@mneme-ai/core 0.9.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":"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"}

package/dist/insights/regret.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `mneme regret` — surface commits that we shipped and then immediately
+ * fixed, hotfixed, or reverted. The "things we regretted" log.
+ *
+ * Reverse-mining git history for failure patterns. A commit is a "regret"
+ * if a follow-up commit (within `windowDays`) contains revert/hotfix/fix
+ * markers OR touches the same lines/files. The follow-up tells us this
+ * commit ALREADY caused pain.
+ *
+ * Why this is useful:
+ *   - Postmortems: "what did we ship and regret?"
+ *   - Retrospectives: pattern of regret reveals systemic issues
+ *   - Pre-commit awareness: see what *kinds* of changes you tend to redo
+ *
+ * Pure data extraction — no LLM. The CLI command renders.
+ */
+import type { Commit } from "../types.js";
+export interface Regret {
+    shipped: Commit;
+    followup: Commit;
+    /** Days between ship and followup. */
+    daysToFix: number;
+    /**
+     * What kind of follow-up — drives the rendered label and lesson tone.
+     * 'revert' is strongest (full undo); 'hotfix' is urgent fix; 'fix' is
+     * any subsequent commit referencing the original; 'sameFiles' is the
+     * weakest signal (just touched the same files within window).
+     */
+    kind: "revert" | "hotfix" | "fix" | "sameFiles";
+    /** A 1-line lesson when one is extractable from the follow-up message. */
+    lesson?: string;
+}
+/**
+ * Detect regrets from a chronological commit list. Commits should be
+ * sorted oldest-first (caller's responsibility — we use index ordering
+ * to compute "follow-up").
+ */
+export declare function detectRegrets(commits: Commit[], opts?: {
+    windowDays?: number;
+    minDaysToFix?: number;
+}): Regret[];
+/**
+ * Aggregate metrics — useful for repo-level trend reporting.
+ *
+ * `regretRate` is how many of the recent shipped commits later got fixed
+ * within the window. We exclude shipped commits whose own subject already
+ * looks like a fix (so we don't double-count repair work).
+ */
+export interface RegretSummary {
+    totalShipped: number;
+    totalRegrets: number;
+    regretRate: number;
+    byKind: Record<Regret["kind"], number>;
+    averageDaysToFix: number;
+}
+export declare function summarizeRegrets(commits: Commit[], regrets: Regret[]): RegretSummary;
+//# sourceMappingURL=regret.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regret.d.ts","sourceRoot":"","sources":["../../src/insights/regret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,WAAW,CAAC;IAChD,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,MAAM,EAAE,CAwDV;AAkCD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,aAAa,CAgBpF"}

package/dist/insights/regret.js

@@ -0,0 +1,137 @@
+/**
+ * `mneme regret` — surface commits that we shipped and then immediately
+ * fixed, hotfixed, or reverted. The "things we regretted" log.
+ *
+ * Reverse-mining git history for failure patterns. A commit is a "regret"
+ * if a follow-up commit (within `windowDays`) contains revert/hotfix/fix
+ * markers OR touches the same lines/files. The follow-up tells us this
+ * commit ALREADY caused pain.
+ *
+ * Why this is useful:
+ *   - Postmortems: "what did we ship and regret?"
+ *   - Retrospectives: pattern of regret reveals systemic issues
+ *   - Pre-commit awareness: see what *kinds* of changes you tend to redo
+ *
+ * Pure data extraction — no LLM. The CLI command renders.
+ */
+const REVERT_RE = /\b(revert|reverts|reverted)\b/i;
+const HOTFIX_RE = /\b(hotfix|emergency|urgent|critical)\b/i;
+const FIX_RE = /\b(fix(?:es|ed)?|bug|broken|crash|regression)\b/i;
+const REF_RE = /\b#?(\d{2,6})\b/;
+/**
+ * Detect regrets from a chronological commit list. Commits should be
+ * sorted oldest-first (caller's responsibility — we use index ordering
+ * to compute "follow-up").
+ */
+export function detectRegrets(commits, opts = {}) {
+    const windowMs = (opts.windowDays ?? 7) * 86_400_000;
+    const minDaysToFix = opts.minDaysToFix ?? 0;
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    const out = [];
+    // Index commits by file for fast suffix matching.
+    for (let i = 0; i < sorted.length; i++) {
+        const shipped = sorted[i];
+        const shippedTime = new Date(shipped.authorDate).getTime();
+        const shippedHashShort = (shipped.shortHash || shipped.hash.slice(0, 7)).toLowerCase();
+        // Walk forward looking for a follow-up within the window.
+        for (let j = i + 1; j < sorted.length; j++) {
+            const followup = sorted[j];
+            const followupTime = new Date(followup.authorDate).getTime();
+            const dt = followupTime - shippedTime;
+            if (dt > windowMs)
+                break; // window exceeded; no later commit qualifies
+            const days = dt / 86_400_000;
+            if (days < minDaysToFix)
+                continue;
+            const fuText = `${followup.subject}\n${followup.body || ""}`;
+            const fuTextLower = fuText.toLowerCase();
+            let kind = null;
+            // Strongest signal: explicit revert that names the original commit.
+            if (REVERT_RE.test(fuText) && (fuTextLower.includes(shippedHashShort) || fuTextLower.includes(shipped.subject.toLowerCase()))) {
+                kind = "revert";
+            }
+            else if (REVERT_RE.test(fuText) && shareFiles(shipped, followup)) {
+                kind = "revert";
+            }
+            else if (HOTFIX_RE.test(fuText) && shareFiles(shipped, followup)) {
+                kind = "hotfix";
+            }
+            else if (FIX_RE.test(fuText) && shareFiles(shipped, followup)) {
+                // Don't double-count the shipped commit itself if it's also a fix.
+                if (!FIX_RE.test(shipped.subject))
+                    kind = "fix";
+            }
+            else if (REF_RE.test(fuText) && shareFiles(shipped, followup)) {
+                // weak signal: same files within window — only count if not already a fix
+                kind = "sameFiles";
+            }
+            if (kind) {
+                out.push({
+                    shipped,
+                    followup,
+                    daysToFix: Number(days.toFixed(1)),
+                    kind,
+                    lesson: extractLesson(fuText, kind),
+                });
+                break; // one regret per shipped commit (the first follow-up)
+            }
+        }
+    }
+    // Sort by recency of ship date (newest first — what users want to see).
+    return out.sort((a, b) => b.shipped.authorDate.localeCompare(a.shipped.authorDate));
+}
+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 extractLesson(text, kind) {
+    // Simple heuristic — find the first sentence that explains WHY.
+    const lines = text.split(/\n+/);
+    for (const line of lines) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        if (t.length < 20 || t.length > 200)
+            continue;
+        // Skip the subject line (usually the first non-empty)
+        if (t.toLowerCase().startsWith("revert "))
+            continue;
+        if (t.toLowerCase().startsWith("hotfix"))
+            continue;
+        return t;
+    }
+    // Fallback — generic lesson by kind.
+    switch (kind) {
+        case "revert":
+            return "this change was fully reverted within the window";
+        case "hotfix":
+            return "needed an urgent follow-up fix";
+        case "fix":
+            return "a follow-up commit fixed it";
+        case "sameFiles":
+            return "the same files were touched again very soon after";
+    }
+}
+export function summarizeRegrets(commits, regrets) {
+    const shippedCandidates = commits.filter((c) => !FIX_RE.test(c.subject));
+    const total = shippedCandidates.length;
+    const byKind = { revert: 0, hotfix: 0, fix: 0, sameFiles: 0 };
+    let sumDays = 0;
+    for (const r of regrets) {
+        byKind[r.kind] += 1;
+        sumDays += r.daysToFix;
+    }
+    return {
+        totalShipped: total,
+        totalRegrets: regrets.length,
+        regretRate: total === 0 ? 0 : regrets.length / total,
+        byKind,
+        averageDaysToFix: regrets.length === 0 ? 0 : sumDays / regrets.length,
+    };
+}
+//# sourceMappingURL=regret.js.map

package/dist/insights/regret.js.map

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

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

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

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

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