@mneme-ai/core 0.9.0 → 0.10.0

package/dist/quant/implied-volatility.js

@@ -0,0 +1,149 @@
+/**
+ * `mneme implied-volatility` — predict project chaos from commit message TONE.
+ *
+ * Wall Street's "implied volatility" measures market expectation of future
+ * turbulence FROM option prices, before realized volatility shows up in
+ * actual price moves. We do the same with commit messages: signals that
+ * predict bug-rate spikes BEFORE the bugs actually land.
+ *
+ * Tone signals (per commit):
+ *   • exclamation density:    !!! → urgency
+ *   • all-caps words:         BROKEN, ARGH → frustration
+ *   • emoji density:          🔥💀⚠️ → emotional load
+ *   • profanity (mild):       wtf, ugh → friction
+ *   • hedging language:       "kinda", "should work?", "maybe" → uncertainty
+ *
+ * Aggregate per week → IV index (0-100). Backtests against subsequent
+ * fix-commit rate to validate.
+ */
+const FRICTION_WORDS = new Set([
+    "wtf", "ugh", "argh", "ffs", "damn", "shit", "fuck", "fucking",
+    "wth", "omg", "yikes", "oof", "ouch",
+    "broken", "borked", "fucked", "cursed",
+]);
+const HEDGE_WORDS = new Set([
+    "maybe", "probably", "kinda", "sorta", "perhaps",
+    "should", "might", "could", "hopefully", "fingers",
+    "untested", "experimental", "tentative", "wip",
+]);
+const ALL_CAPS_WORD_RE = /\b[A-Z]{3,}\b/g;
+const EXCLAMATION_RE = /!+/g;
+// Heuristic emoji match: any code point ≥ U+2600 not in regular Latin block
+const EMOJI_RE = /[\u{1F300}-\u{1FAFF}\u{2600}-\u{27BF}]/gu;
+/**
+ * Score the tone of a single commit subject + body. Pure function.
+ */
+export function scoreTone(c) {
+    const text = `${c.subject} ${c.body || ""}`;
+    // Exclamation density: count sequences of '!' (any count of !!!! is one event).
+    let exMatches = 0;
+    for (const m of text.matchAll(EXCLAMATION_RE)) {
+        exMatches += m[0].length; // double-count !!!!
+    }
+    // All-caps words.
+    const capMatches = text.match(ALL_CAPS_WORD_RE) ?? [];
+    const allCapsScore = capMatches.length;
+    // Emoji.
+    const emoji = text.match(EMOJI_RE) ?? [];
+    // Friction words.
+    const lower = text.toLowerCase();
+    let frictionScore = 0;
+    for (const w of FRICTION_WORDS) {
+        const re = new RegExp(`\\b${w}\\b`, "g");
+        const m = lower.match(re);
+        if (m)
+            frictionScore += m.length;
+    }
+    // Hedge words.
+    let hedgeScore = 0;
+    for (const w of HEDGE_WORDS) {
+        const re = new RegExp(`\\b${w}\\b`, "g");
+        const m = lower.match(re);
+        if (m)
+            hedgeScore += m.length;
+    }
+    // Calibrated tone score (0..1).
+    const raw = 0.25 * Math.min(exMatches, 5) / 5 +
+        0.20 * Math.min(allCapsScore, 5) / 5 +
+        0.15 * Math.min(emoji.length, 5) / 5 +
+        0.25 * Math.min(frictionScore, 3) / 3 +
+        0.15 * Math.min(hedgeScore, 3) / 3;
+    return {
+        hash: c.hash,
+        date: c.authorDate.slice(0, 10),
+        exclamationScore: exMatches,
+        allCapsScore,
+        emojiScore: emoji.length,
+        frictionScore,
+        hedgeScore,
+        toneScore: Math.min(1, raw),
+    };
+}
+/**
+ * Aggregate tones into weekly volatility windows.
+ */
+export function impliedVolatility(commits) {
+    if (commits.length === 0)
+        return [];
+    const tones = commits.map(scoreTone);
+    const buckets = new Map();
+    for (const t of tones) {
+        const week = isoWeek(new Date(t.date));
+        if (!buckets.has(week))
+            buckets.set(week, { sum: 0, count: 0 });
+        const b = buckets.get(week);
+        b.sum += t.toneScore;
+        b.count += 1;
+    }
+    const windows = [];
+    for (const [week, b] of buckets) {
+        const avgTone = b.sum / b.count;
+        windows.push({
+            week,
+            avgTone: Math.round(avgTone * 1000) / 1000,
+            commitCount: b.count,
+            iv: Math.round(avgTone * 100),
+        });
+    }
+    windows.sort((a, b) => a.week.localeCompare(b.week));
+    return windows;
+}
+function isoWeek(d) {
+    const target = new Date(d.valueOf());
+    const dayNr = (d.getUTCDay() + 6) % 7;
+    target.setUTCDate(target.getUTCDate() - dayNr + 3);
+    const firstThursday = target.valueOf();
+    target.setUTCMonth(0, 1);
+    if (target.getUTCDay() !== 4) {
+        target.setUTCMonth(0, 1 + ((4 - target.getUTCDay() + 7) % 7));
+    }
+    const weekNumber = 1 + Math.ceil((firstThursday - target.valueOf()) / (7 * 86_400_000));
+    return `${d.getUTCFullYear()}-W${String(weekNumber).padStart(2, "0")}`;
+}
+export function summarizeVolatility(commits) {
+    const windows = impliedVolatility(commits);
+    if (windows.length === 0) {
+        return { windows: [], latestIV: 0, trend: "insufficient-data", interpretation: "No commits indexed." };
+    }
+    const latest = windows[windows.length - 1].iv;
+    let trend = "insufficient-data";
+    if (windows.length >= 4) {
+        const recent = windows.slice(-4).map((w) => w.iv);
+        const first = recent[0];
+        const last = recent[recent.length - 1];
+        const delta = last - first;
+        trend = delta > 5 ? "rising" : delta < -5 ? "falling" : "flat";
+    }
+    return { windows, latestIV: latest, trend, interpretation: buildVolInterpretation(latest, trend) };
+}
+function buildVolInterpretation(iv, trend) {
+    if (trend === "rising" && iv >= 30) {
+        return `IV is ${iv} (rising) — commit message tone is signaling stress. Expect more bug fixes in the next 1-2 weeks.`;
+    }
+    if (iv >= 50)
+        return `IV is ${iv} (very high). Team is in firefighting mode.`;
+    if (iv <= 10 && trend === "flat")
+        return `IV is ${iv} (low + flat). Calm waters; commits are unemotional.`;
+    return `IV is ${iv} (${trend}). Watch for rising trends as a leading indicator of bugs.`;
+}
+//# sourceMappingURL=implied-volatility.js.map

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

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

package/dist/quant/implied-volatility.test.d.ts

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

package/dist/quant/implied-volatility.test.d.ts.map

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

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":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,MAAM,GAAG,4DAA4D,CAAC;AAqC5E;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAiB,EACjB,OAA8B,EAAE;IAEhC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAEzC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAErF,mDAAmD;IACnD,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS,CAAC,kCAAkC;QAC9E,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,aAAa,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACrE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS;QAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC;YAC9D,IAAI,EAAE,GAAG,QAAQ;gBAAE,MAAM;YACzB,uDAAuD;YACvD,IAAI,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,aAAa;gBAAE,SAAS;YAC3E,wBAAwB;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,SAAS;YAC1C,4BAA4B;YAC5B,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,WAAW,CAAC,IAAI,CAAC;gBACf,OAAO;gBACP,KAAK;gBACL,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC/C,UAAU,EAAE,MAAM;aACnB,CAAC,CAAC;YACH,MAAM,CAAC,iCAAiC;QAC1C,CAAC;IACH,CAAC;IASD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC/D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE;gBAChB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU;gBAChC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW;gBAClC,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE,IAAI,GAAG,EAAE;aACjB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,2DAA2D;IAC3D,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,WAAW;YAAE,SAAS;QAC9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM;YAC/B,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAC3B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI;YACJ,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,cAAc,CAAC;IACtC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,OAAiB,EAAE,WAAmB,EAAE,KAAe;IAC9E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,kDAAkD;IAClD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,UAAU,KAAK,WAAW;YAAE,SAAS;QAC3C,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QACpD,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,qCAAqC;IACrC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC"}

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":""}