@thinkai/tai-api-contract 2.7.3 → 2.8.0

package/openapi/openapi.yaml

@@ -2348,6 +2348,109 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/readiness/repos/{repoId}/runs:
+    get:
+      tags: [RepositoryReadiness]
+      summary: Paginated readiness run history for one repository
+      description: >
+        Append-only scan history for charts on repo detail. Ordered by scan finish time
+        (or `createdAt` when still in progress). Use `cursor` from the previous response for
+        the next page. Failed and `partial_failed` runs are included with nullable `overallScore`.
+      operationId: listReadinessRepoRuns
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - $ref: "#/components/parameters/RepoId"
+        - name: limit
+          in: query
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 25
+        - name: order
+          in: query
+          schema:
+            type: string
+            enum: [asc, desc]
+            default: desc
+        - name: cursor
+          in: query
+          description: Opaque cursor from a prior response `nextCursor` field.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Run history page
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ReadinessRepoRunListDto"
+        "400":
+          description: Invalid pagination query
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace or repository not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /workspaces/{workspaceId}/readiness/score-history:
+    get:
+      tags: [RepositoryReadiness]
+      summary: Workspace score time-series for all repositories
+      description: >
+        Returns succeeded runs with stored `overallScore` per repo in one call (avoids N+1).
+        Points are ordered ascending by `finishedAt` within each repo. Omit failed and
+        `partial_failed` runs. Use `since` to bound the window; `limitPerRepo` caps points per repo
+        (most recent first, then returned oldest-to-newest within the cap).
+      operationId: getReadinessScoreHistory
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: since
+          in: query
+          description: ISO-8601 lower bound on `finishedAt` (inclusive).
+          schema:
+            type: string
+            format: date-time
+        - name: limitPerRepo
+          in: query
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 200
+            default: 50
+      responses:
+        "200":
+          description: Score history grouped by repository
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WorkspaceReadinessScoreHistoryDto"
+        "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"
+
   /workspaces/{workspaceId}/agentic-foundation/dashboard:
     get:
       tags: [AgenticFoundation]
@@ -2439,6 +2542,7 @@ paths:
                             maxScore: 3
                             issues: []
                         lastAnalyzed: "2026-05-12T12:00:00.000Z"
+                        connectedAt: "2026-05-01T10:00:00.000Z"
                         teamId: null
                         provider:
                           kind: github
@@ -5658,6 +5762,92 @@ components:
           items:
             $ref: "#/components/schemas/ReadinessIssueDto"
 
+    ReadinessRepoRunHistoryItemDto:
+      type: object
+      required: [runId, status, overallScore, createdAt, finishedAt]
+      properties:
+        runId:
+          type: string
+          format: uuid
+        status:
+          $ref: "#/components/schemas/ReadinessRunStatusDto"
+        overallScore:
+          type: integer
+          minimum: 0
+          maximum: 100
+          nullable: true
+          description: Present for succeeded runs after migration 050; null otherwise.
+        createdAt:
+          type: string
+          format: date-time
+        finishedAt:
+          type: string
+          format: date-time
+          nullable: true
+
+    ReadinessRepoRunListDto:
+      type: object
+      required: [items, limit, nextCursor]
+      properties:
+        items:
+          type: array
+          items:
+            $ref: "#/components/schemas/ReadinessRepoRunHistoryItemDto"
+        limit:
+          type: integer
+          minimum: 1
+          maximum: 100
+        nextCursor:
+          type: string
+          nullable: true
+          description: Pass as `cursor` query param to fetch the next page; null when no more rows.
+
+    ReadinessScoreHistoryPointDto:
+      type: object
+      required: [finishedAt, overallScore]
+      properties:
+        finishedAt:
+          type: string
+          format: date-time
+        overallScore:
+          type: integer
+          minimum: 0
+          maximum: 100
+
+    ReadinessRepoScoreHistoryDto:
+      type: object
+      required: [repoId, repoName, connectedAt, points]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        repoName:
+          type: string
+          maxLength: 256
+        connectedAt:
+          type: string
+          format: date-time
+          description: When the repository was first materialized in the workspace (GitHub connect).
+        points:
+          type: array
+          items:
+            $ref: "#/components/schemas/ReadinessScoreHistoryPointDto"
+
+    WorkspaceReadinessScoreHistoryDto:
+      type: object
+      required: [workspaceId, generatedAt, repos]
+      properties:
+        workspaceId:
+          type: string
+          format: uuid
+        generatedAt:
+          type: string
+          format: date-time
+        repos:
+          type: array
+          items:
+            $ref: "#/components/schemas/ReadinessRepoScoreHistoryDto"
+
     RepoReadinessScoreDto:
       type: object
       required:
@@ -5667,6 +5857,7 @@ components:
         - overallScore
         - dimensions
         - lastAnalyzed
+        - connectedAt
         - provider
         - analysisStatus
       properties:
@@ -5691,6 +5882,10 @@ components:
         lastAnalyzed:
           type: string
           format: date-time
+        connectedAt:
+          type: string
+          format: date-time
+          description: First time this repository was materialized in the workspace (GitHub connect).
         teamId:
           type: string
           format: uuid

package/package.json

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

package/src/generated/openapi.ts

@@ -915,6 +915,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/repos/{repoId}/runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Paginated readiness run history for one repository
+         * @description Append-only scan history for charts on repo detail. Ordered by scan finish time (or `createdAt` when still in progress). Use `cursor` from the previous response for the next page. Failed and `partial_failed` runs are included with nullable `overallScore`.
+         */
+        get: operations["listReadinessRepoRuns"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/readiness/score-history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace score time-series for all repositories
+         * @description Returns succeeded runs with stored `overallScore` per repo in one call (avoids N+1). Points are ordered ascending by `finishedAt` within each repo. Omit failed and `partial_failed` runs. Use `since` to bound the window; `limitPerRepo` caps points per repo (most recent first, then returned oldest-to-newest within the cap).
+         */
+        get: operations["getReadinessScoreHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/agentic-foundation/dashboard": {
         parameters: {
             query?: never;
@@ -2375,6 +2415,46 @@ export interface components {
             criteriaSummary?: components["schemas"]["ReadinessCriteriaSummaryDto"] | null;
             issues: components["schemas"]["ReadinessIssueDto"][];
         };
+        ReadinessRepoRunHistoryItemDto: {
+            /** Format: uuid */
+            runId: string;
+            status: components["schemas"]["ReadinessRunStatusDto"];
+            /** @description Present for succeeded runs after migration 050; null otherwise. */
+            overallScore: number | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            finishedAt: string | null;
+        };
+        ReadinessRepoRunListDto: {
+            items: components["schemas"]["ReadinessRepoRunHistoryItemDto"][];
+            limit: number;
+            /** @description Pass as `cursor` query param to fetch the next page; null when no more rows. */
+            nextCursor: string | null;
+        };
+        ReadinessScoreHistoryPointDto: {
+            /** Format: date-time */
+            finishedAt: string;
+            overallScore: number;
+        };
+        ReadinessRepoScoreHistoryDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /**
+             * Format: date-time
+             * @description When the repository was first materialized in the workspace (GitHub connect).
+             */
+            connectedAt: string;
+            points: components["schemas"]["ReadinessScoreHistoryPointDto"][];
+        };
+        WorkspaceReadinessScoreHistoryDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            repos: components["schemas"]["ReadinessRepoScoreHistoryDto"][];
+        };
         RepoReadinessScoreDto: {
             /** Format: uuid */
             repoId: string;
@@ -2385,6 +2465,11 @@ export interface components {
             dimensions: components["schemas"]["DimensionScoreDto"][];
             /** Format: date-time */
             lastAnalyzed: string;
+            /**
+             * Format: date-time
+             * @description First time this repository was materialized in the workspace (GitHub connect).
+             */
+            connectedAt: string;
             /** Format: uuid */
             teamId?: string | null;
             provider: components["schemas"]["RepoProviderDto"];
@@ -2921,6 +3006,11 @@ export type ReadinessRunSummaryDto = components['schemas']['ReadinessRunSummaryD
 export type ReadinessCriteriaSummaryDto = components['schemas']['ReadinessCriteriaSummaryDto'];
 export type ReadinessIssueDto = components['schemas']['ReadinessIssueDto'];
 export type DimensionScoreDto = components['schemas']['DimensionScoreDto'];
+export type ReadinessRepoRunHistoryItemDto = components['schemas']['ReadinessRepoRunHistoryItemDto'];
+export type ReadinessRepoRunListDto = components['schemas']['ReadinessRepoRunListDto'];
+export type ReadinessScoreHistoryPointDto = components['schemas']['ReadinessScoreHistoryPointDto'];
+export type ReadinessRepoScoreHistoryDto = components['schemas']['ReadinessRepoScoreHistoryDto'];
+export type WorkspaceReadinessScoreHistoryDto = components['schemas']['WorkspaceReadinessScoreHistoryDto'];
 export type RepoReadinessScoreDto = components['schemas']['RepoReadinessScoreDto'];
 export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
 export type PageMetaDto = components['schemas']['PageMetaDto'];
@@ -5298,6 +5388,100 @@ export interface operations {
             };
         };
     };
+    listReadinessRepoRuns: {
+        parameters: {
+            query?: {
+                limit?: number;
+                order?: "asc" | "desc";
+                /** @description Opaque cursor from a prior response `nextCursor` field. */
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                repoId: components["parameters"]["RepoId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Run history page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReadinessRepoRunListDto"];
+                };
+            };
+            /** @description Invalid pagination query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repository not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getReadinessScoreHistory: {
+        parameters: {
+            query?: {
+                /** @description ISO-8601 lower bound on `finishedAt` (inclusive). */
+                since?: string;
+                limitPerRepo?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Score history grouped by repository */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceReadinessScoreHistoryDto"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
     getAgenticFoundationDashboard: {
         parameters: {
             query?: never;