@thinkai/tai-api-contract 2.197.0 → 2.198.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.197.0
+  version: 2.198.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -5015,7 +5015,8 @@ paths:
         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.
+        risk, workspace-only `ciQuality`, and Actions/check-name `suiteExecution`
+        (unit/e2e suite pass/flake) from the latest org dashboard snapshot.
         Does not change Agentic Foundation `/readiness/test-pyramid*` responses.
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
@@ -29616,6 +29617,54 @@ components:
           type: string
           description: Dashboard metrics bucket end for the org snapshot.
 
+    InsightsTestPyramidSuiteLayerOutcomeDto:
+      type: object
+      required: [passRatePercent, failRatePercent, runsTotal, sampleBucketEnd]
+      properties:
+        passRatePercent:
+          type: number
+          minimum: 0
+          maximum: 100
+        failRatePercent:
+          type: number
+          minimum: 0
+          maximum: 100
+        runsTotal:
+          type: integer
+          minimum: 1
+        sampleBucketEnd:
+          type: string
+          description: Latest mapped check-run `occurred_at` in the sample.
+        flakePercent:
+          type: number
+          minimum: 0
+          maximum: 100
+          description: >
+            Included only when `runsTotal` is at least 5. Failure then success on
+            the same `head_sha` + check name counts as a flake observation.
+
+    InsightsTestPyramidSuiteExecutionDto:
+      type: object
+      nullable: true
+      description: >
+        Suite-level pass/flake from GitHub Actions / Checks job names classified
+        onto pyramid layers. Null when no mapped unit/e2e (or optional integration)
+        check names exist in the org dashboard quality snapshot.
+      properties:
+        unit:
+          allOf:
+            - $ref: "#/components/schemas/InsightsTestPyramidSuiteLayerOutcomeDto"
+          nullable: true
+        e2e:
+          allOf:
+            - $ref: "#/components/schemas/InsightsTestPyramidSuiteLayerOutcomeDto"
+          nullable: true
+        integration:
+          allOf:
+            - $ref: "#/components/schemas/InsightsTestPyramidSuiteLayerOutcomeDto"
+          nullable: true
+          description: Optional bonus layer; not required for #234 acceptance.
+
     InsightsTestPyramidSummaryDto:
       type: object
       required:
@@ -29636,6 +29685,7 @@ components:
         - e2eCrossRepoCandidateCount
         - reposWithHotspots
         - ciQuality
+        - suiteExecution
       properties:
         workspaceId: { type: string, format: uuid }
         generatedAt: { type: string, format: date-time }
@@ -29687,6 +29737,8 @@ components:
           description: Repos whose latest Code Insights snapshot has `hotspotCount` > 0.
         ciQuality:
           $ref: "#/components/schemas/InsightsTestPyramidCiQualityDto"
+        suiteExecution:
+          $ref: "#/components/schemas/InsightsTestPyramidSuiteExecutionDto"
 
     InsightsTestPyramidRepoItemDto:
       type: object
@@ -29711,6 +29763,7 @@ components:
         - layerApplicable
         - e2eCrossRepoCandidate
         - hotspotCount
+        - suiteExecution
       properties:
         repoId: { type: string, format: uuid }
         repoName: { type: string }
@@ -29772,6 +29825,8 @@ components:
           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.
+        suiteExecution:
+          $ref: "#/components/schemas/InsightsTestPyramidSuiteExecutionDto"
 
     InsightsTestPyramidRepoListDto:
       type: object