@cleocode/core 2026.4.30 → 2026.4.35

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 || !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/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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/memory/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,0BAA0B,CAAC;AAItF,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6BD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CA8D3B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwB7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC;IAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/memory/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,0BAA0B,CAAC;AAMtF,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6BD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAyJ3B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwB7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC;IAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/memory/decisions.js

@@ -0,0 +1,218 @@
+/**
+ * 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';
+import { addGraphEdge, upsertGraphNode } from './graph-auto-populate.js';
+import { computeDecisionQuality } from './quality-scoring.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?.trim()) {
+        throw new Error('Decision text is required');
+    }
+    if (!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);
+        // Refresh the graph node for the updated decision (best-effort).
+        const updatedQuality = computeDecisionQuality({
+            confidence: params.confidence,
+            rationale: params.rationale.trim(),
+            contextTaskId: params.contextTaskId ?? null,
+        });
+        upsertGraphNode(projectRoot, `decision:${duplicate.id}`, 'decision', params.decision.trim().substring(0, 200), updatedQuality, params.decision.trim() + params.rationale.trim(), { type: params.type, confidence: params.confidence }).catch(() => {
+            /* best-effort */
+        });
+        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;
+        }
+    }
+    // T549 Wave 1-A: Tier routing for decisions.
+    // Decisions are always medium-term semantic entries — they are intentional acts,
+    // always manually entered via cleo memory decision-store or the CLI.
+    // sourceConfidence = 'owner' (decisions are owner-stated facts by definition)
+    // verified = true (the act of deciding IS verification)
+    // memoryTier = 'medium' (decisions skip short-term; may promote to long after 7d+outcome:success)
+    // memoryType = 'semantic' (decisions are declarative architectural facts)
+    const memoryTier = 'medium';
+    const memoryType = 'semantic';
+    const sourceConfidence = 'owner';
+    const verified = true;
+    // Compute quality score from confidence level, rationale richness, task linkage,
+    // and T549 source multiplier (owner = 1.0, medium tier = +0.05).
+    const qualityScore = computeDecisionQuality({
+        confidence: params.confidence,
+        rationale: params.rationale.trim(),
+        contextTaskId: validTaskId ?? null,
+        sourceConfidence,
+        memoryTier,
+    });
+    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,
+        qualityScore,
+        // T549 Wave 1-A: tier/type/confidence assigned at write time
+        memoryTier,
+        memoryType,
+        sourceConfidence,
+        verified,
+    };
+    const saved = await accessor.addDecision(row);
+    // Auto-populate graph node + edges for the new decision (best-effort, T537).
+    // All graph writes run fire-and-forget so they never block the return.
+    try {
+        await upsertGraphNode(projectRoot, `decision:${saved.id}`, 'decision', saved.decision.substring(0, 200), qualityScore, saved.decision + saved.rationale, { type: saved.type, confidence: saved.confidence });
+        // Link decision → task when a task context is present.
+        if (validTaskId) {
+            await upsertGraphNode(projectRoot, `task:${validTaskId}`, 'task', validTaskId, 1.0, '');
+            await addGraphEdge(projectRoot, `decision:${saved.id}`, `task:${validTaskId}`, 'applies_to', 1.0, 'auto:store-decision');
+        }
+        // Link decision → epic when an epic context is present.
+        if (validEpicId) {
+            await upsertGraphNode(projectRoot, `epic:${validEpicId}`, 'epic', validEpicId, 1.0, '');
+            await addGraphEdge(projectRoot, `decision:${saved.id}`, `epic:${validEpicId}`, 'applies_to', 1.0, 'auto:store-decision');
+        }
+    }
+    catch {
+        /* Graph population is best-effort — never block the primary return */
+    }
+    return saved;
+}
+/**
+ * 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