@mneme-ai/core 0.14.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/indexer/index.d.ts

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

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

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

package/dist/indexer/index.js

@@ -1,2 +1,3 @@
 export * from "./indexer.js";
+export * from "./quality.js";
 //# sourceMappingURL=index.js.map

package/dist/indexer/index.js.map

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

package/dist/indexer/quality.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Index quality analyzer — answers "how good is the memory I just built?"
+ *
+ * The retrieval quality of Mneme is bounded by the quality of what was
+ * indexed. Garbage in, garbage out. This module computes a battery of
+ * metrics that surface index-level problems *before* they become bad
+ * answers.
+ *
+ * Pure data extraction — no LLM, no external services. CLI renders.
+ *
+ * Metrics computed:
+ *   - coverage       : # commits indexed vs # commits in git history
+ *   - chunkDensity   : average chunks per commit (more = richer signal)
+ *   - embedRatio     : fraction of chunks that have a vector embedding
+ *   - subjectQuality : fraction of commits with subjects ≥ minWords
+ *   - bodyRatio      : fraction of commits with non-trivial bodies
+ *   - prRatio        : fraction of commits linked to a PR/MR
+ *   - issueRatio     : fraction of commits with issue refs
+ *   - duplicateRatio : fraction of commits whose subject is a duplicate
+ *                      ("fix", "wip", "merge", etc.)
+ *   - tokenizerHealth: estimate of how well tokenization is working
+ *                      (heuristic: ratio of chunks with ≥3 distinct tokens)
+ *
+ * Returns an overall A-F score plus per-metric details + concrete
+ * recommendations the user can act on.
+ */
+import type { Commit, CommitChunk } from "../types.js";
+export interface IndexQualityReport {
+    /** Total commits in the index. */
+    indexedCommits: number;
+    /** Total chunks in the index. */
+    indexedChunks: number;
+    /** Chunks with non-empty embeddings. */
+    embeddedChunks: number;
+    /** Per-metric breakdown — values 0..1. */
+    metrics: {
+        chunkDensity: number;
+        embedRatio: number;
+        subjectQuality: number;
+        bodyRatio: number;
+        prRatio: number;
+        issueRatio: number;
+        duplicateRatio: number;
+        tokenizerHealth: number;
+    };
+    /** Overall 0..1 quality score (weighted average). */
+    overallScore: number;
+    /** Letter grade A-F derived from overallScore. */
+    grade: "A" | "B" | "C" | "D" | "F";
+    /** Human-actionable recommendations. */
+    recommendations: string[];
+}
+export declare function analyzeIndexQuality(commits: Commit[], chunks: CommitChunk[], opts?: {
+    minSubjectWords?: number;
+}): IndexQualityReport;
+//# sourceMappingURL=quality.d.ts.map

package/dist/indexer/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/indexer/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACnC,wCAAwC;IACxC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAQD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,kBAAkB,CAoHpB"}