@isaacriehm/cairn-core 0.1.0

package/dist/mcp/history/schema.js

@@ -0,0 +1,41 @@
+/**
+ * JSON Schema enforced by `claude --json-schema` for the history
+ * summarizer Tier-1 call.
+ *
+ * Per MCP_SURFACE.md §"cairn_query_history": every claim MUST carry
+ * source_path, source_lines, as_of, and a supersedes-tag (string DEC-id
+ * or null). The cairn post-resolves currently_canonical_pointer from
+ * the decisions ledger after the LLM returns — keeps the LLM's
+ * responsibilities tight (cite + summarize) and makes the canonical
+ * cross-reference mechanical.
+ */
+export const HISTORY_SUMMARIZER_OUTPUT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        claims: {
+            type: "array",
+            items: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    claim: { type: "string", minLength: 1 },
+                    as_of: { type: "string", minLength: 1 },
+                    source_path: { type: "string", minLength: 1 },
+                    source_lines: { type: "string", minLength: 1 },
+                    superseded_by: {
+                        anyOf: [
+                            { type: "string", pattern: "^DEC-\\d{4,}$" },
+                            { type: "null" },
+                        ],
+                    },
+                },
+                required: ["claim", "as_of", "source_path", "source_lines"],
+            },
+        },
+        summary_caveat: { type: "string" },
+        no_relevant_history: { type: "boolean" },
+    },
+    required: ["claims"],
+};
+//# sourceMappingURL=schema.js.map

package/dist/mcp/history/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/mcp/history/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBACvC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBACvC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBAC7C,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBAC9C,aAAa,EAAE;wBACb,KAAK,EAAE;4BACL,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE;4BAC5C,EAAE,IAAI,EAAE,MAAM,EAAE;yBACjB;qBACF;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,CAAC;aAC5D;SACF;QACD,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,mBAAmB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KACzC;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACZ,CAAC"}

package/dist/mcp/history/summarizer.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Composes walker + Tier-1 summarizer + post-resolution of
+ * currently_canonical_pointer for cairn_query_history.
+ *
+ * Flow:
+ *   1. walkArchive(repoRoot, pathHint, since, until) → ArchiveFile[]
+ *   2. Load currently-accepted decisions ledger.
+ *   3. Build summarizer prompt with files + ledger.
+ *   4. runClaude(tier=haiku, jsonSchema=HISTORY_SUMMARIZER_OUTPUT_SCHEMA).
+ *   5. Validate output structurally.
+ *   6. Post-resolve currently_canonical_pointer per claim by looking up
+ *      `superseded_by` against the on-disk decisions/ dir.
+ *   7. Attach summarizer_model + summarizer_prompt_id metadata.
+ *
+ * Returns the structured QueryHistoryResponse the MCP tool emits.
+ */
+import type { ClaudeTier } from "../../claude/index.js";
+import { type ArchiveFile } from "./walker.js";
+export interface SummarizedClaim {
+    claim: string;
+    as_of: string;
+    source_path: string;
+    source_lines: string;
+    superseded_by: string | null;
+    currently_canonical_pointer: string | null;
+    warning: string;
+}
+export interface QueryHistoryResponse {
+    historical_only: true;
+    claims: SummarizedClaim[];
+    summary_caveat: string;
+    summarizer_model: string;
+    summarizer_prompt_id: string;
+    /** Structural metadata about the walk — useful for telemetry + tests. */
+    walked_files: number;
+    walked_buckets: string[];
+    truncated_walk: boolean;
+}
+export interface RunQueryHistoryArgs {
+    repoRoot: string;
+    scope: string;
+    pathHint?: string;
+    since?: string;
+    until?: string;
+    /** Tier override; default haiku per workflow.md. */
+    tier?: ClaudeTier;
+    /** Per-call timeout. Default 120000 ms. */
+    timeoutMs?: number;
+    /** Smoke override — return canned summarizer output without burning quota. */
+    summarizerOverride?: typeof runHistorySummarizer;
+}
+interface RunSummarizerInput {
+    scope: string;
+    pathHint?: string;
+    since?: string;
+    until?: string;
+    files: ArchiveFile[];
+    acceptedDecisions: {
+        id: string;
+        title: string;
+        scope_globs?: string[];
+    }[];
+    tier: ClaudeTier;
+    timeoutMs: number;
+}
+interface RunSummarizerResult {
+    claims: {
+        claim: string;
+        as_of: string;
+        source_path: string;
+        source_lines: string;
+        superseded_by: string | null;
+    }[];
+    summary_caveat: string;
+    no_relevant_history: boolean;
+    model: string;
+}
+export declare function runQueryHistory(args: RunQueryHistoryArgs): Promise<QueryHistoryResponse>;
+/** Default summarizer implementation — runs the real LLM. */
+export declare function runHistorySummarizer(input: RunSummarizerInput): Promise<RunSummarizerResult>;
+export {};

package/dist/mcp/history/summarizer.js

@@ -0,0 +1,196 @@
+/**
+ * Composes walker + Tier-1 summarizer + post-resolution of
+ * currently_canonical_pointer for cairn_query_history.
+ *
+ * Flow:
+ *   1. walkArchive(repoRoot, pathHint, since, until) → ArchiveFile[]
+ *   2. Load currently-accepted decisions ledger.
+ *   3. Build summarizer prompt with files + ledger.
+ *   4. runClaude(tier=haiku, jsonSchema=HISTORY_SUMMARIZER_OUTPUT_SCHEMA).
+ *   5. Validate output structurally.
+ *   6. Post-resolve currently_canonical_pointer per claim by looking up
+ *      `superseded_by` against the on-disk decisions/ dir.
+ *   7. Attach summarizer_model + summarizer_prompt_id metadata.
+ *
+ * Returns the structured QueryHistoryResponse the MCP tool emits.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { runClaude } from "../../claude/index.js";
+import { logger } from "../../logger.js";
+import { decisionsDir } from "../../ground/index.js";
+import { loadAcceptedDecisions } from "../../sensors/decisions.js";
+import { buildHistorySummarizerUserPrompt, CAIRN_HISTORY_SUMMARIZE_PROMPT_ID, HISTORY_SUMMARIZER_SYSTEM_PROMPT, } from "./prompt.js";
+import { HISTORY_SUMMARIZER_OUTPUT_SCHEMA } from "./schema.js";
+import { walkArchive } from "./walker.js";
+const log = logger("mcp.history.summarizer");
+const HISTORICAL_WARNING = "This claim is HISTORICAL. Verify against the canonical pointer before acting.";
+export async function runQueryHistory(args) {
+    const tier = args.tier ?? "haiku";
+    const timeoutMs = args.timeoutMs ?? 120_000;
+    const summarize = args.summarizerOverride ?? runHistorySummarizer;
+    const walkOpts = { repoRoot: args.repoRoot };
+    if (args.pathHint !== undefined)
+        walkOpts.pathHint = args.pathHint;
+    if (args.since !== undefined)
+        walkOpts.since = args.since;
+    if (args.until !== undefined)
+        walkOpts.until = args.until;
+    const walk = walkArchive(walkOpts);
+    if (walk.files.length === 0) {
+        return {
+            historical_only: true,
+            claims: [],
+            summary_caveat: walk.bucketsScanned.length === 0
+                ? "No .archive/ directory found at this repo root."
+                : `No files matched the walk filters (path_hint, since, until) across ${walk.bucketsScanned.length} archive bucket${walk.bucketsScanned.length === 1 ? "" : "s"}.`,
+            summarizer_model: "(skipped — no matches)",
+            summarizer_prompt_id: CAIRN_HISTORY_SUMMARIZE_PROMPT_ID,
+            walked_files: 0,
+            walked_buckets: walk.bucketsScanned,
+            truncated_walk: walk.capHit,
+        };
+    }
+    const decisions = loadAcceptedDecisions(args.repoRoot).map((d) => {
+        const entry = {
+            id: d.id,
+            title: d.title,
+        };
+        if (d.scope_globs !== undefined)
+            entry.scope_globs = d.scope_globs;
+        return entry;
+    });
+    log.info({
+        repo: args.repoRoot,
+        scope_preview: args.scope.slice(0, 80),
+        files: walk.files.length,
+        buckets: walk.bucketsScanned.length,
+        total_bytes: walk.totalBytes,
+        tier,
+    }, "history summarizer dispatch");
+    const summarizerInput = {
+        scope: args.scope,
+        files: walk.files,
+        acceptedDecisions: decisions,
+        tier,
+        timeoutMs,
+    };
+    if (args.pathHint !== undefined)
+        summarizerInput.pathHint = args.pathHint;
+    if (args.since !== undefined)
+        summarizerInput.since = args.since;
+    if (args.until !== undefined)
+        summarizerInput.until = args.until;
+    const summary = await summarize(summarizerInput);
+    const acceptedById = new Map();
+    for (const d of decisions)
+        acceptedById.set(d.id, true);
+    const claims = summary.claims.map((c) => {
+        const supersededBy = resolveSupersededBy(c.superseded_by, acceptedById);
+        const pointer = supersededBy
+            ? canonicalPointerFor(args.repoRoot, supersededBy)
+            : null;
+        return {
+            claim: c.claim,
+            as_of: c.as_of,
+            source_path: c.source_path,
+            source_lines: c.source_lines,
+            superseded_by: supersededBy,
+            currently_canonical_pointer: pointer,
+            warning: HISTORICAL_WARNING,
+        };
+    });
+    const caveatBits = [];
+    if (summary.summary_caveat.trim().length > 0)
+        caveatBits.push(summary.summary_caveat.trim());
+    if (walk.capHit) {
+        caveatBits.push(`Walk truncated — additional matching files were not summarized; refine path_hint / since / until and re-query.`);
+    }
+    if (summary.no_relevant_history && claims.length === 0) {
+        caveatBits.push("Summarizer found no claims relevant to the scope question.");
+    }
+    caveatBits.push("All claims are dated and superseded-tagged. Do not treat any line as current truth. Cross-reference the canonical pointer (or call cairn_decision_get / cairn_canonical_for_topic) before acting.");
+    return {
+        historical_only: true,
+        claims,
+        summary_caveat: caveatBits.join(" "),
+        summarizer_model: summary.model,
+        summarizer_prompt_id: CAIRN_HISTORY_SUMMARIZE_PROMPT_ID,
+        walked_files: walk.files.length,
+        walked_buckets: walk.bucketsScanned,
+        truncated_walk: walk.capHit,
+    };
+}
+/** Default summarizer implementation — runs the real LLM. */
+export async function runHistorySummarizer(input) {
+    const userPrompt = buildHistorySummarizerUserPrompt({
+        scope: input.scope,
+        files: input.files,
+        acceptedDecisions: input.acceptedDecisions,
+        ...(input.pathHint !== undefined ? { pathHint: input.pathHint } : {}),
+        ...(input.since !== undefined ? { since: input.since } : {}),
+        ...(input.until !== undefined ? { until: input.until } : {}),
+    });
+    const result = await runClaude({
+        tier: input.tier,
+        prompt: userPrompt,
+        system: HISTORY_SUMMARIZER_SYSTEM_PROMPT,
+        jsonSchema: HISTORY_SUMMARIZER_OUTPUT_SCHEMA,
+        timeoutMs: input.timeoutMs,
+    });
+    if (!isSummarizerOutput(result.parsed)) {
+        throw new Error(`history summarizer returned malformed output. preview: ${result.text.slice(0, 200)}`);
+    }
+    return {
+        claims: result.parsed.claims.map((c) => ({
+            claim: c.claim,
+            as_of: c.as_of,
+            source_path: c.source_path,
+            source_lines: c.source_lines,
+            superseded_by: c.superseded_by ?? null,
+        })),
+        summary_caveat: result.parsed.summary_caveat ?? "",
+        no_relevant_history: result.parsed.no_relevant_history === true,
+        model: result.model,
+    };
+}
+function isSummarizerOutput(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    if (!Array.isArray(o["claims"]))
+        return false;
+    for (const c of o["claims"]) {
+        if (typeof c !== "object" || c === null)
+            return false;
+        const cc = c;
+        if (typeof cc["claim"] !== "string")
+            return false;
+        if (typeof cc["as_of"] !== "string")
+            return false;
+        if (typeof cc["source_path"] !== "string")
+            return false;
+        if (typeof cc["source_lines"] !== "string")
+            return false;
+        if (cc["superseded_by"] !== undefined &&
+            cc["superseded_by"] !== null &&
+            typeof cc["superseded_by"] !== "string") {
+            return false;
+        }
+    }
+    return true;
+}
+function resolveSupersededBy(proposed, acceptedById) {
+    if (proposed === undefined || proposed === null)
+        return null;
+    if (!/^DEC-\d{4,}$/.test(proposed))
+        return null;
+    return acceptedById.has(proposed) ? proposed : null;
+}
+function canonicalPointerFor(repoRoot, decisionId) {
+    const path = join(decisionsDir(repoRoot), `${decisionId}.md`);
+    if (!existsSync(path))
+        return null;
+    return `.cairn/ground/decisions/${decisionId}.md`;
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/mcp/history/summarizer.js.map

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

package/dist/mcp/history/walker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Archive walker — collects matching files from .archive/ for the
+ * Tier-1 history summarizer.
+ *
+ * The walker reads file content but does NOT return it to the agent.
+ * The MCP server feeds content to a Tier-1 LLM; the LLM emits
+ * structured claims; only the structured claims reach the agent's
+ * context. This is the load-bearing two-zone enforcement: raw stale
+ * content never crosses the historical/canonical boundary.
+ */
+export interface ArchiveFile {
+    /** Absolute path. */
+    absPath: string;
+    /** Repo-relative POSIX path. */
+    relPath: string;
+    /**
+     * Inferred archive date — from the path bucket
+     * `.archive/YYYY-MM-DD/...` if present, else file mtime ISO.
+     */
+    archiveDate: string;
+    /** Inferred bucket label — the segment immediately under .archive/. */
+    bucket: string;
+    /** UTF-8 content, truncated by `maxBytesPerFile`. */
+    content: string;
+    /** Size of original content in bytes (pre-truncation). */
+    bytesOriginal: number;
+    /** True iff `content` was truncated. */
+    truncated: boolean;
+}
+export interface WalkArchiveResult {
+    files: ArchiveFile[];
+    /** True iff at least one match was skipped because totalBytes cap was reached. */
+    capHit: boolean;
+    totalBytes: number;
+    /** Buckets discovered under .archive/ (top-level dirs). */
+    bucketsScanned: string[];
+}
+export interface WalkArchiveOptions {
+    repoRoot: string;
+    /** Optional repo-relative glob (e.g. ".archive/2026-05-pre-cairn/**"). */
+    pathHint?: string;
+    /** ISO 8601 lower bound (inclusive). Compared to archiveDate. */
+    since?: string;
+    /** ISO 8601 upper bound (inclusive). Compared to archiveDate. */
+    until?: string;
+    /** Per-file content cap. Default 32 KB. */
+    maxBytesPerFile?: number;
+    /** Total content cap across all files. Default 200 KB. */
+    maxBytesTotal?: number;
+    /** Hard cap on number of files returned. Default 40. */
+    maxFiles?: number;
+}
+/**
+ * Walks `<repoRoot>/.archive/` collecting matching files. Returns content
+ * inline so the summarizer can build a prompt without re-reading.
+ */
+export declare function walkArchive(opts: WalkArchiveOptions): WalkArchiveResult;

package/dist/mcp/history/walker.js

@@ -0,0 +1,156 @@
+/**
+ * Archive walker — collects matching files from .archive/ for the
+ * Tier-1 history summarizer.
+ *
+ * The walker reads file content but does NOT return it to the agent.
+ * The MCP server feeds content to a Tier-1 LLM; the LLM emits
+ * structured claims; only the structured claims reach the agent's
+ * context. This is the load-bearing two-zone enforcement: raw stale
+ * content never crosses the historical/canonical boundary.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, join, relative } from "node:path";
+import { matchAnyGlob } from "../../ground/glob.js";
+const DEFAULT_MAX_BYTES_PER_FILE = 32 * 1024;
+const DEFAULT_MAX_BYTES_TOTAL = 200 * 1024;
+const DEFAULT_MAX_FILES = 40;
+const CONTENT_EXTENSIONS = new Set([
+    ".md",
+    ".markdown",
+    ".yaml",
+    ".yml",
+    ".json",
+    ".txt",
+    ".sql",
+]);
+const BUCKET_DATE_RE = /^(\d{4}-\d{2}-\d{2})/;
+/**
+ * Walks `<repoRoot>/.archive/` collecting matching files. Returns content
+ * inline so the summarizer can build a prompt without re-reading.
+ */
+export function walkArchive(opts) {
+    const archiveRoot = join(opts.repoRoot, ".archive");
+    const maxBytesPerFile = opts.maxBytesPerFile ?? DEFAULT_MAX_BYTES_PER_FILE;
+    const maxBytesTotal = opts.maxBytesTotal ?? DEFAULT_MAX_BYTES_TOTAL;
+    const maxFiles = opts.maxFiles ?? DEFAULT_MAX_FILES;
+    const files = [];
+    const bucketsScanned = [];
+    let totalBytes = 0;
+    let capHit = false;
+    let topEntries;
+    try {
+        topEntries = readdirSync(archiveRoot, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return { files: [], capHit: false, totalBytes: 0, bucketsScanned: [] };
+    }
+    for (const top of topEntries) {
+        if (!top.isDirectory())
+            continue;
+        bucketsScanned.push(top.name);
+    }
+    bucketsScanned.sort();
+    // BFS so the closest-to-root files come first when caps trigger.
+    const stack = bucketsScanned.map((b) => ({
+        absDir: join(archiveRoot, b),
+        bucket: b,
+    }));
+    while (stack.length > 0 && files.length < maxFiles) {
+        const cur = stack.pop();
+        if (cur === undefined)
+            break;
+        let entries;
+        try {
+            entries = readdirSync(cur.absDir, { withFileTypes: true, encoding: "utf8" });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const abs = join(cur.absDir, e.name);
+            if (e.isDirectory()) {
+                stack.push({ absDir: abs, bucket: cur.bucket });
+                continue;
+            }
+            if (!e.isFile())
+                continue;
+            if (!hasContentExtension(e.name))
+                continue;
+            const rel = relative(opts.repoRoot, abs).replace(/\\/g, "/");
+            if (opts.pathHint && opts.pathHint.length > 0) {
+                if (!matchAnyGlob(rel, [opts.pathHint]))
+                    continue;
+            }
+            const archiveDate = inferArchiveDate(cur.bucket, abs);
+            if (!withinDateWindow(archiveDate, opts.since, opts.until))
+                continue;
+            let buf;
+            try {
+                buf = readFileSync(abs);
+            }
+            catch {
+                continue;
+            }
+            const bytesOriginal = buf.byteLength;
+            if (totalBytes + Math.min(bytesOriginal, maxBytesPerFile) > maxBytesTotal) {
+                capHit = true;
+                continue;
+            }
+            const truncated = bytesOriginal > maxBytesPerFile;
+            const content = truncated
+                ? buf.subarray(0, maxBytesPerFile).toString("utf8") + "\n…[truncated]"
+                : buf.toString("utf8");
+            totalBytes += truncated ? maxBytesPerFile : bytesOriginal;
+            files.push({
+                absPath: abs,
+                relPath: rel,
+                archiveDate,
+                bucket: cur.bucket,
+                content,
+                bytesOriginal,
+                truncated,
+            });
+            if (files.length >= maxFiles) {
+                capHit = true;
+                break;
+            }
+        }
+    }
+    files.sort((a, b) => a.relPath.localeCompare(b.relPath));
+    return { files, capHit, totalBytes, bucketsScanned };
+}
+function hasContentExtension(name) {
+    const dot = name.lastIndexOf(".");
+    if (dot === -1)
+        return false;
+    const ext = name.slice(dot).toLowerCase();
+    return CONTENT_EXTENSIONS.has(ext);
+}
+function inferArchiveDate(bucket, absPath) {
+    const match = BUCKET_DATE_RE.exec(basename(bucket));
+    if (match?.[1])
+        return `${match[1]}T00:00:00Z`;
+    try {
+        return new Date(statSync(absPath).mtimeMs).toISOString();
+    }
+    catch {
+        return new Date(0).toISOString();
+    }
+}
+function withinDateWindow(date, since, until) {
+    const t = Date.parse(date);
+    if (Number.isNaN(t))
+        return true;
+    if (since !== undefined) {
+        const s = Date.parse(since);
+        if (!Number.isNaN(s) && t < s)
+            return false;
+    }
+    if (until !== undefined) {
+        const u = Date.parse(until);
+        if (!Number.isNaN(u) && t > u)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=walker.js.map

package/dist/mcp/history/walker.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,13 @@
+export { startMcpServer } from "./server.js";
+export type { StartServerOptions } from "./server.js";
+export { createContext } from "./context.js";
+export type { McpContext } from "./context.js";
+export { allTools } from "./tools/index.js";
+export type { ToolDef } from "./tools/types.js";
+export { mcpError, isMcpError } from "./errors.js";
+export type { McpErrorCode, McpErrorPayload } from "./errors.js";
+export { requireBootstrap } from "./bootstrap-guard.js";
+export { asMcpResult } from "./result.js";
+export { APPEND_ALLOWLIST, ARCHIVE_DENY, HISTORICAL_ZONE, isAppendAllowed, isArchiveDenied, isHistorical, safeJoin, } from "./path-allowlist.js";
+export { buildHistorySummarizerUserPrompt, CAIRN_HISTORY_SUMMARIZE_PROMPT_ID, CAIRN_HISTORY_SUMMARIZE_VERSION, HISTORY_SUMMARIZER_OUTPUT_SCHEMA, HISTORY_SUMMARIZER_SYSTEM_PROMPT, runHistorySummarizer, runQueryHistory, walkArchive, } from "./history/index.js";
+export type { ArchiveFile, QueryHistoryResponse, RunQueryHistoryArgs, SummarizedClaim, WalkArchiveOptions, WalkArchiveResult, } from "./history/index.js";

package/dist/mcp/index.js

@@ -0,0 +1,9 @@
+export { startMcpServer } from "./server.js";
+export { createContext } from "./context.js";
+export { allTools } from "./tools/index.js";
+export { mcpError, isMcpError } from "./errors.js";
+export { requireBootstrap } from "./bootstrap-guard.js";
+export { asMcpResult } from "./result.js";
+export { APPEND_ALLOWLIST, ARCHIVE_DENY, HISTORICAL_ZONE, isAppendAllowed, isArchiveDenied, isHistorical, safeJoin, } from "./path-allowlist.js";
+export { buildHistorySummarizerUserPrompt, CAIRN_HISTORY_SUMMARIZE_PROMPT_ID, CAIRN_HISTORY_SUMMARIZE_VERSION, HISTORY_SUMMARIZER_OUTPUT_SCHEMA, HISTORY_SUMMARIZER_SYSTEM_PROMPT, runHistorySummarizer, runQueryHistory, walkArchive, } from "./history/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EACjC,+BAA+B,EAC/B,gCAAgC,EAChC,gCAAgC,EAChC,oBAAoB,EACpB,eAAe,EACf,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/mcp/path-allowlist.d.ts

@@ -0,0 +1,29 @@
+import { type McpErrorPayload } from "./errors.js";
+/**
+ * Append-write allowlist. Server-side, NOT agent-controllable.
+ *
+ * Per MCP_SURFACE.md §"Write tools — append-only":
+ *   - .cairn/runs/active/<run-id>/events.jsonl
+ *   - .cairn/runs/active/<run-id>/commands.jsonl
+ *   - .cairn/staleness/log.jsonl
+ *   - .cairn/inbox/**         (system-only; rarely used by agents)
+ *
+ * Per CONTEXT_CONTINUITY_SPEC §2.3:
+ *   - .cairn/tasks/active/<task-id>/notes.md  — agent-authored run notes
+ *     (consumed by handoff builder; persists across sessions)
+ */
+export declare const APPEND_ALLOWLIST: readonly string[];
+/**
+ * Paths agents may NOT archive. AGENTS.md, CLAUDE.md, brand guidelines, and
+ * decisions/ are all sacred ground.
+ */
+export declare const ARCHIVE_DENY: readonly string[];
+/** Historical-zone globs — read tools refuse these; query_history is the ONE escape. */
+export declare const HISTORICAL_ZONE: readonly string[];
+/** Resolves a relative path against repoRoot and rejects escapes. */
+export declare function safeJoin(repoRoot: string, rel: string): string | McpErrorPayload;
+/** Returns repo-relative POSIX-style path for a path already inside repoRoot. */
+export declare function relPosix(repoRoot: string, abs: string): string;
+export declare function isAppendAllowed(repoRelPath: string): boolean;
+export declare function isArchiveDenied(repoRelPath: string): boolean;
+export declare function isHistorical(repoRelPath: string): boolean;