cclaw-cli 0.48.10 → 0.48.11

package/dist/content/doctor-references.js

@@ -13,7 +13,7 @@ Reference docs for \`cclaw doctor\` checks.
 - \`state-and-gates.md\` - flow-state integrity and gate evidence contracts
 - \`delegation-and-preamble.md\` - mandatory delegations and lightweight announce discipline
 - \`traceability.md\` - spec/plan/tdd trace matrix expectations
-- \`tooling-capabilities.md\` - local runtime prerequisites (bash/node/python/jq)
+- \`tooling-capabilities.md\` - local runtime prerequisites (node only)
 - \`config-and-policy.md\` - config schema, rules policy, and validation references
 `,
     "runtime-layout.md": `# Runtime Layout
@@ -116,17 +116,21 @@ Reference docs for \`cclaw doctor\` checks.
 
 ## Required
 
-- \`bash\` for runtime hook scripts
-- \`node\` for generated runtime scripts/plugins
+- \`node\` (>=20) — the only runtime dependency. All hooks, git-hook relays, and the
+  \`cclaw\` CLI itself run on Node.js. No \`bash\`, \`python3\`, or \`jq\` required.
+- \`git\` — needed for worktree and pre-commit/pre-push relays.
 
-## Optional fallback
+## Not required (removed)
 
-- at least one of \`python3\` or \`jq\` for JSON parsing fallback paths
+Earlier releases relied on \`bash\` to execute generated shell hooks and on
+\`python3\`/\`jq\` as JSON fallback parsers. Node-only mode removes both: hooks
+dispatch through \`node .cclaw/hooks/run-hook.mjs <hook-name>\`, so these tools
+are no longer part of the supported runtime contract.
 
 ## Typical fixes
 
-1. Install missing runtime tools.
-2. Keep at least one JSON fallback parser available (\`python3\` or \`jq\`).
+1. Install Node.js 20 or newer (matches \`package.json\` \`engines\`) and ensure \`node\` is on \`PATH\`.
+2. Re-run \`cclaw sync\` to regenerate hook configs after upgrading Node.
 `,
     "config-and-policy.md": `# Config And Policy
 

package/dist/content/node-hooks.js

@@ -186,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) {
@@ -1518,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") {
@@ -1555,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.js

@@ -1,5 +1,9 @@
 import { RUNTIME_ROOT } from "../constants.js";
 function hookDispatcherCommand(hookName) {
+    // RUNTIME_ROOT is a relative path (".cclaw") that currently contains no
+    // whitespace, so quoting is unnecessary inside the JSON-encoded command
+    // string. If RUNTIME_ROOT ever becomes configurable, wrap the path with
+    // JSON.stringify to survive spaces.
     return `node ${RUNTIME_ROOT}/hooks/run-hook.mjs ${hookName}`;
 }
 export function claudeHooksJsonWithObservation() {

package/dist/content/opencode-plugin.js

@@ -409,6 +409,12 @@ export default function cclawPlugin(ctx) {
             : typeof payload;
         console.error("[cclaw] opencode unknown event payload keys: " + keys);
       }
+      // session.compacted must run pre-compact BEFORE refreshing the bootstrap
+      // cache, otherwise the injected system prompt still shows the pre-compact
+      // digest/state until the next lifecycle event.
+      if (eventType === "session.compacted") {
+        await runHookScript("pre-compact", eventData ?? {});
+      }
       if (
         eventType === "session.created" ||
         eventType === "session.resumed" ||
@@ -424,9 +430,6 @@ export default function cclawPlugin(ctx) {
         // until the next compaction or restart.
         await refreshBootstrapCache(true);
       }
-      if (eventType === "session.compacted") {
-        await runHookScript("pre-compact", eventData ?? {});
-      }
       if (eventType === "session.idle") {
         await runHookScript("stop-checkpoint", { loop_count: 0 });
       }

package/dist/doctor-registry.js

@@ -30,15 +30,6 @@ const RULES = [
             docRef: ref("runtime-layout.md")
         }
     },
-    {
-        test: /^capability:runtime:json_parser$/,
-        metadata: {
-            severity: "warning",
-            summary: "Optional JSON fallback parser availability.",
-            fix: "Install at least one of `python3` or `jq` for resilient fallback parsing.",
-            docRef: ref("tooling-capabilities.md")
-        }
-    },
     {
         test: /^capability:required:/,
         metadata: {

package/dist/doctor.js

@@ -743,12 +743,9 @@ export async function doctorChecks(projectRoot, options = {}) {
             }
         }
     }
-    // OpenCode plugin source + deployed path
-    checks.push({
-        name: "hook:opencode_plugin_source",
-        ok: await exists(path.join(projectRoot, RUNTIME_ROOT, "hooks", "opencode-plugin.mjs")),
-        details: `${RUNTIME_ROOT}/hooks/opencode-plugin.mjs`
-    });
+    // OpenCode plugin deployed path. (Presence of the source under
+    // `${RUNTIME_ROOT}/hooks/opencode-plugin.mjs` is already asserted by the
+    // generic `hook:script:opencode-plugin.mjs` check above; avoid a duplicate.)
     const opencodeEnabled = configuredHarnesses.includes("opencode");
     const opencodeDeployed = await exists(path.join(projectRoot, ".opencode/plugins/cclaw-plugin.mjs"));
     checks.push({
@@ -1009,27 +1006,11 @@ export async function doctorChecks(projectRoot, options = {}) {
         });
     }
     const hasNode = await commandAvailable("node");
-    const hasPython = await commandAvailable("python3");
-    const hasJq = await commandAvailable("jq");
     checks.push({
         name: "capability:required:node",
         ok: hasNode,
         details: "node is required for cclaw runtime scripts and CLI wiring"
     });
-    checks.push({
-        name: "warning:capability:jq",
-        ok: true,
-        details: hasJq
-            ? "jq available (optional)"
-            : "warning: jq not found; Node hook runtime no longer depends on jq"
-    });
-    checks.push({
-        name: "warning:capability:python3",
-        ok: true,
-        details: hasPython
-            ? "python3 available (optional)"
-            : "warning: python3 not found; Node hook runtime no longer depends on python3"
-    });
     const windowsHookConfigCandidates = [
         path.join(projectRoot, ".claude/hooks/hooks.json"),
         path.join(projectRoot, ".cursor/hooks.json"),

package/dist/install.js

@@ -119,6 +119,11 @@ function resolveChangedFiles(root) {
 const root = resolveRepoRoot();
 const runtimeHook = path.join(root, RUNTIME_ROOT, "hooks", "run-hook.mjs");
 if (!fs.existsSync(runtimeHook)) {
+  // cclaw git relay is installed but the runtime entrypoint is missing —
+  // warn visibly (without blocking the commit) so the drift is noticed.
+  process.stderr.write(
+    "[cclaw] " + HOOK_NAME + ": " + runtimeHook + " not found; run \`cclaw sync\` to reinstall\\n"
+  );
   process.exit(0);
 }
 
@@ -1428,7 +1433,11 @@ function stripManagedHookCommands(value) {
     return { updated: root, changed: true };
 }
 function isManagedRuntimeHookCommand(command) {
-    const normalized = command.trim().replace(/\s+/gu, " ");
+    // Normalize whitespace and collapse any Windows-style backslash path
+    // separators to forward slashes so user-edited hook configs on Windows
+    // (e.g. `node .cclaw\hooks\run-hook.mjs ...`) still round-trip through
+    // sync without being duplicated alongside freshly generated entries.
+    const normalized = command.trim().replace(/\s+/gu, " ").replace(/\\/gu, "/");
     if (/(^|\s)(?:node\s+)?(?:"|')?(?:\.\/)?\.cclaw\/hooks\/run-hook\.mjs(?:"|')?\s+(?:session-start|stop-checkpoint|pre-compact|prompt-guard|workflow-guard|context-monitor|verify-current-state)(?:\s|$)/u.test(normalized)) {
         return true;
     }

package/package.json

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