@monoes/monomindcli 2.16.12 → 2.16.13

package/dist/src/memory/memory-bridge-backend.js

@@ -0,0 +1,363 @@
+/**
+ * Memory Bridge — the lazy per-path backend cache, the process-wide local
+ * models (embedder + cross-encoder reranker) and their kill switch, and
+ * bridge lifecycle. Owns all of that module-level state; other bridge
+ * modules only read it. Split out of memory-bridge.ts, which re-exports the
+ * public symbols.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { BRIDGE_EMBEDDING_MODEL, logBridgeError } from './memory-bridge-core.js';
+import { getDbPath, getGlobalBrainDir, getProjectRoot, projectDataDir, } from './memory-bridge-paths.js';
+import { ettinHeadLogit, loadEttinHead, resolveRerankerSource } from './reranker-head.js';
+const backendSlots = new Map();
+const MAX_BACKEND_SLOTS = 5;
+export let _embedder = null;
+let _embedderPromise = null;
+const MAX_INIT_ATTEMPTS = 3;
+// Process-local kill switch for both local ONNX models (embedder + reranker):
+// the in-process equivalent of MONOMIND_NO_LOCAL_EMBEDDINGS=1 plus
+// MONOMIND_RERANKER=0. Org runs flip this instead of setting those env vars,
+// because process.env is inherited by every child — each role's CLI and every
+// command a role runs through Bash — which silently degraded a role's own
+// `monomind memory search` to keyword-only (#249).
+let _localModelsDisabled = false;
+/** Disable local model loads for THIS process only (see `org run`/`org serve`). */
+export function disableLocalModels() {
+    _localModelsDisabled = true;
+}
+export function localEmbeddingsDisabled() {
+    return _localModelsDisabled || process.env.MONOMIND_NO_LOCAL_EMBEDDINGS === '1';
+}
+export function rerankerDisabled() {
+    return _localModelsDisabled || process.env.MONOMIND_RERANKER === '0';
+}
+// ===== Lazy cross-encoder reranker (ettin-32m) =====
+//
+// Same ORT constraints as the embedder (ADR-R001). Loaded only when the first
+// search with >1 candidate completes — never on store, never on startup.
+// Disabled with MONOMIND_RERANKER=0.
+//
+// The upstream HF ONNX file for ettin-reranker-32m-v1 only contains the base
+// ModernBERT encoder (outputs last_hidden_state, no logits). The classifier
+// head lives in separate sentence-transformers module safetensors files
+// (2_Dense, 3_LayerNorm, 4_Dense). Two ways to score, in order of preference:
+//  - a self-exported ONNX with the head baked in (scripts/export-ettin-onnx.py,
+//    needs PyTorch) under ~/.monomind/models/ettin-reranker-32m-v1-onnx/
+//  - the upstream encoder plus the head applied in JS (reranker-head.ts), from
+//    head files fetched by `doc eval --provision-model` into
+//    ~/.monomind/models/ettin-reranker-32m-v1-head/
+// With neither, the reranker does not load: the upstream encoder alone cannot
+// score, and loading it anyway ran the model on every search for nothing.
+export const BRIDGE_RERANKER_MODEL = 'cross-encoder/ettin-reranker-32m-v1';
+/** Where reranker export / head files live. */
+export function rerankerModelsDir() {
+    return path.join(os.homedir(), '.monomind', 'models');
+}
+/** How the reranker is scoring, or null when it is not loaded. */
+let _rerankerKind = null;
+export function rerankerKind() {
+    return _rerankerKind;
+}
+export let _reranker = null;
+export let _rerankerPromise = null;
+/** Pre-load the cross-encoder reranker model. Idempotent, no-op when
+ *  MONOMIND_RERANKER=0. Exported so the eval harness can force-load before
+ *  the network guard blocks model downloads. */
+export async function loadReranker() {
+    if (_reranker)
+        return;
+    if (rerankerDisabled())
+        return;
+    if (!_rerankerPromise) {
+        _rerankerPromise = (async () => {
+            try {
+                const source = resolveRerankerSource(rerankerModelsDir());
+                if (!source)
+                    return; // nothing that can score — stay unloaded (no per-search cost)
+                const hf = await import('@huggingface/transformers');
+                const opts = { local_files_only: true };
+                const sigmoid = (logit) => 1 / (1 + Math.exp(-logit));
+                if (source.kind === 'export') {
+                    const tokenizer = await hf.AutoTokenizer.from_pretrained(source.dir, opts);
+                    const model = await hf.AutoModelForSequenceClassification.from_pretrained(source.dir, opts);
+                    _reranker = async (query, passage) => {
+                        const inputs = await tokenizer(query, {
+                            text_pair: passage,
+                            padding: true,
+                            truncation: true,
+                        });
+                        const output = await model(inputs);
+                        // num_labels=1 → [1,1] regression score, apply sigmoid
+                        return sigmoid(output.logits.data[0]);
+                    };
+                }
+                else {
+                    const head = loadEttinHead(source.dir);
+                    const tokenizer = await hf.AutoTokenizer.from_pretrained(BRIDGE_RERANKER_MODEL, opts);
+                    const model = await hf.AutoModel.from_pretrained(BRIDGE_RERANKER_MODEL, {
+                        ...opts,
+                        dtype: 'fp32',
+                    });
+                    _reranker = async (query, passage) => {
+                        const inputs = await tokenizer(query, {
+                            text_pair: passage,
+                            padding: true,
+                            truncation: true,
+                        });
+                        const output = await model(inputs);
+                        return sigmoid(ettinHeadLogit(head, output.last_hidden_state.data));
+                    };
+                }
+                _rerankerKind = source.kind;
+            }
+            catch (e) {
+                _rerankerPromise = null; // allow retry
+                if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
+                    console.error('[memory-bridge] reranker failed to load:', e);
+            }
+        })();
+    }
+    await _rerankerPromise;
+}
+/** Rerank an array of results using the cross-encoder. Mutates nothing; returns
+ *  a new sorted array with reranker scores in provenance. */
+export async function rerankResults(query, results, limit) {
+    const reranker = _reranker;
+    if (!reranker || results.length <= 1)
+        return { reranked: results, applied: false };
+    try {
+        const scored = await Promise.all(results.map(async (r) => {
+            const rerankerScore = await reranker(query, r.content || '');
+            return {
+                ...r,
+                score: rerankerScore,
+                provenance: `${r.provenance ?? ''}→rerank:${rerankerScore.toFixed(3)}`,
+            };
+        }));
+        scored.sort((a, b) => b.score - a.score);
+        return { reranked: scored.slice(0, limit), applied: true };
+    }
+    catch (e) {
+        if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
+            console.error('[memory-bridge] reranking failed — returning original order:', e);
+        return { reranked: results, applied: false };
+    }
+}
+/** Flush after mutations: the sql.js fallback backend is in-memory WASM and
+ *  only reaches disk via persist(); the CLI process is short-lived, so waiting
+ *  for an auto-persist interval would lose writes. No-op on better-sqlite3. */
+export async function flushBackend(backend) {
+    try {
+        await backend?.persist?.();
+    }
+    catch (e) {
+        logBridgeError('flushBackend', e); /* best effort */
+    }
+}
+/** Loads the local embedding model.
+ *
+ *  This is the single point where `onnxruntime-node` enters the CLI process
+ *  (via @huggingface/transformers). Once it has run, the process is subject to
+ *  docs/adrs/ADR-R001-onnxruntime-process-teardown.md: calling process.exit()
+ *  will abort with SIGABRT ("mutex lock failed") instead of exiting cleanly,
+ *  and disposing the pipeline first does not help.
+ *
+ *  Anything that reaches this — `doctor`, `memory store`, `memory search`, the
+ *  MCP memory tools — inherits that constraint, which is why it bit commands
+ *  that look nothing like ML work. Adding a new caller is fine; adding a new
+ *  process-exit path is not. */
+async function loadEmbedder() {
+    if (_embedder)
+        return;
+    // MONOMIND_NO_LOCAL_EMBEDDINGS: skip the native pipeline() load entirely.
+    // On some machines @huggingface/transformers' ONNX runtime crashes the
+    // whole process with a native `libc++abi terminate` (a mutex failure
+    // inside the tokenizer backend) rather than throwing a catchable JS
+    // error — the try/catch below only protects against normal failures
+    // (missing cache, bad revision, offline), not that. Everything that
+    // reads _embedder already tolerates it being unset (keyword-only
+    // fallback), so skipping the call is the only way to actually avoid the
+    // crash rather than just failing to catch it. Org runs disable it
+    // in-process (disableLocalModels()) since a crashed org is much worse than
+    // degraded search; anyone else can opt in with the env var.
+    if (localEmbeddingsDisabled())
+        return;
+    if (!_embedderPromise) {
+        _embedderPromise = (async () => {
+            try {
+                const hf = await import('@huggingface/transformers');
+                // revision must be a git ref — 'main' is the HF default; 'default' 404s and
+                // silently killed embeddings (every search degraded to keyword matching)
+                // dtype pinned explicitly: transformers.js logs a "dtype not specified"
+                // warning to the console on every load otherwise (leaks into CLI output).
+                const extractor = await hf.pipeline('feature-extraction', BRIDGE_EMBEDDING_MODEL, {
+                    revision: 'main',
+                    dtype: 'q8',
+                    local_files_only: true,
+                });
+                _embedder = async (text) => {
+                    const output = await extractor(text, { pooling: 'cls', normalize: true });
+                    return new Float32Array(output.data);
+                };
+            }
+            catch (e) {
+                _embedderPromise = null; // allow retry (e.g. first call offline)
+                if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
+                    console.error('[memory-bridge] embedding model failed to load — store and search without vectors:', e);
+            }
+        })();
+    }
+    await _embedderPromise;
+}
+/** Fetches the local embedding model into the transformers cache so later
+ *  loadEmbedder() calls (local_files_only) find it. Same model, revision and
+ *  dtype as loadEmbedder() — only the network is allowed here, which is why it
+ *  is reserved for explicit opt-in steps (`init --with-embeddings`). Throws
+ *  when the model cannot be fetched (offline, disabled, package missing);
+ *  callers degrade. Loads onnxruntime, so ADR-R001 applies to the caller. */
+export async function downloadEmbeddingModel() {
+    if (localEmbeddingsDisabled())
+        throw new Error('local embeddings are disabled (MONOMIND_NO_LOCAL_EMBEDDINGS=1)');
+    const hf = await import('@huggingface/transformers');
+    await hf.pipeline('feature-extraction', BRIDGE_EMBEDDING_MODEL, {
+        revision: 'main',
+        dtype: 'q8',
+    });
+}
+export async function getBackend(dbPath) {
+    const dir = getDbPath(dbPath);
+    let slot = backendSlots.get(dir);
+    if (!slot) {
+        if (backendSlots.size >= MAX_BACKEND_SLOTS) {
+            const oldest = backendSlots.keys().next().value;
+            const evicted = backendSlots.get(oldest);
+            // shutdownBridge() below uses .shutdown() — that's the real method these
+            // backends expose. .close() doesn't exist on either backend class, so this
+            // resolved to undefined via the optional chain every time and never actually
+            // released the connection: every 6th distinct database path opened in this
+            // process leaked the oldest slot's connection for the process lifetime.
+            try {
+                await evicted?.instance?.shutdown?.();
+            }
+            catch (e) {
+                logBridgeError('getBackend.evictedShutdown', e); /* best effort */
+            }
+            backendSlots.delete(oldest);
+        }
+        slot = { promise: null, instance: null, available: null, attempts: 0 };
+        backendSlots.set(dir, slot);
+    }
+    if (slot.available === false)
+        return null;
+    if (slot.attempts >= MAX_INIT_ATTEMPTS) {
+        slot.available = false;
+        return null;
+    }
+    if (slot.instance)
+        return slot.instance;
+    if (!slot.promise) {
+        slot.promise = (async () => {
+            try {
+                const mod = await import('@monoes/memory');
+                await loadEmbedder();
+                // Local SQLite engine (LanceDB replaced 2026-07): better-sqlite3 when its
+                // native binding loads, sql.js (pure WASM) otherwise — both persist text
+                // AND embeddings, so vectors are always recomputable/derivable data.
+                fs.mkdirSync(dir, { recursive: true });
+                // Origin marker: records which project this data dir belongs to, so
+                // `monomind cleanup --data` can verifiably prune dirs whose project
+                // no longer exists (the dir-name hash is one-way). Best-effort; never
+                // written for the global brain (it has no single origin project).
+                if (dir !== getGlobalBrainDir()) {
+                    try {
+                        // MUST be the same path projectDataDir() hashed into the slug. If
+                        // this recorded the raw cwd, running any memory command from a
+                        // package subdirectory would stamp that subdirectory into the
+                        // project-root-keyed dir — and deleting the subdirectory later
+                        // would make `cleanup --data` prune the WHOLE project's brain as
+                        // orphaned.
+                        const originFile = path.join(projectDataDir(), 'origin.json');
+                        fs.writeFileSync(originFile, JSON.stringify({ path: getProjectRoot(), updatedAt: new Date().toISOString() }) +
+                            '\n', 'utf-8');
+                    }
+                    catch (e) {
+                        logBridgeError('getBackend.originWrite', e); /* non-fatal */
+                    }
+                }
+                const cfg = {
+                    databasePath: path.join(dir, 'memory.db'),
+                    walMode: true,
+                    optimize: true,
+                    defaultNamespace: 'default',
+                    embeddingGenerator: _embedder ?? undefined,
+                    // R3: when the MCP server and a CLI hook subprocess hit the same
+                    // memory.db at the same time, SQLite returns SQLITE_BUSY and the
+                    // bridge silently no-ops. busy_timeout tells SQLite to wait up to
+                    // 5s for a lock before giving up, which covers the normal handoff
+                    // window. The native @monoes/memory backend reads this key.
+                    busyTimeoutMs: 5000,
+                };
+                const origLog = console.log;
+                console.log = (...args) => {
+                    const msg = String(args[0] ?? '');
+                    if (msg.includes('Transformers.js') || msg.includes('Loading model'))
+                        return;
+                    origLog.apply(console, args);
+                };
+                let backend;
+                try {
+                    try {
+                        backend = new mod.SQLiteBackend(cfg);
+                        await backend.initialize();
+                    }
+                    catch (e) {
+                        if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
+                            console.error('[memory-bridge] better-sqlite3 unavailable — using sql.js backend:', e);
+                        backend = new mod.SqlJsBackend(cfg);
+                        await backend.initialize();
+                    }
+                }
+                finally {
+                    console.log = origLog;
+                }
+                slot.instance = backend;
+                slot.available = true;
+                return backend;
+            }
+            catch (e) {
+                slot.attempts++;
+                slot.promise = null;
+                if (slot.attempts >= MAX_INIT_ATTEMPTS)
+                    slot.available = false;
+                logBridgeError('getBackend', e);
+                return null;
+            }
+        })();
+    }
+    return slot.promise;
+}
+// ===== Availability / lifecycle =====
+export async function isBridgeAvailable(dbPath) {
+    const backend = await getBackend(dbPath);
+    return !!backend;
+}
+export async function shutdownBridge() {
+    for (const slot of backendSlots.values()) {
+        if (slot.instance) {
+            try {
+                await slot.instance.shutdown();
+            }
+            catch (e) {
+                logBridgeError('bridgeShutdown.slotShutdown', e); /* ignore */
+            }
+        }
+    }
+    backendSlots.clear();
+    _embedder = null;
+    _embedderPromise = null;
+    _reranker = null;
+    _rerankerPromise = null;
+}
+//# sourceMappingURL=memory-bridge-backend.js.map

package/dist/src/memory/memory-bridge-backend.js.map

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

package/dist/src/memory/memory-bridge-core.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Memory Bridge — shared helpers: error logging, embedding validation,
+ * limits, automem config and usage/feedback weights. Split out of
+ * memory-bridge.ts, which re-exports the public symbols.
+ */
+/**
+ * R1: surface swallowed errors when DEBUG/MONOMIND_DEBUG is on. The bridge
+ * has ~12 `} catch { return null; }` sites that collapse SQLITE_BUSY,
+ * EACCES, disk-full, and schema mismatches into "no matches" with zero
+ * diagnostic. Behavior contract (return null on failure) is unchanged;
+ * observability is added. Caller passes the bridge fn name + the thrown
+ * value so the log is greppable per call site.
+ */
+export declare function logBridgeError(label: string, err: unknown): void;
+export declare function safeParseEmbedding(raw: string | null | undefined): number[] | null;
+export declare const BRIDGE_EMBEDDING_MODEL = "Alibaba-NLP/gte-modernbert-base";
+export declare const BRIDGE_EMBEDDING_DIMS = 768;
+export declare const BRIDGE_MAX_KEY_LEN: number;
+export declare const BRIDGE_MAX_VALUE_LEN: number;
+export declare const MAX_TAGS = 32;
+export declare const MAX_TAG_LEN = 64;
+export declare function capResultContent(content: string): string;
+export declare function getAutomemConfig(): {
+    dedupThreshold: number;
+    staleDays: number;
+    feedbackInfluence: number;
+};
+export declare const FEEDBACK_EWMA_ALPHA = 0.1;
+export declare function entryWeights(metadata: unknown): {
+    feedback: number;
+    frequency: number;
+};
+/** Blend learned usefulness into a GENUINE embedding-similarity score.
+ *  Cognee guard: never applied to keyword-fallback scores — those carry no
+ *  real relevance signal, and blending there lets a high-feedback stale entry
+ *  outrank relevant matches and self-reinforce (rich-get-richer). */
+export declare function blendScore(cosineSim: number, weights: {
+    feedback: number;
+    frequency: number;
+}, influence: number): number;
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=memory-bridge-core.d.ts.map

package/dist/src/memory/memory-bridge-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-bridge-core.d.ts","sourceRoot":"","sources":["../../../src/memory/memory-bridge-core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAIhE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,CAiBlF;AAID,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AACxE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,kBAAkB,QAAW,CAAC;AAC3C,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAC9C,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,WAAW,KAAK,CAAC;AAK9B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,wBAAgB,gBAAgB,IAAI;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CA0BA;AAWD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAWvF;AAED;;;qEAGqE;AACrE,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAChD,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/src/memory/memory-bridge-core.js

@@ -0,0 +1,126 @@
+/**
+ * Memory Bridge — shared helpers: error logging, embedding validation,
+ * limits, automem config and usage/feedback weights. Split out of
+ * memory-bridge.ts, which re-exports the public symbols.
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ===== Embedding validation =====
+const MAX_EMBEDDING_DIMS = 8192;
+const MAX_EMBEDDING_JSON_BYTES = MAX_EMBEDDING_DIMS * 32; // ~256KB ceiling
+/**
+ * R1: surface swallowed errors when DEBUG/MONOMIND_DEBUG is on. The bridge
+ * has ~12 `} catch { return null; }` sites that collapse SQLITE_BUSY,
+ * EACCES, disk-full, and schema mismatches into "no matches" with zero
+ * diagnostic. Behavior contract (return null on failure) is unchanged;
+ * observability is added. Caller passes the bridge fn name + the thrown
+ * value so the log is greppable per call site.
+ */
+export function logBridgeError(label, err) {
+    if (!(process.env.DEBUG || process.env.MONOMIND_DEBUG))
+        return;
+    const msg = err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+    console.error(`[bridge:${label}] ${msg}`);
+}
+export function safeParseEmbedding(raw) {
+    if (typeof raw !== 'string' || raw.length === 0)
+        return null;
+    if (raw.length > MAX_EMBEDDING_JSON_BYTES)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        logBridgeError('safeParseEmbedding', e);
+        return null;
+    }
+    if (!Array.isArray(parsed))
+        return null;
+    if (parsed.length === 0 || parsed.length > MAX_EMBEDDING_DIMS)
+        return null;
+    for (let i = 0; i < parsed.length; i++) {
+        const v = parsed[i];
+        if (typeof v !== 'number' || !Number.isFinite(v))
+            return null;
+    }
+    return parsed;
+}
+// ===== Constants =====
+export const BRIDGE_EMBEDDING_MODEL = 'Alibaba-NLP/gte-modernbert-base';
+export const BRIDGE_EMBEDDING_DIMS = 768;
+export const BRIDGE_MAX_KEY_LEN = 4 * 1024;
+export const BRIDGE_MAX_VALUE_LEN = 16 * 1024;
+export const MAX_TAGS = 32;
+export const MAX_TAG_LEN = 64;
+// Search results serve the head of the stored content only — full values bloat
+// every MCP payload. Entries needing the full text can read the entry by key.
+const BRIDGE_RESULT_CONTENT_CAP = 500;
+export function capResultContent(content) {
+    return content.length > BRIDGE_RESULT_CONTENT_CAP
+        ? `${content.slice(0, BRIDGE_RESULT_CONTENT_CAP)}…`
+        : content;
+}
+export function getAutomemConfig() {
+    const defaults = { dedupThreshold: 0.85, staleDays: 7, feedbackInfluence: 0.2 };
+    try {
+        const configPath = path.join(process.cwd(), '.monomind', 'automem-config.json');
+        if (!fs.existsSync(configPath))
+            return defaults;
+        const stat = fs.statSync(configPath);
+        if (stat.size > 64 * 1024)
+            return defaults;
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        return {
+            dedupThreshold: typeof config?.scaffold?.dedupThreshold === 'number'
+                ? config.scaffold.dedupThreshold
+                : defaults.dedupThreshold,
+            staleDays: typeof config?.scaffold?.staleDays === 'number'
+                ? config.scaffold.staleDays
+                : defaults.staleDays,
+            feedbackInfluence: typeof config?.scaffold?.feedbackInfluence === 'number'
+                ? Math.max(0, Math.min(1, config.scaffold.feedbackInfluence))
+                : defaults.feedbackInfluence,
+        };
+    }
+    catch (e) {
+        logBridgeError('loadBridgeConfig', e);
+        return defaults;
+    }
+}
+// ===== Usage/feedback weights (cognee-style, stored in entry metadata) =====
+//
+// feedback_weight (0..1, default 0.5): EWMA of explicit/auto ratings applied to
+// the entries actually used to produce an answer. frequency_weight (>=0): how
+// often the entry was returned by a search. Both live in the entry's metadata
+// JSON — deliberately NOT backend schema columns, so no @monoes/memory publish
+// is needed and both backends work unchanged.
+const DEFAULT_FEEDBACK_WEIGHT = 0.5;
+export const FEEDBACK_EWMA_ALPHA = 0.1;
+/** frequency_weight normalization ceiling: 10+ uses counts as fully reinforced. */
+const FREQUENCY_NORM_CAP = 10;
+export function entryWeights(metadata) {
+    const md = (metadata ?? {});
+    const fw = typeof md.feedback_weight === 'number' && Number.isFinite(md.feedback_weight)
+        ? Math.max(0, Math.min(1, md.feedback_weight))
+        : DEFAULT_FEEDBACK_WEIGHT;
+    const freq = typeof md.frequency_weight === 'number' && Number.isFinite(md.frequency_weight)
+        ? Math.max(0, md.frequency_weight)
+        : 0;
+    return { feedback: fw, frequency: freq };
+}
+/** Blend learned usefulness into a GENUINE embedding-similarity score.
+ *  Cognee guard: never applied to keyword-fallback scores — those carry no
+ *  real relevance signal, and blending there lets a high-feedback stale entry
+ *  outrank relevant matches and self-reinforce (rich-get-richer). */
+export function blendScore(cosineSim, weights, influence) {
+    if (influence <= 0)
+        return cosineSim;
+    const usefulness = 0.7 * weights.feedback + 0.3 * Math.min(1, weights.frequency / FREQUENCY_NORM_CAP);
+    return (1 - influence) * cosineSim + influence * usefulness;
+}
+export function generateId(prefix) {
+    return `${prefix}_${Date.now()}_${crypto.randomBytes(8).toString('hex')}`;
+}
+//# sourceMappingURL=memory-bridge-core.js.map

package/dist/src/memory/memory-bridge-core.js.map

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