cclaw-cli 0.48.8 → 0.48.10

package/dist/content/learnings.js

@@ -58,7 +58,7 @@ Knowledge capture is now stage-native:
 - Allowed payloads:
   - \`- None this stage.\` (explicit no-op)
   - JSON bullets with required keys \`type\`, \`trigger\`, \`action\`, \`confidence\` (optional keys may mirror the full JSONL schema fields).
-- During \`bash .cclaw/hooks/stage-complete.sh <stage>\`, cclaw:
+- During \`node .cclaw/hooks/stage-complete.mjs <stage>\`, cclaw:
   1. validates \`## Learnings\`,
   2. appends deduped entries to \`${KNOWLEDGE_PATH}\`,
   3. writes a harvest marker into the artifact.
@@ -157,7 +157,7 @@ Manage the project knowledge store. One canonical file, strict JSONL:
 - \`${KNOWLEDGE_ARCHIVE_PATH}\` — soft-archive target written only by curate.
 
 Stage-native pipeline:
-- During \`stage-complete.sh\`, cclaw harvests \`## Learnings\` from the current
+- During \`stage-complete.mjs\`, cclaw harvests \`## Learnings\` from the current
   stage artifact into \`${KNOWLEDGE_PATH}\` automatically.
 - Use \`/cc-learn\` for query, backfill, and curation workflows.
 

package/dist/content/next-command.js

@@ -58,7 +58,7 @@ This is the only progression command the user needs to drive the entire flow. St
 
 → Load **\`${RUNTIME_ROOT}/skills/<skillFolder>/SKILL.md\`** and **\`${RUNTIME_ROOT}/commands/<currentStage>.md\`** for the current stage.
 → Execute that stage's protocol. The stage skill handles the full interaction including STOP points and gate tracking.
-→ Stage completion must use \`bash .cclaw/hooks/stage-complete.sh <currentStage>\` (canonical), which validates delegations + gate evidence before mutating \`flow-state.json\`.
+→ Stage completion must use \`node .cclaw/hooks/stage-complete.mjs <currentStage>\` (canonical), which validates delegations + gate evidence before mutating \`flow-state.json\`.
 
 ### Path B: Current stage IS complete (all gates passed, all delegations satisfied)
 
@@ -188,7 +188,7 @@ Load the current stage's skill and command contract:
 - \`${RUNTIME_ROOT}/skills/<skillFolder>/SKILL.md\`
 - \`${RUNTIME_ROOT}/commands/<currentStage>.md\`
 
-Execute the stage protocol. The stage skill handles interaction, STOP points, gate tracking, and stage completion via \`bash .cclaw/hooks/stage-complete.sh <stage>\` (canonical flow-state mutation path).
+Execute the stage protocol. The stage skill handles interaction, STOP points, gate tracking, and stage completion via \`node .cclaw/hooks/stage-complete.mjs <stage>\` (canonical flow-state mutation path).
 
 Special-case for review: if \`review_criticals_resolved\` is in \`blocked\`, route to rework instead of looping review forever — recommend \`/cc-ops rewind tdd "review_blocked_by_critical"\`.
 

package/dist/content/node-hooks.js

@@ -99,6 +99,72 @@ async function readStdin() {
   });
 }
 
+async function runCclawInternal(root, args) {
+  return await new Promise((resolve) => {
+    const isWindows = process.platform === "win32";
+    let settled = false;
+    let stderr = "";
+    const finalize = (value) => {
+      if (settled) return;
+      settled = true;
+      resolve(value);
+    };
+    let child;
+    try {
+      child = spawn(
+        isWindows ? "cmd.exe" : "cclaw",
+        isWindows ? ["/d", "/s", "/c", "cclaw", "internal", ...args] : ["internal", ...args],
+        {
+        cwd: root,
+        env: process.env,
+        stdio: ["ignore", "ignore", "pipe"]
+      }
+      );
+    } catch (error) {
+      const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+      finalize({
+        code: 1,
+        stderr,
+        missingBinary: code === "ENOENT" || (isWindows && code === "EINVAL")
+      });
+      return;
+    }
+    child.stderr?.on("data", (chunk) => {
+      stderr += String(chunk ?? "");
+      if (stderr.length > 8000) {
+        stderr = stderr.slice(-8000);
+      }
+    });
+    child.on("error", (error) => {
+      const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+      finalize({
+        code: 1,
+        stderr,
+        missingBinary: code === "ENOENT" || (isWindows && code === "EINVAL")
+      });
+    });
+    child.on("close", (code, signal) => {
+      if (signal) {
+        finalize({
+          code: 1,
+          stderr,
+          missingBinary: false
+        });
+        return;
+      }
+      const stderrLower = stderr.toLowerCase();
+      const missingBinary = isWindows
+        ? stderrLower.includes("is not recognized as an internal or external command")
+        : false;
+      finalize({
+        code: typeof code === "number" ? code : 1,
+        stderr,
+        missingBinary
+      });
+    });
+  });
+}
+
 function detectHarness(env) {
   if (env.CLAUDE_PROJECT_DIR) return "claude";
   if (env.CURSOR_PROJECT_DIR || env.CURSOR_PROJECT_ROOT) return "cursor";
@@ -1446,14 +1512,33 @@ async function handleContextMonitor(runtime) {
   return 0;
 }
 
+async function handleVerifyCurrentState(runtime) {
+  const mode = process.env.CCLAW_WORKFLOW_GUARD_MODE === "strict"
+    ? "strict"
+    : DEFAULT_WORKFLOW_GUARD_MODE;
+  const result = await runCclawInternal(runtime.root, ["verify-current-state", "--quiet"]);
+  if (result.missingBinary) {
+    process.stderr.write("[cclaw] codex hook: cclaw binary is required for verify-current-state\\n");
+    return 1;
+  }
+  if (mode === "strict") {
+    if (result.code !== 0 && result.stderr.trim().length > 0) {
+      process.stderr.write(result.stderr);
+    }
+    return result.code === 0 ? 0 : 1;
+  }
+  return 0;
+}
+
 function normalizeHookName(rawName) {
   const value = normalizeText(rawName).toLowerCase();
-  if (value === "session-start" || value === "session-start.sh") return "session-start";
-  if (value === "stop-checkpoint" || value === "stop-checkpoint.sh") return "stop-checkpoint";
-  if (value === "pre-compact" || value === "pre-compact.sh") return "pre-compact";
-  if (value === "prompt-guard" || value === "prompt-guard.sh") return "prompt-guard";
-  if (value === "workflow-guard" || value === "workflow-guard.sh") return "workflow-guard";
-  if (value === "context-monitor" || value === "context-monitor.sh") return "context-monitor";
+  if (value === "session-start") return "session-start";
+  if (value === "stop-checkpoint") return "stop-checkpoint";
+  if (value === "pre-compact") return "pre-compact";
+  if (value === "prompt-guard") return "prompt-guard";
+  if (value === "workflow-guard") return "workflow-guard";
+  if (value === "context-monitor") return "context-monitor";
+  if (value === "verify-current-state") return "verify-current-state";
   return "";
 }
 
@@ -1463,7 +1548,7 @@ async function main() {
     process.stderr.write(
       "[cclaw] run-hook: usage: node " +
         RUNTIME_ROOT +
-        "/hooks/run-hook.mjs <session-start|stop-checkpoint|pre-compact|prompt-guard|workflow-guard|context-monitor>\\n"
+        "/hooks/run-hook.mjs <session-start|stop-checkpoint|pre-compact|prompt-guard|workflow-guard|context-monitor|verify-current-state>\\n"
     );
     process.exitCode = 1;
     return;
@@ -1508,6 +1593,10 @@ async function main() {
       process.exitCode = await handleContextMonitor(runtime);
       return;
     }
+    if (hookName === "verify-current-state") {
+      process.exitCode = await handleVerifyCurrentState(runtime);
+      return;
+    }
     process.stderr.write("[cclaw] run-hook: unsupported hook " + hookName + "\\n");
     process.exitCode = 1;
   } catch (error) {

package/dist/content/observe.d.ts

@@ -1,41 +1,3 @@
-/**
- * Hook helper scripts and harness hook JSON generators.
- *
- * This module still provides prompt/workflow/context guard scripts and
- * cross-harness hook wiring. Observation pipeline scripts are retained only
- * for backward compatibility and are not wired by default runtime generation.
- */
-export interface PromptGuardOptions {
-    strictMode?: boolean;
-}
-export declare function promptGuardScript(options?: PromptGuardOptions): string;
-export interface WorkflowGuardOptions {
-    workflowGuardMode?: "advisory" | "strict";
-    tddEnforcementMode?: "advisory" | "strict";
-    tddTestPathPatterns?: string[];
-    tddProductionPathPatterns?: string[];
-}
-export declare function workflowGuardScript(options?: WorkflowGuardOptions): string;
-export declare function contextMonitorScript(): string;
 export declare function claudeHooksJsonWithObservation(): string;
 export declare function cursorHooksJsonWithObservation(): string;
-/**
- * Codex CLI ≥ v0.114 hooks. Differences vs. the Claude shape:
- *
- * - `SessionStart` matcher is limited to `startup|resume` — Codex does
- *   not emit `clear` or `compact` lifecycle phases.
- * - `PreToolUse` / `PostToolUse` fire **only for the `Bash` tool**
- *   (documented Codex limitation, v0.114/v0.115). We match both `Bash`
- *   and `bash` variants to tolerate casing drift across Codex builds.
- * - `UserPromptSubmit` is supported and is the closest analogue to
- *   Cursor's `preToolUse` for non-Bash tooling — we run prompt-guard
- *   there so workflow/prompt checks still fire when the tool being
- *   used is `Write` or `Edit` rather than `Bash`.
- * - There is no `PreCompact` event in Codex CLI — pre-compact
- *   semantics are carried by the agent itself inside `/cc-ops retro`.
- *
- * The entire file is inert unless the user opts into
- * `[features] codex_hooks = true` in `~/.codex/config.toml`; cclaw
- * doctor and the init prompt handle that flag.
- */
 export declare function codexHooksJsonWithObservation(): string;