@winspan/claude-forge 8.41.0 → 8.50.6

package/dist/core/storage/sqlite.js

@@ -1,812 +1,155 @@
 /**
- * Simplified SQLite storage for minimal Forge
- * No repository pattern, no base class — just direct SQL in one file
+ * SQLiteStorage — 装配入口（facade）
+ *
+ * 历史上这是一个 1000+ 行的单文件实现。重构后职责拆分到独立的 *Operations 类，
+ * 此文件保留为：
+ *   - 组合 db 实例 + 各个 Operations
+ *   - 保持原有 API 完全向后兼容（方法签名 / EventEmitter 行为 / 类型 re-export）
+ *
+ * 职责矩阵：
+ *   base.ts          — 数据库连接、schema、迁移
+ *   events.ts        — events 表读写
+ *   sessions.ts      — sessions 聚合表
+ *   tasks.ts         — tasks / task_events
+ *   injections.ts    — injections
+ *   routing.ts       — routing_events + experiment_assignments
+ *   skills.ts        — skill_invocations + workflow 聚合
+ *   token-usage.ts   — token_usage
+ *   maintenance.ts   — 清理 / VACUUM
  */
-import Database from 'better-sqlite3';
-import { readFileSync, existsSync, mkdirSync, statSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { fileURLToPath } from 'node:url';
 import { EventEmitter } from 'node:events';
-import { DATABASE } from '../constants.js';
+import { SQLiteBase } from './base.js';
+import { EventOperations } from './events.js';
+import { SessionOperations } from './sessions.js';
+import { TaskOperations } from './tasks.js';
+import { InjectionOperations } from './injections.js';
+import { RoutingOperations } from './routing.js';
+import { SkillOperations } from './skills.js';
+import { TokenUsageOperations } from './token-usage.js';
+import { MaintenanceOperations } from './maintenance.js';
 import { logger } from '../utils/logger.js';
 export class SQLiteStorage extends EventEmitter {
-    db;
-    dbPath;
+    base;
+    events;
+    sessions;
+    tasks;
+    injections;
+    routing;
+    skills;
+    tokenUsage;
+    maintenance;
     constructor(dbPath) {
         super();
-        this.dbPath = dbPath;
-        const dir = dirname(dbPath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        this.db = new Database(dbPath);
-        this.db.pragma('journal_mode = WAL');
-        this.db.pragma('synchronous = NORMAL');
-        this.db.pragma('wal_autocheckpoint = 100');
-        this.db.pragma(`cache_size = ${DATABASE.CACHE_SIZE}`);
-        this.db.pragma(`busy_timeout = ${DATABASE.BUSY_TIMEOUT}`);
-        this.initSchema();
-        this.runMigrations();
-    }
-    initSchema() {
-        const thisDir = dirname(fileURLToPath(import.meta.url));
-        const schemaPath = join(thisDir, 'schema.sql');
-        if (existsSync(schemaPath)) {
-            const schema = readFileSync(schemaPath, 'utf-8');
-            this.db.exec(schema);
-        }
-        else {
-            // Inline fallback — events table only
-            this.db.exec(`
-        CREATE TABLE IF NOT EXISTS events (
-          event_id TEXT PRIMARY KEY, session_id TEXT NOT NULL,
-          project_path TEXT NOT NULL, timestamp TEXT NOT NULL,
-          hook_type TEXT NOT NULL, tool_name TEXT, tool_input TEXT,
-          tool_output TEXT, user_prompt TEXT, ai_response TEXT,
-          distilled INTEGER DEFAULT 0, created_at TEXT DEFAULT (datetime('now'))
-        );
-        CREATE INDEX IF NOT EXISTS idx_events_session ON events(session_id);
-        CREATE INDEX IF NOT EXISTS idx_events_project ON events(project_path);
-        CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp DESC);
-        CREATE INDEX IF NOT EXISTS idx_events_distilled ON events(distilled);
-      `);
-        }
-    }
-    hasColumn(table, column) {
-        try {
-            const rows = this.db.prepare(`PRAGMA table_info(${table})`).all();
-            return rows.some(r => r.name === column);
-        }
-        catch {
-            return false;
-        }
-    }
-    addColumnIfMissing(table, column, definition) {
-        if (!this.hasColumn(table, column)) {
-            try {
-                this.db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${definition}`);
-                logger.info(`[SQLiteStorage] migration: added ${table}.${column}`);
-            }
-            catch (err) {
-                logger.warn(`[SQLiteStorage] migration: ALTER ${table} ADD ${column} failed: ${err}`);
-            }
-        }
-    }
-    /**
-     * Incremental schema migrations. Kept idempotent so daemon restarts are safe.
-     * New columns since the base schema.sql go here.
-     */
-    runMigrations() {
-        // sessions: first_prompt — 避免 querySessions 再对 events 表做 O(sessions × events)
-        // 的相关子查询；新增列后若库里已有 sessions 但无 first_prompt，后续 backfill 会补齐。
-        this.addColumnIfMissing('sessions', 'first_prompt', 'TEXT');
-        // routing_events: skill_confidence / skill_source (Skill 监控字段)
-        this.addColumnIfMissing('routing_events', 'skill_confidence', 'REAL');
-        this.addColumnIfMissing('routing_events', 'skill_source', 'TEXT');
-        // skill_invocations: 工作流追踪字段（v8.38+）
-        // 解析 reason 字段的 "<workflow>/<phase>[:feature-slug]" 格式后落库到独立列。
-        this.addColumnIfMissing('skill_invocations', 'workflow', 'TEXT');
-        this.addColumnIfMissing('skill_invocations', 'phase', 'TEXT');
-        this.addColumnIfMissing('skill_invocations', 'feature_slug', 'TEXT');
-        this.addColumnIfMissing('skill_invocations', 'artifact_path', 'TEXT');
-        // skill_invocations: 工作流字段索引（CREATE INDEX IF NOT EXISTS 天然幂等）
-        try {
-            this.db.exec(`CREATE INDEX IF NOT EXISTS idx_skill_invocations_workflow ON skill_invocations(workflow, phase);
-         CREATE INDEX IF NOT EXISTS idx_skill_invocations_feature ON skill_invocations(feature_slug);`);
-        }
-        catch (err) {
-            logger.warn(`[SQLiteStorage] migration: create skill_invocations workflow indexes failed: ${err}`);
-        }
-        // sessions 聚合表性能索引（幂等）：start_time 用于 querySessions 的 ORDER BY
-        try {
-            this.db.exec('CREATE INDEX IF NOT EXISTS idx_sessions_start_time ON sessions(start_time DESC)');
-        }
-        catch (err) {
-            logger.warn(`[SQLiteStorage] migration: create idx_sessions_start_time failed: ${err}`);
-        }
-        // 一次性回填 sessions 聚合表（仅在 sessions 尚未对齐时触发）
-        this.backfillSessionsIfNeeded();
-    }
-    /**
-     * 将 events 表按 session_id 聚合回填到 sessions 表，仅在 sessions 尚未对齐
-     * （没有任何一行带 first_prompt）时触发。旧库升级场景：引入 sessions 聚合表 +
-     * upsert 写入路径后，历史 events 不会自动同步到 sessions，必须通过一次性回填补齐。
-     *
-     * 幂等策略：检测到已有 first_prompt 非空的聚合行就跳过；避免覆盖已被新写路径
-     * upsert 过的数据。
-     */
-    backfillSessionsIfNeeded() {
-        const eventsExists = this.db
-            .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='events'`)
-            .get();
-        if (!eventsExists)
-            return;
-        const aggRow = this.db
-            .prepare(`SELECT COUNT(*) AS total, COUNT(first_prompt) AS with_prompt FROM sessions`)
-            .get();
-        if (aggRow.with_prompt > 0)
-            return;
-        logger.info('[SQLiteStorage] backfilling sessions aggregate from events...');
-        try {
-            const backfill = this.db.transaction(() => {
-                this.db.exec(`
-          INSERT INTO sessions (
-            session_id, project_path, status, first_prompt,
-            start_time, end_time, last_event_time, event_count
-          )
-          SELECT
-            e.session_id,
-            e.project_path,
-            'active' AS status,
-            (SELECT substr(COALESCE(e2.user_prompt, json_extract(e2.tool_input, '$.user_prompt')), 1, 200)
-             FROM events e2
-             WHERE e2.session_id = e.session_id
-               AND e2.hook_type = 'UserPromptSubmit'
-               AND (e2.user_prompt IS NOT NULL OR json_extract(e2.tool_input, '$.user_prompt') IS NOT NULL)
-             ORDER BY e2.timestamp ASC LIMIT 1) AS first_prompt,
-            MIN(e.timestamp) AS start_time,
-            MAX(e.timestamp) AS end_time,
-            MAX(e.timestamp) AS last_event_time,
-            COUNT(*) AS event_count
-          FROM events e
-          GROUP BY e.session_id, e.project_path
-          ON CONFLICT(session_id) DO UPDATE SET
-            first_prompt = COALESCE(sessions.first_prompt, excluded.first_prompt),
-            end_time = MAX(COALESCE(sessions.end_time, ''), excluded.end_time),
-            last_event_time = MAX(COALESCE(sessions.last_event_time, ''), excluded.last_event_time),
-            event_count = excluded.event_count,
-            updated_at = datetime('now')
-        `);
-            });
-            backfill();
-            const migrated = this.db.prepare('SELECT COUNT(*) AS c FROM sessions').get();
-            logger.info(`[SQLiteStorage] backfilled ${migrated.c} sessions from events`);
-        }
-        catch (err) {
-            logger.warn(`[SQLiteStorage] backfillSessionsIfNeeded failed: ${err}`);
-        }
-    }
-    getDatabase() {
-        return this.db;
-    }
-    getDbPath() {
-        return this.dbPath;
-    }
-    // ── Event Operations ────────────────────────────────────────────────────
-    writeEvent(event) {
-        const eventId = event.event_id || randomUUID();
-        const stmt = this.db.prepare(`
-      INSERT INTO events (event_id, session_id, project_path, timestamp, hook_type,
-                          tool_name, tool_input, tool_output, user_prompt, ai_response, distilled)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0)
-    `);
-        stmt.run(eventId, event.session_id, event.project_path, event.timestamp, event.hook_type, event.tool_name ?? null, event.tool_input ? JSON.stringify(event.tool_input) : null, event.tool_output ? JSON.stringify(event.tool_output) : null, event.user_prompt ?? null, event.ai_response ?? null);
-        // 聚合到 sessions 表。单独 try/catch：一旦聚合失败（比如 schema 升级过程中
-        // 的短暂窗口），也不能影响原事件的持久化，上层已经 commit 过 events 了。
-        try {
-            this.upsertSession(event);
-        }
-        catch (err) {
-            logger.warn(`[SQLiteStorage] upsertSession failed (event still written): ${err}`);
-        }
-        this.emit('event', { ...event, event_id: eventId });
-    }
-    /**
-     * 将事件聚合到 sessions 表，供 querySessions 直接读取，避免对 events 做 O(n²)
-     * 的 GROUP BY + 相关子查询。
-     *
-     * 语义：
-     * - 首次出现 session_id → 插入一行，start/end/last_event_time 都取当前事件时间戳
-     * - 已存在 → event_count += 1，end/last_event_time 取更晚的，first_prompt 只在
-     *   原值为 NULL 时才被 UserPromptSubmit 的前 200 字填充（保留"首条"语义）
-     * - 非 UserPromptSubmit 事件或 user_prompt 为空时 first_prompt 传 NULL，不会
-     *   覆盖已有值
-     */
-    upsertSession(event) {
-        const firstPrompt = event.hook_type === 'UserPromptSubmit' && event.user_prompt
-            ? event.user_prompt.slice(0, 200)
-            : null;
-        const stmt = this.db.prepare(`
-      INSERT INTO sessions (
-        session_id, project_path, status, first_prompt,
-        start_time, end_time, last_event_time, event_count
-      )
-      VALUES (?, ?, 'active', ?, ?, ?, ?, 1)
-      ON CONFLICT(session_id) DO UPDATE SET
-        end_time = CASE
-          WHEN excluded.end_time > COALESCE(sessions.end_time, '') THEN excluded.end_time
-          ELSE sessions.end_time
-        END,
-        last_event_time = CASE
-          WHEN excluded.last_event_time > COALESCE(sessions.last_event_time, '') THEN excluded.last_event_time
-          ELSE sessions.last_event_time
-        END,
-        event_count = COALESCE(sessions.event_count, 0) + 1,
-        first_prompt = COALESCE(sessions.first_prompt, excluded.first_prompt),
-        updated_at = datetime('now')
-    `);
-        stmt.run(event.session_id, event.project_path, firstPrompt, event.timestamp, event.timestamp, event.timestamp);
-    }
-    writeToolEvent(event) {
-        const stmt = this.db.prepare(`
-      INSERT INTO v2_tool_events (session_id, route_request_id, tool, args, result, success, error, timestamp)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-    `);
-        const info = stmt.run(event.session_id, event.route_request_id ?? null, event.tool, JSON.stringify(event.args), event.result ? JSON.stringify(event.result) : null, event.success ? 1 : 0, event.error ?? null, event.timestamp);
-        const id = Number(info.lastInsertRowid);
-        this.emit('tool-event', {
-            ...event,
-            id,
-        });
-        return id;
-    }
-    writeDecision(decision) {
-        const stmt = this.db.prepare(`
-      INSERT INTO v2_decisions (session_id, event_id, rule_id, level, reason, suggestion, user_choice, timestamp)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-    `);
-        const info = stmt.run(decision.session_id, decision.event_id, decision.rule_id ?? null, decision.level, decision.reason ?? null, decision.suggestion ?? null, decision.user_choice ?? null, decision.timestamp);
-        const id = Number(info.lastInsertRowid);
-        this.emit('decision', {
-            id,
-            ...decision,
-        });
-        return id;
-    }
+        this.base = new SQLiteBase(dbPath);
+        const db = this.base.getDatabase();
+        this.sessions = new SessionOperations(db);
+        this.events = new EventOperations(db, this);
+        this.tasks = new TaskOperations(db);
+        this.injections = new InjectionOperations(db);
+        this.routing = new RoutingOperations(db);
+        this.skills = new SkillOperations(db);
+        this.tokenUsage = new TokenUsageOperations(db);
+        this.maintenance = new MaintenanceOperations(db, dbPath);
+    }
+    // ── Database accessors ─────────────────────────────────────────────────
+    getDatabase() { return this.base.getDatabase(); }
+    getDbPath() { return this.base.getDbPath(); }
+    // ── Event operations ────────────────────────────────────────────────────
+    writeEvent(event) { this.events.writeEvent(event); }
     queryEvents(filter) {
-        const conditions = [];
-        const params = [];
-        if (filter.session_id) {
-            conditions.push('session_id = ?');
-            params.push(filter.session_id);
-        }
-        if (filter.project_path) {
-            conditions.push('project_path = ?');
-            params.push(filter.project_path);
-        }
-        if (filter.hook_type) {
-            conditions.push('hook_type = ?');
-            params.push(filter.hook_type);
-        }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const limit = filter.limit ?? 1000;
-        const sql = `SELECT * FROM events ${where} ORDER BY timestamp DESC LIMIT ${limit}`;
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map((row) => this.rowToEvent(row));
-    }
-    countEvents(filter) {
-        if (filter.distilled !== undefined) {
-            const sql = 'SELECT COUNT(*) as count FROM events WHERE distilled = ?';
-            const result = this.db.prepare(sql).get(filter.distilled ? 1 : 0);
-            return result.count;
-        }
-        const result = this.db.prepare('SELECT COUNT(*) as count FROM events').get();
-        return result.count;
-    }
-    getUndistilledEvents(sessionId, projectPath) {
-        const sql = `
-      SELECT * FROM events
-      WHERE session_id = ? AND project_path = ? AND distilled = 0
-      ORDER BY timestamp ASC
-    `;
-        const rows = this.db.prepare(sql).all(sessionId, projectPath);
-        return rows.map((row) => this.rowToEvent(row));
+        return this.events.queryEvents(filter);
     }
-    markEventsDistilled(eventIds) {
-        if (eventIds.length === 0)
-            return;
-        const placeholders = eventIds.map(() => '?').join(',');
-        const sql = `UPDATE events SET distilled = 1 WHERE event_id IN (${placeholders})`;
-        this.db.prepare(sql).run(...eventIds);
+    countEvents(filter) { return this.events.countEvents(filter); }
+    searchEvents(filter) {
+        return this.events.searchEvents(filter);
     }
-    // ── Session Operations ─────────────────────────────────────────────────
+    // ── Session operations ─────────────────────────────────────────────────
+    upsertSession(event) { this.sessions.upsertSession(event); }
     querySessions(filter = {}) {
-        const conditions = [];
-        const params = [];
-        if (filter.project_path) {
-            conditions.push('project_path = ?');
-            params.push(filter.project_path);
-        }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const limit = filter.limit ?? 10;
-        // 直接读 sessions 聚合表 → O(sessions)。writeEvent 的 upsertSession 路径保证
-        // 每次事件写入都会同步更新此表；旧库在 runMigrations 里由 backfillSessionsIfNeeded
-        // 一次性回填，确保历史 session 也可见。
-        const sql = `
-      SELECT
-        session_id,
-        first_prompt,
-        event_count,
-        start_time,
-        COALESCE(end_time, last_event_time, start_time) AS end_time
-      FROM sessions
-      ${where}
-      ORDER BY start_time DESC
-      LIMIT ${limit}
-    `;
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(r => ({
-            session_id: r.session_id,
-            first_prompt: r.first_prompt || '',
-            event_count: r.event_count ?? 0,
-            start_time: r.start_time,
-            end_time: r.end_time,
-        }));
-    }
-    // ── Injection Operations ───────────────────────────────────────────────
-    writeInjection(injection) {
-        const id = injection.id || randomUUID();
-        const stmt = this.db.prepare(`
-      INSERT INTO injections (id, event_id, session_id, timestamp, source_handler, injection_type, content)
-      VALUES (?, ?, ?, ?, ?, ?, ?)
-    `);
-        stmt.run(id, injection.event_id ?? null, injection.session_id, injection.timestamp, injection.source_handler, injection.injection_type, injection.content);
+        return this.sessions.querySessions(filter);
     }
+    // ── Injection operations ───────────────────────────────────────────────
+    writeInjection(injection) { this.injections.writeInjection(injection); }
     queryInjections(filter = {}) {
-        const conditions = [];
-        const params = [];
-        if (filter.session_id) {
-            conditions.push('session_id = ?');
-            params.push(filter.session_id);
-        }
-        if (filter.event_id) {
-            conditions.push('event_id = ?');
-            params.push(filter.event_id);
-        }
-        if (filter.source_handler) {
-            conditions.push('source_handler = ?');
-            params.push(filter.source_handler);
-        }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const limit = filter.limit ?? 100;
-        const sql = `SELECT * FROM injections ${where} ORDER BY timestamp DESC LIMIT ${limit}`;
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(r => ({
-            id: r.id,
-            event_id: r.event_id || undefined,
-            session_id: r.session_id,
-            timestamp: r.timestamp,
-            source_handler: r.source_handler,
-            injection_type: r.injection_type,
-            content: r.content,
-        }));
-    }
-    queryQualityIssues(filter = {}) {
-        const conditions = [];
-        const params = [];
-        if (filter.session_id) {
-            conditions.push('session_id = ?');
-            params.push(filter.session_id);
-        }
-        if (filter.resolved !== undefined) {
-            conditions.push('resolved = ?');
-            params.push(filter.resolved ? 1 : 0);
-        }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const limit = filter.limit ?? 100;
-        const rows = this.db.prepare(`SELECT * FROM quality_issues ${where} ORDER BY created_at DESC LIMIT ${limit}`).all(...params);
-        return rows.map(r => ({
-            file_path: r.file_path, category: r.category,
-            level: r.level, message: r.message,
-            resolved: !!r.resolved, created_at: r.created_at,
-        }));
-    }
-    queryDecisions(filter = {}) {
-        const params = [];
-        let sessionFilter = '';
-        if (filter.session_id) {
-            sessionFilter = 'WHERE d.session_id = ?';
-            params.push(filter.session_id);
-        }
-        const limit = filter.limit ?? 100;
-        const rows = this.db.prepare(`
-      SELECT d.rule_id, d.level, d.reason, d.suggestion, e.tool, d.timestamp
-      FROM v2_decisions d LEFT JOIN v2_tool_events e ON d.event_id = e.id
-      ${sessionFilter} ORDER BY d.timestamp DESC LIMIT ${limit}
-    `).all(...params);
-        return rows.map(r => ({
-            rule_id: r.rule_id || null, level: r.level,
-            reason: r.reason || null, suggestion: r.suggestion || null,
-            tool: r.tool || '', timestamp: r.timestamp,
-        }));
+        return this.injections.queryInjections(filter);
     }
-    // ── Task Operations ─────────────────────────────────────────────────
+    // ── Task operations ─────────────────────────────────────────────────
     writeTask(task) {
-        this.db.prepare(`
-      INSERT INTO tasks (id, session_id, title, start_time) VALUES (?, ?, ?, ?)
-    `).run(task.id, task.session_id, task.title, task.start_time);
+        this.tasks.writeTask(task);
     }
     updateTask(taskId, updates) {
-        const sets = [];
-        const params = [];
-        if (updates.end_time !== undefined) {
-            sets.push('end_time = ?');
-            params.push(updates.end_time);
-        }
-        if (updates.status !== undefined) {
-            sets.push('status = ?');
-            params.push(updates.status);
-        }
-        if (updates.event_count !== undefined) {
-            sets.push('event_count = ?');
-            params.push(updates.event_count);
-        }
-        if (updates.title !== undefined) {
-            sets.push('title = ?');
-            params.push(updates.title);
-        }
-        if (sets.length === 0)
-            return;
-        params.push(taskId);
-        this.db.prepare(`UPDATE tasks SET ${sets.join(', ')} WHERE id = ?`).run(...params);
+        this.tasks.updateTask(taskId, updates);
     }
     linkEventToTask(taskId, eventId) {
-        this.db.prepare(`INSERT OR IGNORE INTO task_events (task_id, event_id) VALUES (?, ?)`).run(taskId, eventId);
-        this.db.prepare(`UPDATE tasks SET event_count = event_count + 1, end_time = (SELECT timestamp FROM events WHERE event_id = ?) WHERE id = ?`).run(eventId, taskId);
+        this.tasks.linkEventToTask(taskId, eventId);
     }
     queryTasks(filter = {}) {
-        const conditions = [];
-        const params = [];
-        if (filter.session_id) {
-            conditions.push('session_id = ?');
-            params.push(filter.session_id);
-        }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const limit = filter.limit ?? 50;
-        const rows = this.db.prepare(`SELECT * FROM tasks ${where} ORDER BY start_time DESC LIMIT ${limit}`).all(...params);
-        return rows.map(r => ({
-            id: r.id, session_id: r.session_id,
-            title: r.title, description: r.description || undefined,
-            start_time: r.start_time, end_time: r.end_time || undefined,
-            status: r.status || 'active', event_count: r.event_count || 0,
-        }));
+        return this.tasks.queryTasks(filter);
     }
-    getTaskEventIds(taskId) {
-        const rows = this.db.prepare(`SELECT event_id FROM task_events WHERE task_id = ?`).all(taskId);
-        return rows.map(r => r.event_id);
+    queryTasksFiltered(filter = {}) {
+        return this.tasks.queryTasksFiltered(filter);
     }
-    // ── Routing Events ─────────────────────────────────────────────────────
+    queryTaskProjects() {
+        return this.tasks.queryTaskProjects();
+    }
+    getTaskEventIds(taskId) { return this.tasks.getTaskEventIds(taskId); }
+    // ── Routing events ─────────────────────────────────────────────────────
     writeRoutingEvent(record) {
-        const result = this.db.prepare(`
-      INSERT INTO routing_events (
-        session_id, route_request_id, project_path, ts, prompt, intent_json,
-        routed_to_type, routed_to_name, is_forced, obeyed,
-        classification_ms, fallback_used, refusal_reason,
-        first_tool_name, first_tool_ts, completed_ts,
-        total_execution_ms, completion_reason, downstream_task_chain,
-        injection_version, experiment_id, experiment_group
-      ) VALUES (
-        @session_id, @route_request_id, @project_path, @ts, @prompt, @intent_json,
-        @routed_to_type, @routed_to_name, @is_forced, @obeyed,
-        @classification_ms, @fallback_used, @refusal_reason,
-        @first_tool_name, @first_tool_ts, @completed_ts,
-        @total_execution_ms, @completion_reason, @downstream_task_chain,
-        @injection_version, @experiment_id, @experiment_group
-      )
-    `).run({
-            session_id: record.session_id,
-            route_request_id: record.route_request_id ?? null,
-            project_path: record.project_path,
-            ts: record.ts,
-            prompt: record.prompt,
-            intent_json: record.intent_json,
-            routed_to_type: record.routed_to_type ?? null,
-            routed_to_name: record.routed_to_name ?? null,
-            is_forced: record.is_forced ?? 0,
-            obeyed: record.obeyed ?? null,
-            classification_ms: record.classification_ms ?? null,
-            fallback_used: record.fallback_used ?? 0,
-            refusal_reason: record.refusal_reason ?? null,
-            first_tool_name: record.first_tool_name ?? null,
-            first_tool_ts: record.first_tool_ts ?? null,
-            completed_ts: record.completed_ts ?? null,
-            total_execution_ms: record.total_execution_ms ?? null,
-            completion_reason: record.completion_reason ?? null,
-            downstream_task_chain: record.downstream_task_chain ?? null,
-            injection_version: record.injection_version ?? null,
-            experiment_id: record.experiment_id ?? null,
-            experiment_group: record.experiment_group ?? null,
-        });
-        return Number(result.lastInsertRowid);
+        return this.routing.writeRoutingEvent(record);
     }
     updateRoutingEvent(id, patch) {
-        const fields = Object.keys(patch).filter((k) => k !== 'id');
-        if (fields.length === 0)
-            return;
-        const setClause = fields.map((f) => `${f} = @${f}`).join(', ');
-        this.db.prepare(`UPDATE routing_events SET ${setClause} WHERE id = @id`).run({
-            ...patch,
-            id,
-        });
+        this.routing.updateRoutingEvent(id, patch);
     }
     queryRoutingEvents(filter = {}) {
-        const conds = [];
-        const params = {};
-        if (filter.session_id) {
-            conds.push('session_id = @session_id');
-            params.session_id = filter.session_id;
-        }
-        if (filter.project_path) {
-            conds.push('project_path = @project_path');
-            params.project_path = filter.project_path;
-        }
-        if (filter.since_ts !== undefined) {
-            conds.push('ts >= @since_ts');
-            params.since_ts = filter.since_ts;
-        }
-        if (filter.routed_to_name) {
-            conds.push('routed_to_name = @routed_to_name');
-            params.routed_to_name = filter.routed_to_name;
-        }
-        if (filter.obeyed !== undefined) {
-            if (filter.obeyed === null)
-                conds.push('obeyed IS NULL');
-            else {
-                conds.push('obeyed = @obeyed');
-                params.obeyed = filter.obeyed;
-            }
-        }
-        const where = conds.length > 0 ? `WHERE ${conds.join(' AND ')}` : '';
-        const limit = filter.limit ?? 100;
-        const rows = this.db.prepare(`SELECT * FROM routing_events ${where} ORDER BY ts DESC LIMIT ${limit}`).all(params);
-        return rows;
+        return this.routing.queryRoutingEvents(filter);
     }
-    /** Pending events with NULL obeyed within the last N seconds; used by daemon restart recovery. */
     findPendingRoutingEvents(ageMs) {
-        const cutoff = Date.now() - ageMs;
-        return this.db.prepare(`SELECT * FROM routing_events WHERE obeyed IS NULL AND ts >= ? ORDER BY ts DESC`).all(cutoff);
+        return this.routing.findPendingRoutingEvents(ageMs);
     }
-    // ── Experiment Assignments (Phase 5) ───────────────────────────────────
+    getRecentRoutingEvent(sessionId) {
+        return this.routing.getRecentRoutingEvent(sessionId);
+    }
+    // ── Experiment assignments ─────────────────────────────────────────────
     getExperimentAssignment(sessionId, experimentId) {
-        const row = this.db.prepare(`SELECT group_id FROM experiment_assignments WHERE session_id = ? AND experiment_id = ?`).get(sessionId, experimentId);
-        return row ? row.group_id : null;
+        return this.routing.getExperimentAssignment(sessionId, experimentId);
     }
     setExperimentAssignment(sessionId, experimentId, groupId) {
-        this.db.prepare(`INSERT OR IGNORE INTO experiment_assignments (session_id, experiment_id, group_id)
-       VALUES (?, ?, ?)`).run(sessionId, experimentId, groupId);
+        this.routing.setExperimentAssignment(sessionId, experimentId, groupId);
     }
     queryExperimentStats(experimentId) {
-        const rows = this.db.prepare(`
-      SELECT
-        experiment_group AS group_id,
-        COUNT(*) AS total,
-        SUM(CASE WHEN obeyed = 1 THEN 1 ELSE 0 END) AS obeyed,
-        SUM(CASE WHEN obeyed = 0 THEN 1 ELSE 0 END) AS refused,
-        SUM(CASE WHEN obeyed IS NULL THEN 1 ELSE 0 END) AS unknown,
-        AVG(classification_ms) AS avg_classification_ms
-      FROM routing_events
-      WHERE experiment_id = ? AND experiment_group IS NOT NULL
-      GROUP BY experiment_group
-      ORDER BY experiment_group ASC
-    `).all(experimentId);
-        return rows;
-    }
-    // ── Routing Rule States (Phase 5 Feature 2) ────────────────────────────
-    getRuleState(taskType, agent) {
-        const row = this.db.prepare(`SELECT * FROM routing_rule_states WHERE task_type = ? AND agent = ?`).get(taskType, agent);
-        return row ?? null;
-    }
-    listRuleStates(filter = {}) {
-        const where = filter.disabledOnly ? 'WHERE disabled = 1' : '';
-        return this.db
-            .prepare(`SELECT * FROM routing_rule_states ${where} ORDER BY task_type, agent`)
-            .all();
-    }
-    setRuleState(params) {
-        const now = new Date().toISOString();
-        this.db.prepare(`
-      INSERT INTO routing_rule_states (task_type, agent, disabled, disabled_at, disabled_reason, auto_disabled, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(task_type, agent) DO UPDATE SET
-        disabled = excluded.disabled,
-        disabled_at = CASE WHEN excluded.disabled = 1 THEN excluded.disabled_at ELSE NULL END,
-        disabled_reason = CASE WHEN excluded.disabled = 1 THEN excluded.disabled_reason ELSE NULL END,
-        auto_disabled = excluded.auto_disabled,
-        updated_at = excluded.updated_at
-    `).run(params.taskType, params.agent, params.disabled ? 1 : 0, params.disabled ? now : null, params.disabled ? (params.reason ?? null) : null, params.autoDisabled ? 1 : 0, now);
-    }
-    /**
-     * Return a Set of "<taskType>__<agent>" strings that are currently disabled.
-     * Hot path used by the router on every decide() call.
-     */
-    getDisabledRuleKeys() {
-        const rows = this.db.prepare(`SELECT task_type, agent FROM routing_rule_states WHERE disabled = 1`).all();
-        return new Set(rows.map(r => `${r.task_type}__${r.agent}`));
-    }
-    // ── Maintenance ────────────────────────────────────────────────────────
-    runMaintenance(maxSizeMb) {
-        const sizeMb = this.getDbSizeMb();
-        if (sizeMb < maxSizeMb) {
-            logger.debug(`[Storage] DB size ${sizeMb.toFixed(1)}MB < ${maxSizeMb}MB, skipping maintenance`);
-            return;
-        }
-        logger.info(`[Storage] Running maintenance (size: ${sizeMb.toFixed(1)}MB)`);
-        // Delete distilled events older than 7 days
-        const deleted = this.db.prepare(`
-      DELETE FROM events
-      WHERE distilled = 1 AND created_at < datetime('now', '-7 days')
-    `).run();
-        logger.info(`[Storage] Deleted ${deleted.changes} old distilled events`);
-        this.vacuum();
-    }
-    vacuum() {
-        this.db.exec('VACUUM');
+        return this.routing.queryExperimentStats(experimentId);
     }
-    close() {
-        try {
-            this.db.close();
-        }
-        catch (err) {
-            logger.warn(`Failed to close database: ${err}`);
-        }
-    }
-    // ── Private Helpers ────────────────────────────────────────────────────
-    getDbSizeMb() {
-        if (!existsSync(this.dbPath))
-            return 0;
-        return statSync(this.dbPath).size / (1024 * 1024);
-    }
-    rowToEvent(row) {
-        return {
-            event_id: row.event_id,
-            session_id: row.session_id,
-            project_path: row.project_path,
-            timestamp: row.timestamp,
-            hook_type: row.hook_type,
-            tool_name: row.tool_name || undefined,
-            tool_input: row.tool_input ? JSON.parse(row.tool_input) : undefined,
-            tool_output: row.tool_output ? JSON.parse(row.tool_output) : undefined,
-            user_prompt: row.user_prompt || undefined,
-            ai_response: row.ai_response || undefined,
-        };
-    }
-    // ── Token Usage ────────────────────────────────────────────────────────
+    // ── Token usage ────────────────────────────────────────────────────────
     recordTokenUsage(params) {
-        const total_tokens = params.input_tokens + params.output_tokens;
-        try {
-            this.db.prepare(`
-        INSERT INTO token_usage (session_id, timestamp,
-                                 input_tokens, output_tokens, total_tokens, model, tool_name)
-        VALUES (?, ?, ?, ?, ?, ?, ?)
-      `).run(params.session_id, Date.now(), params.input_tokens, params.output_tokens, total_tokens, params.model ?? null, params.tool_name ?? null);
-        }
-        catch (err) {
-            logger.debug(`[Storage] Failed to record token usage: ${err}`);
-        }
+        this.tokenUsage.recordTokenUsage(params);
     }
     getTokenUsageBySession(session_id) {
-        const result = this.db.prepare(`
-      SELECT
-        COALESCE(SUM(input_tokens), 0) as input_tokens,
-        COALESCE(SUM(output_tokens), 0) as output_tokens,
-        COALESCE(SUM(total_tokens), 0) as total_tokens
-      FROM token_usage WHERE session_id = ?
-    `).get(session_id);
-        return result;
+        return this.tokenUsage.getTokenUsageBySession(session_id);
     }
     listTokenUsage(filter = {}) {
-        const conditions = [];
-        const params = [];
-        if (filter.session_id) {
-            conditions.push('session_id = ?');
-            params.push(filter.session_id);
-        }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const limit = filter.limit ?? 100;
-        const sql = `SELECT * FROM token_usage ${where} ORDER BY timestamp DESC LIMIT ${limit}`;
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(r => ({
-            id: r.id,
-            session_id: r.session_id,
-            timestamp: r.timestamp,
-            input_tokens: r.input_tokens,
-            output_tokens: r.output_tokens,
-            total_tokens: r.total_tokens,
-            model: r.model || null,
-            tool_name: r.tool_name || null,
-        }));
+        return this.tokenUsage.listTokenUsage(filter);
     }
-    // ── Skill Invocations ──────────────────────────────────────────────────
-    // 记录 Agent 动态调用 Skill 的每一次事件。配合 route_request_id 可以串联
-    // "外层路由 → Agent → 内层 Skill 调用"的证据链。
+    // ── Skill invocations ──────────────────────────────────────────────────
     writeSkillInvocation(row) {
-        const sql = `INSERT INTO skill_invocations
-      (id, route_request_id, session_id, agent_id, skill_id, invocation_type,
-       reason, workflow, phase, feature_slug, artifact_path,
-       depth, success, error, timestamp)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
-        this.db.prepare(sql).run(row.id, row.route_request_id, row.session_id, row.agent_id, row.skill_id, row.invocation_type, row.reason, row.workflow, row.phase, row.feature_slug, row.artifact_path, row.depth, row.success, row.error, row.timestamp);
+        this.skills.writeSkillInvocation(row);
     }
     querySkillInvocations(filter = {}) {
-        const conditions = [];
-        const params = [];
-        if (filter.route_request_id) {
-            conditions.push('route_request_id = ?');
-            params.push(filter.route_request_id);
-        }
-        if (filter.session_id) {
-            conditions.push('session_id = ?');
-            params.push(filter.session_id);
-        }
-        if (filter.skill_id) {
-            conditions.push('skill_id = ?');
-            params.push(filter.skill_id);
-        }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const limit = filter.limit ?? 100;
-        const sql = `SELECT * FROM skill_invocations ${where} ORDER BY timestamp DESC LIMIT ${limit}`;
-        return this.db.prepare(sql).all(...params);
+        return this.skills.querySkillInvocations(filter);
     }
-    /**
-     * 按 route_request_id 聚合工作流进度。
-     *
-     * 用途：Web UI 展示「某次路由 / 某个 session 走完了哪些 phase」。仅聚合
-     * `workflow IS NOT NULL` 的调用（工作流型 reason），普通调用不会被纳入。
-     *
-     * 返回字段：
-     * - `phases_completed` 已按 timestamp 升序排序，并去重；同 phase 多次调用只算一次。
-     * - `feature_slug` 取该 route 内首个非空的 slug；不同 slug 混用时以最早出现的为准。
-     * - `total_invocations` / `success_count` 仅统计有 workflow 的行。
-     */
     queryWorkflowProgress(filter = {}) {
-        const conditions = ['workflow IS NOT NULL', 'route_request_id IS NOT NULL'];
-        const params = [];
-        if (filter.session_id) {
-            conditions.push('session_id = ?');
-            params.push(filter.session_id);
+        return this.skills.queryWorkflowProgress(filter);
+    }
+    // ── Maintenance ────────────────────────────────────────────────────────
+    cleanOldEvents(daysToKeep = 30) { return this.maintenance.cleanOldEvents(daysToKeep); }
+    runMaintenance(maxSizeMb) { this.maintenance.runMaintenance(maxSizeMb); }
+    vacuum() { this.maintenance.vacuum(); }
+    close() {
+        try {
+            this.base.getDatabase().close();
         }
-        if (filter.workflow) {
-            conditions.push('workflow = ?');
-            params.push(filter.workflow);
+        catch (err) {
+            logger.warn(`Failed to close database: ${err}`);
         }
-        const where = `WHERE ${conditions.join(' AND ')}`;
-        const limit = filter.limit ?? 100;
-        // 用 GROUP_CONCAT 收集 phase 序列（保留时间顺序），再在 JS 层去重。
-        // SQLite 的 GROUP_CONCAT 不保证子查询排序稳定，因此用一个 ORDER BY timestamp
-        // 的子查询固定顺序。
-        const sql = `
-      SELECT
-        route_request_id,
-        workflow,
-        GROUP_CONCAT(phase, '||') AS phases_raw,
-        MIN(feature_slug) AS feature_slug,
-        COUNT(*) AS total_invocations,
-        SUM(success) AS success_count,
-        MIN(timestamp) AS first_at,
-        MAX(timestamp) AS last_at
-      FROM (
-        SELECT * FROM skill_invocations
-        ${where}
-        ORDER BY timestamp ASC
-      )
-      GROUP BY route_request_id, workflow
-      ORDER BY last_at DESC
-      LIMIT ${limit}
-    `;
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(r => {
-            const phases = r.phases_raw ? r.phases_raw.split('||').filter(Boolean) : [];
-            // 去重，保留首次出现的顺序
-            const seen = new Set();
-            const phases_completed = [];
-            for (const p of phases) {
-                if (!seen.has(p)) {
-                    seen.add(p);
-                    phases_completed.push(p);
-                }
-            }
-            return {
-                route_request_id: r.route_request_id,
-                workflow: r.workflow,
-                phases_completed,
-                feature_slug: r.feature_slug,
-                total_invocations: r.total_invocations,
-                success_count: r.success_count ?? 0,
-                first_at: r.first_at,
-                last_at: r.last_at,
-            };
-        });
     }
 }
 //# sourceMappingURL=sqlite.js.map