@thinkai/tai-api-contract 2.157.0 → 2.159.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.157.0
+  version: 2.159.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
@@ -18357,19 +18366,25 @@ components:
           type: string
           format: date-time
           nullable: true
-          description: Set when the repo has been soft-archived (removed from installation or integration disconnected). Null means active.
+          description: Set when the repo has been soft-archived (removed from installation, archived on GitHub, or integration disconnected). Null means active.
         archivedReason:
           type: string
           nullable: true
           enum:
             [
+              github_archived,
               github_removed,
               installation_disconnected,
               installation_replaced,
               superseded,
               user_removed,
             ]
-          description: Why the repo was archived. `user_removed` means excluded from Agentic Foundation scope only. Only present when `archivedAt` is set.
+          description: >
+            Why the repo was archived. `github_archived` means the repo is still granted by the
+            GitHub installation but GitHub reports `archived === true` (default sync excludes it).
+            `github_removed` means the slug is no longer in the installation listing.
+            `user_removed` means excluded from Agentic Foundation scope only. Only present when
+            `archivedAt` is set.
         eligibilityStatus:
           type: string
           enum: [eligible, ineligible]
@@ -18471,6 +18486,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
@@ -18576,12 +18600,14 @@ components:
           nullable: true
           enum:
             [
+              github_archived,
               github_removed,
               installation_disconnected,
               installation_replaced,
               superseded,
               user_removed,
             ]
+          description: See RepoReadinessScoreDto.archivedReason.
         eligibilityStatus:
           type: string
           enum: [eligible, ineligible]
@@ -18649,10 +18675,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 +18747,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.159.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -7790,14 +7790,14 @@ export interface components {
             lastRunErrorDetail?: string | null;
             /**
              * Format: date-time
-             * @description Set when the repo has been soft-archived (removed from installation or integration disconnected). Null means active.
+             * @description Set when the repo has been soft-archived (removed from installation, archived on GitHub, or integration disconnected). Null means active.
              */
             archivedAt?: string | null;
             /**
-             * @description Why the repo was archived. `user_removed` means excluded from Agentic Foundation scope only. Only present when `archivedAt` is set.
+             * @description Why the repo was archived. `github_archived` means the repo is still granted by the GitHub installation but GitHub reports `archived === true` (default sync excludes it). `github_removed` means the slug is no longer in the installation listing. `user_removed` means excluded from Agentic Foundation scope only. Only present when `archivedAt` is set.
              * @enum {string|null}
              */
-            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
+            archivedReason?: "github_archived" | "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
             /**
              * @description Whether the repo can be analyzed (#44/#729). Language support no longer makes a repo `ineligible` — a missing v1-supported stack is surfaced via `warnings` and the repo stays analyzable. It becomes `ineligible` when the most recent scan hit a hard size/file-count limit (e.g. code-size or file-count exceeded): the repo is then restricted here too so this surface matches the GitHub connect list's size gate after the scan. Null until the first sync/scan computes it.
              * @enum {string|null}
@@ -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. */
@@ -7880,8 +7882,11 @@ export interface components {
             lastRunErrorDetail?: string | null;
             /** Format: date-time */
             archivedAt?: string | null;
-            /** @enum {string|null} */
-            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
+            /**
+             * @description See RepoReadinessScoreDto.archivedReason.
+             * @enum {string|null}
+             */
+            archivedReason?: "github_archived" | "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
             /**
              * @description See RepoReadinessScoreDto.eligibilityStatus. Language support is advisory (#729) and surfaced via `warnings`.
              * @enum {string|null}
@@ -7915,6 +7920,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 +7943,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 +10839,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 +11150,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'];