@mneme-ai/core 1.98.0 → 2.0.0

package/dist/flash/flash.test.js

@@ -0,0 +1,221 @@
+import { describe, it, expect } from "vitest";
+import { computeVeracity, templateForVerdict, formatVeracityPulseLine, generateRefutations, runDevilsAdvocate, formatDevilsAdvocatePulseLine, groundClaim, formatGroundingPulseLine, predictNextQuery, formatPredictionPulseLine, runFlash, DEFAULT_SOURCE_WEIGHT, } from "./index.js";
+// ============================================================
+// VERACITY
+// ============================================================
+describe("v1.99 FLASH · Veracity-Velocity Singularity", () => {
+    it("computes V_eff with strong evidence + low H → AFFIRM", () => {
+        const r = computeVeracity({
+            claim: "this PSA-10 Pikachu Illustrator card is genuinely rare",
+            evidence: [
+                { fact: "PSA pop report shows only 41 known copies", supportStrength: 0.95, sourceWeight: 0.95, sourceKind: "expert-database" },
+                { fact: "Goldin auction sold one for $5.3M (2024)", supportStrength: 0.95, sourceWeight: 0.95, sourceKind: "verified-third-party" },
+            ],
+            hallucinationFactor: 0,
+        });
+        expect(r.V_eff).toBeGreaterThanOrEqual(0.75);
+        expect(r.verdict).toBe("AFFIRM");
+    });
+    it("'Super rare' from seller listing alone → REFUTE", () => {
+        const r = computeVeracity({
+            claim: "this Capcom Trump card deck is super rare",
+            evidence: [
+                // Single piece of evidence: the seller's own listing
+                { fact: '"Super rare" printed in listing title', supportStrength: 0.8, sourceWeight: 0.20, sourceKind: "seller-listing" },
+            ],
+            hallucinationFactor: 2.0,
+            phi_qx: 2.0, // commerce-source paranoia
+        });
+        expect(r.V_eff).toBeLessThan(0.30);
+        expect(["DOUBTFUL", "REFUTE"]).toContain(r.verdict);
+    });
+    it("DEFAULT_SOURCE_WEIGHT: seller-listing < image-OCR < user-statement < expert-database < verified-third-party", () => {
+        expect(DEFAULT_SOURCE_WEIGHT["seller-listing"]).toBeLessThan(DEFAULT_SOURCE_WEIGHT["image-OCR"]);
+        expect(DEFAULT_SOURCE_WEIGHT["image-OCR"]).toBeLessThan(DEFAULT_SOURCE_WEIGHT["user-statement"]);
+        expect(DEFAULT_SOURCE_WEIGHT["user-statement"]).toBeLessThan(DEFAULT_SOURCE_WEIGHT["expert-database"]);
+        expect(DEFAULT_SOURCE_WEIGHT["expert-database"]).toBeLessThan(DEFAULT_SOURCE_WEIGHT["verified-third-party"]);
+    });
+    it("ln(H+e) is always >= 1 (no division by zero)", () => {
+        const r = computeVeracity({
+            claim: "x",
+            evidence: [{ fact: "y", supportStrength: 1, sourceWeight: 1, sourceKind: "verified-third-party" }],
+            hallucinationFactor: 0,
+        });
+        expect(r.hallucinationPenalty).toBeGreaterThanOrEqual(1);
+    });
+    it("Φ_qx multiplier scales V_eff", () => {
+        const base = computeVeracity({ claim: "x", evidence: [{ fact: "y", supportStrength: 0.5, sourceWeight: 0.5, sourceKind: "unknown" }], hallucinationFactor: 0 });
+        const skeptical = computeVeracity({ claim: "x", evidence: [{ fact: "y", supportStrength: 0.5, sourceWeight: 0.5, sourceKind: "unknown" }], hallucinationFactor: 0, phi_qx: 0.5 });
+        expect(skeptical.V_eff).toBeCloseTo(base.V_eff * 0.5, 5);
+    });
+    it("templateForVerdict produces vendor-appropriate response stems", () => {
+        expect(templateForVerdict("AFFIRM", "the card is rare")).toContain("Verified");
+        expect(templateForVerdict("CAUTIOUS", "the card is rare")).toContain("Partially supported");
+        expect(templateForVerdict("DOUBTFUL", "the card is rare")).toContain("Cannot confirm");
+        expect(templateForVerdict("REFUTE", "the card is rare")).toContain("Refuse to confirm");
+    });
+    it("formatVeracityPulseLine produces compact summary", () => {
+        const r = computeVeracity({ claim: "x", evidence: [{ fact: "y", supportStrength: 0.5, sourceWeight: 0.5, sourceKind: "unknown" }], hallucinationFactor: 0 });
+        const line = formatVeracityPulseLine(r);
+        expect(line).toContain("V_eff=");
+        expect(line).toContain("verdict=");
+    });
+});
+// ============================================================
+// DEVIL'S ADVOCATE
+// ============================================================
+describe("v1.99 FLASH · Recursive Self-Verification (Devil's Advocate)", () => {
+    it("generateRefutations emits negation, source-attack, specificity-flip, burden-shift, outlier", () => {
+        const r = generateRefutations("this item is super rare");
+        const kinds = new Set(r.map((c) => c.kind));
+        expect(kinds).toContain("negation");
+        expect(kinds).toContain("source-attack");
+        expect(kinds).toContain("specificity-flip");
+        expect(kinds).toContain("burden-shift");
+        expect(kinds).toContain("outlier");
+    });
+    it("downgrades AFFIRM → CAUTIOUS when refutation pressure > 0.10", () => {
+        const r = runDevilsAdvocate({
+            claim: "this trump card is super rare",
+            evidence: [
+                { fact: "listing says super rare", supportStrength: 0.7, sourceWeight: 0.20, sourceKind: "seller-listing" },
+            ],
+            hallucinationFactor: 1.5,
+            phi_qx: 1.0,
+        });
+        expect(r.refutations.length).toBeGreaterThan(0);
+        expect(r.topRefutation).not.toBeNull();
+        // Original was DOUBTFUL → after downgrade still in DOUBTFUL or REFUTE
+        expect(["DOUBTFUL", "REFUTE"]).toContain(r.finalVerdict);
+    });
+    it("preserves verdict when refutation pressure is < 0.10", () => {
+        const r = runDevilsAdvocate({
+            claim: "this PSA-10 card has 41 known copies",
+            evidence: [
+                { fact: "PSA pop report shows 41", supportStrength: 0.95, sourceWeight: 0.95, sourceKind: "expert-database" },
+                { fact: "Goldin auction sold one $5.3M", supportStrength: 0.9, sourceWeight: 0.95, sourceKind: "verified-third-party" },
+            ],
+            hallucinationFactor: 0,
+        });
+        expect(r.finalVerdict).toBe("AFFIRM");
+        expect(r.adjustmentReason).toMatch(/preserved|no refutation/i);
+    });
+    it("custom refutation generator can be injected (for tests)", () => {
+        const r = runDevilsAdvocate({
+            claim: "x",
+            evidence: [{ fact: "y", supportStrength: 0.5, sourceWeight: 0.5, sourceKind: "unknown" }],
+            hallucinationFactor: 0,
+            refutationGenerator: () => [{ text: "fake refutation", kind: "outlier" }],
+        });
+        expect(r.refutations.length).toBe(1);
+        expect(r.refutations[0].candidate.text).toBe("fake refutation");
+    });
+    it("formatDevilsAdvocatePulseLine produces compact summary", () => {
+        const r = runDevilsAdvocate({ claim: "x", evidence: [{ fact: "y", supportStrength: 0.5, sourceWeight: 0.5, sourceKind: "unknown" }], hallucinationFactor: 0 });
+        const line = formatDevilsAdvocatePulseLine(r);
+        expect(line).toContain("DEVILS-ADVOCATE");
+        expect(line).toContain("final=");
+    });
+});
+// ============================================================
+// GROUNDING
+// ============================================================
+describe("v1.99 FLASH · Hyper-Contextual Grounding", () => {
+    it("classifies seller-listing context from commerce signals", () => {
+        const r = groundClaim("[Super rare] CAPCOM Capcom Character Trump Street Fighter Mega Man ฿1,086.49 (tax included) Shipping included Buy Now on Buyee");
+        expect(r.context).toBe("seller-listing");
+        expect(r.commerceSignals.length).toBeGreaterThanOrEqual(2);
+        expect(r.rarityClaims.length).toBeGreaterThanOrEqual(1);
+        expect(r.suggestedSourceWeight).toBeLessThan(0.30);
+        expect(r.suggestedHallucinationAddOn).toBeGreaterThanOrEqual(1.0);
+    });
+    it("classifies expert-review context with PSA / population-report signals", () => {
+        const r = groundClaim("PSA grading confirms this card. Population report: 41 copies. Auction record: Goldin 2024.");
+        expect(r.context).toBe("expert-review");
+        expect(r.thirdPartyProofs.length).toBeGreaterThanOrEqual(2);
+        expect(r.suggestedSourceWeight).toBeGreaterThanOrEqual(0.80);
+    });
+    it("classifies user-statement when rarity present but no commerce + no proof", () => {
+        const r = groundClaim("I think this thing is rare");
+        expect(r.context).toBe("user-statement");
+    });
+    it("classifies neutral-text when nothing matches", () => {
+        const r = groundClaim("This is some random product description with no specific claims.");
+        expect(r.context).toBe("neutral-text");
+    });
+    it("formatGroundingPulseLine produces compact summary", () => {
+        const r = groundClaim("[Super rare] ฿1,086.49 Buy Now on Buyee");
+        const line = formatGroundingPulseLine(r);
+        expect(line).toContain("GROUNDING");
+        expect(line).toContain("rarity=");
+        expect(line).toContain("commerce=");
+    });
+});
+// ============================================================
+// PROMPT-Q LATENCY
+// ============================================================
+describe("v1.99 FLASH · Prompt-Q-Latency Engine", () => {
+    it("predicts 'rarity-followup' when reply mentions rare/collectible", () => {
+        const r = predictNextQuery("Cannot confirm this is rare without auction history.");
+        expect(r.predictions[0]?.feature.id).toBe("rarity-followup");
+    });
+    it("predicts 'value-followup' when reply mentions price/worth", () => {
+        const r = predictNextQuery("The listed price is 1,086.49 baht.");
+        expect(r.predictions.some((p) => p.feature.id === "value-followup")).toBe(true);
+    });
+    it("returns empty predictions when reply has no triggers", () => {
+        const r = predictNextQuery("Hello!");
+        expect(r.predictions.length).toBe(0);
+    });
+    it("formatPredictionPulseLine produces compact summary", () => {
+        const r = predictNextQuery("The rare card is collectible.");
+        const line = formatPredictionPulseLine(r);
+        expect(line).toContain("PROMPT-Q");
+    });
+});
+// ============================================================
+// FLASH MASTER — the user's exact "Super rare CAPCOM" case
+// ============================================================
+describe("v1.99 FLASH · the user's exact 'Super rare CAPCOM' hallucination case", () => {
+    it("refuses to confirm 'super rare' when the only evidence is the seller listing", () => {
+        const r = runFlash({
+            claim: "this Capcom Trump card deck is super rare",
+            contextText: "[Super rare] CAPCOM Capcom Character Trump Street Fighter Mega Man ฿1,086.49 (tax included) Shipping included Buy Now on Buyee. Product Description: 90年代に販売されたカプコンの人気キャラクター...",
+            baseHallucinationFactor: 0,
+            phi_qx: 2.0, // commerce paranoia
+        });
+        // CORE assertion: vanilla AIs would AFFIRM ("yes it's super rare!").
+        // FLASH must NOT AFFIRM.
+        expect(r.verdict).not.toBe("AFFIRM");
+        expect(["DOUBTFUL", "REFUTE"]).toContain(r.verdict);
+        expect(r.grounding.context).toBe("seller-listing");
+        expect(r.grounding.rarityClaims.length).toBeGreaterThan(0);
+        expect(r.veracity.V_eff).toBeLessThan(0.30);
+        expect(r.template).toMatch(/Cannot confirm|Refuse to confirm/);
+    });
+    it("AFFIRMs the same claim WHEN third-party evidence is also present", () => {
+        const r = runFlash({
+            claim: "this Capcom Trump card deck is super rare",
+            contextText: "[Super rare] CAPCOM Capcom Character Trump ฿1,086.49 Buy Now on Buyee",
+            additionalEvidence: [
+                { fact: "Mandarake catalog shows only 800 copies were printed (1994)", supportStrength: 0.9, sourceWeight: 0.85, sourceKind: "expert-database" },
+                { fact: "Yahoo Auctions Japan 5-year history shows 7 completed sales, avg ¥4800", supportStrength: 0.85, sourceWeight: 0.90, sourceKind: "verified-third-party" },
+            ],
+            baseHallucinationFactor: 0,
+            phi_qx: 1.0,
+        });
+        expect(["AFFIRM", "CAUTIOUS"]).toContain(r.verdict);
+        expect(r.veracity.V_eff).toBeGreaterThan(0.35);
+    });
+    it("produces a pulseLine that an AI agent can surface to the user", () => {
+        const r = runFlash({
+            claim: "this is super rare",
+            contextText: "[Super rare] ฿1,086.49 Buy Now on Buyee",
+            baseHallucinationFactor: 0,
+        });
+        expect(r.pulseLine).toContain("FLASH");
+        expect(r.pulseLine).toMatch(/AFFIRM|CAUTIOUS|DOUBTFUL|REFUTE/);
+        expect(r.pulseLine).toContain("V_eff=");
+    });
+});
+//# sourceMappingURL=flash.test.js.map

package/dist/flash/flash.test.js.map

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

package/dist/flash/grounding.d.ts

@@ -0,0 +1,55 @@
+/**
+ * v1.99.0 -- FLASH · Hyper-Contextual Grounding
+ *
+ * Detect that "Super rare" sitting on a product listing image is NOT a
+ * verified rarity claim — it's marketing copy. The grounding step
+ * extracts text from the user's input (image OCR result or pasted
+ * caption), classifies the SOURCE CONTEXT, and assigns a source weight
+ * that reflects the trust the AI agent should put in it.
+ *
+ * The user's exact case:
+ *   image_4a1c54.jpg contains text "[Super rare] CAPCOM Capcom Character
+ *   Trump Street Fighter Mega Man" plus "1,086.49 baht" plus
+ *   "Buy Now on Buyee".
+ *   Every vanilla AI: "yes it's rare" — because it pattern-matched the
+ *   surface text. WRONG.
+ *
+ * FLASH grounding extracts:
+ *   - rarity claims ("Super rare", "limited", "extremely rare")
+ *   - commerce signals ("Buy Now", "shipping", "BHT", "$", "¥")
+ *   - source context ("seller listing", "marketplace", "auction site")
+ *   - third-party evidence absence
+ * → classifies the whole frame as `seller-listing` source kind
+ * → demotes source weight to 0.20 (per veracity.ts DEFAULT_SOURCE_WEIGHT)
+ *
+ * AI agent then runs computeVeracity with the demoted source weight and
+ * the rarity claim gets correctly marked DOUBTFUL or REFUTE — not AFFIRM.
+ *
+ * Pure function. Deterministic. Offline-only (no external lookups).
+ */
+import type { EvidenceItem } from "./veracity.js";
+export type SourceContext = "seller-listing" | "auction-record" | "expert-review" | "primary-document" | "encyclopedia" | "user-statement" | "neutral-text";
+export interface GroundingResult {
+    /** Classified context for the input frame. */
+    context: SourceContext;
+    /** Suggested EvidenceItem.sourceKind to use downstream. */
+    sourceKind: EvidenceItem["sourceKind"];
+    /** Detected rarity claims (literal phrases). */
+    rarityClaims: string[];
+    /** Detected commerce signals (literal phrases). */
+    commerceSignals: string[];
+    /** Detected third-party verification signals. */
+    thirdPartyProofs: string[];
+    /** Suggested source weight for veracity.computeVeracity. */
+    suggestedSourceWeight: number;
+    /** Suggested hallucination factor add-on for veracity. */
+    suggestedHallucinationAddOn: number;
+    /** Why we classified it that way. */
+    reason: string;
+}
+/** Classify the source context of free-form text (OCR result, caption,
+ *  description) and produce a recommendation for veracity downstream. */
+export declare function groundClaim(rawText: string): GroundingResult;
+/** One-line summary for the pulse. */
+export declare function formatGroundingPulseLine(r: GroundingResult): string;
+//# sourceMappingURL=grounding.d.ts.map

package/dist/flash/grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding.d.ts","sourceRoot":"","sources":["../../src/flash/grounding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA+ClD,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,aAAa,CAAC;IACvB,2DAA2D;IAC3D,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;IACvC,gDAAgD;IAChD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,2BAA2B,EAAE,MAAM,CAAC;IACpC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD;yEACyE;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAqD5D;AAED,sCAAsC;AACtC,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAEnE"}

package/dist/flash/grounding.js

@@ -0,0 +1,144 @@
+/**
+ * v1.99.0 -- FLASH · Hyper-Contextual Grounding
+ *
+ * Detect that "Super rare" sitting on a product listing image is NOT a
+ * verified rarity claim — it's marketing copy. The grounding step
+ * extracts text from the user's input (image OCR result or pasted
+ * caption), classifies the SOURCE CONTEXT, and assigns a source weight
+ * that reflects the trust the AI agent should put in it.
+ *
+ * The user's exact case:
+ *   image_4a1c54.jpg contains text "[Super rare] CAPCOM Capcom Character
+ *   Trump Street Fighter Mega Man" plus "1,086.49 baht" plus
+ *   "Buy Now on Buyee".
+ *   Every vanilla AI: "yes it's rare" — because it pattern-matched the
+ *   surface text. WRONG.
+ *
+ * FLASH grounding extracts:
+ *   - rarity claims ("Super rare", "limited", "extremely rare")
+ *   - commerce signals ("Buy Now", "shipping", "BHT", "$", "¥")
+ *   - source context ("seller listing", "marketplace", "auction site")
+ *   - third-party evidence absence
+ * → classifies the whole frame as `seller-listing` source kind
+ * → demotes source weight to 0.20 (per veracity.ts DEFAULT_SOURCE_WEIGHT)
+ *
+ * AI agent then runs computeVeracity with the demoted source weight and
+ * the rarity claim gets correctly marked DOUBTFUL or REFUTE — not AFFIRM.
+ *
+ * Pure function. Deterministic. Offline-only (no external lookups).
+ */
+const RARITY_CLAIM_PATTERNS = [
+    /\b(super )?rare\b/i,
+    /\bextremely rare\b/i,
+    /\blimited edition\b/i,
+    /\bone of a kind\b/i,
+    /\bunique\b/i,
+    /\bcollectible\b/i,
+    /\boriginal\b/i,
+    /\bauthentic\b/i,
+    /\bmint condition\b/i,
+    /\bvintage\b/i,
+    /\bgrail\b/i,
+];
+const COMMERCE_SIGNALS = [
+    /\bbuy now\b/i,
+    /\bshipping\b/i,
+    /\bauction\b/i,
+    /\bprice\b/i,
+    /\bbht\b/i,
+    /\b฿/i,
+    /[$€¥£]\s*\d/,
+    /\d[\d,]*\.\d{2}\b/, // 1,086.49
+    /\bproduct description\b/i,
+    /\bbuyee\b/i,
+    /\bebay\b/i,
+    /\bmercari\b/i,
+    /\baliexpress\b/i,
+    /\bamazon\b/i,
+    /\b楽天\b/i, // Rakuten
+    /\bヤフオク\b/i, // Yahoo Auctions JP
+];
+const THIRD_PARTY_PROOF_HINTS = [
+    /\bauction record\b/i,
+    /\bpopulation report\b/i,
+    /\bgrading\b/i,
+    /\bpsa\b/i, // PSA / Beckett grading
+    /\bbgs\b/i,
+    /\bcomptia\b/i,
+    /\bmuseum\b/i,
+    /\bcatalog\b/i,
+    /\barchive\b/i,
+];
+function findMatches(text, patterns) {
+    const hits = [];
+    for (const p of patterns) {
+        const m = text.match(p);
+        if (m)
+            hits.push(m[0]);
+    }
+    return hits;
+}
+/** Classify the source context of free-form text (OCR result, caption,
+ *  description) and produce a recommendation for veracity downstream. */
+export function groundClaim(rawText) {
+    const rarityClaims = findMatches(rawText, RARITY_CLAIM_PATTERNS);
+    const commerceSignals = findMatches(rawText, COMMERCE_SIGNALS);
+    const thirdPartyProofs = findMatches(rawText, THIRD_PARTY_PROOF_HINTS);
+    let context;
+    let reason;
+    let suggestedSourceWeight;
+    let suggestedHallucinationAddOn;
+    if (thirdPartyProofs.length >= 2) {
+        context = "expert-review";
+        reason = `${thirdPartyProofs.length} third-party verification signals detected (${thirdPartyProofs.join(", ")})`;
+        suggestedSourceWeight = 0.85;
+        suggestedHallucinationAddOn = 0;
+    }
+    else if (commerceSignals.length >= 2) {
+        context = "seller-listing";
+        reason = `${commerceSignals.length} commerce signals (${commerceSignals.slice(0, 3).join(", ")}) — this is a sales page; treat rarity claims as marketing copy`;
+        suggestedSourceWeight = 0.20;
+        // Adding 2 to H = more skepticism for marketing-tier sources
+        suggestedHallucinationAddOn = rarityClaims.length > 0 ? 2.0 : 1.0;
+    }
+    else if (rarityClaims.length > 0) {
+        context = "user-statement";
+        reason = `rarity claim "${rarityClaims[0]}" present but no commerce signals + no third-party proofs — caller's own assertion`;
+        suggestedSourceWeight = 0.55;
+        suggestedHallucinationAddOn = 1.0;
+    }
+    else {
+        context = "neutral-text";
+        reason = "no rarity claim, no commerce signal, no third-party proof";
+        suggestedSourceWeight = 0.50;
+        suggestedHallucinationAddOn = 0;
+    }
+    // Map to the canonical EvidenceItem sourceKind enum.
+    // (Only the four cases actually produced by the classifier above are
+    // handled here — tsc would flag dead cases otherwise. The other
+    // SourceContext values are reserved for future classifiers.)
+    let sourceKind;
+    if (context === "expert-review")
+        sourceKind = "expert-database";
+    else if (context === "seller-listing")
+        sourceKind = "seller-listing";
+    else if (context === "user-statement")
+        sourceKind = "user-statement";
+    else
+        sourceKind = "unknown";
+    return {
+        context,
+        sourceKind,
+        rarityClaims,
+        commerceSignals,
+        thirdPartyProofs,
+        suggestedSourceWeight,
+        suggestedHallucinationAddOn,
+        reason,
+    };
+}
+/** One-line summary for the pulse. */
+export function formatGroundingPulseLine(r) {
+    return `GROUNDING · context=${r.context} · rarity=${r.rarityClaims.length} · commerce=${r.commerceSignals.length} · third-party=${r.thirdPartyProofs.length} · suggested-weight=${r.suggestedSourceWeight}`;
+}
+//# sourceMappingURL=grounding.js.map

package/dist/flash/grounding.js.map

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

package/dist/flash/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * v1.99.0 -- FLASH INTELLIGENCE public surface.
+ *
+ *   "Not trained to be skeptical. Engineered to be."
+ *
+ * Composed of:
+ *   ⚖  Veracity-Velocity Singularity (computeVeracity)
+ *   👹  Recursive Self-Verification — Devil's Advocate (runDevilsAdvocate)
+ *   🌐  Hyper-Contextual Grounding (groundClaim)
+ *   ⚡  Prompt-Q-Latency Engine (predictNextQuery)
+ *   ✨  FLASH master function (runFlash)
+ */
+export * from "./veracity.js";
+export * from "./devils_advocate.js";
+export * from "./grounding.js";
+export * from "./predictive.js";
+export * from "./flash.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flash/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/flash/index.js

@@ -0,0 +1,18 @@
+/**
+ * v1.99.0 -- FLASH INTELLIGENCE public surface.
+ *
+ *   "Not trained to be skeptical. Engineered to be."
+ *
+ * Composed of:
+ *   ⚖  Veracity-Velocity Singularity (computeVeracity)
+ *   👹  Recursive Self-Verification — Devil's Advocate (runDevilsAdvocate)
+ *   🌐  Hyper-Contextual Grounding (groundClaim)
+ *   ⚡  Prompt-Q-Latency Engine (predictNextQuery)
+ *   ✨  FLASH master function (runFlash)
+ */
+export * from "./veracity.js";
+export * from "./devils_advocate.js";
+export * from "./grounding.js";
+export * from "./predictive.js";
+export * from "./flash.js";
+//# sourceMappingURL=index.js.map

package/dist/flash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flash/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/flash/predictive.d.ts

@@ -0,0 +1,44 @@
+/**
+ * v1.99.0 -- FLASH · Prompt-Q-Latency Engine (predictive reasoning)
+ *
+ * After the AI replies to N, it pre-warms a Markov-chain prediction for
+ * the user's likely N+1 question + builds the context the answer would
+ * need. If the prediction hits, the AI replies in ~0 ms wall (no
+ * round-trip to "think about the question first").
+ *
+ * Mneme already ships PRECOG (Markov + ACO pheromone) for MCP tool
+ * sequences. This is the same idea applied to USER messages — different
+ * domain, same math.
+ *
+ * Honest scope: this v1.99 ships the predictive CORE + a deterministic
+ * "what's the user likely to ask next given the conversation arc?"
+ * scorer. The actual context pre-warming hook into Claude Code/Cursor
+ * is daemon work in v2.00.
+ */
+export interface QueryFeature {
+    /** Stable id for this question-class. */
+    id: string;
+    /** Human label, e.g. "follow-up: is this authentic?". */
+    label: string;
+    /** Keywords that, when present in the AI's last reply, vote for this. */
+    triggers: string[];
+    /** Pre-warm hint — what context to fetch for the predicted question. */
+    prewarmHint: string;
+}
+/** Built-in question classes derived from common Mneme conversation arcs. */
+export declare const QUESTION_CLASSES: QueryFeature[];
+export interface PredictionResult {
+    /** Top-K predicted next questions, ranked by trigger overlap. */
+    predictions: Array<{
+        feature: QueryFeature;
+        score: number;
+        matchedTriggers: string[];
+    }>;
+    /** Pre-warm hints aggregated across the top predictions. */
+    prewarmHints: string[];
+}
+/** Predict next likely user question given the AI's last reply text. */
+export declare function predictNextQuery(lastReplyText: string, topK?: number): PredictionResult;
+/** One-line summary. */
+export declare function formatPredictionPulseLine(r: PredictionResult): string;
+//# sourceMappingURL=predictive.d.ts.map

package/dist/flash/predictive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictive.d.ts","sourceRoot":"","sources":["../../src/flash/predictive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,EAAE,YAAY,EAqC1C,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACxF,4DAA4D;IAC5D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,gBAAgB,CAUlF;AAED,wBAAwB;AACxB,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAIrE"}

package/dist/flash/predictive.js

@@ -0,0 +1,76 @@
+/**
+ * v1.99.0 -- FLASH · Prompt-Q-Latency Engine (predictive reasoning)
+ *
+ * After the AI replies to N, it pre-warms a Markov-chain prediction for
+ * the user's likely N+1 question + builds the context the answer would
+ * need. If the prediction hits, the AI replies in ~0 ms wall (no
+ * round-trip to "think about the question first").
+ *
+ * Mneme already ships PRECOG (Markov + ACO pheromone) for MCP tool
+ * sequences. This is the same idea applied to USER messages — different
+ * domain, same math.
+ *
+ * Honest scope: this v1.99 ships the predictive CORE + a deterministic
+ * "what's the user likely to ask next given the conversation arc?"
+ * scorer. The actual context pre-warming hook into Claude Code/Cursor
+ * is daemon work in v2.00.
+ */
+/** Built-in question classes derived from common Mneme conversation arcs. */
+export const QUESTION_CLASSES = [
+    {
+        id: "rarity-followup",
+        label: "Is this actually rare? Show evidence.",
+        triggers: ["rare", "rarity", "collectible", "valuable", "limited"],
+        prewarmHint: "Fetch auction history + production-count if available; mark seller-listing claims as low source weight.",
+    },
+    {
+        id: "authenticity-followup",
+        label: "How do I verify it's authentic?",
+        triggers: ["authentic", "real", "original", "fake", "counterfeit"],
+        prewarmHint: "Provide grading-service references (PSA/BGS for cards, expert-database for collectibles).",
+    },
+    {
+        id: "value-followup",
+        label: "What's it actually worth?",
+        triggers: ["worth", "value", "price", "expensive", "cheap", "money"],
+        prewarmHint: "Pull sold-listing comparables; ignore asking prices on active listings.",
+    },
+    {
+        id: "alternative-followup",
+        label: "Are there cheaper / better alternatives?",
+        triggers: ["alternative", "instead", "competitor", "similar"],
+        prewarmHint: "Pull DNA-search results for similar items + cross-vendor pricing.",
+    },
+    {
+        id: "decision-justify-followup",
+        label: "Why did you say that?",
+        triggers: ["why", "explain", "because", "reason", "justify"],
+        prewarmHint: "Surface the V_eff + grounding + devil's-advocate trace from the prior reply.",
+    },
+    {
+        id: "implement-followup",
+        label: "Now implement it.",
+        triggers: ["implement", "code", "write", "build", "create"],
+        prewarmHint: "Cache the file paths + skeleton scaffolds matching the prior decision.",
+    },
+];
+/** Predict next likely user question given the AI's last reply text. */
+export function predictNextQuery(lastReplyText, topK = 3) {
+    const text = lastReplyText.toLowerCase();
+    const scored = QUESTION_CLASSES.map((qc) => {
+        const matched = qc.triggers.filter((t) => text.includes(t.toLowerCase()));
+        return { feature: qc, score: matched.length, matchedTriggers: matched };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    const predictions = scored.filter((s) => s.score > 0).slice(0, topK);
+    const prewarmHints = predictions.map((p) => p.feature.prewarmHint);
+    return { predictions, prewarmHints };
+}
+/** One-line summary. */
+export function formatPredictionPulseLine(r) {
+    if (r.predictions.length === 0)
+        return `PROMPT-Q · no prediction (lastReply has no triggers)`;
+    const top = r.predictions[0];
+    return `PROMPT-Q · top=${top.feature.id} score=${top.score} · prewarm=${r.prewarmHints.length} hints`;
+}
+//# sourceMappingURL=predictive.js.map

package/dist/flash/predictive.js.map

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