@mneme-ai/core 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -9,4 +9,5 @@ export * as enrich from "./enrich/index.js";
 export * as util from "./util/index.js";
 export * as wisdom from "./wisdom/index.js";
 export * as insights from "./insights/index.js";
+export * as quant from "./quant/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -9,4 +9,5 @@ export * as enrich from "./enrich/index.js";
 export * as util from "./util/index.js";
 export * as wisdom from "./wisdom/index.js";
 export * as insights from "./insights/index.js";
+export * as quant from "./quant/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/insights/bus-factor.d.ts

@@ -0,0 +1,58 @@
+/**
+ * `mneme bus-factor` — surface single-source-of-truth knowledge holders.
+ *
+ * For each indexed file: compute author distribution. Files where one
+ * author owns >75% of commits AND the file is touched frequently are
+ * "fragile knowledge zones" — if that person leaves, the knowledge dies.
+ *
+ * This is different from `who-knows`:
+ *   - `who-knows`  → "who knows about X?"   (answer + backup)
+ *   - `bus-factor` → "what knowledge is fragile?"  (per-file ownership risk)
+ *
+ * Output ranks by criticality = ownerShare × log(touchCount). High-touch
+ * solo-owned files are the highest risk. Concrete pairing recommendations
+ * are attached when a backup author exists.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+export interface FileRisk {
+    filePath: string;
+    /** Total commits that touched this file. */
+    totalTouches: number;
+    /** Top owner — name + email + share. */
+    topOwner: {
+        name: string;
+        email: string;
+        touches: number;
+        sharePct: number;
+        lastTouch: string;
+    };
+    /** Closest second-place author (for pair recommendation). Undefined if solo-only. */
+    backup?: {
+        name: string;
+        email: string;
+        touches: number;
+        lastTouch: string;
+    };
+    /**
+     * Risk tier from criticality score:
+     *   critical: ownerShare ≥ 0.85 AND touches ≥ 10
+     *   high:     ownerShare ≥ 0.75 AND touches ≥ 5
+     *   medium:   ownerShare ≥ 0.6  AND touches ≥ 3
+     *   low:      everything else (still surfaced when solo-touched)
+     */
+    tier: "critical" | "high" | "medium" | "low";
+    /** Numeric criticality — for sorting. */
+    score: number;
+    /** A 1-line lesson/recommendation. */
+    recommendation: string;
+}
+export interface BusFactorOptions {
+    /** Skip files that match these glob-like fragments. Defaults to lockfiles, generated dirs. */
+    excludePatterns?: string[];
+    /** Minimum touches for a file to be considered. Below this we don't have enough signal. */
+    minTouches?: number;
+    /** Cap on results returned. */
+    topN?: number;
+}
+export declare function busFactor(store: MnemeStore, opts?: BusFactorOptions): FileRisk[];
+//# sourceMappingURL=bus-factor.d.ts.map

package/dist/insights/bus-factor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus-factor.d.ts","sourceRoot":"","sources":["../../src/insights/bus-factor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChG,qFAAqF;IACrF,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E;;;;;;OAMG;IACH,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC7C,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAaD,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,gBAAqB,GAAG,QAAQ,EAAE,CA8EpF"}

package/dist/insights/bus-factor.js

@@ -0,0 +1,117 @@
+/**
+ * `mneme bus-factor` — surface single-source-of-truth knowledge holders.
+ *
+ * For each indexed file: compute author distribution. Files where one
+ * author owns >75% of commits AND the file is touched frequently are
+ * "fragile knowledge zones" — if that person leaves, the knowledge dies.
+ *
+ * This is different from `who-knows`:
+ *   - `who-knows`  → "who knows about X?"   (answer + backup)
+ *   - `bus-factor` → "what knowledge is fragile?"  (per-file ownership risk)
+ *
+ * Output ranks by criticality = ownerShare × log(touchCount). High-touch
+ * solo-owned files are the highest risk. Concrete pairing recommendations
+ * are attached when a backup author exists.
+ */
+const DEFAULT_EXCLUDES = [
+    "package-lock.json",
+    "yarn.lock",
+    "pnpm-lock.yaml",
+    "node_modules/",
+    "dist/",
+    ".min.js",
+    ".min.css",
+    "/generated/",
+];
+export function busFactor(store, opts = {}) {
+    const minTouches = opts.minTouches ?? 3;
+    const excludes = opts.excludePatterns ?? DEFAULT_EXCLUDES;
+    const topN = opts.topN ?? 20;
+    // Aggregate per-file author counts via JOIN of file_changes + commits.
+    const rows = store.db
+        .prepare(`SELECT
+         fc.path                                       AS path,
+         c.author_name                                 AS author_name,
+         c.author_email                                AS author_email,
+         COUNT(*)                                      AS touches,
+         MAX(c.author_date)                            AS last_touch
+       FROM file_changes fc
+       JOIN commits c ON c.hash = fc.commit_hash
+       GROUP BY fc.path, c.author_name, c.author_email
+       ORDER BY fc.path, touches DESC`)
+        .all();
+    const byFile = new Map();
+    for (const r of rows) {
+        if (excludes.some((p) => r.path.includes(p)))
+            continue;
+        if (!byFile.has(r.path))
+            byFile.set(r.path, { filePath: r.path, authors: [], totalTouches: 0 });
+        const b = byFile.get(r.path);
+        b.authors.push({ name: r.author_name, email: r.author_email, touches: r.touches, lastTouch: r.last_touch });
+        b.totalTouches += r.touches;
+    }
+    const risks = [];
+    for (const b of byFile.values()) {
+        if (b.totalTouches < minTouches)
+            continue;
+        b.authors.sort((a, c) => c.touches - a.touches);
+        const top = b.authors[0];
+        const sharePct = Math.round((top.touches / b.totalTouches) * 100);
+        const share = top.touches / b.totalTouches;
+        const score = share * Math.log2(b.totalTouches + 1);
+        const { tier, recommendation } = classifyRisk(share, b.totalTouches, b.authors);
+        risks.push({
+            filePath: b.filePath,
+            totalTouches: b.totalTouches,
+            topOwner: {
+                name: top.name,
+                email: top.email,
+                touches: top.touches,
+                sharePct,
+                lastTouch: top.lastTouch,
+            },
+            backup: b.authors[1]
+                ? {
+                    name: b.authors[1].name,
+                    email: b.authors[1].email,
+                    touches: b.authors[1].touches,
+                    lastTouch: b.authors[1].lastTouch,
+                }
+                : undefined,
+            tier,
+            score,
+            recommendation,
+        });
+    }
+    risks.sort((a, b) => b.score - a.score);
+    return risks.slice(0, topN);
+}
+function classifyRisk(share, touches, authors) {
+    if (share >= 0.85 && touches >= 10) {
+        return {
+            tier: "critical",
+            recommendation: authors.length > 1
+                ? `Pair with ${authors[1].name} this sprint — they are the only backup signal in history.`
+                : "Find a pairing partner before this person leaves. No backup currently exists.",
+        };
+    }
+    if (share >= 0.75 && touches >= 5) {
+        return {
+            tier: "high",
+            recommendation: authors.length > 1
+                ? `Encourage ${authors[1].name} to pick up small changes here to spread the knowledge.`
+                : "Solo-owned. Pair-program the next change to spread context.",
+        };
+    }
+    if (share >= 0.6 && touches >= 3) {
+        return {
+            tier: "medium",
+            recommendation: "Knowledge is concentrated but not critical. Watch for owner departure.",
+        };
+    }
+    return {
+        tier: "low",
+        recommendation: "Knowledge is reasonably distributed.",
+    };
+}
+//# sourceMappingURL=bus-factor.js.map

package/dist/insights/bus-factor.js.map

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

package/dist/insights/bus-factor.test.d.ts

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

package/dist/insights/bus-factor.test.d.ts.map

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

package/dist/insights/bus-factor.test.js

@@ -0,0 +1,149 @@
+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 { busFactor } from "./bus-factor.js";
+let tmpDir;
+let store;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "mneme-busfactor-test-"));
+    store = new MnemeStore(join(tmpDir, "mneme.db"));
+});
+afterEach(() => {
+    store.close();
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+const cmt = (hash, author, date, files) => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: author,
+    authorEmail: `${author}@x`,
+    authorDate: `${date}T00:00:00Z`,
+    committerDate: `${date}T00:00:00Z`,
+    subject: `commit by ${author}`,
+    body: "",
+    parents: [],
+    files,
+});
+function seed(commits) {
+    store.upsertCommits(commits);
+    for (const c of commits) {
+        const changes = c.files.map((f) => ({
+            commitHash: c.hash,
+            path: f,
+            changeKind: "M",
+            insertions: 1,
+            deletions: 0,
+        }));
+        store.upsertFileChanges(changes);
+    }
+}
+describe("busFactor — risk tier classification", () => {
+    it("flags CRITICAL when one author owns ≥85% AND ≥10 touches", () => {
+        const commits = [];
+        for (let i = 0; i < 9; i++)
+            commits.push(cmt(`a${i}1234567`, "alice", `2024-08-0${(i % 9) + 1}`, ["src/payment.ts"]));
+        commits.push(cmt("b0123456", "bob", "2024-09-01", ["src/payment.ts"]));
+        seed(commits);
+        const risks = busFactor(store, { minTouches: 1 });
+        const payment = risks.find((r) => r.filePath === "src/payment.ts");
+        expect(payment.tier).toBe("critical");
+        expect(payment.topOwner.name).toBe("alice");
+        expect(payment.topOwner.sharePct).toBe(90);
+        expect(payment.recommendation.toLowerCase()).toContain("bob");
+    });
+    it("flags HIGH when one author owns 75-85% with 5+ touches", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", ["src/auth.ts"]),
+            cmt("a2", "alice", "2024-08-02", ["src/auth.ts"]),
+            cmt("a3", "alice", "2024-08-03", ["src/auth.ts"]),
+            cmt("a4", "alice", "2024-08-04", ["src/auth.ts"]),
+            cmt("a5", "alice", "2024-08-05", ["src/auth.ts"]),
+            cmt("a6", "alice", "2024-08-06", ["src/auth.ts"]),
+            cmt("b1", "bob", "2024-08-07", ["src/auth.ts"]),
+            cmt("b2", "bob", "2024-08-08", ["src/auth.ts"]),
+        ];
+        seed(commits);
+        const risks = busFactor(store, { minTouches: 1 });
+        const auth = risks.find((r) => r.filePath === "src/auth.ts");
+        expect(auth.tier).toBe("high");
+        expect(auth.topOwner.sharePct).toBe(75);
+    });
+    it("flags MEDIUM when share is 60-75%", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", ["src/x.ts"]),
+            cmt("a2", "alice", "2024-08-02", ["src/x.ts"]),
+            cmt("a3", "alice", "2024-08-03", ["src/x.ts"]),
+            cmt("b1", "bob", "2024-08-04", ["src/x.ts"]),
+            cmt("b2", "bob", "2024-08-05", ["src/x.ts"]),
+        ];
+        seed(commits);
+        const risks = busFactor(store, { minTouches: 1 });
+        const x = risks.find((r) => r.filePath === "src/x.ts");
+        expect(x.tier).toBe("medium");
+        expect(x.topOwner.sharePct).toBe(60);
+    });
+});
+describe("busFactor — backup recommendation", () => {
+    it("includes the second-place author as the backup", () => {
+        const commits = [
+            ...Array.from({ length: 9 }, (_, i) => cmt(`a${i}`, "alice", `2024-08-0${(i % 9) + 1}`, ["x.ts"])),
+            cmt("b1", "bob", "2024-09-01", ["x.ts"]),
+            cmt("c1", "carol", "2024-09-02", ["x.ts"]),
+        ];
+        seed(commits);
+        const risks = busFactor(store, { minTouches: 1 });
+        const x = risks.find((r) => r.filePath === "x.ts");
+        expect(x.backup?.name).toBeDefined();
+        expect(["bob", "carol"]).toContain(x.backup?.name);
+    });
+    it("backup undefined when only one author has ever touched the file", () => {
+        const commits = Array.from({ length: 5 }, (_, i) => cmt(`a${i}`, "alice", `2024-08-0${i + 1}`, ["solo.ts"]));
+        seed(commits);
+        const risks = busFactor(store, { minTouches: 1 });
+        const solo = risks.find((r) => r.filePath === "solo.ts");
+        expect(solo.backup).toBeUndefined();
+        expect(solo.recommendation.toLowerCase()).toMatch(/no backup|spread/);
+    });
+});
+describe("busFactor — filtering and sorting", () => {
+    it("excludes lockfiles + generated dirs by default", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", ["package-lock.json", "src/x.ts"]),
+            cmt("a2", "alice", "2024-08-02", ["package-lock.json", "src/x.ts"]),
+            cmt("a3", "alice", "2024-08-03", ["package-lock.json", "src/x.ts"]),
+        ];
+        seed(commits);
+        const risks = busFactor(store, { minTouches: 1 });
+        expect(risks.find((r) => r.filePath === "package-lock.json")).toBeUndefined();
+        expect(risks.find((r) => r.filePath === "src/x.ts")).toBeDefined();
+    });
+    it("respects minTouches threshold", () => {
+        const commits = [cmt("a1", "alice", "2024-08-01", ["lonely.ts"])];
+        seed(commits);
+        expect(busFactor(store, { minTouches: 2 })).toEqual([]);
+        expect(busFactor(store, { minTouches: 1 })).toHaveLength(1);
+    });
+    it("sorts by criticality score (high-touch solo > low-touch solo)", () => {
+        const commits = [
+            ...Array.from({ length: 12 }, (_, i) => cmt(`a${i}`, "alice", `2024-08-${String(i + 1).padStart(2, "0")}`, ["hot.ts"])),
+            ...Array.from({ length: 3 }, (_, i) => cmt(`b${i}`, "alice", `2024-09-0${i + 1}`, ["cold.ts"])),
+        ];
+        seed(commits);
+        const risks = busFactor(store, { minTouches: 1 });
+        expect(risks[0].filePath).toBe("hot.ts");
+        expect(risks[0].score).toBeGreaterThan(risks[1].score);
+    });
+    it("respects topN limit", () => {
+        const commits = [];
+        for (let f = 0; f < 30; f++) {
+            for (let i = 0; i < 3; i++) {
+                commits.push(cmt(`f${f}c${i}`.padEnd(7, "x"), "alice", `2024-08-${String((i % 28) + 1).padStart(2, "0")}`, [`f${f}.ts`]));
+            }
+        }
+        seed(commits);
+        expect(busFactor(store, { minTouches: 1, topN: 5 })).toHaveLength(5);
+    });
+});
+//# sourceMappingURL=bus-factor.test.js.map

package/dist/insights/bus-factor.test.js.map

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

package/dist/insights/commit-coach.d.ts

@@ -0,0 +1,80 @@
+/**
+ * `mneme commit-coach` — pre-commit assistant.
+ *
+ * Reads a unified diff (from `git diff --staged` or stdin) and produces
+ * a structured advice payload covering:
+ *   1. Suggested commit message (style-matched to repo's history).
+ *   2. Recommended reviewers (top experts on touched files).
+ *   3. Scope warning (touching too many modules → suggest splitting).
+ *   4. Past-regret check (this pattern caused INC-X before).
+ *
+ * Pure data analysis. The CLI optionally calls an LLM to polish the
+ * commit message; everything else is heuristic + store queries.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+export interface ParsedDiff {
+    files: string[];
+    /** Unique top-2-segment modules (e.g. "src/payment", "src/auth"). */
+    modules: string[];
+    /** Total lines added across all hunks. */
+    added: number;
+    /** Total lines removed across all hunks. */
+    removed: number;
+    /** Type guess based on file paths + line counts. */
+    shape: "feat" | "fix" | "refactor" | "test" | "docs" | "chore" | "perf";
+}
+export interface Reviewer {
+    name: string;
+    email: string;
+    /** % of commits on the touched files attributable to this person. */
+    ownership: number;
+    /** Files this reviewer is the primary owner of (within touched set). */
+    ownedFiles: string[];
+}
+export interface RegretWarning {
+    pattern: string;
+    pastCommitHash: string;
+    pastDate: string;
+    outcome: string;
+}
+export interface CoachAdvice {
+    /** What the diff looks like. */
+    diff: ParsedDiff;
+    /** Suggested commit message subject (style-matched). */
+    suggestedSubject: string;
+    /** Top 3 recommended reviewers. */
+    reviewers: Reviewer[];
+    /** Scope diagnosis — module count + verdict. */
+    scopeOK: boolean;
+    scopeMessage: string;
+    /** Past-regret warnings if similar past changes regretted. */
+    warnings: RegretWarning[];
+}
+/**
+ * Parse a unified diff string. Best-effort — handles standard `git diff`
+ * output. Skips binary diffs and file-mode changes.
+ */
+export declare function parseDiff(diffText: string): ParsedDiff;
+/**
+ * Look up the top reviewer per touched file (the file's largest contributor).
+ * Aggregates across files to find the people most worth requesting review from.
+ */
+export declare function recommendReviewers(store: MnemeStore, files: string[], topN?: number): Reviewer[];
+/**
+ * Suggest a commit message based on the diff shape + style of recent
+ * commits in the repo. Returns a Conventional-Commits-style subject line.
+ */
+export declare function suggestSubject(diff: ParsedDiff, recentSubjects: string[]): string;
+/** Diagnose scope creep. Touching > 3 modules is usually too much for one commit. */
+export declare function checkScope(diff: ParsedDiff): {
+    scopeOK: boolean;
+    message: string;
+};
+/**
+ * Check past regrets: any commit touching the same files where the
+ * follow-up was a fix/revert? If so, surface as a warning.
+ */
+export declare function checkPastRegrets(store: MnemeStore, files: string[]): RegretWarning[];
+/** End-to-end coach: parse → recommend → diagnose. Pure-ish (reads the store). */
+export declare function coach(store: MnemeStore, diffText: string): CoachAdvice;
+//# sourceMappingURL=commit-coach.d.ts.map

package/dist/insights/commit-coach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-coach.d.ts","sourceRoot":"","sources":["../../src/insights/commit-coach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CACzE;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAmCtD;AAkBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,SAAI,GAAG,QAAQ,EAAE,CAyD3F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAiBjF;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAYlF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAmDpF;AAED,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAqBtE"}