mneme-ai 3.115.0 → 3.116.0

package/dist/commands/statguard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `mneme statguard` (v3.116.0) — catch statistical misinterpretations (p-value /
+ * CI / power) in a claim, grounded in Greenland et al. 2016. The anti-trap guard
+ * so an AI agent (or a researcher) never relays a documented statistics fallacy.
+ *
+ *   mneme statguard "p > 0.05 so there is no effect"
+ *   mneme statguard bench
+ */
+import type { Command } from "commander";
+export declare function registerStatguardCommands(program: Command): void;
+//# sourceMappingURL=statguard.d.ts.map

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

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

package/dist/commands/statguard.js

@@ -0,0 +1,69 @@
+/**
+ * `mneme statguard` (v3.116.0) — catch statistical misinterpretations (p-value /
+ * CI / power) in a claim, grounded in Greenland et al. 2016. The anti-trap guard
+ * so an AI agent (or a researcher) never relays a documented statistics fallacy.
+ *
+ *   mneme statguard "p > 0.05 so there is no effect"
+ *   mneme statguard bench
+ */
+import { statguard, notary } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+export function registerStatguardCommands(program) {
+    const g = program
+        .command("statguard")
+        .alias("stat-check")
+        .argument("[claim...]", "a statistical claim to check")
+        .description("📐 STATGUARD — flag documented statistical misinterpretations (p-value / confidence interval / power) in a claim, with the correct interpretation + the Greenland et al. 2016 citation. The anti-trap guard so an AI never relays a stats fallacy to a researcher/doctor/analyst. Deterministic; CLEAN = no KNOWN fallacy (not 'the stats are correct').")
+        .option("--json", "JSON output (signed)")
+        .action((claim, opts) => {
+        const q = Array.isArray(claim) ? claim.join(" ") : String(claim ?? "");
+        if (!q.trim()) {
+            out("usage: mneme statguard \"<a statistical claim>\"");
+            process.exitCode = 2;
+            return;
+        }
+        const r = statguard.checkStat(q);
+        let receipt = null;
+        try {
+            receipt = notary.issueReceipt(process.cwd(), { kind: "claim-verdict", subject: `statguard:${r.verdict}`, payload: { verdict: r.verdict, hits: r.hits.map((h) => h.id) }, includePayload: true });
+        }
+        catch { /* */ }
+        if (opts.json) {
+            out(JSON.stringify({ ...r, signed: receipt }, null, 2));
+            process.exitCode = r.verdict === "CLEAN" ? 0 : 2;
+            return;
+        }
+        if (r.verdict === "CLEAN") {
+            out(`✓ CLEAN — no known statistical misinterpretation detected.`);
+            process.exitCode = 0;
+            return;
+        }
+        out(`🛑 MISINTERPRETATION — ${r.hits.length} fallacy(ies):`);
+        for (const h of r.hits) {
+            out(`   • ${h.name}  [${h.ref}]`);
+            out(`     why: ${h.why}`);
+            out(`     fix: ${h.correct}`);
+        }
+        process.exitCode = 2;
+    });
+    g.command("bench")
+        .description("the signed A/B: detection recall on documented fallacies + precision (no false flag on correct statements).")
+        .option("--json", "JSON output")
+        .action((opts) => {
+        const b = statguard.statGuardBench();
+        let receipt = null;
+        try {
+            receipt = notary.issueReceipt(process.cwd(), { kind: "reasoning-trace", subject: `statguard.bench:r${b.recall}p${b.precision}`, payload: { recall: b.recall, precision: b.precision }, includePayload: true });
+        }
+        catch { /* */ }
+        if (opts.json) {
+            out(JSON.stringify({ ...b, signed: receipt }, null, 2));
+            return;
+        }
+        out(`📐 STATGUARD — ${b.total} labeled claims (${b.flaggable} fallacious + ${b.total - b.flaggable} correct):`);
+        out(`   fallacies caught: ${b.caught}/${b.flaggable}  · recall ${(b.recall * 100).toFixed(0)}%`);
+        out(`   correct kept clean: ${b.cleanCorrect}/${b.total - b.flaggable}  · precision ${(b.precision * 100).toFixed(0)}% (${b.falseFlags} false flag)`);
+        out(`   ${receipt ? "✓ signed · " : ""}grounded in Greenland et al. 2016; deterministic pattern detector — CLEAN = no KNOWN fallacy, not a full stats proof.`);
+    });
+}
+//# sourceMappingURL=statguard.js.map

package/dist/commands/statguard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statguard.js","sourceRoot":"","sources":["../../src/commands/statguard.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":"AAsMA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAymNvD"}
+{"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"}

package/dist/index.js

@@ -129,6 +129,7 @@ import { registerMyceliumCommands } from "./commands/mycelium.js";
 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 { registerMoatCommands } from "./commands/moat.js";
 import { attachRegretOracle } from "./commands/regret.js";
 import { registerTrustCommands } from "./commands/trust.js";
@@ -4815,6 +4816,7 @@ export async function run(argv) {
     registerSiegeCommands(program);
     registerCanonCommands(program);
     registerSdcCommands(program);
+    registerStatguardCommands(program);
     registerMoatCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);