@thinkai/tai-api-contract 2.4.1 → 2.4.4

package/dist/generated/openapi.d.ts

@@ -825,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;
@@ -842,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;
@@ -1022,7 +1031,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Import org chart from Supabase storage path */
+        /**
+         * Import org chart from Supabase storage path
+         * @description Parse-only. Downloads the CSV at `storagePath` from the `org-charts` bucket and returns `persons` and `errors`. Does not persist to `spa_org_chart` or `org_chart`. The SPA derives teams client-side and saves the org structure via `POST /workspaces/{workspaceId}/org-chart`.
+         */
         post: operations["postOrgChartImport"];
         delete?: never;
         options?: never;
@@ -1056,6 +1068,16 @@ export interface components {
             /** @enum {string} */
             role: "admin" | "editor" | "viewer";
         };
+        OrgChartNodeDto: {
+            id: string;
+            name: string;
+            /** @enum {string} */
+            type: "org" | "department" | "team" | "person";
+            external_ids?: {
+                [key: string]: string;
+            };
+            children?: components["schemas"]["OrgChartNodeDto"][];
+        };
         OrgChartTreeNodeDto: {
             id: string;
             name?: string;
@@ -1069,9 +1091,31 @@ export interface components {
             };
             children?: components["schemas"]["OrgChartTreeNodeDto"][];
         };
-        OrgChartDto: {
+        ScoringOrgChartDto: {
             root: components["schemas"]["OrgChartTreeNodeDto"];
         };
+        OrgChartDto: {
+            root: components["schemas"]["OrgChartNodeDto"];
+        };
+        OrgChartPersonDto: {
+            employeeId: string;
+            name: string;
+            email: string;
+            title: string;
+            department: string;
+            team: string;
+            managerId: string;
+            location: string;
+        };
+        OrgChartImportResultDto: {
+            persons: components["schemas"]["OrgChartPersonDto"][];
+            errors: string[];
+        };
+        OrgChartSaveResultDto: {
+            ok: boolean;
+            /** Format: uuid */
+            tenantId: string;
+        };
         TenantSourceEntryDto: {
             type: string;
         } & {
@@ -1092,7 +1136,7 @@ export interface components {
         };
         WorkspaceConfigDto: {
             sources: components["schemas"]["TenantSourceEntryDto"][];
-            orgChart?: components["schemas"]["OrgChartDto"] | null;
+            orgChart?: components["schemas"]["ScoringOrgChartDto"] | null;
             /** @enum {string|null} */
             region?: "us" | "eu" | "me" | null;
         };
@@ -1391,6 +1435,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;
@@ -1436,6 +1485,12 @@ 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;
@@ -1484,7 +1539,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: {
@@ -1673,8 +1736,13 @@ export type TeamMemberDto = components['schemas']['TeamMemberDto'];
 export type TeamMemberListDto = components['schemas']['TeamMemberListDto'];
 export type InviteTeamMemberBodyDto = components['schemas']['InviteTeamMemberBodyDto'];
 export type UpdateTeamMemberRoleBodyDto = components['schemas']['UpdateTeamMemberRoleBodyDto'];
+export type OrgChartNodeDto = components['schemas']['OrgChartNodeDto'];
 export type OrgChartTreeNodeDto = components['schemas']['OrgChartTreeNodeDto'];
+export type ScoringOrgChartDto = components['schemas']['ScoringOrgChartDto'];
 export type OrgChartDto = components['schemas']['OrgChartDto'];
+export type OrgChartPersonDto = components['schemas']['OrgChartPersonDto'];
+export type OrgChartImportResultDto = components['schemas']['OrgChartImportResultDto'];
+export type OrgChartSaveResultDto = components['schemas']['OrgChartSaveResultDto'];
 export type TenantSourceEntryDto = components['schemas']['TenantSourceEntryDto'];
 export type CursorSourceDto = components['schemas']['CursorSourceDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
@@ -1716,6 +1784,7 @@ 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'];
@@ -1985,9 +2054,7 @@ export interface operations {
     };
     getTenantOrgChart: {
         parameters: {
-            query?: {
-                withScores?: boolean;
-            };
+            query?: never;
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -1996,7 +2063,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Org chart (optionally with per-node scores) */
+            /** @description SPA org structure chart (`spa_org_chart`; per-node scores not included — use GET /config for scoring tree) */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2006,6 +2073,7 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
             /** @description Workspace not found */
             404: {
                 headers: {
@@ -2036,13 +2104,20 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        ok: boolean;
-                        workspaceId: string;
-                    };
+                    "application/json": components["schemas"]["OrgChartSaveResultDto"];
+                };
+            };
+            /** @description Invalid request body or chart limits exceeded */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
         };
     };
     getWorkspaceConfig: {
@@ -3534,6 +3609,16 @@ export interface operations {
                 };
             };
             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: {
@@ -3557,6 +3642,16 @@ export interface operations {
                 };
             };
             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: {
@@ -3574,7 +3669,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Fix request created */
+            /** @description Fix request created or existing row returned */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -3583,7 +3678,26 @@ export interface operations {
                     "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: {
@@ -3966,18 +4080,53 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Parsed persons (shape TBD; align with backend) */
+            /** @description Parsed persons from uploaded CSV (not persisted server-side) */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        [key: string]: unknown;
-                    };
+                    "application/json": components["schemas"]["OrgChartImportResultDto"];
+                };
+            };
+            /** @description Invalid body or storage path */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Storage object not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Failed to download file from storage */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Storage import not configured or service unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
 }