@mneme-ai/core 0.8.3 → 0.9.0

package/dist/util/redact.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect } from "vitest";
+import { redact, containsSecret, mergeHits } from "./redact.js";
+describe("redact — high-confidence rules", () => {
+    it("strips AWS access key id (AKIA prefix)", () => {
+        const r = redact("token=AKIAIOSFODNN7EXAMPLE in config");
+        expect(r.text).toContain("<REDACTED:aws-access-key-id>");
+        expect(r.text).not.toContain("AKIAIOSFODNN7EXAMPLE");
+        expect(r.hits["aws-access-key-id"]).toBe(1);
+    });
+    it("strips AWS access key id (ASIA prefix — temp credentials)", () => {
+        const r = redact("ASIAIOSFODNN7EXAMPLE");
+        expect(r.text).toContain("<REDACTED:aws-access-key-id>");
+    });
+    it("strips GitHub PAT (ghp_ classic)", () => {
+        const tok = "ghp" + "_" + "A".repeat(36);
+        const r = redact(`Cloning with ${tok} failed`);
+        expect(r.text).toContain("<REDACTED:github-pat>");
+        expect(r.hits["github-pat"]).toBe(1);
+    });
+    it("strips GitHub fine-grained PAT (github_pat_ prefix)", () => {
+        const tok = "github" + "_pat_" + "A".repeat(85);
+        const r = redact(`token=${tok}`);
+        expect(r.text).not.toContain(tok);
+    });
+    it("strips Stripe live secret keys", () => {
+        // Constructed at runtime so the source file does not contain a literal
+        // string that GitHub's secret scanner flags as a real Stripe key.
+        const stripeKey = "sk" + "_live_" + "A".repeat(24);
+        const r = redact(`Stripe key: ${stripeKey}`);
+        expect(r.text).toContain("<REDACTED:stripe-key>");
+    });
+    it("strips OpenAI keys (sk- prefix)", () => {
+        const openaiKey = "sk" + "-" + "A".repeat(20);
+        const r = redact(`OPENAI_API_KEY=${openaiKey}`);
+        expect(r.text).toContain("<REDACTED:openai-key>");
+    });
+    it("strips Anthropic keys (sk-ant- prefix)", () => {
+        const anthropicKey = "sk" + "-ant-" + "A".repeat(32);
+        const r = redact(`ANTHROPIC_API_KEY=${anthropicKey}`);
+        expect(r.text).toContain("<REDACTED:anthropic-key>");
+    });
+    it("strips Slack tokens (xox prefix)", () => {
+        // Constructed at runtime to avoid GitHub secret-scanner false positives.
+        const slackToken = "xox" + "b-" + "1234567890-1234567890-" + "A".repeat(14);
+        const r = redact(`Slack: ${slackToken}`);
+        expect(r.text).toContain("<REDACTED:slack-token>");
+    });
+    it("strips Google API keys (AIza prefix)", () => {
+        // Real format: AIza + exactly 35 chars of [0-9A-Za-z_-]
+        const key = "AIza" + "B".repeat(35);
+        const r = redact(`GOOGLE_API_KEY=${key}`);
+        expect(r.text).toContain("<REDACTED:google-api-key>");
+    });
+    it("strips npm tokens", () => {
+        const r = redact("NPM_TOKEN=npm_" + "x".repeat(36));
+        expect(r.text).toContain("<REDACTED:npm-token>");
+    });
+    it("strips JWTs (3 base64url segments)", () => {
+        const jwt = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9" +
+            ".eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4ifQ" +
+            ".SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
+        const r = redact(`auth: ${jwt}`);
+        expect(r.text).toContain("<REDACTED:jwt>");
+    });
+    it("strips multiline PEM private keys", () => {
+        const pem = [
+            "-----BEGIN RSA PRIVATE KEY-----",
+            "MIIBOQIBAAJAVhx/mmddhM4...",
+            "-----END RSA PRIVATE KEY-----",
+        ].join("\n");
+        const r = redact(`config:\n${pem}\nend`);
+        expect(r.text).toContain("<REDACTED:pem-private-key>");
+        expect(r.text).not.toContain("MIIBOQIBAAJAVhx");
+    });
+    it("strips Bearer tokens", () => {
+        const r = redact("Authorization: Bearer abcDEFghiJKLmnoPQRstuVWXyz0123456");
+        expect(r.text).toContain("<REDACTED:bearer-token>");
+    });
+    it("counts multiple hits per rule", () => {
+        const r = redact("k1=AKIAIOSFODNN7EXAMPLE k2=AKIAIOSFODNN7EXAMPLF");
+        expect(r.hits["aws-access-key-id"]).toBe(2);
+    });
+    it("counts hits across rules", () => {
+        const r = redact("aws=AKIAIOSFODNN7EXAMPLE gh=ghp_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA");
+        expect(r.hits["aws-access-key-id"]).toBe(1);
+        expect(r.hits["github-pat"]).toBe(1);
+    });
+    it("leaves clean text unchanged", () => {
+        const text = "Fix Stripe webhook crash on amount=BigInt overflow";
+        const r = redact(text);
+        expect(r.text).toBe(text);
+        expect(r.hits).toEqual({});
+    });
+    it("handles empty input", () => {
+        expect(redact("").text).toBe("");
+        expect(redact("").hits).toEqual({});
+    });
+});
+describe("redact — aggressive mode", () => {
+    it('catches generic password=... when { aggressive: true }', () => {
+        const r = redact("DB_PASSWORD=hunter2-very-long-password", { aggressive: true });
+        expect(r.text).toContain("<REDACTED:password-assignment>");
+    });
+    it("does NOT catch generic password=... by default (false-positive avoidance)", () => {
+        const r = redact("DB_PASSWORD=hunter2-very-long-password");
+        expect(r.text).toContain("hunter2-very-long-password");
+    });
+    it("catches long hex blobs only when aggressive", () => {
+        const hex = "a".repeat(64);
+        expect(redact(hex).text).toBe(hex);
+        expect(redact(hex, { aggressive: true }).text).toContain("<REDACTED:hex-blob>");
+    });
+});
+describe("redact — custom rules and overrides", () => {
+    it("applies extraRules from caller", () => {
+        const r = redact("internal-secret=XYZZY", {
+            extraRules: [{ name: "internal-secret", pattern: /\binternal-secret=[A-Z]+/g }],
+        });
+        expect(r.text).toContain("<REDACTED:internal-secret>");
+    });
+    it("respects custom replacement string when built-in is disabled", () => {
+        const r = redact("k=AKIAIOSFODNN7EXAMPLE", {
+            disableRules: ["aws-access-key-id"],
+            extraRules: [{ name: "aws", pattern: /\bAKIA[0-9A-Z]{16}\b/g, replacement: "[hidden]" }],
+        });
+        expect(r.text).toBe("k=[hidden]");
+    });
+    it("disableRules removes a built-in rule", () => {
+        const r = redact("AKIAIOSFODNN7EXAMPLE", { disableRules: ["aws-access-key-id"] });
+        expect(r.text).toContain("AKIAIOSFODNN7EXAMPLE");
+        expect(r.hits["aws-access-key-id"]).toBeUndefined();
+    });
+});
+describe("containsSecret", () => {
+    it("returns true when any rule matches", () => {
+        expect(containsSecret("ghp_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA")).toBe(true);
+    });
+    it("returns false on clean text", () => {
+        expect(containsSecret("Fix Stripe webhook crash on BigInt amounts")).toBe(false);
+    });
+});
+describe("mergeHits", () => {
+    it("sums per-rule counters across two reports", () => {
+        const merged = mergeHits({ "aws": 2, "gh": 1 }, { "aws": 3, "stripe": 5 });
+        expect(merged).toEqual({ aws: 5, gh: 1, stripe: 5 });
+    });
+});
+//# sourceMappingURL=redact.test.js.map

package/dist/util/redact.test.js.map

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

package/dist/wisdom/calibrator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Auto-calibrator — picks the search config that maximizes hit rate on the
+ * accumulated feedback set.
+ *
+ * Approach: small-grid search over (semanticWeight × minSemCosine × rrfK).
+ * Re-runs every query in the feedback set with each config and counts how
+ * many of the originally-helpful results stay in top-K. The config with the
+ * highest count wins.
+ *
+ * Pragmatically:
+ *   - Grid is intentionally small (3 × 3 × 2 = 18 configs) to fit in seconds.
+ *   - We only consider feedback where was_helpful = 1 (positive examples).
+ *   - We require ≥ 10 positive examples before calibrating; below that, the
+ *     defaults are statistically stronger than any tuned value.
+ *
+ * The output is written to wisdom_calibration so search() can read the
+ * latest calibrated values without re-running the calibrator.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+import type { EmbeddingProvider } from "../types.js";
+import { type CalibrationConfig, type CalibrationRow } from "./types.js";
+export interface CalibrationResult {
+    /** The winning config. If no calibration ran, equals DEFAULT_CALIBRATION. */
+    config: CalibrationConfig;
+    /** Score on the feedback set: fraction of helpful results re-found in top-3. */
+    hitRate: number;
+    /** Number of positive examples evaluated (gating threshold: 10). */
+    positiveExamples: number;
+    /** Whether the calibrator actually ran or returned defaults. */
+    calibrated: boolean;
+    /** The full grid result, sorted desc by hitRate. */
+    grid: Array<CalibrationConfig & {
+        hitRate: number;
+    }>;
+}
+export declare function calibrate(store: MnemeStore, embedder?: EmbeddingProvider): Promise<CalibrationResult>;
+export declare function persistCalibration(store: MnemeStore, key: string, config: CalibrationConfig & {
+    hitRate: number;
+}, metricName: string, notes?: string): void;
+/** Read back the current calibration. Returns DEFAULT_CALIBRATION if no row. */
+export declare function readCalibration(store: MnemeStore, key?: string): CalibrationConfig;
+export declare function listCalibrations(store: MnemeStore): CalibrationRow[];
+//# sourceMappingURL=calibrator.d.ts.map

package/dist/wisdom/calibrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calibrator.d.ts","sourceRoot":"","sources":["../../src/wisdom/calibrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,IAAI,EAAE,KAAK,CAAC,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAID,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAmD5B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAC/C,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAmBN;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,SAAW,GAAG,iBAAiB,CAiBpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,EAAE,CAsBpE"}

package/dist/wisdom/calibrator.js

@@ -0,0 +1,120 @@
+/**
+ * Auto-calibrator — picks the search config that maximizes hit rate on the
+ * accumulated feedback set.
+ *
+ * Approach: small-grid search over (semanticWeight × minSemCosine × rrfK).
+ * Re-runs every query in the feedback set with each config and counts how
+ * many of the originally-helpful results stay in top-K. The config with the
+ * highest count wins.
+ *
+ * Pragmatically:
+ *   - Grid is intentionally small (3 × 3 × 2 = 18 configs) to fit in seconds.
+ *   - We only consider feedback where was_helpful = 1 (positive examples).
+ *   - We require ≥ 10 positive examples before calibrating; below that, the
+ *     defaults are statistically stronger than any tuned value.
+ *
+ * The output is written to wisdom_calibration so search() can read the
+ * latest calibrated values without re-running the calibrator.
+ */
+import { search } from "../retrieve/search.js";
+import { listFeedback } from "./feedback.js";
+import { DEFAULT_CALIBRATION, } from "./types.js";
+const SEARCH_GRID = [];
+for (const semanticWeight of [0.4, 0.65, 0.85]) {
+    for (const minSemCosine of [0.3, 0.4, 0.5]) {
+        for (const rrfK of [60, 30]) {
+            SEARCH_GRID.push({ semanticWeight, minSemCosine, rrfK });
+        }
+    }
+}
+const MIN_POSITIVE_EXAMPLES = 10;
+export async function calibrate(store, embedder) {
+    const positives = listFeedback(store, { limit: 500 }).filter((f) => f.wasHelpful === 1 && f.resultHashes.length > 0);
+    if (positives.length < MIN_POSITIVE_EXAMPLES) {
+        return {
+            config: DEFAULT_CALIBRATION,
+            hitRate: 0,
+            positiveExamples: positives.length,
+            calibrated: false,
+            grid: [],
+        };
+    }
+    const results = [];
+    for (const config of SEARCH_GRID) {
+        let hits = 0;
+        for (const ex of positives) {
+            // The "ground truth" is the top-3 hashes from the original query —
+            // we re-run with the candidate config and check overlap.
+            const groundTruth = new Set(ex.resultHashes.slice(0, 3));
+            const re = await search(ex.query, {
+                store,
+                embedder,
+                topK: 3,
+                semanticWeight: config.semanticWeight,
+                confidenceFloor: { minFtsHits: 1, minSemCosine: config.minSemCosine },
+            });
+            const reHashes = new Set(re.map((r) => r.commit.hash));
+            // Count this query as a "hit" if at least one of the original useful
+            // results is still surfaced.
+            const overlap = [...groundTruth].some((h) => reHashes.has(h));
+            if (overlap)
+                hits += 1;
+        }
+        results.push({ ...config, hitRate: hits / positives.length });
+    }
+    results.sort((a, b) => b.hitRate - a.hitRate);
+    const best = results[0];
+    persistCalibration(store, "search", best, "hit_rate");
+    return {
+        config: { semanticWeight: best.semanticWeight, minSemCosine: best.minSemCosine, rrfK: best.rrfK },
+        hitRate: best.hitRate,
+        positiveExamples: positives.length,
+        calibrated: true,
+        grid: results,
+    };
+}
+export function persistCalibration(store, key, config, metricName, notes) {
+    store.db
+        .prepare(`INSERT OR REPLACE INTO wisdom_calibration
+       (key, value, metric_value, metric_name, calibrated_at, notes)
+       VALUES (?, ?, ?, ?, ?, ?)`)
+        .run(key, JSON.stringify({
+        semanticWeight: config.semanticWeight,
+        minSemCosine: config.minSemCosine,
+        rrfK: config.rrfK,
+    }), config.hitRate, metricName, new Date().toISOString(), notes ?? null);
+}
+/** Read back the current calibration. Returns DEFAULT_CALIBRATION if no row. */
+export function readCalibration(store, key = "search") {
+    const row = store.db
+        .prepare(`SELECT value FROM wisdom_calibration WHERE key = ? ORDER BY calibrated_at DESC LIMIT 1`)
+        .get(key);
+    if (!row)
+        return DEFAULT_CALIBRATION;
+    try {
+        const parsed = JSON.parse(row.value);
+        return {
+            semanticWeight: parsed.semanticWeight ?? DEFAULT_CALIBRATION.semanticWeight,
+            minSemCosine: parsed.minSemCosine ?? DEFAULT_CALIBRATION.minSemCosine,
+            rrfK: parsed.rrfK ?? DEFAULT_CALIBRATION.rrfK,
+        };
+    }
+    catch {
+        return DEFAULT_CALIBRATION;
+    }
+}
+export function listCalibrations(store) {
+    const rows = store.db
+        .prepare(`SELECT key, value, metric_value, metric_name, calibrated_at, notes
+       FROM wisdom_calibration ORDER BY calibrated_at DESC`)
+        .all();
+    return rows.map((r) => ({
+        key: r.key,
+        value: JSON.parse(r.value),
+        metricValue: r.metric_value ?? undefined,
+        metricName: r.metric_name ?? undefined,
+        calibratedAt: r.calibrated_at,
+        notes: r.notes ?? undefined,
+    }));
+}
+//# sourceMappingURL=calibrator.js.map

package/dist/wisdom/calibrator.js.map

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

package/dist/wisdom/feedback.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Feedback collector — every `mneme ask` writes one row.
+ *
+ * was_helpful starts NULL and is filled by:
+ *   - explicit:        `mneme feedback <id> up|down`
+ *   - implicit-revisit: the user ran `mneme why <commit>` on a returned commit
+ *                       within 5 minutes — strong positive signal.
+ *   - implicit-reuse:   the user did not re-ask a slightly-different version of
+ *                       the same query within 60s — weak positive signal.
+ *
+ * Why these heuristics: they require zero UX work from the user. The
+ * explicit path exists for power users; the implicit paths cover the 95%.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+import type { FeedbackRow } from "./types.js";
+export interface RecordFeedbackInput {
+    query: string;
+    resultHashes: string[];
+    topScore?: number;
+    semanticWeight?: number;
+    minSemCosine?: number;
+    rrfK?: number;
+}
+/** Insert a pending feedback row. Returns the id so callers can update it later. */
+export declare function recordQuery(store: MnemeStore, input: RecordFeedbackInput): string;
+/** Set was_helpful for a feedback row. */
+export declare function setHelpful(store: MnemeStore, id: string, wasHelpful: boolean, source?: FeedbackRow["source"]): boolean;
+/**
+ * Implicit positive signal: the user looked at one of the returned commits
+ * via `mneme why`. We mark the most recent matching pending row as helpful.
+ */
+export declare function recordImplicitRevisit(store: MnemeStore, commitHash: string): number;
+export declare function listFeedback(store: MnemeStore, opts?: {
+    since?: string;
+    limit?: number;
+}): FeedbackRow[];
+export interface FeedbackSummary {
+    total: number;
+    helpful: number;
+    unhelpful: number;
+    pending: number;
+    hitRate: number;
+}
+export declare function summarizeFeedback(store: MnemeStore, since?: string): FeedbackSummary;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/wisdom/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/wisdom/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAqBjF;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,EACnB,MAAM,GAAE,WAAW,CAAC,QAAQ,CAAc,GACzC,OAAO,CAKT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAsBnF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,EAAE,CAwC5G;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CA0BpF"}

package/dist/wisdom/feedback.js

@@ -0,0 +1,116 @@
+/**
+ * Feedback collector — every `mneme ask` writes one row.
+ *
+ * was_helpful starts NULL and is filled by:
+ *   - explicit:        `mneme feedback <id> up|down`
+ *   - implicit-revisit: the user ran `mneme why <commit>` on a returned commit
+ *                       within 5 minutes — strong positive signal.
+ *   - implicit-reuse:   the user did not re-ask a slightly-different version of
+ *                       the same query within 60s — weak positive signal.
+ *
+ * Why these heuristics: they require zero UX work from the user. The
+ * explicit path exists for power users; the implicit paths cover the 95%.
+ */
+import { randomUUID } from "node:crypto";
+/** Insert a pending feedback row. Returns the id so callers can update it later. */
+export function recordQuery(store, input) {
+    const id = randomUUID();
+    const now = new Date().toISOString();
+    store.db
+        .prepare(`INSERT INTO wisdom_feedback
+       (id, query, result_hashes, top_score, was_helpful, source,
+        semantic_weight, min_sem_cosine, rrf_k, created_at)
+       VALUES (?, ?, ?, ?, NULL, 'pending', ?, ?, ?, ?)`)
+        .run(id, input.query, JSON.stringify(input.resultHashes), input.topScore ?? null, input.semanticWeight ?? null, input.minSemCosine ?? null, input.rrfK ?? null, now);
+    return id;
+}
+/** Set was_helpful for a feedback row. */
+export function setHelpful(store, id, wasHelpful, source = "explicit") {
+    const result = store.db
+        .prepare(`UPDATE wisdom_feedback SET was_helpful = ?, source = ? WHERE id = ?`)
+        .run(wasHelpful ? 1 : 0, source, id);
+    return result.changes > 0;
+}
+/**
+ * Implicit positive signal: the user looked at one of the returned commits
+ * via `mneme why`. We mark the most recent matching pending row as helpful.
+ */
+export function recordImplicitRevisit(store, commitHash) {
+    const recent = store.db
+        .prepare(`SELECT id, result_hashes FROM wisdom_feedback
+       WHERE was_helpful IS NULL
+         AND created_at >= datetime('now', '-5 minutes')
+       ORDER BY created_at DESC
+       LIMIT 20`)
+        .all();
+    let updated = 0;
+    for (const row of recent) {
+        try {
+            const hashes = JSON.parse(row.result_hashes);
+            if (hashes.includes(commitHash)) {
+                if (setHelpful(store, row.id, true, "implicit-revisit"))
+                    updated += 1;
+            }
+        }
+        catch {
+            // ignore corrupt JSON; the row is just an inert breadcrumb in that case
+        }
+    }
+    return updated;
+}
+export function listFeedback(store, opts = {}) {
+    const where = [];
+    const params = [];
+    if (opts.since) {
+        where.push("created_at >= ?");
+        params.push(opts.since);
+    }
+    const sql = `
+    SELECT id, query, result_hashes, top_score, was_helpful, source,
+           semantic_weight, min_sem_cosine, rrf_k, created_at
+    FROM wisdom_feedback
+    ${where.length ? "WHERE " + where.join(" AND ") : ""}
+    ORDER BY created_at DESC
+    LIMIT ?
+  `;
+    params.push(opts.limit ?? 1000);
+    const rows = store.db.prepare(sql).all(...params);
+    return rows.map((r) => ({
+        id: r.id,
+        query: r.query,
+        resultHashes: JSON.parse(r.result_hashes),
+        topScore: r.top_score ?? undefined,
+        wasHelpful: r.was_helpful === 1 ? 1 : r.was_helpful === 0 ? 0 : undefined,
+        source: r.source,
+        semanticWeight: r.semantic_weight ?? undefined,
+        minSemCosine: r.min_sem_cosine ?? undefined,
+        rrfK: r.rrf_k ?? undefined,
+        createdAt: r.created_at,
+    }));
+}
+export function summarizeFeedback(store, since) {
+    const params = [];
+    let where = "";
+    if (since) {
+        where = "WHERE created_at >= ?";
+        params.push(since);
+    }
+    const row = store.db
+        .prepare(`SELECT
+         COUNT(*) AS total,
+         SUM(CASE WHEN was_helpful = 1 THEN 1 ELSE 0 END) AS helpful,
+         SUM(CASE WHEN was_helpful = 0 THEN 1 ELSE 0 END) AS unhelpful,
+         SUM(CASE WHEN was_helpful IS NULL THEN 1 ELSE 0 END) AS pending
+       FROM wisdom_feedback ${where}`)
+        .get(...params);
+    const decided = row.helpful + row.unhelpful;
+    const hitRate = decided === 0 ? 0 : row.helpful / decided;
+    return {
+        total: row.total,
+        helpful: row.helpful,
+        unhelpful: row.unhelpful,
+        pending: row.pending,
+        hitRate,
+    };
+}
+//# sourceMappingURL=feedback.js.map

package/dist/wisdom/feedback.js.map

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

package/dist/wisdom/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Wisdom Mutant Engine — public surface.
+ *
+ * The engine has three appendable artifacts (feedback, calibrations,
+ * eval-runs) and three operations on them: collect, calibrate, self-eval.
+ *
+ * Inspired by AlphaGo Zero's loop — observe, adapt, measure, repeat —
+ * minus the reinforcement learning. We are not training a model. We are
+ * tuning a small set of search knobs against the user's own feedback
+ * over time. The point is the *loop*, not the algorithm.
+ */
+export * from "./types.js";
+export * from "./feedback.js";
+export * from "./calibrator.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wisdom/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/wisdom/index.js

@@ -0,0 +1,15 @@
+/**
+ * Wisdom Mutant Engine — public surface.
+ *
+ * The engine has three appendable artifacts (feedback, calibrations,
+ * eval-runs) and three operations on them: collect, calibrate, self-eval.
+ *
+ * Inspired by AlphaGo Zero's loop — observe, adapt, measure, repeat —
+ * minus the reinforcement learning. We are not training a model. We are
+ * tuning a small set of search knobs against the user's own feedback
+ * over time. The point is the *loop*, not the algorithm.
+ */
+export * from "./types.js";
+export * from "./feedback.js";
+export * from "./calibrator.js";
+//# sourceMappingURL=index.js.map

package/dist/wisdom/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wisdom/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/wisdom/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Wisdom Mutant Engine — types.
+ *
+ * The "self-improving memory" subsystem. Three loops:
+ *   1. Feedback collector  — every query records what was returned.
+ *   2. Auto-calibrator     — periodically tunes search knobs against the
+ *                            feedback set, picks the config that maximizes
+ *                            hit rate.
+ *   3. Self-eval           — runs eval set against current config and writes
+ *                            a row to wisdom_eval_run. Detects regressions.
+ *
+ * The point: `mneme adapt` recommendations and the search thresholds in
+ * `mneme ask` are not hardcoded. They are derived from this engine's history.
+ */
+export interface FeedbackRow {
+    id: string;
+    query: string;
+    /** JSON array of commit hashes returned at query time. */
+    resultHashes: string[];
+    /** Top RRF score at query time (a confidence proxy). */
+    topScore?: number;
+    /**
+     * 1 = the user found the result useful (or an implicit signal said so).
+     * 0 = explicitly marked not useful.
+     * undefined = unknown — usually because no feedback has been collected yet.
+     */
+    wasHelpful?: 1 | 0;
+    /** How was_helpful was set. */
+    source: "explicit" | "implicit-reuse" | "implicit-revisit" | "pending";
+    /** Search config in effect when the query ran. */
+    semanticWeight?: number;
+    minSemCosine?: number;
+    rrfK?: number;
+    createdAt: string;
+}
+export interface CalibrationRow {
+    key: string;
+    /** Stored as JSON; parse with JSON.parse. */
+    value: unknown;
+    /** The metric this calibration achieved on the feedback set. */
+    metricValue?: number;
+    metricName?: string;
+    calibratedAt: string;
+    notes?: string;
+}
+export interface EvalRunRow {
+    id: number;
+    ranAt: string;
+    variant: string;
+    recallAt3: number;
+    mrr: number;
+    ndcgAt10?: number;
+    hitRate: number;
+    semanticWeight?: number;
+    minSemCosine?: number;
+    rrfK?: number;
+    numQueries: number;
+    notes?: string;
+}
+/** Search-time knobs the calibrator can tune. */
+export interface CalibrationConfig {
+    semanticWeight: number;
+    minSemCosine: number;
+    rrfK: number;
+}
+export declare const DEFAULT_CALIBRATION: CalibrationConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/wisdom/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/wisdom/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACnB,+BAA+B;IAC/B,MAAM,EAAE,UAAU,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACvE,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAIjC,CAAC"}

package/dist/wisdom/types.js

@@ -0,0 +1,20 @@
+/**
+ * Wisdom Mutant Engine — types.
+ *
+ * The "self-improving memory" subsystem. Three loops:
+ *   1. Feedback collector  — every query records what was returned.
+ *   2. Auto-calibrator     — periodically tunes search knobs against the
+ *                            feedback set, picks the config that maximizes
+ *                            hit rate.
+ *   3. Self-eval           — runs eval set against current config and writes
+ *                            a row to wisdom_eval_run. Detects regressions.
+ *
+ * The point: `mneme adapt` recommendations and the search thresholds in
+ * `mneme ask` are not hardcoded. They are derived from this engine's history.
+ */
+export const DEFAULT_CALIBRATION = {
+    semanticWeight: 0.65,
+    minSemCosine: 0.4,
+    rrfK: 60,
+};
+//# sourceMappingURL=types.js.map

package/dist/wisdom/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/wisdom/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyDH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,GAAG;IACjB,IAAI,EAAE,EAAE;CACT,CAAC"}