@mneme-ai/core 0.12.0 → 0.14.0

package/dist/insights/network.js

@@ -0,0 +1,231 @@
+const STOPWORDS = new Set([
+    "the", "a", "an", "of", "to", "in", "on", "for", "and", "or", "with", "add", "added", "fix",
+    "remove", "update", "change", "make", "made", "new", "old", "this", "that", "is", "are", "be",
+    "feat", "chore", "docs", "test", "refactor", "style", "build", "ci", "perf", "revert",
+    "merge", "branch", "pr", "issue", "close", "closes", "fixes", "from", "by", "at", "into",
+]);
+export function buildNetwork(commits, opts = {}) {
+    const coTimeWindow = (opts.coTimeWindowDays ?? 7) * 86_400_000;
+    const minEdge = opts.minEdgeWeight ?? 0.05;
+    const minAuthor = opts.minAuthorCommits ?? 2;
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    if (sorted.length === 0) {
+        return { windowCommits: 0, nodes: [], edges: [], silos: [], bridges: [] };
+    }
+    // Author commit counts + tokens + files
+    const authorCommits = new Map();
+    const authorTokens = new Map();
+    const authorFiles = new Map();
+    const tokenizedPerCommit = new Map();
+    for (const c of sorted) {
+        const a = c.authorName || c.authorEmail;
+        let arr = authorCommits.get(a);
+        if (!arr) {
+            arr = [];
+            authorCommits.set(a, arr);
+        }
+        arr.push(c);
+        const tokens = tokenizeSet(`${c.subject}\n${c.body || ""}`);
+        tokenizedPerCommit.set(c.hash, tokens);
+        let at = authorTokens.get(a);
+        if (!at) {
+            at = new Set();
+            authorTokens.set(a, at);
+        }
+        for (const t of tokens)
+            at.add(t);
+        let af = authorFiles.get(a);
+        if (!af) {
+            af = new Set();
+            authorFiles.set(a, af);
+        }
+        for (const f of c.files)
+            af.add(f);
+    }
+    // Filter to authors meeting min
+    const eligible = [...authorCommits.entries()]
+        .filter(([, cs]) => cs.length >= minAuthor)
+        .map(([a]) => a);
+    // Build pairwise edges
+    const edges = [];
+    for (let i = 0; i < eligible.length; i++) {
+        for (let j = i + 1; j < eligible.length; j++) {
+            const a = eligible[i];
+            const b = eligible[j];
+            const aFiles = authorFiles.get(a);
+            const bFiles = authorFiles.get(b);
+            const aTokens = authorTokens.get(a);
+            const bTokens = authorTokens.get(b);
+            const aCommits = authorCommits.get(a);
+            const bCommits = authorCommits.get(b);
+            const coEdit = jaccard(aFiles, bFiles);
+            const coTopic = jaccard(aTokens, bTokens);
+            const coTime = computeCoTime(aCommits, bCommits, coTimeWindow);
+            const weight = Number((0.4 * coEdit + 0.2 * coTime + 0.4 * coTopic).toFixed(3));
+            if (weight < minEdge)
+                continue;
+            const sharedTerms = [...aTokens]
+                .filter((t) => bTokens.has(t))
+                .slice(0, 5);
+            edges.push({
+                authorA: a,
+                authorB: b,
+                weight,
+                axes: {
+                    coEdit: Number(coEdit.toFixed(3)),
+                    coTime: Number(coTime.toFixed(3)),
+                    coTopic: Number(coTopic.toFixed(3)),
+                },
+                sharedTerms,
+            });
+        }
+    }
+    edges.sort((a, b) => b.weight - a.weight);
+    // Build nodes with centrality (simple degree-normalized)
+    const degree = new Map();
+    for (const e of edges) {
+        degree.set(e.authorA, (degree.get(e.authorA) ?? 0) + e.weight);
+        degree.set(e.authorB, (degree.get(e.authorB) ?? 0) + e.weight);
+    }
+    const maxDeg = Math.max(0, ...degree.values());
+    const nodes = eligible.map((author) => ({
+        author,
+        commits: authorCommits.get(author).length,
+        collaborators: edges.filter((e) => e.authorA === author || e.authorB === author).length,
+        centrality: maxDeg === 0 ? 0 : Number(((degree.get(author) ?? 0) / maxDeg).toFixed(3)),
+    }));
+    nodes.sort((a, b) => b.centrality - a.centrality);
+    // Detect silos via connected components on the (filtered) graph
+    const silos = detectSilos(eligible, edges);
+    // Bridges: authors with edges to ≥ 2 silos
+    const bridges = detectBridges(eligible, edges, silos);
+    return {
+        windowCommits: sorted.length,
+        nodes,
+        edges,
+        silos,
+        bridges,
+    };
+}
+function tokenizeSet(text) {
+    const out = new Set();
+    for (const t of text
+        .toLowerCase()
+        .replace(/[^a-z0-9_/.-]+/g, " ")
+        .split(/\s+/)) {
+        if (!t || t.length < 3)
+            continue;
+        if (STOPWORDS.has(t))
+            continue;
+        out.add(t);
+    }
+    return out;
+}
+function jaccard(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 1;
+    let inter = 0;
+    for (const x of a)
+        if (b.has(x))
+            inter++;
+    const union = a.size + b.size - inter;
+    return union === 0 ? 0 : inter / union;
+}
+function computeCoTime(a, b, windowMs) {
+    if (a.length === 0 || b.length === 0)
+        return 0;
+    // For each commit in a, count if any commit in b is within window
+    const bTimes = b.map((c) => new Date(c.authorDate).getTime()).sort((x, y) => x - y);
+    let hits = 0;
+    for (const ca of a) {
+        const t = new Date(ca.authorDate).getTime();
+        // binary search for any time within [t - window, t + window]
+        const target = t;
+        let lo = 0, hi = bTimes.length - 1;
+        while (lo <= hi) {
+            const mid = (lo + hi) >> 1;
+            const v = bTimes[mid];
+            if (Math.abs(v - target) <= windowMs) {
+                hits++;
+                break;
+            }
+            if (v < target)
+                lo = mid + 1;
+            else
+                hi = mid - 1;
+        }
+    }
+    return hits / a.length;
+}
+function detectSilos(authors, edges) {
+    // Union-find over authors
+    const parent = new Map();
+    const find = (x) => {
+        let p = parent.get(x) ?? x;
+        while (p !== x) {
+            const grand = parent.get(p) ?? p;
+            parent.set(x, grand);
+            x = grand;
+            p = parent.get(x) ?? x;
+        }
+        return x;
+    };
+    const union = (a, b) => {
+        const ra = find(a), rb = find(b);
+        if (ra !== rb)
+            parent.set(ra, rb);
+    };
+    for (const a of authors)
+        parent.set(a, a);
+    // Only edges with weight ≥ 0.15 join
+    const joinFloor = 0.15;
+    for (const e of edges) {
+        if (e.weight >= joinFloor)
+            union(e.authorA, e.authorB);
+    }
+    const groups = new Map();
+    for (const a of authors) {
+        const r = find(a);
+        if (!groups.has(r))
+            groups.set(r, []);
+        groups.get(r).push(a);
+    }
+    return [...groups.values()].filter((g) => g.length >= 2);
+}
+function detectBridges(authors, edges, silos) {
+    if (silos.length < 2)
+        return [];
+    // For each author, count how many silos they have weak (<0.15) cross-edges to
+    const siloOf = new Map();
+    for (let i = 0; i < silos.length; i++) {
+        for (const a of silos[i])
+            siloOf.set(a, i);
+    }
+    const otherSilosByAuthor = new Map();
+    for (const e of edges) {
+        if (e.weight >= 0.15)
+            continue; // only weak/cross-cluster edges
+        const sa = siloOf.get(e.authorA);
+        const sb = siloOf.get(e.authorB);
+        if (sa === undefined || sb === undefined)
+            continue;
+        if (sa === sb)
+            continue;
+        let setA = otherSilosByAuthor.get(e.authorA);
+        if (!setA) {
+            setA = new Set();
+            otherSilosByAuthor.set(e.authorA, setA);
+        }
+        setA.add(sb);
+        let setB = otherSilosByAuthor.get(e.authorB);
+        if (!setB) {
+            setB = new Set();
+            otherSilosByAuthor.set(e.authorB, setB);
+        }
+        setB.add(sa);
+    }
+    return [...otherSilosByAuthor.entries()]
+        .filter(([, silosSet]) => silosSet.size >= 2)
+        .map(([a]) => a);
+}
+//# sourceMappingURL=network.js.map

package/dist/insights/network.js.map

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

package/dist/insights/network.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=network.test.d.ts.map

package/dist/insights/network.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.test.d.ts","sourceRoot":"","sources":["../../src/insights/network.test.ts"],"names":[],"mappings":""}

package/dist/insights/network.test.js

@@ -0,0 +1,100 @@
+import { describe, it, expect } from "vitest";
+import { buildNetwork } from "./network.js";
+function mk(p) {
+    return {
+        hash: p.hash,
+        shortHash: p.hash.slice(0, 7),
+        authorName: p.author,
+        authorEmail: p.author.toLowerCase() + "@x.com",
+        authorDate: p.date,
+        committerDate: p.date,
+        subject: p.subject,
+        body: "",
+        files: p.files ?? [],
+        parents: [],
+    };
+}
+describe("buildNetwork", () => {
+    it("returns empty for empty input", () => {
+        const n = buildNetwork([]);
+        expect(n.nodes).toHaveLength(0);
+        expect(n.edges).toHaveLength(0);
+        expect(n.silos).toHaveLength(0);
+    });
+    it("filters out authors below minAuthorCommits", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2024-01-01", subject: "x", author: "Alice", files: ["a.ts"] }),
+            mk({ hash: "b1", date: "2024-01-02", subject: "x", author: "Bob", files: ["b.ts"] }),
+        ];
+        const n = buildNetwork(commits, { minAuthorCommits: 3 });
+        expect(n.nodes).toHaveLength(0);
+    });
+    it("creates an edge between authors who touched the same files", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2024-01-01", subject: "auth work", author: "Alice", files: ["src/auth.ts"] }),
+            mk({ hash: "a2", date: "2024-01-02", subject: "auth work", author: "Alice", files: ["src/auth.ts"] }),
+            mk({ hash: "b1", date: "2024-01-03", subject: "auth fix", author: "Bob", files: ["src/auth.ts"] }),
+            mk({ hash: "b2", date: "2024-01-04", subject: "auth tweak", author: "Bob", files: ["src/auth.ts"] }),
+        ];
+        const n = buildNetwork(commits, { minAuthorCommits: 2 });
+        const edge = n.edges.find((e) => (e.authorA === "Alice" && e.authorB === "Bob") || (e.authorA === "Bob" && e.authorB === "Alice"));
+        expect(edge).toBeDefined();
+        expect(edge.axes.coEdit).toBeGreaterThan(0);
+    });
+    it("co-topic axis fires when authors share commit vocabulary", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2024-01-01", subject: "rewrite payment processor", author: "Alice", files: ["a.ts"] }),
+            mk({ hash: "a2", date: "2024-01-02", subject: "rewrite payment validation", author: "Alice", files: ["b.ts"] }),
+            mk({ hash: "b1", date: "2024-01-03", subject: "rewrite payment retry", author: "Bob", files: ["c.ts"] }),
+            mk({ hash: "b2", date: "2024-01-04", subject: "rewrite payment receipts", author: "Bob", files: ["d.ts"] }),
+        ];
+        const n = buildNetwork(commits, { minAuthorCommits: 2, minEdgeWeight: 0 });
+        const edge = n.edges[0];
+        expect(edge).toBeDefined();
+        expect(edge.axes.coTopic).toBeGreaterThan(0);
+        expect(edge.sharedTerms).toContain("payment");
+    });
+    it("centrality is highest for the most-connected author", () => {
+        const commits = [
+            // Alice connected to both Bob and Carol via shared files
+            mk({ hash: "a1", date: "2024-01-01", subject: "x", author: "Alice", files: ["src/x.ts", "src/y.ts"] }),
+            mk({ hash: "a2", date: "2024-01-02", subject: "x", author: "Alice", files: ["src/x.ts", "src/y.ts"] }),
+            mk({ hash: "b1", date: "2024-01-03", subject: "x", author: "Bob", files: ["src/x.ts"] }),
+            mk({ hash: "b2", date: "2024-01-04", subject: "x", author: "Bob", files: ["src/x.ts"] }),
+            mk({ hash: "c1", date: "2024-01-05", subject: "x", author: "Carol", files: ["src/y.ts"] }),
+            mk({ hash: "c2", date: "2024-01-06", subject: "x", author: "Carol", files: ["src/y.ts"] }),
+        ];
+        const n = buildNetwork(commits, { minAuthorCommits: 2, minEdgeWeight: 0 });
+        expect(n.nodes[0].author).toBe("Alice");
+        expect(n.nodes[0].centrality).toBeGreaterThanOrEqual(n.nodes[1].centrality);
+    });
+    it("detects silos when groups have no inter-group edges above threshold", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2024-01-01", subject: "auth", author: "Alice", files: ["src/auth/x.ts"] }),
+            mk({ hash: "a2", date: "2024-01-02", subject: "auth", author: "Alice", files: ["src/auth/x.ts"] }),
+            mk({ hash: "b1", date: "2024-01-01", subject: "auth", author: "Bob", files: ["src/auth/x.ts"] }),
+            mk({ hash: "b2", date: "2024-01-02", subject: "auth", author: "Bob", files: ["src/auth/x.ts"] }),
+            mk({ hash: "c1", date: "2024-01-01", subject: "payments", author: "Carol", files: ["src/pay/y.ts"] }),
+            mk({ hash: "c2", date: "2024-01-02", subject: "payments", author: "Carol", files: ["src/pay/y.ts"] }),
+            mk({ hash: "d1", date: "2024-01-01", subject: "payments", author: "Dave", files: ["src/pay/y.ts"] }),
+            mk({ hash: "d2", date: "2024-01-02", subject: "payments", author: "Dave", files: ["src/pay/y.ts"] }),
+        ];
+        const n = buildNetwork(commits, { minAuthorCommits: 2 });
+        expect(n.silos.length).toBeGreaterThanOrEqual(1);
+    });
+    it("edges sorted by weight descending", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2024-01-01", subject: "auth", author: "Alice", files: ["x.ts"] }),
+            mk({ hash: "a2", date: "2024-01-02", subject: "auth", author: "Alice", files: ["x.ts"] }),
+            mk({ hash: "b1", date: "2024-01-03", subject: "auth", author: "Bob", files: ["x.ts"] }),
+            mk({ hash: "b2", date: "2024-01-04", subject: "auth", author: "Bob", files: ["x.ts"] }),
+            mk({ hash: "c1", date: "2024-01-05", subject: "different", author: "Carol", files: ["y.ts"] }),
+            mk({ hash: "c2", date: "2024-01-06", subject: "different", author: "Carol", files: ["y.ts"] }),
+        ];
+        const n = buildNetwork(commits, { minAuthorCommits: 2, minEdgeWeight: 0 });
+        for (let i = 1; i < n.edges.length; i++) {
+            expect(n.edges[i - 1].weight).toBeGreaterThanOrEqual(n.edges[i].weight);
+        }
+    });
+});
+//# sourceMappingURL=network.test.js.map

package/dist/insights/network.test.js.map

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

package/dist/retrieve/hallucination-guard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hallucination-guard.test.d.ts.map

package/dist/retrieve/hallucination-guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hallucination-guard.test.d.ts","sourceRoot":"","sources":["../../src/retrieve/hallucination-guard.test.ts"],"names":[],"mappings":""}

package/dist/retrieve/hallucination-guard.test.js

@@ -0,0 +1,130 @@
+import { describe, it, expect } from "vitest";
+import { findUnverifiedCitations, synthesize } from "./synthesize.js";
+function mkResult(hash, subject = "init") {
+    return {
+        commit: {
+            hash,
+            shortHash: hash.slice(0, 7),
+            authorName: "Alice",
+            authorEmail: "a@x.com",
+            authorDate: "2024-01-01",
+            committerDate: "2024-01-01",
+            subject,
+            body: "",
+            files: [],
+            parents: [],
+        },
+        score: 0.05,
+        matchedChunks: [],
+    };
+}
+describe("findUnverifiedCitations", () => {
+    it("returns empty when answer cites only evidence hashes", () => {
+        const evidence = ["abc1234567890abc", "def9876543210def"];
+        const answer = "Because of `abc1234`, see also `def9876`.";
+        expect(findUnverifiedCitations(answer, evidence)).toEqual([]);
+    });
+    it("flags hashes that don't match any evidence", () => {
+        const evidence = ["abc1234567890abc"];
+        const answer = "Because of `abc1234`, also `bad9999`.";
+        const unverified = findUnverifiedCitations(answer, evidence);
+        expect(unverified).toContain("bad9999");
+        expect(unverified).not.toContain("abc1234");
+    });
+    it("matches by prefix — short hash in answer + long hash in evidence", () => {
+        const evidence = ["abc1234567890abcdef0000000000000000000000"];
+        const answer = "See `abc1234`.";
+        expect(findUnverifiedCitations(answer, evidence)).toEqual([]);
+    });
+    it("matches by prefix in either direction", () => {
+        // Long hash in answer, short hash prefix in evidence
+        const evidence = ["abc1234"];
+        const answer = "See `abc1234567890`.";
+        expect(findUnverifiedCitations(answer, evidence)).toEqual([]);
+    });
+    it("deduplicates repeated mentions", () => {
+        const evidence = ["abc1234"];
+        const answer = "See `bad9999`. Yes, `bad9999` again. And once more `bad9999`.";
+        expect(findUnverifiedCitations(answer, evidence)).toEqual(["bad9999"]);
+    });
+    it("ignores backtick tokens that aren't hex (e.g. `mneme_ask`)", () => {
+        const evidence = ["abc1234"];
+        const answer = "Use `mneme_ask` and `npm install` — see `abc1234`.";
+        expect(findUnverifiedCitations(answer, evidence)).toEqual([]);
+    });
+    it("is case-insensitive", () => {
+        const evidence = ["ABC1234"];
+        const answer = "See `abc1234`.";
+        expect(findUnverifiedCitations(answer, evidence)).toEqual([]);
+    });
+});
+describe("synthesize — audit mode", () => {
+    it("refuses below confidence floor in audit mode", async () => {
+        const out = await synthesize("why does X exist?", [mkResult("abc1234")], "low", undefined, { auditMode: true, auditFloor: "medium" });
+        expect(out.source).toBe("audit-refused");
+        expect(out.trustScore).toBe(0);
+        expect(out.answer).toContain("Audit mode refused");
+    });
+    it("does NOT refuse when confidence meets floor", async () => {
+        const out = await synthesize("why does X exist?", [mkResult("abc1234")], "high", undefined, { auditMode: true, auditFloor: "medium" });
+        expect(out.source).toBe("extractive");
+        expect(out.trustScore).toBeGreaterThan(0);
+    });
+    it("refuses when LLM cites unverified hashes in audit mode", async () => {
+        const enricher = {
+            name: "fake",
+            enrich: async () => ({
+                text: "Because of `bad9999` and `cafebabe`. Real reason `abc1234`.",
+            }),
+        };
+        const out = await synthesize("why does X exist?", [mkResult("abc1234567890abc")], "high", enricher, { auditMode: true });
+        expect(out.source).toBe("audit-refused");
+        expect(out.unverifiedCitations).toEqual(expect.arrayContaining(["bad9999", "cafebabe"]));
+    });
+    it("returns LLM answer (with unverified flagged) when audit mode is OFF", async () => {
+        const enricher = {
+            name: "fake",
+            enrich: async () => ({
+                text: "Real reason `abc1234`. Also `bad9999`.",
+            }),
+        };
+        const out = await synthesize("why does X exist?", [mkResult("abc1234567890abc")], "high", enricher);
+        expect(out.source).toBe("llm");
+        expect(out.unverifiedCitations).toContain("bad9999");
+        expect(out.trustScore).toBeLessThan(0.95);
+    });
+});
+describe("synthesize — trust score", () => {
+    it("trustScore is 0 for no-context", async () => {
+        const out = await synthesize("vague", [], "none");
+        expect(out.trustScore).toBe(0);
+    });
+    it("extractive trustScore depends on confidence", async () => {
+        const high = await synthesize("q", [mkResult("abc1234")], "high");
+        const med = await synthesize("q", [mkResult("abc1234")], "medium");
+        const low = await synthesize("q", [mkResult("abc1234")], "low");
+        expect(high.trustScore).toBeGreaterThan(med.trustScore);
+        expect(med.trustScore).toBeGreaterThan(low.trustScore);
+    });
+    it("LLM with verified citations has higher trust than extractive", async () => {
+        const enricher = {
+            name: "fake",
+            enrich: async () => ({ text: "See `abc1234`." }),
+        };
+        const llm = await synthesize("q", [mkResult("abc1234567890abc")], "high", enricher);
+        const ext = await synthesize("q", [mkResult("abc1234567890abc")], "high");
+        expect(llm.trustScore).toBeGreaterThan(ext.trustScore);
+        expect(llm.unverifiedCitations).toEqual([]);
+    });
+    it("LLM with unverified citations has reduced trust", async () => {
+        const enricher = {
+            name: "fake",
+            enrich: async () => ({ text: "See `abc1234` and `bad9999` and `cafebabe`." }),
+        };
+        const out = await synthesize("q", [mkResult("abc1234567890abc")], "high", enricher);
+        expect(out.unverifiedCitations.length).toBeGreaterThanOrEqual(2);
+        // Should be penalized
+        expect(out.trustScore).toBeLessThan(0.7);
+    });
+});
+//# sourceMappingURL=hallucination-guard.test.js.map

package/dist/retrieve/hallucination-guard.test.js.map

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

package/dist/retrieve/synthesize.d.ts

@@ -35,14 +35,44 @@ export interface SynthesizedAnswer {
     /** The paragraph the user reads at the top of `mneme ask` output. */
     answer: string;
     /** Provenance: where the answer came from. */
-    source: "llm" | "extractive" | "no-context";
+    source: "llm" | "extractive" | "no-context" | "audit-refused";
     /** The same confidence label that was passed in (echoed for caller convenience). */
     confidence: ConfidenceLabel;
     /** Hashes of the commits the answer is grounded in. */
     evidenceCommitHashes: string[];
+    /**
+     * Hallucination guard — list of inline backtick-hashes the LLM cited that
+     * are NOT present in the retrieved evidence. Empty array means audit-clean.
+     */
+    unverifiedCitations: string[];
+    /**
+     * Trust score 0..1 — combines confidence label + citation validity.
+     *   - "audit-refused" → 0
+     *   - "no-context" → 0
+     *   - extractive → 0.5–0.7 (no LLM risk)
+     *   - LLM clean (no unverified citations) → 0.8–1.0
+     *   - LLM with unverified citations → < 0.5 (risk of hallucination)
+     */
+    trustScore: number;
     /** Per-call latency for telemetry / "how slow is this?" calibration. */
     durationMs: number;
 }
+/** Options for the synthesizer. */
+export interface SynthesizeOptions {
+    /** Top-K to ground the answer in (default 5). */
+    maxResults?: number;
+    /**
+     * Audit mode — refuse to answer below a confidence floor instead of
+     * returning best-effort prose. Use this when the consumer is an audit
+     * surface (CI gate, MCP tool result, security review).
+     */
+    auditMode?: boolean;
+    /**
+     * Minimum confidence label that audit mode allows. Defaults to "medium".
+     * Anything below is refused with a "audit-refused" source.
+     */
+    auditFloor?: ConfidenceLabel;
+}
 /**
  * Synthesize an answer from retrieval results.
  *
@@ -53,5 +83,11 @@ export interface SynthesizedAnswer {
  * @param enricher — optional. If undefined or fails, we fall back to extractive.
  * @param maxResults — how many top results to ground the answer in (default 5).
  */
-export declare function synthesize(question: string, results: SearchResult[], confidence: ConfidenceLabel, enricher?: SynthesisEnricher, maxResults?: number): Promise<SynthesizedAnswer>;
+export declare function synthesize(question: string, results: SearchResult[], confidence: ConfidenceLabel, enricher?: SynthesisEnricher, optsOrMax?: number | SynthesizeOptions): Promise<SynthesizedAnswer>;
+/**
+ * Extract every backtick-quoted token from the answer that LOOKS like a
+ * commit hash (≥4 hex chars), then return the subset that is NOT present
+ * (as prefix) in any evidence hash. These are candidate hallucinations.
+ */
+export declare function findUnverifiedCitations(answer: string, evidenceHashes: string[]): string[];
 //# sourceMappingURL=synthesize.d.ts.map

package/dist/retrieve/synthesize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../src/retrieve/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,YAAY,CAAC;IAC5C,oFAAoF;IACpF,UAAU,EAAE,eAAe,CAAC;IAC5B,uDAAuD;IACvD,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACpB;AAmBD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,UAAU,EAAE,eAAe,EAC3B,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC,iBAAiB,CAAC,CAoD5B"}
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../src/retrieve/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,YAAY,GAAG,eAAe,CAAC;IAC9D,oFAAoF;IACpF,UAAU,EAAE,eAAe,CAAC;IAC5B,uDAAuD;IACvD,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B;;;OAGG;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAmBD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,UAAU,EAAE,eAAe,EAC3B,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,SAAS,GAAE,MAAM,GAAG,iBAAqB,GACxC,OAAO,CAAC,iBAAiB,CAAC,CAiH5B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAaV"}