@mneme-ai/core 0.9.0 → 0.11.0

package/dist/insights/commit-coach.js

@@ -0,0 +1,230 @@
+/**
+ * `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 { detectRegrets } from "./regret.js";
+/**
+ * Parse a unified diff string. Best-effort — handles standard `git diff`
+ * output. Skips binary diffs and file-mode changes.
+ */
+export function parseDiff(diffText) {
+    const files = [];
+    let added = 0;
+    let removed = 0;
+    const lines = diffText.split("\n");
+    for (const line of lines) {
+        if (line.startsWith("diff --git")) {
+            // Format: diff --git a/path b/path
+            const m = line.match(/^diff --git a\/(.+?) b\/(.+)$/);
+            if (m)
+                files.push(m[2]);
+        }
+        else if (line.startsWith("+") && !line.startsWith("+++")) {
+            added += 1;
+        }
+        else if (line.startsWith("-") && !line.startsWith("---")) {
+            removed += 1;
+        }
+    }
+    // Modules: first 2 path segments.
+    const modules = [
+        ...new Set(files.map((f) => {
+            const parts = f.split("/");
+            return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : parts[0];
+        })),
+    ];
+    return {
+        files,
+        modules,
+        added,
+        removed,
+        shape: classifyShape(files, added, removed),
+    };
+}
+function classifyShape(files, added, removed) {
+    if (files.length === 0)
+        return "chore";
+    const allTests = files.every((f) => /(\.test\.|\.spec\.|\/tests?\/|\/specs?\/)/.test(f));
+    if (allTests)
+        return "test";
+    const allDocs = files.every((f) => /(\.md$|\/docs?\/)/i.test(f));
+    if (allDocs)
+        return "docs";
+    // Refactor: balanced add/remove (within 30%) AND no obvious test changes
+    if (removed > 0 && added > 0 && Math.abs(added - removed) / Math.max(added, removed) < 0.3 && removed > 5) {
+        return "refactor";
+    }
+    // Heavy removals → likely a fix or refactor
+    if (removed > added * 2)
+        return "fix";
+    // Default: feat for new code
+    return "feat";
+}
+/**
+ * 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 function recommendReviewers(store, files, topN = 3) {
+    if (files.length === 0)
+        return [];
+    // For each touched file, find the dominant author.
+    const placeholders = files.map(() => "?").join(",");
+    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
+       FROM file_changes fc
+       JOIN commits c ON c.hash = fc.commit_hash
+       WHERE fc.path IN (${placeholders})
+       GROUP BY fc.path, c.author_name, c.author_email
+       ORDER BY fc.path, touches DESC`)
+        .all(...files);
+    // Group by file → top author.
+    const fileTotals = new Map();
+    const fileTopAuthor = new Map();
+    for (const r of rows) {
+        fileTotals.set(r.path, (fileTotals.get(r.path) ?? 0) + r.touches);
+        if (!fileTopAuthor.has(r.path)) {
+            fileTopAuthor.set(r.path, { name: r.author_name, email: r.author_email, touches: r.touches });
+        }
+    }
+    const byAuthor = new Map();
+    for (const [file, top] of fileTopAuthor) {
+        const total = fileTotals.get(file) ?? 1;
+        const share = top.touches / total;
+        const key = `${top.name}|${top.email}`;
+        if (!byAuthor.has(key))
+            byAuthor.set(key, { name: top.name, email: top.email, ownedFiles: [], ownershipScore: 0 });
+        const b = byAuthor.get(key);
+        b.ownedFiles.push(file);
+        b.ownershipScore += share;
+    }
+    return [...byAuthor.values()]
+        .map((b) => ({
+        name: b.name,
+        email: b.email,
+        ownership: Math.round((b.ownershipScore / files.length) * 100),
+        ownedFiles: b.ownedFiles,
+    }))
+        .sort((a, b) => b.ownership - a.ownership)
+        .slice(0, topN);
+}
+/**
+ * Suggest a commit message based on the diff shape + style of recent
+ * commits in the repo. Returns a Conventional-Commits-style subject line.
+ */
+export function suggestSubject(diff, recentSubjects) {
+    const usesConventional = recentSubjects.some((s) => /^[a-z]+(\([^)]+\))?:\s/.test(s));
+    const scope = diff.modules[0]?.replace(/^src\//, "") ?? "";
+    const scopeStr = scope ? `(${scope})` : "";
+    // Hint from filename if obvious
+    const hint = diff.files
+        .map((f) => f.split("/").pop().replace(/\.(ts|js|tsx|jsx|py|go|rb|md)$/, ""))
+        .filter((n) => n.length >= 3)
+        .slice(0, 2)
+        .join(" ");
+    if (!usesConventional) {
+        // Fall back to imperative subject
+        return `${diff.shape}: ${hint || "update " + (diff.modules[0] ?? "code")}`;
+    }
+    return `${diff.shape}${scopeStr}: ${hint || "update " + diff.modules[0]?.split("/").pop()}`;
+}
+/** Diagnose scope creep. Touching > 3 modules is usually too much for one commit. */
+export function checkScope(diff) {
+    if (diff.modules.length === 0)
+        return { scopeOK: true, message: "No files staged." };
+    if (diff.modules.length === 1) {
+        return { scopeOK: true, message: `Focused on ${diff.modules[0]}.` };
+    }
+    if (diff.modules.length <= 3) {
+        return { scopeOK: true, message: `${diff.modules.length} modules touched: ${diff.modules.join(", ")}.` };
+    }
+    return {
+        scopeOK: false,
+        message: `Scope creep — ${diff.modules.length} modules touched (${diff.modules.slice(0, 3).join(", ")}, …). Consider splitting into ${diff.modules.length} commits.`,
+    };
+}
+/**
+ * Check past regrets: any commit touching the same files where the
+ * follow-up was a fix/revert? If so, surface as a warning.
+ */
+export function checkPastRegrets(store, files) {
+    if (files.length === 0)
+        return [];
+    // Pull every commit that touched at least one of the files.
+    const placeholders = files.map(() => "?").join(",");
+    const commitRows = store.db
+        .prepare(`SELECT DISTINCT c.* FROM commits c
+       JOIN file_changes fc ON fc.commit_hash = c.hash
+       WHERE fc.path IN (${placeholders})
+       ORDER BY c.author_date DESC
+       LIMIT 200`)
+        .all(...files);
+    const commits = [];
+    for (const r of commitRows) {
+        const hash = String(r.hash);
+        const filesOfCommit = 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: filesOfCommit,
+        });
+    }
+    const regrets = detectRegrets(commits, { windowDays: 14 });
+    // Convert to warnings — only for regrets where files overlap significantly.
+    const touchedSet = new Set(files);
+    const out = [];
+    for (const r of regrets) {
+        const overlap = (r.shipped.files ?? []).filter((f) => touchedSet.has(f));
+        if (overlap.length === 0)
+            continue;
+        out.push({
+            pattern: `Past change in ${overlap[0]} caused a ${r.kind} within ${r.daysToFix.toFixed(0)} days.`,
+            pastCommitHash: r.shipped.shortHash || r.shipped.hash.slice(0, 7),
+            pastDate: r.shipped.authorDate.slice(0, 10),
+            outcome: r.lesson || `${r.kind} within ${r.daysToFix.toFixed(0)} days`,
+        });
+    }
+    return out.slice(0, 3);
+}
+/** End-to-end coach: parse → recommend → diagnose. Pure-ish (reads the store). */
+export function coach(store, diffText) {
+    const diff = parseDiff(diffText);
+    const reviewers = recommendReviewers(store, diff.files, 3);
+    const scope = checkScope(diff);
+    const warnings = checkPastRegrets(store, diff.files);
+    const recentRows = store.db
+        .prepare(`SELECT subject FROM commits ORDER BY author_date DESC LIMIT 30`)
+        .all();
+    const recentSubjects = recentRows.map((r) => r.subject);
+    const suggestedSubject = suggestSubject(diff, recentSubjects);
+    return {
+        diff,
+        suggestedSubject,
+        reviewers,
+        scopeOK: scope.scopeOK,
+        scopeMessage: scope.message,
+        warnings,
+    };
+}
+//# sourceMappingURL=commit-coach.js.map

package/dist/insights/commit-coach.js.map

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

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

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

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

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

package/dist/insights/commit-coach.test.js

@@ -0,0 +1,163 @@
+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 { parseDiff, suggestSubject, checkScope, recommendReviewers, coach } from "./commit-coach.js";
+let tmpDir;
+let store;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "mneme-coach-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,
+        })));
+    }
+}
+const SAMPLE_DIFF = `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
+index abc..def 100644
+--- a/src/auth/jwt.ts
++++ b/src/auth/jwt.ts
+@@ -1,3 +1,5 @@
+ export function sign(payload) {
+-  return jwt.sign(payload, KEY);
++  return jwt.sign(payload, KEY, { expiresIn: "15m" });
+ }
++export function refresh(token) { return jwt.refresh(token); }
+diff --git a/src/auth/middleware.ts b/src/auth/middleware.ts
+index 111..222 100644
+--- a/src/auth/middleware.ts
++++ b/src/auth/middleware.ts
+@@ -10,2 +10,3 @@
+ export const authGuard = () => {
++  validateExpiry();
+ };
+`;
+describe("parseDiff", () => {
+    it("extracts file paths from `diff --git` headers", () => {
+        const d = parseDiff(SAMPLE_DIFF);
+        expect(d.files).toContain("src/auth/jwt.ts");
+        expect(d.files).toContain("src/auth/middleware.ts");
+    });
+    it("counts added and removed lines", () => {
+        const d = parseDiff(SAMPLE_DIFF);
+        expect(d.added).toBeGreaterThan(0);
+        expect(d.removed).toBeGreaterThan(0);
+    });
+    it("groups files into top-2-segment modules", () => {
+        const d = parseDiff(SAMPLE_DIFF);
+        expect(d.modules).toEqual(["src/auth"]);
+    });
+    it("classifies test-only diffs as 'test'", () => {
+        const d = parseDiff(`diff --git a/tests/unit/foo.test.ts b/tests/unit/foo.test.ts
++const x = 1;`);
+        expect(d.shape).toBe("test");
+    });
+    it("classifies docs-only diffs as 'docs'", () => {
+        const d = parseDiff(`diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
++- new bullet`);
+        expect(d.shape).toBe("docs");
+    });
+    it("classifies balanced add/remove ≥ 5 lines as 'refactor'", () => {
+        const lines = ["diff --git a/src/x.ts b/src/x.ts"];
+        for (let i = 0; i < 10; i++) {
+            lines.push(`-old line ${i}`);
+            lines.push(`+new line ${i}`);
+        }
+        expect(parseDiff(lines.join("\n")).shape).toBe("refactor");
+    });
+});
+describe("suggestSubject", () => {
+    it("uses Conventional Commits format when repo history shows it", () => {
+        const diff = parseDiff(SAMPLE_DIFF);
+        const subject = suggestSubject(diff, ["feat(auth): add jwt", "fix(auth): typo"]);
+        expect(subject).toMatch(/^[a-z]+\([^)]+\):\s/);
+    });
+    it("falls back to imperative subject when repo doesn't use Conventional", () => {
+        const diff = parseDiff(SAMPLE_DIFF);
+        const subject = suggestSubject(diff, ["update stuff", "fix bug"]);
+        expect(subject).not.toMatch(/^[a-z]+\(/);
+    });
+});
+describe("checkScope", () => {
+    it("approves single-module diffs", () => {
+        const diff = parseDiff(SAMPLE_DIFF);
+        const r = checkScope(diff);
+        expect(r.scopeOK).toBe(true);
+    });
+    it("warns at 4+ modules", () => {
+        const diff = {
+            files: [],
+            modules: ["src/a", "src/b", "src/c", "src/d", "src/e"],
+            added: 0,
+            removed: 0,
+            shape: "feat",
+        };
+        const r = checkScope(diff);
+        expect(r.scopeOK).toBe(false);
+        expect(r.message.toLowerCase()).toMatch(/scope creep|split/);
+    });
+});
+describe("recommendReviewers — store-backed", () => {
+    it("returns top reviewers ordered by ownership", () => {
+        seed([
+            cmt("a1", "alice", "2024-08-01", "fix", ["src/auth/jwt.ts"]),
+            cmt("a2", "alice", "2024-08-02", "fix", ["src/auth/jwt.ts"]),
+            cmt("a3", "alice", "2024-08-03", "fix", ["src/auth/jwt.ts"]),
+            cmt("b1", "bob", "2024-08-04", "fix", ["src/auth/middleware.ts"]),
+            cmt("b2", "bob", "2024-08-05", "fix", ["src/auth/middleware.ts"]),
+        ]);
+        const reviewers = recommendReviewers(store, ["src/auth/jwt.ts", "src/auth/middleware.ts"]);
+        expect(reviewers).toHaveLength(2);
+        expect(reviewers.map((r) => r.name).sort()).toEqual(["alice", "bob"]);
+    });
+    it("returns empty when no files provided", () => {
+        expect(recommendReviewers(store, [])).toEqual([]);
+    });
+});
+describe("coach — end-to-end", () => {
+    it("returns a complete CoachAdvice payload", () => {
+        seed([
+            cmt("a1", "alice", "2024-08-01", "feat(auth): add jwt", ["src/auth/jwt.ts"]),
+            cmt("a2", "alice", "2024-08-02", "fix(auth): typo", ["src/auth/jwt.ts"]),
+        ]);
+        const advice = coach(store, SAMPLE_DIFF);
+        expect(advice.diff.files.length).toBeGreaterThan(0);
+        expect(advice.suggestedSubject.length).toBeGreaterThan(0);
+        expect(advice.scopeMessage.length).toBeGreaterThan(0);
+    });
+    it("surfaces past-regret warnings when similar fixes happened recently", () => {
+        seed([
+            cmt("a1", "alice", "2024-08-01", "refactor: simplify session middleware", ["src/auth/middleware.ts"]),
+            cmt("a2", "alice", "2024-08-01", "hotfix: CSRF disappeared", ["src/auth/middleware.ts"]),
+        ]);
+        const advice = coach(store, SAMPLE_DIFF);
+        expect(advice.warnings.length).toBeGreaterThan(0);
+        expect(advice.warnings[0].pattern.toLowerCase()).toMatch(/middleware|hotfix/);
+    });
+});
+//# sourceMappingURL=commit-coach.test.js.map

package/dist/insights/commit-coach.test.js.map

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

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

@@ -0,0 +1,76 @@
+/**
+ * `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 type { MnemeStore } from "../store/sqlite.js";
+import { type ParsedDiff } from "./commit-coach.js";
+export interface DiffFingerprint {
+    /** Top-2-segment modules touched, sorted. */
+    modules: string[];
+    /** File extensions touched, sorted. */
+    extensions: string[];
+    /** "feat" / "fix" / "refactor" / etc. */
+    shape: ParsedDiff["shape"];
+    /** Total touch volume: added + removed. */
+    size: "tiny" | "small" | "medium" | "large";
+    /** Whether tests were also modified. */
+    hasTests: boolean;
+}
+export interface CrystalBallPrediction {
+    fingerprint: DiffFingerprint;
+    /** Number of similar past commits found. */
+    similarN: number;
+    /** Of those, how many had no follow-up regret. */
+    cleanN: number;
+    /** Probability of clean CI / no follow-up trouble (0..1). */
+    pClean: number;
+    /** Verdict label: clear / moderate / risky / unknown. */
+    verdict: "clear" | "moderate" | "risky" | "unknown";
+    /** Most-similar past commit (a concrete reference). */
+    mostSimilar?: {
+        hash: string;
+        subject: string;
+        date: string;
+        outcome: "clean" | "trouble";
+    };
+    /** A 1-line recommendation. */
+    recommendation: string;
+}
+export declare function fingerprint(diff: ParsedDiff): DiffFingerprint;
+/**
+ * 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 declare function similarity(a: DiffFingerprint, b: DiffFingerprint): number;
+/**
+ * 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 declare function predict(store: MnemeStore, diffText: string, windowDays?: number): CrystalBallPrediction;
+//# sourceMappingURL=crystal-ball.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crystal-ball.d.ts","sourceRoot":"","sources":["../../src/insights/crystal-ball.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/D,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,eAAe,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IACpD,uDAAuD;IACvD,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC;IAC5F,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAiB7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,MAAM,CAoBzE;AAID;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAK,GACd,qBAAqB,CA8GvB"}