mneme-ai 2.103.0 → 2.105.0

package/dist/commands/cortex.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `mneme cortex` (v2.104.0) — the Sovereign Memory Bus on the CLI:
+ * contribute / recall / handoff into the local shared, signed,
+ * drift-guarded memory every agent reads. Persists to
+ * .mneme/cortex/store.json. Total: never throws.
+ */
+import type { Command } from "commander";
+export declare function registerCortexCommands(program: Command): void;
+//# sourceMappingURL=cortex.d.ts.map

package/dist/commands/cortex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cortex.d.ts","sourceRoot":"","sources":["../../src/commands/cortex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C7D"}

package/dist/commands/cortex.js

@@ -0,0 +1,112 @@
+/**
+ * `mneme cortex` (v2.104.0) — the Sovereign Memory Bus on the CLI:
+ * contribute / recall / handoff into the local shared, signed,
+ * drift-guarded memory every agent reads. Persists to
+ * .mneme/cortex/store.json. Total: never throws.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+function writeJson(p) { process.stdout.write(JSON.stringify(p, null, 2) + "\n"); }
+function writeText(l) { process.stdout.write(l + "\n"); }
+async function core() {
+    try {
+        const c = (await import("@mneme-ai/core"));
+        if (c.cortex)
+            return c;
+    }
+    catch { /* */ }
+    return null;
+}
+function storePath(cwd) { return join(cwd, ".mneme", "cortex", "store.json"); }
+function readStore(cwd) {
+    try {
+        const p = storePath(cwd);
+        if (!existsSync(p))
+            return { v: 1, entries: [] };
+        const j = JSON.parse(readFileSync(p, "utf8"));
+        return j && Array.isArray(j.entries) ? j : { v: 1, entries: [] };
+    }
+    catch {
+        return { v: 1, entries: [] };
+    }
+}
+function saveStore(cwd, s) { try {
+    const d = join(cwd, ".mneme", "cortex");
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+    writeFileSync(storePath(cwd), JSON.stringify(s, null, 2));
+}
+catch { /* */ } }
+export function registerCortexCommands(program) {
+    const c = program
+        .command("cortex")
+        .description("🧠 COGNITIVE CORTEX — the local, signed, drift-guarded Sovereign Memory Bus every AI agent shares. contribute / recall / handoff. The gatekeeper quarantines conflicts so the shared memory can't be poisoned.");
+    c.command("contribute <key> <value>")
+        .description("Write a fact to the shared memory (signed). Quarantined if it conflicts with established memory unless --update.")
+        .option("--agent <id>", "your agent id", "cli")
+        .option("--kind <k>", "fact | decision | context | warning", "fact")
+        .option("--update", "declare a supersede of an existing conflicting value")
+        .option("--json", "JSON output.")
+        .action(async (key, value, opts) => {
+        const m = await core();
+        if (!m) {
+            writeText("✗ @mneme-ai/core unavailable.");
+            process.exitCode = 1;
+            return;
+        }
+        const cwd = process.cwd();
+        const out = m.cortex.contribute(cwd, readStore(cwd), { agent: opts.agent ?? "cli", key, value, kind: opts.kind }, Date.now(), { update: !!opts.update });
+        if (out.result.verdict !== "QUARANTINED" && out.result.entry)
+            saveStore(cwd, out.store);
+        if (opts.json) {
+            writeJson(out.result);
+            process.exitCode = out.result.verdict === "QUARANTINED" ? 1 : 0;
+            return;
+        }
+        const icon = out.result.verdict === "QUARANTINED" ? "⚠" : "✓";
+        writeText(`${icon} ${out.result.verdict} — ${out.result.reason}`);
+        process.exitCode = out.result.verdict === "QUARANTINED" ? 1 : 0;
+    });
+    c.command("recall <query>")
+        .description("Recall shared memory relevant to a query (signed facts every agent contributed).")
+        .option("--limit <n>", "max hits", (v) => parseInt(v, 10), 10)
+        .option("--json", "JSON output.")
+        .action(async (query, opts) => {
+        const m = await core();
+        if (!m) {
+            writeText("✗ @mneme-ai/core unavailable.");
+            process.exitCode = 1;
+            return;
+        }
+        const hits = m.cortex.recall(readStore(process.cwd()), query, opts.limit ?? 10);
+        if (opts.json) {
+            writeJson(hits.map((h) => ({ key: h.entry.key, value: h.entry.value, agent: h.entry.agent, score: h.score })));
+            return;
+        }
+        if (hits.length === 0) {
+            writeText("· no shared memory matches that query yet");
+            return;
+        }
+        writeText(`CORTEX recall — ${hits.length} fact(s):`);
+        for (const h of hits)
+            writeText(`  • ${h.entry.key} = ${h.entry.value}   (by ${h.entry.agent})`);
+    });
+    c.command("handoff <toAgent>")
+        .description("Build a signed context capsule of the live shared memory for a receiving agent.")
+        .option("--json", "JSON output.")
+        .action(async (toAgent, opts) => {
+        const m = await core();
+        if (!m) {
+            writeText("✗ @mneme-ai/core unavailable.");
+            process.exitCode = 1;
+            return;
+        }
+        const cap = m.cortex.handoff(process.cwd(), readStore(process.cwd()), toAgent, Date.now());
+        if (opts.json) {
+            writeJson(cap);
+            return;
+        }
+        writeText(`✓ signed handoff capsule for ${cap.toAgent} — ${cap.facts.length} fact(s)`);
+    });
+}
+//# sourceMappingURL=cortex.js.map

package/dist/commands/cortex.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyIA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAm+MvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0IA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAo+MvD"}

package/dist/index.js

@@ -70,6 +70,7 @@ import { registerSupernovaCommands } from "./commands/supernova-cli.js";
 import { registerManifestCommands } from "./commands/manifest.js";
 import { registerHydraCommands } from "./commands/hydra.js";
 import { registerWisdomGateCommands } from "./commands/wisdom_gates.js";
+import { registerCortexCommands } from "./commands/cortex.js";
 import { registerTrustCommands } from "./commands/trust.js";
 import { registerNuclearCommands } from "./commands/nuclear-cli.js";
 import { registerOvernightCommand } from "./commands/overnight.js";
@@ -4685,6 +4686,7 @@ export async function run(argv) {
     registerManifestCommands(program);
     registerHydraCommands(program);
     registerWisdomGateCommands(program);
+    registerCortexCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);
     // ─── Wisdom reactor (v1.33.0) -- five nuclear-physics formulas as Mneme metrics