cclaw-cli 0.33.0 → 0.34.0

package/README.md

@@ -133,7 +133,7 @@ inside `/cc-ops` subcommands.
 | **`/cc <idea>`** | Classify the task, discover origin docs (`docs/prd/**`, ADRs, root `PRD.md`, …), sniff the stack, recommend a track, then start the first stage of that track. `/cc` without arguments resumes the current flow. |
 | **`/cc-next`** | The one progression primitive. Reads `flow-state.json`, checks gates + mandatory subagent delegations, and either resumes the current stage or advances to the next. `/cc-next` in a new session is how you **resume**. |
 | **`/cc-ideate`** | Repository improvement discovery. Scans for TODOs, flaky tests, oversized modules, docs drift, and recurring knowledge-store lessons; returns a ranked backlog before you commit to a specific feature. |
-| **`/cc-view`** | Read-only flow visibility. `/cc-view status` (default), `/cc-view tree`, `/cc-view diff` (baseline delta map). Never mutates state. |
+| **`/cc-view`** | Read-only flow visibility. `/cc-view status` (default) shows stage progress, mandatory delegations with their fulfillment mode (isolated / generic-dispatch / role-switch), the ship closeout substate (retro → compound → archive), and the active harness parity row. `/cc-view tree` renders the same picture as a tree with a closeout sub-branch under ship and a per-harness playbook summary. `/cc-view diff` shows stage/gate/closeout/delegation deltas since the last run. Never mutates state (except diff's snapshot baseline). |
 
 > Power-user surface: `/cc-ops` is an operational router for manual
 > overrides (rewind a stale stage, manage parallel features, re-run a

package/dist/content/diff-command.js

@@ -7,12 +7,23 @@ function flowStatePath() {
 function snapshotPath() {
     return `${RUNTIME_ROOT}/state/flow-state.snapshot.json`;
 }
+function delegationLogPath() {
+    return `${RUNTIME_ROOT}/state/delegation-log.json`;
+}
+function retroArtifactPath() {
+    return `${RUNTIME_ROOT}/artifacts/09-retro.md`;
+}
 export function diffCommandContract() {
     return `# /cc-view diff
 
 ## Purpose
 
-Show a visual before/after diff map for flow-state progression.
+Show a visual before/after diff map for flow-state progression. Covers the core
+stage/gate transitions plus:
+
+- ship **closeout substate** transitions (\`retro_review\` → \`compound_review\` → \`ready_to_archive\`),
+- delegation **fulfillmentMode** transitions per mandatory agent,
+- appearance or removal of the retro artifact \`09-retro.md\`.
 
 ## HARD-GATE
 
@@ -21,16 +32,27 @@ Show a visual before/after diff map for flow-state progression.
 
 ## Algorithm
 
-1. Read current state from \`${flowStatePath()}\`.
-2. Read baseline from \`${snapshotPath()}\` (if missing -> create baseline from current state and stop).
-3. Compute deltas:
-   - stage transition (\`from -> to\`)
-   - completed stage additions/removals
-   - skipped stage additions/removals
-   - stale stage additions/removals
-   - current-stage gate \`passed\` and \`blocked\` changes
-4. Render a compact diff map (added \`+\`, removed \`-\`, changed \`->\`).
-5. Persist current state back to \`${snapshotPath()}\` as new baseline with \`capturedAt\`.
+1. Read current state from \`${flowStatePath()}\` (including \`closeout\`).
+2. Read current delegation log from \`${delegationLogPath()}\` (if missing treat as empty).
+3. Read baseline from \`${snapshotPath()}\` (if missing -> create baseline from
+   current state **plus** a copy of the current delegation log; report
+   \`flow diff baseline created\` and stop).
+4. Compute deltas:
+   - stage transition (\`from -> to\`),
+   - completed stage additions/removals,
+   - skipped stage additions/removals,
+   - stale stage additions/removals,
+   - current-stage gate \`passed\` and \`blocked\` changes,
+   - \`closeout.shipSubstate\` transition (\`from -> to\`),
+   - \`closeout.retroDraftedAt\` / \`retroAcceptedAt\` / \`retroSkipped\` flips,
+   - \`closeout.compoundPromoted\` / \`compoundSkipped\` flips,
+   - per-agent \`fulfillmentMode\` transitions from the baseline delegation log,
+   - appearance (\`+\`) or disappearance (\`-\`) of \`${retroArtifactPath()}\`.
+5. Render a compact diff map (added \`+\`, removed \`-\`, changed \`->\`).
+6. Persist current state back to \`${snapshotPath()}\` as new baseline with
+   \`capturedAt\` and an embedded \`delegations\` projection
+   (\`{ agent, status, fulfillmentMode }[]\`) so fulfillmentMode transitions are
+   computable on the next run.
 
 ## Diff Map Format
 
@@ -41,8 +63,18 @@ cclaw flow diff
   stale: -design
   gates(spec): +spec_contract_complete  -spec_open_questions_closed
   blocked(spec): +spec_trace_matrix_missing
+  closeout: idle -> retro_review
+  retro: +drafted (09-retro.md appeared)
+  delegations:
+    - reviewer: scheduled -> completed (mode=generic-dispatch)
+    - test-author: mode=? -> role-switch (evidenceRefs=2)
 \`\`\`
 
+- The \`closeout:\` line is omitted when \`shipSubstate\` is unchanged.
+- The \`delegations:\` block is omitted when no agent changed status or mode.
+- The \`retro:\` line is emitted only on artifact appearance/removal or on a
+  \`retroAcceptedAt\` / \`retroSkipped\` flip.
+
 ## Primary skill
 
 **${RUNTIME_ROOT}/skills/${DIFF_SKILL_FOLDER}/SKILL.md**
@@ -51,7 +83,7 @@ cclaw flow diff
 export function diffCommandSkillMarkdown() {
     return `---
 name: ${DIFF_SKILL_NAME}
-description: "Compare current flow-state against saved snapshot and render gate/stage deltas."
+description: "Compare current flow-state against saved snapshot and render gate/stage/closeout/delegation deltas."
 ---
 
 # /cc-view diff
@@ -63,21 +95,35 @@ Never lose baseline visibility: render deltas before writing a new snapshot.
 ## Protocol
 
 1. Read \`${flowStatePath()}\`.
-2. Read \`${snapshotPath()}\`.
-3. If snapshot missing:
-   - write baseline snapshot from current state,
+2. Read \`${delegationLogPath()}\` (missing → treat as empty list).
+3. Read \`${snapshotPath()}\`.
+4. If snapshot missing:
+   - write baseline snapshot from current state **plus** a
+     \`delegations\` projection (\`{ agent, status, fulfillmentMode }[]\`),
    - print \`flow diff baseline created\`,
    - stop.
-4. Build deltas for stage, completed/skipped/stale sets, and current-stage gate arrays.
-5. Print a compact diff map with explicit \`+\`, \`-\`, and \`->\` markers.
-6. Write updated snapshot with:
-   - \`capturedAt\` (ISO)
-   - \`state\` (full current flow-state object)
+5. Build deltas for:
+   - stage, completed/skipped/stale sets,
+   - current-stage gate arrays (\`passed\`, \`blocked\`),
+   - \`closeout.shipSubstate\` transitions (\`from -> to\`),
+   - \`closeout.retroDraftedAt\` / \`retroAcceptedAt\` / \`retroSkipped\` flips,
+   - \`closeout.compoundPromoted\` / \`compoundSkipped\` / \`compoundCompletedAt\` flips,
+   - per-agent \`fulfillmentMode\` transitions by matching baseline delegations
+     against current delegations on \`agent\` + latest entry,
+   - appearance or removal of \`${retroArtifactPath()}\` on disk.
+6. Print a compact diff map with explicit \`+\`, \`-\`, and \`->\` markers.
+7. Write updated snapshot with:
+   - \`capturedAt\` (ISO),
+   - \`state\` (full current flow-state object),
+   - \`delegations\` projection from the current log.
 
 ## Validation
 
 - Diff output must be deterministic for identical states ("no changes").
 - Snapshot file stays valid JSON after every run.
 - Do not suppress removed values; removals are first-class evidence.
+- Closeout diff lines must use the same \`shipSubstate\` vocabulary as the
+  state machine (\`idle\` / \`retro_review\` / \`compound_review\` /
+  \`ready_to_archive\` / \`archived\`).
 `;
 }

package/dist/content/status-command.js

@@ -22,6 +22,12 @@ function stageActivityPath() {
 function snapshotPath() {
     return `${RUNTIME_ROOT}/state/flow-state.snapshot.json`;
 }
+function harnessGapsPath() {
+    return `${RUNTIME_ROOT}/state/harness-gaps.json`;
+}
+function retroArtifactPath() {
+    return `${RUNTIME_ROOT}/artifacts/09-retro.md`;
+}
 /**
  * Command contract for /cc-view status — a read-only snapshot command.
  * Does not mutate state. Always safe to run.
@@ -34,7 +40,8 @@ export function statusCommandContract() {
 ## Purpose
 
 **Read-only visual snapshot of the cclaw run.** Shows progress bar, current stage,
-gate coverage, delegation status, stale markers, and top knowledge highlights.
+gate coverage, delegation status with fulfillmentMode, closeout substate after
+ship, harness parity fallback, stale markers, and top knowledge highlights.
 
 This command **never mutates state**. Use it at session start to orient, or at any
 time to answer "where are we?" without advancing the flow.
@@ -49,9 +56,10 @@ time to answer "where are we?" without advancing the flow.
 ## Algorithm
 
 1. Read **\`${flowPath}\`** — capture \`track\`, \`currentStage\`, \`completedStages\`,
-   \`skippedStages\`, and per-stage gate catalog.
-2. Read **\`${delegationPath}\`** — count delegated / completed / waived / pending entries
-   for the current stage's \`mandatoryDelegations\`.
+   \`skippedStages\`, \`staleStages\`, per-stage gate catalog, and **\`closeout\`**
+   (shipSubstate + retro/compound flags).
+2. Read **\`${delegationPath}\`** — for each mandatory agent of the current stage,
+   capture \`status\`, \`fulfillmentMode\`, and whether \`evidenceRefs\` are present.
 3. Read **\`${contextModePath()}\`** — surface \`activeMode\` (default if missing).
 4. Compute **time in current stage** from the most recent stage-entry signal:
    - Prefer \`${checkpointPath()}\`'s \`timestamp\` when its \`stage\` matches \`currentStage\`.
@@ -60,25 +68,37 @@ time to answer "where are we?" without advancing the flow.
    - If no signal exists, render \`(unknown)\`.
 5. Optionally read **\`${snapshotPath()}\`** to compute gate delta versus prior baseline:
    - If missing or invalid, render \`delta: (baseline unavailable; run /cc-view diff)\`.
-6. Read the top of **\`${knowledgePath}\`** — surface up to 3 most recent entries
+6. Read **\`${harnessGapsPath()}\`** (schemaVersion 2). For every installed harness
+   capture \`tier\`, \`subagentFallback\`, and \`playbookPath\` for the harness row.
+7. Read the top of **\`${knowledgePath()}\`** — surface up to 3 most recent entries
    (by trailing timestamp or source marker).
-7. Emit the visual status block described below. Do **not** load any stage skill.
+8. Detect **closeout artifacts**: check whether \`${retroArtifactPath()}\` exists on
+   disk and annotate the closeout row accordingly.
+9. Emit the visual status block described below. Do **not** load any stage skill.
 
 ## Visual markers
 
 Default UTF markers: \`✓\` passed, \`▶\` current, \`○\` pending, \`⊘\` skipped, \`⏸\` stale, \`✗\` blocked.  
 ASCII fallback (no UTF locale): \`[x]\`, \`[>]\`, \`[ ]\`, \`[-]\`, \`[=]\`, \`[!]\`.
 
+Delegation markers: \`✓\` completed, \`◎\` completed-no-evidence (role-switch
+harness; **blocks stage**), \`○\` scheduled/pending, \`⊘\` waived, \`✗\` failed.
+
 ## Status Block Format
 
 \`\`\`
 cclaw status
-  flow:   <track> · run=<runId> · feature=<feature-id>
-  stage:  <stage> (<N>/<total>) · time <Xd|XhYm|Xm|unknown> · mode <activeMode>
-  bar:    [✓ brainstorm] [✓ scope] [▶ design] [○ spec] [○ plan] [○ tdd] [○ review] [○ ship]
-  gates:  now <passed>/<required> · blocked <count> · delta <summary or baseline-unavailable>
-  delegations: [✓ <role>] [○ <role>] ...
-  stale:  <list or none>
+  flow:    <track> · run=<runId> · feature=<feature-id>
+  stage:   <stage> (<N>/<total>) · time <Xd|XhYm|Xm|unknown> · mode <activeMode>
+  bar:     [✓ brainstorm] [✓ scope] [▶ design] [○ spec] [○ plan] [○ tdd] [○ review] [○ ship]
+  gates:   now <passed>/<required> · blocked <count> · delta <summary or baseline-unavailable>
+  delegations (<expectedMode>):
+    - planner      ✓ completed  mode=<isolated|generic-dispatch|role-switch>
+    - reviewer     ○ pending
+    - test-author  ◎ missing-evidence (role-switch; add evidenceRefs)
+  closeout: <shipSubstate> · retro=<drafted|accepted|skipped|—> · compound=<N promoted|skipped|—>
+  harness: <id>=<tier>/<fallback>, ... · playbooks: <M>/<N>
+  stale:   <list or none>
   knowledge:
     - <latest entry summary>
     - <second entry summary>
@@ -86,12 +106,20 @@ cclaw status
   next: /cc-next · /cc-view tree · /cc-view diff
 \`\`\`
 
+- Omit the \`closeout:\` row when \`currentStage !== "ship"\` and \`shipSubstate === "idle"\`.
+- Omit \`delegations\` line when the current stage has zero mandatory delegations.
+- Omit \`harness\` line only when \`${harnessGapsPath()}\` is missing or invalid
+  (render \`harness: (report unavailable; run cclaw upgrade)\`).
+
 ## Anti-patterns
 
 - Inventing gate status without reading \`${flowPath}\`.
 - Reporting delegations as satisfied when the log says \`pending\`.
+- Treating a \`completed\` role-switch delegation without \`evidenceRefs\` as green
+  — it must surface as \`◎ missing-evidence\`.
 - Advancing the stage from \`/cc-view status\` — progression belongs to \`/cc-next\`.
-- Hiding stale stages; stale markers must be surfaced directly in the status line.
+- Hiding the closeout substate after ship; retro/compound/archive progress must
+  be visible so \`/cc-next\` resumes at the right step.
 
 ## Primary skill
 
@@ -106,7 +134,7 @@ export function statusCommandSkillMarkdown() {
     const delegationPath = delegationLogPath();
     return `---
 name: ${STATUS_SKILL_NAME}
-description: "Read-only visual snapshot of the cclaw flow with progress bar, gate delta, delegations, and stale markers."
+description: "Read-only visual snapshot of the cclaw flow with progress bar, gate delta, delegations (fulfillmentMode + evidence), closeout substate, and harness parity row."
 ---
 
 # /cc-view status — Flow Status Snapshot
@@ -114,7 +142,14 @@ description: "Read-only visual snapshot of the cclaw flow with progress bar, gat
 ## Overview
 
 \`/cc-view status\` is the quickest way to answer "where are we in the flow?" without
-advancing or mutating anything. Safe to run at any point.
+advancing or mutating anything. Safe to run at any point. The snapshot reflects:
+
+- progress across stages with per-stage markers,
+- gate coverage and delta vs. baseline,
+- mandatory delegations with **fulfillmentMode** (isolated / generic-dispatch /
+  role-switch / harness-waiver) and evidence gate,
+- **closeout substate** after ship (retro → compound → archive),
+- **harness parity row** (tier + fallback) for the active harness set.
 
 ## HARD-GATE
 
@@ -133,22 +168,45 @@ a read-only command. Do **not** update \`${snapshotPath()}\` here.
 5. Try reading \`${snapshotPath()}\` for gate delta:
    - If available, compare current stage \`passed\` / \`blocked\` sets against baseline.
    - If unavailable, render \`delta: (baseline unavailable; run /cc-view diff)\`.
-6. Read \`${RUNTIME_ROOT}/knowledge.jsonl\`. If missing or empty → knowledge highlights are \`(none recorded)\`. Parse each line as JSON and surface its \`trigger\`/\`action\`.
-7. For each gate in \`stageGateCatalog[currentStage].required\`:
+6. Read \`${harnessGapsPath()}\`:
+   - If \`schemaVersion === 2\`, for each entry render \`<harness>=<tier>/<subagentFallback>\`.
+   - Count existing \`playbookPath\` files on disk to print \`playbooks: <M>/<N>\`.
+   - If the file is missing or has an older schema, render
+     \`harness: (report unavailable; run cclaw upgrade)\`.
+7. Read \`${RUNTIME_ROOT}/knowledge.jsonl\`. If missing or empty → knowledge highlights are \`(none recorded)\`. Parse each line as JSON and surface its \`trigger\`/\`action\`.
+8. For each gate in \`stageGateCatalog[currentStage].required\`:
    - Satisfied if present in \`passed\` and absent from \`blocked\`.
-8. Build and print the visual status block:
-   - stage header
-   - one-line progress bar with per-stage markers
-   - gate summary + delta
-   - delegation row
-   - stale stage row
-9. Suggest the next action:
-   - If current stage has unmet gates → \`/cc-next\` to resume.
-   - If current stage is complete → \`/cc-next\` to advance (or report "Flow complete" if terminal).
+9. For each mandatory delegation of the current stage, evaluate:
+   - \`✓ completed\` when \`status === "completed"\` and (harness is not role-switch
+     **or** \`evidenceRefs.length >= 1\`).
+   - \`◎ missing-evidence\` when \`status === "completed"\`, harness declares
+     \`role-switch\`, and \`evidenceRefs\` is empty or absent.
+   - \`○ <status>\` for \`scheduled\` / pending.
+   - \`⊘ waived\` when \`status === "waived"\`.
+   - \`✗ failed\` when \`status === "failed"\`.
+10. Compute **closeout row** when \`currentStage === "ship"\` or
+    \`closeout.shipSubstate !== "idle"\`:
+    - \`shipSubstate\` verbatim,
+    - \`retro=drafted|accepted|skipped|—\` derived from \`closeout.retroDraftedAt\`,
+      \`closeout.retroAcceptedAt\`, \`closeout.retroSkipped\`,
+    - \`compound=<N promoted>|skipped|—\` from
+      \`closeout.compoundPromoted\` / \`closeout.compoundSkipped\`.
+11. Build and print the visual status block:
+    - stage header
+    - one-line progress bar with per-stage markers
+    - gate summary + delta
+    - delegation rows (per mandatory agent)
+    - closeout row (when active)
+    - harness row
+    - stale stage row
+12. Suggest the next action:
+    - If current stage has unmet gates → \`/cc-next\` to resume.
+    - If closeout substate is non-idle → \`/cc-next\` to continue the chain.
+    - If current stage is complete → \`/cc-next\` to advance (or report "Flow complete" if terminal).
 
 ## Output Guidelines
 
-- Keep output compact (≤ 30 lines) — status, not narrative.
+- Keep output compact (≤ 40 lines) — status, not narrative.
 - Report counts, not full artifact contents.
 - If any data source is missing or corrupt, say so explicitly rather than guessing.
 - Include \`/cc-view tree\` for deep structure and \`/cc-view diff\` for before/after map in the final line.
@@ -157,6 +215,10 @@ a read-only command. Do **not** update \`${snapshotPath()}\` here.
 
 - Rebuilding trace-matrix or running doctor from \`/cc-view status\` — those belong to dedicated tools.
 - Treating absence of delegation log as "all delegations complete".
+- Collapsing \`◎ missing-evidence\` into \`✓ completed\` — role-switch gaps must stay
+  visible so the stage cannot advance silently.
+- Omitting the closeout row when \`shipSubstate !== "idle"\`; it is the only signal
+  that tells the user why \`/cc-next\` is about to run retro/compound/archive.
 - Mutating state to "clean up" during a status check.
 `;
 }

package/dist/content/tree-command.js

@@ -13,13 +13,17 @@ function artifactsPath() {
 function rewindLogPath() {
     return `${RUNTIME_ROOT}/state/rewind-log.jsonl`;
 }
+function harnessPlaybooksDir() {
+    return `${RUNTIME_ROOT}/references/harnesses`;
+}
 export function treeCommandContract() {
     return `# /cc-view tree
 
 ## Purpose
 
-Render a visual flow tree for quick orientation across stages, gates, delegations,
-stale markers, and artifact presence.
+Render a visual flow tree for quick orientation across stages, gates, delegations
+(with fulfillmentMode), ship closeout substate, stale markers, artifact presence,
+and per-harness playbook availability.
 
 ## HARD-GATE
 
@@ -30,13 +34,21 @@ stale markers, and artifact presence.
 
 1. Read \`${flowStatePath()}\`.
 2. Read \`${delegationLogPath()}\` (if missing, treat current-stage delegations as pending).
-3. Detect artifact files in \`${artifactsPath()}\`.
+3. Detect artifact files in \`${artifactsPath()}\` (\`01-brainstorm.md\` …
+   \`08-ship.md\` plus \`09-retro.md\`).
 4. Read rewind records from \`${rewindLogPath()}\` when present for stale-stage context.
-5. Render the tree using stage order from active track:
+5. Inspect \`${harnessPlaybooksDir()}\` to confirm per-harness playbooks exist
+   for the installed harness set.
+6. Render the tree using stage order from active track:
    - stage node marker: passed/current/pending/skipped/stale
    - gate summary: \`passed/required\`
-   - delegation summary for current stage
+   - delegation summary for current stage (each agent carries its
+     \`fulfillmentMode\` label)
    - artifact marker per stage (exists / stale copy / missing)
+7. When \`currentStage === "ship"\` or \`closeout.shipSubstate !== "idle"\`,
+   append a closeout sub-tree under ship with substate and retro/compound flags.
+8. Append a final \`harnesses\` branch summarising tier + fallback +
+   playbook-present for each installed harness.
 
 ## Tree Format
 
@@ -45,12 +57,31 @@ cclaw flow tree (track=<track>, run=<runId>)
 ├─ [✓] brainstorm  gates 6/6   artifact 01-brainstorm.md
 ├─ [✓] scope       gates 5/5   artifact 02-scope.md
 ├─ [▶] design      gates 2/7   artifact 03-design.md
-│  ├─ delegations: [✓] planner  [○] reviewer
+│  ├─ delegations:
+│  │   ├─ planner   ✓ completed  mode=isolated
+│  │   └─ reviewer  ○ pending
 │  └─ stale: none
 ├─ [○] spec        gates -     artifact missing
 └─ [○] plan        gates -     artifact missing
+
+closeout (shipSubstate=retro_review):
+  ├─ retro:    drafted 09-retro.md · awaiting accept/edit/skip
+  ├─ compound: —
+  └─ archive:  pending
+
+harnesses:
+  ├─ claude    tier=tier1 fallback=native           playbook ✓
+  ├─ cursor    tier=tier2 fallback=generic-dispatch playbook ✓
+  ├─ opencode  tier=tier2 fallback=role-switch      playbook ✓
+  └─ codex     tier=tier2 fallback=role-switch      playbook ✓
 \`\`\`
 
+- Closeout sub-tree is **omitted** when \`currentStage !== "ship"\` and
+  \`shipSubstate === "idle"\`.
+- Delegations sub-branch is omitted when the stage has no mandatory agents.
+- Playbook marker is \`✗ missing\` when the file under
+  \`${harnessPlaybooksDir()}/<harness>-playbook.md\` is absent.
+
 Use UTF markers by default, ASCII fallback when terminal cannot render UTF.
 
 ## Primary skill
@@ -61,7 +92,7 @@ Use UTF markers by default, ASCII fallback when terminal cannot render UTF.
 export function treeCommandSkillMarkdown() {
     return `---
 name: ${TREE_SKILL_NAME}
-description: "Render a visual flow tree for stages, gates, delegations, and artifacts."
+description: "Render a visual flow tree for stages, gates, delegations (fulfillmentMode), ship closeout substate, artifacts, and per-harness playbooks."
 ---
 
 # /cc-view tree
@@ -72,20 +103,39 @@ Do not modify state in this command. It is a pure read/render operation.
 
 ## Protocol
 
-1. Read \`${flowStatePath()}\` as source of truth.
-2. Read \`${delegationLogPath()}\` for current-stage delegation status.
-3. Inspect \`${artifactsPath()}\` for per-stage artifact presence and stale copies.
-4. Render one compact tree:
-   - stage marker: passed/current/pending/skipped/stale
-   - gates summary
-   - artifact summary
-   - delegation branch for current stage
-5. If rewind records exist in \`${rewindLogPath()}\`, include latest rewind note in footer.
+1. Read \`${flowStatePath()}\` as source of truth (including \`closeout\`).
+2. Read \`${delegationLogPath()}\` for current-stage delegation status plus
+   \`fulfillmentMode\` / \`evidenceRefs\`.
+3. Inspect \`${artifactsPath()}\` for per-stage artifact presence and stale copies,
+   and for the retro artifact \`09-retro.md\`.
+4. Inspect \`${harnessPlaybooksDir()}\` for \`<harness>-playbook.md\` files.
+5. Render one compact tree:
+   - stage marker: passed/current/pending/skipped/stale,
+   - gates summary,
+   - artifact summary,
+   - delegation branch for current stage with fulfillmentMode labels,
+6. When \`closeout.shipSubstate !== "idle"\` or \`currentStage === "ship"\`, add
+   a closeout sub-tree:
+   - \`retro:\` line derived from \`closeout.retroDraftedAt\` /
+     \`closeout.retroAcceptedAt\` / \`closeout.retroSkipped\` and artifact presence,
+   - \`compound:\` line derived from \`closeout.compoundPromoted\` /
+     \`closeout.compoundSkipped\` / \`closeout.compoundCompletedAt\`,
+   - \`archive:\` line — \`pending\` until \`shipSubstate === "ready_to_archive"\`,
+     then \`next\`; the transient \`archived\` substate surfaces only if the
+     archive step failed mid-run.
+7. Append a \`harnesses:\` branch. For each installed harness derive the tier
+   from the harness-gaps report and mark \`playbook ✓/✗ missing\` based on
+   \`${harnessPlaybooksDir()}/<harness>-playbook.md\` existence.
+8. If rewind records exist in \`${rewindLogPath()}\`, include latest rewind note in footer.
 
 ## Validation
 
 - Output must mention the active \`track\` and \`currentStage\`.
 - Exactly one stage is marked current.
 - Missing files are reported explicitly; never guessed as complete.
+- Delegation rows always carry a fulfillmentMode label (or \`mode=?\` when the
+  ledger entry is legacy and the mode is inferred).
+- Closeout sub-tree is present iff ship is reached; it cannot be omitted while
+  \`shipSubstate !== "idle"\`.
 `;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cclaw-cli",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Installer-first flow toolkit for coding agents",
   "type": "module",
   "bin": {