@monoes/monomindcli 2.16.12 → 2.16.14

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

@@ -0,0 +1,201 @@
+/**
+ * Memory Bridge — the write path: bridgeStoreEntry (upsert identity, dedup
+ * gate, compare-and-swap) and the usage-recording helper it shares with the
+ * feedback loop. Split out of memory-bridge.ts, which re-exports the public
+ * symbols.
+ */
+import { _embedder, flushBackend, getBackend } from './memory-bridge-backend.js';
+import { BRIDGE_EMBEDDING_MODEL, BRIDGE_MAX_KEY_LEN, BRIDGE_MAX_VALUE_LEN, entryWeights, generateId, getAutomemConfig, logBridgeError, MAX_TAG_LEN, MAX_TAGS, } from './memory-bridge-core.js';
+// ===== Core CRUD =====
+export async function bridgeStoreEntry(options) {
+    const backend = await getBackend(options.dbPath);
+    if (!backend)
+        return null;
+    try {
+        const key = typeof options.key === 'string' && options.key.length > BRIDGE_MAX_KEY_LEN
+            ? options.key.slice(0, BRIDGE_MAX_KEY_LEN)
+            : options.key;
+        if (typeof options.value === 'string' && options.value.length > BRIDGE_MAX_VALUE_LEN) {
+            return {
+                success: false,
+                id: '',
+                error: `Value exceeds the ${BRIDGE_MAX_VALUE_LEN}-character cap (BRIDGE_MAX_VALUE_LEN = 16 KB); got ${options.value.length}. Split the content into smaller entries.`,
+            };
+        }
+        const value = options.value;
+        const namespace = options.namespace ?? 'default';
+        const tags = Array.isArray(options.tags)
+            ? // src: tags carry the ingest source path for excerpt provenance — paths
+                // routinely exceed the general 64-char tag cap, so they get 512.
+                options.tags
+                    .filter((t) => typeof t === 'string' &&
+                    t.length > 0 &&
+                    t.length <= (t.startsWith('src:') ? 512 : MAX_TAG_LEN))
+                    .slice(0, MAX_TAGS)
+            : [];
+        const now = Date.now();
+        // Upsert resolves the EXISTING identity BEFORE minting anything: a
+        // re-ingest must update the row in place and keep the id the caller was
+        // already handed. The old store-new-then-delete-old order silently
+        // orphaned every outstanding reference — feedback against a
+        // previously-returned id then matched nothing and reported
+        // `success: true, applied: 0`, i.e. success while training nothing (K5).
+        let existing = null;
+        if (options.upsert) {
+            try {
+                existing = await backend.getByKey(namespace, key);
+            }
+            catch (e) {
+                logBridgeError('bridgeStoreEntry.upsertLookup', e); /* treat as no existing entry */
+            }
+        }
+        const id = existing?.id ?? generateId('entry');
+        // Generate embedding
+        let embedding;
+        let embeddingInfo;
+        if (options.generateEmbeddingFlag !== false && value.length > 0 && _embedder) {
+            try {
+                embedding = await _embedder(value);
+                embeddingInfo = { dimensions: embedding.length, model: BRIDGE_EMBEDDING_MODEL };
+            }
+            catch (e) {
+                if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
+                    console.error('[memory-bridge] embedding generation failed — storing entry without embedding:', e);
+            }
+        }
+        const mod = await import('@monoes/memory');
+        const entry = mod.createDefaultEntry({
+            key,
+            content: value,
+            namespace,
+            tags,
+            // On a revision the stored metadata merges UNDER the caller's, so
+            // learned signal (feedback_weight, frequency_weight) survives while every
+            // field the caller states explicitly still wins. Same merge semantics the
+            // backend's own update() uses.
+            metadata: existing
+                ? { ...(existing.metadata ?? {}), ...(options.metadata ?? {}) }
+                : options.metadata,
+            expiresAt: options.ttl ? now + options.ttl * 1000 : undefined,
+        });
+        // Override id and set embedding
+        entry.id = id;
+        if (embedding)
+            entry.embedding = embedding;
+        if (existing) {
+            // Carry the record's history forward. createdAt in particular anchors the
+            // entry in the backend's `created_at DESC` ordering: a revision keeps its
+            // position instead of jumping to the head of every scan.
+            entry.createdAt = existing.createdAt;
+            entry.updatedAt = now;
+            entry.version = (existing.version ?? 1) + 1;
+            entry.accessCount = existing.accessCount ?? 0;
+            entry.lastAccessedAt = existing.lastAccessedAt ?? now;
+        }
+        // Dedup gate: skip if a near-duplicate already exists IN THIS NAMESPACE —
+        // an unscoped search let a similar entry in some other namespace swallow
+        // the store entirely (returned duplicate:true, nothing written where asked).
+        const automemCfg = getAutomemConfig();
+        if (embedding && !options.upsert) {
+            try {
+                const similar = await backend.search(embedding, {
+                    k: 1,
+                    threshold: automemCfg.dedupThreshold,
+                    filters: { type: 'exact', namespace },
+                });
+                if (similar.length > 0 && similar[0].score >= automemCfg.dedupThreshold) {
+                    // Re-storing near-identical content is a usage signal: the fact keeps
+                    // being worth remembering. Reinforce the surviving entry.
+                    await recordUsageOnBackend(backend, [similar[0].entry.id]).catch(() => {
+                        /* best effort */
+                    });
+                    return { success: true, id: similar[0].entry.id, duplicate: true };
+                }
+            }
+            catch (e) {
+                logBridgeError('bridgeStoreEntry.dedupSearch', e); /* non-fatal — store anyway */
+            }
+        }
+        // Compare-and-swap path (K5): a caller merging onto a row it read earlier
+        // (or asserting the row is still absent) asks for that check to be part of
+        // the write, atomically, instead of trusting its own stale read.
+        if (options.ifVersion !== undefined) {
+            if (options.ifVersion === 'absent') {
+                if (existing)
+                    return {
+                        success: false,
+                        id: existing.id,
+                        conflict: true,
+                        error: 'ifVersion=absent but entry already exists',
+                    };
+                const created = typeof backend.storeIfAbsent === 'function' ? await backend.storeIfAbsent(entry) : null;
+                if (created === null) {
+                    // Backend predates storeIfAbsent (or is a test double) — fall back to
+                    // the plain unconditional write rather than fail every caller.
+                    await backend.store(entry);
+                }
+                else if (!created) {
+                    return { success: false, id: '', conflict: true, error: 'entry created concurrently' };
+                }
+            }
+            else {
+                if (!existing)
+                    return { success: false, id: '', conflict: true, error: 'entry no longer exists' };
+                const written = typeof backend.storeIfVersion === 'function'
+                    ? await backend.storeIfVersion(entry, options.ifVersion)
+                    : null;
+                if (written === null) {
+                    await backend.store(entry);
+                }
+                else if (!written) {
+                    return {
+                        success: false,
+                        id,
+                        conflict: true,
+                        error: `version conflict: entry changed concurrently (expected version ${options.ifVersion})`,
+                    };
+                }
+            }
+            await flushBackend(backend);
+            return { success: true, id, embedding: embeddingInfo };
+        }
+        // store() is INSERT OR REPLACE keyed on id, so reusing the existing id
+        // rewrites that row in place — there is no old row left to delete, and no
+        // window in which a failed store leaves the previous data destroyed.
+        await backend.store(entry);
+        await flushBackend(backend);
+        return { success: true, id, embedding: embeddingInfo };
+    }
+    catch (err) {
+        logBridgeError('bridgeStoreEntry', err);
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, id: '', error: message };
+    }
+}
+export async function recordUsageOnBackend(backend, entryIds) {
+    let updated = 0;
+    const skipped = [];
+    for (const id of entryIds) {
+        if (typeof id !== 'string' || !id)
+            continue;
+        try {
+            const entry = await backend.get(id);
+            if (!entry) {
+                skipped.push({ id, reason: 'not_found' });
+                continue;
+            }
+            const { frequency } = entryWeights(entry.metadata);
+            await backend.update(id, {
+                metadata: { frequency_weight: frequency + 1 },
+                lastAccessedAt: Date.now(),
+            });
+            updated++;
+        }
+        catch (e) {
+            logBridgeError('recordUsageOnBackend.entryUpdate', e);
+            skipped.push({ id, reason: 'error' });
+        }
+    }
+    return { updated, skipped };
+}
+//# sourceMappingURL=memory-bridge-store.js.map

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

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