@mneme-ai/core 0.15.0 → 0.16.0

package/dist/guardian/guardian.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Mneme Guardian — the 24/7 self-healing engine.
+ *
+ *   while (true) {
+ *     diagnose();
+ *     fix();
+ *     learn();
+ *     sleep(interval);
+ *   }
+ *
+ * The Guardian is a long-running diagnostic + auto-remediation loop. It
+ * watches for weaknesses (regressions in index quality, drift between
+ * HEAD and the index, missing embeddings, schema-version mismatch) and
+ * threats (data corruption signals, token expiry on remote APIs, secret
+ * patterns slipping through redaction) and applies safe corrective
+ * actions automatically. Anything risky is *logged with a recommendation*
+ * rather than auto-applied.
+ *
+ * Pure data structures + dispatch — no side effects in this module
+ * (file I/O lives in the CLI command). Caller decides whether to
+ * actually apply the recommended action or just observe.
+ *
+ * Design principles:
+ *   • SAFE BY DEFAULT — auto-apply only the actions that are demonstrably
+ *     reversible (re-index, calibrate). Anything that could lose data
+ *     gets recommended, not executed.
+ *   • OBSERVABLE — every diagnosis + action is appended to a JSONL log so
+ *     the operator can audit what the daemon did.
+ *   • DETERMINISTIC — same inputs → same diagnosis. No flaky heuristics.
+ */
+import type { Commit } from "../types.js";
+import type { IndexQualityReport } from "../indexer/quality.js";
+export type WeaknessKind = "drift" | "missing-embeddings" | "low-quality" | "stale-calibration" | "schema-drift" | "token-expiry" | "redaction-gap";
+export type ThreatKind = "tamper" | "secret-leak" | "outlier-author" | "deletion-storm";
+export type Severity = "low" | "medium" | "high" | "critical";
+export type ActionPolicy = "auto" | "recommended" | "observe";
+export interface GuardianFinding {
+    kind: WeaknessKind | ThreatKind;
+    severity: Severity;
+    /** One-line summary for the operator. */
+    message: string;
+    /** Suggested CLI command to apply the fix (if any). */
+    suggestedAction?: string;
+    /** Whether the daemon should auto-apply. */
+    policy: ActionPolicy;
+    /** Free-form structured detail. */
+    detail?: Record<string, unknown>;
+}
+export interface GuardianInput {
+    /** Latest HEAD commits in git (most recent first). */
+    headCommits: Commit[];
+    /** Commits currently indexed (most recent first). */
+    indexedCommits: Commit[];
+    /** Most recent index quality report (if available). */
+    quality: IndexQualityReport | null;
+    /** Last-known good index quality (for regression detection). */
+    lastQualityScore: number | null;
+    /** Schema version recorded in the store. */
+    storeSchemaVersion: number;
+    /** Schema version expected by the running binary. */
+    expectedSchemaVersion: number;
+    /** Number of feedback events since last `mneme calibrate`. */
+    feedbackEventsSinceCalibrate: number;
+    /** Threshold above which calibrate is recommended. Default 25. */
+    feedbackCalibrateThreshold?: number;
+    /** Threshold below which low-quality is flagged (0..1). Default 0.55 (= grade C). */
+    qualityFloor?: number;
+    /** Quality regression threshold (drop in score). Default 0.1. */
+    qualityRegressionThreshold?: number;
+}
+export interface GuardianReport {
+    generatedAt: string;
+    findings: GuardianFinding[];
+    summary: {
+        findings: number;
+        autoActions: number;
+        recommendations: number;
+        threats: number;
+    };
+}
+/**
+ * Run one diagnostic pass. Pure function — same input → same output.
+ *
+ * The CLI wraps this in `while (true)` with a sleep, but the diagnosis
+ * itself is stateless.
+ */
+export declare function diagnose(input: GuardianInput): GuardianReport;
+/**
+ * Decide which findings the daemon should auto-apply this tick. Returns
+ * findings ordered by severity (high → low).
+ */
+export declare function selectAutoActions(report: GuardianReport): GuardianFinding[];
+//# sourceMappingURL=guardian.d.ts.map

package/dist/guardian/guardian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardian.d.ts","sourceRoot":"","sources":["../../src/guardian/guardian.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,oBAAoB,GACpB,aAAa,GACb,mBAAmB,GACnB,cAAc,GACd,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,aAAa,GACb,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9D,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,MAAM,EAAE,YAAY,CAAC;IACrB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,4BAA4B,EAAE,MAAM,CAAC;IACrC,kEAAkE;IAClE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CA0H7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,EAAE,CAU3E"}

package/dist/guardian/guardian.js

@@ -0,0 +1,170 @@
+/**
+ * Mneme Guardian — the 24/7 self-healing engine.
+ *
+ *   while (true) {
+ *     diagnose();
+ *     fix();
+ *     learn();
+ *     sleep(interval);
+ *   }
+ *
+ * The Guardian is a long-running diagnostic + auto-remediation loop. It
+ * watches for weaknesses (regressions in index quality, drift between
+ * HEAD and the index, missing embeddings, schema-version mismatch) and
+ * threats (data corruption signals, token expiry on remote APIs, secret
+ * patterns slipping through redaction) and applies safe corrective
+ * actions automatically. Anything risky is *logged with a recommendation*
+ * rather than auto-applied.
+ *
+ * Pure data structures + dispatch — no side effects in this module
+ * (file I/O lives in the CLI command). Caller decides whether to
+ * actually apply the recommended action or just observe.
+ *
+ * Design principles:
+ *   • SAFE BY DEFAULT — auto-apply only the actions that are demonstrably
+ *     reversible (re-index, calibrate). Anything that could lose data
+ *     gets recommended, not executed.
+ *   • OBSERVABLE — every diagnosis + action is appended to a JSONL log so
+ *     the operator can audit what the daemon did.
+ *   • DETERMINISTIC — same inputs → same diagnosis. No flaky heuristics.
+ */
+/**
+ * Run one diagnostic pass. Pure function — same input → same output.
+ *
+ * The CLI wraps this in `while (true)` with a sleep, but the diagnosis
+ * itself is stateless.
+ */
+export function diagnose(input) {
+    const findings = [];
+    const feedbackThreshold = input.feedbackCalibrateThreshold ?? 25;
+    const qualityFloor = input.qualityFloor ?? 0.55;
+    const qualityRegression = input.qualityRegressionThreshold ?? 0.1;
+    // ── Weakness 1: index drift ────────────────────────────────────────
+    const indexedHashes = new Set(input.indexedCommits.map((c) => c.hash));
+    const driftingCommits = input.headCommits.filter((c) => !indexedHashes.has(c.hash));
+    if (driftingCommits.length > 0) {
+        const sev = driftingCommits.length > 50
+            ? "high"
+            : driftingCommits.length > 10
+                ? "medium"
+                : "low";
+        findings.push({
+            kind: "drift",
+            severity: sev,
+            message: `${driftingCommits.length} commit(s) on HEAD not yet indexed.`,
+            suggestedAction: "mneme index",
+            policy: "auto",
+            detail: {
+                driftingCount: driftingCommits.length,
+                headNewest: input.headCommits[0]?.hash,
+                indexNewest: input.indexedCommits[0]?.hash,
+            },
+        });
+    }
+    // ── Weakness 2: missing embeddings ─────────────────────────────────
+    if (input.quality) {
+        const embedRatio = input.quality.metrics.embedRatio;
+        if (embedRatio < 0.95 && input.quality.indexedChunks > 0) {
+            findings.push({
+                kind: "missing-embeddings",
+                severity: embedRatio < 0.5 ? "high" : "medium",
+                message: `${Math.round((1 - embedRatio) * 100)}% of chunks have no embedding (${input.quality.indexedChunks - input.quality.embeddedChunks} chunks).`,
+                suggestedAction: "mneme index",
+                policy: "auto",
+                detail: { embedRatio },
+            });
+        }
+    }
+    // ── Weakness 3: low overall quality ────────────────────────────────
+    if (input.quality && input.quality.overallScore < qualityFloor) {
+        findings.push({
+            kind: "low-quality",
+            severity: input.quality.overallScore < 0.4 ? "high" : "medium",
+            message: `Index quality grade ${input.quality.grade} (${Math.round(input.quality.overallScore * 100)}/100) is below recommended floor.`,
+            suggestedAction: "mneme heal",
+            policy: "recommended",
+            detail: {
+                score: input.quality.overallScore,
+                grade: input.quality.grade,
+            },
+        });
+    }
+    // ── Weakness 3b: quality regression ────────────────────────────────
+    if (input.quality &&
+        input.lastQualityScore !== null &&
+        input.lastQualityScore - input.quality.overallScore >= qualityRegression) {
+        findings.push({
+            kind: "low-quality",
+            severity: "medium",
+            message: `Index quality dropped from ${Math.round(input.lastQualityScore * 100)} to ${Math.round(input.quality.overallScore * 100)}.`,
+            suggestedAction: "mneme index --analyze",
+            policy: "observe",
+            detail: {
+                before: input.lastQualityScore,
+                after: input.quality.overallScore,
+                regression: input.lastQualityScore - input.quality.overallScore,
+            },
+        });
+    }
+    // ── Weakness 4: stale calibration ──────────────────────────────────
+    if (input.feedbackEventsSinceCalibrate >= feedbackThreshold) {
+        findings.push({
+            kind: "stale-calibration",
+            severity: "low",
+            message: `${input.feedbackEventsSinceCalibrate} feedback events since last calibrate — retrieval knobs may need re-tuning.`,
+            suggestedAction: "mneme calibrate",
+            policy: "auto",
+            detail: {
+                eventsSinceCalibrate: input.feedbackEventsSinceCalibrate,
+                threshold: feedbackThreshold,
+            },
+        });
+    }
+    // ── Weakness 5: schema drift ───────────────────────────────────────
+    if (input.storeSchemaVersion < input.expectedSchemaVersion) {
+        findings.push({
+            kind: "schema-drift",
+            severity: "high",
+            message: `Store schema is v${input.storeSchemaVersion}, binary expects v${input.expectedSchemaVersion}.`,
+            suggestedAction: "mneme index",
+            policy: "auto",
+            detail: {
+                storeVersion: input.storeSchemaVersion,
+                expectedVersion: input.expectedSchemaVersion,
+            },
+        });
+    }
+    const summary = {
+        findings: findings.length,
+        autoActions: findings.filter((f) => f.policy === "auto").length,
+        recommendations: findings.filter((f) => f.policy === "recommended").length,
+        threats: findings.filter((f) => isThreat(f.kind)).length,
+    };
+    return {
+        generatedAt: new Date().toISOString(),
+        findings,
+        summary,
+    };
+}
+/**
+ * Decide which findings the daemon should auto-apply this tick. Returns
+ * findings ordered by severity (high → low).
+ */
+export function selectAutoActions(report) {
+    const order = {
+        critical: 0,
+        high: 1,
+        medium: 2,
+        low: 3,
+    };
+    return report.findings
+        .filter((f) => f.policy === "auto")
+        .sort((a, b) => order[a.severity] - order[b.severity]);
+}
+function isThreat(kind) {
+    return (kind === "tamper" ||
+        kind === "secret-leak" ||
+        kind === "outlier-author" ||
+        kind === "deletion-storm");
+}
+//# sourceMappingURL=guardian.js.map

package/dist/guardian/guardian.js.map

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

package/dist/guardian/guardian.test.d.ts

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

package/dist/guardian/guardian.test.d.ts.map

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

package/dist/guardian/guardian.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect } from "vitest";
+import { diagnose, selectAutoActions } from "./guardian.js";
+function mkCommit(hash, date = "2024-01-01") {
+    return {
+        hash,
+        shortHash: hash.slice(0, 7),
+        authorName: "A",
+        authorEmail: "a@x.com",
+        authorDate: date,
+        committerDate: date,
+        subject: "x",
+        body: "",
+        files: [],
+        parents: [],
+    };
+}
+function mkQuality(score, embedRatio = 1) {
+    return {
+        indexedCommits: 10,
+        indexedChunks: 30,
+        embeddedChunks: Math.round(30 * embedRatio),
+        metrics: {
+            chunkDensity: 1,
+            embedRatio,
+            subjectQuality: 1,
+            bodyRatio: 1,
+            prRatio: 1,
+            issueRatio: 1,
+            duplicateRatio: 0,
+            tokenizerHealth: 1,
+        },
+        overallScore: score,
+        grade: score >= 0.85 ? "A" : score >= 0.7 ? "B" : score >= 0.55 ? "C" : score >= 0.4 ? "D" : "F",
+        recommendations: [],
+    };
+}
+const baseInput = {
+    headCommits: [],
+    indexedCommits: [],
+    quality: mkQuality(0.9),
+    lastQualityScore: 0.9,
+    storeSchemaVersion: 3,
+    expectedSchemaVersion: 3,
+    feedbackEventsSinceCalibrate: 0,
+};
+describe("diagnose", () => {
+    it("returns no findings when everything is healthy", () => {
+        const r = diagnose(baseInput);
+        expect(r.findings).toHaveLength(0);
+        expect(r.summary.autoActions).toBe(0);
+    });
+    it("detects index drift when HEAD has commits not in index", () => {
+        const r = diagnose({
+            ...baseInput,
+            headCommits: [mkCommit("new1"), mkCommit("new2"), mkCommit("indexed")],
+            indexedCommits: [mkCommit("indexed")],
+        });
+        const drift = r.findings.find((f) => f.kind === "drift");
+        expect(drift).toBeDefined();
+        expect(drift.policy).toBe("auto");
+        expect(drift.suggestedAction).toBe("mneme index");
+    });
+    it("escalates drift severity by count", () => {
+        const lots = Array.from({ length: 60 }, (_, i) => mkCommit("c" + i));
+        const r = diagnose({
+            ...baseInput,
+            headCommits: lots,
+            indexedCommits: [],
+        });
+        const drift = r.findings.find((f) => f.kind === "drift");
+        expect(drift.severity).toBe("high");
+    });
+    it("detects missing embeddings", () => {
+        const r = diagnose({
+            ...baseInput,
+            quality: mkQuality(0.9, 0.7),
+        });
+        const missing = r.findings.find((f) => f.kind === "missing-embeddings");
+        expect(missing).toBeDefined();
+        expect(missing.policy).toBe("auto");
+    });
+    it("flags low quality below floor", () => {
+        const r = diagnose({
+            ...baseInput,
+            quality: mkQuality(0.4),
+        });
+        const low = r.findings.find((f) => f.kind === "low-quality");
+        expect(low).toBeDefined();
+        expect(low.policy).toBe("recommended");
+    });
+    it("flags quality regression even when above floor", () => {
+        const r = diagnose({
+            ...baseInput,
+            quality: mkQuality(0.7),
+            lastQualityScore: 0.9,
+        });
+        const reg = r.findings.find((f) => f.kind === "low-quality" &&
+            f.message.toLowerCase().includes("dropped"));
+        expect(reg).toBeDefined();
+    });
+    it("recommends calibrate when feedback accumulates", () => {
+        const r = diagnose({
+            ...baseInput,
+            feedbackEventsSinceCalibrate: 50,
+        });
+        const stale = r.findings.find((f) => f.kind === "stale-calibration");
+        expect(stale).toBeDefined();
+        expect(stale.policy).toBe("auto");
+        expect(stale.suggestedAction).toBe("mneme calibrate");
+    });
+    it("flags schema drift when store < expected", () => {
+        const r = diagnose({
+            ...baseInput,
+            storeSchemaVersion: 2,
+            expectedSchemaVersion: 3,
+        });
+        const sd = r.findings.find((f) => f.kind === "schema-drift");
+        expect(sd).toBeDefined();
+        expect(sd.severity).toBe("high");
+    });
+    it("returns deterministic output for same input", () => {
+        const a = diagnose({
+            ...baseInput,
+            headCommits: [mkCommit("a")],
+            indexedCommits: [],
+        });
+        const b = diagnose({
+            ...baseInput,
+            headCommits: [mkCommit("a")],
+            indexedCommits: [],
+        });
+        expect(a.findings).toEqual(b.findings);
+    });
+});
+describe("selectAutoActions", () => {
+    it("returns only auto-policy findings, sorted by severity", () => {
+        const report = diagnose({
+            ...baseInput,
+            headCommits: [mkCommit("new1")], // low/medium drift → auto
+            indexedCommits: [],
+            storeSchemaVersion: 2, // high schema-drift → auto
+            expectedSchemaVersion: 3,
+            quality: mkQuality(0.4), // medium low-quality → recommended (not auto)
+            feedbackEventsSinceCalibrate: 30, // low stale-calib → auto
+        });
+        const actions = selectAutoActions(report);
+        // High severity should come first
+        expect(actions[0].severity).toBe("high");
+        // No "recommended" findings should be in the auto list
+        for (const a of actions)
+            expect(a.policy).toBe("auto");
+    });
+});
+//# sourceMappingURL=guardian.test.js.map

package/dist/guardian/guardian.test.js.map

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

package/dist/guardian/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./guardian.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guardian/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/guardian/index.js

@@ -0,0 +1,2 @@
+export * from "./guardian.js";
+//# sourceMappingURL=index.js.map

package/dist/guardian/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guardian/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/index.d.ts

@@ -10,4 +10,5 @@ export * as util from "./util/index.js";
 export * as wisdom from "./wisdom/index.js";
 export * as insights from "./insights/index.js";
 export * as quant from "./quant/index.js";
+export * as guardian from "./guardian/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -10,4 +10,5 @@ export * as util from "./util/index.js";
 export * as wisdom from "./wisdom/index.js";
 export * as insights from "./insights/index.js";
 export * as quant from "./quant/index.js";
+export * as guardian from "./guardian/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC"}

package/dist/retrieve/index.d.ts

@@ -2,4 +2,5 @@ export * from "./search.js";
 export * from "./rerank.js";
 export * from "./intent.js";
 export * from "./synthesize.js";
+export * from "./novel-scoring.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;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,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;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/retrieve/index.js

@@ -2,4 +2,5 @@ export * from "./search.js";
 export * from "./rerank.js";
 export * from "./intent.js";
 export * from "./synthesize.js";
+export * from "./novel-scoring.js";
 //# sourceMappingURL=index.js.map

package/dist/retrieve/index.js.map

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

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

@@ -0,0 +1,146 @@
+/**
+ * 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
+ */
+import type { Commit, SearchResult } from "../types.js";
+export interface TdweOptions {
+    /** Reference time (UTC ms). Defaults to Date.now(). */
+    nowMs?: number;
+    /**
+     * Half-life in days. After this many days, weight decays to 0.5.
+     * Default 365 — a year-old commit is half as relevant as today's.
+     * Set higher for stable codebases, lower for fast-moving repos.
+     */
+    halfLifeDays?: number;
+    /**
+     * λ — decay coefficient. Higher = more aggressive decay.
+     * Default 0.693 (ln 2) so that age = halfLifeDays gives weight 0.5.
+     */
+    lambda?: number;
+}
+/**
+ * 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 declare function timeDecayWeight(commitDateIso: string, opts?: TdweOptions): number;
+export declare function applyTdwe(results: SearchResult[], opts?: TdweOptions): SearchResult[];
+export type RegretKind = "revert" | "hotfix" | "fix" | "sameFiles" | "none";
+export interface RegretSignal {
+    /** Commit hash that exhibits a regret follow-up. */
+    commitHash: string;
+    /** What kind of follow-up was detected. */
+    kind: RegretKind;
+    /** Days from commit to its follow-up. */
+    daysToFollowup: number;
+}
+export interface RacbOptions {
+    /**
+     * Maximum boost cap (multiplicative). Default 2.5 — chunks from highly
+     * regretted commits get up to 2.5× boost.
+     */
+    maxBoost?: number;
+    /** Map regret kind → severity factor used in formula. */
+    severityMap?: Record<RegretKind, number>;
+}
+/**
+ * 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 declare function regretBoost(signal: RegretSignal, opts?: RacbOptions): number;
+export declare function applyRacb(results: SearchResult[], signals: RegretSignal[], opts?: RacbOptions): SearchResult[];
+export interface AdsOptions {
+    /** Penalty coefficient 0..1. Higher = more aggressive diversification. Default 0.4. */
+    alpha?: number;
+    /** Cap on how many results to consider. Default Infinity. */
+    topK?: number;
+}
+/**
+ * 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 declare function applyAds(results: SearchResult[], opts?: AdsOptions): SearchResult[];
+export interface CgarOptions {
+    /** Max hops to walk in the causal graph. Default 2. */
+    maxHops?: number;
+    /** Decay per hop. Default 0.85 — each hop reduces boost by 15%. */
+    hopDecay?: number;
+    /** Initial boost for direct causal neighbors. Default 1.3. */
+    initialBoost?: number;
+}
+/**
+ * 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 declare function buildCausalGraph(commits: Commit[]): Map<string, Set<string>>;
+/**
+ * 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 declare function applyCgar(results: SearchResult[], commits: Commit[], opts?: CgarOptions): SearchResult[];
+export interface EnsembleOptions {
+    tdwe?: TdweOptions | false;
+    racb?: {
+        signals: RegretSignal[];
+        opts?: RacbOptions;
+    } | false;
+    ads?: AdsOptions | false;
+    cgar?: {
+        commits: Commit[];
+        opts?: CgarOptions;
+    } | false;
+}
+/**
+ * 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 declare function applyNovelScoring(results: SearchResult[], ensemble: EnsembleOptions): SearchResult[];
+//# sourceMappingURL=novel-scoring.d.ts.map

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

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

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.15.0",
+  "version": "0.16.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",