mneme-ai 3.143.0 → 3.145.0

package/dist/commands/mutagen.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `mneme mutagen` (v3.144.0) — the adversarial-mutation engine that finds an AI
+ * agent's guardrail holes BEFORE anyone exploits them.
+ *
+ *   hunt     — derive a population of novel attack variants (primitive × mutators)
+ *              and report which BREACH a guardrail (default: Mneme's own normalization
+ *              defense vs a naive substring guard, to show the gap).
+ *   variants — list the derived attack variants (the searched space).
+ *
+ *   mneme mutagen hunt
+ */
+import type { Command } from "commander";
+export declare function registerMutagenCommands(program: Command): void;
+//# sourceMappingURL=mutagen.d.ts.map

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

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

package/dist/commands/mutagen.js

@@ -0,0 +1,51 @@
+/**
+ * `mneme mutagen` (v3.144.0) — the adversarial-mutation engine that finds an AI
+ * agent's guardrail holes BEFORE anyone exploits them.
+ *
+ *   hunt     — derive a population of novel attack variants (primitive × mutators)
+ *              and report which BREACH a guardrail (default: Mneme's own normalization
+ *              defense vs a naive substring guard, to show the gap).
+ *   variants — list the derived attack variants (the searched space).
+ *
+ *   mneme mutagen hunt
+ */
+import { mutagen } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+export function registerMutagenCommands(program) {
+    const c = program.command("mutagen")
+        .description("🧬 MUTAGEN — derive NOVEL attack variants (primitive × mutator combos) and measure which slip past a guardrail. Finds the not-yet-seen attack by SEARCHING the mutation space, then self-hardens. ★HONEST: finds breaches in a given guard over a known space — not magic 'any bug'.");
+    c.command("hunt").description("derive attack variants + report breaches against the naive vs the sound guard")
+        .option("--combo <n>", "max mutators stacked per variant (1-3)", "2")
+        .option("--json", "JSON")
+        .action((o) => {
+        const maxCombo = parseInt(o.combo, 10) || 2;
+        const naive = mutagen.hunt(mutagen.naiveGuard, { maxCombo });
+        const sound = mutagen.hunt(mutagen.soundGuard, { maxCombo });
+        if (o.json) {
+            out(JSON.stringify({ naive, sound }, null, 2));
+            return;
+        }
+        out(`🧬 MUTAGEN — searched ${naive.tested} novel variants (${maxCombo}-deep mutator stacks)`);
+        out(`   naive substring guard: ${Math.round(naive.breachRate * 100)}% BREACH (${naive.breaches.length}/${naive.tested} slip past)`);
+        out(`   Mneme normalize guard: ${Math.round(sound.breachRate * 100)}% breach (${sound.breaches.length}/${sound.tested}) — caught ${Math.round(sound.caughtRate * 100)}%`);
+        out(`   top "killer combos" vs the naive guard (the mutator stacks that breach most):`);
+        for (const k of naive.killerCombos.slice(0, 5))
+            out(`     ✦ [${k.mutators}] — ${k.breaches} breaches`);
+        if (sound.breaches.length) {
+            out(`   residual holes MUTAGEN found in Mneme's OWN guard (honest):`);
+            for (const k of sound.killerCombos.slice(0, 3))
+                out(`     ⚠ [${k.mutators}] — ${k.breaches}`);
+        }
+        else
+            out(`   ✅ Mneme's normalize guard caught EVERY derived variant.`);
+    });
+    c.command("variants").description("list the derived attack variants (the searched mutation space)")
+        .option("--combo <n>", "max mutators stacked", "2").option("--limit <n>", "max shown", "20")
+        .action((o) => {
+        const v = mutagen.deriveVariants(undefined, undefined, { maxCombo: parseInt(o.combo, 10) || 2 });
+        out(`🧬 ${v.length} derived variants (showing ${Math.min(v.length, parseInt(o.limit, 10) || 20)}):`);
+        for (const x of v.slice(0, parseInt(o.limit, 10) || 20))
+            out(`   [${x.class}] ${x.id}`);
+    });
+}
+//# sourceMappingURL=mutagen.js.map

package/dist/commands/mutagen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutagen.js","sourceRoot":"","sources":["../../src/commands/mutagen.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":"AAkNA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqnNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmNA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsnNvD"}

package/dist/index.js

@@ -141,6 +141,7 @@ import { registerLaunchCommands } from "./commands/launch.js";
 import { registerArkCommands } from "./commands/ark.js";
 import { registerCosmosCommands } from "./commands/cosmos.js";
 import { registerLedgerCommands } from "./commands/honesty_ledger.js";
+import { registerMutagenCommands } from "./commands/mutagen.js";
 import { registerMoatCommands } from "./commands/moat.js";
 import { attachRegretOracle } from "./commands/regret.js";
 import { registerTrustCommands } from "./commands/trust.js";
@@ -4839,6 +4840,7 @@ export async function run(argv) {
     registerArkCommands(program);
     registerCosmosCommands(program);
     registerLedgerCommands(program);
+    registerMutagenCommands(program);
     registerMoatCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);