@thinkai/tai-api-contract 2.133.0 → 2.135.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.133.0
+  version: 2.135.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -4219,6 +4219,79 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/company-profile/logo:
+    put:
+      tags: [CompanyProfile]
+      summary: Upload company logo
+      operationId: putCompanyProfileLogo
+      description: >
+        Scales the uploaded PNG, JPEG, or WebP to a 128×128 WebP (the mark is fitted inside
+        the square with transparent padding) and stores that image. Requires a saved company
+        profile. Editor or admin only. Source images larger than 2 MB decoded are rejected.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CompanyProfileLogoPutDto"
+      responses:
+        "200":
+          description: Stored 128×128 WebP
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WorkspaceLogoDto"
+        "400":
+          description: Invalid image, unsupported type, or result still too large
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "409":
+          description: No company profile saved yet (`company_profile_required`)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+    delete:
+      tags: [CompanyProfile]
+      summary: Remove company logo
+      operationId: deleteCompanyProfileLogo
+      description: Clears the stored logo. Editor or admin only. Succeeds when no logo is stored.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "204":
+          description: Logo cleared
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "409":
+          description: No company profile saved yet (`company_profile_required`)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/integrations/connectors-snapshot:
     get:
       tags: [Integrations]
@@ -14644,6 +14717,39 @@ components:
           type: string
           enum: [admin, editor, viewer]
           description: Caller's role in this workspace (from tai_workspace_members).
+        logo:
+          type: object
+          nullable: true
+          description: >
+            Square 128px WebP for the workspace switcher. Omitted or null when no logo is stored.
+          allOf:
+            - $ref: "#/components/schemas/WorkspaceLogoDto"
+
+    WorkspaceLogoDto:
+      type: object
+      required: [contentType, data]
+      properties:
+        contentType:
+          type: string
+          enum: [image/webp]
+        data:
+          type: string
+          minLength: 1
+          maxLength: 48000
+          description: Base64-encoded 128×128 WebP. No data-URL prefix.
+
+    CompanyProfileLogoPutDto:
+      type: object
+      required: [contentType, data]
+      properties:
+        contentType:
+          type: string
+          enum: [image/png, image/jpeg, image/webp]
+        data:
+          type: string
+          minLength: 1
+          maxLength: 2800000
+          description: Base64-encoded source image, at most 2 MB after decoding.
 
     WorkspacesForUserDto:
       type: object
@@ -14680,6 +14786,14 @@ components:
           type: string
         headquarters:
           type: string
+        logo:
+          type: object
+          nullable: true
+          description: >
+            Present on GET when a logo is stored. Ignored by PUT /company-profile.
+            Upload and delete use the /company-profile/logo routes.
+          allOf:
+            - $ref: "#/components/schemas/WorkspaceLogoDto"
 
     GithubAccountDto:
       type: object
@@ -16055,6 +16169,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 +16296,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 +17171,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 +17352,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.135.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -1515,6 +1515,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/company-profile/logo": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Upload company logo
+         * @description Scales the uploaded PNG, JPEG, or WebP to a 128×128 WebP (the mark is fitted inside the square with transparent padding) and stores that image. Requires a saved company profile. Editor or admin only. Source images larger than 2 MB decoded are rejected.
+         */
+        put: operations["putCompanyProfileLogo"];
+        post?: never;
+        /**
+         * Remove company logo
+         * @description Clears the stored logo. Editor or admin only. Succeeds when no logo is stored.
+         */
+        delete: operations["deleteCompanyProfileLogo"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/connectors-snapshot": {
         parameters: {
             query?: never;
@@ -6211,6 +6235,20 @@ export interface components {
              * @enum {string}
              */
             role: "admin" | "editor" | "viewer";
+            /** @description Square 128px WebP for the workspace switcher. Omitted or null when no logo is stored. */
+            logo?: components["schemas"]["WorkspaceLogoDto"] | null;
+        };
+        WorkspaceLogoDto: {
+            /** @enum {string} */
+            contentType: "image/webp";
+            /** @description Base64-encoded 128×128 WebP. No data-URL prefix. */
+            data: string;
+        };
+        CompanyProfileLogoPutDto: {
+            /** @enum {string} */
+            contentType: "image/png" | "image/jpeg" | "image/webp";
+            /** @description Base64-encoded source image, at most 2 MB after decoding. */
+            data: string;
         };
         WorkspacesForUserDto: {
             workspaces: components["schemas"]["WorkspaceSummaryDto"][];
@@ -6227,6 +6265,8 @@ export interface components {
             companySize: string;
             engineeringHC: string;
             headquarters: string;
+            /** @description Present on GET when a logo is stored. Ignored by PUT /company-profile. Upload and delete use the /company-profile/logo routes. */
+            logo?: components["schemas"]["WorkspaceLogoDto"] | null;
         };
         GithubAccountDto: {
             login: string;
@@ -6875,6 +6915,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 +6971,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 +7340,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 +7420,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;
@@ -10206,6 +10282,8 @@ export type FulfillPersonErasureBodyDto = components['schemas']['FulfillPersonEr
 export type PrivacyRequestPersonErasureResultDto = components['schemas']['PrivacyRequestPersonErasureResultDto'];
 export type PrivacyRequestExportDto = components['schemas']['PrivacyRequestExportDto'];
 export type WorkspaceSummaryDto = components['schemas']['WorkspaceSummaryDto'];
+export type WorkspaceLogoDto = components['schemas']['WorkspaceLogoDto'];
+export type CompanyProfileLogoPutDto = components['schemas']['CompanyProfileLogoPutDto'];
 export type WorkspacesForUserDto = components['schemas']['WorkspacesForUserDto'];
 export type CreateWorkspaceBodyDto = components['schemas']['CreateWorkspaceBodyDto'];
 export type CompanyProfileDto = components['schemas']['CompanyProfileDto'];
@@ -10264,6 +10342,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'];
@@ -14861,6 +14943,101 @@ export interface operations {
             };
         };
     };
+    putCompanyProfileLogo: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CompanyProfileLogoPutDto"];
+            };
+        };
+        responses: {
+            /** @description Stored 128×128 WebP */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceLogoDto"];
+                };
+            };
+            /** @description Invalid image, unsupported type, or result still too large */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description No company profile saved yet (`company_profile_required`) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    deleteCompanyProfileLogo: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Logo cleared */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description No company profile saved yet (`company_profile_required`) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getWorkspaceConnectorsSnapshot: {
         parameters: {
             query?: never;