@thinkai/tai-api-contract 2.196.1 → 2.198.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.196.1
+  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"
@@ -27507,12 +27508,47 @@ components:
             Active knowledge job for this repo when status is queued/running — phase, tracks,
             and token/cost rollups for SPA transparency (Wave 1).
         indexedAt: { type: string, format: date-time, nullable: true }
+        lastCheckedAt:
+          type: string
+          format: date-time
+          nullable: true
+          description: >
+            When cadence last compared the remote tip SHA to commitSha without rebuilding
+            the graph (change-block skip). Distinct from indexedAt.
+        lastChange:
+          allOf:
+            - $ref: "#/components/schemas/CodeChatIndexLastChangeDto"
+          nullable: true
+          description: >
+            Paths/counts changed between the prior and current commitSha on the last rebuild.
         createdAt: { type: string, format: date-time }
         updatedAt: { type: string, format: date-time }
         hasCodeExcerpts:
           type: boolean
           description: True when the indexed graph stores durable code excerpts (required for useful chat answers).
 
+    CodeChatIndexLastChangeDto:
+      type: object
+      required: [priorCommitSha, commitSha, fileCount, files, capturedAt]
+      properties:
+        priorCommitSha: { type: string }
+        commitSha: { type: string }
+        fileCount:
+          type: integer
+          minimum: 0
+          description: Total files changed (may exceed files.length when capped).
+        files:
+          type: array
+          maxItems: 50
+          items:
+            type: object
+            required: [path, status]
+            properties:
+              path: { type: string }
+              status:
+                { type: string, description: "GitHub compare status (added, modified, removed, …)" }
+        capturedAt: { type: string, format: date-time }
+
     CodeKnowledgeJobDto:
       type: object
       required:
@@ -27627,12 +27663,22 @@ components:
         repoName: { type: string }
         code:
           type: string
-          enum: [repo_ineligible, indexed_recently, index_in_progress, ecg_source_off, index_failed]
+          enum:
+            [
+              repo_ineligible,
+              indexed_recently,
+              index_in_progress,
+              ecg_source_off,
+              index_failed,
+              content_unchanged,
+            ]
           description: >
             Stable machine-readable skip reason. `ecg_source_off` covers a source turned off
             for Engineering Context Graph and non-GitHub providers that stay listed but are
             never indexed. `index_failed` means indexing already failed after three attempts
-            and stays failed until an admin force sync.
+            and stays failed until an admin force sync. `content_unchanged` means the remote
+            tip SHA matched the stored index commit during a daily/weekly cadence tick
+            (check-only; no clone/Graphify).
 
     CodeChatThreadDto:
       type: object
@@ -29571,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:
@@ -29591,6 +29685,7 @@ components:
         - e2eCrossRepoCandidateCount
         - reposWithHotspots
         - ciQuality
+        - suiteExecution
       properties:
         workspaceId: { type: string, format: uuid }
         generatedAt: { type: string, format: date-time }
@@ -29642,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
@@ -29666,6 +29763,7 @@ components:
         - layerApplicable
         - e2eCrossRepoCandidate
         - hotspotCount
+        - suiteExecution
       properties:
         repoId: { type: string, format: uuid }
         repoName: { type: string }
@@ -29727,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