@mneme-ai/core 0.9.0 → 0.11.0

package/dist/insights/ghost.test.js

@@ -0,0 +1,141 @@
+import { describe, it, expect } from "vitest";
+import { buildGhostReport } from "./ghost.js";
+const NOW = new Date("2026-05-05").getTime();
+function mk(p) {
+    return {
+        hash: p.hash,
+        shortHash: p.hash.slice(0, 7),
+        authorName: "Test",
+        authorEmail: "t@e.com",
+        authorDate: p.date,
+        committerDate: p.date,
+        subject: p.subject,
+        body: p.body ?? "",
+        files: p.files ?? [],
+        parents: [],
+    };
+}
+function mkChange(commitHash, path) {
+    return { commitHash, path, changeKind: "M", insertions: 5, deletions: 0 };
+}
+describe("buildGhostReport", () => {
+    it("returns empty when no commits or changes", () => {
+        const r = buildGhostReport([], [], { nowMs: NOW });
+        expect(r.ghostFiles).toHaveLength(0);
+        expect(r.staleTodos).toHaveLength(0);
+        expect(r.totalFiles).toBe(0);
+    });
+    it("identifies a long-untouched file as a ghost", () => {
+        const c = mk({ hash: "a1", date: "2024-01-01", subject: "add legacy thing" });
+        const ch = [mkChange("a1", "src/legacy.ts")];
+        const r = buildGhostReport([c], ch, { nowMs: NOW, staleDays: 180, minGhostliness: 0.4 });
+        const ghost = r.ghostFiles.find((g) => g.path === "src/legacy.ts");
+        expect(ghost).toBeDefined();
+        expect(ghost.daysSinceLastTouch).toBeGreaterThan(180);
+    });
+    it("does not flag actively-edited files as ghosts", () => {
+        const commits = Array.from({ length: 12 }, (_, i) => mk({
+            hash: `c${i}`,
+            date: `2026-04-${(i + 1).toString().padStart(2, "0")}`,
+            subject: `evolve module`,
+            files: ["src/active.ts"],
+        }));
+        const changes = commits.map((c) => mkChange(c.hash, "src/active.ts"));
+        const r = buildGhostReport(commits, changes, { nowMs: NOW, minGhostliness: 0.4 });
+        const ghost = r.ghostFiles.find((g) => g.path === "src/active.ts");
+        expect(ghost).toBeUndefined();
+    });
+    it("boosts ghostliness via TODO density", () => {
+        const c1 = mk({ hash: "a1", date: "2024-01-01", subject: "scaffold" });
+        const c2 = mk({ hash: "a2", date: "2024-01-15", subject: "TODO: finish error handling" });
+        const ch = [mkChange("a1", "src/half.ts"), mkChange("a2", "src/half.ts")];
+        const r = buildGhostReport([c1, c2], ch, {
+            nowMs: NOW,
+            staleDays: 180,
+            todoCounts: new Map([["src/half.ts", 5]]),
+            minGhostliness: 0.4,
+        });
+        const ghost = r.ghostFiles.find((g) => g.path === "src/half.ts");
+        expect(ghost).toBeDefined();
+        expect(ghost.todoCount).toBe(5);
+    });
+    it("detects stale TODOs from commit history", () => {
+        const c1 = mk({ hash: "a1", date: "2024-01-01", subject: "TODO: add validation" });
+        const c2 = mk({ hash: "a2", date: "2024-06-01", subject: "minor formatting" });
+        const c3 = mk({ hash: "a3", date: "2024-12-01", subject: "another tweak" });
+        const ch = [
+            mkChange("a1", "src/feat.ts"),
+            mkChange("a2", "src/feat.ts"),
+            mkChange("a3", "src/feat.ts"),
+        ];
+        const r = buildGhostReport([c1, c2, c3], ch, {
+            nowMs: NOW,
+            todoStaleDays: 90,
+        });
+        expect(r.staleTodos.length).toBeGreaterThanOrEqual(1);
+        expect(r.staleTodos[0].ignoredCount).toBeGreaterThanOrEqual(1);
+    });
+    it("ghostliness is bounded to 0..1", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2020-01-01", subject: "ancient" }),
+        ];
+        const ch = [mkChange("a1", "src/dust.ts")];
+        const r = buildGhostReport(commits, ch, {
+            nowMs: NOW,
+            todoCounts: new Map([["src/dust.ts", 100]]),
+            minGhostliness: 0,
+        });
+        for (const g of r.ghostFiles) {
+            expect(g.ghostliness).toBeGreaterThanOrEqual(0);
+            expect(g.ghostliness).toBeLessThanOrEqual(1);
+        }
+    });
+    it("orders ghostFiles by ghostliness descending", () => {
+        const commits = [
+            mk({ hash: "old", date: "2020-01-01", subject: "very old" }),
+            mk({ hash: "med", date: "2024-08-01", subject: "medium age" }),
+            mk({ hash: "fresh", date: "2026-04-01", subject: "fresh" }),
+        ];
+        const ch = [
+            mkChange("old", "src/old.ts"),
+            mkChange("med", "src/med.ts"),
+            mkChange("fresh", "src/fresh.ts"),
+        ];
+        const r = buildGhostReport(commits, ch, {
+            nowMs: NOW,
+            staleDays: 180,
+            minGhostliness: 0,
+        });
+        for (let i = 1; i < r.ghostFiles.length; i++) {
+            expect(r.ghostFiles[i - 1].ghostliness).toBeGreaterThanOrEqual(r.ghostFiles[i].ghostliness);
+        }
+    });
+    it("reports averageGhostliness across all files", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2020-01-01", subject: "ancient" }),
+            mk({ hash: "a2", date: "2026-04-01", subject: "fresh" }),
+        ];
+        const ch = [mkChange("a1", "src/a.ts"), mkChange("a2", "src/b.ts")];
+        const r = buildGhostReport(commits, ch, { nowMs: NOW, minGhostliness: 0 });
+        expect(r.averageGhostliness).toBeGreaterThan(0);
+        expect(r.averageGhostliness).toBeLessThanOrEqual(1);
+    });
+    it("produces a non-empty reason for every ghost", () => {
+        const commits = [
+            mk({ hash: "a1", date: "2020-01-01", subject: "ancient" }),
+        ];
+        const ch = [mkChange("a1", "src/dusty.ts")];
+        const r = buildGhostReport(commits, ch, { nowMs: NOW, minGhostliness: 0 });
+        for (const g of r.ghostFiles) {
+            expect(g.reason.length).toBeGreaterThan(0);
+        }
+    });
+    it("does not flag stale TODO unless ignored at least once", () => {
+        const c1 = mk({ hash: "a1", date: "2020-01-01", subject: "TODO: clean this up" });
+        const ch = [mkChange("a1", "src/only.ts")];
+        const r = buildGhostReport([c1], ch, { nowMs: NOW, todoStaleDays: 90 });
+        // The TODO commit is the only touch — ignoredCount = 0, should not appear
+        expect(r.staleTodos.find((t) => t.filePath === "src/only.ts")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=ghost.test.js.map

package/dist/insights/ghost.test.js.map

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

package/dist/insights/index.d.ts

@@ -13,4 +13,12 @@ export * from "./story.js";
 export * from "./dream.js";
 export * from "./suggest.js";
 export * from "./obsidian.js";
+export * from "./regret.js";
+export * from "./bus-factor.js";
+export * from "./paradox.js";
+export * from "./commit-coach.js";
+export * from "./crystal-ball.js";
+export * from "./time-machine.js";
+export * from "./premortem.js";
+export * from "./ghost.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/insights/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/insights/index.js

@@ -13,4 +13,12 @@ export * from "./story.js";
 export * from "./dream.js";
 export * from "./suggest.js";
 export * from "./obsidian.js";
+export * from "./regret.js";
+export * from "./bus-factor.js";
+export * from "./paradox.js";
+export * from "./commit-coach.js";
+export * from "./crystal-ball.js";
+export * from "./time-machine.js";
+export * from "./premortem.js";
+export * from "./ghost.js";
 //# sourceMappingURL=index.js.map

package/dist/insights/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/insights/paradox.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `mneme paradox` — find architectural flip-flops in commit history.
+ *
+ * A "flip-flop" is a chain of decisions on the same topic where the
+ * direction reverses: A → B → A. This usually means the team forgot
+ * (or never wrote down) WHY they made the original decision.
+ *
+ * Implementation: walk decisions chronologically, group by topic
+ * (heuristically clustered by key terms), and detect ABA-style
+ * chains. Conservative — only emit when confidence is high that
+ * the decisions are actually about the same thing.
+ *
+ * Pure data analysis. No LLM. The CLI renders.
+ */
+import type { ExtractedDecision } from "./decisions.js";
+export interface FlipFlop {
+    /** Topic label — extracted from the shared keyword(s). */
+    topic: string;
+    /** The chain of decisions, oldest first. */
+    chain: ExtractedDecision[];
+    /** How many direction reversals (0 = no flip, 1 = one flip, 2 = ABA). */
+    flips: number;
+    /** Months between first and last decision in the chain. */
+    spanMonths: number;
+    /** A 1-line interpretation. */
+    question: string;
+}
+/**
+ * Detect flip-flops across a list of decisions.
+ *
+ * Returns groups with ≥ 1 flip — the actual paradoxes worth investigating.
+ * Groups with 2+ decisions but no flips (just continuous progress) are
+ * suppressed.
+ */
+export declare function detectParadoxes(decisions: ExtractedDecision[]): FlipFlop[];
+//# sourceMappingURL=paradox.d.ts.map

package/dist/insights/paradox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paradox.d.ts","sourceRoot":"","sources":["../../src/insights/paradox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqJD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,QAAQ,EAAE,CA2B1E"}

package/dist/insights/paradox.js

@@ -0,0 +1,201 @@
+/**
+ * `mneme paradox` — find architectural flip-flops in commit history.
+ *
+ * A "flip-flop" is a chain of decisions on the same topic where the
+ * direction reverses: A → B → A. This usually means the team forgot
+ * (or never wrote down) WHY they made the original decision.
+ *
+ * Implementation: walk decisions chronologically, group by topic
+ * (heuristically clustered by key terms), and detect ABA-style
+ * chains. Conservative — only emit when confidence is high that
+ * the decisions are actually about the same thing.
+ *
+ * Pure data analysis. No LLM. The CLI renders.
+ */
+/**
+ * Stop-words that should NOT count as "topic" — too generic.
+ * Add to this set when noise topics appear in real-world repos.
+ */
+const TOPIC_STOPWORDS = new Set([
+    "the", "a", "an", "to", "from", "for", "with", "of", "in", "on", "at",
+    "and", "or", "but", "is", "are", "was", "were",
+    "use", "used", "using", "make", "made",
+    "new", "old", "all", "more", "less",
+    "code", "thing", "stuff", "function", "method", "class", "module",
+    "version", "feature", "patch",
+]);
+/**
+ * Extract topic keywords from a decision summary. Keeps only the
+ * meaningful nouns/identifiers (filtering verbs and stop-words).
+ */
+function extractTopicKeywords(summary) {
+    const lower = summary.toLowerCase();
+    // Tokenize: split on non-alphanumeric, keep words ≥ 3 chars.
+    const tokens = lower
+        .replace(/[^\w\s./-]+/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length >= 3 && !TOPIC_STOPWORDS.has(t));
+    // Also exclude transition verbs that won't help cluster.
+    const VERB_BLOCKLIST = new Set([
+        "decided", "switch", "switched", "switching", "from",
+        "replace", "replaced", "with", "over", "instead",
+        "adopt", "adopted", "adopting",
+        "deprecate", "deprecated", "deprecating",
+        "migrate", "migrated", "migrating",
+        "reject", "rejected",
+        "choose", "chose", "chosen",
+    ]);
+    return tokens.filter((t) => !VERB_BLOCKLIST.has(t));
+}
+/**
+ * Group decisions by overlapping topic keywords. Two decisions belong
+ * to the same group if they share ≥ 1 meaningful keyword.
+ */
+function groupByTopic(decisions) {
+    const decisionKeywords = decisions.map((d) => ({
+        decision: d,
+        keywords: new Set(extractTopicKeywords(d.summary)),
+    }));
+    // Union-find by shared keyword.
+    const groups = [];
+    for (const item of decisionKeywords) {
+        let placed = false;
+        for (const g of groups) {
+            // Share at least one keyword?
+            let shared = false;
+            for (const k of item.keywords) {
+                if (g.keywords.has(k)) {
+                    shared = true;
+                    break;
+                }
+            }
+            if (shared) {
+                g.decisions.push(item.decision);
+                for (const k of item.keywords)
+                    g.keywords.add(k);
+                placed = true;
+                break;
+            }
+        }
+        if (!placed) {
+            groups.push({ keywords: new Set(item.keywords), decisions: [item.decision] });
+        }
+    }
+    // Pick a label per group — the keyword that appears in the most decisions
+    // of the group (the "common thread"). Ties broken by length.
+    const out = new Map();
+    for (const g of groups) {
+        if (g.decisions.length < 2)
+            continue; // need at least 2 decisions to flip
+        const label = pickLabel(g.decisions);
+        if (out.has(label)) {
+            // Merge into existing — multiple groups can hash to the same label.
+            out.get(label).push(...g.decisions);
+        }
+        else {
+            out.set(label, g.decisions);
+        }
+    }
+    return out;
+}
+/** Label = the keyword that occurs in the most decisions of the chain. */
+function pickLabel(decisions) {
+    const freq = new Map();
+    for (const d of decisions) {
+        const kws = new Set(extractTopicKeywords(d.summary));
+        for (const k of kws)
+            freq.set(k, (freq.get(k) ?? 0) + 1);
+    }
+    if (freq.size === 0)
+        return "(unnamed)";
+    return [...freq.entries()].sort((a, b) => b[1] - a[1] || b[0].length - a[0].length)[0][0];
+}
+/**
+ * Extract the *destination* keywords of a decision — the noun being
+ * switched/decided TO. This is the "side" that the decision is choosing.
+ *
+ * For "switched from X to Y" we want Y.
+ * For "decided to use Z" we want Z.
+ * For "adopted W" we want W.
+ */
+function destinationKeywords(d) {
+    const summary = d.summary.toLowerCase();
+    // Match the LAST " to X" clause (closest to end of string).
+    // Pattern: "to" surrounded by spaces, then everything to end.
+    const toMatch = summary.match(/\bto\s+(.+)$/);
+    if (toMatch) {
+        return new Set(extractTopicKeywords(toMatch[1]));
+    }
+    // No "to" — fall back to keywords from the whole summary.
+    return new Set(extractTopicKeywords(summary));
+}
+/**
+ * Count flips in a chronologically-sorted decision chain.
+ *
+ * A "flip" is an ABA pattern — at index i, a destination keyword X appears,
+ * disappears in i+1, and reappears in i+2. The team chose X, switched away,
+ * then went back. That's exactly the "we keep flip-flopping" anti-pattern.
+ */
+function countFlips(chain) {
+    if (chain.length < 3)
+        return 0;
+    const dests = chain.map(destinationKeywords);
+    let flips = 0;
+    for (let i = 0; i < dests.length - 2; i++) {
+        const a = dests[i];
+        const b = dests[i + 1];
+        const c = dests[i + 2];
+        let flipFound = false;
+        for (const k of a) {
+            if (!b.has(k) && c.has(k)) {
+                flipFound = true;
+                break;
+            }
+        }
+        if (flipFound)
+            flips += 1;
+    }
+    return flips;
+}
+/**
+ * Detect flip-flops across a list of decisions.
+ *
+ * Returns groups with ≥ 1 flip — the actual paradoxes worth investigating.
+ * Groups with 2+ decisions but no flips (just continuous progress) are
+ * suppressed.
+ */
+export function detectParadoxes(decisions) {
+    if (decisions.length < 2)
+        return [];
+    const sorted = [...decisions].sort((a, b) => a.date.localeCompare(b.date));
+    const groups = groupByTopic(sorted);
+    const flipFlops = [];
+    for (const [topic, chain] of groups) {
+        if (chain.length < 3)
+            continue; // ABA needs 3 decisions minimum
+        const flips = countFlips(chain);
+        if (flips === 0)
+            continue;
+        const fromDate = new Date(chain[0].date);
+        const toDate = new Date(chain[chain.length - 1].date);
+        const spanMonths = (toDate.getTime() - fromDate.getTime()) / (30 * 86_400_000);
+        flipFlops.push({
+            topic,
+            chain,
+            flips,
+            spanMonths: Math.round(spanMonths * 10) / 10,
+            question: buildQuestion(topic, chain, flips),
+        });
+    }
+    flipFlops.sort((a, b) => b.flips - a.flips || b.spanMonths - a.spanMonths);
+    return flipFlops;
+}
+function buildQuestion(topic, chain, flips) {
+    const months = Math.round((new Date(chain[chain.length - 1].date).getTime() - new Date(chain[0].date).getTime()) /
+        (30 * 86_400_000));
+    if (flips >= 2) {
+        return `${flips} reversals in ${months} months — write an ADR before the next change.`;
+    }
+    return `One reversal in ${months} months — was the prior decision a mistake, or did context change?`;
+}
+//# sourceMappingURL=paradox.js.map

package/dist/insights/paradox.js.map

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

package/dist/insights/paradox.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=paradox.test.d.ts.map

package/dist/insights/paradox.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paradox.test.d.ts","sourceRoot":"","sources":["../../src/insights/paradox.test.ts"],"names":[],"mappings":""}

package/dist/insights/paradox.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect } from "vitest";
+import { detectParadoxes } from "./paradox.js";
+const dec = (date, summary, hash = `h${date.replace(/-/g, "")}`, kind = "switched") => ({
+    commitHash: hash,
+    shortHash: hash.slice(0, 7),
+    date,
+    author: "alice",
+    summary,
+    kind,
+    confidence: 0.9,
+});
+describe("detectParadoxes — basic flip detection", () => {
+    it("detects a clean ABA flip (Redis → in-memory → Redis)", () => {
+        const decisions = [
+            dec("2024-03-15", "decided to use Redis for caching"),
+            dec("2024-08-20", "switched from Redis to in-memory cache"),
+            dec("2025-02-10", "switched from in-memory back to Redis"),
+        ];
+        const paradoxes = detectParadoxes(decisions);
+        expect(paradoxes.length).toBeGreaterThanOrEqual(1);
+        const redis = paradoxes.find((p) => /redis|cache/i.test(p.topic));
+        expect(redis).toBeDefined();
+        expect(redis.flips).toBeGreaterThanOrEqual(1);
+        expect(redis.chain).toHaveLength(3);
+    });
+    it("does NOT flip on continuous progress (different targets each time)", () => {
+        const decisions = [
+            dec("2024-01-01", "adopted React"),
+            dec("2024-06-01", "switched from React to Solid"),
+            dec("2024-12-01", "switched from Solid to Svelte"),
+        ];
+        // Each decision picks a NEW target — no return to React. No flip.
+        const paradoxes = detectParadoxes(decisions);
+        const ui = paradoxes.find((p) => /react|solid|svelte/i.test(p.topic));
+        expect(ui?.flips ?? 0).toBe(0);
+    });
+    it("returns empty array when there are fewer than 2 decisions", () => {
+        expect(detectParadoxes([])).toEqual([]);
+        expect(detectParadoxes([dec("2024-01-01", "decided")])).toEqual([]);
+    });
+    it("requires at least 3 decisions to count as a flip-flop chain", () => {
+        const decisions = [
+            dec("2024-01-01", "use Redis cache"),
+            dec("2024-06-01", "switched from Redis to in-memory cache"),
+        ];
+        expect(detectParadoxes(decisions)).toEqual([]);
+    });
+});
+describe("detectParadoxes — span and metadata", () => {
+    it("computes spanMonths between first and last decision", () => {
+        const decisions = [
+            dec("2024-01-01", "use Redis cache"),
+            dec("2024-06-01", "switched from Redis to memcache"),
+            dec("2025-01-01", "back to Redis cache"),
+        ];
+        const p = detectParadoxes(decisions)[0];
+        expect(p.spanMonths).toBeGreaterThan(11);
+        expect(p.spanMonths).toBeLessThan(13);
+    });
+    it("attaches a question that prompts an ADR for repeated reversals", () => {
+        const decisions = [
+            dec("2024-01-01", "passport oauth"),
+            dec("2024-06-01", "switched from passport to custom auth"),
+            dec("2025-01-01", "switched back to passport"),
+        ];
+        const p = detectParadoxes(decisions)[0];
+        expect(p.question.toLowerCase()).toMatch(/reversal|adr|mistake|context/);
+    });
+});
+describe("detectParadoxes — sort order", () => {
+    it("sorts paradoxes by flip count desc, then by span", () => {
+        const decisions = [
+            // topic A: 2 flips (ABABA-ish)
+            dec("2024-01-01", "use Redis cache fast"),
+            dec("2024-04-01", "switched from Redis cache to memcached fast"),
+            dec("2024-08-01", "back to Redis cache"),
+            dec("2024-12-01", "memcached cache again"),
+            dec("2025-04-01", "Redis cache again"),
+            // topic B: 1 flip
+            dec("2024-02-01", "use webpack bundler"),
+            dec("2024-07-01", "switched from webpack bundler to vite bundler"),
+            dec("2024-12-01", "back to webpack bundler"),
+        ];
+        const paradoxes = detectParadoxes(decisions);
+        expect(paradoxes[0].flips).toBeGreaterThanOrEqual(paradoxes[paradoxes.length - 1].flips);
+    });
+});
+//# sourceMappingURL=paradox.test.js.map

package/dist/insights/paradox.test.js.map

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

package/dist/insights/premortem.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `mneme premortem <intent>` — predict what will go wrong with a proposed
+ * change *before* you write it, by mining your repo's history of similar
+ * past attempts and what happened to them.
+ *
+ * Premortem inverts the postmortem: instead of "what went wrong?", we ask
+ * "what is likely to go wrong, given what's gone wrong before in this repo
+ * when we tried something like this?"
+ *
+ * What makes this novel:
+ *   - Most "AI coding" tools give generic advice ("watch out for race
+ *     conditions"). Premortem gives advice grounded in YOUR repo's actual
+ *     failure history.
+ *   - Estimates a regret probability based on hit rate of similar past
+ *     intents that ended in revert/hotfix/incident.
+ *   - Surfaces 3 concrete risks with citations to the past commits that
+ *     caused them — actionable, not abstract.
+ *
+ * Pure data extraction — no LLM. The CLI renders.
+ */
+import type { Commit } from "../types.js";
+export type RiskKind = "revert" | "hotfix" | "incident" | "rewrite";
+export interface PastAttempt {
+    /** The commit that introduced the past attempt. */
+    attempt: Commit;
+    /** The follow-up that signals regret (if any). */
+    regret?: Commit;
+    /** What went wrong, classified by signal in the regret commit. */
+    riskKind: RiskKind | "none";
+    /** Days from attempt to regret (or 0 if no regret). */
+    daysToRegret: number;
+    /** Similarity score of this past attempt to the current intent (0..1). */
+    similarity: number;
+}
+export interface Risk {
+    /** Short label e.g. "cache invalidation regression". */
+    label: string;
+    /** Specific commits that exhibited this risk. */
+    evidence: Commit[];
+    /** How often this risk fired, normalized 0..1 (capped at 1). */
+    weight: number;
+}
+export interface PremortemResult {
+    intent: string;
+    /** Past attempts in this repo that look like the proposed intent. */
+    pastAttempts: PastAttempt[];
+    /**
+     * Probability that this kind of change will be regretted, computed as
+     * regret_count / total_similar_attempts. Range 0..1.
+     */
+    regretProbability: number;
+    /** Top concrete risks distilled from past attempts. */
+    topRisks: Risk[];
+    /** Verdict label — "low / medium / high / very_high". */
+    verdict: "low" | "medium" | "high" | "very_high";
+    /** Short verdict prose. */
+    summary: string;
+}
+/**
+ * Score similarity between an intent string and a commit, by token overlap
+ * + a small bonus for files-mentioned matching commit-touched files.
+ */
+export declare function scoreSimilarity(intent: string, c: Commit): number;
+/**
+ * Build a premortem from an intent string and the commit history. Caller
+ * passes the full commit history (newest first or oldest first — we sort).
+ */
+export declare function buildPremortem(intent: string, commits: Commit[], opts?: {
+    similarityFloor?: number;
+    windowDays?: number;
+    maxAttempts?: number;
+}): PremortemResult;
+//# sourceMappingURL=premortem.d.ts.map

package/dist/insights/premortem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premortem.d.ts","sourceRoot":"","sources":["../../src/insights/premortem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACjD,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBjE;AAsBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,GAAE;IACJ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,eAAe,CA8GjB"}