session-close

Session close orchestrator. Drives issue-close-finalize (when applicable), collects the outcome JSON written by its ICF-K, and emits the Final Report by substituting the skeleton from hooks/lib/final-report-schema.renderSkeleton. Replaces the legacy "Step 7" emit inside /worktree-end so the Final Report reflects every terminal action.

Pre-flight

• AGENTS_MAIN_ROOT must be set.
• Caller context (pull_request path): /worktree-end WE-1..WE-18a have already completed (PR merged, worktree removed; <CONTROL_DIR>/final-report-env.json exists).
• Caller context (direct: merge_to_main is complete): /merge-to-main pushed to the default branch. No worktree-end ran; the env file does not yet exist.

SC-0 — Resolve PLANS_DIR and session id

Run bash "$AGENTS_MAIN_ROOT/bin/workflow-plans-dir" once as one bare command — never assigned to a variable and echoed back. Canonical: skills/_shared/resolve-plans-dir.md.

Substitute the absolute path it prints for <PLANS_DIR> in every subsequent step. Resolve <session-id> from $CLAUDE_CODE_SESSION_ID with the fallback chain used by --from-session. If unresolvable, abort: session id unresolved — cannot render Final Report. <CONTROL_DIR> is the stdout of node "$AGENTS_MAIN_ROOT/bin/workflow-control-dir" --session <session-id> --for-write (non-zero → abort).

<PLANS_DIR>, <CONTROL_DIR> and <session-id> are LLM-substituted literals — shell variables do not persist between Bash tool calls.

SC-1 — Detect the route

Run: node "$AGENTS_MAIN_ROOT"/bin/session-close-detect-route.js --session ""

• ROUTE=wf-meta → WF-META session. Record IS_WF_META=yes as an LLM-tracked state literal (not a shell variable — every Bash call is self-contained). Proceed to SC-2C.
• ROUTE=pull_request → worktree path (SC-2A).
• ROUTE=direct → direct delivery path (SC-2B).

SC-2A — Worktree path: reuse existing env JSON

test -f "<CONTROL_DIR>/final-report-env.json" \
  || { echo "ERROR: env JSON missing — /worktree-end must run first" >&2; exit 1; }