@isaacriehm/cairn-core 0.1.10 → 0.2.0

package/dist/status-line/format.js

@@ -1,36 +1,38 @@
 /**
- * Render a StatusJson as the single-line string Claude Code's status_line hook
- * displays. Pure function; no I/O.
+ * Render a StatusJson as the single-line string Claude Code's status_line
+ * hook displays. Pure function; no I/O.
  *
- * Field priority for the "state" slot (single field):
- *   daemon down  >  attention > 0  >  gc running  >  task_state
+ * Format: `⬡ cairn  decisions:N  inv:N  <state>  <icon>`
+ *
+ * <state> reports the most operator-actionable signal: pending attention
+ * count first (ranks above tasks), GC sweep state second, task state
+ * last; falls back to "ready" when nothing else is happening.
  *
  * Health icon:
- *   daemon down  → ○
- *   attention    → ⚑
- *   else         → ●
+ *   attention > 0  → ⚑
+ *   gc running     → ◐
+ *   idle / running → ●
  */
 export function formatStatus(s) {
     const parts = ["⬡ cairn"];
-    parts.push(`ctx:${s.ctx_tokens_used}/${s.ctx_tokens_budget}`);
     parts.push(`decisions:${s.decisions_in_scope}`);
     parts.push(`inv:${s.invariants_in_scope}`);
     let stateField;
     let icon;
-    if (!s.daemon_alive) {
-        stateField = "daemon:down";
-        icon = "○";
-    }
-    else if (s.attention_count > 0) {
+    if (s.attention_count > 0) {
         stateField = `attention:${s.attention_count}`;
         icon = "⚑";
     }
     else if (s.gc_running) {
         stateField = "gc:active";
+        icon = "◐";
+    }
+    else if (s.task_state !== "idle") {
+        stateField = `task:${s.task_state}`;
         icon = "●";
     }
     else {
-        stateField = `task:${s.task_state}`;
+        stateField = "ready";
         icon = "●";
     }
     parts.push(stateField);

package/dist/status-line/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/status-line/format.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,CAAa;IACxC,MAAM,KAAK,GAAa,CAAC,SAAS,CAAC,CAAC;IAEpC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE3C,IAAI,UAAkB,CAAC;IACvB,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QACpB,UAAU,GAAG,aAAa,CAAC;QAC3B,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;SAAM,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QACjC,UAAU,GAAG,aAAa,CAAC,CAAC,eAAe,EAAE,CAAC;QAC9C,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QACxB,UAAU,GAAG,WAAW,CAAC;QACzB,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,QAAQ,CAAC,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/status-line/format.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,CAAa;IACxC,MAAM,KAAK,GAAa,CAAC,SAAS,CAAC,CAAC;IAEpC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE3C,IAAI,UAAkB,CAAC;IACvB,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAC1B,UAAU,GAAG,aAAa,CAAC,CAAC,eAAe,EAAE,CAAC;QAC9C,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QACxB,UAAU,GAAG,WAAW,CAAC;QACzB,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QACnC,UAAU,GAAG,QAAQ,CAAC,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,OAAO,CAAC;QACrB,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/status-line/index.d.ts

@@ -12,9 +12,6 @@ export type TaskState = "idle" | "running" | "queued" | "tightening" | "sensing"
 export interface StatusJson {
     /** ISO timestamp of last write. */
     updated_at: string;
-    daemon_alive: boolean;
-    ctx_tokens_used: number;
-    ctx_tokens_budget: number;
     decisions_in_scope: number;
     invariants_in_scope: number;
     task_state: TaskState;

package/dist/status-line/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/status-line/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2BH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/status-line/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwBH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/status-line/reader.d.ts

@@ -3,7 +3,7 @@
  * adopted repo at `repoRoot`. `sessionId` is the Claude Code session id
  * (passed via the status-line hook's stdin payload).
  *
- * Returns the placeholder `⬡ cairn  daemon:down  ○` when:
+ * Returns the placeholder `⬡ cairn  no session  ○` when:
  *   - `sessionId` is null/empty (status-line invoked outside a session)
  *   - the per-session status.json is missing
  *   - the file is unreadable, malformed JSON, or fails shape validation

package/dist/status-line/reader.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { formatStatus } from "./format.js";
 import { statusJsonPath } from "./writer.js";
-const PLACEHOLDER = "⬡ cairn  daemon:down  ○";
+const PLACEHOLDER = "⬡ cairn  no session  ○";
 const TASK_STATES = [
     "idle",
     "running",
@@ -25,9 +25,6 @@ function isStatusJson(x) {
         return false;
     const o = x;
     return (typeof o["updated_at"] === "string" &&
-        typeof o["daemon_alive"] === "boolean" &&
-        typeof o["ctx_tokens_used"] === "number" &&
-        typeof o["ctx_tokens_budget"] === "number" &&
         typeof o["decisions_in_scope"] === "number" &&
         typeof o["invariants_in_scope"] === "number" &&
         isTaskState(o["task_state"]) &&
@@ -42,7 +39,7 @@ function isStatusJson(x) {
  * adopted repo at `repoRoot`. `sessionId` is the Claude Code session id
  * (passed via the status-line hook's stdin payload).
  *
- * Returns the placeholder `⬡ cairn  daemon:down  ○` when:
+ * Returns the placeholder `⬡ cairn  no session  ○` when:
  *   - `sessionId` is null/empty (status-line invoked outside a session)
  *   - the per-session status.json is missing
  *   - the file is unreadable, malformed JSON, or fails shape validation

package/dist/status-line/reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/status-line/reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAE9C,MAAM,WAAW,GAAyB;IACxC,MAAM;IACN,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,WAAW;IACX,UAAU;CACX,CAAC;AAEF,SAAS,WAAW,CAAC,CAAU;IAC7B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,CAAU;IACjC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,QAAQ;QACnC,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,SAAS;QACtC,OAAO,CAAC,CAAC,iBAAiB,CAAC,KAAK,QAAQ;QACxC,OAAO,CAAC,CAAC,mBAAmB,CAAC,KAAK,QAAQ;QAC1C,OAAO,CAAC,CAAC,oBAAoB,CAAC,KAAK,QAAQ;QAC3C,OAAO,CAAC,CAAC,qBAAqB,CAAC,KAAK,QAAQ;QAC5C,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5B,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,SAAS;QACpC,OAAO,CAAC,CAAC,iBAAiB,CAAC,KAAK,QAAQ;QACxC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACrC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,SAAwB;IACzE,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IACrE,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IAE9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,WAAW,CAAC;IAE9C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/status-line/reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAE7C,MAAM,WAAW,GAAyB;IACxC,MAAM;IACN,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,WAAW;IACX,UAAU;CACX,CAAC;AAEF,SAAS,WAAW,CAAC,CAAU;IAC7B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,CAAU;IACjC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,QAAQ;QACnC,OAAO,CAAC,CAAC,oBAAoB,CAAC,KAAK,QAAQ;QAC3C,OAAO,CAAC,CAAC,qBAAqB,CAAC,KAAK,QAAQ;QAC5C,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5B,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,SAAS;QACpC,OAAO,CAAC,CAAC,iBAAiB,CAAC,KAAK,QAAQ;QACxC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACrC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,SAAwB;IACzE,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IACrE,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IAE9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,WAAW,CAAC;IAE9C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/status-line/writer.d.ts

@@ -21,13 +21,5 @@ export declare function writeStatusJson(repoRoot: string, sessionId: string, pat
  * Subsequent patches (heartbeat updated_at, attention_count, etc.)
  * merge over this baseline so the shape-validating reader always sees
  * a complete object.
- *
- * `ctx_tokens_budget` defaults to 4000 — the SessionStart
- * additionalContext cap (Section 0–7 budget). Hooks may overwrite once
- * a tighter per-session value is computed.
- *
- * `daemon_alive` is retained on the wire for status-line format
- * back-compat; the daemon itself is dormant. SessionStart writes
- * `true` to indicate the session is live.
  */
-export declare function defaultStatusJson(sessionAlive: boolean): StatusJson;
+export declare function defaultStatusJson(): StatusJson;

package/dist/status-line/writer.js

@@ -44,21 +44,10 @@ export function writeStatusJson(repoRoot, sessionId, patch) {
  * Subsequent patches (heartbeat updated_at, attention_count, etc.)
  * merge over this baseline so the shape-validating reader always sees
  * a complete object.
- *
- * `ctx_tokens_budget` defaults to 4000 — the SessionStart
- * additionalContext cap (Section 0–7 budget). Hooks may overwrite once
- * a tighter per-session value is computed.
- *
- * `daemon_alive` is retained on the wire for status-line format
- * back-compat; the daemon itself is dormant. SessionStart writes
- * `true` to indicate the session is live.
  */
-export function defaultStatusJson(sessionAlive) {
+export function defaultStatusJson() {
     return {
         updated_at: new Date().toISOString(),
-        daemon_alive: sessionAlive,
-        ctx_tokens_used: 0,
-        ctx_tokens_budget: 4000,
         decisions_in_scope: 0,
         invariants_in_scope: 0,
         task_state: "idle",

package/dist/status-line/writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/status-line/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,SAAiB;IAChE,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,SAAiB,EACjB,KAA0B;IAE1B,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE/C,IAAI,QAAQ,GAAwB,EAAE,CAAC;IACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;YAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAClD,QAAQ,GAAG,MAA6B,CAAC;YAC3C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAwB,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;IAE9D,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAqB;IACrD,OAAO;QACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,YAAY,EAAE,YAAY;QAC1B,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,CAAC;QACrB,mBAAmB,EAAE,CAAC;QACtB,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,KAAK;QACjB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/status-line/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,SAAiB;IAChE,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,SAAiB,EACjB,KAA0B;IAE1B,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE/C,IAAI,QAAQ,GAAwB,EAAE,CAAC;IACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;YAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAClD,QAAQ,GAAG,MAA6B,CAAC;YAC3C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAwB,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;IAE9D,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,kBAAkB,EAAE,CAAC;QACrB,mBAAmB,EAAE,CAAC;QACtB,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,KAAK;QACjB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isaacriehm/cairn-core",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "description": "Cairn core — state + context layer. Curated `.cairn/ground/` (decisions, §V invariants, canonical-map, brand, quality-grades), MCP server, init wizard, hook runners, sensors, GC drift sweep.",
   "author": "Isaac Riehm",
   "license": "MIT",

package/templates/.cairn/JOIN.md

@@ -14,10 +14,12 @@ If you opened this project with Claude Code and the Cairn plugin is
 enabled, the SessionStart hook detects an unbootstrapped clone and surfaces
 an inline `[a]` bootstrap prompt. Pick `[a]` once and you are done.
 
-If the plugin isn't installed yet:
+If the plugin isn't installed yet, register the marketplace once and
+install:
 
 ```bash
 # Inside Claude Code
+/plugin marketplace add isaacriehm/cairn
 /plugin install cairn@isaacriehm-cairn
 ```
 
@@ -40,14 +42,6 @@ cairn join                          # idempotent; safe to re-run
    versioned pre-commit / post-commit / commit-msg hooks run.
 3. Creates `.cairn/sessions/` for this clone if missing.
 
-## Path C — `package.json` `prepare` (Node projects only)
-
-For Node projects the adoption flow already wires
-`prepare: cairn join || true` into `package.json`. Running
-`npm install` / `pnpm install` runs `cairn join` for you. The `|| true`
-lets the install succeed even if Cairn isn't yet on PATH; the failure
-surfaces at first commit attempt instead.
-
 ## Verifying
 
 ```bash

package/templates/.cairn/git-hooks/commit-msg

@@ -9,9 +9,20 @@
 
 set -e
 
-if ! command -v cairn > /dev/null 2>&1; then
-  # If Cairn isn't on PATH, the pre-commit hook already blocked.
+REPO_ROOT="$(git rev-parse --show-toplevel 2> /dev/null || true)"
+if [ -z "$REPO_ROOT" ] || [ ! -d "$REPO_ROOT/.cairn" ]; then
   exit 0
 fi
 
-exec cairn sensor-run --commit-msg "$1" "$@"
+CAIRN_CMD=""
+if [ -f "$REPO_ROOT/.cairn/.cli-path" ]; then
+  CAIRN_CMD="$(head -n1 "$REPO_ROOT/.cairn/.cli-path")"
+fi
+if [ -z "$CAIRN_CMD" ] && command -v cairn > /dev/null 2>&1; then
+  CAIRN_CMD="cairn"
+fi
+if [ -z "$CAIRN_CMD" ]; then
+  exit 0
+fi
+
+eval "$CAIRN_CMD sensor-run --commit-msg \"$1\""

package/templates/.cairn/git-hooks/pre-commit

@@ -3,22 +3,31 @@
 #
 # Spec: PLUGIN_ARCHITECTURE §17 Layer 1.
 #
-# Fails the commit when:
-#   - Cairn CLI is missing from PATH
-#   - sensor-run --staged exits non-zero
+# Fails the commit when sensor-run --staged returns non-zero.
 #
-# To opt out a project: rm .cairn/  (irreversible).
-# Bypass for a single commit: git commit --no-verify (CI gate still catches).
+# Resolution order:
+#   1. .cairn/.cli-path (written by `cairn join`; points at the bundled
+#      cli.mjs for plugin users, the global cairn shim for CLI users).
+#   2. global `cairn` binary on PATH.
+#   3. exit 0 — no enforcement available; SessionStart bootstrap banner
+#      will surface on next Claude Code session and re-run join.
 
 set -e
 
-if ! command -v cairn > /dev/null 2>&1; then
-  echo "✗ Cairn CLI not on PATH"
-  echo "  This project requires Cairn. Install:"
-  echo "    /plugin install cairn@isaacriehm-cairn   (Claude Code)"
-  echo "    npm install -g @isaacriehm/cairn            (CLI)"
-  echo "  Or: rm -rf .cairn/  to opt the project out (irreversible)"
-  exit 1
+REPO_ROOT="$(git rev-parse --show-toplevel 2> /dev/null || true)"
+if [ -z "$REPO_ROOT" ] || [ ! -d "$REPO_ROOT/.cairn" ]; then
+  exit 0
 fi
 
-exec cairn sensor-run --staged "$@"
+CAIRN_CMD=""
+if [ -f "$REPO_ROOT/.cairn/.cli-path" ]; then
+  CAIRN_CMD="$(head -n1 "$REPO_ROOT/.cairn/.cli-path")"
+fi
+if [ -z "$CAIRN_CMD" ] && command -v cairn > /dev/null 2>&1; then
+  CAIRN_CMD="cairn"
+fi
+if [ -z "$CAIRN_CMD" ]; then
+  exit 0
+fi
+
+eval "$CAIRN_CMD sensor-run --staged"

package/templates/README.md

@@ -1,24 +0,0 @@
-# `templates/` — files the init script copies into adopted projects
-
-This directory ships with the `@isaacriehm/cairn` npm package. It is the seed for `.cairn/` and `.archive/` inside any project that runs:
-
-```sh
-npx @isaacriehm/cairn init <repo-dir>
-```
-
-Layout mirrors `docs/FILESYSTEM_LAYOUT.md`. The init script:
-
-1. Copies `templates/.cairn/config/*` into `<repo-dir>/.cairn/config/` (preserving the `<project_name>:` placeholder; the script then replaces it with the adopting project's package name).
-2. Copies `templates/.cairn/ground/manifest.yaml` (empty stub; daemon populates).
-3. Copies `templates/.archive/README.md` into `<repo-dir>/.archive/`.
-4. Creates the runtime directories (`runs/`, `inbox/`, `transcripts/`, `tasks/`, `staleness/`, `ground/{decisions,invariants,canonical-map,schema,routes,events}/`) and adds them to the project's `.gitignore` per spec §9.
-
-This directory is **NOT** Cairn's own state. The Cairn package source repo is not self-hosted; it is the source for the published npm package.
-
-## Why placeholders?
-
-The `<project_name>:` block in `templates/.cairn/config/workflow.md` is a placeholder by design. The init script reads the adopting project's `package.json name` (or directory name as fallback), normalizes it (lowercase, non-alphanumerics → underscores), and replaces every occurrence of `<project_name>` in the copied file. Cairn package code reads the project block at runtime via `Object.keys()` lookup — never by hardcoded project name (per L50, operator answer S1).
-
-## Editing templates
-
-Templates are the single source of seed configuration. Changes here flow to every freshly-adopted project on next `npx @isaacriehm/cairn init`. Existing adoptions are unaffected — they own their copies.