@winspan/claude-forge 8.41.0 → 8.51.0

package/dist/core/storage/schema.sql

@@ -1,5 +1,32 @@
--- Claude Forge SQLite Schema (minimal core)
--- Only essential tables for event logging, sessions, quality, distill, and v2 governance
+-- 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 ─────────────────────────────────────────────────────
 
@@ -28,7 +55,7 @@ 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,  -- 首条 UserPromptSubmit 的 user_prompt 截断后入库，避免 querySessions 跑子查询
+    first_prompt TEXT,
     start_time TEXT NOT NULL,
     end_time TEXT,
     last_event_time TEXT,
@@ -41,77 +68,6 @@ 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);
 
--- ── Quality Issues ─────────────────────────────────────────────────────
-
-CREATE TABLE IF NOT EXISTS quality_issues (
-    id TEXT PRIMARY KEY,
-    session_id TEXT NOT NULL,
-    project_path TEXT NOT NULL,
-    file_path TEXT NOT NULL,
-    category TEXT NOT NULL,
-    level TEXT NOT NULL,
-    message TEXT NOT NULL,
-    resolved INTEGER DEFAULT 0,
-    resolved_at TEXT DEFAULT NULL,
-    created_at TEXT DEFAULT (datetime('now'))
-);
-
-CREATE INDEX IF NOT EXISTS idx_qi_session ON quality_issues(session_id);
-CREATE INDEX IF NOT EXISTS idx_qi_project ON quality_issues(project_path);
-
--- ── Distill Results ─────────────────────────────────────────────────────
-
-CREATE TABLE IF NOT EXISTS distill_results (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id TEXT NOT NULL,
-    event_ids TEXT NOT NULL,
-    status TEXT DEFAULT 'pending' CHECK(status IN ('pending', 'processing', 'completed', 'failed')),
-    retry_count INTEGER DEFAULT 0,
-    error_message TEXT,
-    created_at TEXT DEFAULT (datetime('now')),
-    processed_at TEXT
-);
-
-CREATE INDEX IF NOT EXISTS idx_dr_status ON distill_results(status);
-
--- ── V2 Governance ─────────────────────────────────────────────────────
-
-CREATE TABLE IF NOT EXISTS v2_tool_events (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id TEXT NOT NULL,
-    route_request_id TEXT,
-    tool TEXT NOT NULL,
-    args TEXT NOT NULL,
-    result TEXT,
-    success INTEGER NOT NULL,
-    error TEXT,
-    timestamp INTEGER NOT NULL,
-    created_at TEXT DEFAULT (datetime('now'))
-);
-
-CREATE INDEX IF NOT EXISTS idx_v2_events_session ON v2_tool_events(session_id);
-CREATE INDEX IF NOT EXISTS idx_v2_events_route_request ON v2_tool_events(route_request_id);
-CREATE INDEX IF NOT EXISTS idx_v2_events_timestamp ON v2_tool_events(timestamp DESC);
-CREATE INDEX IF NOT EXISTS idx_v2_events_tool ON v2_tool_events(tool);
-
-CREATE TABLE IF NOT EXISTS v2_decisions (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id TEXT NOT NULL,
-    event_id INTEGER NOT NULL,
-    rule_id TEXT,
-    level TEXT NOT NULL CHECK(level IN ('allow', 'warn', 'confirm', 'block')),
-    reason TEXT,
-    suggestion TEXT,
-    user_choice TEXT,
-    timestamp INTEGER NOT NULL,
-    created_at TEXT DEFAULT (datetime('now')),
-    FOREIGN KEY (event_id) REFERENCES v2_tool_events(id) ON DELETE CASCADE
-);
-
-CREATE INDEX IF NOT EXISTS idx_v2_decisions_session ON v2_decisions(session_id);
-CREATE INDEX IF NOT EXISTS idx_v2_decisions_level ON v2_decisions(level);
-CREATE INDEX IF NOT EXISTS idx_v2_decisions_rule ON v2_decisions(rule_id);
-
 -- ── Injections ─────────────────────────────────────────────────────
 
 CREATE TABLE IF NOT EXISTS injections (
@@ -167,10 +123,10 @@ CREATE TABLE IF NOT EXISTS routing_events (
     ts INTEGER NOT NULL,
     prompt TEXT NOT NULL,
     intent_json TEXT NOT NULL,
-    routed_to_type TEXT,                   -- 'agent' | 'skill' | 'none'
+    routed_to_type TEXT,
     routed_to_name TEXT,
     is_forced INTEGER DEFAULT 0,
-    obeyed INTEGER,                        -- 1 / 0 / NULL
+    obeyed INTEGER,
     classification_ms INTEGER,
     fallback_used INTEGER DEFAULT 0,
     refusal_reason TEXT,
@@ -179,12 +135,12 @@ CREATE TABLE IF NOT EXISTS routing_events (
     completed_ts INTEGER,
     total_execution_ms INTEGER,
     completion_reason TEXT,
-    downstream_task_chain TEXT,            -- JSON array of subagent_type
+    downstream_task_chain TEXT,
     injection_version TEXT,
-    experiment_id TEXT,                    -- Phase 5: A/B test experiment id (null if no experiment)
-    experiment_group TEXT,                 -- Phase 5: assigned group id (null if no experiment)
-    skill_confidence REAL,                 -- Skill matching confidence (0.0-1.0)
-    skill_source TEXT,                     -- Skill source: 'auto' / 'slash_command' / 'agent_dependency'
+    experiment_id TEXT,
+    experiment_group TEXT,
+    skill_confidence REAL,
+    skill_source TEXT,
     created_at TEXT DEFAULT (datetime('now'))
 );
 
@@ -195,76 +151,41 @@ CREATE INDEX IF NOT EXISTS idx_routing_events_agent ON routing_events(routed_to_
 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);
 
--- ── Experiment Assignments (Phase 5: A/B test group stickiness) ─────────
-
-CREATE TABLE IF NOT EXISTS experiment_assignments (
-    session_id TEXT NOT NULL,
-    experiment_id TEXT NOT NULL,
-    group_id TEXT NOT NULL,
-    assigned_at TEXT DEFAULT (datetime('now')),
-    PRIMARY KEY (session_id, experiment_id)
-);
-
-CREATE INDEX IF NOT EXISTS idx_exp_assign_exp ON experiment_assignments(experiment_id);
-
--- ── Routing Rule States (Phase 5 Feature 2: auto-disable) ───────────────
--- One row per (task_type, agent) combination. A disabled entry causes the
--- router to skip matches for that pair and continue to the next rule.
-
-CREATE TABLE IF NOT EXISTS routing_rule_states (
-    task_type TEXT NOT NULL,
-    agent TEXT NOT NULL,
-    disabled INTEGER NOT NULL DEFAULT 0,
-    disabled_at TEXT,
-    disabled_reason TEXT,
-    auto_disabled INTEGER NOT NULL DEFAULT 0,   -- 1 if set by the auto-disable scheduler
-    updated_at TEXT DEFAULT (datetime('now')),
-    PRIMARY KEY (task_type, agent)
-);
-
-CREATE INDEX IF NOT EXISTS idx_rule_states_disabled ON routing_rule_states(disabled);
-
--- ── Token Usage (Token 用量追踪) ──────────────────────────────────────────
--- 记录每次 AI 调用的 token 用量，用于成本可观测和预算控制
+-- ── Token Usage ──────────────────────────────────────────────────────
 
 CREATE TABLE IF NOT EXISTS token_usage (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id TEXT NOT NULL,
+    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,  -- 如 'claude-opus-4-7'
-    tool_name TEXT,  -- 如 'Task' / 'Read' / 'Agent' / 'classify' / 'plan'
+    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 (Skill 调用链路追踪) ─────────────────────────────────
--- 记录 Agent 动态调用 Skill 的完整链路，形成"一次路由 → Agent → N 次 Skill 调用"
--- 的证据链，配合 routing_events.route_request_id 可串联外层路由与内层 Skill 调用。
+-- ── Skill Invocations ─────────────────────────────────────────────────
 
 CREATE TABLE IF NOT EXISTS skill_invocations (
-    id TEXT PRIMARY KEY,                     -- UUID
-    route_request_id TEXT,                   -- 关联外层路由（routing_events.route_request_id）
+    id TEXT PRIMARY KEY,
+    route_request_id TEXT,
     session_id TEXT NOT NULL,
-    agent_id TEXT,                           -- 发起调用的 Agent（可能为 NULL 如果是主 Claude）
-    skill_id TEXT NOT NULL,                  -- 被调用的 Skill ID
-    invocation_type TEXT NOT NULL,           -- 'static' / 'dynamic' / 'slash_command'
-    reason TEXT,                             -- Agent 提供的调用理由
-
-    -- 工作流追踪字段：从 reason 解析的 <workflow>/<phase>[:feature-slug] 元信息
-    workflow TEXT,                           -- 'bmad' / 'harness' / NULL（普通调用）
-    phase TEXT,                              -- 'analyze' / 'design' / 'safety-net' 等
-    feature_slug TEXT,                       -- 可选，用于关联同一个 feature 的多次调用
-    artifact_path TEXT,                      -- 可选，调用产出的文档路径
-
-    depth INTEGER DEFAULT 0,                 -- 调用嵌套深度
-    success INTEGER DEFAULT 1,               -- 1 成功 / 0 失败
-    error TEXT,                              -- 错误信息（如 skill 不存在）
-    timestamp INTEGER NOT NULL,              -- 调用时间戳（ms）
+    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'))
 );
 
@@ -272,5 +193,32 @@ CREATE INDEX IF NOT EXISTS idx_skill_invocations_route_request ON skill_invocati
 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);
--- 工作流字段索引（workflow / feature_slug）由 runMigrations 创建，以便旧库升级时
--- 先通过 addColumnIfMissing 补列再建索引，避免 "no such column" 错误。
+
+-- ── 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);

package/dist/core/storage/sessions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SessionOperations — sessions 聚合表读写
+ *
+ * 拆分自 sqlite.ts。负责：
+ * - upsertSession：每次 writeEvent 后被调用，更新 sessions 聚合
+ * - querySessions：直接读聚合表，O(sessions) 而非 O(sessions × events)
+ */
+import type Database from 'better-sqlite3';
+import type { ForgeEvent } from '../types.js';
+export interface SessionSummary {
+    session_id: string;
+    first_prompt: string;
+    event_count: number;
+    start_time: string;
+    end_time: string;
+}
+export declare class SessionOperations {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * 将事件聚合到 sessions 表，供 querySessions 直接读取。
+     *
+     * 语义：
+     * - 首次出现 session_id → 插入一行
+     * - 已存在 → event_count += 1，end/last_event_time 取更晚的，first_prompt 只在
+     *   原值为 NULL 时才被 UserPromptSubmit 的前 200 字填充
+     */
+    upsertSession(event: ForgeEvent): void;
+    querySessions(filter?: {
+        project_path?: string;
+        limit?: number;
+    }): SessionSummary[];
+    /** Total session row count. */
+    countAllSessions(): number;
+    /** Per-day session counts (date(start_time) → count) within [since, until). */
+    aggregateDailySessionCounts(opts: {
+        since: string;
+        until?: string;
+    }): Array<{
+        date: string;
+        count: number;
+    }>;
+    /** Sessions with start_time in [since, until?), ordered by start_time DESC. */
+    querySessionsByTimeRange(opts: {
+        since: string;
+        until?: string;
+    }): SessionSummary[];
+    /** Count of sessions with start_time in [since, until?). */
+    countSessionsByRange(opts: {
+        since: string;
+        until?: string;
+    }): number;
+}
+//# sourceMappingURL=sessions.d.ts.map

package/dist/core/storage/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/core/storage/sessions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAmCtC,aAAa,CAAC,MAAM,GAAE;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,cAAc,EAAE;IAsCzB,+BAA+B;IAC/B,gBAAgB,IAAI,MAAM;IAK1B,+EAA+E;IAC/E,2BAA2B,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAa5G,+EAA+E;IAC/E,wBAAwB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,EAAE;IA4BnF,4DAA4D;IAC5D,oBAAoB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CAWtE"}

package/dist/core/storage/sessions.js

@@ -0,0 +1,137 @@
+/**
+ * SessionOperations — sessions 聚合表读写
+ *
+ * 拆分自 sqlite.ts。负责：
+ * - upsertSession：每次 writeEvent 后被调用，更新 sessions 聚合
+ * - querySessions：直接读聚合表，O(sessions) 而非 O(sessions × events)
+ */
+export class SessionOperations {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * 将事件聚合到 sessions 表，供 querySessions 直接读取。
+     *
+     * 语义：
+     * - 首次出现 session_id → 插入一行
+     * - 已存在 → event_count += 1，end/last_event_time 取更晚的，first_prompt 只在
+     *   原值为 NULL 时才被 UserPromptSubmit 的前 200 字填充
+     */
+    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);
+    }
+    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;
+        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 ?
+    `;
+        params.push(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,
+        }));
+    }
+    // ── H2: 聚合 / 计数方法 ───────────────────────────────────────────────
+    /** Total session row count. */
+    countAllSessions() {
+        const row = this.db.prepare('SELECT COUNT(*) as cnt FROM sessions').get();
+        return row.cnt;
+    }
+    /** Per-day session counts (date(start_time) → count) within [since, until). */
+    aggregateDailySessionCounts(opts) {
+        const conditions = ['start_time >= ?'];
+        const params = [opts.since];
+        if (opts.until !== undefined) {
+            conditions.push('start_time < ?');
+            params.push(opts.until);
+        }
+        const sql = `SELECT date(start_time) as date, COUNT(*) as count FROM sessions
+                 WHERE ${conditions.join(' AND ')}
+                 GROUP BY date ORDER BY date`;
+        return this.db.prepare(sql).all(...params);
+    }
+    /** Sessions with start_time in [since, until?), ordered by start_time DESC. */
+    querySessionsByTimeRange(opts) {
+        const conditions = ['start_time >= ?'];
+        const params = [opts.since];
+        if (opts.until !== undefined) {
+            conditions.push('start_time < ?');
+            params.push(opts.until);
+        }
+        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 ${conditions.join(' AND ')}
+      ORDER BY start_time DESC
+    `;
+        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,
+        }));
+    }
+    /** Count of sessions with start_time in [since, until?). */
+    countSessionsByRange(opts) {
+        const conditions = ['start_time >= ?'];
+        const params = [opts.since];
+        if (opts.until !== undefined) {
+            conditions.push('start_time < ?');
+            params.push(opts.until);
+        }
+        const sql = `SELECT COUNT(*) as cnt FROM sessions WHERE ${conditions.join(' AND ')}`;
+        const row = this.db.prepare(sql).get(...params);
+        return row?.cnt ?? 0;
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/core/storage/sessions.js.map

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

package/dist/core/storage/skills.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SkillOperations — skill_invocations 表读写 + 工作流聚合查询
+ *
+ * 拆分自 sqlite.ts。
+ */
+import type Database from 'better-sqlite3';
+import type { SkillInvocationRow } from './rows.js';
+export declare class SkillOperations {
+    private db;
+    constructor(db: Database.Database);
+    writeSkillInvocation(row: Omit<SkillInvocationRow, 'created_at'>): void;
+    querySkillInvocations(filter?: {
+        route_request_id?: string;
+        session_id?: string;
+        skill_id?: string;
+        since?: number;
+        limit?: number;
+    }): SkillInvocationRow[];
+    /**
+     * H1: 按 skill_id 聚合调用总数 / 成功 / 失败。
+     *
+     * 取代 routes 层的"全表 querySkillInvocations + JS reduce"。
+     * 走 `idx_skill_invocations_timestamp`。
+     */
+    aggregateSkillInvocationsBySkill(filter: {
+        since: number;
+        limit?: number;
+    }): Array<{
+        skill_id: string;
+        total: number;
+        success: number;
+        failed: number;
+    }>;
+    /**
+     * 按 route_request_id 聚合工作流进度。
+     *
+     * 用途：Web UI 展示「某次路由 / 某个 session 走完了哪些 phase」。仅聚合
+     * `workflow IS NOT NULL` 的调用（工作流型 reason），普通调用不会被纳入。
+     */
+    queryWorkflowProgress(filter?: {
+        session_id?: string;
+        workflow?: string;
+        limit?: number;
+    }): Array<{
+        route_request_id: string;
+        workflow: string;
+        phases_completed: string[];
+        feature_slug: string | null;
+        total_invocations: number;
+        success_count: number;
+        first_at: number;
+        last_at: number;
+    }>;
+    /** Total skill_invocations row count. */
+    countAllSkillInvocations(): number;
+    /** Skill invocation count for a single session. */
+    countSkillInvocationsBySession(session_id: string): number;
+    /** Distinct skill_id count since `since_ms` (unix ms). */
+    countDistinctSkillsSince(since_ms: number): number;
+    /** Distinct skill_id values for a single session. */
+    queryDistinctSkillIdsBySession(session_id: string): string[];
+}
+//# sourceMappingURL=skills.d.ts.map

package/dist/core/storage/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/core/storage/skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,qBAAa,eAAe;IACd,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,GAAG,IAAI;IAyBvE,qBAAqB,CAAC,MAAM,GAAE;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,kBAAkB,EAAE;IA6B7B;;;;;OAKG;IACH,gCAAgC,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QACjF,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IA0BF;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,GAAE;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,KAAK,CAAC;QACb,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IA2EF,yCAAyC;IACzC,wBAAwB,IAAI,MAAM;IAKlC,mDAAmD;IACnD,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAO1D,0DAA0D;IAC1D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAOlD,qDAAqD;IACrD,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;CAM7D"}