@isaacriehm/cairn-core 0.1.0

package/dist/mcp/tools/record-decision.js.map

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

package/dist/mcp/tools/record-run-event.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    run_id: string;
+    event: {
+        kind: string;
+        payload?: unknown;
+    };
+}
+export declare const recordRunEventTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/record-run-event.js

@@ -0,0 +1,32 @@
+import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { recordRunEventInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    const runDir = join(ctx.repoRoot, ".cairn", "runs", "active", input.run_id);
+    if (!existsSync(runDir)) {
+        return mcpError("RUN_NOT_FOUND", `No active run dir at ${runDir}`);
+    }
+    const path = join(runDir, "events.jsonl");
+    // Server-fills ts. Seq is omitted in this naive implementation; the orchestrator
+    // re-numbers in the post-run pass when it materializes the canonical event log.
+    const row = {
+        ts: new Date().toISOString(),
+        kind: input.event.kind,
+        ...(input.event.payload !== undefined ? { payload: input.event.payload } : {}),
+    };
+    mkdirSync(runDir, { recursive: true });
+    appendFileSync(path, `${JSON.stringify(row)}\n`, "utf8");
+    return { ok: true, run_id: input.run_id, kind: input.event.kind };
+}
+export const recordRunEventTool = {
+    name: "cairn_record_run_event",
+    description: "Append a structured event to .cairn/runs/active/<run_id>/events.jsonl. Server fills `ts`; sequence is renumbered in post-run materialization.",
+    inputSchema: recordRunEventInput,
+    handler,
+};
+//# sourceMappingURL=record-run-event.js.map

package/dist/mcp/tools/record-run-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-run-event.js","sourceRoot":"","sources":["../../../src/mcp/tools/record-run-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAQpD,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5E,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,eAAe,EAAE,wBAAwB,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,iFAAiF;IACjF,gFAAgF;IAChF,MAAM,GAAG,GAAG;QACV,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACtB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;IACF,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,+IAA+I;IACjJ,WAAW,EAAE,mBAAmB;IAChC,OAAO;CACR,CAAC"}

package/dist/mcp/tools/resolve-attention.d.ts

@@ -0,0 +1,31 @@
+/**
+ * cairn_resolve_attention — inline A/B/C resolution endpoint.
+ *
+ * Spec: PLUGIN_ARCHITECTURE §9 (MCP write tools — plugin-era addition).
+ *
+ * The cairn-attention skill calls this after the operator picks an
+ * option. It maps `kind × choice` onto the canonical resolution
+ * pathway:
+ *
+ * | kind                | choice | resolution                                  |
+ * |---------------------|--------|---------------------------------------------|
+ * | decision_draft      | a      | accept — move `_inbox/<id>.draft.md` → `<id>.md`, status=accepted |
+ * | decision_draft      | b      | reject — archive draft                      |
+ * | decision_draft      | c      | edit-pending — return draft body (no write) |
+ * | baseline_finding    | a      | triage-now — no-op (skill opens the file)   |
+ * | baseline_finding    | b      | suppress — append to baseline/suppressions.yaml |
+ * | baseline_finding    | c      | defer — no-op                               |
+ * | invalidation_event  | a      | refresh — re-read in-scope DECs/§Vs          |
+ * | invalidation_event  | b      | continue-under-old — no-op                  |
+ * | invalidation_event  | c      | abort — caller archives task (no-op here)   |
+ * | drift               | a/b/c  | reserved (drift surface lands later)        |
+ */
+import type { ToolDef } from "./types.js";
+interface Input {
+    item_id: string;
+    choice: "a" | "b" | "c";
+    kind: "decision_draft" | "baseline_finding" | "invalidation_event" | "drift";
+    rationale?: string;
+}
+export declare const resolveAttentionTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/resolve-attention.js

@@ -0,0 +1,191 @@
+/**
+ * cairn_resolve_attention — inline A/B/C resolution endpoint.
+ *
+ * Spec: PLUGIN_ARCHITECTURE §9 (MCP write tools — plugin-era addition).
+ *
+ * The cairn-attention skill calls this after the operator picks an
+ * option. It maps `kind × choice` onto the canonical resolution
+ * pathway:
+ *
+ * | kind                | choice | resolution                                  |
+ * |---------------------|--------|---------------------------------------------|
+ * | decision_draft      | a      | accept — move `_inbox/<id>.draft.md` → `<id>.md`, status=accepted |
+ * | decision_draft      | b      | reject — archive draft                      |
+ * | decision_draft      | c      | edit-pending — return draft body (no write) |
+ * | baseline_finding    | a      | triage-now — no-op (skill opens the file)   |
+ * | baseline_finding    | b      | suppress — append to baseline/suppressions.yaml |
+ * | baseline_finding    | c      | defer — no-op                               |
+ * | invalidation_event  | a      | refresh — re-read in-scope DECs/§Vs          |
+ * | invalidation_event  | b      | continue-under-old — no-op                  |
+ * | invalidation_event  | c      | abort — caller archives task (no-op here)   |
+ * | drift               | a/b/c  | reserved (drift surface lands later)        |
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { writeInvalidationEvent } from "../../events/index.js";
+import { decisionsDir } from "../../ground/index.js";
+import { withWriteLock } from "../../lock.js";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { resolveAttentionInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    switch (input.kind) {
+        case "decision_draft":
+            return resolveDecisionDraft(ctx, input);
+        case "baseline_finding":
+            return resolveBaselineFinding(ctx, input);
+        case "invalidation_event":
+            return resolveInvalidationEvent(ctx, input);
+        case "drift":
+            return {
+                ok: true,
+                resolved_kind: "drift_acknowledged",
+                note: "drift resolution surface not yet implemented (step 7+); item left in queue",
+            };
+    }
+}
+function resolveDecisionDraft(ctx, input) {
+    if (!/^DEC-\d{4,}$/.test(input.item_id)) {
+        return Promise.resolve(mcpError("VALIDATION_FAILED", `decision_draft item_id must match DEC-NNNN, got ${input.item_id}`));
+    }
+    const decDir = decisionsDir(ctx.repoRoot);
+    const inboxPath = join(decDir, "_inbox", `${input.item_id}.draft.md`);
+    if (!existsSync(inboxPath)) {
+        return Promise.resolve(mcpError("FILE_NOT_FOUND", `no draft at ${inboxPath}`));
+    }
+    if (input.choice === "c") {
+        // Edit-pending: return the draft body so the skill can hand it to
+        // the operator's editor flow. No state change.
+        const body = readFileSync(inboxPath, "utf8");
+        return Promise.resolve({
+            ok: true,
+            resolved_kind: "decision_edit_pending",
+            item_id: input.item_id,
+            draft_path: `.cairn/ground/decisions/_inbox/${input.item_id}.draft.md`,
+            body,
+        });
+    }
+    return withWriteLock(ctx.repoRoot, () => {
+        if (input.choice === "a") {
+            const acceptedPath = join(decDir, `${input.item_id}.md`);
+            mkdirSync(dirname(acceptedPath), { recursive: true });
+            const draft = readFileSync(inboxPath, "utf8");
+            const promoted = promoteDraftStatus(draft);
+            writeFileSync(acceptedPath, promoted, "utf8");
+            // Remove the draft after promoting so the inbox stays clean.
+            renameSync(inboxPath, `${inboxPath}.accepted`);
+            // Best-effort: delete the .accepted suffix file. We keep the
+            // rename + cleanup as two steps so an interrupt mid-rename leaves
+            // a recoverable trail rather than a vanished draft.
+            try {
+                renameSync(`${inboxPath}.accepted`, `${inboxPath}.accepted.bak`);
+            }
+            catch {
+                // ignore — file already gone
+            }
+            try {
+                emitEvent(ctx, "decision_accepted", input.item_id, `.cairn/ground/decisions/${input.item_id}.md`);
+            }
+            catch {
+                // event emission must never roll back the resolution
+            }
+            return {
+                ok: true,
+                resolved_kind: "decision_accepted",
+                item_id: input.item_id,
+                accepted_path: `.cairn/ground/decisions/${input.item_id}.md`,
+            };
+        }
+        // choice === "b" — reject + archive.
+        const today = new Date().toISOString().slice(0, 10);
+        const archivedRel = join(".archive", today, ".cairn/ground/decisions/_inbox", `${input.item_id}.draft.md`);
+        const archivedAbs = join(ctx.repoRoot, archivedRel);
+        mkdirSync(dirname(archivedAbs), { recursive: true });
+        renameSync(inboxPath, archivedAbs);
+        try {
+            emitEvent(ctx, "decision_rejected", input.item_id, archivedRel);
+        }
+        catch {
+            // ignore
+        }
+        return {
+            ok: true,
+            resolved_kind: "decision_rejected",
+            item_id: input.item_id,
+            archived_to: archivedRel,
+            ...(input.rationale !== undefined ? { rationale: input.rationale } : {}),
+        };
+    });
+}
+function resolveBaselineFinding(ctx, input) {
+    if (input.choice === "a") {
+        return Promise.resolve({
+            ok: true,
+            resolved_kind: "baseline_triage",
+            item_id: input.item_id,
+            note: "operator selected triage-now — caller opens the flagged file",
+        });
+    }
+    if (input.choice === "c") {
+        return Promise.resolve({
+            ok: true,
+            resolved_kind: "baseline_deferred",
+            item_id: input.item_id,
+        });
+    }
+    // choice === "b" — append to suppressions.
+    return withWriteLock(ctx.repoRoot, () => {
+        const suppressionsPath = join(ctx.repoRoot, ".cairn", "baseline", "suppressions.yaml");
+        mkdirSync(dirname(suppressionsPath), { recursive: true });
+        const initial = existsSync(suppressionsPath) ? "" : "suppressions:\n";
+        const entry = `  - id: ${JSON.stringify(input.item_id)}\n` +
+            `    suppressed_at: ${JSON.stringify(new Date().toISOString())}\n` +
+            (input.rationale !== undefined
+                ? `    rationale: ${JSON.stringify(input.rationale)}\n`
+                : "");
+        appendFileSync(suppressionsPath, `${initial}${entry}`, "utf8");
+        return {
+            ok: true,
+            resolved_kind: "baseline_suppressed",
+            item_id: input.item_id,
+            suppressions_path: ".cairn/baseline/suppressions.yaml",
+        };
+    });
+}
+function resolveInvalidationEvent(_ctx, input) {
+    // Per spec §7: A=refresh, B=continue-under-old, C=abort. The marker
+    // stamping + scope refresh happens in the calling skill, since it
+    // owns the session id. This tool just acknowledges the resolution
+    // so the skill can record it.
+    const map = { a: "refresh", b: "continue_under_old", c: "abort" };
+    return Promise.resolve({
+        ok: true,
+        resolved_kind: `invalidation_${map[input.choice]}`,
+        item_id: input.item_id,
+        ...(input.rationale !== undefined ? { rationale: input.rationale } : {}),
+    });
+}
+function promoteDraftStatus(body) {
+    // Frontmatter `status: draft` → `status: accepted`. Best-effort regex
+    // — if the frontmatter shape is unusual the file is still acceptable
+    // (status field is advisory).
+    return body.replace(/^status:\s*draft\b/m, "status: accepted");
+}
+function emitEvent(ctx, kind, decId, path) {
+    writeInvalidationEvent(ctx.repoRoot, {
+        kind,
+        refs: [{ kind: "decision", id: decId }],
+        path,
+        source: { session_id: ctx.sessionId ?? null, tool: "cairn_resolve_attention" },
+    });
+}
+export const resolveAttentionTool = {
+    name: "cairn_resolve_attention",
+    description: "Resolve an inline-A/B/C attention pick — DEC draft accept/reject/edit, baseline finding suppress/defer/triage, invalidation event refresh/continue/abort. Called by the cairn-attention skill after the operator picks an option.",
+    inputSchema: resolveAttentionInput,
+    handler,
+};
+//# sourceMappingURL=resolve-attention.js.map

package/dist/mcp/tools/resolve-attention.js.map

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

package/dist/mcp/tools/search.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    query: string;
+    scope?: string[];
+    kinds?: ("decision" | "invariant" | "task" | "run" | "doc" | "manifest")[];
+    limit?: number;
+}
+export declare const searchTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/search.js

@@ -0,0 +1,164 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import { decisionsDir, invariantsDir, manifestPath, matchAnyGlob, parseFrontmatter, } from "../../ground/index.js";
+import { searchInput } from "../schemas.js";
+/**
+ * Naive substring index over decisions, invariants, tasks/active, and the
+ * canonical-zone manifest entries. Phase 4 baseline; can be uplifted to FTS
+ * (e.g., MiniSearch / Lunr) without changing the tool surface.
+ *
+ * Score: 0.5 base + 0.25 if title hit + 0.25 if body hit. Caps at 1.0.
+ */
+async function handler(ctx, input) {
+    const limit = Math.min(input.limit ?? 20, 50);
+    const wantKinds = new Set(input.kinds ?? ["decision", "invariant", "task", "doc"]);
+    const q = input.query.toLowerCase();
+    const out = [];
+    if (wantKinds.has("decision")) {
+        const dir = decisionsDir(ctx.repoRoot);
+        if (existsSync(dir)) {
+            for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+                if (!e.isFile() || !e.name.endsWith(".md"))
+                    continue;
+                const path = join(dir, e.name);
+                const raw = readFileSync(path, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const fm = parsed.frontmatter;
+                if (!fm?.id || !fm.title)
+                    continue;
+                const titleHit = fm.title.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: fm.id,
+                    kind: "decision",
+                    title: fm.title,
+                    path: relative(ctx.repoRoot, path).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+        }
+    }
+    if (wantKinds.has("invariant")) {
+        const dir = invariantsDir(ctx.repoRoot);
+        if (existsSync(dir)) {
+            for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+                if (!e.isFile() || !e.name.endsWith(".md"))
+                    continue;
+                const path = join(dir, e.name);
+                const raw = readFileSync(path, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const fm = parsed.frontmatter;
+                if (!fm?.id || !fm.title)
+                    continue;
+                const titleHit = fm.title.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: fm.id,
+                    kind: "invariant",
+                    title: fm.title,
+                    path: relative(ctx.repoRoot, path).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+        }
+    }
+    if (wantKinds.has("task")) {
+        const tasksDir = join(ctx.repoRoot, ".cairn", "tasks", "active");
+        if (existsSync(tasksDir)) {
+            for (const e of readdirSync(tasksDir, { withFileTypes: true, encoding: "utf8" })) {
+                if (!e.isDirectory())
+                    continue;
+                const spec = join(tasksDir, e.name, "spec.tightened.md");
+                const fallback = join(tasksDir, e.name, "spec.md");
+                const target = existsSync(spec) ? spec : existsSync(fallback) ? fallback : null;
+                if (!target)
+                    continue;
+                const raw = readFileSync(target, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const fm = parsed.frontmatter;
+                if (!fm?.id)
+                    continue;
+                const titleLine = parsed.body.match(/^#\s+(.+)$/m)?.[1] ?? fm.id;
+                const titleHit = titleLine.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: fm.id,
+                    kind: "task",
+                    title: titleLine,
+                    path: relative(ctx.repoRoot, target).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+        }
+    }
+    if (wantKinds.has("doc")) {
+        const docsRoot = join(ctx.repoRoot, "docs");
+        if (existsSync(docsRoot))
+            walkDocs(docsRoot, ctx.repoRoot, q, out);
+    }
+    if (wantKinds.has("manifest")) {
+        const path = manifestPath(ctx.repoRoot);
+        if (existsSync(path)) {
+            const text = readFileSync(path, "utf8");
+            if (text.toLowerCase().includes(q)) {
+                out.push({
+                    id: "manifest",
+                    kind: "manifest",
+                    title: "ground/manifest.yaml",
+                    path: relative(ctx.repoRoot, path).replace(/\\/g, "/"),
+                    score: 0.5,
+                });
+            }
+        }
+    }
+    let filtered = out;
+    if (input.scope && input.scope.length > 0) {
+        filtered = out.filter((r) => r.path !== undefined ? matchAnyGlob(r.path, input.scope ?? []) : false);
+    }
+    filtered.sort((a, b) => b.score - a.score);
+    return filtered.slice(0, limit);
+}
+function walkDocs(dir, repoRoot, q, out) {
+    for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+        const abs = join(dir, e.name);
+        if (e.isDirectory()) {
+            if (e.name === "_research")
+                continue;
+            walkDocs(abs, repoRoot, q, out);
+        }
+        else if (e.isFile() && e.name.endsWith(".md")) {
+            try {
+                const raw = readFileSync(abs, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const titleLine = parsed.body.match(/^#\s+(.+)$/m)?.[1] ?? e.name;
+                const titleHit = titleLine.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: relative(repoRoot, abs).replace(/\\/g, "/"),
+                    kind: "doc",
+                    title: titleLine,
+                    path: relative(repoRoot, abs).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+            catch {
+                // unreadable; skip
+            }
+        }
+    }
+}
+export const searchTool = {
+    name: "cairn_search",
+    description: "Naive substring search over decisions, invariants, tasks, docs, and manifest. Returns compact records (~50 tokens each) sorted by score. Phase 4 baseline; FTS uplift later.",
+    inputSchema: searchInput,
+    handler,
+};
+//# sourceMappingURL=search.js.map

package/dist/mcp/tools/search.js.map

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

package/dist/mcp/tools/supersedes-chain.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    decision_id: string;
+}
+export declare const supersedesChainTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/supersedes-chain.js

@@ -0,0 +1,66 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { decisionsDir, parseFrontmatter } from "../../ground/index.js";
+import { DecisionFrontmatter } from "../../ground/index.js";
+import { mcpError } from "../errors.js";
+import { supersedesChainInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const dir = decisionsDir(ctx.repoRoot);
+    if (!existsSync(dir))
+        return mcpError("DECISION_NOT_FOUND", `No decisions directory`);
+    const all = new Map();
+    for (const entry of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const parsed = parseFrontmatter(readFileSync(join(dir, entry.name), "utf8"));
+        const fm = DecisionFrontmatter.safeParse(parsed.frontmatter);
+        if (!fm.success)
+            continue;
+        all.set(fm.data.id, {
+            id: fm.data.id,
+            status: fm.data.status,
+            supersedes: fm.data.supersedes ?? null,
+        });
+    }
+    if (!all.has(input.decision_id)) {
+        return mcpError("DECISION_NOT_FOUND", `Unknown decision id ${input.decision_id}`);
+    }
+    // Walk back to root, then forward via reverse-supersedes index.
+    const reverse = new Map(); // supersedes-id → newer-id
+    for (const e of all.values()) {
+        if (e.supersedes)
+            reverse.set(e.supersedes, e.id);
+    }
+    // Find root (oldest) by walking supersedes chain backward.
+    let root = input.decision_id;
+    const seen = new Set();
+    while (true) {
+        if (seen.has(root))
+            break;
+        seen.add(root);
+        const cur = all.get(root);
+        if (!cur || cur.supersedes === null)
+            break;
+        root = cur.supersedes;
+    }
+    // Forward chain.
+    const chain = [];
+    const fwdSeen = new Set();
+    let cursor = root;
+    while (cursor && !fwdSeen.has(cursor)) {
+        fwdSeen.add(cursor);
+        const e = all.get(cursor);
+        if (!e)
+            break;
+        chain.push(e);
+        cursor = reverse.get(cursor);
+    }
+    return chain;
+}
+export const supersedesChainTool = {
+    name: "cairn_supersedes_chain",
+    description: "Forward chain from earliest superseded decision to current binding decision (status=accepted at the head).",
+    inputSchema: supersedesChainInput,
+    handler,
+};
+//# sourceMappingURL=supersedes-chain.js.map

package/dist/mcp/tools/supersedes-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersedes-chain.js","sourceRoot":"","sources":["../../../src/mcp/tools/supersedes-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAarD,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC;IACtF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChF,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7D,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7E,MAAM,EAAE,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7D,IAAI,CAAC,EAAE,CAAC,OAAO;YAAE,SAAS;QAC1B,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE;YAClB,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;YACd,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM;YACtB,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI;SACvC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC,oBAAoB,EAAE,uBAAuB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,gEAAgE;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,2BAA2B;IACtE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,2DAA2D;IAC3D,IAAI,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM;QAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM;QAC3C,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC;IACxB,CAAC;IACD,iBAAiB;IACjB,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,MAAM,GAAuB,IAAI,CAAC;IACtC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC;YAAE,MAAM;QACd,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,4GAA4G;IAC9G,WAAW,EAAE,oBAAoB;IACjC,OAAO;CACR,CAAC"}

package/dist/mcp/tools/timeline.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    scope?: string[];
+    since?: string;
+    until?: string;
+    kinds?: string[];
+}
+export declare const timelineTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/timeline.js

@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { runsTerminalDir } from "../../ground/index.js";
+import { timelineInput } from "../schemas.js";
+/**
+ * Returns chronologically ordered run/event records intersecting the scope
+ * window. Naive — reads runs/terminal/<id>/meta.json files. Phase 4 baseline;
+ * heavier indexing later.
+ */
+async function handler(ctx, input) {
+    const out = [];
+    const since = input.since ? Date.parse(input.since) : 0;
+    const until = input.until ? Date.parse(input.until) : Number.POSITIVE_INFINITY;
+    const wantKinds = input.kinds ? new Set(input.kinds) : null;
+    const dir = runsTerminalDir(ctx.repoRoot);
+    if (existsSync(dir)) {
+        for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+            if (!e.isDirectory())
+                continue;
+            const meta = readJson(join(dir, e.name, "meta.json"));
+            if (!meta)
+                continue;
+            const ts = meta.finished_at ?? meta.started_at;
+            if (!ts)
+                continue;
+            const tsMs = Date.parse(ts);
+            if (Number.isNaN(tsMs) || tsMs < since || tsMs > until)
+                continue;
+            if (wantKinds && !wantKinds.has("run"))
+                continue;
+            // scope filter — naive: the run's scoped_module substring match.
+            if (input.scope && input.scope.length > 0 && meta.scoped_module) {
+                const hit = input.scope.some((g) => meta.scoped_module?.includes(g) ?? false);
+                if (!hit)
+                    continue;
+            }
+            out.push({
+                ts,
+                kind: "run",
+                run_id: meta.run_id,
+                ...(meta.task_id !== undefined ? { task_id: meta.task_id } : {}),
+                ...(meta.phase !== undefined ? { detail: meta.phase } : {}),
+            });
+        }
+    }
+    out.sort((a, b) => b.ts.localeCompare(a.ts));
+    return out;
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export const timelineTool = {
+    name: "cairn_timeline",
+    description: "Chronological run-event stream intersecting the scope window. Reads runs/terminal/. Useful for `what happened to <module> this week` without reading file bodies.",
+    inputSchema: timelineInput,
+    handler,
+};
+//# sourceMappingURL=timeline.js.map