@thinkai/tai-api-contract 2.81.0 → 2.83.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.81.0
+  version: 2.83.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -5475,6 +5475,78 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/readiness/repos/{repoId}/issues/export:
+    get:
+      tags: [RepositoryReadiness]
+      summary: Export repository readiness issues as Markdown
+      description: >
+        Download outstanding readiness issues for one repository as a Markdown (`.md`) attachment
+        for local IDE workflows. Reuses the same scorecard as `GET .../readiness/repos/{repoId}`
+        (issues plus optional remediation from `criteriaDetails`).
+
+        The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section
+        lists matching issues sorted by severity. Default filter is outstanding issues
+        (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is
+        true (default), each issue includes a Remediation section from the matching criterion when
+        available.
+
+        The response sets `Content-Disposition: attachment` with filename
+        `readiness-issues-{providerSlug}-{date}.md`.
+      operationId: exportReadinessRepoIssuesMarkdown
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - $ref: "#/components/parameters/RepoId"
+        - name: fixStatus
+          in: query
+          required: false
+          description: >
+            When omitted, export outstanding issues (`open` and `pr-pending`). When set, export only
+            issues with this fix status.
+          schema:
+            type: string
+            enum: [open, pr-pending, fixed]
+        - name: dimensionId
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/ReadinessDimensionId"
+        - name: severity
+          in: query
+          required: false
+          schema:
+            type: string
+            enum: [critical, high, medium, low]
+        - name: includeCriteria
+          in: query
+          required: false
+          description: Include remediation from criteriaDetails (default true).
+          schema:
+            type: boolean
+            default: true
+      responses:
+        "200":
+          description: Markdown file of readiness issues
+          content:
+            text/markdown:
+              schema:
+                type: string
+        "400":
+          description: Malformed `repoId` or invalid query parameters
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace or repository not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/readiness/repos/{repoId}/runs:
     get:
       tags: [RepositoryReadiness]
@@ -7010,6 +7082,15 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
+        "422":
+          description: Repository blocked by workspace eligibility or size limits
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Repository exceeds the workspace eligibility limits and cannot be indexed
+                code: repo_ineligible
 
   /workspaces/{workspaceId}/code-chat/indexes/sync:
     post:
@@ -16868,6 +16949,21 @@ components:
         items:
           type: array
           items: { $ref: "#/components/schemas/CodeChatIndexDto" }
+        skipped:
+          type: array
+          description: Repositories requested (or considered) for sync but not enqueued
+          items: { $ref: "#/components/schemas/CodeChatSkippedRepoDto" }
+
+    CodeChatSkippedRepoDto:
+      type: object
+      required: [repoId, repoName, code]
+      properties:
+        repoId: { type: string, format: uuid }
+        repoName: { type: string }
+        code:
+          type: string
+          enum: [repo_ineligible]
+          description: Stable machine-readable skip reason
 
     CodeChatThreadDto:
       type: object
@@ -16956,7 +17052,65 @@ components:
         - type: object
           required: [mode]
           properties:
-            mode: { type: string, enum: [llm, retrieval] }
+            mode:
+              type: string
+              enum: [llm, retrieval, inventory]
+              description: >
+                How the assistant answer was produced. `inventory` returns a deterministic
+                catalog (APIs or modules) rather than LLM synthesis.
+            structured:
+              description: Optional typed inventory payload for rich UI tables
+              allOf:
+                - $ref: "#/components/schemas/CodeChatStructuredBlockDto"
+            groundedInWiki:
+              type: boolean
+              description: True when wiki pages from one or more repos contributed to LLM context
+            wikiRepos:
+              type: array
+              items: { type: string }
+              description: Repository names whose wiki pages grounded the answer
+
+    CodeChatApiRouteRowDto:
+      type: object
+      required: [method, path, file]
+      properties:
+        method: { type: string }
+        path: { type: string }
+        file: { type: string }
+        line: { type: integer }
+        summary: { type: string }
+        repoId: { type: string, format: uuid }
+        repoName: { type: string }
+        providerSlug: { type: string }
+        commitSha: { type: string, nullable: true }
+
+    CodeChatModuleInventoryRowDto:
+      type: object
+      required: [name, kind, path]
+      properties:
+        name: { type: string }
+        kind: { type: string, enum: [package, root, area] }
+        path: { type: string }
+        summary: { type: string }
+        repoId: { type: string, format: uuid }
+        repoName: { type: string }
+
+    CodeChatStructuredBlockDto:
+      oneOf:
+        - type: object
+          required: [kind, rows]
+          properties:
+            kind: { type: string, enum: [api_inventory] }
+            rows:
+              type: array
+              items: { $ref: "#/components/schemas/CodeChatApiRouteRowDto" }
+        - type: object
+          required: [kind, rows]
+          properties:
+            kind: { type: string, enum: [module_inventory] }
+            rows:
+              type: array
+              items: { $ref: "#/components/schemas/CodeChatModuleInventoryRowDto" }
 
     CodeChatWikiPageDto:
       type: object

package/package.json

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

package/src/generated/openapi.ts

@@ -2123,6 +2123,28 @@ export interface paths {
         patch: operations["patchReadinessRepo"];
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/repos/{repoId}/issues/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export repository readiness issues as Markdown
+         * @description Download outstanding readiness issues for one repository as a Markdown (`.md`) attachment for local IDE workflows. Reuses the same scorecard as `GET .../readiness/repos/{repoId}` (issues plus optional remediation from `criteriaDetails`).
+         *     The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section lists matching issues sorted by severity. Default filter is outstanding issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is true (default), each issue includes a Remediation section from the matching criterion when available.
+         *     The response sets `Content-Disposition: attachment` with filename `readiness-issues-{providerSlug}-{date}.md`.
+         */
+        get: operations["exportReadinessRepoIssuesMarkdown"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/repos/{repoId}/runs": {
         parameters: {
             query?: never;
@@ -7325,6 +7347,18 @@ export interface components {
         CodeChatSyncIndexesResultDto: {
             enqueued: number;
             items?: components["schemas"]["CodeChatIndexDto"][];
+            /** @description Repositories requested (or considered) for sync but not enqueued */
+            skipped?: components["schemas"]["CodeChatSkippedRepoDto"][];
+        };
+        CodeChatSkippedRepoDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /**
+             * @description Stable machine-readable skip reason
+             * @enum {string}
+             */
+            code: "repo_ineligible";
         };
         CodeChatThreadDto: {
             /** Format: uuid */
@@ -7387,8 +7421,48 @@ export interface components {
             content: string;
         };
         CodeChatMessageReplyDto: components["schemas"]["CodeChatMessageDto"] & {
+            /**
+             * @description How the assistant answer was produced. `inventory` returns a deterministic catalog (APIs or modules) rather than LLM synthesis.
+             * @enum {string}
+             */
+            mode: "llm" | "retrieval" | "inventory";
+            /** @description Optional typed inventory payload for rich UI tables */
+            structured?: components["schemas"]["CodeChatStructuredBlockDto"];
+            /** @description True when wiki pages from one or more repos contributed to LLM context */
+            groundedInWiki?: boolean;
+            /** @description Repository names whose wiki pages grounded the answer */
+            wikiRepos?: string[];
+        };
+        CodeChatApiRouteRowDto: {
+            method: string;
+            path: string;
+            file: string;
+            line?: number;
+            summary?: string;
+            /** Format: uuid */
+            repoId?: string;
+            repoName?: string;
+            providerSlug?: string;
+            commitSha?: string | null;
+        };
+        CodeChatModuleInventoryRowDto: {
+            name: string;
+            /** @enum {string} */
+            kind: "package" | "root" | "area";
+            path: string;
+            summary?: string;
+            /** Format: uuid */
+            repoId?: string;
+            repoName?: string;
+        };
+        CodeChatStructuredBlockDto: {
             /** @enum {string} */
-            mode: "llm" | "retrieval";
+            kind: "api_inventory";
+            rows: components["schemas"]["CodeChatApiRouteRowDto"][];
+        } | {
+            /** @enum {string} */
+            kind: "module_inventory";
+            rows: components["schemas"]["CodeChatModuleInventoryRowDto"][];
         };
         CodeChatWikiPageDto: {
             /** Format: uuid */
@@ -8215,6 +8289,7 @@ export type CodeChatIndexListDto = components['schemas']['CodeChatIndexListDto']
 export type CodeChatCreateIndexBodyDto = components['schemas']['CodeChatCreateIndexBodyDto'];
 export type CodeChatSyncIndexesBodyDto = components['schemas']['CodeChatSyncIndexesBodyDto'];
 export type CodeChatSyncIndexesResultDto = components['schemas']['CodeChatSyncIndexesResultDto'];
+export type CodeChatSkippedRepoDto = components['schemas']['CodeChatSkippedRepoDto'];
 export type CodeChatThreadDto = components['schemas']['CodeChatThreadDto'];
 export type CodeChatThreadListDto = components['schemas']['CodeChatThreadListDto'];
 export type CodeChatCreateThreadBodyDto = components['schemas']['CodeChatCreateThreadBodyDto'];
@@ -8223,6 +8298,9 @@ export type CodeChatMessageDto = components['schemas']['CodeChatMessageDto'];
 export type CodeChatThreadDetailDto = components['schemas']['CodeChatThreadDetailDto'];
 export type CodeChatPostMessageBodyDto = components['schemas']['CodeChatPostMessageBodyDto'];
 export type CodeChatMessageReplyDto = components['schemas']['CodeChatMessageReplyDto'];
+export type CodeChatApiRouteRowDto = components['schemas']['CodeChatApiRouteRowDto'];
+export type CodeChatModuleInventoryRowDto = components['schemas']['CodeChatModuleInventoryRowDto'];
+export type CodeChatStructuredBlockDto = components['schemas']['CodeChatStructuredBlockDto'];
 export type CodeChatWikiPageDto = components['schemas']['CodeChatWikiPageDto'];
 export type CodeChatWikiPageListDto = components['schemas']['CodeChatWikiPageListDto'];
 export type CodeChatSymbolQueryBodyDto = components['schemas']['CodeChatSymbolQueryBodyDto'];
@@ -13827,6 +13905,56 @@ export interface operations {
             };
         };
     };
+    exportReadinessRepoIssuesMarkdown: {
+        parameters: {
+            query?: {
+                /** @description When omitted, export outstanding issues (`open` and `pr-pending`). When set, export only issues with this fix status. */
+                fixStatus?: "open" | "pr-pending" | "fixed";
+                dimensionId?: components["schemas"]["ReadinessDimensionId"];
+                severity?: "critical" | "high" | "medium" | "low";
+                /** @description Include remediation from criteriaDetails (default true). */
+                includeCriteria?: boolean;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                repoId: components["parameters"]["RepoId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Markdown file of readiness issues */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/markdown": string;
+                };
+            };
+            /** @description Malformed `repoId` or invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repository not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     listReadinessRepoRuns: {
         parameters: {
             query?: {
@@ -15417,6 +15545,21 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
+            /** @description Repository blocked by workspace eligibility or size limits */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Repository exceeds the workspace eligibility limits and cannot be indexed",
+                     *       "code": "repo_ineligible"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     syncCodeChatIndexes: {