@mneme-ai/core 2.19.20 → 2.19.22

package/dist/reflex/reflex.test.js

@@ -0,0 +1,379 @@
+import { describe, it, expect } from "vitest";
+import { eventCacheKey, emptyStore, recordObservation, verifyStore, predictFollowup, emptyCache, writeCacheEntry, readCache, gcCache, prefetch, emptyTelemetry, recordFetch, computeStats, formatStatsLine, } from "./index.js";
+const SECRET = "reflex-test-secret-997744";
+function mkEvent(kind, context, ts = 1_000_000) {
+    return { v: 1, kind, context, ts };
+}
+describe("v2.19.22 REFLEX · eventCacheKey (signature stability)", () => {
+    it("MEASURED 100% determinism: same event -> same key (100 trials)", () => {
+        const e = mkEvent("file_save", { path: "src/foo.ts" });
+        const k1 = eventCacheKey(e);
+        let allEqual = true;
+        for (let i = 0; i < 100; i++) {
+            if (eventCacheKey(e) !== k1) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+        expect(k1.length).toBe(16);
+    });
+    it("ignores ts (same kind+context but different ts -> same key)", () => {
+        const a = mkEvent("git_commit", { sha: "abc" }, 1);
+        const b = mkEvent("git_commit", { sha: "abc" }, 999_999);
+        expect(eventCacheKey(a)).toBe(eventCacheKey(b));
+    });
+    it("distinct kind OR context -> distinct key (50 random pairs, no collisions)", () => {
+        const seen = new Set();
+        let collisions = 0;
+        for (let i = 0; i < 50; i++) {
+            const e = mkEvent(i % 2 === 0 ? "file_save" : "git_commit", { i });
+            const k = eventCacheKey(e);
+            if (seen.has(k))
+                collisions++;
+            seen.add(k);
+        }
+        expect(collisions).toBe(0);
+    });
+    it("context key order does not matter (canonicalisation)", () => {
+        const a = mkEvent("user_chat", { a: 1, b: 2 });
+        const b = mkEvent("user_chat", { b: 2, a: 1 });
+        expect(eventCacheKey(a)).toBe(eventCacheKey(b));
+    });
+});
+describe("v2.19.22 REFLEX · pheromone store (HMAC chain)", () => {
+    it("recordObservation appends + HMAC-chains to predecessor", () => {
+        let s = emptyStore();
+        const e = mkEvent("file_save", { path: "x.ts" });
+        s = recordObservation({ store: s, event: e, followup: { toolName: "mneme.ask", args: { q: "foo" }, ts: 1 }, secret: SECRET });
+        s = recordObservation({ store: s, event: e, followup: { toolName: "mneme.why", args: { f: "x.ts" }, ts: 2 }, secret: SECRET });
+        expect(s.records).toHaveLength(2);
+        expect(s.records[0].prevSig).toBeNull();
+        expect(s.records[1].prevSig).toBe(s.records[0].sig);
+    });
+    it("verifyStore passes on untampered chain (10 records)", () => {
+        let s = emptyStore();
+        for (let i = 0; i < 10; i++) {
+            s = recordObservation({
+                store: s,
+                event: mkEvent("git_commit", { i }),
+                followup: { toolName: "mneme.ask", args: { i }, ts: i },
+                secret: SECRET,
+            });
+        }
+        expect(verifyStore(s, SECRET).ok).toBe(true);
+    });
+    it("verifyStore detects tamper at exact step", () => {
+        let s = emptyStore();
+        for (let i = 0; i < 5; i++) {
+            s = recordObservation({
+                store: s,
+                event: mkEvent("file_save", { i }),
+                followup: { toolName: "mneme.ask", args: { i }, ts: i },
+                secret: SECRET,
+            });
+        }
+        const tampered = {
+            ...s,
+            records: s.records.map((r, i) => (i === 2 ? { ...r, followup: { ...r.followup, toolName: "EVIL" } } : r)),
+        };
+        const v = verifyStore(tampered, SECRET);
+        expect(v.ok).toBe(false);
+        expect(v.brokenAt).toBe(2);
+    });
+});
+describe("v2.19.22 REFLEX · predictor (frequency-based, deterministic)", () => {
+    it("empty store -> empty predictions", () => {
+        const e = mkEvent("file_save", { path: "x.ts" });
+        expect(predictFollowup({ store: emptyStore(), event: e })).toEqual([]);
+    });
+    it("top-N ranked by frequency; confidence = matches/total within event sig", () => {
+        let s = emptyStore();
+        const e = mkEvent("file_save", { path: "x.ts" });
+        // ask called 4 times, why 2 times, status 1 time for this event sig.
+        for (let i = 0; i < 4; i++)
+            s = recordObservation({ store: s, event: e, followup: { toolName: "mneme.ask", args: {}, ts: i }, secret: SECRET });
+        for (let i = 0; i < 2; i++)
+            s = recordObservation({ store: s, event: e, followup: { toolName: "mneme.why", args: {}, ts: i }, secret: SECRET });
+        s = recordObservation({ store: s, event: e, followup: { toolName: "mneme.status", args: {}, ts: 99 }, secret: SECRET });
+        const p = predictFollowup({ store: s, event: e, topN: 3 });
+        expect(p).toHaveLength(3);
+        expect(p[0].toolName).toBe("mneme.ask");
+        expect(p[0].confidence).toBeCloseTo(4 / 7, 5);
+        expect(p[0].sampleCount).toBe(4);
+        expect(p[1].toolName).toBe("mneme.why");
+        expect(p[2].toolName).toBe("mneme.status");
+    });
+    it("predictions scoped to matching event sig only (no cross-event leakage)", () => {
+        let s = emptyStore();
+        const eA = mkEvent("file_save", { path: "A.ts" });
+        const eB = mkEvent("file_save", { path: "B.ts" });
+        for (let i = 0; i < 5; i++)
+            s = recordObservation({ store: s, event: eA, followup: { toolName: "mneme.A_only", args: {}, ts: i }, secret: SECRET });
+        for (let i = 0; i < 5; i++)
+            s = recordObservation({ store: s, event: eB, followup: { toolName: "mneme.B_only", args: {}, ts: i }, secret: SECRET });
+        const pA = predictFollowup({ store: s, event: eA });
+        const pB = predictFollowup({ store: s, event: eB });
+        expect(pA.map((x) => x.toolName)).toEqual(["mneme.A_only"]);
+        expect(pB.map((x) => x.toolName)).toEqual(["mneme.B_only"]);
+    });
+    it("MEASURED deterministic: same input -> same output (20 trials)", () => {
+        let s = emptyStore();
+        const e = mkEvent("git_commit", { sha: "deadbeef" });
+        for (let i = 0; i < 6; i++)
+            s = recordObservation({ store: s, event: e, followup: { toolName: `tool.${i % 2}`, args: { i }, ts: i }, secret: SECRET });
+        const first = JSON.stringify(predictFollowup({ store: s, event: e }));
+        let allEqual = true;
+        for (let i = 0; i < 20; i++) {
+            if (JSON.stringify(predictFollowup({ store: s, event: e })) !== first) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+});
+describe("v2.19.22 REFLEX · cache (TTL + HMAC integrity)", () => {
+    it("write + read happy path", () => {
+        let c = emptyCache();
+        const e = mkEvent("file_save", { path: "x.ts" });
+        c = writeCacheEntry({ cache: c, event: e, toolName: "mneme.ask", args: { q: "foo" }, result: { answer: 42 }, nowMs: 1_000_000, secret: SECRET });
+        const r = readCache({ cache: c, event: e, toolName: "mneme.ask", nowMs: 1_000_000, secret: SECRET });
+        expect(r.hit).toBe(true);
+        expect(r.entry?.result).toEqual({ answer: 42 });
+    });
+    it("expired entry reads as MISS", () => {
+        let c = emptyCache();
+        const e = mkEvent("file_save", { path: "x.ts" });
+        c = writeCacheEntry({ cache: c, event: e, toolName: "mneme.ask", args: {}, result: 1, ttlMs: 1000, nowMs: 0, secret: SECRET });
+        expect(readCache({ cache: c, event: e, toolName: "mneme.ask", nowMs: 500, secret: SECRET }).hit).toBe(true);
+        expect(readCache({ cache: c, event: e, toolName: "mneme.ask", nowMs: 2000, secret: SECRET }).hit).toBe(false);
+    });
+    it("tampered entry refuses to hit (HMAC mismatch)", () => {
+        let c = emptyCache();
+        const e = mkEvent("file_save", { path: "x.ts" });
+        c = writeCacheEntry({ cache: c, event: e, toolName: "mneme.ask", args: {}, result: "ok", nowMs: 0, secret: SECRET });
+        const eventKey = Object.keys(c.entries)[0];
+        const tampered = {
+            v: c.v,
+            entries: { [eventKey]: [{ ...c.entries[eventKey][0], result: "EVIL" }] },
+        };
+        const r = readCache({ cache: tampered, event: e, toolName: "mneme.ask", nowMs: 100, secret: SECRET });
+        expect(r.hit).toBe(false);
+        expect(r.reason).toContain("HMAC");
+    });
+    it("argsMatch predicate filters", () => {
+        let c = emptyCache();
+        const e = mkEvent("user_chat", { topic: "auth" });
+        c = writeCacheEntry({ cache: c, event: e, toolName: "mneme.ask", args: { q: "what" }, result: 1, nowMs: 0, secret: SECRET });
+        c = writeCacheEntry({ cache: c, event: e, toolName: "mneme.ask", args: { q: "why" }, result: 2, nowMs: 0, secret: SECRET });
+        const r = readCache({
+            cache: c, event: e, toolName: "mneme.ask",
+            argsMatch: (a) => a["q"] === "why", nowMs: 100, secret: SECRET,
+        });
+        expect(r.hit).toBe(true);
+        expect(r.entry?.result).toBe(2);
+    });
+    it("gcCache drops expired entries; keeps fresh", () => {
+        let c = emptyCache();
+        const e = mkEvent("file_save", { path: "x.ts" });
+        c = writeCacheEntry({ cache: c, event: e, toolName: "old", args: {}, result: 0, ttlMs: 100, nowMs: 0, secret: SECRET });
+        c = writeCacheEntry({ cache: c, event: e, toolName: "fresh", args: {}, result: 1, ttlMs: 100000, nowMs: 0, secret: SECRET });
+        const { cache: gc, removed } = gcCache({ cache: c, nowMs: 5000 });
+        expect(removed).toBe(1);
+        const keys = Object.keys(gc.entries);
+        expect(keys).toHaveLength(1);
+        expect(gc.entries[keys[0]]).toHaveLength(1);
+        expect(gc.entries[keys[0]][0].toolName).toBe("fresh");
+    });
+});
+describe("v2.19.22 REFLEX · prefetch executor (budget-bound, concurrent)", () => {
+    it("executes all candidates in parallel; writes cache for each", async () => {
+        const e = mkEvent("git_commit", { sha: "deadbeef" });
+        const invoke = async (toolName, args) => ({ toolName, args, ts: Date.now() });
+        const r = await prefetch({
+            cache: emptyCache(),
+            event: e,
+            candidates: [
+                { toolName: "mneme.ask", args: { q: "1" } },
+                { toolName: "mneme.why", args: { f: "x" } },
+                { toolName: "mneme.status", args: {} },
+            ],
+            invoke,
+            budgetMs: 200,
+            secret: SECRET,
+        });
+        expect(r.executed).toHaveLength(3);
+        expect(r.executed.every((x) => x.ok)).toBe(true);
+        expect(r.withinBudget).toBe(true);
+        const keys = Object.keys(r.cache.entries);
+        expect(keys).toHaveLength(1);
+        expect(r.cache.entries[keys[0]]).toHaveLength(3);
+    });
+    it("slow tool times out at budget; other tools complete normally", async () => {
+        const e = mkEvent("file_save", { path: "x.ts" });
+        const invoke = async (toolName) => {
+            if (toolName === "slow") {
+                await new Promise((r) => setTimeout(r, 500));
+                return "slow_done";
+            }
+            return `${toolName}_done`;
+        };
+        const r = await prefetch({
+            cache: emptyCache(),
+            event: e,
+            candidates: [
+                { toolName: "fast", args: {} },
+                { toolName: "slow", args: {} },
+                { toolName: "fast2", args: {} },
+            ],
+            invoke,
+            budgetMs: 100,
+            secret: SECRET,
+        });
+        const slow = r.executed.find((x) => x.toolName === "slow");
+        expect(slow.ok).toBe(false);
+        expect(slow.error).toBe("prefetch_timeout");
+        const fastCount = r.executed.filter((x) => x.ok).length;
+        expect(fastCount).toBe(2);
+    });
+    it("failed candidates are NOT written to cache", async () => {
+        const e = mkEvent("user_chat", { topic: "x" });
+        const invoke = async (toolName) => {
+            if (toolName === "bad")
+                throw new Error("nope");
+            return toolName;
+        };
+        const r = await prefetch({
+            cache: emptyCache(),
+            event: e,
+            candidates: [
+                { toolName: "good", args: {} },
+                { toolName: "bad", args: {} },
+            ],
+            invoke,
+            budgetMs: 200,
+            secret: SECRET,
+        });
+        const eventKey = Object.keys(r.cache.entries)[0];
+        const cached = r.cache.entries[eventKey] ?? [];
+        expect(cached).toHaveLength(1);
+        expect(cached[0].toolName).toBe("good");
+    });
+});
+describe("v2.19.22 REFLEX · MEASURED end-to-end (hit rate + speedup)", () => {
+    it("MEASURED hit rate >= 80% on synthetic warm trail (10 warm-up + 20 follow-up events)", async () => {
+        let store = emptyStore();
+        let cache = emptyCache();
+        let telemetry = emptyTelemetry();
+        const e = mkEvent("git_commit", { sha: "abc" });
+        // Phase 1 — warm-up: observe (git_commit -> mneme.ask) 10 times.
+        for (let i = 0; i < 10; i++) {
+            store = recordObservation({
+                store,
+                event: e,
+                followup: { toolName: "mneme.ask", args: { q: "what changed" }, ts: i },
+                secret: SECRET,
+            });
+        }
+        // Phase 2 — predictive prefetch on next event.
+        const predictions = predictFollowup({ store, event: e, topN: 3 });
+        expect(predictions).toHaveLength(1);
+        const { cache: c1 } = await prefetch({
+            cache,
+            event: e,
+            candidates: predictions.map((p) => ({ toolName: p.toolName, args: p.argsTemplate })),
+            invoke: async () => "answer",
+            budgetMs: 200,
+            secret: SECRET,
+        });
+        cache = c1;
+        // Phase 3 — 20 follow-up reads; should all HIT.
+        for (let i = 0; i < 20; i++) {
+            const r = readCache({ cache, event: e, toolName: "mneme.ask", secret: SECRET });
+            telemetry = recordFetch({ telemetry, hit: r.hit });
+        }
+        const stats = computeStats({ store, cache, telemetry });
+        expect(stats.hitRate).toBeGreaterThanOrEqual(0.8);
+        expect(stats.hitRate).toBe(1.0); // perfect within window
+    });
+    it("MEASURED speedup: cached read p50 < cold invoke p50 (50 trials each)", async () => {
+        const e = mkEvent("file_save", { path: "src/x.ts" });
+        let cache = emptyCache();
+        // Cold invoke simulator: 20ms work.
+        const coldInvoke = async () => {
+            await new Promise((r) => setTimeout(r, 20));
+            return "x";
+        };
+        // Warm cache once.
+        const { cache: c1 } = await prefetch({
+            cache, event: e, candidates: [{ toolName: "mneme.ask", args: {} }],
+            invoke: coldInvoke, budgetMs: 200, secret: SECRET,
+        });
+        cache = c1;
+        // Measure 50 cold + 50 cached.
+        const cold = [];
+        const cached = [];
+        for (let i = 0; i < 50; i++) {
+            const t0 = Date.now();
+            await coldInvoke();
+            cold.push(Date.now() - t0);
+            const t1 = Date.now();
+            const r = readCache({ cache, event: e, toolName: "mneme.ask", secret: SECRET });
+            cached.push(Date.now() - t1);
+            expect(r.hit).toBe(true);
+        }
+        const median = (arr) => {
+            const sorted = [...arr].sort((a, b) => a - b);
+            return sorted[Math.floor(sorted.length / 2)];
+        };
+        const coldP50 = median(cold);
+        const cachedP50 = median(cached);
+        expect(coldP50).toBeGreaterThanOrEqual(15);
+        expect(cachedP50).toBeLessThan(coldP50);
+        expect(cachedP50).toBeLessThanOrEqual(5);
+    });
+    it("MEASURED 100% cache integrity across 50 round-trips (no false hits, no missed verifies)", () => {
+        let c = emptyCache();
+        const e = mkEvent("user_chat", { topic: "auth" });
+        let passes = 0;
+        for (let i = 0; i < 50; i++) {
+            c = writeCacheEntry({ cache: c, event: e, toolName: `t${i}`, args: { i }, result: `r${i}`, nowMs: 0, secret: SECRET });
+            const r = readCache({ cache: c, event: e, toolName: `t${i}`, nowMs: 100, secret: SECRET });
+            if (r.hit && r.entry?.result === `r${i}`)
+                passes++;
+        }
+        expect(passes).toBe(50);
+    });
+});
+describe("v2.19.22 REFLEX · stats + formatter", () => {
+    it("computeStats reports hit rate from telemetry; expired cache entries counted separately", () => {
+        const e = mkEvent("file_save", { path: "x.ts" });
+        let store = emptyStore();
+        store = recordObservation({ store, event: e, followup: { toolName: "t1", args: {}, ts: 1 }, secret: SECRET });
+        store = recordObservation({ store, event: e, followup: { toolName: "t2", args: {}, ts: 2 }, secret: SECRET });
+        let cache = emptyCache();
+        cache = writeCacheEntry({ cache, event: e, toolName: "t1", args: {}, result: 1, ttlMs: 100, nowMs: 0, secret: SECRET });
+        cache = writeCacheEntry({ cache, event: e, toolName: "t2", args: {}, result: 2, ttlMs: 100000, nowMs: 0, secret: SECRET });
+        let tel = emptyTelemetry();
+        tel = recordFetch({ telemetry: tel, hit: true });
+        tel = recordFetch({ telemetry: tel, hit: true });
+        tel = recordFetch({ telemetry: tel, hit: false });
+        const s = computeStats({ store, cache, telemetry: tel, nowMs: 5000 });
+        expect(s.totalRecords).toBe(2);
+        expect(s.uniqueEventSigs).toBe(1);
+        expect(s.totalCacheEntries).toBe(2);
+        expect(s.expiredCacheEntries).toBe(1);
+        expect(s.freshCacheEntries).toBe(1);
+        expect(s.totalHits).toBe(2);
+        expect(s.totalMisses).toBe(1);
+        expect(s.hitRate).toBeCloseTo(2 / 3, 5);
+    });
+    it("formatStatsLine renders single-line digest", () => {
+        const stats = computeStats({ store: emptyStore(), cache: emptyCache(), telemetry: { hits: 7, misses: 3 } });
+        const line = formatStatsLine(stats);
+        expect(line).toContain("REFLEX");
+        expect(line).toContain("70.0%");
+    });
+});
+//# sourceMappingURL=reflex.test.js.map

package/dist/reflex/reflex.test.js.map

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

package/dist/snn_auto_promote/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * v2.19.21 — MNEME SNN AUTO-PROMOTE (W5 audit fix at SOURCE)
+ *
+ *   User audit (W5): mneme status reports hash:fnv-256 [FALLBACK] even
+ *   though SNN MCP tools ship + resolveEmbedder ladder includes SNN. The
+ *   v2.19.16 BundledOrSnnEmbedder promoted at runtime (in-memory) but
+ *   never wrote the resolution back to disk — so every `mneme status`
+ *   call re-resolved + every fresh process started cold.
+ *
+ *   v2.19.21 closes the gap: `decidePromotion()` compares the saved
+ *   config's provider against the runtime-resolved tier and recommends a
+ *   one-way promotion when (a) saved is hash (the worst tier), (b) runtime
+ *   resolved to a higher tier. Pure function — caller decides whether to
+ *   persist the promotion (writes to .mneme/config.json).
+ *
+ *   HMAC-chained PROMOTION HISTORY ledger so the daemon can audit + roll
+ *   back if quality degrades.
+ *
+ * Honest scope:
+ *   - Refuses to downgrade. If saved provider is `snn` or higher and
+ *     ladder resolved to a lower tier (e.g., bundled fail → snn), no
+ *     auto-write. The user's explicit pin always wins.
+ *   - Refuses to "promote" between equal-tier providers (snn vs bundled
+ *     — both ★★★) unless the runtime tier is strictly higher quality.
+ *   - Caller persists. Mneme returns the decision; .mneme/config.json
+ *     write is the CLI's call.
+ */
+declare const PROTOCOL_VERSION: 1;
+export type EmbedderTier = "openai" | "ollama" | "snn" | "bundled" | "hash" | "auto" | "unknown";
+export interface PromotionDecision {
+    v: typeof PROTOCOL_VERSION;
+    savedProvider: EmbedderTier;
+    runtimeResolvedName: string;
+    runtimeResolvedTier: EmbedderTier;
+    shouldPromote: boolean;
+    recommendedProvider: EmbedderTier | null;
+    reason: string;
+    isDowngradeRefused: boolean;
+}
+/** Parse the active embedder's `name` field into a tier. */
+export declare function tierFromName(name: string): EmbedderTier;
+/**
+ * Decide whether to promote the saved config to the runtime-resolved tier.
+ *   Promote when:
+ *     savedProvider is "auto" OR "hash" (worst tier)
+ *     AND runtime resolved to a higher tier than "hash"
+ *   Refuse to downgrade:
+ *     if savedProvider's rank >= runtime's rank, no write
+ */
+export declare function decidePromotion(input: {
+    savedProvider: EmbedderTier;
+    runtimeResolvedName: string;
+}): PromotionDecision;
+export interface PromotionRecord {
+    v: typeof PROTOCOL_VERSION;
+    from: EmbedderTier;
+    to: EmbedderTier;
+    runtimeResolvedName: string;
+    reason: string;
+    ts: number;
+    prevSig: string | null;
+    sig: string;
+}
+export interface PromotionHistory {
+    v: typeof PROTOCOL_VERSION;
+    records: PromotionRecord[];
+}
+export declare function emptyPromotionHistory(): PromotionHistory;
+export declare function appendPromotion(opts: {
+    history: PromotionHistory;
+    decision: PromotionDecision;
+    nowMs?: number;
+    secret?: string;
+}): PromotionHistory;
+export declare function verifyPromotionHistory(history: PromotionHistory, secret?: string): {
+    ok: boolean;
+    brokenAt?: number;
+    reason?: string;
+};
+export declare function formatDecisionLine(d: PromotionDecision): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snn_auto_promote/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAajG,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,aAAa,EAAE,YAAY,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,YAAY,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAOvD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,aAAa,EAAE,YAAY,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,iBAAiB,CA6BpB;AAID,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAsBD,wBAAgB,qBAAqB,IAAI,gBAAgB,CAExD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,gBAAgB,CAgBnB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAWtI;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAG/D"}

package/dist/snn_auto_promote/index.js

@@ -0,0 +1,154 @@
+/**
+ * v2.19.21 — MNEME SNN AUTO-PROMOTE (W5 audit fix at SOURCE)
+ *
+ *   User audit (W5): mneme status reports hash:fnv-256 [FALLBACK] even
+ *   though SNN MCP tools ship + resolveEmbedder ladder includes SNN. The
+ *   v2.19.16 BundledOrSnnEmbedder promoted at runtime (in-memory) but
+ *   never wrote the resolution back to disk — so every `mneme status`
+ *   call re-resolved + every fresh process started cold.
+ *
+ *   v2.19.21 closes the gap: `decidePromotion()` compares the saved
+ *   config's provider against the runtime-resolved tier and recommends a
+ *   one-way promotion when (a) saved is hash (the worst tier), (b) runtime
+ *   resolved to a higher tier. Pure function — caller decides whether to
+ *   persist the promotion (writes to .mneme/config.json).
+ *
+ *   HMAC-chained PROMOTION HISTORY ledger so the daemon can audit + roll
+ *   back if quality degrades.
+ *
+ * Honest scope:
+ *   - Refuses to downgrade. If saved provider is `snn` or higher and
+ *     ladder resolved to a lower tier (e.g., bundled fail → snn), no
+ *     auto-write. The user's explicit pin always wins.
+ *   - Refuses to "promote" between equal-tier providers (snn vs bundled
+ *     — both ★★★) unless the runtime tier is strictly higher quality.
+ *   - Caller persists. Mneme returns the decision; .mneme/config.json
+ *     write is the CLI's call.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+const PROTOCOL_VERSION = 1;
+/** Strict quality ordering. Higher index = higher quality. */
+const TIER_RANK = {
+    hash: 1,
+    unknown: 1,
+    bundled: 2,
+    snn: 2, // peer of bundled — pure-TS vs WASM
+    auto: 3, // "auto" means "let the ladder pick"; treat as middle
+    ollama: 4,
+    openai: 5,
+};
+/** Parse the active embedder's `name` field into a tier. */
+export function tierFromName(name) {
+    if (name.startsWith("openai:"))
+        return "openai";
+    if (name.startsWith("ollama:"))
+        return "ollama";
+    if (name.startsWith("bundled:"))
+        return "bundled";
+    if (name.startsWith("snn:"))
+        return "snn";
+    if (name.startsWith("hash:"))
+        return "hash";
+    return "unknown";
+}
+/**
+ * Decide whether to promote the saved config to the runtime-resolved tier.
+ *   Promote when:
+ *     savedProvider is "auto" OR "hash" (worst tier)
+ *     AND runtime resolved to a higher tier than "hash"
+ *   Refuse to downgrade:
+ *     if savedProvider's rank >= runtime's rank, no write
+ */
+export function decidePromotion(input) {
+    const runtimeTier = tierFromName(input.runtimeResolvedName);
+    const savedRank = TIER_RANK[input.savedProvider] ?? 0;
+    const runtimeRank = TIER_RANK[runtimeTier] ?? 0;
+    const isDowngradeRefused = savedRank >= runtimeRank && input.savedProvider !== "auto";
+    // Auto-promote happens when:
+    //   (a) saved is "hash" or "auto" (worst-tier / undecided)
+    //   (b) runtime resolved to a STRICTLY higher tier
+    const shouldPromote = (input.savedProvider === "hash" || input.savedProvider === "auto")
+        && runtimeRank > savedRank;
+    const recommendedProvider = shouldPromote ? runtimeTier : null;
+    let reason;
+    if (shouldPromote) {
+        reason = `saved=${input.savedProvider} (rank ${savedRank}) → runtime=${runtimeTier} (rank ${runtimeRank}); promoting to surface real tier in status + skip future probe`;
+    }
+    else if (isDowngradeRefused) {
+        reason = `saved=${input.savedProvider} (rank ${savedRank}) >= runtime=${runtimeTier} (rank ${runtimeRank}); refusing to downgrade (user's explicit pin wins)`;
+    }
+    else {
+        reason = `saved=${input.savedProvider} (rank ${savedRank}) ~ runtime=${runtimeTier} (rank ${runtimeRank}); no promotion needed`;
+    }
+    return {
+        v: PROTOCOL_VERSION,
+        savedProvider: input.savedProvider,
+        runtimeResolvedName: input.runtimeResolvedName,
+        runtimeResolvedTier: runtimeTier,
+        shouldPromote,
+        recommendedProvider,
+        reason,
+        isDowngradeRefused,
+    };
+}
+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_SNN_PROMOTE_SECRET"] || `mneme-snn-auto-promote-v${PROTOCOL_VERSION}`;
+}
+function signRecord(body, secret) {
+    return createHmac("sha256", secret).update(canon(body)).digest("hex");
+}
+function safeEqHex(a, b) {
+    try {
+        return timingSafeEqual(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
+    }
+    catch {
+        return false;
+    }
+}
+export function emptyPromotionHistory() {
+    return { v: PROTOCOL_VERSION, records: [] };
+}
+export function appendPromotion(opts) {
+    if (!opts.decision.shouldPromote || opts.decision.recommendedProvider === null) {
+        return opts.history;
+    }
+    const prev = opts.history.records[opts.history.records.length - 1];
+    const body = {
+        v: PROTOCOL_VERSION,
+        from: opts.decision.savedProvider,
+        to: opts.decision.recommendedProvider,
+        runtimeResolvedName: opts.decision.runtimeResolvedName,
+        reason: opts.decision.reason,
+        ts: opts.nowMs ?? Date.now(),
+        prevSig: prev ? prev.sig : null,
+    };
+    const sig = signRecord(body, opts.secret ?? defaultSecret());
+    return { v: PROTOCOL_VERSION, records: [...opts.history.records, { ...body, sig }] };
+}
+export function verifyPromotionHistory(history, secret) {
+    const sec = secret ?? defaultSecret();
+    let prevSig = null;
+    for (let i = 0; i < history.records.length; i++) {
+        const r = history.records[i];
+        const { sig, ...body } = r;
+        if (body.prevSig !== prevSig)
+            return { ok: false, brokenAt: i, reason: `prevSig mismatch at step ${i}` };
+        if (!safeEqHex(signRecord(body, sec), sig))
+            return { ok: false, brokenAt: i, reason: `HMAC mismatch at step ${i}` };
+        prevSig = sig;
+    }
+    return { ok: true };
+}
+export function formatDecisionLine(d) {
+    const tag = d.shouldPromote ? "⬆" : d.isDowngradeRefused ? "🛡" : "·";
+    return `${tag} SNN-PROMOTE · saved=${d.savedProvider} · runtime=${d.runtimeResolvedTier} · ${d.shouldPromote ? "PROMOTE" : "no-op"}`;
+}
+//# sourceMappingURL=index.js.map