@cleocode/core 2026.4.9 → 2026.4.11

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/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 || !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/decisions.js

@@ -0,0 +1,162 @@
+/**
+ * Decision Memory module for CLEO BRAIN.
+ * Uses brain.db via BrainDataAccessor for persistent storage.
+ *
+ * Provides functions to store, recall, search, and update decisions
+ * with sequential ID generation (D001, D002, ...).
+ *
+ * @task T5155
+ * @epic T5149
+ */
+import { getBrainAccessor } from '../store/brain-accessor.js';
+import { taskExistsInTasksDb } from '../store/cross-db-cleanup.js';
+import { getDb } from '../store/sqlite.js';
+/**
+ * Generate the next sequential decision ID (D001, D002, ...).
+ * Reads the highest existing ID from brain_decisions to determine next.
+ */
+async function nextDecisionId(projectRoot) {
+    const { getBrainDb } = await import('../store/brain-sqlite.js');
+    const { brainDecisions } = await import('../store/brain-schema.js');
+    const { desc } = await import('drizzle-orm');
+    const db = await getBrainDb(projectRoot);
+    const rows = await db
+        .select({ id: brainDecisions.id })
+        .from(brainDecisions)
+        .orderBy(desc(brainDecisions.id))
+        .limit(1);
+    if (rows.length === 0) {
+        return 'D001';
+    }
+    const lastId = rows[0].id;
+    const num = parseInt(lastId.slice(1), 10);
+    if (Number.isNaN(num)) {
+        return 'D001';
+    }
+    return `D${String(num + 1).padStart(3, '0')}`;
+}
+/**
+ * Store a new decision or update an existing one if a duplicate is found.
+ * Duplicate detection: same decision text (case-insensitive).
+ *
+ * @task T5155
+ */
+export async function storeDecision(projectRoot, params) {
+    if (!params.decision || !params.decision.trim()) {
+        throw new Error('Decision text is required');
+    }
+    if (!params.rationale || !params.rationale.trim()) {
+        throw new Error('Rationale is required');
+    }
+    const accessor = await getBrainAccessor(projectRoot);
+    // Check for duplicate (same decision text, case-insensitive)
+    const existing = await accessor.findDecisions({ type: params.type });
+    const duplicate = existing.find((d) => d.decision.toLowerCase() === params.decision.toLowerCase());
+    if (duplicate) {
+        // Update the existing decision
+        const now = new Date().toISOString().replace('T', ' ').slice(0, 19);
+        await accessor.updateDecision(duplicate.id, {
+            rationale: params.rationale.trim(),
+            confidence: params.confidence,
+            outcome: params.outcome ?? duplicate.outcome,
+            alternativesJson: params.alternatives
+                ? JSON.stringify(params.alternatives)
+                : duplicate.alternativesJson,
+            updatedAt: now,
+        });
+        const updated = await accessor.getDecision(duplicate.id);
+        return updated;
+    }
+    // Create new decision with sequential ID
+    const id = await nextDecisionId(projectRoot);
+    // Write-guard: validate cross-db task references before inserting
+    let validEpicId = params.contextEpicId;
+    let validTaskId = params.contextTaskId;
+    if (validEpicId || validTaskId) {
+        const tasksDb = await getDb(projectRoot);
+        if (validEpicId && !(await taskExistsInTasksDb(validEpicId, tasksDb))) {
+            validEpicId = undefined;
+        }
+        if (validTaskId && !(await taskExistsInTasksDb(validTaskId, tasksDb))) {
+            validTaskId = undefined;
+        }
+    }
+    const row = {
+        id,
+        type: params.type,
+        decision: params.decision.trim(),
+        rationale: params.rationale.trim(),
+        confidence: params.confidence,
+        outcome: params.outcome,
+        alternativesJson: params.alternatives ? JSON.stringify(params.alternatives) : undefined,
+        contextEpicId: validEpicId,
+        contextTaskId: validTaskId,
+        contextPhase: params.contextPhase,
+    };
+    return accessor.addDecision(row);
+}
+/**
+ * Recall a specific decision by ID.
+ *
+ * @task T5155
+ */
+export async function recallDecision(projectRoot, id) {
+    const accessor = await getBrainAccessor(projectRoot);
+    return accessor.getDecision(id);
+}
+/**
+ * Search decisions by type, confidence, outcome, and/or free-text query.
+ * Query searches across decision + rationale fields using LIKE.
+ *
+ * @task T5155
+ */
+export async function searchDecisions(projectRoot, params = {}) {
+    const accessor = await getBrainAccessor(projectRoot);
+    // Use the accessor for structured filters
+    let results = await accessor.findDecisions({
+        type: params.type,
+        confidence: params.confidence,
+        outcome: params.outcome ?? undefined,
+        limit: params.query ? undefined : params.limit,
+    });
+    // Apply free-text search on top
+    if (params.query) {
+        const q = params.query.toLowerCase();
+        results = results.filter((d) => d.decision.toLowerCase().includes(q) || d.rationale.toLowerCase().includes(q));
+    }
+    if (params.limit && params.limit > 0) {
+        results = results.slice(0, params.limit);
+    }
+    return results;
+}
+/**
+ * List decisions with pagination.
+ *
+ * @task T5155
+ */
+export async function listDecisions(projectRoot, params = {}) {
+    const accessor = await getBrainAccessor(projectRoot);
+    // Get all decisions for total count
+    const all = await accessor.findDecisions({});
+    const total = all.length;
+    const offset = params.offset ?? 0;
+    const limit = params.limit ?? 50;
+    const decisions = all.slice(offset, offset + limit);
+    return { decisions, total };
+}
+/**
+ * Update the outcome of a decision after learning from results.
+ *
+ * @task T5155
+ */
+export async function updateDecisionOutcome(projectRoot, id, outcome) {
+    const accessor = await getBrainAccessor(projectRoot);
+    const existing = await accessor.getDecision(id);
+    if (!existing) {
+        throw new Error(`Decision not found: ${id}`);
+    }
+    await accessor.updateDecision(id, { outcome });
+    const updated = await accessor.getDecision(id);
+    return updated;
+}
+//# sourceMappingURL=decisions.js.map

package/dist/memory/decisions.js.map

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

package/dist/memory/embedding-local.js

@@ -0,0 +1,97 @@
+/**
+ * Local embedding provider using @xenova/transformers.
+ *
+ * Implements the EmbeddingProvider interface for brain memory vector search.
+ * Uses all-MiniLM-L6-v2 (22MB, 384 dimensions) — matches the brain_embeddings
+ * vec0 table schema. Model downloads on first call and is cached locally by
+ * the transformers library.
+ *
+ * @epic T134
+ * @task T136
+ * @why Ship vector search out-of-the-box without external API keys
+ * @what Local embedding provider using @xenova/transformers all-MiniLM-L6-v2
+ */
+import { EMBEDDING_DIMENSIONS } from './brain-embedding.js';
+/** Model identifier for all-MiniLM-L6-v2 via Xenova hub. */
+const MODEL_NAME = 'Xenova/all-MiniLM-L6-v2';
+/** Pipeline singleton — initialized lazily on first call. */
+let _pipeline = null;
+/** Whether the pipeline has been successfully initialized. */
+let _ready = false;
+/**
+ * Load the transformers feature-extraction pipeline lazily.
+ * Dynamic import prevents the heavy model from loading unless embedding is enabled.
+ */
+async function loadPipeline() {
+    if (_ready)
+        return;
+    // Dynamic import — only resolves when embedding is explicitly enabled
+    const { pipeline } = await import('@xenova/transformers');
+    _pipeline = await pipeline('feature-extraction', MODEL_NAME);
+    _ready = true;
+}
+/**
+ * Local embedding provider backed by @xenova/transformers.
+ *
+ * Produces 384-dimension Float32Array vectors compatible with the
+ * brain_embeddings vec0 table. The model is downloaded on first use
+ * and cached locally by the transformers library.
+ *
+ * Use {@link initDefaultProvider} (in brain-embedding.ts) to register an
+ * instance when brain.embedding.enabled=true and
+ * brain.embedding.provider='local'.
+ */
+export class LocalEmbeddingProvider {
+    /** Number of dimensions produced — must match brain_embeddings vec0 table. */
+    dimensions = EMBEDDING_DIMENSIONS;
+    /**
+     * Whether the pipeline has been successfully initialized and is ready to produce embeddings.
+     */
+    isAvailable() {
+        return _ready;
+    }
+    /**
+     * Convert a single text string into a 384-dimension float vector.
+     * Triggers model download on first call if not already cached.
+     *
+     * @param text - The text to embed.
+     * @returns A Float32Array of length 384.
+     */
+    async embed(text) {
+        await loadPipeline();
+        const output = await _pipeline(text, { pooling: 'mean', normalize: true });
+        // output.data is DataArray (AnyTypedArray | any[]). For feature-extraction
+        // with all-MiniLM-L6-v2, the runtime value is always Float32Array. Copy via
+        // Float32Array constructor which accepts any iterable of numbers.
+        return Float32Array.from(output.data);
+    }
+    /**
+     * Embed multiple texts in sequence, reusing the cached pipeline.
+     *
+     * @param texts - Array of text strings to embed.
+     * @returns Array of Float32Array vectors, one per input text.
+     */
+    async embedBatch(texts) {
+        await loadPipeline();
+        const results = [];
+        for (const text of texts) {
+            const output = await _pipeline(text, { pooling: 'mean', normalize: true });
+            results.push(Float32Array.from(output.data));
+        }
+        return results;
+    }
+}
+/** Module-level singleton instance. */
+let _instance = null;
+/**
+ * Get or create the shared LocalEmbeddingProvider singleton.
+ *
+ * @returns The shared LocalEmbeddingProvider instance.
+ */
+export function getLocalEmbeddingProvider() {
+    if (!_instance) {
+        _instance = new LocalEmbeddingProvider();
+    }
+    return _instance;
+}
+//# sourceMappingURL=embedding-local.js.map

package/dist/memory/embedding-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-local.js","sourceRoot":"","sources":["../../src/memory/embedding-local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,4DAA4D;AAC5D,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAE7C,6DAA6D;AAC7D,IAAI,SAAS,GAAoE,IAAI,CAAC;AAEtF,8DAA8D;AAC9D,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB;;;GAGG;AACH,KAAK,UAAU,YAAY;IACzB,IAAI,MAAM;QAAE,OAAO;IACnB,sEAAsE;IACtE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAC1D,SAAS,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,sBAAsB;IACjC,8EAA8E;IACrE,UAAU,GAAG,oBAAoB,CAAC;IAE3C;;OAEG;IACH,WAAW;QACT,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,YAAY,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,SAAU,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,kEAAkE;QAClE,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,YAAY,EAAE,CAAC;QACrB,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,SAAU,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5E,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,uCAAuC;AACvC,IAAI,SAAS,GAAkC,IAAI,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}