@mneme-ai/core 0.8.4 → 0.10.0

package/dist/quant/correlation-matrix.js.map

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

package/dist/quant/correlation-matrix.test.d.ts

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

package/dist/quant/correlation-matrix.test.d.ts.map

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

package/dist/quant/correlation-matrix.test.js

@@ -0,0 +1,118 @@
+import { describe, it, expect } from "vitest";
+import { correlationMatrix, classifyCouplingTier } from "./correlation-matrix.js";
+const cmt = (hash, date, files) => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: "alice",
+    authorEmail: "a@x",
+    authorDate: `${date}T00:00:00Z`,
+    committerDate: `${date}T00:00:00Z`,
+    subject: "x",
+    body: "",
+    parents: [],
+    files,
+});
+describe("classifyCouplingTier", () => {
+    it("'tight' when both jaccard ≥ 0.6 + lift ≥ 5", () => {
+        expect(classifyCouplingTier(0.7, 6)).toBe("tight");
+    });
+    it("'strong' when one of jaccard ≥ 0.4 or lift ≥ 3", () => {
+        expect(classifyCouplingTier(0.5, 1)).toBe("strong");
+        expect(classifyCouplingTier(0.1, 4)).toBe("strong");
+    });
+    it("'moderate' for middling values", () => {
+        expect(classifyCouplingTier(0.25, 2)).toBe("moderate");
+    });
+    it("'weak' otherwise", () => {
+        expect(classifyCouplingTier(0.05, 1.2)).toBe("weak");
+    });
+});
+describe("correlationMatrix — basic detection", () => {
+    it("returns empty when there are no co-occurring file pairs", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", ["src/a.ts"]),
+            cmt("a2", "2024-01-02", ["src/b.ts"]),
+            cmt("a3", "2024-01-03", ["src/c.ts"]),
+        ];
+        expect(correlationMatrix(commits)).toEqual([]);
+    });
+    it("detects a tightly-coupled pair when both files always change together", () => {
+        // 10 co-touched commits + 20 background commits on unrelated files.
+        // Background commits lower the baseline rate of x and y so that
+        // co-occurrence has lift > 1.5 (otherwise lift = 1 and is filtered out).
+        const co = Array.from({ length: 10 }, (_, i) => cmt(`c${i}`.padEnd(7, "x"), `2024-01-${String(i + 1).padStart(2, "0")}`, ["src/x.ts", "src/y.ts"]));
+        const bg = Array.from({ length: 20 }, (_, i) => cmt(`bg${i}`.padEnd(7, "x"), `2024-02-${String((i % 28) + 1).padStart(2, "0")}`, [`src/other${i}.ts`]));
+        const pairs = correlationMatrix([...co, ...bg], { minFileTouches: 3, minCoOccurrences: 2 });
+        const xy = pairs.find((p) => (p.fileA === "src/x.ts" && p.fileB === "src/y.ts") ||
+            (p.fileA === "src/y.ts" && p.fileB === "src/x.ts"));
+        expect(xy).toBeDefined();
+        expect(xy.jaccard).toBeCloseTo(1, 3);
+        expect(xy.tier).toBe("tight");
+    });
+    it("respects minFileTouches threshold", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", ["src/x.ts", "src/y.ts"]),
+            cmt("a2", "2024-01-02", ["src/x.ts", "src/y.ts"]),
+        ];
+        expect(correlationMatrix(commits, { minFileTouches: 5 })).toEqual([]);
+        expect(correlationMatrix(commits, { minFileTouches: 1, minCoOccurrences: 1, minLift: 0 })).toHaveLength(1);
+    });
+    it("respects minCoOccurrences threshold", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", ["src/x.ts", "src/y.ts"]),
+            cmt("a2", "2024-01-02", ["src/x.ts"]),
+            cmt("a3", "2024-01-03", ["src/y.ts"]),
+            cmt("a4", "2024-01-04", ["src/x.ts"]),
+        ];
+        expect(correlationMatrix(commits, { minFileTouches: 1, minCoOccurrences: 3 })).toEqual([]);
+    });
+    it("respects minLift threshold (filters weak pairs)", () => {
+        // Build a noisy history where x and y co-occur but at random level
+        const commits = [];
+        for (let i = 0; i < 20; i++)
+            commits.push(cmt(`x${i}`.padEnd(7, "y"), `2024-01-${String(i + 1).padStart(2, "0")}`, ["src/x.ts"]));
+        for (let i = 0; i < 20; i++)
+            commits.push(cmt(`y${i}`.padEnd(7, "x"), `2024-02-${String(i + 1).padStart(2, "0")}`, ["src/y.ts"]));
+        commits.push(cmt("co1", "2024-03-01", ["src/x.ts", "src/y.ts"]));
+        commits.push(cmt("co2", "2024-03-02", ["src/x.ts", "src/y.ts"]));
+        // 2 co-occurrences but x has 22 total, y has 22 total, so jaccard tiny + lift low
+        expect(correlationMatrix(commits, { minLift: 5 })).toEqual([]);
+    });
+});
+describe("correlationMatrix — sort + tiers", () => {
+    it("sorts by lift desc", () => {
+        const commits = [
+            // Pair 1: TIGHT (5 co-occurrences, files appear in nothing else).
+            cmt("a1", "2024-01-01", ["src/tight-a.ts", "src/tight-b.ts"]),
+            cmt("a2", "2024-01-02", ["src/tight-a.ts", "src/tight-b.ts"]),
+            cmt("a3", "2024-01-03", ["src/tight-a.ts", "src/tight-b.ts"]),
+            cmt("a4", "2024-01-04", ["src/tight-a.ts", "src/tight-b.ts"]),
+            cmt("a5", "2024-01-05", ["src/tight-a.ts", "src/tight-b.ts"]),
+            // Pair 2: LOOSER (3 co, but both files also touched alone — diluted lift).
+            cmt("b1", "2024-02-01", ["src/loose-a.ts", "src/loose-b.ts"]),
+            cmt("b2", "2024-02-02", ["src/loose-a.ts", "src/loose-b.ts"]),
+            cmt("b3", "2024-02-03", ["src/loose-a.ts", "src/loose-b.ts"]),
+            cmt("b4", "2024-02-04", ["src/loose-a.ts"]),
+            cmt("b5", "2024-02-05", ["src/loose-a.ts"]),
+            cmt("b6", "2024-02-06", ["src/loose-b.ts"]),
+            cmt("b7", "2024-02-07", ["src/loose-b.ts"]),
+            // Background — 15 commits on unrelated files lower the global baseline,
+            // so even the tight pair has lift > 1.5 (otherwise lift = 1 and filtered).
+            ...Array.from({ length: 15 }, (_, i) => cmt(`bg${i}`.padEnd(7, "x"), `2024-03-${String(i + 1).padStart(2, "0")}`, [`src/other${i}.ts`])),
+        ];
+        const pairs = correlationMatrix(commits, { minFileTouches: 3, minCoOccurrences: 2 });
+        expect(pairs[0].fileA).toMatch(/tight-/);
+        expect(pairs[0].lift).toBeGreaterThan(pairs[pairs.length - 1].lift);
+    });
+    it("respects topN", () => {
+        const commits = [];
+        // 10 file pairs, each with 4 co-occurrences
+        for (let p = 0; p < 10; p++) {
+            for (let i = 0; i < 4; i++) {
+                commits.push(cmt(`p${p}c${i}`.padEnd(7, "x"), `2024-${String(p + 1).padStart(2, "0")}-0${i + 1}`, [`src/p${p}-a.ts`, `src/p${p}-b.ts`]));
+            }
+        }
+        expect(correlationMatrix(commits, { minFileTouches: 1, minCoOccurrences: 2, topN: 5, minLift: 0 }).length).toBeLessThanOrEqual(5);
+    });
+});
+//# sourceMappingURL=correlation-matrix.test.js.map

package/dist/quant/correlation-matrix.test.js.map

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

package/dist/quant/drawdown.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `mneme drawdown` — find the worst "losing streaks" in repo history.
+ *
+ * In finance, a drawdown is a peak-to-trough decline. In a codebase, it's
+ * a stretch of bug-fix-only commits with no feature progress — pure
+ * firefighting. Surfacing these is gold for retrospectives:
+ *
+ *   "We spent 3 weeks last September shipping nothing but fixes."
+ *
+ * Pure data analysis. No LLM. Tested via TDD against synthetic histories.
+ */
+import type { Commit } from "../types.js";
+export interface Drawdown {
+    /** Start commit (peak — last feat before the drawdown). */
+    startHash: string;
+    startDate: string;
+    /** End commit (trough — last fix in the streak). */
+    endHash: string;
+    endDate: string;
+    /** Number of consecutive non-feat commits in the streak. */
+    length: number;
+    /** Days between start and end. */
+    durationDays: number;
+    /** Sample fix subjects from inside the streak (up to 3). */
+    sampleFixes: string[];
+    /** Severity tier from length × duration. */
+    tier: "minor" | "moderate" | "severe" | "critical";
+}
+/** Decide whether a commit subject is a "fix" (counts toward drawdown). */
+export declare function isFixCommit(c: Commit): boolean;
+/** Decide whether a commit subject is a "feature" (resets the streak). */
+export declare function isFeatCommit(c: Commit): boolean;
+/**
+ * Detect drawdowns — runs of ≥ minLength consecutive non-feat commits
+ * where ≥ fixRatio of those commits are explicit fixes.
+ */
+export declare function detectDrawdowns(commits: Commit[], opts?: {
+    minLength?: number;
+    fixRatio?: number;
+    topN?: number;
+}): Drawdown[];
+export declare function classifyDrawdown(length: number, durationDays: number): Drawdown["tier"];
+export interface DrawdownSummary {
+    total: number;
+    longestStreak: number;
+    totalFixingDays: number;
+    /** Fraction of the repo's lifespan spent in drawdown. */
+    drawdownFraction: number;
+}
+export declare function summarizeDrawdowns(commits: Commit[], drawdowns: Drawdown[]): DrawdownSummary;
+//# sourceMappingURL=drawdown.d.ts.map

package/dist/quant/drawdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawdown.d.ts","sourceRoot":"","sources":["../../src/quant/drawdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4CAA4C;IAC5C,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;CACpD;AAKD,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,QAAQ,EAAE,CA4CZ;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAKvF;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,eAAe,CAiB5F"}

package/dist/quant/drawdown.js

@@ -0,0 +1,96 @@
+/**
+ * `mneme drawdown` — find the worst "losing streaks" in repo history.
+ *
+ * In finance, a drawdown is a peak-to-trough decline. In a codebase, it's
+ * a stretch of bug-fix-only commits with no feature progress — pure
+ * firefighting. Surfacing these is gold for retrospectives:
+ *
+ *   "We spent 3 weeks last September shipping nothing but fixes."
+ *
+ * Pure data analysis. No LLM. Tested via TDD against synthetic histories.
+ */
+const FEAT_RE = /^feat[(:]/i;
+const FIX_RE = /^(fix|hotfix|bug|revert|patch)[(:]/i;
+/** Decide whether a commit subject is a "fix" (counts toward drawdown). */
+export function isFixCommit(c) {
+    return FIX_RE.test(c.subject);
+}
+/** Decide whether a commit subject is a "feature" (resets the streak). */
+export function isFeatCommit(c) {
+    return FEAT_RE.test(c.subject);
+}
+/**
+ * Detect drawdowns — runs of ≥ minLength consecutive non-feat commits
+ * where ≥ fixRatio of those commits are explicit fixes.
+ */
+export function detectDrawdowns(commits, opts = {}) {
+    const minLength = opts.minLength ?? 3;
+    const fixRatio = opts.fixRatio ?? 0.5;
+    const topN = opts.topN ?? 10;
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    const out = [];
+    let i = 0;
+    while (i < sorted.length) {
+        if (isFeatCommit(sorted[i])) {
+            i += 1;
+            continue;
+        }
+        // Walk forward while non-feat.
+        let j = i;
+        let fixCount = 0;
+        while (j < sorted.length && !isFeatCommit(sorted[j])) {
+            if (isFixCommit(sorted[j]))
+                fixCount += 1;
+            j += 1;
+        }
+        const length = j - i;
+        const ratio = length === 0 ? 0 : fixCount / length;
+        if (length >= minLength && ratio >= fixRatio) {
+            const start = sorted[i];
+            const end = sorted[j - 1];
+            const dur = (new Date(end.authorDate).getTime() - new Date(start.authorDate).getTime()) / 86_400_000;
+            const samples = sorted.slice(i, j).filter(isFixCommit).slice(0, 3).map((c) => c.subject);
+            out.push({
+                startHash: start.shortHash || start.hash.slice(0, 7),
+                startDate: start.authorDate.slice(0, 10),
+                endHash: end.shortHash || end.hash.slice(0, 7),
+                endDate: end.authorDate.slice(0, 10),
+                length,
+                durationDays: Math.round(dur * 10) / 10,
+                sampleFixes: samples,
+                tier: classifyDrawdown(length, dur),
+            });
+        }
+        i = j === i ? i + 1 : j;
+    }
+    // Sort by severity (length × duration), desc.
+    out.sort((a, b) => b.length * Math.max(b.durationDays, 1) - a.length * Math.max(a.durationDays, 1));
+    return out.slice(0, topN);
+}
+export function classifyDrawdown(length, durationDays) {
+    if (length >= 15 || durationDays >= 30)
+        return "critical";
+    if (length >= 8 || durationDays >= 14)
+        return "severe";
+    if (length >= 5 || durationDays >= 7)
+        return "moderate";
+    return "minor";
+}
+export function summarizeDrawdowns(commits, drawdowns) {
+    if (commits.length === 0) {
+        return { total: 0, longestStreak: 0, totalFixingDays: 0, drawdownFraction: 0 };
+    }
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    const repoSpan = (new Date(sorted[sorted.length - 1].authorDate).getTime() -
+        new Date(sorted[0].authorDate).getTime()) /
+        86_400_000;
+    const totalFixingDays = drawdowns.reduce((s, d) => s + d.durationDays, 0);
+    const longest = drawdowns.reduce((m, d) => Math.max(m, d.length), 0);
+    return {
+        total: drawdowns.length,
+        longestStreak: longest,
+        totalFixingDays: Math.round(totalFixingDays * 10) / 10,
+        drawdownFraction: repoSpan === 0 ? 0 : totalFixingDays / repoSpan,
+    };
+}
+//# sourceMappingURL=drawdown.js.map

package/dist/quant/drawdown.js.map

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

package/dist/quant/drawdown.test.d.ts

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

package/dist/quant/drawdown.test.d.ts.map

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

package/dist/quant/drawdown.test.js

@@ -0,0 +1,166 @@
+import { describe, it, expect } from "vitest";
+import { detectDrawdowns, summarizeDrawdowns, isFeatCommit, isFixCommit, classifyDrawdown, } from "./drawdown.js";
+const cmt = (hash, date, subject) => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: "alice",
+    authorEmail: "alice@x",
+    authorDate: `${date}T00:00:00Z`,
+    committerDate: `${date}T00:00:00Z`,
+    subject,
+    body: "",
+    parents: [],
+    files: [],
+});
+describe("isFeatCommit / isFixCommit — Conventional-Commit subject classifiers", () => {
+    it("matches feat( and feat:", () => {
+        expect(isFeatCommit(cmt("a", "2024-01-01", "feat: thing"))).toBe(true);
+        expect(isFeatCommit(cmt("a", "2024-01-01", "feat(auth): thing"))).toBe(true);
+        expect(isFeatCommit(cmt("a", "2024-01-01", "feat scoped without colon"))).toBe(false);
+    });
+    it("matches fix/hotfix/bug/revert/patch", () => {
+        expect(isFixCommit(cmt("a", "2024-01-01", "fix: x"))).toBe(true);
+        expect(isFixCommit(cmt("a", "2024-01-01", "hotfix: x"))).toBe(true);
+        expect(isFixCommit(cmt("a", "2024-01-01", "bug: x"))).toBe(true);
+        expect(isFixCommit(cmt("a", "2024-01-01", "revert: x"))).toBe(true);
+        expect(isFixCommit(cmt("a", "2024-01-01", "feat: x"))).toBe(false);
+    });
+});
+describe("classifyDrawdown — tier from length × duration", () => {
+    it("critical at 15+ commits or 30+ days", () => {
+        expect(classifyDrawdown(15, 5)).toBe("critical");
+        expect(classifyDrawdown(5, 30)).toBe("critical");
+    });
+    it("severe at 8+ or 14+", () => {
+        expect(classifyDrawdown(8, 5)).toBe("severe");
+        expect(classifyDrawdown(5, 14)).toBe("severe");
+    });
+    it("moderate at 5+ or 7+", () => {
+        expect(classifyDrawdown(5, 1)).toBe("moderate");
+        expect(classifyDrawdown(3, 7)).toBe("moderate");
+    });
+    it("minor for short streaks", () => {
+        expect(classifyDrawdown(3, 2)).toBe("minor");
+    });
+});
+describe("detectDrawdowns — simple cases", () => {
+    it("returns empty when no fix commits", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "feat: B"),
+            cmt("a3", "2024-01-03", "feat: C"),
+        ];
+        expect(detectDrawdowns(commits)).toEqual([]);
+    });
+    it("returns empty when streak shorter than minLength", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "fix: x"),
+            cmt("a3", "2024-01-03", "fix: y"),
+            cmt("a4", "2024-01-04", "feat: B"),
+        ];
+        expect(detectDrawdowns(commits, { minLength: 3 })).toEqual([]);
+    });
+    it("detects a single drawdown of 5 fixes between two feats", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "fix: 1"),
+            cmt("a3", "2024-01-03", "fix: 2"),
+            cmt("a4", "2024-01-04", "fix: 3"),
+            cmt("a5", "2024-01-05", "fix: 4"),
+            cmt("a6", "2024-01-06", "fix: 5"),
+            cmt("a7", "2024-01-07", "feat: B"),
+        ];
+        const drawdowns = detectDrawdowns(commits, { minLength: 3 });
+        expect(drawdowns).toHaveLength(1);
+        expect(drawdowns[0].length).toBe(5);
+        expect(drawdowns[0].tier).toBe("moderate");
+        expect(drawdowns[0].sampleFixes).toHaveLength(3);
+    });
+    it("detects multiple separate drawdowns", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "fix: 1"),
+            cmt("a3", "2024-01-03", "fix: 2"),
+            cmt("a4", "2024-01-04", "fix: 3"),
+            cmt("a5", "2024-01-05", "feat: B"),
+            cmt("a6", "2024-01-06", "fix: 4"),
+            cmt("a7", "2024-01-07", "fix: 5"),
+            cmt("a8", "2024-01-08", "fix: 6"),
+            cmt("a9", "2024-01-09", "fix: 7"),
+            cmt("a10", "2024-01-10", "feat: C"),
+        ];
+        const drawdowns = detectDrawdowns(commits, { minLength: 3 });
+        expect(drawdowns).toHaveLength(2);
+    });
+    it("respects fixRatio threshold (mixed chore/fix streaks)", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "fix: 1"),
+            cmt("a3", "2024-01-03", "chore: bump deps"),
+            cmt("a4", "2024-01-04", "chore: lint config"),
+            cmt("a5", "2024-01-05", "feat: B"),
+        ];
+        // 1/3 fix ratio — below default 0.5
+        expect(detectDrawdowns(commits, { minLength: 3, fixRatio: 0.5 })).toEqual([]);
+        expect(detectDrawdowns(commits, { minLength: 3, fixRatio: 0.3 })).toHaveLength(1);
+    });
+    it("sorts drawdowns by severity descending", () => {
+        const commits = [
+            // Drawdown 1: 4 fixes
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "fix: 1"),
+            cmt("a3", "2024-01-03", "fix: 2"),
+            cmt("a4", "2024-01-04", "fix: 3"),
+            cmt("a5", "2024-01-05", "fix: 4"),
+            cmt("a6", "2024-01-06", "feat: B"),
+            // Drawdown 2: 8 fixes (more severe)
+            cmt("b1", "2024-02-01", "fix: 1"),
+            cmt("b2", "2024-02-02", "fix: 2"),
+            cmt("b3", "2024-02-03", "fix: 3"),
+            cmt("b4", "2024-02-04", "fix: 4"),
+            cmt("b5", "2024-02-05", "fix: 5"),
+            cmt("b6", "2024-02-06", "fix: 6"),
+            cmt("b7", "2024-02-07", "fix: 7"),
+            cmt("b8", "2024-02-08", "fix: 8"),
+            cmt("b9", "2024-02-09", "feat: C"),
+        ];
+        const drawdowns = detectDrawdowns(commits, { minLength: 3 });
+        expect(drawdowns[0].length).toBe(8);
+        expect(drawdowns[1].length).toBe(4);
+    });
+    it("respects topN cap", () => {
+        const commits = [];
+        for (let i = 0; i < 30; i++) {
+            const day = String(i + 1).padStart(2, "0");
+            commits.push(cmt(`f${i}`, `2024-01-${day}`, "feat: x"));
+            commits.push(cmt(`x${i}`, `2024-01-${day}`, "fix: 1"));
+            commits.push(cmt(`y${i}`, `2024-01-${day}`, "fix: 2"));
+            commits.push(cmt(`z${i}`, `2024-01-${day}`, "fix: 3"));
+        }
+        expect(detectDrawdowns(commits, { minLength: 3, topN: 5 }).length).toBeLessThanOrEqual(5);
+    });
+});
+describe("summarizeDrawdowns — repo-level metrics", () => {
+    it("computes drawdown fraction over repo lifespan", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-08", "fix: 1"), // 7 days into lifespan
+            cmt("a3", "2024-01-15", "fix: 2"),
+            cmt("a4", "2024-01-22", "fix: 3"),
+            cmt("a5", "2024-02-01", "feat: B"), // 31 days total
+        ];
+        const drawdowns = detectDrawdowns(commits, { minLength: 3 });
+        const summary = summarizeDrawdowns(commits, drawdowns);
+        expect(summary.total).toBe(1);
+        expect(summary.longestStreak).toBe(3);
+        expect(summary.drawdownFraction).toBeGreaterThan(0);
+        expect(summary.drawdownFraction).toBeLessThan(1);
+    });
+    it("returns zero metrics for empty commits", () => {
+        const summary = summarizeDrawdowns([], []);
+        expect(summary.total).toBe(0);
+        expect(summary.drawdownFraction).toBe(0);
+    });
+});
+//# sourceMappingURL=drawdown.test.js.map

package/dist/quant/drawdown.test.js.map

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

package/dist/quant/greek.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `mneme greek` — sensitivity analysis (Δ Γ Θ ν) for a codebase.
+ *
+ *   Δ DELTA  — sensitivity to the top contributor (% knowledge lost if X quits)
+ *   Γ GAMMA  — acceleration of risk (super-linear scaling of bug rate vs PR rate)
+ *   Θ THETA  — time decay (untouched files lose coverage over time)
+ *   ν VEGA   — sensitivity to dependency volatility (placeholder for now)
+ *
+ * Pure analysis. Delta + Gamma are required and computed from store data.
+ * Theta is best-effort (depends on coverage indexed). Vega returns null
+ * unless dependency manifest data is available — honestly.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+export interface DeltaResult {
+    /** The author name. */
+    name: string;
+    /** Email. */
+    email: string;
+    /** Files where this author owns ≥ 75% of touches. */
+    ownedFiles: string[];
+    /** Approximate % of knowledge that walks out the door if they quit. */
+    knowledgeLossPct: number;
+}
+export declare function computeDelta(store: MnemeStore, opts?: {
+    topN?: number;
+}): DeltaResult[];
+export interface GammaResult {
+    /** Slope of (commits per week) → (fix-commits per week). */
+    riskAcceleration: number;
+    /** Sample size — number of weekly buckets used. */
+    weeks: number;
+    /** Plain-English interpretation. */
+    interpretation: string;
+}
+export declare function computeGamma(store: MnemeStore): GammaResult;
+export interface ThetaResult {
+    /** Files untouched for > 6 months. */
+    staleFiles: number;
+    /** Average days since last touch across stale set. */
+    avgStaleDays: number;
+    /** Plain-English interpretation. */
+    interpretation: string;
+}
+export declare function computeTheta(store: MnemeStore, opts?: {
+    now?: Date;
+}): ThetaResult;
+export interface GreekReport {
+    delta: DeltaResult[];
+    gamma: GammaResult;
+    theta: ThetaResult;
+}
+export declare function computeGreeks(store: MnemeStore, opts?: {
+    now?: Date;
+}): GreekReport;
+//# sourceMappingURL=greek.d.ts.map

package/dist/quant/greek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"greek.d.ts","sourceRoot":"","sources":["../../src/quant/greek.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,EAAE,CAwD3F;AAID,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CA0C3D;AA4BD,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GAAG,WAAW,CA6BtF;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GAAG,WAAW,CAMvF"}