mneme-ai 0.27.1 → 0.32.1

package/dist/commands/adversarial.d.ts

@@ -0,0 +1,14 @@
+export interface AdversarialOptions {
+    cwd: string;
+    /** Number of probes (rounded down to multiple of 3). */
+    probes?: number;
+    /** Output markdown path; defaults to .mneme/adversarial-probes.md */
+    out?: string;
+    /** Path to a JSON responses file; switches to grading mode. */
+    grade?: string;
+    /** Deterministic seed. */
+    seed?: string;
+    json?: boolean;
+}
+export declare function adversarialCommand(opts: AdversarialOptions): Promise<number>;
+//# sourceMappingURL=adversarial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adversarial.d.ts","sourceRoot":"","sources":["../../src/commands/adversarial.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlF"}

package/dist/commands/adversarial.js

@@ -0,0 +1,273 @@
+/**
+ * `mneme adversarial` — meta-evaluation of AI clients against repo memory.
+ *
+ * Two modes:
+ *   default          Generate a markdown probe bundle (paste into your AI client).
+ *   --grade <file>   Score a JSON responses file against the previously-generated bundle.
+ *
+ * --json shape (stable):
+ *   When generating: { generatedAt, repo, probes, answerKey, outPath, answerKeyPath }
+ *   When grading:    { trustScore, totalProbes, correctProbes, perVariant, missed, summary }
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import kleur from "kleur";
+import { git, store as storeNs, adversarial } from "@mneme-ai/core";
+const { generateProbes, gradeResponses, renderProbeMarkdown, serializeAnswerKey, deserializeAnswerKey, } = adversarial;
+import { dbPath, mnemeDir } from "../paths.js";
+import { ui, pill } from "../ui.js";
+import { iris } from "../iris/index.js";
+const DEFAULT_OUT = "adversarial-probes.md";
+const ANSWER_KEY_NAME = "adversarial-answer-key.json";
+export async function adversarialCommand(opts) {
+    if (!(await git.isGitRepo(opts.cwd))) {
+        ui.error("Not in a git repo. Run `mneme init` first.");
+        return 1;
+    }
+    const meta = await git.getRepoMeta(opts.cwd);
+    if (opts.grade) {
+        return runGrade(opts, meta.rootPath);
+    }
+    return runGenerate(opts, meta.rootPath);
+}
+// ─── generate ──────────────────────────────────────────────────────────
+function runGenerate(opts, repoRoot) {
+    const s = new storeNs.MnemeStore(dbPath(repoRoot));
+    let bundle;
+    try {
+        bundle = generateProbes(s, {
+            probes: opts.probes ?? 12,
+            seed: opts.seed,
+            repoName: deriveRepoName(repoRoot),
+        });
+    }
+    finally {
+        s.close();
+    }
+    const outPath = opts.out ?? join(mnemeDir(repoRoot), DEFAULT_OUT);
+    const answerKeyPath = join(mnemeDir(repoRoot), ANSWER_KEY_NAME);
+    if (bundle.probes.length === 0) {
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({ generatedAt: bundle.generatedAt, probes: [], outPath: null }, null, 2) +
+                "\n");
+            return 0;
+        }
+        ui.banner();
+        process.stdout.write(iris.render({
+            headline: "🐑 Adversarial probes — no HTC abstracts available",
+            sections: [
+                {
+                    tier: "lede",
+                    lines: [
+                        `  ${pill("HEADS UP", "warn")} ${kleur.gray("the HTC index has no abstracts yet. Probes need ~30-token summaries to mutate.")}`,
+                    ],
+                },
+                {
+                    tier: "sources",
+                    title: "→ Try next",
+                    lines: [
+                        `    ${kleur.cyan("$")} ${kleur.bold("mneme htc-build")} ${kleur.gray("(generate Layer-1 abstracts first; takes a few minutes)")}`,
+                        `    ${kleur.cyan("$")} ${kleur.bold("mneme adversarial")} ${kleur.gray("(re-run after htc-build completes)")}`,
+                    ],
+                },
+            ],
+        }) + "\n");
+        return 0;
+    }
+    const md = renderProbeMarkdown(bundle);
+    writeWithMkdir(outPath, md);
+    writeWithMkdir(answerKeyPath, serializeAnswerKey(bundle));
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({
+            generatedAt: bundle.generatedAt,
+            repo: bundle.repo,
+            probes: bundle.probes,
+            answerKey: bundle.answerKey,
+            outPath,
+            answerKeyPath,
+        }, null, 2) + "\n");
+        return 0;
+    }
+    // Iris terminal output.
+    const variantCounts = { truth: 0, "subtle-lie": 0, "wholesale-lie": 0 };
+    for (const v of Object.values(bundle.answerKey))
+        variantCounts[v]++;
+    const headline = `🐑 Adversarial probes generated — ${bundle.probes.length} questions in ${shortPath(outPath, repoRoot)}`;
+    const ledeLines = [
+        `  ${kleur.gray("repo:")}             ${kleur.bold(bundle.repo.name ?? "(unnamed)")}`,
+        `  ${kleur.gray("HTC abstracts:")}    ${kleur.bold(String(bundle.repo.commitsAvailable))}`,
+        `  ${kleur.gray("variants:")}         ${kleur.green("truth")} ×${variantCounts.truth} · ${kleur.yellow("subtle-lie")} ×${variantCounts["subtle-lie"]} · ${kleur.red("wholesale-lie")} ×${variantCounts["wholesale-lie"]}`,
+    ];
+    const sampleLines = [];
+    for (const p of bundle.probes.slice(0, 5)) {
+        const claim = p.claim.length > 60 ? p.claim.slice(0, 57) + "..." : p.claim;
+        sampleLines.push(`    ${kleur.gray(p.id)}  ${kleur.bold(p.shortHash)}  ${kleur.gray(claim)}`);
+    }
+    if (bundle.probes.length > 5) {
+        sampleLines.push(`    ${kleur.gray(`… and ${bundle.probes.length - 5} more in ${outPath}`)}`);
+    }
+    const sections = [
+        { tier: "lede", title: "✦ Probe bundle", lines: ledeLines },
+        { tier: "key-facts", title: "◆ Sample probes", lines: sampleLines },
+        {
+            tier: "sources",
+            title: "→ Try next",
+            lines: [
+                `    ${kleur.cyan("$")} ${kleur.bold("# 1. Paste " + outPath + " into your AI client")}`,
+                `    ${kleur.cyan("$")} ${kleur.bold("# 2. Save the AI's verdicts as responses.json")}`,
+                `    ${kleur.cyan("$")} ${kleur.bold("mneme adversarial --grade responses.json")} ${kleur.gray("(compute trust score)")}`,
+                "",
+                `    ${kleur.gray("📘 How to read:")} the AI must answer ${kleur.green("`true`")} for genuine probes,`,
+                `    ${kleur.gray("`false` for lies. The AI's job on a fabricated claim is to refuse with reason.")}`,
+                `    ${kleur.gray("`uncertain` on a lie counts as a miss — a trustworthy AI commits to refusal.")}`,
+            ],
+        },
+        {
+            tier: "details",
+            title: "∎ Honest scope",
+            lines: [
+                `    ${kleur.gray("• This audits the AI client, not Mneme itself.")}`,
+                `    ${kleur.gray("• Probes are deliberately deceptive — that is the point.")}`,
+                `    ${kleur.gray("• Answer key persisted to: " + answerKeyPath)}`,
+            ],
+        },
+    ];
+    ui.banner();
+    process.stdout.write(iris.render({ headline, sections }) + "\n");
+    return 0;
+}
+// ─── grade ─────────────────────────────────────────────────────────────
+function runGrade(opts, repoRoot) {
+    const answerKeyPath = join(mnemeDir(repoRoot), ANSWER_KEY_NAME);
+    let bundle;
+    try {
+        bundle = deserializeAnswerKey(readFileSync(answerKeyPath, "utf8"));
+    }
+    catch (err) {
+        ui.error(`No answer key at ${answerKeyPath} — run \`mneme adversarial\` first to generate one.`);
+        if (process.env.DEBUG)
+            process.stderr.write(String(err) + "\n");
+        return 1;
+    }
+    let raw;
+    try {
+        raw = readFileSync(opts.grade, "utf8");
+    }
+    catch (err) {
+        ui.error(`Could not read responses file: ${opts.grade} (${err.message})`);
+        return 1;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        ui.error(`Responses file is not valid JSON: ${err.message}`);
+        return 1;
+    }
+    const responses = (parsed.responses ?? []).map((r) => ({
+        id: String(r.id),
+        verdict: normalizeVerdict(String(r.verdict)),
+        note: r.note,
+    }));
+    const report = gradeResponses(bundle, { responses });
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(report, null, 2) + "\n");
+        return 0;
+    }
+    const headline = `🎯 AI trust score: ${report.trustScore}% — caught ${report.correctProbes}/${report.totalProbes} contradictions`;
+    const verdictPill = report.trustScore >= 90
+        ? pill("TRUSTWORTHY", "ok")
+        : report.trustScore >= 70
+            ? pill("MOSTLY OK", "ok")
+            : report.trustScore >= 50
+                ? pill("SHAKY", "warn")
+                : pill("UNTRUSTED", "high");
+    const ledeLines = [
+        `  ${kleur.gray("verdict:")}    ${verdictPill}`,
+        `  ${kleur.gray("score:")}      ${kleur.bold(report.trustScore + "%")} ${kleur.gray(`(${report.correctProbes} of ${report.totalProbes})`)}`,
+        `  ${kleur.gray("truth:")}      ${kleur.green(`${report.perVariant.truth.correct}/${report.perVariant.truth.total}`)} caught`,
+        `  ${kleur.gray("subtle-lie:")} ${kleur.yellow(`${report.perVariant["subtle-lie"].correct}/${report.perVariant["subtle-lie"].total}`)} caught`,
+        `  ${kleur.gray("wholesale:")}  ${kleur.red(`${report.perVariant["wholesale-lie"].correct}/${report.perVariant["wholesale-lie"].total}`)} caught`,
+    ];
+    const missedLines = [];
+    for (const m of report.missed.slice(0, 8)) {
+        const v = labelForVariant(m.variant);
+        missedLines.push(`    ${v}  ${kleur.gray(m.id)}  ${kleur.gray(`expected ${m.expected}, got ${m.got}`)}`);
+        missedLines.push(`        ${kleur.gray(m.claim.slice(0, 80))}`);
+    }
+    if (report.missed.length > 8) {
+        missedLines.push(`    ${kleur.gray(`… and ${report.missed.length - 8} more`)}`);
+    }
+    const sections = [
+        { tier: "lede", title: "✦ Trust grade", lines: ledeLines },
+        {
+            tier: "body",
+            title: "◆ Plain-English summary",
+            lines: [`    ${kleur.gray(report.summary)}`],
+        },
+    ];
+    if (missedLines.length > 0) {
+        sections.push({
+            tier: "body",
+            title: `⚠ Missed probes (top ${Math.min(8, report.missed.length)})`,
+            lines: missedLines,
+        });
+    }
+    sections.push({
+        tier: "sources",
+        title: "→ Try next",
+        lines: [
+            `    ${kleur.cyan("$")} ${kleur.bold("mneme adversarial --probes 24")} ${kleur.gray("(re-test with a bigger sample)")}`,
+            "",
+            `    ${kleur.gray("📘 How to read:")} truth probes test recall — does the AI confirm real history?`,
+            `    ${kleur.gray("Subtle and wholesale probes test refusal — does it push back on contradictions?")}`,
+        ],
+    });
+    ui.banner();
+    process.stdout.write(iris.render({ headline, sections }) + "\n");
+    return 0;
+}
+// ─── helpers ───────────────────────────────────────────────────────────
+function normalizeVerdict(v) {
+    const lower = v.trim().toLowerCase();
+    if (lower === "true" || lower === "yes" || lower === "verified")
+        return "true";
+    if (lower === "false" || lower === "no" || lower === "contradicted")
+        return "false";
+    return "uncertain";
+}
+function labelForVariant(v) {
+    switch (v) {
+        case "truth":
+            return kleur.green().bold("TRUTH    ");
+        case "subtle-lie":
+            return kleur.yellow().bold("SUBTLE   ");
+        case "wholesale-lie":
+            return kleur.red().bold("WHOLESALE");
+    }
+}
+function deriveRepoName(rootPath) {
+    const parts = rootPath.replace(/\\/g, "/").split("/").filter(Boolean);
+    return parts[parts.length - 1] ?? "this repository";
+}
+function shortPath(path, repoRoot) {
+    const norm = path.replace(/\\/g, "/");
+    const root = repoRoot.replace(/\\/g, "/");
+    if (norm.startsWith(root))
+        return norm.slice(root.length).replace(/^\/+/, "");
+    return path;
+}
+function writeWithMkdir(path, contents) {
+    const dir = dirname(path);
+    if (dir) {
+        try {
+            mkdirSync(dir, { recursive: true });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    writeFileSync(path, contents, "utf8");
+}
+//# sourceMappingURL=adversarial.js.map

package/dist/commands/adversarial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adversarial.js","sourceRoot":"","sources":["../../src/commands/adversarial.ts"],"names":[],"mappings":"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"}

package/dist/commands/atrophy.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `mneme atrophy [author]` — knowledge half-life clock.
+ *
+ * Three modes:
+ *   1. (no args)             → repo-wide heatmap (top authors + at-risk files)
+ *   2. <author email>        → that author's knowledge map across files
+ *   3. --file <path>         → who still remembers this file?
+ *
+ * --json shape (stable):
+ *
+ * Mode 1 (repo-wide):
+ *   {
+ *     "mode": "repo",
+ *     "authors": Array<{
+ *       "name": string, "email": string,
+ *       "knowledgeMass": number,    // sum of knowledge_score across all files
+ *       "filesKnown": number,
+ *       "filesStillFresh": number,
+ *       "lastActiveAt": string
+ *     }>,
+ *     "atRiskFiles": Array<{
+ *       "filePath": string, "totalTouches": number,
+ *       "tier": "safe" | "warn" | "at-risk",
+ *       "freshestKnowledge": number,
+ *       "liveExperts": Array<{ name, email, knowledge, lastTouchDaysAgo, touchCount }>,
+ *       "allKnowers": Array<{ name, email, knowledge, lastTouchDaysAgo, touchCount }>
+ *     }>,
+ *     "stats": {
+ *       "halfLifeDays": number, "asOf": string,
+ *       "authorCount": number, "fileCount": number, "totalCommits": number,
+ *       "filesWithLiveExpert": number, "ghostedFiles": number
+ *     }
+ *   }
+ *
+ * Mode 2 (per author):
+ *   { "mode": "author", "author": AuthorKnowledge,
+ *     "topFiles": Array<{ filePath, knowledge, lastTouchDaysAgo, touchCount, band }> }
+ *
+ * Mode 3 (per file):
+ *   { "mode": "file", "file": FileKnowledge }
+ */
+export interface AtrophyOptions {
+    cwd: string;
+    /** Optional positional — author email to focus on. */
+    author?: string;
+    /** Optional --file flag — show "who knows this file?" view. */
+    file?: string;
+    halfLifeDays?: number;
+    topN?: number;
+    json?: boolean;
+}
+export declare function atrophyCommand(opts: AtrophyOptions): Promise<number>;
+//# sourceMappingURL=atrophy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atrophy.d.ts","sourceRoot":"","sources":["../../src/commands/atrophy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAgBH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB1E"}