@thinkai/tai-api-contract 2.99.0 → 2.101.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.99.0
+  version: 2.101.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -1537,6 +1537,80 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/productivity-targets:
+    get:
+      tags: [Workspace]
+      summary: Get Productivity Insights weekly per-engineer targets
+      description: >
+        Returns workspace-wide weekly per-engineer targets for Productivity Insights
+        (Merged PRs, Ship Weight, CI Failures). Empty object `{}` means no targets are set.
+        Member-level read access.
+      operationId: getWorkspaceProductivityTargets
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Current targets (may be empty)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ProductivityTargetsDto"
+        "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: [Workspace]
+      summary: Set Productivity Insights weekly per-engineer targets
+      description: >
+        Full-replace workspace-wide weekly per-engineer targets for Productivity Insights.
+        Omit a key or send `null` to unset that metric. `PUT {}` clears all three.
+        `0` is a valid CI Failures target (ceiling). Requires workspace **admin**
+        (editors receive `403` with `code: workspace_admin_required`).
+      operationId: putWorkspaceProductivityTargets
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ProductivityTargetsDto"
+      responses:
+        "204":
+          description: Targets persisted (or cleared).
+        "400":
+          description: Invalid payload (unknown keys or out-of-range values)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "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]
@@ -10559,6 +10633,32 @@ components:
             $ref: "#/components/schemas/RepoDeliveryOverrideDto"
           description: Per-service-repo overrides keyed by provider slug.
 
+    ProductivityTargetsDto:
+      type: object
+      description: >
+        Optional weekly per-engineer targets for Productivity Insights. Omitted or null
+        fields mean no target for that metric. Additional properties are rejected.
+      additionalProperties: false
+      properties:
+        mergedPrsPerEngineerPerWeek:
+          type: number
+          nullable: true
+          minimum: 0
+          maximum: 10000
+          description: Floor — meet or exceed this many merged PRs per engineer per week.
+        shipWeightPerEngineerPerWeek:
+          type: number
+          nullable: true
+          minimum: 0
+          maximum: 10000
+          description: Floor — meet or exceed this ship weight per engineer per week.
+        ciFailuresPerEngineerPerWeek:
+          type: number
+          nullable: true
+          minimum: 0
+          maximum: 10000
+          description: Ceiling — stay at or below this many CI failures per engineer per week. `0` is valid.
+
     TestConnectionResponseDto:
       type: object
       required: [success]
@@ -18439,11 +18539,15 @@ components:
           error_handling,
           config_cohesion,
           resilience_patterns,
+          circular_deps,
+          fan_in_hotspot,
         ]
       description: >
         Deterministic categories (`duplication`, `complexity`, `proliferation`,
-        `coverage`) plus LLM semantic detectors (`anemic_domain`, `context_leak`,
-        `tx_boundary`, `error_handling`, `config_cohesion`, `resilience_patterns`).
+        `coverage`, `circular_deps`, `fan_in_hotspot`) plus LLM semantic detectors
+        (`anemic_domain`, `context_leak`, `tx_boundary`, `error_handling`,
+        `config_cohesion`, `resilience_patterns`). Coupling categories are written
+        only by Design risks runs (`source=deterministic` on the design run id).
 
     CodeInsightsFindingSource:
       type: string

package/package.json

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

package/src/generated/openapi.ts

@@ -582,6 +582,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/productivity-targets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Productivity Insights weekly per-engineer targets
+         * @description Returns workspace-wide weekly per-engineer targets for Productivity Insights (Merged PRs, Ship Weight, CI Failures). Empty object `{}` means no targets are set. Member-level read access.
+         */
+        get: operations["getWorkspaceProductivityTargets"];
+        /**
+         * Set Productivity Insights weekly per-engineer targets
+         * @description Full-replace workspace-wide weekly per-engineer targets for Productivity Insights. Omit a key or send `null` to unset that metric. `PUT {}` clears all three. `0` is a valid CI Failures target (ceiling). Requires workspace **admin** (editors receive `403` with `code: workspace_admin_required`).
+         */
+        put: operations["putWorkspaceProductivityTargets"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/sources": {
         parameters: {
             query?: never;
@@ -4254,6 +4278,15 @@ export interface components {
                 [key: string]: components["schemas"]["RepoDeliveryOverrideDto"];
             };
         };
+        /** @description Optional weekly per-engineer targets for Productivity Insights. Omitted or null fields mean no target for that metric. Additional properties are rejected. */
+        ProductivityTargetsDto: {
+            /** @description Floor — meet or exceed this many merged PRs per engineer per week. */
+            mergedPrsPerEngineerPerWeek?: number | null;
+            /** @description Floor — meet or exceed this ship weight per engineer per week. */
+            shipWeightPerEngineerPerWeek?: number | null;
+            /** @description Ceiling — stay at or below this many CI failures per engineer per week. `0` is valid. */
+            ciFailuresPerEngineerPerWeek?: number | null;
+        };
         TestConnectionResponseDto: {
             success: boolean;
             /** @description Machine-readable failure code when success=false (e.g. invalid_token, zenhr_sync_in_progress when ZenHR OAuth refresh is contended). */
@@ -8086,10 +8119,10 @@ export interface components {
         /** @enum {string} */
         CodeInsightsFindingSeverity: "critical" | "high" | "medium" | "low";
         /**
-         * @description Deterministic categories (`duplication`, `complexity`, `proliferation`, `coverage`) plus LLM semantic detectors (`anemic_domain`, `context_leak`, `tx_boundary`, `error_handling`, `config_cohesion`, `resilience_patterns`).
+         * @description Deterministic categories (`duplication`, `complexity`, `proliferation`, `coverage`, `circular_deps`, `fan_in_hotspot`) plus LLM semantic detectors (`anemic_domain`, `context_leak`, `tx_boundary`, `error_handling`, `config_cohesion`, `resilience_patterns`). Coupling categories are written only by Design risks runs (`source=deterministic` on the design run id).
          * @enum {string}
          */
-        CodeInsightsFindingCategory: "duplication" | "complexity" | "proliferation" | "coverage" | "anemic_domain" | "context_leak" | "tx_boundary" | "error_handling" | "config_cohesion" | "resilience_patterns";
+        CodeInsightsFindingCategory: "duplication" | "complexity" | "proliferation" | "coverage" | "anemic_domain" | "context_leak" | "tx_boundary" | "error_handling" | "config_cohesion" | "resilience_patterns" | "circular_deps" | "fan_in_hotspot";
         /**
          * @description `deterministic` = measured Code Insights rules; `llm` = AI-detected semantic findings (separate agent pass; never blended in scoring).
          * @enum {string}
@@ -8426,6 +8459,7 @@ export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
 export type DeliveryRoleConfigDto = components['schemas']['DeliveryRoleConfigDto'];
 export type RepoDeliveryOverrideDto = components['schemas']['RepoDeliveryOverrideDto'];
 export type DeliveryTopologyDto = components['schemas']['DeliveryTopologyDto'];
+export type ProductivityTargetsDto = components['schemas']['ProductivityTargetsDto'];
 export type TestConnectionResponseDto = components['schemas']['TestConnectionResponseDto'];
 export type CursorKeyUsageDto = components['schemas']['CursorKeyUsageDto'];
 export type AiToolSeatDto = components['schemas']['AiToolSeatDto'];
@@ -10425,6 +10459,91 @@ export interface operations {
             };
         };
     };
+    getWorkspaceProductivityTargets: {
+        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"]["ProductivityTargetsDto"];
+                };
+            };
+            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"];
+                };
+            };
+        };
+    };
+    putWorkspaceProductivityTargets: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductivityTargetsDto"];
+            };
+        };
+        responses: {
+            /** @description Targets persisted (or cleared). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid payload (unknown keys or out-of-range values) */
+            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;