@mneme-ai/core 2.66.0 → 2.68.0

package/dist/protoplasm/extensions.test.js

@@ -0,0 +1,175 @@
+/**
+ * 🧬 PROTOPLASM — v2.68.0 extension tests
+ *
+ * Pin invariants for USB SOUL / HYDRA QUORUM / LAN GOSSIP / TS AUTO-WRAP /
+ * CRIU PICKLE. Tests skip the OS-specific bits where they cannot run.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync, readFileSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { syncTo, syncFrom, verifyMount } from "./usb_soul.js";
+import { statusHydra, tryBecomePrimary, refreshPrimary, releasePrimary } from "./hydra_quorum.js";
+import { LanGossip, GOSSIP_TUNING } from "./lan_gossip.js";
+import { scanSourceFile, rewriteSourceFile } from "./ts_auto_wrap.js";
+import { probeCriu, snapshot, restore } from "./criu_pickle.js";
+let tmpDir;
+beforeEach(() => { tmpDir = mkdtempSync(join(tmpdir(), "protoplasm-ext-")); });
+afterEach(() => { try {
+    rmSync(tmpDir, { recursive: true, force: true });
+}
+catch { /* */ } });
+describe("USB SOUL", () => {
+    it("syncTo + syncFrom round-trip preserves files", () => {
+        const ledger = join(tmpDir, "ledger");
+        const mount = join(tmpDir, "fake-usb");
+        require("node:fs").mkdirSync(ledger, { recursive: true });
+        require("node:fs").mkdirSync(mount, { recursive: true });
+        writeFileSync(join(ledger, "wal.jsonl"), "wal-content");
+        writeFileSync(join(ledger, "findings.jsonl"), "findings-content");
+        writeFileSync(join(ledger, ".key"), "secret-key-32-chars-min-please-ok");
+        const out = syncTo(mount, ledger);
+        expect(out.ok).toBe(true);
+        expect(out.copied?.length).toBe(3);
+        const restoreDir = join(tmpDir, "restored");
+        const r = syncFrom(mount, restoreDir);
+        expect(r.ok).toBe(true);
+        expect(readFileSync(join(restoreDir, "wal.jsonl"), "utf8")).toBe("wal-content");
+        expect(readFileSync(join(restoreDir, ".key"), "utf8")).toBe("secret-key-32-chars-min-please-ok");
+    });
+    it("verifyMount false on nonexistent path", () => {
+        const v = verifyMount(join(tmpDir, "does-not-exist"));
+        expect(v.ok).toBe(false);
+    });
+    it("syncTo fails gracefully on bad mount", () => {
+        const r = syncTo("/nonexistent/path/whatsoever", tmpDir);
+        expect(r.ok).toBe(false);
+        expect(r.reason).toBeTruthy();
+    });
+});
+describe("HYDRA QUORUM", () => {
+    it("first pid acquires primary; second sees secondary (must use real alive pid for primary)", () => {
+        const ledger = tmpDir;
+        const realPid = process.pid; // alive
+        const fakeSecondaryPid = 99002; // dead — just for "other observer" pov
+        const a = tryBecomePrimary(ledger, realPid);
+        expect(a.role).toBe("primary");
+        const bStatus = statusHydra(ledger, fakeSecondaryPid);
+        expect(bStatus.role).toBe("secondary");
+        expect(bStatus.primaryPid).toBe(realPid);
+    });
+    it("stale primary lock (dead pid) → status reports uncontested for any observer", () => {
+        const ledger = tmpDir;
+        // Write a lock with a known-dead pid
+        writeFileSync(join(ledger, "hydra.primary"), JSON.stringify({ pid: 99001, ts: Date.now() }));
+        const s = statusHydra(ledger, process.pid);
+        expect(s.role).toBe("uncontested"); // dead pid → can take over
+    });
+    it("refreshPrimary returns false when displaced", () => {
+        const ledger = tmpDir;
+        tryBecomePrimary(ledger, process.pid);
+        // Externally overwrite to simulate displacement
+        writeFileSync(join(ledger, "hydra.primary"), JSON.stringify({ pid: 88888, ts: Date.now() }));
+        const ok = refreshPrimary(ledger, process.pid);
+        expect(ok).toBe(false);
+    });
+    it("releasePrimary unlinks lock", () => {
+        const ledger = tmpDir;
+        tryBecomePrimary(ledger, process.pid);
+        expect(existsSync(join(ledger, "hydra.primary"))).toBe(true);
+        releasePrimary(ledger, process.pid);
+        expect(existsSync(join(ledger, "hydra.primary"))).toBe(false);
+    });
+});
+describe("LAN GOSSIP", () => {
+    it("HMAC frame round-trip via loopback unicast", async () => {
+        // Use 2 sockets on localhost, NOT multicast (CI environments often block multicast)
+        const g1 = new LanGossip({ secret: "test-secret-gossip", group: "127.0.0.1", port: 0 });
+        const r1 = await g1.start();
+        // Even if multicast fails, peer storage logic still works in unit test via direct handleMessage
+        expect(typeof r1.ok).toBe("boolean");
+        g1.close();
+    }, 5000);
+    it("verifyFrame rejects tampered hmac", async () => {
+        const g = new LanGossip({ secret: "secret-a" });
+        const r = await g.start();
+        if (!r.ok) {
+            g.close();
+            return;
+        } // skip when multicast unavailable
+        let receivedCount = 0;
+        const tamperFrame = JSON.stringify({ v: 1, hostId: "evil", pid: 99, ts: new Date().toISOString(),
+            summary: { healthy: 999, warn: 0, broken: 0, totalFns: 0, walRows: 0 }, hmac: "DEADBEEF12345678" });
+        const sock = require("node:dgram").createSocket("udp4");
+        sock.send(Buffer.from(tamperFrame), GOSSIP_TUNING.DEFAULT_PORT, GOSSIP_TUNING.DEFAULT_GROUP);
+        await new Promise((r) => setTimeout(r, 200));
+        expect(receivedCount).toBe(0); // tampered should be silently rejected
+        sock.close();
+        g.close();
+    }, 5000);
+});
+describe("TS AUTO-WRAP — scan + rewrite", () => {
+    it("scanSourceFile finds export function + arrow exports", () => {
+        const src = join(tmpDir, "sample.ts");
+        writeFileSync(src, `
+export function alpha(x: number) { return x * 2; }
+export async function beta(): Promise<void> { return; }
+export const gamma = (n: number) => n + 1;
+export const delta = async () => 42;
+const internal = () => 0;        // not exported, must be ignored
+export { someOther } from "./other.js";  // re-export, ignored
+`);
+        const r = scanSourceFile(src);
+        expect(r.exports.find((e) => e.name === "alpha")).toBeDefined();
+        expect(r.exports.find((e) => e.name === "beta")?.isAsync).toBe(true);
+        expect(r.exports.find((e) => e.name === "gamma")).toBeDefined();
+        expect(r.exports.find((e) => e.name === "internal")).toBeUndefined();
+        expect(r.hasImportSuperQuan).toBe(false);
+    });
+    it("rewriteSourceFile dry-run reports count without writing", () => {
+        const src = join(tmpDir, "sample.ts");
+        const original = `export function foo() { return 1; }\nexport async function bar() { return 2; }\n`;
+        writeFileSync(src, original);
+        const r = rewriteSourceFile(src, "sample", { dryRun: true });
+        expect(r.exportsWrapped).toBe(2);
+        expect(r.rewritten).toBe(false);
+        expect(readFileSync(src, "utf8")).toBe(original);
+    });
+    it("rewriteSourceFile refuses when super_quan already imported", () => {
+        const src = join(tmpDir, "sample.ts");
+        writeFileSync(src, `import { withSuperQuanProbe } from "@mneme-ai/core/protoplasm";\nexport function foo() {}\n`);
+        const r = rewriteSourceFile(src, "sample");
+        expect(r.rewritten).toBe(false);
+        expect(r.reason).toMatch(/already imports/);
+    });
+});
+describe("CRIU PICKLE (Linux-only — graceful on Win/macOS)", () => {
+    it("probeCriu returns supported=false on non-Linux", () => {
+        const r = probeCriu();
+        if (process.platform !== "linux") {
+            expect(r.supported).toBe(false);
+            expect(r.reason).toMatch(/Linux-only/);
+        }
+        else {
+            // on Linux without criu installed: still false but different reason
+            expect([true, false]).toContain(r.supported);
+        }
+    });
+    it("snapshot returns ok=false with reason on unsupported platform", () => {
+        if (process.platform === "linux")
+            return; // skip — Linux may succeed
+        const r = snapshot(process.pid, tmpDir);
+        expect(r.ok).toBe(false);
+        expect(r.reason).toBeTruthy();
+    });
+    it("restore on missing image dir returns ok=false", () => {
+        if (process.platform !== "linux") {
+            const r = restore("/nonexistent");
+            expect(r.ok).toBe(false);
+            return;
+        }
+        const r = restore(join(tmpDir, "does-not-exist"));
+        expect(r.ok).toBe(false);
+    });
+});
+//# sourceMappingURL=extensions.test.js.map

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

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

package/dist/protoplasm/findings_ledger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 🦠 PROTOPLASM — findings_ledger
+ *
+ * HMAC-chained append-only log of super_quan findings.
+ * Same canonical-JSON pattern as PASSPORT/MIRRAGE/TIME-CRYSTAL/REFLOG ledgers.
+ */
+import type { SuperQuanFinding } from "./types.js";
+/** Canonical JSON: deterministic key sort + undefined removed. */
+export declare function canonicalJson(obj: unknown): string;
+export declare function chainHmac(prevHmac: string, finding: Omit<SuperQuanFinding, "hmac" | "prev">, secret: string): string;
+export declare function appendFinding(ledgerPath: string, finding: Omit<SuperQuanFinding, "hmac" | "prev">, secret: string): SuperQuanFinding;
+export declare function lastHmac(ledgerPath: string): string;
+export declare function readLedger(ledgerPath: string): SuperQuanFinding[];
+export declare function verifyChain(ledgerPath: string, secret: string): {
+    ok: boolean;
+    brokenAt?: number;
+    rows: number;
+};
+//# sourceMappingURL=findings_ledger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findings_ledger.d.ts","sourceRoot":"","sources":["../../src/protoplasm/findings_ledger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAelD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpH;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC,EAChD,MAAM,EAAE,MAAM,GACb,gBAAgB,CAOlB;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAKjE;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAWhH"}

package/dist/protoplasm/findings_ledger.js

@@ -0,0 +1,81 @@
+/**
+ * 🦠 PROTOPLASM — findings_ledger
+ *
+ * HMAC-chained append-only log of super_quan findings.
+ * Same canonical-JSON pattern as PASSPORT/MIRRAGE/TIME-CRYSTAL/REFLOG ledgers.
+ */
+import { createHmac } from "node:crypto";
+import { appendFileSync, existsSync, readFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+/** Canonical JSON: deterministic key sort + undefined removed. */
+export function canonicalJson(obj) {
+    const seen = new WeakSet();
+    const visit = (v) => {
+        if (v === null || typeof v !== "object")
+            return v;
+        if (seen.has(v))
+            return "[Circular]";
+        seen.add(v);
+        if (Array.isArray(v))
+            return v.map(visit);
+        const sorted = {};
+        for (const k of Object.keys(v).sort()) {
+            const val = v[k];
+            if (val !== undefined)
+                sorted[k] = visit(val);
+        }
+        return sorted;
+    };
+    return JSON.stringify(visit(obj));
+}
+export function chainHmac(prevHmac, finding, secret) {
+    return createHmac("sha256", secret).update(prevHmac + "::" + canonicalJson(finding)).digest("hex").slice(0, 16);
+}
+export function appendFinding(ledgerPath, finding, secret) {
+    mkdirSync(dirname(ledgerPath), { recursive: true });
+    const prev = lastHmac(ledgerPath);
+    const hmac = chainHmac(prev, finding, secret);
+    const full = { ...finding, prev, hmac };
+    appendFileSync(ledgerPath, JSON.stringify(full) + "\n", "utf8");
+    return full;
+}
+export function lastHmac(ledgerPath) {
+    if (!existsSync(ledgerPath))
+        return "0".repeat(16);
+    const lines = readFileSync(ledgerPath, "utf8").trim().split("\n").filter(Boolean);
+    if (lines.length === 0)
+        return "0".repeat(16);
+    try {
+        return JSON.parse(lines[lines.length - 1]).hmac;
+    }
+    catch {
+        return "0".repeat(16);
+    }
+}
+export function readLedger(ledgerPath) {
+    if (!existsSync(ledgerPath))
+        return [];
+    return readFileSync(ledgerPath, "utf8").trim().split("\n").filter(Boolean).map((l) => {
+        try {
+            return JSON.parse(l);
+        }
+        catch {
+            return null;
+        }
+    }).filter((x) => x !== null);
+}
+export function verifyChain(ledgerPath, secret) {
+    const rows = readLedger(ledgerPath);
+    let prev = "0".repeat(16);
+    for (let i = 0; i < rows.length; i++) {
+        const { hmac, prev: storedPrev, ...rest } = rows[i];
+        if (storedPrev !== prev)
+            return { ok: false, brokenAt: i, rows: rows.length };
+        const recomputed = chainHmac(prev, rest, secret);
+        if (recomputed !== hmac)
+            return { ok: false, brokenAt: i, rows: rows.length };
+        prev = hmac;
+    }
+    return { ok: true, rows: rows.length };
+}
+//# sourceMappingURL=findings_ledger.js.map

package/dist/protoplasm/findings_ledger.js.map

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

package/dist/protoplasm/ghost_cell.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 👻 PROTOPLASM — GHOST CELL
+ *
+ * Every `mneme <cmd>` spawns a detached watchdog child that outlives
+ * parent by N seconds. If parent dies cleanly (exit 0), ghost expires
+ * silently. If parent dies abnormally (SIGKILL, SIGSEGV, exit != 0),
+ * ghost detects + spawns heal cycle.
+ *
+ * "Last words of dying parent → first words of newborn child."
+ *
+ * Implementation:
+ *   spawn(node, [ghost_script], { detached: true, stdio: 'ignore' }).unref()
+ *
+ * Ghost script:
+ *   - Waits N seconds polling parent PID
+ *   - Reads parent's last heartbeat from .mneme/protoplasm/heartbeat.json
+ *   - If heartbeat is stale + parent gone → trigger heal
+ *
+ * Detached + unref'd means parent can exit and ghost continues.
+ */
+export interface GhostCellOptions {
+    parentPid: number;
+    ledgerDir: string;
+    watchdogMs?: number;
+    hmacKey: string;
+}
+/** Spawn a detached ghost cell that watches the current process.
+ *  Returns child PID. Parent can exit immediately; ghost continues. */
+export declare function spawnGhostCell(opts: GhostCellOptions): number | null;
+//# sourceMappingURL=ghost_cell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ghost_cell.d.ts","sourceRoot":"","sources":["../../src/protoplasm/ghost_cell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqDD;uEACuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAuBpE"}

package/dist/protoplasm/ghost_cell.js

@@ -0,0 +1,95 @@
+/**
+ * 👻 PROTOPLASM — GHOST CELL
+ *
+ * Every `mneme <cmd>` spawns a detached watchdog child that outlives
+ * parent by N seconds. If parent dies cleanly (exit 0), ghost expires
+ * silently. If parent dies abnormally (SIGKILL, SIGSEGV, exit != 0),
+ * ghost detects + spawns heal cycle.
+ *
+ * "Last words of dying parent → first words of newborn child."
+ *
+ * Implementation:
+ *   spawn(node, [ghost_script], { detached: true, stdio: 'ignore' }).unref()
+ *
+ * Ghost script:
+ *   - Waits N seconds polling parent PID
+ *   - Reads parent's last heartbeat from .mneme/protoplasm/heartbeat.json
+ *   - If heartbeat is stale + parent gone → trigger heal
+ *
+ * Detached + unref'd means parent can exit and ghost continues.
+ */
+import { spawn } from "node:child_process";
+import { writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+const GHOST_SCRIPT = `
+const fs = require("node:fs");
+const path = require("node:path");
+const { parentPid, ledgerDir, watchdogMs } = JSON.parse(process.argv[2] || "{}");
+const heartbeatPath = path.join(ledgerDir, "heartbeat.json");
+const ghostLogPath = path.join(ledgerDir, "ghost_log.jsonl");
+
+function alive(pid) {
+  try { process.kill(pid, 0); return true; } catch { return false; }
+}
+
+function log(event, details) {
+  try {
+    fs.appendFileSync(ghostLogPath, JSON.stringify({ ts: new Date().toISOString(), pid: process.pid, event, parentPid, details }) + "\\n");
+  } catch {}
+}
+
+log("ghost-spawned", { watchdogMs });
+
+const deadline = Date.now() + (watchdogMs || 30000);
+let parentDiedAt = null;
+
+(async () => {
+  while (Date.now() < deadline) {
+    if (parentDiedAt === null && !alive(parentPid)) {
+      parentDiedAt = Date.now();
+      log("parent-died");
+      // Check if parent left a clean shutdown marker (heartbeat ts within last 1s)
+      try {
+        const hb = JSON.parse(fs.readFileSync(heartbeatPath, "utf8"));
+        const hbAge = Date.now() - new Date(hb.ts).getTime();
+        if (hbAge < 1000) {
+          log("clean-exit", { hbAge });
+        } else {
+          log("abnormal-exit", { hbAge });
+          // FUTURE: trigger heal action — for now just log
+          fs.appendFileSync(path.join(ledgerDir, "heal_queue.jsonl"),
+            JSON.stringify({ ts: new Date().toISOString(), parentPid, reason: "ghost-detected-abnormal-exit", hbAge }) + "\\n");
+        }
+      } catch (e) {
+        log("heartbeat-read-error", { msg: String(e) });
+      }
+      break;
+    }
+    await new Promise(r => setTimeout(r, 500));
+  }
+  log("ghost-expired");
+  process.exit(0);
+})();
+`;
+/** Spawn a detached ghost cell that watches the current process.
+ *  Returns child PID. Parent can exit immediately; ghost continues. */
+export function spawnGhostCell(opts) {
+    try {
+        mkdirSync(opts.ledgerDir, { recursive: true });
+        // Write ghost script to temp file (detached child needs accessible script)
+        const scriptPath = join(opts.ledgerDir, "ghost_runner.cjs");
+        writeFileSync(scriptPath, GHOST_SCRIPT, "utf8");
+        // Windows quirk: detached + paths with spaces need shell wrapping;
+        // POSIX works with direct exec.
+        const isWin = process.platform === "win32";
+        const child = isWin
+            ? spawn(process.execPath, [scriptPath, JSON.stringify({ parentPid: opts.parentPid, ledgerDir: opts.ledgerDir, watchdogMs: opts.watchdogMs ?? 30000 })], { detached: true, stdio: "ignore", windowsHide: true, windowsVerbatimArguments: false })
+            : spawn(process.execPath, [scriptPath, JSON.stringify({ parentPid: opts.parentPid, ledgerDir: opts.ledgerDir, watchdogMs: opts.watchdogMs ?? 30000 })], { detached: true, stdio: "ignore" });
+        child.unref();
+        return child.pid ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ghost_cell.js.map

package/dist/protoplasm/ghost_cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost_cell.js","sourceRoot":"","sources":["../../src/protoplasm/ghost_cell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDpB,CAAC;AAEF;uEACuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAsB;IACnD,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,2EAA2E;QAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAC5D,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAChD,mEAAmE;QACnE,gCAAgC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC3C,MAAM,KAAK,GAAG,KAAK;YACjB,CAAC,CAAC,KAAK,CACH,OAAO,CAAC,QAAQ,EAChB,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC,CAAC,EAC5H,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,CACxF;YACH,CAAC,CAAC,KAAK,CACH,OAAO,CAAC,QAAQ,EAChB,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC,CAAC,EAC5H,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CACpC,CAAC;QACN,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC"}

package/dist/protoplasm/hydra_quorum.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 🐉 PROTOPLASM — HYDRA QUORUM
+ *
+ * "Cut one head, two more grow."
+ *
+ * Multi-process co-hosting. N PIDs (typically 3) compete for PRIMARY
+ * lock; non-primaries become SECONDARIES. Primary writes new findings;
+ * secondaries replay + watch.
+ *
+ * Leader election: simple file-based lock with timeout.
+ *   - .mneme/protoplasm/hydra.primary    (PID + timestamp of current primary)
+ *   - lock acquired by atomic write-if-not-exists
+ *   - primary refreshes timestamp every 5s
+ *   - if primary stale (>15s) → any secondary can take over
+ *
+ * No Raft / Paxos — file-based is enough for liveness; HMAC chain on
+ * findings remains the trust layer regardless of which head wrote what.
+ */
+export type HydraRole = "primary" | "secondary" | "uncontested";
+export interface HydraStatus {
+    role: HydraRole;
+    primaryPid: number | null;
+    primaryAge: number;
+    ownPid: number;
+    acquiredAt?: string;
+    lockPath: string;
+}
+export declare function statusHydra(ledgerDir: string, ownPid?: number): HydraStatus;
+/** Attempt to become primary. Idempotent if already primary.
+ *  Returns final role + reason. */
+export declare function tryBecomePrimary(ledgerDir: string, ownPid?: number): HydraStatus;
+/** Refresh primary timestamp (call every REFRESH_MS while primary).
+ *  Returns true if still primary; false if got displaced. */
+export declare function refreshPrimary(ledgerDir: string, ownPid?: number): boolean;
+/** Release primary (graceful step-down). */
+export declare function releasePrimary(ledgerDir: string, ownPid?: number): boolean;
+/** Wire as background refresher. Returns cancel fn. */
+export declare function startHydraHeartbeat(ledgerDir: string, ownPid?: number): () => void;
+export declare const HYDRA_TUNING: {
+    STALE_MS: number;
+    REFRESH_MS: number;
+};
+//# sourceMappingURL=hydra_quorum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydra_quorum.d.ts","sourceRoot":"","sources":["../../src/protoplasm/hydra_quorum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgCD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,WAAW,CAQhF;AAED;mCACmC;AACnC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,WAAW,CAQrF;AAED;6DAC6D;AAC7D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,OAAO,CAM/E;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,OAAO,CAK/E;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,MAAM,IAAI,CAUvF;AAED,eAAO,MAAM,YAAY;;;CAA2B,CAAC"}

package/dist/protoplasm/hydra_quorum.js

@@ -0,0 +1,124 @@
+/**
+ * 🐉 PROTOPLASM — HYDRA QUORUM
+ *
+ * "Cut one head, two more grow."
+ *
+ * Multi-process co-hosting. N PIDs (typically 3) compete for PRIMARY
+ * lock; non-primaries become SECONDARIES. Primary writes new findings;
+ * secondaries replay + watch.
+ *
+ * Leader election: simple file-based lock with timeout.
+ *   - .mneme/protoplasm/hydra.primary    (PID + timestamp of current primary)
+ *   - lock acquired by atomic write-if-not-exists
+ *   - primary refreshes timestamp every 5s
+ *   - if primary stale (>15s) → any secondary can take over
+ *
+ * No Raft / Paxos — file-based is enough for liveness; HMAC chain on
+ * findings remains the trust layer regardless of which head wrote what.
+ */
+import { writeFileSync, readFileSync, existsSync, mkdirSync, unlinkSync } from "node:fs";
+import { join, dirname } from "node:path";
+const STALE_MS = 15_000;
+const REFRESH_MS = 5_000;
+function lockPath(ledgerDir) {
+    return join(ledgerDir, "hydra.primary");
+}
+function readLock(p) {
+    if (!existsSync(p))
+        return null;
+    try {
+        const j = JSON.parse(readFileSync(p, "utf8"));
+        if (typeof j.pid === "number" && typeof j.ts === "number")
+            return j;
+    }
+    catch { /* */ }
+    return null;
+}
+function writeLock(p, pid) {
+    mkdirSync(dirname(p), { recursive: true });
+    // Best-effort atomic-ish: write to tmp, rename
+    const tmp = p + ".tmp." + pid;
+    writeFileSync(tmp, JSON.stringify({ pid, ts: Date.now() }), "utf8");
+    try {
+        require("node:fs").renameSync(tmp, p);
+    }
+    catch {
+        try {
+            writeFileSync(p, JSON.stringify({ pid, ts: Date.now() }));
+        }
+        catch { /* */ }
+    }
+}
+function alivePid(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function statusHydra(ledgerDir, ownPid = process.pid) {
+    const p = lockPath(ledgerDir);
+    const lock = readLock(p);
+    if (!lock)
+        return { role: "uncontested", primaryPid: null, primaryAge: 0, ownPid, lockPath: p };
+    const age = Date.now() - lock.ts;
+    if (lock.pid === ownPid)
+        return { role: "primary", primaryPid: ownPid, primaryAge: age, ownPid, lockPath: p };
+    if (age > STALE_MS || !alivePid(lock.pid))
+        return { role: "uncontested", primaryPid: lock.pid, primaryAge: age, ownPid, lockPath: p };
+    return { role: "secondary", primaryPid: lock.pid, primaryAge: age, ownPid, lockPath: p };
+}
+/** Attempt to become primary. Idempotent if already primary.
+ *  Returns final role + reason. */
+export function tryBecomePrimary(ledgerDir, ownPid = process.pid) {
+    const p = lockPath(ledgerDir);
+    const before = statusHydra(ledgerDir, ownPid);
+    if (before.role === "primary")
+        return before;
+    if (before.role === "secondary")
+        return before; // someone else holds it freshly
+    // uncontested — claim it
+    writeLock(p, ownPid);
+    return { role: "primary", primaryPid: ownPid, primaryAge: 0, ownPid, lockPath: p, acquiredAt: new Date().toISOString() };
+}
+/** Refresh primary timestamp (call every REFRESH_MS while primary).
+ *  Returns true if still primary; false if got displaced. */
+export function refreshPrimary(ledgerDir, ownPid = process.pid) {
+    const p = lockPath(ledgerDir);
+    const lock = readLock(p);
+    if (!lock || lock.pid !== ownPid)
+        return false;
+    writeLock(p, ownPid);
+    return true;
+}
+/** Release primary (graceful step-down). */
+export function releasePrimary(ledgerDir, ownPid = process.pid) {
+    const p = lockPath(ledgerDir);
+    const lock = readLock(p);
+    if (!lock || lock.pid !== ownPid)
+        return false;
+    try {
+        unlinkSync(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Wire as background refresher. Returns cancel fn. */
+export function startHydraHeartbeat(ledgerDir, ownPid = process.pid) {
+    const interval = setInterval(() => {
+        const ok = refreshPrimary(ledgerDir, ownPid);
+        if (!ok) {
+            // We were displaced. Try to reacquire next tick.
+            tryBecomePrimary(ledgerDir, ownPid);
+        }
+    }, REFRESH_MS);
+    if (typeof interval.unref === "function")
+        interval.unref();
+    return () => clearInterval(interval);
+}
+export const HYDRA_TUNING = { STALE_MS, REFRESH_MS };
+//# sourceMappingURL=hydra_quorum.js.map

package/dist/protoplasm/hydra_quorum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydra_quorum.js","sourceRoot":"","sources":["../../src/protoplasm/hydra_quorum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAY,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAa1C,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,SAAS,QAAQ,CAAC,SAAiB;IACjC,OAAO,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAgC,CAAC;QAC7E,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,CAAS,EAAE,GAAW;IACvC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,+CAA+C;IAC/C,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC;IAC9B,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,CAAC;QAAE,OAAO,CAAC,SAAS,CAA8B,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAClF,IAAI,CAAC;YAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACjE,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAChG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC9G,IAAI,GAAG,GAAG,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACtI,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED;mCACmC;AACnC,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACtE,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC,CAAK,gCAAgC;IACpF,yBAAyB;IACzB,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAC3H,CAAC;AAED;6DAC6D;AAC7D,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACpE,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/C,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACpE,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,CAAC;QAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC7D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACzE,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,iDAAiD;YACjD,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,UAAU,CAAC,CAAC;IACf,IAAI,OAAQ,QAAgB,CAAC,KAAK,KAAK,UAAU;QAAG,QAAgB,CAAC,KAAK,EAAE,CAAC;IAC7E,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * 🩸 PROTOPLASM — IMMORTAL ATOM tests
+ *
+ * Pin 5 invariants that make PROTOPLASM survive process death:
+ *   I-IMMORTAL-1: WAL persists baseline BEFORE RAM update
+ *   I-IMMORTAL-2: replay reconstructs baselines from WAL
+ *   I-IMMORTAL-3: tampered WAL row → verify detects
+ *   I-IMMORTAL-4: seamlessBoot is idempotent (safe to call N times)
+ *   I-IMMORTAL-5: parasiteTick writes heartbeat
+ */
+export {};
+//# sourceMappingURL=immortal.test.d.ts.map

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

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