@thinkai/tai-api-contract 2.91.0 → 2.93.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.91.0
+  version: 2.93.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -1544,6 +1544,7 @@ paths:
                       - $ref: "#/components/schemas/CursorSourceDto"
                       - $ref: "#/components/schemas/ClaudeSourcePatchDto"
                       - $ref: "#/components/schemas/ClaudeSourceDto"
+                      - $ref: "#/components/schemas/CodeIntelligenceSourcePatchDto"
                       - $ref: "#/components/schemas/NewRelicSourceDto"
                       - $ref: "#/components/schemas/PrometheusSourceDto"
                       - $ref: "#/components/schemas/GrafanaSourceDto"
@@ -1661,6 +1662,7 @@ paths:
                 - $ref: "#/components/schemas/CursorSourceDto"
                 - $ref: "#/components/schemas/ClaudeSourcePatchDto"
                 - $ref: "#/components/schemas/ClaudeSourceDto"
+                - $ref: "#/components/schemas/CodeIntelligenceSourcePatchDto"
                 - $ref: "#/components/schemas/NewRelicSourceDto"
                 - $ref: "#/components/schemas/PrometheusSourceDto"
                 - $ref: "#/components/schemas/GrafanaSourceDto"
@@ -6805,7 +6807,54 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ErrorMessageDto"
+                type: object
+                required: [error]
+                properties:
+                  error: { type: string, example: invalid_body }
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+
+  /workspaces/{workspaceId}/code-intelligence:
+    put:
+      tags: [CodeChat]
+      summary: Update Code Intelligence workspace settings
+      description: >
+        Admin-only. Enables/disables Code Intelligence for the workspace, chooses whether to reuse
+        the Agent Execution key or a dedicated `code_intelligence` source credential, and optional
+        Cursor/Claude model overrides. Does not store secrets — use `PUT .../sources` with
+        `type: code_intelligence` and `executionToken` when key mode is `dedicated` (except
+        `thinkai_platform_cursor`, which uses the platform key). Preview UI remains behind `?code_kn=true`.
+      operationId: putCodeIntelligenceSettings
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PutCodeIntelligenceSettingsDto"
+      responses:
+        "200":
+          description: Settings updated
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+        "400":
+          description: Invalid request body
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [error]
+                properties:
+                  error: { type: string, example: invalid_body }
         "401":
           $ref: "#/components/responses/Unauthorized"
         "403":
@@ -9694,6 +9743,43 @@ components:
             Masked preview of the stored insights key (prefix + last four characters). Never
             includes the full secret.
 
+    CodeIntelligenceSourcePatchDto:
+      type: object
+      description: >
+        Dedicated Engineering Context Graph execution credential for
+        `PUT /workspaces/{workspaceId}/sources` when `codeIntelligenceKeyMode` is `dedicated`.
+        Provide `executionToken` (Cursor user/service key or Anthropic `sk-ant-api…`). Admin keys
+        are rejected. Reads from `GET /workspaces/{workspaceId}/config` redact the secret to
+        `hasExecutionToken` via `CodeIntelligenceSourceConfigDto`.
+      required: [type]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [code_intelligence]
+        executionToken:
+          type: string
+          minLength: 1
+          maxLength: 256
+          description: >
+            Execution key for wiki/chat LLM calls in dedicated key mode. Whitespace and `env:`
+            prefix are rejected.
+
+    CodeIntelligenceSourceConfigDto:
+      type: object
+      description: >
+        Redacted Engineering Context Graph source returned by `GET /workspaces/{workspaceId}/config`.
+        Raw `executionToken` values are never returned.
+      required: [type, hasExecutionToken]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [code_intelligence]
+        hasExecutionToken:
+          type: boolean
+          description: Whether a dedicated ECG execution token is stored for this workspace.
+
     NewRelicSourceDto:
       type: object
       description: >
@@ -9968,6 +10054,28 @@ components:
         - cursor_user_api_key
         - claude_api_key
 
+    PutCodeIntelligenceSettingsDto:
+      type: object
+      description: Partial update for Code Intelligence workspace settings (admin-only).
+      properties:
+        enabled:
+          type: boolean
+        keyMode:
+          type: string
+          enum: [reuse_agent_execution, dedicated]
+        provider:
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/AgentExecutionProviderDto"
+        cursorModel:
+          type: string
+          nullable: true
+          minLength: 1
+        claudeModel:
+          type: string
+          nullable: true
+          minLength: 1
+
     WorkspaceConfigDto:
       type: object
       required: [sources]
@@ -9978,6 +10086,7 @@ components:
             oneOf:
               - $ref: "#/components/schemas/CursorSourceConfigDto"
               - $ref: "#/components/schemas/ClaudeSourceConfigDto"
+              - $ref: "#/components/schemas/CodeIntelligenceSourceConfigDto"
               - $ref: "#/components/schemas/NewRelicSourceConfigDto"
               - $ref: "#/components/schemas/PrometheusSourceConfigDto"
               - $ref: "#/components/schemas/GrafanaSourceConfigDto"
@@ -10006,6 +10115,34 @@ components:
             The single active agent execution account for this workspace's readiness scanner and
             fix processor. Defaults to `cursor_user_api_key`. Change via
             `PUT /workspaces/{workspaceId}/agent-execution-provider`.
+        codeIntelligenceEnabled:
+          type: boolean
+          description: >
+            When false (default), Code Intelligence write APIs (`/code-chat/*` index/sync/wiki/messages)
+            return 403. Preview UI still requires `?code_kn=true`. Change via
+            `PUT /workspaces/{workspaceId}/code-intelligence`.
+        codeIntelligenceKeyMode:
+          type: string
+          enum: [reuse_agent_execution, dedicated]
+          description: >
+            `reuse_agent_execution` uses the workspace Agent Execution key. `dedicated` uses the
+            `code_intelligence` source token (or platform Cursor when provider is `thinkai_platform_cursor`).
+        codeIntelligenceProvider:
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/AgentExecutionProviderDto"
+          description: Active when `codeIntelligenceKeyMode` is `dedicated`. Null when reusing Agent Execution.
+        codeIntelligenceCursorModel:
+          type: string
+          nullable: true
+          description: Optional Cursor model override for Code Intelligence (null/empty → env default).
+        codeIntelligenceClaudeModel:
+          type: string
+          nullable: true
+          description: Optional Claude model override for Code Intelligence (null/empty → env default).
+        hasCodeIntelligenceExecutionToken:
+          type: boolean
+          description: True when a dedicated `code_intelligence` source has a stored executionToken.
 
     TestConnectionResponseDto:
       type: object
@@ -10275,6 +10412,14 @@ components:
         mergedPrCount:
           type: number
           minimum: 0
+        shipWeightSum:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for PRs merged on this day.
+        shipWeightPendingCount:
+          type: integer
+          minimum: 1
+          description: GitHub merged PRs on this day still awaiting ship-weight scoring.
         ciFailuresCount:
           type: integer
           minimum: 0
@@ -10310,6 +10455,14 @@ components:
           description: Short label for the week column (MM/DD), aligned with Measure charts.
         mergedPrCount:
           type: number
+        shipWeightSum:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for PRs merged in this week bucket.
+        shipWeightPendingCount:
+          type: integer
+          minimum: 1
+          description: GitHub merged PRs in this week bucket still awaiting ship-weight scoring.
         failRatePercent:
           type: number
           description: DORA change failure rate (deployments/incidents), not CI build failures.
@@ -10420,6 +10573,14 @@ components:
           description: Short label for the week column (MM/DD), aligned with Measure charts.
         mergedPrCount:
           type: number
+        shipWeightSum:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for PRs merged in this week bucket.
+        shipWeightPendingCount:
+          type: integer
+          minimum: 1
+          description: GitHub merged PRs in this week bucket still awaiting ship-weight scoring.
 
     ProductivityInsightsMergedPrContributorRowDto:
       type: object
@@ -10516,6 +10677,10 @@ components:
         periodAvgMergedPrs:
           type: number
           description: Average weekly merged PR count over the selected range.
+        periodAvgShipWeight:
+          type: number
+          minimum: 0
+          description: Average weekly ship-weight sum over the selected range.
         avgFailRatePercent:
           type: number
           description: Average change failure rate over the range when available.
@@ -10530,8 +10695,19 @@ components:
       properties:
         totalMergedPrs:
           type: number
+        totalShipWeight:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for merged PRs over the selected range.
+        shipWeightBackfillPending:
+          type: boolean
+          description: True when merged GitHub PRs in scope still lack ship-weight scores (ingest backfill in progress).
         avgMergedPrsPerWeek:
           type: number
+        avgShipWeightPerWeek:
+          type: number
+          minimum: 0
+          description: Mean weekly ship-weight sum over the selected range.
         avgFailRatePercent:
           type: number
           description: Average DORA change failure rate over the range when available.
@@ -10676,6 +10852,14 @@ components:
         mergedPrCount:
           type: integer
           minimum: 0
+        shipWeightSum:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for PRs merged on this day.
+        shipWeightPendingCount:
+          type: integer
+          minimum: 1
+          description: GitHub merged PRs on this day still awaiting ship-weight scoring.
         mergedPrs:
           type: array
           items:
@@ -10767,8 +10951,19 @@ components:
         totalMergedPrs:
           type: integer
           minimum: 0
+        totalShipWeight:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for merged PRs over the selected range.
+        shipWeightBackfillPending:
+          type: boolean
+          description: True when merged GitHub PRs in scope still lack ship-weight scores (ingest backfill in progress).
         avgMergedPrsPerWeek:
           type: number
+        avgShipWeightPerWeek:
+          type: number
+          minimum: 0
+          description: Mean weekly ship-weight sum over the selected range.
         totalAbsenceDays:
           type: integer
           minimum: 0
@@ -10780,8 +10975,14 @@ components:
           description: Average GitHub Actions CI build failure rate over the range when CI ingest is enabled.
         mergedPrDelta:
           type: number
+        shipWeightDelta:
+          type: number
+          description: Change in total ship-weight sum vs the prior comparison window.
         avgMergedPrsPerWeekDelta:
           type: number
+        avgShipWeightPerWeekDelta:
+          type: number
+          description: Change in mean weekly ship-weight sum vs the prior comparison window.
         totalAbsenceDaysDelta:
           type: number
         avgFailRateDelta:
@@ -10872,6 +11073,10 @@ components:
         periodAvgMergedPrs:
           type: number
           description: Mean weekly merged PR count across the selected range.
+        periodAvgShipWeight:
+          type: number
+          minimum: 0
+          description: Mean weekly ship-weight sum across the selected range.
         avgFailRatePercent:
           type: number
           description: Mean weekly change-failure rate when available.
@@ -11576,6 +11781,14 @@ components:
         mergedPrCount:
           type: integer
           minimum: 0
+        shipWeightSum:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for PRs merged on this day.
+        shipWeightPendingCount:
+          type: integer
+          minimum: 1
+          description: GitHub merged PRs on this day still awaiting ship-weight scoring.
         tokenCount:
           type: integer
           minimum: 0
@@ -11597,6 +11810,14 @@ components:
           type: integer
           minimum: 0
           description: Estimated merged PR count in the bucket from dashboard velocity metrics.
+        shipWeightSum:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for PRs merged in this week bucket.
+        shipWeightPendingCount:
+          type: integer
+          minimum: 1
+          description: GitHub merged PRs in this week bucket still awaiting ship-weight scoring.
         tokenCount:
           type: integer
           minimum: 0
@@ -11641,6 +11862,10 @@ components:
         totalMergedPrs:
           type: integer
           minimum: 0
+        totalShipWeight:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for merged PRs over the selected range.
         totalSpendCents:
           type: integer
           minimum: 0
@@ -15710,6 +15935,14 @@ components:
           type: string
         mergedPrCount:
           type: integer
+        shipWeightSum:
+          type: number
+          minimum: 0
+          description: Sum of ship-weight scores for PRs merged in this week bucket.
+        shipWeightPendingCount:
+          type: integer
+          minimum: 1
+          description: GitHub merged PRs in this week bucket still awaiting ship-weight scoring.
         tokenCount:
           type: integer
 
@@ -15923,6 +16156,11 @@ components:
         - integrations.claude.analytics_key.added
         - integrations.claude.analytics_key.updated
         - integrations.claude.analytics_key.removed
+        - integrations.code_intelligence.settings_changed
+        - integrations.code_intelligence.execution_key.added
+        - integrations.code_intelligence.execution_key.updated
+        - integrations.code_intelligence.execution_key.removed
+        - integrations.code_intelligence.execution_key.check_failed
         - readiness.scan_precheck_failed
         - productivity.ingest.completed
         - productivity.ingest.failed

package/package.json

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