@thinkai/tai-api-contract 2.104.0 → 2.106.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.104.0
+  version: 2.106.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -6220,6 +6220,68 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/readiness/score-history/average:
+    get:
+      tags: [RepositoryReadiness]
+      summary: Workspace-average readiness score time-series
+      description: >
+        Returns pre-aggregated workspace-average readiness scores over time, aligned with
+        agentic-foundation `summary.averageOverallScore`. Each point reflects the mean of each
+        repo's latest succeeded run score over **totalRepoCount** (unscanned repos count as 0%).
+        Per-repo input runs are loaded without applying `since` so repos scanned before the window
+        still contribute carry-forward scores; `since` filters **returned** points only. Appends a
+        final point from the live dashboard summary when the current average differs from the last
+        visible point (or when the filtered window is empty). `limitPerRepo` bounds how many
+        succeeded runs per repo are considered when building the series.
+      operationId: getReadinessAverageScoreHistory
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: since
+          in: query
+          description: >
+            ISO-8601 lower bound on returned point `finishedAt` (inclusive). Per-repo input
+            runs are loaded without this filter so scores established before the window still
+            contribute to aggregation.
+          schema:
+            type: string
+            format: date-time
+        - name: limitPerRepo
+          in: query
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 200
+            default: 50
+      responses:
+        "200":
+          description: Workspace-average score history
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WorkspaceAverageReadinessScoreHistoryDto"
+        "400":
+          description: Invalid query
+          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"
+        "501":
+          description: Readiness score history or dashboard summary not supported
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/agentic-foundation/repo-scope:
     put:
       tags: [AgenticFoundation]
@@ -6784,6 +6846,7 @@ paths:
         - $ref: "#/components/parameters/ReadinessFixSearch"
         - $ref: "#/components/parameters/ReadinessFixStatusFilter"
         - $ref: "#/components/parameters/ReadinessFixRepoIdFilter"
+        - $ref: "#/components/parameters/ReadinessFixIssueIdsFilter"
       responses:
         "200":
           description: Paginated fix queue
@@ -6792,7 +6855,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/ReadinessFixListDto"
         "400":
-          description: Invalid pagination or sort query
+          description: Invalid pagination, sort, or issueIds query
           content:
             application/json:
               schema:
@@ -9270,6 +9333,21 @@ components:
       schema:
         type: string
         format: uuid
+    ReadinessFixIssueIdsFilter:
+      name: issueIds
+      in: query
+      required: false
+      description: >
+        Filter fixes to specific readiness issue ids (repeat param or comma-separated UUIDs).
+        At most 100 ids per request. Omitted = no issue-id filter.
+      schema:
+        type: array
+        maxItems: 100
+        items:
+          type: string
+          format: uuid
+      style: form
+      explode: true
     ReadinessFixSearch:
       name: search
       in: query
@@ -15100,6 +15178,30 @@ components:
           items:
             $ref: "#/components/schemas/ReadinessRepoScoreHistoryDto"
 
+    WorkspaceAverageReadinessScoreHistoryDto:
+      type: object
+      required: [workspaceId, generatedAt, totalRepoCount, points]
+      properties:
+        workspaceId:
+          type: string
+          format: uuid
+        generatedAt:
+          type: string
+          format: date-time
+        totalRepoCount:
+          type: integer
+          minimum: 0
+          description: >
+            All non-archived repos in the workspace (denominator for average; unscored repos
+            count as 0%).
+        points:
+          type: array
+          items:
+            $ref: "#/components/schemas/ReadinessScoreHistoryPointDto"
+          description: >
+            Workspace-average score after each scan event, ascending by `finishedAt`. May include
+            a final point from the live dashboard summary.
+
     RepoReadinessScoreDto:
       type: object
       required:

package/package.json

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

package/src/generated/openapi.ts

@@ -2332,6 +2332,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/score-history/average": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace-average readiness score time-series
+         * @description Returns pre-aggregated workspace-average readiness scores over time, aligned with agentic-foundation `summary.averageOverallScore`. Each point reflects the mean of each repo's latest succeeded run score over **totalRepoCount** (unscanned repos count as 0%). Per-repo input runs are loaded without applying `since` so repos scanned before the window still contribute carry-forward scores; `since` filters **returned** points only. Appends a final point from the live dashboard summary when the current average differs from the last visible point (or when the filtered window is empty). `limitPerRepo` bounds how many succeeded runs per repo are considered when building the series.
+         */
+        get: operations["getReadinessAverageScoreHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/agentic-foundation/repo-scope": {
         parameters: {
             query?: never;
@@ -6424,6 +6444,16 @@ export interface components {
             generatedAt: string;
             repos: components["schemas"]["ReadinessRepoScoreHistoryDto"][];
         };
+        WorkspaceAverageReadinessScoreHistoryDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            /** @description All non-archived repos in the workspace (denominator for average; unscored repos count as 0%). */
+            totalRepoCount: number;
+            /** @description Workspace-average score after each scan event, ascending by `finishedAt`. May include a final point from the live dashboard summary. */
+            points: components["schemas"]["ReadinessScoreHistoryPointDto"][];
+        };
         RepoReadinessScoreDto: {
             /** Format: uuid */
             repoId: string;
@@ -8413,6 +8443,8 @@ export interface components {
         ReadinessFixStatusFilter: "queued" | "generating" | "pr-created" | "merged" | "failed";
         /** @description Filter fixes to a single workspace repository id. */
         ReadinessFixRepoIdFilter: string;
+        /** @description Filter fixes to specific readiness issue ids (repeat param or comma-separated UUIDs). At most 100 ids per request. Omitted = no issue-id filter. */
+        ReadinessFixIssueIdsFilter: string[];
         /** @description Case-insensitive filter on repo name, issue title, label, or description. */
         ReadinessFixSearch: string;
         /** @description Page size for the nested installation repo list (default 25, max 100). */
@@ -8658,6 +8690,7 @@ export type ReadinessScoreHistoryDimensionScoreDto = components['schemas']['Read
 export type ReadinessScoreHistoryPointDto = components['schemas']['ReadinessScoreHistoryPointDto'];
 export type ReadinessRepoScoreHistoryDto = components['schemas']['ReadinessRepoScoreHistoryDto'];
 export type WorkspaceReadinessScoreHistoryDto = components['schemas']['WorkspaceReadinessScoreHistoryDto'];
+export type WorkspaceAverageReadinessScoreHistoryDto = components['schemas']['WorkspaceAverageReadinessScoreHistoryDto'];
 export type RepoReadinessScoreDto = components['schemas']['RepoReadinessScoreDto'];
 export type LinkedRolePendingDto = components['schemas']['LinkedRolePendingDto'];
 export type LinkedRoleAssessmentDto = components['schemas']['LinkedRoleAssessmentDto'];
@@ -8890,6 +8923,7 @@ export type ParameterReadinessRepoLanguage = components['parameters']['Readiness
 export type ParameterReadinessFixSort = components['parameters']['ReadinessFixSort'];
 export type ParameterReadinessFixStatusFilter = components['parameters']['ReadinessFixStatusFilter'];
 export type ParameterReadinessFixRepoIdFilter = components['parameters']['ReadinessFixRepoIdFilter'];
+export type ParameterReadinessFixIssueIdsFilter = components['parameters']['ReadinessFixIssueIdsFilter'];
 export type ParameterReadinessFixSearch = components['parameters']['ReadinessFixSearch'];
 export type ParameterGithubRepoLimit = components['parameters']['GithubRepoLimit'];
 export type ParameterGithubRepoOffset = components['parameters']['GithubRepoOffset'];
@@ -15024,6 +15058,61 @@ export interface operations {
             };
         };
     };
+    getReadinessAverageScoreHistory: {
+        parameters: {
+            query?: {
+                /** @description ISO-8601 lower bound on returned point `finishedAt` (inclusive). Per-repo input runs are loaded without this filter so scores established before the window still contribute to aggregation. */
+                since?: string;
+                limitPerRepo?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Workspace-average score history */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceAverageReadinessScoreHistoryDto"];
+                };
+            };
+            /** @description Invalid query */
+            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 Readiness score history or dashboard summary not supported */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     putAgenticFoundationRepoScope: {
         parameters: {
             query?: never;
@@ -15717,6 +15806,8 @@ export interface operations {
                 status?: components["parameters"]["ReadinessFixStatusFilter"];
                 /** @description Filter fixes to a single workspace repository id. */
                 repoId?: components["parameters"]["ReadinessFixRepoIdFilter"];
+                /** @description Filter fixes to specific readiness issue ids (repeat param or comma-separated UUIDs). At most 100 ids per request. Omitted = no issue-id filter. */
+                issueIds?: components["parameters"]["ReadinessFixIssueIdsFilter"];
             };
             header?: never;
             path: {
@@ -15735,7 +15826,7 @@ export interface operations {
                     "application/json": components["schemas"]["ReadinessFixListDto"];
                 };
             };
-            /** @description Invalid pagination or sort query */
+            /** @description Invalid pagination, sort, or issueIds query */
             400: {
                 headers: {
                     [name: string]: unknown;