@thinkai/tai-api-contract 2.62.0 → 2.64.0

package/dist/generated/openapi.d.ts

@@ -922,6 +922,186 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/sdlc/overview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * SDLC insights — Engineering Health overview
+         * @description Engineering Health dashboard for `/insights/sdlc/overview`. Returns precomputed DORA, CI, collaboration, security, governance, and operational metrics aggregated at calendar-day granularity for the selected window. Filter params mirror other Measure insights routes plus optional `repoIds` scope.
+         */
+        get: operations["getSdlcInsightsOverview"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/sdlc/drilldown/{metricId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * SDLC insights — metric drill-down entities
+         * @description Paginated entity list for a single Engineering Health metric (failed workflow runs, PRs, alerts, etc.). Available only when the overview marks `drilldownAvailable: true`.
+         */
+        get: operations["getSdlcInsightsDrilldown"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        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;
@@ -6115,6 +6295,227 @@ export interface components {
              */
             lastSeenAt: string;
         };
+        /** @enum {string} */
+        SdlcModuleId: "dora" | "ci-pipeline" | "collaboration-pr" | "security-risk" | "governance-architecture" | "financial-operational";
+        /** @enum {string} */
+        SdlcMetricId: "dora-deployment-frequency" | "dora-lead-time" | "dora-cfr" | "dora-mttr" | "ci-success-rate" | "ci-duration-p50-p95" | "ci-flakiness" | "ci-queue-wait" | "ci-cache-hit" | "pr-review-time" | "pr-bus-factor" | "pr-size" | "pr-abandonment" | "pr-review-depth" | "pr-draft-duration" | "pr-merge-conflicts" | "pr-commit-density" | "sec-dependabot-backlog" | "sec-vuln-mttr" | "sec-secret-scanning" | "sec-self-approvals" | "sec-unreviewed-merge" | "gov-branch-protection" | "gov-stale-branches" | "gov-orphaned-repos" | "gov-readme-health" | "gov-codeowners" | "gov-issue-pr-linkage" | "fin-gha-minutes" | "fin-copilot-utilization" | "fin-org-inactivity" | "fin-env-drift" | "fin-release-cadence" | "fin-api-rate-limit";
+        /** @enum {string} */
+        SdlcMetricDataStatus: "live" | "preview" | "unavailable";
+        /** @enum {string} */
+        SdlcMetricHealthStatus: "healthy" | "warning" | "critical" | "unknown";
+        /** @enum {string} */
+        SdlcBenchmarkBand: "elite" | "high" | "medium" | "low";
+        SdlcMetricTrendDto: {
+            /** @enum {string} */
+            direction: "up" | "down" | "flat";
+            deltaPercent?: number;
+        };
+        SdlcDailySeriesPointDto: {
+            /**
+             * Format: date
+             * @description Inclusive ISO calendar day (UTC).
+             */
+            date: string;
+            value: number;
+        };
+        SdlcMetricDto: {
+            id: components["schemas"]["SdlcMetricId"];
+            name: string;
+            dataStatus: components["schemas"]["SdlcMetricDataStatus"];
+            healthStatus: components["schemas"]["SdlcMetricHealthStatus"];
+            value: (number | string) | null;
+            unit?: string;
+            secondaryValue?: (number | string) | null;
+            secondaryLabel?: string;
+            trend?: components["schemas"]["SdlcMetricTrendDto"];
+            benchmarkBand?: components["schemas"]["SdlcBenchmarkBand"];
+            drilldownAvailable: boolean;
+            dailySeries?: components["schemas"]["SdlcDailySeriesPointDto"][];
+            unavailableReason?: string;
+        };
+        SdlcModuleDto: {
+            id: components["schemas"]["SdlcModuleId"];
+            name: string;
+            metrics: components["schemas"]["SdlcMetricDto"][];
+        };
+        SdlcOverviewDto: {
+            rangeId: string;
+            /** Format: date */
+            from: string;
+            /** Format: date */
+            to: string;
+            department: string;
+            team: string;
+            repoIds: string[];
+            /** Format: date-time */
+            asOf: string;
+            modules: components["schemas"]["SdlcModuleDto"][];
+        };
+        SdlcDrilldownItemDto: {
+            id: string;
+            title: string;
+            subtitle?: string;
+            /** Format: uri */
+            url?: string;
+            /** Format: date-time */
+            occurredAt?: string;
+            metadata?: {
+                [key: string]: string | number;
+            };
+        };
+        SdlcDrilldownDto: {
+            metricId: components["schemas"]["SdlcMetricId"];
+            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 */
@@ -6168,8 +6569,24 @@ export interface components {
         InsightsProductivityFrom: string;
         /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
         InsightsProductivityTo: string;
+        /** @description Day-level Measure window. Presets: `7d`, `30d`, `90d`, `180d`. Custom inclusive calendar range: `cr:YYYY-MM-DD:YYYY-MM-DD` (max span 180 days). */
+        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. */
@@ -6494,6 +6911,47 @@ export type HrisProviderSyncResultDto = components['schemas']['HrisProviderSyncR
 export type ActivityLogPageDto = components['schemas']['ActivityLogPageDto'];
 export type ReadinessTokenUsageRowDto = components['schemas']['ReadinessTokenUsageRowDto'];
 export type ReadinessTokenUsageByDimensionRowDto = components['schemas']['ReadinessTokenUsageByDimensionRowDto'];
+export type SdlcModuleId = components['schemas']['SdlcModuleId'];
+export type SdlcMetricId = components['schemas']['SdlcMetricId'];
+export type SdlcMetricDataStatus = components['schemas']['SdlcMetricDataStatus'];
+export type SdlcMetricHealthStatus = components['schemas']['SdlcMetricHealthStatus'];
+export type SdlcBenchmarkBand = components['schemas']['SdlcBenchmarkBand'];
+export type SdlcMetricTrendDto = components['schemas']['SdlcMetricTrendDto'];
+export type SdlcDailySeriesPointDto = components['schemas']['SdlcDailySeriesPointDto'];
+export type SdlcMetricDto = components['schemas']['SdlcMetricDto'];
+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'];
@@ -6508,7 +6966,15 @@ export type ParameterFixId = components['parameters']['FixId'];
 export type ParameterInsightsProductivityRangeId = components['parameters']['InsightsProductivityRangeId'];
 export type ParameterInsightsProductivityFrom = components['parameters']['InsightsProductivityFrom'];
 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'];
@@ -9100,6 +9566,518 @@ export interface operations {
             };
         };
     };
+    getSdlcInsightsOverview: {
+        parameters: {
+            query?: {
+                /** @description Day-level Measure window. Presets: `7d`, `30d`, `90d`, `180d`. Custom inclusive calendar range: `cr:YYYY-MM-DD:YYYY-MM-DD` (max span 180 days). */
+                rangeId?: components["parameters"]["InsightsSdlcRangeId"];
+                /** @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). */
+                department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description Team name filter; send `All teams` to include every team. */
+                team?: string;
+                /** @description Comma-separated internal repo ids; omit or empty for all repos. */
+                repoIds?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Engineering Health overview payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdlcOverviewDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            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;
+            };
+        };
+    };
+    getSdlcInsightsDrilldown: {
+        parameters: {
+            query?: {
+                /** @description Day-level Measure window. Presets: `7d`, `30d`, `90d`, `180d`. Custom inclusive calendar range: `cr:YYYY-MM-DD:YYYY-MM-DD` (max span 180 days). */
+                rangeId?: components["parameters"]["InsightsSdlcRangeId"];
+                /** @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). */
+                department?: components["parameters"]["InsightsDepartmentFilter"];
+                team?: string;
+                repoIds?: string;
+                /** @description Opaque pagination cursor from a prior response. */
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                metricId: components["schemas"]["SdlcMetricId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Drill-down page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdlcDrilldownDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or metric not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    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?: {