cclaw-cli 0.13.0 → 0.14.0

package/dist/cli.js

@@ -115,6 +115,17 @@ function buildInitSurfacePreview(harnesses) {
         ".cclaw/config.yaml",
         ".cclaw/commands/*.md",
         ".cclaw/skills/*/SKILL.md",
+        ".cclaw/contexts/*.md",
+        ".cclaw/templates/*",
+        ".cclaw/agents/*.md",
+        ".cclaw/hooks/*",
+        ".cclaw/rules/**",
+        ".cclaw/adapters/*.md",
+        ".cclaw/custom-skills/README.md",
+        ".cclaw/features/**",
+        ".cclaw/runs/**",
+        ".cclaw/artifacts/**",
+        ".cclaw/knowledge.jsonl",
         ".cclaw/state/*.json|*.jsonl",
         ".cclaw/references/**",
         "AGENTS.md (managed block)"

package/dist/config.js

@@ -15,7 +15,6 @@ const ALLOWED_CONFIG_KEYS = new Set([
     "version",
     "flowVersion",
     "harnesses",
-    "autoAdvance",
     "promptGuardMode",
     "tddEnforcement",
     "tddTestGlobs",
@@ -60,7 +59,6 @@ export function createDefaultConfig(harnesses = DEFAULT_HARNESSES, defaultTrack
         version: CCLAW_VERSION,
         flowVersion: FLOW_VERSION,
         harnesses,
-        autoAdvance: false,
         promptGuardMode: "advisory",
         tddEnforcement: "advisory",
         tddTestGlobs: ["**/*.test.*", "**/*.spec.*", "**/test/**"],
@@ -81,7 +79,6 @@ export function createProfileConfig(profile, overrides = {}) {
             return {
                 ...base,
                 harnesses: overrides.harnesses ?? ["claude"],
-                autoAdvance: false,
                 promptGuardMode: "advisory",
                 tddEnforcement: "advisory",
                 gitHookGuards: false,
@@ -92,7 +89,6 @@ export function createProfileConfig(profile, overrides = {}) {
             return {
                 ...base,
                 harnesses: overrides.harnesses ?? DEFAULT_HARNESSES,
-                autoAdvance: false,
                 promptGuardMode: "advisory",
                 tddEnforcement: "advisory",
                 gitHookGuards: false,
@@ -103,7 +99,6 @@ export function createProfileConfig(profile, overrides = {}) {
             return {
                 ...base,
                 harnesses: overrides.harnesses ?? DEFAULT_HARNESSES,
-                autoAdvance: false,
                 promptGuardMode: "strict",
                 tddEnforcement: "strict",
                 gitHookGuards: true,
@@ -147,8 +142,6 @@ export async function readConfig(projectRoot) {
     const harnesses = hasHarnessesField
         ? [...new Set(validatedHarnesses)]
         : DEFAULT_HARNESSES;
-    const autoAdvanceRaw = parsed.autoAdvance;
-    const autoAdvance = typeof autoAdvanceRaw === "boolean" ? autoAdvanceRaw : false;
     const promptGuardModeRaw = parsed.promptGuardMode;
     if (Object.prototype.hasOwnProperty.call(parsed, "promptGuardMode") &&
         promptGuardModeRaw !== "advisory" &&
@@ -261,7 +254,6 @@ export async function readConfig(projectRoot) {
         version: parsed.version ?? CCLAW_VERSION,
         flowVersion: parsed.flowVersion ?? FLOW_VERSION,
         harnesses,
-        autoAdvance,
         promptGuardMode,
         tddEnforcement,
         tddTestGlobs,

package/dist/constants.d.ts

@@ -7,6 +7,6 @@ export declare const DEFAULT_HARNESSES: HarnessId[];
 export declare const REQUIRED_DIRS: readonly [".cclaw", ".cclaw/commands", ".cclaw/skills", ".cclaw/contexts", ".cclaw/templates", ".cclaw/artifacts", ".cclaw/features", ".cclaw/state", ".cclaw/runs", ".cclaw/rules", ".cclaw/adapters", ".cclaw/agents", ".cclaw/hooks", ".cclaw/custom-skills"];
 export declare const REQUIRED_GITIGNORE_PATTERNS: readonly ["# cclaw generated artifacts", ".cclaw/", ".claude/commands/cc-*.md", ".claude/commands/cc.md", ".cursor/commands/cc-*.md", ".cursor/commands/cc.md", ".opencode/commands/cc-*.md", ".opencode/commands/cc.md", ".codex/commands/cc-*.md", ".codex/commands/cc.md", ".claude/hooks/hooks.json", ".cursor/hooks.json", ".codex/hooks.json", ".opencode/plugins/cclaw-plugin.mjs", ".cursor/rules/cclaw-workflow.mdc"];
 export declare const COMMAND_FILE_ORDER: FlowStage[];
-export declare const UTILITY_COMMANDS: readonly ["learn", "next", "status", "tree", "diff", "feature", "tdd-log", "retro", "rewind", "rewind-ack"];
+export declare const UTILITY_COMMANDS: readonly ["learn", "next", "view", "status", "tree", "diff", "ops", "feature", "tdd-log", "retro", "archive", "rewind", "rewind-ack"];
 export declare const SUBAGENT_SKILL_FOLDERS: readonly ["subagent-dev", "parallel-dispatch"];
 export type UtilityCommand = (typeof UTILITY_COMMANDS)[number];

package/dist/constants.js

@@ -54,12 +54,15 @@ export const COMMAND_FILE_ORDER = [
 export const UTILITY_COMMANDS = [
     "learn",
     "next",
+    "view",
     "status",
     "tree",
     "diff",
+    "ops",
     "feature",
     "tdd-log",
     "retro",
+    "archive",
     "rewind",
     "rewind-ack"
 ];

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

@@ -0,0 +1,2 @@
+export declare function archiveCommandContract(): string;
+export declare function archiveCommandSkillMarkdown(): string;

package/dist/content/archive-command.js

@@ -0,0 +1,98 @@
+import { RUNTIME_ROOT } from "../constants.js";
+const ARCHIVE_SKILL_FOLDER = "flow-archive";
+const ARCHIVE_SKILL_NAME = "flow-archive";
+function flowStatePath() {
+    return `${RUNTIME_ROOT}/state/flow-state.json`;
+}
+function runsPath() {
+    return `${RUNTIME_ROOT}/runs`;
+}
+function activeArtifactsPath() {
+    return `${RUNTIME_ROOT}/artifacts`;
+}
+export function archiveCommandContract() {
+    return `# /cc-archive
+
+## Purpose
+
+Archive the active cclaw run from inside the harness flow (agent-first finish).
+
+This command removes the user-facing CLI gap: users can stay in \`/cc-*\` flow and
+finish with \`/cc-archive\` after ship + retro are complete.
+
+## HARD-GATE
+
+- Do not archive a shipped run when retro is still incomplete.
+- Do not manually move files between \`${activeArtifactsPath()}\` and \`${runsPath()}\`.
+- Use the archive runtime so state snapshots + manifest stay consistent.
+
+## Inputs
+
+\`/cc-archive [--name=<slug>] [--skip-retro --retro-reason=<text>]\`
+
+## Algorithm
+
+1. Read \`${flowStatePath()}\`.
+2. If ship is complete and \`retro.completedAt\` is absent:
+   - block with explicit instruction: run \`/cc-retro\` first.
+3. Build archive command:
+   - base: \`npx cclaw archive\`
+   - optional: \`--name=<slug>\`
+   - optional override: \`--skip-retro --retro-reason=<text>\`
+4. Execute archive command in project root.
+5. Surface result:
+   - archive id/path,
+   - reset stage (brainstorm/spec depending on track default),
+   - knowledge curation hint when threshold exceeded.
+
+## Output format
+
+\`\`\`
+cclaw archive
+  status: archived
+  run: <archive-id>
+  path: .cclaw/runs/<archive-id>
+  next: /cc <new-idea>
+\`\`\`
+
+## Primary skill
+
+**${RUNTIME_ROOT}/skills/${ARCHIVE_SKILL_FOLDER}/SKILL.md**
+`;
+}
+export function archiveCommandSkillMarkdown() {
+    return `---
+name: ${ARCHIVE_SKILL_NAME}
+description: "Archive the active cclaw run from harness flow and reset runtime safely."
+---
+
+# /cc-archive
+
+## HARD-GATE
+
+Never simulate archive by hand-editing runtime files. Always execute the archive
+runtime command so state snapshots and manifest generation stay atomic.
+
+## Protocol
+
+1. Read \`${flowStatePath()}\`:
+   - confirm whether ship is completed,
+   - check \`retro.completedAt\` for post-ship runs.
+2. If ship complete and retro incomplete -> stop and direct user to \`/cc-retro\`.
+3. Build shell command:
+   - \`npx cclaw archive\`
+   - append \`--name=<slug>\` when provided
+   - append \`--skip-retro --retro-reason=<text>\` only when user explicitly requests skip
+4. Run command from repo root.
+5. Relay key lines from output:
+   - archive destination under \`${runsPath()}\`
+   - flow reset confirmation
+   - knowledge curation recommendation
+
+## Validation
+
+- \`${runsPath()}\` contains a new archive folder.
+- \`${activeArtifactsPath()}\` is reset for the next run.
+- \`${flowStatePath()}\` is valid JSON and points to the initial stage.
+`;
+}

package/dist/content/contracts.js

@@ -36,7 +36,7 @@ ${schema.hardGate}
 ${hydrationLines}
 4. Stream \`.cclaw/knowledge.jsonl\` and apply relevant JSON-line entries (strict schema: type, trigger, action, confidence, domain, stage, created, project).
 5. Write stage output to ${writeStepPaths}.
-6. Do NOT copy artifacts into \`.cclaw/runs/\`; archival is handled only by \`cclaw archive\`.
+6. Do NOT copy artifacts into \`.cclaw/runs/\`; archival is handled by \`/cc-archive\` (agent-facing wrapper over archive runtime).
 
 ## Gates
 ${gateIds}

package/dist/content/harnesses-doc.js

@@ -65,13 +65,16 @@ All harnesses receive the same utility commands:
 
 - \`/cc\` - flow entry and resume
 - \`/cc-next\` - stage progression
+- \`/cc-view\` - read-only router for status/tree/diff
 - \`/cc-learn\` - knowledge capture/lookup
 - \`/cc-status\` - read-only visual flow snapshot
 - \`/cc-tree\` - deep flow tree (stages, artifacts, stale markers)
 - \`/cc-diff\` - before/after flow-state diff map
+- \`/cc-ops\` - operations router for feature/tdd-log/retro/archive/rewind
 - \`/cc-feature\` - multi-feature workspace management
 - \`/cc-tdd-log\` - explicit RED/GREEN/REFACTOR evidence log
 - \`/cc-retro\` - mandatory retrospective gate before archive
+- \`/cc-archive\` - archive active run from harness flow
 - \`/cc-rewind\` - rewind flow and invalidate downstream stages
 - \`/cc-rewind-ack\` - clear stale stage markers after redo
 

package/dist/content/hooks.js

@@ -742,7 +742,7 @@ if [ "$CHECKPOINT_WRITTEN" -eq 0 ]; then
   CHECKPOINT_NOTE="Checkpoint update failed. Review ${RUNTIME_ROOT}/state/checkpoint.json manually."
 fi
 
-RUN_SYNC_NOTE="Run metadata sync removed; active artifacts stay in ${RUNTIME_ROOT}/artifacts until cclaw archive."
+RUN_SYNC_NOTE="Run metadata sync removed; active artifacts stay in ${RUNTIME_ROOT}/artifacts until /cc-archive (or cclaw archive runtime)."
 
 # --- Escape for JSON ---
 ${ESCAPE_FN}

package/dist/content/learnings.d.ts

@@ -6,5 +6,3 @@ export declare const KNOWLEDGE_JSONL_FIELDS: readonly ["type", "trigger", "actio
 export declare function learnSkillMarkdown(): string;
 export declare function learnCommandContract(): string;
 export declare function selfImprovementBlock(stageName: string): string;
-export declare function learningsSearchPreamble(stage: string): string;
-export declare function learningsAgentsMdBlock(): string;

package/dist/content/learnings.js

@@ -137,38 +137,9 @@ Do not edit source code from this command. Only operate on \`${KNOWLEDGE_PATH}\`
 export function selfImprovementBlock(stageName) {
     return `## Operational Self-Improvement
 
-After this stage, ask:
-- Did I discover a non-obvious reusable **rule** or **pattern**?
-- Did a failure reveal a reusable **lesson**?
-
-If yes, append one concise JSON line to the canonical knowledge store
-(\`${KNOWLEDGE_PATH}\`) using the strict 8-field schema:
-
-\`\`\`bash
-TS="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-printf '%s\\n' '{"type":"pattern","trigger":"when <situation>","action":"<concrete move>","confidence":"medium","domain":null,"stage":"${stageName}","created":"'"$TS"'","project":null}' >> ${KNOWLEDGE_PATH}
-\`\`\`
-
-Type must be exactly one of: \`rule\`, \`pattern\`, \`lesson\`, \`compound\`.
-Fields must appear in the order: \`type, trigger, action, confidence, domain, stage, created, project\`.
-Missing optional values must be emitted as \`null\`, never omitted.
-`;
-}
-export function learningsSearchPreamble(stage) {
-    return `## Prior Knowledge (load at stage start)
-
-Before stage work, stream \`${KNOWLEDGE_PATH}\` and filter for entries relevant to
-this stage (\`${stage}\`), affected domains, and key constraints. Apply matching
-entries explicitly. If the file is empty, continue normally.
-`;
-}
-export function learningsAgentsMdBlock() {
-    return `### Knowledge Store
-
-\`${KNOWLEDGE_PATH}\` — append-only JSONL memory with entry types \`rule\`, \`pattern\`, \`lesson\`, \`compound\`.
-Strict 8-field schema: \`type, trigger, action, confidence, domain, stage, created, project\`.
-At session start and stage transitions, tail the file and apply relevant entries.
-If a non-obvious reusable rule/pattern/lesson is discovered, append a new line
-through \`/cc-learn add\` (never hand-edit).
+Before closeout, capture 1-3 reusable insights in \`${KNOWLEDGE_PATH}\` whenever
+the stage produced non-obvious decisions, patterns, or lessons.
+Prefer \`type=rule|pattern|lesson\` (\`compound\` stays retro-only) and set
+\`stage: "${stageName}"\` unless the insight is explicitly cross-stage.
 `;
 }

package/dist/content/meta-skill.js

@@ -3,7 +3,7 @@ export const META_SKILL_NAME = "using-cclaw";
 export function usingCclawSkillMarkdown() {
     return `---
 name: using-cclaw
-description: "Routing brain for cclaw. Decide whether to start/resume a stage, answer directly, or use utility commands like /cc-learn, /cc-status, /cc-tree, and /cc-diff."
+description: "Routing brain for cclaw. Decide whether to start/resume a stage, answer directly, or use utility commands like /cc-learn, /cc-view, and /cc-ops."
 ---
 
 # Using Cclaw
@@ -27,7 +27,8 @@ Task arrives
   ├─ New software work? -> /cc <idea>
   ├─ Resume existing flow? -> /cc or /cc-next
   ├─ Knowledge operation? -> /cc-learn
-  └─ Workspace operation? -> /cc-status, /cc-tree, /cc-diff, /cc-feature, /cc-tdd-log, /cc-retro, /cc-rewind
+  ├─ Read-only workspace view? -> /cc-view [status|tree|diff]
+  └─ Workspace operation? -> /cc-ops [feature|tdd-log|retro|archive|rewind|rewind-ack]
 \`\`\`
 
 ## Task classification

package/dist/content/next-command.js

@@ -33,7 +33,7 @@ This is the only progression command the user needs to drive the entire flow. St
 
 - **Do not** invent gate completion: use only \`${flowPath}\` plus observable evidence in repo artifacts.
 - **Do not** skip stages: advance only from \`currentStage\` to its configured successor.
-- If the flow is at the terminal stage with all ship gates satisfied, **report completion**.
+- If the flow reaches terminal ship completion, route closeout in order: **/cc-retro -> /cc-archive**.
 
 ## Algorithm (mandatory)
 
@@ -54,7 +54,10 @@ This is the only progression command the user needs to drive the entire flow. St
 
 ### Path B: Current stage IS complete (all gates passed, all delegations satisfied)
 
-→ If current stage's \`next\` is **\`done\`**: report **"Flow complete. All stages finished."** and stop.
+→ If current stage's \`next\` is **\`done\`**:
+  - if \`currentStage === "ship"\` and \`retro.completedAt\` is missing -> route to \`/cc-retro\`,
+  - if \`currentStage === "ship"\` and \`retro.completedAt\` is present -> route to \`/cc-archive\`,
+  - otherwise report **"Flow complete. All stages finished."** and stop.
 → Otherwise: load **\`${RUNTIME_ROOT}/skills/<skillFolder>/SKILL.md\`** and **\`${RUNTIME_ROOT}/commands/<nextStage>.md\`** for the successor stage. Execute that stage's protocol.
 
 ### Track-aware successor resolution
@@ -144,7 +147,11 @@ Execute the stage protocol. The stage skill handles interaction, STOP points, ga
 
 **Path B — stage IS complete (all gates met, all delegations done):**
 
-If \`next\` is \`done\` → report **"Flow complete. All stages finished."** and stop.
+If \`next\` is \`done\`:
+
+- If \`currentStage\` is \`ship\` and \`retro.completedAt\` is missing -> route to \`/cc-retro\`.
+- If \`currentStage\` is \`ship\` and \`retro.completedAt\` exists -> route to \`/cc-archive\`.
+- Otherwise report **"Flow complete. All stages finished."** and stop.
 
 Otherwise load the next stage's skill and command contract, begin execution.
 

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

@@ -0,0 +1,2 @@
+export declare function opsCommandContract(): string;
+export declare function opsCommandSkillMarkdown(): string;

package/dist/content/ops-command.js

@@ -0,0 +1,60 @@
+import { RUNTIME_ROOT } from "../constants.js";
+const OPS_SKILL_FOLDER = "flow-ops";
+const OPS_SKILL_NAME = "flow-ops";
+export function opsCommandContract() {
+    return `# /cc-ops
+
+## Purpose
+
+Unified operational command surface for non-stage flow actions.
+
+Subcommands:
+- \`feature\` -> \`/cc-feature\`
+- \`tdd-log\` -> \`/cc-tdd-log\`
+- \`retro\` -> \`/cc-retro\`
+- \`archive\` -> \`/cc-archive\`
+- \`rewind\` -> \`/cc-rewind\`
+- \`rewind-ack\` -> \`/cc-rewind-ack\`
+
+## HARD-GATE
+
+- \`/cc-ops\` is a routing wrapper; execute only one target subcommand per call.
+- Preserve target command safety contracts (retro gate, archive gate, rewind atomicity, etc.).
+
+## Routing
+
+1. Parse required subcommand token.
+2. Dispatch:
+   - \`feature\` -> \`${RUNTIME_ROOT}/commands/feature.md\`
+   - \`tdd-log\` -> \`${RUNTIME_ROOT}/commands/tdd-log.md\`
+   - \`retro\` -> \`${RUNTIME_ROOT}/commands/retro.md\`
+   - \`archive\` -> \`${RUNTIME_ROOT}/commands/archive.md\`
+   - \`rewind\` -> \`${RUNTIME_ROOT}/commands/rewind.md\`
+   - \`rewind-ack\` -> \`${RUNTIME_ROOT}/commands/rewind-ack.md\`
+3. Unknown subcommand -> print supported values and stop.
+
+## Primary skill
+
+**${RUNTIME_ROOT}/skills/${OPS_SKILL_FOLDER}/SKILL.md**
+`;
+}
+export function opsCommandSkillMarkdown() {
+    return `---
+name: ${OPS_SKILL_NAME}
+description: "Unified operational router for feature/tdd-log/retro/archive/rewind commands."
+---
+
+# /cc-ops
+
+## HARD-GATE
+
+This wrapper only dispatches. It must not apply state mutations itself.
+
+## Protocol
+
+1. Require a subcommand (\`feature|tdd-log|retro|archive|rewind|rewind-ack\`).
+2. Route to the matching command contract + skill pair.
+3. Preserve pass-through args after the subcommand (e.g. \`/cc-ops rewind design\`).
+4. Echo which subcommand was dispatched for auditability.
+`;
+}

package/dist/content/protocols.js

@@ -46,8 +46,20 @@ Shared closeout sequence applied by every stage skill.
    - update \`guardEvidence\`.
 3. Persist stage artifact under \`.cclaw/artifacts/\`.
 4. Run \`npx cclaw doctor\` and resolve failures.
-5. Notify user with stage completion and next action (\`/cc-next\`).
-6. Stop; do not auto-run the next stage unless user asks.
+5. Capture reusable learnings from this stage artifact:
+   - append 1-3 strict-schema JSONL entries when the stage produced non-obvious
+     decisions, patterns, or lessons,
+   - use \`type=rule|pattern|lesson\` (\`compound\` stays retro-focused).
+6. Notify user with stage completion and next action (\`/cc-next\`).
+7. Stop; do not auto-run the next stage unless user asks.
+
+## Automatic learning capture policy
+
+- \`standard\` / \`medium\` tracks: required for \`design\`, \`tdd\`, and \`review\`;
+  recommended for other stages.
+- \`quick\` track: recommended only (avoid overhead for tiny fixes).
+- "No learning captured" is acceptable only when explicitly justified (e.g. pure
+  mechanical change, no new trade-offs).
 
 ## Resume protocol
 

package/dist/content/retro-command.js

@@ -36,7 +36,7 @@ Mandatory retrospective gate before archive once ship is complete.
    - \`required: true\`
    - \`completedAt: <ISO>\`
    - \`compoundEntries: <count>\`
-5. Report completion summary and remind user that \`cclaw archive\` is now unblocked.
+5. Report completion summary and remind user that \`/cc-archive\` is now unblocked.
 
 ## Primary skill
 

package/dist/content/skills.js

@@ -1,5 +1,6 @@
 import { RUNTIME_ROOT } from "../constants.js";
 import { STAGE_EXAMPLES_REFERENCE_DIR, stageDomainExamples, stageExamples, stageGoodBadExamples } from "./examples.js";
+import { selfImprovementBlock } from "./learnings.js";
 import { STAGE_COMMON_GUIDANCE_REL_PATH } from "./stage-common-guidance.js";
 import { stageAutoSubagentDispatch, stageSchema } from "./stage-schema.js";
 const VERIFICATION_STAGES = ["tdd", "review", "ship"];
@@ -377,6 +378,7 @@ ${mergedAntiPatterns(schema)}
 ## Verification
 ${schema.exitCriteria.map((item) => `- [ ] ${item}`).join("\n")}
 
+${selfImprovementBlock(schema.stage)}
 ${completionParametersBlock(schema)}
 ## Shared Stage Guidance
 See:

package/dist/content/stage-common-guidance.js

@@ -59,7 +59,8 @@ Rollback / fallback: <if decision proves wrong>
 ## Self-improvement reminder
 
 If a reusable lesson appears during the stage, append one strict-schema JSONL
-entry via \`/cc-learn add\`. Do not keep operational lessons only in chat.
+entry (manually via \`/cc-learn add\` or directly in stage closeout protocol).
+Do not keep operational lessons only in chat.
 
 ## Progressive disclosure baseline
 

package/dist/content/templates.d.ts

@@ -1,4 +1,4 @@
 export declare const ARTIFACT_TEMPLATES: Record<string, string>;
 export declare const RULEBOOK_MARKDOWN = "# Cclaw Rulebook\n\n## MUST_ALWAYS\n- Follow flow order: brainstorm -> scope -> design -> spec -> plan -> tdd -> review -> ship\n- Require explicit user confirmation after plan before TDD\n- Keep evidence artifacts in `.cclaw/artifacts/`\n- Enforce RED before GREEN in TDD\n- Run two-layer review (spec_compliance and code_quality) before ship\n- Validate all inputs before processing \u2014 never trust external data without sanitization\n- Prefer immutable data patterns and pure functions where the language supports them\n- Follow existing repo conventions, patterns, and directory structure \u2014 match the codebase\n- Verify claims with fresh evidence: \"tests pass\" requires running tests in this message\n- Use conventional commits: `type(scope): description` (feat, fix, refactor, test, docs, chore)\n\n## MUST_NEVER\n- Skip RED phase and jump directly to GREEN in TDD\n- Ship with critical review findings\n- Start implementation during /brainstorm\n- Modify generated cclaw files manually when CLI can regenerate them\n- Commit `.cclaw/` or generated shim files\n- Expose secrets, tokens, API keys, or absolute system paths in agent output\n- Duplicate existing functionality without explicit justification \u2014 search before building\n- Bypass security checks, linting hooks, or type checking to \"move faster\"\n- Claim success (\"Done,\" \"All good,\" \"Tests pass\") without running verification in this message\n- Make changes outside the blast radius of the current task without user consent\n\n## DELEGATION\nWhen a task requires specialist knowledge (security audit, performance profiling, database review),\ndelegate to a specialized agent or skill if the harness supports it. The primary agent should:\n1. Identify the specialist domain\n2. Provide focused context (relevant files, the specific concern)\n3. Evaluate the specialist output before acting on it \u2014 do not blindly apply recommendations\n";
-export declare const CURSOR_WORKFLOW_RULE_MDC = "---\ndescription: cclaw workflow guardrails for Cursor agent sessions\nglobs:\n  - \"**/*\"\nalwaysApply: true\n---\n\n<!-- cclaw-managed-cursor-workflow-rule -->\n\n# Cclaw Workflow Guardrails\n\n## Activation Rule\n\nBefore responding to coding work:\n1. Read `.cclaw/state/flow-state.json`.\n2. Start with `/cc` or continue with `/cc-next`.\n3. If no software-stage flow applies, respond normally.\n\n## Stage Order\n\n`brainstorm -> scope -> design -> spec -> plan -> tdd -> review -> ship`\n\nTrack-specific skips are allowed only when `flow-state.track` + `skippedStages` explicitly say so.\n\n## Task Classification\n\n| Class | Route |\n|---|---|\n| non-trivial software work | `/cc <idea>` |\n| trivial software fix | `/cc <idea>` (quick or medium track) |\n| bugfix with repro | `/cc <idea>` and enforce RED-first in tdd |\n| pure question / non-software | direct answer (no stage flow) |\n\n## Command Surface\n\n- `/cc` = entry and resume.\n- `/cc-next` = only progression path.\n- `/cc-learn` = knowledge capture and recall.\n\n## Verification Discipline\n\n- No completion claim without fresh command evidence in this turn.\n- Do not mark gates passed from memory.\n- Keep evidence in `.cclaw/artifacts/`; archive only via `cclaw archive`.\n\n## Delegation And Approvals\n\n- Machine-only checks in design/plan/tdd/review/ship should auto-dispatch when tooling supports it.\n- Ask for user input only at explicit approval gates (scope mode, plan approval, challenge resolution, ship finalization).\n- If harness capabilities are partial, record waiver reasons in delegation logs.\n\n## Routing Source Of Truth\n\n- Primary router: `.cclaw/skills/using-cclaw/SKILL.md`.\n- Protocols: `.cclaw/references/protocols/*.md`.\n- Preamble budget: `.cclaw/references/protocols/ethos.md`.\n";
+export declare const CURSOR_WORKFLOW_RULE_MDC = "---\ndescription: cclaw workflow guardrails for Cursor agent sessions\nglobs:\n  - \"**/*\"\nalwaysApply: true\n---\n\n<!-- cclaw-managed-cursor-workflow-rule -->\n\n# Cclaw Workflow Guardrails\n\n## Activation Rule\n\nBefore responding to coding work:\n1. Read `.cclaw/state/flow-state.json`.\n2. Start with `/cc` or continue with `/cc-next`.\n3. If no software-stage flow applies, respond normally.\n\n## Stage Order\n\n`brainstorm -> scope -> design -> spec -> plan -> tdd -> review -> ship`\n\nTrack-specific skips are allowed only when `flow-state.track` + `skippedStages` explicitly say so.\n\n## Task Classification\n\n| Class | Route |\n|---|---|\n| non-trivial software work | `/cc <idea>` |\n| trivial software fix | `/cc <idea>` (quick or medium track) |\n| bugfix with repro | `/cc <idea>` and enforce RED-first in tdd |\n| pure question / non-software | direct answer (no stage flow) |\n\n## Command Surface\n\n- `/cc` = entry and resume.\n- `/cc-next` = only progression path.\n- `/cc-learn` = knowledge capture and recall.\n\n## Verification Discipline\n\n- No completion claim without fresh command evidence in this turn.\n- Do not mark gates passed from memory.\n- Keep evidence in `.cclaw/artifacts/`; archive via `/cc-archive` (agent flow) or archive runtime.\n\n## Delegation And Approvals\n\n- Machine-only checks in design/plan/tdd/review/ship should auto-dispatch when tooling supports it.\n- Ask for user input only at explicit approval gates (scope mode, plan approval, challenge resolution, ship finalization).\n- If harness capabilities are partial, record waiver reasons in delegation logs.\n\n## Routing Source Of Truth\n\n- Primary router: `.cclaw/skills/using-cclaw/SKILL.md`.\n- Protocols: `.cclaw/references/protocols/*.md`.\n- Preamble budget: `.cclaw/references/protocols/ethos.md`.\n";
 export declare function buildRulesJson(): Record<string, unknown>;

package/dist/content/templates.js

@@ -593,7 +593,7 @@ Track-specific skips are allowed only when \`flow-state.track\` + \`skippedStage
 
 - No completion claim without fresh command evidence in this turn.
 - Do not mark gates passed from memory.
-- Keep evidence in \`.cclaw/artifacts/\`; archive only via \`cclaw archive\`.
+- Keep evidence in \`.cclaw/artifacts/\`; archive via \`/cc-archive\` (agent flow) or archive runtime.
 
 ## Delegation And Approvals
 

package/dist/content/utility-skills.js

@@ -771,7 +771,7 @@ description: "Read-only curation pass over the canonical strict-JSONL knowledge
 ## When to run
 
 - Triggered automatically by **\`/cc-learn curate\`**.
-- Recommended after \`cclaw archive\` of a feature run, when knowledge has grown.
+- Recommended after \`/cc-archive\` (or archive runtime) of a feature run, when knowledge has grown.
 - Recommended when active entry count exceeds **50**.
 
 ## Audit dimensions

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

@@ -0,0 +1,2 @@
+export declare function viewCommandContract(): string;
+export declare function viewCommandSkillMarkdown(): string;

package/dist/content/view-command.js

@@ -0,0 +1,57 @@
+import { RUNTIME_ROOT } from "../constants.js";
+const VIEW_SKILL_FOLDER = "flow-view";
+const VIEW_SKILL_NAME = "flow-view";
+export function viewCommandContract() {
+    return `# /cc-view
+
+## Purpose
+
+Unified read-only command surface for flow visibility.
+
+Subcommands:
+- \`/cc-view\` or \`/cc-view status\` -> status snapshot
+- \`/cc-view tree\` -> structural flow tree
+- \`/cc-view diff\` -> baseline delta map
+
+## HARD-GATE
+
+- \`/cc-view\` is strictly read-only at wrapper level.
+- Do not mutate flow-state unless routing to \`diff\` (which updates snapshot baseline by design).
+
+## Routing
+
+1. Parse subcommand (default \`status\`).
+2. Route:
+   - \`status\` -> load \`${RUNTIME_ROOT}/commands/status.md\` + \`${RUNTIME_ROOT}/skills/flow-status/SKILL.md\`
+   - \`tree\` -> load \`${RUNTIME_ROOT}/commands/tree.md\` + \`${RUNTIME_ROOT}/skills/flow-tree/SKILL.md\`
+   - \`diff\` -> load \`${RUNTIME_ROOT}/commands/diff.md\` + \`${RUNTIME_ROOT}/skills/flow-diff/SKILL.md\`
+3. Unknown subcommand -> print supported values and stop.
+
+## Primary skill
+
+**${RUNTIME_ROOT}/skills/${VIEW_SKILL_FOLDER}/SKILL.md**
+`;
+}
+export function viewCommandSkillMarkdown() {
+    return `---
+name: ${VIEW_SKILL_NAME}
+description: "Unified read-only view router for status/tree/diff flow visibility commands."
+---
+
+# /cc-view
+
+## HARD-GATE
+
+Wrapper is read-only and dispatch-only. It must not mutate flow state directly.
+
+## Protocol
+
+1. Parse optional subcommand token:
+   - missing -> \`status\`
+   - \`status\` -> dispatch to \`/cc-status\`
+   - \`tree\` -> dispatch to \`/cc-tree\`
+   - \`diff\` -> dispatch to \`/cc-diff\`
+2. Execute the target command contract and skill.
+3. Return concise output and suggest \`/cc-view <subcommand>\` variants for navigation.
+`;
+}

package/dist/doctor-registry.js

@@ -119,9 +119,9 @@ export function doctorCheckMetadata(checkName) {
         }
     }
     return {
-        severity: "error",
-        summary: "Doctor runtime integrity check.",
-        fix: "Inspect check details, apply the suggested remediation, and re-run `cclaw doctor`.",
+        severity: "warning",
+        summary: "Unclassified doctor check.",
+        fix: "Review the check details and add a matching rule in doctor-registry when this check should be severity-scoped.",
         docRef: ref("README.md")
     };
 }

package/dist/harness-adapters.js

@@ -18,6 +18,12 @@ const UTILITY_SHIMS = [
         skillFolder: "flow-next-step",
         commandFile: "next.md"
     },
+    {
+        fileName: "cc-view.md",
+        command: "view",
+        skillFolder: "flow-view",
+        commandFile: "view.md"
+    },
     {
         fileName: "cc-learn.md",
         command: "learn",
@@ -42,6 +48,12 @@ const UTILITY_SHIMS = [
         skillFolder: "flow-diff",
         commandFile: "diff.md"
     },
+    {
+        fileName: "cc-ops.md",
+        command: "ops",
+        skillFolder: "flow-ops",
+        commandFile: "ops.md"
+    },
     {
         fileName: "cc-feature.md",
         command: "feature",
@@ -60,6 +72,12 @@ const UTILITY_SHIMS = [
         skillFolder: "flow-retro",
         commandFile: "retro.md"
     },
+    {
+        fileName: "cc-archive.md",
+        command: "archive",
+        skillFolder: "flow-archive",
+        commandFile: "archive.md"
+    },
     {
         fileName: "cc-rewind.md",
         command: "rewind",
@@ -166,13 +184,16 @@ When in doubt, prefer **non-trivial** — the quick track is opt-in and only saf
 |---|---|
 | \`/cc\` | **Entry point.** No args = resume current stage. With prompt = classify task and start the right flow. |
 | \`/cc-next\` | **Progression.** Advances to the next stage when current is complete. |
+| \`/cc-view\` | **Read-only router.** Unified entry for status/tree/diff views. |
 | \`/cc-learn\` | **Cross-cutting.** Capture or review project knowledge (append-only JSONL). |
 | \`/cc-status\` | **Read-only.** Visual snapshot with progress bar, gate delta, and delegations. |
 | \`/cc-tree\` | **Read-only.** Deep flow tree for stages, artifacts, and stale markers. |
 | \`/cc-diff\` | **Delta map.** Compare current flow-state with saved baseline snapshot. |
+| \`/cc-ops\` | **Operations router.** Unified entry for feature/tdd-log/retro/archive/rewind actions. |
 | \`/cc-feature\` | **Workspace.** Manage active feature snapshots for parallel tracks. |
 | \`/cc-tdd-log\` | **Evidence.** Record RED/GREEN/REFACTOR cycle events for enforcement. |
 | \`/cc-retro\` | **Learning gate.** Mandatory retrospective before archive after ship. |
+| \`/cc-archive\` | **Run finalization.** Archive active flow into \`.cclaw/runs/\` and reset runtime. |
 | \`/cc-rewind\` | **Recovery.** Rewind flow to an earlier stage and invalidate downstream work. |
 | \`/cc-rewind-ack\` | **Recovery.** Clear stale-stage markers after redo. |
 

package/dist/install.js

@@ -12,9 +12,12 @@ import { startCommandContract, startCommandSkillMarkdown } from "./content/start
 import { statusCommandContract, statusCommandSkillMarkdown } from "./content/status-command.js";
 import { treeCommandContract, treeCommandSkillMarkdown } from "./content/tree-command.js";
 import { diffCommandContract, diffCommandSkillMarkdown } from "./content/diff-command.js";
+import { viewCommandContract, viewCommandSkillMarkdown } from "./content/view-command.js";
+import { opsCommandContract, opsCommandSkillMarkdown } from "./content/ops-command.js";
 import { featureCommandContract, featureCommandSkillMarkdown } from "./content/feature-command.js";
 import { tddLogCommandContract, tddLogCommandSkillMarkdown } from "./content/tdd-log-command.js";
 import { retroCommandContract, retroCommandSkillMarkdown } from "./content/retro-command.js";
+import { archiveCommandContract, archiveCommandSkillMarkdown } from "./content/archive-command.js";
 import { rewindAcknowledgeCommandContract, rewindCommandContract, rewindCommandSkillMarkdown } from "./content/rewind-command.js";
 import { subagentDrivenDevSkill, parallelAgentsSkill } from "./content/subagents.js";
 import { sessionHooksSkillMarkdown } from "./content/session-hooks.js";
@@ -202,13 +205,16 @@ async function writeSkills(projectRoot, config) {
     await writeFileSafe(runtimePath(projectRoot, "skills", "learnings", "SKILL.md"), learnSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "flow-next-step", "SKILL.md"), nextCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "flow-start", "SKILL.md"), startCommandSkillMarkdown());
+    await writeFileSafe(runtimePath(projectRoot, "skills", "flow-view", "SKILL.md"), viewCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "flow-status", "SKILL.md"), statusCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "flow-tree", "SKILL.md"), treeCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "flow-diff", "SKILL.md"), diffCommandSkillMarkdown());
+    await writeFileSafe(runtimePath(projectRoot, "skills", "flow-ops", "SKILL.md"), opsCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "feature-workspaces", "SKILL.md"), featureCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "tdd-cycle-log", "SKILL.md"), tddLogCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "flow-retro", "SKILL.md"), retroCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "flow-rewind", "SKILL.md"), rewindCommandSkillMarkdown());
+    await writeFileSafe(runtimePath(projectRoot, "skills", "flow-archive", "SKILL.md"), archiveCommandSkillMarkdown());
     await writeFileSafe(runtimePath(projectRoot, "skills", "subagent-dev", "SKILL.md"), subagentDrivenDevSkill());
     await writeFileSafe(runtimePath(projectRoot, "skills", "parallel-dispatch", "SKILL.md"), parallelAgentsSkill());
     await writeFileSafe(runtimePath(projectRoot, "skills", "session", "SKILL.md"), sessionHooksSkillMarkdown());
@@ -260,13 +266,16 @@ async function writeSkills(projectRoot, config) {
 async function writeUtilityCommands(projectRoot) {
     await writeFileSafe(runtimePath(projectRoot, "commands", "learn.md"), learnCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "next.md"), nextCommandContract());
+    await writeFileSafe(runtimePath(projectRoot, "commands", "view.md"), viewCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "start.md"), startCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "status.md"), statusCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "tree.md"), treeCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "diff.md"), diffCommandContract());
+    await writeFileSafe(runtimePath(projectRoot, "commands", "ops.md"), opsCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "feature.md"), featureCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "tdd-log.md"), tddLogCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "retro.md"), retroCommandContract());
+    await writeFileSafe(runtimePath(projectRoot, "commands", "archive.md"), archiveCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "rewind.md"), rewindCommandContract());
     await writeFileSafe(runtimePath(projectRoot, "commands", "rewind-ack.md"), rewindAcknowledgeCommandContract());
 }

package/dist/types.d.ts

@@ -57,8 +57,6 @@ export interface VibyConfig {
     version: string;
     flowVersion: string;
     harnesses: HarnessId[];
-    /** When true, stage skills instruct the agent to continue to the following stage after gates pass. */
-    autoAdvance?: boolean;
     /** Prompt guard behavior for runtime write-risk detection hooks. */
     promptGuardMode?: "advisory" | "strict";
     /** TDD red->green->refactor enforcement mode used by workflow guard hooks. */

package/package.json

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