@mneme-ai/core 0.10.0 → 0.11.0

package/dist/insights/ghost.d.ts

@@ -0,0 +1,80 @@
+/**
+ * `mneme ghost` — surface "ghost code": files that haunt the repo without
+ * doing anything. Started but never finished, declared but never imported,
+ * touched once a year ago and ignored ever since.
+ *
+ * Ghosts are dangerous because they:
+ *   - Add maintenance surface that nobody knows is unused
+ *   - Mislead readers who assume "if it's here, it must matter"
+ *   - Anchor obsolete patterns ("we use X here, so we must keep using X")
+ *
+ * What makes this novel:
+ *   - Combines staleness, churn pattern, and TODO-density into a single
+ *     "ghostliness" score, instead of just "files not edited recently".
+ *   - Detects abandoned half-finished work via TODO/FIXME density + low
+ *     recent commit activity.
+ *   - Surfaces stale TODOs (added long ago, ignored ever since) — these
+ *     are individual ghost markers, not just file-level signals.
+ *
+ * Pure data extraction. The CLI renders.
+ */
+import type { Commit, FileChange } from "../types.js";
+export interface GhostFile {
+    path: string;
+    /** Days since the file was last modified by any commit. */
+    daysSinceLastTouch: number;
+    /** Number of commits that ever touched the file. */
+    totalCommits: number;
+    /** Most recent commit subject — useful clue. */
+    lastCommitSubject: string;
+    /** Lines of TODO/FIXME in the file when it was last seen (estimated). */
+    todoCount: number;
+    /**
+     * Ghostliness 0..1 — higher = more haunted.
+     *   - boosted by staleness (recency-decay)
+     *   - boosted by low total commits (born and forgotten)
+     *   - boosted by high TODO density
+     *   - dampened if many recent commits (active = not a ghost)
+     */
+    ghostliness: number;
+    /** Why this file looks like a ghost — short label. */
+    reason: string;
+}
+export interface StaleTodo {
+    /** Commit that introduced the TODO. */
+    introducedIn: Commit;
+    /** Days since the TODO was added. */
+    ageDays: number;
+    /** The TODO text (subject of the introducing commit). */
+    hint: string;
+    /** Times the file was touched after the TODO without removing it. */
+    ignoredCount: number;
+    /** File path containing the TODO. */
+    filePath: string;
+}
+export interface GhostReport {
+    ghostFiles: GhostFile[];
+    staleTodos: StaleTodo[];
+    /** Total files analyzed. */
+    totalFiles: number;
+    /** Average ghostliness across files (0..1). */
+    averageGhostliness: number;
+}
+/**
+ * Build a ghost report from commits + per-commit file changes + per-file
+ * TODO counts. Caller provides:
+ *   - commits sorted (any order — we sort)
+ *   - changes: list of FileChange across all commits
+ *   - todoCounts: optional Map<filePath, number> of TODO/FIXME counts
+ *
+ * If `todoCounts` is omitted, TODO inference falls back to scanning commit
+ * subjects for TODO/FIXME mentions.
+ */
+export declare function buildGhostReport(commits: Commit[], changes: FileChange[], opts?: {
+    todoCounts?: Map<string, number>;
+    nowMs?: number;
+    staleDays?: number;
+    todoStaleDays?: number;
+    minGhostliness?: number;
+}): GhostReport;
+//# sourceMappingURL=ghost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ghost.d.ts","sourceRoot":"","sources":["../../src/insights/ghost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,UAAU,EAAE,EACrB,IAAI,GAAE;IACJ,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,WAAW,CAgHb"}

package/dist/insights/ghost.js

@@ -0,0 +1,138 @@
+const TODO_RE = /\b(TODO|FIXME|XXX|HACK|TBD)\b/i;
+/**
+ * Build a ghost report from commits + per-commit file changes + per-file
+ * TODO counts. Caller provides:
+ *   - commits sorted (any order — we sort)
+ *   - changes: list of FileChange across all commits
+ *   - todoCounts: optional Map<filePath, number> of TODO/FIXME counts
+ *
+ * If `todoCounts` is omitted, TODO inference falls back to scanning commit
+ * subjects for TODO/FIXME mentions.
+ */
+export function buildGhostReport(commits, changes, opts = {}) {
+    const nowMs = opts.nowMs ?? Date.now();
+    const staleDays = opts.staleDays ?? 180;
+    const todoStaleDays = opts.todoStaleDays ?? 90;
+    const minGhostliness = opts.minGhostliness ?? 0.4;
+    const byPath = new Map();
+    const commitByHash = new Map();
+    for (const c of commits)
+        commitByHash.set(c.hash, c);
+    for (const ch of changes) {
+        const c = commitByHash.get(ch.commitHash);
+        if (!c)
+            continue;
+        const t = new Date(c.authorDate).getTime();
+        const cur = byPath.get(ch.path);
+        if (!cur) {
+            byPath.set(ch.path, {
+                path: ch.path,
+                lastTouchMs: t,
+                firstTouchMs: t,
+                totalCommits: 1,
+                lastCommit: c,
+            });
+        }
+        else {
+            cur.totalCommits += 1;
+            if (t > cur.lastTouchMs) {
+                cur.lastTouchMs = t;
+                cur.lastCommit = c;
+            }
+            if (t < cur.firstTouchMs)
+                cur.firstTouchMs = t;
+        }
+    }
+    const ghostFiles = [];
+    let totalGhost = 0;
+    for (const stat of byPath.values()) {
+        const daysSinceLastTouch = (nowMs - stat.lastTouchMs) / 86_400_000;
+        const todoCount = opts.todoCounts?.get(stat.path) ?? 0;
+        const ghostliness = computeGhostliness(daysSinceLastTouch, stat.totalCommits, todoCount, staleDays);
+        totalGhost += ghostliness;
+        if (ghostliness >= minGhostliness) {
+            ghostFiles.push({
+                path: stat.path,
+                daysSinceLastTouch: Math.round(daysSinceLastTouch),
+                totalCommits: stat.totalCommits,
+                lastCommitSubject: stat.lastCommit.subject,
+                todoCount,
+                ghostliness: Number(ghostliness.toFixed(2)),
+                reason: explainGhost(daysSinceLastTouch, stat.totalCommits, todoCount, staleDays),
+            });
+        }
+    }
+    ghostFiles.sort((a, b) => b.ghostliness - a.ghostliness);
+    // Detect stale TODOs from commit history
+    const staleTodos = [];
+    // Group commits by file: who introduced a TODO mention?
+    const fileTouchOrder = new Map();
+    for (const ch of changes) {
+        const c = commitByHash.get(ch.commitHash);
+        if (!c)
+            continue;
+        const arr = fileTouchOrder.get(ch.path) ?? [];
+        arr.push(c);
+        fileTouchOrder.set(ch.path, arr);
+    }
+    for (const [path, touches] of fileTouchOrder) {
+        touches.sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+        let firstTodoCommit = null;
+        let ignoredCount = 0;
+        for (const c of touches) {
+            const text = `${c.subject}\n${c.body || ""}`;
+            if (firstTodoCommit) {
+                ignoredCount += 1;
+            }
+            else if (TODO_RE.test(text)) {
+                firstTodoCommit = c;
+            }
+        }
+        if (firstTodoCommit) {
+            const ageDays = (nowMs - new Date(firstTodoCommit.authorDate).getTime()) / 86_400_000;
+            if (ageDays >= todoStaleDays && ignoredCount >= 1) {
+                staleTodos.push({
+                    introducedIn: firstTodoCommit,
+                    ageDays: Math.round(ageDays),
+                    hint: firstTodoCommit.subject,
+                    ignoredCount,
+                    filePath: path,
+                });
+            }
+        }
+    }
+    staleTodos.sort((a, b) => b.ageDays - a.ageDays);
+    return {
+        ghostFiles,
+        staleTodos,
+        totalFiles: byPath.size,
+        averageGhostliness: byPath.size === 0 ? 0 : totalGhost / byPath.size,
+    };
+}
+function computeGhostliness(daysSinceLastTouch, totalCommits, todoCount, staleDays) {
+    // staleness: 0 at 0 days, → 1 as ratio approaches 2x staleDays
+    const stale = Math.min(1, daysSinceLastTouch / (staleDays * 2));
+    // low-touch boost: peaks when totalCommits ≤ 2
+    const lowTouch = totalCommits <= 1 ? 0.3 : totalCommits <= 3 ? 0.15 : 0;
+    // todo-density: each todo adds 0.05, capped at 0.25
+    const todoBoost = Math.min(0.25, todoCount * 0.05);
+    // recent activity dampener: many commits → not a ghost
+    const damp = totalCommits >= 10 ? 0.2 : 0;
+    return Math.max(0, Math.min(1, stale + lowTouch + todoBoost - damp));
+}
+function explainGhost(daysSinceLastTouch, totalCommits, todoCount, staleDays) {
+    if (daysSinceLastTouch >= staleDays * 2 && totalCommits <= 2) {
+        return `born and forgotten — ${Math.round(daysSinceLastTouch)}d untouched, only ${totalCommits} commit${totalCommits === 1 ? "" : "s"} ever`;
+    }
+    if (daysSinceLastTouch >= staleDays * 2) {
+        return `long-untouched — ${Math.round(daysSinceLastTouch)}d since last edit`;
+    }
+    if (todoCount >= 3) {
+        return `dense with TODOs — ${todoCount} marker${todoCount === 1 ? "" : "s"} pending`;
+    }
+    if (totalCommits === 1) {
+        return `one-shot file — added once, never revisited`;
+    }
+    return `stale — ${Math.round(daysSinceLastTouch)}d quiet`;
+}
+//# sourceMappingURL=ghost.js.map

package/dist/insights/ghost.js.map

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

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

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

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

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

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

@@ -18,4 +18,7 @@ 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;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,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

@@ -18,4 +18,7 @@ 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;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,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/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"}