mneme-ai 2.79.0 → 2.80.0

package/dist/commands/flight.d.ts

@@ -0,0 +1,22 @@
+/**
+ * v2.80.0 — `mneme flight <action>` · the AI black box.
+ *
+ *   mneme flight record --agent A --action "..." [--kind K] [--reasoning R] [--claim C] [--reality O] [--delta MATCH|CONTRADICT|UNVERIFIED]
+ *   mneme flight replay            — causal-order narrative + the incident moment
+ *   mneme flight verify            — verify the whole recorder offline (public-key)
+ *   mneme flight seal              — emit ONE court-admissible signed receipt
+ */
+export interface FlightOpts {
+    cwd: string;
+    action: string;
+    agent?: string;
+    frameKind?: string;
+    actionText?: string;
+    reasoning?: string;
+    claim?: string;
+    reality?: string;
+    delta?: string;
+    json?: boolean;
+}
+export declare function flightCommand(o: FlightOpts): Promise<number>;
+//# sourceMappingURL=flight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flight.d.ts","sourceRoot":"","sources":["../../src/commands/flight.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlE"}

package/dist/commands/flight.js

@@ -0,0 +1,83 @@
+/**
+ * v2.80.0 — `mneme flight <action>` · the AI black box.
+ *
+ *   mneme flight record --agent A --action "..." [--kind K] [--reasoning R] [--claim C] [--reality O] [--delta MATCH|CONTRADICT|UNVERIFIED]
+ *   mneme flight replay            — causal-order narrative + the incident moment
+ *   mneme flight verify            — verify the whole recorder offline (public-key)
+ *   mneme flight seal              — emit ONE court-admissible signed receipt
+ */
+import { writeSync } from "node:fs";
+import * as core from "@mneme-ai/core";
+function out(s) {
+    try {
+        writeSync(1, s);
+    }
+    catch {
+        process.stdout.write(s);
+    }
+}
+const KINDS = new Set(["action", "decision", "claim", "tool-call", "payment", "observation"]);
+const DELTAS = new Set(["MATCH", "CONTRADICT", "UNVERIFIED"]);
+export async function flightCommand(o) {
+    const fr = core.flightRecorder;
+    if (o.action === "record") {
+        if (!o.agent || !o.actionText) {
+            out("✗ record requires --agent and --action\n");
+            return 2;
+        }
+        const f = fr.record(o.cwd, {
+            agent: o.agent,
+            kind: o.frameKind && KINDS.has(o.frameKind) ? o.frameKind : "action",
+            action: o.actionText,
+            reasoning: o.reasoning,
+            claim: o.claim,
+            observedReality: o.reality,
+            truthDelta: o.delta && DELTAS.has(o.delta) ? o.delta : undefined,
+        });
+        if (o.json) {
+            out(JSON.stringify(f, null, 2) + "\n");
+            return 0;
+        }
+        const mark = f.truthDelta === "CONTRADICT" ? "🔴" : f.truthDelta === "MATCH" ? "🟢" : "⚪";
+        out(`🛫 recorded frame #${f.seq} ${mark} (${f.truthDelta}) — receipt ${f.receiptId.slice(0, 12)}…\n`);
+        return 0;
+    }
+    if (o.action === "verify") {
+        const v = fr.verifyCdr(o.cwd, { sameIssuer: true });
+        if (o.json) {
+            out(JSON.stringify(v, null, 2) + "\n");
+            return v.valid ? 0 : 1;
+        }
+        out(v.valid ? `🟢 BLACK BOX INTACT — ${v.frames} frame(s) verify offline (signed + chained).\n` : `🔴 TAMPERED — ${v.reason} (at frame ${v.brokenAt}).\n`);
+        return v.valid ? 0 : 1;
+    }
+    if (o.action === "replay") {
+        const r = fr.replay(o.cwd);
+        if (o.json) {
+            out(JSON.stringify(r, null, 2) + "\n");
+            return 0;
+        }
+        const lines = [];
+        lines.push(`🎞  FLIGHT REPLAY — ${r.frames} frame(s) · chain ${r.chainValid ? "VALID ✓" : "BROKEN ✗"}`);
+        lines.push(`   match=${r.counts.match} contradict=${r.counts.contradict} unverified=${r.counts.unverified}`);
+        if (r.incidentSeq !== null)
+            lines.push(`   🔴 INCIDENT at frame #${r.incidentSeq} (first claim≠reality)`);
+        lines.push("");
+        for (const n of r.narrative)
+            lines.push(`   ${n}`);
+        out(lines.join("\n") + "\n");
+        return 0;
+    }
+    if (o.action === "seal") {
+        const s = fr.seal(o.cwd);
+        if (o.json) {
+            out(JSON.stringify(s, null, 2) + "\n");
+            return 0;
+        }
+        out(`🔏 SEALED — ${s.frames} frame(s), ${s.contradictions} contradiction(s)${s.incidentSeq !== null ? ` (incident #${s.incidentSeq})` : ""}.\n  head:    ${s.head ?? "(empty)"}\n  receipt: ${s.receipt.receiptId}\n  issuer:  ${s.receipt.issuerFingerprint}\n\n  Hand the receipt to an auditor — it verifies offline (mneme notary verify).\n`);
+        return 0;
+    }
+    out(`✗ Unknown flight action "${o.action}". Try: record | replay | verify | seal\n`);
+    return 2;
+}
+//# sourceMappingURL=flight.js.map

package/dist/commands/flight.js.map

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

package/dist/index.js

@@ -4209,6 +4209,35 @@ export async function run(argv) {
             json: !!o.json,
         }));
     });
+    // v2.80.0 — FLIGHT RECORDER (💎3). The tamper-evident, replayable AI black box,
+    // built on the NOTARY spine — every frame is a signed, chained receipt the
+    // whole recorder verifies offline; seal = one court-admissible artifact.
+    program
+        .command("flight <action>")
+        .description("🛫 FLIGHT RECORDER — the AI black box. record/replay/verify/seal an agent's actions+reasoning+claim-vs-reality as signed, chained receipts (built on NOTARY). actions: record | replay | verify | seal.")
+        .option("--agent <a>", "agent id (record)")
+        .option("--action <text>", "what the agent did (record)")
+        .option("--kind <k>", "action | decision | claim | tool-call | payment | observation", "action")
+        .option("--reasoning <r>", "why — reasoning trace (record)")
+        .option("--claim <c>", "a checkable claim the agent asserted (record)")
+        .option("--reality <o>", "what was actually observed/true (record)")
+        .option("--delta <d>", "explicit MATCH | CONTRADICT | UNVERIFIED (overrides heuristic)")
+        .option("--json", "machine-readable output", false)
+        .action(async (action, o) => {
+        const { flightCommand } = await import("./commands/flight.js");
+        process.exit(await flightCommand({
+            cwd: process.cwd(),
+            action,
+            agent: o.agent,
+            actionText: o.action,
+            frameKind: o.kind,
+            reasoning: o.reasoning,
+            claim: o.claim,
+            reality: o.reality,
+            delta: o.delta,
+            json: !!o.json,
+        }));
+    });
     program
         .command("atlas")
         .description("🗺  ATLAS HELP — six-layer discovery (TASTE · BLOOM · HOT · TAGS · INTENT · FULL). AI agents read 200 bytes here instead of 14 KB from --help.")