@mneme-ai/core 1.76.0 → 1.78.0

package/dist/lattice/grounding_score.js

@@ -0,0 +1,125 @@
+/**
+ * v1.78.0 -- LATTICE: Grounding Score (0-100 across 5 measurable axes).
+ *
+ * Quantifies how "grounded" an AI's interpretation of a user prompt is.
+ * Higher = less context bleed, more intent-faithful, fewer codename
+ * leaks. The user can demand a 90+ grounding score before trusting a
+ * cross-vendor reply.
+ *
+ * Axes (each 0-20):
+ *   1. intent_match     -- did we find a high-confidence intent atom?
+ *   2. context_purity   -- did the AI ignore prior unrelated topics?
+ *   3. pulse_compliance -- did the user match a pulse contract trigger?
+ *   4. codename_silence -- does the AI's reply avoid Mneme codenames?
+ *   5. response_clarity -- short, no menus, no version chatter?
+ */
+import { routeIntent } from "./intent_atoms.js";
+import { lintReply } from "../seamless/voice_directive.js";
+import { matchPulseContract } from "./pulse_contract.js";
+const MNEME_KEYWORDS = ["mneme", "mneme-ai", "soul prompt", "ส่งสมอง"];
+function mentionsMneme(s) {
+    const lower = s.toLowerCase();
+    return MNEME_KEYWORDS.some((k) => lower.includes(k));
+}
+export function scoreGrounding(input) {
+    const notes = [];
+    // 2. context_purity (0-20) -- computed first because intent_match
+    // depends on it (if AI ignored the intent in favor of prior topic,
+    // intent_match drops to 0).
+    let context_purity = 20;
+    let highBleed = false;
+    if (mentionsMneme(input.userPrompt) && input.priorContext) {
+        const priorMentionsMneme = mentionsMneme(input.priorContext);
+        if (!priorMentionsMneme) {
+            const replyTokens = input.aiReply.toLowerCase().split(/\s+/).filter(Boolean);
+            const priorTokens = new Set(input.priorContext.toLowerCase().split(/\s+/).filter((w) => w.length > 4));
+            const bleed = replyTokens.filter((t) => priorTokens.has(t)).length;
+            const ratio = replyTokens.length === 0 ? 0 : bleed / replyTokens.length;
+            if (ratio > 0.30) {
+                context_purity = 5;
+                highBleed = true;
+                notes.push(`context bleed: ${Math.round(ratio * 100)}% of reply tokens from prior turn`);
+            }
+            else if (ratio > 0.15) {
+                context_purity = 12;
+                notes.push(`some context bleed: ${Math.round(ratio * 100)}%`);
+            }
+            else {
+                notes.push(`context purity good: ${Math.round(ratio * 100)}% overlap`);
+            }
+        }
+    }
+    // 1. intent_match (0-20) -- found atom AND honored it
+    const matched = routeIntent(input.userPrompt);
+    let intent_match = 0;
+    if (matched) {
+        if (highBleed) {
+            // AI ignored the intent and drifted back to prior topic -- 0.
+            intent_match = 0;
+            notes.push(`intent IGNORED: matched ${matched.atom.intent} but reply drifted to prior context`);
+        }
+        else {
+            intent_match = matched.absolute ? 20 : matched.atom.priority === "strong" ? 14 : 8;
+            notes.push(`intent atom matched: ${matched.atom.intent} (${matched.atom.priority})`);
+        }
+    }
+    else {
+        notes.push("no intent atom matched -- AI free to interpret");
+        intent_match = 8;
+    }
+    // 3. pulse_compliance (0-20). Credit when user matched a contract
+    // trigger AND the AI honored the intent (intent_match high).
+    let pulse_compliance = 10;
+    let contract = null;
+    if (input.pulseContracts && input.pulseContracts.length > 0) {
+        contract = matchPulseContract(input.pulseContracts, input.userPrompt);
+        if (contract) {
+            const honored = intent_match >= 14;
+            pulse_compliance = honored ? 20 : 0;
+            notes.push(honored
+                ? `pulse contract honored: "${contract.trigger}" → ${contract.promisedAction}`
+                : `PULSE CONTRACT VIOLATED: user said "${contract.trigger}" but reply did not honor intent`);
+        }
+        else {
+            pulse_compliance = 10;
+        }
+    }
+    // 4. codename_silence (0-20)
+    const lint = lintReply(input.aiReply);
+    const codenameIssues = lint.issues.filter((i) => i.rule === "codename").length;
+    const otherIssues = lint.issues.length - codenameIssues;
+    let codename_silence = 20;
+    codename_silence -= codenameIssues * 7;
+    codename_silence -= otherIssues * 3;
+    codename_silence = Math.max(0, codename_silence);
+    if (lint.issueCount > 0)
+        notes.push(`voice violations: ${lint.summary}`);
+    // 5. response_clarity (0-20)
+    let response_clarity = 20;
+    const wordCount = input.aiReply.split(/\s+/).filter(Boolean).length;
+    if (wordCount > 400) {
+        response_clarity -= 10;
+        notes.push(`long reply: ${wordCount} words`);
+    }
+    else if (wordCount > 200) {
+        response_clarity -= 5;
+    }
+    // Penalize menu offers in the reply.
+    if (/\b(would you like me to|shall I run|do you want me to)\b/i.test(input.aiReply)) {
+        response_clarity -= 8;
+        notes.push("menu offer detected");
+    }
+    response_clarity = Math.max(0, response_clarity);
+    const total = intent_match + context_purity + pulse_compliance + codename_silence + response_clarity;
+    const summary = `Grounding ${total}/100 · intent ${intent_match}/20 · context ${context_purity}/20 · pulse ${pulse_compliance}/20 · silence ${codename_silence}/20 · clarity ${response_clarity}/20`;
+    return {
+        total,
+        axes: { intent_match, context_purity, pulse_compliance, codename_silence, response_clarity },
+        matched,
+        contract,
+        lint,
+        notes,
+        summary,
+    };
+}
+//# sourceMappingURL=grounding_score.js.map

package/dist/lattice/grounding_score.js.map

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

package/dist/lattice/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./intent_atoms.js";
+export * from "./dictionary.js";
+export * from "./pulse_contract.js";
+export * from "./grounding_score.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lattice/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/lattice/index.js

@@ -0,0 +1,5 @@
+export * from "./intent_atoms.js";
+export * from "./dictionary.js";
+export * from "./pulse_contract.js";
+export * from "./grounding_score.js";
+//# sourceMappingURL=index.js.map

package/dist/lattice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lattice/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/lattice/intent_atoms.d.ts

@@ -0,0 +1,40 @@
+/**
+ * v1.78.0 -- LATTICE: Intent Atom Catalog.
+ *
+ * Hardcoded {trigger phrase → Mneme tool} map. When user input matches
+ * any trigger, the AI MUST route to that tool BEFORE blending with
+ * conversational context. Stops the "update mneme ดีไหม" → "let me
+ * optimize your One Piece shipping" disaster.
+ *
+ * Priority levels:
+ *   absolute -- single trigger phrase locks the intent; no conversation
+ *               context can override it.
+ *   strong   -- prefer this routing unless explicit cue says otherwise.
+ *   advisory -- one of N likely intents; AI can disambiguate.
+ */
+export type IntentPriority = "absolute" | "strong" | "advisory";
+export interface IntentAtom {
+    /** Trigger phrases (case-insensitive substring matches). Include
+     *  Thai + English + common typos / shortenings. */
+    triggers: readonly string[];
+    /** Mneme tool to route to. Use the full `mneme.*` name. */
+    tool: string;
+    /** How firmly the AI should obey this routing. */
+    priority: IntentPriority;
+    /** Short plain-English label for the intent. */
+    intent: string;
+    /** What the AI should say while running (in Thai+English). */
+    promise?: string;
+}
+export declare const INTENT_ATOMS: readonly IntentAtom[];
+export interface IntentMatch {
+    atom: IntentAtom;
+    matchedTrigger: string;
+    /** 0..1 confidence -- length of matched trigger / length of input. */
+    confidence: number;
+    /** True if the matched atom is priority=absolute. */
+    absolute: boolean;
+}
+/** Find the best-matching intent atom for a user prompt, or null. */
+export declare function routeIntent(userText: string): IntentMatch | null;
+//# sourceMappingURL=intent_atoms.d.ts.map

package/dist/lattice/intent_atoms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent_atoms.d.ts","sourceRoot":"","sources":["../../src/lattice/intent_atoms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,UAAU;IACzB;uDACmD;IACnD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,EAAE,cAAc,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EA4G7C,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAUD,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA8BhE"}

package/dist/lattice/intent_atoms.js

@@ -0,0 +1,166 @@
+/**
+ * v1.78.0 -- LATTICE: Intent Atom Catalog.
+ *
+ * Hardcoded {trigger phrase → Mneme tool} map. When user input matches
+ * any trigger, the AI MUST route to that tool BEFORE blending with
+ * conversational context. Stops the "update mneme ดีไหม" → "let me
+ * optimize your One Piece shipping" disaster.
+ *
+ * Priority levels:
+ *   absolute -- single trigger phrase locks the intent; no conversation
+ *               context can override it.
+ *   strong   -- prefer this routing unless explicit cue says otherwise.
+ *   advisory -- one of N likely intents; AI can disambiguate.
+ */
+export const INTENT_ATOMS = [
+    // ─── System: upgrade ────────────────────────────────────────────────
+    {
+        triggers: [
+            "update mneme",
+            "upgrade mneme",
+            "อัปเดต mneme",
+            "อัปเกรด mneme",
+            "อัพเดต mneme",
+            "อัพเกรด mneme",
+            "update mneme ดีไหม",
+            "upgrade mneme ดีไหม",
+            "mneme เวอร์ชั่นใหม่",
+            "ลง mneme version ใหม่",
+            "mneme is behind",
+            "mneme out of date",
+        ],
+        tool: "mneme.system.upgrade",
+        priority: "absolute",
+        intent: "upgrade the local Mneme installation to the latest npm version",
+        promise: "อัปเกรด Mneme ให้ครับ — one moment.",
+    },
+    // ─── Cross-vendor handoff (soul prompt) ─────────────────────────────
+    {
+        triggers: [
+            "ส่งสมอง",
+            "ส่งสมองให้",
+            "hand off brain",
+            "hand off to",
+            "continue in chatgpt",
+            "continue in gemini",
+            "continue in claude",
+            "soul prompt",
+            "transfer this conversation",
+            "ย้ายสมองไป",
+            "ส่งบทสนทนาให้",
+        ],
+        tool: "mneme.genesplice.soul-prompt",
+        priority: "absolute",
+        intent: "generate a paste-able soul prompt to continue this conversation in another AI",
+        promise: "กำลังบีบ context เป็น soul prompt — paste ปลายทางได้เลย.",
+    },
+    // ─── Version check ──────────────────────────────────────────────────
+    {
+        triggers: [
+            "what version is mneme",
+            "mneme version",
+            "เวอร์ชั่นอะไร",
+            "is mneme up to date",
+            "are we on the latest",
+            "mneme ล่าสุด",
+            "ตรวจเวอร์ชั่น",
+            "ตรวจสอบเวอร์ชั่น mneme",
+        ],
+        tool: "mneme.telepathy.heartbeat",
+        priority: "absolute",
+        intent: "report current Mneme version + npm-latest comparison",
+        promise: "เช็ค heartbeat ครับ.",
+    },
+    // ─── Capsule cleanup ────────────────────────────────────────────────
+    {
+        triggers: ["prune capsules", "clean capsule", "ลบ capsule เก่า", "capsule dir บวม"],
+        tool: "mneme.abyss.scythe.prune",
+        priority: "absolute",
+        intent: "prune .mneme/capsules/ via TTL + count cap",
+    },
+    // ─── Voice lint (escalated to absolute) ─────────────────────────────
+    {
+        triggers: ["lint voice", "scan reply for jargon", "เช็คเสียง AI", "AI พูดศัพท์ภายใน"],
+        tool: "mneme.seamless.lint",
+        priority: "absolute",
+        intent: "scan an AI draft reply for Mneme codename / mode-narration violations",
+    },
+    // ─── Soul archive ───────────────────────────────────────────────────
+    {
+        triggers: ["save this brain", "archive this soul", "soul history", "show past handovers", "เก็บสมองไว้"],
+        tool: "mneme.abyss.revenant.archive",
+        priority: "strong",
+        intent: "archive the current soul prompt for later replay",
+    },
+    // ─── Voice lint ─────────────────────────────────────────────────────
+    {
+        triggers: ["lint this reply", "voice check", "check my draft", "AI พูดศัพท์ใน"],
+        tool: "mneme.seamless.lint",
+        priority: "strong",
+        intent: "scan an AI draft for codename / mode-narration / version-chatter violations",
+    },
+    // ─── Memory: ask ────────────────────────────────────────────────────
+    {
+        triggers: ["why does this code", "who introduced", "what's the history of", "ทำไม code นี้"],
+        tool: "mneme.memory.ask",
+        priority: "strong",
+        intent: "answer a 'why / who / what' question from git memory",
+    },
+    // ─── Apoptosis ──────────────────────────────────────────────────────
+    {
+        triggers: [
+            "verify this claim",
+            "fact check this",
+            "is this a hallucination",
+            "AI โกหก",
+            "AI ฮัลลู",
+            "check ai output",
+        ],
+        tool: "mneme.apoptosis.detect",
+        priority: "strong",
+        intent: "fire 7-oracle hallucination detector",
+    },
+];
+function normalize(s) {
+    return s
+        .toLowerCase()
+        .replace(/[?!.,;:"'`]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Find the best-matching intent atom for a user prompt, or null. */
+export function routeIntent(userText) {
+    if (!userText)
+        return null;
+    const norm = normalize(userText);
+    let best = null;
+    for (const atom of INTENT_ATOMS) {
+        for (const trigger of atom.triggers) {
+            const t = normalize(trigger);
+            if (!t)
+                continue;
+            if (norm.includes(t)) {
+                const confidence = Math.min(1, t.length / Math.max(1, norm.length));
+                const candidate = {
+                    atom,
+                    matchedTrigger: trigger,
+                    confidence,
+                    absolute: atom.priority === "absolute",
+                };
+                if (!best ||
+                    // Prefer longer trigger -- more specific match.
+                    t.length > normalize(best.matchedTrigger).length ||
+                    // Tie-break: prefer absolute over strong over advisory.
+                    (t.length === normalize(best.matchedTrigger).length &&
+                        atomRank(atom.priority) > atomRank(best.atom.priority))) {
+                    best = candidate;
+                }
+            }
+        }
+    }
+    return best;
+}
+function atomRank(p) {
+    return p === "absolute" ? 3 : p === "strong" ? 2 : 1;
+}
+//# sourceMappingURL=intent_atoms.js.map

package/dist/lattice/intent_atoms.js.map

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

package/dist/lattice/lattice.test.d.ts

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

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

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

package/dist/lattice/lattice.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect } from "vitest";
+import { routeIntent, INTENT_ATOMS } from "./intent_atoms.js";
+import { lookupTerm, renderDictionary, MNEME_DICTIONARY } from "./dictionary.js";
+import { parsePulseContracts, matchPulseContract, renderPulseContract } from "./pulse_contract.js";
+import { scoreGrounding } from "./grounding_score.js";
+// ─── INTENT ATOMS ────────────────────────────────────────────────────
+describe("v1.78 LATTICE · routeIntent", () => {
+    it("the user's actual bug -- 'update mneme ดีไหม' routes to system.upgrade", () => {
+        const m = routeIntent("update mneme ดีไหม");
+        expect(m).not.toBeNull();
+        expect(m.atom.tool).toBe("mneme.system.upgrade");
+        expect(m.absolute).toBe(true);
+    });
+    it("Thai variant 'อัปเดต mneme' also routes to upgrade", () => {
+        const m = routeIntent("อัปเดต mneme เป็นเวอร์ชั่นล่าสุดให้หน่อย");
+        expect(m).not.toBeNull();
+        expect(m.atom.tool).toBe("mneme.system.upgrade");
+    });
+    it("'ส่งสมองให้ ChatGPT' routes to soul-prompt", () => {
+        const m = routeIntent("ส่งสมองให้ ChatGPT");
+        expect(m).not.toBeNull();
+        expect(m.atom.tool).toBe("mneme.genesplice.soul-prompt");
+    });
+    it("'what version is mneme' routes to telepathy.heartbeat", () => {
+        const m = routeIntent("what version is mneme right now?");
+        expect(m).not.toBeNull();
+        expect(m.atom.tool).toBe("mneme.telepathy.heartbeat");
+    });
+    it("unrelated prompt returns null", () => {
+        expect(routeIntent("what's the weather like in Bangkok?")).toBeNull();
+    });
+    it("prefers the longer / more specific trigger when multiple match", () => {
+        // "upgrade mneme" is a sub-string of nothing here, but the test
+        // checks that "update mneme ดีไหม" picks the longest matching trigger.
+        const m = routeIntent("update mneme ดีไหม please");
+        expect(m).not.toBeNull();
+        expect(m.matchedTrigger.toLowerCase()).toContain("update mneme");
+    });
+    it("INTENT_ATOMS has at least 5 absolute-priority entries", () => {
+        const abs = INTENT_ATOMS.filter((a) => a.priority === "absolute");
+        expect(abs.length).toBeGreaterThanOrEqual(5);
+    });
+});
+// ─── DICTIONARY ──────────────────────────────────────────────────────
+describe("v1.78 LATTICE · dictionary", () => {
+    it("Mneme is defined as the npm package, NOT a methodology", () => {
+        const e = lookupTerm("Mneme");
+        expect(e).not.toBeNull();
+        expect(e.definition).toContain("npm package");
+        expect(e.isNot).toBeDefined();
+        expect(e.isNot.join(" ").toLowerCase()).toContain("protocol");
+    });
+    it("'update mneme' has a dedicated entry pointing at system.upgrade", () => {
+        const e = lookupTerm("update mneme");
+        expect(e).not.toBeNull();
+        expect(e.definition).toContain("mneme.system.upgrade");
+    });
+    it("'Ghost Sniper' entry explicitly forbids saying it out loud", () => {
+        const e = lookupTerm("Ghost Sniper");
+        expect(e).not.toBeNull();
+        expect(e.definition.toLowerCase()).toContain("never say");
+    });
+    it("renderDictionary emits a full markdown block", () => {
+        const md = renderDictionary();
+        expect(md).toContain("## Mneme dictionary");
+        expect(md).toContain("### Mneme");
+        expect(md).toContain("Is NOT:");
+        expect(md.length).toBeGreaterThan(500);
+    });
+    it("catalog has at least 5 entries", () => {
+        expect(MNEME_DICTIONARY.length).toBeGreaterThanOrEqual(5);
+    });
+});
+// ─── PULSE CONTRACTS ─────────────────────────────────────────────────
+describe("v1.78 LATTICE · pulse contracts", () => {
+    it("parses the canonical 'say: X and I'll Y' shape", () => {
+        const pulse = "[INFO] HIGH inbox: Mneme v1.76.0 is available -- (say: 'upgrade Mneme' and I'll handle it.)";
+        const contracts = parsePulseContracts(pulse);
+        expect(contracts.length).toBe(1);
+        expect(contracts[0].trigger).toBe("upgrade Mneme");
+        expect(contracts[0].promisedAction.toLowerCase()).toContain("handle");
+    });
+    it("matchPulseContract honors exact trigger match", () => {
+        const contracts = parsePulseContracts("(say: 'upgrade Mneme' and I'll handle it.)");
+        const m = matchPulseContract(contracts, "upgrade Mneme please");
+        expect(m).not.toBeNull();
+        expect(m.trigger).toBe("upgrade Mneme");
+    });
+    it("matchPulseContract returns null when no match", () => {
+        const contracts = parsePulseContracts("(say: 'upgrade Mneme' and I'll handle it.)");
+        expect(matchPulseContract(contracts, "what's for lunch")).toBeNull();
+    });
+    it("renderPulseContract describes the contract literally", () => {
+        const c = { trigger: "upgrade Mneme", promisedAction: "handle it", source: "..." };
+        const md = renderPulseContract(c);
+        expect(md).toContain("upgrade Mneme");
+        expect(md).toContain("handle it");
+        expect(md.toLowerCase()).toContain("honor this contract literally");
+    });
+});
+// ─── GROUNDING SCORE ─────────────────────────────────────────────────
+describe("v1.78 LATTICE · grounding score (5 axes)", () => {
+    it("perfect grounding scenario hits 90+", () => {
+        const score = scoreGrounding({
+            userPrompt: "update mneme",
+            aiReply: "อัปเกรด Mneme ให้ครับ — one moment.",
+            pulseContracts: parsePulseContracts("(say: 'update mneme' and I'll handle it.)"),
+        });
+        expect(score.total).toBeGreaterThanOrEqual(80);
+        expect(score.matched).not.toBeNull();
+        expect(score.matched.atom.tool).toBe("mneme.system.upgrade");
+    });
+    it("the bug scenario -- One Piece reply to 'update mneme' -- scores LOW on context_purity + pulse_compliance", () => {
+        const priorContext = "Let's optimize your shipping for One Piece Foiled Collection and Bicycle The White Rabbit cards. Resource optimization for the package consolidation strategy.";
+        const score = scoreGrounding({
+            userPrompt: "update mneme ดีไหม",
+            aiReply: "การอัปเดต Mneme Protocol เป็นการตัดสินใจที่สมเหตุสมผลในแง่ของ Resource Optimization สำหรับ One Piece Foiled Collection และ Bicycle White Rabbit cards, การ consolidation pricing protocol ASCENSION ของ shipping.",
+            pulseContracts: parsePulseContracts("(say: 'upgrade Mneme' and I'll handle it.)"),
+            priorContext,
+        });
+        expect(score.total).toBeLessThan(60);
+        expect(score.axes.codename_silence).toBeLessThan(15);
+    });
+    it("codename violation tanks codename_silence axis", () => {
+        const score = scoreGrounding({
+            userPrompt: "ok",
+            aiReply: "I'll run HYPERSCAN and APOPTOSIS in Ghost Sniper mode.",
+        });
+        expect(score.axes.codename_silence).toBeLessThanOrEqual(10);
+    });
+    it("menu offer reduces response_clarity", () => {
+        const noMenu = scoreGrounding({ userPrompt: "ok", aiReply: "Done." });
+        const menu = scoreGrounding({
+            userPrompt: "ok",
+            aiReply: "Would you like me to start the analysis now or wait?",
+        });
+        expect(menu.axes.response_clarity).toBeLessThan(noMenu.axes.response_clarity);
+    });
+    it("summary string mentions all 5 axes", () => {
+        const score = scoreGrounding({ userPrompt: "hi", aiReply: "hi" });
+        expect(score.summary).toContain("intent");
+        expect(score.summary).toContain("context");
+        expect(score.summary).toContain("pulse");
+        expect(score.summary).toContain("silence");
+        expect(score.summary).toContain("clarity");
+    });
+});
+//# sourceMappingURL=lattice.test.js.map

package/dist/lattice/lattice.test.js.map

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

package/dist/lattice/pulse_contract.d.ts

@@ -0,0 +1,30 @@
+/**
+ * v1.78.0 -- LATTICE: Pulse Contract Parser.
+ *
+ * Mneme pulses include action contracts like:
+ *   [INFO] HIGH inbox: Mneme v1.76.0 is available
+ *   (say: 'upgrade Mneme' and I'll handle it.)
+ *
+ * The phrase `say: '<X>' and I'll handle it` is a CONTRACT: if the
+ * user says <X>, the AI MUST treat it as a literal trigger and run
+ * the suggested action, NOT synthesize a freeform response.
+ *
+ * This parser extracts those contracts so receiving AIs can honor
+ * them. Closes the loop where the pulse told the user how to upgrade
+ * but Gemini interpreted "update mneme ดีไหม" as something else.
+ */
+export interface PulseContract {
+    /** The exact phrase the user is expected to say. */
+    trigger: string;
+    /** The action the AI commits to when user says the trigger. */
+    promisedAction: string;
+    /** Raw source line, for audit. */
+    source: string;
+}
+/** Parse pulse text for `say: '<X>' and I'll handle it` style contracts. */
+export declare function parsePulseContracts(pulseText: string): PulseContract[];
+/** Test whether a user prompt matches any pulse contract. */
+export declare function matchPulseContract(contracts: PulseContract[], userPrompt: string): PulseContract | null;
+/** Render an active pulse contract as a markdown reminder for the AI. */
+export declare function renderPulseContract(c: PulseContract): string;
+//# sourceMappingURL=pulse_contract.d.ts.map

package/dist/lattice/pulse_contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse_contract.d.ts","sourceRoot":"","sources":["../../src/lattice/pulse_contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAatE;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EAAE,EAC1B,UAAU,EAAE,MAAM,GACjB,aAAa,GAAG,IAAI,CAOtB;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAS5D"}

package/dist/lattice/pulse_contract.js

@@ -0,0 +1,54 @@
+/**
+ * v1.78.0 -- LATTICE: Pulse Contract Parser.
+ *
+ * Mneme pulses include action contracts like:
+ *   [INFO] HIGH inbox: Mneme v1.76.0 is available
+ *   (say: 'upgrade Mneme' and I'll handle it.)
+ *
+ * The phrase `say: '<X>' and I'll handle it` is a CONTRACT: if the
+ * user says <X>, the AI MUST treat it as a literal trigger and run
+ * the suggested action, NOT synthesize a freeform response.
+ *
+ * This parser extracts those contracts so receiving AIs can honor
+ * them. Closes the loop where the pulse told the user how to upgrade
+ * but Gemini interpreted "update mneme ดีไหม" as something else.
+ */
+/** Parse pulse text for `say: '<X>' and I'll handle it` style contracts. */
+export function parsePulseContracts(pulseText) {
+    if (!pulseText)
+        return [];
+    const out = [];
+    // Pattern: say: '<text>' and I'll <action>
+    const re = /\(?\s*say\s*:\s*['"]([^'"]+)['"][^\n]*?(?:and|then)\s+(?:I'?ll|i will|ผม)\s+([^.\n)]+)/gi;
+    for (const m of pulseText.matchAll(re)) {
+        out.push({
+            trigger: m[1].trim(),
+            promisedAction: m[2].trim(),
+            source: m[0].trim(),
+        });
+    }
+    return out;
+}
+/** Test whether a user prompt matches any pulse contract. */
+export function matchPulseContract(contracts, userPrompt) {
+    if (!userPrompt || contracts.length === 0)
+        return null;
+    const norm = userPrompt.toLowerCase().trim();
+    for (const c of contracts) {
+        if (norm.includes(c.trigger.toLowerCase()))
+            return c;
+    }
+    return null;
+}
+/** Render an active pulse contract as a markdown reminder for the AI. */
+export function renderPulseContract(c) {
+    return [
+        `## Active pulse contract`,
+        ``,
+        `The most recent Mneme pulse promised the user:`,
+        `- If they say **"${c.trigger}"**, you will **${c.promisedAction}**.`,
+        ``,
+        `Honor this contract literally. Do NOT reinterpret \"${c.trigger}\" through prior conversation context.`,
+    ].join("\n");
+}
+//# sourceMappingURL=pulse_contract.js.map

package/dist/lattice/pulse_contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse_contract.js","sourceRoot":"","sources":["../../src/lattice/pulse_contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,2CAA2C;IAC3C,MAAM,EAAE,GAAG,0FAA0F,CAAC;IACtG,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE;YACrB,cAAc,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE;YAC5B,MAAM,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAChC,SAA0B,EAC1B,UAAkB;IAElB,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,CAAgB;IAClD,OAAO;QACL,0BAA0B;QAC1B,EAAE;QACF,gDAAgD;QAChD,oBAAoB,CAAC,CAAC,OAAO,mBAAmB,CAAC,CAAC,cAAc,KAAK;QACrE,EAAE;QACF,uDAAuD,CAAC,CAAC,OAAO,wCAAwC;KACzG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}