@thinkai/tai-api-contract 2.100.0 → 2.102.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.100.0
+  version: 2.102.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]
@@ -18559,6 +18659,22 @@ components:
           type: array
           items: { type: string }
           description: Subset of `god_file`, `high_cc`, `long_params`, `deep_nesting`.
+        peakFunction:
+          type: string
+          nullable: true
+          description: Name of the function that owns `ccMax` (lizard). Null on snapshots taken before peak-function capture.
+        peakStartLine:
+          type: integer
+          nullable: true
+          description: 1-based start line of `peakFunction`.
+        peakEndLine:
+          type: integer
+          nullable: true
+          description: 1-based end line of `peakFunction`.
+        peakParams:
+          type: integer
+          nullable: true
+          description: Parameter count of `peakFunction` (not file-wide `paramsMax`). Null on older snapshots.
 
     CodeInsightsFindingDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.100.0",
+  "version": "2.102.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). */
@@ -8145,6 +8178,14 @@ export interface components {
             dupPct?: number | null;
             /** @description Subset of `god_file`, `high_cc`, `long_params`, `deep_nesting`. */
             flags: string[];
+            /** @description Name of the function that owns `ccMax` (lizard). Null on snapshots taken before peak-function capture. */
+            peakFunction?: string | null;
+            /** @description 1-based start line of `peakFunction`. */
+            peakStartLine?: number | null;
+            /** @description 1-based end line of `peakFunction`. */
+            peakEndLine?: number | null;
+            /** @description Parameter count of `peakFunction` (not file-wide `paramsMax`). Null on older snapshots. */
+            peakParams?: number | null;
         };
         CodeInsightsFindingDto: {
             /** Format: uuid */
@@ -8426,6 +8467,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 +10467,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;