mneme-ai 2.115.0 → 2.116.0

package/dist/commands/map.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `mneme map` (v2.116.0) — render the Visual Knowledge Map: a gorgeous,
+ * dependency-free constellation of Mneme's live signed state (savings / loop /
+ * cortex / treasury) that auto-adapts to the terminal (truecolor gradients →
+ * 256-color → plain ASCII on a pipe/CI). Zero config — it just renders the
+ * richest form the surface supports.
+ *
+ *   mneme map            # the live knowledge-map frame
+ *   mneme map --json     # the underlying state (for embedding)
+ *
+ * Gathering is best-effort + total: missing ledgers → idle nodes, never an error.
+ */
+import type { Command } from "commander";
+export declare function registerMapCommands(program: Command): void;
+//# sourceMappingURL=map.d.ts.map

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

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

package/dist/commands/map.js

@@ -0,0 +1,117 @@
+/**
+ * `mneme map` (v2.116.0) — render the Visual Knowledge Map: a gorgeous,
+ * dependency-free constellation of Mneme's live signed state (savings / loop /
+ * cortex / treasury) that auto-adapts to the terminal (truecolor gradients →
+ * 256-color → plain ASCII on a pipe/CI). Zero config — it just renders the
+ * richest form the surface supports.
+ *
+ *   mneme map            # the live knowledge-map frame
+ *   mneme map --json     # the underlying state (for embedding)
+ *
+ * Gathering is best-effort + total: missing ledgers → idle nodes, never an error.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+function writeText(l) { process.stdout.write(l + "\n"); }
+function writeJson(p) { process.stdout.write(JSON.stringify(p, null, 2) + "\n"); }
+async function core() {
+    try {
+        const c = (await import("@mneme-ai/core"));
+        if (c.visual)
+            return c;
+    }
+    catch { /* */ }
+    return null;
+}
+function readVersion() { try {
+    return String(require("../../package.json").version);
+}
+catch {
+    return "";
+} }
+/** Gather the live state into a MapState (best-effort, total). */
+function gatherState(m, cwd) {
+    const nodes = [];
+    let headline = "";
+    let savingsSpark = [];
+    // TREASURY — token savings
+    try {
+        const p = join(cwd, ".mneme", "treasury", "ledger.jsonl");
+        if (existsSync(p) && m.treasury) {
+            const evs = m.treasury.parseLedger(readFileSync(p, "utf8"));
+            const agg = m.treasury.aggregate(evs);
+            if (agg.events > 0) {
+                nodes.push({ label: "SAVINGS", status: "ok" });
+                headline = `${agg.tokensSaved.toLocaleString()} input tokens saved (−${agg.savedPct}%)`;
+                savingsSpark = evs.slice(-24).map((e) => Math.max(0, (e.tokensBefore || 0) - (e.tokensAfter || 0)));
+            }
+            else {
+                nodes.push({ label: "SAVINGS", status: "idle" });
+            }
+        }
+        else {
+            nodes.push({ label: "SAVINGS", status: "idle" });
+        }
+    }
+    catch {
+        nodes.push({ label: "SAVINGS", status: "idle" });
+    }
+    // LOOPGUARD — thrash state
+    try {
+        const p = join(cwd, m.loopguard?.LOOPGUARD_LEDGER ?? ".mneme/loopguard/events.jsonl");
+        if (existsSync(p) && m.loopguard) {
+            const v = m.loopguard.detectStuck(m.loopguard.parseLedger(readFileSync(p, "utf8")));
+            nodes.unshift({ label: "LOOP", status: v.stuck ? "bad" : "ok" });
+        }
+        else {
+            nodes.unshift({ label: "LOOP", status: "idle" });
+        }
+    }
+    catch {
+        nodes.unshift({ label: "LOOP", status: "idle" });
+    }
+    // CORTEX — shared facts
+    try {
+        const p = join(cwd, ".mneme", "cortex", "store.json");
+        if (existsSync(p)) {
+            const store = JSON.parse(readFileSync(p, "utf8"));
+            const n = Array.isArray(store.entries) ? store.entries.length : 0;
+            nodes.push({ label: "CORTEX", status: n > 0 ? "ok" : "idle" });
+        }
+        else {
+            nodes.push({ label: "CORTEX", status: "idle" });
+        }
+    }
+    catch {
+        nodes.push({ label: "CORTEX", status: "idle" });
+    }
+    // TRUTH — always present (the savant identity)
+    nodes.unshift({ label: "TRUTH", status: "ok" });
+    return { state: { version: readVersion(), nodes, savingsSpark, headline: headline || undefined, signed: true } };
+}
+export function registerMapCommands(program) {
+    program
+        .command("map")
+        .alias("visual")
+        .description("🗺️ VISUAL KNOWLEDGE MAP — render Mneme's live signed state as a gorgeous terminal constellation (savings / loop / cortex / truth). Auto-adapts: truecolor gradients → 256-color → plain ASCII on a pipe/CI. Zero config.")
+        .option("--json", "emit the underlying state instead of the rendered frame.")
+        .option("--ascii", "force pure-ASCII output (no color, no Unicode).")
+        .action(async (opts) => {
+        const m = await core();
+        if (!m) {
+            writeText("✗ core unavailable");
+            process.exitCode = 1;
+            return;
+        }
+        const cwd = process.cwd();
+        const { state } = gatherState(m, cwd);
+        if (opts.json) {
+            writeJson(state);
+            return;
+        }
+        const env = opts.ascii ? { ...process.env, MNEME_NO_COLOR: "1", MNEME_ASCII: "1" } : process.env;
+        const caps = m.visual.detectCaps(env, Boolean(process.stdout.isTTY), process.stdout.columns);
+        writeText(m.visual.renderKnowledgeMap(state, caps));
+    });
+}
+//# sourceMappingURL=map.js.map

package/dist/commands/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/commands/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,SAAS,SAAS,CAAC,CAAS,IAAU,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACvE,SAAS,SAAS,CAAC,CAAU,IAAU,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAUjG,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QAAC,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAqB,CAAC;QAAC,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/G,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,KAAa,IAAI,CAAC;IAAC,OAAO,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC;AAAC,CAAC,CAAC,CAAC;AAErH,kEAAkE;AAClE,SAAS,WAAW,CAAC,CAAQ,EAAE,GAAW;IACxC,MAAM,KAAK,GAA6C,EAAE,CAAC;IAC3D,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,YAAY,GAAa,EAAE,CAAC;IAEhC,2BAA2B;IAC3B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QAC1D,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAyD,CAAC;YACpH,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,QAAQ,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,cAAc,EAAE,yBAAyB,GAAG,CAAC,QAAQ,IAAI,CAAC;gBACxF,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACtG,CAAC;iBAAM,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAAC,CAAC;IAE7D,2BAA2B;IAC3B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,gBAAgB,IAAI,+BAA+B,CAAC,CAAC;QACtF,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YACpF,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAAC,CAAC;IAE7D,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;YAC7E,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAAC,CAAC;IAE5D,+CAA+C;IAC/C,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,KAAK,CAAC,QAAQ,CAAC;SACf,WAAW,CAAC,2NAA2N,CAAC;SACxO,MAAM,CAAC,QAAQ,EAAE,0DAA0D,CAAC;SAC5E,MAAM,CAAC,SAAS,EAAE,iDAAiD,CAAC;SACpE,MAAM,CAAC,KAAK,EAAE,IAAyC,EAAE,EAAE;QAC1D,MAAM,CAAC,GAAG,MAAM,IAAI,EAAE,CAAC;QAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAClG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QACjG,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAyC,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnI,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiJA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmgNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkJA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAogNvD"}

package/dist/index.js

@@ -78,6 +78,7 @@ import { registerAbsorbCommands } from "./commands/absorb.js";
 import { registerLoopguardCommands } from "./commands/loopguard.js";
 import { registerDistillCommands } from "./commands/distill.js";
 import { registerSavingsCommands } from "./commands/savings.js";
+import { registerMapCommands } from "./commands/map.js";
 import { registerTrustCommands } from "./commands/trust.js";
 import { registerNuclearCommands } from "./commands/nuclear-cli.js";
 import { registerOvernightCommand } from "./commands/overnight.js";
@@ -4701,6 +4702,7 @@ export async function run(argv) {
     registerLoopguardCommands(program);
     registerDistillCommands(program);
     registerSavingsCommands(program);
+    registerMapCommands(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