mneme-ai 3.114.0 → 3.116.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/commands/sdc.d.ts.map +1 -1
- package/dist/commands/sdc.js +20 -0
- package/dist/commands/sdc.js.map +1 -1
- package/dist/commands/statguard.d.ts +11 -0
- package/dist/commands/statguard.d.ts.map +1 -0
- package/dist/commands/statguard.js +69 -0
- package/dist/commands/statguard.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/package.json +7 -7
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sdc.d.ts","sourceRoot":"","sources":["../../src/commands/sdc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,
|
|
1
|
+
{"version":3,"file":"sdc.d.ts","sourceRoot":"","sources":["../../src/commands/sdc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqD1D"}
|
package/dist/commands/sdc.js
CHANGED
|
@@ -44,6 +44,26 @@ export function registerSdcCommands(program) {
|
|
|
44
44
|
out(` ⚠ located bad agents: ${m.corruptedAgents.join(", ")}`);
|
|
45
45
|
out(` reliability: ${Object.entries(m.reliability).map(([a, r]) => `${a}=${r}`).join(" · ")}`);
|
|
46
46
|
});
|
|
47
|
+
s.command("health")
|
|
48
|
+
.description("Memory Syndrome Health: catch a POISONED or DRIFTED memory cluster before an agent trusts it (the signed A/B — poison detection precision/recall).")
|
|
49
|
+
.option("--json", "JSON output")
|
|
50
|
+
.option("--seed <n>", "scenario seed", "7")
|
|
51
|
+
.action((opts) => {
|
|
52
|
+
const b = sdc.memHealthBench(parseInt(opts.seed ?? "7", 10) || 7);
|
|
53
|
+
let receipt = null;
|
|
54
|
+
try {
|
|
55
|
+
receipt = notary.issueReceipt(process.cwd(), { kind: "reasoning-trace", subject: `sdc.health:r${b.recall}p${b.precision}`, payload: { recall: b.recall, precision: b.precision }, includePayload: true });
|
|
56
|
+
}
|
|
57
|
+
catch { /* */ }
|
|
58
|
+
if (opts.json) {
|
|
59
|
+
out(JSON.stringify({ ...b, signed: receipt }, null, 2));
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
out(`🔷 SDC Memory Health — ${b.trials} memories (${b.poisonInjected} poisoned injected):`);
|
|
63
|
+
out(` poison detected: ${b.detected}/${b.poisonInjected} · recall ${(b.recall * 100).toFixed(0)}% · precision ${(b.precision * 100).toFixed(0)}% (${b.falseFlags} false flag)`);
|
|
64
|
+
out(` model-drift caught: ${b.driftCaught ? "yes" : "no"} · clean cluster stays HEALTHY: ${b.cleanStaysHealthy ? "yes" : "no"}`);
|
|
65
|
+
out(` ${receipt ? "✓ signed · " : ""}HONEST: localized outliers → POISONED (flagged); systemic shift → DRIFTED; detects vs a TRUSTED baseline parity commitment.`);
|
|
66
|
+
});
|
|
47
67
|
s.command("bench")
|
|
48
68
|
.description("the signed A/B: Syndrome-Decoded Consensus vs plain majority-vote on a labeled mesh (sustained-liar regime).")
|
|
49
69
|
.option("--json", "JSON output")
|
package/dist/commands/sdc.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sdc.js","sourceRoot":"","sources":["../../src/commands/sdc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,SAAS,GAAG,CAAC,CAAS,IAAU,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAEjE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,CAAC,GAAG,OAAO;SACd,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,uaAAua,CAAC,CAAC;IAExb,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SAChB,WAAW,CAAC,+HAA+H,CAAC;SAC5I,QAAQ,CAAC,QAAQ,EAAE,oCAAoC,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,CAAC,IAAwB,EAAE,IAAwB,EAAE,EAAE;QAC7D,IAAI,KAAsB,CAAC;QAC3B,IAAI,CAAC;YAAC,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAC1H,MAAM,CAAC;YAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;YAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC9H,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,GAAY,IAAI,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QACrO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACnF,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC,UAAU,sBAAsB,CAAC,CAAC;QACjF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;YAAE,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9P,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM;YAAE,GAAG,CAAC,4BAA4B,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9F,GAAG,CAAC,mBAAmB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;IAEL,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;SACf,WAAW,CAAC,8GAA8G,CAAC;SAC3H,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,CAAC;SAC1C,MAAM,CAAC,CAAC,IAAuC,EAAE,EAAE;QAClD,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,OAAO,GAAY,IAAI,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7Q,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACnF,GAAG,CAAC,gBAAgB,CAAC,CAAC,KAAK,yCAAyC,CAAC,CAAC;QACtE,GAAG,CAAC,2BAA2B,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtG,GAAG,CAAC,2BAA2B,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtJ,GAAG,CAAC,qCAAqC,CAAC,CAAC,kBAAkB,aAAa,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC/F,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,qIAAqI,CAAC,CAAC;IAC/K,CAAC,CAAC,CAAC;AACP,CAAC"}
|
|
1
|
+
{"version":3,"file":"sdc.js","sourceRoot":"","sources":["../../src/commands/sdc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,SAAS,GAAG,CAAC,CAAS,IAAU,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAEjE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,CAAC,GAAG,OAAO;SACd,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,uaAAua,CAAC,CAAC;IAExb,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SAChB,WAAW,CAAC,+HAA+H,CAAC;SAC5I,QAAQ,CAAC,QAAQ,EAAE,oCAAoC,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,CAAC,IAAwB,EAAE,IAAwB,EAAE,EAAE;QAC7D,IAAI,KAAsB,CAAC;QAC3B,IAAI,CAAC;YAAC,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAC1H,MAAM,CAAC;YAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;YAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC9H,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,GAAY,IAAI,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QACrO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACnF,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC,UAAU,sBAAsB,CAAC,CAAC;QACjF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;YAAE,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9P,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM;YAAE,GAAG,CAAC,4BAA4B,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9F,GAAG,CAAC,mBAAmB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;IAEL,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SAChB,WAAW,CAAC,oJAAoJ,CAAC;SACjK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,CAAC;SAC1C,MAAM,CAAC,CAAC,IAAuC,EAAE,EAAE;QAClD,MAAM,CAAC,GAAG,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,IAAI,OAAO,GAAY,IAAI,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QAClO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACnF,GAAG,CAAC,0BAA0B,CAAC,CAAC,MAAM,cAAc,CAAC,CAAC,cAAc,sBAAsB,CAAC,CAAC;QAC5F,GAAG,CAAC,wBAAwB,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,cAAc,cAAc,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,cAAc,CAAC,CAAC;QACpL,GAAG,CAAC,0BAA0B,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,mCAAmC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnI,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,6HAA6H,CAAC,CAAC;IACvK,CAAC,CAAC,CAAC;IAEL,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;SACf,WAAW,CAAC,8GAA8G,CAAC;SAC3H,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,CAAC;SAC1C,MAAM,CAAC,CAAC,IAAuC,EAAE,EAAE;QAClD,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,OAAO,GAAY,IAAI,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7Q,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACnF,GAAG,CAAC,gBAAgB,CAAC,CAAC,KAAK,yCAAyC,CAAC,CAAC;QACtE,GAAG,CAAC,2BAA2B,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtG,GAAG,CAAC,2BAA2B,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtJ,GAAG,CAAC,qCAAqC,CAAC,CAAC,kBAAkB,aAAa,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC/F,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,qIAAqI,CAAC,CAAC;IAC/K,CAAC,CAAC,CAAC;AACP,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `mneme statguard` (v3.116.0) — catch statistical misinterpretations (p-value /
|
|
3
|
+
* CI / power) in a claim, grounded in Greenland et al. 2016. The anti-trap guard
|
|
4
|
+
* so an AI agent (or a researcher) never relays a documented statistics fallacy.
|
|
5
|
+
*
|
|
6
|
+
* mneme statguard "p > 0.05 so there is no effect"
|
|
7
|
+
* mneme statguard bench
|
|
8
|
+
*/
|
|
9
|
+
import type { Command } from "commander";
|
|
10
|
+
export declare function registerStatguardCommands(program: Command): void;
|
|
11
|
+
//# sourceMappingURL=statguard.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `mneme statguard` (v3.116.0) — catch statistical misinterpretations (p-value /
|
|
3
|
+
* CI / power) in a claim, grounded in Greenland et al. 2016. The anti-trap guard
|
|
4
|
+
* so an AI agent (or a researcher) never relays a documented statistics fallacy.
|
|
5
|
+
*
|
|
6
|
+
* mneme statguard "p > 0.05 so there is no effect"
|
|
7
|
+
* mneme statguard bench
|
|
8
|
+
*/
|
|
9
|
+
import { statguard, notary } from "@mneme-ai/core";
|
|
10
|
+
function out(s) { process.stdout.write(s + "\n"); }
|
|
11
|
+
export function registerStatguardCommands(program) {
|
|
12
|
+
const g = program
|
|
13
|
+
.command("statguard")
|
|
14
|
+
.alias("stat-check")
|
|
15
|
+
.argument("[claim...]", "a statistical claim to check")
|
|
16
|
+
.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').")
|
|
17
|
+
.option("--json", "JSON output (signed)")
|
|
18
|
+
.action((claim, opts) => {
|
|
19
|
+
const q = Array.isArray(claim) ? claim.join(" ") : String(claim ?? "");
|
|
20
|
+
if (!q.trim()) {
|
|
21
|
+
out("usage: mneme statguard \"<a statistical claim>\"");
|
|
22
|
+
process.exitCode = 2;
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
const r = statguard.checkStat(q);
|
|
26
|
+
let receipt = null;
|
|
27
|
+
try {
|
|
28
|
+
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 });
|
|
29
|
+
}
|
|
30
|
+
catch { /* */ }
|
|
31
|
+
if (opts.json) {
|
|
32
|
+
out(JSON.stringify({ ...r, signed: receipt }, null, 2));
|
|
33
|
+
process.exitCode = r.verdict === "CLEAN" ? 0 : 2;
|
|
34
|
+
return;
|
|
35
|
+
}
|
|
36
|
+
if (r.verdict === "CLEAN") {
|
|
37
|
+
out(`✓ CLEAN — no known statistical misinterpretation detected.`);
|
|
38
|
+
process.exitCode = 0;
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
out(`🛑 MISINTERPRETATION — ${r.hits.length} fallacy(ies):`);
|
|
42
|
+
for (const h of r.hits) {
|
|
43
|
+
out(` • ${h.name} [${h.ref}]`);
|
|
44
|
+
out(` why: ${h.why}`);
|
|
45
|
+
out(` fix: ${h.correct}`);
|
|
46
|
+
}
|
|
47
|
+
process.exitCode = 2;
|
|
48
|
+
});
|
|
49
|
+
g.command("bench")
|
|
50
|
+
.description("the signed A/B: detection recall on documented fallacies + precision (no false flag on correct statements).")
|
|
51
|
+
.option("--json", "JSON output")
|
|
52
|
+
.action((opts) => {
|
|
53
|
+
const b = statguard.statGuardBench();
|
|
54
|
+
let receipt = null;
|
|
55
|
+
try {
|
|
56
|
+
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 });
|
|
57
|
+
}
|
|
58
|
+
catch { /* */ }
|
|
59
|
+
if (opts.json) {
|
|
60
|
+
out(JSON.stringify({ ...b, signed: receipt }, null, 2));
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
out(`📐 STATGUARD — ${b.total} labeled claims (${b.flaggable} fallacious + ${b.total - b.flaggable} correct):`);
|
|
64
|
+
out(` fallacies caught: ${b.caught}/${b.flaggable} · recall ${(b.recall * 100).toFixed(0)}%`);
|
|
65
|
+
out(` correct kept clean: ${b.cleanCorrect}/${b.total - b.flaggable} · precision ${(b.precision * 100).toFixed(0)}% (${b.falseFlags} false flag)`);
|
|
66
|
+
out(` ${receipt ? "✓ signed · " : ""}grounded in Greenland et al. 2016; deterministic pattern detector — CLEAN = no KNOWN fallacy, not a full stats proof.`);
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
//# sourceMappingURL=statguard.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"statguard.js","sourceRoot":"","sources":["../../src/commands/statguard.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
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"}
|
package/dist/index.js
CHANGED
|
@@ -129,6 +129,7 @@ import { registerMyceliumCommands } from "./commands/mycelium.js";
|
|
|
129
129
|
import { registerSiegeCommands } from "./commands/siege.js";
|
|
130
130
|
import { registerCanonCommands } from "./commands/canon.js";
|
|
131
131
|
import { registerSdcCommands } from "./commands/sdc.js";
|
|
132
|
+
import { registerStatguardCommands } from "./commands/statguard.js";
|
|
132
133
|
import { registerMoatCommands } from "./commands/moat.js";
|
|
133
134
|
import { attachRegretOracle } from "./commands/regret.js";
|
|
134
135
|
import { registerTrustCommands } from "./commands/trust.js";
|
|
@@ -4815,6 +4816,7 @@ export async function run(argv) {
|
|
|
4815
4816
|
registerSiegeCommands(program);
|
|
4816
4817
|
registerCanonCommands(program);
|
|
4817
4818
|
registerSdcCommands(program);
|
|
4819
|
+
registerStatguardCommands(program);
|
|
4818
4820
|
registerMoatCommands(program);
|
|
4819
4821
|
// ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
|
|
4820
4822
|
registerTrustCommands(program);
|