@mneme-ai/core 0.8.4 → 0.10.0

package/dist/quant/moneyball.js

@@ -0,0 +1,110 @@
+/**
+ * `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.
+ */
+export function moneyball(commits, opts = {}) {
+    const windowMs = (opts.downstreamWindowDays ?? 90) * 86_400_000;
+    const minCommits = opts.minCommits ?? 2;
+    const topN = opts.topN ?? 20;
+    const sorted = [...commits].sort((a, b) => a.authorDate.localeCompare(b.authorDate));
+    const byAuthor = new Map();
+    for (const c of sorted) {
+        const key = `${c.authorName}|${c.authorEmail}`;
+        if (!byAuthor.has(key))
+            byAuthor.set(key, {
+                authorName: c.authorName,
+                authorEmail: c.authorEmail,
+                commits: [],
+                downstream: 0,
+                collaboratorSet: new Set(),
+            });
+        byAuthor.get(key).commits.push(c);
+    }
+    // Step 2: for each commit, count downstream commits within window.
+    for (let i = 0; i < sorted.length; i++) {
+        const upstream = sorted[i];
+        if (!upstream.files?.length)
+            continue;
+        const upstreamFiles = new Set(upstream.files);
+        const upstreamTime = new Date(upstream.authorDate).getTime();
+        const upstreamAuthor = `${upstream.authorName}|${upstream.authorEmail}`;
+        const bucket = byAuthor.get(upstreamAuthor);
+        for (let j = i + 1; j < sorted.length; j++) {
+            const later = sorted[j];
+            const dt = new Date(later.authorDate).getTime() - upstreamTime;
+            if (dt > windowMs)
+                break;
+            if (!later.files?.some((f) => upstreamFiles.has(f)))
+                continue;
+            // Count this as a downstream touch on the upstream commit.
+            bucket.downstream += 1;
+            const laterAuthor = `${later.authorName}|${later.authorEmail}`;
+            if (laterAuthor !== upstreamAuthor) {
+                bucket.collaboratorSet.add(later.authorName);
+            }
+        }
+    }
+    // Step 3: compute scores + tiers.
+    const scores = [];
+    for (const b of byAuthor.values()) {
+        if (b.commits.length < minCommits)
+            continue;
+        const valueScore = Math.log2(b.downstream + 1) * b.collaboratorSet.size;
+        const perCommitROI = b.commits.length === 0 ? 0 : valueScore / b.commits.length;
+        const tier = classifyMoneyballTier(b.commits.length, valueScore, perCommitROI);
+        scores.push({
+            authorName: b.authorName,
+            authorEmail: b.authorEmail,
+            commitCount: b.commits.length,
+            downstreamReach: b.downstream,
+            collaborators: b.collaboratorSet.size,
+            valueScore,
+            perCommitROI,
+            tier,
+            interpretation: buildInterpretation(tier, b.commits.length, b.downstream, b.collaboratorSet.size),
+        });
+    }
+    // Sort by perCommitROI desc — undervalued contributors rise.
+    scores.sort((a, b) => b.perCommitROI - a.perCommitROI);
+    return scores.slice(0, topN);
+}
+export function classifyMoneyballTier(commitCount, valueScore, perCommitROI) {
+    // Moneyball: high ROI per commit AND modest commit count (low volume, high impact).
+    if (perCommitROI >= 1.5 && commitCount < 30)
+        return "moneyball";
+    // Balanced: high overall value but proportional commit count.
+    if (valueScore >= 5 && perCommitROI >= 0.5)
+        return "balanced";
+    // Loud: lots of commits, low ROI per commit (noise).
+    if (commitCount >= 30 && perCommitROI < 0.3)
+        return "loud";
+    // Passive: few commits, low downstream activity.
+    return "passive";
+}
+function buildInterpretation(tier, commitCount, downstream, collaborators) {
+    switch (tier) {
+        case "moneyball":
+            return `Undervalued — ${commitCount} commits unblocked ${collaborators} other contributors (${downstream} downstream touches). High ROI per commit.`;
+        case "balanced":
+            return `Solid contributor — ${commitCount} commits with ${downstream} downstream effects across ${collaborators} collaborators.`;
+        case "loud":
+            return `High volume, low impact — ${commitCount} commits but only ${downstream} downstream touches. Noise > signal.`;
+        case "passive":
+            return `Limited footprint — ${commitCount} commits, ${downstream} downstream effects. Either too new or working in isolation.`;
+    }
+}
+//# sourceMappingURL=moneyball.js.map

package/dist/quant/moneyball.js.map

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

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

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

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

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

package/dist/quant/moneyball.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect } from "vitest";
+import { moneyball, classifyMoneyballTier } from "./moneyball.js";
+const cmt = (hash, author, date, files) => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: author,
+    authorEmail: `${author}@x`,
+    authorDate: `${date}T00:00:00Z`,
+    committerDate: `${date}T00:00:00Z`,
+    subject: "commit",
+    body: "",
+    parents: [],
+    files,
+});
+describe("classifyMoneyballTier", () => {
+    it("'moneyball' when perCommitROI ≥ 1.5 + commit count < 30", () => {
+        expect(classifyMoneyballTier(10, 20, 2)).toBe("moneyball");
+    });
+    it("'balanced' when value ≥ 5 + ROI ≥ 0.5", () => {
+        expect(classifyMoneyballTier(20, 10, 0.5)).toBe("balanced");
+    });
+    it("'loud' when ≥30 commits and ROI < 0.3", () => {
+        expect(classifyMoneyballTier(50, 10, 0.2)).toBe("loud");
+    });
+    it("'passive' when nothing else applies", () => {
+        expect(classifyMoneyballTier(5, 1, 0.2)).toBe("passive");
+    });
+});
+describe("moneyball — basic invariants", () => {
+    it("returns empty for empty input", () => {
+        expect(moneyball([])).toEqual([]);
+    });
+    it("respects minCommits filter (default 2)", () => {
+        const commits = [cmt("a1", "alice", "2024-08-01", ["x.ts"])];
+        expect(moneyball(commits)).toEqual([]); // only 1 commit
+        expect(moneyball(commits, { minCommits: 1 })).toHaveLength(1);
+    });
+    it("downstream reach counts later commits touching same files", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", ["src/x.ts"]),
+            cmt("a2", "alice", "2024-08-02", ["src/x.ts"]),
+            cmt("b1", "bob", "2024-08-03", ["src/x.ts"]),
+            cmt("c1", "carol", "2024-08-04", ["src/x.ts"]),
+        ];
+        const scores = moneyball(commits, { minCommits: 1 });
+        const alice = scores.find((s) => s.authorName === "alice");
+        expect(alice.downstreamReach).toBeGreaterThan(0);
+        expect(alice.collaborators).toBeGreaterThanOrEqual(2); // bob + carol
+    });
+    it("ignores downstream commits beyond the time window", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", ["x.ts"]),
+            cmt("a2", "alice", "2024-08-02", ["x.ts"]),
+            cmt("b1", "bob", "2026-01-01", ["x.ts"]), // 1.5 years later
+        ];
+        const scores = moneyball(commits, { minCommits: 1, downstreamWindowDays: 90 });
+        const alice = scores.find((s) => s.authorName === "alice");
+        // bob is outside 90-day window — not counted as collaborator
+        expect(alice.collaborators).toBe(0);
+    });
+});
+describe("moneyball — per-commit ROI sort + tier assignment", () => {
+    it("'moneyball' tier emerges for low-volume + high-impact authors", () => {
+        // alice: 3 commits, each unblocks 5 collaborators
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", ["src/core.ts"]),
+            cmt("a2", "alice", "2024-08-02", ["src/core.ts"]),
+            cmt("a3", "alice", "2024-08-03", ["src/core.ts"]),
+        ];
+        // 5 collaborators each making 3 follow-up commits
+        const followups = ["bob", "carol", "dave", "eve", "frank"];
+        for (const name of followups) {
+            for (let j = 0; j < 3; j++) {
+                commits.push(cmt(`${name[0]}${j}`.padEnd(7, "x"), name, `2024-08-${String(j + 5 + followups.indexOf(name) * 2).padStart(2, "0")}`, ["src/core.ts"]));
+            }
+        }
+        const scores = moneyball(commits, { minCommits: 1 });
+        const alice = scores.find((s) => s.authorName === "alice");
+        expect(alice.tier).toBe("moneyball");
+    });
+    it("'loud' tier for high commit count but low downstream effect", () => {
+        const commits = [];
+        // alice: 50 commits all on isolated files (no follow-ups)
+        for (let i = 0; i < 50; i++) {
+            const day = String(i + 1).padStart(2, "0");
+            const month = i < 28 ? "08" : "09";
+            const dayInMonth = i < 28 ? day : String(i - 27).padStart(2, "0");
+            commits.push(cmt(`a${i}`.padEnd(7, "x"), "alice", `2024-${month}-${dayInMonth}`, [`src/iso${i}.ts`]));
+        }
+        const scores = moneyball(commits, { minCommits: 1 });
+        const alice = scores.find((s) => s.authorName === "alice");
+        expect(alice.tier).toBe("loud");
+        expect(alice.perCommitROI).toBeLessThan(0.3);
+    });
+    it("sorts by perCommitROI desc — moneyball candidates first", () => {
+        const commits = [];
+        // bob: 50 commits on solo files (loud)
+        for (let i = 0; i < 50; i++) {
+            const day = String(i + 1).padStart(2, "0");
+            const month = i < 28 ? "08" : "09";
+            const dayInMonth = i < 28 ? day : String(i - 27).padStart(2, "0");
+            commits.push(cmt(`b${i}`.padEnd(7, "x"), "bob", `2024-${month}-${dayInMonth}`, [`src/iso${i}.ts`]));
+        }
+        // alice: 3 commits on shared file
+        commits.push(cmt("a1", "alice", "2024-08-01", ["src/core.ts"]));
+        commits.push(cmt("a2", "alice", "2024-08-02", ["src/core.ts"]));
+        commits.push(cmt("a3", "alice", "2024-08-03", ["src/core.ts"]));
+        // carol + dave + eve work downstream of alice
+        for (const name of ["carol", "dave", "eve", "frank", "george"]) {
+            const offset = ["carol", "dave", "eve", "frank", "george"].indexOf(name);
+            for (let j = 0; j < 4; j++) {
+                commits.push(cmt(`${name[0]}${j}`.padEnd(7, "x"), name, `2024-08-${String(j + 4 + offset * 4).padStart(2, "0")}`, ["src/core.ts"]));
+            }
+        }
+        const scores = moneyball(commits, { minCommits: 1 });
+        const aliceIdx = scores.findIndex((s) => s.authorName === "alice");
+        const bobIdx = scores.findIndex((s) => s.authorName === "bob");
+        expect(aliceIdx).toBeLessThan(bobIdx); // alice ranked higher (moneyball)
+    });
+});
+describe("moneyball — interpretation text", () => {
+    it("moneyball tier emphasizes high ROI", () => {
+        const commits = [
+            cmt("a1", "alice", "2024-08-01", ["x.ts"]),
+            cmt("a2", "alice", "2024-08-02", ["x.ts"]),
+            cmt("b1", "bob", "2024-08-03", ["x.ts"]),
+            cmt("c1", "carol", "2024-08-04", ["x.ts"]),
+            cmt("d1", "dave", "2024-08-05", ["x.ts"]),
+            cmt("e1", "eve", "2024-08-06", ["x.ts"]),
+        ];
+        const profile = moneyball(commits, { minCommits: 1 }).find((s) => s.authorName === "alice");
+        if (profile.tier === "moneyball") {
+            expect(profile.interpretation.toLowerCase()).toMatch(/undervalued|unblocked/);
+        }
+    });
+});
+//# sourceMappingURL=moneyball.test.js.map

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

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

package/dist/quant/tax-loss-harvest.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `mneme tax-loss-harvest` — find dead code that can be deleted to "offset"
+ * technical debt.
+ *
+ * The metaphor: in finance, you sell losing positions to harvest tax losses,
+ * which offset gains elsewhere. In a codebase, deleting dead code reduces
+ * cognitive surface area, freeing up budget to absorb new debt elsewhere.
+ *
+ * Scoring per file:
+ *   • staleness         — days since last touch
+ *   • commit count      — fewer commits = less load-bearing
+ *   • entity references — files with no entities or no inbound refs
+ *   • risk if deleted   — files with incidents historically = higher risk
+ *
+ *   harvest_score = staleness × (1 / max(commits, 1)) × (1 - risk)
+ *
+ * Pure data analysis. No LLM. Output is a candidate list with risk gauges.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+export interface HarvestCandidate {
+    filePath: string;
+    /** Days since last commit. */
+    daysSinceTouch: number;
+    /** Total commits ever touching this file. */
+    commitCount: number;
+    /** Number of entities (functions/classes) parsed from this file. 0 = likely dead. */
+    entityCount: number;
+    /** Number of past incidents that mentioned this file. */
+    incidentCount: number;
+    /** Composite harvest score — higher = better deletion candidate. */
+    harvestScore: number;
+    /** Risk tier of deletion. */
+    risk: "safe" | "low-risk" | "moderate" | "risky";
+    /** A 1-line action recommendation. */
+    recommendation: string;
+}
+export interface HarvestOptions {
+    /** Minimum days since last touch to consider. Default 180. */
+    minStaleDays?: number;
+    /** Maximum total commits to consider. Default 5 (low-load). */
+    maxCommits?: number;
+    /** Top-N candidates. */
+    topN?: number;
+    /** Override "now" for deterministic tests. */
+    now?: Date;
+}
+export declare function findHarvestCandidates(store: MnemeStore, opts?: HarvestOptions): HarvestCandidate[];
+export declare function classifyHarvestRisk(incidents: number, entities: number, commits: number): HarvestCandidate["risk"];
+export interface HarvestSummary {
+    candidateCount: number;
+    /** Sum of (lines saved if all deleted) — best-effort approximation. */
+    estimatedLinesSaved: number;
+    /** Net risk-adjusted savings — savings × (1 - avg risk). */
+    netSavings: number;
+    /** A 1-line summary. */
+    summary: string;
+}
+export declare function summarizeHarvest(candidates: HarvestCandidate[]): HarvestSummary;
+//# sourceMappingURL=tax-loss-harvest.d.ts.map

package/dist/quant/tax-loss-harvest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax-loss-harvest.d.ts","sourceRoot":"","sources":["../../src/quant/tax-loss-harvest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IACjD,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,cAAmB,GACxB,gBAAgB,EAAE,CAsEpB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,gBAAgB,CAAC,MAAM,CAAC,CAK1B;AAkBD,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,cAAc,CAe/E"}

package/dist/quant/tax-loss-harvest.js

@@ -0,0 +1,126 @@
+/**
+ * `mneme tax-loss-harvest` — find dead code that can be deleted to "offset"
+ * technical debt.
+ *
+ * The metaphor: in finance, you sell losing positions to harvest tax losses,
+ * which offset gains elsewhere. In a codebase, deleting dead code reduces
+ * cognitive surface area, freeing up budget to absorb new debt elsewhere.
+ *
+ * Scoring per file:
+ *   • staleness         — days since last touch
+ *   • commit count      — fewer commits = less load-bearing
+ *   • entity references — files with no entities or no inbound refs
+ *   • risk if deleted   — files with incidents historically = higher risk
+ *
+ *   harvest_score = staleness × (1 / max(commits, 1)) × (1 - risk)
+ *
+ * Pure data analysis. No LLM. Output is a candidate list with risk gauges.
+ */
+export function findHarvestCandidates(store, opts = {}) {
+    const minStale = opts.minStaleDays ?? 180;
+    const maxCommits = opts.maxCommits ?? 5;
+    const topN = opts.topN ?? 20;
+    const now = opts.now ?? new Date();
+    // 1. Per-file commit count + last touch.
+    const fileRows = store.db
+        .prepare(`SELECT
+         fc.path                AS path,
+         COUNT(*)               AS commits,
+         MAX(c.author_date)     AS last_touch
+       FROM file_changes fc
+       JOIN commits c ON c.hash = fc.commit_hash
+       GROUP BY fc.path`)
+        .all();
+    // 2. Entity count per file.
+    const entityRows = store.db
+        .prepare(`SELECT file_path, COUNT(*) AS n FROM entities GROUP BY file_path`)
+        .all();
+    const entityCountByFile = new Map(entityRows.map((r) => [r.file_path, r.n]));
+    // 3. Incident-affected files (best-effort).
+    const incidentRows = store.db
+        .prepare(`SELECT affected_files FROM incidents`)
+        .all();
+    const incidentCountByFile = new Map();
+    for (const r of incidentRows) {
+        if (!r.affected_files)
+            continue;
+        let files = [];
+        try {
+            const parsed = JSON.parse(r.affected_files);
+            if (Array.isArray(parsed))
+                files = parsed.filter((x) => typeof x === "string");
+        }
+        catch {
+            files = r.affected_files.split(",").map((s) => s.trim()).filter(Boolean);
+        }
+        for (const f of files)
+            incidentCountByFile.set(f, (incidentCountByFile.get(f) ?? 0) + 1);
+    }
+    // 4. Score each candidate.
+    const candidates = [];
+    for (const r of fileRows) {
+        const days = (now.getTime() - new Date(r.last_touch).getTime()) / 86_400_000;
+        if (days < minStale)
+            continue;
+        if (r.commits > maxCommits)
+            continue;
+        const entities = entityCountByFile.get(r.path) ?? 0;
+        const incidents = incidentCountByFile.get(r.path) ?? 0;
+        // Risk: incident history makes deletion riskier.
+        const risk = Math.min(1, incidents / 5);
+        const harvestScore = (days / 365) * (1 / Math.max(r.commits, 1)) * (1 - risk);
+        candidates.push({
+            filePath: r.path,
+            daysSinceTouch: Math.round(days),
+            commitCount: r.commits,
+            entityCount: entities,
+            incidentCount: incidents,
+            harvestScore: Math.round(harvestScore * 1000) / 1000,
+            risk: classifyHarvestRisk(incidents, entities, r.commits),
+            recommendation: buildHarvestRecommendation(days, entities, incidents),
+        });
+    }
+    candidates.sort((a, b) => b.harvestScore - a.harvestScore);
+    return candidates.slice(0, topN);
+}
+export function classifyHarvestRisk(incidents, entities, commits) {
+    if (incidents >= 3)
+        return "risky";
+    if (incidents >= 1 || entities >= 10)
+        return "moderate";
+    if (commits >= 4)
+        return "low-risk";
+    return "safe";
+}
+function buildHarvestRecommendation(days, entities, incidents) {
+    if (incidents >= 3) {
+        return "Risky to delete — past incidents associated with this file. Inspect manually.";
+    }
+    if (entities === 0 && days > 365) {
+        return "Likely safe to delete — no entities parsed and untouched for over a year.";
+    }
+    if (entities === 0) {
+        return "Probably dead — no entities. Verify no runtime imports before deleting.";
+    }
+    if (days > 730) {
+        return "Untouched for 2+ years. Strong candidate, but check downstream usage first.";
+    }
+    return "Stale candidate. Run static analysis to confirm no inbound references.";
+}
+export function summarizeHarvest(candidates) {
+    if (candidates.length === 0) {
+        return { candidateCount: 0, estimatedLinesSaved: 0, netSavings: 0, summary: "No harvestable candidates." };
+    }
+    // Approximate 50 LOC per file as a rough heuristic — refine by reading file size if needed.
+    const linesPerFile = 50;
+    const estLines = candidates.length * linesPerFile;
+    const avgRisk = candidates.reduce((s, c) => s + (c.risk === "risky" ? 1 : c.risk === "moderate" ? 0.5 : 0.1), 0) / candidates.length;
+    const netSavings = Math.round(estLines * (1 - avgRisk));
+    return {
+        candidateCount: candidates.length,
+        estimatedLinesSaved: estLines,
+        netSavings,
+        summary: `${candidates.length} harvestable files — ~${estLines} LOC potential, ~${netSavings} net of risk.`,
+    };
+}
+//# sourceMappingURL=tax-loss-harvest.js.map

package/dist/quant/tax-loss-harvest.js.map

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

package/dist/quant/tax-loss-harvest.test.d.ts

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

package/dist/quant/tax-loss-harvest.test.d.ts.map

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

package/dist/quant/tax-loss-harvest.test.js

@@ -0,0 +1,126 @@
+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 { findHarvestCandidates, classifyHarvestRisk, summarizeHarvest } from "./tax-loss-harvest.js";
+let tmpDir;
+let store;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "mneme-tlh-"));
+    store = new MnemeStore(join(tmpDir, "mneme.db"));
+});
+afterEach(() => {
+    store.close();
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+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,
+});
+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 })));
+    }
+}
+function seedIncident(affectedFiles) {
+    store.db
+        .prepare(`INSERT INTO incidents (id, source, title, occurred_at, severity, affected_files)
+       VALUES (?, 'manual', 'inc', ?, 'medium', ?)`)
+        .run(`inc-${Math.random()}`, "2024-01-01T00:00:00Z", JSON.stringify(affectedFiles));
+}
+describe("classifyHarvestRisk", () => {
+    it("'risky' when incidents ≥ 3", () => {
+        expect(classifyHarvestRisk(3, 0, 1)).toBe("risky");
+    });
+    it("'moderate' when entities ≥ 10 OR incidents ≥ 1", () => {
+        expect(classifyHarvestRisk(0, 12, 1)).toBe("moderate");
+        expect(classifyHarvestRisk(1, 0, 1)).toBe("moderate");
+    });
+    it("'low-risk' when commits ≥ 4 (some history)", () => {
+        expect(classifyHarvestRisk(0, 0, 4)).toBe("low-risk");
+    });
+    it("'safe' when nothing else applies", () => {
+        expect(classifyHarvestRisk(0, 0, 1)).toBe("safe");
+    });
+});
+describe("findHarvestCandidates — basic detection", () => {
+    it("returns empty when no files are stale enough", () => {
+        seed([cmt("a1", "2024-11-01", ["src/active.ts"])]);
+        expect(findHarvestCandidates(store, { now: new Date("2024-12-01"), minStaleDays: 180 })).toEqual([]);
+    });
+    it("flags a stale solo-touched file as a candidate", () => {
+        seed([cmt("a1", "2023-01-01", ["src/legacy.ts"])]);
+        const candidates = findHarvestCandidates(store, { now: new Date("2024-12-01") });
+        expect(candidates.find((c) => c.filePath === "src/legacy.ts")).toBeDefined();
+    });
+    it("respects maxCommits filter", () => {
+        const commits = Array.from({ length: 10 }, (_, i) => cmt(`a${i}`.padEnd(7, "x"), "2023-01-01", ["src/hot.ts"]));
+        seed(commits);
+        expect(findHarvestCandidates(store, { now: new Date("2024-12-01"), maxCommits: 5 }).find((c) => c.filePath === "src/hot.ts")).toBeUndefined();
+    });
+    it("higher harvest score for older + lower-commit files", () => {
+        seed([
+            cmt("a1", "2020-01-01", ["src/very-old.ts"]),
+            cmt("b1", "2023-06-01", ["src/recent-stale.ts"]),
+        ]);
+        const candidates = findHarvestCandidates(store, { now: new Date("2024-12-01"), minStaleDays: 90 });
+        expect(candidates[0].filePath).toBe("src/very-old.ts");
+    });
+    it("'risky' tier when file appears in 3+ incidents", () => {
+        seed([cmt("a1", "2023-01-01", ["src/payment.ts"])]);
+        seedIncident(["src/payment.ts"]);
+        seedIncident(["src/payment.ts"]);
+        seedIncident(["src/payment.ts"]);
+        const c = findHarvestCandidates(store, { now: new Date("2024-12-01") }).find((x) => x.filePath === "src/payment.ts");
+        expect(c.risk).toBe("risky");
+        expect(c.recommendation.toLowerCase()).toMatch(/risk|past incidents/);
+    });
+});
+describe("summarizeHarvest", () => {
+    it("returns zero metrics for empty input", () => {
+        const s = summarizeHarvest([]);
+        expect(s.candidateCount).toBe(0);
+        expect(s.estimatedLinesSaved).toBe(0);
+        expect(s.summary.toLowerCase()).toContain("no");
+    });
+    it("computes net-of-risk savings", () => {
+        const candidates = [
+            {
+                filePath: "src/a.ts",
+                daysSinceTouch: 500,
+                commitCount: 1,
+                entityCount: 0,
+                incidentCount: 0,
+                harvestScore: 1,
+                risk: "safe",
+                recommendation: "",
+            },
+            {
+                filePath: "src/b.ts",
+                daysSinceTouch: 600,
+                commitCount: 1,
+                entityCount: 0,
+                incidentCount: 4,
+                harvestScore: 0.5,
+                risk: "risky",
+                recommendation: "",
+            },
+        ];
+        const s = summarizeHarvest(candidates);
+        expect(s.candidateCount).toBe(2);
+        expect(s.estimatedLinesSaved).toBe(100);
+        // avg risk = (0.1 + 1) / 2 = 0.55 → net = 100 × (1 - 0.55) = 45
+        expect(s.netSavings).toBe(45);
+    });
+});
+//# sourceMappingURL=tax-loss-harvest.test.js.map

package/dist/quant/tax-loss-harvest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax-loss-harvest.test.js","sourceRoot":"","sources":["../../src/quant/tax-loss-harvest.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGrG,IAAI,MAAc,CAAC;AACnB,IAAI,KAAiB,CAAC;AAEtB,UAAU,CAAC,GAAG,EAAE;IACd,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACnD,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,KAAe,EAAU,EAAE,CAAC,CAAC;IACpE,IAAI;IACJ,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3B,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,GAAG,IAAI,YAAY;IAC/B,aAAa,EAAE,GAAG,IAAI,YAAY;IAClC,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,EAAE;IACX,KAAK;CACN,CAAC,CAAC;AAEH,SAAS,IAAI,CAAC,OAAiB;IAC7B,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,iBAAiB,CACrB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,GAAY,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAC7G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,aAAuB;IAC3C,KAAK,CAAC,EAAE;SACL,OAAO,CACN;mDAC6C,CAC9C;SACA,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,eAAe,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAClD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,YAAY,CAAC,CAAC,CAC1D,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,CAAC;QACd,MAAM,CACJ,qBAAqB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAC/E,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CACnC,CACF,CAAC,aAAa,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,iBAAiB,CAAC,CAAC;YAC5C,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,qBAAqB,CAAC,CAAC;SACjD,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACnG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,YAAY,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACjC,YAAY,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACjC,YAAY,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,qBAAqB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,CAC1E,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,gBAAgB,CACtC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,UAAU,GAAG;YACjB;gBACE,QAAQ,EAAE,UAAU;gBACpB,cAAc,EAAE,GAAG;gBACnB,WAAW,EAAE,CAAC;gBACd,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;gBACf,IAAI,EAAE,MAAe;gBACrB,cAAc,EAAE,EAAE;aACnB;YACD;gBACE,QAAQ,EAAE,UAAU;gBACpB,cAAc,EAAE,GAAG;gBACnB,WAAW,EAAE,CAAC;gBACd,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,GAAG;gBACjB,IAAI,EAAE,OAAgB;gBACtB,cAAc,EAAE,EAAE;aACnB;SACF,CAAC;QACF,MAAM,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,gEAAgE;QAChE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/retrieve/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./search.js";
 export * from "./rerank.js";
+export * from "./intent.js";
+export * from "./synthesize.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}