@cleocode/core 2026.4.57 → 2026.4.59

package/dist/memory/brain-similarity.js

@@ -0,0 +1,145 @@
+/**
+ * BRAIN Vector Similarity Search
+ *
+ * Provides vector-based KNN search against brain_embeddings vec0 table.
+ * Falls back gracefully when no embedding provider is registered or
+ * sqlite-vec is unavailable.
+ *
+ * @task T5388
+ * @epic T5149
+ */
+import { getBrainAccessor } from '../store/brain-accessor.js';
+import { typedAll } from '../store/typed-query.js';
+import { embedText, isEmbeddingAvailable } from './brain-embedding.js';
+// ============================================================================
+// ID prefix -> table type
+// ============================================================================
+function parseIdPrefix(id) {
+    if (id.startsWith('D-') || /^D\d/.test(id))
+        return 'decision';
+    if (id.startsWith('P-') || /^P\d/.test(id))
+        return 'pattern';
+    if (id.startsWith('L-') || /^L\d/.test(id))
+        return 'learning';
+    if (id.startsWith('O-') || id.startsWith('O') || id.startsWith('CM-'))
+        return 'observation';
+    return null;
+}
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Search for entries similar to a query string using vector similarity.
+ *
+ * 1. Embeds the query text via the registered embedding provider.
+ * 2. Runs KNN query against brain_embeddings vec0 table.
+ * 3. Joins with observation/decision/pattern/learning tables for full entries.
+ *
+ * Returns empty array when embedding is unavailable (graceful fallback).
+ *
+ * @param query - Text to find similar entries for
+ * @param projectRoot - Project root directory
+ * @param limit - Maximum results to return (default 10)
+ * @returns Array of similar entries ranked by distance (ascending)
+ */
+export async function searchSimilar(query, projectRoot, limit) {
+    if (!query?.trim())
+        return [];
+    if (!isEmbeddingAvailable())
+        return [];
+    const maxResults = limit ?? 10;
+    // Embed the query text
+    const queryVector = await embedText(query);
+    if (!queryVector)
+        return [];
+    // Ensure brain.db is initialized
+    const { getBrainDb, getBrainNativeDb, isBrainVecLoaded } = await import('../store/brain-sqlite.js');
+    await getBrainDb(projectRoot);
+    const nativeDb = getBrainNativeDb();
+    if (!nativeDb)
+        return [];
+    // Require sqlite-vec for KNN queries
+    if (!isBrainVecLoaded())
+        return [];
+    // Run KNN query against vec0 table
+    let knnRows;
+    try {
+        const stmt = nativeDb.prepare('SELECT id, distance FROM brain_embeddings WHERE embedding MATCH ? ORDER BY distance LIMIT ?');
+        knnRows = typedAll(stmt, new Float32Array(queryVector.buffer, queryVector.byteOffset, queryVector.length), maxResults);
+    }
+    catch {
+        // vec0 query failed — table may not exist or extension not loaded
+        return [];
+    }
+    if (knnRows.length === 0)
+        return [];
+    // Resolve each ID to its full entry
+    const accessor = await getBrainAccessor(projectRoot);
+    const results = [];
+    for (const row of knnRows) {
+        const entryType = parseIdPrefix(row.id);
+        if (!entryType)
+            continue;
+        try {
+            switch (entryType) {
+                case 'observation': {
+                    const entry = await accessor.getObservation(row.id);
+                    if (entry) {
+                        results.push({
+                            id: row.id,
+                            distance: row.distance,
+                            type: 'observation',
+                            title: entry.title,
+                            text: entry.narrative ?? entry.title,
+                        });
+                    }
+                    break;
+                }
+                case 'decision': {
+                    const entry = await accessor.getDecision(row.id);
+                    if (entry) {
+                        results.push({
+                            id: row.id,
+                            distance: row.distance,
+                            type: 'decision',
+                            title: entry.decision,
+                            text: `${entry.decision} — ${entry.rationale}`,
+                        });
+                    }
+                    break;
+                }
+                case 'pattern': {
+                    const entry = await accessor.getPattern(row.id);
+                    if (entry) {
+                        results.push({
+                            id: row.id,
+                            distance: row.distance,
+                            type: 'pattern',
+                            title: entry.pattern,
+                            text: `${entry.pattern} — ${entry.context}`,
+                        });
+                    }
+                    break;
+                }
+                case 'learning': {
+                    const entry = await accessor.getLearning(row.id);
+                    if (entry) {
+                        results.push({
+                            id: row.id,
+                            distance: row.distance,
+                            type: 'learning',
+                            title: entry.insight,
+                            text: `${entry.insight} (source: ${entry.source})`,
+                        });
+                    }
+                    break;
+                }
+            }
+        }
+        catch {
+            // Skip entries that fail to resolve
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=brain-similarity.js.map

package/dist/memory/brain-similarity.js.map

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

package/dist/memory/brain-stdp.js

@@ -0,0 +1,297 @@
+/**
+ * STDP (Spike-Timing-Dependent Plasticity) for CLEO BRAIN.
+ *
+ * Implements a biologically-inspired Hebbian learning rule that modulates edge
+ * weights based on the *temporal order* of memory retrievals within a session
+ * window, not just co-occurrence frequency.
+ *
+ * ## Neuroscience basis
+ *
+ * Classical STDP: if neuron A fires before neuron B by Δt milliseconds, the
+ * synapse A→B is potentiated (LTP); if A fires after B, it is depressed (LTD).
+ * The magnitude of the change decays exponentially with |Δt|.
+ *
+ * ## Mapping to CLEO memory
+ *
+ * - Each entry retrieved from brain.db is a "spike".
+ * - Retrievals within the same session and within `sessionWindowMs` of each
+ *   other are treated as temporally related spikes.
+ * - If entry A was retrieved BEFORE entry B by Δt ms:
+ *     Δw = A_pre  × exp(−Δt / τ_pre)   → potentiation (LTP, positive Δw)
+ * - If entry A was retrieved AFTER entry B by Δt ms:
+ *     Δw = −A_post × exp(−Δt / τ_post)  → depression  (LTD, negative Δw)
+ * - Weights are clamped to [0.0, 1.0].
+ * - All events are logged to `brain_plasticity_events` for observability.
+ *
+ * ## Parameters (biologically reasonable defaults)
+ *
+ * | Symbol  | Value  | Meaning                                          |
+ * |---------|--------|--------------------------------------------------|
+ * | τ_pre   | 20 s   | Time constant for pre→post potentiation          |
+ * | τ_post  | 20 s   | Time constant for post→pre depression            |
+ * | A_pre   | 0.05   | Peak potentiation amplitude                      |
+ * | A_post  | 0.06   | Peak depression amplitude (asymmetric, per STDP) |
+ *
+ * The asymmetry A_post > A_pre models the biological fact that LTD is slightly
+ * stronger than LTP, preventing runaway weight growth.
+ *
+ * ## Relation to Hebbian co-retrieval
+ *
+ * Hebbian (`strengthenCoRetrievedEdges` in brain-lifecycle.ts) uses the
+ * `co_retrieved` edge type and does NOT track order; it fires on pairs that
+ * co-occur ≥ 3× regardless of timing. STDP is a *second plasticity pass* that
+ * runs after Hebbian and refines existing `co_retrieved` edges using order data.
+ *
+ * If no `co_retrieved` edge exists yet between a pair, STDP inserts one with the
+ * initial STDP-derived weight (potentiation pairs only — LTD does not create
+ * new edges, only weakens existing ones).
+ *
+ * @task T626
+ * @epic T626
+ * @see packages/core/src/memory/brain-lifecycle.ts#strengthenCoRetrievedEdges
+ */
+import { typedAll } from '../store/typed-query.js';
+// ============================================================================
+// STDP constants
+// ============================================================================
+/** Time constant (ms) for pre→post potentiation window. */
+const TAU_PRE_MS = 20_000; // 20 s
+/** Time constant (ms) for post→pre depression window. */
+const TAU_POST_MS = 20_000; // 20 s
+/** Peak potentiation amplitude (dimensionless weight delta). */
+const A_PRE = 0.05;
+/** Peak depression amplitude (slightly larger than A_pre — asymmetric STDP). */
+const A_POST = 0.06;
+/** Minimum edge weight (floor). */
+const WEIGHT_MIN = 0.0;
+/** Maximum edge weight (ceiling). */
+const WEIGHT_MAX = 1.0;
+// ============================================================================
+// Core STDP function
+// ============================================================================
+/**
+ * Apply Spike-Timing-Dependent Plasticity to brain_page_edges.
+ *
+ * Reads `brain_retrieval_log` for rows within the past `sessionWindowMs`
+ * milliseconds, reconstructs the temporal spike sequence per session, and
+ * applies the STDP rule to every ordered pair within the window.
+ *
+ * All weight changes are logged to `brain_plasticity_events` for
+ * observability and `cleo brain plasticity stats` reporting.
+ *
+ * @param projectRoot - Project root directory for brain.db resolution
+ * @param sessionWindowMs - Time window (ms) to consider retrievals as
+ *   temporally related. Defaults to 5 minutes.
+ * @returns Counts of LTP/LTD events applied and edges created/updated.
+ */
+export async function applyStdpPlasticity(projectRoot, sessionWindowMs = 5 * 60 * 1000) {
+    const { getBrainDb, getBrainNativeDb } = await import('../store/brain-sqlite.js');
+    await getBrainDb(projectRoot);
+    const nativeDb = getBrainNativeDb();
+    const result = {
+        ltpEvents: 0,
+        ltdEvents: 0,
+        edgesCreated: 0,
+        pairsExamined: 0,
+    };
+    if (!nativeDb)
+        return result;
+    // Guard: retrieval log must exist
+    try {
+        nativeDb.prepare('SELECT 1 FROM brain_retrieval_log LIMIT 1').get();
+    }
+    catch {
+        return result;
+    }
+    // Guard: plasticity events table must exist
+    try {
+        nativeDb.prepare('SELECT 1 FROM brain_plasticity_events LIMIT 1').get();
+    }
+    catch {
+        return result;
+    }
+    const now = Date.now();
+    const cutoffMs = now - sessionWindowMs;
+    const cutoffIso = new Date(cutoffMs).toISOString().replace('T', ' ').slice(0, 19);
+    const nowIso = new Date(now).toISOString().replace('T', ' ').slice(0, 19);
+    // Fetch recent retrieval log rows including the STDP columns.
+    // We use all rows in the window regardless of whether retrieval_order is set —
+    // if it is null (legacy rows), we fall back to ordering by created_at.
+    let logRows = [];
+    try {
+        logRows = typedAll(nativeDb.prepare(`SELECT id, entry_ids, created_at, retrieval_order, delta_ms
+         FROM brain_retrieval_log
+         WHERE created_at >= ?
+         ORDER BY created_at ASC, id ASC
+         LIMIT 2000`), cutoffIso);
+    }
+    catch {
+        return result;
+    }
+    if (logRows.length === 0)
+        return result;
+    // Build an ordered spike sequence from the log rows.
+    // Each retrieval log row may contain multiple entry_ids (a batch retrieval).
+    // We expand them into individual spikes, preserving the retrieval timestamp.
+    const spikes = [];
+    let globalOrder = 0;
+    for (const row of logRows) {
+        let ids;
+        try {
+            ids = JSON.parse(row.entry_ids);
+        }
+        catch {
+            continue;
+        }
+        const rowTime = new Date(row.created_at.replace(' ', 'T') + 'Z').getTime();
+        for (const rawId of ids) {
+            const entryId = rawId.includes(':') ? rawId : `observation:${rawId}`;
+            spikes.push({
+                entryId,
+                rowId: row.id,
+                retrievedAt: rowTime,
+                order: row.retrieval_order ?? globalOrder,
+            });
+            globalOrder++;
+        }
+    }
+    // Sort spikes by (retrievedAt, order) to establish canonical temporal sequence.
+    spikes.sort((a, b) => a.retrievedAt - b.retrievedAt || a.order - b.order);
+    // For each ordered pair (i, j) where i < j (spike i before spike j),
+    // apply the STDP rule if Δt <= sessionWindowMs.
+    const prepareGetEdge = nativeDb.prepare(`SELECT weight FROM brain_page_edges
+     WHERE from_id = ? AND to_id = ? AND edge_type = 'co_retrieved'`);
+    const prepareUpdateEdge = nativeDb.prepare(`UPDATE brain_page_edges
+     SET weight = MAX(?, MIN(?, weight + ?))
+     WHERE from_id = ? AND to_id = ? AND edge_type = 'co_retrieved'`);
+    const prepareInsertEdge = nativeDb.prepare(`INSERT OR IGNORE INTO brain_page_edges
+       (from_id, to_id, edge_type, weight, provenance, created_at)
+     VALUES (?, ?, 'co_retrieved', ?, 'plasticity:stdp-ltp', ?)`);
+    const prepareLogEvent = nativeDb.prepare(`INSERT INTO brain_plasticity_events
+       (source_node, target_node, delta_w, kind, timestamp)
+     VALUES (?, ?, ?, ?, ?)`);
+    for (let i = 0; i < spikes.length; i++) {
+        const spikeA = spikes[i];
+        for (let j = i + 1; j < spikes.length; j++) {
+            const spikeB = spikes[j];
+            const deltaT = spikeB.retrievedAt - spikeA.retrievedAt; // ms, always >= 0
+            if (deltaT > sessionWindowMs)
+                break; // spikes are sorted; further pairs exceed window
+            if (spikeA.entryId === spikeB.entryId)
+                continue; // skip self-pairs
+            result.pairsExamined++;
+            // A fired before B → LTP on edge A→B
+            const deltaW = A_PRE * Math.exp(-deltaT / TAU_PRE_MS);
+            if (deltaW < 1e-6)
+                continue; // negligible change — skip
+            // Check whether an existing co_retrieved edge A→B exists
+            const existingEdge = prepareGetEdge.get(spikeA.entryId, spikeB.entryId);
+            try {
+                if (existingEdge !== undefined) {
+                    prepareUpdateEdge.run(WEIGHT_MIN, WEIGHT_MAX, deltaW, spikeA.entryId, spikeB.entryId);
+                }
+                else {
+                    // Insert new edge with initial LTP weight (capped at WEIGHT_MAX)
+                    const initialWeight = Math.min(WEIGHT_MAX, deltaW);
+                    prepareInsertEdge.run(spikeA.entryId, spikeB.entryId, initialWeight, nowIso);
+                    result.edgesCreated++;
+                }
+                prepareLogEvent.run(spikeA.entryId, spikeB.entryId, deltaW, 'ltp', nowIso);
+                result.ltpEvents++;
+            }
+            catch {
+                /* best-effort */
+            }
+            // B fired after A → LTD on reverse edge B→A (depression)
+            // LTD only weakens existing edges; it does not create new ones.
+            const deltaWNeg = -(A_POST * Math.exp(-deltaT / TAU_POST_MS));
+            const existingReverseEdge = prepareGetEdge.get(spikeB.entryId, spikeA.entryId);
+            if (existingReverseEdge !== undefined && Math.abs(deltaWNeg) >= 1e-6) {
+                try {
+                    prepareUpdateEdge.run(WEIGHT_MIN, WEIGHT_MAX, deltaWNeg, spikeB.entryId, spikeA.entryId);
+                    prepareLogEvent.run(spikeB.entryId, spikeA.entryId, deltaWNeg, 'ltd', nowIso);
+                    result.ltdEvents++;
+                }
+                catch {
+                    /* best-effort */
+                }
+            }
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Plasticity stats query
+// ============================================================================
+/**
+ * Retrieve a summary of recent STDP plasticity events from `brain_plasticity_events`.
+ *
+ * Used by `cleo brain plasticity stats`.
+ *
+ * @param projectRoot - Project root directory for brain.db resolution
+ * @param limit - Maximum number of recent events to include. Defaults to 20.
+ * @returns Aggregated plasticity statistics and the most recent events.
+ */
+export async function getPlasticityStats(projectRoot, limit = 20) {
+    const { getBrainDb, getBrainNativeDb } = await import('../store/brain-sqlite.js');
+    await getBrainDb(projectRoot);
+    const nativeDb = getBrainNativeDb();
+    const empty = {
+        totalEvents: 0,
+        ltpCount: 0,
+        ltdCount: 0,
+        netDeltaW: 0,
+        lastEventAt: null,
+        recentEvents: [],
+    };
+    if (!nativeDb)
+        return empty;
+    try {
+        nativeDb.prepare('SELECT 1 FROM brain_plasticity_events LIMIT 1').get();
+    }
+    catch {
+        return empty;
+    }
+    let agg;
+    try {
+        agg = nativeDb
+            .prepare(`SELECT
+           COUNT(*)                         AS total,
+           SUM(CASE WHEN kind = 'ltp' THEN 1 ELSE 0 END) AS ltp_count,
+           SUM(CASE WHEN kind = 'ltd' THEN 1 ELSE 0 END) AS ltd_count,
+           SUM(delta_w)                    AS net_delta_w,
+           MAX(timestamp)                  AS last_event_at
+         FROM brain_plasticity_events`)
+            .get();
+    }
+    catch {
+        return empty;
+    }
+    let recentRows = [];
+    try {
+        recentRows = typedAll(nativeDb.prepare(`SELECT id, source_node, target_node, delta_w, kind, timestamp, session_id
+         FROM brain_plasticity_events
+         ORDER BY timestamp DESC, id DESC
+         LIMIT ?`), limit);
+    }
+    catch {
+        // non-fatal
+    }
+    return {
+        totalEvents: agg?.total ?? 0,
+        ltpCount: agg?.ltp_count ?? 0,
+        ltdCount: agg?.ltd_count ?? 0,
+        netDeltaW: agg?.net_delta_w ?? 0,
+        lastEventAt: agg?.last_event_at ?? null,
+        recentEvents: recentRows.map((r) => ({
+            id: r.id,
+            sourceNode: r.source_node,
+            targetNode: r.target_node,
+            deltaW: r.delta_w,
+            kind: r.kind,
+            timestamp: r.timestamp,
+            sessionId: r.session_id,
+        })),
+    };
+}
+//# sourceMappingURL=brain-stdp.js.map

package/dist/memory/brain-stdp.js.map

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