@thinkai/tai-api-contract 2.200.0 → 2.202.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.200.0
+  version: 2.202.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -2921,6 +2921,99 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/agentic-foundation/dimension-targets:
+    get:
+      tags: [AIReadiness]
+      summary: Get Agentic Foundation dimension settings
+      description: >
+        Workspace `disabledDimensions` (scoring off workspace-wide), target percent per
+        readiness dimension, plus optional per-repository overrides. Omitted targets mean
+        100. A repository override may disable scoring for a dimension and set its own
+        target; it cannot re-enable a workspace-disabled dimension. Empty object means
+        every dimension is scored at 100. Member-level read access.
+      operationId: getWorkspaceDimensionTargets
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Current targets (may be empty)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DimensionTargetsDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+    put:
+      tags: [AIReadiness]
+      summary: Set Agentic Foundation dimension settings
+      description: >
+        Full-replace workspace dimension settings and repository overrides.
+        `disabledDimensions` turns scoring off for those dimensions workspace-wide.
+        Omit a target or send 100 to keep the default. `PUT {}` or `null` clears
+        settings so every dimension is scored at 100. Repository ids must be in
+        Agentic Foundation scan scope. Requires workspace **admin**.
+      operationId: putWorkspaceDimensionTargets
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/DimensionTargetsDto"
+            examples:
+              workspaceAndRepo:
+                value:
+                  disabledDimensions: [delivery]
+                  targets:
+                    observability: 90
+                  repoOverrides:
+                    11111111-1111-4111-8111-111111111111:
+                      disabledDimensions: [observability]
+                      targets:
+                        tests-qa: 80
+      responses:
+        "204":
+          description: Targets persisted (or cleared).
+        "400":
+          description: Invalid payload or repository is not in scan scope
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              examples:
+                invalidDimensionTargets:
+                  value:
+                    error: "observability must be an integer from 0 to 100"
+                    code: invalid_dimension_targets
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Forbidden — workspace admin required
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              examples:
+                workspaceAdminRequired:
+                  value:
+                    error: Forbidden
+                    code: workspace_admin_required
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/sources:
     put:
       tags: [Workspace]
@@ -16810,6 +16903,93 @@ components:
           maximum: 10000
           description: Ceiling — stay at or below this many CI failures per engineer per week. `0` is valid.
 
+    DimensionTargetPercentsDto:
+      type: object
+      additionalProperties: false
+      description: Omitted dimension means a target of 100. Values of 100 are not stored.
+      properties:
+        ai-agent-readiness:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        token-efficiency:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        repo-hygiene:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        stack-quality:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        tests-qa:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        observability:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        api-contracts:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        platform-governance:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+        delivery:
+          type: integer
+          nullable: true
+          minimum: 0
+          maximum: 100
+
+    DimensionTargetsRepoOverrideDto:
+      type: object
+      additionalProperties: false
+      properties:
+        disabledDimensions:
+          type: array
+          uniqueItems: true
+          items:
+            $ref: "#/components/schemas/ReadinessDimensionId"
+          description: Dimensions left out of this repository's score.
+        targets:
+          $ref: "#/components/schemas/DimensionTargetPercentsDto"
+
+    DimensionTargetsDto:
+      type: object
+      additionalProperties: false
+      description: >
+        Agentic Foundation dimension settings. Empty object means every dimension is
+        scored and the target is 100.
+      properties:
+        disabledDimensions:
+          type: array
+          uniqueItems: true
+          items:
+            $ref: "#/components/schemas/ReadinessDimensionId"
+          description: >
+            Dimensions left out of readiness scores for every repository in the
+            workspace. Repository overrides may disable additional dimensions.
+        targets:
+          $ref: "#/components/schemas/DimensionTargetPercentsDto"
+        repoOverrides:
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/DimensionTargetsRepoOverrideDto"
+          description: Keys are in-scope repository ids.
+
     AiEmailAliasEntryDto:
       type: object
       required: [canonicalEmail, aliasEmail]

package/openapi/x-test-status-map.json

@@ -281,6 +281,16 @@
       "method": "PUT",
       "path": "/workspaces/{workspaceId}/productivity-targets"
     },
+    "getWorkspaceDimensionTargets": {
+      "status": "implemented",
+      "method": "GET",
+      "path": "/workspaces/{workspaceId}/agentic-foundation/dimension-targets"
+    },
+    "putWorkspaceDimensionTargets": {
+      "status": "implemented",
+      "method": "PUT",
+      "path": "/workspaces/{workspaceId}/agentic-foundation/dimension-targets"
+    },
     "putTenantSources": {
       "status": "implemented",
       "method": "PUT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.200.0",
+  "version": "2.202.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -20,8 +20,8 @@
   },
   "devDependencies": {
     "@stoplight/spectral-cli": "^6.17.0",
-    "@types/node": "^26.6.5",
-    "jsonpath-plus": "^11.2.1",
+    "@types/node": "^26.6.6",
+    "jsonpath-plus": "^11.2.2",
     "openapi-typescript": "^7.13.0",
     "typescript": "~6.0.3"
   },

package/src/generated/openapi.ts

@@ -943,6 +943,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/agentic-foundation/dimension-targets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Agentic Foundation dimension settings
+         * @description Workspace `disabledDimensions` (scoring off workspace-wide), target percent per readiness dimension, plus optional per-repository overrides. Omitted targets mean 100. A repository override may disable scoring for a dimension and set its own target; it cannot re-enable a workspace-disabled dimension. Empty object means every dimension is scored at 100. Member-level read access.
+         */
+        get: operations["getWorkspaceDimensionTargets"];
+        /**
+         * Set Agentic Foundation dimension settings
+         * @description Full-replace workspace dimension settings and repository overrides. `disabledDimensions` turns scoring off for those dimensions workspace-wide. Omit a target or send 100 to keep the default. `PUT {}` or `null` clears settings so every dimension is scored at 100. Repository ids must be in Agentic Foundation scan scope. Requires workspace **admin**.
+         */
+        put: operations["putWorkspaceDimensionTargets"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/sources": {
         parameters: {
             query?: never;
@@ -6516,6 +6540,33 @@ export interface components {
             /** @description Ceiling — stay at or below this many CI failures per engineer per week. `0` is valid. */
             ciFailuresPerEngineerPerWeek?: number | null;
         };
+        /** @description Omitted dimension means a target of 100. Values of 100 are not stored. */
+        DimensionTargetPercentsDto: {
+            "ai-agent-readiness"?: number | null;
+            "token-efficiency"?: number | null;
+            "repo-hygiene"?: number | null;
+            "stack-quality"?: number | null;
+            "tests-qa"?: number | null;
+            observability?: number | null;
+            "api-contracts"?: number | null;
+            "platform-governance"?: number | null;
+            delivery?: number | null;
+        };
+        DimensionTargetsRepoOverrideDto: {
+            /** @description Dimensions left out of this repository's score. */
+            disabledDimensions?: components["schemas"]["ReadinessDimensionId"][];
+            targets?: components["schemas"]["DimensionTargetPercentsDto"];
+        };
+        /** @description Agentic Foundation dimension settings. Empty object means every dimension is scored and the target is 100. */
+        DimensionTargetsDto: {
+            /** @description Dimensions left out of readiness scores for every repository in the workspace. Repository overrides may disable additional dimensions. */
+            disabledDimensions?: components["schemas"]["ReadinessDimensionId"][];
+            targets?: components["schemas"]["DimensionTargetPercentsDto"];
+            /** @description Keys are in-scope repository ids. */
+            repoOverrides?: {
+                [key: string]: components["schemas"]["DimensionTargetsRepoOverrideDto"];
+            };
+        };
         AiEmailAliasEntryDto: {
             /**
              * Format: email
@@ -13316,6 +13367,9 @@ export type AiModelPolicyConfigDto = components['schemas']['AiModelPolicyConfigD
 export type AiModelPolicyPersonOverrideDto = components['schemas']['AiModelPolicyPersonOverrideDto'];
 export type AiModelPolicyDto = components['schemas']['AiModelPolicyDto'];
 export type ProductivityTargetsDto = components['schemas']['ProductivityTargetsDto'];
+export type DimensionTargetPercentsDto = components['schemas']['DimensionTargetPercentsDto'];
+export type DimensionTargetsRepoOverrideDto = components['schemas']['DimensionTargetsRepoOverrideDto'];
+export type DimensionTargetsDto = components['schemas']['DimensionTargetsDto'];
 export type AiEmailAliasEntryDto = components['schemas']['AiEmailAliasEntryDto'];
 export type AiEmailAliasesDto = components['schemas']['AiEmailAliasesDto'];
 export type TestConnectionResponseDto = components['schemas']['TestConnectionResponseDto'];
@@ -16871,6 +16925,91 @@ export interface operations {
             };
         };
     };
+    getWorkspaceDimensionTargets: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current targets (may be empty) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DimensionTargetsDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putWorkspaceDimensionTargets: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DimensionTargetsDto"];
+            };
+        };
+        responses: {
+            /** @description Targets persisted (or cleared). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid payload or repository is not in scan scope */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Forbidden — workspace admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     putTenantSources: {
         parameters: {
             query?: never;