@cleocode/core 2026.10.13 → 2026.10.14-rc.ci.683

package/dist/gateway-client/generated/types.gen.d.ts

@@ -1,6 +1,180 @@
 export type ClientOptions = {
     baseUrl: `${string}://${string}` | (string & {});
 };
+export type MutateTasksReqAddData = {
+    body: {
+        /**
+         * Task that owns the requirement gates
+         */
+        taskId: string;
+        /**
+         * AcceptanceGate JSON; must include kind, description and kind-specific fields
+         */
+        gate: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/req.add';
+};
+export type MutateTasksReqAddResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateTasksReqAddResponse = MutateTasksReqAddResponses[keyof MutateTasksReqAddResponses];
+export type MutateTasksReqReplaceData = {
+    body: {
+        /**
+         * Task that owns the requirement gates
+         */
+        taskId: string;
+        /**
+         * REQ-ID of the gate to replace
+         */
+        req: string;
+        /**
+         * Replacement AcceptanceGate JSON; its req must be absent or equal the REQ-ID
+         */
+        gate: string;
+        /**
+         * Why the gate changes; required once the task is in a locked pipeline stage
+         */
+        reason?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/req.replace';
+};
+export type MutateTasksReqReplaceResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateTasksReqReplaceResponse = MutateTasksReqReplaceResponses[keyof MutateTasksReqReplaceResponses];
+export type QueryTasksReqListData = {
+    body: {
+        /**
+         * Task that owns the requirement gates
+         */
+        taskId: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/req.list';
+};
+export type QueryTasksReqListResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryTasksReqListResponse = QueryTasksReqListResponses[keyof QueryTasksReqListResponses];
+export type QueryTasksReqMigratePreviewData = {
+    body: {
+        /**
+         * Task that owns the requirement gates
+         */
+        taskId: string;
+        /**
+         * Must be absent or false for preview
+         */
+        apply?: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/req.migrate.preview';
+};
+export type QueryTasksReqMigratePreviewResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryTasksReqMigratePreviewResponse = QueryTasksReqMigratePreviewResponses[keyof QueryTasksReqMigratePreviewResponses];
+export type MutateTasksReqMigrateData = {
+    body: {
+        /**
+         * Task that owns the requirement gates
+         */
+        taskId: string;
+        /**
+         * Must be true to apply proposals
+         */
+        apply: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/req.migrate';
+};
+export type MutateTasksReqMigrateResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateTasksReqMigrateResponse = MutateTasksReqMigrateResponses[keyof MutateTasksReqMigrateResponses];
 export type QueryTasksShowData = {
     body: {
         /**
@@ -26,7 +200,7 @@ export type QueryTasksShowData = {
 };
 export type QueryTasksShowResponses = {
     /**
-     * The task record is nested under `task` — use /data/task/<field>, not /data/<field>. `view` may be null. `acRows` and `relations` are conditional.
+     * The task record is nested under `task` — use /data/task/<field>, not /data/<field>. Mutation envelopes are FLAT by contrast (/data/created/0, /data/updated/0), which is the asymmetry that produced GH #1225/#1239/#1231. `view` may be null. `acRows` and `relations` are conditional. The default (MVI) projection withholds each `acRows` UUID and names it once in `/data/_withheld` as `acRows*id` (T12523); cite a criterion by `alias` (AC1..n). `description`, `acceptance` and `verification` are withheld by the default (MVI) projection but `--field` resolves them transparently (T12108) — no `--full` needed. Evidence is NOT a task field: it lives at /data/task/verification/evidence (keyed by gate), alongside /data/task/verification/gates. T12127 (GH #1231) — the previous wording advertised `/data/task/evidence`, which does not exist, in the very text shown to an agent whose pointer had just failed.
      */
     200: {
         success: true;
@@ -41,6 +215,35 @@ export type QueryTasksShowResponses = {
                 priority?: string;
                 type?: string;
                 parentId?: string | null;
+                /**
+                 * Task version for optimistic concurrency: pass it to `cleo update|complete --if-match`. A stale version fails with E_CONFLICT (23); E_TASK_RENAMED (26) when sync re-numbered the task you read (details.expected is its new id).
+                 */
+                updatedAt?: string | null;
+                /**
+                 * Human / owner assignee. Separate from `claim`.
+                 */
+                assignee?: string | null;
+                /**
+                 * Agent claim lease (T12502): the holder session, its agent, and when the lease lapses unless renewed. Absent when unclaimed.
+                 */
+                claim?: {
+                    /**
+                     * Session holding the lease.
+                     */
+                    sessionId: string;
+                    /**
+                     * Agent identity of the holder.
+                     */
+                    agentId: string | null;
+                    /**
+                     * When the lease was taken (ISO-8601 UTC).
+                     */
+                    claimedAt: string;
+                    /**
+                     * When the lease lapses unless renewed (ISO-8601 UTC).
+                     */
+                    leaseExpiresAt: string;
+                };
             };
             /**
              * Canonical task view projection produced by computeTaskView. Null when unavailable.
@@ -53,9 +256,15 @@ export type QueryTasksShowResponses = {
              */
             attachments: Array<unknown>;
             /**
-             * Acceptance-criterion rows (id, alias AC<n>, ordinal, text). Optional.
+             * Acceptance-criterion rows (alias AC<n>, ordinal, text; the UUID id only with --full). Optional.
              */
             acRows?: Array<unknown>;
+            /**
+             * Fields the default projection withheld from list elements, e.g. `acRows*id` → UTF-8 byte total. Absent with --full.
+             */
+            _withheld?: {
+                [key: string]: unknown;
+            };
             /**
              * Expanded relation/doc lists. Present only with --relations.
              */
@@ -391,6 +600,10 @@ export type QueryTasksSubscribeResponses = {
 export type QueryTasksSubscribeResponse = QueryTasksSubscribeResponses[keyof QueryTasksSubscribeResponses];
 export type QueryTasksListData = {
     body?: {
+        /**
+         * Include archived rows under the same filters
+         */
+        includeArchive?: boolean;
         /**
          * Filter by parent task ID
          */
@@ -407,6 +620,14 @@ export type QueryTasksListData = {
          * Filter by task type
          */
         type?: string;
+        /**
+         * Filter by severity axis (P0|P1|P2|P3); invalid values are rejected
+         */
+        severity?: string;
+        /**
+         * Filter by kind axis (work|research|experiment|bug|spike|release); invalid values are rejected
+         */
+        kind?: string;
         /**
          * Filter by task phase
          */
@@ -416,11 +637,11 @@ export type QueryTasksListData = {
          */
         label?: string;
         /**
-         * Limit parent queries to direct children
+         * DEPRECATED (no effect; slated for removal in a future major): --parent already returns DIRECT children only, for every parent type including sagas. Do not use.
          */
         children?: boolean;
         /**
-         * Maximum number of tasks to return
+         * Maximum number of tasks to return (default 10). --all or --limit 0 returns every match.
          */
         limit?: number;
         /**
@@ -459,6 +680,23 @@ export type QueryTasksListResponses = {
              * Number of tasks after filters applied.
              */
             filtered: number;
+            population: {
+                /**
+                 * All rows matching the query before pagination.
+                 */
+                matched: number;
+                /**
+                 * Rows present in this response; also --output count.
+                 */
+                returned: number;
+                /**
+                 * Matching rows are omitted by this page.
+                 */
+                truncated: boolean;
+                archive: 'included' | 'excluded' | 'only';
+                limit: number | null;
+                offset: number;
+            };
             [key: string]: unknown;
         };
         /**
@@ -496,12 +734,29 @@ export type QueryTasksFindResponses = {
              * Total matching tasks.
              */
             total: number;
+            population: {
+                /**
+                 * All rows matching the query before pagination.
+                 */
+                matched: number;
+                /**
+                 * Rows present in this response; also --output count.
+                 */
+                returned: number;
+                /**
+                 * Matching rows are omitted by this page.
+                 */
+                truncated: boolean;
+                archive: 'included' | 'excluded' | 'only';
+                limit: number | null;
+                offset: number;
+            };
             /**
              * The query string that was searched.
              */
             query?: string;
             /**
-             * Kind of search performed (fts, semantic, ...).
+             * Requested matching mode: lexical (default), fuzzy (explicit opt-in), exact, id, or filter.
              */
             searchType?: string;
             [key: string]: unknown;
@@ -1005,7 +1260,20 @@ export type QueryTasksComplexityEstimateResponses = {
 };
 export type QueryTasksComplexityEstimateResponse = QueryTasksComplexityEstimateResponses[keyof QueryTasksComplexityEstimateResponses];
 export type QueryTasksHistoryData = {
-    body?: never;
+    body?: {
+        /**
+         * Task to show history for
+         */
+        taskId?: string;
+        /**
+         * Maximum entries
+         */
+        limit?: number;
+        /**
+         * Only ranking-input changes (actor, session, reason, before/after)
+         */
+        ranking?: boolean;
+    };
     path?: never;
     query?: never;
     url: '/v1/tasks/history';
@@ -2737,11 +3005,70 @@ export type QueryCheckGateStatusData = {
 };
 export type QueryCheckGateStatusResponses = {
     /**
-     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     * FLAT record identical in shape to check.gate.set. Read-only: reports which gates are recorded and which are still missing. /data/missingGates being empty is the precondition for `cleo complete`.
      */
     200: {
         success: true;
         data: {
+            /**
+             * The task the gates belong to.
+             */
+            taskId: string;
+            /**
+             * Task title, for operator display.
+             */
+            title?: string;
+            /**
+             * Task lifecycle status.
+             */
+            status?: string;
+            /**
+             * Task type (epic | task | subtask).
+             */
+            type?: string;
+            verification: {
+                /**
+                 * True when every required gate is set.
+                 */
+                passed?: boolean;
+                /**
+                 * IVTR round counter.
+                 */
+                round?: number;
+                /**
+                 * Gate name → whether it is recorded as passed.
+                 */
+                gates?: {
+                    [key: string]: boolean;
+                };
+                /**
+                 * Gate name → the evidence atom kinds validated for it.
+                 */
+                evidence?: {
+                    [key: string]: unknown;
+                };
+                [key: string]: unknown;
+            };
+            /**
+             * Whether every required gate is now recorded.
+             */
+            verificationStatus: 'passed' | 'pending';
+            /**
+             * Mirror of verification.passed.
+             */
+            passed: boolean;
+            /**
+             * IVTR round counter.
+             */
+            round?: number;
+            /**
+             * Gates this project requires before complete.
+             */
+            requiredGates?: Array<string>;
+            /**
+             * Required gates not yet recorded — empty means ready to complete.
+             */
+            missingGates?: Array<string>;
             [key: string]: unknown;
         };
         /**
@@ -2754,6 +3081,44 @@ export type QueryCheckGateStatusResponses = {
     };
 };
 export type QueryCheckGateStatusResponse = QueryCheckGateStatusResponses[keyof QueryCheckGateStatusResponses];
+export type QueryCheckGateRunData = {
+    body: {
+        /**
+         * Task whose typed gates should run
+         */
+        taskId: string;
+        /**
+         * Actor attribution recorded on each gate result
+         */
+        agent?: string;
+        /**
+         * Comma-separated REQ-IDs: run and cache only these typed gates; the others are not run (T13486)
+         */
+        req?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/check/gate.run';
+};
+export type QueryCheckGateRunResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryCheckGateRunResponse = QueryCheckGateRunResponses[keyof QueryCheckGateRunResponses];
 export type QueryCheckArchiveStatsData = {
     body?: never;
     path?: never;
@@ -4099,6 +4464,7 @@ export type MutateTasksAddData = {
         description?: string;
         parent?: string;
         depends?: Array<string>;
+        dependsWaiver?: string;
         priority?: 'low' | 'medium' | 'high' | 'critical';
         labels?: Array<string>;
         type?: 'saga' | 'epic' | 'task' | 'subtask';
@@ -4113,6 +4479,7 @@ export type MutateTasksAddData = {
         scope?: 'project' | 'feature' | 'unit';
         severity?: 'P0' | 'P1' | 'P2' | 'P3';
         forceDuplicate?: boolean;
+        autoDecompose?: boolean;
     };
     path?: never;
     query?: never;
@@ -4184,6 +4551,7 @@ export type MutateTasksAddBatchData = {
             scope?: 'project' | 'feature' | 'unit';
             severity?: 'P0' | 'P1' | 'P2' | 'P3';
             forceDuplicate?: boolean;
+            autoDecompose?: boolean;
         }>;
         defaultParent?: string;
         dryRun?: boolean;
@@ -4258,6 +4626,7 @@ export type MutateTasksUpdateData = {
         description?: string;
         status?: 'pending' | 'active' | 'blocked' | 'done' | 'cancelled';
         priority?: 'low' | 'medium' | 'high' | 'critical';
+        phase?: string;
         notes?: string;
         labels?: Array<string>;
         addLabels?: Array<string>;
@@ -4278,7 +4647,9 @@ export type MutateTasksUpdateData = {
         severity?: 'P0' | 'P1' | 'P2' | 'P3';
         reason?: string;
         dependsWaiver?: string;
+        blockedBy?: string;
         clearBlockedBy?: boolean;
+        noAutoComplete?: boolean;
         relates?: Array<{
             taskId: string;
             type: string;
@@ -4290,6 +4661,7 @@ export type MutateTasksUpdateData = {
             reason?: string;
         }>;
         removeRelates?: Array<string>;
+        expectedUpdatedAt?: string;
     };
     path?: never;
     query?: never;
@@ -4348,6 +4720,10 @@ export type MutateTasksCompleteData = {
          * taskId parameter
          */
         taskId: string;
+        /**
+         * Optimistic-concurrency guard: fail with E_CONFLICT unless the task updatedAt still equals this value
+         */
+        expectedUpdatedAt?: string;
     };
     path?: never;
     query?: never;
@@ -4440,6 +4816,14 @@ export type MutateTasksDeleteData = {
          * taskId parameter
          */
         taskId: string;
+        /**
+         * Allow dependents and orphan children unless cascade is enabled
+         */
+        force?: boolean;
+        /**
+         * Archive all descendants with the selected task
+         */
+        cascade?: boolean;
     };
     path?: never;
     query?: never;
@@ -4484,12 +4868,92 @@ export type MutateTasksDeleteResponses = {
     };
 };
 export type MutateTasksDeleteResponse = MutateTasksDeleteResponses[keyof MutateTasksDeleteResponses];
-export type MutateTasksArchiveData = {
-    body?: never;
-    path?: never;
-    query?: never;
-    url: '/v1/tasks/archive';
-};
+export type MutateTasksReconcileScopeData = {
+    body: {
+        /**
+         * Saga, epic or other container to sweep (its whole subtree is considered)
+         */
+        rootId: string;
+        /**
+         * Write the proposed `relates` edges (read-only without it)
+         */
+        apply?: boolean;
+        /**
+         * Report pairs at or above this similarity score, 0-1 (default 0.55)
+         */
+        threshold?: number;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/reconcile-scope';
+};
+export type MutateTasksReconcileScopeResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateTasksReconcileScopeResponse = MutateTasksReconcileScopeResponses[keyof MutateTasksReconcileScopeResponses];
+export type MutateTasksDecomposeData = {
+    body: {
+        /**
+         * Task whose text acceptance criteria move to a new child
+         */
+        taskId: string;
+        /**
+         * Title for the child that inherits the criteria (default: the parent’s)
+         */
+        childTitle?: string;
+        /**
+         * Description for the child (default: the parent’s)
+         */
+        childDescription?: string;
+        /**
+         * Preview the move without writing
+         */
+        dryRun?: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/decompose';
+};
+export type MutateTasksDecomposeResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateTasksDecomposeResponse = MutateTasksDecomposeResponses[keyof MutateTasksDecomposeResponses];
+export type MutateTasksArchiveData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/archive';
+};
 export type MutateTasksArchiveResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
@@ -4745,6 +5209,44 @@ export type MutateTasksAssigneeResponses = {
     };
 };
 export type MutateTasksAssigneeResponse = MutateTasksAssigneeResponses[keyof MutateTasksAssigneeResponses];
+export type MutateTasksRankingRevertData = {
+    body: {
+        /**
+         * ranking_changed audit row id (cleo history ranking <taskId>)
+         */
+        entryId: string;
+        /**
+         * Why it is reverted
+         */
+        reason?: string;
+        /**
+         * Revert even though a field changed again since
+         */
+        force?: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/tasks/ranking.revert';
+};
+export type MutateTasksRankingRevertResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateTasksRankingRevertResponse = MutateTasksRankingRevertResponses[keyof MutateTasksRankingRevertResponses];
 export type MutateTasksRelatesAddData = {
     body: {
         /**
@@ -5182,6 +5684,14 @@ export type MutateTasksStartData = {
          * taskId parameter
          */
         taskId: string;
+        /**
+         * Take over another session's EXPIRED claim lease (audited)
+         */
+        takeOver?: boolean;
+        /**
+         * Take over another session's LIVE claim lease (audited)
+         */
+        forceClaim?: boolean;
     };
     path?: never;
     query?: never;
@@ -5189,11 +5699,40 @@ export type MutateTasksStartData = {
 };
 export type MutateTasksStartResponses = {
     /**
-     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     * The claim lease this start holds is at /data/claim (null when the caller is not bound to a session). Another session holding the task fails with E_TASK_CLAIMED (exit 35); error.details.holder names it.
      */
     200: {
         success: true;
         data: {
+            /**
+             * The task now active.
+             */
+            taskId: string;
+            /**
+             * The task active before, if any.
+             */
+            previousTask: string | null;
+            /**
+             * Agent claim lease (T12502): the holder session, its agent, and when the lease lapses unless renewed. Absent when unclaimed.
+             */
+            claim?: {
+                /**
+                 * Session holding the lease.
+                 */
+                sessionId: string;
+                /**
+                 * Agent identity of the holder.
+                 */
+                agentId: string | null;
+                /**
+                 * When the lease was taken (ISO-8601 UTC).
+                 */
+                claimedAt: string;
+                /**
+                 * When the lease lapses unless renewed (ISO-8601 UTC).
+                 */
+                leaseExpiresAt: string;
+            } | null;
             [key: string]: unknown;
         };
         /**
@@ -5374,11 +5913,40 @@ export type MutateTasksClaimData = {
 };
 export type MutateTasksClaimResponses = {
     /**
-     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     * The lease now held by your session is at /data/claim; renew it with --renew. Another holder fails with E_TASK_CLAIMED (exit 35): --take-over (expired) or --force-claim (live).
      */
     200: {
         success: true;
         data: {
+            /**
+             * The claimed task.
+             */
+            taskId: string;
+            /**
+             * Agent recorded with the lease.
+             */
+            agentId: string | null;
+            /**
+             * Agent claim lease (T12502): the holder session, its agent, and when the lease lapses unless renewed. Absent when unclaimed.
+             */
+            claim: {
+                /**
+                 * Session holding the lease.
+                 */
+                sessionId: string;
+                /**
+                 * Agent identity of the holder.
+                 */
+                agentId: string | null;
+                /**
+                 * When the lease was taken (ISO-8601 UTC).
+                 */
+                claimedAt: string;
+                /**
+                 * When the lease lapses unless renewed (ISO-8601 UTC).
+                 */
+                leaseExpiresAt: string;
+            };
             [key: string]: unknown;
         };
         /**
@@ -5397,6 +5965,10 @@ export type MutateTasksUnclaimData = {
          * Task ID to unclaim
          */
         taskId: string;
+        /**
+         * Release another session's lease (audited)
+         */
+        forceClaim?: boolean;
     };
     path?: never;
     query?: never;
@@ -5404,11 +5976,19 @@ export type MutateTasksUnclaimData = {
 };
 export type MutateTasksUnclaimResponses = {
     /**
-     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     * /data/released is true when a lease was cleared, false when the task was unclaimed.
      */
     200: {
         success: true;
         data: {
+            /**
+             * The released task.
+             */
+            taskId: string;
+            /**
+             * Whether a lease was cleared.
+             */
+            released: boolean;
             [key: string]: unknown;
         };
         /**
@@ -5883,6 +6463,10 @@ export type MutateMemoryObserveData = {
          * text parameter
          */
         text: string;
+        /**
+         * Store to write: project (default) or global, the synced main brain (T13720)
+         */
+        scope?: string;
     };
     path?: never;
     query?: never;
@@ -5917,6 +6501,10 @@ export type MutateMemoryDecisionStoreData = {
          * rationale parameter
          */
         rationale: string;
+        /**
+         * Store to write: project (default) or global, the synced main brain (T13720)
+         */
+        scope?: string;
     };
     path?: never;
     query?: never;
@@ -6749,7 +7337,24 @@ export type QueryMemoryBackfillListResponses = {
 };
 export type QueryMemoryBackfillListResponse = QueryMemoryBackfillListResponses[keyof QueryMemoryBackfillListResponses];
 export type MutateMemoryBackfillRunData = {
-    body?: never;
+    body?: {
+        /**
+         * Source of the reviewed backfill request.
+         */
+        source?: string;
+        /**
+         * Backfill classification.
+         */
+        kind?: string;
+        /**
+         * Derived brain_page_nodes target only.
+         */
+        targetTable?: string;
+        /**
+         * Exact qualified graph node IDs to stage; all must resolve to missing, eligible typed sources.
+         */
+        nodeIds?: Array<string>;
+    };
     path?: never;
     query?: never;
     url: '/v1/memory/backfill.run';
@@ -6988,6 +7593,56 @@ export type MutatePipelineManifestAppendResponses = {
     };
 };
 export type MutatePipelineManifestAppendResponse = MutatePipelineManifestAppendResponses[keyof MutatePipelineManifestAppendResponses];
+export type MutatePipelineManifestUpdateData = {
+    body: {
+        /**
+         * Manifest entry id
+         */
+        id: string;
+        /**
+         * Task id to add to linked_tasks
+         */
+        linkTask?: string;
+        /**
+         * New title
+         */
+        title?: string;
+        /**
+         * Replacement topics
+         */
+        topics?: Array<string>;
+        /**
+         * Replacement key findings
+         */
+        key_findings?: Array<string>;
+        /**
+         * New status
+         */
+        status?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/pipeline/manifest.update';
+};
+export type MutatePipelineManifestUpdateResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutatePipelineManifestUpdateResponse = MutatePipelineManifestUpdateResponses[keyof MutatePipelineManifestUpdateResponses];
 export type MutatePipelineManifestArchiveData = {
     body: {
         /**
@@ -7245,11 +7900,70 @@ export type MutateCheckGateSetData = {
 };
 export type MutateCheckGateSetResponses = {
     /**
-     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     * FLAT record, not the nested read shape. The verification object is at /data/verification — NEVER /data/task/verification, which is how `cleo show` nests a task and does not exist here. The response is self-confirming: it returns the full verification after the write, so there is no need to re-read.
      */
     200: {
         success: true;
         data: {
+            /**
+             * The task the gates belong to.
+             */
+            taskId: string;
+            /**
+             * Task title, for operator display.
+             */
+            title?: string;
+            /**
+             * Task lifecycle status.
+             */
+            status?: string;
+            /**
+             * Task type (epic | task | subtask).
+             */
+            type?: string;
+            verification: {
+                /**
+                 * True when every required gate is set.
+                 */
+                passed?: boolean;
+                /**
+                 * IVTR round counter.
+                 */
+                round?: number;
+                /**
+                 * Gate name → whether it is recorded as passed.
+                 */
+                gates?: {
+                    [key: string]: boolean;
+                };
+                /**
+                 * Gate name → the evidence atom kinds validated for it.
+                 */
+                evidence?: {
+                    [key: string]: unknown;
+                };
+                [key: string]: unknown;
+            };
+            /**
+             * Whether every required gate is now recorded.
+             */
+            verificationStatus: 'passed' | 'pending';
+            /**
+             * Mirror of verification.passed.
+             */
+            passed: boolean;
+            /**
+             * IVTR round counter.
+             */
+            round?: number;
+            /**
+             * Gates this project requires before complete.
+             */
+            requiredGates?: Array<string>;
+            /**
+             * Required gates not yet recorded — empty means ready to complete.
+             */
+            missingGates?: Array<string>;
             [key: string]: unknown;
         };
         /**
@@ -10212,32 +10926,98 @@ export type QueryNexusProjectsListResponses = {
     };
 };
 export type QueryNexusProjectsListResponse = QueryNexusProjectsListResponses[keyof QueryNexusProjectsListResponses];
-export type MutateNexusProjectsRegisterData = {
-    body: {
+export type QueryNexusProjectsFleetData = {
+    body?: {
         /**
-         * Path to the project directory
+         * Only locations on this device (device id, hostname, or current)
          */
-        path: string;
+        device?: string;
         /**
-         * Custom project name
+         * Only projects with a missing location
          */
-        name?: string;
-    };
-    path?: never;
-    query?: never;
-    url: '/v1/nexus/projects.register';
-};
-export type MutateNexusProjectsRegisterResponses = {
-    /**
-     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
-     */
-    200: {
-        success: true;
-        data: {
-            [key: string]: unknown;
-        };
+        missing?: boolean;
         /**
-         * LAFS response metadata.
+         * Only projects with a dirty location
+         */
+        dirty?: boolean;
+        /**
+         * Only projects with a location behind its upstream (as of the last fetch)
+         */
+        behind?: boolean;
+        /**
+         * Only projects with a location ahead of its upstream (as of the last fetch)
+         */
+        ahead?: boolean;
+        /**
+         * Only projects with a never-probed, old-probe or old-fetch location
+         */
+        stale?: boolean;
+        /**
+         * Only projects whose last probe recorded an error
+         */
+        errored?: boolean;
+        /**
+         * Staleness window for probes, fetches and heartbeats (default 24h)
+         */
+        staleAfterMs?: number;
+        /**
+         * Page size in projects (default 50, max 500; 0 = all)
+         */
+        limit?: number;
+        /**
+         * Projects skipped before the page
+         */
+        offset?: number;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/nexus/projects.fleet';
+};
+export type QueryNexusProjectsFleetResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryNexusProjectsFleetResponse = QueryNexusProjectsFleetResponses[keyof QueryNexusProjectsFleetResponses];
+export type MutateNexusProjectsRegisterData = {
+    body: {
+        /**
+         * Path to the project directory
+         */
+        path: string;
+        /**
+         * Custom project name
+         */
+        name?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/nexus/projects.register';
+};
+export type MutateNexusProjectsRegisterResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
          */
         meta: {
             [key: string]: unknown;
@@ -10318,6 +11098,48 @@ export type MutateNexusProjectsScanResponses = {
     };
 };
 export type MutateNexusProjectsScanResponse = MutateNexusProjectsScanResponses[keyof MutateNexusProjectsScanResponses];
+export type MutateNexusProjectsStatusData = {
+    body?: {
+        /**
+         * Run git fetch per location first (network; off by default)
+         */
+        fetch?: boolean;
+        /**
+         * Locations probed at once (default 8, max 64)
+         */
+        concurrency?: number;
+        /**
+         * Per-location git budget in ms (default 10000; 30000 with fetch)
+         */
+        timeoutMs?: number;
+        /**
+         * A fetch older than this marks remote state stale (default 24h)
+         */
+        staleAfterMs?: number;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/nexus/projects.status';
+};
+export type MutateNexusProjectsStatusResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateNexusProjectsStatusResponse = MutateNexusProjectsStatusResponses[keyof MutateNexusProjectsStatusResponses];
 export type MutateNexusProjectsCleanData = {
     body?: {
         /**
@@ -10329,7 +11151,7 @@ export type MutateNexusProjectsCleanData = {
          */
         pattern?: string;
         /**
-         * Match .temp/ paths
+         * Match .temp/ or OS temp-directory paths
          */
         includeTemp?: boolean;
         /**
@@ -10353,7 +11175,7 @@ export type MutateNexusProjectsCleanData = {
          */
         removeFs?: boolean;
         /**
-         * After delete, run sqlite VACUUM on nexus.db to reclaim space (T9117)
+         * After delete, VACUUM the global registry store (<cleoHome>/cleo.db) to reclaim space (T9117 · T12324)
          */
         vacuum?: boolean;
     };
@@ -11279,15 +12101,755 @@ export type QueryIntelligenceConfidenceResponse = QueryIntelligenceConfidenceRes
 export type QueryIntelligenceMatchData = {
     body: {
         /**
-         * Task ID to match patterns against
+         * Task ID to match patterns against
+         */
+        taskId: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/intelligence/match';
+};
+export type QueryIntelligenceMatchResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryIntelligenceMatchResponse = QueryIntelligenceMatchResponses[keyof QueryIntelligenceMatchResponses];
+export type QueryDiagnosticsStatusData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/diagnostics/status';
+};
+export type QueryDiagnosticsStatusResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDiagnosticsStatusResponse = QueryDiagnosticsStatusResponses[keyof QueryDiagnosticsStatusResponses];
+export type QueryDiagnosticsAnalyzeData = {
+    body?: {
+        /**
+         * Analysis window in days (default: 30)
+         */
+        days?: number;
+        /**
+         * Skip pushing observations to BRAIN
+         */
+        noBrain?: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/diagnostics/analyze';
+};
+export type QueryDiagnosticsAnalyzeResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDiagnosticsAnalyzeResponse = QueryDiagnosticsAnalyzeResponses[keyof QueryDiagnosticsAnalyzeResponses];
+export type QueryDiagnosticsExportData = {
+    body?: {
+        /**
+         * Limit export to last N days (default: all)
+         */
+        days?: number;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/diagnostics/export';
+};
+export type QueryDiagnosticsExportResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDiagnosticsExportResponse = QueryDiagnosticsExportResponses[keyof QueryDiagnosticsExportResponses];
+export type MutateDiagnosticsEnableData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/diagnostics/enable';
+};
+export type MutateDiagnosticsEnableResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateDiagnosticsEnableResponse = MutateDiagnosticsEnableResponses[keyof MutateDiagnosticsEnableResponses];
+export type MutateDiagnosticsDisableData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/diagnostics/disable';
+};
+export type MutateDiagnosticsDisableResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateDiagnosticsDisableResponse = MutateDiagnosticsDisableResponses[keyof MutateDiagnosticsDisableResponses];
+export type MutateDocsAddData = {
+    body: {
+        /**
+         * Owner entity ID (e.g. T123, ses_*, O-abc)
+         */
+        ownerId: string;
+        /**
+         * Path to local file to attach
+         */
+        file?: string;
+        /**
+         * Remote URL to attach
+         */
+        url?: string;
+        /**
+         * Inline document body (T10965); mutually exclusive with file/url
+         */
+        content?: string;
+        /**
+         * Free-text description
+         */
+        desc?: string;
+        /**
+         * Comma-separated labels
+         */
+        labels?: string;
+        /**
+         * Agent identity (defaults to "human")
+         */
+        attachedBy?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/add';
+};
+export type MutateDocsAddResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateDocsAddResponse = MutateDocsAddResponses[keyof MutateDocsAddResponses];
+export type QueryDocsListData = {
+    body?: {
+        /**
+         * Filter by task ID (e.g. T123)
+         */
+        task?: string;
+        /**
+         * Filter by session ID (e.g. ses_*)
+         */
+        session?: string;
+        /**
+         * Filter by observation ID (e.g. O-abc)
+         */
+        observation?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/list';
+};
+export type QueryDocsListResponses = {
+    /**
+     * Records (doc) are under /data/attachments (array). Use /data/attachments/0/<field>.
+     */
+    200: {
+        success: true;
+        data: {
+            /**
+             * Array of doc records.
+             */
+            attachments: Array<{
+                [key: string]: unknown;
+            }>;
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsListResponse = QueryDocsListResponses[keyof QueryDocsListResponses];
+export type QueryDocsFetchData = {
+    body: {
+        /**
+         * Attachment ID (att_*) or SHA-256 hex
+         */
+        attachmentRef: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/fetch';
+};
+export type QueryDocsFetchResponses = {
+    /**
+     * Records (doc) are under /data/metadata. Use /data/metadata/<field>.
+     */
+    200: {
+        success: true;
+        data: {
+            /**
+             * A doc record.
+             */
+            metadata: {
+                [key: string]: unknown;
+            };
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsFetchResponse = QueryDocsFetchResponses[keyof QueryDocsFetchResponses];
+export type MutateDocsRemoveData = {
+    body: {
+        /**
+         * Attachment ID (att_*) or SHA-256 hex
+         */
+        attachmentRef: string;
+        /**
+         * Owner entity ID to remove the ref from
+         */
+        from: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/remove';
+};
+export type MutateDocsRemoveResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateDocsRemoveResponse = MutateDocsRemoveResponses[keyof MutateDocsRemoveResponses];
+export type MutateDocsLinkDecisionData = {
+    body: {
+        /**
+         * Slug of the ADR doc
+         */
+        adrSlug: string;
+        /**
+         * The D#### brain ledger decision id the ADR ratifies
+         */
+        decisionId: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/link-decision';
+};
+export type MutateDocsLinkDecisionResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateDocsLinkDecisionResponse = MutateDocsLinkDecisionResponses[keyof MutateDocsLinkDecisionResponses];
+export type MutateDocsUnlinkDecisionData = {
+    body: {
+        /**
+         * Slug of the ADR doc
+         */
+        adrSlug: string;
+        /**
+         * The D#### brain ledger decision id to unlink
+         */
+        decisionId: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/unlink-decision';
+};
+export type MutateDocsUnlinkDecisionResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateDocsUnlinkDecisionResponse = MutateDocsUnlinkDecisionResponses[keyof MutateDocsUnlinkDecisionResponses];
+export type MutateDocsSupersedeData = {
+    body: {
+        /**
+         * Slug of the doc being replaced
+         */
+        oldSlug: string;
+        /**
+         * Slug of the doc that replaces oldSlug
+         */
+        newSlug: string;
+        /**
+         * Optional human-readable reason carried back on the response
+         */
+        reason?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/supersede';
+};
+export type MutateDocsSupersedeResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateDocsSupersedeResponse = MutateDocsSupersedeResponses[keyof MutateDocsSupersedeResponses];
+export type QueryDocsStatusData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/docs/status';
+};
+export type QueryDocsStatusResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsStatusResponse = QueryDocsStatusResponses[keyof QueryDocsStatusResponses];
+export type QueryDocsExportData = {
+    body: {
+        /**
+         * Task whose document to export
+         */
+        taskId: string;
+        /**
+         * Include attachment manifest
+         */
+        includeAttachments?: boolean;
+        /**
+         * Include memory references
+         */
+        includeMemoryRefs?: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/export';
+};
+export type QueryDocsExportResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsExportResponse = QueryDocsExportResponses[keyof QueryDocsExportResponses];
+export type QueryDocsSearchData = {
+    body: {
+        /**
+         * Document search text
+         */
+        query: string;
+        /**
+         * Optional owner scope
+         */
+        ownerId?: string;
+        /**
+         * Maximum matches
+         */
+        limit?: number;
+        /**
+         * Document kind filter
+         */
+        type?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/search';
+};
+export type QueryDocsSearchResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsSearchResponse = QueryDocsSearchResponses[keyof QueryDocsSearchResponses];
+export type QueryDocsFindData = {
+    body: {
+        /**
+         * Existing document slug to compare
+         */
+        similarSlug: string;
+        /**
+         * Maximum matches
+         */
+        limit?: number;
+        /**
+         * Minimum similarity
+         */
+        threshold?: number;
+        /**
+         * Compare all document kinds
+         */
+        allKinds?: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/find';
+};
+export type QueryDocsFindResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsFindResponse = QueryDocsFindResponses[keyof QueryDocsFindResponses];
+export type QueryDocsMergeData = {
+    body: {
+        /**
+         * First attachment reference
+         */
+        attA: string;
+        /**
+         * Second attachment reference
+         */
+        attB: string;
+        /**
+         * three-way, cherry-pick, or multi-diff
+         */
+        strategy?: string;
+        /**
+         * Common ancestor attachment reference
+         */
+        base?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/merge';
+};
+export type QueryDocsMergeResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsMergeResponse = QueryDocsMergeResponses[keyof QueryDocsMergeResponses];
+export type QueryDocsRankData = {
+    body: {
+        /**
+         * Owner whose documents to rank
+         */
+        ownerId: string;
+        /**
+         * Optional ranking query
+         */
+        query?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/rank';
+};
+export type QueryDocsRankResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsRankResponse = QueryDocsRankResponses[keyof QueryDocsRankResponses];
+export type QueryDocsVersionsData = {
+    body: {
+        /**
+         * Document owner
+         */
+        ownerId: string;
+        /**
+         * Optional document name
+         */
+        name?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/docs/versions';
+};
+export type QueryDocsVersionsResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QueryDocsVersionsResponse = QueryDocsVersionsResponses[keyof QueryDocsVersionsResponses];
+export type MutateDocsPublishData = {
+    body?: {
+        /**
+         * Publication target: file or pr
+         */
+        target?: string;
+        /**
+         * Required for file publication
+         */
+        ownerId?: string;
+        /**
+         * Required destination for file publication
+         */
+        toPath?: string;
+        /**
+         * Attachment to publish
+         */
+        attachmentId?: string;
+        /**
+         * Required document reference for PR publication
+         */
+        slugOrId?: string;
+        /**
+         * Override document slug
+         */
+        slug?: string;
+        /**
+         * Override document kind
+         */
+        type?: string;
+        /**
+         * Override PR title
+         */
+        title?: string;
+        /**
+         * Override PR body
+         */
+        body?: string;
+        /**
+         * PR base branch
          */
-        taskId: string;
+        base?: string;
+        /**
+         * Owning task id (T####) for the PR commit subject
+         */
+        taskId?: string;
     };
     path?: never;
     query?: never;
-    url: '/v1/intelligence/match';
+    url: '/v1/docs/publish';
 };
-export type QueryIntelligenceMatchResponses = {
+export type MutateDocsPublishResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11305,14 +12867,43 @@ export type QueryIntelligenceMatchResponses = {
         [key: string]: unknown;
     };
 };
-export type QueryIntelligenceMatchResponse = QueryIntelligenceMatchResponses[keyof QueryIntelligenceMatchResponses];
-export type QueryDiagnosticsStatusData = {
-    body?: never;
+export type MutateDocsPublishResponse = MutateDocsPublishResponses[keyof MutateDocsPublishResponses];
+export type MutateDocsPublishPrData = {
+    body: {
+        /**
+         * Document reference to publish
+         */
+        slugOrId: string;
+        /**
+         * Override document slug
+         */
+        slug?: string;
+        /**
+         * Override document kind
+         */
+        type?: string;
+        /**
+         * Override PR title
+         */
+        title?: string;
+        /**
+         * Override PR body
+         */
+        body?: string;
+        /**
+         * PR base branch
+         */
+        base?: string;
+        /**
+         * Owning task id (T####) for the PR commit subject
+         */
+        taskId?: string;
+    };
     path?: never;
     query?: never;
-    url: '/v1/diagnostics/status';
+    url: '/v1/docs/publish-pr';
 };
-export type QueryDiagnosticsStatusResponses = {
+export type MutateDocsPublishPrResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11330,23 +12921,31 @@ export type QueryDiagnosticsStatusResponses = {
         [key: string]: unknown;
     };
 };
-export type QueryDiagnosticsStatusResponse = QueryDiagnosticsStatusResponses[keyof QueryDiagnosticsStatusResponses];
-export type QueryDiagnosticsAnalyzeData = {
-    body?: {
+export type MutateDocsPublishPrResponse = MutateDocsPublishPrResponses[keyof MutateDocsPublishPrResponses];
+export type MutateDocsSyncData = {
+    body: {
         /**
-         * Analysis window in days (default: 30)
+         * Document owner
          */
-        days?: number;
+        ownerId: string;
         /**
-         * Skip pushing observations to BRAIN
+         * Source file path
          */
-        noBrain?: boolean;
+        fromPath: string;
+        /**
+         * Document blob name
+         */
+        blobName?: string;
+        /**
+         * Document media type
+         */
+        contentType?: string;
     };
     path?: never;
     query?: never;
-    url: '/v1/diagnostics/analyze';
+    url: '/v1/docs/sync';
 };
-export type QueryDiagnosticsAnalyzeResponses = {
+export type MutateDocsSyncResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11364,19 +12963,31 @@ export type QueryDiagnosticsAnalyzeResponses = {
         [key: string]: unknown;
     };
 };
-export type QueryDiagnosticsAnalyzeResponse = QueryDiagnosticsAnalyzeResponses[keyof QueryDiagnosticsAnalyzeResponses];
-export type QueryDiagnosticsExportData = {
-    body?: {
+export type MutateDocsSyncResponse = MutateDocsSyncResponses[keyof MutateDocsSyncResponses];
+export type MutateDocsImportData = {
+    body: {
         /**
-         * Limit export to last N days (default: all)
+         * Root directory to scan
          */
-        days?: number;
+        scanRoot: string;
+        /**
+         * Preview without writing
+         */
+        dryRun?: boolean;
+        /**
+         * Replace conflicting import mappings
+         */
+        force?: boolean;
+        /**
+         * Import manifest path
+         */
+        manifestPath?: string;
     };
     path?: never;
     query?: never;
-    url: '/v1/diagnostics/export';
+    url: '/v1/docs/import';
 };
-export type QueryDiagnosticsExportResponses = {
+export type MutateDocsImportResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11394,39 +13005,23 @@ export type QueryDiagnosticsExportResponses = {
         [key: string]: unknown;
     };
 };
-export type QueryDiagnosticsExportResponse = QueryDiagnosticsExportResponses[keyof QueryDiagnosticsExportResponses];
-export type MutateDiagnosticsEnableData = {
-    body?: never;
-    path?: never;
-    query?: never;
-    url: '/v1/diagnostics/enable';
-};
-export type MutateDiagnosticsEnableResponses = {
-    /**
-     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
-     */
-    200: {
-        success: true;
-        data: {
-            [key: string]: unknown;
-        };
+export type MutateDocsImportResponse = MutateDocsImportResponses[keyof MutateDocsImportResponses];
+export type QueryDocsAuditData = {
+    body?: {
         /**
-         * LAFS response metadata.
+         * Document slug whose history to inspect
          */
-        meta: {
-            [key: string]: unknown;
-        };
-        [key: string]: unknown;
+        slug?: string;
+        /**
+         * Verify the full audit chain
+         */
+        verify?: boolean;
     };
-};
-export type MutateDiagnosticsEnableResponse = MutateDiagnosticsEnableResponses[keyof MutateDiagnosticsEnableResponses];
-export type MutateDiagnosticsDisableData = {
-    body?: never;
     path?: never;
     query?: never;
-    url: '/v1/diagnostics/disable';
+    url: '/v1/docs/audit';
 };
-export type MutateDiagnosticsDisableResponses = {
+export type QueryDocsAuditResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11444,43 +13039,19 @@ export type MutateDiagnosticsDisableResponses = {
         [key: string]: unknown;
     };
 };
-export type MutateDiagnosticsDisableResponse = MutateDiagnosticsDisableResponses[keyof MutateDiagnosticsDisableResponses];
-export type MutateDocsAddData = {
-    body: {
-        /**
-         * Owner entity ID (e.g. T123, ses_*, O-abc)
-         */
-        ownerId: string;
-        /**
-         * Path to local file to attach
-         */
-        file?: string;
-        /**
-         * Remote URL to attach
-         */
-        url?: string;
-        /**
-         * Inline document body (T10965); mutually exclusive with file/url
-         */
-        content?: string;
-        /**
-         * Free-text description
-         */
-        desc?: string;
-        /**
-         * Comma-separated labels
-         */
-        labels?: string;
+export type QueryDocsAuditResponse = QueryDocsAuditResponses[keyof QueryDocsAuditResponses];
+export type QueryDocsDoctorData = {
+    body?: {
         /**
-         * Agent identity (defaults to "human")
+         * Age threshold in days for the stale-drafts check (default 30)
          */
-        attachedBy?: string;
+        olderThanDays?: number;
     };
     path?: never;
     query?: never;
-    url: '/v1/docs/add';
+    url: '/v1/docs/doctor/query';
 };
-export type MutateDocsAddResponses = {
+export type QueryDocsDoctorResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11498,39 +13069,33 @@ export type MutateDocsAddResponses = {
         [key: string]: unknown;
     };
 };
-export type MutateDocsAddResponse = MutateDocsAddResponses[keyof MutateDocsAddResponses];
-export type QueryDocsListData = {
+export type QueryDocsDoctorResponse = QueryDocsDoctorResponses[keyof QueryDocsDoctorResponses];
+export type QueryDocsTriageData = {
     body?: {
         /**
-         * Filter by task ID (e.g. T123)
+         * Maximum docs to scan, oldest first (default 25)
          */
-        task?: string;
+        limit?: number;
         /**
-         * Filter by session ID (e.g. ses_*)
+         * Lifecycle status to scan (default draft)
          */
-        session?: string;
+        status?: string;
         /**
-         * Filter by observation ID (e.g. O-abc)
+         * Persist every verdict as a proposed D#### decision (default false)
          */
-        observation?: string;
+        record?: boolean;
     };
     path?: never;
     query?: never;
-    url: '/v1/docs/list';
+    url: '/v1/docs/triage';
 };
-export type QueryDocsListResponses = {
+export type QueryDocsTriageResponses = {
     /**
-     * Records (doc) are under /data/attachments (array). Use /data/attachments/0/<field>.
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
     200: {
         success: true;
         data: {
-            /**
-             * Array of doc records.
-             */
-            attachments: Array<{
-                [key: string]: unknown;
-            }>;
             [key: string]: unknown;
         };
         /**
@@ -11542,31 +13107,20 @@ export type QueryDocsListResponses = {
         [key: string]: unknown;
     };
 };
-export type QueryDocsListResponse = QueryDocsListResponses[keyof QueryDocsListResponses];
-export type QueryDocsFetchData = {
-    body: {
-        /**
-         * Attachment ID (att_*) or SHA-256 hex
-         */
-        attachmentRef: string;
-    };
+export type QueryDocsTriageResponse = QueryDocsTriageResponses[keyof QueryDocsTriageResponses];
+export type QueryDocsStatsData = {
+    body?: never;
     path?: never;
     query?: never;
-    url: '/v1/docs/fetch';
+    url: '/v1/docs/stats';
 };
-export type QueryDocsFetchResponses = {
+export type QueryDocsStatsResponses = {
     /**
-     * Records (doc) are under /data/metadata. Use /data/metadata/<field>.
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
     200: {
         success: true;
         data: {
-            /**
-             * A doc record.
-             */
-            metadata: {
-                [key: string]: unknown;
-            };
             [key: string]: unknown;
         };
         /**
@@ -11578,23 +13132,27 @@ export type QueryDocsFetchResponses = {
         [key: string]: unknown;
     };
 };
-export type QueryDocsFetchResponse = QueryDocsFetchResponses[keyof QueryDocsFetchResponses];
-export type MutateDocsRemoveData = {
-    body: {
+export type QueryDocsStatsResponse = QueryDocsStatsResponses[keyof QueryDocsStatsResponses];
+export type MutateDocsDoctorData = {
+    body?: {
         /**
-         * Attachment ID (att_*) or SHA-256 hex
+         * Execute repairs (default false — dry-run plan only)
          */
-        attachmentRef: string;
+        apply?: boolean;
         /**
-         * Owner entity ID to remove the ref from
+         * Execute ONLY the legacy-blob-coverage backfill: mirror hash-verified legacy bytes into the blob store so unmigrated docs become readable (T13653)
          */
-        from: string;
+        repair?: boolean;
+        /**
+         * Age threshold in days for the stale-drafts check (default 30)
+         */
+        olderThanDays?: number;
     };
     path?: never;
     query?: never;
-    url: '/v1/docs/remove';
+    url: '/v1/docs/doctor/mutate';
 };
-export type MutateDocsRemoveResponses = {
+export type MutateDocsDoctorResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11612,27 +13170,14 @@ export type MutateDocsRemoveResponses = {
         [key: string]: unknown;
     };
 };
-export type MutateDocsRemoveResponse = MutateDocsRemoveResponses[keyof MutateDocsRemoveResponses];
-export type MutateDocsSupersedeData = {
-    body: {
-        /**
-         * Slug of the doc being replaced
-         */
-        oldSlug: string;
-        /**
-         * Slug of the doc that replaces oldSlug
-         */
-        newSlug: string;
-        /**
-         * Optional human-readable reason carried back on the response
-         */
-        reason?: string;
-    };
+export type MutateDocsDoctorResponse = MutateDocsDoctorResponses[keyof MutateDocsDoctorResponses];
+export type MutateDocsMigrateData = {
+    body?: never;
     path?: never;
     query?: never;
-    url: '/v1/docs/supersede';
+    url: '/v1/docs/migrate';
 };
-export type MutateDocsSupersedeResponses = {
+export type MutateDocsMigrateResponses = {
     /**
      * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
      */
@@ -11650,7 +13195,7 @@ export type MutateDocsSupersedeResponses = {
         [key: string]: unknown;
     };
 };
-export type MutateDocsSupersedeResponse = MutateDocsSupersedeResponses[keyof MutateDocsSupersedeResponses];
+export type MutateDocsMigrateResponse = MutateDocsMigrateResponses[keyof MutateDocsMigrateResponses];
 export type QueryDocsGenerateData = {
     body: {
         /**
@@ -11753,6 +13298,10 @@ export type MutateDocsUpdateData = {
          * Inline UTF-8 content (mutually exclusive with file)
          */
         content?: string;
+        /**
+         * Expected base version uid — the metadata.headVersionUid from the `cleo docs fetch <slug>` envelope the edit was authored against (T13674). When the stored head has moved past it: append-shaped section edits are three-way merged through the section CRDT (both writers survive); a non-mergeable section edit is recorded as a named section conflict — nothing is silently dropped. A base that does not resolve to this doc's version history is refused with E_DOC_BASE_UNKNOWN before any write. Works with --content and with a UTF-8 text --file; a non-text --file with a base is refused with E_DOC_BASE_UNSUPPORTED. The update result carries the new headVersionUid, so edits can chain without a re-fetch. Omit only when the edit was not based on an earlier fetch (the current head is then assumed).
+         */
+        baseVersionUid?: string;
         /**
          * One-line summary describing the change (recorded in the audit log)
          */
@@ -12622,13 +14171,21 @@ export type MutateReleasePlanData = {
          */
         scheme?: string;
         /**
-         * Release channel: latest | beta | alpha | rc
+         * Release channel: latest | beta | alpha | rc | canary
          */
         channel?: string;
         /**
          * Mark plan as release_kind=hotfix
          */
         hotfix?: boolean;
+        /**
+         * Require the unified-hooks pilot for this stable promotion
+         */
+        hooksV1Promotion?: boolean;
+        /**
+         * Audited reason to ship a source change that opens the hooks-v1 gate without the promotion
+         */
+        hooksV1Waiver?: string;
         /**
          * Compute the plan without writing file or DB row
          */
@@ -12675,6 +14232,14 @@ export type MutateReleaseOpenData = {
          * Commit plan file before dispatching
          */
         commitPlan?: boolean;
+        /**
+         * Epic task ID forwarded as the plan scope (e.g. T9999)
+         */
+        epic?: string;
+        /**
+         * Comma-separated task IDs forwarded as the plan scope for a task-scoped release
+         */
+        tasks?: string;
     };
     path?: never;
     query?: never;
@@ -13607,6 +15172,31 @@ export type QueryTasksContextResponses = {
     };
 };
 export type QueryTasksContextResponse = QueryTasksContextResponses[keyof QueryTasksContextResponses];
+export type QuerySelfimproveProbeData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/selfimprove/probe';
+};
+export type QuerySelfimproveProbeResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type QuerySelfimproveProbeResponse = QuerySelfimproveProbeResponses[keyof QuerySelfimproveProbeResponses];
 export type MutateSelfimproveRunData = {
     body: {
         /**
@@ -14698,4 +16288,38 @@ export type MutateProfileUseResponses = {
     };
 };
 export type MutateProfileUseResponse = MutateProfileUseResponses[keyof MutateProfileUseResponses];
+export type MutateAdminJanitorRunData = {
+    body?: {
+        /**
+         * Report planned actions without mutating anything.
+         */
+        dryRun?: boolean;
+        /**
+         * Minimum age (ms) of an unregistered process before reap eligibility (default: 600000).
+         */
+        gracePeriodMs?: number;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/admin/janitor.run';
+};
+export type MutateAdminJanitorRunResponses = {
+    /**
+     * Generic query result — the precise /data shape is not individually contracted. Run with --full to see the verbose record, or --describe for the operation contract.
+     */
+    200: {
+        success: true;
+        data: {
+            [key: string]: unknown;
+        };
+        /**
+         * LAFS response metadata.
+         */
+        meta: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export type MutateAdminJanitorRunResponse = MutateAdminJanitorRunResponses[keyof MutateAdminJanitorRunResponses];
 //# sourceMappingURL=types.gen.d.ts.map