@winspan/claude-forge 8.54.4 → 9.12.0

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

@@ -9,7 +9,12 @@ export interface CleanOldDataResult {
     events: number;
     routing: number;
     skills: number;
-    tokens: number;
+    /**
+     * task_events: 关联表（无自身 timestamp）。清理基于 events 表删除时
+     * 的孤儿行（event_id 已不存在于 events 表）。SQLite 默认未开启
+     * `PRAGMA foreign_keys`，CASCADE 不会自动触发，因此这里显式 DELETE。
+     */
+    taskEvents: number;
 }
 export declare class MaintenanceOperations {
     private db;
@@ -20,24 +25,46 @@ export declare class MaintenanceOperations {
      *
      * 范围：
      *   - events            (timestamp TEXT, ISO)
+     *   - task_events       （关联表 — 删除指向已被清理 events 的行）
      *   - routing_events    (ts INTEGER, unix ms)
      *   - skill_invocations (timestamp INTEGER, unix ms)
-     *   - token_usage       (timestamp INTEGER, unix ms)
      *
-     * **不删** `sessions` 和 `tasks`：它们是用户可见的"会话历史 / 任务列表"，
-     * 删除会破坏 UI 体验。它们的体积也远小于事实表。
+     * **不删** 的表（按设计保留）：
+     *   - sessions / tasks       — 用户可见的"会话历史 / 任务列表"，
+     *                              删除会破坏 UI 体验；它们的体积也远小于
+     *                              事实表。
+     *   - kb_build_log           — 知识库构建审计日志，按 build_id 持久化，
+     *                              是审计 / 回溯依据。
+     *   - kb_query_log           — 知识库查询遥测，体积小且按需采样。
+     *                              如未来体量过大可单独窗口清理。
+     *   - injections             — 与 events 一一对应的注入审计；
+     *                              schema 已声明 ON DELETE CASCADE，但
+     *                              SQLite 默认未启用 `PRAGMA foreign_keys`，
+     *                              当前依赖体积自然衰减。如需主动清，
+     *                              再走与 task_events 同样的孤儿删除模式。
+     *
+     * **执行顺序**：先删 task_events 中指向 *将被* 删除 events 的行，
+     * 再删 events。否则 events 删完后 task_events 已经是孤儿，仍可清，
+     * 但顺序反过来会让 SQL 的 IN 子查询少一次范围。
      *
      * @param daysToKeep 保留最近多少天（默认 30）
      * @returns 各表删除行数（结构化以便上层做监控/日志）
      */
     cleanOldData(daysToKeep?: number): CleanOldDataResult;
-    /**
-     * @deprecated 仅清 events 表的窄接口。新代码请用 `cleanOldData(days)`。
-     * 保留是为了向后兼容现有 daemon / 测试，下个大版本删除。
-     */
-    cleanOldEvents(daysToKeep?: number): number;
     runMaintenance(maxSizeMb: number): void;
     vacuum(): void;
+    /**
+     * Reclaim free pages from the auto_vacuum=INCREMENTAL freelist back to the
+     * OS. Returns the number of pages reclaimed (0 if auto_vacuum is not
+     * INCREMENTAL or the freelist is empty).
+     *
+     * Each page is 4 KB (see base.ts page_size), so reclaiming 1000 pages frees
+     * about 4 MB. Bounded by `maxPages` to keep the writer-lock window short.
+     *
+     * Safe to call when auto_vacuum != INCREMENTAL — SQLite silently no-ops and
+     * we return 0.
+     */
+    incrementalVacuum(maxPages?: number): number;
     getDbSizeMb(): number;
 }
 //# sourceMappingURL=maintenance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../../src/core/storage/maintenance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,4BAA4B;AAC5B,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;gBADN,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM;IAGxB;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,UAAU,GAAE,MAAW,GAAG,kBAAkB;IAoBzD;;;OAGG;IACH,cAAc,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAgB/C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAavC,MAAM,IAAI,IAAI;IAId,WAAW,IAAI,MAAM;CAItB"}
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../../src/core/storage/maintenance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,4BAA4B;AAC5B,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;gBADN,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM;IAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,YAAY,CAAC,UAAU,GAAE,MAAW,GAAG,kBAAkB;IA+BzD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAavC,MAAM,IAAI,IAAI;IAId;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,QAAQ,GAAE,MAAa,GAAG,MAAM;IAgBlD,WAAW,IAAI,MAAM;CAItB"}

package/dist/core/storage/maintenance.js

@@ -17,12 +17,27 @@ export class MaintenanceOperations {
      *
      * 范围：
      *   - events            (timestamp TEXT, ISO)
+     *   - task_events       （关联表 — 删除指向已被清理 events 的行）
      *   - routing_events    (ts INTEGER, unix ms)
      *   - skill_invocations (timestamp INTEGER, unix ms)
-     *   - token_usage       (timestamp INTEGER, unix ms)
      *
-     * **不删** `sessions` 和 `tasks`：它们是用户可见的"会话历史 / 任务列表"，
-     * 删除会破坏 UI 体验。它们的体积也远小于事实表。
+     * **不删** 的表（按设计保留）：
+     *   - sessions / tasks       — 用户可见的"会话历史 / 任务列表"，
+     *                              删除会破坏 UI 体验；它们的体积也远小于
+     *                              事实表。
+     *   - kb_build_log           — 知识库构建审计日志，按 build_id 持久化，
+     *                              是审计 / 回溯依据。
+     *   - kb_query_log           — 知识库查询遥测，体积小且按需采样。
+     *                              如未来体量过大可单独窗口清理。
+     *   - injections             — 与 events 一一对应的注入审计；
+     *                              schema 已声明 ON DELETE CASCADE，但
+     *                              SQLite 默认未启用 `PRAGMA foreign_keys`，
+     *                              当前依赖体积自然衰减。如需主动清，
+     *                              再走与 task_events 同样的孤儿删除模式。
+     *
+     * **执行顺序**：先删 task_events 中指向 *将被* 删除 events 的行，
+     * 再删 events。否则 events 删完后 task_events 已经是孤儿，仍可清，
+     * 但顺序反过来会让 SQL 的 IN 子查询少一次范围。
      *
      * @param daysToKeep 保留最近多少天（默认 30）
      * @returns 各表删除行数（结构化以便上层做监控/日志）
@@ -32,32 +47,22 @@ export class MaintenanceOperations {
         cutoffDate.setDate(cutoffDate.getDate() - daysToKeep);
         const cutoffIso = cutoffDate.toISOString();
         const cutoffMs = cutoffDate.getTime();
+        // 1. task_events 先删 —— 用即将被删 events 的 event_id 做范围。
+        //    无自身 timestamp，必须借 events.timestamp 反向定位。
+        const taskEvents = this.db
+            .prepare(`DELETE FROM task_events
+         WHERE event_id IN (SELECT event_id FROM events WHERE timestamp < ?)`)
+            .run(cutoffIso).changes;
+        // 2. events
         const events = this.db.prepare(`DELETE FROM events WHERE timestamp < ?`).run(cutoffIso).changes;
+        // 3. 其它独立时间序列表
         const routing = this.db.prepare(`DELETE FROM routing_events WHERE ts < ?`).run(cutoffMs).changes;
         const skills = this.db.prepare(`DELETE FROM skill_invocations WHERE timestamp < ?`).run(cutoffMs).changes;
-        const tokens = this.db.prepare(`DELETE FROM token_usage WHERE timestamp < ?`).run(cutoffMs).changes;
-        const total = events + routing + skills + tokens;
+        const total = events + taskEvents + routing + skills;
         if (total > 0) {
-            logger.info(`[Storage] cleanOldData(${daysToKeep}d): events=${events}, routing=${routing}, skills=${skills}, tokens=${tokens}`);
-        }
-        return { events, routing, skills, tokens };
-    }
-    /**
-     * @deprecated 仅清 events 表的窄接口。新代码请用 `cleanOldData(days)`。
-     * 保留是为了向后兼容现有 daemon / 测试，下个大版本删除。
-     */
-    cleanOldEvents(daysToKeep = 30) {
-        const cutoffDate = new Date();
-        cutoffDate.setDate(cutoffDate.getDate() - daysToKeep);
-        const cutoff = cutoffDate.toISOString();
-        const result = this.db.prepare(`
-      DELETE FROM events WHERE timestamp < ?
-    `).run(cutoff);
-        const deleted = result.changes;
-        if (deleted > 0) {
-            logger.info(`[Storage] Cleaned ${deleted} events older than ${daysToKeep} days`);
+            logger.info(`[Storage] cleanOldData(${daysToKeep}d): events=${events}, taskEvents=${taskEvents}, routing=${routing}, skills=${skills}`);
         }
-        return deleted;
+        return { events, routing, skills, taskEvents };
     }
     runMaintenance(maxSizeMb) {
         const sizeMb = this.getDbSizeMb();
@@ -72,6 +77,33 @@ export class MaintenanceOperations {
     vacuum() {
         this.db.exec('VACUUM');
     }
+    /**
+     * Reclaim free pages from the auto_vacuum=INCREMENTAL freelist back to the
+     * OS. Returns the number of pages reclaimed (0 if auto_vacuum is not
+     * INCREMENTAL or the freelist is empty).
+     *
+     * Each page is 4 KB (see base.ts page_size), so reclaiming 1000 pages frees
+     * about 4 MB. Bounded by `maxPages` to keep the writer-lock window short.
+     *
+     * Safe to call when auto_vacuum != INCREMENTAL — SQLite silently no-ops and
+     * we return 0.
+     */
+    incrementalVacuum(maxPages = 1000) {
+        const before = this.db.pragma('freelist_count', { simple: true });
+        try {
+            this.db.exec(`PRAGMA incremental_vacuum(${Math.max(0, Math.floor(maxPages))})`);
+        }
+        catch (err) {
+            logger.warn(`[Storage] incremental_vacuum(${maxPages}) failed: ${err}`);
+            return 0;
+        }
+        const after = this.db.pragma('freelist_count', { simple: true });
+        const reclaimed = Math.max(0, Number(before) - Number(after));
+        if (reclaimed > 0) {
+            logger.info(`[Storage] incremental_vacuum reclaimed ${reclaimed} pages (~${(reclaimed * 4 / 1024).toFixed(1)} MB)`);
+        }
+        return reclaimed;
+    }
     getDbSizeMb() {
         if (!existsSync(this.dbPath))
             return 0;

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

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

package/dist/core/storage/pipeline-rollup.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Pipeline rollup — Phase 2d real-time orchestration link view.
+ *
+ * Given the most recent N UserPromptSubmit events, this module produces one
+ * `PipelineRow` per prompt with 5 status dots:
+ *
+ *   ① 接收     events.hook_type='UserPromptSubmit'
+ *   ② 意图     injections.source_handler='UserPromptSubmitHandler:intent'
+ *               (or :intent_fallback:L1/L2/L3 — see Phase 2a)
+ *   ③ KB+Skill  injections.source_handler='UserPromptSubmitHandler:kb'
+ *   ④ Spec      decisions row (kind='spec') keyed by approval_token
+ *   ⑤ 执行     tool_intercepts.decision + routing_events.routed_to_name
+ *
+ * Each dot is one of 4 states (P1 fix from doc-reviewer 2026-05-22):
+ *   - 'ok'      green — the step ran and produced a usable result
+ *   - 'fail'    red   — the step ran but the outcome was a refusal / failure
+ *   - 'skipped' light gray — the step was intentionally skipped by design
+ *                            (e.g. workflow_type='explore' does not generate
+ *                            a spec; KB miss is "skipped" not "missing")
+ *   - 'missing' dark gray  — the step should have produced data but didn't
+ *                            (possible bug or new module not wired up yet)
+ *
+ * The output is consumed by `src/web/routes/pipeline.ts` and rendered as
+ * 4-coloured circles in `web/src/pages/InsightsPipeline.tsx`.
+ *
+ * Performance note: we do 1 query for prompts + 5 batch queries for the rest,
+ * then assemble rows in memory. P95 stays < 50ms for 50 prompts on the dev
+ * dataset (988 prompts total). No SQL JOIN — see spec § 3.1 rationale.
+ */
+import type { SQLiteStorage } from './sqlite.js';
+export type DotStatus = 'ok' | 'fail' | 'skipped' | 'missing';
+export interface PipelineRow {
+    session_id: string;
+    /**
+     * task_id reverse-resolved via task_events. Null when the prompt has not
+     * been linked to a task yet (TaskSegmenter race / very old data).
+     *
+     * Added 2026-05-25 so the InsightsPipeline click handler can open the task
+     * drawer (TaskDetailContent — "what did this task actually do") instead of
+     * the noisy SessionDetailContent (entire session event firehose). The user
+     * complaint: "我想看的是任务的详细执行内容，你给我加载会话有什么用？"
+     */
+    task_id: string | null;
+    prompt_event_id: string | null;
+    prompt: string;
+    received_at: string;
+    project_path: string;
+    intent: {
+        workflow_type: string | null;
+        confidence: number | null;
+        suggested_agent: string | null;
+        fallback: boolean;
+        fallback_layer: number | null;
+    } | null;
+    kb: {
+        pages: Array<{
+            name: string;
+            score: number;
+        }>;
+    } | null;
+    spec: {
+        spec_path: string;
+        token: string;
+        status: string;
+    } | null;
+    exec: {
+        spawned_agent: string | null;
+        first_tool: string | null;
+        intercept_decision: 'allow' | 'deny' | 'warn' | 'bypass' | 'dry_run';
+        intercept_outcome: string | null;
+        routing_obeyed: number | null;
+    } | null;
+    status_dots: [DotStatus, DotStatus, DotStatus, DotStatus, DotStatus];
+}
+/**
+ * 4-state status dot computation.
+ *
+ * The semantics distinguish "no data because nothing should have run" from
+ * "no data because something should have run but didn't" — important when
+ * the user is diagnosing whether a step is broken vs not applicable.
+ *
+ * @internal exported for testing.
+ */
+export declare function computeDots(row: {
+    intent: PipelineRow['intent'];
+    kb: PipelineRow['kb'];
+    spec: PipelineRow['spec'];
+    exec: PipelineRow['exec'];
+}): PipelineRow['status_dots'];
+export interface QueryPipelineRowsOpts {
+    /** How many recent prompts to return. Clamped 1..200. */
+    limit: number;
+    /** Optional project filter (exact match against events.project_path). */
+    projectPath?: string;
+    /**
+     * Single-prompt mode (DetailDrawer `?event_id=<id>`). When set, the rollup
+     * returns AT MOST one row — the pipeline link for exactly this prompt's
+     * UserPromptSubmit event — bypassing the `limit`/`projectPath` recent-N
+     * window. This is required because the drawer can open an arbitrarily-old
+     * prompt that would otherwise fall outside the default limit=50 set and
+     * silently 404 / come back empty. Returns `[]` when the id is unknown or the
+     * event is not a UserPromptSubmit.
+     */
+    eventId?: string;
+}
+/**
+ * Build the pipeline view: most-recent-N UserPromptSubmit events joined
+ * in-memory with the 5 downstream signal streams.
+ */
+export declare function queryPipelineRows(storage: SQLiteStorage, opts: QueryPipelineRowsOpts): PipelineRow[];
+//# sourceMappingURL=pipeline-rollup.d.ts.map

package/dist/core/storage/pipeline-rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-rollup.d.ts","sourceRoot":"","sources":["../../../src/core/storage/pipeline-rollup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAajD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC;QAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,GAAG,IAAI,CAAC;IAET,EAAE,EAAE;QACF,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/C,GAAG,IAAI,CAAC;IAET,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI,CAAC;IAET,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,kBAAkB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;QACrE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,GAAG,IAAI,CAAC;IAET,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;CACtE;AA4LD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE;IAC/B,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3B,GAAG,WAAW,CAAC,aAAa,CAAC,CAkF7B;AAED,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,qBAAqB,GAC1B,WAAW,EAAE,CA2Ef"}