@thinkai/tai-api-contract 2.125.0 → 2.126.0

package/dist/generated/openapi.d.ts

@@ -2375,6 +2375,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/test-pyramid": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Latest test-pyramid report and progress per repository
+         * @description Returns the latest test inventory for every repository with a pyramid snapshot, deltas from the previous and baseline scans, and workspace layer coverage. Repositories whose historical runs predate pyramid snapshots are omitted.
+         */
+        get: operations["getReadinessTestPyramid"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/readiness/test-pyramid/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Historical test-pyramid snapshots per repository
+         * @description Returns succeeded readiness runs containing test-pyramid snapshots, ordered oldest to newest per repository. Older runs without snapshots are omitted, not treated as gaps.
+         */
+        get: operations["getReadinessTestPyramidHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/readiness/test-pyramid/progress": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Test-pyramid code progress from successive scans
+         * @description Compares each repository's latest pyramid snapshot with its previous and baseline snapshots. Reports layer adoption/removal, file-count and Tests & QA score deltas, criterion changes, and current workspace coverage.
+         */
+        get: operations["getReadinessTestPyramidProgress"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/score-history": {
         parameters: {
             query?: never;
@@ -6794,12 +6854,176 @@ export interface components {
             /** @description Dimension score as a percentage (0–100) for this scan run. */
             scorePercent: number;
         };
+        TestPyramidLayerSnapshotDto: {
+            present: boolean;
+            /** @description False when the repository archetype makes this layer not applicable. */
+            applicable: boolean;
+            /** @enum {string} */
+            confidence: "high" | "medium" | "low";
+            fileCount: number;
+            frameworks: string[];
+            /** @description Capped relative file paths or script names supporting the classification. */
+            evidence: string[];
+            lineCoverage?: components["schemas"]["TestPyramidLineCoverageDto"];
+        };
+        TestPyramidLayersDto: {
+            unit: components["schemas"]["TestPyramidLayerSnapshotDto"];
+            integration: components["schemas"]["TestPyramidLayerSnapshotDto"];
+            acceptance_bdd: components["schemas"]["TestPyramidLayerSnapshotDto"];
+            contract: components["schemas"]["TestPyramidLayerSnapshotDto"];
+            e2e: components["schemas"]["TestPyramidLayerSnapshotDto"];
+        };
+        TestPyramidSnapshotDto: {
+            /** @enum {integer} */
+            version: 1;
+            layers: components["schemas"]["TestPyramidLayersDto"];
+            /** @description Evidence suggests the repository's E2E suite exercises multiple services. */
+            e2eCrossRepoCandidate: boolean;
+            /** @description Hostnames or compose service names referenced by the E2E suite. */
+            e2eReferencedTargets: string[];
+            lineCoverage?: components["schemas"]["TestPyramidLineCoverageDto"];
+        };
+        TestPyramidLineCoverageDto: {
+            /** @description Line coverage percent from Sonar or a committed coverage report. */
+            linePercent: number;
+            branchPercent: number | null;
+            /** @enum {string} */
+            source: "sonar" | "jacoco" | "lcov" | "cobertura" | "clover" | "go_cover";
+            /** @description Path of the scanned report when the source is not Sonar. */
+            reportPath?: string | null;
+        } | null;
+        TestPyramidCriteriaDto: {
+            D1?: string;
+            D2?: string;
+            D3?: string;
+            D4?: string;
+        };
+        /**
+         * @description Run state the snapshot came from. The pyramid is derived from the filesystem scan, which finishes before rubric grading, so `partial_failed` and `failed` runs still carry a valid snapshot but no scores.
+         * @enum {string}
+         */
+        TestPyramidRunStatusDto: "succeeded" | "partial_failed" | "failed";
+        TestPyramidHistoryPointDto: {
+            /** Format: date-time */
+            finishedAt: string;
+            runStatus: components["schemas"]["TestPyramidRunStatusDto"];
+            overallScore: number | null;
+            testsQaPercent: number | null;
+            testPyramid: components["schemas"]["TestPyramidSnapshotDto"];
+            testPyramidCriteria: components["schemas"]["TestPyramidCriteriaDto"];
+        };
+        TestPyramidRepoHistoryDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /** Format: date-time */
+            connectedAt: string;
+            points: components["schemas"]["TestPyramidHistoryPointDto"][];
+        };
+        WorkspaceTestPyramidHistoryDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            repos: components["schemas"]["TestPyramidRepoHistoryDto"][];
+        };
+        TestPyramidLayerDeltaDto: {
+            /** @enum {string} */
+            presence: "unchanged" | "adopted" | "removed";
+            fileCountDelta: number;
+            addedFrameworks: string[];
+        };
+        TestPyramidLayerDeltasDto: {
+            unit: components["schemas"]["TestPyramidLayerDeltaDto"];
+            integration: components["schemas"]["TestPyramidLayerDeltaDto"];
+            acceptance_bdd: components["schemas"]["TestPyramidLayerDeltaDto"];
+            contract: components["schemas"]["TestPyramidLayerDeltaDto"];
+            e2e: components["schemas"]["TestPyramidLayerDeltaDto"];
+        };
+        TestPyramidCriterionDeltaDto: {
+            from: string | null;
+            to: string;
+        };
+        TestPyramidCriterionDeltasDto: {
+            D1?: components["schemas"]["TestPyramidCriterionDeltaDto"];
+            D2?: components["schemas"]["TestPyramidCriterionDeltaDto"];
+            D3?: components["schemas"]["TestPyramidCriterionDeltaDto"];
+            D4?: components["schemas"]["TestPyramidCriterionDeltaDto"];
+        };
+        TestPyramidRepoProgressDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /** Format: date-time */
+            baselineAt: string;
+            /** Format: date-time */
+            previousAt: string | null;
+            /** Format: date-time */
+            currentAt: string;
+            currentRunStatus: components["schemas"]["TestPyramidRunStatusDto"];
+            /** @enum {string} */
+            maturity: "missing" | "emerging" | "established" | "mature";
+            testsQaPercent: number | null;
+            testsQaPercentDelta: number | null;
+            layerDeltas: components["schemas"]["TestPyramidLayerDeltasDto"];
+            baselineLayerDeltas: components["schemas"]["TestPyramidLayerDeltasDto"];
+            criterionDeltas: components["schemas"]["TestPyramidCriterionDeltasDto"];
+            testPyramid: components["schemas"]["TestPyramidSnapshotDto"];
+            testPyramidCriteria: components["schemas"]["TestPyramidCriteriaDto"];
+            lineCoverage?: components["schemas"]["TestPyramidLineCoverageDto"];
+        };
+        TestPyramidLayerCoverageDto: {
+            presentRepos: number;
+            applicableRepos: number;
+            percent: number | null;
+            missingRepoIds: string[];
+        };
+        TestPyramidLayerCoverageMapDto: {
+            unit: components["schemas"]["TestPyramidLayerCoverageDto"];
+            integration: components["schemas"]["TestPyramidLayerCoverageDto"];
+            acceptance_bdd: components["schemas"]["TestPyramidLayerCoverageDto"];
+            contract: components["schemas"]["TestPyramidLayerCoverageDto"];
+            e2e: components["schemas"]["TestPyramidLayerCoverageDto"];
+        };
+        TestPyramidMaturityCountsDto: {
+            missing: number;
+            emerging: number;
+            established: number;
+            mature: number;
+        };
+        TestPyramidCrossRepoMatchDto: {
+            /** Format: uuid */
+            sourceRepoId: string;
+            targetRepoIds: string[];
+            referencedTargets: string[];
+        };
+        WorkspaceTestPyramidSummaryDto: {
+            reposWithPyramid: number;
+            /** @description Repositories whose newest snapshot came from a run whose rubric grading did not complete. Their pyramid is valid but Tests & QA scores are unavailable. */
+            reposFromDegradedRuns: string[];
+            layerCoverage: components["schemas"]["TestPyramidLayerCoverageMapDto"];
+            maturityCounts: components["schemas"]["TestPyramidMaturityCountsDto"];
+            e2eCrossRepoCandidateRepoIds: string[];
+            e2eCrossRepoMatches: components["schemas"]["TestPyramidCrossRepoMatchDto"][];
+            /** @description True only when an E2E target is matched to another repository in the workspace. */
+            crossRepoE2ePresent: boolean;
+        };
+        WorkspaceTestPyramidProgressDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            repos: components["schemas"]["TestPyramidRepoProgressDto"][];
+            workspace: components["schemas"]["WorkspaceTestPyramidSummaryDto"];
+        };
         ReadinessScoreHistoryPointDto: {
             /** Format: date-time */
             finishedAt: string;
             overallScore: number;
             /** @description Per-dimension percentages captured on this scan run. */
             dimensionScores?: components["schemas"]["ReadinessScoreHistoryDimensionScoreDto"][];
+            testPyramid?: components["schemas"]["TestPyramidSnapshotDto"];
+            testPyramidCriteria?: components["schemas"]["TestPyramidCriteriaDto"];
         };
         ReadinessRepoScoreHistoryDto: {
             /** Format: uuid */
@@ -9667,6 +9891,26 @@ export type DimensionScoreDetailDto = components['schemas']['DimensionScoreDetai
 export type ReadinessRepoRunHistoryItemDto = components['schemas']['ReadinessRepoRunHistoryItemDto'];
 export type ReadinessRepoRunListDto = components['schemas']['ReadinessRepoRunListDto'];
 export type ReadinessScoreHistoryDimensionScoreDto = components['schemas']['ReadinessScoreHistoryDimensionScoreDto'];
+export type TestPyramidLayerSnapshotDto = components['schemas']['TestPyramidLayerSnapshotDto'];
+export type TestPyramidLayersDto = components['schemas']['TestPyramidLayersDto'];
+export type TestPyramidSnapshotDto = components['schemas']['TestPyramidSnapshotDto'];
+export type TestPyramidLineCoverageDto = components['schemas']['TestPyramidLineCoverageDto'];
+export type TestPyramidCriteriaDto = components['schemas']['TestPyramidCriteriaDto'];
+export type TestPyramidRunStatusDto = components['schemas']['TestPyramidRunStatusDto'];
+export type TestPyramidHistoryPointDto = components['schemas']['TestPyramidHistoryPointDto'];
+export type TestPyramidRepoHistoryDto = components['schemas']['TestPyramidRepoHistoryDto'];
+export type WorkspaceTestPyramidHistoryDto = components['schemas']['WorkspaceTestPyramidHistoryDto'];
+export type TestPyramidLayerDeltaDto = components['schemas']['TestPyramidLayerDeltaDto'];
+export type TestPyramidLayerDeltasDto = components['schemas']['TestPyramidLayerDeltasDto'];
+export type TestPyramidCriterionDeltaDto = components['schemas']['TestPyramidCriterionDeltaDto'];
+export type TestPyramidCriterionDeltasDto = components['schemas']['TestPyramidCriterionDeltasDto'];
+export type TestPyramidRepoProgressDto = components['schemas']['TestPyramidRepoProgressDto'];
+export type TestPyramidLayerCoverageDto = components['schemas']['TestPyramidLayerCoverageDto'];
+export type TestPyramidLayerCoverageMapDto = components['schemas']['TestPyramidLayerCoverageMapDto'];
+export type TestPyramidMaturityCountsDto = components['schemas']['TestPyramidMaturityCountsDto'];
+export type TestPyramidCrossRepoMatchDto = components['schemas']['TestPyramidCrossRepoMatchDto'];
+export type WorkspaceTestPyramidSummaryDto = components['schemas']['WorkspaceTestPyramidSummaryDto'];
+export type WorkspaceTestPyramidProgressDto = components['schemas']['WorkspaceTestPyramidProgressDto'];
 export type ReadinessScoreHistoryPointDto = components['schemas']['ReadinessScoreHistoryPointDto'];
 export type ReadinessRepoScoreHistoryDto = components['schemas']['ReadinessRepoScoreHistoryDto'];
 export type WorkspaceReadinessScoreHistoryDto = components['schemas']['WorkspaceReadinessScoreHistoryDto'];
@@ -16252,6 +16496,138 @@ export interface operations {
             };
         };
     };
+    getReadinessTestPyramid: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Latest test-pyramid report and progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceTestPyramidProgressDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Readiness history is not supported by the configured store */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getReadinessTestPyramidHistory: {
+        parameters: {
+            query?: {
+                since?: string;
+                limitPerRepo?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Test-pyramid history grouped by repository */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceTestPyramidHistoryDto"];
+                };
+            };
+            /** @description Invalid query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Readiness history is not supported by the configured store */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getReadinessTestPyramidProgress: {
+        parameters: {
+            query?: {
+                since?: string;
+                limitPerRepo?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Test-pyramid code progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceTestPyramidProgressDto"];
+                };
+            };
+            /** @description Invalid query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Readiness history is not supported by the configured store */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getReadinessScoreHistory: {
         parameters: {
             query?: {