@mneme-ai/core 0.8.4 → 0.10.0

package/dist/insights/crystal-ball.js

@@ -0,0 +1,219 @@
+/**
+ * `mneme crystal-ball` — predict the probability that the staged change
+ * will fail CI, BEFORE you push.
+ *
+ * Approach (Bayesian-ish over historical signals):
+ *   1. Compute a fingerprint of the staged diff:
+ *        modules touched, file types, add/remove ratio, test changes Y/N.
+ *   2. Find historical commits with similar fingerprints.
+ *   3. Look at each one's fate within `windowDays`:
+ *        - revert / hotfix / fix follow-up = "trouble"
+ *        - else                            = "clean"
+ *   4. Output: prediction p(clean) = clean / total similar.
+ *
+ * Without integrated CI run history (which Mneme doesn't index by default),
+ * follow-up commits are our best proxy: a commit that needed a hotfix is
+ * indistinguishable from one that broke CI from the user's perspective.
+ *
+ * The output is honest about its limits: if `n` is small (< 5), we say
+ * "low signal" instead of pretending to be confident.
+ */
+import { parseDiff } from "./commit-coach.js";
+import { detectRegrets } from "./regret.js";
+export function fingerprint(diff) {
+    const exts = new Set();
+    for (const f of diff.files) {
+        const m = f.match(/\.([a-z0-9]+)$/i);
+        if (m)
+            exts.add(m[1].toLowerCase());
+    }
+    const totalLines = diff.added + diff.removed;
+    const size = totalLines < 20 ? "tiny" : totalLines < 100 ? "small" : totalLines < 500 ? "medium" : "large";
+    const hasTests = diff.files.some((f) => /(\.test\.|\.spec\.|\/tests?\/|\/specs?\/)/.test(f));
+    return {
+        modules: [...new Set(diff.modules)].sort(),
+        extensions: [...exts].sort(),
+        shape: diff.shape,
+        size,
+        hasTests,
+    };
+}
+/**
+ * Score similarity between two fingerprints. Returns 0..1.
+ *
+ * Each dimension contributes a weight; the score is a weighted average:
+ *   modules:    0.40  (Jaccard)
+ *   extensions: 0.20  (Jaccard)
+ *   shape:      0.20  (1.0 if equal, else 0.0)
+ *   size:       0.10  (linear distance over 4 buckets)
+ *   hasTests:   0.10  (1.0 if equal, else 0.0)
+ */
+export function similarity(a, b) {
+    const jaccard = (xs, ys) => {
+        if (xs.length === 0 && ys.length === 0)
+            return 1;
+        const A = new Set(xs);
+        const B = new Set(ys);
+        let inter = 0;
+        for (const x of A)
+            if (B.has(x))
+                inter += 1;
+        const union = A.size + B.size - inter;
+        return union === 0 ? 0 : inter / union;
+    };
+    const modules = jaccard(a.modules, b.modules);
+    const exts = jaccard(a.extensions, b.extensions);
+    const shape = a.shape === b.shape ? 1 : 0;
+    const sizes = ["tiny", "small", "medium", "large"];
+    const sizeDist = Math.abs(sizes.indexOf(a.size) - sizes.indexOf(b.size));
+    const size = 1 - sizeDist / 3;
+    const tests = a.hasTests === b.hasTests ? 1 : 0;
+    return 0.4 * modules + 0.2 * exts + 0.2 * shape + 0.1 * size + 0.1 * tests;
+}
+const SIMILARITY_THRESHOLD = 0.5;
+/**
+ * Predict CI/follow-up trouble probability for the given diff.
+ *
+ * @param store - the indexed store
+ * @param diffText - unified diff text (e.g. `git diff --staged` output)
+ * @param windowDays - how long after a past commit do we still count a
+ *                     follow-up as "trouble" (default 14)
+ */
+export function predict(store, diffText, windowDays = 14) {
+    const parsed = parseDiff(diffText);
+    const fp = fingerprint(parsed);
+    // Pull all commits from the store + their files.
+    // Only consider recent-enough commits (skip ancient history).
+    const commitRows = store.db
+        .prepare(`SELECT * FROM commits ORDER BY author_date DESC LIMIT 1000`)
+        .all();
+    if (commitRows.length === 0) {
+        return {
+            fingerprint: fp,
+            similarN: 0,
+            cleanN: 0,
+            pClean: 0,
+            verdict: "unknown",
+            recommendation: "Index the repo first (mneme index) — no historical signal yet.",
+        };
+    }
+    const commits = [];
+    for (const r of commitRows) {
+        const hash = String(r.hash);
+        const files = store.db.prepare("SELECT path FROM file_changes WHERE commit_hash = ?").all(hash).map((x) => x.path);
+        commits.push({
+            hash,
+            shortHash: String(r.short_hash),
+            authorName: String(r.author_name),
+            authorEmail: String(r.author_email),
+            authorDate: String(r.author_date),
+            committerDate: String(r.committer_date),
+            subject: String(r.subject),
+            body: String(r.body || ""),
+            parents: r.parents ? String(r.parents).split(/\s+/).filter(Boolean) : [],
+            files,
+        });
+    }
+    // Compute similarity for each historical commit.
+    const scored = [];
+    for (const c of commits) {
+        const cFp = fingerprintFromCommit(c);
+        const sim = similarity(fp, cFp);
+        if (sim >= SIMILARITY_THRESHOLD)
+            scored.push({ commit: c, sim, fp: cFp });
+    }
+    scored.sort((a, b) => b.sim - a.sim);
+    // Top 50 most-similar commits are our base.
+    const similar = scored.slice(0, 50);
+    const similarN = similar.length;
+    if (similarN === 0) {
+        return {
+            fingerprint: fp,
+            similarN: 0,
+            cleanN: 0,
+            pClean: 0,
+            verdict: "unknown",
+            recommendation: "No similar past changes in this repo. Treat as exploratory — small commits, careful review.",
+        };
+    }
+    // Detect regrets ONLY among the similar commits (constrain corpus).
+    // Use only strong regret signals (revert/hotfix/fix) — the weaker
+    // 'sameFiles' kind is too noisy for failure prediction.
+    const similarHashes = new Set(similar.map((s) => s.commit.hash));
+    const allRegrets = detectRegrets(commits, { windowDays });
+    const troubledHashes = new Set(allRegrets
+        .filter((r) => r.kind !== "sameFiles" && similarHashes.has(r.shipped.hash))
+        .map((r) => r.shipped.hash));
+    const cleanN = similarN - troubledHashes.size;
+    const pClean = cleanN / similarN;
+    // Find most-similar past commit (top of scored list) and its outcome.
+    const top = similar[0];
+    const mostSimilar = {
+        hash: top.commit.shortHash || top.commit.hash.slice(0, 7),
+        subject: top.commit.subject,
+        date: top.commit.authorDate.slice(0, 10),
+        outcome: troubledHashes.has(top.commit.hash) ? "trouble" : "clean",
+    };
+    const verdict = similarN < 5
+        ? "unknown"
+        : pClean >= 0.85
+            ? "clear"
+            : pClean >= 0.6
+                ? "moderate"
+                : "risky";
+    const recommendation = buildRecommendation(verdict, similarN, troubledHashes.size, pClean);
+    return {
+        fingerprint: fp,
+        similarN,
+        cleanN,
+        pClean,
+        verdict,
+        mostSimilar,
+        recommendation,
+    };
+}
+function fingerprintFromCommit(c) {
+    // Reconstruct a parsed-diff-like view from commit metadata.
+    const files = c.files ?? [];
+    const modules = [
+        ...new Set(files.map((f) => {
+            const parts = f.split("/");
+            return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : parts[0];
+        })),
+    ].sort();
+    const exts = new Set();
+    for (const f of files) {
+        const m = f.match(/\.([a-z0-9]+)$/i);
+        if (m)
+            exts.add(m[1].toLowerCase());
+    }
+    // Shape from subject conventions.
+    const subjectLower = c.subject.toLowerCase();
+    const shape = /^fix|^hotfix|^bug/.test(subjectLower)
+        ? "fix"
+        : /^refactor/.test(subjectLower)
+            ? "refactor"
+            : /^docs?|^chore/.test(subjectLower)
+                ? "docs"
+                : /^test/.test(subjectLower)
+                    ? "test"
+                    : /^perf/.test(subjectLower)
+                        ? "perf"
+                        : "feat";
+    // We don't have line counts; treat as "small" by default.
+    const hasTests = files.some((f) => /(\.test\.|\.spec\.|\/tests?\/)/.test(f));
+    return { modules, extensions: [...exts].sort(), shape, size: "small", hasTests };
+}
+function buildRecommendation(verdict, similarN, troubledN, pClean) {
+    switch (verdict) {
+        case "unknown":
+            return `Only ${similarN} similar past change${similarN === 1 ? "" : "s"} in history — too thin to predict. Run tests locally before pushing.`;
+        case "clear":
+            return `${(pClean * 100).toFixed(0)}% of ${similarN} similar past changes shipped cleanly. Looks like a routine change.`;
+        case "moderate":
+            return `${troubledN} of ${similarN} similar past changes needed a follow-up fix. Run lint + tests locally first.`;
+        case "risky":
+            return `${troubledN} of ${similarN} similar past changes needed a follow-up fix (${(pClean * 100).toFixed(0)}% clean rate). Strongly consider splitting this commit + extra review.`;
+    }
+}
+//# sourceMappingURL=crystal-ball.js.map

package/dist/insights/crystal-ball.js.map

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

package/dist/insights/crystal-ball.test.d.ts

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

package/dist/insights/crystal-ball.test.d.ts.map

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

package/dist/insights/crystal-ball.test.js

@@ -0,0 +1,157 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { MnemeStore } from "../store/sqlite.js";
+import { fingerprint, similarity, predict } from "./crystal-ball.js";
+import { parseDiff } from "./commit-coach.js";
+let tmpDir;
+let store;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "mneme-cb-test-"));
+    store = new MnemeStore(join(tmpDir, "mneme.db"));
+});
+afterEach(() => {
+    store.close();
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+const cmt = (hash, author, date, subject, files) => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: author,
+    authorEmail: `${author}@x`,
+    authorDate: `${date}T00:00:00Z`,
+    committerDate: `${date}T00:00:00Z`,
+    subject,
+    body: "",
+    parents: [],
+    files,
+});
+function seed(commits) {
+    store.upsertCommits(commits);
+    for (const c of commits) {
+        store.upsertFileChanges(c.files.map((f) => ({
+            commitHash: c.hash,
+            path: f,
+            changeKind: "M",
+            insertions: 1,
+            deletions: 0,
+        })));
+    }
+}
+describe("fingerprint", () => {
+    it("extracts modules, extensions, shape, size, hasTests", () => {
+        const diff = parseDiff(`diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        const fp = fingerprint(diff);
+        expect(fp.modules).toEqual(["src/auth"]);
+        expect(fp.extensions).toEqual(["ts"]);
+        expect(fp.size).toBe("tiny");
+        expect(fp.hasTests).toBe(false);
+    });
+    it("flags hasTests when *.test.ts present", () => {
+        const diff = parseDiff(`diff --git a/src/foo.test.ts b/src/foo.test.ts
++test('x', () => {});`);
+        expect(fingerprint(diff).hasTests).toBe(true);
+    });
+    it("size buckets are tiny/small/medium/large by line count", () => {
+        const tiny = fingerprint({ files: [], modules: [], added: 5, removed: 5, shape: "feat" });
+        const small = fingerprint({ files: [], modules: [], added: 50, removed: 30, shape: "feat" });
+        const medium = fingerprint({ files: [], modules: [], added: 200, removed: 200, shape: "feat" });
+        const large = fingerprint({ files: [], modules: [], added: 800, removed: 100, shape: "feat" });
+        expect(tiny.size).toBe("tiny");
+        expect(small.size).toBe("small");
+        expect(medium.size).toBe("medium");
+        expect(large.size).toBe("large");
+    });
+});
+describe("similarity", () => {
+    const fp = (overrides = {}) => ({
+        modules: ["src/auth"],
+        extensions: ["ts"],
+        shape: "feat",
+        size: "small",
+        hasTests: false,
+        ...overrides,
+    });
+    it("identical fingerprints score 1.0", () => {
+        expect(similarity(fp(), fp())).toBe(1);
+    });
+    it("module overlap dominates the score (40% weight)", () => {
+        const a = fp({ modules: ["src/auth"] });
+        const b = fp({ modules: ["src/payment"] });
+        // No module overlap → modules contributes 0
+        // Same exts (1.0 × 0.2), shape (0.2), size (0.1), tests (0.1) = 0.6
+        expect(similarity(a, b)).toBeCloseTo(0.6, 1);
+    });
+    it("size distance reduces score linearly", () => {
+        const a = fp({ size: "tiny" });
+        const b = fp({ size: "large" });
+        const s = similarity(a, b);
+        // Other dims identical (0.9 weight), size dim 0
+        expect(s).toBeCloseTo(0.9, 1);
+    });
+});
+describe("predict — empty repo edge case", () => {
+    it("returns 'unknown' verdict when repo is empty", () => {
+        const p = predict(store, "diff --git a/src/x.ts b/src/x.ts\n+const x = 1;");
+        expect(p.verdict).toBe("unknown");
+        expect(p.similarN).toBe(0);
+        expect(p.recommendation.toLowerCase()).toMatch(/index|signal/);
+    });
+});
+describe("predict — clean prediction", () => {
+    it("predicts 'clear' when most similar past changes shipped cleanly", () => {
+        const seedCommits = Array.from({ length: 20 }, (_, i) => cmt(`a${i}1234567`, "alice", `2024-08-${String((i % 28) + 1).padStart(2, "0")}`, `feat(auth): add thing ${i}`, ["src/auth/jwt.ts"]));
+        seed(seedCommits);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(p.similarN).toBeGreaterThan(0);
+        expect(p.verdict).toBe("clear");
+        expect(p.pClean).toBeGreaterThan(0.8);
+    });
+});
+describe("predict — risky prediction", () => {
+    it("predicts 'risky' when many similar past changes needed follow-up fixes", () => {
+        const commits = [];
+        // 10 pairs of (shipped, fix-2-days-later) on src/auth
+        for (let i = 0; i < 10; i++) {
+            const day = String(i * 3 + 1).padStart(2, "0");
+            const fixDay = String(i * 3 + 3).padStart(2, "0");
+            commits.push(cmt(`a${i}_____`, "alice", `2024-08-${day}`, `feat(auth): add thing ${i}`, ["src/auth/jwt.ts"]));
+            commits.push(cmt(`b${i}_____`, "alice", `2024-08-${fixDay}`, `fix: thing ${i} broke`, ["src/auth/jwt.ts"]));
+        }
+        seed(commits);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(p.similarN).toBeGreaterThanOrEqual(5);
+        expect(["risky", "moderate"]).toContain(p.verdict);
+        expect(p.pClean).toBeLessThan(0.7);
+    });
+});
+describe("predict — low signal verdict", () => {
+    it("returns 'unknown' when similar count is below 5", () => {
+        seed([
+            cmt("a1", "alice", "2024-08-01", "feat: thing", ["src/auth/jwt.ts"]),
+            cmt("a2", "alice", "2024-08-02", "feat: thing 2", ["src/auth/jwt.ts"]),
+        ]);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(["unknown", "clear"]).toContain(p.verdict);
+        if (p.similarN < 5)
+            expect(p.verdict).toBe("unknown");
+    });
+});
+describe("predict — most-similar reference", () => {
+    it("returns the most-similar past commit alongside the prediction", () => {
+        seed([
+            cmt("a1xxxxxx", "alice", "2024-08-01", "feat(auth): unique subject", ["src/auth/jwt.ts"]),
+            ...Array.from({ length: 10 }, (_, i) => cmt(`b${i}xxxxxx`, "alice", `2024-09-${String(i + 1).padStart(2, "0")}`, `feat: misc`, ["src/other/foo.ts"])),
+        ]);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(p.mostSimilar?.hash).toBeDefined();
+        expect(["clean", "trouble"]).toContain(p.mostSimilar?.outcome);
+    });
+});
+//# sourceMappingURL=crystal-ball.test.js.map

package/dist/insights/crystal-ball.test.js.map

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

package/dist/insights/decisions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `decisions` — auto-extract architectural decisions (ADRs) from commit
+ * history. The classic "we should write ADRs" never works in practice;
+ * instead, extract them from the commit messages that *already exist*.
+ *
+ * The extractor is intentionally conservative — it triggers on a small set
+ * of high-precision patterns ("decided to", "switched from X to Y",
+ * "replaced X with Y", "deprecate X"). False positives are worse than
+ * false negatives here: an ADR list with garbage erodes trust faster than
+ * a thin one builds it.
+ */
+import type { Commit } from "../types.js";
+export interface ExtractedDecision {
+    /** Commit hash where the decision was recorded. */
+    commitHash: string;
+    shortHash: string;
+    date: string;
+    author: string;
+    /** A 1-line summary of the decision, drawn from the matched span. */
+    summary: string;
+    /** Optional rationale clause, when the message includes "because"/"so that". */
+    rationale?: string;
+    /** The pattern that fired — for transparency. */
+    kind: "decided-to" | "switched" | "replaced" | "deprecated" | "chose-over" | "instead-of" | "migrated" | "adopted" | "rejected";
+    /** Confidence score in [0, 1]; calibrated from pattern specificity. */
+    confidence: number;
+}
+/**
+ * Extract every decision in a single commit's text (subject + body + PR
+ * title + PR body). Returns 0..N decisions; one commit can record several.
+ */
+export declare function extractDecisions(commit: Commit): ExtractedDecision[];
+/**
+ * Render a list of decisions as a Markdown table. Useful for
+ * `mneme decisions --format markdown > docs/ADR.md`.
+ */
+export declare function renderDecisionsAsMarkdown(decisions: ExtractedDecision[]): string;
+//# sourceMappingURL=decisions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/insights/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EACA,YAAY,GACZ,UAAU,GACV,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,UAAU,CAAC;IACf,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;CACpB;AAyCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAyCpE;AA2BD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAgBhF"}

package/dist/insights/decisions.js

@@ -0,0 +1,125 @@
+/**
+ * `decisions` — auto-extract architectural decisions (ADRs) from commit
+ * history. The classic "we should write ADRs" never works in practice;
+ * instead, extract them from the commit messages that *already exist*.
+ *
+ * The extractor is intentionally conservative — it triggers on a small set
+ * of high-precision patterns ("decided to", "switched from X to Y",
+ * "replaced X with Y", "deprecate X"). False positives are worse than
+ * false negatives here: an ADR list with garbage erodes trust faster than
+ * a thin one builds it.
+ */
+/**
+ * Patterns ordered by specificity. The first matching pattern wins.
+ * Each match exposes the decision text via the `text` group.
+ */
+const PATTERNS = [
+    // Highest specificity: explicit "decided to ..."
+    { kind: "decided-to", re: /\b(?:we\s+)?decided\s+to\s+(?<text>[^.\n;]{8,200})/gi, confidence: 0.95 },
+    // Switched / migrated FROM A TO B
+    { kind: "switched", re: /\bswitch(?:ed)?\s+from\s+(?<from>[^.\n;]{2,80})\s+to\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.9 },
+    { kind: "migrated", re: /\bmigrat(?:e|ed)\s+from\s+(?<from>[^.\n;]{2,80})\s+to\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.9 },
+    // Replaced X with Y
+    { kind: "replaced", re: /\breplaced?\s+(?<from>[^.\n;]{2,80})\s+with\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.85 },
+    // Chose X over Y
+    { kind: "chose-over", re: /\bch(?:ose|ooses?)\s+(?<text>[^.\n;]{2,80})\s+over\s+(?<from>[^.\n;]{2,80})/gi, confidence: 0.85 },
+    // Use X instead of Y — text is lazy so it stops at "instead" instead of greedily eating it.
+    { kind: "instead-of", re: /\b(?:use|using|used)\s+(?<text>\S[^.\n;]*?)\s+instead\s+of\s+(?<from>[^.\n;]{2,80})/gi, confidence: 0.8 },
+    // Adopted X
+    { kind: "adopted", re: /\b(?:we\s+)?adopt(?:ed|ing)?\s+(?<text>[^.\n;]{4,120})/gi, confidence: 0.65 },
+    // Deprecated X / Deprecate X
+    { kind: "deprecated", re: /\bdeprecat(?:e|ed|ing)\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.75 },
+    // Rejected (the opposite — a decision NOT to do something)
+    { kind: "rejected", re: /\b(?:we\s+)?reject(?:ed|ing)?\s+(?<text>[^.\n;]{4,120})/gi, confidence: 0.6 },
+];
+const RATIONALE_RE = /\b(?:because|so\s+that|in\s+order\s+to|due\s+to)\s+(?<rationale>[^.\n;]{4,200})/i;
+/**
+ * Extract every decision in a single commit's text (subject + body + PR
+ * title + PR body). Returns 0..N decisions; one commit can record several.
+ */
+export function extractDecisions(commit) {
+    const fullText = [commit.subject, commit.body, commit.prTitle, commit.prBody]
+        .filter(Boolean)
+        .join("\n");
+    if (!fullText)
+        return [];
+    const found = [];
+    const seen = new Set(); // dedupe by summary text
+    for (const p of PATTERNS) {
+        // Re-create regex per call to reset lastIndex.
+        const re = new RegExp(p.re.source, p.re.flags);
+        let m;
+        while ((m = re.exec(fullText)) !== null) {
+            const text = (m.groups?.text ?? "").trim();
+            const from = (m.groups?.from ?? "").trim();
+            // Min 2 chars — code identifiers like "Go", "DB", "JS", "Map" are real.
+            if (!text || text.length < 2)
+                continue;
+            const summary = buildSummary(p.kind, text, from);
+            if (seen.has(summary.toLowerCase()))
+                continue;
+            seen.add(summary.toLowerCase());
+            // Look for a rationale within ~120 chars after the match.
+            const tail = fullText.slice(m.index, m.index + m[0].length + 200);
+            const ratMatch = RATIONALE_RE.exec(tail);
+            const rationale = ratMatch?.groups?.rationale?.trim();
+            found.push({
+                commitHash: commit.hash,
+                shortHash: commit.shortHash || commit.hash.slice(0, 7),
+                date: commit.authorDate.slice(0, 10),
+                author: commit.authorName,
+                summary,
+                rationale: rationale || undefined,
+                kind: p.kind,
+                confidence: p.confidence,
+            });
+        }
+    }
+    return found;
+}
+function buildSummary(kind, text, from) {
+    const t = text.replace(/\s+/g, " ").replace(/^[,:\s]+|[,:\s]+$/g, "");
+    const f = from.replace(/\s+/g, " ").replace(/^[,:\s]+|[,:\s]+$/g, "");
+    switch (kind) {
+        case "decided-to":
+            return `decided to ${t}`;
+        case "switched":
+            return `switched from ${f} to ${t}`;
+        case "migrated":
+            return `migrated from ${f} to ${t}`;
+        case "replaced":
+            return `replaced ${f} with ${t}`;
+        case "chose-over":
+            return `chose ${t} over ${f}`;
+        case "instead-of":
+            return `using ${t} instead of ${f}`;
+        case "adopted":
+            return `adopted ${t}`;
+        case "deprecated":
+            return `deprecated ${t}`;
+        case "rejected":
+            return `rejected ${t}`;
+    }
+}
+/**
+ * Render a list of decisions as a Markdown table. Useful for
+ * `mneme decisions --format markdown > docs/ADR.md`.
+ */
+export function renderDecisionsAsMarkdown(decisions) {
+    if (decisions.length === 0) {
+        return "# Architecture Decisions\n\n(no decisions extracted — try richer commit messages)\n";
+    }
+    const lines = [];
+    lines.push("# Architecture Decisions (auto-extracted)");
+    lines.push("");
+    lines.push("| Date | Author | Decision | Rationale | Source |");
+    lines.push("|---|---|---|---|---|");
+    for (const d of decisions) {
+        const decision = d.summary.replace(/\|/g, "\\|");
+        const rationale = (d.rationale ?? "").replace(/\|/g, "\\|");
+        lines.push(`| ${d.date} | ${d.author} | ${decision} | ${rationale} | \`${d.shortHash}\` |`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=decisions.js.map

package/dist/insights/decisions.js.map

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

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

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

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

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