@mneme-ai/core 1.98.0 → 2.0.0

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.98.0",
+  "version": "2.0.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",