daftari 1.29.0 → 1.31.0

package/dist/tools/read.js

@@ -5,23 +5,30 @@
 // definitions; tests call the logic functions directly.
 import { canRead, filterByReadPermission } from "../access/rbac.js";
 import { computeDecay } from "../curation/decay.js";
+import { compiledUpstreamStaleness, loadCompiledStaleContext, splitUpstreamVisibility, } from "../curation/edge-staleness.js";
 import { readProvenanceLog } from "../curation/provenance.js";
+import { recordRead } from "../curation/read-log.js";
 import { listStaleFiles } from "../curation/staleness.js";
+import { structuralDecay } from "../curation/structural.js";
 import { DEFAULT_TENSION_STATUS, listTensions } from "../curation/tension.js";
+import { sourceReadable, visibleTensions } from "../curation/tension-access.js";
 import { parseDocument } from "../frontmatter/parser.js";
 import { DOMAINS, err, ok, STATUSES, } from "../frontmatter/types.js";
+import { contestedFor } from "../search/contested.js";
 import { getProvider } from "../search/vector.js";
 import { countDimMismatches, openIndexDb } from "../storage/index-db.js";
 import { listFiles, readFile, resolveVaultPath } from "../storage/local.js";
 import { sha256Hex } from "../utils/hash.js";
-export async function vaultRead(vaultRoot, path, access) {
+import { readRunId } from "../utils/run-id.js";
+import { openIndexForAccessOrNull } from "./search.js";
+export async function vaultRead(vaultRoot, path, access, runId) {
     if (typeof path !== "string" || path.length === 0) {
         return err(new Error("vault_read requires a non-empty 'path' argument"));
     }
     const resolved = resolveVaultPath(vaultRoot, path);
     if (!resolved.ok)
         return resolved;
-    const file = await readFile(resolved.value);
+    const file = await readFile(resolved.value.absPath);
     if (!file.ok)
         return file;
     const parsed = parseDocument(file.value);
@@ -33,6 +40,89 @@ export async function vaultRead(vaultRoot, path, access) {
             return err(new Error(`access denied: role '${access.roleName}' cannot read ` + `collection '${collection}'`));
         }
     }
+    // #234: classify this document's compiled upstream edges as of the serve.
+    // Best-effort — the read never fails on telemetry; on a log-read error the
+    // serve is still recorded, just uninstrumented (broken_upstream absent).
+    //
+    // Cost posture (accepted for v1): classification is derived at query time
+    // from the two append-only logs, so an instrumented vault pays two log
+    // scans per read — the price of having no verdict store that could itself
+    // go stale. An UNinstrumented vault pays almost nothing: no consumes log
+    // (or an empty one) short-circuits before the provenance log is touched,
+    // since with zero compiled edges every broken count is zero. If vault
+    // history ever makes the scans hurt, the escalation is an index.db mirror
+    // of the logs (ephemeral, rebuildable — the edges.jsonl materialization
+    // precedent), not caching bolted on here.
+    const staleCtx = await loadCompiledStaleContext(vaultRoot);
+    const rows = staleCtx
+        ? compiledUpstreamStaleness(resolved.value.relPath, staleCtx.consumes, staleCtx.provenance)
+        : null;
+    // Every served read is logged — the broken-read rate needs its denominator
+    // (#234) — and a run_id additionally joins the run's input set (#233).
+    // Recorded only AFTER the RBAC gate (a denied read is never an input and
+    // never a serve), under the CANONICAL relPath so the write-time join
+    // matches performWrite's keying. broken_upstream is the TRUE count,
+    // unfiltered by the caller's role: the log is local operator telemetry,
+    // not a caller-facing surface. Best-effort: the read itself never fails
+    // on a logging failure.
+    await recordRead(vaultRoot, {
+        tool: "vault_read",
+        file: resolved.value.relPath,
+        ...(runId ? { run_id: runId } : {}),
+        ...(access?.user != null ? { principal: access.user } : {}),
+        ...(rows
+            ? { broken_upstream: rows.filter((r) => r.staleness === "pending-broken").length }
+            : {}),
+    });
+    // One index handle serves every graph-backed enrichment below: the #234
+    // visible/hidden split, structural decay (#8), and the contested join.
+    // Open failure degrades every one of them to silence — all advisory.
+    const db = openIndexForAccessOrNull(vaultRoot);
+    let upstream = null;
+    let structural = null;
+    let contestedResult = null;
+    try {
+        // Reader-facing surface: visible edges by omission, hidden pending edges
+        // coarsened (#217 — an exact count over unreadable units is a small-cell
+        // existence leak). Collapses to null when there is nothing to report,
+        // which is byte-identical to a document with no compiled edges at all.
+        if (rows && rows.length > 0) {
+            const { visible, hiddenPending, } = access
+                ? splitUpstreamVisibility(rows, (unit) => sourceReadable(db, access, unit))
+                : { visible: rows, hiddenPending: "none" };
+            if (visible.length > 0 || hiddenPending !== "none") {
+                const pendingBroken = visible.filter((r) => r.staleness === "pending-broken").length;
+                const notes = [];
+                if (pendingBroken > 0) {
+                    notes.push(`${pendingBroken} compiled upstream input${pendingBroken === 1 ? " has" : "s have"} ` +
+                        `changed incompatibly since this document was compiled`);
+                }
+                if (hiddenPending !== "none") {
+                    notes.push(`${hiddenPending} upstream inputs outside your read scope have pending changes`);
+                }
+                upstream = {
+                    edges: visible,
+                    hidden_pending: hiddenPending,
+                    pending_broken: pendingBroken,
+                    banner: notes.length > 0 ? `${notes.join("; ")} — this content may predate them.` : null,
+                };
+            }
+        }
+        // #8: structural decay from the materialized inbound-link graph (one
+        // indexed query, lint's vantage rule), plus unresolved-tension parity
+        // with search's contested channel.
+        structural = structuralDecay({
+            db,
+            path: resolved.value.relPath,
+            status: parsed.value.frontmatter.status,
+            access,
+        });
+        if (db)
+            contestedResult = contestedFor(vaultRoot, db, resolved.value.relPath, access);
+    }
+    finally {
+        db?.close();
+    }
     return ok({
         path,
         content: parsed.value.content,
@@ -41,6 +131,11 @@ export async function vaultRead(vaultRoot, path, access) {
         validation: parsed.value.validation,
         hasFrontmatter: parsed.value.hasFrontmatter,
         decay: computeDecay(parsed.value.frontmatter),
+        upstream_staleness: upstream,
+        structural,
+        ...(contestedResult
+            ? { contested: contestedResult.contested, contestedCount: contestedResult.contestedCount }
+            : {}),
         version: sha256Hex(file.value),
     });
 }
@@ -61,7 +156,7 @@ export async function vaultIndex(vaultRoot, filters = {}, access) {
         const resolved = resolveVaultPath(vaultRoot, relPath);
         if (!resolved.ok)
             continue;
-        const file = await readFile(resolved.value);
+        const file = await readFile(resolved.value.absPath);
         if (!file.ok)
             continue;
         const parsed = parseDocument(file.value);
@@ -102,12 +197,6 @@ export async function vaultIndex(vaultRoot, filters = {}, access) {
     const visible = access ? filterByReadPermission(access.role, entries) : entries;
     return ok({ count: visible.length, entries: visible });
 }
-// The collection a bare vault-relative path belongs to: its top-level
-// directory. tension/provenance records carry only a path (no frontmatter),
-// so RBAC on those falls back to this path-based collection.
-function topCollection(relPath) {
-    return relPath.split("/")[0] ?? "";
-}
 export async function vaultStatus(vaultRoot, access) {
     // vault_status reports only over the documents the role can read.
     const index = await vaultIndex(vaultRoot, {}, access);
@@ -148,28 +237,34 @@ export async function vaultStatus(vaultRoot, access) {
         else
             stalenessDistribution.fresh += 1;
     }
-    // Unresolved tensions. A tension links two files; with an access context we
-    // show it only when the role can read the collections of BOTH sources, so
-    // the dashboard never leaks the existence of a doc in a denied collection.
+    // Unresolved tensions and provenance entries carry only a path (no
+    // frontmatter), so RBAC on them goes through the shared source predicates
+    // (canonicalized — an alias must not widen visibility). A tension shows
+    // only when the role can read BOTH sources; a write entry when it can read
+    // the written file. Neither leaks the existence of a doc in a denied
+    // collection.
     const tensions = await listTensions(vaultRoot, DEFAULT_TENSION_STATUS);
     if (!tensions.ok)
         return tensions;
-    const visibleTensions = access
-        ? tensions.value.filter((t) => canRead(access.role, topCollection(t.sourceA)) &&
-            canRead(access.role, topCollection(t.sourceB)))
-        : tensions.value;
-    const recentTensions = [...visibleTensions]
-        .sort((a, b) => b.date.localeCompare(a.date))
-        .slice(0, 5)
-        .map((t) => ({ title: t.title, date: t.date }));
-    // Recent writes from the provenance log (oldest first in the file). Each
-    // entry is gated by the role's read access to the written file's collection.
     const log = await readProvenanceLog(vaultRoot);
     if (!log.ok)
         return log;
-    const visibleWrites = access
-        ? log.value.filter((e) => canRead(access.role, topCollection(e.file)))
-        : log.value;
+    let tensionEntries = tensions.value;
+    let visibleWrites = log.value;
+    if (access) {
+        const accessDb = openIndexForAccessOrNull(vaultRoot);
+        try {
+            tensionEntries = visibleTensions(accessDb, tensions.value, access);
+            visibleWrites = log.value.filter((e) => sourceReadable(accessDb, access, e.file));
+        }
+        finally {
+            accessDb?.close();
+        }
+    }
+    const recentTensions = [...tensionEntries]
+        .sort((a, b) => b.date.localeCompare(a.date))
+        .slice(0, 5)
+        .map((t) => ({ title: t.title, date: t.date }));
     // Dim-mismatch counter. A non-zero value means some embedding cache rows
     // for the active model have the wrong dim and are being silently skipped
     // by vector ranking. We open the DB defensively — if sqlite-vec isn't
@@ -193,7 +288,7 @@ export async function vaultStatus(vaultRoot, access) {
         generatedAt: new Date().toISOString(),
         stalenessDistribution,
         unresolvedTensions: {
-            count: visibleTensions.length,
+            count: tensionEntries.length,
             recent: recentTensions,
         },
         recentWrites: {
@@ -222,10 +317,17 @@ export const readTools = [
         annotations: { readOnlyHint: true },
         description: "Read a single vault document. Returns its markdown body, parsed " +
             "frontmatter, a validation report, a decay assessment (null when " +
-            "healthy; otherwise level, reasons, and an optional banner), and a " +
-            "'version' token (SHA-256 of the file) that can be passed back to a " +
-            "write tool as 'base_version' for optimistic-concurrency checking. " +
-            "Path is relative to the vault root.",
+            "healthy; otherwise level, reasons, and an optional banner), an " +
+            "upstream_staleness report (#234 — per compiled input, whether it " +
+            "changed since this document was compiled and what tier 1 says about " +
+            "the pending change: current / pending-compatible / pending-broken; " +
+            "null when there is nothing to report), a structural report (#8 — " +
+            "orphan: nothing you can read links here; deprecated_still_linked: " +
+            "canonical docs still lean on this deprecated one; null when healthy), " +
+            "any unresolved tensions involving the document (contested, same " +
+            "shape as search hits), and a 'version' token (SHA-256 of the file) " +
+            "that can be passed back to a write tool as 'base_version' for " +
+            "optimistic-concurrency checking. Path is relative to the vault root.",
         inputSchema: {
             type: "object",
             properties: {
@@ -233,11 +335,22 @@ export const readTools = [
                     type: "string",
                     description: "Vault-relative path to the markdown file, e.g. competitive-intel/foo.md",
                 },
+                run_id: {
+                    type: "string",
+                    description: "Optional trace/run identifier of the calling run. Recorded in " +
+                        "the read log so a later write by the same run compiles this " +
+                        "document into its consumes edges (#233).",
+                },
             },
             required: ["path"],
             additionalProperties: false,
         },
-        handler: (vaultRoot, args, access) => vaultRead(vaultRoot, String(args.path ?? ""), access),
+        handler: (vaultRoot, args, access) => {
+            const runId = readRunId(args, "vault_read");
+            if (!runId.ok)
+                return Promise.resolve(runId);
+            return vaultRead(vaultRoot, String(args.path ?? ""), access, runId.value);
+        },
     },
     {
         name: "vault_index",

package/dist/tools/read.js.map

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

package/dist/tools/receipt.d.ts

@@ -0,0 +1,65 @@
+import { type AccessContext } from "../access/rbac.js";
+import { type DecayState } from "../curation/decay.js";
+import { type AgingTier, type TensionKind } from "../curation/tension.js";
+import { type Result } from "../frontmatter/types.js";
+import type { ToolDefinition } from "./read.js";
+export declare const MAX_RECEIPT_PATHS = 50;
+export declare const MAX_CLAIM_LENGTH = 2000;
+export type ChainResolution = {
+    kind: "resolved";
+    path: string;
+    title: string;
+    hops: number;
+} | {
+    kind: "restricted";
+} | {
+    kind: "dangling";
+    brokenAt: string;
+} | {
+    kind: "cycle";
+};
+export interface ReceiptTension {
+    id: string | null;
+    title: string;
+    kind: TensionKind;
+    date: string;
+    agingTier: AgingTier | null;
+}
+export interface ReceiptSource {
+    path: string;
+    title: string;
+    collection: string;
+    status: string;
+    confidence: string;
+    provenance: string;
+    created: string;
+    updated: string;
+    sources: string[];
+    version: string;
+    decay: DecayState | null;
+    currentSource: ChainResolution | null;
+    tensions: ReceiptTension[];
+}
+export interface ReceiptSummary {
+    sourceCount: number;
+    byStatus: Record<string, number>;
+    openTensions: number;
+    oldestUpdated: string | null;
+    newestUpdated: string | null;
+    flags: string[];
+}
+export interface VaultReceiptResult {
+    claim: string | null;
+    sources: ReceiptSource[];
+    summary: ReceiptSummary;
+    vaultHead: string | null;
+    generatedAt: string;
+    receiptHash: string;
+}
+export interface VaultReceiptArgs {
+    paths: string[];
+    claim?: string;
+}
+export declare function vaultReceipt(vaultRoot: string, args: VaultReceiptArgs, access?: AccessContext): Promise<Result<VaultReceiptResult, Error>>;
+export declare const receiptTools: ToolDefinition[];
+//# sourceMappingURL=receipt.d.ts.map

package/dist/tools/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/tools/receipt.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,KAAK,SAAS,EAKd,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAI/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAOrC,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAGzB,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IAEtC,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IAGxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IAGpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAkDD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,CAgJ5C;AAMD,eAAO,MAAM,YAAY,EAAE,cAAc,EAiDxC,CAAC"}

package/dist/tools/receipt.js

@@ -0,0 +1,257 @@
+// vault_receipt — compile an epistemic receipt for the documents an answer
+// cites.
+//
+// The receipt is the vault's metadata weaponized into a single attachable
+// artifact: for each cited document its status, confidence, provenance,
+// freshness (decay), exact content version, the resolution of its
+// supersession chain, and every unresolved tension touching it — plus a
+// deterministic summary with machine-readable flags, the vault's git HEAD as
+// an as-of anchor, and a content hash over the whole receipt.
+//
+// Discipline: the receipt only *reads* — frontmatter, the tension log, git.
+// It never grades, never synthesizes prose, never mints a value. Flags are
+// deterministic derivations from facts already in the vault. The optional
+// `claim` is caller-supplied and carried verbatim (labeled as such); it is
+// never interpolated into any Daftari-authored text.
+import { canRead } from "../access/rbac.js";
+import { computeDecay } from "../curation/decay.js";
+import { agingTier, DEFAULT_TENSION_STATUS, listTensions, } from "../curation/tension.js";
+import { visibleTensions } from "../curation/tension-access.js";
+import { parseDocument } from "../frontmatter/parser.js";
+import { err, ok } from "../frontmatter/types.js";
+import { readFile, resolveVaultPath } from "../storage/local.js";
+import { log as gitLog, isGitRepo } from "../utils/git.js";
+import { sha256Hex } from "../utils/hash.js";
+import { openIndexForAccessOrNull } from "./search.js";
+export const MAX_RECEIPT_PATHS = 50;
+export const MAX_CLAIM_LENGTH = 2000;
+// A document's collection: frontmatter `collection`, falling back to the
+// top-level directory. Tension records carry only a path, so RBAC on the
+// counterpart side falls back to the path-based collection.
+function topCollection(relPath) {
+    return relPath.split("/")[0] ?? "";
+}
+function tensionIdentity(t) {
+    return t.id ?? `${t.date}:${t.title}`;
+}
+async function resolveChain(vaultRoot, startPath, startSupersededBy, access) {
+    const visited = new Set([startPath]);
+    let hops = 0;
+    let nextRel = startSupersededBy;
+    let currentPath = startPath;
+    let currentTitle = "";
+    while (nextRel !== null) {
+        hops += 1;
+        const resolved = resolveVaultPath(vaultRoot, nextRel);
+        if (!resolved.ok)
+            return { kind: "dangling", brokenAt: currentPath };
+        const rel = resolved.value.relPath;
+        if (visited.has(rel))
+            return { kind: "cycle" };
+        visited.add(rel);
+        const file = await readFile(resolved.value.absPath);
+        if (!file.ok)
+            return { kind: "dangling", brokenAt: currentPath };
+        const parsed = parseDocument(file.value);
+        if (!parsed.ok)
+            return { kind: "dangling", brokenAt: currentPath };
+        const fm = parsed.value.frontmatter;
+        const collection = fm.collection || topCollection(rel);
+        if (access && !canRead(access.role, collection))
+            return { kind: "restricted" };
+        currentPath = rel;
+        currentTitle = fm.title;
+        nextRel = fm.superseded_by;
+    }
+    return { kind: "resolved", path: currentPath, title: currentTitle, hops };
+}
+export async function vaultReceipt(vaultRoot, args, access) {
+    if (!Array.isArray(args.paths) || args.paths.length === 0) {
+        return err(new Error("vault_receipt requires a non-empty 'paths' array"));
+    }
+    if (args.paths.some((p) => typeof p !== "string" || p.length === 0)) {
+        return err(new Error("vault_receipt 'paths' entries must be non-empty strings"));
+    }
+    if (args.paths.length > MAX_RECEIPT_PATHS) {
+        return err(new Error(`vault_receipt accepts at most ${MAX_RECEIPT_PATHS} paths`));
+    }
+    if (args.claim !== undefined) {
+        if (typeof args.claim !== "string") {
+            return err(new Error("vault_receipt 'claim' must be a string"));
+        }
+        if (args.claim.length > MAX_CLAIM_LENGTH) {
+            return err(new Error(`vault_receipt 'claim' exceeds ${MAX_CLAIM_LENGTH} characters`));
+        }
+    }
+    // Unresolved tensions, read once. With an access context a tension is
+    // visible only when the role can read BOTH sources' collections (the
+    // vault_status precedent), judged on the canonicalized paths via the shared
+    // predicate — the receipt never leaks the existence of a document in a
+    // denied collection, and an alias must not widen visibility.
+    const tensionScan = await listTensions(vaultRoot, DEFAULT_TENSION_STATUS);
+    if (!tensionScan.ok)
+        return tensionScan;
+    let tensionEntries = tensionScan.value;
+    if (access) {
+        const accessDb = openIndexForAccessOrNull(vaultRoot);
+        try {
+            tensionEntries = visibleTensions(accessDb, tensionScan.value, access);
+        }
+        finally {
+            accessDb?.close();
+        }
+    }
+    // Dedupe cited paths, preserving first-seen order.
+    const citedPaths = [];
+    const seen = new Set();
+    for (const p of args.paths) {
+        const resolved = resolveVaultPath(vaultRoot, p);
+        if (!resolved.ok)
+            return resolved;
+        const rel = resolved.value.relPath;
+        if (seen.has(rel))
+            continue;
+        seen.add(rel);
+        citedPaths.push(rel);
+    }
+    const sources = [];
+    const matchedTensionIds = new Set();
+    const flagSet = new Set();
+    for (const rel of citedPaths) {
+        const resolved = resolveVaultPath(vaultRoot, rel);
+        if (!resolved.ok)
+            return resolved;
+        const file = await readFile(resolved.value.absPath);
+        if (!file.ok)
+            return file;
+        const parsed = parseDocument(file.value);
+        if (!parsed.ok)
+            return parsed;
+        const fm = parsed.value.frontmatter;
+        const collection = fm.collection || topCollection(rel);
+        if (access && !canRead(access.role, collection)) {
+            return err(new Error(`access denied: role '${access.roleName}' cannot read collection '${collection}'`));
+        }
+        const decay = computeDecay(fm);
+        const onChain = fm.superseded_by !== null || fm.status === "superseded";
+        const currentSource = onChain
+            ? await resolveChain(vaultRoot, rel, fm.superseded_by, access)
+            : null;
+        const matched = tensionEntries.filter((t) => t.sourceA === rel || t.sourceB === rel);
+        for (const t of matched)
+            matchedTensionIds.add(tensionIdentity(t));
+        if (fm.status === "deprecated")
+            flagSet.add("cites-deprecated");
+        if (fm.status === "archived")
+            flagSet.add("cites-archived");
+        if (fm.status === "draft")
+            flagSet.add("cites-draft");
+        if (onChain)
+            flagSet.add("cites-superseded");
+        if (fm.confidence === "low")
+            flagSet.add("cites-low-confidence");
+        if (decay?.level === "warn")
+            flagSet.add("cites-stale");
+        if (decay?.level === "aging")
+            flagSet.add("cites-aging");
+        if (matched.length > 0)
+            flagSet.add("cites-contested");
+        if (currentSource !== null && currentSource.kind !== "resolved") {
+            flagSet.add("supersession-unresolved");
+        }
+        sources.push({
+            path: rel,
+            title: fm.title,
+            collection,
+            status: fm.status,
+            confidence: fm.confidence,
+            provenance: fm.provenance,
+            created: fm.created,
+            updated: fm.updated,
+            sources: fm.sources,
+            version: sha256Hex(file.value),
+            decay,
+            currentSource,
+            tensions: matched.map((t) => ({
+                id: t.id ?? null,
+                title: t.title,
+                kind: t.kind,
+                date: t.date,
+                agingTier: agingTier(t),
+            })),
+        });
+    }
+    const byStatus = {};
+    for (const s of sources) {
+        byStatus[s.status] = (byStatus[s.status] ?? 0) + 1;
+    }
+    const updatedDates = sources.map((s) => s.updated).filter((d) => d.length > 0);
+    updatedDates.sort();
+    const summary = {
+        sourceCount: sources.length,
+        byStatus,
+        openTensions: matchedTensionIds.size,
+        oldestUpdated: updatedDates[0] ?? null,
+        newestUpdated: updatedDates[updatedDates.length - 1] ?? null,
+        flags: [...flagSet].sort(),
+    };
+    // The as-of anchor: the vault's HEAD commit. Belief archaeology starts
+    // here — a receipt plus this hash reproduces the exact vault state the
+    // answer was compiled against.
+    let vaultHead = null;
+    if (await isGitRepo(vaultRoot)) {
+        const head = await gitLog(vaultRoot, { limit: 1 });
+        if (head.ok && head.value.length > 0)
+            vaultHead = head.value[0].hash;
+    }
+    const claim = args.claim !== undefined && args.claim.length > 0 ? args.claim : null;
+    const generatedAt = new Date().toISOString();
+    const payload = { claim, sources, summary, vaultHead, generatedAt };
+    return ok({ ...payload, receiptHash: sha256Hex(JSON.stringify(payload)) });
+}
+// ---------------------------------------------------------------------------
+// MCP tool definition
+// ---------------------------------------------------------------------------
+export const receiptTools = [
+    {
+        name: "vault_receipt",
+        title: "Compile an epistemic receipt",
+        annotations: { readOnlyHint: true },
+        description: "Compile an epistemic receipt for the vault documents an answer relies " +
+            "on. For each cited path: status, confidence, provenance, freshness " +
+            "(decay), an exact content-version hash, the resolution of its " +
+            "supersession chain, and any unresolved tensions touching it. Plus a " +
+            "summary with deterministic flags (e.g. cites-stale, cites-contested, " +
+            "cites-superseded — empty flags mean current, grounded, uncontested), " +
+            "the vault's git HEAD as an as-of anchor, and a recomputable SHA-256 " +
+            "over the receipt. Attach the receipt to the answer so downstream " +
+            "consumers can see what it stands on. Read-only; facts are derived " +
+            "from frontmatter, the tension log, and git — never invented.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                paths: {
+                    type: "array",
+                    items: { type: "string" },
+                    minItems: 1,
+                    maxItems: MAX_RECEIPT_PATHS,
+                    description: "Vault-relative paths of the documents the answer cites, e.g. " +
+                        "competitive-intel/foo.md",
+                },
+                claim: {
+                    type: "string",
+                    maxLength: MAX_CLAIM_LENGTH,
+                    description: "Optional one-line statement of the answer the receipt attests. " +
+                        "Carried verbatim (caller-supplied) and covered by the receipt hash.",
+                },
+            },
+            required: ["paths"],
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultReceipt(vaultRoot, {
+            paths: Array.isArray(args.paths) ? args.paths : [],
+            claim: typeof args.claim === "string" ? args.claim : undefined,
+        }, access),
+    },
+];
+//# sourceMappingURL=receipt.js.map