mneme-ai 2.148.0 → 2.149.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.
@@ -0,0 +1,12 @@
1
+ /**
2
+ * `mneme canon` (v2.149.0) — the Accountability-Record Standard (CANON/1). Emit
3
+ * + verify a versioned, Ed25519 offline-verifiable record of "an AI did/decided
4
+ * X, here's the proof" that ANY party can check with the public key alone.
5
+ *
6
+ * mneme canon emit --kind command-gate --subject "rm -rf /" --verdict BLOCK > rec.json
7
+ * mneme canon verify --record rec.json # offline: conformance + body-binds-id + Ed25519 sig
8
+ * mneme canon spec # the published schema
9
+ */
10
+ import type { Command } from "commander";
11
+ export declare function registerCanonCommands(program: Command): void;
12
+ //# sourceMappingURL=canon.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"canon.d.ts","sourceRoot":"","sources":["../../src/commands/canon.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgD5D"}
@@ -0,0 +1,81 @@
1
+ /**
2
+ * `mneme canon` (v2.149.0) — the Accountability-Record Standard (CANON/1). Emit
3
+ * + verify a versioned, Ed25519 offline-verifiable record of "an AI did/decided
4
+ * X, here's the proof" that ANY party can check with the public key alone.
5
+ *
6
+ * mneme canon emit --kind command-gate --subject "rm -rf /" --verdict BLOCK > rec.json
7
+ * mneme canon verify --record rec.json # offline: conformance + body-binds-id + Ed25519 sig
8
+ * mneme canon spec # the published schema
9
+ */
10
+ import { readFileSync } from "node:fs";
11
+ import { createHash } from "node:crypto";
12
+ import { canon, notary } from "@mneme-ai/core";
13
+ function out(s) { process.stdout.write(s + "\n"); }
14
+ export function registerCanonCommands(program) {
15
+ const c = program
16
+ .command("canon")
17
+ .description("📜 CANON — the Accountability-Record Standard: a versioned, Ed25519 OFFLINE-verifiable record of an AI decision/action that ANY auditor / insurer / regulator / competitor can emit + verify with the public key alone, without trusting Mneme. The neutral 'NVD/Visa-of-AI' format on the NOTARY spine; binds the payload by hash (proves what was decided without exposing it), chains by lineage. The moat: a model isn't a moat, but if the canonical FORMAT everyone accepts is yours, everyone speaks it.");
18
+ c.command("emit")
19
+ .description("emit a signed CANON/1 accountability record.")
20
+ .requiredOption("--kind <k>", "command-gate | diff | claim-verdict | agent-action | value-event | siege | memory-capsule | other")
21
+ .requiredOption("--subject <s>", "what the record is about")
22
+ .requiredOption("--verdict <v>", "the decision (ALLOW/BLOCK/PASS/REFUTED/…)")
23
+ .option("--payload <json>", "the underlying payload (bound by hash, not exposed)")
24
+ .option("--lineage <id>", "prev record id (chain)")
25
+ .action((opts) => {
26
+ let payload = undefined;
27
+ try {
28
+ payload = opts.payload ? JSON.parse(opts.payload) : undefined;
29
+ }
30
+ catch {
31
+ payload = opts.payload;
32
+ }
33
+ const rec = canon.buildRecord({ kind: opts.kind, subject: opts.subject, verdict: opts.verdict, payload, lineage: opts.lineage ?? null, ts: Date.now() });
34
+ // sign the recordId with NOTARY (Ed25519, offline-verifiable); embed issuer + sig
35
+ try {
36
+ const receipt = notary.issueReceipt(process.cwd(), { kind: "claim-verdict", subject: `canon:${rec.kind}:${rec.recordId.slice(0, 12)}`, payload: { recordId: rec.recordId }, includePayload: true });
37
+ rec.issuer = (receipt.publicKey ?? receipt.pubkey ?? "ed25519:notary");
38
+ rec.sig = receipt.signature ?? null;
39
+ // re-derive recordId now that issuer is set (issuer is part of the signed body)
40
+ rec.recordId = createHash("sha256").update(canon.canonicalize(rec)).digest("hex");
41
+ }
42
+ catch { /* still emit unsigned-but-conformant */ }
43
+ out(JSON.stringify(rec, null, 2));
44
+ });
45
+ c.command("verify")
46
+ .description("verify a CANON record OFFLINE: conformance + version + body-binds-recordId (exit 2 if invalid).")
47
+ .requiredOption("--record <file>", "the record JSON ('-' for stdin)")
48
+ .option("--json", "JSON output")
49
+ .action((opts) => {
50
+ let rec;
51
+ try {
52
+ const raw = opts.record === "-" ? readFileSync(0, "utf8") : readFileSync(opts.record, "utf8");
53
+ rec = JSON.parse(raw);
54
+ }
55
+ catch {
56
+ out("✗ could not read/parse record");
57
+ process.exitCode = 2;
58
+ return;
59
+ }
60
+ const v = canon.verifyRecord(rec);
61
+ if (opts.json) {
62
+ out(JSON.stringify(v, null, 2));
63
+ process.exitCode = v.ok ? 0 : 2;
64
+ return;
65
+ }
66
+ out(`${v.ok ? "✓ VALID" : "🛑 INVALID"} — ${v.reason}`);
67
+ out(` conformant=${v.conformant} · recordId-binds-body=${v.recordIdValid}`);
68
+ process.exitCode = v.ok ? 0 : 2;
69
+ });
70
+ c.command("spec").description("print the published CANON spec (schema + version policy).").option("--json", "JSON").action((opts) => {
71
+ if (opts.json) {
72
+ out(JSON.stringify(canon.SPEC, null, 2));
73
+ return;
74
+ }
75
+ out(`📜 CANON/${canon.CANON_VERSION} — required: ${canon.SPEC.required.join(", ")}`);
76
+ out(` kinds: ${canon.SPEC.kinds.join(" · ")}`);
77
+ out(` verify: ${canon.SPEC.verify}`);
78
+ out(` versions: ${canon.SPEC.versionPolicy}`);
79
+ });
80
+ }
81
+ //# sourceMappingURL=canon.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"canon.js","sourceRoot":"","sources":["../../src/commands/canon.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyKA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAykNvD"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0KA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0kNvD"}
package/dist/index.js CHANGED
@@ -101,6 +101,7 @@ import { registerGovernCommands } from "./commands/govern.js";
101
101
  import { registerGatewayCommands } from "./commands/gateway.js";
102
102
  import { registerMyceliumCommands } from "./commands/mycelium.js";
103
103
  import { registerSiegeCommands } from "./commands/siege.js";
104
+ import { registerCanonCommands } from "./commands/canon.js";
104
105
  import { attachRegretOracle } from "./commands/regret.js";
105
106
  import { registerTrustCommands } from "./commands/trust.js";
106
107
  import { registerNuclearCommands } from "./commands/nuclear-cli.js";
@@ -4755,6 +4756,7 @@ export async function run(argv) {
4755
4756
  registerGatewayCommands(program);
4756
4757
  registerMyceliumCommands(program);
4757
4758
  registerSiegeCommands(program);
4759
+ registerCanonCommands(program);
4758
4760
  // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
4759
4761
  registerTrustCommands(program);
4760
4762
  // ─── Wisdom reactor (v1.33.0) -- five nuclear-physics formulas as Mneme metrics