@isaacriehm/cairn-core 0.14.0 → 0.14.2

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

@@ -1,57 +0,0 @@
-/**
- * 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

@@ -1,156 +0,0 @@
-/**
- * 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 "@isaacriehm/cairn-state";
-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();
-    // DFS per bucket; caps bound total output regardless of traversal order.
-    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

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

package/dist/mcp/tools/query-history.d.ts

@@ -1,20 +0,0 @@
-/**
- * cairn_query_history — the only sanctioned read path into .archive/.
- *
- * Walks .archive/ matching path_hint + date window, runs a Tier-1 (Haiku)
- * summarizer over the matched files, returns structured per-claim
- * records with source citations and supersedes-tags. The agent never
- * sees raw stale content — only the summary.
- *
- * Per MCP_SURFACE.md §"cairn_query_history". Implementation lives in
- * src/mcp/history/.
- */
-import type { ToolDef } from "./types.js";
-interface Input {
-    scope: string;
-    path_hint?: string;
-    since?: string;
-    until?: string;
-}
-export declare const queryHistoryTool: ToolDef<Input>;
-export {};

package/dist/mcp/tools/query-history.js

@@ -1,51 +0,0 @@
-/**
- * cairn_query_history — the only sanctioned read path into .archive/.
- *
- * Walks .archive/ matching path_hint + date window, runs a Tier-1 (Haiku)
- * summarizer over the matched files, returns structured per-claim
- * records with source citations and supersedes-tags. The agent never
- * sees raw stale content — only the summary.
- *
- * Per MCP_SURFACE.md §"cairn_query_history". Implementation lives in
- * src/mcp/history/.
- */
-import { mcpError } from "../errors.js";
-import { isQuotaKind, ClaudeError, classifyClaudeError, } from "../../claude/index.js";
-import { runQueryHistory } from "../history/summarizer.js";
-import { queryHistoryInput } from "../schemas.js";
-async function handler(ctx, input) {
-    try {
-        const args = {
-            repoRoot: ctx.repoRoot,
-            scope: input.scope,
-        };
-        if (input.path_hint !== undefined)
-            args.pathHint = input.path_hint;
-        if (input.since !== undefined)
-            args.since = input.since;
-        if (input.until !== undefined)
-            args.until = input.until;
-        return await runQueryHistory(args);
-    }
-    catch (err) {
-        if (err instanceof ClaudeError) {
-            if (isQuotaKind(err.kind)) {
-                return mcpError("OPERATION_TIMEOUT", `history summarizer quota / rate-limit: ${err.message}`, { kind: err.kind, exit_code: err.exitCode ?? null });
-            }
-            return mcpError("INTERNAL_ERROR", `history summarizer call failed: ${err.message}`, { kind: err.kind, exit_code: err.exitCode ?? null });
-        }
-        const kind = classifyClaudeError({
-            message: err instanceof Error ? err.message : String(err),
-            exitCode: null,
-            stderr: "",
-        });
-        return mcpError("INTERNAL_ERROR", `history summarizer threw: ${err instanceof Error ? err.message : String(err)}`, { kind });
-    }
-}
-export const queryHistoryTool = {
-    name: "cairn_query_history",
-    description: "Returns summarized historical claims from .archive/ via Tier-1 LLM. Walks the archive by path_hint + since/until, summarizes per-claim with source citations and supersedes-tags. Raw archive content never enters agent context — only the structured summary does. The only sanctioned path into .archive/.",
-    inputSchema: queryHistoryInput,
-    handler,
-};
-//# sourceMappingURL=query-history.js.map

package/dist/mcp/tools/query-history.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"query-history.js","sourceRoot":"","sources":["../../../src/mcp/tools/query-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EACL,WAAW,EACX,WAAW,EACX,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUlD,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAA0C;YAClD,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;QACF,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;QACnE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACxD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACxD,OAAO,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,OAAO,QAAQ,CACb,mBAAmB,EACnB,0CAA0C,GAAG,CAAC,OAAO,EAAE,EACvD,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI,EAAE,CACpD,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CACb,gBAAgB,EAChB,mCAAmC,GAAG,CAAC,OAAO,EAAE,EAChD,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI,EAAE,CACpD,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,mBAAmB,CAAC;YAC/B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;QACH,OAAO,QAAQ,CACb,gBAAgB,EAChB,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC/E,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,+SAA+S;IACjT,WAAW,EAAE,iBAAiB;IAC9B,OAAO;CACR,CAAC"}

package/templates/.archive/README.md

@@ -1,67 +0,0 @@
----
-type: rule
-status: accepted
-audience: dual
-generated: 2026-05-02T13:19:00Z
-verified-at: 2026-05-02T13:19:00Z
-source-commits:
-  - manual
----
-
-# `.archive/` — quarantine zone
-
-This directory holds files that were once canonical but are no longer current. **It is committed history, not deletion.** Per `docs/FILESYSTEM_LAYOUT.md` §2 it is Cairn's `historical` zone.
-
-## What lives here
-
-- Pre-Cairn state files moved out at adoption (e.g. `2026-05-pre-cairn/STATE.md`)
-- Documents superseded by an ADR (the new ADR cites the archived path)
-- Stale generated artifacts whose source has been removed
-- Completed runs' terminal artifacts (auto-moved by Cairn)
-
-## What does NOT live here
-
-- Files marked `[STALE]` in canonical paths — Cairn rejects this pattern. Stale files are MOVED here, never banner-flagged in place.
-- Branches or tagged refs — `.archive/` is filesystem-only.
-- Secrets — `.env*` patterns stay in `.gitignore` regardless.
-
-## Layout convention
-
-```
-.archive/
-├── README.md
-├── 2026-05-pre-cairn/      ← one bucket per migration / adoption / cleanup wave
-│   └── <original-path>       ← preserves the file's prior path inside the bucket
-└── <YYYY-MM-DD>/             ← daily quarantine drops
-    └── <original-path>
-```
-
-## Reading from `.archive/`
-
-Agents do **not** read this directory directly. Soft enforcement, three layers:
-
-1. The `cairn hook session-start` SessionStart hook injects a reminder instructing the agent that historical paths are off-default.
-2. Cairn walkers (manifest build, GC sweep, sensor scans) exclude `.archive/` from canonical-zone reads.
-3. The only sanctioned read path is the MCP tool:
-
-```
-cairn_query_history(scope, question)
-```
-
-`cairn_query_history` walks `.archive/` (matched by `path_hint` + `since`/`until`), runs a Tier-1 Haiku summarizer, and returns structured per-claim records with source citations and supersedes-pointers. The agent receives only the summary — raw stale content never enters its context.
-
-PreToolUse-style interception is **not** used (operator decision 2026-05-04). The combination of SessionStart instruction + walker exclusion + `cairn_query_history` is sufficient and avoids the brittleness of a hot-path tool-call hook.
-
-## Writing to `.archive/`
-
-Only via `cairn_archive(path, reason)`. Direct moves are accepted but discouraged because they bypass the audit log. The MCP tool records the reason and timestamp.
-
-## Why we don't delete
-
-1. Decisions cite archived paths. Deletion breaks the audit trail.
-2. The init script's mapper agent learns from prior moves what's project-specific.
-3. Historical context is occasionally re-needed (e.g. confirming an old decision's premise). Quarantine preserves that without polluting canonical reads.
-
-## Restoring an archived file
-
-`cairn restore <path>` (CLI subcommand, future) — moves a file out of `.archive/<bucket>/` back to its original location and logs the restoration. Use sparingly.