@cleocode/core 2026.4.58 → 2026.4.59

package/dist/memory/claude-mem-migration.js

@@ -0,0 +1,277 @@
+/**
+ * Claude-mem to brain.db migration.
+ * Imports observations from ~/.claude-mem/claude-mem.db into brain_observations.
+ * Also creates brain_decisions from decision-typed observations and
+ * brain_learnings from session_summaries with learned fields.
+ *
+ * @epic T5149
+ * @task T5143
+ */
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { getClaudeMemDbPath } from '../paths.js';
+import { getBrainDb, getBrainNativeDb } from '../store/brain-sqlite.js';
+import { ensureFts5Tables, rebuildFts5Index } from './brain-search.js';
+/** Type-safe wrapper for StatementSync.all(). */
+function typedAll(db, sql) {
+    return db.prepare(sql).all();
+}
+// Runtime-load node:sqlite via createRequire (same pattern as node-sqlite-adapter.ts)
+const _require = createRequire(import.meta.url);
+const { DatabaseSync } = _require('node:sqlite');
+/** Valid observation types in the BRAIN schema. */
+const VALID_OBSERVATION_TYPES = new Set([
+    'discovery',
+    'change',
+    'feature',
+    'bugfix',
+    'decision',
+    'refactor',
+]);
+/**
+ * Map a claude-mem observation type to a valid BRAIN observation type.
+ * Falls back to 'discovery' for unrecognized types.
+ */
+function mapObservationType(type) {
+    if (VALID_OBSERVATION_TYPES.has(type)) {
+        return type;
+    }
+    return 'discovery';
+}
+/**
+ * Parse a learned field from claude-mem session_summaries.
+ * The field may be a JSON array of strings or a plain string.
+ */
+function parseLearned(learned) {
+    try {
+        const parsed = JSON.parse(learned);
+        if (Array.isArray(parsed)) {
+            return parsed.filter((s) => typeof s === 'string' && s.trim()).join('; ');
+        }
+        if (typeof parsed === 'string') {
+            return parsed;
+        }
+        return String(parsed);
+    }
+    catch {
+        // Not valid JSON — treat as plain string
+        return learned;
+    }
+}
+/**
+ * Migrate observations from claude-mem's SQLite database into CLEO brain.db.
+ *
+ * Reads from ~/.claude-mem/claude-mem.db (or a custom path) and inserts into:
+ * - brain_observations (all observations, prefixed CM-)
+ * - brain_decisions (decision-typed observations, prefixed CMD-)
+ * - brain_learnings (session summaries with learned field, prefixed CML-)
+ *
+ * Idempotent: skips rows whose ID already exists in brain.db.
+ * After all inserts, rebuilds FTS5 indexes.
+ *
+ * @param projectRoot - The CLEO project root (for brain.db resolution)
+ * @param options - Migration options
+ */
+export async function migrateClaudeMem(projectRoot, options = {}) {
+    const sourcePath = options.sourcePath ?? getClaudeMemDbPath();
+    const dryRun = options.dryRun ?? false;
+    const batchSize = options.batchSize ?? 100;
+    const result = {
+        observationsImported: 0,
+        observationsSkipped: 0,
+        learningsImported: 0,
+        decisionsImported: 0,
+        errors: [],
+        dryRun,
+    };
+    // Validate source database exists
+    if (!existsSync(sourcePath)) {
+        throw new Error(`claude-mem database not found at: ${sourcePath}\n` +
+            `Expected location: ~/.claude-mem/claude-mem.db\n` +
+            `Use --source <path> to specify a custom location.`);
+    }
+    // Open source DB read-only
+    let sourceDb;
+    try {
+        sourceDb = new DatabaseSync(sourcePath, {
+            readOnly: true,
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to open claude-mem database at ${sourcePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        // Initialize brain.db (ensures tables exist via migrations)
+        await getBrainDb(projectRoot);
+        const nativeDb = getBrainNativeDb();
+        if (!nativeDb) {
+            throw new Error('Failed to initialize brain.db — getBrainNativeDb() returned null');
+        }
+        // Ensure FTS5 tables exist for the rebuild at the end
+        ensureFts5Tables(nativeDb);
+        // --- Phase 1: Migrate observations ---
+        const observations = typedAll(sourceDb, 'SELECT * FROM observations ORDER BY id');
+        // Process observations in batches
+        for (let i = 0; i < observations.length; i += batchSize) {
+            const batch = observations.slice(i, i + batchSize);
+            if (!dryRun) {
+                nativeDb.prepare('BEGIN IMMEDIATE').run();
+            }
+            try {
+                for (const row of batch) {
+                    const obsId = `CM-${row.id}`;
+                    // Check if already imported (idempotent)
+                    const existing = nativeDb
+                        .prepare('SELECT id FROM brain_observations WHERE id = ?')
+                        .get(obsId);
+                    if (existing) {
+                        result.observationsSkipped++;
+                        continue;
+                    }
+                    if (dryRun) {
+                        result.observationsImported++;
+                        // Also count decisions in dry run
+                        if (row.type === 'decision') {
+                            result.decisionsImported++;
+                        }
+                        continue;
+                    }
+                    const mappedType = mapObservationType(row.type);
+                    const projectTag = options.project ?? row.project ?? null;
+                    nativeDb
+                        .prepare(`
+            INSERT INTO brain_observations (
+              id, type, title, subtitle, narrative,
+              facts_json, concepts_json, project,
+              files_read_json, files_modified_json,
+              source_type, created_at, updated_at
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          `)
+                        .run(obsId, mappedType, row.title, row.subtitle ?? null, row.narrative ?? null, row.facts ?? null, row.concepts ?? null, projectTag, row.files_read ?? null, row.files_modified ?? null, 'claude-mem', row.created_at ?? null, row.updated_at ?? null);
+                    result.observationsImported++;
+                    // For decision-typed observations, also create a brain_decisions entry
+                    if (row.type === 'decision') {
+                        const decId = `CMD-${row.id}`;
+                        const existingDec = nativeDb
+                            .prepare('SELECT id FROM brain_decisions WHERE id = ?')
+                            .get(decId);
+                        if (!existingDec) {
+                            nativeDb
+                                .prepare(`
+                INSERT INTO brain_decisions (
+                  id, type, decision, rationale, confidence, created_at
+                ) VALUES (?, ?, ?, ?, ?, ?)
+              `)
+                                .run(decId, 'tactical', row.title, row.narrative ?? 'Imported from claude-mem', 'medium', row.created_at ?? null);
+                            result.decisionsImported++;
+                        }
+                    }
+                }
+                if (!dryRun) {
+                    nativeDb.prepare('COMMIT').run();
+                }
+            }
+            catch (err) {
+                if (!dryRun) {
+                    try {
+                        nativeDb.prepare('ROLLBACK').run();
+                    }
+                    catch {
+                        // Ignore rollback errors
+                    }
+                }
+                result.errors.push(`Batch starting at observation ${batch[0]?.id ?? '?'}: ` +
+                    `${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // --- Phase 2: Migrate session_summaries (learned -> brain_learnings) ---
+        let summaries = [];
+        try {
+            summaries = typedAll(sourceDb, 'SELECT * FROM session_summaries ORDER BY id');
+        }
+        catch {
+            // session_summaries table may not exist in all claude-mem versions
+            // This is not an error — just skip
+        }
+        for (let i = 0; i < summaries.length; i += batchSize) {
+            const batch = summaries.slice(i, i + batchSize);
+            if (!dryRun) {
+                nativeDb.prepare('BEGIN IMMEDIATE').run();
+            }
+            try {
+                for (const row of batch) {
+                    if (!row.learned?.trim()) {
+                        continue;
+                    }
+                    const learnId = `CML-${row.id}`;
+                    // Check if already imported
+                    const existing = nativeDb
+                        .prepare('SELECT id FROM brain_learnings WHERE id = ?')
+                        .get(learnId);
+                    if (existing) {
+                        // Don't count as skipped — these are separate from observations
+                        continue;
+                    }
+                    const insight = parseLearned(row.learned);
+                    if (!insight.trim()) {
+                        continue;
+                    }
+                    if (dryRun) {
+                        result.learningsImported++;
+                        continue;
+                    }
+                    const source = row.session_id
+                        ? `claude-mem session ${row.session_id}`
+                        : 'claude-mem session';
+                    nativeDb
+                        .prepare(`
+            INSERT INTO brain_learnings (
+              id, insight, source, confidence, actionable, created_at
+            ) VALUES (?, ?, ?, ?, ?, ?)
+          `)
+                        .run(learnId, insight, source, 0.5, 0, // false
+                    row.created_at ?? null);
+                    result.learningsImported++;
+                }
+                if (!dryRun) {
+                    nativeDb.prepare('COMMIT').run();
+                }
+            }
+            catch (err) {
+                if (!dryRun) {
+                    try {
+                        nativeDb.prepare('ROLLBACK').run();
+                    }
+                    catch {
+                        // Ignore rollback errors
+                    }
+                }
+                result.errors.push(`Session summary batch starting at ${batch[0]?.id ?? '?'}: ` +
+                    `${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // --- Phase 3: Rebuild FTS5 indexes ---
+        if (!dryRun &&
+            (result.observationsImported > 0 ||
+                result.learningsImported > 0 ||
+                result.decisionsImported > 0)) {
+            try {
+                rebuildFts5Index(nativeDb);
+            }
+            catch (err) {
+                result.errors.push(`FTS5 rebuild warning: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    finally {
+        // Close source DB (read-only, safe to close)
+        try {
+            sourceDb.close();
+        }
+        catch {
+            // Ignore close errors
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=claude-mem-migration.js.map

package/dist/memory/claude-mem-migration.js.map

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

package/dist/memory/decision-cross-link.js

@@ -0,0 +1,228 @@
+/**
+ * Decision cross-link module for CLEO BRAIN.
+ *
+ * Extracts file paths and symbol names referenced in a decision's text and
+ * rationale, then creates `affects` edges from the decision graph node to
+ * matching `file` / `symbol` nodes in brain_page_nodes.  This implements
+ * the cross-substrate edge described in
+ * docs/plans/brain-synaptic-visualization-research.md §3.2.
+ *
+ * All database operations are best-effort — they never throw or block the
+ * caller.  Nodes for referenced files / symbols are upserted on demand so
+ * the graph remains consistent even when the target has not yet been
+ * independently indexed.
+ *
+ * @task T626
+ * @epic T626
+ */
+import { addGraphEdge, upsertGraphNode } from './graph-auto-populate.js';
+/**
+ * Regex patterns used to locate file paths and symbol names inside text.
+ *
+ * File-path pattern — matches:
+ *   - Relative paths:   `src/store/brain-schema.ts`
+ *   - Absolute paths:   `/mnt/projects/cleocode/packages/core/src/…`
+ *   - Extension-gated:  only `.ts`, `.tsx`, `.js`, `.jsx`, `.rs`, `.json`
+ *
+ * Symbol pattern — matches:
+ *   - PascalCase class/interface names: `BrainPageNodes`
+ *   - camelCase function names at word boundaries: `upsertGraphNode`
+ *   - snake_case identifiers: `brain_page_edges`
+ *
+ * Overlapping matches are deduplicated by nodeId before edge creation.
+ */
+const FILE_PATH_RE = /(?:^|[\s`"'([\]{,])((\/[\w.\-/]+|[\w.-]+(?:\/[\w.-]+)+)\.(ts|tsx|js|jsx|rs|json))(?=$|[\s`"')[\]{,])/gm;
+const SYMBOL_RE = /(?<![`"'/\w.])(?:[A-Z][a-zA-Z0-9]{2,}|[a-z][a-zA-Z0-9]*(?:[A-Z][a-zA-Z0-9]*)+|[a-z][a-z0-9]*(?:_[a-z][a-z0-9]*){2,})(?![`"'/\w])/g;
+/**
+ * Extract file-path and symbol references from free-form text.
+ *
+ * Symbols shorter than 4 characters or matching common English stop-words
+ * are filtered to reduce noise.
+ *
+ * @param text - Decision text and/or rationale to scan.
+ * @returns Deduplicated array of extracted references.
+ */
+export function extractReferencedSymbols(text) {
+    const seen = new Set();
+    const refs = [];
+    // --- File paths ---
+    for (const match of text.matchAll(FILE_PATH_RE)) {
+        const raw = match[1];
+        if (!raw)
+            continue;
+        const nodeId = `file:${raw}`;
+        if (seen.has(nodeId))
+            continue;
+        seen.add(nodeId);
+        refs.push({ raw, nodeId, nodeType: 'file', label: raw });
+    }
+    // --- Symbol names ---
+    for (const match of text.matchAll(SYMBOL_RE)) {
+        const raw = match[0];
+        if (!raw || raw.length < 4)
+            continue;
+        if (SYMBOL_STOP_WORDS.has(raw.toLowerCase()))
+            continue;
+        const nodeId = `symbol:${raw}`;
+        if (seen.has(nodeId))
+            continue;
+        seen.add(nodeId);
+        refs.push({ raw, nodeId, nodeType: 'symbol', label: raw });
+    }
+    return refs;
+}
+/**
+ * Common English / technical words that look like camelCase or PascalCase
+ * symbols but carry no meaningful code reference.  Filtered out to keep the
+ * extracted reference set signal-rich.
+ */
+const SYMBOL_STOP_WORDS = new Set([
+    'this',
+    'that',
+    'with',
+    'from',
+    'into',
+    'when',
+    'then',
+    'also',
+    'both',
+    'each',
+    'such',
+    'over',
+    'after',
+    'before',
+    'always',
+    'never',
+    'should',
+    'must',
+    'will',
+    'would',
+    'could',
+    'have',
+    'been',
+    'there',
+    'their',
+    'they',
+    'them',
+    'these',
+    'those',
+    'some',
+    'only',
+    'just',
+    'more',
+    'most',
+    'many',
+    'much',
+    'well',
+    'very',
+    'here',
+    'where',
+    'which',
+    'what',
+    'why',
+    'how',
+    'the',
+    'and',
+    'but',
+    'for',
+    'not',
+    'are',
+    'was',
+    'were',
+    'has',
+    'had',
+    'its',
+    'the',
+    'data',
+    'true',
+    'false',
+    'null',
+    'none',
+    'type',
+    'test',
+    'spec',
+    'todo',
+    'fixme',
+    'note',
+    'example',
+    'index',
+    'config',
+    'error',
+    'value',
+    'input',
+    'output',
+    'result',
+    'return',
+    'default',
+    'source',
+    'target',
+    'import',
+    'export',
+    'class',
+    'interface',
+    'function',
+    'const',
+    'async',
+    'await',
+]);
+// ---------------------------------------------------------------------------
+// Edge creation
+// ---------------------------------------------------------------------------
+/**
+ * Create `affects` edges from a decision graph node to every referenced
+ * file / symbol node.
+ *
+ * For each reference:
+ *  1. Upsert the target node (file or symbol) so the graph stays consistent.
+ *  2. Insert an `applies_to` edge from `decision:<id>` to the target node.
+ *
+ * All writes are best-effort via {@link upsertGraphNode} and
+ * {@link addGraphEdge} — failures are swallowed internally.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @param decisionId  - The decision ID (e.g. `D001`).
+ * @param refs        - Extracted references returned by {@link extractReferencedSymbols}.
+ */
+export async function linkDecisionToTargets(projectRoot, decisionId, refs) {
+    const fromId = `decision:${decisionId}`;
+    const writes = refs.map(async (ref) => {
+        // Upsert the target node so the edge has a valid destination even if the
+        // file / symbol has not been independently indexed yet.
+        await upsertGraphNode(projectRoot, ref.nodeId, ref.nodeType, ref.label, 0.5, // placeholder quality until nexus indexes it
+        ref.raw);
+        await addGraphEdge(projectRoot, fromId, ref.nodeId, 'applies_to', 1.0, 'auto:decision-cross-link');
+    });
+    // Fire all writes concurrently — individual failures are swallowed inside
+    // upsertGraphNode / addGraphEdge.
+    await Promise.allSettled(writes);
+}
+// ---------------------------------------------------------------------------
+// Convenience facade
+// ---------------------------------------------------------------------------
+/**
+ * Extract file/symbol references from a decision and create `applies_to`
+ * edges in the brain graph.  Combines {@link extractReferencedSymbols} and
+ * {@link linkDecisionToTargets} in one call.
+ *
+ * This is the function wired into {@link storeDecision} after a new decision
+ * is saved.  It is always fire-and-forget: the caller should NOT await it
+ * when used inside the decision write path.
+ *
+ * @param projectRoot  - Absolute path to the project root directory.
+ * @param decisionId   - The saved decision ID (e.g. `D001`).
+ * @param decisionText - Full decision text.
+ * @param rationale    - Full rationale text.
+ */
+export async function autoCrossLinkDecision(projectRoot, decisionId, decisionText, rationale) {
+    try {
+        const combined = `${decisionText} ${rationale}`;
+        const refs = extractReferencedSymbols(combined);
+        if (refs.length === 0)
+            return;
+        await linkDecisionToTargets(projectRoot, decisionId, refs);
+    }
+    catch {
+        /* best-effort — never surface errors to caller */
+    }
+}
+//# sourceMappingURL=decision-cross-link.js.map

package/dist/memory/decision-cross-link.js.map

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