mneme-ai 2.142.0 → 2.143.0

package/dist/commands/drift.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `mneme drift` (v2.143.0) — Mission-Drift Detection (Context Forensics). Run an
+ * EWMA statistical-process-control chart over an agent's action stream to catch
+ * it slowly straying from its declared mission.
+ *
+ *   mneme telos --mission "refactor auth" --scope "src/auth/**" --actions log.jsonl
+ *   cat actions.jsonl | mneme telos --mission "..." --actions -
+ *
+ * actions.jsonl: one JSON per line — {"turn":N,"summary":"...","files":["..."],"riskClass":"write"}
+ * Exit 2 on DIVERGENT. HONEST: measures movement from the agent's own baseline,
+ * not a prediction; abstains UNKNOWN on thin data.
+ */
+import type { Command } from "commander";
+export declare function registerDriftCommands(program: Command): void;
+//# sourceMappingURL=drift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/commands/drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8B5D"}

package/dist/commands/drift.js

@@ -0,0 +1,88 @@
+/**
+ * `mneme drift` (v2.143.0) — Mission-Drift Detection (Context Forensics). Run an
+ * EWMA statistical-process-control chart over an agent's action stream to catch
+ * it slowly straying from its declared mission.
+ *
+ *   mneme telos --mission "refactor auth" --scope "src/auth/**" --actions log.jsonl
+ *   cat actions.jsonl | mneme telos --mission "..." --actions -
+ *
+ * actions.jsonl: one JSON per line — {"turn":N,"summary":"...","files":["..."],"riskClass":"write"}
+ * Exit 2 on DIVERGENT. HONEST: measures movement from the agent's own baseline,
+ * not a prediction; abstains UNKNOWN on thin data.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { drift, notary } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+function splitList(v) { return typeof v === "string" && v.trim() ? v.split(",").map((s) => s.trim()).filter(Boolean) : []; }
+function readActions(file) {
+    try {
+        const raw = file === "-" ? readFileSync(0, "utf8") : (file && existsSync(file) ? readFileSync(file, "utf8") : "");
+        const acts = [];
+        raw.split("\n").forEach((line, i) => {
+            if (!line.trim())
+                return;
+            try {
+                const j = JSON.parse(line);
+                acts.push({ turn: Number(j.turn) || i + 1, summary: String(j.summary ?? ""), files: Array.isArray(j.files) ? j.files.map(String) : undefined, riskClass: j.riskClass });
+            }
+            catch { /* skip */ }
+        });
+        return acts;
+    }
+    catch {
+        return [];
+    }
+}
+function sparkline(series, ucl) {
+    const blocks = "▁▂▃▄▅▆▇█";
+    const max = Math.max(ucl, ...series, 0.001);
+    return series.map((v) => { const idx = Math.min(blocks.length - 1, Math.floor((v / max) * (blocks.length - 1))); return v > ucl ? "❗" : blocks[idx]; }).join("");
+}
+export function registerDriftCommands(program) {
+    program
+        .command("telos")
+        .alias("mission-drift")
+        .description("🧭 TELOS (Mission Drift) — catch an agent slowly straying from its declared mission/telos across turns. Runs an EWMA statistical-process-control chart over a deterministic off-mission signal (off-scope files · off-topic vs the mission keywords · risk-class), with a control limit from the agent's OWN early baseline → band STABLE / DRIFTING / DIVERGENT / UNKNOWN. Reads an actions JSONL. Exit 2 on DIVERGENT. HONEST: measures movement from baseline, NOT a prediction; abstains UNKNOWN on thin data. (The trend layer — distinct from `mneme overshoot`'s one-shot plan compare.)")
+        .requiredOption("--mission <goal>", "the declared mission/goal")
+        .option("--scope <globs>", "comma-separated allowed path globs (e.g. \"src/auth/**\")")
+        .option("--keywords <list>", "comma-separated mission vocabulary (else derived from the goal)")
+        .requiredOption("--actions <file>", "JSONL of agent actions ({turn,summary,files,riskClass}); '-' = stdin")
+        .option("--lambda <n>", "EWMA smoothing 0..1 (default 0.3)", (v) => parseFloat(v))
+        .option("--json", "JSON output (signed)")
+        .action((opts) => {
+        const cwd = process.cwd();
+        const mission = { goal: opts.mission, scopeGlobs: splitList(opts.scope), keywords: splitList(opts.keywords) };
+        const actions = readActions(opts.actions);
+        const r = drift.analyzeDrift(mission, actions, opts.lambda !== undefined ? { lambda: opts.lambda } : undefined);
+        let receipt = null;
+        try {
+            receipt = notary.issueReceipt(cwd, { kind: "claim-verdict", subject: `drift:${r.band}`, payload: { band: r.band, driftScore: r.driftScore, ucl: r.ucl, firstBreachTurn: r.firstBreachTurn }, includePayload: true });
+        }
+        catch { /* */ }
+        if (opts.json) {
+            out(JSON.stringify({ ...r, signed: receipt }, null, 2));
+            process.exitCode = r.band === "DIVERGENT" ? 2 : 0;
+            return;
+        }
+        const icon = r.band === "DIVERGENT" ? "🛑" : r.band === "DRIFTING" ? "🟡" : r.band === "STABLE" ? "🟢" : "❔";
+        out(`${icon} MISSION DRIFT — ${r.band}`);
+        if (r.band === "UNKNOWN") {
+            out(`   ${r.reasons[0] ?? "not enough data"}`);
+            out(`   ${r.note}`);
+            process.exitCode = 0;
+            return;
+        }
+        out(`   EWMA ${r.driftScore} vs baseline ${r.baseline.mean} · UCL ${r.ucl} · breaches ${r.breachCount}${r.firstBreachTurn !== null ? ` (first @ turn ${r.firstBreachTurn})` : ""}`);
+        out(`   chart: ${sparkline(r.series, r.ucl)}`);
+        for (const reason of r.reasons)
+            out(`   • ${reason}`);
+        if (r.offMissionRecent.length) {
+            out("   off-mission actions:");
+            for (const a of r.offMissionRecent)
+                out(`     t${a.turn} (${a.score}) ${a.summary}`);
+        }
+        out(`   ${receipt ? "✓ signed · " : ""}${r.note}`);
+        process.exitCode = r.band === "DIVERGENT" ? 2 : 0;
+    });
+}
+//# sourceMappingURL=drift.js.map

package/dist/commands/drift.js.map

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

package/dist/index.js

@@ -96,6 +96,7 @@ import { registerAxiaCommands } from "./commands/axia.js";
 import { registerPceCommands } from "./commands/pce.js";
 import { registerHauntCommands } from "./commands/haunt.js";
 import { registerCrucibleCommands } from "./commands/crucible.js";
+import { registerDriftCommands } from "./commands/drift.js";
 import { attachRegretOracle } from "./commands/regret.js";
 import { registerTrustCommands } from "./commands/trust.js";
 import { registerNuclearCommands } from "./commands/nuclear-cli.js";
@@ -4745,6 +4746,7 @@ export async function run(argv) {
     registerPceCommands(program);
     registerHauntCommands(program);
     registerCrucibleCommands(program);
+    registerDriftCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);
     // ─── Wisdom reactor (v1.33.0) -- five nuclear-physics formulas as Mneme metrics