@isaacriehm/cairn-core 0.1.0

package/dist/hooks/runners/session-start.js

@@ -0,0 +1,167 @@
+/**
+ * `SessionStart` hook runner — composes the additionalContext payload
+ * Claude Code injects on session open and seeds the per-session state
+ * partition (status.json, events marker), then GCs stale sessions +
+ * events.
+ *
+ * Spec: PLUGIN_ARCHITECTURE §7 + §10. Bin entrypoint at
+ * `cairn-core/src/hooks/session-start.ts` calls into this runner.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { gcStaleEvents } from "../../events/index.js";
+import { inspectJoinState } from "../../join/index.js";
+import { resolveRepoRoot } from "../../session-start/index.js";
+import { buildSessionStartContext } from "../../session-start/index.js";
+import { ensureSessionDir, gcStaleSessions, resolveSessionId, seedEventsMarker, } from "../../session/index.js";
+import { defaultStatusJson, writeStatusJson } from "../../status-line/index.js";
+import { emitShapeB, parseHookPayload, readHookStdin, recordHookTelemetry, } from "./payload.js";
+export async function runSessionStartHook() {
+    const startedAt = Date.now();
+    const raw = await readHookStdin();
+    const payload = parseHookPayload(raw);
+    const payloadSessionId = typeof payload.session_id === "string" ? payload.session_id : null;
+    const source = typeof payload.source === "string" ? payload.source : null;
+    const cwdInput = typeof payload.cwd === "string" ? payload.cwd : process.cwd();
+    const repoRoot = resolveRepoRoot(cwdInput);
+    if (repoRoot === null) {
+        const out = {
+            continue: true,
+            hookSpecificOutput: {
+                hookEventName: "SessionStart",
+                additionalContext: "",
+            },
+        };
+        emitShapeB(out);
+        recordHookTelemetry({
+            hook: "session-start",
+            repoRoot: null,
+            sessionId: payloadSessionId,
+            source,
+            durationMs: Date.now() - startedAt,
+            warnings: ["no_cairn_dir_found"],
+            extra: {
+                sections_rendered: [],
+                sections_dropped: [],
+                total_chars: 0,
+            },
+        });
+        return;
+    }
+    const sessionWarnings = [];
+    const sessionId = resolveSessionId({ session_id: payloadSessionId ?? undefined });
+    try {
+        ensureSessionDir({ repoRoot, sessionId });
+        writeStatusJson(repoRoot, sessionId, defaultStatusJson(true));
+        seedEventsMarker({ repoRoot, sessionId });
+    }
+    catch (err) {
+        sessionWarnings.push(`session_dir_init_failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        const gc = gcStaleSessions({ repoRoot });
+        if (gc.removed.length > 0)
+            sessionWarnings.push(`gc_removed:${gc.removed.length}`);
+    }
+    catch (err) {
+        sessionWarnings.push(`session_gc_failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        const eventsGc = gcStaleEvents({ repoRoot });
+        if (eventsGc.removed.length > 0) {
+            sessionWarnings.push(`events_gc_removed:${eventsGc.removed.length}`);
+        }
+    }
+    catch (err) {
+        sessionWarnings.push(`events_gc_failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const isResume = source === "resume";
+    const buildArgs = { repoRoot };
+    if (isResume)
+        buildArgs.maxChars = 4_000;
+    if (source !== null)
+        buildArgs.source = source;
+    if (cwdInput !== repoRoot && cwdInput.startsWith(repoRoot)) {
+        buildArgs.scopeRelPath = cwdInput.slice(repoRoot.length + 1);
+    }
+    const result = await buildSessionStartContext(buildArgs);
+    try {
+        writeStatusJson(repoRoot, sessionId, {
+            decisions_in_scope: result.counts.decisions,
+            invariants_in_scope: result.counts.invariants,
+            attention_count: result.counts.pendingDrafts,
+            updated_at: new Date().toISOString(),
+        });
+    }
+    catch (err) {
+        sessionWarnings.push(`session_status_patch_failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const bootstrapBanner = renderBootstrapBanner(repoRoot);
+    const additionalContext = bootstrapBanner === null
+        ? result.additionalContext
+        : `${bootstrapBanner}\n\n${result.additionalContext}`;
+    const out = {
+        continue: true,
+        hookSpecificOutput: {
+            hookEventName: "SessionStart",
+            additionalContext,
+        },
+    };
+    emitShapeB(out);
+    recordHookTelemetry({
+        hook: "session-start",
+        repoRoot,
+        sessionId,
+        source,
+        durationMs: Date.now() - startedAt,
+        warnings: [
+            ...result.warnings,
+            ...sessionWarnings,
+            ...(bootstrapBanner !== null ? ["bootstrap_required"] : []),
+        ],
+        extra: {
+            sections_rendered: result.sectionsRendered,
+            sections_dropped: result.sectionsDropped,
+            total_chars: additionalContext.length,
+        },
+    });
+}
+/**
+ * Per PLUGIN_ARCHITECTURE §17 Layer 4: when a clone is cairn-adopted
+ * (`.cairn/config.yaml` present + `.git/` present) but `core.hooksPath`
+ * is unset, the plugin enters degraded mode. The session opens — read
+ * tools still work — but main Claude must surface the bootstrap prompt
+ * inline before the operator engages with any cairn write surface. The
+ * banner is the only contract: if the surrounding skill / agent does not
+ * gate on it, the MCP write tools' BOOTSTRAP_REQUIRED envelope is the
+ * server-side backstop.
+ */
+function renderBootstrapBanner(repoRoot) {
+    if (!existsSync(join(repoRoot, ".git")))
+        return null;
+    if (!existsSync(join(repoRoot, ".cairn", "config.yaml")))
+        return null;
+    const state = inspectJoinState({ repoRoot });
+    if (state.hooksPathSet)
+        return null;
+    const lines = [];
+    lines.push("## Cairn — bootstrap required");
+    lines.push("");
+    lines.push("This project is cairn-adopted, but this clone is not bootstrapped. " +
+        "Without `cairn join`, MCP write tools refuse, the cairn-direction " +
+        "skill blocks, and your local commits will fail at the pre-commit hook.");
+    lines.push("");
+    lines.push(`Project pinned to cairn ${state.projectCairnVersion ?? "(unset)"}.`);
+    lines.push("");
+    lines.push("Surface this inline to the operator now:");
+    lines.push("");
+    lines.push("> This project uses cairn, but your clone isn't bootstrapped.");
+    lines.push("> `[a]` bootstrap now (run `cairn join`, ~5s)");
+    lines.push("> `[b]` skip (cairn write surface stays disabled)");
+    lines.push("");
+    lines.push("On `[a]`, run `cairn join` from this repo's working directory and " +
+        "wait for it to print `cairn join: bootstrapped`. The next assistant " +
+        "turn will pick up the unblocked surface.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=session-start.js.map

package/dist/hooks/runners/session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../../src/hooks/runners/session-start.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAUtB,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,gBAAgB,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5F,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/E,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,GAAG,GAA6B;YACpC,QAAQ,EAAE,IAAI;YACd,kBAAkB,EAAE;gBAClB,aAAa,EAAE,cAAc;gBAC7B,iBAAiB,EAAE,EAAE;aACtB;SACF,CAAC;QACF,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,mBAAmB,CAAC;YAClB,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,gBAAgB;YAC3B,MAAM;YACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,QAAQ,EAAE,CAAC,oBAAoB,CAAC;YAChC,KAAK,EAAE;gBACL,iBAAiB,EAAE,EAAE;gBACrB,gBAAgB,EAAE,EAAE;gBACpB,WAAW,EAAE,CAAC;aACf;SACF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,UAAU,EAAE,gBAAgB,IAAI,SAAS,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC;QACH,gBAAgB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1C,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,gBAAgB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,CAAC,IAAI,CAClB,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,eAAe,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,CAAC,IAAI,CAClB,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7C,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,eAAe,CAAC,IAAI,CAAC,qBAAqB,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,CAAC,IAAI,CAClB,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,QAAQ,CAAC;IACrC,MAAM,SAAS,GAAmD,EAAE,QAAQ,EAAE,CAAC;IAC/E,IAAI,QAAQ;QAAE,SAAS,CAAC,QAAQ,GAAG,KAAK,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI;QAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC;IAC/C,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE;YACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;YAC3C,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;YAC7C,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa;YAC5C,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,CAAC,IAAI,CAClB,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,iBAAiB,GACrB,eAAe,KAAK,IAAI;QACtB,CAAC,CAAC,MAAM,CAAC,iBAAiB;QAC1B,CAAC,CAAC,GAAG,eAAe,OAAO,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAC1D,MAAM,GAAG,GAA6B;QACpC,QAAQ,EAAE,IAAI;QACd,kBAAkB,EAAE;YAClB,aAAa,EAAE,cAAc;YAC7B,iBAAiB;SAClB;KACF,CAAC;IACF,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,mBAAmB,CAAC;QAClB,IAAI,EAAE,eAAe;QACrB,QAAQ;QACR,SAAS;QACT,MAAM;QACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QAClC,QAAQ,EAAE;YACR,GAAG,MAAM,CAAC,QAAQ;YAClB,GAAG,eAAe;YAClB,GAAG,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D;QACD,KAAK,EAAE;YACL,iBAAiB,EAAE,MAAM,CAAC,gBAAgB;YAC1C,gBAAgB,EAAE,MAAM,CAAC,eAAe;YACxC,WAAW,EAAE,iBAAiB,CAAC,MAAM;SACtC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,qEAAqE;QACnE,oEAAoE;QACpE,wEAAwE,CAC3E,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,2BAA2B,KAAK,CAAC,mBAAmB,IAAI,SAAS,GAAG,CACrE,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,oEAAoE;QAClE,sEAAsE;QACtE,0CAA0C,CAC7C,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/hooks/runners/stop.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `Stop` hook runner — fires when the assistant turn ends.
+ *
+ * Current scope:
+ *   • Drain `.cairn/events/` since the per-session marker; stamp the
+ *     poll cursor so the next Stop only sees newer events.
+ *   • Scan `.cairn/tasks/active/<id>/` for tasks that have a
+ *     tightened spec but no `attestation.yaml`; surface a reviewer-
+ *     spawn hint in additionalContext so main Claude can spawn the
+ *     reviewer subagent on the next assistant turn.
+ *   • Patch the per-session status.json `updated_at` (heartbeat).
+ *
+ * Future scope (steps 7–8 per PLUGIN_ARCHITECTURE §10):
+ *   • Run sensors on staged + unstaged diff; surface findings inline.
+ *   • Compare HEAD's last 5 commits against `.attested-commits` marker;
+ *     surface backfill prompt for `--no-verify` bypasses.
+ */
+export declare function runStopHook(): Promise<void>;

package/dist/hooks/runners/stop.js

@@ -0,0 +1,165 @@
+/**
+ * `Stop` hook runner — fires when the assistant turn ends.
+ *
+ * Current scope:
+ *   • Drain `.cairn/events/` since the per-session marker; stamp the
+ *     poll cursor so the next Stop only sees newer events.
+ *   • Scan `.cairn/tasks/active/<id>/` for tasks that have a
+ *     tightened spec but no `attestation.yaml`; surface a reviewer-
+ *     spawn hint in additionalContext so main Claude can spawn the
+ *     reviewer subagent on the next assistant turn.
+ *   • Patch the per-session status.json `updated_at` (heartbeat).
+ *
+ * Future scope (steps 7–8 per PLUGIN_ARCHITECTURE §10):
+ *   • Run sensors on staged + unstaged diff; surface findings inline.
+ *   • Compare HEAD's last 5 commits against `.attested-commits` marker;
+ *     surface backfill prompt for `--no-verify` bypasses.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { eventsSince, } from "../../events/index.js";
+import { renderBypassHint, scanBypassedCommits, } from "../bypass-detection.js";
+import { resolveRepoRoot } from "../../session-start/index.js";
+import { readEventsMarker, stampEventsPoll, } from "../../session/index.js";
+import { writeStatusJson } from "../../status-line/index.js";
+import { emitShapeB, parseHookPayload, readHookStdin, recordHookTelemetry, } from "./payload.js";
+export async function runStopHook() {
+    const startedAt = Date.now();
+    const raw = await readHookStdin();
+    const payload = parseHookPayload(raw);
+    const sessionId = typeof payload.session_id === "string" ? payload.session_id : null;
+    const cwdInput = typeof payload.cwd === "string" ? payload.cwd : process.cwd();
+    const repoRoot = resolveRepoRoot(cwdInput);
+    const warnings = [];
+    let drained = [];
+    let pendingReviews = [];
+    let bypassed = [];
+    let additionalContext = "";
+    if (repoRoot !== null && sessionId !== null && sessionId.length > 0) {
+        try {
+            const marker = readEventsMarker(repoRoot, sessionId);
+            const since = marker?.last_polled_ts ?? Date.now() - 60_000;
+            const result = eventsSince({ repoRoot, sinceMs: since });
+            drained = result.events;
+            if (result.malformed.length > 0) {
+                warnings.push(`malformed_events:${result.malformed.length}`);
+            }
+            stampEventsPoll({ repoRoot, sessionId, ts: Date.now() });
+        }
+        catch (err) {
+            warnings.push(`events_poll_failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        try {
+            pendingReviews = scanPendingReviews(repoRoot);
+            if (pendingReviews.length > 0) {
+                additionalContext = renderReviewerHint(pendingReviews);
+            }
+        }
+        catch (err) {
+            warnings.push(`pending_review_scan_failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        try {
+            const bypassResult = scanBypassedCommits(repoRoot);
+            bypassed = bypassResult.bypassed;
+            if (bypassed.length > 0) {
+                const hint = renderBypassHint(bypassed);
+                additionalContext = additionalContext.length > 0
+                    ? `${additionalContext}\n\n${hint}`
+                    : hint;
+            }
+        }
+        catch (err) {
+            warnings.push(`bypass_scan_failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        try {
+            writeStatusJson(repoRoot, sessionId, {
+                updated_at: new Date().toISOString(),
+            });
+        }
+        catch (err) {
+            warnings.push(`status_heartbeat_failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const out = {
+        continue: true,
+        hookSpecificOutput: {
+            hookEventName: "Stop",
+            additionalContext,
+        },
+    };
+    emitShapeB(out);
+    recordHookTelemetry({
+        hook: "stop",
+        repoRoot,
+        sessionId,
+        source: null,
+        durationMs: Date.now() - startedAt,
+        warnings,
+        extra: {
+            events_drained: drained.length,
+            pending_reviews: pendingReviews.length,
+            bypassed_commits: bypassed.length,
+        },
+    });
+}
+/**
+ * Scan `.cairn/tasks/active/<id>/` for tasks that have a tightened
+ * spec but no `attestation.yaml`. Per PLUGIN_ARCHITECTURE §10, the
+ * Stop hook spawns the reviewer subagent for those.
+ *
+ * Window: only tasks whose spec has been touched in the last 6 hours.
+ * Older orphans are stale; the operator deals with them via attention
+ * rather than spawning reviewers blindly.
+ */
+function scanPendingReviews(repoRoot) {
+    const activeDir = join(repoRoot, ".cairn", "tasks", "active");
+    if (!existsSync(activeDir))
+        return [];
+    const out = [];
+    const cutoffMs = Date.now() - 6 * 60 * 60 * 1000;
+    let entries;
+    try {
+        entries = readdirSync(activeDir, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const taskId = entry.name;
+        const taskDir = join(activeDir, taskId);
+        const tightenedSpec = join(taskDir, "spec.tightened.md");
+        if (!existsSync(tightenedSpec))
+            continue;
+        const attestation = join(taskDir, "attestation.yaml");
+        if (existsSync(attestation))
+            continue;
+        let mtime = 0;
+        try {
+            mtime = statSync(tightenedSpec).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        if (mtime < cutoffMs)
+            continue;
+        out.push({
+            task_id: taskId,
+            spec_path: `.cairn/tasks/active/${taskId}/spec.tightened.md`,
+        });
+    }
+    return out;
+}
+function renderReviewerHint(pending) {
+    const lines = [];
+    lines.push(`## Reviewer pending (${pending.length} task${pending.length === 1 ? "" : "s"})`);
+    lines.push("");
+    for (const p of pending) {
+        lines.push(`- **${p.task_id}** — ${p.spec_path}`);
+    }
+    lines.push("");
+    lines.push("Spawn the `reviewer` subagent (defined at `agents/reviewer.md` in the cairn plugin) via the Task tool to attest each pending task. The subagent reads the diff, collects subagent attestation files, extracts non-obvious DECs, and writes the consolidated `attestation.yaml`. Once written, this hook will stop surfacing the reminder.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=stop.js.map

package/dist/hooks/runners/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/hooks/runners/stop.ts"],"names":[],"mappings":"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"}

package/dist/hooks/session-end.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/session-end.js`.
+ */
+export {};

package/dist/hooks/session-end.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/session-end.js`.
+ */
+import { runSessionEndHook } from "./runners/index.js";
+runSessionEndHook().catch((err) => {
+    process.stderr.write(`[cairn session-end] ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=session-end.js.map

package/dist/hooks/session-end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-end.js","sourceRoot":"","sources":["../../src/hooks/session-end.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC5E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/hooks/session-start.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/session-start.js`.
+ * Plugin manifest references this directly so cairn-frontend-claudecode
+ * doesn't depend on the `cairn` umbrella CLI being on PATH.
+ */
+export {};

package/dist/hooks/session-start.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/session-start.js`.
+ * Plugin manifest references this directly so cairn-frontend-claudecode
+ * doesn't depend on the `cairn` umbrella CLI being on PATH.
+ */
+import { runSessionStartHook } from "./runners/index.js";
+runSessionStartHook().catch((err) => {
+    process.stderr.write(`[cairn session-start] ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=session-start.js.map

package/dist/hooks/session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC9E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/hooks/stop.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/stop.js`.
+ */
+export {};

package/dist/hooks/stop.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/stop.js`.
+ */
+import { runStopHook } from "./runners/index.js";
+runStopHook().catch((err) => {
+    process.stderr.write(`[cairn stop] ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=stop.js.map

package/dist/hooks/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/hooks/stop.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACrE,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/hooks/write-guard.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/write-guard.js`.
+ * PostToolUse on Write/Edit; copy-safety + scope reminder.
+ */
+export {};

package/dist/hooks/write-guard.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Bin entrypoint — `node cairn-core/dist/hooks/write-guard.js`.
+ * PostToolUse on Write/Edit; copy-safety + scope reminder.
+ */
+import { runWriteGuardian } from "./post-tool-use/index.js";
+runWriteGuardian().catch((err) => {
+    process.stderr.write(`[cairn write-guard] ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=write-guard.js.map

package/dist/hooks/write-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-guard.js","sourceRoot":"","sources":["../../src/hooks/write-guard.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC5E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/inbox.d.ts

@@ -0,0 +1,17 @@
+import type { InboxKind } from "./frontend-types.js";
+/**
+ * Append a normalized event row to `.cairn/inbox/`.
+ *
+ * The orchestrator (Phase 8) tails this directory and acts on each row.
+ * Phase 5 just lands rows — no orchestrator yet. Inbox is a write-allowed
+ * path per `cairn/src/mcp/path-allowlist.ts` (`APPEND_ALLOWLIST`).
+ *
+ * Filename pattern: `<ts>-<source>-<kind>-<slug>.json`. Sortable, scannable,
+ * collision-resistant under concurrent writers.
+ */
+export declare function writeInboxRow(args: {
+    repoRoot: string;
+    source: string;
+    kind: InboxKind;
+    payload: object;
+}): Promise<string>;

package/dist/inbox.js

@@ -0,0 +1,30 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import { join } from "node:path";
+/**
+ * Append a normalized event row to `.cairn/inbox/`.
+ *
+ * The orchestrator (Phase 8) tails this directory and acts on each row.
+ * Phase 5 just lands rows — no orchestrator yet. Inbox is a write-allowed
+ * path per `cairn/src/mcp/path-allowlist.ts` (`APPEND_ALLOWLIST`).
+ *
+ * Filename pattern: `<ts>-<source>-<kind>-<slug>.json`. Sortable, scannable,
+ * collision-resistant under concurrent writers.
+ */
+export async function writeInboxRow(args) {
+    const { repoRoot, source, kind, payload } = args;
+    const dir = join(repoRoot, ".cairn", "inbox");
+    await mkdir(dir, { recursive: true });
+    const ts = Date.now();
+    const slug = randomBytes(4).toString("hex");
+    const file = join(dir, `${ts}-${source}-${kind}-${slug}.json`);
+    const row = {
+        kind,
+        source,
+        received_at: new Date().toISOString(),
+        ...payload,
+    };
+    await writeFile(file, `${JSON.stringify(row, null, 2)}\n`, "utf8");
+    return file;
+}
+//# sourceMappingURL=inbox.js.map

package/dist/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAKnC;IACC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG;QACV,IAAI;QACJ,MAAM;QACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,GAAG,OAAO;KACX,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @isaacriehm/cairn-core — state + context-loading layer.
+ *
+ * See docs/ARCHITECTURE.md §3.1.
+ */
+export declare const VERSION = "0.0.0";
+export { logger, setLogFile, setLogNull, setLogStderr } from "./logger.js";
+export { withWriteLock, acquireOperationLock, OperationLockHeldError, } from "./lock.js";
+export type { WithLockOptions } from "./lock.js";
+export * from "./claude/index.js";
+export * from "./context/index.js";
+export * from "./decision-capture/index.js";
+export * from "./doctor/index.js";
+export * from "./gc/index.js";
+export * from "./ground/index.js";
+export * from "./hooks/post-tool-use/index.js";
+export * from "./init/index.js";
+export * from "./join/index.js";
+export * from "./mcp/index.js";
+export * from "./paths/index.js";
+export * from "./profiles/index.js";
+export * from "./sensors/index.js";
+export * from "./events/index.js";
+export * from "./hooks/runners/index.js";
+export * from "./session/index.js";
+export * from "./session-start/index.js";
+export * from "./status-line/index.js";
+export * from "./tier0/index.js";
+export * from "./tightener/index.js";
+export * from "./frontend-types.js";
+export { writeInboxRow } from "./inbox.js";
+export { loadWorkflowTemplate, renderTemplate } from "./prompt.js";
+export type { TemplateContext } from "./prompt.js";

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @isaacriehm/cairn-core — state + context-loading layer.
+ *
+ * See docs/ARCHITECTURE.md §3.1.
+ */
+export const VERSION = "0.0.0";
+export { logger, setLogFile, setLogNull, setLogStderr } from "./logger.js";
+export { withWriteLock, acquireOperationLock, OperationLockHeldError, } from "./lock.js";
+export * from "./claude/index.js";
+export * from "./context/index.js";
+export * from "./decision-capture/index.js";
+export * from "./doctor/index.js";
+export * from "./gc/index.js";
+export * from "./ground/index.js";
+export * from "./hooks/post-tool-use/index.js";
+export * from "./init/index.js";
+export * from "./join/index.js";
+export * from "./mcp/index.js";
+export * from "./paths/index.js";
+export * from "./profiles/index.js";
+export * from "./sensors/index.js";
+export * from "./events/index.js";
+export * from "./hooks/runners/index.js";
+export * from "./session/index.js";
+export * from "./session-start/index.js";
+export * from "./status-line/index.js";
+export * from "./tier0/index.js";
+export * from "./tightener/index.js";
+export * from "./frontend-types.js";
+export { writeInboxRow } from "./inbox.js";
+export { loadWorkflowTemplate, renderTemplate } from "./prompt.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}