@mneme-ai/core 2.67.0 → 2.69.0

package/dist/protoplasm/usb_soul.js

@@ -0,0 +1,162 @@
+/**
+ * 🧬 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).
+ */
+import { existsSync, copyFileSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { createHmac } from "node:crypto";
+const REQUIRED_FILES = ["wal.jsonl", "findings.jsonl", ".key"];
+function detectMounts() {
+    const out = [];
+    const plat = process.platform;
+    try {
+        if (plat === "win32") {
+            // Use wmic to enumerate removable drives
+            const stdout = execSync("wmic logicaldisk where DriveType=2 get Caption /value", { encoding: "utf8", timeout: 3000 });
+            for (const m of stdout.matchAll(/Caption=([A-Z]:)/g))
+                out.push(m[1] + "\\");
+        }
+        else if (plat === "darwin") {
+            if (existsSync("/Volumes"))
+                for (const v of readdirSync("/Volumes")) {
+                    if (v !== "Macintosh HD")
+                        out.push("/Volumes/" + v);
+                }
+        }
+        else {
+            for (const root of ["/media", "/mnt", "/run/media"]) {
+                if (!existsSync(root))
+                    continue;
+                for (const u of readdirSync(root)) {
+                    const p = join(root, u);
+                    try {
+                        if (statSync(p).isDirectory())
+                            out.push(p);
+                    }
+                    catch { /* */ }
+                }
+            }
+        }
+    }
+    catch { /* */ }
+    return out;
+}
+export function pickMount() {
+    const env = process.env.MNEME_USB_SOUL_PATH;
+    if (env && existsSync(env))
+        return env;
+    try {
+        if (existsSync(".mneme/usb_mount")) {
+            const p = readFileSync(".mneme/usb_mount", "utf8").trim();
+            if (existsSync(p))
+                return p;
+        }
+    }
+    catch { /* */ }
+    const detected = detectMounts();
+    return detected[0] ?? null;
+}
+export function verifyMount(mount) {
+    if (!existsSync(mount))
+        return { ok: false, writable: false, hasLayout: false };
+    let writable = false;
+    try {
+        const test = join(mount, ".mneme-soul-write-test");
+        writeFileSync(test, String(Date.now()));
+        writable = true;
+        try {
+            require("node:fs").unlinkSync(test);
+        }
+        catch { /* */ }
+    }
+    catch {
+        writable = false;
+    }
+    const hasLayout = existsSync(join(mount, "mneme-soul"));
+    return { ok: writable, writable, hasLayout };
+}
+function obfuscateKey(plain, passphrase) {
+    return createHmac("sha256", passphrase).update(plain).digest("hex");
+}
+export function syncTo(mount, ledgerDir, encryptPassphrase) {
+    if (!existsSync(mount))
+        return { ok: false, mount, reason: "mount does not exist" };
+    const dst = join(mount, "mneme-soul");
+    try {
+        mkdirSync(dst, { recursive: true });
+        const copied = [];
+        let bytes = 0;
+        for (const f of REQUIRED_FILES) {
+            const src = join(ledgerDir, f);
+            if (!existsSync(src))
+                continue;
+            const dstFile = join(dst, f);
+            if (f === ".key" && encryptPassphrase) {
+                const raw = readFileSync(src, "utf8");
+                writeFileSync(dstFile + ".enc", obfuscateKey(raw, encryptPassphrase));
+                copied.push(f + ".enc");
+                bytes += dstFile.length;
+            }
+            else {
+                copyFileSync(src, dstFile);
+                copied.push(f);
+                bytes += statSync(src).size;
+            }
+        }
+        // marker for future syncFrom detection
+        writeFileSync(join(dst, "soul.manifest.json"), JSON.stringify({
+            syncedAt: new Date().toISOString(),
+            sourcePid: process.pid,
+            hostHint: process.env.COMPUTERNAME ?? process.env.HOSTNAME ?? "unknown",
+            files: copied,
+            encrypted: Boolean(encryptPassphrase),
+        }, null, 2));
+        return { ok: true, mount, copied, bytesWritten: bytes };
+    }
+    catch (e) {
+        return { ok: false, mount, reason: e.message };
+    }
+}
+export function syncFrom(mount, ledgerDir) {
+    const src = join(mount, "mneme-soul");
+    if (!existsSync(src))
+        return { ok: false, mount, reason: "no mneme-soul/ folder on mount" };
+    try {
+        mkdirSync(ledgerDir, { recursive: true });
+        const copied = [];
+        let bytes = 0;
+        for (const entry of readdirSync(src)) {
+            if (entry === "soul.manifest.json")
+                continue;
+            const srcFile = join(src, entry);
+            const dstFile = join(ledgerDir, entry.replace(/\.enc$/, ""));
+            try {
+                copyFileSync(srcFile, dstFile);
+                copied.push(entry);
+                bytes += statSync(srcFile).size;
+            }
+            catch { /* */ }
+        }
+        return { ok: true, mount, copied, bytesWritten: bytes };
+    }
+    catch (e) {
+        return { ok: false, mount, reason: e.message };
+    }
+}
+//# sourceMappingURL=usb_soul.js.map

package/dist/protoplasm/usb_soul.js.map

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

package/package.json

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