@thinkai/tai-api-contract 2.133.0 → 2.134.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.133.0
+  version: 2.134.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -16055,6 +16055,90 @@ components:
             `platform_env_key`: ThinkAI platform key was used (opt-in required; additional cost applies).
             `null`: run did not reach the Cursor agent stage.
 
+    CriterionEvidenceKind:
+      type: string
+      enum: [in_repo, linked_platform]
+      description: >
+        Where a CI setup criterion's evidence came from.
+        `in_repo` — this repository's CI config contributed.
+        `linked_platform` — a linked CI templates platform repo (role `ci_templates`
+        or the `jenkins_shared` alias) contributed.
+
+    CriterionEvidenceSourceDto:
+      type: object
+      additionalProperties: false
+      required: [kind, label]
+      description: >
+        One evidence chip for a CI setup criterion (CI on change, CI runs build,
+        CI runs tests, CI static analysis). `role` and `providerSlug` are present
+        when `kind` is `linked_platform` and omitted for `in_repo`.
+      properties:
+        kind:
+          $ref: "#/components/schemas/CriterionEvidenceKind"
+        label:
+          type: string
+          minLength: 1
+          maxLength: 256
+          description: Chip text shown in the UI (for example "In this repo" or "CI templates · org/platform-ci").
+        role:
+          type: string
+          minLength: 1
+          maxLength: 64
+          description: >
+            Topology role when `kind` is `linked_platform` (for example `ci_templates`
+            or `jenkins_shared`). Omit for `in_repo`.
+        providerSlug:
+          type: string
+          minLength: 1
+          maxLength: 256
+          description: >
+            Platform repository `owner/name` when `kind` is `linked_platform`. Omit for `in_repo`.
+
+    ScanImprovementCode:
+      type: string
+      enum:
+        - configure_linked_ci_templates
+        - scan_linked_ci_templates
+        - view_ci_health_in_insights
+      description: >
+        Stable "Improve this scan" code for Agentic Foundation CI setup honesty.
+        `configure_linked_ci_templates` — map a linked CI templates repo.
+        `scan_linked_ci_templates` — the mapped platform repo still needs a fresh scan.
+        `view_ci_health_in_insights` — CI config is present; live pass/fail health is in SDLC Insights.
+
+    ScanImprovementDto:
+      type: object
+      additionalProperties: false
+      required: [code, title, description]
+      description: >
+        One repo-level recommendation on a readiness scorecard. Display copy is
+        `title` and `description`; clients may also route from `code`.
+      properties:
+        code:
+          $ref: "#/components/schemas/ScanImprovementCode"
+        title:
+          type: string
+          minLength: 1
+          maxLength: 256
+        description:
+          type: string
+          minLength: 1
+          maxLength: 1024
+        href:
+          type: string
+          minLength: 1
+          maxLength: 512
+          description: >
+            Optional SPA path for the recommendation (linked-platform settings or
+            SDLC Insights). Not a scored URL.
+        providerSlug:
+          type: string
+          minLength: 1
+          maxLength: 256
+          description: >
+            Platform repository `owner/name` when the recommendation names a specific
+            linked repo (typically `scan_linked_ci_templates`).
+
     CriterionDetailDto:
       type: object
       required: [rubricId, title, status, severity]
@@ -16098,6 +16182,16 @@ components:
             UUID of the linked open issue in tai_workspace_repo_issues.
             Present only for gap/partial criteria that have a corresponding issue row.
             Use this to navigate to the Fix flow.
+        evidenceUsed:
+          type: array
+          minItems: 1
+          description: >
+            Sources that contributed to CI setup criteria (CI on change, CI runs build,
+            CI runs tests, CI static analysis). Met or Partial on those rows includes
+            at least one entry (`in_repo` and/or `linked_platform`). Omitted on other
+            criteria and when the scan did not record evidence.
+          items:
+            $ref: "#/components/schemas/CriterionEvidenceSourceDto"
 
     ReadinessCriteriaSummaryDto:
       type: object
@@ -16963,6 +17057,16 @@ components:
             (terraform/gitops/ci_templates/api_contracts, from the workspace delivery topology)
             are still missing scan evidence. Absent/null when no topology is configured or every
             declared role has fresh metadata (`complete: true`).
+        scanImprovements:
+          type: array
+          minItems: 1
+          maxItems: 3
+          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.
+          items:
+            $ref: "#/components/schemas/ScanImprovementDto"
 
     LinkedRolePendingDto:
       type: object
@@ -17134,6 +17238,13 @@ components:
           allOf:
             - $ref: "#/components/schemas/LinkedRoleAssessmentDto"
           description: See RepoReadinessScoreDto.linkedRoleAssessment.
+        scanImprovements:
+          type: array
+          minItems: 1
+          maxItems: 3
+          description: See RepoReadinessScoreDto.scanImprovements.
+          items:
+            $ref: "#/components/schemas/ScanImprovementDto"
 
     AgenticFoundationDashboardSummaryDto:
       type: object

package/package.json

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

package/src/generated/openapi.ts

@@ -6875,6 +6875,36 @@ export interface components {
              */
             cursorKeySource?: "workspace_execution_token" | "platform_env_key" | null;
         };
+        /**
+         * @description Where a CI setup criterion's evidence came from. `in_repo` — this repository's CI config contributed. `linked_platform` — a linked CI templates platform repo (role `ci_templates` or the `jenkins_shared` alias) contributed.
+         * @enum {string}
+         */
+        CriterionEvidenceKind: "in_repo" | "linked_platform";
+        /** @description One evidence chip for a CI setup criterion (CI on change, CI runs build, CI runs tests, CI static analysis). `role` and `providerSlug` are present when `kind` is `linked_platform` and omitted for `in_repo`. */
+        CriterionEvidenceSourceDto: {
+            kind: components["schemas"]["CriterionEvidenceKind"];
+            /** @description Chip text shown in the UI (for example "In this repo" or "CI templates · org/platform-ci"). */
+            label: string;
+            /** @description Topology role when `kind` is `linked_platform` (for example `ci_templates` or `jenkins_shared`). Omit for `in_repo`. */
+            role?: string;
+            /** @description Platform repository `owner/name` when `kind` is `linked_platform`. Omit for `in_repo`. */
+            providerSlug?: string;
+        };
+        /**
+         * @description Stable "Improve this scan" code for Agentic Foundation CI setup honesty. `configure_linked_ci_templates` — map a linked CI templates repo. `scan_linked_ci_templates` — the mapped platform repo still needs a fresh scan. `view_ci_health_in_insights` — CI config is present; live pass/fail health is in SDLC Insights.
+         * @enum {string}
+         */
+        ScanImprovementCode: "configure_linked_ci_templates" | "scan_linked_ci_templates" | "view_ci_health_in_insights";
+        /** @description One repo-level recommendation on a readiness scorecard. Display copy is `title` and `description`; clients may also route from `code`. */
+        ScanImprovementDto: {
+            code: components["schemas"]["ScanImprovementCode"];
+            title: string;
+            description: string;
+            /** @description Optional SPA path for the recommendation (linked-platform settings or SDLC Insights). Not a scored URL. */
+            href?: string;
+            /** @description Platform repository `owner/name` when the recommendation names a specific linked repo (typically `scan_linked_ci_templates`). */
+            providerSlug?: string;
+        };
         CriterionDetailDto: {
             /** @description Rubric criterion id (e.g. A1, B3) */
             rubricId: string;
@@ -6901,6 +6931,8 @@ export interface components {
              * @description UUID of the linked open issue in tai_workspace_repo_issues. Present only for gap/partial criteria that have a corresponding issue row. Use this to navigate to the Fix flow.
              */
             issueId?: string | null;
+            /** @description Sources that contributed to CI setup criteria (CI on change, CI runs build, CI runs tests, CI static analysis). Met or Partial on those rows includes at least one entry (`in_repo` and/or `linked_platform`). Omitted on other criteria and when the scan did not record evidence. */
+            evidenceUsed?: components["schemas"]["CriterionEvidenceSourceDto"][];
         };
         ReadinessCriteriaSummaryDto: {
             total: number;
@@ -7268,6 +7300,8 @@ export interface components {
             platformArchetype?: "terraform_platform" | "gitops_platform" | "ci_templates" | "api_contracts_platform" | null;
             /** @description Federated readiness completeness for service repos: which linked platform roles (terraform/gitops/ci_templates/api_contracts, from the workspace delivery topology) are still missing scan evidence. Absent/null when no topology is configured or every declared role has fresh metadata (`complete: true`). */
             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"][];
         };
         LinkedRolePendingDto: {
             /** @description Topology role key, e.g. terraform | gitops | ci_templates | api_contracts. */
@@ -7346,6 +7380,8 @@ export interface components {
             platformArchetype?: "terraform_platform" | "gitops_platform" | "ci_templates" | "api_contracts_platform" | null;
             /** @description See RepoReadinessScoreDto.linkedRoleAssessment. */
             linkedRoleAssessment?: components["schemas"]["LinkedRoleAssessmentDto"] | null;
+            /** @description See RepoReadinessScoreDto.scanImprovements. */
+            scanImprovements?: components["schemas"]["ScanImprovementDto"][];
         };
         AgenticFoundationDashboardSummaryDto: {
             repoCount: number;
@@ -10264,6 +10300,10 @@ export type ReadinessAnalyzeResponseDto = components['schemas']['ReadinessAnalyz
 export type ReadinessRunStatusDto = components['schemas']['ReadinessRunStatusDto'];
 export type ReadinessRepoAnalysisStatusDto = components['schemas']['ReadinessRepoAnalysisStatusDto'];
 export type ReadinessRunSummaryDto = components['schemas']['ReadinessRunSummaryDto'];
+export type CriterionEvidenceKind = components['schemas']['CriterionEvidenceKind'];
+export type CriterionEvidenceSourceDto = components['schemas']['CriterionEvidenceSourceDto'];
+export type ScanImprovementCode = components['schemas']['ScanImprovementCode'];
+export type ScanImprovementDto = components['schemas']['ScanImprovementDto'];
 export type CriterionDetailDto = components['schemas']['CriterionDetailDto'];
 export type ReadinessCriteriaSummaryDto = components['schemas']['ReadinessCriteriaSummaryDto'];
 export type ReadinessIssueDto = components['schemas']['ReadinessIssueDto'];