@thinkai/tai-api-contract 2.177.0 → 2.181.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.177.0
+  version: 2.181.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -419,6 +419,235 @@ paths:
                 error: Forbidden
                 code: forbidden
 
+  /admin/workspaces/{workspaceId}/assessment-preflight:
+    post:
+      tags: [PlatformAdmin]
+      summary: Evaluate assessment preflight from server-loaded evidence
+      operationId: runLiveAssessmentPreflight
+      description: >
+        Loads repository scope, readiness scan age, and window coverage for one
+        workspace. Client fields for scope, scans, windows, and engineer counts
+        are ignored, so an unscanned source cannot be marked fresh. The
+        five-business-day clock uses Monday–Friday in America/New_York and is
+        stored on the first passing result. A later blocker does not clear it.
+        Active-engineer counts stay unloaded until stored activity can be counted.
+
+        **Authorization:** Bearer JWT required. Caller email must appear in `PLATFORM_ADMIN_EMAILS`.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - offerId
+                - sourceControl
+                - platformExecutionReady
+                - premiumAi
+                - jiraSelected
+                - incidentSelected
+                - incidentAvailable
+              properties:
+                offerId:
+                  type: string
+                  enum: [engineering_readiness_baseline, agentic_ai_roi]
+                sourceControl:
+                  type: string
+                  enum: [connected, pending_approval, setup_in_progress, revoked, stale, missing]
+                platformExecutionReady:
+                  type: boolean
+                premiumAi:
+                  type: object
+                  required: [cursor, claude, copilot]
+                  properties:
+                    cursor:
+                      type: boolean
+                    claude:
+                      type: boolean
+                    copilot:
+                      type: boolean
+                jiraSelected:
+                  type: boolean
+                incidentSelected:
+                  type: boolean
+                incidentAvailable:
+                  type: boolean
+                owner:
+                  type: string
+                  nullable: true
+      responses:
+        "200":
+          description: >
+            Preflight result. `dueDate` is set once the clock has started and stays
+            set if a later check is blocked.
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  [ready, clockStarted, dueDate, owner, blocker, nextAction, failures, chapters]
+                properties:
+                  ready:
+                    type: boolean
+                  clockStarted:
+                    type: boolean
+                  dueDate:
+                    type: string
+                    nullable: true
+                    format: date
+                  owner:
+                    type: string
+                    nullable: true
+                  blocker:
+                    type: string
+                    nullable: true
+                  nextAction:
+                    type: object
+                    nullable: true
+                    required: [label, href]
+                    properties:
+                      label:
+                        type: string
+                      href:
+                        type: string
+                        nullable: true
+                  failures:
+                    type: array
+                    items:
+                      type: object
+                      required: [code, blocker, nextAction]
+                      properties:
+                        code:
+                          type: string
+                        blocker:
+                          type: string
+                        nextAction:
+                          type: object
+                          required: [label, href]
+                          properties:
+                            label:
+                              type: string
+                            href:
+                              type: string
+                              nullable: true
+                  chapters:
+                    type: array
+                    items:
+                      type: object
+                      required: [id, status, reason]
+                      properties:
+                        id:
+                          type: string
+                          enum: [jira, incidents]
+                        status:
+                          type: string
+                          enum: [unavailable]
+                        reason:
+                          type: string
+        "400":
+          description: Body or workspace id failed validation.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: offerId is not a known assessment offer
+                code: invalid_body
+        "401":
+          description: Missing or invalid JWT.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "403":
+          description: Caller is not a platform admin.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: forbidden
+        "503":
+          description: Evidence store is unavailable.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /admin/assessment-queue:
+    get:
+      tags: [PlatformAdmin]
+      summary: List operator assessment records
+      operationId: listAssessmentQueue
+      description: >
+        Returns the stored assessment record for each workspace an operator has
+        evaluated. The next blocker is on this list. A second workspace is not
+        required.
+
+        **Authorization:** Bearer JWT required. Caller email must appear in `PLATFORM_ADMIN_EMAILS`.
+      responses:
+        "200":
+          description: Operator queue.
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [records]
+                properties:
+                  records:
+                    type: array
+                    items:
+                      type: object
+                      required:
+                        [workspaceId, offerId, ready, blocker, nextAction, dueDate, evaluatedAt]
+                      properties:
+                        workspaceId:
+                          type: string
+                          format: uuid
+                        offerId:
+                          type: string
+                          enum: [engineering_readiness_baseline, agentic_ai_roi]
+                        ready:
+                          type: boolean
+                        blocker:
+                          type: string
+                          nullable: true
+                        nextAction:
+                          type: object
+                          nullable: true
+                          required: [label, href]
+                          properties:
+                            label:
+                              type: string
+                            href:
+                              type: string
+                              nullable: true
+                        dueDate:
+                          type: string
+                          nullable: true
+                          format: date
+                        evaluatedAt:
+                          type: string
+                          format: date-time
+        "401":
+          description: Missing or invalid JWT.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "403":
+          description: Caller is not a platform admin.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: forbidden
+
   /admin/assessment-manifest-validation:
     post:
       tags: [PlatformAdmin]
@@ -9268,6 +9497,32 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
 
+  /workspaces/{workspaceId}/knowledge-pages/{slug}:
+    delete:
+      tags: [CodeChat]
+      summary: Delete a workspace knowledge page by slug
+      description: >-
+        Removes one page (typically a `prd-*` / `rfc-*` / `adr-*` draft). Does not
+        regenerate the rest of the knowledge base.
+      operationId: deleteWorkspaceKnowledgePage
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: slug
+          in: path
+          required: true
+          schema: { type: string, minLength: 1, maxLength: 200 }
+      responses:
+        "204":
+          description: Page deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: Page not found (`knowledge_page_not_found`)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/knowledge-pages/generate:
     post:
       tags: [CodeChat]
@@ -24463,6 +24718,7 @@ components:
                 - explain
                 - platform_ops
                 - feature_impact
+                - pr_review
                 - prd_request
               description: Classified Ask intent for the turn
             skillId:
@@ -24475,8 +24731,30 @@ components:
                 - chat-cicd
                 - chat-stack
                 - chat-platform
+                - chat-workspace
+                - chat-product
+                - chat-pr-review
                 - chat-wiki
               description: Conversation skill pack that grounded the LLM answer (Wave 10)
+            userMessage:
+              type: string
+              description: >
+                Short customer-safe summary when mode is failed. Shown in the reply body;
+                raw provider detail is only in providerFailures / debug marker.
+            providerFailures:
+              type: array
+              description: >
+                Structured provider failures for Conversations ⓘ hover (primary first).
+                Also embedded in content as `<!-- code-intel-debug:{...} -->` for reload.
+              items:
+                type: object
+                required: [provider, sanitized, raw]
+                properties:
+                  provider:
+                    type: string
+                    enum: [anthropic_messages, cursor_agent]
+                  sanitized: { type: string }
+                  raw: { type: string }
             usage:
               $ref: "#/components/schemas/CodeIntelligenceUsageDto"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.177.0",
+  "version": "2.181.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -67,6 +67,48 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/admin/workspaces/{workspaceId}/assessment-preflight": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Evaluate assessment preflight from server-loaded evidence
+         * @description Loads repository scope, readiness scan age, and window coverage for one workspace. Client fields for scope, scans, windows, and engineer counts are ignored, so an unscanned source cannot be marked fresh. The five-business-day clock uses Monday–Friday in America/New_York and is stored on the first passing result. A later blocker does not clear it. Active-engineer counts stay unloaded until stored activity can be counted.
+         *     **Authorization:** Bearer JWT required. Caller email must appear in `PLATFORM_ADMIN_EMAILS`.
+         */
+        post: operations["runLiveAssessmentPreflight"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/admin/assessment-queue": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List operator assessment records
+         * @description Returns the stored assessment record for each workspace an operator has evaluated. The next blocker is on this list. A second workspace is not required.
+         *     **Authorization:** Bearer JWT required. Caller email must appear in `PLATFORM_ADMIN_EMAILS`.
+         */
+        get: operations["listAssessmentQueue"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/admin/assessment-manifest-validation": {
         parameters: {
             query?: never;
@@ -3432,6 +3474,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/knowledge-pages/{slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a workspace knowledge page by slug
+         * @description Removes one page (typically a `prd-*` / `rfc-*` / `adr-*` draft). Does not regenerate the rest of the knowledge base.
+         */
+        delete: operations["deleteWorkspaceKnowledgePage"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/knowledge-pages/generate": {
         parameters: {
             query?: never;
@@ -10305,12 +10367,21 @@ export interface components {
              * @description Classified Ask intent for the turn
              * @enum {string}
              */
-            intent?: "inventory_apis" | "inventory_modules" | "explain" | "platform_ops" | "feature_impact" | "prd_request";
+            intent?: "inventory_apis" | "inventory_modules" | "explain" | "platform_ops" | "feature_impact" | "pr_review" | "prd_request";
             /**
              * @description Conversation skill pack that grounded the LLM answer (Wave 10)
              * @enum {string}
              */
-            skillId?: "chat-api-detail" | "chat-architecture" | "chat-tests" | "chat-contracts" | "chat-cicd" | "chat-stack" | "chat-platform" | "chat-wiki";
+            skillId?: "chat-api-detail" | "chat-architecture" | "chat-tests" | "chat-contracts" | "chat-cicd" | "chat-stack" | "chat-platform" | "chat-workspace" | "chat-product" | "chat-pr-review" | "chat-wiki";
+            /** @description Short customer-safe summary when mode is failed. Shown in the reply body; raw provider detail is only in providerFailures / debug marker. */
+            userMessage?: string;
+            /** @description Structured provider failures for Conversations ⓘ hover (primary first). Also embedded in content as `<!-- code-intel-debug:{...} -->` for reload. */
+            providerFailures?: {
+                /** @enum {string} */
+                provider: "anthropic_messages" | "cursor_agent";
+                sanitized: string;
+                raw: string;
+            }[];
             usage?: components["schemas"]["CodeIntelligenceUsageDto"];
         };
         CodeChatApiRouteRowDto: {
@@ -12706,6 +12777,182 @@ export interface operations {
             };
         };
     };
+    runLiveAssessmentPreflight: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    offerId: "engineering_readiness_baseline" | "agentic_ai_roi";
+                    /** @enum {string} */
+                    sourceControl: "connected" | "pending_approval" | "setup_in_progress" | "revoked" | "stale" | "missing";
+                    platformExecutionReady: boolean;
+                    premiumAi: {
+                        cursor: boolean;
+                        claude: boolean;
+                        copilot: boolean;
+                    };
+                    jiraSelected: boolean;
+                    incidentSelected: boolean;
+                    incidentAvailable: boolean;
+                    owner?: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description Preflight result. `dueDate` is set once the clock has started and stays set if a later check is blocked. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ready: boolean;
+                        clockStarted: boolean;
+                        /** Format: date */
+                        dueDate: string | null;
+                        owner: string | null;
+                        blocker: string | null;
+                        nextAction: {
+                            label: string;
+                            href: string | null;
+                        } | null;
+                        failures: {
+                            code: string;
+                            blocker: string;
+                            nextAction: {
+                                label: string;
+                                href: string | null;
+                            };
+                        }[];
+                        chapters: {
+                            /** @enum {string} */
+                            id: "jira" | "incidents";
+                            /** @enum {string} */
+                            status: "unavailable";
+                            reason: string;
+                        }[];
+                    };
+                };
+            };
+            /** @description Body or workspace id failed validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "offerId is not a known assessment offer",
+                     *       "code": "invalid_body"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Missing or invalid JWT. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Caller is not a platform admin. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "forbidden"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Evidence store is unavailable. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    listAssessmentQueue: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Operator queue. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        records: {
+                            /** Format: uuid */
+                            workspaceId: string;
+                            /** @enum {string} */
+                            offerId: "engineering_readiness_baseline" | "agentic_ai_roi";
+                            ready: boolean;
+                            blocker: string | null;
+                            nextAction: {
+                                label: string;
+                                href: string | null;
+                            } | null;
+                            /** Format: date */
+                            dueDate: string | null;
+                            /** Format: date-time */
+                            evaluatedAt: string;
+                        }[];
+                    };
+                };
+            };
+            /** @description Missing or invalid JWT. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Caller is not a platform admin. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "forbidden"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     runAssessmentManifestValidation: {
         parameters: {
             query?: never;
@@ -21748,6 +21995,37 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    deleteWorkspaceKnowledgePage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Page not found (`knowledge_page_not_found`) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     generateWorkspaceKnowledgePages: {
         parameters: {
             query?: never;