@thinkai/tai-api-contract 2.126.0 → 2.128.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 and the immediately previous succeeded/partial_failed/failed point when present (`limitPerRepo: 2`). 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. Also returns maturity trend, coverage overlay, confidence, applicability, E2E-cross/hotspot risk, and workspace-only `ciQuality` from the latest org dashboard snapshot. 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, shape, trend vs the previous pyramid point, coverage overlay, confidence/evidence, layer applicability, and risk signals (`e2eCrossRepoCandidate`, `hotspotCount`). 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,176 @@ 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"];
+        };
+        /**
+         * @description Insights maturity rank change vs the immediately previous pyramid point (missing 0, emerging 1, established 2, mature 3). `none` when the repo has no previous succeeded/partial_failed/failed point.
+         * @enum {string}
+         */
+        InsightsTestPyramidMaturityDeltaDto: "up" | "down" | "unchanged" | "none";
+        /** @enum {string} */
+        InsightsTestPyramidConfidenceDto: "high" | "medium" | "low";
+        InsightsTestPyramidLayerConfidenceDto: {
+            unit: components["schemas"]["InsightsTestPyramidConfidenceDto"];
+            integration: components["schemas"]["InsightsTestPyramidConfidenceDto"];
+            acceptance_bdd: components["schemas"]["InsightsTestPyramidConfidenceDto"];
+            contract: components["schemas"]["InsightsTestPyramidConfidenceDto"];
+            e2e: components["schemas"]["InsightsTestPyramidConfidenceDto"];
+        };
+        InsightsTestPyramidCoverageRollupDto: {
+            /** @description Repos whose overlaid `lineCoverage` is non-null. */
+            reposWithCoverage: number;
+            /** @description Median of repo `linePercent` among repos that have coverage. Null when `reposWithCoverage` is 0. */
+            medianLinePercent: number | null;
+        };
+        InsightsTestPyramidCiQualityDto: {
+            /** @description Latest org dashboard `quality.ciFailureRatePercent`, falling back to `quality.ciBuildFailRatePercent`. */
+            ciFailureRatePercent: number;
+            /** @description Included only when `quality.ciFlakinessPercent` is a finite number. */
+            ciFlakinessPercent?: number;
+            /** @description Dashboard metrics bucket end for the org snapshot. */
+            bucketEnd: string;
+        } | null;
+        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"];
+            /**
+             * Format: date-time
+             * @description Latest per-repo `scannedAt`. Null when `reposWithPyramid` is 0.
+             */
+            newestScannedAt: string | null;
+            /** @description Repos whose Insights maturity rank increased vs the previous point. */
+            maturedRepoCount: number;
+            /** @description Repos whose Insights maturity rank decreased vs the previous point. */
+            slippedRepoCount: number;
+            /** @description Insights workspace shape from previous-point file totals for repos that have a previous point. Null when no repo has a previous point. */
+            previousShape: components["schemas"]["InsightsTestPyramidShapeDto"] | null;
+            coverage: components["schemas"]["InsightsTestPyramidCoverageRollupDto"];
+            e2eCrossRepoCandidateCount: number;
+            /** @description Repos whose latest Code Insights snapshot has `hotspotCount` > 0. */
+            reposWithHotspots: number;
+            ciQuality: components["schemas"]["InsightsTestPyramidCiQualityDto"];
+        };
+        InsightsTestPyramidRepoItemDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /** Format: date-time */
+            scannedAt: string;
+            currentRunStatus: components["schemas"]["TestPyramidRunStatusDto"];
+            maturity: components["schemas"]["InsightsTestPyramidMaturityDto"];
+            previousMaturity: components["schemas"]["InsightsTestPyramidMaturityDto"] | null;
+            maturityDelta: components["schemas"]["InsightsTestPyramidMaturityDeltaDto"];
+            previousShapeLabel: components["schemas"]["InsightsTestPyramidShapeLabelDto"] | null;
+            layerFileCounts: components["schemas"]["InsightsTestPyramidLayerCountsDto"];
+            layerPresent: components["schemas"]["InsightsTestPyramidLayerPresentDto"];
+            /** @description Snapshot `layers.*.applicable` for each layer. */
+            layerApplicable: components["schemas"]["InsightsTestPyramidLayerPresentDto"];
+            totalClassifiedFiles: number;
+            shape: components["schemas"]["InsightsTestPyramidShapeDto"];
+            /** @description Same overlay as AF progress — latest Sonar row first, else snapshot `testPyramid.lineCoverage`. Null when both are missing. Not Code Insights `coveragePct`. */
+            lineCoverage: components["schemas"]["TestPyramidLineCoverageDto"];
+            /** @description Minimum confidence among layers with Insights presence (`fileCount > 0`); if none present, minimum of applicable layers. Order low < medium < high. */
+            lowestConfidence: components["schemas"]["InsightsTestPyramidConfidenceDto"];
+            layerConfidence: components["schemas"]["InsightsTestPyramidLayerConfidenceDto"];
+            /** @description Sum of layer `evidence[]` lengths on the latest snapshot. */
+            evidenceCount: number;
+            /** @description Unique framework names across layers, capped at 8. */
+            frameworks: string[];
+            e2eCrossRepoCandidate: boolean;
+            /** @description Row count in `tai_workspace_repo_code_hotspots` for the repo's latest Code Insights metrics snapshot. Null when the repo has no metrics snapshot. */
+            hotspotCount: number | null;
+        };
+        InsightsTestPyramidRepoListDto: {
+            items: components["schemas"]["InsightsTestPyramidRepoItemDto"][];
+            total: number;
+            limit: number;
+            offset: number;
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -9630,6 +9840,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 +10367,24 @@ 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 InsightsTestPyramidMaturityDeltaDto = components['schemas']['InsightsTestPyramidMaturityDeltaDto'];
+export type InsightsTestPyramidConfidenceDto = components['schemas']['InsightsTestPyramidConfidenceDto'];
+export type InsightsTestPyramidLayerConfidenceDto = components['schemas']['InsightsTestPyramidLayerConfidenceDto'];
+export type InsightsTestPyramidCoverageRollupDto = components['schemas']['InsightsTestPyramidCoverageRollupDto'];
+export type InsightsTestPyramidCiQualityDto = components['schemas']['InsightsTestPyramidCiQualityDto'];
+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 +10416,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 +14341,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?: {