@mneme-ai/core 2.24.0 → 2.26.0

package/dist/tune/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tune/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAC/D,UAAU,EAAE,UAAU,EAAE,uBAAuB,GAChD,MAAM,aAAa,CAAC"}

package/dist/tune/tune.test.d.ts

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

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

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

package/dist/tune/tune.test.js

@@ -0,0 +1,58 @@
+// v2.26.0 — PEAK PERFORMANCE GAUNTLET unit tests.
+import { describe, it, expect } from "vitest";
+import { ALL_FINDINGS, suggestFix, verifyCard, __resetTuneChainForTest } from "./index.js";
+describe("tune — finding catalog", () => {
+    it("has exactly 12 findings (N1..N12)", () => {
+        expect(ALL_FINDINGS.length).toBe(12);
+        const ids = new Set(ALL_FINDINGS.map((f) => f.id));
+        for (let i = 1; i <= 12; i++)
+            expect(ids.has(`N${i}`)).toBe(true);
+    });
+    it("each finding has title + spec + remediation + probe + sinceVersion", () => {
+        for (const f of ALL_FINDINGS) {
+            expect(f.title.length).toBeGreaterThan(0);
+            expect(f.spec.length).toBeGreaterThan(0);
+            expect(Array.isArray(f.remediation)).toBe(true);
+            expect(typeof f.probe).toBe("function");
+            expect(f.sinceVersion).toMatch(/^v\d/);
+        }
+    });
+});
+describe("tune — suggestFix", () => {
+    it("returns suggestion for every valid id", () => {
+        for (let i = 1; i <= 12; i++) {
+            const id = `N${i}`;
+            const s = suggestFix(id);
+            expect(s, `no suggestion for ${id}`).not.toBeNull();
+            expect(s.findingId).toBe(id);
+            expect(s.steps.length).toBeGreaterThan(0);
+            expect(s.commands.length).toBeGreaterThan(0);
+        }
+    });
+    it("returns null for unknown id", () => {
+        expect(suggestFix("N99")).toBeNull();
+    });
+});
+describe("tune — verifyCard", () => {
+    function blank() {
+        return {
+            spec: { name: "MNEME-PEAK-GAUNTLET", version: "1.0" },
+            target: "tmp",
+            startedAt: "2026-05-22T00:00:00.000Z",
+            finishedAt: "2026-05-22T00:00:01.000Z",
+            totalMs: 1000,
+            findings: [],
+            overall: 50,
+            headline: "test",
+            trafficLight: "yellow",
+            hmac: "deadbeef".repeat(8),
+            seq: 1,
+            bodyDigest: "feedface".repeat(8),
+        };
+    }
+    it("rejects a card with wrong bodyDigest", () => {
+        __resetTuneChainForTest();
+        expect(verifyCard(blank()).ok).toBe(false);
+    });
+});
+//# sourceMappingURL=tune.test.js.map

package/dist/tune/tune.test.js.map

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

package/dist/tune/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * v2.26.0 — PEAK PERFORMANCE GAUNTLET / AUTO-OPTIMIZER types.
+ *
+ * The Gauntlet runs the 12 deep-findings probes (N1-N12) against the
+ * live MCP server + scores each 0-10 stars + produces an HMAC-signed
+ * scorecard. AI agents can:
+ *   mneme.tune.run            run the probe + emit signed scorecard
+ *   mneme.tune.report         read latest signed card
+ *   mneme.tune.suggest_fix    given a finding id, return remediation
+ *
+ * Scorecard is HMAC-chained per-run; ledger lives at
+ *   .mneme/tune/scorecard.jsonl
+ * + each full card at .mneme/tune/<seq>-<utc>.json.
+ *
+ * Each finding has:
+ *   id           — N1 .. N12
+ *   title        — short summary
+ *   probe        — async function that returns { stars, evidence }
+ *   remediation  — list of human-actionable fixes the operator can run
+ *   sinceVersion — which version first hardened this finding
+ */
+export type FindingId = `N${number}`;
+export interface FindingResult {
+    /** 0..10 — 10 = best, 0 = critical fail. */
+    stars: number;
+    /** One-line summary of what we measured. */
+    evidence: string;
+    /** Optional structured detail (counts, ids, etc). */
+    detail?: Record<string, unknown>;
+    /** Per-finding duration. */
+    dtMs?: number;
+}
+export interface Finding {
+    id: FindingId;
+    title: string;
+    /** Brief spec citation. */
+    spec: string;
+    /** Which MCP primitive / module fixes this. */
+    sinceVersion: string;
+    /** Probe function — see engine.ts for the live implementation. */
+    probe: (target: ProbeTarget) => Promise<FindingResult>;
+    /** Static remediation hints. */
+    remediation: string[];
+}
+export interface ProbeTarget {
+    /** Working dir for spawn. */
+    cwd: string;
+    /** Optional spawn command override. */
+    cmd?: {
+        exe: string;
+        args: string[];
+    };
+}
+export interface ScoreCard {
+    spec: {
+        name: "MNEME-PEAK-GAUNTLET";
+        version: string;
+    };
+    target: string;
+    startedAt: string;
+    finishedAt: string;
+    totalMs: number;
+    findings: Array<{
+        id: FindingId;
+        title: string;
+        stars: number;
+        evidence: string;
+        detail?: Record<string, unknown>;
+        dtMs?: number;
+        sinceVersion: string;
+    }>;
+    /** Aggregate score 0..100 = avg stars × 10. */
+    overall: number;
+    /** Headline. */
+    headline: string;
+    trafficLight: "green" | "yellow" | "red" | "black";
+    /** HMAC chain link. */
+    hmac: string;
+    /** Sequence number. */
+    seq: number;
+    /** SHA-256 of canonical body (without hmac/seq). */
+    bodyDigest: string;
+}
+export interface SuggestedFix {
+    findingId: FindingId;
+    steps: string[];
+    /** Concrete CLI / MCP commands the operator can copy-paste. */
+    commands: string[];
+    /** Pointer to the source file that ships the fix. */
+    sourcePath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tune/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tune/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,SAAS,GAAG,IAAI,MAAM,EAAE,CAAC;AAErC,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,gCAAgC;IAChC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,GAAG,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE;QAAE,IAAI,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,SAAS,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IACnD,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/tune/types.js

@@ -0,0 +1,23 @@
+/**
+ * v2.26.0 — PEAK PERFORMANCE GAUNTLET / AUTO-OPTIMIZER types.
+ *
+ * The Gauntlet runs the 12 deep-findings probes (N1-N12) against the
+ * live MCP server + scores each 0-10 stars + produces an HMAC-signed
+ * scorecard. AI agents can:
+ *   mneme.tune.run            run the probe + emit signed scorecard
+ *   mneme.tune.report         read latest signed card
+ *   mneme.tune.suggest_fix    given a finding id, return remediation
+ *
+ * Scorecard is HMAC-chained per-run; ledger lives at
+ *   .mneme/tune/scorecard.jsonl
+ * + each full card at .mneme/tune/<seq>-<utc>.json.
+ *
+ * Each finding has:
+ *   id           — N1 .. N12
+ *   title        — short summary
+ *   probe        — async function that returns { stars, evidence }
+ *   remediation  — list of human-actionable fixes the operator can run
+ *   sinceVersion — which version first hardened this finding
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tune/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tune/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/core",
-  "version": "2.24.0",
+  "version": "2.26.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",