@isaacriehm/cairn-core 0.7.0 → 0.7.1

package/dist/hooks/runners/index.js

@@ -9,5 +9,5 @@ export { runStopHook } from "./stop.js";
 export { runUserPromptSubmitHook } from "./user-prompt-submit.js";
 export { renderBypassHint, scanBypassedCommits, } from "../bypass-detection.js";
 export { seedAttestedCommits } from "../seed-attested.js";
-export { CAIRN_HOOK_VERSION, emitShapeB, parseHookPayload, readHookStdin, recordHookTelemetry, } from "./payload.js";
+export { CAIRN_HOOK_VERSION, emitShapeB, parseHookPayload, readHookStdin, appendTelemetry, } from "./payload.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/runners/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/runners/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC"}

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

@@ -4,29 +4,44 @@
  *
  * Spec: Claude Code hook contract (Shape-B JSON on stdout).
  */
+import { z } from "zod";
 export declare const CAIRN_HOOK_VERSION = "0.2.0";
-export interface ClaudeHookPayload {
-    session_id?: string;
-    transcript_path?: string;
-    cwd?: string;
-    hook_event_name?: string;
-    source?: string;
-}
+declare const ClaudeHookPayloadSchema: z.ZodObject<{
+    session_id: z.ZodOptional<z.ZodString>;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type ClaudeHookPayload = z.infer<typeof ClaudeHookPayloadSchema>;
 export declare function readHookStdin(): Promise<string>;
 export declare function parseHookPayload(text: string): ClaudeHookPayload;
-export declare function emitShapeB(output: object): void;
-export interface HookTelemetryRow {
-    hook: string;
-    repoRoot: string | null;
+/**
+ * Hook event names Claude Code validates against the runner's stdout
+ * `hookSpecificOutput.hookEventName` field. Claude Code 2.1+ rejects
+ * a hook payload whose `hookEventName` doesn't match the event the
+ * hook was invoked for — e.g. a SessionStart hook returning
+ * `"PostToolUse"` is dropped with `Hook returned incorrect event
+ * name`. The previous shared default of `"PostToolUse"` worked
+ * historically but is now wrong for every other event.
+ */
+export type HookEventName = "SessionStart" | "SessionEnd" | "Stop" | "UserPromptSubmit" | "PreCompact" | "PostToolUse" | "PreToolUse" | "Notification";
+/**
+ * Write Shape-B JSON to stdout and exit.
+ * Claude Code expects exactly this JSON on stdout to continue.
+ * `hookEventName` MUST match the hook event the runner was invoked
+ * for; mismatches are rejected as `Hook returned incorrect event
+ * name` in Claude Code 2.1+.
+ */
+export declare function emitShapeB(context: string, hookEventName: HookEventName): never;
+/** Truncated append-only telemetry sink. */
+export declare function appendTelemetry(row: {
+    repoRoot: string;
     sessionId: string | null;
-    source: string | null;
+    kind: string;
     durationMs: number;
+    source: string | null;
     warnings: string[];
-    /** Free-form fields merged into the telemetry row. */
     extra?: Record<string, unknown>;
-}
-/**
- * Append a telemetry row to `~/.local/cairn/state/<hook>.jsonl`.
- * Telemetry must never throw — failures are swallowed.
- */
-export declare function recordHookTelemetry(row: HookTelemetryRow): void;
+}): void;
+export {};

package/dist/hooks/runners/payload.js

@@ -5,10 +5,16 @@
  * Spec: Claude Code hook contract (Shape-B JSON on stdout).
  */
 import { appendFileSync, existsSync, mkdirSync } from "node:fs";
-import { homedir } from "node:os";
-import { join, resolve } from "node:path";
-import { appendTrace } from "../../trace/index.js";
+import { join } from "node:path";
+import { z } from "zod";
 export const CAIRN_HOOK_VERSION = "0.2.0";
+const ClaudeHookPayloadSchema = z.object({
+    session_id: z.string().optional(),
+    transcript_path: z.string().optional(),
+    cwd: z.string().optional(),
+    hook_event_name: z.string().optional(),
+    source: z.string().optional(),
+}).passthrough();
 export function readHookStdin() {
     return new Promise((resolveP) => {
         const chunks = [];
@@ -16,62 +22,53 @@ export function readHookStdin() {
         process.stdin.on("end", () => {
             resolveP(Buffer.concat(chunks).toString("utf8"));
         });
-        process.stdin.on("error", () => {
-            resolveP("");
-        });
-        if (process.stdin.isTTY) {
-            // No piped input — Claude Code always pipes; this only matters in
-            // dev/test invocations.
-            resolveP("");
-        }
     });
 }
 export function parseHookPayload(text) {
     if (text.trim().length === 0)
         return {};
     try {
-        const parsed = JSON.parse(text);
-        return typeof parsed === "object" && parsed !== null ? parsed : {};
+        const raw = JSON.parse(text);
+        const result = ClaudeHookPayloadSchema.safeParse(raw);
+        return result.success ? result.data : {};
     }
     catch {
         return {};
     }
 }
-export function emitShapeB(output) {
-    process.stdout.write(JSON.stringify(output));
-    process.stdout.write("\n");
-}
 /**
- * Append a telemetry row to `~/.local/cairn/state/<hook>.jsonl`.
- * Telemetry must never throw — failures are swallowed.
+ * Write Shape-B JSON to stdout and exit.
+ * Claude Code expects exactly this JSON on stdout to continue.
+ * `hookEventName` MUST match the hook event the runner was invoked
+ * for; mismatches are rejected as `Hook returned incorrect event
+ * name` in Claude Code 2.1+.
  */
-export function recordHookTelemetry(row) {
-    const ts = new Date().toISOString();
-    const body = {
-        ts,
-        hook_version: CAIRN_HOOK_VERSION,
-        hook: row.hook,
-        ...(row.sessionId !== null ? { session_id: row.sessionId } : {}),
-        ...(row.source !== null ? { source: row.source } : {}),
-        ...(row.repoRoot !== null ? { repo_root: row.repoRoot } : {}),
-        duration_ms: row.durationMs,
-        warnings: row.warnings,
-        ...(row.extra ?? {}),
+export function emitShapeB(context, hookEventName) {
+    const payload = {
+        continue: true,
+        hookSpecificOutput: {
+            hookEventName,
+            additionalContext: context,
+        },
     };
-    try {
-        const dir = resolve(homedir(), ".local", "cairn", "state");
-        if (!existsSync(dir))
+    process.stdout.write(JSON.stringify(payload));
+    process.exit(0);
+}
+/** Truncated append-only telemetry sink. */
+export function appendTelemetry(row) {
+    const dir = join(row.repoRoot, ".cairn", "state", "telemetry");
+    if (!existsSync(dir)) {
+        try {
             mkdirSync(dir, { recursive: true });
-        const path = join(dir, `${row.hook}.jsonl`);
-        appendFileSync(path, `${JSON.stringify(body)}\n`, "utf8");
-    }
-    catch {
-        // Telemetry must never block the hook.
+        }
+        catch {
+            return;
+        }
     }
-    appendTrace({
-        ts,
-        source: "hook",
-        kind: row.hook,
+    const path = join(dir, "hooks.jsonl");
+    const entry = {
+        ts: new Date().toISOString(),
+        kind: row.kind,
         repo_root: row.repoRoot,
         session_id: row.sessionId,
         duration_ms: row.durationMs,
@@ -80,6 +77,12 @@ export function recordHookTelemetry(row) {
             warnings: row.warnings,
             ...(row.extra ?? {}),
         },
-    });
+    };
+    try {
+        appendFileSync(path, `${JSON.stringify(entry)}\n`, "utf8");
+    }
+    catch {
+        /* ignore */
+    }
 }
 //# sourceMappingURL=payload.js.map

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

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

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

@@ -6,7 +6,7 @@
  */
 import { resolveRepoRoot } from "../../session-start/index.js";
 import { cleanupSession } from "../../session/index.js";
-import { emitShapeB, parseHookPayload, readHookStdin, recordHookTelemetry, } from "./payload.js";
+import { emitShapeB, parseHookPayload, readHookStdin, appendTelemetry, } from "./payload.js";
 export async function runSessionEndHook() {
     const startedAt = Date.now();
     const raw = await readHookStdin();
@@ -23,17 +23,18 @@ export async function runSessionEndHook() {
         catch (err) {
             warnings.push(`cleanup_failed: ${err instanceof Error ? err.message : String(err)}`);
         }
+        appendTelemetry({
+            repoRoot: repoRoot,
+            sessionId,
+            kind: "session-end",
+            durationMs: Date.now() - startedAt,
+            source: null,
+            warnings,
+            extra: { removed },
+        });
     }
     const out = { continue: true };
-    emitShapeB(out);
-    recordHookTelemetry({
-        hook: "session-end",
-        repoRoot,
-        sessionId,
-        source: null,
-        durationMs: Date.now() - startedAt,
-        warnings,
-        extra: { removed },
-    });
+    void out;
+    emitShapeB("", "SessionEnd");
 }
 //# sourceMappingURL=session-end.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"session-end.js","sourceRoot":"","sources":["../../../src/hooks/runners/session-end.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAMtB,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,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,SAAS,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACrF,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,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,QAAQ,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC;YACH,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CACX,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvD,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,mBAAmB,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,QAAQ;QACR,SAAS;QACT,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QAClC,QAAQ;QACR,KAAK,EAAE,EAAE,OAAO,EAAE;KACnB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"session-end.js","sourceRoot":"","sources":["../../../src/hooks/runners/session-end.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AAMtB,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,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,SAAS,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACrF,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,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,QAAQ,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC;YACH,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CACX,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;QAED,eAAe,CAAC;YACd,QAAQ,EAAE,QAAkB;YAC5B,SAAS;YACT,IAAI,EAAE,aAAa;YACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,MAAM,EAAE,IAAI;YACZ,QAAQ;YACR,KAAK,EAAE,EAAE,OAAO,EAAE;SACnB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvD,KAAK,GAAG,CAAC;IACT,UAAU,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -4,7 +4,9 @@
  * 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.
+ * This is the ONLY project-aware hook that runs on UNADOPTED repos (to
+ * show the adoption banner).
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §3.
  */
 export declare function runSessionStartHook(): Promise<void>;