mneme-ai 2.132.0 → 2.133.0

package/dist/commands/boot.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `mneme boot` (v2.133.0) — THE ACTIVATION CORTEX.
+ * The first thing an agent (or a SessionStart hook) calls so it instantly knows
+ * Mneme is connected + WHEN to reach for which tool (the task→tool decision
+ * table) + what the shared memory already knows about this repo.
+ *
+ *   mneme boot                  # human-readable activation digest
+ *   mneme boot --json           # full signed packet
+ *   mneme boot --task "..."     # rank the table for the task at hand
+ *   mneme boot --hook           # emit the activation CONTEXT (what a SessionStart hook injects)
+ *   mneme boot --emit-hook-config   # print the .claude/settings.json snippet to enable the hook
+ */
+import type { Command } from "commander";
+export declare function registerBootCommands(program: Command): void;
+//# sourceMappingURL=boot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/commands/boot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8D3D"}

package/dist/commands/boot.js

@@ -0,0 +1,102 @@
+/**
+ * `mneme boot` (v2.133.0) — THE ACTIVATION CORTEX.
+ * The first thing an agent (or a SessionStart hook) calls so it instantly knows
+ * Mneme is connected + WHEN to reach for which tool (the task→tool decision
+ * table) + what the shared memory already knows about this repo.
+ *
+ *   mneme boot                  # human-readable activation digest
+ *   mneme boot --json           # full signed packet
+ *   mneme boot --task "..."     # rank the table for the task at hand
+ *   mneme boot --hook           # emit the activation CONTEXT (what a SessionStart hook injects)
+ *   mneme boot --emit-hook-config   # print the .claude/settings.json snippet to enable the hook
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { boot, cortex, notary } from "@mneme-ai/core";
+import { getVersion } from "../version.js";
+function out(s) { process.stdout.write(s + "\n"); }
+function readCortexStore(cwd) {
+    try {
+        const p = join(cwd, ".mneme", "cortex", "store.json");
+        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 recallFacts(cwd, task) {
+    try {
+        if (!task)
+            return [];
+        const hits = cortex.recall(readCortexStore(cwd), task, 8);
+        return hits.map((h) => ({ key: h.entry.key, value: h.entry.value }));
+    }
+    catch {
+        return [];
+    }
+}
+export function registerBootCommands(program) {
+    program
+        .command("boot")
+        .description("⚡ ACTIVATION CORTEX — the session-start handshake: confirms Mneme is connected + returns the task→tool decision table (WHEN to use which Mneme tool) + cortex recall. Fire it FIRST.")
+        .option("--task <t>", "the task at hand (ranks the decision table + recalls relevant shared memory).")
+        .option("--json", "full signed packet as JSON.")
+        .option("--hook", "emit the activation CONTEXT a SessionStart hook injects into the agent.")
+        .option("--emit-hook-config", "print the .claude/settings.json SessionStart hook snippet (opt-in).")
+        .action((opts) => {
+        const cwd = process.cwd();
+        const version = getVersion();
+        if (opts.emitHookConfig) {
+            out(boot.bootHookSnippet(process.env["MNEME_CLI_BIN"] ?? "mneme"));
+            process.stderr.write(`\n# Paste the above into .claude/settings.json (merge with existing hooks). It runs \`mneme boot --hook\` at session start so the agent always knows how/when to use Mneme. Opt-in — Mneme never installs a hook for you.\n`);
+            return;
+        }
+        const packet = boot.buildBootPacket({
+            version,
+            healthy: true,
+            ...(opts.task ? { task: opts.task, cortexFacts: recallFacts(cwd, opts.task) } : {}),
+        });
+        if (opts.hook) {
+            // SessionStart hook stdout is injected into the agent's context.
+            out(`<mneme-activation v="${version}">`);
+            out(packet.instructions);
+            if (packet.cortexFacts.length) {
+                out(`\nShared memory relevant now:`);
+                for (const f of packet.cortexFacts)
+                    out(`• ${f.key}: ${f.value}`);
+            }
+            out(`</mneme-activation>`);
+            return;
+        }
+        if (opts.json) {
+            const receipt = notary.issueReceipt(cwd, { kind: "claim-verdict", subject: "boot", payload: { version, rows: packet.decisionTable.length }, includePayload: true });
+            out(JSON.stringify({ ...packet, receipt }, null, 2));
+            return;
+        }
+        // human-readable digest
+        out(`⚡ ${packet.installCheck}`);
+        out(``);
+        out(`Boundaries:`);
+        out(`  ${packet.capabilities.inbound}`);
+        out(`  ${packet.capabilities.outbound}`);
+        out(`  ${packet.capabilities.memory}`);
+        out(`  ${packet.capabilities.token}`);
+        out(``);
+        out(`When to reach for Mneme (signals, not commands):`);
+        for (const r of packet.decisionTable)
+            out(`  • ${r.when}\n      → ${r.tool}\n        (${r.why})`);
+        if (packet.cortexFacts.length) {
+            out(``);
+            out(`Shared memory relevant to "${opts.task}":`);
+            for (const f of packet.cortexFacts)
+                out(`  • ${f.key}: ${f.value}`);
+        }
+        out(``);
+        out(`# ${packet.note}`);
+        out(`# Reliable auto-activation: mneme boot --emit-hook-config  (opt-in SessionStart hook)`);
+    });
+}
+//# sourceMappingURL=boot.js.map

package/dist/commands/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/commands/boot.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":"AA4JA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8gNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6JA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+gNvD"}

package/dist/index.js

@@ -89,6 +89,7 @@ import { registerChannelCommands } from "./commands/channel.js";
 import { registerSettlementCommands } from "./commands/settlement.js";
 import { registerFirewallCommands } from "./commands/firewall.js";
 import { registerRailCommands } from "./commands/rail.js";
+import { registerBootCommands } from "./commands/boot.js";
 import { registerTrustCommands } from "./commands/trust.js";
 import { registerNuclearCommands } from "./commands/nuclear-cli.js";
 import { registerOvernightCommand } from "./commands/overnight.js";
@@ -4723,6 +4724,7 @@ export async function run(argv) {
     registerSettlementCommands(program);
     registerFirewallCommands(program);
     registerRailCommands(program);
+    registerBootCommands(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