@isaacriehm/cairn-core 0.7.0 → 0.7.1

package/dist/hooks/post-tool-use/post-write.js

@@ -0,0 +1,112 @@
+/**
+ * Combined PostToolUse hook for Write/Edit tools.
+ *
+ * Merges the Write Guardian (safety/scope hints) and Layer A alignment
+ * into a single runner. This saves ~300ms of Node/CLI boot overhead
+ * by running both logically sequential tasks in a single process.
+ */
+import { z } from "zod";
+import { resolveRepoRoot } from "../../session-start/index.js";
+import { readHookStdin } from "../runners/payload.js";
+import { executeSotAlign } from "./sot-align.js";
+import { executeWriteGuardian } from "./write-guardian.js";
+import { logger } from "../../logger.js";
+const log = logger("hooks.post-tool-use.post-write");
+const ClaudePostToolUsePayloadSchema = z.object({
+    session_id: z.string().optional(),
+    transcript_path: z.string().optional(),
+    cwd: z.string().optional(),
+    hook_event_name: z.string().optional(),
+    tool_name: z.string().optional(),
+    tool_input: z.object({
+        file_path: z.string().optional(),
+        new_string: z.string().optional(),
+    }).passthrough().optional(),
+    tool_response: z.object({
+        content: z.string().optional(),
+        text: z.string().optional(),
+        output: z.string().optional(),
+    }).passthrough().optional(),
+}).passthrough();
+function parsePayload(text) {
+    if (text.trim().length === 0)
+        return {};
+    try {
+        const raw = JSON.parse(text);
+        const result = ClaudePostToolUsePayloadSchema.safeParse(raw);
+        return result.success ? result.data : {};
+    }
+    catch {
+        return {};
+    }
+}
+function emitShapeB(additionalContext) {
+    const out = {
+        continue: true,
+        hookSpecificOutput: {
+            hookEventName: "PostToolUse",
+            additionalContext,
+        },
+    };
+    process.stdout.write(JSON.stringify(out));
+    process.stdout.write("\n");
+}
+function emitBlock(reason) {
+    const out = {
+        continue: false,
+        decision: "block",
+        reason,
+    };
+    process.stdout.write(JSON.stringify(out));
+    process.stdout.write("\n");
+}
+export async function runPostWriteHook() {
+    try {
+        const raw = await readHookStdin();
+        const payload = parsePayload(raw);
+        const tool = payload.tool_name;
+        if (tool !== "Write" && tool !== "Edit") {
+            emitShapeB("");
+            return;
+        }
+        const filePath = payload.tool_input?.file_path;
+        if (filePath === undefined || filePath.length === 0) {
+            emitShapeB("");
+            return;
+        }
+        const cwd = payload.cwd ?? process.cwd();
+        const repoRoot = resolveRepoRoot(cwd);
+        if (repoRoot === null) {
+            emitShapeB("");
+            return;
+        }
+        // 1. Run Guardian (can block)
+        // Needs content — extract from tool_response
+        const content = payload.tool_response?.content ?? payload.tool_response?.text ?? payload.tool_response?.output ?? "";
+        const guard = executeWriteGuardian({
+            repoRoot,
+            relPath: filePath,
+            content,
+            payload,
+        });
+        if (guard.kind === "block") {
+            emitBlock(guard.message ?? "blocked");
+            return;
+        }
+        // 2. Run SoT Align (hint only)
+        const alignSummary = await executeSotAlign(payload, repoRoot);
+        // 3. Merge and Emit
+        const sections = [];
+        if (guard.message)
+            sections.push(guard.message);
+        if (alignSummary.length > 0)
+            sections.push(alignSummary);
+        emitShapeB(sections.join("\n\n"));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.warn({ err: message }, "Post-write hook failed; degrading to no-op");
+        emitShapeB("");
+    }
+}
+//# sourceMappingURL=post-write.js.map

package/dist/hooks/post-tool-use/post-write.js.map

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

package/dist/hooks/post-tool-use/read-enricher.d.ts

@@ -3,11 +3,16 @@
  *
  * Scans the file content the agent just read for cairn citation
  * patterns (`§INV-NNNN`, `TODO(TSK-<id>)`, banned `DEC-<N>`) and prepends a
- * legend block via Claude Code's documented Shape-B `additionalContext`
- * field so the agent sees authoritative resolutions inline with the
- * file content. No MCP round-trip; all sources read directly from
- * `.cairn/` on disk.
+ * legend block to Shape-B `additionalContext`.
  *
- * Spec: docs/READ_ENRICHER_SPEC.md
+ * This hook is critical for "Honest Agent" context continuity — it
+ * ensures that if an agent reads a file carrying a bare cite, it
+ * immediately sees the definition and rationale for that cite without
+ * having to manually fetch the DEC/INV artifact.
+ *
+ * Spec: docs/READ_ENRICHER_SPEC.md.
+ */
+/**
+ * Hook entry point.
  */
 export declare function runReadEnricher(): Promise<void>;

package/dist/hooks/post-tool-use/read-enricher.js

@@ -3,93 +3,49 @@
  *
  * Scans the file content the agent just read for cairn citation
  * patterns (`§INV-NNNN`, `TODO(TSK-<id>)`, banned `DEC-<N>`) and prepends a
- * legend block via Claude Code's documented Shape-B `additionalContext`
- * field so the agent sees authoritative resolutions inline with the
- * file content. No MCP round-trip; all sources read directly from
- * `.cairn/` on disk.
+ * legend block to Shape-B `additionalContext`.
  *
- * Spec: docs/READ_ENRICHER_SPEC.md
+ * This hook is critical for "Honest Agent" context continuity — it
+ * ensures that if an agent reads a file carrying a bare cite, it
+ * immediately sees the definition and rationale for that cite without
+ * having to manually fetch the DEC/INV artifact.
+ *
+ * Spec: docs/READ_ENRICHER_SPEC.md.
  */
-import { relative } from "node:path";
-import { readHookStdin } from "../runners/payload.js";
+import { resolve, relative } from "node:path";
+import { z } from "zod";
+import { getDecisionsLedger, getInvariantsLedger, getScopeIndexEntry, lookupTask, } from "@isaacriehm/cairn-state";
+import { readHookStdin, emitShapeB, appendTelemetry, } from "../runners/payload.js";
 import { resolveRepoRoot } from "../../session-start/index.js";
-import { appendTrace } from "../../trace/index.js";
 import { scanCitations } from "./citation-scanner.js";
-import { getDecisionsLedger, getFileCandidateCount, getInvariantsLedger, getScopeIndexEntry, lookupTask, } from "./ledger-cache.js";
 import { buildLegend } from "./legend-builder.js";
+import { logger } from "../../logger.js";
 const MAX_CONTENT_BYTES = 512_000;
 const BINARY_SAMPLE_BYTES = 1024;
 const BINARY_THRESHOLD = 0.05;
-function parsePayload(text) {
-    if (text.trim().length === 0)
-        return {};
-    try {
-        const parsed = JSON.parse(text);
-        return typeof parsed === "object" && parsed !== null ? parsed : {};
-    }
-    catch {
-        return {};
-    }
-}
-function pickContent(resp) {
-    if (!resp || typeof resp !== "object")
-        return undefined;
-    // Claude Code's Read tool wraps the body as `tool_response.file.content`.
-    // Check the nested file shape FIRST so it wins over any same-named key
-    // at the top level.
-    if (resp.file !== undefined && typeof resp.file === "object" && resp.file !== null) {
-        const f = resp.file;
-        if (typeof f.content === "string" && f.content.length > 0)
-            return f.content;
-        if (typeof f.text === "string" && f.text.length > 0)
-            return f.text;
-    }
-    const candidates = ["content", "text", "output"];
-    for (const k of candidates) {
-        const v = resp[k];
-        if (typeof v === "string" && v.length > 0)
-            return v;
-    }
-    return undefined;
-}
-function isBinary(content) {
-    const sampleLen = Math.min(content.length, BINARY_SAMPLE_BYTES);
-    if (sampleLen === 0)
-        return false;
-    let suspicious = 0;
-    for (let i = 0; i < sampleLen; i++) {
-        const code = content.charCodeAt(i);
-        if (code < 0x09 || (code >= 0x0e && code <= 0x1f))
-            suspicious++;
-    }
-    return suspicious / sampleLen > BINARY_THRESHOLD;
-}
-function isExcludedPath(relPath) {
-    if (relPath.startsWith(".archive/") || relPath === ".archive")
-        return true;
-    if (relPath.startsWith(".cairn/ground/") ||
-        relPath === ".cairn/ground") {
-        return true;
-    }
-    return false;
-}
-function computeRelPath(repoRoot, filePath) {
-    const rel = relative(repoRoot, filePath);
-    if (rel.startsWith("..") || rel.length === 0)
-        return filePath;
-    return rel.replace(/\\/g, "/");
-}
-function emitShapeB(additionalContext) {
-    const out = {
-        continue: true,
-        hookSpecificOutput: {
-            hookEventName: "PostToolUse",
-            additionalContext,
-        },
-    };
-    process.stdout.write(JSON.stringify(out));
-    process.stdout.write("\n");
-}
+const ClaudePostToolUsePayloadSchema = z.object({
+    session_id: z.string().optional(),
+    transcript_path: z.string().optional(),
+    cwd: z.string().optional(),
+    hook_event_name: z.string().optional(),
+    tool_name: z.string().optional(),
+    tool_input: z.object({
+        file_path: z.string().optional(),
+    }).optional(),
+    tool_response: z.object({
+        content: z.string().optional(),
+        text: z.string().optional(),
+        output: z.string().optional(),
+        file: z.object({
+            content: z.string().optional(),
+            text: z.string().optional(),
+        }).passthrough().optional(),
+    }).passthrough().optional(),
+}).passthrough();
+const log = logger("hooks.post-tool-use.read-enricher");
+/**
+ * Hook entry point.
+ */
 export async function runReadEnricher() {
     const ts = new Date().toISOString();
     let outcome = { skip: "unknown" };
@@ -98,15 +54,13 @@ export async function runReadEnricher() {
     try {
         const raw = await readHookStdin();
         const payload = parsePayload(raw);
-        sessionForTrace = typeof payload.session_id === "string" ? payload.session_id : null;
+        sessionForTrace = payload.session_id ?? null;
         if (payload.tool_name !== "Read") {
             outcome = { skip: "non-read-tool", tool_name: payload.tool_name };
-            emitShapeB("");
+            emitShapeB("", "PostToolUse");
             return;
         }
-        const filePath = typeof payload.tool_input?.file_path === "string"
-            ? payload.tool_input.file_path
-            : undefined;
+        const filePath = payload.tool_input?.file_path;
         const content = pickContent(payload.tool_response);
         if (filePath === undefined || content === undefined || content.length === 0) {
             outcome = {
@@ -115,96 +69,101 @@ export async function runReadEnricher() {
                 content_present: content !== undefined,
                 content_chars: content?.length ?? 0,
             };
-            emitShapeB("");
-            return;
-        }
-        if (content.length > MAX_CONTENT_BYTES) {
-            outcome = { skip: "content-too-large", content_chars: content.length };
-            emitShapeB("");
+            emitShapeB("", "PostToolUse");
             return;
         }
-        const repoRoot = resolveRepoRoot(filePath);
+        const cwd = payload.cwd ?? process.cwd();
+        const repoRoot = resolveRepoRoot(cwd);
         repoRootForTrace = repoRoot;
         if (repoRoot === null) {
-            outcome = { skip: "no-cairn-ancestor", file_path: filePath };
-            emitShapeB("");
-            return;
-        }
-        const relPath = computeRelPath(repoRoot, filePath);
-        if (isExcludedPath(relPath)) {
-            outcome = { skip: "excluded-path", rel_path: relPath };
-            emitShapeB("");
+            outcome = { skip: "not-adopted", cwd };
+            emitShapeB("", "PostToolUse");
             return;
         }
+        const relPath = relative(repoRoot, resolve(cwd, filePath));
         if (isBinary(content)) {
-            outcome = { skip: "binary-content", rel_path: relPath };
-            emitShapeB("");
+            outcome = { skip: "binary", path: relPath };
+            emitShapeB("", "PostToolUse");
             return;
         }
-        const matches = scanCitations(content);
-        const invariantsLedger = getInvariantsLedger(repoRoot);
+        const citations = scanCitations(content);
+        const scopeEntry = getScopeIndexEntry(repoRoot, relPath);
         const decisionsLedger = getDecisionsLedger(repoRoot);
-        const cachedEntry = getScopeIndexEntry(repoRoot, relPath);
-        const scopeHint = cachedEntry !== null
-            ? {
-                decisions: cachedEntry.decisions,
-                invariants: cachedEntry.invariants,
-            }
-            : null;
-        const resolveTaskFn = (taskId) => lookupTask(repoRoot, taskId);
-        // PR 2 / PHASE_6_REDESIGN §4.7 — O(1) lookup against the
-        // file-candidates-map. Stays at 0 (silent) on un-adopted projects
-        // and on files that aren't the SoT for any unpromoted candidate.
-        const unpromotedCandidates = getFileCandidateCount(repoRoot, relPath);
-        const legend = buildLegend(matches, invariantsLedger, decisionsLedger, scopeHint, resolveTaskFn, unpromotedCandidates);
-        if (legend === null) {
-            outcome = {
-                skip: "no-citations-no-scope",
-                rel_path: relPath,
-                decisions_matched: matches.decisions.length,
-                invariants_matched: matches.invariants.length,
-                todos_matched: matches.todos.length,
-                unpromoted_candidates: unpromotedCandidates,
-            };
-            emitShapeB("");
-            return;
-        }
+        const invariantsLedger = getInvariantsLedger(repoRoot);
+        const resolveTaskFn = (id) => lookupTask(repoRoot, id);
+        const legend = buildLegend(citations, invariantsLedger, decisionsLedger, scopeEntry, resolveTaskFn);
         outcome = {
-            emitted: true,
-            rel_path: relPath,
-            legend_chars: legend.length,
-            decisions_matched: matches.decisions.length,
-            invariants_matched: matches.invariants.length,
-            todos_matched: matches.todos.length,
-            unpromoted_candidates: unpromotedCandidates,
+            ok: true,
+            path: relPath,
+            citations: {
+                invariants: citations.invariants.length,
+                decisions: citations.decisions.length,
+                todos: citations.todos.length,
+            },
+            legend_chars: legend?.length ?? 0,
         };
-        emitShapeB(legend);
+        emitShapeB(legend ?? "", "PostToolUse");
     }
     catch (err) {
-        outcome = { error: err instanceof Error ? err.message : String(err) };
-        // Defer-fail gracefully — the hook is a no-op enrichment, NOT a gate.
-        try {
-            emitShapeB("");
-        }
-        catch {
-            // Last-resort: nothing we can do.
-        }
+        const message = err instanceof Error ? err.message : String(err);
+        outcome = { error: message };
+        log.error({ err: message }, "read-enricher hook failed");
+        emitShapeB("", "PostToolUse");
     }
     finally {
-        // Skip trace writes for non-cairn projects — keeps
-        // ~/.local/cairn/trace/ quiet outside cairn-adopted repos so the
-        // hook leaves no footprint when there's nothing to enrich.
-        if (outcome["skip"] !== "no-cairn-ancestor") {
-            appendTrace({
-                ts,
-                source: "hook",
+        if (repoRootForTrace !== null) {
+            appendTelemetry({
+                repoRoot: repoRootForTrace,
+                sessionId: sessionForTrace,
                 kind: "read-enrich",
-                repo_root: repoRootForTrace,
-                session_id: sessionForTrace,
-                ok: outcome["error"] === undefined,
-                payload: outcome,
+                durationMs: Date.now() - Date.parse(ts),
+                source: "hook",
+                warnings: [],
+                extra: outcome,
             });
         }
     }
 }
+function parsePayload(text) {
+    if (text.trim().length === 0)
+        return {};
+    try {
+        const raw = JSON.parse(text);
+        const result = ClaudePostToolUsePayloadSchema.safeParse(raw);
+        return result.success ? result.data : {};
+    }
+    catch {
+        return {};
+    }
+}
+function pickContent(resp) {
+    if (resp === undefined)
+        return undefined;
+    // Claude Code's Read tool wraps the body as `tool_response.file.content`.
+    // Check the nested file shape FIRST so it wins over any same-named key
+    // at the top level.
+    if (resp.file !== undefined) {
+        const f = resp.file;
+        if (typeof f.content === "string" && f.content.length > 0)
+            return f.content;
+        if (typeof f.text === "string" && f.text.length > 0)
+            return f.text;
+    }
+    if (typeof resp.content === "string" && resp.content.length > 0)
+        return resp.content;
+    if (typeof resp.text === "string" && resp.text.length > 0)
+        return resp.text;
+    if (typeof resp.output === "string" && resp.output.length > 0)
+        return resp.output;
+    return undefined;
+}
+function isBinary(content) {
+    const sampleLen = Math.min(content.length, BINARY_SAMPLE_BYTES);
+    let nullCount = 0;
+    for (let i = 0; i < sampleLen; i++) {
+        if (content.charCodeAt(i) === 0)
+            nullCount++;
+    }
+    return nullCount / sampleLen > BINARY_THRESHOLD;
+}
 //# sourceMappingURL=read-enricher.js.map

package/dist/hooks/post-tool-use/read-enricher.js.map

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

package/dist/hooks/post-tool-use/sot-align.d.ts

@@ -46,6 +46,17 @@
  *     (`.md`/`.mdx`) skipped entirely — operator-curated narrative is
  *     handled by phase 5b's topic-index + the doc-drift sensor.
  */
+import { z } from "zod";
+declare const ClaudePostToolUsePayloadSchema: z.ZodObject<{
+    session_id: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodOptional<z.ZodString>;
+    tool_name: z.ZodOptional<z.ZodString>;
+    tool_input: z.ZodOptional<z.ZodObject<{
+        file_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+type ClaudePostToolUsePayload = z.infer<typeof ClaudePostToolUsePayloadSchema>;
 export interface AlignFileArgs {
     repoRoot: string;
     /** Repo-relative POSIX path written by Claude Code. */
@@ -163,4 +174,5 @@ export interface AlignFileResult {
  */
 export declare function alignFile(args: AlignFileArgs): Promise<AlignFileResult>;
 export declare function runSotAlign(): Promise<void>;
+export declare function executeSotAlign(payload: ClaudePostToolUsePayload, repoRoot: string): Promise<string>;
 export {};