@stackmemoryai/stackmemory 0.6.0 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/dist/src/cli/commands/daemon.js +27 -0
  2. package/dist/src/cli/commands/daemon.js.map +2 -2
  3. package/dist/src/cli/commands/skills.js +3 -1
  4. package/dist/src/cli/commands/skills.js.map +2 -2
  5. package/dist/src/core/context/frame-database.js +12 -3
  6. package/dist/src/core/context/frame-database.js.map +2 -2
  7. package/dist/src/core/database/database-adapter.js +4 -0
  8. package/dist/src/core/database/database-adapter.js.map +2 -2
  9. package/dist/src/core/database/embedding-provider.js +17 -0
  10. package/dist/src/core/database/embedding-provider.js.map +7 -0
  11. package/dist/src/core/database/sqlite-adapter.js +260 -11
  12. package/dist/src/core/database/sqlite-adapter.js.map +2 -2
  13. package/dist/src/core/database/transformers-embedding-provider.js +50 -0
  14. package/dist/src/core/database/transformers-embedding-provider.js.map +7 -0
  15. package/dist/src/core/retrieval/context-retriever.js +15 -19
  16. package/dist/src/core/retrieval/context-retriever.js.map +2 -2
  17. package/dist/src/daemon/daemon-config.js +17 -0
  18. package/dist/src/daemon/daemon-config.js.map +2 -2
  19. package/dist/src/daemon/services/maintenance-service.js +258 -0
  20. package/dist/src/daemon/services/maintenance-service.js.map +7 -0
  21. package/dist/src/daemon/unified-daemon.js +36 -3
  22. package/dist/src/daemon/unified-daemon.js.map +2 -2
  23. package/dist/src/integrations/claude-code/task-coordinator.js +7 -2
  24. package/dist/src/integrations/claude-code/task-coordinator.js.map +2 -2
  25. package/dist/src/integrations/ralph/bridge/ralph-stackmemory-bridge.js +6 -2
  26. package/dist/src/integrations/ralph/bridge/ralph-stackmemory-bridge.js.map +2 -2
  27. package/package.json +3 -2
  28. package/scripts/install-claude-hooks-auto.js +10 -10
  29. package/templates/claude-hooks/on-task-complete.js +3 -4
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/core/context/frame-database.ts"],
4
- "sourcesContent": ["/**\n * Frame Database Operations\n * Handles all database interactions for frames, events, and anchors\n */\n\nimport Database from 'better-sqlite3';\nimport { Frame, Event, Anchor } from './frame-types.js';\nimport { logger } from '../monitoring/logger.js';\nimport { DatabaseError, ErrorCode } from '../errors/index.js';\n\n// Database row types for type-safe queries\ninterface FrameRow {\n frame_id: string;\n run_id: string;\n project_id: string;\n parent_frame_id: string | null;\n depth: number;\n type: string;\n name: string;\n state: string;\n inputs: string;\n outputs: string;\n digest_text: string | null;\n digest_json: string;\n created_at: number;\n closed_at: number | null;\n}\n\ninterface EventRow {\n event_id: string;\n frame_id: string;\n run_id: string;\n seq: number;\n event_type: string;\n payload: string;\n ts: number;\n}\n\ninterface AnchorRow {\n anchor_id: string;\n frame_id: string;\n type: string;\n text: string;\n priority: number;\n metadata: string;\n created_at: number;\n}\n\ninterface CountRow {\n count: number;\n}\n\ninterface MaxSeqRow {\n max_seq: number | null;\n}\n\n// Default limits to prevent unbounded queries\nexport const DEFAULT_FRAME_LIMIT = 1000;\nexport const DEFAULT_EVENT_LIMIT = 500;\nexport const DEFAULT_ANCHOR_LIMIT = 200;\n\n// Safe JSON parse with fallback\nfunction safeJsonParse<T>(json: string | null | undefined, fallback: T): T {\n if (!json) return fallback;\n try {\n return JSON.parse(json) as T;\n } catch {\n logger.warn('Failed to parse JSON, using fallback', {\n json: json.substring(0, 100),\n });\n return fallback;\n }\n}\n\nexport class FrameDatabase {\n constructor(private db: Database.Database) {}\n\n /**\n * Initialize database schema\n */\n initSchema(): void {\n try {\n // Enable WAL mode for better concurrency\n this.db.pragma('journal_mode = WAL');\n this.db.pragma('synchronous = NORMAL');\n // Enforce referential integrity\n this.db.pragma('foreign_keys = ON');\n\n // Create frames table\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS frames (\n frame_id TEXT PRIMARY KEY,\n run_id TEXT NOT NULL,\n project_id TEXT NOT NULL,\n parent_frame_id TEXT,\n depth INTEGER NOT NULL DEFAULT 0,\n type TEXT NOT NULL,\n name TEXT NOT NULL,\n state TEXT NOT NULL DEFAULT 'active',\n inputs TEXT DEFAULT '{}',\n outputs TEXT DEFAULT '{}',\n digest_text TEXT,\n digest_json TEXT DEFAULT '{}',\n created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n closed_at INTEGER,\n FOREIGN KEY (parent_frame_id) REFERENCES frames(frame_id)\n );\n `);\n\n // Create events table\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS events (\n event_id TEXT PRIMARY KEY,\n frame_id TEXT NOT NULL,\n run_id TEXT NOT NULL,\n seq INTEGER NOT NULL,\n event_type TEXT NOT NULL,\n payload TEXT NOT NULL DEFAULT '{}',\n ts INTEGER NOT NULL DEFAULT (unixepoch() * 1000),\n FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n );\n `);\n\n // Create anchors table\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS anchors (\n anchor_id TEXT PRIMARY KEY,\n frame_id TEXT NOT NULL,\n type TEXT NOT NULL,\n text TEXT NOT NULL,\n priority INTEGER NOT NULL DEFAULT 5,\n metadata TEXT DEFAULT '{}',\n created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n );\n `);\n\n // Create indexes for performance\n this.db.exec(`\n CREATE INDEX IF NOT EXISTS idx_frames_project_state ON frames(project_id, state);\n CREATE INDEX IF NOT EXISTS idx_frames_parent ON frames(parent_frame_id);\n CREATE INDEX IF NOT EXISTS idx_events_frame_seq ON events(frame_id, seq);\n CREATE INDEX IF NOT EXISTS idx_anchors_frame_priority ON anchors(frame_id, priority DESC);\n `);\n\n logger.info('Frame database schema initialized');\n } catch (error: unknown) {\n throw new DatabaseError(\n 'Failed to initialize frame database schema',\n ErrorCode.DB_SCHEMA_ERROR,\n { operation: 'initSchema' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Insert new frame\n */\n insertFrame(frame: Omit<Frame, 'created_at' | 'closed_at'>): Frame {\n try {\n const stmt = this.db.prepare(`\n INSERT INTO frames (frame_id, run_id, project_id, parent_frame_id, depth, type, name, state, inputs, outputs, digest_json)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n `);\n\n const result = stmt.run(\n frame.frame_id,\n frame.run_id,\n frame.project_id,\n frame.parent_frame_id || null,\n frame.depth,\n frame.type,\n frame.name,\n frame.state,\n JSON.stringify(frame.inputs),\n JSON.stringify(frame.outputs),\n JSON.stringify(frame.digest_json)\n );\n\n if (result.changes === 0) {\n throw new DatabaseError(\n 'Frame insertion failed - no rows affected',\n ErrorCode.DB_INSERT_FAILED,\n { frameId: frame.frame_id, operation: 'insertFrame' }\n );\n }\n\n // Return the created frame with timestamp\n const createdFrame = this.getFrame(frame.frame_id);\n if (!createdFrame) {\n throw new DatabaseError(\n 'Failed to retrieve created frame',\n ErrorCode.DB_QUERY_FAILED,\n { frameId: frame.frame_id, operation: 'insertFrame' }\n );\n }\n\n return createdFrame;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to insert frame: ${frame.frame_id}`,\n ErrorCode.DB_INSERT_FAILED,\n {\n frameId: frame.frame_id,\n frameName: frame.name,\n operation: 'insertFrame',\n },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get frame by ID\n */\n getFrame(frameId: string): Frame | undefined {\n try {\n const row = this.db\n .prepare('SELECT * FROM frames WHERE frame_id = ?')\n .get(frameId) as FrameRow | undefined;\n\n if (!row) return undefined;\n\n return {\n ...row,\n parent_frame_id: row.parent_frame_id ?? undefined,\n inputs: safeJsonParse<Record<string, unknown>>(row.inputs, {}),\n outputs: safeJsonParse<Record<string, unknown>>(row.outputs, {}),\n digest_json: safeJsonParse<Record<string, unknown>>(\n row.digest_json,\n {}\n ),\n } as Frame;\n } catch (error: unknown) {\n logger.warn(`Failed to get frame: ${frameId}`, { error });\n return undefined;\n }\n }\n\n /**\n * Update frame state and outputs\n */\n updateFrame(frameId: string, updates: Partial<Frame>): void {\n try {\n const setClauses: string[] = [];\n const values: (string | number | null)[] = [];\n\n if (updates.state !== undefined) {\n setClauses.push('state = ?');\n values.push(updates.state);\n }\n\n if (updates.outputs !== undefined) {\n setClauses.push('outputs = ?');\n values.push(JSON.stringify(updates.outputs));\n }\n\n if (updates.digest_text !== undefined) {\n setClauses.push('digest_text = ?');\n values.push(updates.digest_text);\n }\n\n if (updates.digest_json !== undefined) {\n setClauses.push('digest_json = ?');\n values.push(JSON.stringify(updates.digest_json));\n }\n\n if (updates.closed_at !== undefined) {\n setClauses.push('closed_at = ?');\n values.push(updates.closed_at);\n }\n\n if (updates.parent_frame_id !== undefined) {\n setClauses.push('parent_frame_id = ?');\n values.push(updates.parent_frame_id);\n }\n\n if (updates.depth !== undefined) {\n setClauses.push('depth = ?');\n values.push(updates.depth);\n }\n\n if (setClauses.length === 0) {\n return; // No updates to apply\n }\n\n values.push(frameId);\n\n const stmt = this.db.prepare(`\n UPDATE frames SET ${setClauses.join(', ')} WHERE frame_id = ?\n `);\n\n const result = stmt.run(...values);\n\n if (result.changes === 0) {\n throw new DatabaseError(\n `Frame not found: ${frameId}`,\n ErrorCode.DB_UPDATE_FAILED,\n { frameId, operation: 'updateFrame' }\n );\n }\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to update frame: ${frameId}`,\n ErrorCode.DB_UPDATE_FAILED,\n { frameId, updates, operation: 'updateFrame' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get frames by project and state\n */\n getFramesByProject(\n projectId: string,\n state?: 'active' | 'closed',\n limit: number = DEFAULT_FRAME_LIMIT\n ): Frame[] {\n try {\n const query = state\n ? 'SELECT * FROM frames WHERE project_id = ? AND state = ? ORDER BY created_at LIMIT ?'\n : 'SELECT * FROM frames WHERE project_id = ? ORDER BY created_at LIMIT ?';\n\n const params = state ? [projectId, state, limit] : [projectId, limit];\n const rows = this.db.prepare(query).all(...params) as FrameRow[];\n\n return rows.map((row) => ({\n ...row,\n parent_frame_id: row.parent_frame_id ?? undefined,\n inputs: safeJsonParse<Record<string, unknown>>(row.inputs, {}),\n outputs: safeJsonParse<Record<string, unknown>>(row.outputs, {}),\n digest_json: safeJsonParse<Record<string, unknown>>(\n row.digest_json,\n {}\n ),\n })) as Frame[];\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get frames for project: ${projectId}`,\n ErrorCode.DB_QUERY_FAILED,\n { projectId, state, operation: 'getFramesByProject' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Insert event\n */\n insertEvent(event: Omit<Event, 'ts'>): Event {\n try {\n const stmt = this.db.prepare(`\n INSERT INTO events (event_id, frame_id, run_id, seq, event_type, payload)\n VALUES (?, ?, ?, ?, ?, ?)\n `);\n\n const result = stmt.run(\n event.event_id,\n event.frame_id,\n event.run_id,\n event.seq,\n event.event_type,\n JSON.stringify(event.payload)\n );\n\n if (result.changes === 0) {\n throw new DatabaseError(\n 'Event insertion failed - no rows affected',\n ErrorCode.DB_INSERT_FAILED,\n {\n eventId: event.event_id,\n frameId: event.frame_id,\n operation: 'insertEvent',\n }\n );\n }\n\n // Return the created event with timestamp\n const createdEvent = this.db\n .prepare('SELECT * FROM events WHERE event_id = ?')\n .get(event.event_id) as EventRow;\n\n return {\n ...createdEvent,\n payload: safeJsonParse<Record<string, unknown>>(\n createdEvent.payload,\n {}\n ),\n } as Event;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to insert event: ${event.event_id}`,\n ErrorCode.DB_INSERT_FAILED,\n {\n eventId: event.event_id,\n frameId: event.frame_id,\n operation: 'insertEvent',\n },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get events for a frame\n */\n getFrameEvents(\n frameId: string,\n limit: number = DEFAULT_EVENT_LIMIT\n ): Event[] {\n try {\n const query =\n 'SELECT * FROM events WHERE frame_id = ? ORDER BY seq DESC LIMIT ?';\n const params = [frameId, limit];\n const rows = this.db.prepare(query).all(...params) as EventRow[];\n\n return rows.map((row) => ({\n ...row,\n payload: safeJsonParse<Record<string, unknown>>(row.payload, {}),\n })) as Event[];\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get events for frame: ${frameId}`,\n ErrorCode.DB_QUERY_FAILED,\n { frameId, limit, operation: 'getFrameEvents' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get next event sequence number\n */\n getNextEventSequence(frameId: string): number {\n try {\n const result = this.db\n .prepare('SELECT MAX(seq) as max_seq FROM events WHERE frame_id = ?')\n .get(frameId) as MaxSeqRow;\n\n return (result.max_seq || 0) + 1;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get next event sequence for frame: ${frameId}`,\n ErrorCode.DB_QUERY_FAILED,\n { frameId, operation: 'getNextEventSequence' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Insert anchor\n */\n insertAnchor(anchor: Omit<Anchor, 'created_at'>): Anchor {\n try {\n const stmt = this.db.prepare(`\n INSERT INTO anchors (anchor_id, frame_id, type, text, priority, metadata)\n VALUES (?, ?, ?, ?, ?, ?)\n `);\n\n const result = stmt.run(\n anchor.anchor_id,\n anchor.frame_id,\n anchor.type,\n anchor.text,\n anchor.priority,\n JSON.stringify(anchor.metadata)\n );\n\n if (result.changes === 0) {\n throw new DatabaseError(\n 'Anchor insertion failed - no rows affected',\n ErrorCode.DB_INSERT_FAILED,\n {\n anchorId: anchor.anchor_id,\n frameId: anchor.frame_id,\n operation: 'insertAnchor',\n }\n );\n }\n\n // Return the created anchor with timestamp\n const createdAnchor = this.db\n .prepare('SELECT * FROM anchors WHERE anchor_id = ?')\n .get(anchor.anchor_id) as AnchorRow;\n\n return {\n ...createdAnchor,\n metadata: safeJsonParse<Record<string, unknown>>(\n createdAnchor.metadata,\n {}\n ),\n } as Anchor;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to insert anchor: ${anchor.anchor_id}`,\n ErrorCode.DB_INSERT_FAILED,\n {\n anchorId: anchor.anchor_id,\n frameId: anchor.frame_id,\n operation: 'insertAnchor',\n },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get anchors for a frame\n */\n getFrameAnchors(\n frameId: string,\n limit: number = DEFAULT_ANCHOR_LIMIT\n ): Anchor[] {\n try {\n const rows = this.db\n .prepare(\n 'SELECT * FROM anchors WHERE frame_id = ? ORDER BY priority DESC, created_at ASC LIMIT ?'\n )\n .all(frameId, limit) as AnchorRow[];\n\n return rows.map((row) => ({\n ...row,\n metadata: safeJsonParse<Record<string, unknown>>(row.metadata, {}),\n })) as Anchor[];\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get anchors for frame: ${frameId}`,\n ErrorCode.DB_QUERY_FAILED,\n { frameId, operation: 'getFrameAnchors' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Delete frame and all related data\n */\n deleteFrame(frameId: string): void {\n try {\n // Delete in order due to foreign keys\n this.db.prepare('DELETE FROM anchors WHERE frame_id = ?').run(frameId);\n this.db.prepare('DELETE FROM events WHERE frame_id = ?').run(frameId);\n this.db.prepare('DELETE FROM frames WHERE frame_id = ?').run(frameId);\n\n logger.info('Frame deleted', { frameId });\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to delete frame: ${frameId}`,\n ErrorCode.DB_DELETE_FAILED,\n { frameId, operation: 'deleteFrame' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Count frames by project and state (without loading all data)\n */\n countFrames(projectId?: string, state?: 'active' | 'closed'): number {\n try {\n let query = 'SELECT COUNT(*) as count FROM frames';\n const params: (string | undefined)[] = [];\n\n if (projectId) {\n query += ' WHERE project_id = ?';\n params.push(projectId);\n if (state) {\n query += ' AND state = ?';\n params.push(state);\n }\n } else if (state) {\n query += ' WHERE state = ?';\n params.push(state);\n }\n\n const result = this.db.prepare(query).get(...params) as CountRow;\n return result.count;\n } catch (error: unknown) {\n logger.warn('Failed to count frames', { error, projectId, state });\n return 0;\n }\n }\n\n /**\n * Get database statistics\n */\n getStatistics(): Record<string, number> {\n try {\n const frameCount = this.db\n .prepare('SELECT COUNT(*) as count FROM frames')\n .get() as CountRow;\n const eventCount = this.db\n .prepare('SELECT COUNT(*) as count FROM events')\n .get() as CountRow;\n const anchorCount = this.db\n .prepare('SELECT COUNT(*) as count FROM anchors')\n .get() as CountRow;\n const activeFrames = this.db\n .prepare(\"SELECT COUNT(*) as count FROM frames WHERE state = 'active'\")\n .get() as CountRow;\n\n return {\n totalFrames: frameCount.count,\n totalEvents: eventCount.count,\n totalAnchors: anchorCount.count,\n activeFrames: activeFrames.count,\n };\n } catch (error: unknown) {\n logger.warn('Failed to get database statistics', {\n error: error instanceof Error ? error.message : String(error),\n });\n return {};\n }\n }\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * Frame Database Operations\n * Handles all database interactions for frames, events, and anchors\n */\n\nimport Database from 'better-sqlite3';\nimport { Frame, Event, Anchor } from './frame-types.js';\nimport { logger } from '../monitoring/logger.js';\nimport { DatabaseError, ErrorCode } from '../errors/index.js';\n\n// Database row types for type-safe queries\ninterface FrameRow {\n frame_id: string;\n run_id: string;\n project_id: string;\n parent_frame_id: string | null;\n depth: number;\n type: string;\n name: string;\n state: string;\n inputs: string;\n outputs: string;\n digest_text: string | null;\n digest_json: string;\n created_at: number;\n closed_at: number | null;\n}\n\ninterface EventRow {\n event_id: string;\n frame_id: string;\n run_id: string;\n seq: number;\n event_type: string;\n payload: string;\n ts: number;\n}\n\ninterface AnchorRow {\n anchor_id: string;\n frame_id: string;\n type: string;\n text: string;\n priority: number;\n metadata: string;\n created_at: number;\n}\n\ninterface CountRow {\n count: number;\n}\n\ninterface MaxSeqRow {\n max_seq: number | null;\n}\n\n// Default limits to prevent unbounded queries\nexport const DEFAULT_FRAME_LIMIT = 1000;\nexport const DEFAULT_EVENT_LIMIT = 500;\nexport const DEFAULT_ANCHOR_LIMIT = 200;\n\n// Safe JSON parse with fallback\nfunction safeJsonParse<T>(json: string | null | undefined, fallback: T): T {\n if (!json) return fallback;\n try {\n return JSON.parse(json) as T;\n } catch {\n logger.warn('Failed to parse JSON, using fallback', {\n json: json.substring(0, 100),\n });\n return fallback;\n }\n}\n\nexport class FrameDatabase {\n constructor(private db: Database.Database) {}\n\n /**\n * Initialize database schema\n */\n initSchema(): void {\n try {\n // Pragmas may fail if another component already opened this database\n // and left an implicit transaction (e.g. SQLiteAdapter.connect()).\n // Wrap each in try/catch so schema creation still proceeds.\n try {\n this.db.pragma('journal_mode = WAL');\n } catch {\n // WAL mode likely already set by adapter\n }\n try {\n this.db.pragma('synchronous = NORMAL');\n } catch {\n // Safety level cannot change inside a transaction \u2014 skip\n }\n try {\n this.db.pragma('foreign_keys = ON');\n } catch {\n // Foreign keys likely already enabled\n }\n\n // Create frames table\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS frames (\n frame_id TEXT PRIMARY KEY,\n run_id TEXT NOT NULL,\n project_id TEXT NOT NULL,\n parent_frame_id TEXT,\n depth INTEGER NOT NULL DEFAULT 0,\n type TEXT NOT NULL,\n name TEXT NOT NULL,\n state TEXT NOT NULL DEFAULT 'active',\n inputs TEXT DEFAULT '{}',\n outputs TEXT DEFAULT '{}',\n digest_text TEXT,\n digest_json TEXT DEFAULT '{}',\n created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n closed_at INTEGER,\n FOREIGN KEY (parent_frame_id) REFERENCES frames(frame_id)\n );\n `);\n\n // Create events table\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS events (\n event_id TEXT PRIMARY KEY,\n frame_id TEXT NOT NULL,\n run_id TEXT NOT NULL,\n seq INTEGER NOT NULL,\n event_type TEXT NOT NULL,\n payload TEXT NOT NULL DEFAULT '{}',\n ts INTEGER NOT NULL DEFAULT (unixepoch() * 1000),\n FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n );\n `);\n\n // Create anchors table\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS anchors (\n anchor_id TEXT PRIMARY KEY,\n frame_id TEXT NOT NULL,\n type TEXT NOT NULL,\n text TEXT NOT NULL,\n priority INTEGER NOT NULL DEFAULT 5,\n metadata TEXT DEFAULT '{}',\n created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n );\n `);\n\n // Create indexes for performance\n this.db.exec(`\n CREATE INDEX IF NOT EXISTS idx_frames_project_state ON frames(project_id, state);\n CREATE INDEX IF NOT EXISTS idx_frames_parent ON frames(parent_frame_id);\n CREATE INDEX IF NOT EXISTS idx_events_frame_seq ON events(frame_id, seq);\n CREATE INDEX IF NOT EXISTS idx_anchors_frame_priority ON anchors(frame_id, priority DESC);\n `);\n\n logger.info('Frame database schema initialized');\n } catch (error: unknown) {\n throw new DatabaseError(\n 'Failed to initialize frame database schema',\n ErrorCode.DB_SCHEMA_ERROR,\n { operation: 'initSchema' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Insert new frame\n */\n insertFrame(frame: Omit<Frame, 'created_at' | 'closed_at'>): Frame {\n try {\n const stmt = this.db.prepare(`\n INSERT INTO frames (frame_id, run_id, project_id, parent_frame_id, depth, type, name, state, inputs, outputs, digest_json)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n `);\n\n const result = stmt.run(\n frame.frame_id,\n frame.run_id,\n frame.project_id,\n frame.parent_frame_id || null,\n frame.depth,\n frame.type,\n frame.name,\n frame.state,\n JSON.stringify(frame.inputs),\n JSON.stringify(frame.outputs),\n JSON.stringify(frame.digest_json)\n );\n\n if (result.changes === 0) {\n throw new DatabaseError(\n 'Frame insertion failed - no rows affected',\n ErrorCode.DB_INSERT_FAILED,\n { frameId: frame.frame_id, operation: 'insertFrame' }\n );\n }\n\n // Return the created frame with timestamp\n const createdFrame = this.getFrame(frame.frame_id);\n if (!createdFrame) {\n throw new DatabaseError(\n 'Failed to retrieve created frame',\n ErrorCode.DB_QUERY_FAILED,\n { frameId: frame.frame_id, operation: 'insertFrame' }\n );\n }\n\n return createdFrame;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to insert frame: ${frame.frame_id}`,\n ErrorCode.DB_INSERT_FAILED,\n {\n frameId: frame.frame_id,\n frameName: frame.name,\n operation: 'insertFrame',\n },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get frame by ID\n */\n getFrame(frameId: string): Frame | undefined {\n try {\n const row = this.db\n .prepare('SELECT * FROM frames WHERE frame_id = ?')\n .get(frameId) as FrameRow | undefined;\n\n if (!row) return undefined;\n\n return {\n ...row,\n parent_frame_id: row.parent_frame_id ?? undefined,\n inputs: safeJsonParse<Record<string, unknown>>(row.inputs, {}),\n outputs: safeJsonParse<Record<string, unknown>>(row.outputs, {}),\n digest_json: safeJsonParse<Record<string, unknown>>(\n row.digest_json,\n {}\n ),\n } as Frame;\n } catch (error: unknown) {\n logger.warn(`Failed to get frame: ${frameId}`, { error });\n return undefined;\n }\n }\n\n /**\n * Update frame state and outputs\n */\n updateFrame(frameId: string, updates: Partial<Frame>): void {\n try {\n const setClauses: string[] = [];\n const values: (string | number | null)[] = [];\n\n if (updates.state !== undefined) {\n setClauses.push('state = ?');\n values.push(updates.state);\n }\n\n if (updates.outputs !== undefined) {\n setClauses.push('outputs = ?');\n values.push(JSON.stringify(updates.outputs));\n }\n\n if (updates.digest_text !== undefined) {\n setClauses.push('digest_text = ?');\n values.push(updates.digest_text);\n }\n\n if (updates.digest_json !== undefined) {\n setClauses.push('digest_json = ?');\n values.push(JSON.stringify(updates.digest_json));\n }\n\n if (updates.closed_at !== undefined) {\n setClauses.push('closed_at = ?');\n values.push(updates.closed_at);\n }\n\n if (updates.parent_frame_id !== undefined) {\n setClauses.push('parent_frame_id = ?');\n values.push(updates.parent_frame_id);\n }\n\n if (updates.depth !== undefined) {\n setClauses.push('depth = ?');\n values.push(updates.depth);\n }\n\n if (setClauses.length === 0) {\n return; // No updates to apply\n }\n\n values.push(frameId);\n\n const stmt = this.db.prepare(`\n UPDATE frames SET ${setClauses.join(', ')} WHERE frame_id = ?\n `);\n\n const result = stmt.run(...values);\n\n if (result.changes === 0) {\n throw new DatabaseError(\n `Frame not found: ${frameId}`,\n ErrorCode.DB_UPDATE_FAILED,\n { frameId, operation: 'updateFrame' }\n );\n }\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to update frame: ${frameId}`,\n ErrorCode.DB_UPDATE_FAILED,\n { frameId, updates, operation: 'updateFrame' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get frames by project and state\n */\n getFramesByProject(\n projectId: string,\n state?: 'active' | 'closed',\n limit: number = DEFAULT_FRAME_LIMIT\n ): Frame[] {\n try {\n const query = state\n ? 'SELECT * FROM frames WHERE project_id = ? AND state = ? ORDER BY created_at LIMIT ?'\n : 'SELECT * FROM frames WHERE project_id = ? ORDER BY created_at LIMIT ?';\n\n const params = state ? [projectId, state, limit] : [projectId, limit];\n const rows = this.db.prepare(query).all(...params) as FrameRow[];\n\n return rows.map((row) => ({\n ...row,\n parent_frame_id: row.parent_frame_id ?? undefined,\n inputs: safeJsonParse<Record<string, unknown>>(row.inputs, {}),\n outputs: safeJsonParse<Record<string, unknown>>(row.outputs, {}),\n digest_json: safeJsonParse<Record<string, unknown>>(\n row.digest_json,\n {}\n ),\n })) as Frame[];\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get frames for project: ${projectId}`,\n ErrorCode.DB_QUERY_FAILED,\n { projectId, state, operation: 'getFramesByProject' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Insert event\n */\n insertEvent(event: Omit<Event, 'ts'>): Event {\n try {\n const stmt = this.db.prepare(`\n INSERT INTO events (event_id, frame_id, run_id, seq, event_type, payload)\n VALUES (?, ?, ?, ?, ?, ?)\n `);\n\n const result = stmt.run(\n event.event_id,\n event.frame_id,\n event.run_id,\n event.seq,\n event.event_type,\n JSON.stringify(event.payload)\n );\n\n if (result.changes === 0) {\n throw new DatabaseError(\n 'Event insertion failed - no rows affected',\n ErrorCode.DB_INSERT_FAILED,\n {\n eventId: event.event_id,\n frameId: event.frame_id,\n operation: 'insertEvent',\n }\n );\n }\n\n // Return the created event with timestamp\n const createdEvent = this.db\n .prepare('SELECT * FROM events WHERE event_id = ?')\n .get(event.event_id) as EventRow;\n\n return {\n ...createdEvent,\n payload: safeJsonParse<Record<string, unknown>>(\n createdEvent.payload,\n {}\n ),\n } as Event;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to insert event: ${event.event_id}`,\n ErrorCode.DB_INSERT_FAILED,\n {\n eventId: event.event_id,\n frameId: event.frame_id,\n operation: 'insertEvent',\n },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get events for a frame\n */\n getFrameEvents(\n frameId: string,\n limit: number = DEFAULT_EVENT_LIMIT\n ): Event[] {\n try {\n const query =\n 'SELECT * FROM events WHERE frame_id = ? ORDER BY seq DESC LIMIT ?';\n const params = [frameId, limit];\n const rows = this.db.prepare(query).all(...params) as EventRow[];\n\n return rows.map((row) => ({\n ...row,\n payload: safeJsonParse<Record<string, unknown>>(row.payload, {}),\n })) as Event[];\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get events for frame: ${frameId}`,\n ErrorCode.DB_QUERY_FAILED,\n { frameId, limit, operation: 'getFrameEvents' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get next event sequence number\n */\n getNextEventSequence(frameId: string): number {\n try {\n const result = this.db\n .prepare('SELECT MAX(seq) as max_seq FROM events WHERE frame_id = ?')\n .get(frameId) as MaxSeqRow;\n\n return (result.max_seq || 0) + 1;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get next event sequence for frame: ${frameId}`,\n ErrorCode.DB_QUERY_FAILED,\n { frameId, operation: 'getNextEventSequence' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Insert anchor\n */\n insertAnchor(anchor: Omit<Anchor, 'created_at'>): Anchor {\n try {\n const stmt = this.db.prepare(`\n INSERT INTO anchors (anchor_id, frame_id, type, text, priority, metadata)\n VALUES (?, ?, ?, ?, ?, ?)\n `);\n\n const result = stmt.run(\n anchor.anchor_id,\n anchor.frame_id,\n anchor.type,\n anchor.text,\n anchor.priority,\n JSON.stringify(anchor.metadata)\n );\n\n if (result.changes === 0) {\n throw new DatabaseError(\n 'Anchor insertion failed - no rows affected',\n ErrorCode.DB_INSERT_FAILED,\n {\n anchorId: anchor.anchor_id,\n frameId: anchor.frame_id,\n operation: 'insertAnchor',\n }\n );\n }\n\n // Return the created anchor with timestamp\n const createdAnchor = this.db\n .prepare('SELECT * FROM anchors WHERE anchor_id = ?')\n .get(anchor.anchor_id) as AnchorRow;\n\n return {\n ...createdAnchor,\n metadata: safeJsonParse<Record<string, unknown>>(\n createdAnchor.metadata,\n {}\n ),\n } as Anchor;\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to insert anchor: ${anchor.anchor_id}`,\n ErrorCode.DB_INSERT_FAILED,\n {\n anchorId: anchor.anchor_id,\n frameId: anchor.frame_id,\n operation: 'insertAnchor',\n },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Get anchors for a frame\n */\n getFrameAnchors(\n frameId: string,\n limit: number = DEFAULT_ANCHOR_LIMIT\n ): Anchor[] {\n try {\n const rows = this.db\n .prepare(\n 'SELECT * FROM anchors WHERE frame_id = ? ORDER BY priority DESC, created_at ASC LIMIT ?'\n )\n .all(frameId, limit) as AnchorRow[];\n\n return rows.map((row) => ({\n ...row,\n metadata: safeJsonParse<Record<string, unknown>>(row.metadata, {}),\n })) as Anchor[];\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to get anchors for frame: ${frameId}`,\n ErrorCode.DB_QUERY_FAILED,\n { frameId, operation: 'getFrameAnchors' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Delete frame and all related data\n */\n deleteFrame(frameId: string): void {\n try {\n // Delete in order due to foreign keys\n this.db.prepare('DELETE FROM anchors WHERE frame_id = ?').run(frameId);\n this.db.prepare('DELETE FROM events WHERE frame_id = ?').run(frameId);\n this.db.prepare('DELETE FROM frames WHERE frame_id = ?').run(frameId);\n\n logger.info('Frame deleted', { frameId });\n } catch (error: unknown) {\n throw new DatabaseError(\n `Failed to delete frame: ${frameId}`,\n ErrorCode.DB_DELETE_FAILED,\n { frameId, operation: 'deleteFrame' },\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Count frames by project and state (without loading all data)\n */\n countFrames(projectId?: string, state?: 'active' | 'closed'): number {\n try {\n let query = 'SELECT COUNT(*) as count FROM frames';\n const params: (string | undefined)[] = [];\n\n if (projectId) {\n query += ' WHERE project_id = ?';\n params.push(projectId);\n if (state) {\n query += ' AND state = ?';\n params.push(state);\n }\n } else if (state) {\n query += ' WHERE state = ?';\n params.push(state);\n }\n\n const result = this.db.prepare(query).get(...params) as CountRow;\n return result.count;\n } catch (error: unknown) {\n logger.warn('Failed to count frames', { error, projectId, state });\n return 0;\n }\n }\n\n /**\n * Get database statistics\n */\n getStatistics(): Record<string, number> {\n try {\n const frameCount = this.db\n .prepare('SELECT COUNT(*) as count FROM frames')\n .get() as CountRow;\n const eventCount = this.db\n .prepare('SELECT COUNT(*) as count FROM events')\n .get() as CountRow;\n const anchorCount = this.db\n .prepare('SELECT COUNT(*) as count FROM anchors')\n .get() as CountRow;\n const activeFrames = this.db\n .prepare(\"SELECT COUNT(*) as count FROM frames WHERE state = 'active'\")\n .get() as CountRow;\n\n return {\n totalFrames: frameCount.count,\n totalEvents: eventCount.count,\n totalAnchors: anchorCount.count,\n activeFrames: activeFrames.count,\n };\n } catch (error: unknown) {\n logger.warn('Failed to get database statistics', {\n error: error instanceof Error ? error.message : String(error),\n });\n return {};\n }\n }\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -9,6 +9,10 @@ class DatabaseAdapter {
9
9
  this.projectId = projectId;
10
10
  this.config = config || {};
11
11
  }
12
+ /** Returns the configured embedding provider, if any */
13
+ getEmbeddingProvider() {
14
+ return void 0;
15
+ }
12
16
  // Utility methods
13
17
  generateId() {
14
18
  return crypto.randomUUID();
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/core/database/database-adapter.ts"],
4
- "sourcesContent": ["/**\n * Database Adapter Interface\n * Provides abstraction layer for different database implementations\n * Supports SQLite (current) and ParadeDB (new) with seamless migration\n */\n\nimport type { Frame, Event, Anchor } from '../context/index.js';\n\nexport interface QueryOptions {\n limit?: number;\n offset?: number;\n orderBy?: string;\n orderDirection?: 'ASC' | 'DESC';\n timeout?: number;\n}\n\nexport interface SearchOptions extends QueryOptions {\n query: string;\n searchType?: 'text' | 'vector' | 'hybrid';\n scoreThreshold?: number;\n fields?: string[];\n boost?: Record<string, number>;\n}\n\nexport interface AggregationOptions {\n groupBy: string[];\n metrics: Array<{\n field: string;\n operation: 'count' | 'sum' | 'avg' | 'min' | 'max';\n alias?: string;\n }>;\n having?: Record<string, any>;\n}\n\nexport interface BulkOperation {\n type: 'insert' | 'update' | 'delete';\n table: string;\n data?: any;\n where?: Record<string, any>;\n}\n\nexport interface DatabaseStats {\n totalFrames: number;\n activeFrames: number;\n totalEvents: number;\n totalAnchors: number;\n diskUsage: number;\n lastVacuum?: Date;\n}\n\n// Database result type interfaces\nexport interface CountResult {\n count: number;\n}\n\nexport interface VersionResult {\n version: number;\n}\n\nexport interface FrameRow {\n frame_id: string;\n parent_frame_id?: string;\n project_id: string;\n run_id: string;\n type: string;\n name: string;\n state: string;\n depth: number;\n inputs: string;\n outputs: string;\n digest_text: string;\n digest_json: string;\n created_at: number;\n closed_at?: number;\n score?: number;\n}\n\nexport interface EventRow {\n event_id: string;\n frame_id: string;\n seq: number;\n type: string;\n text: string;\n metadata: string;\n}\n\nexport interface AnchorRow {\n anchor_id: string;\n frame_id: string;\n type: string;\n text: string;\n priority: number;\n created_at: number;\n metadata: string;\n}\n\nexport abstract class DatabaseAdapter {\n protected readonly projectId: string;\n protected readonly config: any;\n\n constructor(projectId: string, config?: any) {\n this.projectId = projectId;\n this.config = config || {};\n }\n\n // Lifecycle methods\n abstract connect(): Promise<void>;\n abstract disconnect(): Promise<void>;\n abstract isConnected(): boolean;\n abstract ping(): Promise<boolean>;\n\n // Schema management\n abstract initializeSchema(): Promise<void>;\n abstract migrateSchema(targetVersion: number): Promise<void>;\n abstract getSchemaVersion(): Promise<number>;\n\n // Frame operations\n abstract createFrame(frame: Partial<Frame>): Promise<string>;\n abstract getFrame(frameId: string): Promise<Frame | null>;\n abstract updateFrame(frameId: string, updates: Partial<Frame>): Promise<void>;\n abstract deleteFrame(frameId: string): Promise<void>;\n abstract getActiveFrames(runId?: string): Promise<Frame[]>;\n abstract closeFrame(frameId: string, outputs?: any): Promise<void>;\n\n // Event operations\n abstract createEvent(event: Partial<Event>): Promise<string>;\n abstract getFrameEvents(\n frameId: string,\n options?: QueryOptions\n ): Promise<Event[]>;\n abstract deleteFrameEvents(frameId: string): Promise<void>;\n\n // Anchor operations\n abstract createAnchor(anchor: Partial<Anchor>): Promise<string>;\n abstract getFrameAnchors(frameId: string): Promise<Anchor[]>;\n abstract deleteFrameAnchors(frameId: string): Promise<void>;\n\n // Search operations (enhanced for ParadeDB)\n abstract search(\n options: SearchOptions\n ): Promise<Array<Frame & { score: number }>>;\n abstract searchByVector(\n embedding: number[],\n options?: QueryOptions\n ): Promise<Array<Frame & { similarity: number }>>;\n abstract searchHybrid(\n textQuery: string,\n embedding: number[],\n weights?: { text: number; vector: number }\n ): Promise<Array<Frame & { score: number }>>;\n\n // Aggregation operations\n abstract aggregate(\n table: string,\n options: AggregationOptions\n ): Promise<Record<string, any>[]>;\n\n // Pattern detection\n abstract detectPatterns(timeRange?: { start: Date; end: Date }): Promise<\n Array<{\n pattern: string;\n type: string;\n frequency: number;\n lastSeen: Date;\n }>\n >;\n\n // Bulk operations\n abstract executeBulk(operations: BulkOperation[]): Promise<void>;\n abstract vacuum(): Promise<void>;\n abstract analyze(): Promise<void>;\n\n // Statistics\n abstract getStats(): Promise<DatabaseStats>;\n abstract getQueryStats(): Promise<\n Array<{\n query: string;\n calls: number;\n meanTime: number;\n totalTime: number;\n }>\n >;\n\n // Transaction support\n abstract beginTransaction(): Promise<void>;\n abstract commitTransaction(): Promise<void>;\n abstract rollbackTransaction(): Promise<void>;\n abstract inTransaction(\n callback: (adapter: DatabaseAdapter) => Promise<void>\n ): Promise<void>;\n\n // Export/Import for migration\n abstract exportData(\n tables: string[],\n format: 'json' | 'parquet' | 'csv'\n ): Promise<Buffer>;\n abstract importData(\n data: Buffer,\n format: 'json' | 'parquet' | 'csv',\n options?: { truncate?: boolean; upsert?: boolean }\n ): Promise<void>;\n\n // Utility methods\n protected generateId(): string {\n return crypto.randomUUID();\n }\n\n protected sanitizeQuery(query: string): string {\n // DEPRECATED: Use parameterized queries instead\n // This method is kept for legacy compatibility but should not be used\n console.warn(\n 'sanitizeQuery() is deprecated and unsafe - use parameterized queries'\n );\n return query.replace(/[;'\"\\\\]/g, '');\n }\n\n protected buildWhereClause(conditions: Record<string, any>): string {\n const clauses = Object.entries(conditions).map(([key, value]) => {\n if (value === null) {\n return `${key} IS NULL`;\n } else if (Array.isArray(value)) {\n return `${key} IN (${value.map(() => '?').join(',')})`;\n } else {\n return `${key} = ?`;\n }\n });\n return clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';\n }\n\n protected buildOrderByClause(\n orderBy?: string,\n direction?: 'ASC' | 'DESC'\n ): string {\n if (!orderBy) return '';\n // Whitelist validation: allow letters, numbers, underscore, dot (for table aliasing)\n const isSafe = /^[a-zA-Z0-9_.]+$/.test(orderBy);\n if (!isSafe) {\n // Drop ORDER BY if unsafe to prevent injection via column name\n return '';\n }\n const dir = direction === 'DESC' ? 'DESC' : 'ASC';\n return ` ORDER BY ${orderBy} ${dir}`;\n }\n\n protected buildLimitClause(limit?: number, offset?: number): string {\n if (!limit) return '';\n let clause = ` LIMIT ${limit}`;\n if (offset) clause += ` OFFSET ${offset}`;\n return clause;\n }\n}\n\n// Feature flags for gradual migration\nexport interface DatabaseFeatures {\n supportsFullTextSearch: boolean;\n supportsVectorSearch: boolean;\n supportsPartitioning: boolean;\n supportsAnalytics: boolean;\n supportsCompression: boolean;\n supportsMaterializedViews: boolean;\n supportsParallelQueries: boolean;\n}\n\nexport abstract class FeatureAwareDatabaseAdapter extends DatabaseAdapter {\n abstract getFeatures(): DatabaseFeatures;\n\n async canUseFeature(feature: keyof DatabaseFeatures): Promise<boolean> {\n const features = this.getFeatures();\n return features[feature] || false;\n }\n}\n"],
5
- "mappings": ";;;;AAgGO,MAAe,gBAAgB;AAAA,EACjB;AAAA,EACA;AAAA,EAEnB,YAAY,WAAmB,QAAc;AAC3C,SAAK,YAAY;AACjB,SAAK,SAAS,UAAU,CAAC;AAAA,EAC3B;AAAA;AAAA,EAoGU,aAAqB;AAC7B,WAAO,OAAO,WAAW;AAAA,EAC3B;AAAA,EAEU,cAAc,OAAuB;AAG7C,YAAQ;AAAA,MACN;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,YAAY,EAAE;AAAA,EACrC;AAAA,EAEU,iBAAiB,YAAyC;AAClE,UAAM,UAAU,OAAO,QAAQ,UAAU,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAC/D,UAAI,UAAU,MAAM;AAClB,eAAO,GAAG,GAAG;AAAA,MACf,WAAW,MAAM,QAAQ,KAAK,GAAG;AAC/B,eAAO,GAAG,GAAG,QAAQ,MAAM,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,MACrD,OAAO;AACL,eAAO,GAAG,GAAG;AAAA,MACf;AAAA,IACF,CAAC;AACD,WAAO,QAAQ,SAAS,IAAI,SAAS,QAAQ,KAAK,OAAO,CAAC,KAAK;AAAA,EACjE;AAAA,EAEU,mBACR,SACA,WACQ;AACR,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,SAAS,mBAAmB,KAAK,OAAO;AAC9C,QAAI,CAAC,QAAQ;AAEX,aAAO;AAAA,IACT;AACA,UAAM,MAAM,cAAc,SAAS,SAAS;AAC5C,WAAO,aAAa,OAAO,IAAI,GAAG;AAAA,EACpC;AAAA,EAEU,iBAAiB,OAAgB,QAAyB;AAClE,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,SAAS,UAAU,KAAK;AAC5B,QAAI,OAAQ,WAAU,WAAW,MAAM;AACvC,WAAO;AAAA,EACT;AACF;AAaO,MAAe,oCAAoC,gBAAgB;AAAA,EAGxE,MAAM,cAAc,SAAmD;AACrE,UAAM,WAAW,KAAK,YAAY;AAClC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AACF;",
4
+ "sourcesContent": ["/**\n * Database Adapter Interface\n * Provides abstraction layer for different database implementations\n * Supports SQLite (current) and ParadeDB (new) with seamless migration\n */\n\nimport type { Frame, Event, Anchor } from '../context/index.js';\nimport type { EmbeddingProvider } from './embedding-provider.js';\n\nexport interface QueryOptions {\n limit?: number;\n offset?: number;\n orderBy?: string;\n orderDirection?: 'ASC' | 'DESC';\n timeout?: number;\n}\n\nexport interface SearchOptions extends QueryOptions {\n query: string;\n searchType?: 'text' | 'vector' | 'hybrid';\n scoreThreshold?: number;\n fields?: string[];\n boost?: Record<string, number>;\n}\n\nexport interface AggregationOptions {\n groupBy: string[];\n metrics: Array<{\n field: string;\n operation: 'count' | 'sum' | 'avg' | 'min' | 'max';\n alias?: string;\n }>;\n having?: Record<string, any>;\n}\n\nexport interface BulkOperation {\n type: 'insert' | 'update' | 'delete';\n table: string;\n data?: any;\n where?: Record<string, any>;\n}\n\nexport interface DatabaseStats {\n totalFrames: number;\n activeFrames: number;\n totalEvents: number;\n totalAnchors: number;\n diskUsage: number;\n lastVacuum?: Date;\n}\n\n// Database result type interfaces\nexport interface CountResult {\n count: number;\n}\n\nexport interface VersionResult {\n version: number;\n}\n\nexport interface FrameRow {\n frame_id: string;\n parent_frame_id?: string;\n project_id: string;\n run_id: string;\n type: string;\n name: string;\n state: string;\n depth: number;\n inputs: string;\n outputs: string;\n digest_text: string;\n digest_json: string;\n created_at: number;\n closed_at?: number;\n score?: number;\n}\n\nexport interface EventRow {\n event_id: string;\n frame_id: string;\n seq: number;\n type: string;\n text: string;\n metadata: string;\n}\n\nexport interface AnchorRow {\n anchor_id: string;\n frame_id: string;\n type: string;\n text: string;\n priority: number;\n created_at: number;\n metadata: string;\n}\n\nexport abstract class DatabaseAdapter {\n protected readonly projectId: string;\n protected readonly config: any;\n\n constructor(projectId: string, config?: any) {\n this.projectId = projectId;\n this.config = config || {};\n }\n\n // Lifecycle methods\n abstract connect(): Promise<void>;\n abstract disconnect(): Promise<void>;\n abstract isConnected(): boolean;\n abstract ping(): Promise<boolean>;\n\n // Schema management\n abstract initializeSchema(): Promise<void>;\n abstract migrateSchema(targetVersion: number): Promise<void>;\n abstract getSchemaVersion(): Promise<number>;\n\n // Frame operations\n abstract createFrame(frame: Partial<Frame>): Promise<string>;\n abstract getFrame(frameId: string): Promise<Frame | null>;\n abstract updateFrame(frameId: string, updates: Partial<Frame>): Promise<void>;\n abstract deleteFrame(frameId: string): Promise<void>;\n abstract getActiveFrames(runId?: string): Promise<Frame[]>;\n abstract closeFrame(frameId: string, outputs?: any): Promise<void>;\n\n // Event operations\n abstract createEvent(event: Partial<Event>): Promise<string>;\n abstract getFrameEvents(\n frameId: string,\n options?: QueryOptions\n ): Promise<Event[]>;\n abstract deleteFrameEvents(frameId: string): Promise<void>;\n\n // Anchor operations\n abstract createAnchor(anchor: Partial<Anchor>): Promise<string>;\n abstract getFrameAnchors(frameId: string): Promise<Anchor[]>;\n abstract deleteFrameAnchors(frameId: string): Promise<void>;\n\n // Search operations (enhanced for ParadeDB)\n abstract search(\n options: SearchOptions\n ): Promise<Array<Frame & { score: number }>>;\n abstract searchByVector(\n embedding: number[],\n options?: QueryOptions\n ): Promise<Array<Frame & { similarity: number }>>;\n abstract searchHybrid(\n textQuery: string,\n embedding: number[],\n weights?: { text: number; vector: number }\n ): Promise<Array<Frame & { score: number }>>;\n\n // Aggregation operations\n abstract aggregate(\n table: string,\n options: AggregationOptions\n ): Promise<Record<string, any>[]>;\n\n // Pattern detection\n abstract detectPatterns(timeRange?: { start: Date; end: Date }): Promise<\n Array<{\n pattern: string;\n type: string;\n frequency: number;\n lastSeen: Date;\n }>\n >;\n\n // Bulk operations\n abstract executeBulk(operations: BulkOperation[]): Promise<void>;\n abstract vacuum(): Promise<void>;\n abstract analyze(): Promise<void>;\n\n // Statistics\n abstract getStats(): Promise<DatabaseStats>;\n abstract getQueryStats(): Promise<\n Array<{\n query: string;\n calls: number;\n meanTime: number;\n totalTime: number;\n }>\n >;\n\n // Transaction support\n abstract beginTransaction(): Promise<void>;\n abstract commitTransaction(): Promise<void>;\n abstract rollbackTransaction(): Promise<void>;\n abstract inTransaction(\n callback: (adapter: DatabaseAdapter) => Promise<void>\n ): Promise<void>;\n\n // Export/Import for migration\n abstract exportData(\n tables: string[],\n format: 'json' | 'parquet' | 'csv'\n ): Promise<Buffer>;\n abstract importData(\n data: Buffer,\n format: 'json' | 'parquet' | 'csv',\n options?: { truncate?: boolean; upsert?: boolean }\n ): Promise<void>;\n\n /** Returns the configured embedding provider, if any */\n getEmbeddingProvider(): EmbeddingProvider | undefined {\n return undefined;\n }\n\n // Utility methods\n protected generateId(): string {\n return crypto.randomUUID();\n }\n\n protected sanitizeQuery(query: string): string {\n // DEPRECATED: Use parameterized queries instead\n // This method is kept for legacy compatibility but should not be used\n console.warn(\n 'sanitizeQuery() is deprecated and unsafe - use parameterized queries'\n );\n return query.replace(/[;'\"\\\\]/g, '');\n }\n\n protected buildWhereClause(conditions: Record<string, any>): string {\n const clauses = Object.entries(conditions).map(([key, value]) => {\n if (value === null) {\n return `${key} IS NULL`;\n } else if (Array.isArray(value)) {\n return `${key} IN (${value.map(() => '?').join(',')})`;\n } else {\n return `${key} = ?`;\n }\n });\n return clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';\n }\n\n protected buildOrderByClause(\n orderBy?: string,\n direction?: 'ASC' | 'DESC'\n ): string {\n if (!orderBy) return '';\n // Whitelist validation: allow letters, numbers, underscore, dot (for table aliasing)\n const isSafe = /^[a-zA-Z0-9_.]+$/.test(orderBy);\n if (!isSafe) {\n // Drop ORDER BY if unsafe to prevent injection via column name\n return '';\n }\n const dir = direction === 'DESC' ? 'DESC' : 'ASC';\n return ` ORDER BY ${orderBy} ${dir}`;\n }\n\n protected buildLimitClause(limit?: number, offset?: number): string {\n if (!limit) return '';\n let clause = ` LIMIT ${limit}`;\n if (offset) clause += ` OFFSET ${offset}`;\n return clause;\n }\n}\n\n// Feature flags for gradual migration\nexport interface DatabaseFeatures {\n supportsFullTextSearch: boolean;\n supportsVectorSearch: boolean;\n supportsPartitioning: boolean;\n supportsAnalytics: boolean;\n supportsCompression: boolean;\n supportsMaterializedViews: boolean;\n supportsParallelQueries: boolean;\n}\n\nexport abstract class FeatureAwareDatabaseAdapter extends DatabaseAdapter {\n abstract getFeatures(): DatabaseFeatures;\n\n async canUseFeature(feature: keyof DatabaseFeatures): Promise<boolean> {\n const features = this.getFeatures();\n return features[feature] || false;\n }\n}\n"],
5
+ "mappings": ";;;;AAiGO,MAAe,gBAAgB;AAAA,EACjB;AAAA,EACA;AAAA,EAEnB,YAAY,WAAmB,QAAc;AAC3C,SAAK,YAAY;AACjB,SAAK,SAAS,UAAU,CAAC;AAAA,EAC3B;AAAA;AAAA,EAoGA,uBAAsD;AACpD,WAAO;AAAA,EACT;AAAA;AAAA,EAGU,aAAqB;AAC7B,WAAO,OAAO,WAAW;AAAA,EAC3B;AAAA,EAEU,cAAc,OAAuB;AAG7C,YAAQ;AAAA,MACN;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,YAAY,EAAE;AAAA,EACrC;AAAA,EAEU,iBAAiB,YAAyC;AAClE,UAAM,UAAU,OAAO,QAAQ,UAAU,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAC/D,UAAI,UAAU,MAAM;AAClB,eAAO,GAAG,GAAG;AAAA,MACf,WAAW,MAAM,QAAQ,KAAK,GAAG;AAC/B,eAAO,GAAG,GAAG,QAAQ,MAAM,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,MACrD,OAAO;AACL,eAAO,GAAG,GAAG;AAAA,MACf;AAAA,IACF,CAAC;AACD,WAAO,QAAQ,SAAS,IAAI,SAAS,QAAQ,KAAK,OAAO,CAAC,KAAK;AAAA,EACjE;AAAA,EAEU,mBACR,SACA,WACQ;AACR,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,SAAS,mBAAmB,KAAK,OAAO;AAC9C,QAAI,CAAC,QAAQ;AAEX,aAAO;AAAA,IACT;AACA,UAAM,MAAM,cAAc,SAAS,SAAS;AAC5C,WAAO,aAAa,OAAO,IAAI,GAAG;AAAA,EACpC;AAAA,EAEU,iBAAiB,OAAgB,QAAyB;AAClE,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,SAAS,UAAU,KAAK;AAC5B,QAAI,OAAQ,WAAU,WAAW,MAAM;AACvC,WAAO;AAAA,EACT;AACF;AAaO,MAAe,oCAAoC,gBAAgB;AAAA,EAGxE,MAAM,cAAc,SAAmD;AACrE,UAAM,WAAW,KAAK,YAAY;AAClC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AACF;",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,17 @@
1
+ import { fileURLToPath as __fileURLToPath } from 'url';
2
+ import { dirname as __pathDirname } from 'path';
3
+ const __filename = __fileURLToPath(import.meta.url);
4
+ const __dirname = __pathDirname(__filename);
5
+ class NoOpEmbeddingProvider {
6
+ dimension = 0;
7
+ async embed(_text) {
8
+ return [];
9
+ }
10
+ async embedBatch(_texts) {
11
+ return [];
12
+ }
13
+ }
14
+ export {
15
+ NoOpEmbeddingProvider
16
+ };
17
+ //# sourceMappingURL=embedding-provider.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../src/core/database/embedding-provider.ts"],
4
+ "sourcesContent": ["/**\n * Embedding Provider Interface\n * Abstraction for generating vector embeddings from text\n */\n\nexport interface EmbeddingProvider {\n /** Generate embedding for a single text */\n embed(text: string): Promise<number[]>;\n /** Generate embeddings for multiple texts */\n embedBatch(texts: string[]): Promise<number[][]>;\n /** Dimensionality of the embedding vectors */\n dimension: number;\n}\n\n/**\n * No-op provider that disables vector search.\n * Used as default when no real provider is configured.\n */\nexport class NoOpEmbeddingProvider implements EmbeddingProvider {\n readonly dimension = 0;\n\n async embed(_text: string): Promise<number[]> {\n return [];\n }\n\n async embedBatch(_texts: string[]): Promise<number[][]> {\n return [];\n }\n}\n"],
5
+ "mappings": ";;;;AAkBO,MAAM,sBAAmD;AAAA,EACrD,YAAY;AAAA,EAErB,MAAM,MAAM,OAAkC;AAC5C,WAAO,CAAC;AAAA,EACV;AAAA,EAEA,MAAM,WAAW,QAAuC;AACtD,WAAO,CAAC;AAAA,EACV;AACF;",
6
+ "names": []
7
+ }
@@ -14,15 +14,23 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
14
14
  db = null;
15
15
  dbPath;
16
16
  inTransactionFlag = false;
17
+ ftsEnabled = false;
18
+ vecEnabled = false;
19
+ embeddingProvider;
20
+ embeddingDimension;
17
21
  constructor(projectId, config) {
18
22
  super(projectId, config);
19
23
  this.dbPath = config.dbPath;
24
+ this.embeddingProvider = config.embeddingProvider;
25
+ this.embeddingDimension = config.embeddingDimension || 384;
26
+ }
27
+ getEmbeddingProvider() {
28
+ return this.embeddingProvider;
20
29
  }
21
30
  getFeatures() {
22
31
  return {
23
- supportsFullTextSearch: false,
24
- // Could enable with FTS5
25
- supportsVectorSearch: false,
32
+ supportsFullTextSearch: this.ftsEnabled,
33
+ supportsVectorSearch: this.vecEnabled,
26
34
  supportsPartitioning: false,
27
35
  supportsAnalytics: false,
28
36
  supportsCompression: false,
@@ -149,6 +157,8 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
149
157
  } catch (e) {
150
158
  logger.warn("Failed to ensure cascade constraints", e);
151
159
  }
160
+ this.initializeFts();
161
+ this.initializeVec();
152
162
  }
153
163
  /**
154
164
  * Ensure ON DELETE CASCADE exists for events/anchors referencing frames
@@ -208,6 +218,115 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
208
218
  if (needsCascade("events")) migrateTable("events");
209
219
  if (needsCascade("anchors")) migrateTable("anchors");
210
220
  }
221
+ /**
222
+ * Initialize FTS5 virtual table and sync triggers
223
+ */
224
+ initializeFts() {
225
+ if (!this.db) return;
226
+ try {
227
+ this.db.exec(`
228
+ CREATE VIRTUAL TABLE IF NOT EXISTS frames_fts USING fts5(
229
+ name, digest_text, inputs, outputs,
230
+ content='frames', content_rowid='rowid'
231
+ );
232
+ `);
233
+ this.db.exec(`
234
+ CREATE TRIGGER IF NOT EXISTS frames_ai AFTER INSERT ON frames BEGIN
235
+ INSERT INTO frames_fts(rowid, name, digest_text, inputs, outputs)
236
+ VALUES (new.rowid, new.name, new.digest_text, new.inputs, new.outputs);
237
+ END;
238
+ `);
239
+ this.db.exec(`
240
+ CREATE TRIGGER IF NOT EXISTS frames_ad AFTER DELETE ON frames BEGIN
241
+ INSERT INTO frames_fts(frames_fts, rowid, name, digest_text, inputs, outputs)
242
+ VALUES ('delete', old.rowid, old.name, old.digest_text, old.inputs, old.outputs);
243
+ END;
244
+ `);
245
+ this.db.exec(`
246
+ CREATE TRIGGER IF NOT EXISTS frames_au AFTER UPDATE ON frames BEGIN
247
+ INSERT INTO frames_fts(frames_fts, rowid, name, digest_text, inputs, outputs)
248
+ VALUES ('delete', old.rowid, old.name, old.digest_text, old.inputs, old.outputs);
249
+ INSERT INTO frames_fts(rowid, name, digest_text, inputs, outputs)
250
+ VALUES (new.rowid, new.name, new.digest_text, new.inputs, new.outputs);
251
+ END;
252
+ `);
253
+ this.migrateToFts();
254
+ this.ftsEnabled = true;
255
+ logger.info("FTS5 full-text search initialized");
256
+ } catch (e) {
257
+ logger.warn(
258
+ "FTS5 initialization failed, falling back to LIKE search",
259
+ e
260
+ );
261
+ this.ftsEnabled = false;
262
+ }
263
+ }
264
+ /**
265
+ * One-time migration: populate FTS index from existing frames data
266
+ */
267
+ migrateToFts() {
268
+ if (!this.db) return;
269
+ const version = this.db.prepare("SELECT MAX(version) as version FROM schema_version").get()?.version || 1;
270
+ if (version < 2) {
271
+ this.db.exec(`
272
+ INSERT OR IGNORE INTO frames_fts(rowid, name, digest_text, inputs, outputs)
273
+ SELECT rowid, name, digest_text, inputs, outputs FROM frames;
274
+ `);
275
+ this.db.prepare("INSERT OR REPLACE INTO schema_version (version) VALUES (?)").run(2);
276
+ logger.info(
277
+ "FTS5 index populated from existing frames (migration v1\u2192v2)"
278
+ );
279
+ }
280
+ }
281
+ /**
282
+ * Initialize sqlite-vec for vector search
283
+ */
284
+ initializeVec() {
285
+ if (!this.db || !this.embeddingProvider) return;
286
+ try {
287
+ let sqliteVec;
288
+ try {
289
+ sqliteVec = require("sqlite-vec");
290
+ } catch {
291
+ logger.info("sqlite-vec not installed, vector search disabled");
292
+ return;
293
+ }
294
+ sqliteVec.load(this.db);
295
+ this.db.exec(`
296
+ CREATE VIRTUAL TABLE IF NOT EXISTS frame_embeddings USING vec0(
297
+ frame_id TEXT PRIMARY KEY,
298
+ embedding float[${this.embeddingDimension}]
299
+ );
300
+ `);
301
+ this.vecEnabled = true;
302
+ logger.info("sqlite-vec vector search initialized", {
303
+ dimension: this.embeddingDimension
304
+ });
305
+ } catch (e) {
306
+ logger.warn(
307
+ "sqlite-vec initialization failed, vector search disabled",
308
+ e
309
+ );
310
+ this.vecEnabled = false;
311
+ }
312
+ }
313
+ /**
314
+ * Rebuild the FTS5 index (for maintenance)
315
+ */
316
+ async rebuildFtsIndex() {
317
+ if (!this.db) {
318
+ throw new DatabaseError(
319
+ "Database not connected",
320
+ ErrorCode.DB_CONNECTION_FAILED
321
+ );
322
+ }
323
+ if (!this.ftsEnabled) {
324
+ logger.warn("FTS not enabled, skipping rebuild");
325
+ return;
326
+ }
327
+ this.db.exec("INSERT INTO frames_fts(frames_fts) VALUES('rebuild')");
328
+ logger.info("FTS5 index rebuilt");
329
+ }
211
330
  async migrateSchema(targetVersion) {
212
331
  if (!this.db)
213
332
  throw new DatabaseError(
@@ -462,16 +581,63 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
462
581
  );
463
582
  this.db.prepare("DELETE FROM anchors WHERE frame_id = ?").run(frameId);
464
583
  }
465
- // Limited search (basic LIKE queries)
584
+ // Full-text search with FTS5 + BM25 ranking (fallback to LIKE)
466
585
  async search(options) {
467
586
  if (!this.db)
468
587
  throw new DatabaseError(
469
588
  "Database not connected",
470
589
  ErrorCode.DB_CONNECTION_FAILED
471
590
  );
591
+ if (this.ftsEnabled) {
592
+ try {
593
+ return this.searchFts(options);
594
+ } catch (e) {
595
+ logger.debug("FTS search failed, falling back to LIKE", {
596
+ error: e instanceof Error ? e.message : String(e),
597
+ query: options.query
598
+ });
599
+ }
600
+ }
601
+ return this.searchLike(options);
602
+ }
603
+ /**
604
+ * FTS5 MATCH search with BM25 ranking
605
+ */
606
+ searchFts(options) {
607
+ const boost = options.boost || {};
608
+ const w0 = boost["name"] || 10;
609
+ const w1 = boost["digest_text"] || 5;
610
+ const w2 = boost["inputs"] || 2;
611
+ const w3 = boost["outputs"] || 1;
612
+ const sql = `
613
+ SELECT f.*, -bm25(frames_fts, ${w0}, ${w1}, ${w2}, ${w3}) as score
614
+ FROM frames_fts fts
615
+ JOIN frames f ON f.rowid = fts.rowid
616
+ WHERE frames_fts MATCH ?
617
+ ORDER BY score DESC
618
+ LIMIT ? OFFSET ?
619
+ `;
620
+ const limit = options.limit || 50;
621
+ const offset = options.offset || 0;
622
+ const rows = this.db.prepare(sql).all(
623
+ options.query,
624
+ limit,
625
+ offset
626
+ );
627
+ return rows.map((row) => ({
628
+ ...row,
629
+ inputs: JSON.parse(row.inputs || "{}"),
630
+ outputs: JSON.parse(row.outputs || "{}"),
631
+ digest_json: JSON.parse(row.digest_json || "{}")
632
+ }));
633
+ }
634
+ /**
635
+ * Fallback LIKE search for when FTS is unavailable
636
+ */
637
+ searchLike(options) {
472
638
  const sql = `
473
- SELECT *,
474
- CASE
639
+ SELECT *,
640
+ CASE
475
641
  WHEN name LIKE ? THEN 1.0
476
642
  WHEN digest_text LIKE ? THEN 0.8
477
643
  WHEN inputs LIKE ? THEN 0.6
@@ -498,12 +664,95 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
498
664
  digest_json: JSON.parse(row.digest_json || "{}")
499
665
  }));
500
666
  }
501
- async searchByVector(_embedding, _options) {
502
- logger.warn("Vector search not supported in SQLite adapter");
503
- return [];
667
+ async searchByVector(embedding, options) {
668
+ if (!this.db)
669
+ throw new DatabaseError(
670
+ "Database not connected",
671
+ ErrorCode.DB_CONNECTION_FAILED
672
+ );
673
+ if (!this.vecEnabled) {
674
+ logger.warn("Vector search not available (sqlite-vec not loaded)");
675
+ return [];
676
+ }
677
+ const limit = options?.limit || 20;
678
+ const sql = `
679
+ SELECT f.*, ve.distance as similarity
680
+ FROM frame_embeddings ve
681
+ JOIN frames f ON f.frame_id = ve.frame_id
682
+ WHERE ve.embedding MATCH ?
683
+ ORDER BY ve.distance
684
+ LIMIT ?
685
+ `;
686
+ const rows = this.db.prepare(sql).all(JSON.stringify(embedding), limit);
687
+ return rows.map((row) => ({
688
+ ...row,
689
+ inputs: JSON.parse(row.inputs || "{}"),
690
+ outputs: JSON.parse(row.outputs || "{}"),
691
+ digest_json: JSON.parse(row.digest_json || "{}")
692
+ }));
693
+ }
694
+ async searchHybrid(textQuery, embedding, weights) {
695
+ const textWeight = weights?.text ?? 0.6;
696
+ const vecWeight = weights?.vector ?? 0.4;
697
+ const textResults = await this.search({ query: textQuery, limit: 50 });
698
+ const vecResults = this.vecEnabled ? await this.searchByVector(embedding, { limit: 50 }) : [];
699
+ if (vecResults.length === 0) {
700
+ return textResults;
701
+ }
702
+ const scoreMap = /* @__PURE__ */ new Map();
703
+ const maxText = Math.max(...textResults.map((r) => r.score), 1);
704
+ for (const r of textResults) {
705
+ const normalizedScore = r.score / maxText * textWeight;
706
+ scoreMap.set(r.frame_id, { frame: r, score: normalizedScore });
707
+ }
708
+ const maxDist = Math.max(...vecResults.map((r) => r.similarity), 1);
709
+ for (const r of vecResults) {
710
+ const normalizedScore = (1 - r.similarity / maxDist) * vecWeight;
711
+ const existing = scoreMap.get(r.frame_id);
712
+ if (existing) {
713
+ existing.score += normalizedScore;
714
+ } else {
715
+ scoreMap.set(r.frame_id, { frame: r, score: normalizedScore });
716
+ }
717
+ }
718
+ return Array.from(scoreMap.values()).sort((a, b) => b.score - a.score).map(({ frame, score }) => ({ ...frame, score }));
504
719
  }
505
- async searchHybrid(textQuery, _embedding, weights) {
506
- return this.search({ query: textQuery, ...weights });
720
+ /**
721
+ * Store an embedding for a frame
722
+ */
723
+ async storeEmbedding(frameId, embedding) {
724
+ if (!this.db)
725
+ throw new DatabaseError(
726
+ "Database not connected",
727
+ ErrorCode.DB_CONNECTION_FAILED
728
+ );
729
+ if (!this.vecEnabled) return;
730
+ this.db.prepare(
731
+ "INSERT OR REPLACE INTO frame_embeddings (frame_id, embedding) VALUES (?, ?)"
732
+ ).run(frameId, JSON.stringify(embedding));
733
+ }
734
+ /**
735
+ * Get frames that are missing embeddings
736
+ */
737
+ async getFramesMissingEmbeddings(limit = 50) {
738
+ if (!this.db)
739
+ throw new DatabaseError(
740
+ "Database not connected",
741
+ ErrorCode.DB_CONNECTION_FAILED
742
+ );
743
+ const sql = `
744
+ SELECT f.* FROM frames f
745
+ LEFT JOIN frame_embeddings ve ON f.frame_id = ve.frame_id
746
+ WHERE ve.frame_id IS NULL
747
+ LIMIT ?
748
+ `;
749
+ const rows = this.db.prepare(sql).all(limit);
750
+ return rows.map((row) => ({
751
+ ...row,
752
+ inputs: JSON.parse(row.inputs || "{}"),
753
+ outputs: JSON.parse(row.outputs || "{}"),
754
+ digest_json: JSON.parse(row.digest_json || "{}")
755
+ }));
507
756
  }
508
757
  // Basic aggregation
509
758
  async aggregate(table, options) {