@thinkai/tai-api-contract 2.75.0 → 2.76.0-pr.973.d7782c88

package/dist/generated/openapi.d.ts

@@ -2466,6 +2466,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/issues/{issueId}/fix-guide": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            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: operations["getReadinessIssueFixGuide"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/cursor/platform-key-consent": {
         parameters: {
             query?: never;
@@ -5935,6 +5955,27 @@ export interface components {
             /** Format: date-time */
             createdAt: string;
         };
+        ReadinessFixGuideDto: {
+            /** Format: uuid */
+            issueId: string;
+            /** Format: uuid */
+            repoId: string;
+            /** @description G1–G5 rubric criterion id */
+            rubricId: string;
+            /**
+             * Format: uuid
+             * @description Readiness scan run that produced this guide
+             */
+            sourceRunId: string;
+            /** @enum {string} */
+            status: "ready" | "failed";
+            /** @description Sanitized markdown body including server-appended Re-scan section */
+            markdown: string;
+            /** @description Human-readable criterion label for page chrome */
+            criterionTitle: string;
+            /** @description Present when status is failed (guide assembly error at scan time) */
+            errorDetail?: string | null;
+        };
         /**
          * @description Transient failure codes. Use the retrigger endpoint to start a fresh fix request. `processor_error` — unexpected internal failure; safe to retrigger after checking batch-runner logs.
          * @enum {string}
@@ -6934,6 +6975,8 @@ export interface components {
         /** @description Privacy request id (`tai_privacy_requests.id`). */
         PrivacyRequestId: string;
         FixId: string;
+        /** @description Readiness issue id (`tai_workspace_repo_issues.id`). */
+        ReadinessIssueId: string;
         /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
         InsightsProductivityRangeId: string;
         /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
@@ -7223,6 +7266,7 @@ export type ReadinessFixStatusSummaryDto = components['schemas']['ReadinessFixSt
 export type GithubInstalledRepoListDto = components['schemas']['GithubInstalledRepoListDto'];
 export type AgenticFoundationDashboardDto = components['schemas']['AgenticFoundationDashboardDto'];
 export type FixRequestDto = components['schemas']['FixRequestDto'];
+export type ReadinessFixGuideDto = components['schemas']['ReadinessFixGuideDto'];
 export type FixRetryableErrorCode = components['schemas']['FixRetryableErrorCode'];
 export type FixNonRetryableErrorCode = components['schemas']['FixNonRetryableErrorCode'];
 export type CreateFixRequestBodyDto = components['schemas']['CreateFixRequestBodyDto'];
@@ -7352,6 +7396,7 @@ export type ParameterWorkspaceMemberId = components['parameters']['WorkspaceMemb
 export type ParameterWorkspaceInvitationToken = components['parameters']['WorkspaceInvitationToken'];
 export type ParameterPrivacyRequestId = components['parameters']['PrivacyRequestId'];
 export type ParameterFixId = components['parameters']['FixId'];
+export type ParameterReadinessIssueId = components['parameters']['ReadinessIssueId'];
 export type ParameterInsightsProductivityRangeId = components['parameters']['InsightsProductivityRangeId'];
 export type ParameterInsightsProductivityFrom = components['parameters']['InsightsProductivityFrom'];
 export type ParameterInsightsProductivityTo = components['parameters']['InsightsProductivityTo'];
@@ -13905,6 +13950,50 @@ export interface operations {
             };
         };
     };
+    getReadinessIssueFixGuide: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Readiness issue id (`tai_workspace_repo_issues.id`). */
+                issueId: components["parameters"]["ReadinessIssueId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Fix instruction guide */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReadinessFixGuideDto"];
+                };
+            };
+            /** @description Issue rubric is not G1–G5 (use PR Fix it for G6 and other criteria) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Issue not found, or no guide for the latest scan (re-scan to generate) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     putCursorPlatformKeyConsent: {
         parameters: {
             query?: never;