@thinkai/tai-api-contract 2.157.0 → 2.158.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.157.0
+  version: 2.158.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -6959,6 +6959,15 @@ paths:
                         fixed: 0
                       verificationGapCount: 0
                       verificationGaps: []
+                      blockedRepoCount: 0
+                      topBlockingRuleTitle: null
+                      topBlockingRuleRepoCount: 0
+                      fixProof:
+                        windowDays: 30
+                        mergeRatePercent: null
+                        medianDaysToMerge: null
+                        clearedCount: 0
+                        rows: []
                     dimensionAggregates: []
                     fixStatusSummary:
                       queued: 0
@@ -11515,7 +11524,7 @@ components:
       description: Allowlisted repository sort field.
       schema:
         type: string
-        enum: [repoName, overallScore, lastAnalyzed, language]
+        enum: [repoName, overallScore, lastAnalyzed, language, blockingRule]
         default: overallScore
     CodeInsightsRepoSort:
       name: sort
@@ -18471,6 +18480,15 @@ components:
             scores; live CI health stays in SDLC Insights.
           items:
             $ref: "#/components/schemas/ScanImprovementDto"
+        blockingRule:
+          type: object
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/ReadinessBlockingRuleDto"
+          description: >
+            The one open gap or partial criterion on the latest succeeded scan that is not
+            already fixed. Null when the repo is not blocked. Severity ranks first, then
+            dimension weight, then rubric id.
 
     LinkedRolePendingDto:
       type: object
@@ -18649,10 +18667,27 @@ components:
           description: See RepoReadinessScoreDto.scanImprovements.
           items:
             $ref: "#/components/schemas/ScanImprovementDto"
+        blockingRule:
+          type: object
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/ReadinessBlockingRuleDto"
+          description: See RepoReadinessScoreDto.blockingRule.
 
     AgenticFoundationDashboardSummaryDto:
       type: object
-      required: [repoCount, averageOverallScore, issueCount, criticalIssueCount, issuesByFixStatus]
+      required:
+        [
+          repoCount,
+          averageOverallScore,
+          issueCount,
+          criticalIssueCount,
+          issuesByFixStatus,
+          blockedRepoCount,
+          topBlockingRuleTitle,
+          topBlockingRuleRepoCount,
+          fixProof,
+        ]
       properties:
         repoCount:
           type: integer
@@ -18704,6 +18739,91 @@ components:
             both gaps appears twice. Does not change averageOverallScore.
           items:
             $ref: "#/components/schemas/AgenticFoundationVerificationGapDto"
+        blockedRepoCount:
+          type: integer
+          minimum: 0
+          description: >
+            Non-archived repos whose latest succeeded scan still has a gap or partial
+            criterion that is not fixed. A repo with no open gap is not blocked.
+        topBlockingRuleTitle:
+          type: string
+          nullable: true
+          description: Rule title that blocks the most repos. Null when blockedRepoCount is 0.
+        topBlockingRuleRepoCount:
+          type: integer
+          minimum: 0
+          description: How many blocked repos share topBlockingRuleTitle.
+        fixProof:
+          $ref: "#/components/schemas/AgenticFoundationFixProofDto"
+
+    ReadinessBlockingRuleDto:
+      type: object
+      additionalProperties: false
+      required: [rubricId, title, severity]
+      properties:
+        rubricId:
+          type: string
+        title:
+          type: string
+        severity:
+          type: string
+          enum: [critical, high, medium, low]
+
+    AgenticFoundationFixProofDto:
+      type: object
+      additionalProperties: false
+      required: [windowDays, mergeRatePercent, medianDaysToMerge, clearedCount, rows]
+      properties:
+        windowDays:
+          type: integer
+          minimum: 1
+        mergeRatePercent:
+          type: integer
+          minimum: 0
+          maximum: 100
+          nullable: true
+          description: >
+            Rounded percent of terminal fixes in the window that merged (merged / merged + failed).
+            Null when there is no terminal fix.
+        medianDaysToMerge:
+          type: number
+          nullable: true
+          description: Median days from created_at to merge. Null when nothing merged in the window.
+        clearedCount:
+          type: integer
+          minimum: 0
+          description: Merged fixes in the window whose next scan marked the criterion met.
+        rows:
+          type: array
+          maxItems: 10
+          items:
+            $ref: "#/components/schemas/AgenticFoundationFixProofRowDto"
+
+    AgenticFoundationFixProofRowDto:
+      type: object
+      additionalProperties: false
+      required: [repoName, ruleTitle, scoreBefore, scoreAfter, cleared]
+      properties:
+        repoName:
+          type: string
+        ruleTitle:
+          type: string
+        scoreBefore:
+          type: integer
+          minimum: 0
+          maximum: 100
+          nullable: true
+        scoreAfter:
+          type: integer
+          minimum: 0
+          maximum: 100
+          nullable: true
+        cleared:
+          type: boolean
+          nullable: true
+          description: >
+            True when the first succeeded scan after the merge marked the criterion met.
+            Null when that scan has not run yet.
 
     AgenticFoundationVerificationGapDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.157.0",
+  "version": "2.158.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -7835,6 +7835,8 @@ export interface components {
             linkedRoleAssessment?: components["schemas"]["LinkedRoleAssessmentDto"] | null;
             /** @description Repo-level "Improve this scan" recommendations for Agentic Foundation CI setup (at most three). Omitted when the scan emitted none. Does not change criterion scores; live CI health stays in SDLC Insights. */
             scanImprovements?: components["schemas"]["ScanImprovementDto"][];
+            /** @description The one open gap or partial criterion on the latest succeeded scan that is not already fixed. Null when the repo is not blocked. Severity ranks first, then dimension weight, then rubric id. */
+            blockingRule?: components["schemas"]["ReadinessBlockingRuleDto"] | null;
         };
         LinkedRolePendingDto: {
             /** @description Topology role key, e.g. terraform | gitops | ci_templates | api_contracts. */
@@ -7915,6 +7917,8 @@ export interface components {
             linkedRoleAssessment?: components["schemas"]["LinkedRoleAssessmentDto"] | null;
             /** @description See RepoReadinessScoreDto.scanImprovements. */
             scanImprovements?: components["schemas"]["ScanImprovementDto"][];
+            /** @description See RepoReadinessScoreDto.blockingRule. */
+            blockingRule?: components["schemas"]["ReadinessBlockingRuleDto"] | null;
         };
         AgenticFoundationDashboardSummaryDto: {
             repoCount: number;
@@ -7936,6 +7940,37 @@ export interface components {
             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"][];
+            /** @description Non-archived repos whose latest succeeded scan still has a gap or partial criterion that is not fixed. A repo with no open gap is not blocked. */
+            blockedRepoCount: number;
+            /** @description Rule title that blocks the most repos. Null when blockedRepoCount is 0. */
+            topBlockingRuleTitle: string | null;
+            /** @description How many blocked repos share topBlockingRuleTitle. */
+            topBlockingRuleRepoCount: number;
+            fixProof: components["schemas"]["AgenticFoundationFixProofDto"];
+        };
+        ReadinessBlockingRuleDto: {
+            rubricId: string;
+            title: string;
+            /** @enum {string} */
+            severity: "critical" | "high" | "medium" | "low";
+        };
+        AgenticFoundationFixProofDto: {
+            windowDays: number;
+            /** @description Rounded percent of terminal fixes in the window that merged (merged / merged + failed). Null when there is no terminal fix. */
+            mergeRatePercent: number | null;
+            /** @description Median days from created_at to merge. Null when nothing merged in the window. */
+            medianDaysToMerge: number | null;
+            /** @description Merged fixes in the window whose next scan marked the criterion met. */
+            clearedCount: number;
+            rows: components["schemas"]["AgenticFoundationFixProofRowDto"][];
+        };
+        AgenticFoundationFixProofRowDto: {
+            repoName: string;
+            ruleTitle: string;
+            scoreBefore: number | null;
+            scoreAfter: number | null;
+            /** @description True when the first succeeded scan after the merge marked the criterion met. Null when that scan has not run yet. */
+            cleared: boolean | null;
         };
         AgenticFoundationVerificationGapDto: {
             repoName: string;
@@ -10801,7 +10836,7 @@ export interface components {
         /** @description Sort direction. */
         PaginationOrder: "asc" | "desc";
         /** @description Allowlisted repository sort field. */
-        ReadinessRepoSort: "repoName" | "overallScore" | "lastAnalyzed" | "language";
+        ReadinessRepoSort: "repoName" | "overallScore" | "lastAnalyzed" | "language" | "blockingRule";
         /** @description Allowlisted Code Insights repo sort field. */
         CodeInsightsRepoSort: "repoName" | "locTotal" | "ccAvg" | "dupPct" | "lastMeasuredAt";
         /** @description Case-insensitive substring filter on repo name / provider slug. */
@@ -11112,6 +11147,9 @@ 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 ReadinessBlockingRuleDto = components['schemas']['ReadinessBlockingRuleDto'];
+export type AgenticFoundationFixProofDto = components['schemas']['AgenticFoundationFixProofDto'];
+export type AgenticFoundationFixProofRowDto = components['schemas']['AgenticFoundationFixProofRowDto'];
 export type AgenticFoundationVerificationGapDto = components['schemas']['AgenticFoundationVerificationGapDto'];
 export type PageMetaDto = components['schemas']['PageMetaDto'];
 export type ReadinessEligibilityLimitsDto = components['schemas']['ReadinessEligibilityLimitsDto'];