cclaw-cli 0.48.9 → 0.48.11

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

@@ -101,6 +101,7 @@ 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) => {
@@ -110,17 +111,21 @@ async function runCclawInternal(root, args) {
     };
     let child;
     try {
-      child = spawn("cclaw", ["internal", ...args], {
+      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"
+        missingBinary: code === "ENOENT" || (isWindows && code === "EINVAL")
       });
       return;
     }
@@ -135,7 +140,7 @@ async function runCclawInternal(root, args) {
       finalize({
         code: 1,
         stderr,
-        missingBinary: code === "ENOENT"
+        missingBinary: code === "ENOENT" || (isWindows && code === "EINVAL")
       });
     });
     child.on("close", (code, signal) => {
@@ -147,10 +152,14 @@ async function runCclawInternal(root, args) {
         });
         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: false
+        missingBinary
       });
     });
   });
@@ -177,12 +186,12 @@ async function detectRoot(env) {
     try {
       const runtimePath = path.join(candidate, RUNTIME_ROOT);
       const stat = await fs.stat(runtimePath);
-      if (stat.isDirectory()) return candidate;
+      if (stat.isDirectory()) return { root: candidate, foundRuntime: true };
     } catch {
       // continue
     }
   }
-  return candidates[0] || process.cwd();
+  return { root: candidates[0] || process.cwd(), foundRuntime: false };
 }
 
 function toLower(value) {
@@ -1509,7 +1518,7 @@ async function handleVerifyCurrentState(runtime) {
     : 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");
+    process.stderr.write("[cclaw] hook: cclaw binary is required for verify-current-state\\n");
     return 1;
   }
   if (mode === "strict") {
@@ -1523,12 +1532,12 @@ async function handleVerifyCurrentState(runtime) {
 
 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 "";
 }
@@ -1546,7 +1555,14 @@ async function main() {
   }
 
   const harness = detectHarness(process.env);
-  const root = await detectRoot(process.env);
+  const { root, foundRuntime } = await detectRoot(process.env);
+  if (!foundRuntime) {
+    // No .cclaw/ runtime in any candidate root — this directory is not
+    // initialized for cclaw. Exit 0 silently so hooks never block harnesses
+    // that run in unrelated repos; users initialize with \`cclaw init\`.
+    process.exitCode = 0;
+    return;
+  }
   const inputRaw = await readStdin();
   const inputData = safeParseJson(inputRaw, {});
   const runtime = {

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;