wf-resume

wf-resume — Resume an interrupted workflow

This skill is the entry point to resume a paused or interrupted waterfall need. It is invoked by the /waterfall:resume command.

Resume flow

Step 1 — Preflight (fail-fast)

bash ${CLAUDE_PLUGIN_ROOT}/scripts/wf-check-bash.sh

If not running under bash (Git Bash on Windows) → the script fails with an explicit message. STOP.

bash ${CLAUDE_PLUGIN_ROOT}/scripts/wf-check-teams.sh

If the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS flag is missing → the script fails with an explicit message. STOP.

jq verification (used by all wf scripts to parse .wf-state.json, .team-registry.json, etc.):

INSTALL_CMD=$(bash ${CLAUDE_PLUGIN_ROOT}/scripts/wf-check-jq.sh) || JQ_RC=$?

• Exit 0 → continue.
• Exit 2 → jq missing. If $INSTALL_CMD non-empty, AskUserQuestion: "jq is required. Install it via ${INSTALL_CMD}?" (Yes / No). On Yes: bash -c "$INSTALL_CMD" then re-run the check. On No or if command empty: display stderr and stop.

Step 1.a — Resolve WF_SID (new HO window)

Critical for statusline (INV-002): on resume, $CLAUDE_SESSION_ID is a fresh sid (new Claude Code window) that does not match the session_id stored in .wf-state.json. We must force WF_SID to the current HO sid so the --reactivate migration takes place.

export WF_SID="${CLAUDE_SESSION_ID}"

Without this, the statusline (which filters on state.session_id == $CLAUDE_SESSION_ID) will not display the resumed need.

Step 1.bis — Same-sid ambiguity detection (EX-005)

Note: when resuming in a new window, WF_SID is a fresh sid that won't match any state. This step is effectively a no-op on resume; it remains useful if /waterfall:resume is invoked in the same window as a workflow that was just abandoned.

If WF_SID is set and no <name> is provided as argument:

# Count needs whose session_id == $WF_SID
matches=()
for state in C:/projets/waterfall/wf/needs/*/.wf-state.json; do
    [[ -f "$state" ]] || continue
    state_sid=$(jq -r '.session_id // ""' "$state" 2>/dev/null)
    [[ "$state_sid" == "$WF_SID" ]] && matches+=("$(dirname "$state" | xargs basename)")
done
if [[ ${#matches[@]} -ge 2 ]]; then
    # AskUserQuestion: pick among the needs (one option per need)
fi