cclaw-cli 1.0.0 → 3.0.0

package/dist/content/hook-events.js

@@ -8,11 +8,7 @@ export { HOOK_SEMANTIC_EVENTS } from "./hook-manifest.js";
  */
 const OPENCODE_SEMANTIC_COVERAGE = {
     session_rehydrate: "plugin event handlers + transform rehydration",
-    pre_tool_prompt_guard: "plugin tool.execute.before -> prompt-guard",
-    pre_tool_workflow_guard: "plugin tool.execute.before -> workflow-guard",
-    post_tool_context_monitor: "plugin tool.execute.after -> context-monitor",
-    stop_handoff: "plugin session.idle -> stop-handoff",
-    precompact_compat: "plugin session.compacted -> pre-compact"
+    stop_handoff: "plugin session.idle -> stop-handoff"
 };
 /**
  * Public semantic coverage map derived from `HOOK_MANIFEST` for

package/dist/content/hook-manifest.d.ts

@@ -21,7 +21,7 @@
  */
 export declare const HOOK_MANIFEST_HARNESSES: readonly ["claude", "cursor", "codex"];
 export type HookManifestHarness = (typeof HOOK_MANIFEST_HARNESSES)[number];
-export declare const HOOK_HANDLERS: readonly ["session-start", "prompt-guard", "workflow-guard", "context-monitor", "stop-handoff", "pre-compact", "verify-current-state"];
+export declare const HOOK_HANDLERS: readonly ["session-start", "stop-handoff"];
 export type HookHandlerId = (typeof HOOK_HANDLERS)[number];
 export interface HookBinding {
     /**
@@ -31,12 +31,13 @@ export interface HookBinding {
     event: string;
     matcher?: string;
     timeout?: number;
+    /** Optional harness UI status line while this hook runs. */
+    statusMessage?: string;
     /**
      * Within a single (harness, event) group, entries are sorted by
      * `priority` ASC, ties broken by manifest-declaration order. Use
      * this to express "this handler must run BEFORE/AFTER that handler
-     * on the same event" (e.g. pre-compact must run before session-start
-     * on cursor `sessionCompact`). Default `0`.
+     * on the same event". Default `0`.
      */
     priority?: number;
 }
@@ -50,7 +51,7 @@ export interface HookHandlerSpec {
     semantic: HookSemanticEvent | null;
     bindings: Partial<Record<HookManifestHarness, HookBinding[]>>;
 }
-export declare const HOOK_SEMANTIC_EVENTS: readonly ["session_rehydrate", "pre_tool_prompt_guard", "pre_tool_workflow_guard", "post_tool_context_monitor", "stop_handoff", "precompact_compat", "strict_state_verify"];
+export declare const HOOK_SEMANTIC_EVENTS: readonly ["session_rehydrate", "stop_handoff"];
 export type HookSemanticEvent = (typeof HOOK_SEMANTIC_EVENTS)[number];
 export declare const HOOK_MANIFEST: readonly HookHandlerSpec[];
 export interface EventGroup {
@@ -63,6 +64,7 @@ export interface EventGroup {
         handler: HookHandlerId;
         matcher?: string;
         timeout?: number;
+        statusMessage?: string;
     }>;
 }
 /**

package/dist/content/hook-manifest.js

@@ -22,26 +22,16 @@
 export const HOOK_MANIFEST_HARNESSES = ["claude", "cursor", "codex"];
 export const HOOK_HANDLERS = [
     "session-start",
-    "prompt-guard",
-    "workflow-guard",
-    "context-monitor",
-    "stop-handoff",
-    "pre-compact",
-    "verify-current-state"
+    "stop-handoff"
 ];
 export const HOOK_SEMANTIC_EVENTS = [
     "session_rehydrate",
-    "pre_tool_prompt_guard",
-    "pre_tool_workflow_guard",
-    "post_tool_context_monitor",
-    "stop_handoff",
-    "precompact_compat",
-    "strict_state_verify"
+    "stop_handoff"
 ];
 export const HOOK_MANIFEST = [
     {
         handler: "session-start",
-        description: "Rehydrate flow state, refresh Ralph Loop + compound readiness, emit bootstrap digest.",
+        description: "Rehydrate flow state and emit bootstrap digest.",
         semantic: "session_rehydrate",
         bindings: {
             claude: [{ event: "SessionStart", matcher: "startup|resume|clear|compact" }],
@@ -51,42 +41,15 @@ export const HOOK_MANIFEST = [
                 { event: "sessionClear" },
                 { event: "sessionCompact" }
             ],
-            codex: [{ event: "SessionStart", matcher: "startup|resume" }]
-        }
-    },
-    {
-        handler: "prompt-guard",
-        description: "Stage-aware prompt gate (iron-laws + strictness).",
-        semantic: "pre_tool_prompt_guard",
-        bindings: {
-            claude: [{ event: "PreToolUse", matcher: "*" }],
-            cursor: [{ event: "preToolUse", matcher: "*" }],
             codex: [
-                { event: "UserPromptSubmit" },
-                { event: "PreToolUse", matcher: "Bash|bash" }
+                {
+                    event: "SessionStart",
+                    matcher: "startup|resume",
+                    statusMessage: "Running cclaw session startup checks"
+                }
             ]
         }
     },
-    {
-        handler: "workflow-guard",
-        description: "TDD and workflow gate on Write/Edit/Bash style tool invocations.",
-        semantic: "pre_tool_workflow_guard",
-        bindings: {
-            claude: [{ event: "PreToolUse", matcher: "Write|Edit|MultiEdit|NotebookEdit|Bash" }],
-            cursor: [{ event: "preToolUse", matcher: "*" }],
-            codex: [{ event: "PreToolUse", matcher: "Bash|bash" }]
-        }
-    },
-    {
-        handler: "context-monitor",
-        description: "Post-tool context usage + stage signal monitor.",
-        semantic: "post_tool_context_monitor",
-        bindings: {
-            claude: [{ event: "PostToolUse", matcher: "*" }],
-            cursor: [{ event: "postToolUse", matcher: "*" }],
-            codex: [{ event: "PostToolUse", matcher: "Bash|bash" }]
-        }
-    },
     {
         handler: "stop-handoff",
         description: "Remind about clean handoff with stage + run context on session stop.",
@@ -94,26 +57,13 @@ export const HOOK_MANIFEST = [
         bindings: {
             claude: [{ event: "Stop", timeout: 10 }],
             cursor: [{ event: "stop", timeout: 10 }],
-            codex: [{ event: "Stop", timeout: 10 }]
-        }
-    },
-    {
-        handler: "pre-compact",
-        description: "No-op compatibility hook for harness pre-compact events; session-start rehydrates from flow-state, artifacts, and knowledge.",
-        semantic: "precompact_compat",
-        bindings: {
-            claude: [{ event: "PreCompact", matcher: "manual|auto", timeout: 10 }],
-            // Keep this before session-start on cursor `sessionCompact` so the
-            // compatibility handler runs before rehydration.
-            cursor: [{ event: "sessionCompact", priority: -10 }]
-        }
-    },
-    {
-        handler: "verify-current-state",
-        description: "Supplementary Codex strict-mode guard that runs on UserPromptSubmit to assert the live state matches the flow.",
-        semantic: "strict_state_verify",
-        bindings: {
-            codex: [{ event: "UserPromptSubmit" }]
+            codex: [
+                {
+                    event: "Stop",
+                    timeout: 10,
+                    statusMessage: "Preparing cclaw handoff checklist"
+                }
+            ]
         }
     }
 ];
@@ -144,6 +94,7 @@ export function groupBindingsByEvent(harness) {
                 handler: spec.handler,
                 ...(binding.matcher !== undefined ? { matcher: binding.matcher } : {}),
                 ...(binding.timeout !== undefined ? { timeout: binding.timeout } : {}),
+                ...(binding.statusMessage !== undefined ? { statusMessage: binding.statusMessage } : {}),
                 priority: binding.priority ?? 0,
                 seq: seq++
             });

package/dist/content/hooks.js

@@ -5,6 +5,15 @@ import { RUNTIME_ROOT } from "../constants.js";
 import { DELEGATION_DISPATCH_SURFACES, DELEGATION_DISPATCH_SURFACE_PATH_PREFIXES } from "../delegation.js";
 function resolveCliRuntimeForGeneratedHook() {
     const here = fileURLToPath(import.meta.url);
+    // Vitest runs init/sync from src/ and expects helpers to execute the same
+    // source runtime, even when a stale dist/ exists in the repository.
+    if (process.env.VITEST === "true") {
+        const sourceCli = path.resolve(path.dirname(here), "..", "cli.ts");
+        const viteNode = path.resolve(path.dirname(here), "..", "..", "node_modules", "vite-node", "vite-node.mjs");
+        if (existsSync(sourceCli) && existsSync(viteNode)) {
+            return { entrypoint: viteNode, argsPrefix: ["--script", sourceCli] };
+        }
+    }
     const candidates = [
         path.resolve(path.dirname(here), "..", "cli.js"),
         path.resolve(path.dirname(here), "..", "..", "dist", "cli.js")
@@ -15,15 +24,6 @@ function resolveCliRuntimeForGeneratedHook() {
         if (existsSync(candidate))
             return { entrypoint: candidate, argsPrefix: [] };
     }
-    // Vitest exercises init/sync directly from src/ without a compiled dist/.
-    // Route that dev-only shape through vite-node so hooks still prove a local runtime.
-    if (process.env.VITEST === "true") {
-        const sourceCli = path.resolve(path.dirname(here), "..", "cli.ts");
-        const viteNode = path.resolve(path.dirname(here), "..", "..", "node_modules", "vite-node", "vite-node.mjs");
-        if (existsSync(sourceCli) && existsSync(viteNode)) {
-            return { entrypoint: viteNode, argsPrefix: ["--script", sourceCli] };
-        }
-    }
     return { entrypoint: null, argsPrefix: [] };
 }
 function internalHelperScript(helperName, internalSubcommand, usage, options) {
@@ -42,6 +42,7 @@ const INTERNAL_SUBCOMMAND = ${JSON.stringify(internalSubcommand)};
 const USAGE = ${JSON.stringify(usage)};
 const POSITIONAL_ARG_NAME = ${JSON.stringify(options?.positionalArgName ?? null)};
 const POSITIONAL_ARG_REQUIRED = ${JSON.stringify(options?.positionalArgRequired === true)};
+const DEFAULT_QUIET_ENV_VAR = ${JSON.stringify(options?.defaultQuietEnvVar ?? null)};
 
 async function detectRoot() {
   const candidates = [
@@ -88,6 +89,19 @@ async function main() {
     }
   }
 
+  if (DEFAULT_QUIET_ENV_VAR !== null) {
+    const envRaw = process.env[DEFAULT_QUIET_ENV_VAR];
+    if (typeof envRaw !== "string" || envRaw.trim().length === 0) {
+      process.env[DEFAULT_QUIET_ENV_VAR] = "1";
+    }
+    const quietRaw = (process.env[DEFAULT_QUIET_ENV_VAR] ?? "").trim().toLowerCase();
+    const quietEnabled = !/^(0|false|no|off)$/u.test(quietRaw);
+    const alreadyQuiet = flags.includes("--quiet");
+    if (quietEnabled && !alreadyQuiet) {
+      flags = [...flags, "--quiet"];
+    }
+  }
+
   const root = await detectRoot();
   const runtimePath = path.join(root, RUNTIME_ROOT);
   try {
@@ -171,13 +185,13 @@ void main();
 `;
 }
 export function startFlowScript() {
-    return internalHelperScript("start-flow", "start-flow", "Usage: node " + RUNTIME_ROOT + "/hooks/start-flow.mjs --track=<standard|medium|quick> [--class=...] [--prompt=...] [--stack=...] [--reason=...] [--reclassify] [--force-reset]");
+    return internalHelperScript("start-flow", "start-flow", "Usage: node " + RUNTIME_ROOT + "/hooks/start-flow.mjs --track=<standard|medium|quick> [--class=...] [--prompt=...] [--stack=...] [--reason=...] [--reclassify] [--force-reset]", { defaultQuietEnvVar: "CCLAW_START_FLOW_QUIET" });
 }
 export function cancelRunScript() {
     return internalHelperScript("cancel-run", "cancel-run", "Usage: node " + RUNTIME_ROOT + "/hooks/cancel-run.mjs --reason=<text> [--disposition=<cancelled|abandoned>] [--name=<slug>]");
 }
 export function stageCompleteScript() {
-    return internalHelperScript("stage-complete", "advance-stage", "Usage: node " + RUNTIME_ROOT + "/hooks/stage-complete.mjs <stage> [--passed=...] [--evidence-json=...] [--waive-delegation=...] [--waiver-reason=...] [--accept-proactive-waiver] [--accept-proactive-waiver-reason=...] [--json]", {
+    return internalHelperScript("stage-complete", "advance-stage", "Usage: node " + RUNTIME_ROOT + "/hooks/stage-complete.mjs <stage> [--passed=...] [--evidence-json=...] [--waive-delegation=...] [--waiver-reason=...] [--accept-proactive-waiver] [--accept-proactive-waiver-reason=...] [--skip-questions] [--json]", {
         positionalArgName: "stage",
         positionalArgRequired: true
     });
@@ -280,7 +294,7 @@ function usage() {
   process.stderr.write([
     "Usage:",
     "  node .cclaw/hooks/delegation-record.mjs --stage=<stage> --agent=<agent> --mode=<mandatory|proactive> --status=<scheduled|launched|acknowledged|completed|failed|waived|stale> --span-id=<id> [--dispatch-id=<id>] [--worker-run-id=<id>] [--dispatch-surface=<surface>] [--agent-definition-path=<path>] [--ack-ts=<iso>] [--launched-ts=<iso>] [--completed-ts=<iso>] [--evidence-ref=<ref>] [--waiver-reason=<text>] [--json]",
-    "  node .cclaw/hooks/delegation-record.mjs --rerecord --span-id=<id> --dispatch-id=<id> --dispatch-surface=<surface> --agent-definition-path=<path> [--ack-ts=<iso>] [--completed-ts=<iso>] [--json]",
+    "  node .cclaw/hooks/delegation-record.mjs --rerecord --span-id=<id> --dispatch-id=<id> --dispatch-surface=<surface> --agent-definition-path=<path> [--ack-ts=<iso>] [--completed-ts=<iso>] [--evidence-ref=<ref>] [--json]",
     "",
     "Allowed --dispatch-surface values:",
     "  " + VALID_DISPATCH_SURFACES.join(", "),
@@ -322,6 +336,18 @@ async function pathExists(filePath) {
   }
 }
 
+function normalizeEvidenceRefs(args) {
+  if (Array.isArray(args["evidence-refs"])) {
+    return args["evidence-refs"]
+      .filter((ref) => typeof ref === "string" && ref.trim().length > 0)
+      .map((ref) => ref.trim());
+  }
+  if (typeof args["evidence-ref"] === "string" && args["evidence-ref"].trim().length > 0) {
+    return [args["evidence-ref"].trim()];
+  }
+  return [];
+}
+
 function buildRow(args, status, runId, now) {
   const fulfillmentMode = args["dispatch-surface"] === "role-switch"
     ? "role-switch"
@@ -340,7 +366,7 @@ function buildRow(args, status, runId, now) {
     agentDefinitionPath: args["agent-definition-path"],
     fulfillmentMode,
     waiverReason: args["waiver-reason"],
-    evidenceRefs: args["evidence-ref"] ? [args["evidence-ref"]] : [],
+    evidenceRefs: normalizeEvidenceRefs(args),
     runId,
     startTs: now,
     ts: now,
@@ -420,6 +446,18 @@ async function runRerecord(args, json) {
     emitProblems(["no legacy ledger entry found for --span-id=" + args["span-id"]], json, 1);
     return;
   }
+  const explicitEvidenceRef =
+    typeof args["evidence-ref"] === "string" && args["evidence-ref"].trim().length > 0
+      ? args["evidence-ref"].trim()
+      : "";
+  const legacyEvidenceRefs = Array.isArray(legacyEntry.evidenceRefs)
+    ? legacyEntry.evidenceRefs
+      .filter((ref) => typeof ref === "string" && ref.trim().length > 0)
+      .map((ref) => ref.trim())
+    : [];
+  const mergedEvidenceRefs = explicitEvidenceRef.length > 0
+    ? [explicitEvidenceRef]
+    : legacyEvidenceRefs;
   if (args["dispatch-surface"] !== "role-switch") {
     if (!dispatchSurfaceMatchesPath(args["dispatch-surface"], args["agent-definition-path"])) {
       const allowedPrefixes = SURFACE_PATH_PREFIXES[args["dispatch-surface"]];
@@ -445,7 +483,9 @@ async function runRerecord(args, json) {
     "agent-definition-path": args["agent-definition-path"],
     "ack-ts": args["ack-ts"] || legacyEntry.ackTs || now,
     "completed-ts": args["completed-ts"] || legacyEntry.completedTs || now,
-    "launched-ts": args["launched-ts"] || legacyEntry.launchedTs || now
+    "launched-ts": args["launched-ts"] || legacyEntry.launchedTs || now,
+    "evidence-ref": explicitEvidenceRef.length > 0 ? explicitEvidenceRef : undefined,
+    "evidence-refs": mergedEvidenceRefs
   };
   const status = "completed";
   const clean = Object.fromEntries(Object.entries(buildRow(merged, status, runId, now)).filter(([, value]) => value !== undefined));

package/dist/content/meta-skill.js

@@ -44,9 +44,10 @@ Substantive vs. non-substantive:
 - **Non-substantive** (skill load optional): one-line acknowledgement,
   clarifying a typo, confirming a prior answer, pure conversation.
 
-If the current stage is ambiguous because \`flow-state.json\` is missing
-or corrupt, stop and route through \`/cc\` before any substantive
-response.
+If \`.cclaw/state/flow-state.json\` is missing, treat it as a normal fresh-init
+state and route through \`/cc <idea>\` to start the first tracked run.
+If the file exists but is corrupt/unreadable, stop and route through \`/cc\`
+before any substantive response.
 
 ## Red Flags (stop and re-route)
 

package/dist/content/node-hooks.d.ts

@@ -1,30 +1,4 @@
 export interface NodeHookRuntimeOptions {
-    /**
-     * Single enforcement knob derived from `config.strictness`. Generated hooks
-     * embed this value as the default for every guard (prompt, workflow, TDD,
-     * iron-laws-coupled blocks). `CCLAW_STRICTNESS` env var overrides at run
-     * time; per-law strictness still flows through `iron-laws.json`.
-     */
-    strictness?: "advisory" | "strict";
-    tddTestPathPatterns?: string[];
-    tddProductionPathPatterns?: string[];
-    /**
-     * Baked-in default recurrence threshold for compound-readiness computed
-     * by the session-start hook. Derived from
-     * `config.compound.recurrenceThreshold` at install time; re-run
-     * `cclaw sync` after changing the config value so hook and CLI agree.
-     */
-    compoundRecurrenceThreshold?: number;
-    /**
-     * Enables early-stage producer/critic loop diagnostics in session-start.
-     * Defaults to true.
-     */
-    earlyLoopEnabled?: boolean;
-    /**
-     * Baked-in max iterations for brainstorm/scope/design early-loop status.
-     * Derived from `config.earlyLoop.maxIterations`.
-     */
-    earlyLoopMaxIterations?: number;
 }
 /**
  * Node-only hook runtime (single entrypoint).