mneme-ai 2.64.0 → 2.66.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -4682,6 +4682,237 @@ export async function run(argv) {
             process.exitCode = 1;
         }
     });
+    // v2.66.0 — REFLOG: cross-session time-machine.
+    const reflogParent = program
+        .command("reflog")
+        .description("v2.66 — time-machine: per-file checkpoints + selective rewind. Default = list checkpoints.")
+        .action(async () => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const list = core.reflog.listCheckpoints(process.cwd());
+            const led = core.reflog.verifyLedgerChain(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: led.ok, checkpoints: list, ledger: led }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    reflogParent.command("checkpoint")
+        .description("Create an HMAC-signed checkpoint of all tracked files with pheromone tag.")
+        .option("--label <text>", "Optional label (e.g. 'before refactor')")
+        .option("--include <list>", "Comma-separated include globs", (v) => v.split(",").map((s) => s.trim()).filter(Boolean), ["**/*"])
+        .option("--exclude <list>", "Comma-separated additional exclude globs", (v) => v.split(",").map((s) => s.trim()).filter(Boolean), [])
+        .option("--max-files <n>", "Max files to track (default 5000)", (v) => Number(v), 5000)
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = core.reflog.createCheckpoint({ cwd: process.cwd(), label: opts.label, include: opts.include, exclude: opts.exclude, maxFiles: opts.maxFiles });
+            process.stdout.write(JSON.stringify(r, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    reflogParent.command("list")
+        .description("List all checkpoints with timestamps + pheromone tags.")
+        .action(async () => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const list = core.reflog.listCheckpoints(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: true, count: list.length, checkpoints: list }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    reflogParent.command("rewind")
+        .description("PREVIEW a rewind proposal (dry-run by design). Returns toRevert + toKeep with HMAC proof. Apply manually via your IDE.")
+        .option("--since <window>", "Time window like '2h', '30m', '1d'")
+        .option("--checkpoint <id>", "Specific checkpoint id")
+        .option("--include <list>", "Comma-separated include globs", (v) => v.split(",").map((s) => s.trim()).filter(Boolean), [])
+        .option("--exclude <list>", "Comma-separated exclude globs (e.g. 'tests/**')", (v) => v.split(",").map((s) => s.trim()).filter(Boolean), [])
+        .option("--pheromone <name>", "Only rewind files where target checkpoint pheromone equals this")
+        .option("--banner", "Render ASCII banner instead of JSON")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = core.reflog.rewindPreview({
+                cwd: process.cwd(),
+                since: opts.since,
+                checkpointId: opts.checkpoint,
+                include: opts.include,
+                exclude: opts.exclude,
+                pheromone: opts.pheromone,
+            });
+            if (opts.banner)
+                process.stdout.write(core.reflog.renderRewindBanner(r) + "\n");
+            else
+                process.stdout.write(JSON.stringify(r, null, 2) + "\n");
+            if (!r.ok)
+                process.exitCode = 1;
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    reflogParent.command("audit")
+        .description("Verify HMAC-chained reflog ledger + last N entries.")
+        .option("--limit <n>", "Max rows", (v) => Number(v), 20)
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const led = core.reflog.verifyLedgerChain(process.cwd());
+            const rows = core.reflog.readLedger(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: led.ok, totalRows: led.rows, brokenAt: led.brokenAt, recent: rows.slice(-(opts.limit ?? 20)) }, null, 2) + "\n");
+            if (!led.ok)
+                process.exitCode = 1;
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    // v2.65.0 — SWARM BUS: cross-agent message bus.
+    const swarmBusParent = program
+        .command("swarm_bus")
+        .description("v2.65 — cross-agent message bus. Default action = audit ledger.")
+        .action(async () => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const led = core.swarmBus.verifyLedgerChain(process.cwd());
+            const rows = core.swarmBus.readLedger(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: led.ok, rows: led.rows, brokenAt: led.brokenAt, channels: core.swarmBus.listChannels(process.cwd()), recent: rows.slice(-10) }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    swarmBusParent.command("subscribe")
+        .description("Subscribe an agent to a channel. Auto-creates public channel if not exists.")
+        .requiredOption("--channel <name>", "Channel name")
+        .requiredOption("--agent <id>", "Agent id")
+        .option("--passport <token>", "Capability passport (required for private channels)")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = await core.swarmBus.subscribe({ channel: opts.channel, agent: opts.agent, passportToken: opts.passport, cwd: process.cwd() });
+            process.stdout.write(JSON.stringify(r, null, 2) + "\n");
+            if (!r.ok)
+                process.exitCode = 1;
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    swarmBusParent.command("broadcast")
+        .description("Broadcast a message to a channel. Optional artifact HMAC for tamper-evident handoffs.")
+        .requiredOption("--channel <name>", "Channel name")
+        .requiredOption("--from <agent>", "Sender agent id")
+        .requiredOption("--text <text>", "Message text")
+        .option("--artifact-path <path>", "Optional relative path to artifact")
+        .option("--artifact-hmac <hash>", "Optional HMAC/SHA of artifact for tamper detection")
+        .option("--passport <token>", "Capability passport (required for private channels)")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = await core.swarmBus.broadcast({ channel: opts.channel, from: opts.from, text: opts.text, artifactPath: opts.artifactPath, artifactHmac: opts.artifactHmac, passportToken: opts.passport, cwd: process.cwd() });
+            process.stdout.write(JSON.stringify(r, null, 2) + "\n");
+            if (!r.ok)
+                process.exitCode = 1;
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    swarmBusParent.command("drain")
+        .description("Drain (pop) pending messages for an agent. Returns inbox content + clears it.")
+        .requiredOption("--agent <id>", "Agent id")
+        .option("--channel <name>", "Optional channel filter")
+        .option("--limit <n>", "Max messages to drain", (v) => Number(v))
+        .option("--banner", "Render ASCII inbox banner")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = core.swarmBus.drain({ agent: opts.agent, channel: opts.channel, limit: opts.limit, cwd: process.cwd() });
+            if (opts.banner)
+                process.stdout.write(core.swarmBus.renderInbox(r.messages) + "\n");
+            else
+                process.stdout.write(JSON.stringify(r, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    swarmBusParent.command("peek")
+        .description("Peek at an agent's inbox without consuming.")
+        .requiredOption("--agent <id>", "Agent id")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const messages = core.swarmBus.peekInbox(process.cwd(), opts.agent);
+            process.stdout.write(JSON.stringify({ ok: true, count: messages.length, messages }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    swarmBusParent.command("handoff")
+        .description("Render the agent → agent → agent handoff chain for a channel with HMAC proof per step.")
+        .requiredOption("--channel <name>", "Channel name")
+        .option("--banner", "Render ASCII")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = core.swarmBus.auditHandoff(process.cwd(), opts.channel);
+            if (opts.banner)
+                process.stdout.write(r.rendered + "\n");
+            else
+                process.stdout.write(JSON.stringify(r, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    swarmBusParent.command("channels")
+        .description("List all channels with kind + subscriber count + Lamport clock.")
+        .action(async () => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const channels = core.swarmBus.listChannels(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: true, count: channels.length, channels }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    swarmBusParent.command("audit")
+        .description("Verify HMAC-chained bus ledger + show last N entries.")
+        .option("--limit <n>", "Max rows", (v) => Number(v), 20)
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const led = core.swarmBus.verifyLedgerChain(process.cwd());
+            const rows = core.swarmBus.readLedger(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: led.ok, totalRows: led.rows, brokenAt: led.brokenAt, recent: rows.slice(-(opts.limit ?? 20)) }, null, 2) + "\n");
+            if (!led.ok)
+                process.exitCode = 1;
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
     // v2.64.0 — DIFFERENTIAL ARENA: multi-vendor consensus by default.
     const diffArenaParent = program
         .command("diff_arena")