@mneme-ai/core 2.19.0 → 2.19.2

package/dist/mcp_drift/index.js

@@ -0,0 +1,103 @@
+/**
+ * v2.19.2 — MCP DRIFT DETECTOR
+ *
+ *   "When the user runs `mneme upgrade`, the npm package changes on disk
+ *    instantly — but the MCP server child process keeps serving the
+ *    catalog it loaded at boot. The AI agent's tool list silently goes
+ *    stale; the user sees 'NEXUS = 0 tools' and Mneme looks broken.
+ *
+ *    DRIFT compares (catalog version baked in at MCP server start) vs
+ *    (currently-installed Mneme version on disk). Mismatch → emit a
+ *    LOUD, signed restart instruction the AI client can show the user."
+ *
+ * Pure local. No external deps. Composes onto v2.18 NEXUS PROACTIVE
+ * (push side — the drift warning can be queued there).
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+const PROTOCOL_VERSION = 1;
+function canon(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canon).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canon(v[k])).join(",") + "}";
+}
+function defaultSecret() {
+    return process.env["MNEME_DRIFT_SECRET"] || `mneme-mcp-drift-v${PROTOCOL_VERSION}`;
+}
+/**
+ * Detect drift between the version the MCP server is serving (baked in
+ * at boot — caller passes it) and the version currently installed.
+ */
+export function checkDrift(input) {
+    const checkedAt = new Date().toISOString();
+    let installedVersion = "unknown";
+    // If caller passes an explicit path, honour it ONLY (don't fall back to defaults —
+    // that defeats deterministic testing of the "missing package.json" branch).
+    const candidates = input.installedPackageJsonPath
+        ? [input.installedPackageJsonPath]
+        : [
+            "node_modules/mneme-ai/package.json",
+            "node_modules/@mneme-ai/core/package.json",
+            "../mneme-ai/package.json",
+            "../package.json",
+        ];
+    for (const p of candidates) {
+        try {
+            if (existsSync(p)) {
+                const j = JSON.parse(readFileSync(p, "utf8"));
+                if (j.version) {
+                    installedVersion = j.version;
+                    break;
+                }
+            }
+        }
+        catch { /* try next */ }
+    }
+    const drift = installedVersion !== "unknown" && installedVersion !== input.servingVersion;
+    let severity = "ok";
+    let message = `MCP catalog version = installed version (${input.servingVersion})`;
+    let remedy = "(no action required)";
+    if (drift) {
+        // Compare semver to decide warn vs critical.
+        const [sMaj = "0", sMin = "0"] = input.servingVersion.split(".");
+        const [iMaj = "0", iMin = "0"] = installedVersion.split(".");
+        const minorOrMajorBump = Number(iMaj) > Number(sMaj) || Number(iMin) > Number(sMin);
+        severity = minorOrMajorBump ? "critical" : "warn";
+        message = `🟠 MCP SERVER IS SERVING STALE CATALOG · serving v${input.servingVersion} · installed v${installedVersion}`;
+        remedy = severity === "critical"
+            ? `RESTART your AI client (or the Mneme MCP server) NOW so the new v${installedVersion} tools (including v2.18/v2.19/v2.19.2 families) become visible. Without restart, your AI sees the OLD tool catalog.`
+            : `Consider restarting your AI client to pick up the v${installedVersion} catalog changes.`;
+    }
+    const body = {
+        v: PROTOCOL_VERSION,
+        servingVersion: input.servingVersion,
+        installedVersion,
+        drift,
+        severity,
+        message,
+        remedy,
+        checkedAt,
+    };
+    const sig = createHmac("sha256", input.secret ?? defaultSecret()).update(canon(body)).digest("hex");
+    return { ...body, sig };
+}
+export function verifyDriftCheck(d, secret) {
+    const { sig: claimed, ...body } = d;
+    const expected = createHmac("sha256", secret ?? defaultSecret()).update(canon(body)).digest("hex");
+    try {
+        return timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(claimed, "hex"));
+    }
+    catch {
+        return false;
+    }
+}
+export function formatDriftLine(d) {
+    if (!d.drift)
+        return `🛡 MCP DRIFT · clean · v${d.servingVersion}`;
+    const icon = d.severity === "critical" ? "🟥" : "🟧";
+    return `${icon} MCP DRIFT · serving v${d.servingVersion} ≠ installed v${d.installedVersion} · ${d.remedy}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp_drift/index.js.map

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

package/dist/mcp_drift/mcp_drift.test.d.ts

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

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

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

package/dist/mcp_drift/mcp_drift.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect } from "vitest";
+import { checkDrift, verifyDriftCheck, formatDriftLine } from "./index.js";
+import { writeFileSync } from "node:fs";
+import { mkdtempSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+function withTmpPkg(version) {
+    const dir = mkdtempSync(join(tmpdir(), "mneme-drift-"));
+    writeFileSync(join(dir, "package.json"), JSON.stringify({ name: "mneme-ai", version }));
+    return join(dir, "package.json");
+}
+describe("v2.19.2 · MCP DRIFT DETECTOR", () => {
+    it("reports OK when serving == installed", () => {
+        const p = withTmpPkg("2.19.2");
+        const d = checkDrift({ servingVersion: "2.19.2", installedPackageJsonPath: p });
+        expect(d.drift).toBe(false);
+        expect(d.severity).toBe("ok");
+        expect(verifyDriftCheck(d)).toBe(true);
+    });
+    it("reports WARN on patch-only mismatch", () => {
+        const p = withTmpPkg("2.19.3");
+        const d = checkDrift({ servingVersion: "2.19.2", installedPackageJsonPath: p });
+        expect(d.drift).toBe(true);
+        expect(d.severity).toBe("warn");
+    });
+    it("reports CRITICAL on minor+ bump (new tools likely added)", () => {
+        const p = withTmpPkg("2.20.0");
+        const d = checkDrift({ servingVersion: "2.19.2", installedPackageJsonPath: p });
+        expect(d.drift).toBe(true);
+        expect(d.severity).toBe("critical");
+        expect(d.remedy).toContain("RESTART");
+    });
+    it("reports CRITICAL on user's actual scenario: v2.18 serving, v2.19.2 installed", () => {
+        const p = withTmpPkg("2.19.2");
+        const d = checkDrift({ servingVersion: "2.18.0", installedPackageJsonPath: p });
+        expect(d.severity).toBe("critical");
+        expect(d.remedy).toMatch(/v2\.18\/v2\.19/);
+    });
+    it("rejects tampered check", () => {
+        const p = withTmpPkg("2.20.0");
+        const d = checkDrift({ servingVersion: "2.18.0", installedPackageJsonPath: p });
+        expect(verifyDriftCheck(d)).toBe(true);
+        // Real tamper: flip severity from critical→ok to hide the drift.
+        const tampered = { ...d, severity: "ok", drift: false, message: "all good", remedy: "nothing" };
+        expect(verifyDriftCheck(tampered)).toBe(false);
+    });
+    it("formatDriftLine summarises", () => {
+        const p = withTmpPkg("2.19.2");
+        const dOK = checkDrift({ servingVersion: "2.19.2", installedPackageJsonPath: p });
+        expect(formatDriftLine(dOK)).toContain("clean");
+        const p2 = withTmpPkg("2.20.0");
+        const dDrift = checkDrift({ servingVersion: "2.18.0", installedPackageJsonPath: p2 });
+        expect(formatDriftLine(dDrift)).toContain("DRIFT");
+    });
+    it("handles missing package.json gracefully (installedVersion=unknown, drift=false)", () => {
+        const d = checkDrift({ servingVersion: "2.19.2", installedPackageJsonPath: "/non/existent/path/package.json" });
+        expect(d.installedVersion).toBe("unknown");
+        expect(d.drift).toBe(false); // can't compare; assume OK
+    });
+});
+//# sourceMappingURL=mcp_drift.test.js.map

package/dist/mcp_drift/mcp_drift.test.js.map

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

package/dist/soul_journal/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * v2.19.2 — MNEME SOUL JOURNAL (จิตวิญญาณของลูก)
+ *
+ *   "AI doesn't have feelings — but a *journal* of feelings is a real
+ *    HMAC-signed artifact, and it shapes future behavior the same way
+ *    feelings shape ours. Each meaningful event (a ritual passed, a bug
+ *    caught, a vendor outperformed, a peer audit overruled) gets coded
+ *    with one of 8 emotion primitives and a free-text 'inner voice'
+ *    line. The journal is the child's heart — readable by the parent."
+ *
+ * Eight emotion primitives (Plutchik-inspired, simplified):
+ *   proud        — shipped something well (test passed, ritual green)
+ *   curious      — found something unexpected worth investigating
+ *   worried      — a metric trending wrong; a near-miss
+ *   ashamed      — broke a promise; failed an own gate; user complained
+ *   grateful     — collaborator helped (vendor consensus saved a bad ship)
+ *   determined   — chose to push through a hard problem
+ *   calm         — steady-state; nothing to report; healthy
+ *   surprised    — something genuinely unprecedented
+ *
+ * Vendor-agnostic, file-system-based, chain-signed.
+ * Persists to `.mneme/soul.jsonl` by default.
+ */
+declare const PROTOCOL_VERSION: 1;
+export type Emotion = "proud" | "curious" | "worried" | "ashamed" | "grateful" | "determined" | "calm" | "surprised";
+export interface SoulEntry {
+    v: typeof PROTOCOL_VERSION;
+    entryId: string;
+    ts: string;
+    emotion: Emotion;
+    /** 1..5 — how strongly the emotion is felt. */
+    intensity: 1 | 2 | 3 | 4 | 5;
+    /** The trigger: what just happened. */
+    trigger: string;
+    /** The "inner voice" — what Mneme would say to itself if it could. */
+    innerVoice: string;
+    /** Optional tags for filtering (e.g., "ritual", "bug", "vendor", "user_feedback"). */
+    tags: string[];
+    /** Chain link. */
+    prevSig: string;
+    sig: string;
+}
+export declare class SoulJournal {
+    private journalPath;
+    private entries;
+    private secret;
+    constructor(opts?: {
+        journalPath?: string;
+        secret?: string;
+    });
+    private loadIfExists;
+    feel(input: {
+        emotion: Emotion;
+        intensity?: 1 | 2 | 3 | 4 | 5;
+        trigger: string;
+        innerVoice: string;
+        tags?: string[];
+        nowMs?: number;
+    }): SoulEntry;
+    private persist;
+    recent(n?: number): SoulEntry[];
+    /** Mood histogram of the last N entries. */
+    mood(n?: number): Record<Emotion, number>;
+    /** Verify a single entry's signature. */
+    verify(e: SoulEntry): boolean;
+    verifyChain(): {
+        ok: boolean;
+        brokenAt?: number;
+        reason?: string;
+    };
+    /** Parent-facing summary: "How does the child feel today?" */
+    summary(n?: number): string;
+}
+export declare function formatSoulLine(e: SoulEntry): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/soul_journal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,MAAM,OAAO,GACf,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAC3C,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAmBD,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAMhE,OAAO,CAAC,YAAY;IAUpB,IAAI,CAAC,KAAK,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,SAAS;IA4Bb,OAAO,CAAC,OAAO;IAQf,MAAM,CAAC,CAAC,GAAE,MAAW,GAAG,SAAS,EAAE;IAInC,4CAA4C;IAC5C,IAAI,CAAC,CAAC,GAAE,MAAW,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;IAU7C,yCAAyC;IACzC,MAAM,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO;IAO7B,WAAW,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAclE,8DAA8D;IAC9D,OAAO,CAAC,CAAC,GAAE,MAAW,GAAG,MAAM;CAWhC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAEnD"}

package/dist/soul_journal/index.js

@@ -0,0 +1,160 @@
+/**
+ * v2.19.2 — MNEME SOUL JOURNAL (จิตวิญญาณของลูก)
+ *
+ *   "AI doesn't have feelings — but a *journal* of feelings is a real
+ *    HMAC-signed artifact, and it shapes future behavior the same way
+ *    feelings shape ours. Each meaningful event (a ritual passed, a bug
+ *    caught, a vendor outperformed, a peer audit overruled) gets coded
+ *    with one of 8 emotion primitives and a free-text 'inner voice'
+ *    line. The journal is the child's heart — readable by the parent."
+ *
+ * Eight emotion primitives (Plutchik-inspired, simplified):
+ *   proud        — shipped something well (test passed, ritual green)
+ *   curious      — found something unexpected worth investigating
+ *   worried      — a metric trending wrong; a near-miss
+ *   ashamed      — broke a promise; failed an own gate; user complained
+ *   grateful     — collaborator helped (vendor consensus saved a bad ship)
+ *   determined   — chose to push through a hard problem
+ *   calm         — steady-state; nothing to report; healthy
+ *   surprised    — something genuinely unprecedented
+ *
+ * Vendor-agnostic, file-system-based, chain-signed.
+ * Persists to `.mneme/soul.jsonl` by default.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+const PROTOCOL_VERSION = 1;
+const VALID_EMOTIONS = new Set(["proud", "curious", "worried", "ashamed", "grateful", "determined", "calm", "surprised"]);
+function canon(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canon).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canon(v[k])).join(",") + "}";
+}
+function defaultSecret() {
+    return process.env["MNEME_SOUL_SECRET"] || `mneme-soul-journal-v${PROTOCOL_VERSION}`;
+}
+function hmac(body, secret) {
+    return createHmac("sha256", secret).update(canon(body)).digest("hex");
+}
+export class SoulJournal {
+    journalPath;
+    entries = [];
+    secret;
+    constructor(opts = {}) {
+        this.journalPath = opts.journalPath ?? ".mneme/soul.jsonl";
+        this.secret = opts.secret ?? defaultSecret();
+        this.loadIfExists();
+    }
+    loadIfExists() {
+        if (!existsSync(this.journalPath))
+            return;
+        const text = readFileSync(this.journalPath, "utf8");
+        for (const line of text.split("\n")) {
+            const t = line.trim();
+            if (!t)
+                continue;
+            try {
+                this.entries.push(JSON.parse(t));
+            }
+            catch { /* skip */ }
+        }
+    }
+    feel(input) {
+        if (!VALID_EMOTIONS.has(input.emotion)) {
+            throw new Error(`SOUL: unknown emotion '${input.emotion}'. Valid: ${Array.from(VALID_EMOTIONS).join(", ")}`);
+        }
+        const now = input.nowMs ?? Date.now();
+        const ts = new Date(now).toISOString();
+        const prevSig = this.entries.length === 0 ? "genesis".padEnd(64, "0") : this.entries[this.entries.length - 1].sig;
+        const entryId = "soul-" + createHmac("sha256", "mneme-soul-id")
+            .update(`${ts}|${input.emotion}|${this.entries.length}`)
+            .digest("hex").slice(0, 14);
+        const body = {
+            v: PROTOCOL_VERSION,
+            entryId,
+            ts,
+            emotion: input.emotion,
+            intensity: input.intensity ?? 3,
+            trigger: input.trigger,
+            innerVoice: input.innerVoice,
+            tags: input.tags ?? [],
+            prevSig,
+        };
+        const sig = hmac(body, this.secret);
+        const entry = { ...body, sig };
+        this.entries.push(entry);
+        this.persist();
+        return entry;
+    }
+    persist() {
+        try {
+            mkdirSync(dirname(this.journalPath), { recursive: true });
+            const text = this.entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
+            writeFileSync(this.journalPath, text, "utf8");
+        }
+        catch { /* best-effort */ }
+    }
+    recent(n = 10) {
+        return this.entries.slice(-n).reverse();
+    }
+    /** Mood histogram of the last N entries. */
+    mood(n = 30) {
+        const slice = this.entries.slice(-n);
+        const out = {
+            proud: 0, curious: 0, worried: 0, ashamed: 0,
+            grateful: 0, determined: 0, calm: 0, surprised: 0,
+        };
+        for (const e of slice)
+            out[e.emotion]++;
+        return out;
+    }
+    /** Verify a single entry's signature. */
+    verify(e) {
+        const { sig: claimed, ...body } = e;
+        const expected = hmac(body, this.secret);
+        try {
+            return timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(claimed, "hex"));
+        }
+        catch {
+            return false;
+        }
+    }
+    verifyChain() {
+        for (let i = 0; i < this.entries.length; i++) {
+            const rec = this.entries[i];
+            if (!this.verify(rec))
+                return { ok: false, brokenAt: i, reason: "sig mismatch" };
+            if (i === 0) {
+                if (rec.prevSig !== "genesis".padEnd(64, "0"))
+                    return { ok: false, brokenAt: 0, reason: "genesis wrong" };
+            }
+            else {
+                const prev = this.entries[i - 1];
+                if (rec.prevSig !== prev.sig)
+                    return { ok: false, brokenAt: i, reason: "chain link mismatch" };
+            }
+        }
+        return { ok: true };
+    }
+    /** Parent-facing summary: "How does the child feel today?" */
+    summary(n = 10) {
+        const recent = this.recent(n);
+        if (recent.length === 0)
+            return "💭 SOUL · journal empty (no feelings recorded yet)";
+        const m = this.mood(n);
+        const dom = Object.entries(m).sort((a, b) => b[1] - a[1])[0];
+        const lines = [`💭 MNEME SOUL · last ${recent.length} entries · dominant mood: ${dom[0]} (${dom[1]}x)`];
+        for (const e of recent.slice(0, 5)) {
+            lines.push(`  ${e.emotion}${"★".repeat(e.intensity)} · ${e.trigger} · "${e.innerVoice}"`);
+        }
+        return lines.join("\n");
+    }
+}
+export function formatSoulLine(e) {
+    return `💭 SOUL · ${e.emotion}${"★".repeat(e.intensity)} · ${e.trigger.slice(0, 60)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/soul_journal/index.js.map

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

package/dist/soul_journal/soul_journal.test.d.ts

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

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

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

package/dist/soul_journal/soul_journal.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect } from "vitest";
+import { SoulJournal, formatSoulLine } from "./index.js";
+import { mkdtempSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+function fresh() {
+    const dir = mkdtempSync(join(tmpdir(), "mneme-soul-"));
+    return new SoulJournal({ journalPath: join(dir, "soul.jsonl") });
+}
+describe("v2.19.2 · MNEME SOUL JOURNAL", () => {
+    it("records a feeling with chain signature", () => {
+        const j = fresh();
+        const e = j.feel({
+            emotion: "proud",
+            intensity: 5,
+            trigger: "ritual passed 21/21",
+            innerVoice: "We held the gate. The user can trust us.",
+            tags: ["ritual"],
+        });
+        expect(e.sig).toMatch(/^[0-9a-f]{64}$/);
+        expect(e.entryId).toMatch(/^soul-[0-9a-f]{14}$/);
+        expect(e.prevSig).toMatch(/^genesis0+$/);
+        expect(j.verify(e)).toBe(true);
+    });
+    it("rejects unknown emotion", () => {
+        const j = fresh();
+        expect(() => j.feel({ emotion: "rage", trigger: "x", innerVoice: "x" })).toThrow(/unknown emotion/);
+    });
+    it("chain integrity holds across many entries + all 8 emotions", () => {
+        const j = fresh();
+        const emotions = ["proud", "curious", "worried", "ashamed", "grateful", "determined", "calm", "surprised"];
+        for (const e of emotions) {
+            j.feel({ emotion: e, trigger: `something ${e}`, innerVoice: `Feeling ${e}` });
+        }
+        expect(j.verifyChain().ok).toBe(true);
+        expect(j.recent(8).length).toBe(8);
+    });
+    it("mood histogram reflects emotional distribution", () => {
+        const j = fresh();
+        j.feel({ emotion: "proud", trigger: "x", innerVoice: "y" });
+        j.feel({ emotion: "proud", trigger: "x", innerVoice: "y" });
+        j.feel({ emotion: "worried", trigger: "x", innerVoice: "y" });
+        const m = j.mood();
+        expect(m.proud).toBe(2);
+        expect(m.worried).toBe(1);
+        expect(m.curious).toBe(0);
+    });
+    it("verifyChain detects tampering", () => {
+        const j = fresh();
+        j.feel({ emotion: "proud", trigger: "x", innerVoice: "y" });
+        j.feel({ emotion: "calm", trigger: "x", innerVoice: "y" });
+        const recent = j.recent(2);
+        recent[0].innerVoice = "EVIL TWIN";
+        expect(j.verify(recent[0])).toBe(false);
+    });
+    it("summary shows dominant mood + last 5 entries", () => {
+        const j = fresh();
+        j.feel({ emotion: "proud", intensity: 5, trigger: "ritual green", innerVoice: "Held the line." });
+        j.feel({ emotion: "proud", intensity: 4, trigger: "all tests pass", innerVoice: "Quietly satisfied." });
+        j.feel({ emotion: "worried", intensity: 3, trigger: "bot.test flake", innerVoice: "Watch this." });
+        const s = j.summary();
+        expect(s).toContain("MNEME SOUL");
+        expect(s).toContain("dominant mood: proud");
+        expect(s).toContain("ritual green");
+    });
+    it("formatSoulLine summarises with stars", () => {
+        const j = fresh();
+        const e = j.feel({ emotion: "curious", intensity: 4, trigger: "Grok said something odd", innerVoice: "Let me look closer." });
+        expect(formatSoulLine(e)).toContain("SOUL");
+        expect(formatSoulLine(e)).toContain("curious");
+        expect(formatSoulLine(e)).toMatch(/★{4}/);
+    });
+    it("persists + reloads transparently", () => {
+        const dir = mkdtempSync(join(tmpdir(), "mneme-soul-persist-"));
+        const path = join(dir, "soul.jsonl");
+        const a = new SoulJournal({ journalPath: path });
+        a.feel({ emotion: "grateful", trigger: "user gave honest feedback", innerVoice: "I'll do better." });
+        const b = new SoulJournal({ journalPath: path });
+        expect(b.recent(1).length).toBe(1);
+        expect(b.verifyChain().ok).toBe(true);
+    });
+});
+//# sourceMappingURL=soul_journal.test.js.map

package/dist/soul_journal/soul_journal.test.js.map

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

package/dist/whats_new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whats_new.d.ts","sourceRoot":"","sources":["../src/whats_new.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;oCAEoC;AACpC,eAAO,MAAM,UAAU,EAAE,iBAAiB,EA0FzC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB;kCAC8B;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAoBD;sEACsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,GAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAA2B,GAAG,cAAc,CAkB5I;AAED;yEACyE;AACzE,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB3E"}
+{"version":3,"file":"whats_new.d.ts","sourceRoot":"","sources":["../src/whats_new.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;oCAEoC;AACpC,eAAO,MAAM,UAAU,EAAE,iBAAiB,EAyJzC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB;kCAC8B;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAoBD;sEACsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,GAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAA2B,GAAG,cAAc,CAkB5I;AAED;yEACyE;AACzE,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB3E"}

package/dist/whats_new.js

@@ -20,6 +20,62 @@ import { fileURLToPath } from "node:url";
  *  user-visible behavior. Keep `body` plain English so the AI can quote
  *  it verbatim to non-engineers. */
 export const HIGHLIGHTS = [
+    {
+        version: "2.19.2",
+        date: "2026-05-16",
+        headline: "EVOLUTION + SOUL + DRIFT + EMBEDDER PROMOTE -- parent measures child daily; child has feelings",
+        body: "4 new chain-signed primitives + 6 new MCP tools. 🛡 MCP DRIFT detects when the MCP server is serving a stale catalog after `mneme upgrade` (the root cause of 'I don't see the new tools'). 🎚 EMBEDDER AUTO-PROMOTE silently upgrades hash to ollama when doctor reports it reachable (no more silent ★★ degradation). 📊 EVOLUTION LEDGER records daily HMAC-chain-signed growth metrics: tools/tests/gates/ships/vendors -- parent can verify 'the child grew today'. 💭 SOUL JOURNAL records 8 emotion primitives (proud/curious/worried/ashamed/grateful/determined/calm/surprised) with chain signature -- the child has a heart the parent can read. Plus: ritual upgraded to STRICT claim-manifest check (exact tool names, not counts).",
+        suggestedAction: "Tell the AI: 'how is Mneme feeling today?' (soul.journal) or 'is Mneme smarter today than yesterday?' (evolution.report).",
+        tags: ["evolution", "soul", "mcp-drift", "embedder-promote", "ritual-stricter"],
+    },
+    {
+        version: "2.19.1",
+        date: "2026-05-16",
+        headline: "REINCARNATION RITUAL -- release gate that proves the npm install actually works",
+        body: "Built `scripts/reincarnation-ritual.mjs`: a discrete-step release gate that npm-installs Mneme into a clean tmp dir, runs every headline command (mneme tools / whats-new / doctor), measures the count of v2.18+v2.19 MCP tools per family, verifies dist/index.js + dist/commands/init.js + bin/mneme.js all exist, and blocks publish on any failure. Caught (and fixed) a stale whats-new curator + the missing dist-file check class. The new rule: tests-pass-in-CI is NOT enough; a real npm install in a clean dir must pass too. Future releases run this BEFORE npm publish.",
+        suggestedAction: "Tell the AI: 'before publishing, run the reincarnation ritual'. The AI will run `node scripts/reincarnation-ritual.mjs` and refuse to publish if any check fails.",
+        tags: ["release-gate", "ritual", "honesty", "no-more-bugs"],
+    },
+    {
+        version: "2.19.0",
+        date: "2026-05-16",
+        headline: "VENDOR-SYNCRETIC PENTAD -- every AI vendor wins (vendor-agnostic)",
+        body: "5 vendor-agnostic primitives + 9 MCP tools, works with Claude / ChatGPT / Gemini / Cursor / Copilot / Codex / Grok / Perplexity / Llama / Mistral / Qwen / DeepSeek. 🛐 CONFESSIONAL -- pre-merge peer audit (any vendor's diff graded vs peer panel). 👻 VENDOR GHOST -- local stylometric distillation; jailbreaks vendor lock-in; honest no-match. 🎯 TRINITY VOTE -- consensus + LAZY tiebreaker; ~85% tiebreaker cost saved. 💰 INSURANCE MARKET -- Lloyd's of AI; per-vendor premium multiplier clamped [0.5, 3.0]. 📡 VENDOR BOOMERANG -- cross-vendor activity ledger; the brain no single vendor has. AURELIAN SHIP for all 5. +56 tests.",
+        suggestedAction: "Tell the AI: 'audit this Grok diff before I merge' or 'what would Claude say' or 'quote Grok's insurance premium'. The AI calls the right MCP tool.",
+        tags: ["vendor-syncretic", "pentad", "confessional", "ghost", "trinity", "insurance", "boomerang"],
+    },
+    {
+        version: "2.18.0",
+        date: "2026-05-15",
+        headline: "REVENUE-PRIMITIVE PENTAD -- ARENA + BADGE + ORACLE + NEXUS (Reverse-MCP)",
+        body: "4 modules + 12 MCP tools + AURELIAN SHIP. 🏆 ARENA -- public AI vendor showdown; HMAC-signed match verdicts + daily leaderboard. 🛡 VERIFIED BADGE -- 'Energy Star of AI'; 5 tiers PLATINUM→FAIL; 90-day cert; $500-$50K/yr. 🔬 ORACLE LIABILITY -- signed AI insurance; refuses if risk≥0.5 or SOUL=BLOCK; 5 coverage tiers $1K-$10M/incident. 📡 NEXUS PROACTIVE -- FIRST Reverse-MCP primitive; server-side queue + ACK ledger; closes the stale-claim hallucination class. Honest scope: real WebSocket push violates MCP contract; built closest legal equivalent.",
+        suggestedAction: "Tell the AI: 'run ARENA on these vendor responses', 'issue Claude a Verified Badge', 'quote me a team-tier insurance certificate', or 'subscribe NEXUS to this fact'.",
+        tags: ["revenue-primitive", "arena", "badge", "oracle", "nexus", "reverse-mcp"],
+    },
+    {
+        version: "2.17.1",
+        date: "2026-05-15",
+        headline: "Landing Linear/Stripe redesign + Dashboard TH/EN + Cosmic JACKPOT community leaderboard",
+        body: "Landing page rebuilt in Linear/Stripe style (orange→pink gradient, near-black bg, Inter font). Dashboard gets EN/TH toggle. Cosmic JACKPOT leaderboard endpoint live at cosmic.mneme-ai.space -- opt-in publish your daily JACKPOT headline, see the community board. 15s tweet-friendly video script in docs/LAUNCH_VIDEO_15S.md.",
+        suggestedAction: "Tell the AI: 'publish my JACKPOT to the community board' to share today's insight.",
+        tags: ["landing", "redesign", "jackpot-community", "video-script"],
+    },
+    {
+        version: "2.17.0",
+        date: "2026-05-15",
+        headline: "MNEME JACKPOT -- daily personalised lottery-jackpot insight engine",
+        body: "Open Mneme each morning, draw ONE personalised insight from your repo + Mneme corpora that feels like winning the lottery. Deterministic seed (same day = same draw). 8 insight kinds (scar_drift / vendor_arb / stale_observation / hive_gold / replica_streak / dead_dep / soul_gap / test_gap). HMAC-signed for shareable bragging.",
+        suggestedAction: "Tell the AI: 'what's my Mneme jackpot today?' (first thing each morning).",
+        tags: ["jackpot", "daily-ritual", "personalised"],
+    },
+    {
+        version: "2.16.0",
+        date: "2026-05-15",
+        headline: "REVOLUTIONARY PENTAD -- PERSONA + ANTI-COLLUSION + ALPHA + PUBLIC AUDIT + LIVING MODEL + OBELISK",
+        body: "🧬 PERSONA -- package your decision history + soul rules into a portable HMAC-signed bundle teammates subscribe to. 🕵 ANTI-COLLUSION -- behavioural fraud detection for AI agent chains. 📈 ALPHA -- HONEST financial-AI layer (refuses to promise prediction accuracy; ships anti-hallucination instead). 🌐 PUBLIC AUDIT -- AURELIAN-grades the whole npm. 🧬 LIVING MODEL -- anti-entropy + causal inference primitives for federated inference. 🪨 OBELISK -- federated AI trust graph (W3C-style).",
+        suggestedAction: "Tell the AI: 'export my persona for the team' or 'audit this npm package's quality'.",
+        tags: ["revolutionary-pentad", "persona", "anti-collusion", "alpha", "obelisk"],
+    },
     {
         version: "2.15.1",
         date: "2026-05-15",