cclaw-cli 0.46.4 → 0.46.6

package/dist/content/hooks.d.ts

@@ -17,5 +17,5 @@ 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";
-export declare function opencodePluginJs(_options?: HookRuntimeOptions): string;
+export { opencodePluginJs } from "./opencode-plugin.js";
 export declare function hooksAgentsMdBlock(): string;

package/dist/content/hooks.js

@@ -1002,293 +1002,7 @@ export { codexHooksJsonWithObservation as codexHooksJson } from "./observe.js";
 // ---------------------------------------------------------------------------
 // OpenCode plugin — JS module
 // ---------------------------------------------------------------------------
-export function opencodePluginJs(_options = {}) {
-    return `// cclaw OpenCode plugin — generated by cclaw sync
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-
-export default function cclawPlugin(ctx) {
-  const root = ctx.directory || process.cwd();
-  const runtimeDir = join(root, "${RUNTIME_ROOT}");
-  const stateDir = join(runtimeDir, "state");
-  const flowStatePath = join(stateDir, "flow-state.json");
-  const checkpointPath = join(stateDir, "checkpoint.json");
-  const activityPath = join(stateDir, "stage-activity.jsonl");
-  const contextWarningsPath = join(stateDir, "context-warnings.jsonl");
-  const contextModePath = join(stateDir, "context-mode.json");
-  const contextsDir = join(runtimeDir, "contexts");
-  const sessionDigestPath = join(stateDir, "session-digest.md");
-  const knowledgePath = join(runtimeDir, "knowledge.jsonl");
-  const knowledgeDigestPath = join(stateDir, "knowledge-digest.md");
-  const metaSkillPath = join(runtimeDir, "skills/${META_SKILL_NAME}/SKILL.md");
-
-  function ensureRuntimeDirs() {
-    try {
-      mkdirSync(runtimeDir, { recursive: true });
-    } catch {
-      // ignore
-    }
-    try {
-      mkdirSync(stateDir, { recursive: true });
-    } catch {
-      // ignore
-    }
-  }
-
-  function readFlowState() {
-    try {
-      const raw = readFileSync(flowStatePath, "utf8");
-      const state = JSON.parse(raw);
-      return {
-        stage: typeof state.currentStage === "string" ? state.currentStage : "none",
-        completed: Array.isArray(state.completedStages) ? state.completedStages.length : 0,
-        activeRunId: typeof state.activeRunId === "string" ? state.activeRunId : "none"
-      };
-    } catch {
-      return { stage: "none", completed: 0, activeRunId: "none" };
-    }
-  }
-
-  function readFileText(filePath) {
-    try {
-      return readFileSync(filePath, "utf8");
-    } catch {
-      return "";
-    }
-  }
-
-  function readTailLines(filePath, maxLines) {
-    const text = readFileText(filePath).trim();
-    if (!text) return [];
-    return text.split(/\\r?\\n/).slice(-maxLines);
-  }
-
-  function readCheckpointSummary() {
-    try {
-      const raw = readFileText(checkpointPath);
-      if (!raw) return "";
-      const cp = JSON.parse(raw);
-      return \`Checkpoint: stage=\${cp.stage || "none"}, status=\${cp.status || "unknown"}, run=\${cp.runId || "none"}, at=\${cp.timestamp || "unknown"}\`;
-    } catch {
-      return "";
-    }
-  }
-
-  function readContextMode() {
-    let mode = "default";
-    try {
-      const parsed = JSON.parse(readFileText(contextModePath));
-      if (parsed && typeof parsed.activeMode === "string" && parsed.activeMode.trim().length > 0) {
-        mode = parsed.activeMode.trim();
-      }
-    } catch {
-      // keep default
-    }
-    const guidePath = join(contextsDir, mode + ".md");
-    const guide = existsSync(guidePath) ? "${RUNTIME_ROOT}/contexts/" + mode + ".md" : "";
-    return { mode, guide };
-  }
-
-  function readRecentActivity() {
-    try {
-      const lines = readTailLines(activityPath, 5);
-      if (lines.length === 0) return [];
-      return lines
-        .map((line) => {
-          try {
-            return JSON.parse(line);
-          } catch {
-            return null;
-          }
-        })
-        .filter(Boolean)
-        .map((entry) => \`- \${entry.ts || "unknown"} [\${entry.phase || "unknown"}] \${entry.tool || "unknown"} (stage=\${entry.stage || "unknown"}, run=\${entry.runId || "none"})\`);
-    } catch {
-      return [];
-    }
-  }
-
-  function readLatestContextWarning() {
-    try {
-      const line = readTailLines(contextWarningsPath, 1)[0];
-      if (!line) return "";
-      try {
-        const parsed = JSON.parse(line);
-        if (parsed && typeof parsed.note === "string") return parsed.note;
-      } catch {
-        // non-json fallback
-      }
-      return line;
-    } catch {
-      return "";
-    }
-  }
-
-  function readKnowledgeDigest() {
-    const digest = readFileText(knowledgeDigestPath).trim();
-    if (!digest) {
-      return readTailLines(knowledgePath, 12);
-    }
-    return digest
-      .split(/\\r?\\n/)
-      .map((line) => line.trim())
-      .filter((line) => line.length > 0)
-      .filter((line) => !line.startsWith("#"));
-  }
-
-  function buildBootstrap() {
-    const flow = readFlowState();
-    const parts = [
-      \`cclaw loaded. Flow: stage=\${flow.stage} (\${flow.completed}/8 completed, run=\${flow.activeRunId}). Active artifacts: ${RUNTIME_ROOT}/artifacts/\`
-    ];
-    const contextMode = readContextMode();
-    parts.push(
-      contextMode.guide
-        ? \`Context mode: \${contextMode.mode} (guide: \${contextMode.guide})\`
-        : \`Context mode: \${contextMode.mode}\`
-    );
-
-    const checkpoint = readCheckpointSummary();
-    if (checkpoint) parts.push(checkpoint);
-
-    const digest = readFileText(sessionDigestPath).trim();
-    if (digest) parts.push("Last session:", digest);
-
-    const activity = readRecentActivity();
-    if (activity.length > 0) parts.push("Recent stage activity:", ...activity);
-
-    const warning = readLatestContextWarning();
-    if (warning) parts.push("Latest context warning:", warning);
-
-    const knowledge = readKnowledgeDigest();
-    if (knowledge.length > 0) parts.push("Knowledge digest (top relevant entries):", ...knowledge);
-
-    parts.push(
-      "If you discover a non-obvious rule or pattern, append one strict-schema JSON line to .cclaw/knowledge.jsonl using type: rule, pattern, lesson, or compound."
-    );
-
-    const meta = readFileText(metaSkillPath).trim();
-    if (meta) parts.push("", meta);
-    return parts.join("\\n");
-  }
-
-  let bootstrapCache = "";
-
-  function refreshBootstrapCache() {
-    bootstrapCache = buildBootstrap();
-  }
-
-  function getBootstrap() {
-    if (!bootstrapCache) refreshBootstrapCache();
-    return bootstrapCache;
-  }
-
-  async function runHookScript(scriptFileName, payload = {}) {
-    const { spawnSync } = await import("node:child_process");
-    const scriptPath = join(root, "${RUNTIME_ROOT}/hooks/" + scriptFileName);
-    const input = typeof payload === "string" ? payload : JSON.stringify(payload ?? {});
-    try {
-      const result = spawnSync("bash", [scriptPath], {
-        cwd: root,
-        timeout: 20000,
-        stdio: ["pipe", "ignore", "ignore"],
-        input
-      });
-      return typeof result.status === "number" ? result.status === 0 : false;
-    } catch {
-      return false;
-    }
-  }
-
-  function normalizeToolPayload(input, output) {
-    if (typeof output === "undefined") return input ?? {};
-    return { input: input ?? {}, output: output ?? {} };
-  }
-
-  function resolveEventType(payload) {
-    if (typeof payload === "string") return payload;
-    if (payload && typeof payload === "object") {
-      if (typeof payload.type === "string") return payload.type;
-      if (typeof payload.name === "string") return payload.name;
-      if (payload.event && typeof payload.event === "object") {
-        if (typeof payload.event.type === "string") return payload.event.type;
-        if (typeof payload.event.name === "string") return payload.event.name;
-      }
-    }
-    return "";
-  }
-
-  function resolveEventData(payload) {
-    if (payload && typeof payload === "object" && payload.event && typeof payload.event === "object") {
-      return payload.event;
-    }
-    return payload;
-  }
-
-  ensureRuntimeDirs();
-
-  return {
-    event: async (payload) => {
-      const eventType = resolveEventType(payload);
-      const eventData = resolveEventData(payload);
-      if (
-        eventType === "session.created" ||
-        eventType === "session.resumed" ||
-        eventType === "session.compacted" ||
-        eventType === "session.cleared"
-      ) {
-        // Avoid writing directly to stdout in lifecycle hooks because it can
-        // interfere with OpenCode TUI rendering. Bootstrap is injected via
-        // the system transform hook instead.
-        refreshBootstrapCache();
-      }
-      if (eventType === "session.idle") {
-        await runHookScript("stop-checkpoint.sh", { loop_count: 0 });
-      }
-      if (eventType === "tool.execute.before") {
-        const toolPayload = normalizeToolPayload(eventData, undefined);
-        const promptOk = await runHookScript("prompt-guard.sh", toolPayload);
-        const workflowOk = await runHookScript("workflow-guard.sh", toolPayload);
-        if (!promptOk || !workflowOk) {
-          throw new Error(
-            "cclaw OpenCode guard blocked tool.execute.before (prompt/workflow guard non-zero exit)."
-          );
-        }
-      }
-      if (eventType === "tool.execute.after") {
-        const toolPayload = normalizeToolPayload(eventData, undefined);
-        await runHookScript("context-monitor.sh", toolPayload);
-      }
-    },
-    "tool.execute.before": async (input, output) => {
-      const payload = normalizeToolPayload(input, output);
-      const promptOk = await runHookScript("prompt-guard.sh", payload);
-      const workflowOk = await runHookScript("workflow-guard.sh", payload);
-      if (!promptOk || !workflowOk) {
-        throw new Error(
-          "cclaw OpenCode guard blocked tool.execute.before (prompt/workflow guard non-zero exit)."
-        );
-      }
-    },
-    "tool.execute.after": async (input, output) => {
-      const payload = normalizeToolPayload(input, output);
-      await runHookScript("context-monitor.sh", payload);
-    },
-    "experimental.chat.system.transform": (payload) => {
-      const bootstrap = getBootstrap();
-      if (typeof payload === "string") {
-        return payload.includes("cclaw loaded.") ? payload : \`\${payload}\\n\\n\${bootstrap}\`;
-      }
-      if (payload && typeof payload === "object" && typeof payload.system === "string") {
-        if (payload.system.includes("cclaw loaded.")) return payload;
-        return { ...payload, system: \`\${payload.system}\\n\\n\${bootstrap}\` };
-      }
-      return payload;
-    }
-  };
-}
-`;
-}
+export { opencodePluginJs } from "./opencode-plugin.js";
 // ---------------------------------------------------------------------------
 // AGENTS.md block for hooks
 // ---------------------------------------------------------------------------

package/dist/content/observe.d.ts

@@ -15,7 +15,6 @@ export interface WorkflowGuardOptions {
     tddTestGlobs?: string[];
 }
 export declare function workflowGuardScript(options?: WorkflowGuardOptions): string;
-export declare function observeScript(): string;
 export declare function contextMonitorScript(): string;
 export declare function summarizeObservationsRuntimeModule(): string;
 export declare function summarizeObservationsScript(): string;

package/dist/content/observe.js

@@ -693,260 +693,6 @@ if [ -n "$REASONS" ]; then
   printf '[cclaw] %s\n' "$NOTE" >&2
 fi
 
-exit 0
-`;
-}
-export function observeScript() {
-    return `#!/usr/bin/env bash
-# cclaw observe hook — generated by cclaw sync
-# Captures PreToolUse/PostToolUse events to ${RUNTIME_ROOT}/observations.jsonl
-# Reads hook JSON from stdin, extracts tool + truncated I/O, appends JSONL.
-# Always exits 0 to never block the agent.
-set -uo pipefail
-
-# Phase: "pre" or "post" passed as $1 by the hook runner
-PHASE="\${1:-post}"
-
-${RUNTIME_SHELL_DETECT_ROOT}
-
-OBS_FILE="$ROOT/${RUNTIME_ROOT}/observations.jsonl"
-STATE_FILE="$ROOT/${RUNTIME_ROOT}/state/flow-state.json"
-ACTIVITY_FILE="$ROOT/${RUNTIME_ROOT}/state/stage-activity.jsonl"
-LOCK_DIR="$ROOT/${RUNTIME_ROOT}/state/.observe.lock"
-MAX_LEN=2000
-
-# Guard: skip if disabled or observations dir missing
-[ -f "$ROOT/${RUNTIME_ROOT}/.observe-disabled" ] && exit 0
-[ -d "$ROOT/${RUNTIME_ROOT}" ] || exit 0
-mkdir -p "$ROOT/${RUNTIME_ROOT}/state" 2>/dev/null || true
-
-escape_json() {
-  local str="$1"
-  str=\${str//\\\\/\\\\\\\\}
-  str=\${str//\\"/\\\\\\"}
-  str=\${str//$'\\t'/\\\\t}
-  str=\${str//$'\\n'/\\\\n}
-  printf '%s' "$str"
-}
-
-acquire_lock() {
-  local attempt=0
-  while ! mkdir "$LOCK_DIR" 2>/dev/null; do
-    attempt=$((attempt + 1))
-    if [ "$attempt" -ge 200 ]; then
-      return 1
-    fi
-    sleep 0.02
-  done
-  return 0
-}
-
-release_lock() {
-  rmdir "$LOCK_DIR" 2>/dev/null || true
-}
-
-rotate_file() {
-  local file_path="$1"
-  local keep_lines="$2"
-  if [ ! -f "$file_path" ]; then
-    return
-  fi
-  local line_count
-  line_count=$(wc -l < "$file_path" 2>/dev/null | tr -d ' ')
-  if [ -z "$line_count" ]; then
-    return
-  fi
-  if [ "$line_count" -gt $((keep_lines * 2)) ]; then
-    local tmp_path="\${file_path}.tmp.$$"
-    if tail -n "$keep_lines" "$file_path" > "$tmp_path" 2>/dev/null; then
-      mv "$tmp_path" "$file_path" 2>/dev/null || rm -f "$tmp_path" 2>/dev/null || true
-    fi
-  fi
-}
-
-sync_run_artifacts() {
-  if [ "$PHASE" != "post" ]; then
-    return
-  fi
-  [ -n "$ACTIVE_RUN" ] || return
-  if [ "$ACTIVE_RUN" = "none" ]; then
-    return
-  fi
-
-  local tool_lower
-  tool_lower=$(printf '%s' "$TOOL" | tr '[:upper:]' '[:lower:]')
-  case "$tool_lower" in
-    write|edit|multiedit|multi_edit|delete|applypatch|runcommand|shell|terminal|execcommand) ;;
-    *) return ;;
-  esac
-
-  local active_dir="$ROOT/${RUNTIME_ROOT}/artifacts"
-  local run_dir="$ROOT/${RUNTIME_ROOT}/runs/$ACTIVE_RUN/artifacts"
-  [ -d "$active_dir" ] || return
-  mkdir -p "$run_dir" 2>/dev/null || return
-
-  for run_file in "$run_dir"/*; do
-    [ -e "$run_file" ] || continue
-    [ -f "$run_file" ] || continue
-    local base_name
-    base_name=$(basename "$run_file")
-    local active_file="$active_dir/$base_name"
-    if [ ! -f "$active_file" ]; then
-      rm -f "$run_file" 2>/dev/null || true
-      continue
-    fi
-    if command -v cmp >/dev/null 2>&1 && cmp -s "$active_file" "$run_file" 2>/dev/null; then
-      continue
-    fi
-    cp "$active_file" "$run_file" 2>/dev/null || true
-  done
-
-  for active_file in "$active_dir"/*; do
-    [ -e "$active_file" ] || continue
-    [ -f "$active_file" ] || continue
-    local base_name
-    base_name=$(basename "$active_file")
-    local run_file="$run_dir/$base_name"
-    if [ -f "$run_file" ] && command -v cmp >/dev/null 2>&1 && cmp -s "$active_file" "$run_file" 2>/dev/null; then
-      continue
-    fi
-    cp "$active_file" "$run_file" 2>/dev/null || true
-  done
-}
-
-# Read stdin (hook JSON)
-INPUT=$(cat 2>/dev/null || echo '{}')
-[ -z "$INPUT" ] && exit 0
-
-# Extract fields from hook payload.
-TOOL="unknown"
-PAYLOAD=""
-if command -v jq >/dev/null 2>&1; then
-  TOOL=$(echo "$INPUT" | jq -r '.tool_name // .tool // .toolName // .name // .id // .command // .tool.name // .tool.id // .input.tool_name // .input.tool // .input.toolName // .input.name // .input.id // .input.command // .input.tool.name // .input.tool.id // "unknown"' 2>/dev/null || echo "unknown")
-  if [ "$PHASE" = "pre" ]; then
-    PAYLOAD=$(echo "$INPUT" | jq -r --arg max "$MAX_LEN" '.tool_input // .input // {} | tostring | .[0:($max|tonumber)]' 2>/dev/null || echo "")
-  else
-    PAYLOAD=$(echo "$INPUT" | jq -r --arg max "$MAX_LEN" '.tool_response // .tool_output // .output // .result_json // "" | tostring | .[0:($max|tonumber)]' 2>/dev/null || echo "")
-  fi
-else
-  TOOL=$(printf '%s' "$INPUT" | sed -n -E 's/.*"tool_name"[[:space:]]*:[[:space:]]*"([^"]+)".*/\\1/p' | head -1)
-  if [ -z "$TOOL" ]; then
-    TOOL=$(printf '%s' "$INPUT" | sed -n -E 's/.*"tool"[[:space:]]*:[[:space:]]*"([^"]+)".*/\\1/p' | head -1)
-  fi
-  [ -n "$TOOL" ] || TOOL="unknown"
-  PAYLOAD=$(printf '%s' "$INPUT" | cut -c1-"$MAX_LEN")
-fi
-
-TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || echo "")
-STAGE="none"
-ACTIVE_RUN="none"
-if [ -f "$STATE_FILE" ]; then
-  if command -v jq >/dev/null 2>&1; then
-    STAGE=$(jq -r '.currentStage // "none"' "$STATE_FILE" 2>/dev/null || echo "none")
-    ACTIVE_RUN=$(jq -r '.activeRunId // "none"' "$STATE_FILE" 2>/dev/null || echo "none")
-  elif command -v python3 >/dev/null 2>&1; then
-    STAGE=$(python3 - "$STATE_FILE" <<'PY'
-import json
-import sys
-
-stage = "none"
-try:
-    with open(sys.argv[1], "r", encoding="utf-8") as fh:
-        data = json.load(fh)
-    value = data.get("currentStage")
-    if isinstance(value, str) and value:
-        stage = value
-except Exception:
-    pass
-print(stage)
-PY
-)
-    ACTIVE_RUN=$(python3 - "$STATE_FILE" <<'PY'
-import json
-import sys
-
-run_id = "none"
-try:
-    with open(sys.argv[1], "r", encoding="utf-8") as fh:
-        data = json.load(fh)
-    value = data.get("activeRunId")
-    if isinstance(value, str) and value:
-        run_id = value
-except Exception:
-    pass
-print(run_id)
-PY
-)
-  else
-    STAGE=$(grep -o '"currentStage"[[:space:]]*:[[:space:]]*"[^"]*"' "$STATE_FILE" 2>/dev/null | head -1 | sed 's/.*"\\([^"]*\\)"$/\\1/' || echo "none")
-    ACTIVE_RUN=$(grep -o '"activeRunId"[[:space:]]*:[[:space:]]*"[^"]*"' "$STATE_FILE" 2>/dev/null | head -1 | sed 's/.*"\\([^"]*\\)"$/\\1/' || echo "none")
-  fi
-fi
-
-# Skip observation of cclaw hooks to avoid recursion
-case "$TOOL" in
-  cclaw*|*cclaw-hook*|observe) exit 0 ;;
-esac
-
-if [ "$PHASE" = "pre" ]; then
-  EVENT="tool_start"
-else
-  EVENT="tool_complete"
-fi
-
-# Scrub potential secrets (env vars, tokens, keys) — BSD/macOS sed compatible
-PAYLOAD=$(echo "$PAYLOAD" | sed -E 's/[A-Za-z0-9_]*([Kk][Ee][Yy]|[Tt][Oo][Kk][Ee][Nn]|[Ss][Ee][Cc][Rr][Ee][Tt]|[Pp][Aa][Ss][Ss][Ww][Oo][Rr][Dd]|[Cc][Rr][Ee][Dd][Ee][Nn][Tt][Ii][Aa][Ll])[A-Za-z0-9_]*[=:][^ ",}]+/[REDACTED]/g' 2>/dev/null || echo "$PAYLOAD")
-
-# Build JSONL lines.
-if command -v jq >/dev/null 2>&1; then
-  EVENT_JSON=$(jq -n -c \\
-    --arg ts "$TS" \\
-    --arg event "$EVENT" \\
-    --arg tool "$TOOL" \\
-    --arg phase "$PHASE" \\
-    --arg stage "$STAGE" \\
-    --arg runId "$ACTIVE_RUN" \\
-    --arg payload "$PAYLOAD" \\
-    '{ts:$ts,event:$event,tool:$tool,phase:$phase,stage:$stage,runId:$runId,data:$payload}' 2>/dev/null || echo "")
-  ACTIVITY_JSON=$(jq -n -c \\
-    --arg ts "$TS" \\
-    --arg event "$EVENT" \\
-    --arg tool "$TOOL" \\
-    --arg phase "$PHASE" \\
-    --arg stage "$STAGE" \\
-    --arg runId "$ACTIVE_RUN" \\
-    --arg schemaVersion "1" \\
-    '{ts:$ts,event:$event,tool:$tool,phase:$phase,stage:$stage,runId:$runId,schemaVersion:($schemaVersion|tonumber)}' 2>/dev/null || echo "")
-else
-  EVENT_JSON=$(printf '{"ts":"%s","event":"%s","tool":"%s","phase":"%s","stage":"%s","runId":"%s","data":"%s"}' \\
-    "$(escape_json "$TS")" \\
-    "$(escape_json "$EVENT")" \\
-    "$(escape_json "$TOOL")" \\
-    "$(escape_json "$PHASE")" \\
-    "$(escape_json "$STAGE")" \\
-    "$(escape_json "$ACTIVE_RUN")" \\
-    "$(escape_json "$PAYLOAD")")
-  ACTIVITY_JSON=$(printf '{"ts":"%s","event":"%s","tool":"%s","phase":"%s","stage":"%s","runId":"%s","schemaVersion":1}' \\
-    "$(escape_json "$TS")" \\
-    "$(escape_json "$EVENT")" \\
-    "$(escape_json "$TOOL")" \\
-    "$(escape_json "$PHASE")" \\
-    "$(escape_json "$STAGE")" \\
-    "$(escape_json "$ACTIVE_RUN")")
-fi
-
-if acquire_lock; then
-  trap release_lock EXIT INT TERM
-  [ -n "$EVENT_JSON" ] && printf '%s\\n' "$EVENT_JSON" >> "$OBS_FILE" 2>/dev/null
-  [ -n "$ACTIVITY_JSON" ] && printf '%s\\n' "$ACTIVITY_JSON" >> "$ACTIVITY_FILE" 2>/dev/null
-  rotate_file "$OBS_FILE" 4000
-  rotate_file "$ACTIVITY_FILE" 3000
-  release_lock
-  trap - EXIT INT TERM
-fi
-
-sync_run_artifacts
-
 exit 0
 `;
 }

package/dist/content/opencode-plugin.d.ts

@@ -0,0 +1 @@
+export declare function opencodePluginJs(_options?: Record<string, never>): string;

package/dist/content/opencode-plugin.js

@@ -0,0 +1,289 @@
+import { RUNTIME_ROOT } from "../constants.js";
+import { META_SKILL_NAME } from "./meta-skill.js";
+export function opencodePluginJs(_options = {}) {
+    return `// cclaw OpenCode plugin — generated by cclaw sync
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+export default function cclawPlugin(ctx) {
+  const root = ctx.directory || process.cwd();
+  const runtimeDir = join(root, "${RUNTIME_ROOT}");
+  const stateDir = join(runtimeDir, "state");
+  const flowStatePath = join(stateDir, "flow-state.json");
+  const checkpointPath = join(stateDir, "checkpoint.json");
+  const activityPath = join(stateDir, "stage-activity.jsonl");
+  const contextWarningsPath = join(stateDir, "context-warnings.jsonl");
+  const contextModePath = join(stateDir, "context-mode.json");
+  const contextsDir = join(runtimeDir, "contexts");
+  const sessionDigestPath = join(stateDir, "session-digest.md");
+  const knowledgePath = join(runtimeDir, "knowledge.jsonl");
+  const knowledgeDigestPath = join(stateDir, "knowledge-digest.md");
+  const metaSkillPath = join(runtimeDir, "skills/${META_SKILL_NAME}/SKILL.md");
+
+  function ensureRuntimeDirs() {
+    try {
+      mkdirSync(runtimeDir, { recursive: true });
+    } catch {
+      // ignore
+    }
+    try {
+      mkdirSync(stateDir, { recursive: true });
+    } catch {
+      // ignore
+    }
+  }
+
+  function readFlowState() {
+    try {
+      const raw = readFileSync(flowStatePath, "utf8");
+      const state = JSON.parse(raw);
+      return {
+        stage: typeof state.currentStage === "string" ? state.currentStage : "none",
+        completed: Array.isArray(state.completedStages) ? state.completedStages.length : 0,
+        activeRunId: typeof state.activeRunId === "string" ? state.activeRunId : "none"
+      };
+    } catch {
+      return { stage: "none", completed: 0, activeRunId: "none" };
+    }
+  }
+
+  function readFileText(filePath) {
+    try {
+      return readFileSync(filePath, "utf8");
+    } catch {
+      return "";
+    }
+  }
+
+  function readTailLines(filePath, maxLines) {
+    const text = readFileText(filePath).trim();
+    if (!text) return [];
+    return text.split(/\\r?\\n/).slice(-maxLines);
+  }
+
+  function readCheckpointSummary() {
+    try {
+      const raw = readFileText(checkpointPath);
+      if (!raw) return "";
+      const cp = JSON.parse(raw);
+      return \`Checkpoint: stage=\${cp.stage || "none"}, status=\${cp.status || "unknown"}, run=\${cp.runId || "none"}, at=\${cp.timestamp || "unknown"}\`;
+    } catch {
+      return "";
+    }
+  }
+
+  function readContextMode() {
+    let mode = "default";
+    try {
+      const parsed = JSON.parse(readFileText(contextModePath));
+      if (parsed && typeof parsed.activeMode === "string" && parsed.activeMode.trim().length > 0) {
+        mode = parsed.activeMode.trim();
+      }
+    } catch {
+      // keep default
+    }
+    const guidePath = join(contextsDir, mode + ".md");
+    const guide = existsSync(guidePath) ? "${RUNTIME_ROOT}/contexts/" + mode + ".md" : "";
+    return { mode, guide };
+  }
+
+  function readRecentActivity() {
+    try {
+      const lines = readTailLines(activityPath, 5);
+      if (lines.length === 0) return [];
+      return lines
+        .map((line) => {
+          try {
+            return JSON.parse(line);
+          } catch {
+            return null;
+          }
+        })
+        .filter(Boolean)
+        .map((entry) => \`- \${entry.ts || "unknown"} [\${entry.phase || "unknown"}] \${entry.tool || "unknown"} (stage=\${entry.stage || "unknown"}, run=\${entry.runId || "none"})\`);
+    } catch {
+      return [];
+    }
+  }
+
+  function readLatestContextWarning() {
+    try {
+      const line = readTailLines(contextWarningsPath, 1)[0];
+      if (!line) return "";
+      try {
+        const parsed = JSON.parse(line);
+        if (parsed && typeof parsed.note === "string") return parsed.note;
+      } catch {
+        // non-json fallback
+      }
+      return line;
+    } catch {
+      return "";
+    }
+  }
+
+  function readKnowledgeDigest() {
+    const digest = readFileText(knowledgeDigestPath).trim();
+    if (!digest) {
+      return readTailLines(knowledgePath, 12);
+    }
+    return digest
+      .split(/\\r?\\n/)
+      .map((line) => line.trim())
+      .filter((line) => line.length > 0)
+      .filter((line) => !line.startsWith("#"));
+  }
+
+  function buildBootstrap() {
+    const flow = readFlowState();
+    const parts = [
+      \`cclaw loaded. Flow: stage=\${flow.stage} (\${flow.completed}/8 completed, run=\${flow.activeRunId}). Active artifacts: ${RUNTIME_ROOT}/artifacts/\`
+    ];
+    const contextMode = readContextMode();
+    parts.push(
+      contextMode.guide
+        ? \`Context mode: \${contextMode.mode} (guide: \${contextMode.guide})\`
+        : \`Context mode: \${contextMode.mode}\`
+    );
+
+    const checkpoint = readCheckpointSummary();
+    if (checkpoint) parts.push(checkpoint);
+
+    const digest = readFileText(sessionDigestPath).trim();
+    if (digest) parts.push("Last session:", digest);
+
+    const activity = readRecentActivity();
+    if (activity.length > 0) parts.push("Recent stage activity:", ...activity);
+
+    const warning = readLatestContextWarning();
+    if (warning) parts.push("Latest context warning:", warning);
+
+    const knowledge = readKnowledgeDigest();
+    if (knowledge.length > 0) parts.push("Knowledge digest (top relevant entries):", ...knowledge);
+
+    parts.push(
+      "If you discover a non-obvious rule or pattern, append one strict-schema JSON line to .cclaw/knowledge.jsonl using type: rule, pattern, lesson, or compound."
+    );
+
+    const meta = readFileText(metaSkillPath).trim();
+    if (meta) parts.push("", meta);
+    return parts.join("\\n");
+  }
+
+  let bootstrapCache = "";
+
+  function refreshBootstrapCache() {
+    bootstrapCache = buildBootstrap();
+  }
+
+  function getBootstrap() {
+    if (!bootstrapCache) refreshBootstrapCache();
+    return bootstrapCache;
+  }
+
+  async function runHookScript(scriptFileName, payload = {}) {
+    const { spawnSync } = await import("node:child_process");
+    const scriptPath = join(root, "${RUNTIME_ROOT}/hooks/" + scriptFileName);
+    const input = typeof payload === "string" ? payload : JSON.stringify(payload ?? {});
+    try {
+      const result = spawnSync("bash", [scriptPath], {
+        cwd: root,
+        timeout: 20000,
+        stdio: ["pipe", "ignore", "ignore"],
+        input
+      });
+      return typeof result.status === "number" ? result.status === 0 : false;
+    } catch {
+      return false;
+    }
+  }
+
+  function normalizeToolPayload(input, output) {
+    if (typeof output === "undefined") return input ?? {};
+    return { input: input ?? {}, output: output ?? {} };
+  }
+
+  function resolveEventType(payload) {
+    if (typeof payload === "string") return payload;
+    if (payload && typeof payload === "object") {
+      if (typeof payload.type === "string") return payload.type;
+      if (typeof payload.name === "string") return payload.name;
+      if (payload.event && typeof payload.event === "object") {
+        if (typeof payload.event.type === "string") return payload.event.type;
+        if (typeof payload.event.name === "string") return payload.event.name;
+      }
+    }
+    return "";
+  }
+
+  function resolveEventData(payload) {
+    if (payload && typeof payload === "object" && payload.event && typeof payload.event === "object") {
+      return payload.event;
+    }
+    return payload;
+  }
+
+  ensureRuntimeDirs();
+
+  return {
+    event: async (payload) => {
+      const eventType = resolveEventType(payload);
+      const eventData = resolveEventData(payload);
+      if (
+        eventType === "session.created" ||
+        eventType === "session.resumed" ||
+        eventType === "session.compacted" ||
+        eventType === "session.cleared"
+      ) {
+        // Avoid writing directly to stdout in lifecycle hooks because it can
+        // interfere with OpenCode TUI rendering. Bootstrap is injected via
+        // the system transform hook instead.
+        refreshBootstrapCache();
+      }
+      if (eventType === "session.idle") {
+        await runHookScript("stop-checkpoint.sh", { loop_count: 0 });
+      }
+      if (eventType === "tool.execute.before") {
+        const toolPayload = normalizeToolPayload(eventData, undefined);
+        const promptOk = await runHookScript("prompt-guard.sh", toolPayload);
+        const workflowOk = await runHookScript("workflow-guard.sh", toolPayload);
+        if (!promptOk || !workflowOk) {
+          throw new Error(
+            "cclaw OpenCode guard blocked tool.execute.before (prompt/workflow guard non-zero exit)."
+          );
+        }
+      }
+      if (eventType === "tool.execute.after") {
+        const toolPayload = normalizeToolPayload(eventData, undefined);
+        await runHookScript("context-monitor.sh", toolPayload);
+      }
+    },
+    "tool.execute.before": async (input, output) => {
+      const payload = normalizeToolPayload(input, output);
+      const promptOk = await runHookScript("prompt-guard.sh", payload);
+      const workflowOk = await runHookScript("workflow-guard.sh", payload);
+      if (!promptOk || !workflowOk) {
+        throw new Error(
+          "cclaw OpenCode guard blocked tool.execute.before (prompt/workflow guard non-zero exit)."
+        );
+      }
+    },
+    "tool.execute.after": async (input, output) => {
+      const payload = normalizeToolPayload(input, output);
+      await runHookScript("context-monitor.sh", payload);
+    },
+    "experimental.chat.system.transform": (payload) => {
+      const bootstrap = getBootstrap();
+      if (typeof payload === "string") {
+        return payload.includes("cclaw loaded.") ? payload : \`\${payload}\\n\\n\${bootstrap}\`;
+      }
+      if (payload && typeof payload === "object" && typeof payload.system === "string") {
+        if (payload.system.includes("cclaw loaded.")) return payload;
+        return { ...payload, system: \`\${payload.system}\\n\\n\${bootstrap}\` };
+      }
+      return payload;
+    }
+  };
+}
+`;
+}

package/package.json

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