@winspan/claude-forge 8.54.3 → 9.2.0

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

@@ -17,15 +17,62 @@ interface UpsertCapableEmitter extends EventEmitter {
 export declare class EventOperations {
     private db;
     private emitter;
+    private readonly writeEventStmt;
     constructor(db: Database.Database, emitter: UpsertCapableEmitter);
     writeEvent(event: ForgeEvent): void;
     queryEvents(filter: {
         session_id?: string;
         project_path?: string;
         hook_type?: string;
+        /**
+         * Inclusive lower bound on `timestamp` (ISO string).
+         * Used by incremental scans (e.g. PreToolUseHandler edited-files cache, F7
+         * fix) to avoid re-reading the entire session history on every call.
+         */
+        since?: string;
         limit?: number;
         offset?: number;
     }): ForgeEvent[];
+    /**
+     * Fetch a single event by its primary key (`event_id`), or null when absent.
+     *
+     * Unlike {@link queryEvents}, this does a point lookup (`WHERE event_id = ?`)
+     * so it never depends on a `limit` window — the pipeline drawer's
+     * `?event_id=<id>` branch needs to locate an arbitrarily-old prompt that may
+     * be far beyond the most-recent-N set the default rollup scans.
+     */
+    getEventById(eventId: string): ForgeEvent | null;
+    /**
+     * Slim variant of queryEvents used by `/api/insights/timeline` (audit F5).
+     *
+     * Drops `tool_output` and `ai_response` from the SELECT — those columns
+     * dominate row size on tool-heavy sessions (PostToolUse rows can carry
+     * MB-scale JSON each), so omitting them cuts both transport bytes and the
+     * per-row JSON.parse cost handled inside this method.
+     *
+     * Adds an optional `before_ts` cursor (exclusive, `timestamp < ?`) for
+     * descending pagination — keeps the existing `limit` semantics and is
+     * additive so callers that don't pass it behave exactly like before.
+     *
+     * NOT a generic queryEvents overload: dropping output columns would
+     * silently break any caller that relies on `tool_output` / `ai_response`.
+     */
+    queryEventsTimeline(filter: {
+        session_id: string;
+        hook_type?: string;
+        limit?: number;
+        /** Rows strictly older than this ISO ts (timestamp < ?). */
+        before_ts?: string;
+    }): Array<{
+        event_id: string;
+        session_id: string;
+        project_path: string;
+        timestamp: string;
+        hook_type: ForgeEvent['hook_type'];
+        tool_name: string | undefined;
+        tool_input: Record<string, unknown> | undefined;
+        user_prompt: string | undefined;
+    }>;
     countEvents(filter?: {
         session_id?: string;
         project_path?: string;
@@ -36,7 +83,8 @@ export declare class EventOperations {
      * Reduces data transfer by filtering events before sending to client.
      */
     searchEvents(filter: {
-        session_id: string;
+        /** Optional — omit to search the entire events table (for the topbar quick-search). */
+        session_id?: string;
         query?: string;
         tool_name?: string;
         hook_type?: string;
@@ -73,7 +121,14 @@ export declare class EventOperations {
         hook_type: string;
         count: number;
     }>;
-    /** Agent/Task subagent_type distribution for a single session (json_extract from tool_input). */
+    /**
+     * Agent/Task subagent_type distribution for a single session.
+     *
+     * Was a single SQL with `json_extract(tool_input, '$.subagent_type')` —
+     * incompatible with the gzip codec. Refactored to: SELECT raw tool_input
+     * for matching events, JS-decode each row via the codec, bucket in JS.
+     * Per-session scan is tiny (≤ a few hundred Task/Agent rows in practice).
+     */
     aggregateAgentTypeBySession(session_id: string): Array<{
         agent_type: string | null;
         count: number;
@@ -102,14 +157,34 @@ export declare class EventOperations {
         since: string;
         until: string;
     }): string[];
+    /**
+     * Outcome classifier (spec 1100 v2): count a SESSION's Edit/Write intent
+     * events. Reads only `tool_name` (never the gzip `tool_input`), so it is
+     * always correct. Drives the session-level `edit_intent_count` signal
+     * (>0 → success, ==0 → answered). PreToolUse only, so a single logical edit
+     * (Pre+Post) counts once.
+     */
+    countEditIntentEventsBySession(sessionId: string): number;
     /**
      * PostToolUse failure rate within [since, until).
      *
-     * Failure detection uses three LIKE branches on tool_output (preserved from
-     * weekly-report.ts original SQL):
-     *   - '%"error"%'
-     *   - '%"is_error":true%'
-     *   - '%"isError":true%'
+     * Was three SQL `LIKE` branches on `tool_output` — incompatible with the gzip
+     * codec: any tool_output >= TINY_INPUT_BYTES is stored as gzip bytes, so the
+     * LIKE could never match and failures buried in large (stack-trace) outputs
+     * were silently dropped, deflating the weekly-report failure rate. Refactored
+     * to "decode at read time": SELECT raw tool_output for the PostToolUse rows,
+     * `decodeToolOutput` each via the codec (transparently handles gzip Buffer,
+     * tiny-UTF-8 Buffer, and legacy plain text — `JSON.parse` fallback covers
+     * pre-codec plain rows), then apply the same three-marker heuristic in JS.
+     * Same pattern as `aggregateAgentTypeBySession` (:483).
+     *
+     * Failure markers (semantically equivalent to the original LIKE branches):
+     *   - top-level `error` key present  (was `'%"error"%'`)
+     *   - `is_error === true`            (was `'%"is_error":true%'`)
+     *   - `isError === true`             (was `'%"isError":true%'`)
+     *
+     * Non-hot path (weekly-report generation, user-triggered), so the per-row
+     * decode cost is acceptable.
      */
     aggregateToolFailureRate(opts: {
         since: string;
@@ -120,7 +195,14 @@ export declare class EventOperations {
     };
     /**
      * Raw tool_input JSON strings for file-edit tools within [since, until).
-     * Caller is responsible for JSON.parse / file_path extraction.
+     *
+     * gzip codec note: the on-disk column is now binary for new rows. To
+     * preserve the existing caller contract (caller does `JSON.parse(row.tool_input)`),
+     * we decode each row via the codec inside this method and re-stringify back
+     * to JSON text on the way out. Net: callers see the same `Array<{tool_input: string}>`
+     * shape as before. Bytes-per-row pays the gzip → JSON.stringify cost but
+     * the row counts here are small (weekly anti-pattern-detector ≈ a few thousand).
+     *
      * Internal IN-list expansion of `tool_names`.
      */
     queryFileEditInputs(opts: {
@@ -130,6 +212,28 @@ export declare class EventOperations {
     }): Array<{
         tool_input: string;
     }>;
+    /**
+     * NULL out `tool_input` for events older than `cutoffIso` in batches.
+     *
+     * Only touches rows where `tool_input IS NOT NULL` so repeat-runs are
+     * idempotent. Returns the row count that was updated this pass.
+     *
+     * `maxRows` bounds the SQL UPDATE via a LIMIT-style sub-SELECT — SQLite
+     * doesn't support `UPDATE ... LIMIT` without compile-time flag, so we
+     * use `WHERE event_id IN (SELECT event_id FROM events WHERE ... LIMIT ?)`.
+     */
+    expireToolInputBatch(cutoffIso: string, maxRows: number): number;
+    /**
+     * DELETE events older than `cutoffIso`, plus orphan task_events rows, in
+     * one transaction. Returns counters per table for logging.
+     *
+     * `maxRows` caps the events delete to keep writer lock short. task_events
+     * pruning is bounded by the events delete via the IN-subquery.
+     */
+    deleteEventsByCutoff(cutoffIso: string, maxRows: number): {
+        events: number;
+        taskEvents: number;
+    };
     /** Full events in [since, until?), ascending by timestamp (used by anti-pattern-detector). */
     queryEventsByTimeRange(opts: {
         since: string;

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

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