@thinkai/tai-api-contract 2.5.17 → 2.7.0

package/src/generated/openapi.ts

@@ -824,7 +824,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List repo readiness scores */
+        /**
+         * List repo readiness scores (paginated)
+         * @description Returns a page of repository readiness scorecards. Use `GET .../readiness/repos/{repoId}` for a single repo. Summary aggregates on the Agentic Foundation dashboard use separate aggregate queries over the full workspace (#403).
+         */
         get: operations["listReadinessRepos"];
         put?: never;
         post?: never;
@@ -899,8 +902,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Agentic Foundation dashboard
-         * @description Returns stored repository readiness scorecards plus a flattened issue queue for the Agentic Foundation dashboard surfaces. This is read-only and does not run scoring on the request path (issue #279). Field `generatedAt` is the server timestamp when this JSON payload was assembled; it is not the same as per-repo `lastAnalyzed` on `RepoReadinessScoreDto`.
+         * Agentic Foundation dashboard summary
+         * @description Returns workspace-level readiness summary, per-dimension aggregate bars, and fix status counts for Agentic Foundation dashboard surfaces. Repository and issue lists are paginated on `GET .../readiness/repos` and related segment routes (#403). Read-only; does not run scoring on the request path (issue #279). Field `generatedAt` is the server timestamp when this JSON payload was assembled.
          */
         get: operations["getAgenticFoundationDashboard"];
         put?: never;
@@ -1119,8 +1122,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List fix requests
-         * @description Returns persisted fix-queue rows for the workspace (newest first). Empty array when none exist.
+         * List fix requests (paginated)
+         * @description Returns a page of persisted fix-queue rows for the workspace (default newest first).
          */
         get: operations["listReadinessFixes"];
         put?: never;
@@ -1335,6 +1338,150 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/your-ai-journey/analytics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Combined analytics summary for the /dashboard page
+         * @description Returns a single aggregated payload combining journey step progress, readiness summary, and PR-signal headline metrics. Covers issue #268. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyAnalytics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/pr-signals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Weekly PR velocity and change-failure-rate time series
+         * @description Returns a per-week time series of PR throughput and DORA change-failure-rate metrics, sourced from stored dashboard metrics. Covers issue #269. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyPrSignals"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/readiness/aggregate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-dimension readiness aggregate across all repos
+         * @description Aggregates stored readiness scores across all workspace repos by dimension. Covers issue #270. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyReadinessAggregate"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/journey/progress": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace journey step completion
+         * @description Returns the workspace-scoped journey progress state. Returns an empty `completedSteps` list with a synthetic `updatedAt` if no row exists yet. Covers issue #271.
+         */
+        get: operations["getYourAiJourneyProgress"];
+        /**
+         * Replace workspace journey completed steps
+         * @description Idempotent replace-all of completed route strings for the workspace journey. Requires editor role. Covers issue #271.
+         */
+        put: operations["putYourAiJourneyProgress"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/agentic-foundation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Agentic foundation dashboard slice for /dashboard
+         * @description Returns the same `AgenticFoundationDashboardDto` payload as `GET /agentic-foundation/dashboard`, scoped to the /dashboard page context. Covers issue #272. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyAgenticFoundation"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/productivity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace productivity metrics for /dashboard
+         * @description Returns the most recent stored dashboard productivity metrics snapshot that overlaps the requested window (defaults to the trailing 7 days). Same schema as `GET /dashboard/productivity`. Covers issue #273. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyProductivity"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/your-ai-journey/ai-spend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI tool spend and usage aggregated by week and provider
+         * @description Returns token usage and spend aggregated from connected AI tool sources (e.g. Cursor) over the requested range, broken down by week and provider. Covers issue #274. Results are cached for 60 seconds.
+         */
+        get: operations["getYourAiJourneyAiSpend"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -1580,6 +1727,10 @@ export interface components {
             personId: string;
             personName: string;
             teamName?: string;
+            /** @description True when the contributor GitHub login is not mapped in the org chart. */
+            notInOrgChart?: boolean;
+            /** @description GitHub login for unattributed contributors (when notInOrgChart is true). */
+            githubLogin?: string;
             weeks: components["schemas"]["ProductivityInsightsMergedPrTrendWeekDto"][];
         };
         ProductivityInsightsMergedPrTrendsDto: {
@@ -1590,7 +1741,7 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
-            /** @description Portfolio aggregate merged PR counts (sum of filtered contributors per week). */
+            /** @description Portfolio aggregate merged PR counts from org-scope metrics (all merged PRs in window). */
             weeks: components["schemas"]["ProductivityInsightsMergedPrTrendWeekDto"][];
             contributors: components["schemas"]["ProductivityInsightsMergedPrContributorRowDto"][];
         };
@@ -1960,6 +2111,11 @@ export interface components {
             fullName?: string | null;
             language?: string | null;
             private?: boolean | null;
+            /**
+             * Format: date-time
+             * @description Last push or metadata update from GitHub when available.
+             */
+            updatedAt?: string | null;
         };
         GithubMissingPermissionDto: {
             /** @description GitHub App permission key (e.g. contents, pull_requests). */
@@ -1975,7 +2131,8 @@ export interface components {
         GithubInstallationSummaryDto: {
             installationId: string;
             account: components["schemas"]["GithubAccountDto"];
-            repos: components["schemas"]["GithubInstalledRepoDto"][];
+            /** @description Paginated repositories granted on this installation (same repoLimit/repoOffset as top-level repos). */
+            repos: components["schemas"]["GithubInstalledRepoListDto"];
             /** Format: uri */
             manageUrl?: string | null;
             /** Format: date-time */
@@ -1993,7 +2150,8 @@ export interface components {
             permissionsUpgradeRequired: boolean;
             installationId?: string | null;
             account?: components["schemas"]["GithubAccountDto"] | null;
-            repos?: components["schemas"]["GithubInstalledRepoDto"][] | null;
+            /** @description Paginated merged installation repositories when `installed` is true. */
+            repos?: components["schemas"]["GithubInstalledRepoListDto"] | null;
             /**
              * Format: uri
              * @description User accounts: github.com/settings/installations/<id>. Organizations: github.com/organizations/<login>/settings/installations/<id>.
@@ -2233,14 +2391,46 @@ export interface components {
             /** @enum {string} */
             fixStatus: "open" | "pr-pending" | "fixed";
         };
+        PageMetaDto: {
+            /** @description Total rows matching filters (full workspace, not just this page). */
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        ReadinessRepoListDto: components["schemas"]["PageMetaDto"] & {
+            items: components["schemas"]["RepoReadinessScoreDto"][];
+        };
+        ReadinessFixListDto: components["schemas"]["PageMetaDto"] & {
+            items: components["schemas"]["FixRequestDto"][];
+        };
+        AgenticFoundationDimensionAggregateDto: {
+            dimensionId: components["schemas"]["ReadinessDimensionId"];
+            /** @description Mean dimension score percent across repos with maxScore > 0. */
+            averageScorePercent: number;
+            /** @description Repositories with a scored row for this dimension. */
+            repoCount: number;
+        };
+        ReadinessFixStatusSummaryDto: {
+            queued: number;
+            generating: number;
+            /** @description Count of fixes with status `pr-created`. */
+            prCreated: number;
+            merged: number;
+            failed: number;
+            total: number;
+        };
+        GithubInstalledRepoListDto: components["schemas"]["PageMetaDto"] & {
+            items: components["schemas"]["GithubInstalledRepoDto"][];
+        };
         AgenticFoundationDashboardDto: {
             /** Format: uuid */
             workspaceId: string;
             /** Format: date-time */
             generatedAt: string;
             summary: components["schemas"]["AgenticFoundationDashboardSummaryDto"];
-            repos: components["schemas"]["RepoReadinessScoreDto"][];
-            issueQueue: components["schemas"]["AgenticFoundationDashboardIssueDto"][];
+            /** @description Per-dimension average score bars for overview UI (full workspace aggregates). */
+            dimensionAggregates: components["schemas"]["AgenticFoundationDimensionAggregateDto"][];
+            fixStatusSummary: components["schemas"]["ReadinessFixStatusSummaryDto"];
         };
         FixRequestDto: {
             id: string;
@@ -2438,6 +2628,115 @@ export interface components {
             /** @description Path in `org-charts` bucket after Supabase upload */
             storagePath: string;
         };
+        YourAiJourneyPrSignalsWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            /** @description Display label in MM/DD format. */
+            weekLabel: string;
+            prsPerDeveloperPerWeek: number;
+            changeFailureRatePercent: number;
+        };
+        YourAiJourneyPrSignalsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            /** Format: date-time */
+            windowStart: string;
+            /** Format: date-time */
+            windowEnd: string;
+            weeks: components["schemas"]["YourAiJourneyPrSignalsWeekDto"][];
+            summary: {
+                avgPrsPerDeveloperPerWeek: number;
+                avgFailureRatePercent: number;
+                prVelocityDeltaPercent: number;
+            };
+        };
+        YourAiJourneyReadinessDimensionDto: {
+            dimensionId: string;
+            name: string;
+            totalScore: number;
+            maxScore: number;
+            /** @description Rounded percentage 0–100. */
+            percent: number;
+        };
+        YourAiJourneyReadinessAggregateDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            dimensions: components["schemas"]["YourAiJourneyReadinessDimensionDto"][];
+            summary: {
+                avgScore: number;
+                repoCount: number;
+                fixRate: number;
+                totalOpenIssues: number;
+                totalFixedIssues: number;
+            };
+        };
+        YourAiJourneyAnalyticsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            /** Format: date-time */
+            windowStart: string;
+            /** Format: date-time */
+            windowEnd: string;
+            journey: {
+                completedSteps: string[];
+                /** Format: date-time */
+                updatedAt: string | null;
+            };
+            readiness: {
+                avgScore: number;
+                repoCount: number;
+                fixRate: number;
+                totalOpenIssues: number;
+                totalFixedIssues: number;
+            };
+            prSignals: {
+                avgPrsPerDeveloperPerWeek: number;
+                prVelocityDeltaPercent: number;
+                avgFailureRatePercent: number;
+            };
+        };
+        YourAiJourneyAiSpendWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            weekLabel: string;
+            mergedPrCount: number;
+            tokenCount: number;
+        };
+        YourAiJourneyAiSpendDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            /** Format: date-time */
+            windowStart: string;
+            /** Format: date-time */
+            windowEnd: string;
+            totalSpendCents: number;
+            totalTokenCount: number;
+            activeUsers: number;
+            /** @description Fraction 0–1 of PRs that are AI-assisted. */
+            aiAssistedPrRatio: number;
+            prThroughputDeltaPercent: number;
+            usageDeltaPercent: number;
+            weeks: components["schemas"]["YourAiJourneyAiSpendWeekDto"][];
+            providers: {
+                providerId: string;
+                providerName: string;
+                tokenCount: number;
+                spendCents: number;
+                activeUsers: number;
+            }[];
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -2469,6 +2768,34 @@ export interface components {
         FixId: string;
         /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
         InsightsDepartmentFilter: string;
+        /** @description Page size (default 25, max 100). */
+        PaginationLimit: number;
+        /** @description Zero-based row offset into the filtered, sorted result set. */
+        PaginationOffset: number;
+        /** @description Sort direction. */
+        PaginationOrder: "asc" | "desc";
+        /** @description Allowlisted repository sort field. */
+        ReadinessRepoSort: "repoName" | "overallScore" | "lastAnalyzed" | "language";
+        /** @description Case-insensitive filter on repository name, language, or provider slug. */
+        ReadinessRepoSearch: string;
+        /** @description Exact language filter (e.g. `typescript`). */
+        ReadinessRepoLanguage: string;
+        /** @description Allowlisted fix-queue sort field. */
+        ReadinessFixSort: "createdAt" | "repoName" | "severity" | "status";
+        /** @description Filter fixes by workflow status. */
+        ReadinessFixStatusFilter: "queued" | "generating" | "pr-created" | "merged" | "failed";
+        /** @description Filter fixes to a single workspace repository id. */
+        ReadinessFixRepoIdFilter: 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). */
+        GithubRepoLimit: number;
+        /** @description Zero-based offset into the merged installation repo list. */
+        GithubRepoOffset: number;
+        /** @description Allowlisted GitHub repo sort field. */
+        GithubRepoSort: "name" | "updatedAt";
+        /** @description Sort direction for the nested installation repo list. */
+        GithubRepoOrder: "asc" | "desc";
     };
     requestBodies: never;
     headers: never;
@@ -2572,6 +2899,12 @@ export type DimensionScoreDto = components['schemas']['DimensionScoreDto'];
 export type RepoReadinessScoreDto = components['schemas']['RepoReadinessScoreDto'];
 export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
 export type AgenticFoundationDashboardIssueDto = components['schemas']['AgenticFoundationDashboardIssueDto'];
+export type PageMetaDto = components['schemas']['PageMetaDto'];
+export type ReadinessRepoListDto = components['schemas']['ReadinessRepoListDto'];
+export type ReadinessFixListDto = components['schemas']['ReadinessFixListDto'];
+export type AgenticFoundationDimensionAggregateDto = components['schemas']['AgenticFoundationDimensionAggregateDto'];
+export type ReadinessFixStatusSummaryDto = components['schemas']['ReadinessFixStatusSummaryDto'];
+export type GithubInstalledRepoListDto = components['schemas']['GithubInstalledRepoListDto'];
 export type AgenticFoundationDashboardDto = components['schemas']['AgenticFoundationDashboardDto'];
 export type FixRequestDto = components['schemas']['FixRequestDto'];
 export type FixRetryableErrorCode = components['schemas']['FixRetryableErrorCode'];
@@ -2600,6 +2933,13 @@ export type PreferencesDto = components['schemas']['PreferencesDto'];
 export type ValidationIssueDto = components['schemas']['ValidationIssueDto'];
 export type PreferencesValidationErrorDto = components['schemas']['PreferencesValidationErrorDto'];
 export type OrgChartImportBodyDto = components['schemas']['OrgChartImportBodyDto'];
+export type YourAiJourneyPrSignalsWeekDto = components['schemas']['YourAiJourneyPrSignalsWeekDto'];
+export type YourAiJourneyPrSignalsDto = components['schemas']['YourAiJourneyPrSignalsDto'];
+export type YourAiJourneyReadinessDimensionDto = components['schemas']['YourAiJourneyReadinessDimensionDto'];
+export type YourAiJourneyReadinessAggregateDto = components['schemas']['YourAiJourneyReadinessAggregateDto'];
+export type YourAiJourneyAnalyticsDto = components['schemas']['YourAiJourneyAnalyticsDto'];
+export type YourAiJourneyAiSpendWeekDto = components['schemas']['YourAiJourneyAiSpendWeekDto'];
+export type YourAiJourneyAiSpendDto = components['schemas']['YourAiJourneyAiSpendDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
@@ -2609,6 +2949,20 @@ export type ParameterNotificationId = components['parameters']['NotificationId']
 export type ParameterWorkspaceMemberId = components['parameters']['WorkspaceMemberId'];
 export type ParameterFixId = components['parameters']['FixId'];
 export type ParameterInsightsDepartmentFilter = components['parameters']['InsightsDepartmentFilter'];
+export type ParameterPaginationLimit = components['parameters']['PaginationLimit'];
+export type ParameterPaginationOffset = components['parameters']['PaginationOffset'];
+export type ParameterPaginationOrder = components['parameters']['PaginationOrder'];
+export type ParameterReadinessRepoSort = components['parameters']['ReadinessRepoSort'];
+export type ParameterReadinessRepoSearch = components['parameters']['ReadinessRepoSearch'];
+export type ParameterReadinessRepoLanguage = components['parameters']['ReadinessRepoLanguage'];
+export type ParameterReadinessFixSort = components['parameters']['ReadinessFixSort'];
+export type ParameterReadinessFixStatusFilter = components['parameters']['ReadinessFixStatusFilter'];
+export type ParameterReadinessFixRepoIdFilter = components['parameters']['ReadinessFixRepoIdFilter'];
+export type ParameterReadinessFixSearch = components['parameters']['ReadinessFixSearch'];
+export type ParameterGithubRepoLimit = components['parameters']['GithubRepoLimit'];
+export type ParameterGithubRepoOffset = components['parameters']['GithubRepoOffset'];
+export type ParameterGithubRepoSort = components['parameters']['GithubRepoSort'];
+export type ParameterGithubRepoOrder = components['parameters']['GithubRepoOrder'];
 export type $defs = Record<string, never>;
 export interface operations {
     getMe: {
@@ -3986,6 +4340,14 @@ export interface operations {
                 refresh?: boolean;
                 /** @description When true, re-fetch GitHub App and installation permission metadata (used by the login permission gate after the user approves on GitHub). */
                 permissionsRefresh?: boolean;
+                /** @description Page size for the nested installation repo list (default 25, max 100). */
+                repoLimit?: components["parameters"]["GithubRepoLimit"];
+                /** @description Zero-based offset into the merged installation repo list. */
+                repoOffset?: components["parameters"]["GithubRepoOffset"];
+                /** @description Allowlisted GitHub repo sort field. */
+                repoSort?: components["parameters"]["GithubRepoSort"];
+                /** @description Sort direction for the nested installation repo list. */
+                repoOrder?: components["parameters"]["GithubRepoOrder"];
             };
             header?: never;
             path: {
@@ -4651,7 +5013,20 @@ export interface operations {
     };
     listReadinessRepos: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -4660,13 +5035,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories analyzed */
+            /** @description Paginated repositories analyzed */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -4825,7 +5209,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Dashboard scorecards and issue queue */
+            /** @description Dashboard summary and aggregates */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -4849,7 +5233,20 @@ export interface operations {
     };
     getAgenticFoundationAgenticReadiness: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -4858,13 +5255,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with ai-agent-readiness slice */
+            /** @description Paginated repositories with ai-agent-readiness slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -4882,7 +5288,20 @@ export interface operations {
     };
     getAgenticFoundationRepositoryHealth: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -4891,13 +5310,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with repo-hygiene slice */
+            /** @description Paginated repositories with repo-hygiene slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -4915,7 +5343,20 @@ export interface operations {
     };
     getAgenticFoundationCodebaseQuality: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -4924,13 +5365,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with stack-quality slice */
+            /** @description Paginated repositories with stack-quality slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -4948,7 +5398,20 @@ export interface operations {
     };
     getAgenticFoundationTestQa: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -4957,13 +5420,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with tests-qa slice */
+            /** @description Paginated repositories with tests-qa slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -4981,7 +5453,20 @@ export interface operations {
     };
     getAgenticFoundationObservability: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -4990,13 +5475,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with observability slice */
+            /** @description Paginated repositories with observability slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -5014,7 +5508,20 @@ export interface operations {
     };
     getAgenticFoundationApiContract: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -5023,13 +5530,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with api-contracts slice */
+            /** @description Paginated repositories with api-contracts slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -5047,7 +5563,20 @@ export interface operations {
     };
     getAgenticFoundationPlatformGovernance: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -5056,13 +5585,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with platform-governance slice */
+            /** @description Paginated repositories with platform-governance slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -5080,7 +5618,20 @@ export interface operations {
     };
     getAgenticFoundationDeliveryGovernance: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -5089,13 +5640,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Repositories with delivery slice */
+            /** @description Paginated repositories with delivery slice */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -5113,7 +5673,20 @@ export interface operations {
     };
     getAgenticFoundationAiResolutionHub: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted repository sort field. */
+                sort?: components["parameters"]["ReadinessRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repository name, language, or provider slug. */
+                search?: components["parameters"]["ReadinessRepoSearch"];
+                /** @description Exact language filter (e.g. `typescript`). */
+                language?: components["parameters"]["ReadinessRepoLanguage"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -5128,7 +5701,16 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RepoReadinessScoreDto"][];
+                    "application/json": components["schemas"]["ReadinessRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -5179,7 +5761,22 @@ export interface operations {
     };
     listReadinessFixes: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted fix-queue sort field. */
+                sort?: components["parameters"]["ReadinessFixSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive filter on repo name, issue title, label, or description. */
+                search?: components["parameters"]["ReadinessFixSearch"];
+                /** @description Filter fixes by workflow status. */
+                status?: components["parameters"]["ReadinessFixStatusFilter"];
+                /** @description Filter fixes to a single workspace repository id. */
+                repoId?: components["parameters"]["ReadinessFixRepoIdFilter"];
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -5188,13 +5785,22 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Fix queue */
+            /** @description Paginated fix queue */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FixRequestDto"][];
+                    "application/json": components["schemas"]["ReadinessFixListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -5728,4 +6334,299 @@ export interface operations {
             };
         };
     };
+    getYourAiJourneyAnalytics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Analytics summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyAnalyticsDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyPrSignals: {
+        parameters: {
+            query?: {
+                /** @description Number of weekly buckets to return (1–52; default 8). */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Weekly PR signals */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyPrSignalsDto"];
+                };
+            };
+            /** @description Invalid query parameter (limit out of range) */
+            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"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyReadinessAggregate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Readiness aggregate */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyReadinessAggregateDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyProgress: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Journey progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["JourneyProgressDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putYourAiJourneyProgress: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["JourneyProgressUpdateDto"];
+            };
+        };
+        responses: {
+            /** @description Saved progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["JourneyProgressDto"];
+                };
+            };
+            /** @description Body fails validation (non-array, invalid entries, too many steps) */
+            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"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyAgenticFoundation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Agentic foundation dashboard */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgenticFoundationDashboardDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyProductivity: {
+        parameters: {
+            query?: {
+                /** @description Upper bound of the requested window (ISO 8601; defaults to now). */
+                windowEnd?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Productivity metrics snapshot */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DashboardProductivityDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyAiSpend: {
+        parameters: {
+            query?: {
+                /** @description Time range — `4w` (4 weeks), `8w` (8 weeks), or `q` (quarter, 12 weeks). */
+                rangeId?: "4w" | "8w" | "q";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description AI spend aggregation */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyAiSpendDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
 }