@thinkai/tai-api-contract 2.4.1 → 2.4.4

package/src/generated/openapi.ts

@@ -826,7 +826,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;
@@ -843,10 +846,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;
@@ -1023,7 +1032,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;
@@ -1057,6 +1069,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;
@@ -1070,9 +1092,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;
         } & {
@@ -1093,7 +1137,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;
         };
@@ -1392,6 +1436,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;
@@ -1437,6 +1486,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;
@@ -1485,7 +1540,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: {
@@ -1674,8 +1737,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'];
@@ -1717,6 +1785,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'];
@@ -1986,9 +2055,7 @@ export interface operations {
     };
     getTenantOrgChart: {
         parameters: {
-            query?: {
-                withScores?: boolean;
-            };
+            query?: never;
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -1997,7 +2064,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;
@@ -2007,6 +2074,7 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
             /** @description Workspace not found */
             404: {
                 headers: {
@@ -2037,13 +2105,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: {
@@ -3535,6 +3610,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: {
@@ -3558,6 +3643,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: {
@@ -3575,7 +3670,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Fix request created */
+            /** @description Fix request created or existing row returned */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -3584,7 +3679,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: {
@@ -3967,18 +4081,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"];
+                };
+            };
         };
     };
 }

package/src/index.ts

@@ -179,18 +179,23 @@ export interface OrgChartTreeNodeDto {
   external_ids?: Record<string, string>;
 }
 
-/** Org chart tree node with computed scores (Option B, α=0.2). Used when ?withScores=true. */
+/** Org chart tree node with computed scores (Option B, α=0.2). Reserved for a future scored-tree API. */
 export interface OrgChartTreeNodeWithScoreDto extends OrgChartTreeNodeDto {
   score?: number | null;
   individualUpi?: number | null;
   children?: OrgChartTreeNodeWithScoreDto[];
 }
 
-/** M7: Org chart response (tree only). */
+/** M7: Org chart response (tree only). Legacy hand-written shape; prefer generated `OrgChartDto` for SPA routes. */
 export interface OrgChartDto {
   root: OrgChartTreeNodeDto;
 }
 
+/** Batch scoring person tree returned by GET /workspaces/{workspaceId}/config (`org_chart` column). */
+export interface ScoringOrgChartDto {
+  root: OrgChartTreeNodeDto;
+}
+
 /** Summary of a person derived from the tenant's org chart. */
 export interface PersonSummaryDto {
   /** Canonical person identifier (e.g. work email). */
@@ -222,7 +227,7 @@ export interface TestConnectionResponseDto {
 /** Workspace integration config (sources; optionally org chart for Home; optionally region for data residency). */
 export interface WorkspaceConfigDto {
   sources: TenantSourceEntryDto[];
-  orgChart?: OrgChartDto | null;
+  orgChart?: ScoringOrgChartDto | null;
   /** Region for data residency (us, eu, me). Null or absent = legacy/single-region. */
   region?: string | null;
 }