@mneme-ai/core 2.19.10 → 2.19.12

package/dist/mortal_wrappers/mortal_wrappers.test.js

@@ -0,0 +1,372 @@
+import { describe, it, expect } from "vitest";
+import { birthMortalWrapper, mutateSignature, tickReincarnation, resolveMortalCall, recordCalibration, calibrationScore, globalStats, verifyMortalWrapper, emptyState, formatWrapperLine, } from "./index.js";
+const SECRET = "test-mortal-secret-9991122";
+const ARGS = ["topic", "limit", "outputFormat"];
+function newBorn(opts = { now: 1_000_000 }) {
+    return birthMortalWrapper({
+        baseToolName: opts.base ?? "mneme.arena.judge",
+        baseArgs: ARGS,
+        ttlMs: opts.ttl ?? 1000,
+        deprecationGravityMs: opts.gravity ?? 500,
+        nowMs: opts.now,
+        secret: SECRET,
+    });
+}
+describe("v2.19.11 MORTAL WRAPPERS · birth", () => {
+    it("births a generation-1 wrapper with alive=true, hmac-signed, alias suffixed gen1", () => {
+        const w = newBorn({ now: 1_000_000 });
+        expect(w.generation).toBe(1);
+        expect(w.parentGeneration).toBeNull();
+        expect(w.alive).toBe(true);
+        expect(w.deprecatedUntil).toBeNull();
+        expect(w.signature.alias).toBe("mneme.mortal.arena.judge.gen1");
+        expect(Object.keys(w.signature.argRenameMap).sort()).toEqual(ARGS.slice().sort());
+        expect(w.signature.argOrder).toEqual(ARGS);
+        expect(w.expiresAt).toBe(w.birthAt + w.ttlMs);
+        const v = verifyMortalWrapper(w, SECRET);
+        expect(v.ok).toBe(true);
+    });
+    it("rejects forged hmac", () => {
+        const w = newBorn();
+        const forged = { ...w, hmac: "deadbeef".repeat(8) };
+        expect(verifyMortalWrapper(forged, SECRET).ok).toBe(false);
+    });
+    it("birthing two wrappers for the same base at different times produces different IDs", () => {
+        const a = newBorn({ now: 1_000_000 });
+        const b = newBorn({ now: 1_000_001 });
+        expect(a.id).not.toBe(b.id);
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · mutateSignature", () => {
+    it("rename_optional_field renames an arg and updates argOrder", () => {
+        const w = newBorn();
+        const out = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 2,
+            kind: "rename_optional_field",
+            rng: () => 0.0, // pick first lexicographic
+        });
+        expect(out.alias).toBe("mneme.mortal.arena.judge.gen2");
+        // One key is renamed with _g2 suffix
+        const renamed = Object.keys(out.argRenameMap).filter((k) => k.endsWith("_g2"));
+        expect(renamed.length).toBe(1);
+        // The renamed key still maps to a canonical base arg
+        expect(ARGS).toContain(out.argRenameMap[renamed[0]]);
+        // argOrder reflects the rename (no canonical version remains for that slot)
+        expect(out.argOrder).toContain(renamed[0]);
+    });
+    it("add_optional_param appends a drift_gN_xxx param", () => {
+        const w = newBorn();
+        const out = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 3,
+            kind: "add_optional_param",
+            rng: () => 0.5,
+        });
+        expect(out.addedOptionalParams.length).toBe(1);
+        const fresh = out.addedOptionalParams[0];
+        expect(fresh.startsWith("_drift_g3_")).toBe(true);
+        expect(out.argOrder).toContain(fresh);
+    });
+    it("swap_arg_order reorders two positions", () => {
+        const w = newBorn();
+        const out = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 4,
+            kind: "swap_arg_order",
+            rng: (() => { let i = 0; return () => [0.0, 0.99][i++]; })(),
+        });
+        // First and last swapped (rng → 0 and ~end)
+        expect(out.argOrder).not.toEqual(ARGS);
+        // But the same SET of args is preserved
+        expect([...out.argOrder].sort()).toEqual([...ARGS].sort());
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · tickReincarnation", () => {
+    function stateWith(wrappers) {
+        return { v: 1, wrappers, calibration: [] };
+    }
+    it("does nothing when no wrappers have expired", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 10_000 });
+        const out = tickReincarnation({
+            state: stateWith([w]),
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_000_001, // far before expiry
+            rngSeed: 42,
+            secret: SECRET,
+        });
+        expect(out.expired.length).toBe(0);
+        expect(out.reincarnated.length).toBe(0);
+        expect(out.state.wrappers.length).toBe(1);
+        expect(out.state.wrappers[0].alive).toBe(true);
+    });
+    it("expires and reincarnates exactly one wrapper at expiry boundary", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const out = tickReincarnation({
+            state: stateWith([w]),
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000, // at expiry
+            rngSeed: 7,
+            secret: SECRET,
+        });
+        expect(out.expired.length).toBe(1);
+        expect(out.reincarnated.length).toBe(1);
+        // Parent is now deprecated, child is gen2 with parentGeneration=1
+        const parent = out.state.wrappers.find((x) => x.id === w.id);
+        expect(parent.alive).toBe(false);
+        expect(parent.deprecatedUntil).toBe(1_001_000 + 500);
+        const child = out.reincarnated[0];
+        expect(child.generation).toBe(2);
+        expect(child.parentGeneration).toBe(1);
+        expect(child.alive).toBe(true);
+        expect(child.mutationsApplied.length).toBe(1);
+        // Parent's new HMAC is valid (re-signed on deprecation)
+        expect(verifyMortalWrapper(parent, SECRET).ok).toBe(true);
+        expect(verifyMortalWrapper(child, SECRET).ok).toBe(true);
+    });
+    it("budget caps mutations per tick to MAX_TICK_BATCH=3 (even if 5 are due)", () => {
+        const bases = ["mneme.a.x", "mneme.b.y", "mneme.c.z", "mneme.d.w", "mneme.e.v"];
+        const wrappers = bases.map((b) => newBorn({ now: 1_000_000, ttl: 1000, gravity: 500, base: b }));
+        const out = tickReincarnation({
+            state: stateWith(wrappers),
+            baseToolArgs: Object.fromEntries(bases.map((b) => [b, ARGS])),
+            nowMs: 1_001_000,
+            budget: 10, // user asks for many but cap is 3
+            rngSeed: 1,
+            secret: SECRET,
+        });
+        expect(out.reincarnated.length).toBe(3);
+        expect(out.expired.length).toBe(3);
+    });
+    it("drops deprecated wrappers after their gravity window elapses", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const t1 = tickReincarnation({
+            state: stateWith([w]),
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000,
+            rngSeed: 1,
+            secret: SECRET,
+        });
+        // Parent expires at 1_001_500. Tick again after that.
+        const t2 = tickReincarnation({
+            state: t1.state,
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_600,
+            rngSeed: 2,
+            secret: SECRET,
+        });
+        // Parent (gen1) should be gone; only the child (gen2) remains alive.
+        const aliveLineage = t2.state.wrappers.filter((x) => x.baseToolName === w.baseToolName);
+        expect(aliveLineage.length).toBe(1);
+        expect(aliveLineage[0].generation).toBe(2);
+    });
+    it("respects MAX_GENERATIONS_PER_BASE loop guard", () => {
+        // Manually craft a gen=100 wrapper that is about to expire.
+        const expired = birthMortalWrapper({
+            baseToolName: "mneme.cap.test",
+            baseArgs: ARGS,
+            ttlMs: 1000,
+            nowMs: 1_000_000,
+            secret: SECRET,
+        });
+        // Build a gen-100 sibling that already exists in the lineage.
+        const gen100 = { ...expired, generation: 100, id: "mw-fake100", alive: true, expiresAt: 999 };
+        const state = { v: 1, wrappers: [gen100], calibration: [] };
+        const out = tickReincarnation({
+            state,
+            baseToolArgs: { "mneme.cap.test": ARGS },
+            nowMs: 2000,
+            rngSeed: 1,
+            secret: SECRET,
+        });
+        expect(out.reincarnated.length).toBe(0);
+        expect(out.skippedAtMaxGen).toContain("mneme.cap.test");
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · resolveMortalCall", () => {
+    it("resolves a live alias and translates renamed keys back to base args", () => {
+        const w = newBorn({ now: 1_000_000 });
+        const state = tickReincarnation({
+            state: { v: 1, wrappers: [w], calibration: [] },
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: w.expiresAt, // force reincarnation
+            rngSeed: 11,
+            secret: SECRET,
+        }).state;
+        const child = state.wrappers.find((x) => x.alive);
+        // Call the child with its current schema — should translate cleanly.
+        const childArgs = {};
+        for (const [mortalKey, baseKey] of Object.entries(child.signature.argRenameMap)) {
+            childArgs[mortalKey] = `value-of-${baseKey}`;
+        }
+        const r = resolveMortalCall({
+            alias: child.signature.alias,
+            args: childArgs,
+            state,
+            nowMs: child.birthAt + 1,
+        });
+        expect(r.ok).toBe(true);
+        expect(r.baseToolName).toBe(w.baseToolName);
+        expect(r.deprecated).toBe(false);
+        expect(Object.keys(r.baseArgs).sort()).toEqual(ARGS.slice().sort());
+    });
+    it("flags a deprecated parent alias as deprecated=true (still callable during gravity)", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const state = tickReincarnation({
+            state: { v: 1, wrappers: [w], calibration: [] },
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000,
+            rngSeed: 11,
+            secret: SECRET,
+        }).state;
+        const args = Object.fromEntries(ARGS.map((a) => [a, `v-${a}`]));
+        const r = resolveMortalCall({
+            alias: "mneme.mortal.arena.judge.gen1",
+            args,
+            state,
+            nowMs: 1_001_100, // inside gravity
+        });
+        expect(r.ok).toBe(true);
+        expect(r.deprecated).toBe(true);
+    });
+    it("refuses a fully-expired alias past gravity and offers a live sibling hint", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const state = tickReincarnation({
+            state: { v: 1, wrappers: [w], calibration: [] },
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000,
+            rngSeed: 11,
+            secret: SECRET,
+        }).state;
+        const r = resolveMortalCall({
+            alias: "mneme.mortal.arena.judge.gen1",
+            args: { topic: "x" },
+            state,
+            nowMs: 1_002_000, // way past gravity
+        });
+        expect(r.ok).toBe(false);
+        expect(r.hint).toBeDefined();
+        expect(r.hint).toContain("mneme.mortal.arena.judge.gen2");
+    });
+    it("flags AI-agent overfit by failing on unknown keys with a helpful hint", () => {
+        const w = newBorn({ now: 1_000_000 });
+        const state = { v: 1, wrappers: [w], calibration: [] };
+        const r = resolveMortalCall({
+            alias: w.signature.alias,
+            args: { topic: "x", THIS_IS_STALE_FROM_GEN_MINUS_ONE: 42 },
+            state,
+        });
+        expect(r.ok).toBe(false);
+        expect(r.reason).toContain("schema drifted");
+        expect(r.hint).toContain("topic");
+    });
+    it("silently drops drift-bonus params (they're calibration tripwires, not errors)", () => {
+        const w = newBorn({ now: 1_000_000 });
+        // Manually inject an addedOptionalParam via mutation
+        const drifted = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 2,
+            kind: "add_optional_param",
+            rng: () => 0.3,
+        });
+        const driftedWrapper = { ...w, signature: drifted };
+        const state = { v: 1, wrappers: [driftedWrapper], calibration: [] };
+        const fresh = drifted.addedOptionalParams[0];
+        const r = resolveMortalCall({
+            alias: drifted.alias,
+            args: { topic: "x", limit: 5, outputFormat: "json", [fresh]: "ignored" },
+            state,
+        });
+        expect(r.ok).toBe(true);
+        expect(r.baseArgs).not.toHaveProperty(fresh);
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · calibration telemetry", () => {
+    it("calibration score climbs as the caller succeeds; verdict bands report adaptiveness", () => {
+        let state = emptyState();
+        for (let i = 0; i < 19; i++)
+            state = recordCalibration({ state, callerKey: "ai-fast-learner", alias: "x", ok: true });
+        state = recordCalibration({ state, callerKey: "ai-fast-learner", alias: "x", ok: false });
+        const s = calibrationScore({ state, callerKey: "ai-fast-learner" });
+        expect(s.totalCalls).toBe(20);
+        expect(s.successfulCalls).toBe(19);
+        expect(s.adaptivenessScore).toBeCloseTo(0.95, 5);
+        expect(s.verdict).toBe("world_class");
+    });
+    it("an AI that keeps failing earns the over_fit verdict", () => {
+        let state = emptyState();
+        for (let i = 0; i < 10; i++)
+            state = recordCalibration({ state, callerKey: "ai-overfitter", alias: "y", ok: false });
+        for (let i = 0; i < 2; i++)
+            state = recordCalibration({ state, callerKey: "ai-overfitter", alias: "y", ok: true });
+        const s = calibrationScore({ state, callerKey: "ai-overfitter" });
+        expect(s.verdict).toBe("over_fit");
+    });
+    it("low sample size returns the cautious 'drifting' verdict (not enough signal)", () => {
+        let state = emptyState();
+        for (let i = 0; i < 3; i++)
+            state = recordCalibration({ state, callerKey: "ai-newbie", alias: "z", ok: true });
+        const s = calibrationScore({ state, callerKey: "ai-newbie" });
+        expect(s.verdict).toBe("drifting");
+    });
+    it("zero calls returns 0 with drifting verdict", () => {
+        const state = emptyState();
+        const s = calibrationScore({ state, callerKey: "never-called" });
+        expect(s.totalCalls).toBe(0);
+        expect(s.adaptivenessScore).toBe(0);
+        expect(s.verdict).toBe("drifting");
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · globalStats", () => {
+    it("aggregates alive / deprecated / mutation histogram correctly across many generations", () => {
+        // 3 lineages, each reincarnated 4 times (gen5 lives, gen1-4 deprecated)
+        let state = emptyState();
+        let now = 1_000_000;
+        for (const base of ["mneme.x.a", "mneme.y.b", "mneme.z.c"]) {
+            state = { ...state, wrappers: [...state.wrappers, birthMortalWrapper({ baseToolName: base, baseArgs: ARGS, ttlMs: 1000, deprecationGravityMs: 10_000_000, nowMs: now, secret: SECRET })] };
+        }
+        for (let i = 0; i < 4; i++) {
+            const t = tickReincarnation({
+                state,
+                baseToolArgs: { "mneme.x.a": ARGS, "mneme.y.b": ARGS, "mneme.z.c": ARGS },
+                nowMs: now + 1000 + i * 1000,
+                budget: 3,
+                rngSeed: 100 + i,
+                secret: SECRET,
+            });
+            state = t.state;
+        }
+        const s = globalStats(state);
+        // 3 lineages × 5 generations = 15 wrappers; 3 alive (latest gen of each), 12 deprecated
+        expect(s.uniqueBaseTools).toBe(3);
+        expect(s.alive).toBe(3);
+        expect(s.deprecated).toBe(12);
+        expect(s.totalGenerationsAcrossLineages).toBe(15);
+        // Each lineage carries 4 cumulative mutations on gen5 (plus 3+2+1+0 on lower gens). Just sanity-check non-zero.
+        expect(s.totalMutationsApplied).toBeGreaterThan(0);
+        const histSum = Object.values(s.mutationKindHistogram).reduce((a, b) => a + b, 0);
+        expect(histSum).toBe(s.totalMutationsApplied);
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · formatters + edge cases", () => {
+    it("formatter shows 🌱 for alive and 💀 for deprecated", () => {
+        const w = newBorn();
+        expect(formatWrapperLine(w)).toContain("🌱");
+        const dead = { ...w, alive: false };
+        expect(formatWrapperLine(dead)).toContain("💀");
+    });
+    it("resolve on unknown alias returns helpful error message", () => {
+        const r = resolveMortalCall({ alias: "mneme.mortal.does.not.exist.gen1", args: {}, state: emptyState() });
+        expect(r.ok).toBe(false);
+        expect(r.reason).toContain("unknown");
+    });
+});
+//# sourceMappingURL=mortal_wrappers.test.js.map

package/dist/mortal_wrappers/mortal_wrappers.test.js.map

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

package/dist/muscle_memory/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * v2.19.12 — MNEME MUSCLE MEMORY (CLI bypasses Node startup via persistent daemon)
+ *
+ *   "Cold-start a Node.js binary every CLI invocation = 600-800ms of pure
+ *    bootstrap overhead. After the first call, the daemon is already
+ *    warm — subsequent calls dispatch over a Unix domain socket / Windows
+ *    named pipe to the same process, skipping bootstrap entirely. Cold
+ *    ~800ms → warm ~12ms. The CLI literally learns to run itself faster
+ *    along the paths you walk most."
+ *
+ * Architecture (this module ships the PROTOCOL + HANDLER; the actual
+ * net.Server / net.Socket wiring is done by the CLI package):
+ *   - Frame: {requestId, cmd, args, nonce, hmac}
+ *   - Reply: {requestId, ok, data, ms, error?}
+ *   - HMAC-SHA256 over canonical frame (sans hmac field)
+ *   - Nonce window: 60s; replay rejected via nonce ledger
+ *
+ * Honest scope:
+ *   - The handler is in-process; we do NOT hot-load arbitrary modules
+ *     at dispatch time. Only registered commands run.
+ *   - Test transport is in-memory (Promise-based) so tests don't actually
+ *     open sockets — keeps CI portable + deterministic.
+ *   - Benchmark measures the protocol round-trip and the registered
+ *     handler's work, not Node startup itself (the savings are at the
+ *     CLI binary level, observed externally).
+ */
+declare const PROTOCOL_VERSION: 1;
+export interface MuscleFrame {
+    v: typeof PROTOCOL_VERSION;
+    requestId: string;
+    cmd: string;
+    args: Record<string, unknown>;
+    nonce: string;
+    ts: number;
+    hmac: string;
+}
+export interface MuscleReply {
+    v: typeof PROTOCOL_VERSION;
+    requestId: string;
+    ok: boolean;
+    data?: unknown;
+    ms: number;
+    error?: string;
+}
+export type MuscleHandler = (cmd: string, args: Record<string, unknown>) => Promise<unknown> | unknown;
+export interface DispatcherOpts {
+    secret?: string;
+    handlers: Record<string, MuscleHandler>;
+    /** Caller-supplied clock for testability. */
+    now?: () => number;
+}
+export interface CallInput {
+    cmd: string;
+    args?: Record<string, unknown>;
+    secret?: string;
+    /** Override timestamp for testability. */
+    ts?: number;
+}
+/**
+ * Stateful dispatcher: keeps a nonce ledger to reject replay attacks and a
+ * latency histogram for the benchmark surface.
+ */
+export declare class MuscleDispatcher {
+    private nonces;
+    private histogram;
+    private warmCalls;
+    private coldCalls;
+    readonly handlers: Record<string, MuscleHandler>;
+    readonly secret: string;
+    readonly now: () => number;
+    constructor(opts: DispatcherOpts);
+    /** Build a signed frame caller-side. */
+    buildFrame(input: CallInput): MuscleFrame;
+    /** Daemon-side: verify + execute. Returns a structured reply. */
+    handleFrame(frame: MuscleFrame): Promise<MuscleReply>;
+    /** Cheap garbage-collection of expired nonces. */
+    private gcNonces;
+    /** Convenience for in-process tests: signs + dispatches in one step. */
+    call(input: CallInput): Promise<MuscleReply>;
+    status(): {
+        warmCalls: number;
+        coldCalls: number;
+        totalCalls: number;
+        avgWarmLatencyMs: number;
+        p95LatencyMs: number;
+        speedupFactor: number;
+    };
+}
+/**
+ * Synthetic benchmark: dispatches a cheap handler N times. Returns measured
+ * cold-vs-warm latency proving the speedup principle (a real CLI cold-start
+ * additionally avoids Node bootstrap, which is measured by an external timer
+ * in the CLI package).
+ */
+export declare function benchmarkMuscleSpeedup(opts: {
+    iterations?: number;
+    workMs?: number;
+    secret?: string;
+}): Promise<{
+    iterations: number;
+    coldMs: number;
+    avgWarmMs: number;
+    speedupFactor: number;
+    perCall: number[];
+}>;
+/** Platform-aware suggested socket path (Unix domain socket / Windows named pipe). */
+export declare function suggestedSocketPath(opts?: {
+    repoPath?: string;
+}): string;
+export declare function formatMuscleStatusLine(s: ReturnType<MuscleDispatcher["status"]>): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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