mneme-ai 2.61.0 → 2.63.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,CAgrLvD"}
+{"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,CA63LvD"}

package/dist/index.js

@@ -4682,6 +4682,228 @@ export async function run(argv) {
             process.exitCode = 1;
         }
     });
+    // v2.63.0 — TIME-CRYSTAL: federated agent wisdom.
+    // When agent A hits problem P → "342 agents saw same in 7 days; 89%
+    // used X; 11% tried Y but broke on pnpm".
+    const timeCrystalParent = program
+        .command("time_crystal")
+        .description("v2.63 — federated agent wisdom. Default action = stats summary.")
+        .action(async () => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const stats = core.timeCrystal.contributorStats(process.cwd());
+            const led = core.timeCrystal.verifyLedgerChain(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: led.ok, ledger: led, ...stats }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    timeCrystalParent.command("lookup")
+        .description("Look up wisdom for a problem (returns ranked approaches + gotchas + related buckets).")
+        .requiredOption("--problem <text>", "Problem description")
+        .option("--env <kv...>", "Env hints (e.g. node=22 pm=npm)", (val, prev = []) => prev.concat([val]), [])
+        .option("--top <n>", "Max approaches", (v) => Number(v), 5)
+        .option("--banner", "Render ASCII banner instead of JSON")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const envMap = {};
+            for (const e of opts.env ?? []) {
+                const [k, v] = e.split("=");
+                if (k && v)
+                    envMap[k] = v;
+            }
+            const r = core.timeCrystal.lookupWisdom({
+                problem: opts.problem,
+                env: Object.keys(envMap).length > 0 ? envMap : undefined,
+                topN: opts.top ?? 5,
+                cwd: process.cwd(),
+            });
+            if (opts.banner)
+                process.stdout.write(core.timeCrystal.renderLookupBanner(r) + "\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;
+        }
+    });
+    timeCrystalParent.command("contribute")
+        .description("Contribute a (problem, approach, outcome) record. Anyone using Mneme MCP contributes back.")
+        .requiredOption("--problem <text>", "Problem description")
+        .requiredOption("--approach <text>", "What you tried")
+        .requiredOption("--outcome <s>", "success / failure / partial")
+        .requiredOption("--agent <id>", "Reporting agent identifier")
+        .option("--env <kv...>", "Env hints (node=22 pm=npm)", (val, prev = []) => prev.concat([val]), [])
+        .option("--note <text>", "Free-text gotcha hint")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const envMap = {};
+            for (const e of opts.env ?? []) {
+                const [k, v] = e.split("=");
+                if (k && v)
+                    envMap[k] = v;
+            }
+            const r = core.timeCrystal.contribute({
+                problem: opts.problem,
+                approach: opts.approach,
+                outcome: opts.outcome,
+                agent: opts.agent,
+                env: Object.keys(envMap).length > 0 ? envMap : undefined,
+                note: opts.note,
+                cwd: process.cwd(),
+            });
+            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;
+        }
+    });
+    timeCrystalParent.command("stats")
+        .description("Show contributor stats: total contributions, distinct agents, top problems.")
+        .action(async () => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const stats = core.timeCrystal.contributorStats(process.cwd());
+            process.stdout.write(JSON.stringify(stats, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    timeCrystalParent.command("audit")
+        .description("Verify HMAC-chained wisdom 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.timeCrystal.verifyLedgerChain(process.cwd());
+            const rows = core.timeCrystal.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.62.0 — MIRRAGE: live conscience for AI agents via MCP reverse-channel.
+    // Agent calls `mneme.mirrage.scan {draft}` BEFORE shipping; per-sentence
+    // nudges (5-level conscience ladder) + suggested edit + ship-block on
+    // critical findings.
+    const mirrageParent = program
+        .command("mirrage")
+        .description("v2.62 — live conscience. Default action = ledger audit.")
+        .action(async () => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const led = core.mirrage.verifyLedgerChain(process.cwd());
+            const rows = core.mirrage.readLedger(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: led.ok, rows: led.rows, brokenAt: led.brokenAt, recent: rows.slice(-10) }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    mirrageParent.command("scan")
+        .description("Scan a draft for refutable claims. Returns per-sentence nudges + suggested edit + ship-block decision.")
+        .requiredOption("--draft <text>", "Draft text (or use --stdin)")
+        .requiredOption("--agent <id>", "Requesting agent identifier")
+        .option("--cursor <n>", "Streaming mode: only scan sentences ending before this offset", (v) => Number(v))
+        .option("--min-risk <n>", "Risk threshold below which no nudge is emitted (default 0.30)", (v) => Number(v), 0.30)
+        .option("--banner", "Render ASCII banner instead of JSON")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = core.mirrage.scanDraft({
+                draft: opts.draft,
+                agent: opts.agent,
+                cursorPos: opts.cursor,
+                minRisk: opts.minRisk ?? 0.30,
+                cwd: process.cwd(),
+            });
+            if (opts.banner)
+                process.stdout.write(core.mirrage.renderBanner(r) + "\n");
+            else
+                process.stdout.write(JSON.stringify(r, null, 2) + "\n");
+            if (r.blocksShip)
+                process.exitCode = 1;
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    mirrageParent.command("ack")
+        .description("Acknowledge a nudge (closes alert + bumps fatigue counter + optional cross-agent wisdom broadcast).")
+        .requiredOption("--scan-id <id>", "Scan id from a prior scan")
+        .requiredOption("--nudge-id <id>", "Nudge id within that scan")
+        .requiredOption("--agent <id>", "Acknowledging agent")
+        .option("--broadcast", "Append lesson to cross-agent wisdom feed")
+        .option("--sentence <text>", "Sentence (required if --broadcast)")
+        .option("--level <l>", "Conscience level (hint/suggestion/warning/block/reject)")
+        .option("--reason <r>", "Why the agent acked")
+        .option("--fingerprint <fp>", "Fingerprint hash (for fatigue gating)")
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const r = core.mirrage.acknowledgeNudge({
+                scanId: opts.scanId,
+                nudgeId: opts.nudgeId,
+                agent: opts.agent,
+                broadcast: opts.broadcast === true,
+                sentence: opts.sentence,
+                level: opts.level,
+                reason: opts.reason,
+                fingerprint: opts.fingerprint,
+                cwd: process.cwd(),
+            });
+            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;
+        }
+    });
+    mirrageParent.command("wisdom")
+        .description("Show cross-agent wisdom feed (lessons broadcast after nudge acks).")
+        .option("--limit <n>", "Max rows", (v) => Number(v), 20)
+        .action(async (opts) => {
+        try {
+            const core = await import("@mneme-ai/core");
+            const rows = core.mirrage.readWisdom(process.cwd());
+            process.stdout.write(JSON.stringify({ ok: true, total: rows.length, recent: rows.slice(-(opts.limit ?? 20)) }, null, 2) + "\n");
+        }
+        catch (e) {
+            process.stdout.write(JSON.stringify({ ok: false, error: e.message }) + "\n");
+            process.exitCode = 1;
+        }
+    });
+    mirrageParent.command("audit")
+        .description("Verify the HMAC-chained nudge 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.mirrage.verifyLedgerChain(process.cwd());
+            const rows = core.mirrage.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.61.0 — PASSPORT: capability-based security for MCP.
     // Agents request HMAC-signed passports before sensitive tool calls;
     // trust score gates issuance; delegation chain + revocation cascade