@winspan/claude-forge 8.54.4 → 9.12.0

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

@@ -1 +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;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAuB7C;;;;;;;;OAQG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAwB3D,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"}
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/core/storage/sessions.ts"],"names":[],"mappings":"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"}

package/dist/core/storage/sessions.js

@@ -5,24 +5,26 @@
  * - upsertSession：每次 writeEvent 后被调用，更新 sessions 聚合
  * - querySessions：直接读聚合表，O(sessions) 而非 O(sessions × events)
  */
+import { decodeToolInput } from './codec/tool-input-codec.js';
+import { daysAgoMs } from '../utils/time.js';
+// TODO (storage-perf follow-up, 2026-05-26): un-cached this.db.prepare(...)
+// callsites in SessionOperations — promote to constructor Statement fields
+// in a future sweep. Hot path (upsertSession, fires per event) is cached.
+//
+//   - getSession                  (line ~93)
+//   - getSessionWithMetrics       (lines ~124, ~165)
+//   - querySessions               (line ~230)
+//   - aggregateEventCount         (line ~340)
+//   - aggregateDailyCounts        (line ~355)
+//   - getAgentBoardSessions       (lines ~522, ~543)
+//
+// Cached now: upsertSessionStmt (fires once per event → hottest).
 export class SessionOperations {
     db;
+    upsertSessionStmt;
     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(`
+        this.upsertSessionStmt = db.prepare(`
       INSERT INTO sessions (
         session_id, project_path, status, first_prompt,
         start_time, end_time, last_event_time, event_count
@@ -41,7 +43,20 @@ export class SessionOperations {
         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);
+    }
+    /**
+     * 将事件聚合到 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;
+        this.upsertSessionStmt.run(event.session_id, event.project_path, firstPrompt, event.timestamp, event.timestamp, event.timestamp);
     }
     /**
      * Look up a session by exact PK (`session_id`).
@@ -73,6 +88,51 @@ export class SessionOperations {
             end_time: row.end_time,
         };
     }
+    /**
+     * Phase 3 (master roadmap §2): fetch a session row with the rollup metric
+     * columns and outcome classification attached. Used by the Web timeline
+     * endpoint header so the React page can show intercept / KB / skill chips
+     * without a second round-trip.
+     *
+     * Accepts either a full PK or a >=8 char prefix (parity with getSession).
+     */
+    getSessionWithMetrics(idOrPrefix) {
+        if (!idOrPrefix)
+            return null;
+        const exact = this.db
+            .prepare(`SELECT session_id, project_path, first_prompt, event_count, start_time,
+                COALESCE(end_time, last_event_time, start_time) AS end_time,
+                outcome, outcome_reason,
+                intercept_count, kb_inject_count, skill_match_count
+         FROM sessions WHERE session_id = ? LIMIT 1`)
+            .get(idOrPrefix);
+        const row = exact
+            ?? (idOrPrefix.length >= 8
+                ? this.db
+                    .prepare(`SELECT session_id, project_path, first_prompt, event_count, start_time,
+                      COALESCE(end_time, last_event_time, start_time) AS end_time,
+                      outcome, outcome_reason,
+                      intercept_count, kb_inject_count, skill_match_count
+               FROM sessions WHERE session_id LIKE ? || '%'
+               ORDER BY start_time DESC LIMIT 1`)
+                    .get(idOrPrefix)
+                : undefined);
+        if (!row)
+            return null;
+        return {
+            session_id: row.session_id,
+            project_path: row.project_path || null,
+            first_prompt: row.first_prompt || '',
+            event_count: row.event_count ?? 0,
+            start_time: row.start_time,
+            end_time: row.end_time,
+            outcome: row.outcome ?? null,
+            outcome_reason: row.outcome_reason || null,
+            intercept_count: row.intercept_count ?? 0,
+            kb_inject_count: row.kb_inject_count ?? 0,
+            skill_match_count: row.skill_match_count ?? 0,
+        };
+    }
     /**
      * Look up a session by a session_id prefix. Used by web routes that accept
      * short ids from the URL bar.
@@ -114,6 +174,10 @@ export class SessionOperations {
             conditions.push('project_path = ?');
             params.push(filter.project_path);
         }
+        if (filter.search) {
+            conditions.push('first_prompt LIKE ?');
+            params.push(`%${filter.search}%`);
+        }
         const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
         const limit = filter.limit ?? 10;
         const sql = `
@@ -139,6 +203,85 @@ export class SessionOperations {
         }));
     }
     // ── H2: 聚合 / 计数方法 ───────────────────────────────────────────────
+    /**
+     * 写入 outcome 归因字段（v9.x outcome instrumentation）。
+     *
+     * 字段语义：
+     * - outcome: success/partial/failed/abandoned；null 表示尚未分类（不要覆盖）
+     * - outcome_reason: 自由文本，归因依据短文本（例 "commit+no_violation"）
+     * - commit_count / reverted_commits / user_violation_count: 信号原值，
+     *   保留下来便于回测调参 & 在 web 上展示
+     * - classified_at: ISO timestamp of classification call
+     *
+     * 调用方：daemon Stop handler；backfill 脚本；测试。
+     * 容错：每个字段都是可选；只更新提供的字段，避免误覆盖。
+     */
+    updateSessionOutcome(sessionId, updates) {
+        const sets = [];
+        const params = [];
+        if (updates.outcome !== undefined) {
+            sets.push('outcome = ?');
+            params.push(updates.outcome);
+        }
+        if (updates.outcome_reason !== undefined) {
+            sets.push('outcome_reason = ?');
+            params.push(updates.outcome_reason);
+        }
+        if (updates.commit_count !== undefined) {
+            sets.push('commit_count = ?');
+            params.push(updates.commit_count);
+        }
+        if (updates.reverted_commits !== undefined) {
+            sets.push('reverted_commits = ?');
+            params.push(updates.reverted_commits);
+        }
+        if (updates.user_violation_count !== undefined) {
+            sets.push('user_violation_count = ?');
+            params.push(updates.user_violation_count);
+        }
+        if (updates.classified_at !== undefined) {
+            sets.push('classified_at = ?');
+            params.push(updates.classified_at);
+        }
+        if (sets.length === 0)
+            return;
+        params.push(sessionId);
+        this.db
+            .prepare(`UPDATE sessions SET ${sets.join(', ')}, updated_at = datetime('now') WHERE session_id = ?`)
+            .run(...params);
+    }
+    /**
+     * Phase 2 metrics rollup: 回填本 session 的三个事实表行数到 sessions 表。
+     *
+     * 调用方：Stop handler 在 classifyAndPersistOutcome 之后；这里只做写，不做
+     * 聚合逻辑（由 caller 用 facade 的 countToolInterceptsBySession /
+     * countInjectionsBySessionByHandler / countSkillInvocationsBySession 计算）。
+     *
+     * 容错：每个字段都是可选；只更新提供的字段。和 updateSessionOutcome 对称，
+     * 不重置未提供的列，避免被两个调用点互相覆盖。
+     */
+    updateSessionMetrics(sessionId, updates) {
+        const sets = [];
+        const params = [];
+        if (updates.interceptCount !== undefined) {
+            sets.push('intercept_count = ?');
+            params.push(updates.interceptCount);
+        }
+        if (updates.kbInjectCount !== undefined) {
+            sets.push('kb_inject_count = ?');
+            params.push(updates.kbInjectCount);
+        }
+        if (updates.skillMatchCount !== undefined) {
+            sets.push('skill_match_count = ?');
+            params.push(updates.skillMatchCount);
+        }
+        if (sets.length === 0)
+            return;
+        params.push(sessionId);
+        this.db
+            .prepare(`UPDATE sessions SET ${sets.join(', ')}, updated_at = datetime('now') WHERE session_id = ?`)
+            .run(...params);
+    }
     /** Total session row count. */
     countAllSessions() {
         const row = this.db.prepare('SELECT COUNT(*) as cnt FROM sessions').get();
@@ -185,6 +328,35 @@ export class SessionOperations {
             end_time: r.end_time,
         }));
     }
+    /**
+     * Phase 9.5 idle-session sweeper input.
+     *
+     * Sessions whose `outcome` is still NULL (never reached Stop hook — abnormal
+     * exit, experimental synthetic events, etc.) AND whose effective "last
+     * activity" timestamp is older than `cutoffIso`. We use
+     * `COALESCE(last_event_time, start_time)` so sessions that never recorded a
+     * non-UserPromptSubmit event still age out by their start time.
+     *
+     * Ordered by oldest-first so under a `LIMIT` cap the worst offenders go
+     * first (defensive against backlog bursts).
+     */
+    queryIdleUnclassifiedSessions(cutoffIso, limit) {
+        const rows = this.db.prepare(`
+      SELECT session_id, start_time, last_event_time, event_count, user_violation_count
+      FROM sessions
+      WHERE outcome IS NULL
+        AND COALESCE(last_event_time, start_time) < ?
+      ORDER BY COALESCE(last_event_time, start_time) ASC
+      LIMIT ?
+    `).all(cutoffIso, limit);
+        return rows.map(r => ({
+            session_id: r.session_id,
+            start_time: r.start_time,
+            last_event_time: r.last_event_time ?? null,
+            event_count: r.event_count ?? null,
+            user_violation_count: r.user_violation_count ?? null,
+        }));
+    }
     /** Count of sessions with start_time in [since, until?). */
     countSessionsByRange(opts) {
         const conditions = ['start_time >= ?'];
@@ -197,5 +369,170 @@ export class SessionOperations {
         const row = this.db.prepare(sql).get(...params);
         return row?.cnt ?? 0;
     }
+    /**
+     * Session-centric agent board projection (v2 rewrite, 2026-05-22).
+     *
+     * Returns one row per session in [since, now] with everything a Kanban card
+     * needs to show "what actually happened in this work unit":
+     *   - first user prompt (truncated)
+     *   - tool usage Top-3 (PostToolUse hook_type only)
+     *   - spawned subagents Top-3 (Task tool input.subagent_type)
+     *   - distinct edited files count + sample (Edit / Write tool_input.file_path)
+     *   - matched skills (skill_invocations)
+     *   - KB injection GROUP_CONCAT (route reshapes into page list)
+     *   - tool intercept decision counts (deny / warn / dry_run)
+     *   - git commit Bash count (heuristic: tool_input.command LIKE '%git commit%')
+     *   - session outcome + last_event_time so the route can lane-bucket
+     *
+     * Single SQL with correlated subqueries — every subquery hits a covered
+     * index (idx_events_session_hook / idx_tool_intercepts_session /
+     * idx_skill_invocations_session / idx_injections_session_handler), so the
+     * per-session fan-out is cheap. Limit-clamped 1..200.
+     */
+    queryAgentBoardSessions(opts) {
+        const limit = Math.min(Math.max(opts.limit ?? 100, 1), 200);
+        const sinceMs = daysAgoMs(opts.windowDays);
+        const since = new Date(sinceMs).toISOString();
+        const params = [since];
+        let projectFilter = '';
+        if (opts.projectPath) {
+            projectFilter = 'AND s.project_path = ?';
+            params.push(opts.projectPath);
+        }
+        params.push(limit);
+        // Top-level SQL: every aggregate that does NOT touch `tool_input`. The
+        // four tool_input-derived columns (spawned_json / files_changed /
+        // last_file / bash_commit_count) used to be sub-SELECTs with
+        // json_extract / LIKE on tool_input. They're incompatible with the gzip
+        // codec, so we build them in JS below via a single batched SELECT over
+        // the candidate PostToolUse rows + codec decode.
+        const sql = `
+      SELECT
+        s.session_id            AS session_id,
+        s.project_path          AS project_path,
+        s.first_prompt          AS first_prompt,
+        s.start_time            AS start_time,
+        COALESCE(s.last_event_time, s.end_time, s.start_time) AS last_event_time,
+        COALESCE(s.end_time, s.last_event_time, s.start_time) AS end_time,
+        s.event_count           AS event_count,
+        s.outcome               AS outcome,
+        s.outcome_reason        AS outcome_reason,
+        s.intercept_count       AS intercept_count,
+        s.kb_inject_count       AS kb_inject_count,
+        s.skill_match_count     AS skill_match_count,
+        s.commit_count          AS commit_count,
+        s.user_violation_count  AS user_violation_count,
+        (SELECT json_group_array(json_object('tool', tool_name, 'n', cnt))
+           FROM (SELECT tool_name, COUNT(*) AS cnt FROM events
+                  WHERE session_id = s.session_id
+                    AND hook_type = 'PostToolUse'
+                    AND tool_name IS NOT NULL
+                  GROUP BY tool_name ORDER BY cnt DESC LIMIT 3)) AS top_tools_json,
+        (SELECT SUM(CASE WHEN decision = 'deny' THEN 1 ELSE 0 END)
+           FROM tool_intercepts WHERE session_id = s.session_id) AS deny_count,
+        (SELECT SUM(CASE WHEN decision = 'warn' THEN 1 ELSE 0 END)
+           FROM tool_intercepts WHERE session_id = s.session_id) AS warn_count,
+        (SELECT SUM(CASE WHEN decision = 'dry_run' THEN 1 ELSE 0 END)
+           FROM tool_intercepts WHERE session_id = s.session_id) AS dryrun_count,
+        (SELECT json_group_array(DISTINCT skill_id)
+           FROM skill_invocations WHERE session_id = s.session_id) AS skills_json,
+        (SELECT GROUP_CONCAT(metadata_json, '||')
+           FROM injections
+          WHERE session_id = s.session_id
+            AND source_handler = 'UserPromptSubmitHandler:kb') AS kb_meta_concat
+      FROM sessions s
+      WHERE s.start_time >= ?
+        ${projectFilter}
+      ORDER BY COALESCE(s.last_event_time, s.start_time) DESC
+      LIMIT ?
+    `;
+        const baseRows = this.db.prepare(sql).all(...params);
+        if (baseRows.length === 0)
+            return baseRows;
+        // ── JS-side tool_input-derived aggregations (codec replacement) ──────
+        //
+        // Single SELECT batched over the candidate sessions for every event that
+        // could feed any of the 4 derived fields. Then bucket per-session in JS.
+        const sessionIds = baseRows.map(r => r.session_id);
+        const sessionPh = sessionIds.map(() => '?').join(',');
+        const candidateRows = this.db.prepare(`
+      SELECT session_id, tool_name, tool_input, timestamp
+        FROM events
+       WHERE session_id IN (${sessionPh})
+         AND hook_type = 'PostToolUse'
+         AND tool_input IS NOT NULL
+         AND tool_name IN ('Task', 'Agent', 'Edit', 'Write', 'NotebookEdit', 'Bash')
+    `).all(...sessionIds);
+        // Per-session aggregates
+        const spawnedBySession = new Map(); // session → (subagent_type → cnt)
+        const filesBySession = new Map(); // session → distinct file_paths
+        const lastFileBySession = new Map();
+        const bashCommitBySession = new Map();
+        for (const ev of candidateRows) {
+            let decoded = null;
+            try {
+                const d = decodeToolInput(ev.tool_input);
+                if (d && typeof d === 'object' && !Array.isArray(d)) {
+                    decoded = d;
+                }
+            }
+            catch {
+                continue;
+            }
+            if (!decoded)
+                continue;
+            if (ev.tool_name === 'Task' || ev.tool_name === 'Agent') {
+                const subType = decoded.subagent_type;
+                if (typeof subType === 'string' && subType.length > 0) {
+                    let m = spawnedBySession.get(ev.session_id);
+                    if (!m) {
+                        m = new Map();
+                        spawnedBySession.set(ev.session_id, m);
+                    }
+                    m.set(subType, (m.get(subType) ?? 0) + 1);
+                }
+            }
+            else if (ev.tool_name === 'Edit' || ev.tool_name === 'Write' || ev.tool_name === 'NotebookEdit') {
+                const filePath = decoded.file_path;
+                if (typeof filePath === 'string' && filePath.length > 0) {
+                    let set = filesBySession.get(ev.session_id);
+                    if (!set) {
+                        set = new Set();
+                        filesBySession.set(ev.session_id, set);
+                    }
+                    set.add(filePath);
+                    const cur = lastFileBySession.get(ev.session_id);
+                    if (!cur || ev.timestamp > cur.ts) {
+                        lastFileBySession.set(ev.session_id, { file: filePath, ts: ev.timestamp });
+                    }
+                }
+            }
+            else if (ev.tool_name === 'Bash') {
+                const cmd = decoded.command;
+                if (typeof cmd === 'string' && cmd.includes('git commit')) {
+                    bashCommitBySession.set(ev.session_id, (bashCommitBySession.get(ev.session_id) ?? 0) + 1);
+                }
+            }
+        }
+        // Merge per-session aggregates back onto baseRows in the same row shape.
+        for (const row of baseRows) {
+            const sid = row.session_id;
+            const spawnMap = spawnedBySession.get(sid);
+            if (spawnMap && spawnMap.size > 0) {
+                const top3 = Array.from(spawnMap.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, 3)
+                    .map(([type, n]) => ({ type, n }));
+                row.spawned_json = JSON.stringify(top3);
+            }
+            else {
+                row.spawned_json = '[]';
+            }
+            row.files_changed = filesBySession.get(sid)?.size ?? 0;
+            row.last_file = lastFileBySession.get(sid)?.file ?? null;
+            row.bash_commit_count = bashCommitBySession.get(sid) ?? 0;
+        }
+        return baseRows;
+    }
 }
 //# sourceMappingURL=sessions.js.map

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

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

@@ -7,14 +7,24 @@ import type Database from 'better-sqlite3';
 import type { SkillInvocationRow } from './rows.js';
 export declare class SkillOperations {
     private db;
+    private readonly writeSkillInvocationStmt;
     constructor(db: Database.Database);
     writeSkillInvocation(row: Omit<SkillInvocationRow, 'created_at'>): void;
+    /**
+     * One-shot back-fill of skill_invocations.project_path from
+     * sessions.project_path (decision 39839e30 Part 2). Public test seam mirroring
+     * the boot-time migration (base.backfillSkillInvocationsProjectPathIfNeeded).
+     * Idempotent: only NULL rows whose session JOINs a sessions row with a
+     * non-NULL project_path are touched. Returns rows-affected.
+     */
+    backfillSkillInvocationProjectPath(): number;
     querySkillInvocations(filter?: {
         route_request_id?: string;
         session_id?: string;
         skill_id?: string;
         since?: number;
         limit?: number;
+        projectPath?: string;
     }): SkillInvocationRow[];
     /**
      * H1: 按 skill_id 聚合调用总数 / 成功 / 失败。
@@ -29,12 +39,86 @@ export declare class SkillOperations {
         since: number;
         until?: number;
         limit?: number;
+        projectPath?: string;
     }): Array<{
         skill_id: string;
         total: number;
         success: number;
         failed: number;
     }>;
+    /**
+     * audit #2 (decision f61b8a0c): per-skill split of "injected" vs "really
+     * invoked" rows in skill_invocations.
+     *
+     * - `injected`  = rows stamped `recorded_at_inject = 1` (UserPromptSubmit
+     *   auto-match wrote them at inject time; NOT proof the skill was followed).
+     * - `invoked`   = rows with `recorded_at_inject IS NULL` (real-call rows:
+     *   MCP skill_invoke / Skill tool, plus legacy rows predating the column).
+     *
+     * Web "skill effectiveness" surfaces must read `invoked`, not `injected`.
+     * Walks `idx_skill_invocations_timestamp`.
+     */
+    aggregateSkillInjectVsInvoke(filter: {
+        since: number;
+        until?: number;
+        limit?: number;
+        projectPath?: string;
+    }): Array<{
+        skill_id: string;
+        injected: number;
+        invoked: number;
+        /**
+         * decision 76be4e4a: per-skill GENUINE agent invoke count — the authoritative
+         * "Skill 调用" 口径. Genuine = `invocation_type = 'cli'` (a deliberate
+         * `cf skill invoke` agent pull) AND `recorded_at_inject IS NULL` (not an
+         * inject-time auto-write). This DELIBERATELY excludes the legacy `dynamic`
+         * keyword-matcher rows (reason "Auto-matched by keyword matching") that
+         * `invoked` still counts, and all injected rows.
+         */
+        genuine: number;
+        total: number;
+    }>;
+    /**
+     * decision 76be4e4a: authoritative "Skill 调用" headline count — total GENUINE
+     * agent invocations across all skills in the window. Genuine =
+     * `invocation_type = 'cli' AND recorded_at_inject IS NULL` (a deliberate
+     * `cf skill invoke` agent pull that is not an inject-time auto-write).
+     *
+     * This is the single口径 the Workplace KPI and the Skill page header both read
+     * so they agree. It excludes:
+     *   - `dynamic` keyword-matcher rows (reason "Auto-matched by keyword matching")
+     *     — historical auto-matches, NOT deliberate calls (the old `invoked`口径
+     *     wrongly counted them, inflating to ~166).
+     *   - injected rows (`recorded_at_inject = 1`).
+     * It is NOT events.tool_name `realCalls` (=2, the MCP/Skill-tool path the main
+     * thread rarely uses — a different, far smaller口径).
+     *
+     * Walks `idx_skill_invocations_project` when projectPath is set, else
+     * `idx_skill_invocations_timestamp`.
+     */
+    countGenuineSkillInvocations(filter: {
+        since: number;
+        until?: number;
+        projectPath?: string;
+    }): number;
+    /**
+     * audit #2: count of REAL skill calls from the `events` table — the only
+     * ground truth for "a skill was actually invoked". Reads only `tool_name`
+     * (never the gzip `tool_input`/`tool_output`), matching the documented
+     * gzip-content landmine guard.
+     *
+     * `tool_name` matched:
+     *   - 'Skill'                           (Claude Code native Skill tool)
+     *   - 'mcp__claude-forge__skill_invoke' (forge MCP skill_invoke mirror)
+     *
+     * `since` / `until` are unix ms; events.timestamp is an ISO string, so we
+     * compare on the ISO form (same convention as other event aggregates).
+     */
+    countRealSkillCalls(filter: {
+        since: number;
+        until?: number;
+        projectPath?: string;
+    }): number;
     /**
      * 按 route_request_id 聚合工作流进度。
      *
@@ -63,5 +147,81 @@ export declare class SkillOperations {
     countDistinctSkillsSince(since_ms: number): number;
     /** Distinct skill_id values for a single session. */
     queryDistinctSkillIdsBySession(session_id: string): string[];
+    /**
+     * Stamp `usefulness` + `usefulness_note` onto the SINGLE most-recent un-rated
+     * skill_invocations row matching `session_id + skill_id` (usefulness IS NULL).
+     *
+     * Deterministic target rule: `ORDER BY timestamp DESC LIMIT 1` inside a
+     * subquery so we update exactly one row. Idempotent: only NULL rows are
+     * eligible, so re-running stamps the next-older un-rated pull (or affects 0
+     * once all are rated). Optional `sinceMs` guard avoids stamping a stale
+     * unrelated pull. Returns rows-affected (0 = nothing to stamp — caller treats
+     * that as a soft no-op, never an error).
+     */
+    writeSkillUsefulness(args: {
+        session_id: string;
+        skill_id: string;
+        usefulness: string;
+        note?: string | null;
+        sinceMs?: number;
+    }): number;
+    /**
+     * Per-skill usefulness aggregation — the P1 refinement consumer's input.
+     *
+     * GROUP BY skill_id over rows that HAVE a usefulness rating
+     * (`usefulness IS NOT NULL`). `actionable_rate = helped / total_rated`
+     * (STRICT helped-only, per decision d24cd3a2 Q3). Un-rated pulls are reported
+     * separately as `pending` (NOT in the rate denominator). Sorted worst
+     * actionable_rate FIRST so the least-useful skills surface for refinement;
+     * ties broken by higher total_rated (more evidence first). Walks
+     * `idx_skill_invocations_timestamp`.
+     */
+    aggregateSkillUsefulness(filter?: {
+        since?: number;
+        until?: number;
+        limit?: number;
+        projectPath?: string;
+    }): Array<{
+        skill_id: string;
+        total_rated: number;
+        helped: number;
+        partial: number;
+        not_actionable: number;
+        pending: number;
+        actionable_rate: number;
+    }>;
+    /**
+     * Per-(agent, skill) usefulness aggregation — the (agent,skill) pairing
+     * closed-loop metric input for Agent 体检 (decision 234f1ad4, Phase 1).
+     *
+     * Grouping key is the `reason` workflow PREFIX
+     * (`substr(reason,1,instr(reason,'/')-1)`) × `skill_id`, NOT `agent_id`:
+     * `skill_invocations.agent_id` is empirically all-NULL across the whole DB
+     * (the CLI `cf skill invoke` path never wrote it; only MCP did, and subagents
+     * have zero MCP — see spec increment P1-1 / Q6). The reason prefix is the
+     * proxy agent key that today carries real per-agent data
+     * (coder/verify/decision/safetynet/planner/harness).
+     *
+     * Only rows with a parseable `<x>/<y>` reason and `invocation_type='cli'` are
+     * counted; rows whose reason has no `/` are归入 the `<unknown>` bucket and not
+     * attributed to any real agent (per spec compat note). `timestamp` is INTEGER
+     * ms. `actionable_rate = helped / total_rated` (STRICT helped-only, d24cd3a2 Q3).
+     */
+    aggregateSkillUsefulnessByAgent(filter?: {
+        since?: number;
+        until?: number;
+        projectPath?: string;
+        limit?: number;
+    }): Array<{
+        agent: string;
+        skill_id: string;
+        pulls: number;
+        helped: number;
+        partial: number;
+        not_actionable: number;
+        total_rated: number;
+        pending: number;
+        actionable_rate: number;
+    }>;
 }
 //# sourceMappingURL=skills.d.ts.map