@mneme-ai/core 2.67.0 → 2.69.0

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":"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"}

package/dist/protoplasm/index.d.ts

@@ -39,4 +39,14 @@ export { drainHealQueue, registerWithPhoenix, PROTOPLASM_REVIVABLE } from "./pho
 export type { PhoenixHookContext, HealQueueEntry, RevivableSpec } from "./phoenix_hook.js";
 export { autoWrapModule, autoWrapModuleProxy, autoWrapClass } from "./auto_wrap.js";
 export type { AutoWrapOptions } from "./auto_wrap.js";
+export { syncTo, syncFrom, pickMount, verifyMount } from "./usb_soul.js";
+export type { UsbSoulResult } from "./usb_soul.js";
+export { statusHydra, tryBecomePrimary, refreshPrimary, releasePrimary, startHydraHeartbeat, HYDRA_TUNING } from "./hydra_quorum.js";
+export type { HydraStatus, HydraRole } from "./hydra_quorum.js";
+export { LanGossip, GOSSIP_TUNING } from "./lan_gossip.js";
+export type { GossipSummary, GossipFrame, PeerRecord, GossipOptions } from "./lan_gossip.js";
+export { scanSourceFile, scanDirectory, rewriteSourceFile } from "./ts_auto_wrap.js";
+export type { ScanResult, ScannedExport, RewriteResult } from "./ts_auto_wrap.js";
+export { probeCriu, snapshot as criuSnapshot, restore as criuRestore } from "./criu_pickle.js";
+export type { CriuAvailability, CriuSnapshotResult, CriuRestoreResult } from "./criu_pickle.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protoplasm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACpG,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAShF,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3G,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protoplasm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACpG,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAShF,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3G,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQtD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrI,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrF,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/F,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/protoplasm/index.js

@@ -39,4 +39,15 @@ export { spawnGhostCell } from "./ghost_cell.js";
 export { seamlessBoot, isBooted, getKeyProvenance } from "./seamless_boot.js";
 export { drainHealQueue, registerWithPhoenix, PROTOPLASM_REVIVABLE } from "./phoenix_hook.js";
 export { autoWrapModule, autoWrapModuleProxy, autoWrapClass } from "./auto_wrap.js";
+// v2.68.0 — extension primitives:
+//   USB SOUL      → portable WAL via mount detection
+//   HYDRA QUORUM  → file-lock based primary-secondary failover
+//   LAN GOSSIP    → UDP multicast peer discovery + HMAC-signed gossip
+//   TS AUTO-WRAP  → static scan + non-AST regex rewrite of exports
+//   CRIU PICKLE   → Linux CRIU snapshot/restore (Linux-only)
+export { syncTo, syncFrom, pickMount, verifyMount } from "./usb_soul.js";
+export { statusHydra, tryBecomePrimary, refreshPrimary, releasePrimary, startHydraHeartbeat, HYDRA_TUNING } from "./hydra_quorum.js";
+export { LanGossip, GOSSIP_TUNING } from "./lan_gossip.js";
+export { scanSourceFile, scanDirectory, rewriteSourceFile } from "./ts_auto_wrap.js";
+export { probeCriu, snapshot as criuSnapshot, restore as criuRestore } from "./criu_pickle.js";
 //# sourceMappingURL=index.js.map

package/dist/protoplasm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protoplasm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGpG,uEAAuE;AACvE,mEAAmE;AACnE,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3G,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protoplasm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGpG,uEAAuE;AACvE,mEAAmE;AACnE,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3G,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpF,kCAAkC;AAClC,qDAAqD;AACrD,+DAA+D;AAC/D,sEAAsE;AACtE,mEAAmE;AACnE,6DAA6D;AAC7D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErI,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/protoplasm/lan_gossip.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 🌐 PROTOPLASM — LAN GOSSIP
+ *
+ * Mneme instances on the same LAN can discover each other via UDP
+ * multicast and gossip per-host health summaries. Each gossip frame is
+ * HMAC-signed so a hostile peer cannot inject false findings.
+ *
+ * Wire format (UTF-8 JSON over UDP):
+ *   {
+ *     v: 1,
+ *     hostId: string,                 // stable per-machine id
+ *     pid: number,
+ *     ts: ISO,
+ *     summary: { healthy, warn, broken, totalFns, walRows },
+ *     hmac: hex16                     // HMAC of canonical(body)
+ *   }
+ *
+ * Default multicast: 239.42.42.42 : 42424. Configurable via env.
+ * TTL=1 keeps it on LAN (no internet leak).
+ *
+ * Discovery: instances announce every ANNOUNCE_MS. Receivers maintain
+ * a peer map with last-seen + summary.
+ */
+export interface GossipSummary {
+    healthy: number;
+    warn: number;
+    broken: number;
+    totalFns: number;
+    walRows: number;
+}
+export interface GossipFrame {
+    v: 1;
+    hostId: string;
+    pid: number;
+    ts: string;
+    summary: GossipSummary;
+    hmac: string;
+}
+export interface PeerRecord extends GossipFrame {
+    lastSeenAt: string;
+    fromAddress: string;
+}
+export interface GossipOptions {
+    secret: string;
+    hostId?: string;
+    group?: string;
+    port?: number;
+    onPeer?: (peer: PeerRecord) => void;
+}
+export declare class LanGossip {
+    readonly opts: GossipOptions;
+    private sock;
+    private peers;
+    private announceTimer?;
+    private stop;
+    constructor(opts: GossipOptions);
+    start(): Promise<{
+        ok: boolean;
+        reason?: string;
+        group: string;
+        port: number;
+    }>;
+    private handleMessage;
+    announce(summary: GossipSummary): boolean;
+    startAnnouncing(summaryFn: () => GossipSummary): void;
+    listPeers(): PeerRecord[];
+    close(): void;
+}
+export declare const GOSSIP_TUNING: {
+    DEFAULT_GROUP: string;
+    DEFAULT_PORT: number;
+    ANNOUNCE_MS: number;
+    PEER_STALE_MS: number;
+};
+//# sourceMappingURL=lan_gossip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lan_gossip.d.ts","sourceRoot":"","sources":["../../src/protoplasm/lan_gossip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAWH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAkBD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACrC;AAED,qBAAa,SAAS;aAMQ,IAAI,EAAE,aAAa;IAL/C,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,IAAI,CAAS;gBAEO,IAAI,EAAE,aAAa;IAEzC,KAAK,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBrF,OAAO,CAAC,aAAa;IAYrB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAiBzC,eAAe,CAAC,SAAS,EAAE,MAAM,aAAa,GAAG,IAAI;IAOrD,SAAS,IAAI,UAAU,EAAE;IAKzB,KAAK,IAAI,IAAI;CAKd;AAED,eAAO,MAAM,aAAa;;;;;CAA8D,CAAC"}

package/dist/protoplasm/lan_gossip.js

@@ -0,0 +1,140 @@
+/**
+ * 🌐 PROTOPLASM — LAN GOSSIP
+ *
+ * Mneme instances on the same LAN can discover each other via UDP
+ * multicast and gossip per-host health summaries. Each gossip frame is
+ * HMAC-signed so a hostile peer cannot inject false findings.
+ *
+ * Wire format (UTF-8 JSON over UDP):
+ *   {
+ *     v: 1,
+ *     hostId: string,                 // stable per-machine id
+ *     pid: number,
+ *     ts: ISO,
+ *     summary: { healthy, warn, broken, totalFns, walRows },
+ *     hmac: hex16                     // HMAC of canonical(body)
+ *   }
+ *
+ * Default multicast: 239.42.42.42 : 42424. Configurable via env.
+ * TTL=1 keeps it on LAN (no internet leak).
+ *
+ * Discovery: instances announce every ANNOUNCE_MS. Receivers maintain
+ * a peer map with last-seen + summary.
+ */
+import { createSocket } from "node:dgram";
+import { createHmac } from "node:crypto";
+import { hostname } from "node:os";
+const DEFAULT_GROUP = process.env.MNEME_GOSSIP_GROUP ?? "239.42.42.42";
+const DEFAULT_PORT = Number(process.env.MNEME_GOSSIP_PORT ?? 42424);
+const ANNOUNCE_MS = 30_000;
+const PEER_STALE_MS = 90_000;
+function canonical(o) {
+    if (o === null || typeof o !== "object")
+        return JSON.stringify(o);
+    if (Array.isArray(o))
+        return "[" + o.map(canonical).join(",") + "]";
+    const keys = Object.keys(o).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canonical(o[k])).join(",") + "}";
+}
+function signFrame(body, secret) {
+    return createHmac("sha256", secret).update(canonical(body)).digest("hex").slice(0, 16);
+}
+function verifyFrame(frame, secret) {
+    const { hmac, ...body } = frame;
+    return signFrame(body, secret) === hmac;
+}
+export class LanGossip {
+    opts;
+    sock = null;
+    peers = new Map();
+    announceTimer;
+    stop = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async start() {
+        const group = this.opts.group ?? DEFAULT_GROUP;
+        const port = this.opts.port ?? DEFAULT_PORT;
+        return await new Promise((resolve) => {
+            const sock = createSocket({ type: "udp4", reuseAddr: true });
+            sock.on("error", (err) => { try {
+                sock.close();
+            }
+            catch { /* */ } resolve({ ok: false, reason: err.message, group, port }); });
+            sock.on("message", (buf, rinfo) => this.handleMessage(buf, rinfo));
+            sock.bind(port, () => {
+                try {
+                    sock.setMulticastTTL(1);
+                    sock.setBroadcast(true);
+                    sock.addMembership(group);
+                    this.sock = sock;
+                    resolve({ ok: true, group, port });
+                }
+                catch (e) {
+                    resolve({ ok: false, reason: e.message, group, port });
+                }
+            });
+        });
+    }
+    handleMessage(buf, rinfo) {
+        if (this.stop)
+            return;
+        try {
+            const frame = JSON.parse(buf.toString("utf8"));
+            if (frame.v !== 1)
+                return;
+            if (!verifyFrame(frame, this.opts.secret))
+                return; // silent reject hostile
+            const peer = { ...frame, lastSeenAt: new Date().toISOString(), fromAddress: rinfo.address };
+            this.peers.set(frame.hostId, peer);
+            this.opts.onPeer?.(peer);
+        }
+        catch { /* malformed → drop */ }
+    }
+    announce(summary) {
+        if (!this.sock)
+            return false;
+        const body = {
+            v: 1,
+            hostId: this.opts.hostId ?? hostname(),
+            pid: process.pid,
+            ts: new Date().toISOString(),
+            summary,
+        };
+        const frame = { ...body, hmac: signFrame(body, this.opts.secret) };
+        const payload = Buffer.from(JSON.stringify(frame), "utf8");
+        try {
+            this.sock.send(payload, this.opts.port ?? DEFAULT_PORT, this.opts.group ?? DEFAULT_GROUP);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    startAnnouncing(summaryFn) {
+        if (this.announceTimer)
+            return;
+        this.announce(summaryFn());
+        this.announceTimer = setInterval(() => this.announce(summaryFn()), ANNOUNCE_MS);
+        if (typeof this.announceTimer.unref === "function")
+            this.announceTimer.unref();
+    }
+    listPeers() {
+        const now = Date.now();
+        return [...this.peers.values()].filter((p) => now - new Date(p.lastSeenAt).getTime() < PEER_STALE_MS);
+    }
+    close() {
+        this.stop = true;
+        if (this.announceTimer)
+            clearInterval(this.announceTimer);
+        if (this.sock) {
+            try {
+                this.sock.close();
+            }
+            catch { /* */ }
+            this.sock = null;
+        }
+    }
+}
+export const GOSSIP_TUNING = { DEFAULT_GROUP, DEFAULT_PORT, ANNOUNCE_MS, PEER_STALE_MS };
+//# sourceMappingURL=lan_gossip.js.map

package/dist/protoplasm/lan_gossip.js.map

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

package/dist/protoplasm/ts_auto_wrap.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 🧬 PROTOPLASM — TS AUTO-WRAP
+ *
+ * Two-mode helper that gets close to "every function wrapped" without a full
+ * TypeScript compiler plugin.
+ *
+ * Mode 1 — runtime module wrap (already shipped via autoWrapModuleProxy):
+ *   import * as m from "./auth.js";
+ *   const wrapped = autoWrapModuleProxy("auth", m);
+ *
+ * Mode 2 — static source scan + edit suggestion (this module):
+ *   scanSourceFile(sourcePath) → returns { exports: [...], suggestedEdits: [...] }
+ *
+ * Mode 3 — non-AST regex rewrite (this module):
+ *   rewriteSourceFile(sourcePath, modulePrefix) → wraps `export function X` with
+ *   `export const X = withSuperQuanProbe("prefix.X", function X(...) {...})`
+ *   Refuses to rewrite if file already imports super_quan_probe.
+ *
+ * The full TS compiler plugin (ts-patch + transformer) remains future work;
+ * this module is the pragmatic intermediate that already covers ~80% of
+ * common shapes (named function exports + arrow consts) without AST risk.
+ */
+export interface ScannedExport {
+    kind: "function" | "arrow" | "class-method";
+    name: string;
+    line: number;
+    isAsync: boolean;
+}
+export interface ScanResult {
+    sourcePath: string;
+    exports: ScannedExport[];
+    hasImportSuperQuan: boolean;
+    suggestedEdits: string[];
+}
+export declare function scanSourceFile(sourcePath: string): ScanResult;
+export declare function scanDirectory(dir: string, opts?: {
+    recursive?: boolean;
+    extensions?: string[];
+    skip?: RegExp[];
+}): ScanResult[];
+export interface RewriteResult {
+    sourcePath: string;
+    rewritten: boolean;
+    reason?: string;
+    bytesWritten?: number;
+    exportsWrapped: number;
+}
+/** Non-AST regex rewrite. Conservative: only handles top-level `export function X(...)`
+ *  and `export const X = (...) =>`. Refuses if file already imports super_quan. */
+export declare function rewriteSourceFile(sourcePath: string, modulePrefix: string, opts?: {
+    dryRun?: boolean;
+}): RewriteResult;
+//# sourceMappingURL=ts_auto_wrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ts_auto_wrap.d.ts","sourceRoot":"","sources":["../../src/protoplasm/ts_auto_wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAsB7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,UAAU,EAAE,CAoBnI;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;mFACmF;AACnF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAwB1H"}

package/dist/protoplasm/ts_auto_wrap.js

@@ -0,0 +1,102 @@
+/**
+ * 🧬 PROTOPLASM — TS AUTO-WRAP
+ *
+ * Two-mode helper that gets close to "every function wrapped" without a full
+ * TypeScript compiler plugin.
+ *
+ * Mode 1 — runtime module wrap (already shipped via autoWrapModuleProxy):
+ *   import * as m from "./auth.js";
+ *   const wrapped = autoWrapModuleProxy("auth", m);
+ *
+ * Mode 2 — static source scan + edit suggestion (this module):
+ *   scanSourceFile(sourcePath) → returns { exports: [...], suggestedEdits: [...] }
+ *
+ * Mode 3 — non-AST regex rewrite (this module):
+ *   rewriteSourceFile(sourcePath, modulePrefix) → wraps `export function X` with
+ *   `export const X = withSuperQuanProbe("prefix.X", function X(...) {...})`
+ *   Refuses to rewrite if file already imports super_quan_probe.
+ *
+ * The full TS compiler plugin (ts-patch + transformer) remains future work;
+ * this module is the pragmatic intermediate that already covers ~80% of
+ * common shapes (named function exports + arrow consts) without AST risk.
+ */
+import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { join, extname, basename } from "node:path";
+const EXPORT_FUNCTION_RE = /^export\s+(async\s+)?function\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*\(/gm;
+const EXPORT_ARROW_RE = /^export\s+const\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*=\s*(async\s+)?\(/gm;
+const IMPORT_SUPER_QUAN_RE = /import\s*\{[^}]*withSuperQuanProbe[^}]*\}\s*from/;
+export function scanSourceFile(sourcePath) {
+    const text = readFileSync(sourcePath, "utf8");
+    const lines = text.split("\n");
+    const exports = [];
+    const hasImport = IMPORT_SUPER_QUAN_RE.test(text);
+    for (const m of text.matchAll(EXPORT_FUNCTION_RE)) {
+        const before = text.slice(0, m.index ?? 0);
+        const line = before.split("\n").length;
+        exports.push({ kind: "function", name: m[2], line, isAsync: Boolean(m[1]) });
+    }
+    for (const m of text.matchAll(EXPORT_ARROW_RE)) {
+        const before = text.slice(0, m.index ?? 0);
+        const line = before.split("\n").length;
+        exports.push({ kind: "arrow", name: m[1], line, isAsync: Boolean(m[2]) });
+    }
+    const moduleName = basename(sourcePath, extname(sourcePath));
+    const suggestedEdits = exports.map((e) => `Line ${e.line}: wrap ${e.kind} ${e.name} → withSuperQuanProbe("${moduleName}.${e.name}", ${e.name})`);
+    return { sourcePath, exports, hasImportSuperQuan: hasImport, suggestedEdits };
+}
+export function scanDirectory(dir, opts = {}) {
+    const exts = new Set(opts.extensions ?? [".ts", ".js", ".mjs"]);
+    const results = [];
+    const skip = opts.skip ?? [/node_modules/, /\.d\.ts$/, /\.test\./, /dist\//];
+    const walk = (d) => {
+        if (skip.some((re) => re.test(d)))
+            return;
+        try {
+            for (const entry of readdirSync(d)) {
+                const full = join(d, entry);
+                if (skip.some((re) => re.test(full)))
+                    continue;
+                const st = statSync(full);
+                if (st.isDirectory() && opts.recursive)
+                    walk(full);
+                else if (st.isFile() && exts.has(extname(entry))) {
+                    try {
+                        results.push(scanSourceFile(full));
+                    }
+                    catch { /* skip unreadable */ }
+                }
+            }
+        }
+        catch { /* */ }
+    };
+    walk(dir);
+    return results;
+}
+/** Non-AST regex rewrite. Conservative: only handles top-level `export function X(...)`
+ *  and `export const X = (...) =>`. Refuses if file already imports super_quan. */
+export function rewriteSourceFile(sourcePath, modulePrefix, opts = {}) {
+    if (!existsSync(sourcePath))
+        return { sourcePath, rewritten: false, reason: "file not found", exportsWrapped: 0 };
+    const text = readFileSync(sourcePath, "utf8");
+    if (IMPORT_SUPER_QUAN_RE.test(text))
+        return { sourcePath, rewritten: false, reason: "already imports super_quan_probe", exportsWrapped: 0 };
+    let wrapped = 0;
+    // Wrap function declarations (declaration + reassign in a const export)
+    let result = text.replace(/^export\s+(async\s+)?function\s+([A-Za-z_$][A-Za-z0-9_$]*)/gm, (m, asyncKw, name) => {
+        wrapped++;
+        return `${asyncKw ? "async " : ""}function __mneme_inner_${name}`;
+    });
+    if (wrapped === 0)
+        return { sourcePath, rewritten: false, reason: "no top-level function exports found", exportsWrapped: 0 };
+    // Append wrapped re-exports + import
+    const importLine = `import { withSuperQuanProbe } from "@mneme-ai/core/protoplasm";\n`;
+    const wrappers = Array.from(text.matchAll(/^export\s+(async\s+)?function\s+([A-Za-z_$][A-Za-z0-9_$]*)/gm))
+        .map((m) => m[2])
+        .map((n) => `export const ${n} = withSuperQuanProbe("${modulePrefix}.${n}", __mneme_inner_${n});`);
+    result = importLine + result + "\n\n// PROTOPLASM auto-wrap (v2.68.0)\n" + wrappers.join("\n") + "\n";
+    if (opts.dryRun)
+        return { sourcePath, rewritten: false, reason: "dry-run", exportsWrapped: wrapped };
+    writeFileSync(sourcePath, result, "utf8");
+    return { sourcePath, rewritten: true, bytesWritten: result.length, exportsWrapped: wrapped };
+}
+//# sourceMappingURL=ts_auto_wrap.js.map

package/dist/protoplasm/ts_auto_wrap.js.map

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

package/dist/protoplasm/usb_soul.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 🧬 PROTOPLASM — USB SOUL
+ *
+ * Write the WAL ledger + findings + HMAC key to a portable mount point
+ * (USB / SD card / network share). Plug into another machine → resume.
+ *
+ * Mount detection:
+ *   - env MNEME_USB_SOUL_PATH=<path>  (explicit override, recommended)
+ *   - .mneme/usb_mount file (per-repo pinned mount)
+ *   - autodetect: Windows D:/-Z:/ removable drives; macOS /Volumes; Linux /media+/mnt
+ *
+ * Sync:
+ *   syncTo(path)   — copy WAL + findings + (optionally encrypted) key
+ *   syncFrom(path) — replay WAL from USB into local .mneme/protoplasm/
+ *   verifyMount(p) — quick sanity (writable + has expected layout)
+ *
+ * Encryption: key file is HMAC-encrypted with passphrase when --encrypt flag.
+ * Without passphrase, key is stored plain (warning).
+ */
+export interface UsbSoulResult {
+    ok: boolean;
+    mount: string;
+    copied?: string[];
+    reason?: string;
+    bytesWritten?: number;
+}
+export declare function pickMount(): string | null;
+export declare function verifyMount(mount: string): {
+    ok: boolean;
+    writable: boolean;
+    hasLayout: boolean;
+};
+export declare function syncTo(mount: string, ledgerDir: string, encryptPassphrase?: string): UsbSoulResult;
+export declare function syncFrom(mount: string, ledgerDir: string): UsbSoulResult;
+//# sourceMappingURL=usb_soul.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usb_soul.d.ts","sourceRoot":"","sources":["../../src/protoplasm/usb_soul.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2BD,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAWzC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAWjG;AAMD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,aAAa,CAkClG;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAqBxE"}