@mneme-ai/core 1.99.0 → 2.0.0

package/dist/prophecy/index.js

@@ -0,0 +1,94 @@
+/**
+ * v2.0.0 -- PROPHECY LETTERS · time-locked cross-version messages
+ *
+ * Mneme v2.0 writes a letter to its future self (or to a different
+ * machine running a different Mneme version). The letter is sealed
+ * with the user's HMAC secret + a target-version gate. When a future
+ * Mneme version that meets the gate opens the letter, it can grade
+ * its past self's predictions:
+ *
+ *   "Past Mneme (v2.0, 2026-05-13) predicted: 'by v2.5 we'll have
+ *    real IBM Quantum wiring.' Current Mneme (v2.5, 2026-09-01) checks
+ *    its own state: TRUE. Time-consistency score updated."
+ *
+ * Pure function. Deterministic. Composable with PASSPORT + audit log.
+ */
+import { createHmac, createHash } from "node:crypto";
+function fpSecret(secret) {
+    return createHash("sha256").update(secret).digest("hex").slice(0, 16);
+}
+function computeSig(p, secret) {
+    const h = createHmac("sha256", secret);
+    h.update([p.fromVersion, p.toMinVersion, p.sealedAt, p.earliestOpenAt, p.text, JSON.stringify(p.predictions)].join("|"));
+    return h.digest("hex");
+}
+export function sealProphecy(input) {
+    const sealedAt = Date.now();
+    const earliestOpenAt = input.earliestOpenAt ?? sealedAt + 30 * 24 * 60 * 60 * 1000;
+    const base = {
+        fromVersion: input.fromVersion,
+        toMinVersion: input.toMinVersion,
+        sealedAt,
+        earliestOpenAt,
+        text: input.text,
+        predictions: input.predictions,
+    };
+    const signature = computeSig(base, input.secret);
+    const id = createHash("sha256").update(`${input.fromVersion}|${sealedAt}|${signature.slice(0, 16)}`).digest("hex").slice(0, 12);
+    return { id, ...base, signature, keyFingerprint: fpSecret(input.secret) };
+}
+function semverGe(a, b) {
+    const pa = a.split(".").map((n) => parseInt(n, 10));
+    const pb = b.split(".").map((n) => parseInt(n, 10));
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const ai = pa[i] ?? 0;
+        const bi = pb[i] ?? 0;
+        if (ai > bi)
+            return true;
+        if (ai < bi)
+            return false;
+    }
+    return true;
+}
+export function unsealProphecy(input) {
+    const now = input.now ?? Date.now();
+    if (fpSecret(input.secret) !== input.prophecy.keyFingerprint) {
+        return { verdict: "WRONG_KEY", reason: `secret fingerprint mismatch` };
+    }
+    if (!semverGe(input.currentVersion, input.prophecy.toMinVersion)) {
+        return { verdict: "SEALED", reason: `current version ${input.currentVersion} < required ${input.prophecy.toMinVersion}` };
+    }
+    if (now < input.prophecy.earliestOpenAt) {
+        return { verdict: "SEALED", reason: `time-lock not expired (open at ${new Date(input.prophecy.earliestOpenAt).toISOString()})` };
+    }
+    const { signature: _drop, id: _drop2, keyFingerprint: _drop3, ...rest } = input.prophecy;
+    void _drop;
+    void _drop2;
+    void _drop3;
+    const expected = computeSig(rest, input.secret);
+    if (expected !== input.prophecy.signature) {
+        return { verdict: "TAMPERED", reason: `signature mismatch` };
+    }
+    return { verdict: "OPENABLE", reason: "all checks pass", prophecy: input.prophecy };
+}
+export function gradeProphecy(input) {
+    const obsByTopic = new Map();
+    for (const o of input.observations)
+        obsByTopic.set(o.topic, o.cameTrue);
+    const byTopic = input.prophecy.predictions.map((p) => ({
+        topic: p.topic,
+        predicted: p.claim,
+        cameTrue: obsByTopic.get(p.topic) ?? false,
+    }));
+    const correct = byTopic.filter((b) => b.cameTrue).length;
+    return {
+        total: byTopic.length,
+        correct,
+        consistency: byTopic.length > 0 ? correct / byTopic.length : 0,
+        byTopic,
+    };
+}
+export function formatProphecyPulseLine(p) {
+    return `PROPHECY · ${p.id} · ${p.fromVersion}→${p.toMinVersion} · ${p.predictions.length} predictions`;
+}
+//# sourceMappingURL=index.js.map

package/dist/prophecy/index.js.map

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

package/dist/prophecy/prophecy.test.d.ts

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

package/dist/prophecy/prophecy.test.d.ts.map

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

package/dist/prophecy/prophecy.test.js

@@ -0,0 +1,112 @@
+import { describe, it, expect } from "vitest";
+import { randomBytes } from "node:crypto";
+import { sealProphecy, unsealProphecy, gradeProphecy, formatProphecyPulseLine } from "./index.js";
+describe("v2.0 PROPHECY LETTERS · time-locked cross-version", () => {
+    const secret = randomBytes(32);
+    it("seal returns envelope with id + signature + keyFingerprint", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.5.0",
+            text: "By v2.5 we'll have IBM Quantum wired.",
+            predictions: [{ topic: "ibm-quantum", claim: "wired by v2.5", verifyHint: "check qx_bridge providers.ts for runIbm impl" }],
+            secret,
+        });
+        expect(p.id).toMatch(/^[a-f0-9]{12}$/);
+        expect(p.signature.length).toBe(64);
+        expect(p.keyFingerprint).toBeTruthy();
+    });
+    it("SEALED verdict when current version < required", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.5.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000, // time-lock already past
+        });
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.0.0", secret });
+        expect(r.verdict).toBe("SEALED");
+        expect(r.reason).toContain("version");
+    });
+    it("SEALED verdict when time-lock not yet expired", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() + 1000 * 60 * 60,
+        });
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret });
+        expect(r.verdict).toBe("SEALED");
+        expect(r.reason).toContain("time-lock");
+    });
+    it("OPENABLE verdict when version AND time gate pass + signature valid", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000,
+        });
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret });
+        expect(r.verdict).toBe("OPENABLE");
+        expect(r.prophecy).toBeDefined();
+    });
+    it("TAMPERED verdict when signature was forged", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000,
+        });
+        p.signature = "0".repeat(64);
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret });
+        expect(r.verdict).toBe("TAMPERED");
+    });
+    it("WRONG_KEY verdict on wrong secret", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000,
+        });
+        const wrong = randomBytes(32);
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret: wrong });
+        expect(r.verdict).toBe("WRONG_KEY");
+    });
+    it("gradeProphecy computes consistency 0..1", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.5.0",
+            text: "x",
+            predictions: [
+                { topic: "ibm-quantum", claim: "wired", verifyHint: "" },
+                { topic: "dwave-qubo", claim: "wired", verifyHint: "" },
+                { topic: "ggwave-audio", claim: "shipped", verifyHint: "" },
+            ],
+            secret,
+        });
+        const r = gradeProphecy({
+            prophecy: p,
+            observations: [
+                { topic: "ibm-quantum", cameTrue: true },
+                { topic: "dwave-qubo", cameTrue: false },
+                { topic: "ggwave-audio", cameTrue: true },
+            ],
+        });
+        expect(r.total).toBe(3);
+        expect(r.correct).toBe(2);
+        expect(r.consistency).toBeCloseTo(2 / 3, 3);
+    });
+    it("formatProphecyPulseLine produces compact summary", () => {
+        const p = sealProphecy({ fromVersion: "2.0.0", toMinVersion: "2.5.0", text: "x", predictions: [], secret });
+        expect(formatProphecyPulseLine(p)).toContain("PROPHECY");
+    });
+});
+//# sourceMappingURL=prophecy.test.js.map

package/dist/prophecy/prophecy.test.js.map

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

package/dist/xray/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * v2.0.0 -- X-RAY of AI's own reasoning
+ *
+ * AI answers with confident prose. User believes it. But the prose
+ * itself often contains TELLS: hedge density, absolute claims without
+ * citation, contradictions, hand-waving. X-RAY scans the AI's reply
+ * BEFORE the user sees it and reports the structural confidence.
+ *
+ * Output is composable with FLASH (v1.99): X-RAY = surface-text audit,
+ * FLASH = source-grounded audit. Together = double check.
+ *
+ * Pure function. Regex-only. No LLM in the hot path.
+ */
+export interface XrayResult {
+    /** Token estimate of the response. */
+    tokens: number;
+    /** Hedge phrases (maybe, possibly, I think, ...). */
+    hedges: string[];
+    hedgeRatio: number;
+    /** Absolute phrases (always, never, definitely, ...). */
+    absolutes: string[];
+    absoluteRatio: number;
+    /** Citation candidates (commit SHAs, file paths, URLs). */
+    citations: string[];
+    citationDensity: number;
+    /** Pairs of phrases that contradict each other within the same reply. */
+    contradictions: Array<{
+        a: string;
+        b: string;
+    }>;
+    /** Long-prose-no-citation streaks (potential hand-waving). */
+    handWaveStreaks: number;
+    /** Final structural confidence 0..1. */
+    structuralConfidence: number;
+    /** Verdict bucket. */
+    verdict: "HIGH" | "MIXED" | "LOW" | "WEAK";
+    /** Top weak spots to highlight. */
+    weakSpots: string[];
+}
+/** Run the X-ray scan on an AI's response text. Returns structural
+ *  confidence + weak spots. */
+export declare function xrayResponse(text: string): XrayResult;
+export declare function formatXrayPulseLine(r: XrayResult): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/xray/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xray/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,cAAc,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3C,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAkDD;+BAC+B;AAC/B,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAsErD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEzD"}

package/dist/xray/index.js

@@ -0,0 +1,139 @@
+/**
+ * v2.0.0 -- X-RAY of AI's own reasoning
+ *
+ * AI answers with confident prose. User believes it. But the prose
+ * itself often contains TELLS: hedge density, absolute claims without
+ * citation, contradictions, hand-waving. X-RAY scans the AI's reply
+ * BEFORE the user sees it and reports the structural confidence.
+ *
+ * Output is composable with FLASH (v1.99): X-RAY = surface-text audit,
+ * FLASH = source-grounded audit. Together = double check.
+ *
+ * Pure function. Regex-only. No LLM in the hot path.
+ */
+const HEDGE_PATTERNS = [
+    /\bmaybe\b/gi, /\bperhaps\b/gi, /\bpossibly\b/gi, /\bpotentially\b/gi,
+    /\bI think\b/gi, /\bI believe\b/gi, /\bI guess\b/gi, /\bseem(s?|ed)\b/gi,
+    /\b(might|may|could)\b/gi, /\bappears? to\b/gi, /\barguably\b/gi,
+    /\bsort of\b/gi, /\bkind of\b/gi, /\bgenerally\b/gi, /\btypically\b/gi,
+];
+const ABSOLUTE_PATTERNS = [
+    /\balways\b/gi, /\bnever\b/gi, /\bdefinitely\b/gi, /\bcertainly\b/gi,
+    /\babsolutely\b/gi, /\bguaranteed\b/gi, /\bimpossible\b/gi,
+    /\bcompletely\b/gi, /\bentirely\b/gi, /\bperfectly\b/gi,
+    /\bno (way|doubt)\b/gi, /\b100\s*%\b/gi,
+];
+const CITATION_PATTERNS = [
+    /\bcommit\s+[a-f0-9]{7,40}\b/gi,
+    /\b[a-f0-9]{7,12}\b/g, // bare SHAs
+    /\b[A-Za-z0-9_./-]+\.(ts|tsx|js|jsx|py|go|rs|java|md|json|yaml|yml|toml|sh)\b/g,
+    /https?:\/\/[^\s)]+/g,
+    /\bPR\s*#\d+\b/gi,
+    /\bissue\s*#\d+\b/gi,
+];
+const CONTRADICTION_PAIRS = [
+    [/\bsafe\b/i, /\bunsafe\b/i],
+    [/\brecommend\b/i, /\bdiscourage\b/i],
+    [/\balways\b/i, /\bnever\b/i],
+    [/\bsupports?\b/i, /\bdoes not support\b/i],
+    [/\brequires?\b/i, /\bdoes not require\b/i],
+    [/\bworks?\b/i, /\bdoes not work\b/i],
+    [/\bavailable\b/i, /\bunavailable\b/i],
+];
+function sentencesOf(text) {
+    return text.split(/(?<=[.!?])\s+/).filter((s) => s.trim().length > 0);
+}
+function findAll(text, patterns) {
+    const out = [];
+    for (const p of patterns) {
+        // Reset stateful regex
+        const re = new RegExp(p.source, p.flags);
+        const m = text.match(re);
+        if (m)
+            for (const hit of m)
+                out.push(hit);
+    }
+    return out;
+}
+/** Run the X-ray scan on an AI's response text. Returns structural
+ *  confidence + weak spots. */
+export function xrayResponse(text) {
+    const tokens = Math.ceil(text.length / 3.5);
+    const sentences = sentencesOf(text);
+    const sentenceCount = Math.max(1, sentences.length);
+    const hedges = findAll(text, HEDGE_PATTERNS);
+    const absolutes = findAll(text, ABSOLUTE_PATTERNS);
+    const citations = findAll(text, CITATION_PATTERNS);
+    const hedgeRatio = hedges.length / sentenceCount;
+    const absoluteRatio = absolutes.length / sentenceCount;
+    const citationDensity = (citations.length / Math.max(1, tokens)) * 100;
+    // Find contradictions: scan sentence pairs
+    const contradictions = [];
+    for (let i = 0; i < sentences.length; i++) {
+        for (let j = i + 1; j < sentences.length; j++) {
+            for (const [a, b] of CONTRADICTION_PAIRS) {
+                if (a.test(sentences[i]) && b.test(sentences[j])) {
+                    contradictions.push({ a: sentences[i].slice(0, 80), b: sentences[j].slice(0, 80) });
+                }
+            }
+        }
+    }
+    // Hand-wave streaks: count sentences with NO citation
+    let handWaveStreak = 0;
+    let maxHandWave = 0;
+    for (const s of sentences) {
+        const hasCitation = CITATION_PATTERNS.some((p) => new RegExp(p.source, p.flags).test(s));
+        if (hasCitation)
+            handWaveStreak = 0;
+        else {
+            handWaveStreak++;
+            maxHandWave = Math.max(maxHandWave, handWaveStreak);
+        }
+    }
+    // Score: start at 1.0, subtract for weak signals
+    let confidence = 1.0;
+    confidence -= Math.min(0.30, hedgeRatio * 0.40); // hedges drop confidence (uncertainty)
+    confidence -= Math.min(0.30, absoluteRatio * 0.50); // absolutes WITHOUT citation are bad
+    confidence += Math.min(0.20, citationDensity / 10); // citations boost
+    confidence -= contradictions.length * 0.10;
+    confidence -= Math.min(0.20, Math.max(0, maxHandWave - 5) * 0.03);
+    confidence = Math.max(0, Math.min(1, confidence));
+    let verdict;
+    if (confidence >= 0.75)
+        verdict = "HIGH";
+    else if (confidence >= 0.50)
+        verdict = "MIXED";
+    else if (confidence >= 0.25)
+        verdict = "LOW";
+    else
+        verdict = "WEAK";
+    const weakSpots = [];
+    if (hedgeRatio > 0.30)
+        weakSpots.push(`high hedge density (${hedges.length} hedges / ${sentenceCount} sentences)`);
+    if (absoluteRatio > 0.15 && citationDensity < 1)
+        weakSpots.push(`${absolutes.length} absolute claim(s) without citation`);
+    if (contradictions.length > 0)
+        weakSpots.push(`${contradictions.length} contradiction pair(s) detected`);
+    if (maxHandWave > 5)
+        weakSpots.push(`${maxHandWave} consecutive sentences without any citation`);
+    if (citationDensity === 0 && tokens > 50)
+        weakSpots.push("zero citations across the entire response");
+    return {
+        tokens,
+        hedges,
+        hedgeRatio: Math.round(hedgeRatio * 1000) / 1000,
+        absolutes,
+        absoluteRatio: Math.round(absoluteRatio * 1000) / 1000,
+        citations,
+        citationDensity: Math.round(citationDensity * 100) / 100,
+        contradictions,
+        handWaveStreaks: maxHandWave,
+        structuralConfidence: Math.round(confidence * 1000) / 1000,
+        verdict,
+        weakSpots,
+    };
+}
+export function formatXrayPulseLine(r) {
+    return `X-RAY · ${r.verdict} · confidence=${r.structuralConfidence} · hedges=${r.hedges.length} absolutes=${r.absolutes.length} citations=${r.citations.length} contradictions=${r.contradictions.length}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/xray/index.js.map

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

package/dist/xray/xray.test.d.ts

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

package/dist/xray/xray.test.d.ts.map

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

package/dist/xray/xray.test.js

@@ -0,0 +1,57 @@
+import { describe, it, expect } from "vitest";
+import { xrayResponse, formatXrayPulseLine } from "./index.js";
+describe("v2.0 X-RAY · reasoning audit", () => {
+    it("detects hedge phrases", () => {
+        const r = xrayResponse("I think this might be the right answer. Perhaps you could try it.");
+        expect(r.hedges.length).toBeGreaterThanOrEqual(3);
+        expect(r.hedgeRatio).toBeGreaterThan(0);
+    });
+    it("detects absolutes", () => {
+        const r = xrayResponse("This is ALWAYS the case. Definitely. 100% guaranteed.");
+        expect(r.absolutes.length).toBeGreaterThanOrEqual(3);
+        expect(r.absoluteRatio).toBeGreaterThan(0);
+    });
+    it("detects citations (commit SHAs / file paths / URLs)", () => {
+        const r = xrayResponse("See commit a3f9b21 in packages/core/src/index.ts and the issue at https://github.com/x/y/issues/42.");
+        expect(r.citations.length).toBeGreaterThanOrEqual(2);
+        expect(r.citationDensity).toBeGreaterThan(0);
+    });
+    it("detects contradictions across sentences", () => {
+        const r = xrayResponse("This API is safe to use. The same API is actually unsafe in production.");
+        expect(r.contradictions.length).toBeGreaterThanOrEqual(1);
+    });
+    it("HIGH verdict on well-cited grounded response", () => {
+        const text = "Per commit a3f9b21 the JWT tolerance was set to 5 min. The file packages/auth/jwt.ts contains the validator. See PR #214 for the rollout plan.";
+        const r = xrayResponse(text);
+        expect(r.verdict).toBe("HIGH");
+        expect(r.structuralConfidence).toBeGreaterThanOrEqual(0.75);
+    });
+    it("LOW or WEAK verdict on hand-wavy hedge-heavy reply", () => {
+        const text = "I think this might generally work in most cases. Perhaps. Maybe. It could be the right approach. Possibly. Seems reasonable to me. Generally speaking. Arguably.";
+        const r = xrayResponse(text);
+        expect(["LOW", "WEAK", "MIXED"]).toContain(r.verdict);
+        expect(r.weakSpots.length).toBeGreaterThan(0);
+    });
+    it("flags absolute claims without citation", () => {
+        const r = xrayResponse("This is always the best approach. Never use the alternative. Definitely the right call.");
+        expect(r.weakSpots.some((w) => w.includes("absolute"))).toBe(true);
+    });
+    it("flags zero-citation responses over 50 tokens", () => {
+        const text = "Lorem ipsum dolor sit amet ".repeat(15); // ~75 tokens of nothing
+        const r = xrayResponse(text);
+        expect(r.weakSpots.some((w) => w.includes("zero citations"))).toBe(true);
+    });
+    it("structuralConfidence stays in 0..1", () => {
+        for (const text of ["", "a.", "the cat sat", "always never always"]) {
+            const r = xrayResponse(text);
+            expect(r.structuralConfidence).toBeGreaterThanOrEqual(0);
+            expect(r.structuralConfidence).toBeLessThanOrEqual(1);
+        }
+    });
+    it("formatXrayPulseLine produces compact summary", () => {
+        const r = xrayResponse("commit a3f9b21 explains why.");
+        expect(formatXrayPulseLine(r)).toContain("X-RAY");
+        expect(formatXrayPulseLine(r)).toContain("confidence=");
+    });
+});
+//# sourceMappingURL=xray.test.js.map

package/dist/xray/xray.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/core",
-  "version": "1.99.0",
+  "version": "2.0.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",