cclaw-cli 0.48.9 → 0.48.11

package/dist/config.d.ts

@@ -4,7 +4,7 @@ export declare class InvalidConfigError extends Error {
 }
 export declare function configPath(projectRoot: string): string;
 /**
- * Default test-path patterns used by workflow-guard.sh to classify TDD writes.
+ * Default test-path patterns used by the workflow-guard hook to classify TDD writes.
  *
  * Scope is intentionally narrow and language-agnostic; users can extend this
  * list in config when their repository uses different conventions.

package/dist/config.js

@@ -100,7 +100,7 @@ export function configPath(projectRoot) {
     return path.join(projectRoot, CONFIG_PATH);
 }
 /**
- * Default test-path patterns used by workflow-guard.sh to classify TDD writes.
+ * Default test-path patterns used by the workflow-guard hook to classify TDD writes.
  *
  * Scope is intentionally narrow and language-agnostic; users can extend this
  * list in config when their repository uses different conventions.

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/harness-doc.js

@@ -103,7 +103,7 @@ shared casing silently breaks generated wiring.
 - Codex-specific ceiling: \`PreToolUse\` can only intercept \`Bash\`. Direct
   \`Write\`/\`Edit\` to \`.cclaw/state/flow-state.json\` cannot be hard-blocked
   at hook level, so the canonical path is
-  \`bash .cclaw/hooks/stage-complete.sh <stage>\` plus the non-blocking
+  \`node .cclaw/hooks/stage-complete.mjs <stage>\` plus the non-blocking
   \`UserPromptSubmit\` state nudge.
 
 ## Shared command contract

package/dist/content/harness-playbooks.js

@@ -233,7 +233,7 @@ Codex CLI has a different shape from Claude/Cursor:
   \`PostToolUse\` events only fire for the \`Bash\` tool. \`Write\`,
   \`Edit\`, \`WebSearch\`, and MCP tool calls are **not** gated by hooks.
   cclaw partially compensates by wiring \`UserPromptSubmit\` to both
-  \`prompt-guard.sh\` and a non-blocking
+  \`prompt-guard\` and a non-blocking
   \`cclaw internal verify-current-state --quiet\` nudge that emits
   unmet-delegation / missing-evidence warnings before the turn executes.
   This is still a nudge, not a hard block: workflow-guard (TDD red-first,
@@ -291,7 +291,7 @@ disabled in v0.33 and remains off.
 - \`/use cc\` — open the \`/cc\` skill and pick a track.
 - \`/use cc-next\` — advance the flow one stage.
 - \`/use cc-ops\` — compound / archive / rewind.
-- \`bash .cclaw/hooks/stage-complete.sh <stage>\` — canonical stage closeout helper;
+- \`node .cclaw/hooks/stage-complete.mjs <stage>\` — canonical stage closeout helper;
   validates delegations + gate evidence before mutating \`flow-state.json\`.
 - Typing \`/cc …\` or \`/cc-next …\` in plain text also works: Codex
   matches the skill descriptions (which spell out these tokens) and
@@ -318,12 +318,12 @@ continue to work regardless.
 
 | Hook intent | Codex mapping | Coverage |
 |-------------|---------------|----------|
-| SessionStart rehydration | \`SessionStart\` matcher \`startup|resume\` → \`session-start.sh\` | Full. |
-| PreToolUse prompt-guard | \`PreToolUse\` matcher \`Bash\` + \`UserPromptSubmit\` → \`prompt-guard.sh\` | Bash tool calls are gated inline; \`UserPromptSubmit\` catches prompts before any tool fires, so non-Bash writes (\`Write\`/\`Edit\`) are still prompt-guarded at the turn boundary. |
+| SessionStart rehydration | \`SessionStart\` matcher \`startup|resume\` → \`session-start\` | Full. |
+| PreToolUse prompt-guard | \`PreToolUse\` matcher \`Bash\` + \`UserPromptSubmit\` → \`prompt-guard\` | Bash tool calls are gated inline; \`UserPromptSubmit\` catches prompts before any tool fires, so non-Bash writes (\`Write\`/\`Edit\`) are still prompt-guarded at the turn boundary. |
 | UserPromptSubmit state nudge | \`UserPromptSubmit\` → \`cclaw internal verify-current-state --quiet\` | Non-blocking warning only. Prints unmet mandatory delegation / gate-evidence counts before the turn; cannot block non-Bash \`Write\`/\`Edit\`. |
-| PreToolUse workflow-guard | \`PreToolUse\` matcher \`Bash\` → \`workflow-guard.sh\` | Bash-only. For \`Write\`/\`Edit\` calls the agent performs the TDD-order / artifact check in-turn (see the stage skill). |
-| PostToolUse context-monitor | \`PostToolUse\` matcher \`Bash\` → \`context-monitor.sh\` | Bash-only. Other tool calls get context-monitored at end-of-turn via \`.cclaw/references/protocols/ethos.md\`. |
-| Stop checkpoint | \`Stop\` → \`stop-checkpoint.sh\` | Full. |
+| PreToolUse workflow-guard | \`PreToolUse\` matcher \`Bash\` → \`workflow-guard\` | Bash-only. For \`Write\`/\`Edit\` calls the agent performs the TDD-order / artifact check in-turn (see the stage skill). |
+| PostToolUse context-monitor | \`PostToolUse\` matcher \`Bash\` → \`context-monitor\` | Bash-only. Other tool calls get context-monitored at end-of-turn via \`.cclaw/references/protocols/ethos.md\`. |
+| Stop checkpoint | \`Stop\` → \`stop-checkpoint\` | Full. |
 | PreCompact digest | Not supported — Codex has no \`PreCompact\` event. | Covered by \`/cc-ops retro\` and the user running \`/cc-view status\` before Codex's \`/compact\` command. |
 
 ## Verification

package/dist/content/hook-events.js

@@ -9,27 +9,27 @@ export const HOOK_SEMANTIC_EVENTS = [
 export const HOOK_EVENTS_BY_HARNESS = {
     claude: {
         session_rehydrate: "SessionStart matcher startup|resume|clear|compact",
-        pre_tool_prompt_guard: "PreToolUse -> prompt-guard.sh",
-        pre_tool_workflow_guard: "PreToolUse -> workflow-guard.sh",
-        post_tool_context_monitor: "PostToolUse -> context-monitor.sh",
-        stop_checkpoint: "Stop -> stop-checkpoint.sh",
-        precompact_digest: "PreCompact -> pre-compact.sh"
+        pre_tool_prompt_guard: "PreToolUse -> prompt-guard",
+        pre_tool_workflow_guard: "PreToolUse -> workflow-guard",
+        post_tool_context_monitor: "PostToolUse -> context-monitor",
+        stop_checkpoint: "Stop -> stop-checkpoint",
+        precompact_digest: "PreCompact -> pre-compact"
     },
     cursor: {
         session_rehydrate: "sessionStart/sessionResume/sessionClear/sessionCompact",
-        pre_tool_prompt_guard: "preToolUse -> prompt-guard.sh",
-        pre_tool_workflow_guard: "preToolUse -> workflow-guard.sh",
-        post_tool_context_monitor: "postToolUse -> context-monitor.sh",
-        stop_checkpoint: "stop -> stop-checkpoint.sh",
-        precompact_digest: "sessionCompact -> pre-compact.sh"
+        pre_tool_prompt_guard: "preToolUse -> prompt-guard",
+        pre_tool_workflow_guard: "preToolUse -> workflow-guard",
+        post_tool_context_monitor: "postToolUse -> context-monitor",
+        stop_checkpoint: "stop -> stop-checkpoint",
+        precompact_digest: "sessionCompact -> pre-compact"
     },
     opencode: {
         session_rehydrate: "plugin event handlers + transform rehydration",
-        pre_tool_prompt_guard: "plugin tool.execute.before -> prompt-guard.sh",
-        pre_tool_workflow_guard: "plugin tool.execute.before -> workflow-guard.sh",
-        post_tool_context_monitor: "plugin tool.execute.after -> context-monitor.sh",
-        stop_checkpoint: "plugin session.idle -> stop-checkpoint.sh",
-        precompact_digest: "plugin session.compacted -> pre-compact.sh"
+        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_checkpoint: "plugin session.idle -> stop-checkpoint",
+        precompact_digest: "plugin session.compacted -> pre-compact"
     },
     codex: {
         // Codex CLI v0.114+ exposes lifecycle hooks via `.codex/hooks.json`,
@@ -39,9 +39,9 @@ export const HOOK_EVENTS_BY_HARNESS = {
         // calls do not trigger them). `precompact_digest` is unmapped —
         // Codex has no PreCompact event; cclaw covers it via `/cc-ops retro`.
         session_rehydrate: "SessionStart matcher startup|resume",
-        pre_tool_prompt_guard: "PreToolUse matcher Bash -> prompt-guard.sh (plus UserPromptSubmit for non-Bash prompts)",
-        pre_tool_workflow_guard: "PreToolUse matcher Bash -> workflow-guard.sh (Bash-only)",
-        post_tool_context_monitor: "PostToolUse matcher Bash -> context-monitor.sh (Bash-only)",
-        stop_checkpoint: "Stop -> stop-checkpoint.sh"
+        pre_tool_prompt_guard: "PreToolUse matcher Bash -> prompt-guard (plus UserPromptSubmit for non-Bash prompts)",
+        pre_tool_workflow_guard: "PreToolUse matcher Bash -> workflow-guard (Bash-only)",
+        post_tool_context_monitor: "PostToolUse matcher Bash -> context-monitor (Bash-only)",
+        stop_checkpoint: "Stop -> stop-checkpoint"
     }
 };

package/dist/content/hooks.d.ts

@@ -1,20 +1,4 @@
-/**
- * Hook generators for all supported harnesses.
- *
- * SessionStart: injects using-cclaw + flow state + knowledge + checkpoint/activity summary.
- * Stop: writes checkpoint.json and reminds about flow consistency.
- * Harness hook JSON wiring is generated in observe.ts.
- */
-export interface HookRuntimeOptions {
-}
-/** Shared bash preamble for generated hook scripts. */
-export declare const RUNTIME_SHELL_DETECT_ROOT = "CCLAW_HOOK_LIB_PATH=\"\"\nfor candidate in \"${CCLAW_PROJECT_ROOT:-}\" \"${CLAUDE_PROJECT_DIR:-}\" \"${CURSOR_PROJECT_DIR:-}\" \"${CURSOR_PROJECT_ROOT:-}\" \"${OPENCODE_PROJECT_DIR:-}\" \"${OPENCODE_PROJECT_ROOT:-}\" \"${PWD:-}\"; do\n  if [ -n \"$candidate\" ] && [ -f \"$candidate/.cclaw/hooks/_lib.sh\" ]; then\n    CCLAW_HOOK_LIB_PATH=\"$candidate/.cclaw/hooks/_lib.sh\"\n    break\n  fi\ndone\nif [ -n \"$CCLAW_HOOK_LIB_PATH\" ] && [ -f \"$CCLAW_HOOK_LIB_PATH\" ]; then\n  # shellcheck disable=SC1090\n  . \"$CCLAW_HOOK_LIB_PATH\"\nfi\n\nif command -v cclaw_hook_detect_root >/dev/null 2>&1; then\n  cclaw_hook_detect_root\nelse\n  HARNESS=\"codex\"\n  if [ -n \"${CLAUDE_PROJECT_DIR:-}\" ]; then\n    HARNESS=\"claude\"\n  elif [ -n \"${CURSOR_PROJECT_DIR:-}\" ] || [ -n \"${CURSOR_PROJECT_ROOT:-}\" ]; then\n    HARNESS=\"cursor\"\n  elif [ -n \"${OPENCODE_PROJECT_DIR:-}\" ] || [ -n \"${OPENCODE_PROJECT_ROOT:-}\" ]; then\n    HARNESS=\"opencode\"\n  fi\n\n  ROOT=\"\"\n  for candidate in \"${CCLAW_PROJECT_ROOT:-}\" \"${CLAUDE_PROJECT_DIR:-}\" \"${CURSOR_PROJECT_DIR:-}\" \"${CURSOR_PROJECT_ROOT:-}\" \"${OPENCODE_PROJECT_DIR:-}\" \"${OPENCODE_PROJECT_ROOT:-}\" \"${PWD:-}\"; do\n    if [ -n \"$candidate\" ] && [ -d \"$candidate/.cclaw\" ]; then\n      ROOT=\"$candidate\"\n      break\n    fi\n  done\n  if [ -z \"$ROOT\" ]; then\n    ROOT=\"${CCLAW_PROJECT_ROOT:-${CLAUDE_PROJECT_DIR:-${CURSOR_PROJECT_DIR:-${CURSOR_PROJECT_ROOT:-${OPENCODE_PROJECT_DIR:-${OPENCODE_PROJECT_ROOT:-${PWD}}}}}}}\"\n  fi\nfi";
-export declare function hookLibScript(): string;
-export declare function sessionStartScript(_options?: HookRuntimeOptions): string;
-export declare function stopCheckpointScript(): string;
-export declare function runHookDispatcherScript(): string;
 export declare function stageCompleteScript(): string;
-export declare function preCompactScript(): string;
 export { claudeHooksJsonWithObservation as claudeHooksJson } from "./observe.js";
 export { cursorHooksJsonWithObservation as cursorHooksJson } from "./observe.js";
 export { codexHooksJsonWithObservation as codexHooksJson } from "./observe.js";