@thinkai/tai-api-contract 2.154.0-pr.1317.ba1b741d → 2.156.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.154.0
+  version: 2.156.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -6957,6 +6957,8 @@ paths:
                         open: 0
                         prPending: 0
                         fixed: 0
+                      verificationGapCount: 0
+                      verificationGaps: []
                     dimensionAggregates: []
                     fixStatusSummary:
                       queued: 0
@@ -7492,7 +7494,9 @@ paths:
               schema:
                 $ref: "#/components/schemas/FixRequestDto"
         "400":
-          description: Invalid body or malformed `repoId` (not a UUID)
+          description: >
+            Invalid body, malformed `repoId`, or a missing/unknown `patternChoice` when the issue
+            has `unresolvedChoices` (`pattern_choice_required`, `pattern_choice_invalid`).
           content:
             application/json:
               schema:
@@ -17638,6 +17642,15 @@ components:
             True when the platform does not yet have an auto-fix skill for this
             issue's dimension. The UI should render these items as disabled with
             a "Coming Soon" tooltip.
+        unresolvedChoices:
+          type: array
+          maxItems: 2
+          description: >
+            Short labels when the instruction file names two alternatives and does not pick one.
+            Fix it stays disabled until the request includes one of these as patternChoice.
+          items:
+            type: string
+            maxLength: 64
         fixTier:
           type: string
           enum: [auto, decisions-first, guidance]
@@ -18668,6 +18681,33 @@ components:
               type: integer
               minimum: 0
               description: Issues whose fix has been applied (fix_status = fixed).
+        verificationGapCount:
+          type: integer
+          minimum: 0
+          description: >-
+            Distinct non-archived repos whose latest succeeded scan has an A1 gap
+            (no instruction file) or a B5 gap (CI never runs tests). A gap whose
+            matching issue is already fixed is excluded. Omitted when the server
+            cannot see per-criterion status.
+        verificationGaps:
+          type: array
+          maxItems: 12
+          description: >-
+            Up to 12 repo and reason pairs for verificationGapCount. A repo with
+            both gaps appears twice. Does not change averageOverallScore.
+          items:
+            $ref: "#/components/schemas/AgenticFoundationVerificationGapDto"
+
+    AgenticFoundationVerificationGapDto:
+      type: object
+      additionalProperties: false
+      required: [repoName, reason]
+      properties:
+        repoName:
+          type: string
+        reason:
+          type: string
+          enum: ["no instruction file", "CI never runs tests"]
 
     PageMetaDto:
       type: object
@@ -19075,6 +19115,12 @@ components:
           type: string
           format: uuid
           description: Workspace repository id that owns the issue
+        patternChoice:
+          type: string
+          maxLength: 64
+          description: >
+            Required when the issue has unresolvedChoices. Must be one of those labels.
+            Stored on the fix row and stated in the worker prompt.
 
     PhaseRoleDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.154.0-pr.1317.ba1b741d",
+  "version": "2.156.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -7490,6 +7490,8 @@ export interface components {
             fixStatus: "open" | "pr-pending" | "fixed";
             /** @description True when the platform does not yet have an auto-fix skill for this issue's dimension. The UI should render these items as disabled with a "Coming Soon" tooltip. */
             comingSoon?: boolean;
+            /** @description Short labels when the instruction file names two alternatives and does not pick one. Fix it stays disabled until the request includes one of these as patternChoice. */
+            unresolvedChoices?: string[];
             /**
              * @description How automated fixing is supported for this criterion. `auto` — agent edits files directly; no human input needed. `decisions-first` — agent requires docs/ai-readiness-decisions.md to be filled first. `guidance` — admin-level action; agent creates an instructions doc PR.
              * @enum {string}
@@ -7930,6 +7932,15 @@ export interface components {
                 /** @description Issues whose fix has been applied (fix_status = fixed). */
                 fixed: number;
             };
+            /** @description Distinct non-archived repos whose latest succeeded scan has an A1 gap (no instruction file) or a B5 gap (CI never runs tests). A gap whose matching issue is already fixed is excluded. Omitted when the server cannot see per-criterion status. */
+            verificationGapCount?: number;
+            /** @description Up to 12 repo and reason pairs for verificationGapCount. A repo with both gaps appears twice. Does not change averageOverallScore. */
+            verificationGaps?: components["schemas"]["AgenticFoundationVerificationGapDto"][];
+        };
+        AgenticFoundationVerificationGapDto: {
+            repoName: string;
+            /** @enum {string} */
+            reason: "no instruction file" | "CI never runs tests";
         };
         PageMetaDto: {
             /** @description Total rows matching filters (full workspace, not just this page). */
@@ -8098,6 +8109,8 @@ export interface components {
              * @description Workspace repository id that owns the issue
              */
             repoId: string;
+            /** @description Required when the issue has unresolvedChoices. Must be one of those labels. Stored on the fix row and stated in the worker prompt. */
+            patternChoice?: string;
         };
         PhaseRoleDto: {
             phase: string;
@@ -11098,6 +11111,7 @@ export type LinkedRolePendingDto = components['schemas']['LinkedRolePendingDto']
 export type LinkedRoleAssessmentDto = components['schemas']['LinkedRoleAssessmentDto'];
 export type RepoReadinessScoreDetailDto = components['schemas']['RepoReadinessScoreDetailDto'];
 export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
+export type AgenticFoundationVerificationGapDto = components['schemas']['AgenticFoundationVerificationGapDto'];
 export type PageMetaDto = components['schemas']['PageMetaDto'];
 export type ReadinessEligibilityLimitsDto = components['schemas']['ReadinessEligibilityLimitsDto'];
 export type ReadinessRepoListDto = components['schemas']['ReadinessRepoListDto'];
@@ -18982,7 +18996,7 @@ export interface operations {
                     "application/json": components["schemas"]["FixRequestDto"];
                 };
             };
-            /** @description Invalid body or malformed `repoId` (not a UUID) */
+            /** @description Invalid body, malformed `repoId`, or a missing/unknown `patternChoice` when the issue has `unresolvedChoices` (`pattern_choice_required`, `pattern_choice_invalid`). */
             400: {
                 headers: {
                     [name: string]: unknown;