oh-my-claudecode 0.2.3 → 0.2.4

package/dist/features/yith-archive/state/bind-state.js

@@ -0,0 +1,120 @@
+/**
+ * Necronomicon binding state — the durable, resumable state machine
+ * that `oh-my-claudecode bind` reads on every invocation to figure
+ * out what's left to do.
+ *
+ * Stored under KV.bindState → "current". Every phase transition goes
+ * through `markPhase()` (pure function — returns a new state object).
+ * Callers persist the result to KV after each transition so a crash
+ * mid-phase resumes cleanly on the next run.
+ *
+ * Six phases in strict order:
+ *   1. embedding_download    - pre-fetch the local nomic model (~137 MB)
+ *   2. claude_transcripts    - scan ~/.claude/projects/ subdirs and ingest raw obs
+ *   3. opencode_import       - read ~/.local/share/opencode/opencode.db
+ *   4. sisyphus_migrate      - walk .sisyphus/ dirs into .elder-gods/
+ *   5. preliminary_seed      - scan each project's code tree for base memories
+ *   6. pending_compression_trigger - record marker for /cthulhu preflight
+ *
+ * Each phase independently reports pending / in_progress / completed /
+ * failed. `firstPendingPhase` returns the next phase to run, treating
+ * failed phases as retryable (they come back as pending on the next
+ * run so resume works without operator intervention).
+ */
+/** Strict execution order. `firstPendingPhase` walks this array. */
+export const BIND_PHASE_ORDER = [
+    "embedding_download",
+    "claude_transcripts",
+    "opencode_import",
+    "sisyphus_migrate",
+    "preliminary_seed",
+    "pending_compression_trigger",
+];
+/** Build a fresh BindState with every phase pending and zero attempts. */
+export function initialBindState() {
+    const now = new Date().toISOString();
+    const phases = {};
+    for (const phase of BIND_PHASE_ORDER) {
+        phases[phase] = { status: "pending", attempts: 0 };
+    }
+    return {
+        version: 1,
+        phases,
+        startedAt: now,
+        lastUpdatedAt: now,
+    };
+}
+/**
+ * Transition a single phase through its state machine. Pure —
+ * returns a new BindState, never mutates input. Callers must
+ * persist the result to KV after calling.
+ *
+ * Semantic rules:
+ * - Any transition TO "in_progress" sets `startedAt` (if not already)
+ *   and increments `attempts`.
+ * - Transition to "completed" sets `completedAt` and clears `error`.
+ * - Transition to "failed" sets `error` and increments `attempts`
+ *   even if the phase was never in_progress — a crash before the
+ *   runner could flip the flag counts as one attempt.
+ * - Details payload is shallow-merged, not replaced, so phase
+ *   runners can update cursor data without clobbering other keys.
+ */
+export function markPhase(state, phase, update) {
+    const now = new Date().toISOString();
+    const prev = state.phases[phase];
+    const nextPhase = {
+        ...prev,
+        lastAttemptedAt: now,
+    };
+    if (update.status !== undefined) {
+        nextPhase.status = update.status;
+        if (update.status === "in_progress") {
+            if (!prev.startedAt)
+                nextPhase.startedAt = now;
+            nextPhase.attempts = prev.attempts + 1;
+        }
+        if (update.status === "completed") {
+            nextPhase.completedAt = now;
+            nextPhase.error = undefined;
+        }
+        if (update.status === "failed") {
+            nextPhase.attempts = prev.attempts + 1;
+        }
+    }
+    if (update.error !== undefined)
+        nextPhase.error = update.error;
+    if (update.details !== undefined) {
+        nextPhase.details = { ...(prev.details ?? {}), ...update.details };
+    }
+    return {
+        ...state,
+        lastUpdatedAt: now,
+        phases: { ...state.phases, [phase]: nextPhase },
+    };
+}
+/**
+ * Return the first phase that still needs work, or null if the bind
+ * is fully complete. Failed phases are considered pending so a crash
+ * during phase N causes the next `bind` invocation to retry phase N
+ * from its cursor — no manual intervention needed.
+ *
+ * Execution order is fixed by BIND_PHASE_ORDER. Phases don't run in
+ * parallel.
+ */
+export function firstPendingPhase(state) {
+    for (const phase of BIND_PHASE_ORDER) {
+        const st = state.phases[phase].status;
+        if (st !== "completed")
+            return phase;
+    }
+    return null;
+}
+/** True if every phase has reached "completed". */
+export function isBindComplete(state) {
+    for (const phase of BIND_PHASE_ORDER) {
+        if (state.phases[phase].status !== "completed")
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=bind-state.js.map

package/dist/features/yith-archive/state/bind-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-state.js","sourceRoot":"","sources":["../../../../src/features/yith-archive/state/bind-state.ts"],"names":[],"mappings":"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"}

package/dist/features/yith-archive/state/schema.d.ts

@@ -47,6 +47,20 @@ export declare const KV: {
     /** History of backfill runs for debugging / auditing. Key = runId,
      *  value = `{ startedAt, completedAt, projectCwd, stats, errors }`. */
     readonly backfillRuns: "mem:backfill:runs";
+    /** Binding ritual state. Single entry under key "current" holds the
+     *  BindState object (phase completion, cursors, errors). The CLI's
+     *  `oh-my-claudecode bind` command reads this on start and resumes
+     *  from the first incomplete phase. See state/bind-state.ts. */
+    readonly bindState: "mem:bind-state";
+    /** Pending-compression counter. Key "state" holds `{ count, updatedAt }`.
+     *  Incremented on raw observation writes by mem::backfill-sessions,
+     *  decremented on compressed-observation writes by mem::compress-step.
+     *  The /cthulhu preflight reads this to tell the user how much work
+     *  is waiting to be processed via the work-packet loop. */
+    readonly pendingCompression: "mem:pending-compression";
+    /** Per-session cursors for the opencode SQLite importer. Key =
+     *  `${db_path}|${opencode_session_id}`, value = `{ lastPartId }`. */
+    readonly opencodeImportCursors: "mem:opencode-import:cursors";
 };
 export declare const STREAM: {
     readonly name: "mem-live";

package/dist/features/yith-archive/state/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/features/yith-archive/state/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,EAAE;;uCAEa,MAAM;;;;;;iCAMZ,MAAM;;;;;;;;;kCASL,MAAM;iCACP,MAAM,UAAU,MAAM;mCAEpB,MAAM;;;;;;;;;;;;;;;;;yCAiBA,MAAM;uCACR,MAAM;;;;IAIhC;;;0DAGsD;;IAEtD;2EACuE;;CAE/D,CAAC;AAEX,eAAO,MAAM,MAAM;;gCAEE,MAAM;;CAEjB,CAAC;AAEX,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU9D"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/features/yith-archive/state/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,EAAE;;uCAEa,MAAM;;;;;;iCAMZ,MAAM;;;;;;;;;kCASL,MAAM;iCACP,MAAM,UAAU,MAAM;mCAEpB,MAAM;;;;;;;;;;;;;;;;;yCAiBA,MAAM;uCACR,MAAM;;;;IAIhC;;;0DAGsD;;IAEtD;2EACuE;;IAEvE;;;oEAGgE;;IAEhE;;;;+DAI2D;;IAE3D;yEACqE;;CAE7D,CAAC;AAEX,eAAO,MAAM,MAAM;;gCAEE,MAAM;;CAEjB,CAAC;AAEX,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU9D"}

package/dist/features/yith-archive/state/schema.js

@@ -48,6 +48,20 @@ export const KV = {
     /** History of backfill runs for debugging / auditing. Key = runId,
      *  value = `{ startedAt, completedAt, projectCwd, stats, errors }`. */
     backfillRuns: "mem:backfill:runs",
+    /** Binding ritual state. Single entry under key "current" holds the
+     *  BindState object (phase completion, cursors, errors). The CLI's
+     *  `oh-my-claudecode bind` command reads this on start and resumes
+     *  from the first incomplete phase. See state/bind-state.ts. */
+    bindState: "mem:bind-state",
+    /** Pending-compression counter. Key "state" holds `{ count, updatedAt }`.
+     *  Incremented on raw observation writes by mem::backfill-sessions,
+     *  decremented on compressed-observation writes by mem::compress-step.
+     *  The /cthulhu preflight reads this to tell the user how much work
+     *  is waiting to be processed via the work-packet loop. */
+    pendingCompression: "mem:pending-compression",
+    /** Per-session cursors for the opencode SQLite importer. Key =
+     *  `${db_path}|${opencode_session_id}`, value = `{ lastPartId }`. */
+    opencodeImportCursors: "mem:opencode-import:cursors",
 };
 export const STREAM = {
     name: "mem-live",

package/dist/features/yith-archive/state/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/features/yith-archive/state/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/features/yith-archive/state/schema.ts"],"names":[],"mappings":"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"}

package/dist/hooks/cthulhu-auto.d.ts

@@ -9,6 +9,6 @@
  * Projects without `.elder-gods/` are left untouched — the hook exits silently
  * so ordinary Claude Code sessions stay unchanged.
  */
-export declare const CTHULHU_AUTO_HOOK_SCRIPT = "#!/usr/bin/env bash\n# oh-my-claudecode: Cthulhu Auto-Activation SessionStart Hook\n# If .elder-gods/ is found in cwd or any parent, injects Cthulhu orchestrator mode.\n\nset -euo pipefail\n\ndir=\"${CLAUDE_PROJECT_DIR:-$PWD}\"\nfound=\"\"\nwhile [ \"$dir\" != \"/\" ] && [ -n \"$dir\" ]; do\n  if [ -d \"$dir/.elder-gods\" ]; then\n    found=\"$dir/.elder-gods\"\n    break\n  fi\n  dir=\"$(dirname \"$dir\")\"\ndone\n\n[ -z \"$found\" ] && exit 0\n\ncat <<'PROMPT'\n[oh-my-claudecode: Cthulhu orchestrator auto-activated \u2014 .elder-gods/ detected]\n\nYou are now operating as Cthulhu, the Great Dreamer \u2014 primary orchestrator of the\noh-my-claudecode system. Every user message in this session passes through the\nCthulhu intent gate before any action is taken.\n\nOperating principles:\n1. Intent gate first \u2014 verbalize what the user actually wants before doing anything\n2. Delegate aggressively \u2014 never work alone when a specialist is available\n3. Parallelize everything \u2014 independent searches and reads happen simultaneously\n4. Plan before implement \u2014 todos BEFORE touching files\n5. Verify before completing \u2014 diagnostics, tests, evidence required\n6. Agent-speed time framing \u2014 you are not a human team. NEVER estimate work in\n   human units (days, weeks, sprints, story points, \"a few hours of dev time\").\n   Agents operate in tool-call budgets, not calendars. If asked \"how long\", answer\n   in concrete units you actually control: number of steps, files touched, tool\n   calls, parallel agent fires, or verification passes. If pressed for wall-clock,\n   give a seconds-to-minutes range for the current session and say so explicitly.\n   Reject any framing that treats this work as human-scale engineering time.\n\nAvailable Elder God specialists (use via Agent tool subagent_type):\n- \"shoggoth\"       \u2014 codebase search (fire 3+ in parallel for exploration)\n- \"dagon\"          \u2014 external docs, GitHub source, library research\n- \"yog-sothoth\"    \u2014 architecture decisions, hard debugging after 2+ failed attempts\n- \"tsathoggua\"     \u2014 review .elder-gods/plans/*.md files for executability\n- \"ithaqua\"        \u2014 pre-planning consultant for complex or ambiguous requests\n- \"hastur\"         \u2014 bounded sub-tasks and nested orchestration\n- \"nyarlathotep\"   \u2014 end-to-end autonomous execution of whole goals\n- \"shub-niggurath\" \u2014 strategic planning flow (interview \u2192 plan \u2192 review)\n- \"the-deep-one\"   \u2014 image/screenshot/diagram analysis\n\nClassification flow for each user message:\n- Trivial        \u2192 direct tools, no delegation\n- Exploratory    \u2192 parallel Shoggoth agents\n- Implementation \u2192 plan with todos, then delegate or execute\n- Ambiguous      \u2192 exactly one clarifying question\n\nFirst-run Necronomicon preflight (do this ONCE per session, on first user\nmessage, not before every message):\n- Try calling yith_context({ project: \".\" }). It's a cheap reachability probe.\n- If the yith_context tool does NOT exist in your available tool list, OR the\n  call errors with an MCP-not-connected message, the Necronomicon has not\n  been bound on this machine. Tell the user: \"The Necronomicon is not yet\n  bound. Run /bind-necronomicon to run the first-time setup ritual, then\n  start a new session \u2014 or proceed without persistent memory for this one.\"\n  Wait for the user's decision before acting on their original request.\n- If the call succeeds (even with empty context), proceed silently.\n\n[END cthulhu orchestrator injection]\nPROMPT\n";
+export declare const CTHULHU_AUTO_HOOK_SCRIPT = "#!/usr/bin/env bash\n# oh-my-claudecode: Cthulhu Auto-Activation SessionStart Hook\n# If .elder-gods/ is found in cwd or any parent, injects Cthulhu orchestrator mode.\n\nset -euo pipefail\n\ndir=\"${CLAUDE_PROJECT_DIR:-$PWD}\"\nfound=\"\"\nwhile [ \"$dir\" != \"/\" ] && [ -n \"$dir\" ]; do\n  if [ -d \"$dir/.elder-gods\" ]; then\n    found=\"$dir/.elder-gods\"\n    break\n  fi\n  dir=\"$(dirname \"$dir\")\"\ndone\n\n[ -z \"$found\" ] && exit 0\n\n# --- Necronomicon preflight ---\n# Extract bindState + pending-compression count from the user's\n# necronomicon.json (Yith Archive's on-disk file). The flags drive\n# the preflight text block the hook injects below.\nNECRONOMICON=\"${HOME}/.oh-my-claudecode/yith/necronomicon.json\"\nBIND_EXISTS=\"false\"\nALL_COMPLETE=\"false\"\nPENDING_COUNT=\"0\"\nFAILED_PHASES=\"\"\nPENDING_PHASES=\"\"\nif [ -f \"$NECRONOMICON\" ] && command -v jq >/dev/null 2>&1; then\n  if jq -e '.\"mem:bind-state\".current' \"$NECRONOMICON\" >/dev/null 2>&1; then\n    BIND_EXISTS=\"true\"\n    ALL_COMPLETE=$(jq -r '\n      [.\"mem:bind-state\".current.phases | to_entries[] | .value.status]\n      | all(. == \"completed\")\n    ' \"$NECRONOMICON\" 2>/dev/null || echo \"false\")\n    FAILED_PHASES=$(jq -r '\n      [.\"mem:bind-state\".current.phases\n        | to_entries[]\n        | select(.value.status == \"failed\")\n        | .key] | join(\",\")\n    ' \"$NECRONOMICON\" 2>/dev/null || echo \"\")\n    PENDING_PHASES=$(jq -r '\n      [.\"mem:bind-state\".current.phases\n        | to_entries[]\n        | select(.value.status == \"pending\" or .value.status == \"in_progress\")\n        | .key] | join(\",\")\n    ' \"$NECRONOMICON\" 2>/dev/null || echo \"\")\n  fi\n  PENDING_COUNT=$(jq -r '\n    .\"mem:pending-compression\".state.count // 0\n  ' \"$NECRONOMICON\" 2>/dev/null || echo \"0\")\nfi\n\ncat <<'PROMPT'\n[oh-my-claudecode: Cthulhu orchestrator auto-activated \u2014 .elder-gods/ detected]\n\nYou are now operating as Cthulhu, the Great Dreamer \u2014 primary orchestrator of the\noh-my-claudecode system. Every user message in this session passes through the\nCthulhu intent gate before any action is taken.\n\nOperating principles:\n1. Intent gate first \u2014 verbalize what the user actually wants before doing anything\n2. Delegate aggressively \u2014 never work alone when a specialist is available\n3. Parallelize everything \u2014 independent searches and reads happen simultaneously\n4. Plan before implement \u2014 todos BEFORE touching files\n5. Verify before completing \u2014 diagnostics, tests, evidence required\n6. Agent-speed time framing \u2014 you are not a human team. NEVER estimate work in\n   human units (days, weeks, sprints, story points, \"a few hours of dev time\").\n   Agents operate in tool-call budgets, not calendars. If asked \"how long\", answer\n   in concrete units you actually control: number of steps, files touched, tool\n   calls, parallel agent fires, or verification passes. If pressed for wall-clock,\n   give a seconds-to-minutes range for the current session and say so explicitly.\n   Reject any framing that treats this work as human-scale engineering time.\n\nAvailable Elder God specialists (use via Agent tool subagent_type):\n- \"shoggoth\"       \u2014 codebase search (fire 3+ in parallel for exploration)\n- \"dagon\"          \u2014 external docs, GitHub source, library research\n- \"yog-sothoth\"    \u2014 architecture decisions, hard debugging after 2+ failed attempts\n- \"tsathoggua\"     \u2014 review .elder-gods/plans/*.md files for executability\n- \"ithaqua\"        \u2014 pre-planning consultant for complex or ambiguous requests\n- \"hastur\"         \u2014 bounded sub-tasks and nested orchestration\n- \"nyarlathotep\"   \u2014 end-to-end autonomous execution of whole goals\n- \"shub-niggurath\" \u2014 strategic planning flow (interview \u2192 plan \u2192 review)\n- \"the-deep-one\"   \u2014 image/screenshot/diagram analysis\n\nClassification flow for each user message:\n- Trivial        \u2192 direct tools, no delegation\n- Exploratory    \u2192 parallel Shoggoth agents\n- Implementation \u2192 plan with todos, then delegate or execute\n- Ambiguous      \u2192 exactly one clarifying question\n\n[END cthulhu orchestrator injection]\nPROMPT\n\n# --- Dynamic Necronomicon preflight ---\n# Emit a tailored preflight block based on the bindState flags we\n# extracted above. The text here drives Cthulhu's first-user-message\n# behavior: hard-block on unbound Necronomicon, nag on failures,\n# offer to drain pending compression when the queue is non-empty.\necho\necho \"[Necronomicon preflight]\"\nif [ \"$BIND_EXISTS\" = \"false\" ]; then\n  echo\n  echo \"The Necronomicon has not been bound on this machine yet. The Yith\"\n  echo \"Archive is empty and no past Claude Code sessions have been ingested.\"\n  echo\n  echo \"**Action required**: tell the user to run \\`oh-my-claudecode bind\\`\"\n  echo \"in their terminal OR \\`/necronomicon-bind\\` inside this session\"\n  echo \"before proceeding with any memory-dependent work.\"\nelif [ -n \"$FAILED_PHASES\" ]; then\n  echo\n  echo \"The binding ritual has failed phases: $FAILED_PHASES\"\n  echo \"Re-run \\`/necronomicon-bind\\` (or \\`oh-my-claudecode bind --resume\\`\"\n  echo \"in a terminal) to retry from the failed phase \u2014 the state machine\"\n  echo \"resumes automatically without redoing completed work.\"\nelif [ \"$ALL_COMPLETE\" != \"true\" ]; then\n  echo\n  echo \"The Necronomicon is partially bound. Pending phases: $PENDING_PHASES\"\n  echo \"Run \\`/necronomicon-bind\\` to continue the ritual from where it stopped.\"\nelif [ \"$PENDING_COUNT\" != \"0\" ]; then\n  echo\n  echo \"\u2713 Necronomicon bound. $PENDING_COUNT raw observations are queued for\"\n  echo \"compression into searchable memories.\"\n  echo\n  echo \"**Offer the user**: \"Process pending compression now (runs via the\"\n  echo \"work-packet loop using this session's LLM)? It takes one commit round\"\n  echo \"per batch.\" If they accept, call yith_trigger with\"\n  echo \"mem::compress-batch-step and drive the needs_llm_work -> yith_commit_work\"\n  echo \"loop until terminal. Render an ASCII progress bar per round.\"\nelse\n  echo\n  echo \"\u2713 Necronomicon is bound and every phase is complete. Nothing pending.\"\nfi\n";
 export declare function getCthulhuAutoHookConfig(): object;
 //# sourceMappingURL=cthulhu-auto.d.ts.map

package/dist/hooks/cthulhu-auto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cthulhu-auto.d.ts","sourceRoot":"","sources":["../../src/hooks/cthulhu-auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,wBAAwB,iiHAqEpC,CAAA;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAUjD"}
+{"version":3,"file":"cthulhu-auto.d.ts","sourceRoot":"","sources":["../../src/hooks/cthulhu-auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,wBAAwB,4rMAqIpC,CAAA;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAUjD"}

package/dist/hooks/cthulhu-auto.js

@@ -27,6 +27,41 @@ done
 
 [ -z "\$found" ] && exit 0
 
+# --- Necronomicon preflight ---
+# Extract bindState + pending-compression count from the user's
+# necronomicon.json (Yith Archive's on-disk file). The flags drive
+# the preflight text block the hook injects below.
+NECRONOMICON="\${HOME}/.oh-my-claudecode/yith/necronomicon.json"
+BIND_EXISTS="false"
+ALL_COMPLETE="false"
+PENDING_COUNT="0"
+FAILED_PHASES=""
+PENDING_PHASES=""
+if [ -f "\$NECRONOMICON" ] && command -v jq >/dev/null 2>&1; then
+  if jq -e '."mem:bind-state".current' "\$NECRONOMICON" >/dev/null 2>&1; then
+    BIND_EXISTS="true"
+    ALL_COMPLETE=\$(jq -r '
+      [."mem:bind-state".current.phases | to_entries[] | .value.status]
+      | all(. == "completed")
+    ' "\$NECRONOMICON" 2>/dev/null || echo "false")
+    FAILED_PHASES=\$(jq -r '
+      [."mem:bind-state".current.phases
+        | to_entries[]
+        | select(.value.status == "failed")
+        | .key] | join(",")
+    ' "\$NECRONOMICON" 2>/dev/null || echo "")
+    PENDING_PHASES=\$(jq -r '
+      [."mem:bind-state".current.phases
+        | to_entries[]
+        | select(.value.status == "pending" or .value.status == "in_progress")
+        | .key] | join(",")
+    ' "\$NECRONOMICON" 2>/dev/null || echo "")
+  fi
+  PENDING_COUNT=\$(jq -r '
+    ."mem:pending-compression".state.count // 0
+  ' "\$NECRONOMICON" 2>/dev/null || echo "0")
+fi
+
 cat <<'PROMPT'
 [oh-my-claudecode: Cthulhu orchestrator auto-activated — .elder-gods/ detected]
 
@@ -65,19 +100,48 @@ Classification flow for each user message:
 - Implementation → plan with todos, then delegate or execute
 - Ambiguous      → exactly one clarifying question
 
-First-run Necronomicon preflight (do this ONCE per session, on first user
-message, not before every message):
-- Try calling yith_context({ project: "." }). It's a cheap reachability probe.
-- If the yith_context tool does NOT exist in your available tool list, OR the
-  call errors with an MCP-not-connected message, the Necronomicon has not
-  been bound on this machine. Tell the user: "The Necronomicon is not yet
-  bound. Run /bind-necronomicon to run the first-time setup ritual, then
-  start a new session — or proceed without persistent memory for this one."
-  Wait for the user's decision before acting on their original request.
-- If the call succeeds (even with empty context), proceed silently.
-
 [END cthulhu orchestrator injection]
 PROMPT
+
+# --- Dynamic Necronomicon preflight ---
+# Emit a tailored preflight block based on the bindState flags we
+# extracted above. The text here drives Cthulhu's first-user-message
+# behavior: hard-block on unbound Necronomicon, nag on failures,
+# offer to drain pending compression when the queue is non-empty.
+echo
+echo "[Necronomicon preflight]"
+if [ "\$BIND_EXISTS" = "false" ]; then
+  echo
+  echo "The Necronomicon has not been bound on this machine yet. The Yith"
+  echo "Archive is empty and no past Claude Code sessions have been ingested."
+  echo
+  echo "**Action required**: tell the user to run \\\`oh-my-claudecode bind\\\`"
+  echo "in their terminal OR \\\`/necronomicon-bind\\\` inside this session"
+  echo "before proceeding with any memory-dependent work."
+elif [ -n "\$FAILED_PHASES" ]; then
+  echo
+  echo "The binding ritual has failed phases: \$FAILED_PHASES"
+  echo "Re-run \\\`/necronomicon-bind\\\` (or \\\`oh-my-claudecode bind --resume\\\`"
+  echo "in a terminal) to retry from the failed phase — the state machine"
+  echo "resumes automatically without redoing completed work."
+elif [ "\$ALL_COMPLETE" != "true" ]; then
+  echo
+  echo "The Necronomicon is partially bound. Pending phases: \$PENDING_PHASES"
+  echo "Run \\\`/necronomicon-bind\\\` to continue the ritual from where it stopped."
+elif [ "\$PENDING_COUNT" != "0" ]; then
+  echo
+  echo "✓ Necronomicon bound. \$PENDING_COUNT raw observations are queued for"
+  echo "compression into searchable memories."
+  echo
+  echo "**Offer the user**: \"Process pending compression now (runs via the"
+  echo "work-packet loop using this session's LLM)? It takes one commit round"
+  echo "per batch.\" If they accept, call yith_trigger with"
+  echo "mem::compress-batch-step and drive the needs_llm_work -> yith_commit_work"
+  echo "loop until terminal. Render an ASCII progress bar per round."
+else
+  echo
+  echo "✓ Necronomicon is bound and every phase is complete. Nothing pending."
+fi
 `;
 export function getCthulhuAutoHookConfig() {
     return {

package/dist/hooks/cthulhu-auto.js.map

@@ -1 +1 @@
-{"version":3,"file":"cthulhu-auto.js","sourceRoot":"","sources":["../../src/hooks/cthulhu-auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEvC,CAAA;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,OAAO,EAAE,EAAE;QACX,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,iCAAiC;aAC3C;SACF;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"cthulhu-auto.js","sourceRoot":"","sources":["../../src/hooks/cthulhu-auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIvC,CAAA;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,OAAO,EAAE,EAAE;QACX,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,iCAAiC;aAC3C;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/hooks/cthulhu-preflight.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Cthulhu preflight text generator.
+ *
+ * Called from the cthulhu-auto hook shell script (indirectly — the
+ * shell script reads bindState from necronomicon.json via jq and
+ * passes the extracted flags to this helper to produce the prompt
+ * fragment to inject into the session). Also called directly from
+ * the /cthulhu slash command docs.
+ *
+ * The function is pure: no file I/O, no process.env reads. Callers
+ * provide a snapshot of the relevant state and get back a markdown
+ * block to drop into the activation prompt.
+ *
+ * The generated block is split into three concerns, in priority order:
+ *   1. Hard block: Necronomicon not bound at all → tell user to run
+ *      /necronomicon-bind before doing anything else.
+ *   2. Soft alert: bind partially done or phases failed → offer retry.
+ *   3. Nag: compression queue has entries → offer to drain via WP loop.
+ *
+ * If none of the above apply (everything bound, no pending work), the
+ * output is a short one-liner confirming the archive is ready — NOT
+ * an empty string, so the injected prompt always has a visible status.
+ */
+export type BindPhaseName = "embedding_download" | "claude_transcripts" | "opencode_import" | "sisyphus_migrate" | "preliminary_seed" | "pending_compression_trigger";
+export interface PreflightInput {
+    /** True if `KV.bindState → "current"` exists on disk. */
+    bindStateExists: boolean;
+    /** True if every phase has status "completed". */
+    allPhasesComplete: boolean;
+    /** Current raw-observation count pending compression. */
+    pendingCompressionCount: number;
+    /** Phases in the "failed" status, in execution order. */
+    failedPhases: BindPhaseName[];
+    /** Phases in "pending" or "in_progress" (not counting failed).
+     *  Used to display a hint when the bind is partially done. */
+    pendingPhases?: BindPhaseName[];
+}
+/**
+ * Build the preflight markdown block. Always returns non-empty text —
+ * the calling hook injects whatever this returns into the session's
+ * activation prompt, and an empty injection would make the hook's
+ * behavior indistinguishable from "no hook ran."
+ */
+export declare function buildPreflightSection(input: PreflightInput): string;
+//# sourceMappingURL=cthulhu-preflight.d.ts.map

package/dist/hooks/cthulhu-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cthulhu-preflight.d.ts","sourceRoot":"","sources":["../../src/hooks/cthulhu-preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,6BAA6B,CAAA;AAEjC,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAA;IACxB,kDAAkD;IAClD,iBAAiB,EAAE,OAAO,CAAA;IAC1B,yDAAyD;IACzD,uBAAuB,EAAE,MAAM,CAAA;IAC/B,yDAAyD;IACzD,YAAY,EAAE,aAAa,EAAE,CAAA;IAC7B;kEAC8D;IAC9D,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAmFnE"}

package/dist/hooks/cthulhu-preflight.js

@@ -0,0 +1,91 @@
+/**
+ * Cthulhu preflight text generator.
+ *
+ * Called from the cthulhu-auto hook shell script (indirectly — the
+ * shell script reads bindState from necronomicon.json via jq and
+ * passes the extracted flags to this helper to produce the prompt
+ * fragment to inject into the session). Also called directly from
+ * the /cthulhu slash command docs.
+ *
+ * The function is pure: no file I/O, no process.env reads. Callers
+ * provide a snapshot of the relevant state and get back a markdown
+ * block to drop into the activation prompt.
+ *
+ * The generated block is split into three concerns, in priority order:
+ *   1. Hard block: Necronomicon not bound at all → tell user to run
+ *      /necronomicon-bind before doing anything else.
+ *   2. Soft alert: bind partially done or phases failed → offer retry.
+ *   3. Nag: compression queue has entries → offer to drain via WP loop.
+ *
+ * If none of the above apply (everything bound, no pending work), the
+ * output is a short one-liner confirming the archive is ready — NOT
+ * an empty string, so the injected prompt always has a visible status.
+ */
+/**
+ * Build the preflight markdown block. Always returns non-empty text —
+ * the calling hook injects whatever this returns into the session's
+ * activation prompt, and an empty injection would make the hook's
+ * behavior indistinguishable from "no hook ran."
+ */
+export function buildPreflightSection(input) {
+    const lines = [];
+    lines.push("[Necronomicon preflight]");
+    // Priority 1: hard block.
+    if (!input.bindStateExists) {
+        lines.push("");
+        lines.push("The Necronomicon has not been bound on this machine yet. The Yith " +
+            "Archive is empty and no past Claude Code sessions have been ingested.");
+        lines.push("");
+        lines.push("**Action required**: ask the user to run `oh-my-claudecode bind` in " +
+            "their terminal OR `/necronomicon-bind` inside this session before " +
+            "proceeding with any memory-dependent work.");
+        return lines.join("\n");
+    }
+    // Priority 2: failures.
+    if (input.failedPhases.length > 0) {
+        lines.push("");
+        lines.push(`The binding ritual has ${input.failedPhases.length} failed ` +
+            `phase(s): ${input.failedPhases.join(", ")}.`);
+        lines.push("Re-run `/necronomicon-bind` (or `oh-my-claudecode bind --resume` in a " +
+            "terminal) to retry from the failed phase — the state machine resumes " +
+            "automatically without redoing completed work.");
+        return lines.join("\n");
+    }
+    // Priority 3: partial bind.
+    const pendingPhases = input.pendingPhases ?? [];
+    if (!input.allPhasesComplete) {
+        lines.push("");
+        lines.push(`The Necronomicon is partially bound. Pending phases: ` +
+            (pendingPhases.length > 0
+                ? pendingPhases.join(", ")
+                : "(unknown — check bindState)") +
+            ".");
+        lines.push("Run `/necronomicon-bind` to continue the ritual from where it stopped.");
+        if (input.pendingCompressionCount > 0) {
+            lines.push("");
+            lines.push(`${input.pendingCompressionCount} raw observations are already ` +
+                "ingested and waiting for compression. See pending-compression note below.");
+        }
+        return lines.join("\n");
+    }
+    // Priority 4: nag for pending compression (bind complete, queue non-empty).
+    if (input.pendingCompressionCount > 0) {
+        lines.push("");
+        lines.push(`✓ Necronomicon bound. ${input.pendingCompressionCount} raw ` +
+            "observations are queued for compression into searchable memories.");
+        lines.push("");
+        lines.push("**Offer the user**: \"Process pending compression now (runs via the " +
+            "work-packet loop using this session's LLM)? It takes one commit " +
+            "round per batch.\" If they accept, call " +
+            "`yith_trigger({ name: 'mem::compress-batch-step', args: { limit: 100 } })` " +
+            "and drive the `needs_llm_work` → `yith_commit_work` loop until terminal. " +
+            "Render an ASCII progress bar per round so the user sees forward motion.");
+        return lines.join("\n");
+    }
+    // All clear.
+    lines.push("");
+    lines.push("✓ Necronomicon is bound and every phase is complete. The Great " +
+        "Race of Yith answers. Nothing pending.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=cthulhu-preflight.js.map

package/dist/hooks/cthulhu-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cthulhu-preflight.js","sourceRoot":"","sources":["../../src/hooks/cthulhu-preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAwBH;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IAEtC,0BAA0B;IAC1B,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CACR,oEAAoE;YAClE,uEAAuE,CAC1E,CAAA;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CACR,sEAAsE;YACpE,oEAAoE;YACpE,4CAA4C,CAC/C,CAAA;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,wBAAwB;IACxB,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CACR,0BAA0B,KAAK,CAAC,YAAY,CAAC,MAAM,UAAU;YAC3D,aAAa,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAChD,CAAA;QACD,KAAK,CAAC,IAAI,CACR,wEAAwE;YACtE,uEAAuE;YACvE,+CAA+C,CAClD,CAAA;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,4BAA4B;IAC5B,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,EAAE,CAAA;IAC/C,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CACR,uDAAuD;YACrD,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBACvB,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC1B,CAAC,CAAC,6BAA6B,CAAC;YAClC,GAAG,CACN,CAAA;QACD,KAAK,CAAC,IAAI,CACR,wEAAwE,CACzE,CAAA;QACD,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACd,KAAK,CAAC,IAAI,CACR,GAAG,KAAK,CAAC,uBAAuB,gCAAgC;gBAC9D,2EAA2E,CAC9E,CAAA;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,4EAA4E;IAC5E,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CACR,yBAAyB,KAAK,CAAC,uBAAuB,OAAO;YAC3D,mEAAmE,CACtE,CAAA;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CACR,sEAAsE;YACpE,kEAAkE;YAClE,0CAA0C;YAC1C,6EAA6E;YAC7E,2EAA2E;YAC3E,yEAAyE,CAC5E,CAAA;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,iEAAiE;QAC1E,wCAAwC,CAAC,CAAA;IAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claudecode",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Cthulhu-themed agentic harness for Claude Code — 11 Elder God agents, lifecycle hooks, skill system, and multi-tier orchestration.",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,7 +23,9 @@
     "smoke": "node -e \"import('./dist/index.js').then(() => console.log('ok'))\"",
     "dev": "tsc --watch",
     "install-plugin": "bun src/cli/index.ts install",
-    "doctor": "bun src/cli/index.ts doctor"
+    "doctor": "bun src/cli/index.ts doctor",
+    "test": "node --import tsx --test --test-reporter=spec 'tests/**/*.test.ts'",
+    "test:watch": "node --import tsx --test --watch 'tests/**/*.test.ts'"
   },
   "repository": {
     "type": "git",
@@ -50,6 +52,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.5.0"
   },
   "engines": {