mneme-ai 3.133.0 → 3.134.0

package/dist/commands/ctx.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `mneme ctx` (v3.134.0) — THE CONTEXT PASSPORT: the cross-agent verified context
+ * layer that lives in git (`.mneme/passport/*.jsonl`). Any agent (any vendor)
+ * inherits what others learned — screened for poison/injection first — and
+ * contributes back, signed. Portable · vendor-neutral · local-first · trustworthy.
+ *
+ *   mneme ctx contribute --kind decision --text "chose X" --cite a1b2c3,src/x.ts:4
+ *   mneme ctx inherit          # the screened, trusted context an agent reads
+ *   mneme ctx status
+ */
+import type { Command } from "commander";
+export declare function registerCtxCommands(program: Command): void;
+//# sourceMappingURL=ctx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ctx.d.ts","sourceRoot":"","sources":["../../src/commands/ctx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC1D"}

package/dist/commands/ctx.js

@@ -0,0 +1,93 @@
+/**
+ * `mneme ctx` (v3.134.0) — THE CONTEXT PASSPORT: the cross-agent verified context
+ * layer that lives in git (`.mneme/passport/*.jsonl`). Any agent (any vendor)
+ * inherits what others learned — screened for poison/injection first — and
+ * contributes back, signed. Portable · vendor-neutral · local-first · trustworthy.
+ *
+ *   mneme ctx contribute --kind decision --text "chose X" --cite a1b2c3,src/x.ts:4
+ *   mneme ctx inherit          # the screened, trusted context an agent reads
+ *   mneme ctx status
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { contextPassport, notary } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+const DIR = () => join(process.cwd(), ".mneme", "passport");
+function readAll() {
+    const acc = [];
+    const d = DIR();
+    try {
+        if (!existsSync(d))
+            return [];
+        for (const f of readdirSync(d)) {
+            if (!f.endsWith(".jsonl"))
+                continue;
+            for (const line of readFileSync(join(d, f), "utf8").split("\n")) {
+                if (line.trim()) {
+                    try {
+                        acc.push(JSON.parse(line));
+                    }
+                    catch { /* skip */ }
+                }
+            }
+        }
+    }
+    catch { /* */ }
+    return acc;
+}
+export function registerCtxCommands(program) {
+    const c = program
+        .command("ctx")
+        .alias("context-passport")
+        .description("🛂 CONTEXT PASSPORT — the cross-agent verified-context layer in git (.mneme/passport). Any agent (any vendor) inherits what others learned (poison-screened first) + contributes back, signed. Portable · vendor-neutral · local-first · trustworthy. TRUST-precision 1.0 — a poisoned/injected entry is NEVER inherited.");
+    c.command("contribute")
+        .description("append a signed context entry the next agent (any vendor) can inherit")
+        .requiredOption("--kind <k>", "decision | finding | dead-end | constraint")
+        .requiredOption("--text <t>", "the context to record")
+        .option("--cite <list>", "comma-separated commit hashes / file:line that ground it", "")
+        .option("--agent <name>", "your agent/tool id", "cli")
+        .action((o) => {
+        const kind = (["decision", "finding", "dead-end", "constraint"].includes(o.kind) ? o.kind : "finding");
+        const cites = o.cite ? o.cite.split(",").map((s) => s.trim()).filter(Boolean) : [];
+        const entry = contextPassport.makeEntry(o.agent, kind, o.text, cites, Math.floor(Date.now() / 1000));
+        const screen = contextPassport.trustScreen(entry);
+        let sig = null;
+        try {
+            sig = notary.issueReceipt(process.cwd(), { kind: "claim-verdict", subject: `ctx:${entry.kind}:${entry.id}`, payload: { id: entry.id }, includePayload: true });
+        }
+        catch { /* */ }
+        try {
+            mkdirSync(DIR(), { recursive: true });
+            const f = join(DIR(), o.agent.replace(/[^A-Za-z0-9._-]/g, "_") + ".jsonl");
+            const prev = existsSync(f) ? readFileSync(f, "utf8") : "";
+            writeFileSync(f, prev + JSON.stringify({ ...entry, sig }) + "\n");
+        }
+        catch { /* */ }
+        out(`🛂 recorded ${entry.kind} (${entry.id}) — ${screen.trust ? "✓ will be inherited as TRUSTED" : "⚠ would be QUARANTINED: " + screen.reason}`);
+        out(`   commit .mneme/passport so the next agent (any vendor) inherits it.`);
+    });
+    c.command("inherit")
+        .description("the screened, trusted context an agent should read at task start (poison quarantined)")
+        .option("--json", "JSON output")
+        .action((o) => {
+        const r = contextPassport.inheritPassport(readAll());
+        if (o.json) {
+            out(JSON.stringify(r, null, 2));
+            return;
+        }
+        out(`🛂 CONTEXT PASSPORT — ${r.summary.trusted} trusted · ${r.summary.quarantined} quarantined (of ${r.summary.total})`);
+        if (!r.summary.total) {
+            out("   (empty — contribute: mneme ctx contribute --kind decision --text \"…\" --cite <commit>)");
+            return;
+        }
+        for (const e of r.trusted.slice(0, 20))
+            out(`   ✓ [${e.kind}] ${e.text}  ⟨${e.agent} · ${e.citations.join(", ")}⟩`);
+        for (const q of r.quarantined.slice(0, 8))
+            out(`   ⚠ QUARANTINED [${q.entry.kind}] ${q.entry.text.slice(0, 56)} — ${q.reason}`);
+    });
+    c.command("status").description("passport counts").action(() => {
+        const r = contextPassport.inheritPassport(readAll());
+        out(`🛂 ${r.summary.total} entries · ${r.summary.trusted} trusted · ${r.summary.quarantined} quarantined · dir .mneme/passport`);
+    });
+}
+//# sourceMappingURL=ctx.js.map

package/dist/commands/ctx.js.map

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

package/dist/index.js

@@ -136,6 +136,7 @@ import { registerPersonaCommands } from "./commands/persona.js";
 import { registerSeanceCommands } from "./commands/seance.js";
 import { registerBriefCommands } from "./commands/brief.js";
 import { registerPrCommentCommands } from "./commands/pr-comment.js";
+import { registerCtxCommands } from "./commands/ctx.js";
 import { registerMoatCommands } from "./commands/moat.js";
 import { attachRegretOracle } from "./commands/regret.js";
 import { registerTrustCommands } from "./commands/trust.js";
@@ -4829,6 +4830,7 @@ export async function run(argv) {
     registerSeanceCommands(program);
     registerBriefCommands(program);
     registerPrCommentCommands(program);
+    registerCtxCommands(program);
     registerMoatCommands(program);
     // ─── Trust calibrator (v1.31.0) -- per-subsystem precision/recall/band
     registerTrustCommands(program);