cclaw-cli 0.13.0 → 0.15.0

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 \`${RUNTIME_ROOT}/commands/status.md\`
+   - \`tree\` -> dispatch to \`${RUNTIME_ROOT}/commands/tree.md\`
+   - \`diff\` -> dispatch to \`${RUNTIME_ROOT}/commands/diff.md\`
+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

@@ -58,7 +58,7 @@ const RULES = [
         }
     },
     {
-        test: /^(hook:|lifecycle:|git_hooks:)/,
+        test: /^(hook:|hooks:|lifecycle:|git_hooks:)/,
         metadata: {
             severity: "error",
             summary: "Hook wiring and lifecycle integration check.",
@@ -67,7 +67,7 @@ const RULES = [
         }
     },
     {
-        test: /^(shim:|agents:cclaw_block|rules:cursor:workflow)/,
+        test: /^(shim:|agents:cclaw_block|rules:cursor:)/,
         metadata: {
             severity: "error",
             summary: "Harness shim and routing file consistency check.",
@@ -84,6 +84,24 @@ const RULES = [
             docRef: ref("state-and-gates.md")
         }
     },
+    {
+        test: /^(knowledge:|artifacts:|runs:)/,
+        metadata: {
+            severity: "error",
+            summary: "Knowledge and artifact runtime integrity check.",
+            fix: "Restore missing runtime files under `.cclaw/` or re-run `cclaw sync`.",
+            docRef: ref("runtime-layout.md")
+        }
+    },
+    {
+        test: /^(meta_skill:|protocol:|stage_skill:|context_mode:)/,
+        metadata: {
+            severity: "error",
+            summary: "Routing skill and protocol integrity check.",
+            fix: "Regenerate runtime references and skills via `cclaw sync`, then re-run doctor.",
+            docRef: ref("harness-and-routing.md")
+        }
+    },
     {
         test: /^delegation:/,
         metadata: {
@@ -120,8 +138,8 @@ 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`.",
+        summary: "Unclassified doctor check.",
+        fix: "Report this check name to cclaw maintainers so doctor-registry can classify it explicitly.",
         docRef: ref("README.md")
     };
 }

package/dist/doctor.js

@@ -8,7 +8,7 @@ import { CCLAW_AGENTS } from "./content/core-agents.js";
 import { readConfig } from "./config.js";
 import { exists } from "./fs-utils.js";
 import { gitignoreHasRequiredPatterns } from "./gitignore.js";
-import { HARNESS_ADAPTERS, CCLAW_MARKER_START, CCLAW_MARKER_END } from "./harness-adapters.js";
+import { HARNESS_ADAPTERS, CCLAW_MARKER_START, CCLAW_MARKER_END, harnessShimFileNames } from "./harness-adapters.js";
 import { policyChecks } from "./policy.js";
 import { readFlowState } from "./runs.js";
 import { skippedStagesForTrack } from "./flow-state.js";
@@ -447,19 +447,7 @@ export async function doctorChecks(projectRoot, options = {}) {
             });
             continue;
         }
-        for (const shim of [
-            "cc.md",
-            "cc-next.md",
-            "cc-learn.md",
-            "cc-status.md",
-            "cc-tree.md",
-            "cc-diff.md",
-            "cc-feature.md",
-            "cc-tdd-log.md",
-            "cc-retro.md",
-            "cc-rewind.md",
-            "cc-rewind-ack.md"
-        ]) {
+        for (const shim of harnessShimFileNames()) {
             const shimPath = path.join(projectRoot, adapter.commandDir, shim);
             checks.push({
                 name: `shim:${harness}:${shim.replace(".md", "")}`,
@@ -476,14 +464,8 @@ export async function doctorChecks(projectRoot, options = {}) {
         const hasCcCommand = content.includes("/cc");
         const hasCcNext = content.includes("/cc-next");
         const hasCcLearn = content.includes("/cc-learn");
-        const hasCcStatus = content.includes("/cc-status");
-        const hasCcTree = content.includes("/cc-tree");
-        const hasCcDiff = content.includes("/cc-diff");
-        const hasCcFeature = content.includes("/cc-feature");
-        const hasCcTddLog = content.includes("/cc-tdd-log");
-        const hasCcRetro = content.includes("/cc-retro");
-        const hasCcRewind = content.includes("/cc-rewind");
-        const hasCcRewindAck = content.includes("/cc-rewind-ack");
+        const hasCcView = content.includes("/cc-view");
+        const hasCcOps = content.includes("/cc-ops");
         const hasVerification = content.includes("Verification Discipline");
         const hasMinimalMarker = content.includes("intentionally minimal for cross-project use");
         const hasMetaSkillPointer = content.includes(".cclaw/skills/using-cclaw/SKILL.md");
@@ -491,14 +473,8 @@ export async function doctorChecks(projectRoot, options = {}) {
             && hasCcCommand
             && hasCcNext
             && hasCcLearn
-            && hasCcStatus
-            && hasCcTree
-            && hasCcDiff
-            && hasCcFeature
-            && hasCcTddLog
-            && hasCcRetro
-            && hasCcRewind
-            && hasCcRewindAck
+            && hasCcView
+            && hasCcOps
             && hasVerification
             && hasMinimalMarker
             && hasMetaSkillPointer;
@@ -1067,7 +1043,7 @@ export async function doctorChecks(projectRoot, options = {}) {
         ok: staleStages.length === 0,
         details: staleStages.length === 0
             ? "no stale stages pending acknowledgement"
-            : `stale stages must be acknowledged via /cc-rewind-ack: ${staleStages.join(", ")}`
+            : `stale stages must be acknowledged via /cc-ops rewind-ack: ${staleStages.join(", ")}`
     });
     const retroRequired = flowState.completedStages.includes("ship");
     const retroComplete = !retroRequired ||
@@ -1079,7 +1055,7 @@ export async function doctorChecks(projectRoot, options = {}) {
             ? retroRequired
                 ? `retro gate complete (${flowState.retro.compoundEntries} compound entries)`
                 : "retro gate not required yet (ship not completed)"
-            : "retro gate incomplete: run /cc-retro and record at least one compound knowledge entry"
+            : "retro gate incomplete: run /cc-ops retro and record at least one compound knowledge entry"
     });
     const flowSnapshotPath = path.join(projectRoot, RUNTIME_ROOT, "state", "flow-state.snapshot.json");
     const flowSnapshotExists = await exists(flowSnapshotPath);

package/dist/harness-adapters.d.ts

@@ -10,6 +10,7 @@ export interface HarnessAdapter {
         structuredAsk: "AskUserQuestion" | "AskQuestion" | "plain-text";
     };
 }
+export declare function harnessShimFileNames(): string[];
 export declare const HARNESS_ADAPTERS: Record<HarnessId, HarnessAdapter>;
 export type HarnessTier = "tier1" | "tier2" | "tier3";
 export declare function harnessTier(harnessId: HarnessId): HarnessTier;

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",
@@ -25,54 +31,15 @@ const UTILITY_SHIMS = [
         commandFile: "learn.md"
     },
     {
-        fileName: "cc-status.md",
-        command: "status",
-        skillFolder: "flow-status",
-        commandFile: "status.md"
-    },
-    {
-        fileName: "cc-tree.md",
-        command: "tree",
-        skillFolder: "flow-tree",
-        commandFile: "tree.md"
-    },
-    {
-        fileName: "cc-diff.md",
-        command: "diff",
-        skillFolder: "flow-diff",
-        commandFile: "diff.md"
-    },
-    {
-        fileName: "cc-feature.md",
-        command: "feature",
-        skillFolder: "feature-workspaces",
-        commandFile: "feature.md"
-    },
-    {
-        fileName: "cc-tdd-log.md",
-        command: "tdd-log",
-        skillFolder: "tdd-cycle-log",
-        commandFile: "tdd-log.md"
-    },
-    {
-        fileName: "cc-retro.md",
-        command: "retro",
-        skillFolder: "flow-retro",
-        commandFile: "retro.md"
-    },
-    {
-        fileName: "cc-rewind.md",
-        command: "rewind",
-        skillFolder: "flow-rewind",
-        commandFile: "rewind.md"
-    },
-    {
-        fileName: "cc-rewind-ack.md",
-        command: "rewind-ack",
-        skillFolder: "flow-rewind",
-        commandFile: "rewind-ack.md"
+        fileName: "cc-ops.md",
+        command: "ops",
+        skillFolder: "flow-ops",
+        commandFile: "ops.md"
     }
 ];
+export function harnessShimFileNames() {
+    return ["cc.md", ...UTILITY_SHIMS.map((shim) => shim.fileName)];
+}
 export const HARNESS_ADAPTERS = {
     claude: {
         id: "claude",
@@ -166,15 +133,9 @@ 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-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-rewind\` | **Recovery.** Rewind flow to an earlier stage and invalidate downstream work. |
-| \`/cc-rewind-ack\` | **Recovery.** Clear stale-stage markers after redo. |
+| \`/cc-ops\` | **Operations router.** Unified entry for feature/tdd-log/retro/archive/rewind actions. |
 
 **Stage order:** brainstorm > scope > design > spec > plan > tdd > review > ship.
 \`/cc-next\` loads the right stage skill automatically. Gates must pass before handoff.

package/dist/install.js

@@ -2,7 +2,7 @@ import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { promisify } from "node:util";
-import { COMMAND_FILE_ORDER, REQUIRED_DIRS, RUNTIME_ROOT, UTILITY_COMMANDS } from "./constants.js";
+import { COMMAND_FILE_ORDER, REQUIRED_DIRS, RUNTIME_ROOT } from "./constants.js";
 import { writeConfig, createDefaultConfig, createProfileConfig, readConfig, configPath } from "./config.js";
 import { commandContract } from "./content/contracts.js";
 import { contextModeFiles, createInitialContextModeState } from "./content/contexts.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";
@@ -35,7 +38,7 @@ import { HOOK_EVENTS_BY_HARNESS, HOOK_SEMANTIC_EVENTS } from "./content/hook-eve
 import { createInitialFlowState } from "./flow-state.js";
 import { ensureDir, exists, writeFileSafe } from "./fs-utils.js";
 import { ensureGitignore, removeGitignorePatterns } from "./gitignore.js";
-import { HARNESS_ADAPTERS, harnessTier, syncHarnessShims, removeCclawFromAgentsMd } from "./harness-adapters.js";
+import { HARNESS_ADAPTERS, harnessShimFileNames, harnessTier, syncHarnessShims, removeCclawFromAgentsMd } from "./harness-adapters.js";
 import { validateHookDocument } from "./hook-schema.js";
 import { ensureRunSystem, readFlowState } from "./runs.js";
 const OPENCODE_PLUGIN_REL_PATH = ".opencode/plugins/cclaw-plugin.mjs";
@@ -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());
 }
@@ -695,7 +704,7 @@ version: 0.1.0                         # semver; bump when hardGate or algorithm
 
 | Field | Type | Required | Meaning |
 |---|---|---|---|
-| \`name\` | string (kebab-case) | yes | Unique id used by the router and by \`/cc-status\` diagnostics. |
+| \`name\` | string (kebab-case) | yes | Unique id used by the router and by \`/cc-view status\` diagnostics. |
 | \`description\` | string ≤180 chars (single line OR YAML \`>\` folded) | yes | Drives semantic routing. Include trigger + action. |
 | \`stages\` | array of flow stages | no | When present, the meta-skill only surfaces this skill during those stages. Omit for "any stage". |
 | \`triggers\` | array of strings | no | Extra literal substrings that route to this skill when found in the user prompt or the active artifact. |
@@ -1000,13 +1009,7 @@ async function cleanLegacyArtifacts(projectRoot) {
     }
 }
 async function cleanStaleFiles(projectRoot) {
-    const expectedShimFiles = new Set([
-        ...COMMAND_FILE_ORDER.map((stage) => `viby-${stage}.md`),
-        ...UTILITY_COMMANDS.map((cmd) => `viby-${cmd}.md`),
-        ...COMMAND_FILE_ORDER.map((stage) => `cc-${stage}.md`),
-        ...UTILITY_COMMANDS.map((cmd) => `cc-${cmd}.md`),
-        "cc.md"
-    ]);
+    const expectedShimFiles = new Set(harnessShimFileNames());
     for (const adapter of Object.values(HARNESS_ADAPTERS)) {
         const commandDir = path.join(projectRoot, adapter.commandDir);
         if (!(await exists(commandDir)))

package/dist/policy.js

@@ -91,7 +91,7 @@ export async function policyChecks(projectRoot, options = {}) {
         { file: runtimeFile("skills/learnings/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:learnings:hard_gate" },
         { file: runtimeFile("commands/learn.md"), needle: "## Subcommands", name: "utility_command:learn:subcommands" },
         { file: runtimeFile("commands/status.md"), needle: "bar:", name: "utility_command:status:visual_bar" },
-        { file: runtimeFile("commands/status.md"), needle: "/cc-tree · /cc-diff", name: "utility_command:status:tree_diff_link" },
+        { file: runtimeFile("commands/status.md"), needle: "/cc-view tree · /cc-view diff", name: "utility_command:status:tree_diff_link" },
         { file: runtimeFile("commands/tree.md"), needle: "## Algorithm", name: "utility_command:tree:algorithm" },
         { file: runtimeFile("skills/flow-tree/SKILL.md"), needle: "## Protocol", name: "utility_skill:tree:protocol" },
         { file: runtimeFile("skills/flow-tree/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:tree:hard_gate" },

package/dist/runs.js

@@ -564,7 +564,7 @@ export async function archiveRun(projectRoot, featureName, options = {}) {
     }
     if (retroGate.required && !retroGate.completed && !skipRetro) {
         throw new Error("Archive blocked: retro gate is required after ship completion. " +
-            "Run /cc-retro and append at least one compound knowledge entry, or re-run archive with --skip-retro and --retro-reason.");
+            "Run /cc-ops retro and append at least one compound knowledge entry, or re-run /cc-ops archive with --skip-retro and --retro-reason.");
     }
     if (retroGate.completed) {
         const completedAt = sourceState.retro.completedAt ?? new Date().toISOString();

package/dist/types.d.ts

@@ -57,13 +57,11 @@ 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. */
     tddEnforcement?: "advisory" | "strict";
-    /** Optional test file globs used by guard guidance and /cc-tdd-log docs. */
+    /** Optional test file globs used by guard guidance and /cc-ops tdd-log docs. */
     tddTestGlobs?: string[];
     /** When true, cclaw installs managed git pre-commit/pre-push wrappers. */
     gitHookGuards?: boolean;

package/package.json

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