@mneme-ai/core 2.66.0 → 2.68.0

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

package/dist/protoplasm/super_quan_probe.js

@@ -0,0 +1,132 @@
+/**
+ * 🦠 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 { buildBaseline, runQuantumProbe } from "./quantum_probe.js";
+import { appendFinding } from "./findings_ledger.js";
+/** Cheap structural fingerprint — count + top-level type pattern, no values. */
+function argShape(args) {
+    return Array.from(args, (a) => {
+        if (a === null)
+            return "null";
+        if (a === undefined)
+            return "undef";
+        if (Array.isArray(a))
+            return `arr[${a.length}]`;
+        const t = typeof a;
+        if (t === "object")
+            return `obj{${Object.keys(a).length}}`;
+        return t;
+    }).join(",");
+}
+function outputShape(value) {
+    if (value === null)
+        return "null";
+    if (value === undefined)
+        return "undef";
+    if (Array.isArray(value))
+        return `arr[${value.length}]`;
+    if (typeof value === "object")
+        return `obj{${Object.keys(value).length}}`;
+    return typeof value;
+}
+const REGISTRY = new Map();
+const PROBE_LISTENERS = [];
+export function onFinding(listener) {
+    PROBE_LISTENERS.push(listener);
+    return () => { const i = PROBE_LISTENERS.indexOf(listener); if (i >= 0)
+        PROBE_LISTENERS.splice(i, 1); };
+}
+function ensureState(fnId) {
+    let s = REGISTRY.get(fnId);
+    if (!s) {
+        s = { buffer: [], baseline: null, callsSinceLastProbe: 0, bufferLimit: 200, probeEveryNCalls: 25 };
+        REGISTRY.set(fnId, s);
+    }
+    return s;
+}
+function record(state, snapshot, cfg) {
+    state.buffer.push(snapshot);
+    if (state.buffer.length > state.bufferLimit)
+        state.buffer.shift();
+    state.callsSinceLastProbe++;
+    // Rebuild baseline when enough samples; refresh slowly.
+    if (state.baseline === null && state.buffer.length >= 5)
+        state.baseline = buildBaseline(snapshot.fnId, state.buffer);
+    else if (state.baseline !== null && state.buffer.length % 50 === 0)
+        state.baseline = buildBaseline(snapshot.fnId, state.buffer);
+    if (state.callsSinceLastProbe >= state.probeEveryNCalls && state.baseline && cfg) {
+        state.callsSinceLastProbe = 0;
+        const recentWindow = state.buffer.slice(-state.probeEveryNCalls);
+        const partial = runQuantumProbe(snapshot.fnId, recentWindow, state.baseline, cfg);
+        try {
+            const finding = appendFinding(cfg.ledgerDir + "/findings.jsonl", partial, cfg.hmacKey);
+            PROBE_LISTENERS.forEach((l) => { try {
+                l(finding);
+            }
+            catch { /* ignore */ } });
+        }
+        catch { /* ledger optional — never block hot path */ }
+    }
+}
+export function withSuperQuanProbe(fnId, fn, cfg) {
+    const state = ensureState(fnId);
+    const wrapped = function (...args) {
+        const t0 = performance.now();
+        let result;
+        let threwClass;
+        try {
+            result = fn.apply(this, args);
+        }
+        catch (e) {
+            threwClass = e?.constructor?.name ?? "Error";
+            record(state, {
+                fnId, ts: new Date().toISOString(), durationMs: performance.now() - t0,
+                args: { count: args.length, shape: argShape(args) },
+                output: { kind: "throw", errorClass: threwClass },
+            }, cfg);
+            throw e;
+        }
+        // async case
+        if (result && typeof result.then === "function") {
+            return result.then((v) => {
+                record(state, {
+                    fnId, ts: new Date().toISOString(), durationMs: performance.now() - t0,
+                    args: { count: args.length, shape: argShape(args) },
+                    output: { kind: "ok", shape: outputShape(v) },
+                }, cfg);
+                return v;
+            }, (e) => {
+                record(state, {
+                    fnId, ts: new Date().toISOString(), durationMs: performance.now() - t0,
+                    args: { count: args.length, shape: argShape(args) },
+                    output: { kind: "throw", errorClass: e?.constructor?.name ?? "Error" },
+                }, cfg);
+                throw e;
+            });
+        }
+        // sync case
+        record(state, {
+            fnId, ts: new Date().toISOString(), durationMs: performance.now() - t0,
+            args: { count: args.length, shape: argShape(args) },
+            output: { kind: "ok", shape: outputShape(result) },
+        }, cfg);
+        return result;
+    };
+    return wrapped;
+}
+/** Snapshot of the registry — for orchestrator / wisdom_space inspection. */
+export function snapshotRegistry() {
+    return [...REGISTRY.entries()].map(([fnId, s]) => ({ fnId, samples: s.buffer.length, recent: s.buffer.slice(-25) }));
+}
+export function clearRegistry() { REGISTRY.clear(); }
+//# sourceMappingURL=super_quan_probe.js.map

package/dist/protoplasm/super_quan_probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"super_quan_probe.js","sourceRoot":"","sources":["../../src/protoplasm/super_quan_probe.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/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 🦠 PROTOPLASM — types
+ *
+ * Live atom embedded in every function. Reports super_quan findings to
+ * orchestrator. Orchestrator decides: HEALTHY → crawl-and-learn,
+ * BROKEN → wisdom-space root-cause + heal.
+ */
+export type ProbeOutcome = "healthy" | "warn" | "broken";
+/** A single recorded invocation snapshot. */
+export interface InvocationSnapshot {
+    fnId: string;
+    ts: string;
+    durationMs: number;
+    args: {
+        count: number;
+        shape: string;
+    };
+    output: {
+        kind: "ok" | "throw";
+        shape?: string;
+        errorClass?: string;
+    };
+}
+/** Statistical baseline for a single function (rolling). */
+export interface FunctionBaseline {
+    fnId: string;
+    samples: number;
+    durationMean: number;
+    durationStdev: number;
+    errorRate: number;
+    argShapeEntropy: number;
+    outputShapeEntropy: number;
+    lastUpdate: string;
+}
+/** Result of a single super_quan probe run. */
+export interface SuperQuanFinding {
+    fnId: string;
+    at: string;
+    outcome: ProbeOutcome;
+    zScores: Record<string, number>;
+    quantumSignals: QuantumSignals;
+    rootCauseHints: string[];
+    evidence: string;
+    hmac: string;
+    prev: string;
+}
+/** Quantum-inspired signals (analogues, not literal QM). */
+export interface QuantumSignals {
+    /** Shannon entropy of output distribution. Low = collapse to single state. High = decoherence. */
+    outputEntropy: number;
+    /** Chaos-input divergence — how much the function's output varies given structured perturbation. */
+    chaosDivergence: number;
+    /** Cross-function correlation — does this function's broken state coincide w/ neighbors? */
+    neighborCorrelation: number;
+    /** Superposition collapse score — proportion of calls that produce typed output vs throw. */
+    collapseStability: number;
+}
+export interface WisdomRootCause {
+    fnId: string;
+    hypothesis: string;
+    upstreamSuspects: string[];
+    confidence: number;
+    proposedHeal: HealAction[];
+}
+export interface HealAction {
+    kind: "retry-with-backoff" | "fallback-to-cached" | "request-supernova-restart" | "raise-truth-gate-block" | "noop";
+    rationale: string;
+}
+export interface CrawlPlan {
+    trigger: "healthy-burst" | "scheduled" | "manual";
+    fnId: string;
+    searchTopics: string[];
+    budgetMs: number;
+    estimatedROI: number;
+}
+export interface ProtoplasmConfig {
+    baselineSamplesMin: number;
+    zScoreWarn: number;
+    zScoreBroken: number;
+    ledgerDir: string;
+    hmacKey: string;
+    crawlOnHealthyEvery: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protoplasm/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,MAAM,EAAE;QAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,oGAAoG;IACpG,eAAe,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,2BAA2B,GAAG,wBAAwB,GAAG,MAAM,CAAC;IACpH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,eAAe,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;CAC7B"}

package/dist/protoplasm/types.js

@@ -0,0 +1,9 @@
+/**
+ * 🦠 PROTOPLASM — types
+ *
+ * Live atom embedded in every function. Reports super_quan findings to
+ * orchestrator. Orchestrator decides: HEALTHY → crawl-and-learn,
+ * BROKEN → wisdom-space root-cause + heal.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/protoplasm/types.js.map

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

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