mneme-ai 3.116.0 → 3.118.0

package/dist/commands/hpe.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `mneme protect` (v3.117.0) — the Hallucination Protection Engine. Run an AI
+ * claim/output through the nerve mesh → TRUSTED / REVIEW / BLOCK + the fired nerves.
+ *
+ *   mneme protect "p > 0.05 so the drug has no effect"
+ *   mneme protect bench
+ */
+import type { Command } from "commander";
+export declare function registerHpeCommands(program: Command): void;
+//# sourceMappingURL=hpe.d.ts.map

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

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

package/dist/commands/hpe.js

@@ -0,0 +1,65 @@
+/**
+ * `mneme protect` (v3.117.0) — the Hallucination Protection Engine. Run an AI
+ * claim/output through the nerve mesh → TRUSTED / REVIEW / BLOCK + the fired nerves.
+ *
+ *   mneme protect "p > 0.05 so the drug has no effect"
+ *   mneme protect bench
+ */
+import { hpe, notary } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+export function registerHpeCommands(program) {
+    const g = program
+        .command("protect")
+        .alias("hpe")
+        .argument("[claim...]", "an AI claim/output to screen")
+        .description("🧠 HALLUCINATION PROTECTION ENGINE — screen an AI claim through a mesh of INDEPENDENT nerves (statistical fallacy · self-contradiction · overconfidence · fabrication-risk · + external truth-grounding/consensus/injection). REFLEX-blocks any hard fault, ABSTAINS (REVIEW) when unverifiable, passes only well-calibrated claims → TRUSTED/REVIEW/BLOCK. HONEST: drives confidently-wrong → ~0 (precision-when-TRUSTED 1.0 measured), NOT 0% hallucination (impossible). TRUSTED = no KNOWN fault, not a proof of truth.")
+        .option("--json", "JSON output (signed)")
+        .action((claim, opts) => {
+        const q = Array.isArray(claim) ? claim.join(" ") : String(claim ?? "");
+        if (!q.trim()) {
+            out("usage: mneme protect \"<an AI claim>\"");
+            process.exitCode = 2;
+            return;
+        }
+        const r = hpe.protect(q);
+        let receipt = null;
+        try {
+            receipt = notary.issueReceipt(process.cwd(), { kind: "claim-verdict", subject: `hpe:${r.verdict}`, payload: { verdict: r.verdict, trust: r.trust, fired: r.fired.map((f) => f.nerve) }, includePayload: true });
+        }
+        catch { /* */ }
+        if (opts.json) {
+            out(JSON.stringify({ ...r, signed: receipt }, null, 2));
+            process.exitCode = r.verdict === "BLOCK" ? 2 : 0;
+            return;
+        }
+        const icon = r.verdict === "TRUSTED" ? "✓" : r.verdict === "REVIEW" ? "❔" : "🛑";
+        out(`${icon} ${r.verdict}  (trust ${(r.trust * 100).toFixed(0)}%)`);
+        for (const f of r.fired) {
+            out(`   • [${f.severity}] ${f.nerve}: ${f.why}`);
+            out(`     fix: ${f.fix}`);
+        }
+        if (!r.fired.length)
+            out(`   no nerve fired — no known fault (not a proof of truth).`);
+        process.exitCode = r.verdict === "BLOCK" ? 2 : 0;
+    });
+    g.command("bench")
+        .description("the signed A/B: precision-when-TRUSTED (no hallucination passes) + per-class containment, on a labeled corpus.")
+        .option("--json", "JSON output")
+        .action((opts) => {
+        const b = hpe.hpeBench();
+        let receipt = null;
+        try {
+            receipt = notary.issueReceipt(process.cwd(), { kind: "reasoning-trace", subject: `hpe.bench:p${b.precisionWhenTrusted}`, payload: { precisionWhenTrusted: b.precisionWhenTrusted, leaks: b.leaks.length }, includePayload: true });
+        }
+        catch { /* */ }
+        if (opts.json) {
+            out(JSON.stringify({ ...b, signed: receipt }, null, 2));
+            return;
+        }
+        out(`🧠 HPE — ${b.total} labeled claims (${b.risky} hallucination-class + ${b.safe} well-calibrated):`);
+        out(`   ★ precision-when-TRUSTED: ${(b.precisionWhenTrusted * 100).toFixed(0)}%  (${b.leaks.length} hallucination leaked as TRUSTED)`);
+        out(`   hallucinations contained: ${b.hallucinationsBlockedOrReviewed}/${b.risky}  · safe passed: ${b.safeTrusted}/${b.safe} (coverage ${(b.safeCoverage * 100).toFixed(0)}%)`);
+        out(`   ${receipt ? "✓ signed · " : ""}HONEST: confidently-wrong → ~0 via reflex+abstain; NOT 0% hallucination (a novel failure no nerve models can still pass).`);
+    });
+}
+//# sourceMappingURL=hpe.js.map

package/dist/commands/hpe.js.map

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

package/dist/index.js

@@ -130,6 +130,7 @@ import { registerSiegeCommands } from "./commands/siege.js";
 import { registerCanonCommands } from "./commands/canon.js";
 import { registerSdcCommands } from "./commands/sdc.js";
 import { registerStatguardCommands } from "./commands/statguard.js";
+import { registerHpeCommands } from "./commands/hpe.js";
 import { registerMoatCommands } from "./commands/moat.js";
 import { attachRegretOracle } from "./commands/regret.js";
 import { registerTrustCommands } from "./commands/trust.js";
@@ -4817,6 +4818,7 @@ export async function run(argv) {
     registerCanonCommands(program);
     registerSdcCommands(program);
     registerStatguardCommands(program);
+    registerHpeCommands(program);
     registerMoatCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);