@mneme-ai/core 2.66.0 → 2.67.0

package/dist/protoplasm/phoenix_hook.js

@@ -0,0 +1,64 @@
+/**
+ * 🔥 PROTOPLASM — PHOENIX HOOK
+ *
+ * Integration with Mneme's existing PHOENIX (v1.21+) resurrection cycle
+ * and SUPERNOVA (v1.30+) escalation.
+ *
+ * What Mneme already has:
+ *   - PHOENIX: when daemon dies, can be respawned by OS service / cron
+ *   - SUPERNOVA: factorial backoff supervised cycles for self-heal
+ *   - heartbeats/ directory in ~/.mneme-global for per-PID heartbeats
+ *
+ * What PROTOPLASM adds via this hook:
+ *   - Register PROTOPLASM as a "phoenix-revivable" subsystem
+ *   - Heal queue (from ghost_cell) feeds SUPERNOVA escalation
+ *   - PROTOPLASM heartbeat composes into nucleus daemon heartbeat
+ *
+ * On a fresh Mneme install where PHOENIX/SUPERNOVA may not be configured,
+ * we degrade to "advisory mode": write to heal_queue.jsonl, let any
+ * supervisor that exists pick it up.
+ */
+import { readFileSync, writeFileSync, existsSync, appendFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/** Drain pending heal requests from ghost_cell → SUPERNOVA escalation. */
+export function drainHealQueue(ctx) {
+    const queuePath = join(ctx.ledgerDir, "heal_queue.jsonl");
+    if (!existsSync(queuePath))
+        return { drained: [], remaining: 0 };
+    const lines = readFileSync(queuePath, "utf8").trim().split("\n").filter(Boolean);
+    const drained = [];
+    for (const line of lines) {
+        try {
+            drained.push(JSON.parse(line));
+        }
+        catch { /* */ }
+    }
+    // Clear queue after drain
+    writeFileSync(queuePath, "");
+    return { drained, remaining: 0 };
+}
+/** Register PROTOPLASM as a phoenix-revivable subsystem. */
+export function registerWithPhoenix(ctx, spec) {
+    const registryPath = join(ctx.daemonLedgerDir ?? ctx.ledgerDir, "phoenix-revivables.jsonl");
+    try {
+        mkdirSync(join(ctx.daemonLedgerDir ?? ctx.ledgerDir), { recursive: true });
+        appendFileSync(registryPath, JSON.stringify({
+            ts: new Date().toISOString(),
+            name: spec.name,
+            description: spec.description,
+            reviveCommand: spec.reviveCommand,
+        }) + "\n");
+        return { registered: true, path: registryPath };
+    }
+    catch {
+        return { registered: false, path: registryPath };
+    }
+}
+/** Default PROTOPLASM revivable spec. */
+export const PROTOPLASM_REVIVABLE = {
+    name: "protoplasm",
+    description: "Live atom infrastructure — per-function super_quan probes with HMAC-chained findings ledger",
+    livenessCheck: () => existsSync(".mneme/protoplasm/heartbeat.json"),
+    reviveCommand: "mneme protoplasm report",
+};
+//# sourceMappingURL=phoenix_hook.js.map

package/dist/protoplasm/phoenix_hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoenix_hook.js","sourceRoot":"","sources":["../../src/protoplasm/phoenix_hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAqBjC,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,GAAuB;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACjE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IACD,0BAA0B;IAC1B,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACnC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,GAAuB,EAAE,IAAmB;IAC9E,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;IAC5F,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC;YAC1C,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,GAAG,IAAI,CAAC,CAAC;QACX,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IACnD,CAAC;AACH,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6FAA6F;IAC1G,aAAa,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,kCAAkC,CAAC;IACnE,aAAa,EAAE,yBAAyB;CACzC,CAAC"}

package/dist/protoplasm/protoplasm.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 🦠 PROTOPLASM — vitest suite
+ *
+ * Pin the 6 invariants the live-atom infrastructure must guarantee:
+ *   I1. Wrapped fn behavior is identical (sync + async, throw + return)
+ *   I2. Probe runs every N calls; baseline rebuilt every 50
+ *   I3. HMAC chain integrity holds (tamper one row → verifyChain fails)
+ *   I4. Diagnose surfaces cascade pattern when upstream broke first
+ *   I5. Crawl plan only generated when ≥10 healthy findings recent
+ *   I6. Quantum signals respect bounds (entropy ≥ 0, stability ∈ [0,1])
+ */
+export {};
+//# sourceMappingURL=protoplasm.test.d.ts.map

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

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

package/dist/protoplasm/protoplasm.test.js

@@ -0,0 +1,142 @@
+/**
+ * 🦠 PROTOPLASM — vitest suite
+ *
+ * Pin the 6 invariants the live-atom infrastructure must guarantee:
+ *   I1. Wrapped fn behavior is identical (sync + async, throw + return)
+ *   I2. Probe runs every N calls; baseline rebuilt every 50
+ *   I3. HMAC chain integrity holds (tamper one row → verifyChain fails)
+ *   I4. Diagnose surfaces cascade pattern when upstream broke first
+ *   I5. Crawl plan only generated when ≥10 healthy findings recent
+ *   I6. Quantum signals respect bounds (entropy ≥ 0, stability ∈ [0,1])
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { withSuperQuanProbe, clearRegistry, snapshotRegistry, appendFinding, verifyChain, diagnose, planCrawl, buildBaseline, computeQuantumSignals, DEFAULT_PROTOPLASM_CONFIG, } from "./index.js";
+let tmpDir;
+let cfg;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "protoplasm-test-"));
+    cfg = { ...DEFAULT_PROTOPLASM_CONFIG, ledgerDir: tmpDir, hmacKey: "test-secret-key", crawlOnHealthyEvery: 5 };
+    clearRegistry();
+});
+afterEach(() => { try {
+    rmSync(tmpDir, { recursive: true, force: true });
+}
+catch { /* */ } });
+describe("I1 — wrapped fn identical behavior", () => {
+    it("sync return: identical output", () => {
+        const inner = (a, b) => a + b;
+        const wrapped = withSuperQuanProbe("test.add", inner, cfg);
+        expect(wrapped(2, 3)).toBe(5);
+        expect(wrapped(10, 20)).toBe(30);
+    });
+    it("sync throw: same exception bubbles", () => {
+        const inner = () => { throw new TypeError("nope"); };
+        const wrapped = withSuperQuanProbe("test.thrower", inner, cfg);
+        expect(() => wrapped()).toThrow(TypeError);
+    });
+    it("async resolve + reject", async () => {
+        const ok = withSuperQuanProbe("test.ok", async (x) => x * 2, cfg);
+        const bad = withSuperQuanProbe("test.bad", async () => { throw new Error("async fail"); }, cfg);
+        expect(await ok(21)).toBe(42);
+        await expect(bad()).rejects.toThrow("async fail");
+    });
+});
+describe("I3 — HMAC chain integrity", () => {
+    const sampleFinding = (fnId, outcome) => ({
+        fnId, at: new Date().toISOString(), outcome, zScores: { duration: 0.5 },
+        quantumSignals: { outputEntropy: 1, chaosDivergence: 1, neighborCorrelation: 0, collapseStability: 1 },
+        rootCauseHints: [], evidence: "test",
+    });
+    it("append 3 findings → chain verifies", () => {
+        const ledger = join(tmpDir, "findings.jsonl");
+        appendFinding(ledger, sampleFinding("a", "healthy"), cfg.hmacKey);
+        appendFinding(ledger, sampleFinding("b", "healthy"), cfg.hmacKey);
+        appendFinding(ledger, sampleFinding("c", "broken"), cfg.hmacKey);
+        const v = verifyChain(ledger, cfg.hmacKey);
+        expect(v.ok).toBe(true);
+        expect(v.rows).toBe(3);
+    });
+    it("tamper one row → verifyChain detects", () => {
+        const ledger = join(tmpDir, "findings.jsonl");
+        appendFinding(ledger, sampleFinding("a", "healthy"), cfg.hmacKey);
+        appendFinding(ledger, sampleFinding("b", "healthy"), cfg.hmacKey);
+        appendFinding(ledger, sampleFinding("c", "broken"), cfg.hmacKey);
+        // Tamper: change row 2's outcome
+        const lines = readFileSync(ledger, "utf8").trim().split("\n");
+        const row1 = JSON.parse(lines[1]);
+        row1.outcome = "broken";
+        lines[1] = JSON.stringify(row1);
+        writeFileSync(ledger, lines.join("\n") + "\n");
+        const v = verifyChain(ledger, cfg.hmacKey);
+        expect(v.ok).toBe(false);
+        expect(v.brokenAt).toBe(1);
+    });
+});
+describe("I4 — wisdom_space cascade detection", () => {
+    it("finds cascade when upstream broke earlier in window", () => {
+        const baseAt = Date.now();
+        const upstreamA = {
+            fnId: "fnA", at: new Date(baseAt - 30_000).toISOString(), outcome: "broken",
+            zScores: { duration: 4 }, quantumSignals: { outputEntropy: 0, chaosDivergence: 5, neighborCorrelation: 0, collapseStability: 0.3 },
+            rootCauseHints: [], evidence: "A broke first", hmac: "h1", prev: "h0",
+        };
+        const upstreamB = { ...upstreamA, fnId: "fnB", at: new Date(baseAt - 20_000).toISOString(), evidence: "B broke too", hmac: "h2", prev: "h1" };
+        const broken = { ...upstreamA, fnId: "fnDownstream", at: new Date(baseAt).toISOString(), evidence: "I broke too", hmac: "h3", prev: "h2" };
+        const result = diagnose({ brokenFinding: broken, recentLedger: [upstreamA, upstreamB, broken] });
+        expect(result.upstreamSuspects).toContain("fnA");
+        expect(result.upstreamSuspects).toContain("fnB");
+        expect(result.confidence).toBeGreaterThan(0.7);
+        expect(result.hypothesis).toMatch(/cascade/);
+    });
+});
+describe("I5 — crawl plan threshold", () => {
+    it("returns null when <10 healthy findings", () => {
+        const findings = Array.from({ length: 5 }, (_, i) => ({
+            fnId: "fnX", at: new Date().toISOString(), outcome: "healthy",
+            zScores: {}, quantumSignals: { outputEntropy: 1, chaosDivergence: 1, neighborCorrelation: 0, collapseStability: 1 },
+            rootCauseHints: [], evidence: "ok", hmac: `h${i}`, prev: i === 0 ? "0".repeat(16) : `h${i - 1}`,
+        }));
+        expect(planCrawl(findings)).toBeNull();
+    });
+    it("returns plan with topics when ≥10 healthy", () => {
+        const findings = Array.from({ length: 12 }, (_, i) => ({
+            fnId: "packages.core.src.nemesis.classifier", at: new Date().toISOString(), outcome: "healthy",
+            zScores: {}, quantumSignals: { outputEntropy: 1, chaosDivergence: 1, neighborCorrelation: 0, collapseStability: 1 },
+            rootCauseHints: [], evidence: "ok", hmac: `h${i}`, prev: i === 0 ? "0".repeat(16) : `h${i - 1}`,
+        }));
+        const plan = planCrawl(findings);
+        expect(plan).not.toBeNull();
+        expect(plan.searchTopics.length).toBeGreaterThan(0);
+        expect(plan.searchTopics.some((t) => t.includes("agent fingerprinting"))).toBe(true);
+    });
+});
+describe("I6 — quantum signal bounds", () => {
+    it("entropy ≥ 0, stability ∈ [0,1]", () => {
+        const snapshots = Array.from({ length: 30 }, (_, i) => ({
+            fnId: "x", ts: new Date().toISOString(), durationMs: 10 + Math.random() * 5,
+            args: { count: 1, shape: "number" },
+            output: i % 7 === 0 ? { kind: "throw", errorClass: "Error" } : { kind: "ok", shape: "number" },
+        }));
+        const baseline = buildBaseline("x", snapshots.slice(0, 20));
+        const qs = computeQuantumSignals(snapshots.slice(-10), baseline, 0.2);
+        expect(qs.outputEntropy).toBeGreaterThanOrEqual(0);
+        expect(qs.collapseStability).toBeGreaterThanOrEqual(0);
+        expect(qs.collapseStability).toBeLessThanOrEqual(1);
+        expect(qs.neighborCorrelation).toBe(0.2);
+    });
+});
+describe("I2 — registry tracks samples", () => {
+    it("snapshot reflects buffer growth", () => {
+        const fn = withSuperQuanProbe("test.counter", (x) => x + 1, cfg);
+        for (let i = 0; i < 30; i++)
+            fn(i);
+        const snap = snapshotRegistry().find((s) => s.fnId === "test.counter");
+        expect(snap).toBeDefined();
+        expect(snap.samples).toBe(30);
+        expect(snap.recent.length).toBe(25);
+    });
+});
+//# sourceMappingURL=protoplasm.test.js.map

package/dist/protoplasm/protoplasm.test.js.map

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

package/dist/protoplasm/quantum_probe.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 🦠 PROTOPLASM — quantum_probe
+ *
+ * Statistical + quantum-inspired probe over recorded InvocationSnapshots.
+ *
+ * The "quantum-inspired" part is analogical, not literal QM:
+ *   - outputEntropy: Shannon entropy of output shapes → high = decoherence
+ *   - chaosDivergence: spread of output given structured input perturbation
+ *   - collapseStability: proportion of calls that resolve cleanly (no throw)
+ *   - neighborCorrelation: did this function break in same window as neighbors?
+ *
+ * Why quantum-inspired metaphor: standard means/stdev miss multi-modal
+ * behavior. A function returning {success, fallback, throw} states needs
+ * a distributional signal, not just a central tendency.
+ */
+import type { InvocationSnapshot, FunctionBaseline, QuantumSignals, SuperQuanFinding, ProtoplasmConfig, ProbeOutcome } from "./types.js";
+export declare function buildBaseline(fnId: string, snapshots: InvocationSnapshot[]): FunctionBaseline;
+export declare function computeQuantumSignals(recent: InvocationSnapshot[], baseline: FunctionBaseline, neighborBrokenRate: number): QuantumSignals;
+export declare function gradeOutcome(zScores: Record<string, number>, quantum: QuantumSignals, cfg: ProtoplasmConfig): ProbeOutcome;
+export declare function runQuantumProbe(fnId: string, recent: InvocationSnapshot[], baseline: FunctionBaseline, cfg: ProtoplasmConfig, neighborBrokenRate?: number): Omit<SuperQuanFinding, "hmac" | "prev">;
+//# sourceMappingURL=quantum_probe.d.ts.map

package/dist/protoplasm/quantum_probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantum_probe.d.ts","sourceRoot":"","sources":["../../src/protoplasm/quantum_probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAC;AAwBpB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,CAoB7F;AAOD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,GAAG,cAAc,CAqB1I;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,gBAAgB,GAAG,YAAY,CAQ1H;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,EAAE,EAC5B,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,gBAAgB,EACrB,kBAAkB,SAAI,GACrB,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC,CAoBzC"}

package/dist/protoplasm/quantum_probe.js

@@ -0,0 +1,118 @@
+/**
+ * 🦠 PROTOPLASM — quantum_probe
+ *
+ * Statistical + quantum-inspired probe over recorded InvocationSnapshots.
+ *
+ * The "quantum-inspired" part is analogical, not literal QM:
+ *   - outputEntropy: Shannon entropy of output shapes → high = decoherence
+ *   - chaosDivergence: spread of output given structured input perturbation
+ *   - collapseStability: proportion of calls that resolve cleanly (no throw)
+ *   - neighborCorrelation: did this function break in same window as neighbors?
+ *
+ * Why quantum-inspired metaphor: standard means/stdev miss multi-modal
+ * behavior. A function returning {success, fallback, throw} states needs
+ * a distributional signal, not just a central tendency.
+ */
+/** Shannon entropy over a histogram (normalized to 1). */
+function shannonEntropy(counts) {
+    const total = [...counts.values()].reduce((a, b) => a + b, 0);
+    if (total === 0)
+        return 0;
+    let h = 0;
+    for (const c of counts.values()) {
+        if (c === 0)
+            continue;
+        const p = c / total;
+        h -= p * Math.log2(p);
+    }
+    return h;
+}
+function shapeHistogram(snapshots, key) {
+    const h = new Map();
+    for (const s of snapshots) {
+        const k = key === "argShape" ? s.args.shape : (s.output.shape ?? `throw:${s.output.errorClass}`);
+        h.set(k, (h.get(k) ?? 0) + 1);
+    }
+    return h;
+}
+export function buildBaseline(fnId, snapshots) {
+    if (snapshots.length === 0) {
+        return { fnId, samples: 0, durationMean: 0, durationStdev: 0, errorRate: 0, argShapeEntropy: 0, outputShapeEntropy: 0, lastUpdate: new Date().toISOString() };
+    }
+    const durations = snapshots.map((s) => s.durationMs);
+    const mean = durations.reduce((a, b) => a + b, 0) / durations.length;
+    const variance = durations.reduce((a, b) => a + (b - mean) ** 2, 0) / Math.max(1, durations.length - 1);
+    const errorRate = snapshots.filter((s) => s.output.kind === "throw").length / snapshots.length;
+    const argEntropy = shannonEntropy(shapeHistogram(snapshots, "argShape"));
+    const outEntropy = shannonEntropy(shapeHistogram(snapshots, "outputShape"));
+    return {
+        fnId,
+        samples: snapshots.length,
+        durationMean: mean,
+        durationStdev: Math.sqrt(variance),
+        errorRate,
+        argShapeEntropy: argEntropy,
+        outputShapeEntropy: outEntropy,
+        lastUpdate: new Date().toISOString(),
+    };
+}
+function zScore(value, mean, stdev) {
+    if (stdev < 1e-9)
+        return Math.abs(value - mean) < 1e-9 ? 0 : Number.POSITIVE_INFINITY;
+    return (value - mean) / stdev;
+}
+export function computeQuantumSignals(recent, baseline, neighborBrokenRate) {
+    const outputEntropy = shannonEntropy(shapeHistogram(recent, "outputShape"));
+    const throwCount = recent.filter((s) => s.output.kind === "throw").length;
+    const collapseStability = recent.length === 0 ? 1 : 1 - throwCount / recent.length;
+    // chaosDivergence: stdev of durations among non-throw calls / baseline.stdev
+    const okDurations = recent.filter((s) => s.output.kind === "ok").map((s) => s.durationMs);
+    let chaos = 0;
+    if (okDurations.length >= 2) {
+        const m = okDurations.reduce((a, b) => a + b, 0) / okDurations.length;
+        const v = okDurations.reduce((a, b) => a + (b - m) ** 2, 0) / (okDurations.length - 1);
+        const recentStdev = Math.sqrt(v);
+        chaos = baseline.durationStdev < 1e-9 ? recentStdev : recentStdev / baseline.durationStdev;
+    }
+    return {
+        outputEntropy,
+        chaosDivergence: chaos,
+        neighborCorrelation: neighborBrokenRate,
+        collapseStability,
+    };
+}
+export function gradeOutcome(zScores, quantum, cfg) {
+    const maxZ = Math.max(...Object.values(zScores).map((z) => Math.abs(z)));
+    if (maxZ > cfg.zScoreBroken)
+        return "broken";
+    if (maxZ > cfg.zScoreWarn)
+        return "warn";
+    if (quantum.collapseStability < 0.7)
+        return "broken";
+    if (quantum.outputEntropy > 4 && quantum.collapseStability < 0.85)
+        return "warn";
+    if (quantum.neighborCorrelation > 0.5 && maxZ > 1.5)
+        return "warn";
+    return "healthy";
+}
+export function runQuantumProbe(fnId, recent, baseline, cfg, neighborBrokenRate = 0) {
+    if (recent.length === 0) {
+        return {
+            fnId, at: new Date().toISOString(), outcome: "healthy",
+            zScores: {}, quantumSignals: { outputEntropy: 0, chaosDivergence: 0, neighborCorrelation: 0, collapseStability: 1 },
+            rootCauseHints: [], evidence: "no recent invocations to probe",
+        };
+    }
+    const recentDur = recent.map((s) => s.durationMs);
+    const recentMean = recentDur.reduce((a, b) => a + b, 0) / recentDur.length;
+    const recentErrorRate = recent.filter((s) => s.output.kind === "throw").length / recent.length;
+    const zScores = {
+        duration: zScore(recentMean, baseline.durationMean, baseline.durationStdev),
+        errorRate: baseline.errorRate < 1e-9 && recentErrorRate > 0 ? Number.POSITIVE_INFINITY : (recentErrorRate - baseline.errorRate) / Math.max(0.01, baseline.errorRate),
+    };
+    const quantum = computeQuantumSignals(recent, baseline, neighborBrokenRate);
+    const outcome = gradeOutcome(zScores, quantum, cfg);
+    const evidence = `${recent.length} recent calls · meanDur ${recentMean.toFixed(1)}ms (z=${zScores.duration.toFixed(2)}) · errRate ${(recentErrorRate * 100).toFixed(1)}% · entropy ${quantum.outputEntropy.toFixed(2)} · stability ${(quantum.collapseStability * 100).toFixed(0)}%`;
+    return { fnId, at: new Date().toISOString(), outcome, zScores, quantumSignals: quantum, rootCauseHints: [], evidence };
+}
+//# sourceMappingURL=quantum_probe.js.map

package/dist/protoplasm/quantum_probe.js.map

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

package/dist/protoplasm/seamless_boot.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 🤝 PROTOPLASM — SEAMLESS BOOT
+ *
+ * Zero-config auto-init. User does nothing.
+ *
+ * Pattern: when @mneme-ai/core is imported (any CLI cmd, any MCP call,
+ * any SDK call), seamlessBoot() runs once. It:
+ *   1. Activates PARASITE context (loads WAL baselines)
+ *   2. Writes heartbeat
+ *   3. Spawns GHOST CELL (detached watchdog)
+ *
+ * Cost: ~5ms per first-import-per-process.
+ * Benefit: PROTOPLASM is alive from the very first Mneme tool call,
+ *          forever, without any user action.
+ */
+import type { ProtoplasmConfig } from "./types.js";
+/** Provenance of current HMAC key. Useful for telemetry / first-run UX. */
+export declare function getKeyProvenance(): "env" | "file" | "generated";
+/** Idempotent. Safe to call from anywhere; runs once per process. */
+export declare function seamlessBoot(cfg?: ProtoplasmConfig): {
+    booted: boolean;
+    bootedAt: string;
+    pid: number;
+};
+/** For tests: reset boot flag. */
+export declare function _resetBoot(): void;
+export declare function isBooted(): boolean;
+//# sourceMappingURL=seamless_boot.d.ts.map

package/dist/protoplasm/seamless_boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seamless_boot.d.ts","sourceRoot":"","sources":["../../src/protoplasm/seamless_boot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAyCnD,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,KAAK,GAAG,MAAM,GAAG,WAAW,CAA2B;AAE3F,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,GAAG,GAAE,gBAAmC,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAuCzH;AAED,kCAAkC;AAClC,wBAAgB,UAAU,IAAI,IAAI,CAAoC;AACtE,wBAAgB,QAAQ,IAAI,OAAO,CAAmB"}

package/dist/protoplasm/seamless_boot.js

@@ -0,0 +1,106 @@
+/**
+ * 🤝 PROTOPLASM — SEAMLESS BOOT
+ *
+ * Zero-config auto-init. User does nothing.
+ *
+ * Pattern: when @mneme-ai/core is imported (any CLI cmd, any MCP call,
+ * any SDK call), seamlessBoot() runs once. It:
+ *   1. Activates PARASITE context (loads WAL baselines)
+ *   2. Writes heartbeat
+ *   3. Spawns GHOST CELL (detached watchdog)
+ *
+ * Cost: ~5ms per first-import-per-process.
+ * Benefit: PROTOPLASM is alive from the very first Mneme tool call,
+ *          forever, without any user action.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+import { randomBytes } from "node:crypto";
+import { activateParasite, parasiteTick } from "./parasite.js";
+import { spawnGhostCell } from "./ghost_cell.js";
+let BOOTED = false;
+let BOOT_TS = null;
+/** First-run HMAC key wizard:
+ *  1. env var set → use it (caller-controlled, best)
+ *  2. .mneme/protoplasm/.key file exists → load it (per-repo persistent)
+ *  3. neither → generate 32-byte random key + write file with 0600 + warn
+ *  Returns the key + provenance for telemetry. */
+function ensureHmacKey(ledgerDir) {
+    const envKey = process.env.MNEME_PROTOPLASM_KEY;
+    if (envKey && envKey.length >= 16)
+        return { key: envKey, provenance: "env" };
+    try {
+        mkdirSync(ledgerDir, { recursive: true });
+        const keyPath = join(ledgerDir, ".key");
+        if (existsSync(keyPath)) {
+            const k = readFileSync(keyPath, "utf8").trim();
+            if (k.length >= 16)
+                return { key: k, provenance: "file" };
+        }
+        const fresh = randomBytes(32).toString("hex");
+        writeFileSync(keyPath, fresh, { encoding: "utf8" });
+        try {
+            chmodSync(keyPath, 0o600);
+        }
+        catch { /* windows ignores */ }
+        return { key: fresh, provenance: "generated" };
+    }
+    catch {
+        return { key: "dev-protoplasm-fallback-INSECURE", provenance: "generated" };
+    }
+}
+const DEFAULT_LEDGER = ".mneme/protoplasm";
+const { key: AUTO_KEY, provenance: KEY_PROVENANCE } = ensureHmacKey(DEFAULT_LEDGER);
+const DEFAULT_BOOT_CFG = {
+    baselineSamplesMin: 5,
+    zScoreWarn: 2,
+    zScoreBroken: 3,
+    ledgerDir: DEFAULT_LEDGER,
+    hmacKey: AUTO_KEY,
+    crawlOnHealthyEvery: 50,
+};
+/** Provenance of current HMAC key. Useful for telemetry / first-run UX. */
+export function getKeyProvenance() { return KEY_PROVENANCE; }
+/** Idempotent. Safe to call from anywhere; runs once per process. */
+export function seamlessBoot(cfg = DEFAULT_BOOT_CFG) {
+    if (BOOTED)
+        return { booted: false, bootedAt: BOOT_TS, pid: process.pid };
+    BOOTED = true;
+    BOOT_TS = new Date().toISOString();
+    try {
+        activateParasite(cfg);
+        parasiteTick(cfg);
+        spawnGhostCell({ parentPid: process.pid, ledgerDir: cfg.ledgerDir, hmacKey: cfg.hmacKey });
+        // Register process exit cleanup — write final heartbeat so ghost knows clean exit
+        process.on("exit", () => {
+            try {
+                writeFileSync(cfg.ledgerDir + "/heartbeat.json", JSON.stringify({
+                    pid: process.pid,
+                    ts: new Date().toISOString(),
+                    cleanExit: true,
+                }));
+            }
+            catch { /* */ }
+        });
+        // Catch uncaught + unhandled — write WAL "incident" then re-throw
+        process.on("uncaughtException", (err) => {
+            try {
+                appendFileSync(cfg.ledgerDir + "/incidents.jsonl", JSON.stringify({ ts: new Date().toISOString(), pid: process.pid, kind: "uncaughtException", message: err.message, stack: err.stack }) + "\n");
+            }
+            catch { /* */ }
+            throw err;
+        });
+        process.on("unhandledRejection", (reason) => {
+            try {
+                appendFileSync(cfg.ledgerDir + "/incidents.jsonl", JSON.stringify({ ts: new Date().toISOString(), pid: process.pid, kind: "unhandledRejection", message: String(reason?.message ?? reason) }) + "\n");
+            }
+            catch { /* */ }
+        });
+    }
+    catch { /* boot must NEVER throw — degrades gracefully */ }
+    return { booted: true, bootedAt: BOOT_TS, pid: process.pid };
+}
+/** For tests: reset boot flag. */
+export function _resetBoot() { BOOTED = false; BOOT_TS = null; }
+export function isBooted() { return BOOTED; }
+//# sourceMappingURL=seamless_boot.js.map

package/dist/protoplasm/seamless_boot.js.map

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

package/dist/protoplasm/super_quan_probe.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 🦠 PROTOPLASM — super_quan_probe decorator
+ *
+ * The "live atom" that gets embedded in every function:
+ *   const wrapped = withSuperQuanProbe("module.fn", fn);
+ *
+ * On every call:
+ *   - records InvocationSnapshot to in-memory rolling buffer
+ *   - if buffer reaches probe interval → run quantum probe → emit finding
+ *
+ * Zero behavioral change to wrapped fn. Sync + async supported.
+ * Hot-path overhead target: <50µs per call (only timing + shape).
+ */
+import type { InvocationSnapshot, ProtoplasmConfig, SuperQuanFinding } from "./types.js";
+export declare function onFinding(listener: (f: SuperQuanFinding) => void): () => void;
+export declare function withSuperQuanProbe<F extends (...args: any[]) => any>(fnId: string, fn: F, cfg?: ProtoplasmConfig): F;
+/** Snapshot of the registry — for orchestrator / wisdom_space inspection. */
+export declare function snapshotRegistry(): Array<{
+    fnId: string;
+    samples: number;
+    recent: InvocationSnapshot[];
+}>;
+export declare function clearRegistry(): void;
+//# sourceMappingURL=super_quan_probe.d.ts.map

package/dist/protoplasm/super_quan_probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"super_quan_probe.d.ts","sourceRoot":"","sources":["../../src/protoplasm/super_quan_probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAoB,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmC3G,wBAAgB,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAG7E;AA+BD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,CAAC,CA+CpH;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAEzG;AAED,wBAAgB,aAAa,IAAI,IAAI,CAAsB"}