@isaacriehm/cairn-core 0.1.0

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 WORKFLOW_GUIDE §2.2 budget metric (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 WORKFLOW_GUIDE §2.2 budget metric (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/context/checkpoint.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Daemon-driven checkpoint writer — emits a snapshot of the same handoff
+ * block content to `.cairn/tasks/active/<taskId>/checkpoint-<ISO>.md`.
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.2.
+ *
+ * Throws if the task directory is missing — daemons should fail loudly when
+ * pointed at a stale taskId. Successful writes return the absolute path.
+ */
+export declare function writeCheckpoint(repoRoot: string, taskId: string, _runId: string): Promise<string>;

package/dist/context/checkpoint.js

@@ -0,0 +1,29 @@
+/**
+ * Daemon-driven checkpoint writer — emits a snapshot of the same handoff
+ * block content to `.cairn/tasks/active/<taskId>/checkpoint-<ISO>.md`.
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.2.
+ *
+ * Throws if the task directory is missing — daemons should fail loudly when
+ * pointed at a stale taskId. Successful writes return the absolute path.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { buildHandoffBlock } from "./handoff-builder.js";
+export async function writeCheckpoint(repoRoot, taskId, _runId) {
+    const taskDir = join(repoRoot, ".cairn", "tasks", "active", taskId);
+    if (!existsSync(taskDir)) {
+        throw new Error(`writeCheckpoint: task directory not found: ${taskDir}`);
+    }
+    const block = await buildHandoffBlock(repoRoot);
+    const content = block === null ? "(no active run handoff to capture)\n" : block;
+    // Ensure dir exists (defensive — `existsSync` above guarantees parent, but
+    // mkdir recursive is cheap and safe).
+    mkdirSync(taskDir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/:/g, "-");
+    const filename = `checkpoint-${stamp}.md`;
+    const abs = join(taskDir, filename);
+    writeFileSync(abs, content, "utf8");
+    return abs;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/context/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/context/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,MAAc,EACd,MAAc;IAEd,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,8CAA8C,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEhF,2EAA2E;IAC3E,sCAAsC;IACtC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,cAAc,KAAK,KAAK,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/context/handoff-builder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Run-handoff block — builds the Section-0 SessionStart payload from git
+ * history when an active run is in flight (`tasks/active/<id>/status.yaml`
+ * with `phase: running` or `phase: sensor_check`).
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.2.
+ *
+ * Read-only; returns null when no in-flight run is detected, when meta is
+ * unparseable, or when there are no commits since the run's `sha_pin`.
+ */
+export declare function buildHandoffBlock(repoRoot: string): Promise<string | null>;

package/dist/context/handoff-builder.js

@@ -0,0 +1,268 @@
+/**
+ * Run-handoff block — builds the Section-0 SessionStart payload from git
+ * history when an active run is in flight (`tasks/active/<id>/status.yaml`
+ * with `phase: running` or `phase: sensor_check`).
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.2.
+ *
+ * Read-only; returns null when no in-flight run is detected, when meta is
+ * unparseable, or when there are no commits since the run's `sha_pin`.
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { simpleGit } from "simple-git";
+import { parse as parseYaml } from "yaml";
+import { parseFrontmatter } from "../ground/index.js";
+/** Hard cap on rendered handoff size (chars). ~600 tokens. */
+const MAX_CHARS = 2_400;
+/** Cap on commits emitted before truncation kicks in. */
+const COMMIT_CAP = 20;
+export async function buildHandoffBlock(repoRoot) {
+    const activeDir = join(repoRoot, ".cairn", "tasks", "active");
+    if (!existsSync(activeDir))
+        return null;
+    let dirents;
+    try {
+        dirents = readdirSync(activeDir, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return null;
+    }
+    // Find the first task whose status indicates an in-flight run with a runId.
+    let matched = null;
+    for (const e of dirents) {
+        if (!e.isDirectory())
+            continue;
+        const taskDir = join(activeDir, e.name);
+        const statusPath = join(taskDir, "status.yaml");
+        if (!existsSync(statusPath))
+            continue;
+        let parsed;
+        try {
+            parsed = parseYaml(readFileSync(statusPath, "utf8"));
+        }
+        catch {
+            continue;
+        }
+        if (typeof parsed !== "object" || parsed === null)
+            continue;
+        const status = parsed;
+        const phase = typeof status.phase === "string" ? status.phase : "";
+        if (phase !== "running" && phase !== "sensor_check")
+            continue;
+        const runIds = Array.isArray(status.related_run_ids) ? status.related_run_ids : [];
+        const first = runIds[0];
+        if (typeof first !== "string" || first.length === 0)
+            continue;
+        matched = { taskId: e.name, runId: first };
+        break;
+    }
+    if (matched === null)
+        return null;
+    // Read meta.json for the run's sha_pin.
+    const metaPath = join(repoRoot, ".cairn", "runs", "active", matched.runId, "meta.json");
+    if (!existsSync(metaPath))
+        return null;
+    let meta;
+    try {
+        const raw = JSON.parse(readFileSync(metaPath, "utf8"));
+        if (typeof raw !== "object" || raw === null)
+            return null;
+        meta = raw;
+    }
+    catch {
+        return null;
+    }
+    const shaPin = typeof meta.sha_pin === "string" ? meta.sha_pin : null;
+    if (shaPin === null || shaPin.length === 0)
+        return null;
+    // Resolve task title from spec.tightened.md heading.
+    const taskDir = join(activeDir, matched.taskId);
+    const specPath = join(taskDir, "spec.tightened.md");
+    let taskTitle = matched.taskId;
+    let checkpoints = [];
+    if (existsSync(specPath)) {
+        let specText = "";
+        try {
+            specText = readFileSync(specPath, "utf8");
+        }
+        catch {
+            specText = "";
+        }
+        if (specText.length > 0) {
+            const parsed = parseFrontmatter(specText);
+            const titleMatch = parsed.body.match(/^#\s+(.+)$/m);
+            if (titleMatch && titleMatch[1])
+                taskTitle = titleMatch[1].trim();
+            const fm = (parsed.frontmatter ?? {});
+            const rawCheckpoints = fm["checkpoints"];
+            if (Array.isArray(rawCheckpoints)) {
+                for (const c of rawCheckpoints) {
+                    if (typeof c !== "object" || c === null)
+                        continue;
+                    const cc = c;
+                    if (typeof cc["id"] !== "string")
+                        continue;
+                    const entry = { id: cc["id"] };
+                    if (typeof cc["label"] === "string")
+                        entry.label = cc["label"];
+                    checkpoints.push(entry);
+                }
+            }
+        }
+    }
+    // Read git log + diff summary.
+    const git = simpleGit({ baseDir: repoRoot });
+    let logCommits = [];
+    try {
+        const logResult = await git.log({ from: shaPin, to: "HEAD" });
+        for (const c of logResult.all) {
+            const subject = (c.message ?? "").split("\n")[0] ?? "";
+            logCommits.push({ hash: c.hash, subject });
+        }
+    }
+    catch {
+        return null;
+    }
+    if (logCommits.length === 0)
+        return null;
+    let diffFiles = [];
+    try {
+        const summary = await git.diffSummary([shaPin, "HEAD"]);
+        for (const f of summary.files) {
+            if (f.binary) {
+                diffFiles.push({ file: f.file, insertions: 0, deletions: 0 });
+            }
+            else {
+                diffFiles.push({
+                    file: f.file,
+                    insertions: f.insertions,
+                    deletions: f.deletions,
+                });
+            }
+        }
+    }
+    catch {
+        diffFiles = [];
+    }
+    // Read notes.md if present.
+    let notes = "";
+    const notesPath = join(taskDir, "notes.md");
+    if (existsSync(notesPath)) {
+        try {
+            notes = readFileSync(notesPath, "utf8").trim();
+        }
+        catch {
+            notes = "";
+        }
+    }
+    return renderHandoff({
+        taskId: matched.taskId,
+        taskTitle,
+        commits: logCommits,
+        diffFiles,
+        checkpoints,
+        notes,
+    });
+}
+function renderHandoff(parts) {
+    const truncatedCommits = parts.commits.slice(0, COMMIT_CAP);
+    const phasesComplete = [];
+    const phasesRemaining = [];
+    for (const cp of parts.checkpoints) {
+        const isComplete = parts.commits.some((c) => c.subject.includes(cp.id));
+        const label = cp.label !== undefined ? `${cp.id} (${cp.label})` : cp.id;
+        if (isComplete)
+            phasesComplete.push(label);
+        else
+            phasesRemaining.push(label);
+    }
+    const lines = [];
+    lines.push(`## ⟳ Resuming run ${parts.taskId} — ${parts.taskTitle}`);
+    lines.push("");
+    lines.push("Commits since run start:");
+    for (const c of truncatedCommits) {
+        const sha7 = c.hash.slice(0, 7);
+        lines.push(`  ${sha7}  ${c.subject}`);
+    }
+    if (parts.commits.length > truncatedCommits.length) {
+        lines.push(`  …${parts.commits.length - truncatedCommits.length} older commits truncated`);
+    }
+    lines.push("");
+    if (parts.checkpoints.length > 0) {
+        lines.push(`Phases complete: ${phasesComplete.length === 0 ? "(none)" : phasesComplete.join(", ")}`);
+        lines.push(`Phases remaining: ${phasesRemaining.length === 0 ? "(none)" : phasesRemaining.join(", ")}`);
+        lines.push("");
+    }
+    lines.push("Files touched so far:");
+    if (parts.diffFiles.length === 0) {
+        lines.push("  (none reported)");
+    }
+    else {
+        for (const f of parts.diffFiles) {
+            lines.push(`  ${f.file}  [+${f.insertions} -${f.deletions}]`);
+        }
+    }
+    let notesBody = parts.notes;
+    if (notesBody.length > 0) {
+        lines.push("");
+        lines.push("Agent notes from previous phases:");
+        lines.push(notesBody);
+    }
+    let out = lines.join("\n");
+    if (out.length <= MAX_CHARS)
+        return out;
+    // Over budget — first try truncating notes oldest-first (front of body).
+    while (notesBody.length > 0 && out.length > MAX_CHARS) {
+        const newlineIdx = notesBody.indexOf("\n");
+        if (newlineIdx === -1) {
+            notesBody = "";
+        }
+        else {
+            notesBody = notesBody.slice(newlineIdx + 1);
+        }
+        out = renderWithCustomNotes(parts, truncatedCommits, phasesComplete, phasesRemaining, notesBody);
+    }
+    if (out.length <= MAX_CHARS)
+        return out;
+    // Still over — drop notes section entirely.
+    out = renderWithCustomNotes(parts, truncatedCommits, phasesComplete, phasesRemaining, "");
+    if (out.length <= MAX_CHARS)
+        return out;
+    // Hard cap.
+    return out.slice(0, MAX_CHARS);
+}
+function renderWithCustomNotes(parts, truncatedCommits, phasesComplete, phasesRemaining, notesBody) {
+    const lines = [];
+    lines.push(`## ⟳ Resuming run ${parts.taskId} — ${parts.taskTitle}`);
+    lines.push("");
+    lines.push("Commits since run start:");
+    for (const c of truncatedCommits) {
+        lines.push(`  ${c.hash.slice(0, 7)}  ${c.subject}`);
+    }
+    if (parts.commits.length > truncatedCommits.length) {
+        lines.push(`  …${parts.commits.length - truncatedCommits.length} older commits truncated`);
+    }
+    lines.push("");
+    if (parts.checkpoints.length > 0) {
+        lines.push(`Phases complete: ${phasesComplete.length === 0 ? "(none)" : phasesComplete.join(", ")}`);
+        lines.push(`Phases remaining: ${phasesRemaining.length === 0 ? "(none)" : phasesRemaining.join(", ")}`);
+        lines.push("");
+    }
+    lines.push("Files touched so far:");
+    if (parts.diffFiles.length === 0) {
+        lines.push("  (none reported)");
+    }
+    else {
+        for (const f of parts.diffFiles) {
+            lines.push(`  ${f.file}  [+${f.insertions} -${f.deletions}]`);
+        }
+    }
+    if (notesBody.length > 0) {
+        lines.push("");
+        lines.push("Agent notes from previous phases:");
+        lines.push(notesBody);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=handoff-builder.js.map

package/dist/context/handoff-builder.js.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Context module — handoff builder, checkpoint writer, and spec-delta
+ * computation. Consumed by the SessionStart Section-0 injector and the
+ * orchestrator daemon.
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.2 (handoff) + §10 (spec delta).
+ */
+export { buildHandoffBlock } from "./handoff-builder.js";
+export { writeCheckpoint } from "./checkpoint.js";
+export { buildSpecDelta } from "./spec-delta.js";
+export type { SpecDelta } from "./spec-delta.js";

package/dist/context/index.js

@@ -0,0 +1,11 @@
+/**
+ * Context module — handoff builder, checkpoint writer, and spec-delta
+ * computation. Consumed by the SessionStart Section-0 injector and the
+ * orchestrator daemon.
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.2 (handoff) + §10 (spec delta).
+ */
+export { buildHandoffBlock } from "./handoff-builder.js";
+export { writeCheckpoint } from "./checkpoint.js";
+export { buildSpecDelta } from "./spec-delta.js";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/context/spec-delta.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Spec-delta computation — answers "what changed in ground state since the
+ * affected code was last touched?" for a task scope.
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §10.
+ *
+ * Mechanical: resolve scope → find oldest last-touch SHA across paths →
+ * diff `decisions.ledger.yaml` and `invariants.ledger.yaml` between that
+ * cutoff and HEAD → stat brand/product files for newer mtimes. No LLM.
+ *
+ * Returns null when the input scope is empty, when no path has any commits,
+ * or when the resulting delta is empty (nothing to inject).
+ */
+export interface SpecDelta {
+    cutoffSha: string;
+    cutoffAgeDays: number;
+    scopeSummary: string;
+    decisions: {
+        added: {
+            id: string;
+            title: string;
+            scopeGlobs: string[];
+        }[];
+        superseded: {
+            id: string;
+            supersededBy: string;
+            title: string;
+        }[];
+    };
+    invariants: {
+        added: {
+            id: string;
+            title: string;
+            sourceDecision: string | null;
+        }[];
+        superseded: {
+            id: string;
+            supersededBy: string;
+            title: string;
+        }[];
+    };
+    brand: {
+        path: string;
+        mtimeIso: string;
+    }[];
+}
+export declare function buildSpecDelta(repoRoot: string, taskScopePaths: string[]): Promise<SpecDelta | null>;