mneme-ai 2.136.0 → 2.137.0

package/dist/commands/stele.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `mneme stele` (v2.137.0) — the signed, merkle-rooted, delta-syncable
+ * capability inscription. An agent learns the WHOLE Mneme surface at O(delta)
+ * tokens and can PROVE it holds the latest, complete set.
+ *
+ *   mneme stele                       # the current merkle root + count (signed)
+ *   mneme stele --held <root>         # delta vs what you hold (added/changed/removed)
+ *   mneme stele --held-file held.json # held = {"root":"…","leaves":{name:hash}}
+ *   mneme stele --verify <root>       # is my held root current? (stale/tamper-evident)
+ *   mneme stele --json
+ */
+import type { Command } from "commander";
+export declare function registerSteleCommands(program: Command): void;
+//# sourceMappingURL=stele.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stele.d.ts","sourceRoot":"","sources":["../../src/commands/stele.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0C5D"}

package/dist/commands/stele.js

@@ -0,0 +1,86 @@
+/**
+ * `mneme stele` (v2.137.0) — the signed, merkle-rooted, delta-syncable
+ * capability inscription. An agent learns the WHOLE Mneme surface at O(delta)
+ * tokens and can PROVE it holds the latest, complete set.
+ *
+ *   mneme stele                       # the current merkle root + count (signed)
+ *   mneme stele --held <root>         # delta vs what you hold (added/changed/removed)
+ *   mneme stele --held-file held.json # held = {"root":"…","leaves":{name:hash}}
+ *   mneme stele --verify <root>       # is my held root current? (stale/tamper-evident)
+ *   mneme stele --json
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { stele, notary, agentManifest } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+function catalogEntries() {
+    try {
+        return agentManifest.MNEME_COMMAND_CATALOG.map((c) => ({ name: c.command, version: c.since, summary: c.what }));
+    }
+    catch {
+        return [];
+    }
+}
+export function registerSteleCommands(program) {
+    program
+        .command("stele")
+        .description("🗿 STELE — the signed, merkle-rooted, delta-syncable inscription of Mneme's whole capability surface. An agent proves it holds the latest/complete set (merkle root) + pulls only the delta at boot (O(delta) tokens, not O(900 tools)). The honest fix for 'I didn't know that tool existed' + a stale manifest.")
+        .option("--held <root>", "the merkle root your agent currently holds (for a delta).")
+        .option("--held-file <p>", "JSON file: {\"root\":\"…\",\"leaves\":{\"name\":\"hash\"}} — full delta incl. tamper-detect.")
+        .option("--verify <root>", "verify a held root against the live catalog (stale/tamper-evident).")
+        .option("--json", "JSON output (signed).")
+        .action((opts) => {
+        const cwd = process.cwd();
+        const entries = catalogEntries();
+        if (opts.verify) {
+            const v = stele.verifyStele(entries, opts.verify);
+            if (opts.json) {
+                out(JSON.stringify(v, null, 2));
+            }
+            else {
+                out(`${v.ok ? "✓ CURRENT" : "🛑 STALE/TAMPERED"} — ${v.reason}\n   live root: ${v.currentRoot}`);
+            }
+            process.exitCode = v.ok ? 0 : 2;
+            return;
+        }
+        let heldRoot = opts.held ?? "";
+        let heldLeaves;
+        if (opts.heldFile && existsSync(opts.heldFile)) {
+            try {
+                const j = JSON.parse(readFileSync(opts.heldFile, "utf8"));
+                heldRoot = typeof j.root === "string" ? j.root : heldRoot;
+                if (j.leaves && typeof j.leaves === "object")
+                    heldLeaves = j.leaves;
+            }
+            catch { /* */ }
+        }
+        if (heldRoot || heldLeaves) {
+            const d = stele.steleDelta(entries, heldRoot, heldLeaves);
+            const receipt = notary.issueReceipt(cwd, { kind: "claim-verdict", subject: "stele.delta", payload: { currentRoot: d.currentRoot, upToDate: d.upToDate, added: d.added.length, changed: d.changed.length, removed: d.removed.length }, includePayload: true });
+            if (opts.json) {
+                out(JSON.stringify({ ...d, receipt }, null, 2));
+                return;
+            }
+            if (d.upToDate) {
+                out(`✓ UP TO DATE — ${d.note}\n   root: ${d.currentRoot}`);
+                return;
+            }
+            out(`🔄 STELE delta — ${d.added.length} new · ${d.changed.length} changed · ${d.removed.length} removed  (~${d.deltaTokenEstimate} tok vs ~${d.fullTokenEstimate} full)`);
+            for (const e of d.added.slice(0, 20))
+                out(`   + ${e.name}${e.summary ? ` — ${e.summary.slice(0, 70)}` : ""}`);
+            for (const e of d.changed.slice(0, 20))
+                out(`   ~ ${e.name}${e.summary ? ` — ${e.summary.slice(0, 70)}` : ""}`);
+            for (const n of d.removed.slice(0, 20))
+                out(`   - ${n}`);
+            out(`   new root: ${d.currentRoot}  ·  receipt ${receipt.receiptId ? receipt.receiptId.slice(0, 12) + "…" : "(signed)"}`);
+            return;
+        }
+        const s = stele.buildStele(entries);
+        const receipt = notary.issueReceipt(cwd, { kind: "claim-verdict", subject: "stele.root", payload: { root: s.root, count: s.count }, includePayload: true });
+        if (opts.json) {
+            out(JSON.stringify({ root: s.root, count: s.count, receipt }, null, 2));
+            return;
+        }
+        out(`🗿 STELE — ${s.count} capabilities · merkle root:\n   ${s.root}\n   signed · pass --held <root> for a delta, --verify <root> to check freshness.`);
+    });
+}
+//# sourceMappingURL=stele.js.map

package/dist/commands/stele.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stele.js","sourceRoot":"","sources":["../../src/commands/stele.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":"AA8JA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAohNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+JA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqhNvD"}

package/dist/index.js

@@ -91,6 +91,7 @@ import { registerFirewallCommands } from "./commands/firewall.js";
 import { registerRailCommands } from "./commands/rail.js";
 import { registerBootCommands } from "./commands/boot.js";
 import { registerElleipsisCommands } from "./commands/elleipsis.js";
+import { registerSteleCommands } from "./commands/stele.js";
 import { registerTrustCommands } from "./commands/trust.js";
 import { registerNuclearCommands } from "./commands/nuclear-cli.js";
 import { registerOvernightCommand } from "./commands/overnight.js";
@@ -4731,6 +4732,7 @@ export async function run(argv) {
     registerRailCommands(program);
     registerBootCommands(program);
     registerElleipsisCommands(program);
+    registerSteleCommands(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