@cleocode/core 2026.4.9 → 2026.4.12

package/dist/store/brain-schema.js

@@ -0,0 +1,215 @@
+/**
+ * Drizzle ORM schema for CLEO brain.db (SQLite via node:sqlite + sqlite-proxy).
+ *
+ * Tables: brain_decisions, brain_patterns, brain_learnings, brain_memory_links, brain_schema_meta
+ * Stores cognitive infrastructure: decisions, patterns, and learnings extracted
+ * from CLEO task execution. Cross-references tasks in tasks.db via soft FKs.
+ *
+ * @epic T5149
+ * @task T5127
+ */
+import { sql } from 'drizzle-orm';
+import { index, integer, primaryKey, real, sqliteTable, text } from 'drizzle-orm/sqlite-core';
+// === ENUM CONSTANTS ===
+/** Decision types from ADR-009. */
+export const BRAIN_DECISION_TYPES = [
+    'architecture',
+    'technical',
+    'process',
+    'strategic',
+    'tactical',
+];
+/** Confidence levels for decisions. */
+export const BRAIN_CONFIDENCE_LEVELS = ['low', 'medium', 'high'];
+/** Outcome types for decision tracking. */
+export const BRAIN_OUTCOME_TYPES = ['success', 'failure', 'mixed', 'pending'];
+/** Pattern types for workflow analysis. */
+export const BRAIN_PATTERN_TYPES = [
+    'workflow',
+    'blocker',
+    'success',
+    'failure',
+    'optimization',
+];
+/** Impact levels for patterns. */
+export const BRAIN_IMPACT_LEVELS = ['low', 'medium', 'high'];
+/** Link types for cross-referencing BRAIN entries with tasks. */
+export const BRAIN_LINK_TYPES = [
+    'produced_by',
+    'applies_to',
+    'informed_by',
+    'contradicts',
+];
+/** Observation types for claude-mem compatible observations. */
+export const BRAIN_OBSERVATION_TYPES = [
+    'discovery',
+    'change',
+    'feature',
+    'bugfix',
+    'decision',
+    'refactor',
+];
+/** Source types for observations (how the observation was created). */
+export const BRAIN_OBSERVATION_SOURCE_TYPES = [
+    'agent',
+    'session-debrief',
+    'claude-mem',
+    'manual',
+];
+/** Memory entity types for the links table. */
+export const BRAIN_MEMORY_TYPES = ['decision', 'pattern', 'learning', 'observation'];
+/** Sticky note status values. */
+export const BRAIN_STICKY_STATUSES = ['active', 'converted', 'archived'];
+/** Sticky note colors. */
+export const BRAIN_STICKY_COLORS = ['yellow', 'blue', 'green', 'red', 'purple'];
+/** Sticky note priority levels. */
+export const BRAIN_STICKY_PRIORITIES = ['low', 'medium', 'high'];
+// === BRAIN_DECISIONS TABLE ===
+export const brainDecisions = sqliteTable('brain_decisions', {
+    id: text('id').primaryKey(),
+    type: text('type', { enum: BRAIN_DECISION_TYPES }).notNull(),
+    decision: text('decision').notNull(),
+    rationale: text('rationale').notNull(),
+    confidence: text('confidence', { enum: BRAIN_CONFIDENCE_LEVELS }).notNull(),
+    outcome: text('outcome', { enum: BRAIN_OUTCOME_TYPES }),
+    alternativesJson: text('alternatives_json'),
+    contextEpicId: text('context_epic_id'), // soft FK to tasks.id in tasks.db
+    contextTaskId: text('context_task_id'), // soft FK to tasks.id in tasks.db
+    contextPhase: text('context_phase'),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at'),
+}, (table) => [
+    index('idx_brain_decisions_type').on(table.type),
+    index('idx_brain_decisions_confidence').on(table.confidence),
+    index('idx_brain_decisions_outcome').on(table.outcome),
+    index('idx_brain_decisions_context_epic').on(table.contextEpicId),
+    index('idx_brain_decisions_context_task').on(table.contextTaskId),
+]);
+// === BRAIN_PATTERNS TABLE ===
+export const brainPatterns = sqliteTable('brain_patterns', {
+    id: text('id').primaryKey(),
+    type: text('type', { enum: BRAIN_PATTERN_TYPES }).notNull(),
+    pattern: text('pattern').notNull(),
+    context: text('context').notNull(),
+    frequency: integer('frequency').notNull().default(1),
+    successRate: real('success_rate'),
+    impact: text('impact', { enum: BRAIN_IMPACT_LEVELS }),
+    antiPattern: text('anti_pattern'),
+    mitigation: text('mitigation'),
+    examplesJson: text('examples_json').default('[]'),
+    extractedAt: text('extracted_at').notNull().default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at'),
+}, (table) => [
+    index('idx_brain_patterns_type').on(table.type),
+    index('idx_brain_patterns_impact').on(table.impact),
+    index('idx_brain_patterns_frequency').on(table.frequency),
+]);
+// === BRAIN_LEARNINGS TABLE ===
+export const brainLearnings = sqliteTable('brain_learnings', {
+    id: text('id').primaryKey(),
+    insight: text('insight').notNull(),
+    source: text('source').notNull(),
+    confidence: real('confidence').notNull(), // 0.0-1.0
+    actionable: integer('actionable', { mode: 'boolean' }).notNull().default(false),
+    application: text('application'),
+    applicableTypesJson: text('applicable_types_json'),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at'),
+}, (table) => [
+    index('idx_brain_learnings_confidence').on(table.confidence),
+    index('idx_brain_learnings_actionable').on(table.actionable),
+]);
+// === BRAIN_OBSERVATIONS TABLE ===
+/** General-purpose observations — replaces claude-mem's observations table. */
+export const brainObservations = sqliteTable('brain_observations', {
+    id: text('id').primaryKey(),
+    type: text('type', { enum: BRAIN_OBSERVATION_TYPES }).notNull(),
+    title: text('title').notNull(),
+    subtitle: text('subtitle'),
+    narrative: text('narrative'),
+    factsJson: text('facts_json'), // JSON array of fact strings
+    conceptsJson: text('concepts_json'), // JSON array of concept strings
+    project: text('project'),
+    filesReadJson: text('files_read_json'), // JSON array of file paths
+    filesModifiedJson: text('files_modified_json'), // JSON array of file paths
+    sourceSessionId: text('source_session_id'), // soft FK to sessions
+    sourceType: text('source_type', { enum: BRAIN_OBSERVATION_SOURCE_TYPES })
+        .notNull()
+        .default('agent'),
+    contentHash: text('content_hash'), // SHA-256 prefix for dedup
+    discoveryTokens: integer('discovery_tokens'), // cost to produce this observation
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at'),
+}, (table) => [
+    index('idx_brain_observations_type').on(table.type),
+    index('idx_brain_observations_project').on(table.project),
+    index('idx_brain_observations_created_at').on(table.createdAt),
+    index('idx_brain_observations_source_type').on(table.sourceType),
+    index('idx_brain_observations_source_session').on(table.sourceSessionId),
+    // T033: composite replaces single-col content_hash; see brain migration
+    index('idx_brain_observations_content_hash_created_at').on(table.contentHash, table.createdAt),
+    // T033: type + project compound filter optimization
+    index('idx_brain_observations_type_project').on(table.type, table.project),
+]);
+// === BRAIN_STICKY_NOTES TABLE ===
+/** Ephemeral sticky notes for quick capture before formal classification. */
+export const brainStickyNotes = sqliteTable('brain_sticky_notes', {
+    id: text('id').primaryKey(),
+    content: text('content').notNull(),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at'),
+    tagsJson: text('tags_json'),
+    status: text('status', { enum: BRAIN_STICKY_STATUSES }).notNull().default('active'),
+    convertedToJson: text('converted_to_json'),
+    color: text('color', { enum: BRAIN_STICKY_COLORS }),
+    priority: text('priority', { enum: BRAIN_STICKY_PRIORITIES }),
+    sourceType: text('source_type').default('sticky-note'),
+}, (table) => [
+    index('idx_brain_sticky_status').on(table.status),
+    index('idx_brain_sticky_created').on(table.createdAt),
+    index('idx_brain_sticky_tags').on(table.tagsJson),
+]);
+// === BRAIN_MEMORY_LINKS TABLE ===
+/** Cross-references between BRAIN entries and tasks in tasks.db. */
+export const brainMemoryLinks = sqliteTable('brain_memory_links', {
+    memoryType: text('memory_type', { enum: BRAIN_MEMORY_TYPES }).notNull(),
+    memoryId: text('memory_id').notNull(),
+    taskId: text('task_id').notNull(), // soft FK to tasks.id in tasks.db
+    linkType: text('link_type', { enum: BRAIN_LINK_TYPES }).notNull(),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+}, (table) => [
+    primaryKey({ columns: [table.memoryType, table.memoryId, table.taskId, table.linkType] }),
+    index('idx_brain_links_task').on(table.taskId),
+    index('idx_brain_links_memory').on(table.memoryType, table.memoryId),
+]);
+// === SCHEMA METADATA ===
+export const brainSchemaMeta = sqliteTable('brain_schema_meta', {
+    key: text('key').primaryKey(),
+    value: text('value').notNull(),
+});
+// === PAGEINDEX GRAPH TABLES (T5160) ===
+/** Node types for PageIndex graph. */
+export const BRAIN_NODE_TYPES = ['task', 'doc', 'file', 'concept'];
+/** Edge types for PageIndex graph. */
+export const BRAIN_EDGE_TYPES = ['depends_on', 'relates_to', 'implements', 'documents'];
+/** Documents/concepts as graph nodes for cross-document linking. */
+export const brainPageNodes = sqliteTable('brain_page_nodes', {
+    id: text('id').primaryKey(), // 'task:T5241', 'doc:BRAIN-SPEC', 'file:src/store/brain-schema.ts'
+    nodeType: text('node_type', { enum: BRAIN_NODE_TYPES }).notNull(),
+    label: text('label').notNull(),
+    metadataJson: text('metadata_json'), // JSON blob for extensible metadata
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+}, (table) => [index('idx_brain_nodes_type').on(table.nodeType)]);
+/** Directed links between graph nodes. */
+export const brainPageEdges = sqliteTable('brain_page_edges', {
+    fromId: text('from_id').notNull(),
+    toId: text('to_id').notNull(),
+    edgeType: text('edge_type', { enum: BRAIN_EDGE_TYPES }).notNull(),
+    weight: real('weight').default(1.0),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+}, (table) => [
+    primaryKey({ columns: [table.fromId, table.toId, table.edgeType] }),
+    index('idx_brain_edges_from').on(table.fromId),
+    index('idx_brain_edges_to').on(table.toId),
+]);
+//# sourceMappingURL=brain-schema.js.map

package/dist/store/brain-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-schema.js","sourceRoot":"","sources":["../../src/store/brain-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE9F,yBAAyB;AAEzB,mCAAmC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,WAAW;IACX,SAAS;IACT,WAAW;IACX,UAAU;CACF,CAAC;AAEX,uCAAuC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAE1E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAEvF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU;IACV,SAAS;IACT,SAAS;IACT,SAAS;IACT,cAAc;CACN,CAAC;AAEX,kCAAkC;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAEtE,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa;IACb,YAAY;IACZ,aAAa;IACb,aAAa;CACL,CAAC;AAEX,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW;IACX,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;CACF,CAAC;AAEX,uEAAuE;AACvE,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,OAAO;IACP,iBAAiB;IACjB,YAAY;IACZ,QAAQ;CACA,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAE9F,iCAAiC;AACjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAElF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAEzF,mCAAmC;AACnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAE1E,gCAAgC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CACvC,iBAAiB,EACjB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC5D,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACtC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3E,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;IACvD,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAC3C,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE,kCAAkC;IAC1E,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE,kCAAkC;IAC1E,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;IACvE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;CAC9B,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;IAChD,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAC5D,KAAK,CAAC,6BAA6B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IACtD,KAAK,CAAC,kCAAkC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC;IACjE,KAAK,CAAC,kCAAkC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC;CAClE,CACF,CAAC;AAEF,+BAA+B;AAE/B,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CACtC,gBAAgB,EAChB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3D,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;IACjC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;IACrD,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;IACjC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC;IAC9B,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACjD,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;IAC3E,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;CAC9B,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;IAC/C,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;IACnD,KAAK,CAAC,8BAA8B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;CAC1D,CACF,CAAC;AAEF,gCAAgC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CACvC,iBAAiB,EACjB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,EAAE,UAAU;IACpD,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/E,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;IAChC,mBAAmB,EAAE,IAAI,CAAC,uBAAuB,CAAC;IAClD,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;IACvE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;CAC9B,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAC5D,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;CAC7D,CACF,CAAC;AAEF,mCAAmC;AAEnC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAC1C,oBAAoB,EACpB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC/D,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;IAC5B,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,6BAA6B;IAC5D,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,gCAAgC;IACrE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;IACxB,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE,2BAA2B;IACnE,iBAAiB,EAAE,IAAI,CAAC,qBAAqB,CAAC,EAAE,2BAA2B;IAC3E,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,EAAE,sBAAsB;IAClE,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;SACtE,OAAO,EAAE;SACT,OAAO,CAAC,OAAO,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,2BAA2B;IAC9D,eAAe,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAAE,mCAAmC;IACjF,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;IACvE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;CAC9B,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,6BAA6B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;IACnD,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IACzD,KAAK,CAAC,mCAAmC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9D,KAAK,CAAC,oCAAoC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAChE,KAAK,CAAC,uCAAuC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC;IACxE,wEAAwE;IACxE,KAAK,CAAC,gDAAgD,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9F,oDAAoD;IACpD,KAAK,CAAC,qCAAqC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;CAC3E,CACF,CAAC;AAEF,mCAAmC;AAEnC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CACzC,oBAAoB,EACpB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;IACvE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;IAC7B,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;IAC3B,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnF,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAC1C,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;IACnD,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAC7D,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;CACvD,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;IACjD,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACrD,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;CAClD,CACF,CAAC;AAEF,mCAAmC;AAEnC,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CACzC,oBAAoB,EACpB;IACE,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;IACvE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,kCAAkC;IACrE,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IACjE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;CACxE,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzF,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;IAC9C,KAAK,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;CACrE,CACF,CAAC;AAEF,0BAA0B;AAE1B,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC,mBAAmB,EAAE;IAC9D,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE;IAC7B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;CAC/B,CAAC,CAAC;AAEH,yCAAyC;AAEzC,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAE5E,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAU,CAAC;AAEjG,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CACvC,kBAAkB,EAClB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,mEAAmE;IAChG,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IACjE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,oCAAoC;IACzE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;CACxE,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAC9D,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CACvC,kBAAkB,EAClB;IACE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IACjC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC7B,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IACjE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;CACxE,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IACnE,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;IAC9C,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;CAC3C,CACF,CAAC"}

package/dist/store/brain-sqlite.js

@@ -0,0 +1,222 @@
+/**
+ * SQLite store for brain.db via drizzle-orm/node-sqlite + node:sqlite (DatabaseSync).
+ *
+ * Separate database from tasks.db for cognitive infrastructure (decisions,
+ * patterns, learnings). Follows the same singleton + WAL + migration pattern
+ * as sqlite.ts.
+ *
+ * @epic T5149
+ * @task T5128
+ */
+import { mkdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { drizzle } from 'drizzle-orm/node-sqlite';
+import { getCleoDirAbsolute } from '../paths.js';
+import * as brainSchema from './brain-schema.js';
+import { createSafetyBackup, migrateWithRetry, reconcileJournal, tableExists, } from './migration-manager.js';
+import { openNativeDatabase } from './sqlite.js';
+const _require = createRequire(import.meta.url);
+/** Database file name within .cleo/ directory. */
+const DB_FILENAME = 'brain.db';
+/** Schema version for newly created brain databases. Single source of truth. */
+export const BRAIN_SCHEMA_VERSION = '1.0.0';
+/** Singleton state for lazy initialization. */
+let _db = null;
+let _nativeDb = null;
+let _dbPath = null;
+/** Guard against concurrent initialization (async migration). */
+let _initPromise = null;
+/** Whether sqlite-vec extension loaded successfully. */
+let _vecLoaded = false;
+/**
+ * Get the path to the brain.db SQLite database file.
+ */
+export function getBrainDbPath(cwd) {
+    return join(getCleoDirAbsolute(cwd), DB_FILENAME);
+}
+/**
+ * Resolve the path to the drizzle-brain migrations folder.
+ * Works from both src/ (dev via tsx) and dist/ (compiled via esbuild bundle).
+ *
+ * - Source layout: __dirname = src/store/ → need ../../migrations/drizzle-brain
+ * - Bundled layout: __dirname = dist/     → need ../migrations/drizzle-brain
+ */
+export function resolveBrainMigrationsFolder() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const isBundled = __dirname.endsWith('/dist') || __dirname.endsWith('\\dist');
+    const pkgRoot = isBundled ? join(__dirname, '..') : join(__dirname, '..', '..');
+    return join(pkgRoot, 'migrations', 'drizzle-brain');
+}
+// tableExists — delegated to migration-manager.ts (T132)
+/**
+ * Run drizzle migrations to create/update brain.db tables.
+ *
+ * Delegates to shared migration-manager.ts for journal reconciliation,
+ * retry logic, and safety backups. See T132 for consolidation rationale.
+ *
+ * @task T5128
+ * @task T132 - Unified migration system
+ */
+function runBrainMigrations(nativeDb, db) {
+    const migrationsFolder = resolveBrainMigrationsFolder();
+    // Safety backup before any migration work
+    if (tableExists(nativeDb, 'brain_decisions') && _dbPath) {
+        createSafetyBackup(_dbPath);
+    }
+    // Bootstrap baseline + reconcile stale journal entries
+    reconcileJournal(nativeDb, migrationsFolder, 'brain_decisions', 'brain');
+    // Run pending migrations with SQLITE_BUSY retry
+    migrateWithRetry(db, migrationsFolder);
+}
+/**
+ * Load the sqlite-vec extension into a native DatabaseSync instance.
+ * Returns true if the extension loaded successfully, false otherwise.
+ *
+ * The extension enables vec0 virtual tables for vector similarity search.
+ * Requires the database to be opened with allowExtension: true.
+ *
+ * @task T5157
+ */
+function loadBrainVecExtension(nativeDb) {
+    try {
+        const sqliteVec = _require('sqlite-vec');
+        sqliteVec.load(nativeDb);
+        return true;
+    }
+    catch {
+        // sqlite-vec not available or failed to load — non-fatal
+        return false;
+    }
+}
+/**
+ * Create the vec0 virtual table for brain embeddings.
+ * Called after migrations complete and sqlite-vec extension is loaded.
+ *
+ * The vec0 table is not managed by Drizzle (virtual tables are not
+ * supported by drizzle-orm's SQLite schema). Created via raw SQL.
+ *
+ * @task T5157
+ */
+function initializeBrainVec(nativeDb) {
+    nativeDb
+        .prepare('CREATE VIRTUAL TABLE IF NOT EXISTS brain_embeddings USING vec0(id TEXT PRIMARY KEY, embedding FLOAT[384])')
+        .run();
+}
+/**
+ * Check whether the sqlite-vec extension is loaded for the current brain.db.
+ */
+export function isBrainVecLoaded() {
+    return _vecLoaded;
+}
+/**
+ * Initialize the brain.db SQLite database (lazy, singleton).
+ * Creates the database file and tables if they don't exist.
+ * Returns the drizzle ORM instance (async via sqlite-proxy).
+ *
+ * Uses a promise guard so concurrent callers wait for the same
+ * initialization to complete (migrations are async).
+ */
+export async function getBrainDb(cwd) {
+    const requestedPath = getBrainDbPath(cwd);
+    // If singleton exists but points to different path, reset it
+    if (_db && _dbPath !== requestedPath) {
+        resetBrainDbState();
+    }
+    if (_db)
+        return _db;
+    // If already initializing, wait for the in-flight init
+    if (_initPromise)
+        return _initPromise;
+    _initPromise = (async () => {
+        const dbPath = requestedPath;
+        _dbPath = dbPath;
+        // Ensure directory exists
+        mkdirSync(dirname(dbPath), { recursive: true });
+        // Open file-backed SQLite via node:sqlite with WAL mode.
+        // allowExtension: true enables sqlite-vec extension loading.
+        const nativeDb = openNativeDatabase(dbPath, { allowExtension: true });
+        _nativeDb = nativeDb;
+        // Load sqlite-vec extension for vector similarity search (T5157).
+        // Non-fatal if unavailable — vec0 tables simply won't be created.
+        _vecLoaded = loadBrainVecExtension(nativeDb);
+        // Create drizzle ORM wrapper via node-sqlite
+        const db = drizzle({ client: nativeDb, schema: brainSchema });
+        // Run drizzle migrations (creates/updates tables)
+        runBrainMigrations(nativeDb, db);
+        // Create vec0 virtual table for embeddings if extension is loaded (T5157).
+        // Must run after migrations so the schema is consistent.
+        if (_vecLoaded) {
+            initializeBrainVec(nativeDb);
+        }
+        // Seed schema version for new databases (no-op if already set)
+        nativeDb
+            .prepare(`INSERT OR IGNORE INTO brain_schema_meta (key, value) VALUES ('schemaVersion', '${BRAIN_SCHEMA_VERSION}')`)
+            .run();
+        // Set singleton only after migrations complete
+        _db = db;
+        return db;
+    })();
+    try {
+        return await _initPromise;
+    }
+    finally {
+        _initPromise = null;
+    }
+}
+/**
+ * Close the brain.db database connection and release resources.
+ */
+export function closeBrainDb() {
+    if (_nativeDb) {
+        try {
+            if (_nativeDb.isOpen) {
+                _nativeDb.close();
+            }
+        }
+        catch {
+            // Ignore close errors
+        }
+        _nativeDb = null;
+    }
+    _db = null;
+    _dbPath = null;
+    _vecLoaded = false;
+}
+/**
+ * Reset brain.db singleton state without saving.
+ * Used during tests or when database file is recreated.
+ * Safe to call multiple times.
+ */
+export function resetBrainDbState() {
+    if (_nativeDb) {
+        try {
+            if (_nativeDb.isOpen) {
+                _nativeDb.close();
+            }
+        }
+        catch {
+            // Ignore close errors
+        }
+        _nativeDb = null;
+    }
+    _db = null;
+    _dbPath = null;
+    _initPromise = null;
+    _vecLoaded = false;
+}
+/**
+ * Get the underlying node:sqlite DatabaseSync instance for brain.db.
+ * Useful for direct PRAGMA calls or raw SQL operations.
+ * Returns null if the database hasn't been initialized.
+ */
+export function getBrainNativeDb() {
+    return _nativeDb;
+}
+/**
+ * Re-export brain schema for external use.
+ */
+export { brainSchema };
+//# sourceMappingURL=brain-sqlite.js.map

package/dist/store/brain-sqlite.js.map

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

package/dist/store/cache.js

@@ -0,0 +1,168 @@
+/**
+ * Index caching for O(1) label/phase/hierarchy lookups.
+ * Ported from lib/data/cache.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+/**
+ * In-memory cache for task indices with checksum-based staleness detection.
+ */
+export class TaskCache {
+    labelIndex = new Map();
+    phaseIndex = new Map();
+    parentIndex = new Map();
+    childrenIndex = new Map();
+    depthIndex = new Map();
+    checksum = '';
+    initialized = false;
+    /**
+     * Compute a checksum from task data for staleness detection.
+     */
+    computeChecksum(tasks) {
+        return tasks
+            .map((t) => `${t.id}:${t.status}:${t.parentId ?? ''}:${t.phase ?? ''}:${(t.labels ?? []).join(',')}`)
+            .sort()
+            .join('|');
+    }
+    /**
+     * Initialize or rebuild cache from tasks.
+     * Returns true if cache was rebuilt, false if already valid.
+     */
+    init(tasks) {
+        const newChecksum = this.computeChecksum(tasks);
+        if (this.initialized && newChecksum === this.checksum) {
+            return false;
+        }
+        this.buildLabelIndex(tasks);
+        this.buildPhaseIndex(tasks);
+        this.buildHierarchyIndex(tasks);
+        this.checksum = newChecksum;
+        this.initialized = true;
+        return true;
+    }
+    buildLabelIndex(tasks) {
+        this.labelIndex.clear();
+        for (const task of tasks) {
+            if (!task.labels?.length)
+                continue;
+            for (const label of task.labels) {
+                const existing = this.labelIndex.get(label) ?? [];
+                existing.push(task.id);
+                this.labelIndex.set(label, existing);
+            }
+        }
+    }
+    buildPhaseIndex(tasks) {
+        this.phaseIndex.clear();
+        for (const task of tasks) {
+            if (!task.phase)
+                continue;
+            const existing = this.phaseIndex.get(task.phase) ?? [];
+            existing.push(task.id);
+            this.phaseIndex.set(task.phase, existing);
+        }
+    }
+    buildHierarchyIndex(tasks) {
+        this.parentIndex.clear();
+        this.childrenIndex.clear();
+        this.depthIndex.clear();
+        const taskMap = new Map(tasks.map((t) => [t.id, t]));
+        for (const task of tasks) {
+            this.parentIndex.set(task.id, task.parentId ?? null);
+            if (task.parentId) {
+                const siblings = this.childrenIndex.get(task.parentId) ?? [];
+                siblings.push(task.id);
+                this.childrenIndex.set(task.parentId, siblings);
+            }
+        }
+        // Compute depths
+        for (const task of tasks) {
+            let depth = 0;
+            let current = task;
+            const visited = new Set();
+            while (current.parentId && !visited.has(current.parentId)) {
+                visited.add(current.parentId);
+                const parent = taskMap.get(current.parentId);
+                if (!parent)
+                    break;
+                depth++;
+                current = parent;
+            }
+            this.depthIndex.set(task.id, depth);
+        }
+    }
+    /** Get task IDs by label. */
+    getTasksByLabel(label) {
+        return this.labelIndex.get(label) ?? [];
+    }
+    /** Get task IDs by phase. */
+    getTasksByPhase(phase) {
+        return this.phaseIndex.get(phase) ?? [];
+    }
+    /** Get all labels. */
+    getAllLabels() {
+        return [...this.labelIndex.keys()];
+    }
+    /** Get all phases. */
+    getAllPhases() {
+        return [...this.phaseIndex.keys()];
+    }
+    /** Get label count for a specific label. */
+    getLabelCount(label) {
+        return this.getTasksByLabel(label).length;
+    }
+    /** Get parent ID for a task. */
+    getParent(taskId) {
+        return this.parentIndex.get(taskId) ?? null;
+    }
+    /** Get children IDs for a task. */
+    getChildren(taskId) {
+        return this.childrenIndex.get(taskId) ?? [];
+    }
+    /** Get depth for a task. */
+    getDepth(taskId) {
+        return this.depthIndex.get(taskId) ?? 0;
+    }
+    /** Get child count. */
+    getChildCount(taskId) {
+        return this.getChildren(taskId).length;
+    }
+    /** Get root tasks (no parent). */
+    getRootTasks() {
+        return [...this.parentIndex.entries()]
+            .filter(([, parent]) => parent === null)
+            .map(([id]) => id);
+    }
+    /** Get leaf tasks (no children). */
+    getLeafTasks() {
+        const parentSet = new Set(this.childrenIndex.keys());
+        return [...this.parentIndex.keys()].filter((id) => !parentSet.has(id) || this.getChildCount(id) === 0);
+    }
+    /** Force invalidation and rebuild. */
+    invalidate() {
+        this.labelIndex.clear();
+        this.phaseIndex.clear();
+        this.parentIndex.clear();
+        this.childrenIndex.clear();
+        this.depthIndex.clear();
+        this.checksum = '';
+        this.initialized = false;
+    }
+    /** Get cache statistics. */
+    getStats() {
+        let maxDepth = 0;
+        for (const d of this.depthIndex.values()) {
+            if (d > maxDepth)
+                maxDepth = d;
+        }
+        return {
+            initialized: this.initialized,
+            labelCount: this.labelIndex.size,
+            phaseCount: this.phaseIndex.size,
+            taskCount: this.parentIndex.size,
+            maxDepth,
+        };
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/store/cache.js.map

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