@mneme-ai/core 0.14.0 → 0.16.0

package/dist/retrieve/novel-scoring.js

@@ -0,0 +1,256 @@
+/**
+ * Novel scoring algorithms for Mneme retrieval.
+ *
+ * These formulas are designed to outperform pure semantic similarity by
+ * exploiting signals that other tools (which only embed file contents)
+ * cannot see: time decay, regret patterns, author diversity, and the
+ * causal graph implicit in commit/PR/issue references.
+ *
+ * All formulas are pure functions. They take the set of search results
+ * + (optional) commit history and produce a re-ranked list. Use them as
+ * post-processors over base BM25/cosine search.
+ *
+ * Algorithms:
+ *   1. TDWE — Time-Decay Weighted Embedding score
+ *      Formula: w(c) = exp(-λ · age_days / half_life)
+ *               adjusted = base × w(c)
+ *
+ *   2. RACB — Regret-Aware Chunk Boosting
+ *      Formula: boost(c) = 1 + ln(1 + days_to_followup × severity_factor)
+ *      Severity: revert=3, hotfix=2, fix=1, sameFiles=0.5, none=0
+ *
+ *   3. ADS — Author Diversity Score re-ranking
+ *      Formula: penalty = α · (same_author_above_in_ranking / K)
+ *               final = base × (1 - penalty)
+ *
+ *   4. CGAR — Causal Graph Augmented Retrieval (light)
+ *      Walks PR/issue links 2 hops; chunks reachable get boost = 0.85^hops
+ */
+/**
+ * Apply time-decay weighting to a base score.
+ *   - A commit from today gets weight ≈ 1.0
+ *   - A commit at half-life age gets weight ≈ 0.5
+ *   - A commit at 2× half-life age gets weight ≈ 0.25
+ */
+export function timeDecayWeight(commitDateIso, opts = {}) {
+    const nowMs = opts.nowMs ?? Date.now();
+    const halfLife = opts.halfLifeDays ?? 365;
+    const lambda = opts.lambda ?? Math.LN2;
+    const t = new Date(commitDateIso).getTime();
+    if (Number.isNaN(t))
+        return 1;
+    const ageDays = Math.max(0, (nowMs - t) / 86_400_000);
+    return Math.exp(-lambda * (ageDays / halfLife));
+}
+export function applyTdwe(results, opts = {}) {
+    return results
+        .map((r) => ({
+        ...r,
+        score: r.score * timeDecayWeight(r.commit.authorDate, opts),
+    }))
+        .sort((a, b) => b.score - a.score);
+}
+const DEFAULT_SEVERITY = {
+    revert: 3,
+    hotfix: 2,
+    fix: 1,
+    sameFiles: 0.5,
+    none: 0,
+};
+/**
+ * Compute regret boost for a single signal.
+ *   boost = 1 + ln(1 + days × severity)
+ *
+ * Why ln? Because the "wisdom" in a regret saturates. A 1-day-to-fix is
+ * very informative; a 30-day-to-fix is *more* informative but not 30×
+ * more. Logarithmic growth captures diminishing returns.
+ */
+export function regretBoost(signal, opts = {}) {
+    const maxBoost = opts.maxBoost ?? 2.5;
+    const severity = (opts.severityMap ?? DEFAULT_SEVERITY)[signal.kind] ?? 0;
+    if (severity === 0)
+        return 1;
+    const raw = 1 + Math.log(1 + signal.daysToFollowup * severity);
+    return Math.min(maxBoost, raw);
+}
+export function applyRacb(results, signals, opts = {}) {
+    const sigByHash = new Map();
+    for (const s of signals)
+        sigByHash.set(s.commitHash, s);
+    return results
+        .map((r) => {
+        const sig = sigByHash.get(r.commit.hash);
+        const boost = sig ? regretBoost(sig, opts) : 1;
+        return { ...r, score: r.score * boost };
+    })
+        .sort((a, b) => b.score - a.score);
+}
+/**
+ * Re-rank results to penalize over-representation of any single author.
+ *
+ * For each result at position i:
+ *   sameAuthorAbove = count of (j < i) where author(j) == author(i)
+ *   penalty = α × (sameAuthorAbove / total)
+ *   final = base × (1 - penalty)
+ *
+ * Then re-sort by final.
+ *
+ * Why this matters: when one author dominates a topic, retrieval becomes
+ * monocultural. Diversity surfaces the second-most-knowledgeable
+ * contributor, which the user often actually needs.
+ */
+export function applyAds(results, opts = {}) {
+    const alpha = opts.alpha ?? 0.4;
+    const topK = opts.topK ?? results.length;
+    const slice = results.slice(0, topK);
+    const total = Math.max(1, slice.length);
+    const adjusted = slice.map((r, i) => {
+        let sameAuthorAbove = 0;
+        for (let j = 0; j < i; j++) {
+            if (slice[j].commit.authorEmail === r.commit.authorEmail) {
+                sameAuthorAbove += 1;
+            }
+        }
+        const penalty = alpha * (sameAuthorAbove / total);
+        const finalScore = r.score * (1 - penalty);
+        return { ...r, score: finalScore };
+    });
+    adjusted.sort((a, b) => b.score - a.score);
+    return adjusted;
+}
+/**
+ * Build adjacency of "causal references" between commits using:
+ *   - PR numbers in body / subject
+ *   - Issue refs (closes #N, fixes #N, etc.)
+ *   - Reverts that name a commit hash
+ *
+ * Returns a map: commitHash → Set<referenced commit hash>
+ */
+export function buildCausalGraph(commits) {
+    const graph = new Map();
+    const byPrNumber = new Map();
+    for (const c of commits) {
+        if (c.prNumber)
+            byPrNumber.set(c.prNumber, c.hash);
+    }
+    const PR_REF = /(?:pr|pull request|merge\s+pull\s+request)\s*#?\s*(\d+)|#(\d+)/gi;
+    const HASH_REF = /\b([0-9a-f]{7,40})\b/gi;
+    const REVERT_HASH = /revert(?:s|ed)?\s+(?:commit\s+)?["`]?([0-9a-f]{7,40})/i;
+    for (const c of commits) {
+        const text = `${c.subject}\n${c.body || ""}`;
+        const refs = new Set();
+        // PR/issue references
+        let m;
+        PR_REF.lastIndex = 0;
+        while ((m = PR_REF.exec(text)) !== null) {
+            const num = Number(m[1] ?? m[2]);
+            const target = byPrNumber.get(num);
+            if (target && target !== c.hash)
+                refs.add(target);
+        }
+        // Direct hash references — match against commits in the index
+        HASH_REF.lastIndex = 0;
+        while ((m = HASH_REF.exec(text)) !== null) {
+            const candidate = m[1].toLowerCase();
+            if (candidate.length < 7)
+                continue;
+            // Find any commit whose hash starts with this candidate
+            for (const target of commits) {
+                if (target.hash === c.hash)
+                    continue;
+                if (target.hash.toLowerCase().startsWith(candidate)) {
+                    refs.add(target.hash);
+                    break;
+                }
+            }
+        }
+        // Revert markers
+        const rev = REVERT_HASH.exec(c.subject + " " + (c.body || ""));
+        if (rev) {
+            const candidate = rev[1].toLowerCase();
+            for (const target of commits) {
+                if (target.hash === c.hash)
+                    continue;
+                if (target.hash.toLowerCase().startsWith(candidate)) {
+                    refs.add(target.hash);
+                    break;
+                }
+            }
+        }
+        if (refs.size > 0)
+            graph.set(c.hash, refs);
+    }
+    return graph;
+}
+/**
+ * Boost search results by causal proximity to the top hit.
+ *
+ * If a chunk's commit is referenced (directly or transitively up to
+ * maxHops) by another result's commit, its score gets boosted.
+ */
+export function applyCgar(results, commits, opts = {}) {
+    const maxHops = opts.maxHops ?? 2;
+    const decay = opts.hopDecay ?? 0.85;
+    const initial = opts.initialBoost ?? 1.3;
+    if (results.length === 0)
+        return results;
+    const graph = buildCausalGraph(commits);
+    // Compute distance (in hops) from any result-commit to every commit it
+    // references transitively.
+    const seedHashes = new Set(results.map((r) => r.commit.hash));
+    const distance = new Map();
+    // BFS from each seed
+    for (const seed of seedHashes) {
+        const queue = [[seed, 0]];
+        const seen = new Set([seed]);
+        while (queue.length > 0) {
+            const [node, hops] = queue.shift();
+            if (hops >= maxHops)
+                continue;
+            const neighbors = graph.get(node);
+            if (!neighbors)
+                continue;
+            for (const nb of neighbors) {
+                if (seen.has(nb))
+                    continue;
+                seen.add(nb);
+                const cur = distance.get(nb);
+                if (cur === undefined || hops + 1 < cur) {
+                    distance.set(nb, hops + 1);
+                }
+                queue.push([nb, hops + 1]);
+            }
+        }
+    }
+    return results
+        .map((r) => {
+        const hops = distance.get(r.commit.hash);
+        if (hops === undefined || hops === 0)
+            return r;
+        const boost = initial * Math.pow(decay, hops - 1);
+        return { ...r, score: r.score * boost };
+    })
+        .sort((a, b) => b.score - a.score);
+}
+/**
+ * Apply all four novel scoring layers in sequence:
+ *   1. TDWE — temporal relevance
+ *   2. RACB — regret-derived wisdom boost
+ *   3. CGAR — causal graph propagation
+ *   4. ADS — diversity re-ranking (last, after scoring is final)
+ */
+export function applyNovelScoring(results, ensemble) {
+    let r = results;
+    if (ensemble.tdwe !== false)
+        r = applyTdwe(r, ensemble.tdwe || {});
+    if (ensemble.racb !== false && ensemble.racb) {
+        r = applyRacb(r, ensemble.racb.signals, ensemble.racb.opts);
+    }
+    if (ensemble.cgar !== false && ensemble.cgar) {
+        r = applyCgar(r, ensemble.cgar.commits, ensemble.cgar.opts);
+    }
+    if (ensemble.ads !== false)
+        r = applyAds(r, ensemble.ads || {});
+    return r;
+}
+//# sourceMappingURL=novel-scoring.js.map

package/dist/retrieve/novel-scoring.js.map

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

package/dist/retrieve/novel-scoring.test.d.ts

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

package/dist/retrieve/novel-scoring.test.d.ts.map

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

package/dist/retrieve/novel-scoring.test.js

@@ -0,0 +1,221 @@
+import { describe, it, expect } from "vitest";
+import { timeDecayWeight, applyTdwe, regretBoost, applyRacb, applyAds, buildCausalGraph, applyCgar, applyNovelScoring, } from "./novel-scoring.js";
+const NOW = new Date("2026-05-06").getTime();
+function mkCommit(p) {
+    return {
+        hash: p.hash,
+        shortHash: p.hash.slice(0, 7),
+        authorName: p.author ?? "Alice",
+        authorEmail: (p.author ?? "alice").toLowerCase() + "@x.com",
+        authorDate: p.date,
+        committerDate: p.date,
+        subject: p.subject ?? "x",
+        body: p.body ?? "",
+        files: [],
+        parents: [],
+        prNumber: p.pr,
+    };
+}
+function mkResult(c, score) {
+    return { commit: c, score, matchedChunks: [] };
+}
+// ─── TDWE ──────────────────────────────────────────────────────────────
+describe("timeDecayWeight", () => {
+    it("returns ≈ 1 for today's commit", () => {
+        const w = timeDecayWeight(new Date(NOW).toISOString(), { nowMs: NOW });
+        expect(w).toBeGreaterThan(0.99);
+    });
+    it("returns ≈ 0.5 at half-life age", () => {
+        const halfLifeAgo = new Date(NOW - 365 * 86_400_000).toISOString();
+        const w = timeDecayWeight(halfLifeAgo, { nowMs: NOW, halfLifeDays: 365 });
+        expect(w).toBeCloseTo(0.5, 1);
+    });
+    it("returns ≈ 0.25 at 2× half-life age", () => {
+        const twiceHalfLife = new Date(NOW - 730 * 86_400_000).toISOString();
+        const w = timeDecayWeight(twiceHalfLife, { nowMs: NOW, halfLifeDays: 365 });
+        expect(w).toBeCloseTo(0.25, 1);
+    });
+    it("clamps negative ages to 0 (future commits = weight 1)", () => {
+        const future = new Date(NOW + 86_400_000).toISOString();
+        const w = timeDecayWeight(future, { nowMs: NOW });
+        expect(w).toBe(1);
+    });
+});
+describe("applyTdwe", () => {
+    it("boosts recent commits over old ones with same base score", () => {
+        const recent = mkCommit({ hash: "r1", date: "2026-04-01" });
+        const old = mkCommit({ hash: "o1", date: "2024-04-01" });
+        const results = [mkResult(old, 0.5), mkResult(recent, 0.5)];
+        const out = applyTdwe(results, { nowMs: NOW });
+        expect(out[0].commit.hash).toBe("r1");
+    });
+    it("preserves score ordering when ages are equal", () => {
+        const c1 = mkCommit({ hash: "a", date: "2026-04-01" });
+        const c2 = mkCommit({ hash: "b", date: "2026-04-01" });
+        const out = applyTdwe([mkResult(c1, 0.3), mkResult(c2, 0.5)], { nowMs: NOW });
+        expect(out[0].commit.hash).toBe("b");
+    });
+});
+// ─── RACB ──────────────────────────────────────────────────────────────
+describe("regretBoost", () => {
+    it("returns 1 when severity = 0 (no regret)", () => {
+        const b = regretBoost({ commitHash: "x", kind: "none", daysToFollowup: 5 });
+        expect(b).toBe(1);
+    });
+    it("scales boost with daysToFollowup logarithmically", () => {
+        const day1 = regretBoost({ commitHash: "x", kind: "fix", daysToFollowup: 1 });
+        const day7 = regretBoost({ commitHash: "x", kind: "fix", daysToFollowup: 7 });
+        expect(day7).toBeGreaterThan(day1);
+        expect(day7).toBeLessThan(day1 * 7); // sub-linear
+    });
+    it("revert > hotfix > fix for same days (using small enough days to avoid cap)", () => {
+        // Use days=0.5 so all three stay below the maxBoost cap
+        const r = regretBoost({ commitHash: "x", kind: "revert", daysToFollowup: 0.5 });
+        const h = regretBoost({ commitHash: "x", kind: "hotfix", daysToFollowup: 0.5 });
+        const f = regretBoost({ commitHash: "x", kind: "fix", daysToFollowup: 0.5 });
+        expect(r).toBeGreaterThan(h);
+        expect(h).toBeGreaterThan(f);
+    });
+    it("respects maxBoost cap", () => {
+        const b = regretBoost({ commitHash: "x", kind: "revert", daysToFollowup: 1000 }, { maxBoost: 1.5 });
+        expect(b).toBeLessThanOrEqual(1.5);
+    });
+});
+describe("applyRacb", () => {
+    it("boosts commits with regret signals", () => {
+        const commits = [
+            mkCommit({ hash: "regretted", date: "2024-01-01" }),
+            mkCommit({ hash: "clean", date: "2024-01-01" }),
+        ];
+        const results = [mkResult(commits[1], 0.6), mkResult(commits[0], 0.5)];
+        const signals = [
+            { commitHash: "regretted", kind: "revert", daysToFollowup: 2 },
+        ];
+        const out = applyRacb(results, signals);
+        // The regretted commit should now beat the clean one despite lower base score
+        expect(out[0].commit.hash).toBe("regretted");
+    });
+});
+// ─── ADS ──────────────────────────────────────────────────────────────
+describe("applyAds", () => {
+    it("penalizes results from the same author appearing repeatedly", () => {
+        const commits = [
+            mkCommit({ hash: "a1", date: "2024-01-01", author: "Alice" }),
+            mkCommit({ hash: "a2", date: "2024-01-02", author: "Alice" }),
+            mkCommit({ hash: "a3", date: "2024-01-03", author: "Alice" }),
+            mkCommit({ hash: "b1", date: "2024-01-04", author: "Bob" }),
+        ];
+        // Alice dominates with high scores; Bob has a lower score
+        const results = [
+            mkResult(commits[0], 0.50),
+            mkResult(commits[1], 0.49),
+            mkResult(commits[2], 0.48),
+            mkResult(commits[3], 0.40),
+        ];
+        const out = applyAds(results, { alpha: 0.4 });
+        // Bob should rise above some Alice entries despite lower base score
+        const bobIdx = out.findIndex((r) => r.commit.authorEmail === "bob@x.com");
+        expect(bobIdx).toBeLessThanOrEqual(2);
+    });
+    it("preserves order when all results are different authors", () => {
+        const commits = [
+            mkCommit({ hash: "a", date: "2024-01-01", author: "Alice" }),
+            mkCommit({ hash: "b", date: "2024-01-01", author: "Bob" }),
+            mkCommit({ hash: "c", date: "2024-01-01", author: "Carol" }),
+        ];
+        const out = applyAds([
+            mkResult(commits[0], 0.5),
+            mkResult(commits[1], 0.4),
+            mkResult(commits[2], 0.3),
+        ]);
+        expect(out.map((r) => r.commit.hash)).toEqual(["a", "b", "c"]);
+    });
+});
+// ─── CGAR ──────────────────────────────────────────────────────────────
+describe("buildCausalGraph", () => {
+    it("links commits via PR number references", () => {
+        const commits = [
+            mkCommit({ hash: "old", date: "2024-01-01", pr: 482 }),
+            mkCommit({ hash: "new", date: "2024-02-01", subject: "follow-up to PR #482" }),
+        ];
+        const g = buildCausalGraph(commits);
+        expect(g.get("new")?.has("old")).toBe(true);
+    });
+    it("links commits via direct hash references", () => {
+        const commits = [
+            mkCommit({ hash: "abc1234defabcdef", date: "2024-01-01" }),
+            mkCommit({ hash: "new", date: "2024-02-01", subject: "fix regression in abc1234" }),
+        ];
+        const g = buildCausalGraph(commits);
+        expect(g.get("new")?.has("abc1234defabcdef")).toBe(true);
+    });
+    it("links revert commits to their target", () => {
+        const commits = [
+            mkCommit({ hash: "abc1234defabcdef", date: "2024-01-01", subject: "add caching" }),
+            mkCommit({ hash: "rev1", date: "2024-02-01", subject: "Revert \"add caching\"", body: "Reverts commit abc1234" }),
+        ];
+        const g = buildCausalGraph(commits);
+        expect(g.get("rev1")?.has("abc1234defabcdef")).toBe(true);
+    });
+});
+describe("applyCgar", () => {
+    it("boosts results that are causally linked to other results", () => {
+        const commits = [
+            mkCommit({ hash: "abcd1234efghij5678", date: "2024-01-01", subject: "feat: caching" }),
+            mkCommit({ hash: "linked", date: "2024-02-01", subject: "follow-up to abcd1234" }),
+            mkCommit({ hash: "unrelated", date: "2024-02-15", subject: "docs: typo" }),
+        ];
+        const results = [
+            mkResult(commits[0], 0.7),
+            mkResult(commits[1], 0.4),
+            mkResult(commits[2], 0.4),
+        ];
+        const out = applyCgar(results, commits);
+        // "linked" should rise above "unrelated" because it's causally connected
+        const linkedIdx = out.findIndex((r) => r.commit.hash === "linked");
+        const unrelatedIdx = out.findIndex((r) => r.commit.hash === "unrelated");
+        expect(linkedIdx).toBeLessThan(unrelatedIdx);
+    });
+    it("respects maxHops bound", () => {
+        const commits = [
+            mkCommit({ hash: "a", date: "2024-01-01" }),
+            mkCommit({ hash: "b", date: "2024-02-01", subject: "ref a" }),
+            mkCommit({ hash: "c", date: "2024-03-01", subject: "ref b" }),
+        ];
+        // With maxHops=1, c shouldn't get a boost (it's 2 hops from a)
+        const out1 = applyCgar([mkResult(commits[0], 0.5), mkResult(commits[2], 0.3)], commits, { maxHops: 1 });
+        expect(out1[0].commit.hash).toBe("a");
+    });
+});
+// ─── ENSEMBLE ──────────────────────────────────────────────────────────
+describe("applyNovelScoring (ensemble)", () => {
+    it("composes all four algorithms without errors", () => {
+        const commits = [
+            mkCommit({ hash: "a1", date: "2026-04-01", author: "Alice", pr: 1 }),
+            mkCommit({ hash: "a2", date: "2024-04-01", author: "Alice", subject: "ref PR #1" }),
+            mkCommit({ hash: "b1", date: "2025-04-01", author: "Bob" }),
+        ];
+        const results = [
+            mkResult(commits[0], 0.5),
+            mkResult(commits[1], 0.4),
+            mkResult(commits[2], 0.45),
+        ];
+        const out = applyNovelScoring(results, {
+            tdwe: { nowMs: new Date("2026-05-06").getTime() },
+            racb: {
+                signals: [{ commitHash: "a2", kind: "fix", daysToFollowup: 3 }],
+            },
+            ads: { alpha: 0.3 },
+            cgar: { commits },
+        });
+        expect(out.length).toBe(3);
+        // Every output should still have a valid score
+        for (const r of out)
+            expect(r.score).toBeGreaterThan(0);
+    });
+    it("returns empty array when input is empty", () => {
+        const out = applyNovelScoring([], {});
+        expect(out).toEqual([]);
+    });
+});
+//# sourceMappingURL=novel-scoring.test.js.map

package/dist/retrieve/novel-scoring.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/core",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",