@thinkai/tai-api-contract 2.4.0 → 2.4.3

package/dist/generated/openapi.d.ts

@@ -605,7 +605,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Single repo readiness */
+        /**
+         * Single repo readiness
+         * @description Returns one stored repository scorecard with all eight dimensions and nested issues. Unknown `repoId` or a repo that belongs to another workspace returns `404` (no cross-tenant leakage).
+         */
         get: operations["getReadinessRepo"];
         put?: never;
         post?: never;
@@ -615,6 +618,206 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/agentic-foundation/dashboard": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Agentic Foundation dashboard
+         * @description Returns stored repository readiness scorecards plus a flattened issue queue for the Agentic Foundation dashboard surfaces. This is read-only and does not run scoring on the request path (issue #279). Field `generatedAt` is the server timestamp when this JSON payload was assembled; it is not the same as per-repo `lastAnalyzed` on `RepoReadinessScoreDto`.
+         */
+        get: operations["getAgenticFoundationDashboard"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/agentic-readiness": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Agentic readiness pillar (stored dimension slice)
+         * @description Returns `RepoReadinessScoreDto` rows with only the `ai-agent-readiness` dimension populated per repo. Same auth and persistence source as `GET .../readiness/repos` (issue #280).
+         */
+        get: operations["getAgenticFoundationAgenticReadiness"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/repository-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Repository health pillar (repo-hygiene slice)
+         * @description Returns per-repo `repo-hygiene` dimension only (issue
+         */
+        get: operations["getAgenticFoundationRepositoryHealth"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/codebase-quality": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Codebase quality pillar (stack-quality slice)
+         * @description Returns per-repo `stack-quality` dimension only (issue
+         */
+        get: operations["getAgenticFoundationCodebaseQuality"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/test-qa": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Test and QA pillar (tests-qa slice)
+         * @description Returns per-repo `tests-qa` dimension only (issue
+         */
+        get: operations["getAgenticFoundationTestQa"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/observability": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Observability pillar (observability slice)
+         * @description Returns per-repo `observability` dimension only (issue
+         */
+        get: operations["getAgenticFoundationObservability"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/api-contract": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * API contract pillar (api-contracts slice)
+         * @description Returns per-repo `api-contracts` dimension only (issue
+         */
+        get: operations["getAgenticFoundationApiContract"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/platform-governance": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Platform governance pillar (platform-governance slice)
+         * @description Returns per-repo `platform-governance` dimension only (issue
+         */
+        get: operations["getAgenticFoundationPlatformGovernance"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/delivery-governance": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Delivery governance pillar (delivery slice)
+         * @description Returns per-repo `delivery` dimension only (issue
+         */
+        get: operations["getAgenticFoundationDeliveryGovernance"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/agentic-foundation/ai-resolution-hub": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI resolution hub (full readiness scorecards)
+         * @description Returns the same payload as `GET .../readiness/repos` (all dimensions per repo) for cross-pillar hub views (issue #288).
+         */
+        get: operations["getAgenticFoundationAiResolutionHub"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/dimensions": {
         parameters: {
             query?: never;
@@ -622,7 +825,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Readiness dimensions catalog */
+        /**
+         * Readiness dimensions catalog
+         * @description Returns static rubric metadata (id, name, description, maxScore) aligned with the readiness scanner dimensions. Does not run scoring on the request path.
+         */
         get: operations["listReadinessDimensions"];
         put?: never;
         post?: never;
@@ -639,10 +845,16 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List fix requests */
+        /**
+         * List fix requests
+         * @description Returns persisted fix-queue rows for the workspace (newest first). Empty array when none exist.
+         */
         get: operations["listReadinessFixes"];
         put?: never;
-        /** Enqueue fix for an issue */
+        /**
+         * Enqueue fix for an issue
+         * @description Creates a fix request with `status: queued` when `issueId` belongs to `repoId` in this workspace. Requires workspace editor or admin. Re-posting the same `issueId` and `repoId` returns the existing row (idempotent).
+         */
         post: operations["postReadinessFix"];
         delete?: never;
         options?: never;
@@ -1188,6 +1400,11 @@ export interface components {
         };
         /** @enum {string} */
         ReadinessRunStatusDto: "queued" | "running" | "succeeded" | "failed" | "partial_failed";
+        /**
+         * @description Whether an AI readiness analysis run is queued or in progress for this repository slug. `idle` means no `queued`/`running` row exists in `tai_workspace_readiness_runs`.
+         * @enum {string}
+         */
+        ReadinessRepoAnalysisStatusDto: "idle" | "queued" | "running";
         ReadinessRunSummaryDto: {
             /** Format: uuid */
             runId: string;
@@ -1233,6 +1450,43 @@ export interface components {
             /** Format: uuid */
             teamId?: string | null;
             provider: components["schemas"]["RepoProviderDto"];
+            analysisStatus: components["schemas"]["ReadinessRepoAnalysisStatusDto"];
+            /**
+             * Format: uuid
+             * @description Present when `analysisStatus` is `queued` or `running`; use with `GET .../readiness/runs/{runId}`.
+             */
+            activeRunId?: string | null;
+        };
+        AgenticFoundationDashboardSummaryDto: {
+            repoCount: number;
+            averageOverallScore: number;
+            issueCount: number;
+            criticalIssueCount: number;
+        };
+        AgenticFoundationDashboardIssueDto: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            provider: components["schemas"]["RepoProviderDto"];
+            dimensionId: components["schemas"]["ReadinessDimensionId"];
+            /** @enum {string} */
+            severity: "critical" | "high" | "medium" | "low";
+            title: string;
+            description: string;
+            filePath: string | null;
+            /** @enum {string} */
+            fixStatus: "open" | "pr-pending" | "fixed";
+        };
+        AgenticFoundationDashboardDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            summary: components["schemas"]["AgenticFoundationDashboardSummaryDto"];
+            repos: components["schemas"]["RepoReadinessScoreDto"][];
+            issueQueue: components["schemas"]["AgenticFoundationDashboardIssueDto"][];
         };
         FixRequestDto: {
             id: string;
@@ -1250,7 +1504,15 @@ export interface components {
             createdAt: string;
         };
         CreateFixRequestBodyDto: {
+            /**
+             * Format: uuid
+             * @description Readiness issue id from stored scorecard data
+             */
             issueId: string;
+            /**
+             * Format: uuid
+             * @description Workspace repository id that owns the issue
+             */
             repoId: string;
         };
         PhaseRoleDto: {
@@ -1482,10 +1744,14 @@ export type RepoProviderDto = components['schemas']['RepoProviderDto'];
 export type ReadinessAnalyzeBodyDto = components['schemas']['ReadinessAnalyzeBodyDto'];
 export type ReadinessAnalyzeResponseDto = components['schemas']['ReadinessAnalyzeResponseDto'];
 export type ReadinessRunStatusDto = components['schemas']['ReadinessRunStatusDto'];
+export type ReadinessRepoAnalysisStatusDto = components['schemas']['ReadinessRepoAnalysisStatusDto'];
 export type ReadinessRunSummaryDto = components['schemas']['ReadinessRunSummaryDto'];
 export type ReadinessIssueDto = components['schemas']['ReadinessIssueDto'];
 export type DimensionScoreDto = components['schemas']['DimensionScoreDto'];
 export type RepoReadinessScoreDto = components['schemas']['RepoReadinessScoreDto'];
+export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
+export type AgenticFoundationDashboardIssueDto = components['schemas']['AgenticFoundationDashboardIssueDto'];
+export type AgenticFoundationDashboardDto = components['schemas']['AgenticFoundationDashboardDto'];
 export type FixRequestDto = components['schemas']['FixRequestDto'];
 export type CreateFixRequestBodyDto = components['schemas']['CreateFixRequestBodyDto'];
 export type PhaseRoleDto = components['schemas']['PhaseRoleDto'];
@@ -2924,10 +3190,29 @@ export interface operations {
                     "application/json": components["schemas"]["RepoReadinessScoreDto"];
                 };
             };
+            /** @description Malformed `repoId` (not a UUID) */
+            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"];
+                };
+            };
         };
     };
-    listReadinessDimensions: {
+    getAgenticFoundationDashboard: {
         parameters: {
             query?: never;
             header?: never;
@@ -2938,19 +3223,29 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Dimensions */
+            /** @description Dashboard scorecards and issue queue */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ReadinessDimensionDto"][];
+                    "application/json": components["schemas"]["AgenticFoundationDashboardDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
-    listReadinessFixes: {
+    getAgenticFoundationAgenticReadiness: {
         parameters: {
             query?: never;
             header?: never;
@@ -2961,19 +3256,29 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Fix queue */
+            /** @description Repositories with ai-agent-readiness slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FixRequestDto"][];
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
                 };
             };
             401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
-    postReadinessFix: {
+    getAgenticFoundationRepositoryHealth: {
         parameters: {
             query?: never;
             header?: never;
@@ -2982,22 +3287,371 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["CreateFixRequestBodyDto"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description Fix request created */
+            /** @description Repositories with repo-hygiene slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FixRequestDto"];
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
                 };
             };
             401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAgenticFoundationCodebaseQuality: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repositories with stack-quality slice */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAgenticFoundationTestQa: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repositories with tests-qa slice */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAgenticFoundationObservability: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repositories with observability slice */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAgenticFoundationApiContract: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repositories with api-contracts slice */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAgenticFoundationPlatformGovernance: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repositories with platform-governance slice */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAgenticFoundationDeliveryGovernance: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repositories with delivery slice */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAgenticFoundationAiResolutionHub: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Full repository readiness scorecards */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    listReadinessDimensions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Dimensions */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReadinessDimensionDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    listReadinessFixes: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Fix queue */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FixRequestDto"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    postReadinessFix: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateFixRequestBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Fix request created or existing row returned */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FixRequestDto"];
+                };
+            };
+            /** @description Invalid body or malformed `repoId` (not a UUID) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace not found, or issue/repo pair not in workspace */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     getSquad: {