@mneme-ai/core 0.9.0 → 0.11.0

package/dist/quant/implied-volatility.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect } from "vitest";
+import { scoreTone, impliedVolatility, summarizeVolatility } from "./implied-volatility.js";
+const cmt = (hash, date, subject, body = "") => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: "alice",
+    authorEmail: "a@x",
+    authorDate: `${date}T00:00:00Z`,
+    committerDate: `${date}T00:00:00Z`,
+    subject,
+    body,
+    parents: [],
+    files: [],
+});
+describe("scoreTone — calm vs frustrated commits", () => {
+    it("calm commit scores low tone", () => {
+        const t = scoreTone(cmt("a1", "2024-01-01", "feat: add new endpoint"));
+        expect(t.exclamationScore).toBe(0);
+        expect(t.allCapsScore).toBe(0);
+        expect(t.emojiScore).toBe(0);
+        expect(t.frictionScore).toBe(0);
+        expect(t.toneScore).toBeLessThan(0.1);
+    });
+    it("frustrated commit scores high tone", () => {
+        const t = scoreTone(cmt("a1", "2024-01-01", "OMG WTF this is BROKEN!!!", "kinda hopefully fixed??"));
+        expect(t.exclamationScore).toBeGreaterThan(0);
+        expect(t.allCapsScore).toBeGreaterThan(0);
+        expect(t.frictionScore).toBeGreaterThan(0);
+        expect(t.hedgeScore).toBeGreaterThan(0);
+        expect(t.toneScore).toBeGreaterThan(0.3);
+    });
+    it("emoji-laden commit raises emoji score", () => {
+        const t = scoreTone(cmt("a1", "2024-01-01", "fix prod 🔥💀⚠️"));
+        expect(t.emojiScore).toBeGreaterThan(0);
+    });
+    it("hedge words detected", () => {
+        const t = scoreTone(cmt("a1", "2024-01-01", "maybe fix race", "should work probably"));
+        expect(t.hedgeScore).toBeGreaterThanOrEqual(2);
+    });
+    it("toneScore is bounded [0, 1]", () => {
+        const samples = [
+            "feat: add",
+            "OMG WTF BROKEN!!!! 🔥💀 wtf wtf wtf maybe maybe maybe",
+            "",
+            "AAAAAAAA",
+        ];
+        for (const subj of samples) {
+            const t = scoreTone(cmt("x", "2024-01-01", subj));
+            expect(t.toneScore).toBeGreaterThanOrEqual(0);
+            expect(t.toneScore).toBeLessThanOrEqual(1);
+        }
+    });
+});
+describe("impliedVolatility — weekly aggregation", () => {
+    it("returns empty for empty input", () => {
+        expect(impliedVolatility([])).toEqual([]);
+    });
+    it("buckets by ISO week + computes IV in 0-100 range", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "feat: B"),
+            cmt("a3", "2024-01-08", "OMG BROKEN!!!"),
+            cmt("a4", "2024-01-09", "wtf this is hopeless"),
+        ];
+        const windows = impliedVolatility(commits);
+        expect(windows.length).toBeGreaterThanOrEqual(2);
+        for (const w of windows) {
+            expect(w.iv).toBeGreaterThanOrEqual(0);
+            expect(w.iv).toBeLessThanOrEqual(100);
+        }
+    });
+    it("higher tone week shows higher IV", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: A"),
+            cmt("a2", "2024-01-02", "feat: B"),
+            cmt("a3", "2024-01-08", "OMG WTF BROKEN!!!"),
+            cmt("a4", "2024-01-09", "ARGH crashed!!! ugh"),
+            cmt("a5", "2024-01-10", "fucking 🔥🔥🔥"),
+        ];
+        const windows = impliedVolatility(commits);
+        expect(windows.length).toBe(2);
+        expect(windows[1].iv).toBeGreaterThan(windows[0].iv);
+    });
+});
+describe("summarizeVolatility — trend detection", () => {
+    it("returns 'insufficient-data' for fewer than 4 weeks", () => {
+        const commits = [cmt("a", "2024-01-01", "feat: x")];
+        expect(summarizeVolatility(commits).trend).toBe("insufficient-data");
+    });
+    it("'rising' when last 4 weeks ascend", () => {
+        const commits = [
+            // Week 1: calm
+            cmt("a1", "2024-01-01", "feat: A"),
+            // Week 2: warming up
+            cmt("a2", "2024-01-08", "fix bug !!"),
+            // Week 3: hot
+            cmt("a3", "2024-01-15", "WTF BROKEN!!!"),
+            // Week 4: very hot
+            cmt("a4", "2024-01-22", "OMG WTF FUCKED 🔥💀 maybe hopefully fix?"),
+        ];
+        expect(summarizeVolatility(commits).trend).toBe("rising");
+    });
+    it("'falling' when last 4 weeks descend", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "OMG WTF FUCKED 🔥💀!!!!!"),
+            cmt("a2", "2024-01-08", "WTF still BROKEN!!!"),
+            cmt("a3", "2024-01-15", "kinda fix maybe"),
+            cmt("a4", "2024-01-22", "feat: stable release"),
+        ];
+        expect(summarizeVolatility(commits).trend).toBe("falling");
+    });
+    it("'flat' when 4 weeks are similar", () => {
+        const commits = [
+            cmt("a1", "2024-01-01", "feat: stable"),
+            cmt("a2", "2024-01-08", "feat: stable"),
+            cmt("a3", "2024-01-15", "feat: stable"),
+            cmt("a4", "2024-01-22", "feat: stable"),
+        ];
+        expect(summarizeVolatility(commits).trend).toBe("flat");
+    });
+    it("interpretation includes IV number + trend label", () => {
+        const commits = Array.from({ length: 4 }, (_, i) => cmt(`a${i}`, `2024-01-${String(i * 7 + 1).padStart(2, "0")}`, "feat: x"));
+        const r = summarizeVolatility(commits);
+        expect(r.interpretation).toMatch(/IV is/);
+    });
+});
+//# sourceMappingURL=implied-volatility.test.js.map

package/dist/quant/implied-volatility.test.js.map

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

package/dist/quant/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Sprint 5 — Wall Street meets Git.
+ *
+ * Quantitative analysis of codebase as if it were a market:
+ *   • drawdown          — worst losing streaks (firefighting periods)
+ *   • alpha             — Kelly criterion for technical-debt allocation
+ *   • backtest          — validate any predictor against actual outcomes
+ *   • black-swan        — rare-but-catastrophic file patterns
+ *   • insider-trading   — authors who fix bugs they introduced
+ *   • moneyball         — undervalued contributors (high impact, low LOC)
+ *   • greek             — sensitivity analysis (Δ Γ Θ)
+ *   • correlation-matrix— hidden behavioral coupling between files
+ *   • implied-volatility— project chaos predicted from commit message tone
+ *   • tax-loss-harvest  — dead code candidates that "offset" technical debt
+ *
+ * All pure analysis. No LLM. Each module is fully unit-tested.
+ */
+export * from "./drawdown.js";
+export * from "./alpha.js";
+export * from "./backtest.js";
+export * from "./black-swan.js";
+export * from "./insider-trading.js";
+export * from "./moneyball.js";
+export * from "./greek.js";
+export * from "./correlation-matrix.js";
+export * from "./implied-volatility.js";
+export * from "./tax-loss-harvest.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quant/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/quant/index.js

@@ -0,0 +1,28 @@
+/**
+ * Sprint 5 — Wall Street meets Git.
+ *
+ * Quantitative analysis of codebase as if it were a market:
+ *   • drawdown          — worst losing streaks (firefighting periods)
+ *   • alpha             — Kelly criterion for technical-debt allocation
+ *   • backtest          — validate any predictor against actual outcomes
+ *   • black-swan        — rare-but-catastrophic file patterns
+ *   • insider-trading   — authors who fix bugs they introduced
+ *   • moneyball         — undervalued contributors (high impact, low LOC)
+ *   • greek             — sensitivity analysis (Δ Γ Θ)
+ *   • correlation-matrix— hidden behavioral coupling between files
+ *   • implied-volatility— project chaos predicted from commit message tone
+ *   • tax-loss-harvest  — dead code candidates that "offset" technical debt
+ *
+ * All pure analysis. No LLM. Each module is fully unit-tested.
+ */
+export * from "./drawdown.js";
+export * from "./alpha.js";
+export * from "./backtest.js";
+export * from "./black-swan.js";
+export * from "./insider-trading.js";
+export * from "./moneyball.js";
+export * from "./greek.js";
+export * from "./correlation-matrix.js";
+export * from "./implied-volatility.js";
+export * from "./tax-loss-harvest.js";
+//# sourceMappingURL=index.js.map

package/dist/quant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/quant/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/quant/insider-trading.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `mneme insider-trading` — find authors who repeatedly fix bugs they
+ * themselves introduced.
+ *
+ * The pattern tells you two things at once:
+ *   1. This person has the deepest domain knowledge (only they understand
+ *      this code well enough to BOTH ship and break it).
+ *   2. They have an execution gap — knowing more isn't translating to
+ *      better quality.
+ *
+ * Concrete coaching opportunity: pair them with someone who has zero
+ * defects on the same files.
+ *
+ * Pure data. Detects pairs of (commit, follow-up commit) by SAME author
+ * touching the SAME files where the follow-up is a fix.
+ */
+import type { Commit } from "../types.js";
+export interface InsiderPattern {
+    /** Original commit that introduced the bug. */
+    shipped: Commit;
+    /** Same-author commit that fixed it. */
+    fixed: Commit;
+    /** Days between ship and fix. */
+    daysToFix: number;
+    /** The shared file path that triggered the match. */
+    sharedFile: string;
+}
+export interface InsiderProfile {
+    authorName: string;
+    authorEmail: string;
+    /** Number of self-introduced + self-fixed bug pairs. */
+    patternCount: number;
+    /** Files where the pattern repeats. */
+    affectedFiles: string[];
+    /** Sample patterns (up to 3) for display. */
+    samples: InsiderPattern[];
+    /** Risk tier — used for output labeling. */
+    tier: "high-pattern" | "elevated" | "watch" | "low";
+    /** Suggested pairing partner from another author (if any). */
+    pairSuggestion?: string;
+}
+export interface InsiderTradingOptions {
+    /** Maximum days between ship and fix to count as a pattern. */
+    windowDays?: number;
+    /** Minimum patterns for an author to be flagged. */
+    minPatterns?: number;
+    /** Top-N profiles to return. */
+    topN?: number;
+}
+/**
+ * Detect insider patterns across commits + suggest a pairing partner per
+ * flagged author. Pure analysis — caller must pre-load commits.
+ */
+export declare function detectInsiderTrading(commits: Commit[], opts?: InsiderTradingOptions): InsiderProfile[];
+export declare function classifyInsiderTier(count: number): InsiderProfile["tier"];
+//# sourceMappingURL=insider-trading.d.ts.map

package/dist/quant/insider-trading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insider-trading.d.ts","sourceRoot":"","sources":["../../src/quant/insider-trading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6CAA6C;IAC7C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;IACpD,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,GAAE,qBAA0B,GAC/B,cAAc,EAAE,CAkFlB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAKzE"}

package/dist/quant/insider-trading.js

@@ -0,0 +1,129 @@
+/**
+ * `mneme insider-trading` — find authors who repeatedly fix bugs they
+ * themselves introduced.
+ *
+ * The pattern tells you two things at once:
+ *   1. This person has the deepest domain knowledge (only they understand
+ *      this code well enough to BOTH ship and break it).
+ *   2. They have an execution gap — knowing more isn't translating to
+ *      better quality.
+ *
+ * Concrete coaching opportunity: pair them with someone who has zero
+ * defects on the same files.
+ *
+ * Pure data. Detects pairs of (commit, follow-up commit) by SAME author
+ * touching the SAME files where the follow-up is a fix.
+ */
+const FIX_RE = /\b(fix(?:es|ed)?|hotfix|bug|crashed?|broken|regression)\b/i;
+/**
+ * Detect insider patterns across commits + suggest a pairing partner per
+ * flagged author. Pure analysis — caller must pre-load commits.
+ */
+export function detectInsiderTrading(commits, opts = {}) {
+    const windowDays = opts.windowDays ?? 14;
+    const minPatterns = opts.minPatterns ?? 2;
+    const topN = opts.topN ?? 10;
+    const windowMs = windowDays * 86_400_000;
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    // Step 1: collect all patterns across ALL authors.
+    const allPatterns = [];
+    for (let i = 0; i < sorted.length; i++) {
+        const shipped = sorted[i];
+        if (FIX_RE.test(shipped.subject))
+            continue; // skip if shipped IS itself a fix
+        const shippedTime = new Date(shipped.authorDate).getTime();
+        const shippedAuthor = `${shipped.authorName}|${shipped.authorEmail}`;
+        const shippedFiles = new Set(shipped.files ?? []);
+        if (shippedFiles.size === 0)
+            continue;
+        for (let j = i + 1; j < sorted.length; j++) {
+            const fixed = sorted[j];
+            const dt = new Date(fixed.authorDate).getTime() - shippedTime;
+            if (dt > windowMs)
+                break;
+            // Same author requirement — that's the "insider" part.
+            if (`${fixed.authorName}|${fixed.authorEmail}` !== shippedAuthor)
+                continue;
+            // Must look like a fix.
+            if (!FIX_RE.test(fixed.subject))
+                continue;
+            // Must touch a shared file.
+            const shared = (fixed.files ?? []).find((f) => shippedFiles.has(f));
+            if (!shared)
+                continue;
+            allPatterns.push({
+                shipped,
+                fixed,
+                daysToFix: Number((dt / 86_400_000).toFixed(1)),
+                sharedFile: shared,
+            });
+            break; // one pattern per shipped commit
+        }
+    }
+    const byAuthor = new Map();
+    for (const p of allPatterns) {
+        const key = `${p.shipped.authorName}|${p.shipped.authorEmail}`;
+        if (!byAuthor.has(key)) {
+            byAuthor.set(key, {
+                authorName: p.shipped.authorName,
+                authorEmail: p.shipped.authorEmail,
+                patterns: [],
+                files: new Set(),
+            });
+        }
+        const b = byAuthor.get(key);
+        b.patterns.push(p);
+        b.files.add(p.sharedFile);
+    }
+    // Step 3: build per-author profiles + pairing suggestions.
+    const profiles = [];
+    for (const b of byAuthor.values()) {
+        if (b.patterns.length < minPatterns)
+            continue;
+        const tier = classifyInsiderTier(b.patterns.length);
+        const pairSuggestion = findPairPartner(commits, b.authorName, [...b.files]);
+        profiles.push({
+            authorName: b.authorName,
+            authorEmail: b.authorEmail,
+            patternCount: b.patterns.length,
+            affectedFiles: [...b.files],
+            samples: b.patterns.slice(0, 3),
+            tier,
+            pairSuggestion,
+        });
+    }
+    profiles.sort((a, b) => b.patternCount - a.patternCount);
+    return profiles.slice(0, topN);
+}
+export function classifyInsiderTier(count) {
+    if (count >= 5)
+        return "high-pattern";
+    if (count >= 3)
+        return "elevated";
+    if (count >= 2)
+        return "watch";
+    return "low";
+}
+/**
+ * Find a pairing partner — the author who has touched the same files
+ * with ZERO insider patterns themselves. Returns the first match.
+ */
+function findPairPartner(commits, avoidAuthor, files) {
+    if (files.length === 0)
+        return undefined;
+    const fileSet = new Set(files);
+    // Count touches per author on the affected files.
+    const otherAuthors = new Map();
+    for (const c of commits) {
+        if (c.authorName === avoidAuthor)
+            continue;
+        if (!c.files?.some((f) => fileSet.has(f)))
+            continue;
+        otherAuthors.set(c.authorName, (otherAuthors.get(c.authorName) ?? 0) + 1);
+    }
+    if (otherAuthors.size === 0)
+        return undefined;
+    // Pick the most active OTHER author.
+    return [...otherAuthors.entries()].sort((a, b) => b[1] - a[1])[0][0];
+}
+//# sourceMappingURL=insider-trading.js.map

package/dist/quant/insider-trading.js.map

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

package/dist/quant/insider-trading.test.d.ts

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

package/dist/quant/insider-trading.test.d.ts.map

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

package/dist/quant/insider-trading.test.js

@@ -0,0 +1,130 @@
+import { describe, it, expect } from "vitest";
+import { detectInsiderTrading, classifyInsiderTier } from "./insider-trading.js";
+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,
+});
+describe("classifyInsiderTier", () => {
+    it("high-pattern at 5+", () => expect(classifyInsiderTier(5)).toBe("high-pattern"));
+    it("elevated at 3-4", () => expect(classifyInsiderTier(3)).toBe("elevated"));
+    it("watch at 2", () => expect(classifyInsiderTier(2)).toBe("watch"));
+    it("low at <2", () => expect(classifyInsiderTier(1)).toBe("low"));
+});
+describe("detectInsiderTrading — same author + same files + fix follow-up", () => {
+    it("flags a single insider pattern (alice ships then alice fixes)", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat(stripe): add webhook", ["src/stripe.ts"]),
+            cmt("a2", "alice", "2024-08-03", "fix: stripe webhook crashed", ["src/stripe.ts"]),
+        ];
+        const profiles = detectInsiderTrading(commits, { minPatterns: 1 });
+        expect(profiles).toHaveLength(1);
+        expect(profiles[0].authorName).toBe("alice");
+        expect(profiles[0].patternCount).toBe(1);
+    });
+    it("does NOT flag when author is different", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat(stripe): add webhook", ["src/stripe.ts"]),
+            cmt("b1", "bob", "2024-08-03", "fix: stripe webhook crashed", ["src/stripe.ts"]),
+        ];
+        expect(detectInsiderTrading(commits, { minPatterns: 1 })).toEqual([]);
+    });
+    it("does NOT flag when files do not overlap", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat: stripe", ["src/stripe.ts"]),
+            cmt("a2", "alice", "2024-08-03", "fix: orders broken", ["src/orders.ts"]),
+        ];
+        expect(detectInsiderTrading(commits, { minPatterns: 1 })).toEqual([]);
+    });
+    it("respects windowDays", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat: stripe", ["src/x.ts"]),
+            cmt("a2", "alice", "2024-09-15", "fix: stripe broke", ["src/x.ts"]), // 45 days later
+        ];
+        expect(detectInsiderTrading(commits, { windowDays: 14, minPatterns: 1 })).toEqual([]);
+        expect(detectInsiderTrading(commits, { windowDays: 60, minPatterns: 1 })).toHaveLength(1);
+    });
+});
+describe("detectInsiderTrading — minPatterns threshold and aggregation", () => {
+    it("requires ≥ minPatterns to flag (default 2)", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat: A", ["src/x.ts"]),
+            cmt("a2", "alice", "2024-08-02", "fix: A", ["src/x.ts"]),
+        ];
+        expect(detectInsiderTrading(commits)).toEqual([]); // only 1 pattern, default min = 2
+    });
+    it("aggregates all patterns by author", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat: A", ["src/x.ts"]),
+            cmt("a2", "alice", "2024-08-02", "fix: A", ["src/x.ts"]),
+            cmt("a3", "alice", "2024-08-10", "feat: B", ["src/y.ts"]),
+            cmt("a4", "alice", "2024-08-11", "fix: B", ["src/y.ts"]),
+            cmt("a5", "alice", "2024-08-20", "feat: C", ["src/z.ts"]),
+            cmt("a6", "alice", "2024-08-22", "fix: C broke", ["src/z.ts"]),
+        ];
+        const profiles = detectInsiderTrading(commits, { minPatterns: 2 });
+        expect(profiles).toHaveLength(1);
+        expect(profiles[0].patternCount).toBe(3);
+        expect(profiles[0].affectedFiles.sort()).toEqual(["src/x.ts", "src/y.ts", "src/z.ts"]);
+    });
+    it("samples are capped at 3", () => {
+        const commits = [];
+        for (let i = 0; i < 10; i++) {
+            commits.push(cmt(`f${i}`, "alice", `2024-08-${String((i * 2) + 1).padStart(2, "0")}`, `feat: ${i}`, [`f${i}.ts`]));
+            commits.push(cmt(`x${i}`, "alice", `2024-08-${String((i * 2) + 2).padStart(2, "0")}`, `fix: ${i}`, [`f${i}.ts`]));
+        }
+        const profiles = detectInsiderTrading(commits, { minPatterns: 2 });
+        expect(profiles[0].samples).toHaveLength(3);
+    });
+});
+describe("detectInsiderTrading — pairing suggestion", () => {
+    it("suggests another author who has touched the same files", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat: A", ["src/x.ts"]),
+            cmt("a2", "alice", "2024-08-02", "fix: A", ["src/x.ts"]),
+            cmt("a3", "alice", "2024-08-10", "feat: B", ["src/x.ts"]),
+            cmt("a4", "alice", "2024-08-11", "fix: B", ["src/x.ts"]),
+            cmt("b1", "bob", "2024-09-01", "refactor", ["src/x.ts"]),
+            cmt("b2", "bob", "2024-09-05", "refactor 2", ["src/x.ts"]),
+        ];
+        const profile = detectInsiderTrading(commits, { minPatterns: 2 })[0];
+        expect(profile?.pairSuggestion).toBe("bob");
+    });
+    it("returns undefined pair when nobody else has touched the files", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", "feat: A", ["src/solo.ts"]),
+            cmt("a2", "alice", "2024-08-02", "fix: A", ["src/solo.ts"]),
+            cmt("a3", "alice", "2024-08-10", "feat: B", ["src/solo.ts"]),
+            cmt("a4", "alice", "2024-08-11", "fix: B", ["src/solo.ts"]),
+        ];
+        const profile = detectInsiderTrading(commits, { minPatterns: 2 })[0];
+        expect(profile?.pairSuggestion).toBeUndefined();
+    });
+});
+describe("detectInsiderTrading — sort order", () => {
+    it("sorts profiles by patternCount desc", () => {
+        const commits = [];
+        // alice — 3 patterns
+        for (let i = 0; i < 3; i++) {
+            commits.push(cmt(`a${i}`, "alice", `2024-0${i + 1}-01`, `feat: ${i}`, [`a${i}.ts`]));
+            commits.push(cmt(`af${i}`, "alice", `2024-0${i + 1}-03`, `fix: ${i}`, [`a${i}.ts`]));
+        }
+        // bob — 5 patterns
+        for (let i = 0; i < 5; i++) {
+            commits.push(cmt(`b${i}`, "bob", `2024-0${i + 1}-15`, `feat: ${i}`, [`b${i}.ts`]));
+            commits.push(cmt(`bf${i}`, "bob", `2024-0${i + 1}-17`, `fix: ${i}`, [`b${i}.ts`]));
+        }
+        const profiles = detectInsiderTrading(commits, { minPatterns: 2 });
+        expect(profiles[0].authorName).toBe("bob");
+        expect(profiles[0].patternCount).toBe(5);
+        expect(profiles[1].authorName).toBe("alice");
+    });
+});
+//# sourceMappingURL=insider-trading.test.js.map

package/dist/quant/insider-trading.test.js.map

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

package/dist/quant/moneyball.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `mneme moneyball` — find undervalued contributors.
+ *
+ * The Billy Beane angle on engineering: in baseball, big-volume hitters
+ * get the contracts but on-base-percentage wins games. In codebases:
+ * loud LOC-per-day contributors get promoted, but the people whose
+ * commits *unblock everyone else* are the real value.
+ *
+ * Metric: each commit is "valuable" by how many SUBSEQUENT commits touch
+ * the same files. People whose commits frequently appear upstream of
+ * many others' work are unblocking. People with high LOC volume but few
+ * downstream touches are noise generators.
+ *
+ *   value_score = log(downstream_commits + 1) × distinct_collaborators
+ *   over_undervalued = value_score / commit_count   (per-commit ROI)
+ *
+ * Pure analysis. No LLM.
+ */
+import type { Commit } from "../types.js";
+export interface ContributorScore {
+    authorName: string;
+    authorEmail: string;
+    /** Total commits authored. */
+    commitCount: number;
+    /** Total downstream commits — sum of how many later commits touched the same files. */
+    downstreamReach: number;
+    /** Number of DISTINCT other authors whose work followed theirs on the same files. */
+    collaborators: number;
+    /** Aggregate value score (see formula in module doc). */
+    valueScore: number;
+    /** Per-commit ROI = valueScore / commitCount — the moneyball metric. */
+    perCommitROI: number;
+    /** Tier label. */
+    tier: "moneyball" | "balanced" | "loud" | "passive";
+    /** A 1-line interpretation. */
+    interpretation: string;
+}
+export interface MoneyballOptions {
+    /** Maximum days to count "downstream" relationships. Default 90. */
+    downstreamWindowDays?: number;
+    /** Minimum commits for a contributor to be ranked. Default 2. */
+    minCommits?: number;
+    /** Top-N to return. */
+    topN?: number;
+}
+export declare function moneyball(commits: Commit[], opts?: MoneyballOptions): ContributorScore[];
+export declare function classifyMoneyballTier(commitCount: number, valueScore: number, perCommitROI: number): ContributorScore["tier"];
+//# sourceMappingURL=moneyball.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moneyball.d.ts","sourceRoot":"","sources":["../../src/quant/moneyball.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,eAAe,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IACpD,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,gBAAqB,GAAG,gBAAgB,EAAE,CA2E5F;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAAC,MAAM,CAAC,CAS1B"}