cclaw-cli 7.7.1 → 8.1.0

package/dist/content/artifact-templates.js

@@ -0,0 +1,550 @@
+const PLAN_TEMPLATE = `---
+slug: SLUG-PLACEHOLDER
+stage: plan
+status: active
+ac:
+  - id: AC-1
+    text: "Replace with the first observable outcome (something a user or test can verify)."
+    status: pending
+    parallelSafe: true
+    touchSurface: []
+  - id: AC-2
+    text: "Replace with the second observable outcome, or delete this entry if one AC is enough."
+    status: pending
+    parallelSafe: true
+    touchSurface: []
+last_specialist: null
+refines: null
+shipped_at: null
+ship_commit: null
+review_iterations: 0
+security_flag: false
+---
+
+# SLUG-PLACEHOLDER
+
+> One short paragraph: what we are doing and why. If the goal does not fit in 4 lines, the request is probably too large — split it.
+
+## Frame
+
+_(Brainstormer-authored when invoked. 2-5 sentences: what is broken or missing today, who feels it, what success looks like a user or test can verify, what is explicitly out of scope. Cite real evidence — \`file:path:line\`, ticket id, conversation excerpt — when you have it. If the orchestrator runs inline without brainstormer, leave a one-line summary here.)_
+
+## Approaches
+
+_(Optional. Brainstormer fills this in \`guided\` or \`deep\` posture. Drop dead options before showing the table; do not pad to 3 rows for symmetry.)_
+
+| Role | Approach | Trade-off | Reuse / reference |
+| --- | --- | --- | --- |
+| baseline | _approach_ | _trade-off_ | _reference_ |
+| challenger | _approach_ | _trade-off_ | _reference_ |
+
+## Selected Direction
+
+_(One paragraph when Approaches exists; cites the picked row and why.)_
+
+## Not Doing
+
+_(3-5 bullets the brainstorm explicitly is NOT committing to. Protects scope from silent enlargement.)_
+
+- _explicit non-commitment_
+- _explicit non-commitment_
+
+## Architecture
+
+_(Architect, when invoked. Link to \`flows/SLUG-PLACEHOLDER/decisions.md\`. Keep this section short — full rationale lives in decisions.md.)_
+
+## Plan
+
+_(Planner authors this. AC-aligned, not horizontal-layer. Each unit ships an end-to-end vertical slice for one AC.)_
+
+- **Phase 1 — Foundation (AC-1).**
+  - Concrete change with file:path:line reference.
+- **Phase 2 — Wiring (AC-2, AC-3).**
+  - Concrete change with file:path:line reference.
+
+## Acceptance Criteria
+
+| id | text | status | parallelSafe | touchSurface | commit |
+| --- | --- | --- | --- | --- | --- |
+| AC-1 | _Replace with the first observable outcome._ | pending | true | _list of repo paths_ | — |
+| AC-2 | _Replace or delete._ | pending | true | _list of repo paths_ | — |
+
+The AC block is the source of truth. Every commit produced by \`commit-helper.mjs\` references exactly one AC id. \`parallelSafe: false\` opts the AC out of parallel-build dispatch; \`touchSurface\` is the list of repo-relative paths the AC is allowed to modify. Each AC must point at a real \`file:line\` or destination path.
+
+## Edge cases
+
+_(Planner-authored. One bullet per AC naming the non-happy-path the slice-builder's RED test must encode.)_
+
+- **AC-1** — _empty input / boundary / error response_.
+- **AC-2** — _hover under 100ms / missing fixture / etc_.
+
+## Topology
+
+_(Planner topology mode. Default: \`inline\`. \`parallel-build\` is opt-in; see lib/skills/parallel-build.md for rules.)_
+
+- topology: inline
+- slices: _none_
+
+## Traceability block
+
+- AC-1 → commit pending
+- AC-2 → commit pending
+
+This block is rebuilt by \`commit-helper.mjs\` after every AC commit. Do not edit by hand once a commit is recorded.
+`;
+const BUILD_TEMPLATE = `---
+slug: SLUG-PLACEHOLDER
+stage: build
+status: active
+build_iterations: 0
+last_commit: null
+tdd_cycle: enforced
+---
+
+# Build log — SLUG-PLACEHOLDER
+
+This is the TDD implementation journal. Every AC goes through RED → GREEN → REFACTOR; every phase is a separate commit recorded by \`commit-helper.mjs --phase=…\`.
+
+> **Iron Law:** NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST. The RED failure is the spec.
+
+## Plan summary
+
+_(One paragraph mirroring \`plans/SLUG-PLACEHOLDER.md\` Plan section.)_
+
+## TDD cycle log
+
+For every AC, append one row with **all six columns filled** before the AC is considered done.
+
+| AC | Discovery | RED proof | GREEN evidence | REFACTOR notes | commits |
+| --- | --- | --- | --- | --- | --- |
+| AC-1 | _file:path:line refs from discovery_ | _failing test name + 1-3 line failure excerpt_ | _full-suite command + PASS summary_ | _shape change or "skipped: reason"_ | _red SHA, green SHA, refactor SHA (or "skipped")_ |
+
+## Watched-RED proofs
+
+\`\`\`text
+_(Per AC: command run, test name, 1-3 line failure excerpt that proves RED failed for the right reason.)_
+_AC-1: npm test src/lib/permissions.ts -- -t "renders email"_
+_         AssertionError: expected 'anna@example.com' got undefined_
+\`\`\`
+
+## GREEN suite evidence
+
+\`\`\`text
+_(Per AC: command run, PASS/FAIL summary of the FULL relevant suite — not the single test.)_
+_AC-1: npm test src/lib/__       47 passed, 0 failed (in 1.8s)_
+\`\`\`
+
+## REFACTOR notes
+
+_(Per AC: one-line shape change applied, or explicit "skipped: <reason>". Silence is not acceptable; the gate forces the question.)_
+
+- AC-1: extracted \`hasViewEmail\` helper from inline check.
+
+## Fix iterations (after a review block)
+
+_(Append one fix-iteration block per review iteration that returned \`block\`. Same TDD cycle applies; same AC id is reused; finding F-N is cited in the message.)_
+
+### Fix iteration 1 — review block 1
+
+| F-N | AC | phase | commit | files | note |
+| --- | --- | --- | --- | --- | --- |
+| F-2 | AC-1 | red | _SHA_ | _tests/...:line_ | _what the new RED encodes_ |
+| F-2 | AC-1 | green | _SHA_ | _src/...:line_ | _minimal fix_ |
+| F-2 | AC-1 | refactor (skipped) | — | — | _reason_ |
+
+## Hooks invoked
+
+- \`commit-helper.mjs --ac=AC-1 --phase=red --message="red(AC-1): …"\` → _SHA_
+- \`commit-helper.mjs --ac=AC-1 --phase=green --message="green(AC-1): …"\` → _SHA_
+- \`commit-helper.mjs --ac=AC-1 --phase=refactor --message="refactor(AC-1): …"\` → _SHA_ or _skipped_
+
+## Notes
+
+_(Surprises, deviations from the plan, tests added, refactors that came up, paths considered and discarded, etc.)_
+`;
+const REVIEW_TEMPLATE = `---
+slug: SLUG-PLACEHOLDER
+stage: review
+status: active
+review_iterations: 0
+modes_run:
+  - code
+findings_block: []
+ledger_open: 0
+ledger_closed: 0
+zero_block_streak: 0
+---
+
+# Review — SLUG-PLACEHOLDER
+
+This is the review log. \`reviewer\` (and \`security-reviewer\`, when relevant) append findings here. The loop is producer ↔ critic: iteration N proposes findings, \`slice-builder\` (mode=fix-only) closes them, iteration N+1 re-checks. The loop ends when the convergence detector fires (see review-loop skill).
+
+## Run summary
+
+| iteration | mode | reviewer | result | new_block | closed_block |
+| --- | --- | --- | --- | --- | --- |
+| 1 | code | reviewer | _pending_ | _N_ | _N_ |
+
+Hard cap: 5 iterations. After the 5th, stop and surface what remains in the ledger.
+
+## Concern Ledger (append-only)
+
+Stable global ids per slug. Rows are never edited or deleted, only appended. Closing a row requires a citation to the fix evidence (commit SHA, test name, or new file:line).
+
+| ID | Opened in | Mode | Severity | Status | Closed in | Citation |
+| --- | --- | --- | --- | --- | --- | --- |
+| F-1 | 1 | code | _block / warn_ | _open / closed_ | _N or –_ | \`path:line\` or commit SHA |
+
+Severity rules:
+
+- \`block\` — must close before ship.
+- \`warn\` — may ship; carries to \`ships/<slug>.md\` and \`learnings/<slug>.md\`.
+
+## Iteration logs
+
+\`\`\`markdown
+## Iteration N — <mode> — <ISO timestamp>
+
+Ledger reread:
+- F-K: <closed | open | superseded by F-L> — <citation>
+
+New findings:
+- F-M <severity> — \`<path:line>\` — <description> → <proposed fix>
+
+Five Failure Modes:
+- Hallucinated actions: no / yes (cite)
+- Scope creep: no / yes (cite)
+- Cascading errors: no / yes (cite)
+- Context loss: no / yes (cite)
+- Tool misuse: no / yes (cite)
+
+Decision: <block | warn | clear | cap-reached>
+\`\`\`
+
+## Convergence detector
+
+The loop ends when ANY signal fires:
+
+1. All ledger rows closed → \`clear\`.
+2. Two consecutive iterations with zero new \`block\` findings AND every open row is \`warn\` → \`clear\` (warn carry-over).
+3. Hard cap reached with at least one open \`block\` row → \`cap-reached\`.
+
+Tie-breaker: if iteration 5 closes the last block row, return \`clear\` (signal #1) regardless of cap.
+
+## Decision values
+
+- **block** — at least one open block row. slice-builder (fix-only) addresses them; re-review next iteration.
+- **warn** — convergence signal #2 fired. Open warns carry over. Ship may proceed.
+- **clear** — signal #1 (all closed) or signal #2 (warn-only convergence). Ready for ship.
+- **cap-reached** — signal #3. Stop; orchestrator surfaces remaining open rows to the user; user picks \`/cc-cancel\` or \`accept warns and ship\` (only valid if every open row is severity=warn).
+`;
+const SHIP_TEMPLATE = `---
+slug: SLUG-PLACEHOLDER
+stage: ship
+status: active
+ship_commit: null
+push_approved: false
+pr_url: null
+finalization_mode: null
+preflight_passed: false
+rollback_recorded: false
+repo_mode: git
+---
+
+# Ship notes — SLUG-PLACEHOLDER
+
+This artifact is written just before \`runCompoundAndShip()\` archives the run. It must contain enough information for downstream operators to understand what shipped without opening every other artifact.
+
+> **Iron Law:** NO MERGE WITHOUT GREEN PREFLIGHT, A WRITTEN ROLLBACK, AND EXACTLY ONE SELECTED FINALIZATION MODE. No exceptions for urgency. If no VCS is available, use \`FINALIZE_NO_VCS\` explicitly instead of inventing git steps.
+
+## Summary
+
+_(2-4 lines: what changed, who needs to know.)_
+
+## Preflight checks (mandatory; fresh output in this artifact)
+
+Every check below must produce fresh output in this section. Pasting "tests passed yesterday" does not count.
+
+| Check | Command | Result | Notes |
+| --- | --- | --- | --- |
+| tests | _e.g._ \`npm test\` | _pass / fail_ | _file paths or test names_ |
+| build | _e.g._ \`npm run build\` | _pass / fail_ | _output stderr lines_ |
+| linter | _e.g._ \`npm run lint\` | _pass / fail_ | _file paths_ |
+| type-check | _e.g._ \`npm run typecheck\` or \`tsc --noEmit\` | _pass / fail_ | _error count_ |
+| clean tree | \`git status --porcelain\` | _empty / non-empty_ | _file paths_ |
+
+Set \`preflight_passed: true\` in the frontmatter only when every row is pass/empty.
+
+## Repository mode detection
+
+Run \`test -d .git && echo git || echo no-vcs\`. Result: _git / no-vcs_.
+
+If no-vcs, the only valid finalization mode is \`FINALIZE_NO_VCS\`; document the manual handoff target and rollback owner in the relevant sections.
+
+## Merge-base detection (git mode only)
+
+Run \`git merge-base HEAD <base-branch>\`. If the base has diverged significantly, flag for rebase-first BEFORE proceeding to finalization.
+
+\`\`\`bash
+$ git merge-base HEAD main
+<sha>
+
+$ git rev-list --count <sha>..main
+N commits behind main
+\`\`\`
+
+If \`N > 0\` and any of those commits touch this slug's \`touchSurface\`, rebase first. Re-run preflight after the rebase; do not trust the prior preflight result.
+
+## AC ↔ commit map
+
+| AC | text (one line) | red SHA | green SHA | refactor SHA | description |
+| --- | --- | --- | --- | --- | --- |
+| AC-1 | _AC text_ | _sha_ | _sha_ | _sha or skipped_ | _short description_ |
+
+This table mirrors \`flows/SLUG-PLACEHOLDER/plan.md > Acceptance Criteria\` with the final SHAs from \`flow-state.ac[].phases\`. The orchestrator refuses to run \`runCompoundAndShip()\` if any AC still shows \`status: pending\`.
+
+## Rollback plan (mandatory)
+
+The rollback plan has three explicit fields; missing any one blocks ship:
+
+- **Trigger conditions (what tells you it is broken):** _e.g._ error rate on /api/list > 1% over 5 min; latency p95 > 800ms over 10 min; user-visible 5xx in dashboard.
+- **Rollback steps (exact commands or git operations):** _e.g._ \`git revert <ship_commit>; git push origin main\`. For non-git: \`scp release/<slug>-prev.tar.gz <host>:/srv/app && systemctl restart app\`.
+- **Verification (how to confirm rollback worked):** _e.g._ /healthz returns 200; error rate back to baseline within 5 min; smoke test \`curl /api/list | jq '.items | length'\` returns N.
+
+Set \`rollback_recorded: true\` in the frontmatter only when all three fields are filled with concrete content.
+
+## Monitoring checklist
+
+- Error rate on _/path_: baseline _N_/min, alert above _M_/min for _T_ min.
+- Latency p95 on _/path_: baseline _Nms_, alert above _Mms_ for _T_ min.
+- Business metric: _e.g._ search_quality_score (rolling 1h average should not drop > 5%).
+- If no monitoring exists for the affected surface, flag in Risks section below.
+
+## Push / PR
+
+- push: _pending — orchestrator must explicitly ask the user before running \`git push\`._
+- PR: _pending — only created if the user explicitly says "open a PR"._
+
+When push is approved, record the upstream branch + PR URL above.
+
+## Finalization mode (exactly ONE)
+
+Pick exactly one. Setting \`finalization_mode\` to anything other than these five values is rejected:
+
+- **FINALIZE_MERGE_LOCAL** — merge into the base branch locally; no PR.
+- **FINALIZE_OPEN_PR** — push and open a PR with this artifact's Summary + AC↔commit map as the body.
+- **FINALIZE_KEEP_BRANCH** — push the branch but leave the merge to a downstream operator.
+- **FINALIZE_DISCARD_BRANCH** — delete the branch entirely (requires typed confirmation in the orchestrator turn).
+- **FINALIZE_NO_VCS** — no VCS available; record manual handoff target and rollback owner.
+
+Selected: _<one mode>_
+Rationale: _<one sentence>_
+
+## Breaking changes / migration
+
+_(If none, write "none". If any, link to migration notes — typically docs/migration-… or a release-notes file.)_
+
+## Release notes (one paragraph)
+
+_(Suitable for CHANGELOG.md. Avoid TODOs and references that won't make sense to readers without internal context.)_
+
+## Risks carried over
+
+_(List any \`warn\`-severity ledger rows from \`flows/SLUG-PLACEHOLDER/review.md\` and any \`open\` assumptions from the plan. Each line says: id, source, why we are shipping anyway.)_
+
+- _e.g._ F-2 (warn) — \`tests/integration/list.test.ts:31\` — no negative test for empty page; tracked in \`flows/SLUG-PLACEHOLDER/learnings.md\`.
+
+## Victory Detector
+
+Ship is allowed only when ALL of these are true:
+
+- valid review verdict (\`clear\` or \`warn\` with convergence signal #2)
+- preflight_passed=true with fresh output
+- rollback_recorded=true with all three fields filled
+- finalization_mode set to exactly one enum value
+- repo_mode matches the chosen finalization (\`no-vcs\` repo cannot pick \`FINALIZE_MERGE_LOCAL\`)
+
+If any field is stale or missing, keep \`status: blocked\` and iterate.
+`;
+const DECISIONS_TEMPLATE = `---
+slug: SLUG-PLACEHOLDER
+stage: plan
+status: active
+decision_count: 0
+architecture_tier: null
+---
+
+# Decisions — SLUG-PLACEHOLDER
+
+\`architect\` (and any reviewer in \`text-review\` mode) records decisions here. Each decision is independently citable.
+
+## Architecture tier
+
+_(Architect picks one tier per slug, recorded once at the top of this file. Tier sets the depth bar for the whole D-N set.)_
+
+- **minimum-viable** — solve only the immediate failure mode; ignore future-proofing. Use for hot-fixes, small enhancements, doc-only.
+- **product-grade** — production-ready quality bar; includes failure modes, monitoring hooks, rollback plan. Default for most slugs.
+- **ideal** — invest in long-term shape (clean abstractions, full failure-mode coverage, perf budgets, security review). Use only when explicitly requested or when the change is foundational.
+
+Selected tier: _<minimum-viable | product-grade | ideal>_
+Rationale: _<one sentence>_
+
+## Trivial-Change Escape Hatch
+
+_(If the change is ≤3 files, no new interfaces, no cross-module data flow, write a one-paragraph mini-decision here and skip the full D-N machinery. Otherwise write \`Not applicable.\`.)_
+
+## Blast-radius Diff
+
+_(Only the paths this slug touches, not the whole repo. Cite \`git diff\` against the slug's baseline SHA. Skip for trivial changes.)_
+
+\`\`\`text
+$ git diff <baseline-sha>..HEAD --stat
+src/api/list.ts        | 12 +
+tests/unit/list.test.ts |  6 +
+\`\`\`
+
+## D-1 — _decision title_
+
+- **Context:** _what makes this a real decision instead of a default._
+- **Considered options:**
+  - Option A — _summary_
+  - Option B — _summary_
+  - Option C — _summary_
+- **Selected:** Option _X_
+- **Rationale:** _why X beats A / B / C right now._
+- **Rejected because:** _short reason per rejected option._
+- **Consequences:** _what becomes easier; what becomes harder; what we will revisit._
+- **Refs:** _file:path:line, AC-N, related external link._
+
+### Failure Mode Table
+
+_(Only when this decision touches a user-visible failure path — rendering, request/response, persisted data, payment/auth, third-party calls. If the decision is purely internal, replace this section with the single line \`Failure Mode Table: not applicable — no user-visible failure path\`. When present, \`UserSees\` is mandatory in every row; silent failure paths must show "UserSees=nothing — recorded in <metric>".)_
+
+| # | Method | Exception | Rescue | UserSees |
+| --- | --- | --- | --- | --- |
+| 1 | \`scoring.bm25\` | doc length missing in index | fallback to plain TF | warning toast: "Search ranking degraded" |
+
+### Pre-mortem
+
+_(Imagine this decision shipped and failed. What did it look like in the failure scenario? Three bullets max. Mandatory at product-grade and ideal tiers; minimum-viable may skip.)_
+
+- _Failure scenario 1_
+- _Failure scenario 2_
+- _Failure scenario 3_
+`;
+const LEARNINGS_TEMPLATE = `---
+slug: SLUG-PLACEHOLDER
+stage: ship
+status: active
+captured_by: orchestrator
+quality_gate: passed
+signals:
+  hasArchitectDecision: false
+  reviewIterations: 0
+  securityFlag: false
+  userRequestedCapture: false
+---
+
+# Learnings — SLUG-PLACEHOLDER
+
+The compound phase writes this only when at least one quality signal is present. If you are reading this in an active run, the orchestrator decided this run is worth remembering.
+
+## What we believed at the start
+
+_(What was the going-in assumption when \`/cc\` was invoked?)_
+
+## What turned out to be true
+
+_(Confirmed beliefs.)_
+
+## What turned out to be wrong
+
+_(Discoveries that contradicted the assumption.)_
+
+## Decisions worth remembering
+
+- D-N (link to decisions.md)
+
+## Patterns we should keep
+
+_(Reusable patterns we saw work.)_
+
+## Anti-patterns we should avoid
+
+_(Reusable patterns we saw fail.)_
+
+## Follow-ups
+
+- _(Items intentionally deferred. Each one becomes a separate \`/cc <task>\` later.)_
+`;
+const MANIFEST_TEMPLATE = `---
+slug: SLUG-PLACEHOLDER
+stage: shipped
+status: shipped
+ship_commit: SHIP-COMMIT-PLACEHOLDER
+shipped_at: SHIPPED-AT-PLACEHOLDER
+artifacts:
+  - plan.md
+---
+
+# SLUG-PLACEHOLDER — shipped manifest
+
+This file is the entry point for any future agent that wants to understand what shipped under this slug.
+
+## Acceptance Criteria
+
+- AC-1: _description_ (commit \`SHIP-COMMIT-PLACEHOLDER\`)
+
+## Artifacts
+
+- plan.md — original plan
+- build.md — implementation log
+- review.md — review findings
+- ship.md — release notes
+- decisions.md — architectural decisions (if architect was invoked)
+- learnings.md — lessons captured by compound (if quality gate passed)
+
+## Refines
+
+_(If this run refined a previous slug, link to its shipped manifest here.)_
+
+## Knowledge index
+
+This slug is referenced from \`.cclaw/knowledge.jsonl\` whenever the compound quality gate captured a learning.
+`;
+const IDEAS_TEMPLATE = `# .cclaw/ideas.md
+
+This file is a free-form idea backlog. Entries are appended by \`/cc-idea\` and never auto-promoted to plans. To act on an idea, invoke \`/cc <task>\` describing it.
+
+Each entry begins with an ISO timestamp, then a single-line summary, then the body.
+`;
+export const ARTIFACT_TEMPLATES = [
+    { id: "plan", fileName: "plan.md", description: "Plan template with frontmatter, AC table, and traceability block.", body: PLAN_TEMPLATE },
+    { id: "build", fileName: "build.md", description: "Build log template with commit table and hook invocation log.", body: BUILD_TEMPLATE },
+    { id: "review", fileName: "review.md", description: "Review template with iteration table, findings table, and Five Failure Modes pass.", body: REVIEW_TEMPLATE },
+    { id: "ship", fileName: "ship.md", description: "Ship notes template with AC↔commit map, push/PR section, release notes paragraph.", body: SHIP_TEMPLATE },
+    { id: "decisions", fileName: "decisions.md", description: "Architect-style decision record template (D-N entries).", body: DECISIONS_TEMPLATE },
+    { id: "learnings", fileName: "learnings.md", description: "Compound learning capture template with belief/outcome/follow-up sections.", body: LEARNINGS_TEMPLATE },
+    { id: "manifest", fileName: "manifest.md", description: "Shipped manifest template; lists AC, artifacts, refines link.", body: MANIFEST_TEMPLATE },
+    { id: "ideas", fileName: "ideas.md", description: "Append-only idea backlog seed.", body: IDEAS_TEMPLATE }
+];
+export function templateBody(id, replacements = {}) {
+    const template = ARTIFACT_TEMPLATES.find((entry) => entry.id === id);
+    if (!template)
+        throw new Error(`Unknown artifact template: ${id}`);
+    let body = template.body;
+    for (const [key, value] of Object.entries(replacements)) {
+        body = body.split(key).join(value);
+    }
+    return body;
+}
+export function planTemplateForSlug(slug) {
+    return templateBody("plan", { "SLUG-PLACEHOLDER": slug });
+}
+export function manifestTemplate(slug, shipCommit, shippedAt) {
+    return templateBody("manifest", {
+        "SLUG-PLACEHOLDER": slug,
+        "SHIP-COMMIT-PLACEHOLDER": shipCommit,
+        "SHIPPED-AT-PLACEHOLDER": shippedAt
+    });
+}

package/dist/content/cancel-command.d.ts

@@ -1,2 +1,2 @@
-export declare function cancelCommandContract(): string;
-export declare function cancelCommandSkillMarkdown(): string;
+export declare const CANCEL_COMMAND_BODY = "# /cc-cancel \u2014 cancel the active cclaw run\n\nStop the current flow without finishing it. Artifacts are preserved.\n\n## Behaviour\n\n1. Read `.cclaw/state/flow-state.json`.\n2. If `currentSlug` is null \u2192 tell the user there is nothing to cancel and stop.\n3. Otherwise, perform the cancel runtime:\n   - For every active stage (`plan`, `build`, `review`, `ship`, `decisions`, `learnings`), move `<slug>.md` into `.cclaw/flows/cancelled/<slug>/` as `<stage>.md`.\n   - Write `.cclaw/flows/cancelled/<slug>/manifest.md` recording the cancel time, the user's reason (if provided), and the artifacts that were moved.\n   - Update each moved artifact's frontmatter so `status: cancelled` and `stage: cancelled` (best-effort \u2014 invalid frontmatter is preserved as-is).\n   - Reset `flow-state.json` to fresh: `currentSlug=null, currentStage=null, ac=[], reviewIterations=0, securityFlag=false`.\n   - Leave the working tree alone. Do not auto-commit, do not stash, do not revert.\n4. Confirm the cancellation in one line and list the destination directory.\n\n## Recovery\n\nThe artifacts under `.cclaw/flows/cancelled/<slug>/` are read-only references for future runs. To resume the work:\n\n1. Invoke `/cc <task>` describing the same goal.\n2. Existing-plan detection will surface the cancelled match.\n3. Choose **resume from cancelled** to move the artifacts from `.cclaw/flows/cancelled/<slug>/` back into `.cclaw/flows/<slug>/`, reset `status: active`, and continue.\n\n## Hard rules\n\n- `/cc-cancel` never deletes artifacts. The orchestrator must refuse explicit deletion requests.\n- `/cc-cancel` never pushes to git or rewrites history.\n- `/cc-cancel` is idempotent: invoking it without an active slug prints \"no active run\" and stops.\n";
+export declare function renderCancelCommand(): string;

package/dist/content/cancel-command.js

@@ -1,25 +1,33 @@
-export function cancelCommandContract() {
-    return `# /cc-cancel command contract
+export const CANCEL_COMMAND_BODY = `# /cc-cancel — cancel the active cclaw run
 
-Use this command when the user wants to stop the active run without claiming completion.
+Stop the current flow without finishing it. Artifacts are preserved.
 
-## Protocol
+## Behaviour
 
-1. Ask for a concise cancellation reason if the user has not already provided one.
-2. Run \`node .cclaw/hooks/cancel-run.mjs --reason="<reason>"\` from the project root. Use \`--disposition=abandoned\` only when the user explicitly frames the run as abandoned rather than cancelled.
-3. Report the archive path and reset run id. Make clear that the archived run is not a completed ship.
+1. Read \`.cclaw/state/flow-state.json\`.
+2. If \`currentSlug\` is null → tell the user there is nothing to cancel and stop.
+3. Otherwise, perform the cancel runtime:
+   - For every active stage (\`plan\`, \`build\`, \`review\`, \`ship\`, \`decisions\`, \`learnings\`), move \`<slug>.md\` into \`.cclaw/flows/cancelled/<slug>/\` as \`<stage>.md\`.
+   - Write \`.cclaw/flows/cancelled/<slug>/manifest.md\` recording the cancel time, the user's reason (if provided), and the artifacts that were moved.
+   - Update each moved artifact's frontmatter so \`status: cancelled\` and \`stage: cancelled\` (best-effort — invalid frontmatter is preserved as-is).
+   - Reset \`flow-state.json\` to fresh: \`currentSlug=null, currentStage=null, ac=[], reviewIterations=0, securityFlag=false\`.
+   - Leave the working tree alone. Do not auto-commit, do not stash, do not revert.
+4. Confirm the cancellation in one line and list the destination directory.
 
-Cancelled and abandoned archives are allowed from any stage, but they require a required reason so future readers know why the run ended.
-`;
-}
-export function cancelCommandSkillMarkdown() {
-    return `---
-name: flow-cancel
-description: Cancel or abandon the active cclaw run with a required reason. Use when the user types /cc-cancel or asks to cancel, abandon, stop, discard, or reset an unfinished run.
----
+## Recovery
+
+The artifacts under \`.cclaw/flows/cancelled/<slug>/\` are read-only references for future runs. To resume the work:
+
+1. Invoke \`/cc <task>\` describing the same goal.
+2. Existing-plan detection will surface the cancelled match.
+3. Choose **resume from cancelled** to move the artifacts from \`.cclaw/flows/cancelled/<slug>/\` back into \`.cclaw/flows/<slug>/\`, reset \`status: active\`, and continue.
 
-# Cancel cclaw Run
+## Hard rules
 
-Load and follow \`.cclaw/commands/cancel.md\`. This is a non-completion path: require a reason, run the generated cancel helper, and archive with cancelled or abandoned disposition.
+- \`/cc-cancel\` never deletes artifacts. The orchestrator must refuse explicit deletion requests.
+- \`/cc-cancel\` never pushes to git or rewrites history.
+- \`/cc-cancel\` is idempotent: invoking it without an active slug prints "no active run" and stops.
 `;
+export function renderCancelCommand() {
+    return CANCEL_COMMAND_BODY;
 }