@thinkai/tai-api-contract 2.146.0 → 2.147.1

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.146.0
+  version: 2.147.1
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -7591,12 +7591,12 @@ paths:
   /workspaces/{workspaceId}/readiness/issues/{issueId}/fix-guide:
     get:
       tags: [RepositoryReadiness]
-      summary: Get scan-time fix instruction guide (G1–G5)
+      summary: Get fix instructions for a readiness issue
       description: >
-        Returns the markdown fix guide written during the latest successful scan for this issue.
-        Applies only to platform-governance criteria **G1–G5** (`guidance` tier). **G6** and other
-        rubrics must use the Automations PR Fix it flow (`POST .../readiness/fixes`). When no guide
-        exists for a legacy run, returns `404` — re-scan the repository to generate instructions.
+        G1–G5 return the markdown guide written during the latest successful scan.
+        Every other issue returns the remediation already stored for that issue
+        (latest succeeded criterion row, otherwise the issue description).
+        When that text is missing, returns `404` so the page can show the empty-guide state.
       operationId: getReadinessIssueFixGuide
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
@@ -7609,16 +7609,11 @@ paths:
               schema:
                 $ref: "#/components/schemas/ReadinessFixGuideDto"
         "400":
-          description: Issue rubric is not G1–G5 (use PR Fix it for G6 and other criteria)
+          description: issueId is not a UUID
           content:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
-              examples:
-                not_guidance:
-                  value:
-                    error: "Fix guide is only available for G1–G5 governance criteria"
-                    code: fix_guide_not_guidance
         "401":
           $ref: "#/components/responses/Unauthorized"
         "403":
@@ -7865,7 +7860,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
               example:
-                error: No ready repository index is available to write the workspace agent file.
+                error: No ready code map is available to write the workspace agent file.
                 code: agent_md_not_ready
 
   /workspaces/{workspaceId}/code-intelligence/token-usage/summary:
@@ -8196,7 +8191,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
               example:
-                error: Repository exceeds the workspace eligibility limits and cannot be indexed
+                error: Repository exceeds the workspace eligibility limits and cannot be scanned
                 code: repo_ineligible
 
   /workspaces/{workspaceId}/code-chat/indexes/sync:
@@ -8356,9 +8351,9 @@ paths:
               examples:
                 chat_not_ready:
                   value:
-                    error: Indexing repositories (0/2).
+                    error: Scanning repositories (0/2).
                     code: chat_not_ready
-                    progressMessage: Indexing repositories (0/2).
+                    progressMessage: Scanning repositories (0/2).
         "422":
           description: Execution key required
           content:
@@ -8594,7 +8589,7 @@ paths:
         "403":
           description: Code Intelligence is disabled for this workspace
         "409":
-          description: No ready repository index in scope
+          description: No ready code map in scope
 
   /workspaces/{workspaceId}/knowledge-pages/generate/status:
     get:
@@ -8644,7 +8639,7 @@ paths:
         "403":
           description: Code Intelligence is disabled for this workspace
         "409":
-          description: No ready repository index in scope
+          description: No ready code map in scope
 
   /workspaces/{workspaceId}/knowledge-graph:
     get:
@@ -8824,7 +8819,7 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
-          description: Index not found
+          description: Code map not found
         "409":
           description: Wiki has no pages yet
 
@@ -8878,7 +8873,7 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
         "409":
-          description: Index not ready
+          description: Code map not ready
 
   /workspaces/{workspaceId}/code-chat/indexes/{indexId}/origin-prompt:
     get:
@@ -8925,7 +8920,7 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
-          description: Index not ready
+          description: Code map not ready
           content:
             application/json:
               schema:
@@ -18235,7 +18230,7 @@ components:
         rubricId:
           type: string
           maxLength: 16
-          description: G1–G5 rubric criterion id
+          description: Rubric criterion id (G1–G5 guides, or any other issue with stored remediation)
         sourceRunId:
           type: string
           format: uuid
@@ -21195,8 +21190,8 @@ components:
           type: boolean
           default: false
           description: >
-            When true, re-enqueue even if the repository is already indexing or was
-            indexed within the last 10 minutes.
+            When true, re-enqueue even if the repository is already indexing, was
+            indexed within the last 10 minutes, or failed after three indexing attempts.
         indexOnly:
           type: boolean
           default: false
@@ -21230,11 +21225,12 @@ components:
         repoName: { type: string }
         code:
           type: string
-          enum: [repo_ineligible, indexed_recently, index_in_progress, ecg_source_off]
+          enum: [repo_ineligible, indexed_recently, index_in_progress, ecg_source_off, index_failed]
           description: >
             Stable machine-readable skip reason. `ecg_source_off` covers a source turned off
             for Engineering Context Graph and non-GitHub providers that stay listed but are
-            never indexed.
+            never indexed. `index_failed` means indexing already failed after three attempts
+            and stays failed until an admin force sync.
 
     CodeChatThreadDto:
       type: object

package/package.json

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

package/src/generated/openapi.ts

@@ -2872,8 +2872,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get scan-time fix instruction guide (G1–G5)
-         * @description Returns the markdown fix guide written during the latest successful scan for this issue. Applies only to platform-governance criteria **G1–G5** (`guidance` tier). **G6** and other rubrics must use the Automations PR Fix it flow (`POST .../readiness/fixes`). When no guide exists for a legacy run, returns `404` — re-scan the repository to generate instructions.
+         * Get fix instructions for a readiness issue
+         * @description G1–G5 return the markdown guide written during the latest successful scan. Every other issue returns the remediation already stored for that issue (latest succeeded criterion row, otherwise the issue description). When that text is missing, returns `404` so the page can show the empty-guide state.
          */
         get: operations["getReadinessIssueFixGuide"];
         put?: never;
@@ -7740,7 +7740,7 @@ export interface components {
             issueId: string;
             /** Format: uuid */
             repoId: string;
-            /** @description G1–G5 rubric criterion id */
+            /** @description Rubric criterion id (G1–G5 guides, or any other issue with stored remediation) */
             rubricId: string;
             /**
              * Format: uuid
@@ -9099,7 +9099,7 @@ export interface components {
             /** @description Optional subset; omit or empty to enqueue all readiness GitHub repos. */
             repoIds?: string[];
             /**
-             * @description When true, re-enqueue even if the repository is already indexing or was indexed within the last 10 minutes.
+             * @description When true, re-enqueue even if the repository is already indexing, was indexed within the last 10 minutes, or failed after three indexing attempts.
              * @default false
              */
             force: boolean;
@@ -9120,10 +9120,10 @@ export interface components {
             repoId: string;
             repoName: string;
             /**
-             * @description Stable machine-readable skip reason. `ecg_source_off` covers a source turned off for Engineering Context Graph and non-GitHub providers that stay listed but are never indexed.
+             * @description Stable machine-readable skip reason. `ecg_source_off` covers a source turned off for Engineering Context Graph and non-GitHub providers that stay listed but are never indexed. `index_failed` means indexing already failed after three attempts and stays failed until an admin force sync.
              * @enum {string}
              */
-            code: "repo_ineligible" | "indexed_recently" | "index_in_progress" | "ecg_source_off";
+            code: "repo_ineligible" | "indexed_recently" | "index_in_progress" | "ecg_source_off" | "index_failed";
         };
         CodeChatThreadDto: {
             /** Format: uuid */
@@ -18653,7 +18653,7 @@ export interface operations {
                     "application/json": components["schemas"]["ReadinessFixGuideDto"];
                 };
             };
-            /** @description Issue rubric is not G1–G5 (use PR Fix it for G6 and other criteria) */
+            /** @description issueId is not a UUID */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -18918,7 +18918,7 @@ export interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "error": "No ready repository index is available to write the workspace agent file.",
+                     *       "error": "No ready code map is available to write the workspace agent file.",
                      *       "code": "agent_md_not_ready"
                      *     }
                      */
@@ -19292,7 +19292,7 @@ export interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "error": "Repository exceeds the workspace eligibility limits and cannot be indexed",
+                     *       "error": "Repository exceeds the workspace eligibility limits and cannot be scanned",
                      *       "code": "repo_ineligible"
                      *     }
                      */
@@ -19783,7 +19783,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description No ready repository index in scope */
+            /** @description No ready code map in scope */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -19854,7 +19854,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description No ready repository index in scope */
+            /** @description No ready code map in scope */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -20090,7 +20090,7 @@ export interface operations {
                 content?: never;
             };
             401: components["responses"]["Unauthorized"];
-            /** @description Index not found */
+            /** @description Code map not found */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -20160,7 +20160,7 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
-            /** @description Index not ready */
+            /** @description Code map not ready */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -20215,7 +20215,7 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
-            /** @description Index not ready */
+            /** @description Code map not ready */
             404: {
                 headers: {
                     [name: string]: unknown;