@winspan/claude-forge 8.51.1 → 8.54.3

package/src/core/storage/routing.ts

@@ -1,322 +0,0 @@
-/**
- * RoutingOperations — routing_events + experiment_assignments 读写
- *
- * 拆分自 sqlite.ts。
- *
- * 注意：experiment_assignments 表在 base.ts 的 deprecated 列表里被 DROP 了，
- * 但保留访问方法以维持 API 向后兼容（旧库残留 / 不同 schema 版本）。
- */
-
-import type Database from 'better-sqlite3';
-
-export interface RoutingEventRecord {
-  id?: number;
-  session_id: string;
-  route_request_id?: string | null;
-  project_path: string;
-  ts: number;
-  prompt: string;
-  intent_json: string;
-  routed_to_type?: 'agent' | 'skill' | 'none' | null;
-  routed_to_name?: string | null;
-  is_forced?: number;
-  obeyed?: number | null;
-  classification_ms?: number | null;
-  fallback_used?: number;
-  refusal_reason?: string | null;
-  first_tool_name?: string | null;
-  first_tool_ts?: number | null;
-  completed_ts?: number | null;
-  total_execution_ms?: number | null;
-  completion_reason?: string | null;
-  downstream_task_chain?: string | null;
-  injection_version?: string | null;
-  experiment_id?: string | null;
-  experiment_group?: string | null;
-  skill_confidence?: number | null;
-  skill_source?: 'auto' | 'slash_command' | 'agent_dependency' | null;
-}
-
-export interface RoutingEventRow extends RoutingEventRecord {
-  id: number;
-  created_at: string;
-}
-
-export class RoutingOperations {
-  constructor(private db: Database.Database) {}
-
-  writeRoutingEvent(record: RoutingEventRecord): number {
-    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);
-  }
-
-  updateRoutingEvent(id: number, patch: Partial<RoutingEventRecord>): void {
-    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,
-    });
-  }
-
-  queryRoutingEvents(filter: {
-    session_id?: string;
-    project_path?: string;
-    since_ts?: number;
-    routed_to_name?: string;
-    obeyed?: number | null;
-    limit?: number;
-  } = {}): RoutingEventRow[] {
-    const conds: string[] = [];
-    const params: Record<string, unknown> = {};
-    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;
-    params.limit = limit;
-    const rows = this.db.prepare(
-      `SELECT * FROM routing_events ${where} ORDER BY ts DESC LIMIT @limit`
-    ).all(params) as RoutingEventRow[];
-    return rows;
-  }
-
-  /** Pending events with NULL obeyed within the last N seconds; used by daemon restart recovery. */
-  queryPendingRoutingEvents(ageMs: number): RoutingEventRow[] {
-    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) as RoutingEventRow[];
-  }
-
-  /** Get the most recent routing_event for a session (used by Agent observation). */
-  getRecentRoutingEvent(sessionId: string): { id: number } | null {
-    const row = this.db.prepare(`
-      SELECT id FROM routing_events
-      WHERE session_id = ?
-      ORDER BY ts DESC
-      LIMIT 1
-    `).get(sessionId) as { id: number } | undefined;
-    return row ?? null;
-  }
-
-  /**
-   * Get the most recent PENDING routing_event for a session (obeyed IS NULL).
-   *
-   * Used by PostToolUseHandler to associate Agent invocations with the
-   * still-unfilled routing_event from the current user prompt. Returning only
-   * pending rows prevents the handler from re-overwriting an already-completed
-   * event (e.g. when 2+ Agents fire within the same prompt, or when an old
-   * obeyed=1 row leaks past a missed UserPromptSubmit).
-   *
-   * Trade-off: in the "same-prompt multi-Agent" case, the 2nd+ Agent will not
-   * find a pending row and will be silently skipped. Recording every Agent
-   * call is M7 out-of-scope (would require INSERT in PostToolUse rather than
-   * UPDATE).
-   */
-  getRecentPendingRoutingEvent(sessionId: string): { id: number } | null {
-    const row = this.db.prepare(`
-      SELECT id FROM routing_events
-      WHERE session_id = ? AND obeyed IS NULL
-      ORDER BY ts DESC
-      LIMIT 1
-    `).get(sessionId) as { id: number } | undefined;
-    return row ?? null;
-  }
-
-  // ── Experiment Assignments ──────────────────────────────────────────────
-
-  getExperimentAssignment(sessionId: string, experimentId: string): string | null {
-    const row = this.db.prepare(
-      `SELECT group_id FROM experiment_assignments WHERE session_id = ? AND experiment_id = ?`
-    ).get(sessionId, experimentId) as { group_id: string } | undefined;
-    return row ? row.group_id : null;
-  }
-
-  setExperimentAssignment(sessionId: string, experimentId: string, groupId: string): void {
-    this.db.prepare(
-      `INSERT OR IGNORE INTO experiment_assignments (session_id, experiment_id, group_id)
-       VALUES (?, ?, ?)`
-    ).run(sessionId, experimentId, groupId);
-  }
-
-  // ── Aggregates (H1: SQL-side GROUP BY for routes/rules/skill-stats) ───
-  //
-  // 这些 aggregate* 方法把原本 routes 层做的"全表 SELECT + JS reduce"下沉到
-  // SQL 端，避免单进程内存放大。命名约定（spec H1 固化）：
-  //   - aggregate* —— SQL 端 GROUP BY / COUNT，返回小结果
-  //   - query*     —— 原始行返回（保留旧 API）
-  //
-  // 注意：所有方法都用 `ts > 0` 兜底，防止 strftime 在 ts<=0 时返回 NULL。
-
-  /**
-   * 一次性返回 rules + skill-stats 共用的 routing 汇总（4 个独立聚合，
-   * 各走自己的索引）。不走 UNION ALL（SQLite 无 GROUPING SETS）。
-   */
-  aggregateRoutingStats(filter: { since_ts: number; project_path?: string }): {
-    total: number;
-    obeyed: number;
-    refused: number;
-    unknown: number;
-    by_type: Array<{ type: 'agent' | 'skill' | 'none'; count: number }>;
-    by_agent: Array<{ agent: string; count: number }>;
-    by_skill_routed: Array<{ skill: string; count: number }>;
-  } {
-    const projectCond = filter.project_path ? 'AND project_path = @project' : '';
-    const params = {
-      since: filter.since_ts,
-      project: filter.project_path ?? null,
-    };
-
-    const totalRow = this.db.prepare(`
-      SELECT 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
-      FROM routing_events
-      WHERE ts > 0 AND ts >= @since ${projectCond}
-    `).get(params) as {
-      total: number | null;
-      obeyed: number | null;
-      refused: number | null;
-      unknown: number | null;
-    };
-
-    const byTypeRows = this.db.prepare(`
-      SELECT COALESCE(routed_to_type, 'none') AS type, COUNT(*) AS count
-      FROM routing_events
-      WHERE ts > 0 AND ts >= @since ${projectCond}
-      GROUP BY COALESCE(routed_to_type, 'none')
-      ORDER BY count DESC
-    `).all(params) as Array<{ type: 'agent' | 'skill' | 'none'; count: number }>;
-
-    const byAgentRows = this.db.prepare(`
-      SELECT routed_to_name AS agent, COUNT(*) AS count
-      FROM routing_events
-      WHERE ts > 0 AND ts >= @since AND obeyed = 1 AND routed_to_name IS NOT NULL ${projectCond}
-      GROUP BY routed_to_name
-      ORDER BY count DESC
-    `).all(params) as Array<{ agent: string; count: number }>;
-
-    const bySkillRoutedRows = this.db.prepare(`
-      SELECT routed_to_name AS skill, COUNT(*) AS count
-      FROM routing_events
-      WHERE ts > 0 AND ts >= @since AND routed_to_type = 'skill' AND routed_to_name IS NOT NULL ${projectCond}
-      GROUP BY routed_to_name
-      ORDER BY count DESC
-    `).all(params) as Array<{ skill: string; count: number }>;
-
-    return {
-      total: totalRow.total ?? 0,
-      obeyed: totalRow.obeyed ?? 0,
-      refused: totalRow.refused ?? 0,
-      unknown: totalRow.unknown ?? 0,
-      by_type: byTypeRows,
-      by_agent: byAgentRows,
-      by_skill_routed: bySkillRoutedRows,
-    };
-  }
-
-  /**
-   * 按天聚合 routing 事件，用于 skill-stats trend chart。
-   * 时区固定 UTC（strftime + unixepoch），与旧实现的 `new Date(ts).toISOString().split('T')[0]` 一致。
-   */
-  aggregateRoutingTrendByDay(filter: { since_ts: number }): Array<{
-    day: string;
-    total: number;
-    skill: number;
-  }> {
-    const rows = this.db.prepare(`
-      SELECT strftime('%Y-%m-%d', ts / 1000, 'unixepoch') AS day,
-             COUNT(*) AS total,
-             SUM(CASE WHEN routed_to_type = 'skill' THEN 1 ELSE 0 END) AS skill
-      FROM routing_events
-      WHERE ts > 0 AND ts >= @since
-      GROUP BY day
-      ORDER BY day ASC
-    `).all({ since: filter.since_ts }) as Array<{
-      day: string | null;
-      total: number;
-      skill: number | null;
-    }>;
-    return rows
-      .filter(r => r.day !== null)
-      .map(r => ({ day: r.day as string, total: r.total, skill: r.skill ?? 0 }));
-  }
-
-  queryExperimentStats(experimentId: string): Array<{
-    group_id: string;
-    total: number;
-    obeyed: number;
-    refused: number;
-    unknown: number;
-    avg_classification_ms: number | null;
-  }> {
-    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) as Array<{
-      group_id: string;
-      total: number;
-      obeyed: number;
-      refused: number;
-      unknown: number;
-      avg_classification_ms: number | null;
-    }>;
-    return rows;
-  }
-}

package/src/core/storage/rows.ts

@@ -1,112 +0,0 @@
-/**
- * 数据库行的 TypeScript 类型定义。
- *
- * 每个 interface 对应一张表的查询结果行（shape 与 schema.sql + runMigrations 后
- * 的最终结构一致）。sqlite.ts 的所有 get/all 返回值都应该用这些类型而非 any，
- * 以确保 schema 变动能在编译期而不是运行期暴露。
- *
- * 约定：
- * - 字段可空性严格对齐 schema.sql 的 NOT NULL / DEFAULT NULL / 外键约束
- * - enum 字段（status / mode / trigger_type 等）使用 string literal union
- * - timestamp 字段按实际存储类型：文本时间戳 → string，Unix 毫秒数 → number
- */
-
-// ── events ────────────────────────────────────────────────────────────────
-
-export interface EventRow {
-  event_id: string;
-  session_id: string;
-  project_path: string;
-  timestamp: string;
-  hook_type: 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Notification' | 'Stop';
-  tool_name: string | null;
-  tool_input: string | null; // JSON string
-  tool_output: string | null; // JSON string
-  user_prompt: string | null;
-  ai_response: string | null;
-  created_at: string;
-}
-
-// ── sessions ──────────────────────────────────────────────────────────────
-
-export interface SessionRow {
-  session_id: string;
-  project_path: string;
-  status: 'active' | 'completed' | 'interrupted' | 'resumed' | 'abandoned';
-  first_prompt: string | null;
-  start_time: string;
-  end_time: string | null;
-  last_event_time: string | null;
-  event_count: number;
-  created_at: string;
-  updated_at: string;
-}
-
-// ── injections ────────────────────────────────────────────────────────────
-
-export interface InjectionRow {
-  id: string;
-  event_id: string | null;
-  session_id: string;
-  timestamp: string;
-  source_handler: string;
-  injection_type: 'systemMessage' | 'additionalContext' | 'reason';
-  content: string;
-  created_at: string;
-}
-
-// ── tasks ─────────────────────────────────────────────────────────────────
-
-export interface TaskRow {
-  id: string;
-  session_id: string;
-  title: string;
-  description: string | null;
-  start_time: string;
-  end_time: string | null;
-  status: 'active' | 'completed' | 'abandoned';
-  event_count: number;
-  created_at: string;
-}
-
-// ── token_usage ───────────────────────────────────────────────────────────
-
-export interface TokenUsageRow {
-  id: number;
-  session_id: string;
-  timestamp: number;
-  input_tokens: number;
-  output_tokens: number;
-  total_tokens: number;
-  model: string | null;
-  tool_name: string | null;
-  created_at: string;
-}
-
-// ── skill_invocations ─────────────────────────────────────────────────────
-// Skill 调用链路追踪：Agent 动态调用 Skill 的每一次记录。
-// invocation_type 区分静态依赖（agent frontmatter 声明）、动态调用（MCP 工具 `skill_invoke`）、
-// 以及 slash_command（用户直接通过 /skill-xxx 触发）。
-
-export interface SkillInvocationRow {
-  id: string;
-  route_request_id: string | null;
-  session_id: string;
-  agent_id: string | null;
-  skill_id: string;
-  invocation_type: 'static' | 'dynamic' | 'slash_command';
-  reason: string | null;
-
-  // 工作流追踪字段（v8.38+）：从 reason 字段解析的 <workflow>/<phase>[:feature-slug] 元信息。
-  // 解析失败或非工作流调用时所有字段为 null，以保持向后兼容。
-  workflow: string | null;             // 'bmad' / 'harness' / 其他工作流标识
-  phase: string | null;                // 'analyze' / 'design' / 'safety-net' 等
-  feature_slug: string | null;         // 可选，关联同一 feature 的多次调用
-  artifact_path: string | null;        // 可选，调用产出的文档路径
-
-  depth: number;
-  success: number; // SQLite 存储为 INTEGER (0 | 1)
-  error: string | null;
-  timestamp: number;
-  created_at: string;
-}

package/src/core/storage/schema.sql

@@ -1,224 +0,0 @@
--- Claude Forge SQLite Schema (core tables)
--- Active tables: events, sessions, injections, tasks, task_events,
--- routing_events, token_usage, skill_invocations
---
--- ── Table Relationships ──────────────────────────────────────────────────────
---
--- events (core fact table)
---   └─ sessions.session_id        — aggregated from events (app-layer, no FK)
---   └─ injections.event_id        — FK ON DELETE CASCADE
---   └─ task_events.event_id       — FK ON DELETE CASCADE
---
--- routing_events (agent routing decisions)
---   └─ routing_events.session_id  → events.session_id (logical, no FK)
---   └─ skill_invocations.route_request_id → routing_events.route_request_id (logical, no FK)
---
--- skill_invocations (skill execution records)
---   └─ skill_invocations.session_id       → events.session_id (logical, no FK)
---   └─ skill_invocations.route_request_id → routing_events.route_request_id (logical, no FK)
---
--- token_usage (LLM token accounting)
---   └─ token_usage.session_id     → events.session_id (logical, no FK)
---
--- Why no FK on routing_events / skill_invocations / token_usage:
---   1. routing_events.route_request_id is nullable and not UNIQUE — cannot be FK target
---   2. Write order is not guaranteed: skill_invocations may be written before routing_events
---   3. session_id references are maintained by application logic; sessions is an aggregate
---      table that may lag behind event writes
---   4. Indexes on join columns provide equivalent query performance to FK indexes
---
-
--- ── Events & Sessions ─────────────────────────────────────────────────────
-
-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 CHECK(hook_type IN ('PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'Notification', 'Stop')),
-    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);
-CREATE INDEX IF NOT EXISTS idx_events_hook_type ON events(hook_type);
-
-CREATE TABLE IF NOT EXISTS sessions (
-    session_id TEXT PRIMARY KEY,
-    project_path TEXT NOT NULL,
-    status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'completed', 'interrupted', 'resumed', 'abandoned')),
-    first_prompt TEXT,
-    start_time TEXT NOT NULL,
-    end_time TEXT,
-    last_event_time TEXT,
-    event_count INTEGER DEFAULT 0,
-    created_at TEXT DEFAULT (datetime('now')),
-    updated_at TEXT DEFAULT (datetime('now'))
-);
-
-CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_path);
-CREATE INDEX IF NOT EXISTS idx_sessions_status ON sessions(status);
-CREATE INDEX IF NOT EXISTS idx_sessions_start_time ON sessions(start_time DESC);
-
--- ── Injections ─────────────────────────────────────────────────────
-
-CREATE TABLE IF NOT EXISTS injections (
-    id TEXT PRIMARY KEY,
-    event_id TEXT,
-    session_id TEXT NOT NULL,
-    timestamp TEXT NOT NULL,
-    source_handler TEXT NOT NULL,
-    injection_type TEXT NOT NULL CHECK(injection_type IN ('systemMessage', 'additionalContext', 'reason')),
-    content TEXT NOT NULL,
-    created_at TEXT DEFAULT (datetime('now')),
-    FOREIGN KEY (event_id) REFERENCES events(event_id) ON DELETE CASCADE
-);
-
-CREATE INDEX IF NOT EXISTS idx_injections_session ON injections(session_id);
-CREATE INDEX IF NOT EXISTS idx_injections_event ON injections(event_id);
-CREATE INDEX IF NOT EXISTS idx_injections_timestamp ON injections(timestamp DESC);
-
--- ── Tasks ──────────────────────────────────────────────────────────
-
-CREATE TABLE IF NOT EXISTS tasks (
-    id TEXT PRIMARY KEY,
-    session_id TEXT NOT NULL,
-    title TEXT NOT NULL,
-    description TEXT,
-    start_time TEXT NOT NULL,
-    end_time TEXT,
-    status TEXT DEFAULT 'active' CHECK(status IN ('active', 'completed', 'abandoned')),
-    event_count INTEGER DEFAULT 0,
-    created_at TEXT DEFAULT (datetime('now'))
-);
-
-CREATE TABLE IF NOT EXISTS task_events (
-    task_id TEXT NOT NULL,
-    event_id TEXT NOT NULL,
-    PRIMARY KEY (task_id, event_id),
-    FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE,
-    FOREIGN KEY (event_id) REFERENCES events(event_id) ON DELETE CASCADE
-);
-
-CREATE INDEX IF NOT EXISTS idx_tasks_session ON tasks(session_id);
-CREATE INDEX IF NOT EXISTS idx_tasks_start_time ON tasks(start_time DESC);
-CREATE INDEX IF NOT EXISTS idx_task_events_task ON task_events(task_id);
-CREATE INDEX IF NOT EXISTS idx_task_events_event ON task_events(event_id);
-
--- ── Routing Events (agent routing observability) ─────────────────────────
-
-CREATE TABLE IF NOT EXISTS routing_events (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id TEXT NOT NULL,
-    route_request_id TEXT,
-    project_path TEXT NOT NULL,
-    ts INTEGER NOT NULL,
-    prompt TEXT NOT NULL,
-    intent_json TEXT NOT NULL,
-    routed_to_type TEXT,
-    routed_to_name TEXT,
-    is_forced INTEGER DEFAULT 0,
-    obeyed INTEGER,
-    classification_ms INTEGER,
-    fallback_used INTEGER DEFAULT 0,
-    refusal_reason TEXT,
-    first_tool_name TEXT,
-    first_tool_ts INTEGER,
-    completed_ts INTEGER,
-    total_execution_ms INTEGER,
-    completion_reason TEXT,
-    downstream_task_chain TEXT,
-    injection_version TEXT,
-    experiment_id TEXT,
-    experiment_group TEXT,
-    skill_confidence REAL,
-    skill_source TEXT,
-    created_at TEXT DEFAULT (datetime('now'))
-);
-
-CREATE INDEX IF NOT EXISTS idx_routing_events_session ON routing_events(session_id);
-CREATE INDEX IF NOT EXISTS idx_routing_events_route_request ON routing_events(route_request_id);
-CREATE INDEX IF NOT EXISTS idx_routing_events_ts ON routing_events(ts DESC);
-CREATE INDEX IF NOT EXISTS idx_routing_events_agent ON routing_events(routed_to_name, obeyed);
-CREATE INDEX IF NOT EXISTS idx_routing_events_obeyed ON routing_events(obeyed);
-CREATE INDEX IF NOT EXISTS idx_routing_events_experiment ON routing_events(experiment_id, experiment_group);
-
--- ── Token Usage ──────────────────────────────────────────────────────
-
-CREATE TABLE IF NOT EXISTS token_usage (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id TEXT NOT NULL,  -- logical ref → events.session_id; no FK due to write-order race (sessions is aggregate, may lag)
-    timestamp INTEGER NOT NULL,
-    input_tokens INTEGER NOT NULL,
-    output_tokens INTEGER NOT NULL,
-    total_tokens INTEGER NOT NULL,
-    model TEXT,
-    tool_name TEXT,
-    created_at TEXT DEFAULT (datetime('now'))
-);
-
-CREATE INDEX IF NOT EXISTS idx_token_usage_session ON token_usage(session_id);
-CREATE INDEX IF NOT EXISTS idx_token_usage_timestamp ON token_usage(timestamp DESC);
-
--- ── Skill Invocations ─────────────────────────────────────────────────
-
-CREATE TABLE IF NOT EXISTS skill_invocations (
-    id TEXT PRIMARY KEY,
-    route_request_id TEXT,
-    session_id TEXT NOT NULL,
-    agent_id TEXT,
-    skill_id TEXT NOT NULL,
-    invocation_type TEXT NOT NULL,
-    reason TEXT,
-    workflow TEXT,
-    phase TEXT,
-    feature_slug TEXT,
-    artifact_path TEXT,
-    depth INTEGER DEFAULT 0,
-    success INTEGER DEFAULT 1,
-    error TEXT,
-    timestamp INTEGER NOT NULL,
-    created_at TEXT DEFAULT (datetime('now'))
-);
-
-CREATE INDEX IF NOT EXISTS idx_skill_invocations_route_request ON skill_invocations(route_request_id);
-CREATE INDEX IF NOT EXISTS idx_skill_invocations_session ON skill_invocations(session_id);
-CREATE INDEX IF NOT EXISTS idx_skill_invocations_skill ON skill_invocations(skill_id);
-CREATE INDEX IF NOT EXISTS idx_skill_invocations_timestamp ON skill_invocations(timestamp DESC);
-
--- ── Composite Indexes (high-frequency query optimization) ─────────────────────
--- These cover session-scoped queries that filter by session_id then sort by time.
--- Existing single-column indexes are retained for other query paths.
-
-CREATE INDEX IF NOT EXISTS idx_events_session_ts ON events(session_id, timestamp DESC);
-CREATE INDEX IF NOT EXISTS idx_routing_events_session_ts ON routing_events(session_id, ts DESC);
-CREATE INDEX IF NOT EXISTS idx_skill_invocations_session_ts ON skill_invocations(session_id, timestamp DESC);
-
--- ── Additional Performance Indexes (Phase 1 Refactor) ─────────────────────
-
--- routing_events: optimize obeyed flag queries with time sorting
-CREATE INDEX IF NOT EXISTS idx_routing_events_obeyed_ts ON routing_events(obeyed, ts DESC);
-
--- tasks: optimize filter+sort queries (start_time range filter + session join)
-CREATE INDEX IF NOT EXISTS idx_tasks_start_time_session ON tasks(start_time DESC, session_id);
-
--- events: optimize session + hook_type composite queries
-CREATE INDEX IF NOT EXISTS idx_events_session_hook ON events(session_id, hook_type, timestamp DESC);
-
--- injections: optimize session + handler composite queries
-CREATE INDEX IF NOT EXISTS idx_injections_session_handler ON injections(session_id, source_handler);
-
--- routing_events: optimize routed_to_type distribution (H1 aggregate path)
-CREATE INDEX IF NOT EXISTS idx_routing_events_type_ts ON routing_events(routed_to_type, ts DESC);
-
--- skill_invocations: optimize workflow/phase and feature_slug queries (H4 dedup: previously migration-only)
-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);