@mneme-ai/core 0.10.0 → 0.11.0

package/dist/insights/premortem.js

@@ -0,0 +1,209 @@
+const REVERT_RE = /\b(revert|reverts|reverted|rollback)\b/i;
+const HOTFIX_RE = /\b(hotfix|emergency|urgent|critical|p[01])\b/i;
+const INCIDENT_RE = /\b(incident|outage|down|broken|crash|regression)\b/i;
+const REWRITE_RE = /\b(rewrite|rewritten|redo|redid|second(?:\s|-)attempt)\b/i;
+const STOPWORDS = new Set([
+    "the", "a", "an", "of", "to", "in", "on", "for", "and", "or", "with", "add", "added", "fix",
+    "remove", "update", "change", "make", "made", "new", "old", "this", "that", "is", "are", "be",
+    "was", "were", "my", "our", "your", "i", "we", "you", "it", "its", "into", "from", "by", "at",
+]);
+/**
+ * Score similarity between an intent string and a commit, by token overlap
+ * + a small bonus for files-mentioned matching commit-touched files.
+ */
+export function scoreSimilarity(intent, c) {
+    const intentTokens = tokenize(intent);
+    if (intentTokens.size === 0)
+        return 0;
+    const commitText = `${c.subject}\n${c.body || ""}`;
+    const commitTokens = tokenize(commitText);
+    let overlap = 0;
+    for (const t of intentTokens)
+        if (commitTokens.has(t))
+            overlap += 1;
+    const base = overlap / intentTokens.size;
+    // Path-level boost: if intent names a file/path, check commit touches it.
+    const pathHint = extractPathHint(intent);
+    let pathBoost = 0;
+    if (pathHint && c.files?.some((f) => f.includes(pathHint))) {
+        pathBoost = 0.2;
+    }
+    return Math.min(1, base + pathBoost);
+}
+function tokenize(s) {
+    const out = new Set();
+    for (const t of s
+        .toLowerCase()
+        .replace(/[^a-z0-9_/.-]+/g, " ")
+        .split(/\s+/)) {
+        if (!t)
+            continue;
+        if (t.length < 3)
+            continue;
+        if (STOPWORDS.has(t))
+            continue;
+        out.add(t);
+    }
+    return out;
+}
+function extractPathHint(intent) {
+    // crude: any token that looks like a path or file
+    const m = intent.match(/[A-Za-z0-9_./-]+\.(?:ts|tsx|js|jsx|py|go|rs|java|md)/);
+    return m ? m[0] : null;
+}
+/**
+ * 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 function buildPremortem(intent, commits, opts = {}) {
+    const similarityFloor = opts.similarityFloor ?? 0.25;
+    const windowDays = opts.windowDays ?? 14;
+    const maxAttempts = opts.maxAttempts ?? 25;
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    // Find similar past attempts. Exclude commits that are themselves regret
+    // signals (revert / hotfix / incident) — those aren't attempts, they're
+    // the consequence of one.
+    const scored = [];
+    for (const c of sorted) {
+        const subject = c.subject || "";
+        if (REVERT_RE.test(subject) || HOTFIX_RE.test(subject) || INCIDENT_RE.test(subject)) {
+            continue;
+        }
+        const s = scoreSimilarity(intent, c);
+        if (s >= similarityFloor)
+            scored.push({ commit: c, similarity: s });
+    }
+    scored.sort((a, b) => b.similarity - a.similarity);
+    const candidates = scored.slice(0, maxAttempts);
+    // For each candidate, walk forward window to find regret signal
+    const pastAttempts = [];
+    const windowMs = windowDays * 86_400_000;
+    for (const { commit: attempt, similarity } of candidates) {
+        const tStart = new Date(attempt.authorDate).getTime();
+        let regret;
+        let kind = "none";
+        let daysToRegret = 0;
+        for (const c of sorted) {
+            if (c.hash === attempt.hash)
+                continue;
+            const tC = new Date(c.authorDate).getTime();
+            if (tC <= tStart)
+                continue;
+            if (tC - tStart > windowMs)
+                break;
+            // Must share at least one file with the attempt
+            if (!shareFiles(attempt, c))
+                continue;
+            const text = `${c.subject}\n${c.body || ""}`;
+            if (REVERT_RE.test(text)) {
+                regret = c;
+                kind = "revert";
+                daysToRegret = Number(((tC - tStart) / 86_400_000).toFixed(1));
+                break;
+            }
+            if (HOTFIX_RE.test(text)) {
+                regret = c;
+                kind = "hotfix";
+                daysToRegret = Number(((tC - tStart) / 86_400_000).toFixed(1));
+                break;
+            }
+            if (INCIDENT_RE.test(text)) {
+                regret = c;
+                kind = "incident";
+                daysToRegret = Number(((tC - tStart) / 86_400_000).toFixed(1));
+                break;
+            }
+            if (REWRITE_RE.test(text) && shareFiles(attempt, c)) {
+                regret = c;
+                kind = "rewrite";
+                daysToRegret = Number(((tC - tStart) / 86_400_000).toFixed(1));
+                break;
+            }
+        }
+        pastAttempts.push({ attempt, regret, riskKind: kind, daysToRegret, similarity });
+    }
+    // Compute regret probability
+    const regretCount = pastAttempts.filter((p) => p.riskKind !== "none").length;
+    const regretProbability = pastAttempts.length === 0 ? 0 : regretCount / pastAttempts.length;
+    // Distill top risks: cluster regrets by riskKind, label them.
+    const byKind = new Map();
+    for (const p of pastAttempts) {
+        if (p.riskKind === "none")
+            continue;
+        const arr = byKind.get(p.riskKind) ?? [];
+        arr.push(p);
+        byKind.set(p.riskKind, arr);
+    }
+    const topRisks = [];
+    for (const [kind, arr] of byKind) {
+        topRisks.push({
+            label: riskLabel(kind, arr),
+            evidence: arr.map((a) => a.regret).filter(Boolean),
+            weight: Math.min(1, arr.length / Math.max(1, pastAttempts.length)),
+        });
+    }
+    topRisks.sort((a, b) => b.weight - a.weight);
+    // Verdict
+    let verdict = "low";
+    if (regretProbability >= 0.7)
+        verdict = "very_high";
+    else if (regretProbability >= 0.4)
+        verdict = "high";
+    else if (regretProbability >= 0.15)
+        verdict = "medium";
+    const summary = composeSummary(intent, pastAttempts.length, regretCount, verdict);
+    return {
+        intent,
+        pastAttempts,
+        regretProbability,
+        topRisks: topRisks.slice(0, 3),
+        verdict,
+        summary,
+    };
+}
+function shareFiles(a, b) {
+    if (!a.files?.length || !b.files?.length)
+        return false;
+    const setA = new Set(a.files);
+    for (const f of b.files)
+        if (setA.has(f))
+            return true;
+    return false;
+}
+function riskLabel(kind, arr) {
+    const n = arr.length;
+    switch (kind) {
+        case "revert":
+            return `change reverted within ${Math.round(median(arr.map((a) => a.daysToRegret)))}d (${n}× before)`;
+        case "hotfix":
+            return `hotfix follow-up needed (${n}× before)`;
+        case "incident":
+            return `linked to incident/regression (${n}× before)`;
+        case "rewrite":
+            return `partially rewritten soon after (${n}× before)`;
+    }
+}
+function median(xs) {
+    if (xs.length === 0)
+        return 0;
+    const s = [...xs].sort((a, b) => a - b);
+    const m = Math.floor(s.length / 2);
+    return s.length % 2 === 1 ? s[m] : (s[m - 1] + s[m]) / 2;
+}
+function composeSummary(intent, total, regret, verdict) {
+    if (total === 0) {
+        return `No similar past attempts found in this repo for "${intent}". Premortem cannot calibrate against history — proceed with normal review.`;
+    }
+    const pct = Math.round((regret / total) * 100);
+    switch (verdict) {
+        case "very_high":
+            return `${regret} of ${total} similar past attempts ended badly (${pct}%). This pattern has burned this repo before — slow down, write tests first, and review the cited commits.`;
+        case "high":
+            return `${regret} of ${total} similar past attempts hit problems (${pct}%). High caution warranted; review the cited risks before starting.`;
+        case "medium":
+            return `${regret} of ${total} similar past attempts had issues (${pct}%). Some historical risk — worth reading the cited commits.`;
+        case "low":
+            return `Only ${regret} of ${total} similar past attempts had problems (${pct}%). This kind of change has gone smoothly before — usual care is fine.`;
+    }
+}
+//# sourceMappingURL=premortem.js.map

package/dist/insights/premortem.js.map

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

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

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

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

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

package/dist/insights/premortem.test.js

@@ -0,0 +1,169 @@
+import { describe, it, expect } from "vitest";
+import { buildPremortem, scoreSimilarity } from "./premortem.js";
+function mk(p) {
+    return {
+        shortHash: p.hash.slice(0, 7),
+        authorName: "Test",
+        authorEmail: "t@e.com",
+        committerDate: p.authorDate,
+        body: p.body ?? "",
+        files: p.files ?? ["src/cache.ts"],
+        parents: p.parents ?? [],
+        ...p,
+    };
+}
+describe("scoreSimilarity", () => {
+    it("scores 0 when no token overlap", () => {
+        const c = mk({ hash: "a1", authorDate: "2024-01-01", subject: "fix typo in readme" });
+        const s = scoreSimilarity("rebuild authentication layer", c);
+        expect(s).toBe(0);
+    });
+    it("scores higher when intent terms appear in commit", () => {
+        const c = mk({
+            hash: "a1",
+            authorDate: "2024-01-01",
+            subject: "add caching layer to api responses",
+        });
+        const s = scoreSimilarity("add caching layer", c);
+        expect(s).toBeGreaterThan(0.5);
+    });
+    it("ignores stopwords", () => {
+        const c = mk({ hash: "a1", authorDate: "2024-01-01", subject: "the a an of to in for" });
+        const s = scoreSimilarity("the a an of to", c);
+        expect(s).toBe(0);
+    });
+    it("boosts score when intent names a file the commit touched", () => {
+        const c = mk({
+            hash: "a1",
+            authorDate: "2024-01-01",
+            subject: "minor unrelated change",
+            files: ["src/auth.ts"],
+        });
+        const s = scoreSimilarity("rewrite src/auth.ts", c);
+        expect(s).toBeGreaterThan(0);
+    });
+});
+describe("buildPremortem", () => {
+    it("returns empty when no commits at all", () => {
+        const r = buildPremortem("add caching layer", []);
+        expect(r.pastAttempts).toHaveLength(0);
+        expect(r.regretProbability).toBe(0);
+        expect(r.verdict).toBe("low");
+    });
+    it("flags very_high verdict when most past attempts ended in revert", () => {
+        const commits = [];
+        // 4 attempts to add caching, 3 reverted
+        for (let i = 0; i < 4; i++) {
+            commits.push(mk({
+                hash: `att${i}`,
+                authorDate: `2024-0${i + 1}-01`,
+                subject: `add caching layer to api`,
+                files: ["src/cache.ts"],
+            }));
+            if (i < 3) {
+                commits.push(mk({
+                    hash: `rev${i}`,
+                    authorDate: `2024-0${i + 1}-05`,
+                    subject: `revert "add caching layer to api"`,
+                    files: ["src/cache.ts"],
+                }));
+            }
+        }
+        const r = buildPremortem("add caching layer", commits, { similarityFloor: 0.2 });
+        expect(r.regretProbability).toBeGreaterThanOrEqual(0.7);
+        expect(r.verdict).toBe("very_high");
+    });
+    it("flags low verdict when no past attempts had problems", () => {
+        const commits = [];
+        for (let i = 0; i < 3; i++) {
+            commits.push(mk({
+                hash: `att${i}`,
+                authorDate: `2024-0${i + 1}-01`,
+                subject: `add caching layer for api`,
+                files: ["src/cache.ts"],
+            }));
+            commits.push(mk({
+                hash: `success${i}`,
+                authorDate: `2024-0${i + 1}-05`,
+                subject: `extend caching to user objects`,
+                files: ["src/cache.ts"],
+            }));
+        }
+        const r = buildPremortem("add caching layer", commits, { similarityFloor: 0.2 });
+        expect(r.regretProbability).toBe(0);
+        expect(r.verdict).toBe("low");
+    });
+    it("clusters risks by kind", () => {
+        const commits = [
+            mk({ hash: "a1", authorDate: "2024-01-01", subject: "add cache" }),
+            mk({ hash: "a2", authorDate: "2024-01-03", subject: "revert add cache" }),
+            mk({ hash: "a3", authorDate: "2024-02-01", subject: "add cache for users" }),
+            mk({ hash: "a4", authorDate: "2024-02-05", subject: "hotfix cache invalidation" }),
+            mk({ hash: "a5", authorDate: "2024-03-01", subject: "add cache for orders" }),
+            mk({ hash: "a6", authorDate: "2024-03-04", subject: "incident: stale cache caused outage" }),
+        ];
+        const r = buildPremortem("add cache", commits, { similarityFloor: 0.2 });
+        const kinds = new Set(r.topRisks.map((x) => x.label.split(" ")[0]));
+        expect(kinds.size).toBeGreaterThan(0);
+    });
+    it("limits topRisks to at most 3", () => {
+        const commits = [];
+        const subjects = [
+            "add cache",
+            "revert add cache",
+            "add cache",
+            "hotfix add cache bug",
+            "add cache",
+            "incident outage cache",
+            "add cache",
+            "rewrite cache after issues",
+        ];
+        for (let i = 0; i < subjects.length; i++) {
+            commits.push(mk({ hash: `c${i}`, authorDate: `2024-${(i + 1).toString().padStart(2, "0")}-01`, subject: subjects[i] }));
+        }
+        const r = buildPremortem("add cache", commits, { similarityFloor: 0.2 });
+        expect(r.topRisks.length).toBeLessThanOrEqual(3);
+    });
+    it("does not count the attempt itself as its own regret", () => {
+        const commits = [
+            mk({ hash: "a1", authorDate: "2024-01-01", subject: "add caching layer" }),
+        ];
+        const r = buildPremortem("add caching layer", commits, { similarityFloor: 0.2 });
+        expect(r.pastAttempts[0].riskKind).toBe("none");
+    });
+    it("computes summary string for every verdict tier", () => {
+        const verdicts = [
+            "low",
+            "medium",
+            "high",
+            "very_high",
+        ];
+        const seen = new Set();
+        for (const v of verdicts) {
+            const commits = [];
+            const total = 10;
+            const regrets = v === "low" ? 0 : v === "medium" ? 2 : v === "high" ? 5 : 8;
+            for (let i = 0; i < total; i++) {
+                commits.push(mk({
+                    hash: `a${i}`,
+                    authorDate: `2024-${(i + 1).toString().padStart(2, "0")}-01`,
+                    subject: `add caching feature`,
+                    files: ["src/cache.ts"],
+                }));
+                if (i < regrets) {
+                    commits.push(mk({
+                        hash: `r${i}`,
+                        authorDate: `2024-${(i + 1).toString().padStart(2, "0")}-05`,
+                        subject: `revert add caching feature`,
+                        files: ["src/cache.ts"],
+                    }));
+                }
+            }
+            const r = buildPremortem("add caching feature", commits, { similarityFloor: 0.2 });
+            seen.add(r.verdict);
+            expect(r.summary.length).toBeGreaterThan(20);
+        }
+        expect(seen.size).toBeGreaterThanOrEqual(2);
+    });
+});
+//# sourceMappingURL=premortem.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"premortem.test.js","sourceRoot":"","sources":["../../src/insights/premortem.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjE,SAAS,EAAE,CAAC,CAA4F;IACtG,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7B,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,CAAC,CAAC,UAAU;QAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC;QAClC,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,GAAG,CAAC;KACL,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACtF,MAAM,CAAC,GAAG,eAAe,CAAC,8BAA8B,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,YAAY;YACxB,OAAO,EAAE,oCAAoC;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,eAAe,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,eAAe,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,YAAY;YACxB,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,CAAC,aAAa,CAAC;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,eAAe,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,cAAc,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,wCAAwC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CACV,EAAE,CAAC;gBACD,IAAI,EAAE,MAAM,CAAC,EAAE;gBACf,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK;gBAC/B,OAAO,EAAE,0BAA0B;gBACnC,KAAK,EAAE,CAAC,cAAc,CAAC;aACxB,CAAC,CACH,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CACV,EAAE,CAAC;oBACD,IAAI,EAAE,MAAM,CAAC,EAAE;oBACf,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK;oBAC/B,OAAO,EAAE,mCAAmC;oBAC5C,KAAK,EAAE,CAAC,cAAc,CAAC;iBACxB,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,CAAC,GAAG,cAAc,CAAC,mBAAmB,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CACV,EAAE,CAAC;gBACD,IAAI,EAAE,MAAM,CAAC,EAAE;gBACf,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK;gBAC/B,OAAO,EAAE,2BAA2B;gBACpC,KAAK,EAAE,CAAC,cAAc,CAAC;aACxB,CAAC,CACH,CAAC;YACF,OAAO,CAAC,IAAI,CACV,EAAE,CAAC;gBACD,IAAI,EAAE,UAAU,CAAC,EAAE;gBACnB,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK;gBAC/B,OAAO,EAAE,gCAAgC;gBACzC,KAAK,EAAE,CAAC,cAAc,CAAC;aACxB,CAAC,CACH,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,cAAc,CAAC,mBAAmB,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,OAAO,GAAa;YACxB,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YAClE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;YACzE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;YAC5E,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;YAClF,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;YAC7E,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC7F,CAAC;QACF,MAAM,CAAC,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG;YACf,WAAW;YACX,kBAAkB;YAClB,WAAW;YACX,sBAAsB;YACtB,WAAW;YACX,uBAAuB;YACvB,WAAW;YACX,4BAA4B;SAC7B,CAAC;QACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CACV,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC,CAC3G,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,OAAO,GAAG;YACd,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;SAC3E,CAAC;QACF,MAAM,CAAC,GAAG,cAAc,CAAC,mBAAmB,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,QAAQ,GAAmD;YAC/D,KAAK;YACL,QAAQ;YACR,MAAM;YACN,WAAW;SACZ,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CACV,EAAE,CAAC;oBACD,IAAI,EAAE,IAAI,CAAC,EAAE;oBACb,UAAU,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;oBAC5D,OAAO,EAAE,qBAAqB;oBAC9B,KAAK,EAAE,CAAC,cAAc,CAAC;iBACxB,CAAC,CACH,CAAC;gBACF,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC;oBAChB,OAAO,CAAC,IAAI,CACV,EAAE,CAAC;wBACD,IAAI,EAAE,IAAI,CAAC,EAAE;wBACb,UAAU,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;wBAC5D,OAAO,EAAE,4BAA4B;wBACrC,KAAK,EAAE,CAAC,cAAc,CAAC;qBACxB,CAAC,CACH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM,CAAC,GAAG,cAAc,CAAC,qBAAqB,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;YACnF,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACpB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/insights/time-machine.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `mneme time-machine <file>` — narrate a file's evolution as discrete
+ * epochs, not a flat diff log. Each epoch is a meaningful era in the
+ * file's life: when it was born, when it was rewritten, when it stabilized,
+ * when it broke things, when it was abandoned.
+ *
+ * What makes this novel:
+ *   - Most tools show `git log file.ts` — a flat list. Time Machine
+ *     groups commits into ERAS based on intent (rewrite, fix, polish,
+ *     stable plateau).
+ *   - Detects "rewrite events" (large simultaneous insertions+deletions)
+ *     vs. "polish events" (small surgical changes) vs. "stable plateaus"
+ *     (long quiet stretches).
+ *   - Surfaces the WHY for each epoch by extracting the most informative
+ *     commit message of that era.
+ *   - Computes "narrative health" — how much of the history is rewrite
+ *     vs. evolution vs. firefight.
+ *
+ * Pure data extraction. The CLI renders the timeline; an LLM (optional)
+ * can polish the prose.
+ */
+import type { Commit, FileChange } from "../types.js";
+export type EpochKind = "birth" | "rewrite" | "evolution" | "firefight" | "polish" | "plateau" | "twilight";
+export interface FileEpoch {
+    kind: EpochKind;
+    /** Sequential number, 1-indexed. */
+    index: number;
+    /** Commits defining this epoch (chronological). */
+    commits: Commit[];
+    /** The most informative commit of the epoch — used for narration. */
+    defining: Commit;
+    fromDate: string;
+    toDate: string;
+    /** Total insertions across the epoch. */
+    insertions: number;
+    /** Total deletions across the epoch. */
+    deletions: number;
+    /** Days spanned by this epoch. */
+    spanDays: number;
+    /** A short prose label — the WHY of this epoch. */
+    label: string;
+}
+export interface TimeMachineResult {
+    filePath: string;
+    totalCommits: number;
+    totalSpanDays: number;
+    epochs: FileEpoch[];
+    /**
+     * Health balance across epochs:
+     *   - rewriteRatio: fraction of commits in rewrite epochs (high = unstable)
+     *   - firefightRatio: fraction in firefight epochs (high = pain)
+     *   - polishRatio: fraction in polish/plateau (high = mature)
+     */
+    health: {
+        rewriteRatio: number;
+        firefightRatio: number;
+        polishRatio: number;
+    };
+}
+/**
+ * Compute file epochs from a chronological list of commits + per-commit
+ * file changes for the target file. Caller is responsible for filtering
+ * commits to ones that actually touched `filePath`.
+ */
+export declare function buildTimeMachine(filePath: string, commits: Commit[], changes: Map<string, FileChange>, // commitHash -> file change for filePath
+opts?: {
+    plateauDays?: number;
+    rewriteChurnLines?: number;
+}): TimeMachineResult;
+//# sourceMappingURL=time-machine.d.ts.map

package/dist/insights/time-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-machine.d.ts","sourceRoot":"","sources":["../../src/insights/time-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,SAAS,GACT,WAAW,GACX,WAAW,GACX,QAAQ,GACR,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB;;;;;OAKG;IACH,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,yCAAyC;AAC3E,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,iBAAiB,CAgJnB"}

package/dist/insights/time-machine.js

@@ -0,0 +1,177 @@
+const FIRE_RE = /\b(fix(?:es|ed)?|hotfix|revert|rollback|broken|crash|regression|emergency|urgent|critical|p[01])\b/i;
+const REWRITE_RE = /\b(rewrite|refactor|overhaul|redesign|migrate|replace[ds]?|move(?:d)? to)\b/i;
+const POLISH_RE = /\b(typo|format|lint|rename|comment|whitespace|cleanup|style|chore)\b/i;
+/**
+ * Compute file epochs from a chronological list of commits + per-commit
+ * file changes for the target file. Caller is responsible for filtering
+ * commits to ones that actually touched `filePath`.
+ */
+export function buildTimeMachine(filePath, commits, changes, // commitHash -> file change for filePath
+opts = {}) {
+    const plateauDays = opts.plateauDays ?? 60;
+    const rewriteChurnLines = opts.rewriteChurnLines ?? 80;
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    if (sorted.length === 0) {
+        return {
+            filePath,
+            totalCommits: 0,
+            totalSpanDays: 0,
+            epochs: [],
+            health: { rewriteRatio: 0, firefightRatio: 0, polishRatio: 0 },
+        };
+    }
+    const flavorOf = (c) => {
+        const text = `${c.subject}\n${c.body || ""}`;
+        const fc = changes.get(c.hash);
+        const churn = fc ? fc.insertions + fc.deletions : 0;
+        if (REWRITE_RE.test(text) || churn >= rewriteChurnLines)
+            return "rewrite";
+        if (FIRE_RE.test(text))
+            return "firefight";
+        if (POLISH_RE.test(text) || churn <= 5)
+            return "polish";
+        return "evolution";
+    };
+    const epochs = [];
+    let buf = [sorted[0]];
+    let bufFlavor = sorted[0].parents.length === 0 || epochs.length === 0 ? "birth" : flavorOf(sorted[0]);
+    // birth applies only to the very first commit
+    bufFlavor = "birth";
+    let prevDate = new Date(sorted[0].authorDate).getTime();
+    const flush = (kind) => {
+        const commitsInEpoch = buf;
+        if (commitsInEpoch.length === 0)
+            return;
+        let ins = 0;
+        let del = 0;
+        for (const c of commitsInEpoch) {
+            const fc = changes.get(c.hash);
+            if (fc) {
+                ins += fc.insertions;
+                del += fc.deletions;
+            }
+        }
+        const fromDate = commitsInEpoch[0].authorDate.slice(0, 10);
+        const toDate = commitsInEpoch[commitsInEpoch.length - 1].authorDate.slice(0, 10);
+        const spanDays = Math.max(0, Math.round((new Date(toDate).getTime() - new Date(fromDate).getTime()) / 86_400_000));
+        const defining = pickDefiningCommit(commitsInEpoch, kind);
+        epochs.push({
+            kind,
+            index: epochs.length + 1,
+            commits: commitsInEpoch,
+            defining,
+            fromDate,
+            toDate,
+            insertions: ins,
+            deletions: del,
+            spanDays,
+            label: labelEpoch(kind, defining, ins + del),
+        });
+    };
+    for (let i = 1; i < sorted.length; i++) {
+        const c = sorted[i];
+        const cTime = new Date(c.authorDate).getTime();
+        const gapDays = (cTime - prevDate) / 86_400_000;
+        const flavor = flavorOf(c);
+        // Long quiet gap → emit plateau epoch covering the gap
+        if (gapDays >= plateauDays) {
+            flush(bufFlavor);
+            epochs.push({
+                kind: "plateau",
+                index: epochs.length + 1,
+                commits: [],
+                defining: buf[buf.length - 1],
+                fromDate: buf[buf.length - 1].authorDate.slice(0, 10),
+                toDate: c.authorDate.slice(0, 10),
+                insertions: 0,
+                deletions: 0,
+                spanDays: Math.round(gapDays),
+                label: `quiet stretch — ${Math.round(gapDays)} days untouched`,
+            });
+            buf = [c];
+            bufFlavor = flavor;
+        }
+        else if (flavor !== bufFlavor) {
+            // flavor change → close current epoch, start new one
+            flush(bufFlavor);
+            buf = [c];
+            bufFlavor = flavor;
+        }
+        else {
+            buf.push(c);
+        }
+        prevDate = cTime;
+    }
+    flush(bufFlavor);
+    // Mark trailing plateau as "twilight" if file is quiet at end (>plateauDays
+    // since last touch).
+    const last = epochs[epochs.length - 1];
+    if (last && last.kind === "plateau" && last.spanDays >= plateauDays * 2) {
+        last.kind = "twilight";
+        last.label = `twilight — ${last.spanDays} days since last touch`;
+    }
+    // Compute health ratios
+    const totalCommits = sorted.length;
+    let rewrite = 0;
+    let firefight = 0;
+    let polish = 0;
+    for (const e of epochs) {
+        if (e.kind === "rewrite")
+            rewrite += e.commits.length;
+        else if (e.kind === "firefight")
+            firefight += e.commits.length;
+        else if (e.kind === "polish" || e.kind === "plateau")
+            polish += e.commits.length;
+    }
+    const totalSpanDays = Math.max(0, Math.round((new Date(sorted[sorted.length - 1].authorDate).getTime() -
+        new Date(sorted[0].authorDate).getTime()) /
+        86_400_000));
+    return {
+        filePath,
+        totalCommits,
+        totalSpanDays,
+        epochs,
+        health: {
+            rewriteRatio: totalCommits === 0 ? 0 : rewrite / totalCommits,
+            firefightRatio: totalCommits === 0 ? 0 : firefight / totalCommits,
+            polishRatio: totalCommits === 0 ? 0 : polish / totalCommits,
+        },
+    };
+}
+function pickDefiningCommit(commits, kind) {
+    if (commits.length === 0)
+        throw new Error("empty epoch");
+    if (kind === "birth")
+        return commits[0];
+    if (kind === "rewrite") {
+        // longest body / most descriptive subject wins
+        return [...commits].sort((a, b) => (b.body?.length ?? 0) + b.subject.length - ((a.body?.length ?? 0) + a.subject.length))[0];
+    }
+    // For evolution/polish/firefight, pick the commit whose subject is longest
+    // (typically more informative than "fix typo")
+    return [...commits].sort((a, b) => b.subject.length - a.subject.length)[0];
+}
+function labelEpoch(kind, defining, churn) {
+    switch (kind) {
+        case "birth":
+            return `born — "${truncate(defining.subject, 60)}"`;
+        case "rewrite":
+            return `rewrite — "${truncate(defining.subject, 60)}" (${churn} lines)`;
+        case "evolution":
+            return `evolution — "${truncate(defining.subject, 60)}"`;
+        case "firefight":
+            return `firefight — "${truncate(defining.subject, 60)}"`;
+        case "polish":
+            return `polish — "${truncate(defining.subject, 60)}"`;
+        case "plateau":
+            return `plateau — quiet`;
+        case "twilight":
+            return `twilight — possibly abandoned`;
+    }
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1).trimEnd() + "…";
+}
+//# sourceMappingURL=time-machine.js.map