@thinkai/tai-api-contract 2.82.0 → 2.83.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.82.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]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.82.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;
@@ -13883,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?: {