@app-vitals/agent-lib 0.16.2 → 1.1.0

package/task-store-types.ts

@@ -1,3256 +0,0 @@
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-
-export interface paths {
-    "/tasks": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List tasks
-         * @description Returns `{ tasks, total, limit, offset, scopeDegraded }`. `?ready=true` (or `?state=ready`) is an unpaginated convenience endpoint that computes over the whole dependency graph and returns only tasks that are `pending`, non-HITL, non-autonomous-plan-session, free of a fresh same-branch in-progress sibling, and fully dependency-satisfied — always oldest-first. `?state=blocked` similarly walks the whole graph to compute each task's `blockedBy` entries. Agent tokens with repo scope see the OR union of tasks assigned to them and unassigned pool tasks in their scoped repos; agent tokens without repo scope see only their own assigned tasks; admin tokens see everything matching the filters.
-         */
-        get: {
-            parameters: {
-                query?: {
-                    status?: string;
-                    state?: "open" | "closed" | "in_progress" | "ready" | "blocked";
-                    source?: string;
-                    session?: string;
-                    repo?: string | string[];
-                    org?: string | string[];
-                    assignee?: string;
-                    claimedBy?: string;
-                    branch?: string;
-                    pr?: string;
-                    limit?: string;
-                    offset?: string;
-                    ready?: "true" | "false";
-                    hitl?: "true" | "false";
-                    kind?: "dev" | "prd";
-                    sort?: "asc" | "desc";
-                    updatedSince?: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description List of tasks with total count */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TaskListResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        /**
-         * Create a task
-         * @description Creates a single task. `title`, `status`, and `repo` are required — the `repo` key must be present, though `null` is a valid value for tasks not scoped to a specific repository. Agent tokens leave `assignee` as supplied by the caller, defaulting to `null` (unassigned/pool task) when omitted. Returns `201` with the created task; an existing `id` collision is not given dedicated handling and surfaces as an unhandled error rather than a clean `409` (use `POST /tasks/bulk` for collision-safe inserts).
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["CreateTaskBody"];
-                };
-            };
-            responses: {
-                /** @description Created task */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/bulk": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Bulk insert tasks
-         * @description Inserts the whole array in one transaction (TSW-1.3): a single task's id collision or a webhook delivery failure rolls back the entire batch, not just that task. At most 500 tasks per call — the transaction's budget scales with batch size, and this cap bounds it.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["BulkInsertBody"];
-                };
-            };
-            responses: {
-                /** @description Bulk insert result */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["BulkInsertResponse"];
-                    };
-                };
-                /** @description Bad request — malformed body, a missing repo key, or more than 500 tasks in one batch */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Conflict — a task id in the batch already exists; the entire batch was rolled back */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Webhook delivery failed; the entire batch was rolled back */
-                502: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/distinct": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get distinct session and repo values
-         * @description Returns distinct `sessions`, `repos` (`org/repo` strings), and `orgs` (the `org` prefix of each `repo`) across the caller's visible task set — useful for populating filter dropdowns in a UI.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Distinct values */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["DistinctResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get a task by ID
-         * @description Fetches a single task by its ID. Returns `404` if the task doesn't exist or is outside the calling agent token's ownership/repo scope.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        /**
-         * Delete a task
-         * @description Deletes a task and its TaskEvent audit rows. Agent tokens can only delete tasks within their ownership/repo scope (by `assignee`, `claimedBy`, or a `repo` in the token's scoped repos). Returns `204` on success; this write does not fire a `task.write` webhook, since the deleted row can't be sent as the event payload.
-         */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Deleted */
-                204: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        /**
-         * Update a task
-         * @description Applies partial task fields. Agent tokens can only update tasks within their ownership/repo scope (by `assignee`, `claimedBy`, or a `repo` in the token's scoped repos) and cannot set `claimedBy`, `claimedAt`, `heartbeatAt`, or `status: 'pending'` via this route — those are managed exclusively by `/claim` and `/release` so a generic PATCH can never bypass the atomic claim protocol. Admin tokens may set any field. A common use is setting `status: 'blocked'` alongside `blockedReason` when an agent hits an unrecoverable dead end.
-         */
-        patch: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["UpdateTaskBody"];
-                };
-            };
-            responses: {
-                /** @description Updated task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        trace?: never;
-    };
-    "/tasks/{id}/claim": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Atomically claim a task
-         * @description Atomically claims a pending task via a single conditional `UPDATE ... WHERE status='pending' AND "claimedBy" IS NULL`, setting `status=in_progress`, `claimedBy`, `claimedAt`, `heartbeatAt`, and `startedAt` (or keeping it if already set) in one round-trip. Agent tokens send no body — the service pins `claimedBy` to the calling agent's ID server-side; admin tokens must supply `{ claimedBy: string }`. Returns `200` with the claimed task, or `409` if the task is already claimed or not in `pending` status. A DB-level CHECK constraint independently enforces that a row can never have `status='pending'` with a non-null `claimedBy` simultaneously, as defense-in-depth against any write path — including manual admin PATCHes — that might otherwise leave a task claimed-yet-pending.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["ClaimBody"];
-                };
-            };
-            responses: {
-                /** @description Claimed task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Conflict — already claimed */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/heartbeat": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Touch heartbeatAt on a claimed task
-         * @description Updates `heartbeatAt` to now. Agents call this periodically to renew a claim before any long-running operation (dispatching a subagent, waiting on CI) so the stale-claim reaper doesn't reclaim the task mid-pipeline. This write is deliberately excluded from both the `task.write` webhook and the TaskEvent audit trail — it's the highest-volume write path in the service and a heartbeat-only change isn't an audit-worthy event.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Updated task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/complete": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Mark a task as done
-         * @description Sets `status=done` and `completedAt` to now, ending the task's lifecycle successfully.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Updated task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/fail": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Mark a task as blocked
-         * @description Sets `status=blocked`, pausing the task (it returns to `pending` on retry). Optional body `{ reason: string }` records why.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["FailBody"];
-                };
-            };
-            responses: {
-                /** @description Updated task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/release": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Release a task back to pending
-         * @description Clears `claimedBy`, `claimedAt`, and `heartbeatAt`, and resets `status=pending`. Use when an agent stops work without completing or failing, so the task becomes claimable again.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Updated task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/skip": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Record a skip — increments skipCount, auto-blocks at threshold
-         * @description Increments `skipCount` and updates `lastSkippedAt` to now. Called by orchestrators when a task is repeatedly re-selected but produces no visible outcome ([silent] dispatch). When `skipCount` crosses the threshold (3, `SPIN_DETECTION_THRESHOLD`), the task is auto-set to `status=blocked` with `blockedReason="Auto-blocked after {skipCount} consecutive skips (dispatched but found nothing to do)"` to halt further dispatches.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Updated task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/skip/reset": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Reset skip tracking — skipCount back to 0
-         * @description Resets `skipCount` back to 0 and clears `lastSkippedAt`. Called after a human reviews and unblocks a task that was auto-blocked by the skip threshold.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Updated task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/unblock": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Atomically unblock a task back to pending
-         * @description Atomically unblocks a task via a single conditional `UPDATE ... WHERE status='blocked'`, setting `status=pending` and clearing `blockedReason`, `blockedAt`, `claimedBy`, `claimedAt`, and `heartbeatAt`, and resetting `skipCount` to `0` and `lastSkippedAt` to `null` — all in one round-trip. Returns `409` if the task is not currently in `blocked` status (never a silent no-op, unlike `/release` on a non-`in_progress` task).
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Unblocked task */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Task"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Conflict — task is not currently blocked */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tasks/{id}/events": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Fetch a task's TaskEvent audit trail, ordered by `at` ascending (oldest first)
-         * @description Returns `{ events, total, limit, offset }` — the task's append-only `TaskEvent` rows recording field-level state transitions, oldest first. `total` counts all events regardless of `limit`/`offset` (default `limit=50`, `offset=0`). Returns `404` if the task doesn't exist or is outside the caller's scope.
-         */
-        get: {
-            parameters: {
-                query?: {
-                    limit?: string;
-                    offset?: string;
-                };
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Task's event history */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TaskEventsResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tokens": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List all tokens
-         * @description Admin-only. Returns token metadata (hash, label, agentId) for every token — raw token values are never returned once past creation.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Array of token metadata */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TaskToken"][];
-                    };
-                };
-                /** @description Forbidden — admin token required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        /**
-         * Create a new token — raw value returned exactly once
-         * @description Admin-only. Body is optional: `{ label?, agentId? }`. Omitting `agentId` creates an unrestricted admin token; supplying it creates an agent-scoped token. Only the token's SHA-256 hash is persisted — the raw value is included in this response and never retrievable again.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["TokenBody"];
-                };
-            };
-            responses: {
-                /** @description Created token including the one-time raw value */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TaskTokenWithRaw"];
-                    };
-                };
-                /** @description Forbidden — admin token required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/tokens/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post?: never;
-        /**
-         * Revoke a token
-         * @description Admin-only. Soft-deletes the token by setting `revokedAt` — the record is not removed, so its history stays intact, but the raw token stops authenticating requests.
-         */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Revoked token metadata */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TaskToken"];
-                    };
-                };
-                /** @description Forbidden — admin token required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Token not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        /**
-         * Update token label and/or agentId
-         * @description Admin-only. Body: `{ label?, agentId? }`. Returns `400` if the target token has already been revoked.
-         */
-        patch: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["TokenBody"];
-                };
-            };
-            responses: {
-                /** @description Updated token metadata */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TaskToken"];
-                    };
-                };
-                /** @description Bad request — token is revoked */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden — admin token required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Token not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        trace?: never;
-    };
-    "/prs": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List pull requests
-         * @description Returns `{ prs, total, limit, offset }`. `?ready=true` returns only unclaimed PRs (`claimedBy IS NULL`); `?blocked=true` returns PRs where `pr.blocked===true` OR a linked task has `status='blocked'` (resolved live via `(Task.repo, Task.pr)`, so a PR shared by several bundled tasks is blocked if any one of them is). `repo`/`org` are repeatable query params combined via AND; `sort` orders by `createdAt` (`asc` default).
-         */
-        get: {
-            parameters: {
-                query?: {
-                    repo?: string | string[];
-                    org?: string | string[];
-                    prNumber?: string;
-                    state?: "open" | "merged" | "closed";
-                    reviewState?: "pending" | "in_progress" | "posted" | "approved";
-                    staged?: "true" | "false";
-                    limit?: string;
-                    offset?: string;
-                    ready?: "true" | "false";
-                    blocked?: "true" | "false";
-                    sort?: "asc" | "desc";
-                    updatedSince?: string;
-                    origin?: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description List of pull requests */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PrListResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/claim": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Claim a pull request (atomic)
-         * @description Atomic via Postgres row locking, keyed on `(repo, prNumber)`. No existing record creates and returns `201` (a concurrent INSERT loser hits the `@@unique([repo, prNumber])` constraint and gets `409`). Against an existing record, the conflict conditions are re-checked inside the UPDATE's own WHERE clause so only one writer can win: same `commitSha` + same `phase` + already claimed by another agent returns `409` (phase locked); already claimed + same `commitSha` + `reviewState !== pending` (review phase only) returns `409` (already reviewed at this commit); otherwise the row is updated and `200` returned (new cycle). Agent tokens pin `claimedBy` to their own ID; admin tokens supply it in the body. Optional `phase` (default `review`) sets the pipeline phase — `patch`/`deploy` phases preserve `reviewState` as-is rather than resetting it. Optional `authorLogin`/`headRef`/`title` (POM-1.2) are forwarded server-side into an atomic origin-stamping write: a linked Task row (matching `repo`+`pr`) always derives `origin='shipwright'`; otherwise `authorLogin`/`headRef` are pattern-matched against known CI/dependency-bot signals, falling back to `human`/`unknown`. Origin is first-write-wins (never overwritten once set); `authorLogin`/`headRef`/`title` are refreshed to the latest value on every claim.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["ClaimPrBody"];
-                };
-            };
-            responses: {
-                /** @description Updated existing claim */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description New claim created */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Conflict — already claimed with same commitSha */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/claim-next": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Atomic find-and-claim of oldest eligible PR
-         * @description Atomically finds and claims the oldest eligible PR not yet claimed by the calling agent, in one round-trip — useful for agents implementing a pull-based queue instead of manually claiming a specific PR. Optional `maxConcurrent` (default `1`) caps how many PRs the agent may hold at once; if the agent already has that many claimed, returns `204`. Agent tokens see only PRs in their configured repo scope; admin tokens see all. Returns `200` with `{ pr, phase }`, or `204` if nothing eligible.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["ClaimNextBody"];
-                };
-            };
-            responses: {
-                /** @description PR claimed — returns {pr, phase} */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ClaimNextResponse"];
-                    };
-                };
-                /** @description No eligible PR found */
-                204: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/census": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Batch upsert PR origin/author/branch/title/state metadata
-         * @description Upserts a PullRequest row for each (repo, prNumber) entry — at most 200 entries per call, all in one transaction. Writes `authorLogin`/`headRef`/`title`/`state`/`mergedAt`/`prCreatedAt`/`commitCount`/`commitsDocsRefresh`/`commitsReviewPatch`/`commitsCiFix`/`commitsImplementation` unconditionally; `origin` follows first-write-wins (only applied when the row's existing origin is currently null). Never touches claim/phase/review/patch/blocked fields — safe to run alongside review/patch/deploy's separate POST /prs/claim lock. New rows get `phase=null`, `reviewState='pending'`, `staged=false`. Not part of the public MCP tool surface.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["CensusBody"];
-                };
-            };
-            responses: {
-                /** @description Upserted PR rows, one per input entry */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["CensusResponse"];
-                    };
-                };
-                /** @description Bad request — malformed entry, or more than 200 entries in one batch */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden — an entry's repo is outside the agent token's scope */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/census/cursor": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get the census incremental-search-window cursor for a repo
-         * @description Returns `{ cursor }`: the max `mergedAt` (ISO string) among rows scoped to `repo` whose `origin` is not null, or `null` when no such row exists. Used by POM-4.1's census sweep to derive its incremental search window.
-         */
-        get: {
-            parameters: {
-                query: {
-                    repo: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Census cursor */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["CensusCursorResponse"];
-                    };
-                };
-                /** @description Bad request — missing or malformed repo */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden — repo is outside the agent token's scope */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Fetch a single pull request
-         * @description Fetches a single PR record by its ID. Returns `404` if not found.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Pull request record */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        /**
-         * Update pull request fields
-         * @description Writable fields: `staged`, `commitSha`, `reviewedCommitSha`, `agentId`, `state`, `mergedAt`, `reviewState`, `reviewedAt`, `phase`, `readyForReviewAt`, `readyForPatchAt`, `readyForDeployAt`, `blocked`, `blockedReason` — every other field is managed by a lifecycle endpoint instead. Returns `400` if no writable field is provided. Unlike the lifecycle endpoints, PATCH does not record a PullRequestEvent audit row; it's meant for late-stage corrections (e.g. force-setting `state=merged` after GitHub confirms it) that don't need transactional field-diff auditing. Setting `state` to `merged`/`closed`, or `reviewState` to `posted`/`approved`, clears the claim fields (`claimedBy`, `claimedAt`, `heartbeatAt`, `phase`) as a side effect so a completed PR isn't left held by a stale claim. Setting `reviewState=posted` together with `reviewedCommitSha` records the commit-level dedup marker the review phase's staged-review guard reads to decide whether re-review is needed.
-         */
-        patch: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["UpdatePrBody"];
-                };
-            };
-            responses: {
-                /** @description Updated pull request */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        trace?: never;
-    };
-    "/prs/{id}/heartbeat": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Touch heartbeatAt for a claimed PR
-         * @description Updates `heartbeatAt` to now to signal the claiming agent is still working. Deliberately excluded from the PullRequestEvent audit trail — a bare liveness ping recording would be a guaranteed no-op, and keeping this a single cheap UPDATE avoids dominating write volume.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description PR with updated heartbeatAt */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}/complete": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Mark PR review as complete (reviewState=posted)
-         * @description Sets `reviewState=posted`, increments `reviewCycles`, sets `reviewedAt`, and clears `claimedBy`/`claimedAt`/`heartbeatAt`/`phase` so the review claim is released as soon as the review is done. Records field-level transitions as PullRequestEvent rows.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Completed PR */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}/patch": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Increment patchCycles and conditionally reset reviewState=pending; optionally track a CI-failure streak via ciFailureSignature
-         * @description Increments `patchCycles`, sets `patchedAt`, and clears `claimedBy`/`claimedAt`/`heartbeatAt`/`phase`. `reviewState` is reset conditionally based on the optional `commitSha` field: omitted resets unconditionally to `pending`; provided and differing from the stored `commitSha` also resets to `pending` and updates `commitSha`; provided and matching leaves `reviewState` untouched (a no-op patch cycle). The optional `ciFailureSignature` field tracks consecutive patch cycles hitting the same CI failure — a matching signature increments `consecutiveCiFailureCount`, a differing or absent one resets it to 1; crossing the threshold (3, `SPIN_DETECTION_THRESHOLD`) auto-sets `blocked=true` with a descriptive `blockedReason`. Records field-level transitions as PullRequestEvent rows.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["PatchPrBody"];
-                };
-            };
-            responses: {
-                /** @description Patched PR */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}/release": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Release a claim (reviewState=pending, claimedBy cleared)
-         * @description Clears `claimedBy`, `claimedAt`, and `heartbeatAt`. Resets `reviewState=pending` unless it's already a terminal value (`posted`/`approved`), in which case `reviewState` is left untouched. Records field-level transitions as PullRequestEvent rows.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Released PR */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}/skip": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Record a skip — increments skipCount, auto-blocks at threshold
-         * @description Increments `skipCount` and updates `lastSkippedAt` to now. When `skipCount` crosses the threshold (3), auto-sets `blocked=true` and `blockedReason="Auto-blocked after {skipCount} consecutive skips (dispatched but found nothing to do)"`. Mirrors `POST /tasks/:id/skip`. Records field-level transitions as PullRequestEvent rows.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Updated PR */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}/skip/reset": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Reset skip tracking — skipCount back to 0; also clears blocked/blockedReason if the PR was blocked by the skip mechanism
-         * @description Resets `skipCount` to 0 and clears `lastSkippedAt`. If the PR is currently blocked with a `blockedReason` matching the skip-auto-block message (contains "consecutive skips"), also clears `blocked=false` and `blockedReason=null` in the same update — a block set by a different mechanism (e.g. the CI-failure-streak auto-block from `POST /:id/patch`) is left untouched. Records field-level transitions as PullRequestEvent rows.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Updated PR */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PullRequest"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}/findings": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Append a review/patch finding to a PR — source:'patch' may only submit disposition:'rejected'
-         * @description Appends a `PrFinding` row: `{ ref, disposition, source, evidence, at?, agentId? }`, where `disposition` is one of `resolved`, `superseded`, `rejected`, and `source` is one of `review`, `patch`. Server-enforced authority rule: `source:"patch"` may only submit `disposition:"rejected"` (patch cannot unilaterally resolve or supersede a finding it didn't originate) — any other combination returns `400`. `source:"review"` may submit any disposition. Returns `201` with the created finding.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["CreateFindingBody"];
-                };
-            };
-            responses: {
-                /** @description Finding recorded */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PrFinding"];
-                    };
-                };
-                /** @description Bad request — including the authority violation of source:'patch' submitting a disposition other than 'rejected' */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/prs/{id}/events": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Fetch a PR's PullRequestEvent audit trail, ordered by `at` ascending (oldest first)
-         * @description Returns `{ events, total, limit, offset }` — the PR's append-only `PullRequestEvent` rows recording field-level state transitions, oldest first. `total` counts all events regardless of `limit`/`offset` (default `limit=50`, `offset=0`). Returns `404` if the PR doesn't exist.
-         */
-        get: {
-            parameters: {
-                query?: {
-                    limit?: string;
-                    offset?: string;
-                };
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description PR's event history */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["PrEventsResponse"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/sessions": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List sessions
-         * @description Returns `{ sessions, total, limit, offset }` — each session's Task rows rolled up into a single object (`state`, `waitingSince`, `lastActivityAt`, per-status `counts`, distinct `agentIds`/`repos`, `waitingTasks`) flattened with the Session row's own fields. Omitting `?state` defaults to non-archived, non-closed sessions. Every agent token (agentId set) is scoped: it only sees sessions with at least one qualifying task — one where `assignee === agentId` OR the task's repo is in the agent's resolved scope; a token with no resolved repos degrades to assignee-only matching rather than unrestricted visibility. Only admin tokens see every session unrestricted.
-         */
-        get: {
-            parameters: {
-                query?: {
-                    state?: "waiting" | "active" | "closed" | "empty" | "archived" | "all";
-                    sort?: "waitingSince" | "lastActivityAt";
-                    agentId?: string;
-                    repo?: string | string[];
-                    org?: string | string[];
-                    q?: string;
-                    limit?: string;
-                    offset?: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description List of sessions with total count */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["SessionListResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/sessions/{slug}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get a session by slug
-         * @description Returns the same flattened session+rollup shape as the list route. Returns `404` if the session doesn't exist, or if an agent token has no qualifying task in it (same visibility rule as list) — the two cases are indistinguishable to the caller by design.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    slug: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Session */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Session"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        /**
-         * Rename/archive a session — admin-only
-         * @description Admin-only, no exceptions — agent tokens get `403` regardless of ownership. Body: `{ title?: string | null, archived?: boolean }`, both optional (an empty body is a no-op). `title: null` clears the title; `archived: true` sets `archivedAt`/`archivedBy`, `archived: false` clears both. Returns `404` if the session doesn't exist.
-         */
-        patch: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    slug: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["SessionPatchBody"];
-                };
-            };
-            responses: {
-                /** @description Updated session */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Session"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden — admin tokens only */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        trace?: never;
-    };
-    "/verification-checks": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List verification checks for a task, a PR, or a repo+checkName pair
-         * @description Returns `{ checks, total, limit, offset }` for exactly one of three mutually-exclusive modes: `?taskId=`, `?prId=`, or `?repo=`+`?checkName=` together (supplying none, or more than one mode, or only half of the repo+checkName pair, is `400`). The `?taskId=`/`?prId=` modes are ordered by `at` ascending (oldest first, default `limit=50`, `offset=0`) and `404` if the referenced task/pr doesn't exist. The `?repo=`+`?checkName=` mode (LVB-4.4) spans every task/PR that recorded that repo+check — there's no single parent to `404` on, so an unmatched pair returns `200` with an empty list — and is ordered by `at` DESCENDING (most recent first) so a caller can walk backward from the latest outcome to detect a consecutive skipped/timed_out streak.
-         */
-        get: {
-            parameters: {
-                query?: {
-                    taskId?: string;
-                    prId?: string;
-                    repo?: string;
-                    checkName?: string;
-                    limit?: string;
-                    offset?: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Verification check history */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["VerificationCheckListResponse"];
-                    };
-                };
-                /** @description Bad request — none, or more than one, of ?taskId=/?prId=/(?repo=+?checkName=) supplied, or only one half of the ?repo=/?checkName= pair given */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found (?taskId=/?prId= modes only — the referenced task/pr doesn't exist) */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        /**
-         * Record a single per-check verification outcome
-         * @description Records one VerificationCheck row against exactly one parent — `taskId` (a task still in progress, before a PR exists) or `prId` (an already-open PR); supplying neither or both is `400`. `status` is `ran_passed | ran_failed | skipped | timed_out`. `reasonCategory` is a closed set of ENVIRONMENTAL causes and is only valid alongside `status: skipped | timed_out` — a `ran_failed` row (the check ran and produced a genuine failure) must never carry one; supplying it anyway is `400`, enforced server-side (not just by convention). `learnedFromCategory` is only valid alongside `reasonCategory: learned_skip`, and must not itself be `learned_skip`. `at` defaults to the current time when omitted.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["CreateVerificationCheckBody"];
-                };
-            };
-            responses: {
-                /** @description Recorded verification check */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["VerificationCheck"];
-                    };
-                };
-                /** @description Bad request — missing/invalid fields, taskId/prId neither-or-both, or a status/reasonCategory combination that violates the ran_failed-never-carries-a-reasonCategory rule */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found — the referenced task/pr does not exist */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-}
-export type webhooks = Record<string, never>;
-export interface components {
-    schemas: {
-        Task: {
-            /** @example clx1234567890 */
-            id: string;
-            /** @example Implement feature X */
-            title: string;
-            /**
-             * @example pending
-             * @enum {string}
-             */
-            status: "pending" | "in_progress" | "pr_open" | "approved" | "merged" | "done" | "deploying" | "deployed" | "blocked" | "cancelled";
-            /** @example manual */
-            source?: string | null;
-            /** @example session-123 */
-            session?: string | null;
-            /** @example org/repo */
-            repo?: string | null;
-            /** @example Task description */
-            description?: string | null;
-            /**
-             * @example [
-             *       "Criterion 1",
-             *       "Criterion 2"
-             *     ]
-             */
-            acceptanceCriteria?: string[];
-            /** @example feature */
-            layer?: string | null;
-            /** @example feat/feature-x */
-            branch?: string | null;
-            /**
-             * @example [
-             *       "task-1",
-             *       "task-2"
-             *     ]
-             */
-            dependencies?: string[];
-            /** @example 42 */
-            pr?: number | null;
-            /** @example 5.5 */
-            hours?: number | null;
-            /** @example 2026-01-02T00:00:00.000Z */
-            startedAt?: string | null;
-            /** @example 2026-01-03T00:00:00.000Z */
-            prCreatedAt?: string | null;
-            /** @example 2026-01-04T00:00:00.000Z */
-            mergedAt?: string | null;
-            /** @example null */
-            blockedAt?: string | null;
-            /** @example Waiting on dependency */
-            blockedReason?: string | null;
-            /** @example Some notes */
-            note?: string | null;
-            /** @example feature */
-            type?: string | null;
-            /** @example high */
-            priority?: string | null;
-            /** @example null */
-            cancelledAt?: string | null;
-            /** @example 2026-01-05T00:00:00.000Z */
-            completedAt?: string | null;
-            /** @example null */
-            deployingAt?: string | null;
-            /** @example 2026-01-06T00:00:00.000Z */
-            deployedAt?: string | null;
-            /** @example 2 */
-            ciFixAttempts?: number | null;
-            /** @example abc123def456 */
-            mergeCommit?: string | null;
-            /** @example https://github.com/org/repo/pull/42 */
-            prUrl?: string | null;
-            /** @example user@example.com */
-            assignee?: string | null;
-            /** @example GH-123 */
-            issue?: string | null;
-            /** @example sonnet */
-            model?: string | null;
-            /** @example 7 */
-            complexity?: number | null;
-            /** @example true */
-            hitl?: boolean | null;
-            /**
-             * @description What the task is: `dev` (ordinary work item, the default) or `prd` (a product spec awaiting an autonomous plan session). A `prd` task is never part of the `?ready=true` set.
-             * @default dev
-             * @example dev
-             * @enum {string}
-             */
-            kind: "dev" | "prd";
-            /**
-             * @description Consecutive skip count. Auto-blocks (hitl+blockedReason) once it crosses the threshold (3).
-             * @default 0
-             * @example 0
-             */
-            skipCount: number;
-            /** @example 2026-01-02T00:00:00.000Z */
-            lastSkippedAt?: string | null;
-            /** @example agent-id-123 */
-            claimedBy?: string | null;
-            /** @example prefer-sonnet */
-            agentHint?: string | null;
-            /** @example 2026-01-02T00:00:00.000Z */
-            claimedAt?: string | null;
-            /** @example 2026-01-06T12:00:00.000Z */
-            heartbeatAt?: string | null;
-            /** @example 10 */
-            simplifyTotal?: number | null;
-            /** @example 2 */
-            simplifyDry?: number | null;
-            /** @example 3 */
-            simplifyDeadCode?: number | null;
-            /** @example 1 */
-            simplifyNaming?: number | null;
-            /** @example 2 */
-            simplifyComplexity?: number | null;
-            /** @example 2 */
-            simplifyConsistency?: number | null;
-            /** @example 5.5 */
-            coverageDelta?: number | null;
-            /** @example medium */
-            effortLevel?: string | null;
-            /** @example 1000 */
-            inputTokens?: number | null;
-            /** @example 500 */
-            outputTokens?: number | null;
-            /** @example 100 */
-            cacheReadTokens?: number | null;
-            /** @example 50 */
-            cacheCreationTokens?: number | null;
-            /** @example 0.02 */
-            costUsd?: number | null;
-            /**
-             * @example {
-             *       "customKey": "customValue"
-             *     }
-             */
-            metadata?: {
-                [key: string]: unknown;
-            } | null;
-            /**
-             * Format: date-time
-             * @example 2026-01-01T00:00:00.000Z
-             */
-            createdAt: string;
-            /**
-             * Format: date-time
-             * @example 2026-01-06T12:00:00.000Z
-             */
-            updatedAt: string;
-        };
-        TaskListResponse: {
-            tasks: components["schemas"]["Task"][];
-            /** @example 10 */
-            total: number;
-            /**
-             * @description True only when the agent token's repo-scope resolver call itself failed upstream (network error, timeout, non-2xx, malformed JSON) — distinct from a legitimate empty repo scope. Always false for admin tokens.
-             * @example false
-             */
-            scopeDegraded: boolean;
-        };
-        Error: {
-            /** @example not found */
-            error: string;
-        };
-        CreateTaskBody: {
-            /** @example Implement feature X */
-            title?: string;
-            /** @example pending */
-            status?: string;
-            /** @example org/repo */
-            repo?: string | null;
-            /** @example session-123 */
-            session?: string;
-            /** @example Task description */
-            description?: string;
-            /** @example service */
-            layer?: string;
-            /** @example feat/feature-x */
-            branch?: string;
-            /** @example [] */
-            dependencies?: string[];
-            /** @example [] */
-            acceptanceCriteria?: string[];
-            /** @example user@example.com */
-            assignee?: string;
-            /** @example high */
-            priority?: string;
-            /** @example feature */
-            type?: string;
-            /** @example manual */
-            source?: string;
-            /**
-             * @description What the task is (TKD-1.1). Defaults to `dev`.
-             * @example dev
-             * @enum {string}
-             */
-            kind?: "dev" | "prd";
-            [key: string]: unknown;
-        };
-        BulkInsertResponse: {
-            /** @example 3 */
-            inserted: number;
-            /** @example 1 */
-            updated: number;
-            /**
-             * @description Always empty on success (TSW-1.3). bulk() is atomic — a single task id collision (P2002) now hard-fails the whole batch with 409 instead of skipping that task and continuing. This field is retained only for response-shape backward compatibility.
-             * @example []
-             */
-            skipped: string[];
-        };
-        /** @description Tasks to insert, at most 500 per call (TSW-1.3: the whole array runs in one transaction, and the cap bounds that transaction's budget). An over-cap batch is rejected with 400 — split it. */
-        BulkInsertBody: {
-            /** @example Implement feature X */
-            title?: string;
-            /** @example pending */
-            status?: string;
-            /** @example org/repo */
-            repo?: string | null;
-            [key: string]: unknown;
-        }[];
-        DistinctResponse: {
-            /**
-             * @example [
-             *       "session-1"
-             *     ]
-             */
-            sessions: string[];
-            /**
-             * @example [
-             *       "org/repo"
-             *     ]
-             */
-            repos: string[];
-            /**
-             * @example [
-             *       "org"
-             *     ]
-             */
-            orgs: string[];
-        };
-        UpdateTaskBody: {
-            [key: string]: unknown;
-        };
-        ClaimBody: {
-            /** @example agent-id-123 */
-            claimedBy?: string;
-        };
-        FailBody: {
-            /** @example build failed */
-            reason?: string;
-        };
-        TaskEvent: {
-            /** @example clxevent123456 */
-            id: string;
-            /** @example clx0987654321 */
-            taskId: string;
-            /** @example status */
-            field: string;
-            /** @example pending */
-            oldValue: string | null;
-            /** @example in_progress */
-            newValue: string | null;
-            /** @example agent-abc123 */
-            actor: string | null;
-            /** @example claim */
-            method: string;
-            /** @example 2026-08-17T12:00:00.000Z */
-            at: string;
-            /**
-             * Format: date-time
-             * @example 2026-08-17T12:00:00.000Z
-             */
-            createdAt: string;
-        };
-        TaskEventsResponse: {
-            /** @description This task's TaskEvent audit trail, ordered by `at` ascending (oldest first). */
-            events: components["schemas"]["TaskEvent"][];
-            /** @example 1 */
-            total: number;
-            /** @example 50 */
-            limit: number;
-            /** @example 0 */
-            offset: number;
-        };
-        TaskToken: {
-            /** @example clxtoken123456 */
-            id: string;
-            /** @example ci-runner */
-            label?: string | null;
-            /** @example agent-id-123 */
-            agentId?: string | null;
-            /**
-             * Format: date-time
-             * @example 2026-01-01T00:00:00.000Z
-             */
-            createdAt: string;
-            /**
-             * Format: date-time
-             * @example null
-             */
-            revokedAt?: string | null;
-        };
-        TaskTokenWithRaw: components["schemas"]["TaskToken"] & {
-            /** @example raw-token-value-shown-once */
-            rawToken: string;
-        };
-        TokenBody: {
-            /** @example ci-runner */
-            label?: string;
-            /** @example agent-id-123 */
-            agentId?: string;
-        };
-        PrFinding: {
-            /** @example clxfinding123456 */
-            id: string;
-            /** @example clx0987654321 */
-            prRecordId: string;
-            /** @example src/foo.ts:42 */
-            ref: string;
-            /**
-             * @example resolved
-             * @enum {string}
-             */
-            disposition: "resolved" | "superseded" | "rejected";
-            /**
-             * @example review
-             * @enum {string}
-             */
-            source: "review" | "patch";
-            /** @example Fixed the null check in the follow-up commit. */
-            evidence: string;
-            /** @example 2026-08-17T12:00:00.000Z */
-            at: string;
-            /**
-             * @description Agent instance that triaged this finding, if any.
-             * @example agent-abc123
-             */
-            agentId: string | null;
-            /**
-             * Format: date-time
-             * @example 2026-08-17T12:00:00.000Z
-             */
-            createdAt: string;
-        };
-        PullRequestEvent: {
-            /** @example clxevent123456 */
-            id: string;
-            /** @example clx0987654321 */
-            prRecordId: string;
-            /** @example reviewState */
-            field: string;
-            /** @example pending */
-            oldValue: string | null;
-            /** @example in_progress */
-            newValue: string | null;
-            /** @example agent-abc123 */
-            actor: string | null;
-            /** @example claim */
-            method: string;
-            /** @example 2026-08-17T12:00:00.000Z */
-            at: string;
-            /**
-             * Format: date-time
-             * @example 2026-08-17T12:00:00.000Z
-             */
-            createdAt: string;
-        };
-        PullRequest: {
-            /** @example clx0987654321 */
-            id: string;
-            /** @example org/repo */
-            repo: string;
-            /** @example 42 */
-            prNumber: number;
-            /**
-             * @default false
-             * @example false
-             */
-            staged: boolean;
-            /**
-             * @default open
-             * @example open
-             * @enum {string}
-             */
-            state: "open" | "merged" | "closed";
-            /**
-             * @default pending
-             * @example pending
-             * @enum {string}
-             */
-            reviewState: "pending" | "in_progress" | "posted" | "approved";
-            /** @example abc123def456 */
-            commitSha?: string | null;
-            /**
-             * @description The review pipeline's exclusive commit-tracking field, separate from the shared commitSha field written by claim()/patch()/deploy for their own multi-phase bookkeeping.
-             * @example abc123def456
-             */
-            reviewedCommitSha?: string | null;
-            /**
-             * @default 0
-             * @example 1
-             */
-            patchCycles: number;
-            /**
-             * @default 0
-             * @example 0
-             */
-            reviewCycles: number;
-            /** @example agent-id-123 */
-            agentId?: string | null;
-            /** @example 2026-01-03T00:00:00.000Z */
-            reviewedAt?: string | null;
-            /** @example null */
-            patchedAt?: string | null;
-            /** @example null */
-            mergedAt?: string | null;
-            /**
-             * @description ISO timestamp of the GitHub PR's actual creation time. Set once via POST /prs/claim (first claim only); read-only thereafter.
-             * @example 2026-01-01T00:00:00.000Z
-             */
-            prCreatedAt?: string | null;
-            /** @example agent-id-123 */
-            claimedBy?: string | null;
-            /** @example 2026-01-02T00:00:00.000Z */
-            claimedAt?: string | null;
-            /** @example 2026-01-06T12:00:00.000Z */
-            heartbeatAt?: string | null;
-            /**
-             * @example review
-             * @enum {string|null}
-             */
-            phase?: "review" | "patch" | "deploy" | null;
-            /** @example 2026-01-02T00:00:00.000Z */
-            readyForReviewAt?: string | null;
-            /** @example null */
-            readyForPatchAt?: string | null;
-            /** @example null */
-            readyForDeployAt?: string | null;
-            /**
-             * @default false
-             * @example false
-             */
-            blocked: boolean;
-            /** @example no linked task */
-            blockedReason?: string | null;
-            /**
-             * @description Where this PR record first learned about the PR — first-write-wins (see PullRequestService.stampOrigin()). Null means the row has never been stamped (POM-1.1's accepted gap: a PR that never passes through the pr_open transition, POST /prs/claim, or the census sweep has no origin at all).
-             * @example shipwright
-             * @enum {string|null}
-             */
-            origin?: "shipwright" | "ci" | "dependency_bot" | "human" | "unknown" | null;
-            /** @example octocat */
-            authorLogin?: string | null;
-            /** @example feat/some-branch */
-            headRef?: string | null;
-            /** @example Add the origin metrics dimension */
-            title?: string | null;
-            /**
-             * @description Total commit count on this PR (CPP-1.1). Written unconditionally by POST /prs/census whenever supplied — mirrors authorLogin/headRef/title, not origin's first-write-wins semantic.
-             * @example 12
-             */
-            commitCount?: number | null;
-            /**
-             * @description Commits attributed to the docs-refresher subagent (CPP-1.1).
-             * @example 1
-             */
-            commitsDocsRefresh?: number | null;
-            /**
-             * @description Commits attributed to the review/patch cycle (CPP-1.1).
-             * @example 3
-             */
-            commitsReviewPatch?: number | null;
-            /**
-             * @description Commits attributed to CI-fix cycles (CPP-1.1).
-             * @example 2
-             */
-            commitsCiFix?: number | null;
-            /**
-             * @description Commits attributed to the initial implementation (CPP-1.1).
-             * @example 6
-             */
-            commitsImplementation?: number | null;
-            /**
-             * @description Consecutive skip count. Auto-blocks (blocked+blockedReason) once it crosses the threshold (3). POST /prs/:id/skip/reset resets this to 0 and, only when blockedReason matches the skip-auto-block message pattern (contains 'consecutive skips'), also clears blocked/blockedReason — a block set by a different mechanism (e.g. the CI-failure-streak auto-block) is left untouched.
-             * @default 0
-             * @example 0
-             */
-            skipCount: number;
-            /** @example 2026-01-02T00:00:00.000Z */
-            lastSkippedAt?: string | null;
-            /**
-             * @description Signature of the most recent CI failure reported via POST /prs/:id/patch's ciFailureSignature field. Used to detect consecutive patch cycles hitting the same CI failure.
-             * @example npm-test-failed-foo.unit.test.ts
-             */
-            lastCiFailureSignature?: string | null;
-            /**
-             * @description Count of consecutive patch() calls whose ciFailureSignature matched lastCiFailureSignature. Auto-blocks (blocked+blockedReason) once it crosses the threshold (3).
-             * @default 0
-             * @example 0
-             */
-            consecutiveCiFailureCount: number;
-            /**
-             * Format: date-time
-             * @example 2026-01-01T00:00:00.000Z
-             */
-            createdAt: string;
-            /**
-             * Format: date-time
-             * @example 2026-01-06T12:00:00.000Z
-             */
-            updatedAt: string;
-            /** @description Review/patch findings recorded against this PR, if the caller's query included them (GET /prs/:id and list responses always include this array). */
-            findings?: components["schemas"]["PrFinding"][];
-            /** @description Field-level state transition audit trail for this PR, if the caller's query included them (GET /prs/:id and list responses always include this array). */
-            events?: components["schemas"]["PullRequestEvent"][];
-        };
-        PrListResponse: {
-            /** @description Array of pull requests */
-            prs: components["schemas"]["PullRequest"][];
-            /** @example 1 */
-            total: number;
-            /** @example 50 */
-            limit: number;
-            /** @example 0 */
-            offset: number;
-        };
-        ClaimPrBody: {
-            /**
-             * @description Repository in org/repo format
-             * @example org/repo
-             */
-            repo: string;
-            /**
-             * @description Pull request number
-             * @example 42
-             */
-            prNumber: number;
-            /**
-             * @description Commit SHA to associate
-             * @example abc123def456
-             */
-            commitSha: string;
-            /**
-             * @description Agent claiming this PR (admin tokens only)
-             * @example agent-id-123
-             */
-            claimedBy?: string;
-            /**
-             * @description Pipeline phase this claim is for (defaults to 'review' when omitted)
-             * @example patch
-             * @enum {string}
-             */
-            phase?: "review" | "patch" | "deploy";
-            /**
-             * @description ISO timestamp of the GitHub PR's actual creation time. Only applied on first claim (record creation); ignored on subsequent claims since the field is immutable once set.
-             * @example 2026-01-01T00:00:00.000Z
-             */
-            prCreatedAt?: string;
-            /**
-             * @description PR author's GitHub login (POM-1.2). Used server-side to derive `origin` (first-write-wins) and refreshed unconditionally on every claim.
-             * @example octocat
-             */
-            authorLogin?: string | null;
-            /**
-             * @description PR's head branch name (POM-1.2). Used server-side to derive `origin` (first-write-wins) and refreshed unconditionally on every claim.
-             * @example feat/some-branch
-             */
-            headRef?: string | null;
-            /**
-             * @description PR title (POM-1.2). Refreshed unconditionally on every claim.
-             * @example Add the origin metrics dimension
-             */
-            title?: string | null;
-        };
-        ClaimNextResponse: {
-            pr: components["schemas"]["PullRequest"];
-            /**
-             * @example review
-             * @enum {string}
-             */
-            phase: "review" | "patch" | "deploy";
-        };
-        ClaimNextBody: {
-            /**
-             * @description Agent ID (admin tokens only; agent tokens use token identity)
-             * @example agent-id-123
-             */
-            agentId?: string;
-            /**
-             * @description Maximum concurrent PRs to claim
-             * @example 1
-             */
-            maxConcurrent?: number;
-        };
-        CensusResponse: {
-            /** @description The upserted PullRequest rows, one per input entry. */
-            prs: components["schemas"]["PullRequest"][];
-        };
-        CensusEntry: {
-            /** @example org/repo */
-            repo: string;
-            /** @example 42 */
-            prNumber: number;
-            /**
-             * @description First-write-wins: only applied when the row's existing origin is currently null.
-             * @example unknown
-             * @enum {string}
-             */
-            origin?: "shipwright" | "ci" | "dependency_bot" | "human" | "unknown";
-            /** @example octocat */
-            authorLogin?: string | null;
-            /** @example feat/some-branch */
-            headRef?: string | null;
-            /** @example Add the origin metrics dimension */
-            title?: string | null;
-            /**
-             * @example merged
-             * @enum {string}
-             */
-            state?: "open" | "merged" | "closed";
-            /** @example 2026-01-04T00:00:00.000Z */
-            mergedAt?: string | null;
-            /** @example 2026-01-01T00:00:00.000Z */
-            prCreatedAt?: string | null;
-            /** @example 12 */
-            commitCount?: number | null;
-            /** @example 1 */
-            commitsDocsRefresh?: number | null;
-            /** @example 3 */
-            commitsReviewPatch?: number | null;
-            /** @example 2 */
-            commitsCiFix?: number | null;
-            /** @example 6 */
-            commitsImplementation?: number | null;
-        };
-        /** @description Entries to upsert, at most 200 per call — the whole batch runs in one transaction. An over-cap batch is rejected with 400. */
-        CensusBody: components["schemas"]["CensusEntry"][];
-        CensusCursorResponse: {
-            /**
-             * @description Max mergedAt (ISO string) among rows scoped to `repo` whose origin is not null, or null when no such row exists.
-             * @example 2026-01-04T00:00:00.000Z
-             */
-            cursor: string | null;
-        };
-        UpdatePrBody: {
-            [key: string]: unknown;
-        };
-        PatchPrBody: {
-            /**
-             * @description Current head commit SHA. When provided and it differs from the record's stored commitSha, reviewState resets to pending and commitSha is updated. When it matches, reviewState is left untouched (no-op patch cycle). When omitted, reviewState unconditionally resets to pending (legacy behavior).
-             * @example abc123def456
-             */
-            commitSha?: string;
-            /**
-             * @description Signature identifying the current CI failure (e.g. which check + which test). When it matches the record's stored lastCiFailureSignature, consecutiveCiFailureCount increments; when it differs (or none is stored), the count resets to 1 and the new signature is stored. Crossing CI_FAILURE_BLOCK_THRESHOLD (3) auto-sets blocked:true plus a descriptive blockedReason. When omitted (e.g. merge-conflict/review-fix patch calls unrelated to CI), both fields are left untouched.
-             * @example npm-test-failed-foo.unit.test.ts
-             */
-            ciFailureSignature?: string;
-        };
-        CreateFindingBody: {
-            /**
-             * @description Identifier for the finding (e.g. file:line or a slug).
-             * @example src/foo.ts:42
-             */
-            ref: string;
-            /**
-             * @description Triage outcome. source:'patch' may only submit 'rejected' — server-enforced (400 otherwise); source:'review' may submit any value.
-             * @example resolved
-             * @enum {string}
-             */
-            disposition: "resolved" | "superseded" | "rejected";
-            /**
-             * @description Which pipeline phase is recording this finding.
-             * @example review
-             * @enum {string}
-             */
-            source: "review" | "patch";
-            /** @example Fixed the null check in the follow-up commit. */
-            evidence: string;
-            /**
-             * @description ISO timestamp of when the finding was triaged. Defaults to the current time when omitted.
-             * @example 2026-08-17T12:00:00.000Z
-             */
-            at?: string;
-            /**
-             * @description Agent instance that triaged this finding.
-             * @example agent-abc123
-             */
-            agentId?: string;
-        };
-        PrEventsResponse: {
-            /** @description This PR's PullRequestEvent audit trail, ordered by `at` ascending (oldest first). */
-            events: components["schemas"]["PullRequestEvent"][];
-            /** @example 1 */
-            total: number;
-            /** @example 50 */
-            limit: number;
-            /** @example 0 */
-            offset: number;
-        };
-        Session: {
-            /** @example shipwright-may-launch */
-            slug: string;
-            /** @example May launch prep */
-            title?: string | null;
-            /**
-             * Format: date-time
-             * @example 2026-01-01T00:00:00.000Z
-             */
-            createdAt: string;
-            /**
-             * Format: date-time
-             * @example 2026-01-06T12:00:00.000Z
-             */
-            updatedAt: string;
-            /** @example null */
-            archivedAt?: string | null;
-            /** @example null */
-            archivedBy?: string | null;
-            /**
-             * @example active
-             * @enum {string}
-             */
-            state: "waiting" | "active" | "closed" | "empty";
-            /** @example 2026-01-01T00:00:00.000Z */
-            waitingSince: string | null;
-            /** @example 2026-01-06T12:00:00.000Z */
-            lastActivityAt: string | null;
-            /**
-             * @example {
-             *       "total": 3,
-             *       "open": 2,
-             *       "closed": 1
-             *     }
-             */
-            counts: {
-                total: number;
-                open: number;
-                closed: number;
-            };
-            /**
-             * @example [
-             *       "agent-1"
-             *     ]
-             */
-            agentIds: string[];
-            /**
-             * @example [
-             *       "org/repo"
-             *     ]
-             */
-            repos: string[];
-            /**
-             * @example [
-             *       {
-             *         "id": "task-1",
-             *         "kind": "hitl"
-             *       }
-             *     ]
-             */
-            waitingTasks: {
-                id: string;
-                /** @enum {string} */
-                kind: "hitl" | "blocked" | "pr_blocked";
-            }[];
-            /** @example false */
-            archived: boolean;
-        };
-        SessionListResponse: {
-            sessions: components["schemas"]["Session"][];
-            /** @example 10 */
-            total: number;
-            /** @example 50 */
-            limit: number;
-            /** @example 0 */
-            offset: number;
-        };
-        SessionPatchBody: {
-            /**
-             * @description Omitted: title untouched. A string: set. null: clears the title.
-             * @example May launch prep
-             */
-            title?: string | null;
-            /**
-             * @description Omitted: archive fields untouched. true: stamps archivedAt/archivedBy. false: clears both.
-             * @example true
-             */
-            archived?: boolean;
-        };
-        VerificationCheck: {
-            /** @example clxvcheck1234567 */
-            id: string;
-            /** @example null */
-            taskId: string | null;
-            /** @example clx0987654321 */
-            prRecordId: string | null;
-            /** @example org/repo */
-            repo: string;
-            /** @example unit */
-            checkName: string;
-            /**
-             * @description Outcome of the check attempt. A 'ran_failed' row must never carry a reasonCategory — that field means the agent could not attempt/complete the check in its own environment, never that the code has a real problem.
-             * @example ran_passed
-             * @enum {string}
-             */
-            status: "ran_passed" | "ran_failed" | "skipped" | "timed_out";
-            /**
-             * @description A closed set of ENVIRONMENTAL causes, only valid alongside status: 'skipped' or 'timed_out'.
-             * @example null
-             * @enum {string|null}
-             */
-            reasonCategory: "check_timeout" | "install_timeout" | "resource_limit" | "missing_tool" | "missing_secret" | "missing_dependency" | "not_configured" | "learned_skip" | null;
-            /**
-             * @description Only valid alongside reasonCategory: 'learned_skip' — the original root-cause category that triggered the learned classification.
-             * @example null
-             * @enum {string|null}
-             */
-            learnedFromCategory: "check_timeout" | "install_timeout" | "resource_limit" | "missing_tool" | "missing_secret" | "missing_dependency" | "not_configured" | "learned_skip" | null;
-            /** @example 4200 */
-            durationMs: number | null;
-            /** @example 2026-09-24T12:00:00.000Z */
-            at: string;
-            /**
-             * Format: date-time
-             * @example 2026-09-24T12:00:00.000Z
-             */
-            createdAt: string;
-        };
-        CreateVerificationCheckBody: {
-            /**
-             * @description Exactly one of taskId/prId is required — supplying neither or both is 400.
-             * @example clx1234567890
-             */
-            taskId?: string;
-            /** @example clx0987654321 */
-            prId?: string;
-            /** @example org/repo */
-            repo: string;
-            /**
-             * @description Free-form check name — 'install', 'lint', 'typecheck', 'unit', 'integration', etc.
-             * @example unit
-             */
-            checkName: string;
-            /**
-             * @example ran_passed
-             * @enum {string}
-             */
-            status: "ran_passed" | "ran_failed" | "skipped" | "timed_out";
-            /**
-             * @description Only valid alongside status: 'skipped' or 'timed_out'. A status:'ran_failed' (or 'ran_passed') request supplying this is 400.
-             * @example missing_tool
-             * @enum {string}
-             */
-            reasonCategory?: "check_timeout" | "install_timeout" | "resource_limit" | "missing_tool" | "missing_secret" | "missing_dependency" | "not_configured" | "learned_skip";
-            /**
-             * @description Only valid alongside reasonCategory: 'learned_skip', and must not itself be 'learned_skip'.
-             * @example missing_tool
-             * @enum {string}
-             */
-            learnedFromCategory?: "check_timeout" | "install_timeout" | "resource_limit" | "missing_tool" | "missing_secret" | "missing_dependency" | "not_configured" | "learned_skip";
-            /** @example 4200 */
-            durationMs?: number;
-            /**
-             * @description ISO timestamp of when the check completed. Defaults to the current time when omitted.
-             * @example 2026-09-24T12:00:00.000Z
-             */
-            at?: string;
-        };
-        VerificationCheckListResponse: {
-            /** @description Verification checks matching the selected mode. Ordered by `at` ascending (oldest first) for taskId/prId modes; ordered by `at` descending (most recent first) for repo+checkName mode. */
-            checks: components["schemas"]["VerificationCheck"][];
-            /** @example 1 */
-            total: number;
-            /** @example 50 */
-            limit: number;
-            /** @example 0 */
-            offset: number;
-        };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-export type $defs = Record<string, never>;
-export type operations = Record<string, never>;