@isaacriehm/cairn 0.1.0

package/dist/backprop/writer.js

@@ -0,0 +1,301 @@
+/**
+ * Writers for the invariant file + the generated sensor / E2E.
+ *
+ * The agent supplies content; the harness mints the id, materializes the
+ * frontmatter, and emits the boilerplate around the regex / E2E so the
+ * surface is uniform regardless of which agent wrote which invariant.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { invariantsDir } from "../ground/paths.js";
+/**
+ * Materialize V<N>.md + the matching enforcement artifact. Returns
+ * repo-relative paths for both. Idempotent at the *path* level — if a file
+ * already exists at the target path the writer overwrites; the id allocator
+ * is responsible for picking a fresh id.
+ */
+export function writeInvariantArtifacts(args) {
+    const invariantPath = writeInvariantFile(args);
+    const sensorPath = writeEnforcement(args);
+    return { invariant_path: invariantPath, sensor_path: sensorPath };
+}
+function writeInvariantFile(args) {
+    const dir = invariantsDir(args.repoRoot);
+    mkdirSync(dir, { recursive: true });
+    const filename = `${args.invariantId}.md`;
+    const abs = join(dir, filename);
+    const rel = `.harness/ground/invariants/${filename}`;
+    const sensorRel = predictSensorRelPath(args);
+    const frontmatter = {
+        id: args.invariantId,
+        title: args.output.title,
+        type: "invariant",
+        status: "active",
+        audience: "dual",
+        generated: new Date().toISOString(),
+        "verified-at": new Date().toISOString(),
+        source_run: args.runId,
+        introduced_for_bug: args.output.introduced_for_bug,
+        sensor: sensorRel,
+        naming_convention: `${args.invariantId.toLowerCase()}_${args.output.slug}`,
+        ...(args.output.source_decision_ids && args.output.source_decision_ids.length > 0
+            ? { source_decisions: args.output.source_decision_ids }
+            : {}),
+    };
+    const yaml = stringifyYaml(frontmatter);
+    const body = ensureTrailingNewline(args.output.body_markdown.trim());
+    const fileContent = `---\n${yaml}---\n\n# ${args.invariantId} — ${args.output.title}\n\n${body}\n\n## Enforcement\n\nThis invariant is enforced by [\`${sensorRel}\`](../../../${sensorRel}).\n`;
+    writeFileSync(abs, fileContent, "utf8");
+    return rel;
+}
+/**
+ * Compute what the sensor / E2E path WILL be, before writing it. Used by
+ * writeInvariantFile to embed the relative link inside the invariant
+ * markdown body.
+ */
+function predictSensorRelPath(args) {
+    const kind = args.output.enforcement.kind;
+    if (kind === "regex_sensor") {
+        const filename = `check-${args.invariantId.toLowerCase()}-${args.output.slug}.ts`;
+        return `harness/scripts/${filename}`;
+    }
+    if (kind === "named_e2e") {
+        const customPath = args.output.enforcement.e2e_path;
+        return isValidE2eRel(customPath)
+            ? customPath
+            : `e2e/${args.invariantId}_${args.output.slug}.spec.ts`;
+    }
+    throw new Error(`unknown enforcement kind: ${kind}`);
+}
+function writeEnforcement(args) {
+    const kind = args.output.enforcement.kind;
+    if (kind === "regex_sensor")
+        return writeRegexSensor(args);
+    if (kind === "named_e2e")
+        return writeE2eStub(args);
+    // Defensive: schema-checked, but TS exhaustive switch guard.
+    throw new Error(`unknown enforcement kind: ${kind}`);
+}
+function writeRegexSensor(args) {
+    const { invariantId, output } = args;
+    const slug = output.slug;
+    const filename = `check-${invariantId.toLowerCase()}-${slug}.ts`;
+    const rel = `harness/scripts/${filename}`;
+    const abs = resolve(args.repoRoot, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    const regex = output.enforcement.regex ?? "(?!.*)"; // never matches
+    const targetGlobs = output.enforcement.target_globs ?? ["**/*.ts"];
+    const language = output.enforcement.language ?? "typescript";
+    const failureMessage = output.enforcement.failure_message ??
+        `${invariantId} violation — see .harness/ground/invariants/${invariantId}.md`;
+    const escapedRegex = JSON.stringify(regex);
+    const escapedGlobs = JSON.stringify(targetGlobs);
+    const escapedMessage = JSON.stringify(failureMessage);
+    const content = `#!/usr/bin/env tsx
+/**
+ * Sensor for invariant ${invariantId} — ${output.title}.
+ *
+ * Generated by the backprop subagent during run ${args.runId}.
+ * Source: .harness/ground/invariants/${invariantId}.md
+ *
+ * Mechanically scans repo files matching the target globs for a regex that
+ * indicates an invariant violation. Exits 0 when no hits, 1 on any hit.
+ *
+ * Per PRIMER §13: "every fix introduces a permanent invariant" — touching
+ * this file requires either fixing the regression OR superseding the
+ * invariant via a new V-id.
+ */
+
+import { type Dirent, readdirSync, readFileSync, statSync } from "node:fs";
+import { relative, resolve } from "node:path";
+
+const REGEX = new RegExp(${escapedRegex}, "gm");
+const TARGET_GLOBS = ${escapedGlobs} as const;
+const LANGUAGE = ${JSON.stringify(language)};
+const FAILURE_MESSAGE = ${escapedMessage};
+
+const SKIP_DIRS = new Set([
+  ".git",
+  "node_modules",
+  ".pnpm-store",
+  "dist",
+  "build",
+  ".next",
+  ".turbo",
+  ".cache",
+  ".archive",
+  "coverage",
+]);
+
+const LANGUAGE_EXTS: Record<string, readonly string[]> = {
+  typescript: [".ts", ".tsx", ".cts", ".mts"],
+  javascript: [".js", ".jsx", ".cjs", ".mjs"],
+  python: [".py"],
+  ruby: [".rb"],
+  go: [".go"],
+  rust: [".rs"],
+  sql: [".sql"],
+};
+
+function compileGlob(glob: string): RegExp {
+  let re = "^";
+  for (let i = 0; i < glob.length; i++) {
+    const c = glob[i];
+    if (c === "*") {
+      if (glob[i + 1] === "*") {
+        i += 1;
+        if (glob[i + 1] === "/") {
+          i += 1;
+          re += "(?:.*/)?";
+        } else {
+          re += ".*";
+        }
+      } else {
+        re += "[^/]*";
+      }
+    } else if (c === "?") {
+      re += "[^/]";
+    } else if (c !== undefined && /[.+^\${}()|[\\]\\\\]/.test(c)) {
+      re += \`\\\\\${c}\`;
+    } else {
+      re += c ?? "";
+    }
+  }
+  re += "$";
+  return new RegExp(re);
+}
+
+const GLOB_RE = TARGET_GLOBS.map(compileGlob);
+
+function matchesGlobs(rel: string): boolean {
+  return GLOB_RE.some((g) => g.test(rel));
+}
+
+function lineOf(text: string, charIndex: number): number {
+  let line = 1;
+  for (let i = 0; i < charIndex && i < text.length; i++) {
+    if (text.charCodeAt(i) === 10) line += 1;
+  }
+  return line;
+}
+
+function walk(repoRoot: string): string[] {
+  const out: string[] = [];
+  const stack: string[] = [repoRoot];
+  while (stack.length > 0) {
+    const dir = stack.pop();
+    if (dir === undefined) break;
+    let entries: Dirent[];
+    try {
+      entries = readdirSync(dir, { withFileTypes: true, encoding: "utf8" });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const abs = resolve(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (SKIP_DIRS.has(entry.name)) continue;
+        stack.push(abs);
+      } else if (entry.isFile()) {
+        out.push(relative(repoRoot, abs).replace(/\\\\/g, "/"));
+      }
+    }
+  }
+  out.sort();
+  return out;
+}
+
+function detectLanguage(rel: string): string | undefined {
+  const lower = rel.toLowerCase();
+  for (const [lang, exts] of Object.entries(LANGUAGE_EXTS)) {
+    if (exts.some((e) => lower.endsWith(e))) return lang;
+  }
+  return undefined;
+}
+
+function main(): void {
+  const repoRoot = process.argv[2] ?? process.cwd();
+  void statSync(repoRoot); // throws if missing
+  const files = walk(repoRoot).filter((rel) => matchesGlobs(rel) && detectLanguage(rel) === LANGUAGE);
+  const hits: { path: string; line: number; matched: string }[] = [];
+  for (const rel of files) {
+    let content: string;
+    try {
+      content = readFileSync(resolve(repoRoot, rel), "utf8");
+    } catch {
+      continue;
+    }
+    REGEX.lastIndex = 0;
+    let m: RegExpExecArray | null;
+    while ((m = REGEX.exec(content)) !== null) {
+      hits.push({
+        path: rel,
+        line: lineOf(content, m.index),
+        matched: m[0].slice(0, 200),
+      });
+      if (REGEX.lastIndex === m.index) REGEX.lastIndex += 1;
+    }
+  }
+  if (hits.length === 0) {
+    console.log(\`${invariantId}: ok — 0 hits across \${files.length} files\`);
+    process.exit(0);
+  }
+  console.error(\`${invariantId}: FAIL — \${hits.length} hit(s)\`);
+  console.error(\`  \${FAILURE_MESSAGE}\`);
+  for (const h of hits) {
+    console.error(\`  \${h.path}:\${h.line} → \${h.matched}\`);
+  }
+  process.exit(1);
+}
+
+main();
+`;
+    writeFileSync(abs, content, "utf8");
+    return rel;
+}
+function writeE2eStub(args) {
+    const { invariantId, output } = args;
+    const customPath = output.enforcement.e2e_path;
+    // Default: e2e/V<N>_<slug>.spec.ts. Honor the agent-supplied path only if it
+    // is repo-relative and ends in .spec.ts; otherwise fall back to default.
+    const defaultRel = `e2e/${invariantId}_${output.slug}.spec.ts`;
+    const rel = isValidE2eRel(customPath) ? customPath : defaultRel;
+    const abs = resolve(args.repoRoot, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    const content = `/**
+ * E2E case for invariant ${invariantId} — ${output.title}.
+ *
+ * Generated by the backprop subagent during run ${args.runId}.
+ * Source: .harness/ground/invariants/${invariantId}.md
+ *
+ * STUB — flesh out with the project's E2E harness. The presence of this
+ * file is itself a contract: removing it without superseding ${invariantId}
+ * is an invariant violation.
+ */
+
+// TODO: import the project's E2E harness and write a case that asserts
+// ${output.title.replace(/\*/g, "")}.
+//
+// The failure mode this guards: ${output.introduced_for_bug.replace(/\n/g, " ").slice(0, 200)}
+//
+// Naming convention: this file's path encodes the invariant id (${invariantId})
+// per PRIMER §13.1. Cite the id in any commit that touches it.
+export const ${invariantId.toLowerCase()}_invariant = ${JSON.stringify(invariantId)};
+`;
+    writeFileSync(abs, content, "utf8");
+    return rel;
+}
+function isValidE2eRel(p) {
+    if (typeof p !== "string" || p.length === 0)
+        return false;
+    if (p.startsWith("/") || p.startsWith(".."))
+        return false;
+    if (!p.endsWith(".spec.ts") && !p.endsWith(".spec.tsx"))
+        return false;
+    return true;
+}
+function ensureTrailingNewline(s) {
+    return s.endsWith("\n") ? s : `${s}\n`;
+}
+//# sourceMappingURL=writer.js.map

package/dist/backprop/writer.js.map

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

package/dist/claude/error.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Claude subprocess error classification.
+ *
+ * The CLI surfaces rate-limit / overload / auth failures via stderr +
+ * non-zero exit. Classifying lets the orchestrator distinguish:
+ *   - `rate_limit` / `overloaded` → pause dispatch after N consecutive,
+ *     don't burn the operator's coding-plan quota on doomed retries
+ *   - `auth` → stop trying immediately + page operator
+ *   - `other` → ordinary failure, dispatch normally
+ *
+ * Used by both `claude/runner.ts` (one-shot calls) and
+ * `orchestrator/runner.ts` (stream-json implementer runs).
+ */
+export type ClaudeErrorKind = "rate_limit" | "overloaded" | "auth" | "other";
+export declare class ClaudeError extends Error {
+    readonly kind: ClaudeErrorKind;
+    readonly exitCode: number | undefined;
+    readonly stderr: string | undefined;
+    constructor(args: {
+        message: string;
+        kind: ClaudeErrorKind;
+        exitCode?: number | null;
+        stderr?: string;
+    });
+}
+export declare function classifyClaudeError(args: {
+    message: string;
+    exitCode?: number | null;
+    stderr?: string;
+}): ClaudeErrorKind;
+/** True when the kind warrants a dispatch pause (vs a per-task fail). */
+export declare function isQuotaKind(kind: ClaudeErrorKind): boolean;
+export declare function asClaudeError(err: unknown, fallbackStderr?: string): ClaudeError;

package/dist/claude/error.js

@@ -0,0 +1,58 @@
+/**
+ * Claude subprocess error classification.
+ *
+ * The CLI surfaces rate-limit / overload / auth failures via stderr +
+ * non-zero exit. Classifying lets the orchestrator distinguish:
+ *   - `rate_limit` / `overloaded` → pause dispatch after N consecutive,
+ *     don't burn the operator's coding-plan quota on doomed retries
+ *   - `auth` → stop trying immediately + page operator
+ *   - `other` → ordinary failure, dispatch normally
+ *
+ * Used by both `claude/runner.ts` (one-shot calls) and
+ * `orchestrator/runner.ts` (stream-json implementer runs).
+ */
+export class ClaudeError extends Error {
+    kind;
+    exitCode;
+    stderr;
+    constructor(args) {
+        super(args.message);
+        this.name = "ClaudeError";
+        this.kind = args.kind;
+        this.exitCode =
+            typeof args.exitCode === "number" ? args.exitCode : undefined;
+        this.stderr = args.stderr;
+    }
+}
+const RATE_LIMIT_RE = /rate[\s_-]?limit|\b429\b|too many requests|usage_limit/i;
+const OVERLOADED_RE = /overloaded|\b529\b|temporarily unavailable|service.?unavailable|\b503\b/i;
+const AUTH_RE = /unauthorized|forbidden|\b401\b|\b403\b|authentication|please[\s_-]+log[\s_-]?in|not[\s_-]+authenticated|invalid[\s_-]+api[\s_-]+key|api[\s_-]+key[\s_-]+expired|credit[\s_-]+balance[\s_-]+is[\s_-]+too[\s_-]+low/i;
+export function classifyClaudeError(args) {
+    const text = `${args.message}\n${args.stderr ?? ""}`;
+    if (RATE_LIMIT_RE.test(text))
+        return "rate_limit";
+    if (OVERLOADED_RE.test(text))
+        return "overloaded";
+    if (AUTH_RE.test(text))
+        return "auth";
+    return "other";
+}
+/** True when the kind warrants a dispatch pause (vs a per-task fail). */
+export function isQuotaKind(kind) {
+    return kind === "rate_limit" || kind === "overloaded";
+}
+export function asClaudeError(err, fallbackStderr) {
+    if (err instanceof ClaudeError)
+        return err;
+    const message = err instanceof Error ? err.message : String(err);
+    const kind = classifyClaudeError({
+        message,
+        ...(fallbackStderr !== undefined ? { stderr: fallbackStderr } : {}),
+    });
+    return new ClaudeError({
+        message,
+        kind,
+        ...(fallbackStderr !== undefined ? { stderr: fallbackStderr } : {}),
+    });
+}
+//# sourceMappingURL=error.js.map

package/dist/claude/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/claude/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,QAAQ,CAAqB;IAC7B,MAAM,CAAqB;IAEpC,YAAY,IAKX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ;YACX,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,aAAa,GAAG,yDAAyD,CAAC;AAChF,MAAM,aAAa,GAAG,0EAA0E,CAAC;AACjG,MAAM,OAAO,GACX,oNAAoN,CAAC;AAEvN,MAAM,UAAU,mBAAmB,CAAC,IAInC;IACC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IACrD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IAClD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IAClD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,IAAqB;IAC/C,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,cAAuB;IACjE,IAAI,GAAG,YAAY,WAAW;QAAE,OAAO,GAAG,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,mBAAmB,CAAC;QAC/B,OAAO;QACP,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;IACH,OAAO,IAAI,WAAW,CAAC;QACrB,OAAO;QACP,IAAI;QACJ,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}

package/dist/claude/index.d.ts

@@ -0,0 +1,3 @@
+export { claudeIsAvailable, runClaude } from "./runner.js";
+export type { ClaudeTier, ClaudeUsage, RunClaudeOptions, RunClaudeResult, } from "./types.js";
+export { asClaudeError, ClaudeError, classifyClaudeError, isQuotaKind, type ClaudeErrorKind, } from "./error.js";

package/dist/claude/index.js

@@ -0,0 +1,3 @@
+export { claudeIsAvailable, runClaude } from "./runner.js";
+export { asClaudeError, ClaudeError, classifyClaudeError, isQuotaKind, } from "./error.js";
+//# sourceMappingURL=index.js.map

package/dist/claude/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO3D,OAAO,EACL,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,WAAW,GAEZ,MAAM,YAAY,CAAC"}

package/dist/claude/runner.d.ts

@@ -0,0 +1,11 @@
+import type { RunClaudeOptions, RunClaudeResult } from "./types.js";
+/** Returns true when `claude --version` succeeds. Used at startup + smoke. */
+export declare function claudeIsAvailable(): boolean;
+/**
+ * Run a single non-interactive Claude Code call via subprocess.
+ *
+ * Auth path: relies on the operator's existing Claude Code login (OAuth /
+ * keychain). No `--bare`, no `ANTHROPIC_API_KEY`. The whole point is to use
+ * the operator's coding-plan subscription quota per L42.
+ */
+export declare function runClaude(opts: RunClaudeOptions): Promise<RunClaudeResult>;

package/dist/claude/runner.js

@@ -0,0 +1,132 @@
+import { spawn, spawnSync } from "node:child_process";
+import { logger } from "../logger.js";
+import { ClaudeError, classifyClaudeError } from "./error.js";
+const log = logger("claude.runner");
+/** Tier → model alias passed to `claude --model`. */
+const TIER_MODEL = {
+    haiku: "haiku",
+    sonnet: "sonnet",
+    opus: "opus",
+};
+/** Returns true when `claude --version` succeeds. Used at startup + smoke. */
+export function claudeIsAvailable() {
+    try {
+        const result = spawnSync("claude", ["--version"], { encoding: "utf8" });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run a single non-interactive Claude Code call via subprocess.
+ *
+ * Auth path: relies on the operator's existing Claude Code login (OAuth /
+ * keychain). No `--bare`, no `ANTHROPIC_API_KEY`. The whole point is to use
+ * the operator's coding-plan subscription quota per L42.
+ */
+export async function runClaude(opts) {
+    const model = TIER_MODEL[opts.tier];
+    const args = [
+        "--print",
+        "--output-format",
+        "json",
+        "--no-session-persistence",
+        "--model",
+        model,
+    ];
+    if (opts.system !== undefined) {
+        args.push("--system-prompt", opts.system);
+    }
+    if (opts.jsonSchema !== undefined) {
+        args.push("--json-schema", JSON.stringify(opts.jsonSchema));
+    }
+    if (opts.extraArgs && opts.extraArgs.length > 0) {
+        args.push(...opts.extraArgs);
+    }
+    const startedAt = Date.now();
+    const ctrl = new AbortController();
+    const timeoutMs = opts.timeoutMs ?? 120_000;
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    return new Promise((resolve, reject) => {
+        const child = spawn("claude", args, {
+            cwd: opts.cwd ?? process.cwd(),
+            stdio: ["pipe", "pipe", "pipe"],
+            signal: ctrl.signal,
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        child.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+        child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            const stdout = Buffer.concat(stdoutChunks).toString("utf8");
+            const stderr = Buffer.concat(stderrChunks).toString("utf8");
+            if (code !== 0) {
+                const message = `claude exited ${code}${stderr ? `: ${stderr.trim()}` : ""}`;
+                const kind = classifyClaudeError({ message, exitCode: code, stderr });
+                reject(new ClaudeError({ message, kind, exitCode: code, stderr }));
+                return;
+            }
+            let envelope;
+            try {
+                envelope = JSON.parse(stdout);
+            }
+            catch {
+                reject(new ClaudeError({
+                    message: `claude output not JSON: ${stdout.slice(0, 200)}`,
+                    kind: "other",
+                    exitCode: code,
+                    stderr,
+                }));
+                return;
+            }
+            const text = typeof envelope["result"] === "string" ? envelope["result"] : "";
+            let parsed;
+            if (opts.jsonSchema !== undefined) {
+                // The CLI puts schema-validated payload in `structured_output`, not
+                // in `result` (which holds the conversational ack). Prefer that;
+                // fall back to parsing the result text in case future versions
+                // change the placement.
+                if (envelope["structured_output"] !== undefined) {
+                    parsed = envelope["structured_output"];
+                }
+                else if (text.length > 0) {
+                    try {
+                        parsed = JSON.parse(text);
+                    }
+                    catch (err) {
+                        log.warn({ err: String(err), preview: text.slice(0, 200) }, "claude json output parse failed despite --json-schema");
+                    }
+                }
+            }
+            const usageRaw = envelope["usage"];
+            const usage = typeof usageRaw === "object" && usageRaw !== null
+                ? usageRaw
+                : undefined;
+            const durationMs = Date.now() - startedAt;
+            log.info({
+                model,
+                durationMs,
+                input_tokens: usage?.["input_tokens"],
+                output_tokens: usage?.["output_tokens"],
+            }, "claude call complete");
+            resolve({
+                text,
+                ...(parsed !== undefined ? { parsed } : {}),
+                durationMs,
+                tier: opts.tier,
+                model,
+                envelope,
+                ...(usage !== undefined ? { usage } : {}),
+            });
+        });
+        child.stdin.write(opts.prompt);
+        child.stdin.end();
+    });
+}
+//# sourceMappingURL=runner.js.map

package/dist/claude/runner.js.map

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

package/dist/claude/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Subprocess wrapper for the `claude` CLI.
+ *
+ * Per L42 + operator answer T1: every Tier-1/2/3 LLM call goes through the
+ * operator's Claude Code coding-plan subscription via `claude --print
+ * --model <tier> --output-format json`. No direct Anthropic SDK calls.
+ *
+ * Tier mapping is hardcoded (no env vars per operator profile). The CLI's
+ * model alias resolution maps `haiku|sonnet|opus` to the latest model id
+ * for that family — we don't pin specific snapshots here so the wrapper
+ * keeps tracking newer models as Anthropic ships them.
+ */
+export type ClaudeTier = "haiku" | "sonnet" | "opus";
+export interface RunClaudeOptions {
+    tier: ClaudeTier;
+    /** User prompt — sent on stdin so it can be arbitrary length. */
+    prompt: string;
+    /** Optional system prompt override (replaces default Claude Code system). */
+    system?: string;
+    /**
+     * Optional JSON Schema for structured output. When provided, the CLI
+     * enforces the shape and the wrapper parses + returns under `parsed`.
+     */
+    jsonSchema?: object;
+    /** Working directory for the subprocess. Default = process.cwd(). */
+    cwd?: string;
+    /** Hard timeout in ms. Default 120000. */
+    timeoutMs?: number;
+    /**
+     * Extra CLI flags. Useful for `--add-dir`, `--disable-slash-commands`,
+     * etc. when the caller knows what they want.
+     */
+    extraArgs?: string[];
+}
+export interface ClaudeUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+export interface RunClaudeResult {
+    text: string;
+    /** Parsed JSON when `jsonSchema` was set. */
+    parsed?: unknown;
+    durationMs: number;
+    tier: ClaudeTier;
+    model: string;
+    /** Raw JSON envelope from `--output-format json`. */
+    envelope?: Record<string, unknown>;
+    /** Usage stats lifted from the envelope when present. */
+    usage?: ClaudeUsage;
+}

package/dist/claude/types.js

@@ -0,0 +1,14 @@
+/**
+ * Subprocess wrapper for the `claude` CLI.
+ *
+ * Per L42 + operator answer T1: every Tier-1/2/3 LLM call goes through the
+ * operator's Claude Code coding-plan subscription via `claude --print
+ * --model <tier> --output-format json`. No direct Anthropic SDK calls.
+ *
+ * Tier mapping is hardcoded (no env vars per operator profile). The CLI's
+ * model alias resolution maps `haiku|sonnet|opus` to the latest model id
+ * for that family — we don't pin specific snapshots here so the wrapper
+ * keeps tracking newer models as Anthropic ships them.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/claude/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/claude/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/cli/attention.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `cairn attention` — show pending operator review items.
+ *
+ * Reads two sources from the adopted project:
+ *   1. `.cairn/ground/decisions/_inbox/*.draft.md`  — DEC drafts awaiting confirm
+ *   2. `.cairn/baseline/sensor-audit-*.yaml` (latest) — pre-Cairn sensor findings
+ *
+ * Prints a structured summary; exits 0 when there are no pending items, 2 when
+ * any are present (so scripts can branch on attention).
+ */
+export declare function attentionCli(argv: string[]): Promise<void>;