@thinkai/tai-api-contract 2.126.0 → 2.127.0

package/dist/generated/openapi.d.ts

@@ -1393,6 +1393,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/test-pyramid/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Test pyramid assessment — workspace summary
+         * @description Org-level Test pyramid assessment for `/insights/test-pyramid`. Aggregates each active repo's **latest** readiness-scan test-pyramid snapshot. Layer **presence is count-based** (`fileCount > 0`); CI/dependency-only AF `present` flags are ignored. Shape uses fixed advisory targets (base ~70% unit, middle ~20% integration+contract+acceptance/BDD, top ~10% E2E) and returns `insufficient_data` when total classified test files < 10. Does not change Agentic Foundation `/readiness/test-pyramid*` responses.
+         */
+        get: operations["getInsightsTestPyramidSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/test-pyramid/repos": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Test pyramid assessment — per-repo list (paginated)
+         * @description Page of repos with latest classified test-file counts, count-based presence, presence maturity, and shape assessment. Use `gapsByLayer` on the summary endpoint (or filter this list via layerPresent) to answer “who lacks layer X?”. No v1 repo-detail Insights route — link repo names to AF readiness inventory.
+         */
+        get: operations["listInsightsTestPyramidRepos"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/members": {
         parameters: {
             query?: never;
@@ -9543,6 +9583,115 @@ export interface components {
             topHotspots: components["schemas"]["CodeInsightsOrgHotspotDto"][];
             sonar: components["schemas"]["CodeInsightsSonarDto"];
         };
+        /**
+         * @description Presence maturity (model A) using count-based layer presence (`fileCount > 0`), not AF signal-inclusive `present`.
+         * @enum {string}
+         */
+        InsightsTestPyramidMaturityDto: "missing" | "emerging" | "established" | "mature";
+        /**
+         * @description Advisory shape label vs fixed 70/20/10. `insufficient_data` when total classified test files < 10 (band percents are null).
+         * @enum {string}
+         */
+        InsightsTestPyramidShapeLabelDto: "insufficient_data" | "base_heavy" | "balanced" | "top_heavy" | "middle_heavy";
+        InsightsTestPyramidShapeDto: {
+            label: components["schemas"]["InsightsTestPyramidShapeLabelDto"];
+            /** @description Sum of classified test **files** across the five layers (not test cases). */
+            totalClassifiedFiles: number;
+            /** @description Share of classified files in unit (base). Null when insufficient_data. */
+            basePercent: number | null;
+            /** @description Share in integration + contract + acceptance_bdd (middle). Null when insufficient_data. */
+            middlePercent: number | null;
+            /** @description Share in e2e (top). Null when insufficient_data. */
+            topPercent: number | null;
+            targets: {
+                /** @enum {number} */
+                basePercent: 70;
+                /** @enum {number} */
+                middlePercent: 20;
+                /** @enum {number} */
+                topPercent: 10;
+            };
+        };
+        InsightsTestPyramidLayerCountsDto: {
+            unit: number;
+            integration: number;
+            acceptance_bdd: number;
+            contract: number;
+            e2e: number;
+        };
+        InsightsTestPyramidLayerPresentDto: {
+            unit: boolean;
+            integration: boolean;
+            acceptance_bdd: boolean;
+            contract: boolean;
+            e2e: boolean;
+        };
+        InsightsTestPyramidLayerPresenceDto: {
+            presentRepos: number;
+            applicableRepos: number;
+            percent: number | null;
+            missingRepoIds: string[];
+            missingRepoNames: string[];
+        };
+        InsightsTestPyramidGapRepoDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+        };
+        InsightsTestPyramidGapsByLayerDto: {
+            unit: components["schemas"]["InsightsTestPyramidGapRepoDto"][];
+            integration: components["schemas"]["InsightsTestPyramidGapRepoDto"][];
+            acceptance_bdd: components["schemas"]["InsightsTestPyramidGapRepoDto"][];
+            contract: components["schemas"]["InsightsTestPyramidGapRepoDto"][];
+            e2e: components["schemas"]["InsightsTestPyramidGapRepoDto"][];
+        };
+        InsightsTestPyramidMaturityCountsDto: {
+            missing: number;
+            emerging: number;
+            established: number;
+            mature: number;
+        };
+        InsightsTestPyramidLayerPresenceMapDto: {
+            unit: components["schemas"]["InsightsTestPyramidLayerPresenceDto"];
+            integration: components["schemas"]["InsightsTestPyramidLayerPresenceDto"];
+            acceptance_bdd: components["schemas"]["InsightsTestPyramidLayerPresenceDto"];
+            contract: components["schemas"]["InsightsTestPyramidLayerPresenceDto"];
+            e2e: components["schemas"]["InsightsTestPyramidLayerPresenceDto"];
+        };
+        InsightsTestPyramidSummaryDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            reposWithPyramid: number;
+            /** @description Repos whose newest pyramid came from a non-succeeded readiness run. */
+            reposFromDegradedRuns: string[];
+            /** @description Workspace sum of classified test files (not cases). */
+            totalClassifiedFiles: number;
+            shape: components["schemas"]["InsightsTestPyramidShapeDto"];
+            layerPresence: components["schemas"]["InsightsTestPyramidLayerPresenceMapDto"];
+            maturityCounts: components["schemas"]["InsightsTestPyramidMaturityCountsDto"];
+            gapsByLayer: components["schemas"]["InsightsTestPyramidGapsByLayerDto"];
+        };
+        InsightsTestPyramidRepoItemDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /** Format: date-time */
+            scannedAt: string;
+            currentRunStatus: components["schemas"]["TestPyramidRunStatusDto"];
+            maturity: components["schemas"]["InsightsTestPyramidMaturityDto"];
+            layerFileCounts: components["schemas"]["InsightsTestPyramidLayerCountsDto"];
+            layerPresent: components["schemas"]["InsightsTestPyramidLayerPresentDto"];
+            totalClassifiedFiles: number;
+            shape: components["schemas"]["InsightsTestPyramidShapeDto"];
+        };
+        InsightsTestPyramidRepoListDto: {
+            items: components["schemas"]["InsightsTestPyramidRepoItemDto"][];
+            total: number;
+            limit: number;
+            offset: number;
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -9630,6 +9779,10 @@ export interface components {
         CodeInsightsRepoSort: "repoName" | "locTotal" | "ccAvg" | "dupPct" | "lastMeasuredAt";
         /** @description Case-insensitive substring filter on repo name / provider slug. */
         CodeInsightsRepoSearch: string;
+        /** @description Allowlisted Test pyramid assessment repo sort field. */
+        InsightsTestPyramidRepoSort: "repoName" | "totalClassifiedFiles" | "scannedAt" | "maturity";
+        /** @description Case-insensitive substring filter on repository name. */
+        InsightsTestPyramidRepoSearch: string;
         /** @description Case-insensitive filter on repository name, language, or provider slug. */
         ReadinessRepoSearch: string;
         /** @description Exact language filter (e.g. `typescript`). */
@@ -10153,6 +10306,19 @@ export type CodeInsightsDesignAnalyzeResponseDto = components['schemas']['CodeIn
 export type CodeInsightsOrgHotspotDto = components['schemas']['CodeInsightsOrgHotspotDto'];
 export type CodeInsightsSonarDto = components['schemas']['CodeInsightsSonarDto'];
 export type CodeInsightsSummaryDto = components['schemas']['CodeInsightsSummaryDto'];
+export type InsightsTestPyramidMaturityDto = components['schemas']['InsightsTestPyramidMaturityDto'];
+export type InsightsTestPyramidShapeLabelDto = components['schemas']['InsightsTestPyramidShapeLabelDto'];
+export type InsightsTestPyramidShapeDto = components['schemas']['InsightsTestPyramidShapeDto'];
+export type InsightsTestPyramidLayerCountsDto = components['schemas']['InsightsTestPyramidLayerCountsDto'];
+export type InsightsTestPyramidLayerPresentDto = components['schemas']['InsightsTestPyramidLayerPresentDto'];
+export type InsightsTestPyramidLayerPresenceDto = components['schemas']['InsightsTestPyramidLayerPresenceDto'];
+export type InsightsTestPyramidGapRepoDto = components['schemas']['InsightsTestPyramidGapRepoDto'];
+export type InsightsTestPyramidGapsByLayerDto = components['schemas']['InsightsTestPyramidGapsByLayerDto'];
+export type InsightsTestPyramidMaturityCountsDto = components['schemas']['InsightsTestPyramidMaturityCountsDto'];
+export type InsightsTestPyramidLayerPresenceMapDto = components['schemas']['InsightsTestPyramidLayerPresenceMapDto'];
+export type InsightsTestPyramidSummaryDto = components['schemas']['InsightsTestPyramidSummaryDto'];
+export type InsightsTestPyramidRepoItemDto = components['schemas']['InsightsTestPyramidRepoItemDto'];
+export type InsightsTestPyramidRepoListDto = components['schemas']['InsightsTestPyramidRepoListDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ResponseZenHrSyncInProgress = components['responses']['ZenHrSyncInProgress'];
@@ -10184,6 +10350,8 @@ export type ParameterPaginationOrder = components['parameters']['PaginationOrder
 export type ParameterReadinessRepoSort = components['parameters']['ReadinessRepoSort'];
 export type ParameterCodeInsightsRepoSort = components['parameters']['CodeInsightsRepoSort'];
 export type ParameterCodeInsightsRepoSearch = components['parameters']['CodeInsightsRepoSearch'];
+export type ParameterInsightsTestPyramidRepoSort = components['parameters']['InsightsTestPyramidRepoSort'];
+export type ParameterInsightsTestPyramidRepoSearch = components['parameters']['InsightsTestPyramidRepoSearch'];
 export type ParameterReadinessRepoSearch = components['parameters']['ReadinessRepoSearch'];
 export type ParameterReadinessRepoLanguage = components['parameters']['ReadinessRepoLanguage'];
 export type ParameterReadinessFixSort = components['parameters']['ReadinessFixSort'];
@@ -14107,6 +14275,106 @@ export interface operations {
             };
         };
     };
+    getInsightsTestPyramidSummary: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Test pyramid assessment workspace summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsTestPyramidSummaryDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Test pyramid history not supported by store */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    listInsightsTestPyramidRepos: {
+        parameters: {
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted Test pyramid assessment repo sort field. */
+                sort?: components["parameters"]["InsightsTestPyramidRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive substring filter on repository name. */
+                search?: components["parameters"]["InsightsTestPyramidRepoSearch"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated test pyramid assessment repo rows */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsTestPyramidRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Test pyramid history not supported by store */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAiToolMembers: {
         parameters: {
             query?: {