@mneme-ai/core 2.19.26 → 2.19.28

package/dist/dreamspace_cartographer/index.js

@@ -0,0 +1,175 @@
+/**
+ * v2.19.27 — MNEME DREAMSPACE · CARTOGRAPHER (stage 2 of 6)
+ *
+ *   "build map: tool X handles input pattern Y with quality Z, store
+ *    ใน PROPRIOCEPTION → REFLEX query proprioception ตอน predict-
+ *    next-tool → 90/100 stuck features เริ่มถูก trigger ตามที่จริง"
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: PROBE measures per-tool fitness; CARTOGRAPHER aggregates
+ *   ACROSS many probe reports into a queryable capability map. REFLEX
+ *   then asks "which tool best handles this input pattern?" and gets
+ *   evidence-backed answer instead of frequency guess.
+ *
+ *   The map is a 2D index:
+ *     pattern_signature → tool_name → quality_score
+ *   Pattern signature is a content-addressed hash of the input shape
+ *   (kind + sorted key list). Stable across probe runs; case-insensitive.
+ *
+ *   Composes onto:
+ *     - v2.19.27 PROBE (consumes ToolProbeReport.runs)
+ *     - v2.19.23 PROPRIOCEPTION (unified catalog; caller stores map here)
+ *     - v2.19.22 REFLEX (queries map at predict-next-tool time)
+ *     - v2.19.26 GESTATION (gaps in map = signal for proposeToolSpec)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION builder. Caller persists the CapabilityMap to disk.
+ *   - Pattern signature is conservative (kind + sorted key names); we
+ *     don't try to infer semantic intent — that's PROPRIOCEPTION's job.
+ *   - HMAC-signed map so federation can ship verified capability maps.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+const PROTOCOL_VERSION = 1;
+const DEFAULT_BLEND_WEIGHT = 0.3;
+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_DREAMSPACE_CARTOGRAPHER_SECRET"] || `mneme-dreamspace-cartographer-v${PROTOCOL_VERSION}`;
+}
+function hmacHex(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;
+    }
+}
+/**
+ * Pattern signature from input args: kind discriminator + sorted key list.
+ *   { name: "x", count: 3 } → "obj:count,name"
+ *   [] → "arr:empty"
+ *   "hello" → "str:len5"
+ *   42 → "num"
+ *   null → "null"
+ * Stable; case-insensitive; never reveals user data.
+ */
+export function patternSignature(args) {
+    if (args === null)
+        return "null";
+    if (args === undefined)
+        return "undef";
+    if (Array.isArray(args))
+        return args.length === 0 ? "arr:empty" : `arr:len${args.length < 5 ? "small" : args.length < 50 ? "med" : "large"}`;
+    if (typeof args === "object") {
+        const keys = Object.keys(args).map((k) => k.toLowerCase()).sort();
+        return keys.length === 0 ? "obj:empty" : `obj:${keys.join(",")}`;
+    }
+    if (typeof args === "string")
+        return `str:len${args.length === 0 ? "0" : args.length < 32 ? "small" : "large"}`;
+    return typeof args;
+}
+/**
+ * Build a fresh CapabilityMap from a list of probe runs.
+ *
+ * Aggregation: for each (toolName, patternSig) cell, quality is the
+ * weighted mean of qualityForThisRun across all probes for that cell.
+ * Recent probes weight slightly more than old probes (recency bias
+ * controlled by `blendWeight` per new probe).
+ */
+export function buildCapabilityMap(input) {
+    const w = input.blendWeight ?? DEFAULT_BLEND_WEIGHT;
+    const byCell = new Map();
+    // Sort probes chronologically for stable EWMA evolution
+    const sorted = [...input.probes].sort((a, b) => a.probedAt - b.probedAt);
+    for (const p of sorted) {
+        const sig = patternSignature(p.inputArgs);
+        const key = `${p.toolName}::${sig}`;
+        const prev = byCell.get(key);
+        if (prev) {
+            // Exponential moving average; defaults to 0.3 new weight (slow drift).
+            prev.quality = (1 - w) * prev.quality + w * p.qualityForThisRun;
+            prev.sampleCount++;
+            prev.lastProbedAt = Math.max(prev.lastProbedAt, p.probedAt);
+        }
+        else {
+            byCell.set(key, {
+                quality: p.qualityForThisRun,
+                sampleCount: 1,
+                lastProbedAt: p.probedAt,
+                patternLabel: p.inputLabel,
+            });
+        }
+    }
+    const cells = [];
+    for (const [key, acc] of byCell) {
+        const [toolName, patternSig] = key.split("::");
+        cells.push({
+            toolName,
+            patternSig,
+            patternLabel: acc.patternLabel,
+            quality: acc.quality,
+            sampleCount: acc.sampleCount,
+            lastProbedAt: acc.lastProbedAt,
+        });
+    }
+    // Stable order: by patternSig asc, then quality desc, then toolName asc
+    cells.sort((a, b) => a.patternSig.localeCompare(b.patternSig) ||
+        b.quality - a.quality ||
+        a.toolName.localeCompare(b.toolName));
+    const uniquePatterns = new Set(cells.map((c) => c.patternSig)).size;
+    const uniqueTools = new Set(cells.map((c) => c.toolName)).size;
+    const body = {
+        v: PROTOCOL_VERSION,
+        cells,
+        totalProbes: input.probes.length,
+        uniquePatterns,
+        uniqueTools,
+        builtAt: input.builtAt ?? Date.now(),
+    };
+    const sig = hmacHex(body, input.secret ?? defaultSecret());
+    return { ...body, sig };
+}
+export function verifyCapabilityMap(m, secret) {
+    const { sig, ...body } = m;
+    return safeEqHex(hmacHex(body, secret ?? defaultSecret()), sig);
+}
+/**
+ * Query the map for tools that handle a given input shape. Returns the
+ * top-N by quality desc. REFLEX's predict-next-tool path calls this
+ * BEFORE falling back to frequency-only prediction.
+ */
+export function queryCapability(input) {
+    const sig = patternSignature(input.args);
+    const minQ = input.minQuality ?? 0;
+    const topN = input.topN ?? 5;
+    return input.map.cells
+        .filter((c) => c.patternSig === sig && c.quality >= minQ)
+        .slice(0, topN);
+}
+export function computeMapStats(m) {
+    const total = m.cells.length;
+    const meanQuality = total === 0 ? 0 : m.cells.reduce((s, c) => s + c.quality, 0) / total;
+    const highQ = m.cells.filter((c) => c.quality >= 0.7).length;
+    const single = m.cells.filter((c) => c.sampleCount === 1).length;
+    return {
+        totalCells: total,
+        uniquePatterns: m.uniquePatterns,
+        uniqueTools: m.uniqueTools,
+        meanQuality,
+        highQualityCells: highQ,
+        singleProbeCells: single,
+    };
+}
+export function formatMapLine(s) {
+    return `🗺 CARTOGRAPHER · ${s.totalCells} cells · ${s.uniqueTools} tools × ${s.uniquePatterns} patterns · ${s.highQualityCells} high-Q · meanQ=${s.meanQuality.toFixed(2)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/dreamspace_cartographer/index.js.map

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

package/dist/dreamspace_federate/dreamspace_federate.test.d.ts

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

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

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

package/dist/dreamspace_federate/dreamspace_federate.test.js

@@ -0,0 +1,199 @@
+import { describe, it, expect } from "vitest";
+import { attestElite, verifyAttestation, aggregateBlessing, verifyBlessingQuorum, exportStarterPack, verifyStarterPack, BLESSING_EMOJI, formatQuorumLine, formatStarterPackLine, } from "./index.js";
+const SECRET = "federate-test-secret-997744";
+function mkAttest(instance, tool, fitness, useCount, ts = 1) {
+    return attestElite({
+        instanceId: instance,
+        toolName: tool,
+        localFitness: fitness,
+        localUseCount: useCount,
+        ts,
+        secret: SECRET,
+    });
+}
+describe("v2.19.27 FEDERATE · attestElite", () => {
+    it("issues attestation when fitness >= threshold", () => {
+        const a = attestElite({
+            instanceId: "inst1",
+            toolName: "mneme.x",
+            localFitness: 0.8,
+            localUseCount: 100,
+            secret: SECRET,
+        });
+        expect(a).not.toBeNull();
+        expect(verifyAttestation(a, SECRET)).toBe(true);
+    });
+    it("REFUSES attestation when fitness < threshold (default 0.7)", () => {
+        const a = attestElite({
+            instanceId: "inst1",
+            toolName: "mneme.x",
+            localFitness: 0.5,
+            localUseCount: 100,
+            secret: SECRET,
+        });
+        expect(a).toBeNull();
+    });
+    it("custom minFitness override works", () => {
+        const a = attestElite({
+            instanceId: "inst1",
+            toolName: "mneme.x",
+            localFitness: 0.3,
+            localUseCount: 100,
+            minFitness: 0.2,
+            secret: SECRET,
+        });
+        expect(a).not.toBeNull();
+    });
+    it("MEASURED 100% determinism: same input -> same sig (30 trials)", () => {
+        const args = { instanceId: "x", toolName: "y", localFitness: 0.8, localUseCount: 10, ts: 1, secret: SECRET };
+        const first = attestElite(args).sig;
+        let allEqual = true;
+        for (let i = 0; i < 30; i++) {
+            if (attestElite(args).sig !== first) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+});
+describe("v2.19.27 FEDERATE · aggregateBlessing (quorum bands)", () => {
+    it("0 attestations -> orphan", () => {
+        const q = aggregateBlessing({ toolName: "mneme.x", attestations: [], totalInstancesKnown: 10, secret: SECRET });
+        expect(q.band).toBe("orphan");
+        expect(q.isBlessed).toBe(false);
+    });
+    it(">= 95% of known instances -> unanimous + blessed", () => {
+        const attests = Array.from({ length: 20 }, (_, i) => mkAttest(`inst${i}`, "mneme.x", 0.9, 10));
+        const q = aggregateBlessing({ toolName: "mneme.x", attestations: attests, totalInstancesKnown: 20, secret: SECRET });
+        expect(q.band).toBe("unanimous");
+        expect(q.isBlessed).toBe(true);
+    });
+    it(">= 67% -> supermajority + blessed", () => {
+        const attests = Array.from({ length: 7 }, (_, i) => mkAttest(`inst${i}`, "mneme.x", 0.9, 10));
+        const q = aggregateBlessing({ toolName: "mneme.x", attestations: attests, totalInstancesKnown: 10, secret: SECRET });
+        expect(q.band).toBe("supermajority");
+        expect(q.isBlessed).toBe(true);
+    });
+    it(">= 51% -> majority (NOT blessed)", () => {
+        const attests = Array.from({ length: 6 }, (_, i) => mkAttest(`inst${i}`, "mneme.x", 0.9, 10));
+        const q = aggregateBlessing({ toolName: "mneme.x", attestations: attests, totalInstancesKnown: 10, secret: SECRET });
+        expect(q.band).toBe("majority");
+        expect(q.isBlessed).toBe(false);
+    });
+    it("forged attestations DROPPED + counted in forgedDropped", () => {
+        const good = mkAttest("inst1", "mneme.x", 0.9, 10);
+        const tampered = { ...mkAttest("inst2", "mneme.x", 0.9, 10), localFitness: 0.99 };
+        const q = aggregateBlessing({
+            toolName: "mneme.x",
+            attestations: [good, tampered],
+            totalInstancesKnown: 2,
+            secret: SECRET,
+        });
+        expect(q.forgedDropped).toBe(1);
+        expect(q.validAttestations).toBe(1);
+    });
+    it("one-vote-per-instance: keeps latest by ts (dedup)", () => {
+        const old = mkAttest("inst1", "mneme.x", 0.7, 5, 1);
+        const fresh = mkAttest("inst1", "mneme.x", 0.9, 10, 100);
+        const q = aggregateBlessing({
+            toolName: "mneme.x",
+            attestations: [old, fresh],
+            totalInstancesKnown: 1,
+            secret: SECRET,
+        });
+        expect(q.validAttestations).toBe(1);
+        expect(q.meanFitness).toBe(0.9); // latest kept
+        expect(q.totalUseCount).toBe(10);
+    });
+    it("ignores attestations for different toolName", () => {
+        const a = mkAttest("inst1", "mneme.OTHER", 0.9, 10);
+        const q = aggregateBlessing({
+            toolName: "mneme.x",
+            attestations: [a],
+            totalInstancesKnown: 10,
+            secret: SECRET,
+        });
+        expect(q.validAttestations).toBe(0);
+        expect(q.band).toBe("orphan");
+    });
+    it("MEASURED 100% determinism: same attestations -> same quorum sig (30 trials)", () => {
+        const attests = [mkAttest("a", "t", 0.9, 5), mkAttest("b", "t", 0.8, 3)];
+        const input = { toolName: "t", attestations: attests, totalInstancesKnown: 2, secret: SECRET };
+        const first = aggregateBlessing(input).sig;
+        let allEqual = true;
+        for (let i = 0; i < 30; i++) {
+            if (aggregateBlessing(input).sig !== first) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+});
+describe("v2.19.27 FEDERATE · exportStarterPack", () => {
+    it("sorts blessed-first, then meanFitness desc, then attestationCount desc", () => {
+        const quorums = [
+            aggregateBlessing({ toolName: "low", attestations: [mkAttest("i1", "low", 0.7, 1)], totalInstancesKnown: 1, secret: SECRET }),
+            aggregateBlessing({ toolName: "high", attestations: [mkAttest("i1", "high", 0.95, 1)], totalInstancesKnown: 1, secret: SECRET }),
+            aggregateBlessing({ toolName: "mid", attestations: [mkAttest("i1", "mid", 0.85, 1)], totalInstancesKnown: 1, secret: SECRET }),
+        ];
+        const pack = exportStarterPack({ quorums, topN: 10, builtAt: 0, secret: SECRET });
+        expect(pack.entries.map((e) => e.toolName)).toEqual(["high", "mid", "low"]);
+    });
+    it("topN respected", () => {
+        const quorums = Array.from({ length: 5 }, (_, i) => aggregateBlessing({
+            toolName: `t${i}`,
+            attestations: [mkAttest("inst", `t${i}`, 0.95, 5)],
+            totalInstancesKnown: 1,
+            secret: SECRET,
+        }));
+        const pack = exportStarterPack({ quorums, topN: 2, builtAt: 0, secret: SECRET });
+        expect(pack.entries.length).toBe(2);
+    });
+    it("HMAC sig verifies; rejects tamper", () => {
+        const pack = exportStarterPack({ quorums: [], topN: 100, builtAt: 0, secret: SECRET });
+        expect(verifyStarterPack(pack, SECRET)).toBe(true);
+        expect(verifyStarterPack({ ...pack, topN: 999 }, SECRET)).toBe(false);
+    });
+});
+describe("v2.19.27 FEDERATE · formatters + emoji", () => {
+    it("BLESSING_EMOJI maps each band", () => {
+        expect(BLESSING_EMOJI.unanimous).toBe("🏆");
+        expect(BLESSING_EMOJI.supermajority).toBe("🥇");
+        expect(BLESSING_EMOJI.majority).toBe("🥈");
+        expect(BLESSING_EMOJI.minority).toBe("🥉");
+        expect(BLESSING_EMOJI.conflict).toBe("⚖");
+        expect(BLESSING_EMOJI.orphan).toBe("🌌");
+    });
+    it("formatQuorumLine includes band + valid/total counts + meanFit", () => {
+        const q = aggregateBlessing({
+            toolName: "x",
+            attestations: [mkAttest("i", "x", 0.9, 1)],
+            totalInstancesKnown: 1,
+            secret: SECRET,
+        });
+        const line = formatQuorumLine(q);
+        expect(line).toContain("FEDERATE x");
+        expect(line).toContain("meanFit=");
+    });
+    it("formatStarterPackLine reports total + blessed counts", () => {
+        const pack = exportStarterPack({ quorums: [], topN: 100, builtAt: 0, secret: SECRET });
+        const line = formatStarterPackLine(pack);
+        expect(line).toContain("STARTER-PACK");
+        expect(line).toContain("blessed");
+    });
+});
+describe("v2.19.27 FEDERATE · verifyBlessingQuorum", () => {
+    it("HMAC sig verifies untampered + rejects tamper", () => {
+        const q = aggregateBlessing({
+            toolName: "x",
+            attestations: [mkAttest("i", "x", 0.9, 1)],
+            totalInstancesKnown: 1,
+            secret: SECRET,
+        });
+        expect(verifyBlessingQuorum(q, SECRET)).toBe(true);
+        expect(verifyBlessingQuorum({ ...q, meanFitness: 0.5 }, SECRET)).toBe(false);
+    });
+});
+//# sourceMappingURL=dreamspace_federate.test.js.map

package/dist/dreamspace_federate/dreamspace_federate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreamspace_federate.test.js","sourceRoot":"","sources":["../../src/dreamspace_federate/dreamspace_federate.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,GAAG,6BAA6B,CAAC;AAE7C,SAAS,QAAQ,CAAC,QAAgB,EAAE,IAAY,EAAE,OAAe,EAAE,QAAgB,EAAE,EAAE,GAAG,CAAC;IACzF,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,QAAQ;QACpB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,OAAO;QACrB,aAAa,EAAE,QAAQ;QACvB,EAAE;QACF,MAAM,EAAE,MAAM;KACf,CAAE,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,UAAU,EAAE,OAAO;YACnB,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,GAAG;YAClB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,iBAAiB,CAAC,CAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,UAAU,EAAE,OAAO;YACnB,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,GAAG;YAClB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,UAAU,EAAE,OAAO;YACnB,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,GAAG;YAClB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,IAAI,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC7G,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC;QACrC,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,IAAI,WAAW,CAAC,IAAI,CAAE,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;gBAAC,QAAQ,GAAG,KAAK,CAAC;gBAAC,MAAM;YAAC,CAAC;QACpE,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sDAAsD,EAAE,GAAG,EAAE;IACpE,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChH,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/F,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACrH,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACrH,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACrH,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAClF,MAAM,CAAC,GAAG,iBAAiB,CAAC;YAC1B,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;YAC9B,mBAAmB,EAAE,CAAC;YACtB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,iBAAiB,CAAC;YAC1B,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC;YAC1B,mBAAmB,EAAE,CAAC;YACtB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc;QAC/C,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,iBAAiB,CAAC;YAC1B,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,CAAC,CAAC,CAAC;YACjB,mBAAmB,EAAE,EAAE;YACvB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC/F,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;QAC3C,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;gBAAC,QAAQ,GAAG,KAAK,CAAC;gBAAC,MAAM;YAAC,CAAC;QAC1E,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,OAAO,GAAG;YACd,iBAAiB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC7H,iBAAiB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAChI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;SAC/H,CAAC;QACF,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACjD,iBAAiB,CAAC;YAChB,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,YAAY,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAClD,mBAAmB,EAAE,CAAC;YACtB,MAAM,EAAE,MAAM;SACf,CAAC,CACH,CAAC;QACF,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,iBAAiB,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,GAAG,iBAAiB,CAAC;YAC1B,QAAQ,EAAE,GAAG;YACb,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1C,mBAAmB,EAAE,CAAC;YACtB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,iBAAiB,CAAC;YAC1B,QAAQ,EAAE,GAAG;YACb,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1C,mBAAmB,EAAE,CAAC;YACtB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,oBAAoB,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/dreamspace_federate/index.d.ts

@@ -0,0 +1,131 @@
+/**
+ * v2.19.27 — MNEME DREAMSPACE · FEDERATE (stage 6 of 6)
+ *
+ *   "tools ที่ elite ใน 100+ instances → 'blessed'
+ *    shared via cosmic.mneme-ai.space/dreamspace
+ *    ผู้ใช้ใหม่ download starter pack จาก top 100 dreamt-born tools
+ *    ⇒ Mneme network effect ที่ไม่มี framework ไหนมี"
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: GESTATION proposes; EVOLUTION selects; PROBE measures;
+ *   CARTOGRAPHER maps; PAIR scores complementarity. All locally. The
+ *   network effect kicks in when ELITE tools spread across instances.
+ *
+ *   FEDERATE composes onto v2.19.16 FEDERATED TRUTH GRAVITY. Each
+ *   instance HMAC-signs an EliteAttestation for tools whose local
+ *   fitness >= threshold. Quorum across instances → "blessed" tag.
+ *   Starter pack export = top-N blessed tools, downloadable by new
+ *   users.
+ *
+ *   Composes onto:
+ *     - v2.19.16 FEDERATED TRUTH GRAVITY (cross-attestation pattern)
+ *     - v2.19.27 PROBE (local fitness source)
+ *     - v2.19.26 EVOLUTION (lifecycle bands; only MATURE eligible)
+ *     - v2.19.9 WRAPPER_GENESPLICING (blessed tools = composer recipes
+ *       that any instance can apply)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION attestation + quorum. Caller does the actual
+ *     network sync via v2.19.16 mesh/nexus transport.
+ *   - Eligibility gate: only MATURE tools (v2.19.26 EVOLUTION) with
+ *     local fitness >= threshold get attested.
+ *   - HMAC-signed attestations; forged attestations dropped on verify.
+ *   - Quorum bands match v2.19.16: unanimous / supermajority / majority
+ *     / minority / conflict / orphan.
+ */
+declare const PROTOCOL_VERSION: 1;
+export interface EliteAttestation {
+    v: typeof PROTOCOL_VERSION;
+    /** Pseudonymous instance id from v2.19.16 FEDERATED. */
+    instanceId: string;
+    /** Tool the instance attests is elite locally. */
+    toolName: string;
+    /** Local fitness score 0..1 (from PROBE). */
+    localFitness: number;
+    /** Local use count (from CONSEQUENCE / EVOLUTION). */
+    localUseCount: number;
+    /** ts of the attestation (ms). */
+    ts: number;
+    sig: string;
+}
+export type BlessingBand = "unanimous" | "supermajority" | "majority" | "minority" | "conflict" | "orphan";
+export interface BlessingQuorum {
+    v: typeof PROTOCOL_VERSION;
+    toolName: string;
+    totalAttestations: number;
+    validAttestations: number;
+    forgedDropped: number;
+    meanFitness: number;
+    totalUseCount: number;
+    band: BlessingBand;
+    /** Convenience: is the tool blessed (band ∈ {unanimous, supermajority})? */
+    isBlessed: boolean;
+    sig: string;
+}
+export interface StarterPackEntry {
+    toolName: string;
+    band: BlessingBand;
+    meanFitness: number;
+    attestationCount: number;
+}
+export interface StarterPack {
+    v: typeof PROTOCOL_VERSION;
+    entries: StarterPackEntry[];
+    topN: number;
+    builtAt: number;
+    sig: string;
+}
+/**
+ * Issue an EliteAttestation for a tool. Refuses if fitness < threshold
+ * (we never attest mediocre tools). Caller-supplied instanceId from
+ * v2.19.16 FEDERATED identity.
+ */
+export declare function attestElite(input: {
+    instanceId: string;
+    toolName: string;
+    localFitness: number;
+    localUseCount: number;
+    ts?: number;
+    minFitness?: number;
+    secret?: string;
+}): EliteAttestation | null;
+export declare function verifyAttestation(a: EliteAttestation, secret?: string): boolean;
+/**
+ * Aggregate N attestations for a single tool into a BlessingQuorum.
+ *
+ * Bands (proportions of validAttestations / totalInstances):
+ *   unanimous     : >= 0.95
+ *   supermajority : >= 0.67
+ *   majority      : >= 0.51
+ *   minority      : >= 0.10
+ *   conflict      : > 0  and < 0.10
+ *   orphan        : 0 attestations
+ *
+ * Forged attestations (failed HMAC verify) are dropped silently and
+ * counted in `forgedDropped`. One-vote-per-instance: duplicates from
+ * same instanceId keep the latest by ts.
+ */
+export declare function aggregateBlessing(input: {
+    toolName: string;
+    attestations: EliteAttestation[];
+    totalInstancesKnown: number;
+    secret?: string;
+}): BlessingQuorum;
+export declare function verifyBlessingQuorum(q: BlessingQuorum, secret?: string): boolean;
+/**
+ * Export a starter pack of top-N blessed tools — downloaded by new
+ * users on first install. Sorted by isBlessed first, then meanFitness
+ * desc, then validAttestations desc.
+ */
+export declare function exportStarterPack(input: {
+    quorums: BlessingQuorum[];
+    topN?: number;
+    builtAt?: number;
+    secret?: string;
+}): StarterPack;
+export declare function verifyStarterPack(p: StarterPack, secret?: string): boolean;
+export declare const BLESSING_EMOJI: Record<BlessingBand, string>;
+export declare function formatQuorumLine(q: BlessingQuorum): string;
+export declare function formatStarterPackLine(p: StarterPack): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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