@thinkai/tai-api-contract 2.63.0 → 2.64.0

package/dist/generated/openapi.d.ts

@@ -962,6 +962,146 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/recommendations-page/verdict-summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Insights recommendations — verdict summary cards
+         * @description Top status cards for `/insights-recommendations`. `productivityMultiplier` is the merged-PR volume ratio versus the previous equal-length window (not AI-active vs non-users). `ciFailRatePct` is portfolio CI fail rate percent. Cost statuses compare AI spend per merged PR to the prior window. Status thresholds match the product UI: productivity ≥1.5 healthy / ≥1.0 watch / else at-risk; CI fail <15 healthy / ≤30 watch / else at-risk; cost change ≤0 healthy / <20% watch / else at-risk (prev≤0 → watch).
+         */
+        get: operations["getInsightsRecommendationsVerdictSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/recommendations-page/roi-quadrant": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Insights recommendations — AI spend vs delivery output
+         * @description Per-engineer AI spend (USD) and merged PR counts for the scatter / ROI quadrant. Includes engineers with spend>0 or mergedPrs>0. Medians are over the returned set (n<2 uses the single point or zeros when empty). `id` is the stable org person id.
+         */
+        get: operations["getInsightsRecommendationsRoiQuadrant"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/recommendations-page/velocity-quality": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Insights recommendations — velocity vs quality weekly series
+         * @description Weekly merged PR volume and CI fail rate for the filter window. Weeks follow the Measure calendar-week bucket convention. `targetFailRatePct` is the org target (15). `volumeGrowthPct` is percent change vs the prior equal-length period.
+         */
+        get: operations["getInsightsRecommendationsVelocityQuality"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/recommendations-page/review-pipeline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Insights recommendations — review bottleneck funnel
+         * @description Review funnel stages `open-review`, `review-approval`, `approval-merge`, and `merged`. Wait stages use delivery-health hours (`avgReviewWaitHours`, `avgApprovalHours`, and approval→merge as max(0, avgTimeToMergeHours − wait − approval)). The `merged` stage uses `medianHours=0` (volume is not hours). `bottleneckStageId` is the wait stage with the highest median hours. `reviewerLoad` comes from persisted `deliveryHealth.topReviewers` when available; otherwise an empty array (never invented reviewers).
+         */
+        get: operations["getInsightsRecommendationsReviewPipeline"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/recommendations-page/cost-per-pr": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Insights recommendations — cost per merged PR by team
+         * @description Org and per-team AI spend / merged PRs. Teams with zero merged PRs in the window are omitted. `costPerPrUsd = spendUsd / mergedPrs`. `activeAi` is distinct AI-active members on the team in the window (provider filter applied).
+         */
+        get: operations["getInsightsRecommendationsCostPerPr"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/recommendations-page/adoption-gap": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Insights recommendations — AI adoption gap by team
+         * @description Headcount vs AI-active contributors and per-team readiness/output. `readinessPct` is the mean latest overallScore of repos with matching `teamId` (workspace mean fallback). `outputPerEngPerWeek` is team merged PRs / headcount / weeks in window. `upliftPct` estimates additional PR volume if non-adopters matched leader-team output (teams with >50% adoption).
+         */
+        get: operations["getInsightsRecommendationsAdoptionGap"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/recommendations-page/recommendations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Insights recommendations — deterministic action items
+         * @description Deterministic rules engine (no LLM). Emits module-anchored recommendations with `moduleId` in {mod-spend-vs-output, mod-velocity-vs-quality, mod-review-bottleneck, mod-cost-per-pr, mod-adoption-gap}. Action items must cite one AI metric and one delivery metric in `observed`. Evidence chips use kinds user-spend|team|contributor|repo|module with real target ids when available.
+         */
+        get: operations["getInsightsRecommendationsRecommendations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/members": {
         parameters: {
             query?: never;
@@ -6228,6 +6368,154 @@ export interface components {
             items: components["schemas"]["SdlcDrilldownItemDto"][];
             nextCursor?: string;
         };
+        InsightsResponseMeta: {
+            /**
+             * Format: date-time
+             * @description ISO timestamp when numbers were computed server-side
+             */
+            syncedAt: string;
+            /**
+             * @description Must be false for production handlers
+             * @enum {boolean}
+             */
+            isMock: false;
+        };
+        /** @enum {string} */
+        InsightsVerdictStatus: "healthy" | "watch" | "at-risk";
+        InsightsRecommendationsVerdictSummary: {
+            /** @description Merged-PR volume ratio vs prior equal-length window (current/prior). When priorMergedPrs is 0, value is 1.0 and productivityStatus is watch. */
+            productivityMultiplier: number;
+            productivityStatus: components["schemas"]["InsightsVerdictStatus"];
+            ciFailRatePct: number;
+            qualityStatus: components["schemas"]["InsightsVerdictStatus"];
+            spendPerMergedPrUsd: number;
+            spendPerMergedPrPrevUsd: number;
+            costStatus: components["schemas"]["InsightsVerdictStatus"];
+        };
+        InsightsRecommendationsVerdictSummaryResponse: components["schemas"]["InsightsRecommendationsVerdictSummary"] & {
+            _meta: components["schemas"]["InsightsResponseMeta"];
+        };
+        InsightsRoiEngineerPoint: {
+            id: string;
+            name: string;
+            team: string;
+            spendUsd: number;
+            mergedPrs: number;
+        };
+        InsightsRecommendationsRoiQuadrant: {
+            medianSpendUsd: number;
+            medianMergedPrs: number;
+            engineers: components["schemas"]["InsightsRoiEngineerPoint"][];
+            correlationHint: string;
+        };
+        InsightsRecommendationsRoiQuadrantResponse: components["schemas"]["InsightsRecommendationsRoiQuadrant"] & {
+            _meta: components["schemas"]["InsightsResponseMeta"];
+        };
+        InsightsVelocityQualityWeek: {
+            /** Format: date */
+            weekStartIso: string;
+            mergedPrs: number;
+            ciFailRatePct: number;
+        };
+        InsightsRecommendationsVelocityQuality: {
+            weeks: components["schemas"]["InsightsVelocityQualityWeek"][];
+            targetFailRatePct: number;
+            volumeGrowthPct: number;
+        };
+        InsightsRecommendationsVelocityQualityResponse: components["schemas"]["InsightsRecommendationsVelocityQuality"] & {
+            _meta: components["schemas"]["InsightsResponseMeta"];
+        };
+        /** @enum {string} */
+        InsightsReviewStageId: "open-review" | "review-approval" | "approval-merge" | "merged";
+        InsightsReviewStage: {
+            id: components["schemas"]["InsightsReviewStageId"];
+            name: string;
+            /** @description Wait hours for funnel stages; 0 for the merged volume stage */
+            medianHours: number;
+            trendPct: number;
+        };
+        InsightsReviewerLoadItem: {
+            id: string;
+            name: string;
+            reviewsCount: number;
+            sharePct: number;
+        };
+        InsightsRecommendationsReviewPipeline: {
+            stages: components["schemas"]["InsightsReviewStage"][];
+            bottleneckStageId: components["schemas"]["InsightsReviewStageId"];
+            reviewerLoad: components["schemas"]["InsightsReviewerLoadItem"][];
+        };
+        InsightsRecommendationsReviewPipelineResponse: components["schemas"]["InsightsRecommendationsReviewPipeline"] & {
+            _meta: components["schemas"]["InsightsResponseMeta"];
+        };
+        InsightsCostPerPrTeam: {
+            id: string;
+            name: string;
+            activeAi: number;
+            spendUsd: number;
+            mergedPrs: number;
+            costPerPrUsd: number;
+            changePct: number;
+        };
+        InsightsRecommendationsCostPerPr: {
+            orgAvgCostUsd: number;
+            orgAvgPrevUsd: number;
+            teams: components["schemas"]["InsightsCostPerPrTeam"][];
+        };
+        InsightsRecommendationsCostPerPrResponse: components["schemas"]["InsightsRecommendationsCostPerPr"] & {
+            _meta: components["schemas"]["InsightsResponseMeta"];
+        };
+        InsightsAdoptionTeam: {
+            id: string;
+            name: string;
+            activeAi: number;
+            totalMembers: number;
+            readinessPct: number;
+            outputPerEngPerWeek: number;
+        };
+        InsightsRecommendationsAdoptionGap: {
+            totalContributors: number;
+            activeContributors: number;
+            upliftPct: number;
+            teams: components["schemas"]["InsightsAdoptionTeam"][];
+        };
+        InsightsRecommendationsAdoptionGapResponse: components["schemas"]["InsightsRecommendationsAdoptionGap"] & {
+            _meta: components["schemas"]["InsightsResponseMeta"];
+        };
+        /** @enum {string} */
+        InsightsRecommendationModuleId: "mod-spend-vs-output" | "mod-velocity-vs-quality" | "mod-review-bottleneck" | "mod-cost-per-pr" | "mod-adoption-gap";
+        /** @enum {string} */
+        InsightsRecommendationImpact: "high" | "medium";
+        /** @enum {string} */
+        InsightsRecommendationTone: "action" | "no-action";
+        /** @enum {string} */
+        InsightsEvidenceLinkKind: "user-spend" | "team" | "contributor" | "repo" | "module";
+        InsightsEvidenceChip: {
+            label: string;
+            kind: components["schemas"]["InsightsEvidenceLinkKind"];
+            targetId: string;
+        };
+        InsightsRecommendationEvidenceGroup: {
+            title: string;
+            chips: components["schemas"]["InsightsEvidenceChip"][];
+        };
+        InsightsRecommendationDto: {
+            moduleId: components["schemas"]["InsightsRecommendationModuleId"];
+            moduleName: string;
+            tone: components["schemas"]["InsightsRecommendationTone"];
+            impact: components["schemas"]["InsightsRecommendationImpact"];
+            headline: string;
+            /** @description For tone=action must cite one AI metric and one delivery metric */
+            observed: string;
+            action: string;
+            benefit: string;
+            confidencePct: number;
+            evidence: components["schemas"]["InsightsRecommendationEvidenceGroup"][];
+        };
+        InsightsRecommendationsListResponse: {
+            items: components["schemas"]["InsightsRecommendationDto"][];
+            _meta: components["schemas"]["InsightsResponseMeta"];
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -6285,6 +6573,20 @@ export interface components {
         InsightsSdlcRangeId: 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 Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+        InsightsRecommendationsDepartments: string[];
+        /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+        InsightsRecommendationsTeams: string[];
+        /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+        InsightsRecommendationsDateFrom: string;
+        /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+        InsightsRecommendationsDateTo: string;
+        /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+        InsightsRecommendationsProvider: string[];
+        /** @description Include contributors / AI rows not mapped to a team. */
+        InsightsRecommendationsIncludeUnmapped: boolean;
+        /** @description Include bot accounts in PR/CI stats. */
+        InsightsRecommendationsIncludeBots: boolean;
         /** @description Page size (default 25, max 100). */
         PaginationLimit: number;
         /** @description Zero-based row offset into the filtered, sorted result set. */
@@ -6621,6 +6923,35 @@ export type SdlcModuleDto = components['schemas']['SdlcModuleDto'];
 export type SdlcOverviewDto = components['schemas']['SdlcOverviewDto'];
 export type SdlcDrilldownItemDto = components['schemas']['SdlcDrilldownItemDto'];
 export type SdlcDrilldownDto = components['schemas']['SdlcDrilldownDto'];
+export type InsightsResponseMeta = components['schemas']['InsightsResponseMeta'];
+export type InsightsVerdictStatus = components['schemas']['InsightsVerdictStatus'];
+export type InsightsRecommendationsVerdictSummary = components['schemas']['InsightsRecommendationsVerdictSummary'];
+export type InsightsRecommendationsVerdictSummaryResponse = components['schemas']['InsightsRecommendationsVerdictSummaryResponse'];
+export type InsightsRoiEngineerPoint = components['schemas']['InsightsRoiEngineerPoint'];
+export type InsightsRecommendationsRoiQuadrant = components['schemas']['InsightsRecommendationsRoiQuadrant'];
+export type InsightsRecommendationsRoiQuadrantResponse = components['schemas']['InsightsRecommendationsRoiQuadrantResponse'];
+export type InsightsVelocityQualityWeek = components['schemas']['InsightsVelocityQualityWeek'];
+export type InsightsRecommendationsVelocityQuality = components['schemas']['InsightsRecommendationsVelocityQuality'];
+export type InsightsRecommendationsVelocityQualityResponse = components['schemas']['InsightsRecommendationsVelocityQualityResponse'];
+export type InsightsReviewStageId = components['schemas']['InsightsReviewStageId'];
+export type InsightsReviewStage = components['schemas']['InsightsReviewStage'];
+export type InsightsReviewerLoadItem = components['schemas']['InsightsReviewerLoadItem'];
+export type InsightsRecommendationsReviewPipeline = components['schemas']['InsightsRecommendationsReviewPipeline'];
+export type InsightsRecommendationsReviewPipelineResponse = components['schemas']['InsightsRecommendationsReviewPipelineResponse'];
+export type InsightsCostPerPrTeam = components['schemas']['InsightsCostPerPrTeam'];
+export type InsightsRecommendationsCostPerPr = components['schemas']['InsightsRecommendationsCostPerPr'];
+export type InsightsRecommendationsCostPerPrResponse = components['schemas']['InsightsRecommendationsCostPerPrResponse'];
+export type InsightsAdoptionTeam = components['schemas']['InsightsAdoptionTeam'];
+export type InsightsRecommendationsAdoptionGap = components['schemas']['InsightsRecommendationsAdoptionGap'];
+export type InsightsRecommendationsAdoptionGapResponse = components['schemas']['InsightsRecommendationsAdoptionGapResponse'];
+export type InsightsRecommendationModuleId = components['schemas']['InsightsRecommendationModuleId'];
+export type InsightsRecommendationImpact = components['schemas']['InsightsRecommendationImpact'];
+export type InsightsRecommendationTone = components['schemas']['InsightsRecommendationTone'];
+export type InsightsEvidenceLinkKind = components['schemas']['InsightsEvidenceLinkKind'];
+export type InsightsEvidenceChip = components['schemas']['InsightsEvidenceChip'];
+export type InsightsRecommendationEvidenceGroup = components['schemas']['InsightsRecommendationEvidenceGroup'];
+export type InsightsRecommendationDto = components['schemas']['InsightsRecommendationDto'];
+export type InsightsRecommendationsListResponse = components['schemas']['InsightsRecommendationsListResponse'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ResponseZenHrSyncInProgress = components['responses']['ZenHrSyncInProgress'];
@@ -6637,6 +6968,13 @@ export type ParameterInsightsProductivityFrom = components['parameters']['Insigh
 export type ParameterInsightsProductivityTo = components['parameters']['InsightsProductivityTo'];
 export type ParameterInsightsSdlcRangeId = components['parameters']['InsightsSdlcRangeId'];
 export type ParameterInsightsDepartmentFilter = components['parameters']['InsightsDepartmentFilter'];
+export type ParameterInsightsRecommendationsDepartments = components['parameters']['InsightsRecommendationsDepartments'];
+export type ParameterInsightsRecommendationsTeams = components['parameters']['InsightsRecommendationsTeams'];
+export type ParameterInsightsRecommendationsDateFrom = components['parameters']['InsightsRecommendationsDateFrom'];
+export type ParameterInsightsRecommendationsDateTo = components['parameters']['InsightsRecommendationsDateTo'];
+export type ParameterInsightsRecommendationsProvider = components['parameters']['InsightsRecommendationsProvider'];
+export type ParameterInsightsRecommendationsIncludeUnmapped = components['parameters']['InsightsRecommendationsIncludeUnmapped'];
+export type ParameterInsightsRecommendationsIncludeBots = components['parameters']['InsightsRecommendationsIncludeBots'];
 export type ParameterPaginationLimit = components['parameters']['PaginationLimit'];
 export type ParameterPaginationOffset = components['parameters']['PaginationOffset'];
 export type ParameterPaginationOrder = components['parameters']['PaginationOrder'];
@@ -9334,6 +9672,412 @@ export interface operations {
             };
         };
     };
+    getInsightsRecommendationsVerdictSummary: {
+        parameters: {
+            query: {
+                /** @description Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+                departments?: components["parameters"]["InsightsRecommendationsDepartments"];
+                /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+                teams?: components["parameters"]["InsightsRecommendationsTeams"];
+                /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+                dateFrom: components["parameters"]["InsightsRecommendationsDateFrom"];
+                /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+                dateTo: components["parameters"]["InsightsRecommendationsDateTo"];
+                /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+                provider?: components["parameters"]["InsightsRecommendationsProvider"];
+                /** @description Include contributors / AI rows not mapped to a team. */
+                includeUnmapped?: components["parameters"]["InsightsRecommendationsIncludeUnmapped"];
+                /** @description Include bot accounts in PR/CI stats. */
+                includeBots?: components["parameters"]["InsightsRecommendationsIncludeBots"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Verdict summary with `_meta.isMock=false` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsRecommendationsVerdictSummaryResponse"];
+                };
+            };
+            /** @description Invalid filter or date range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getInsightsRecommendationsRoiQuadrant: {
+        parameters: {
+            query: {
+                /** @description Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+                departments?: components["parameters"]["InsightsRecommendationsDepartments"];
+                /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+                teams?: components["parameters"]["InsightsRecommendationsTeams"];
+                /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+                dateFrom: components["parameters"]["InsightsRecommendationsDateFrom"];
+                /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+                dateTo: components["parameters"]["InsightsRecommendationsDateTo"];
+                /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+                provider?: components["parameters"]["InsightsRecommendationsProvider"];
+                /** @description Include contributors / AI rows not mapped to a team. */
+                includeUnmapped?: components["parameters"]["InsightsRecommendationsIncludeUnmapped"];
+                /** @description Include bot accounts in PR/CI stats. */
+                includeBots?: components["parameters"]["InsightsRecommendationsIncludeBots"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description ROI quadrant payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsRecommendationsRoiQuadrantResponse"];
+                };
+            };
+            /** @description Invalid filter or date range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getInsightsRecommendationsVelocityQuality: {
+        parameters: {
+            query: {
+                /** @description Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+                departments?: components["parameters"]["InsightsRecommendationsDepartments"];
+                /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+                teams?: components["parameters"]["InsightsRecommendationsTeams"];
+                /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+                dateFrom: components["parameters"]["InsightsRecommendationsDateFrom"];
+                /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+                dateTo: components["parameters"]["InsightsRecommendationsDateTo"];
+                /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+                provider?: components["parameters"]["InsightsRecommendationsProvider"];
+                /** @description Include contributors / AI rows not mapped to a team. */
+                includeUnmapped?: components["parameters"]["InsightsRecommendationsIncludeUnmapped"];
+                /** @description Include bot accounts in PR/CI stats. */
+                includeBots?: components["parameters"]["InsightsRecommendationsIncludeBots"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Velocity vs quality payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsRecommendationsVelocityQualityResponse"];
+                };
+            };
+            /** @description Invalid filter or date range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getInsightsRecommendationsReviewPipeline: {
+        parameters: {
+            query: {
+                /** @description Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+                departments?: components["parameters"]["InsightsRecommendationsDepartments"];
+                /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+                teams?: components["parameters"]["InsightsRecommendationsTeams"];
+                /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+                dateFrom: components["parameters"]["InsightsRecommendationsDateFrom"];
+                /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+                dateTo: components["parameters"]["InsightsRecommendationsDateTo"];
+                /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+                provider?: components["parameters"]["InsightsRecommendationsProvider"];
+                /** @description Include contributors / AI rows not mapped to a team. */
+                includeUnmapped?: components["parameters"]["InsightsRecommendationsIncludeUnmapped"];
+                /** @description Include bot accounts in PR/CI stats. */
+                includeBots?: components["parameters"]["InsightsRecommendationsIncludeBots"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Review pipeline payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsRecommendationsReviewPipelineResponse"];
+                };
+            };
+            /** @description Invalid filter or date range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getInsightsRecommendationsCostPerPr: {
+        parameters: {
+            query: {
+                /** @description Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+                departments?: components["parameters"]["InsightsRecommendationsDepartments"];
+                /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+                teams?: components["parameters"]["InsightsRecommendationsTeams"];
+                /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+                dateFrom: components["parameters"]["InsightsRecommendationsDateFrom"];
+                /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+                dateTo: components["parameters"]["InsightsRecommendationsDateTo"];
+                /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+                provider?: components["parameters"]["InsightsRecommendationsProvider"];
+                /** @description Include contributors / AI rows not mapped to a team. */
+                includeUnmapped?: components["parameters"]["InsightsRecommendationsIncludeUnmapped"];
+                /** @description Include bot accounts in PR/CI stats. */
+                includeBots?: components["parameters"]["InsightsRecommendationsIncludeBots"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Cost per PR payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsRecommendationsCostPerPrResponse"];
+                };
+            };
+            /** @description Invalid filter or date range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getInsightsRecommendationsAdoptionGap: {
+        parameters: {
+            query: {
+                /** @description Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+                departments?: components["parameters"]["InsightsRecommendationsDepartments"];
+                /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+                teams?: components["parameters"]["InsightsRecommendationsTeams"];
+                /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+                dateFrom: components["parameters"]["InsightsRecommendationsDateFrom"];
+                /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+                dateTo: components["parameters"]["InsightsRecommendationsDateTo"];
+                /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+                provider?: components["parameters"]["InsightsRecommendationsProvider"];
+                /** @description Include contributors / AI rows not mapped to a team. */
+                includeUnmapped?: components["parameters"]["InsightsRecommendationsIncludeUnmapped"];
+                /** @description Include bot accounts in PR/CI stats. */
+                includeBots?: components["parameters"]["InsightsRecommendationsIncludeBots"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Adoption gap payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsRecommendationsAdoptionGapResponse"];
+                };
+            };
+            /** @description Invalid filter or date range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getInsightsRecommendationsRecommendations: {
+        parameters: {
+            query: {
+                /** @description Org-chart department ids (repeat param or comma-separated). Empty/omitted = all departments. */
+                departments?: components["parameters"]["InsightsRecommendationsDepartments"];
+                /** @description Org-chart team ids (repeat param or comma-separated). Empty/omitted = all teams in department scope. */
+                teams?: components["parameters"]["InsightsRecommendationsTeams"];
+                /** @description Inclusive window start (`YYYY-MM-DD`). Required with `dateTo`. Maps to Measure day-mode custom range (`from`/`to`). Max span 180 days. */
+                dateFrom: components["parameters"]["InsightsRecommendationsDateFrom"];
+                /** @description Inclusive window end (`YYYY-MM-DD`). Required with `dateFrom`. */
+                dateTo: components["parameters"]["InsightsRecommendationsDateTo"];
+                /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
+                provider?: components["parameters"]["InsightsRecommendationsProvider"];
+                /** @description Include contributors / AI rows not mapped to a team. */
+                includeUnmapped?: components["parameters"]["InsightsRecommendationsIncludeUnmapped"];
+                /** @description Include bot accounts in PR/CI stats. */
+                includeBots?: components["parameters"]["InsightsRecommendationsIncludeBots"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Recommendation items */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InsightsRecommendationsListResponse"];
+                };
+            };
+            /** @description Invalid filter or date range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getAiToolMembers: {
         parameters: {
             query?: {