@thinkai/tai-api-contract 2.78.0 → 2.80.0-pr.976.4c124f8a

package/src/generated/openapi.ts

@@ -1203,6 +1203,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/code/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Code Insights — org summary
+         * @description Org-level Code Insights summary for `/insights/code`. Aggregates each active repo's **latest** deterministic metrics row (unweighted medians — mega-repos are not down-weighted, by design), findings counts by severity across latest scans, the org top-10 complexity hotspots, and org-level SonarQube coverage/tech-debt-ratio when a SonarQube source is connected (per-repo Sonar mapping is v2). Reads stored scan outputs only — never recomputes on request.
+         */
+        get: operations["getCodeInsightsSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/code/repos": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Code Insights — per-repo metrics list (paginated)
+         * @description Page of active (not user-archived) repos with their latest code-quality metrics, threshold badges, and finding counts. Repos without a completed metrics scan appear with `metricsStatus` absent/`null` ("pending first scan").
+         */
+        get: operations["listCodeInsightsRepos"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/code/repos/{repoId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Code Insights — repo detail (metrics, hotspots, findings)
+         * @description Single-repo Code Insights detail: latest metrics row with per-metric provenance, current hotspot snapshot (top-N worst files), and the findings computed by the latest scan. `metrics` is `null` when the repo is pending its first metrics scan.
+         */
+        get: operations["getCodeInsightsRepoDetail"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/members": {
         parameters: {
             query?: never;
@@ -7520,6 +7580,172 @@ export interface components {
             }[];
             snippets: string[];
         };
+        /**
+         * @description Where a metric value came from: `measured` (direct tool output), `derived` (computed from measured inputs, e.g. the maintainability band), `estimated` (heuristic proxy, e.g. test-to-source ratio), or `unavailable` (tool missing/failed, or the language is unsupported). Keyed per metric in `CodeInsightsMetricsDto.provenance`.
+         * @enum {string}
+         */
+        CodeInsightsMetricProvenance: "measured" | "derived" | "estimated" | "unavailable";
+        /**
+         * @description CC/LOC-derived maintainability band (documented heuristic, not Halstead MI).
+         * @enum {string}
+         */
+        CodeInsightsMaintainabilityBand: "green" | "yellow" | "red";
+        /**
+         * @description Outcome of the repo's latest metrics scan: `ok` (at least one tool measured), `failed` (every tool failed — metric fields are null with `unavailable` provenance), `skipped` (stage ran but found no measurable source).
+         * @enum {string}
+         */
+        CodeInsightsMetricsStatus: "ok" | "failed" | "skipped";
+        /** @enum {string} */
+        CodeInsightsFindingSeverity: "critical" | "high" | "medium" | "low";
+        /**
+         * @description Deterministic categories (`duplication`, `complexity`, `proliferation`, `coverage`) plus LLM semantic detectors (`anemic_domain`, `context_leak`, `tx_boundary`, `error_handling`).
+         * @enum {string}
+         */
+        CodeInsightsFindingCategory: "duplication" | "complexity" | "proliferation" | "coverage" | "anemic_domain" | "context_leak" | "tx_boundary" | "error_handling";
+        /**
+         * @description `deterministic` = measured Code Insights rules; `llm` = AI-detected semantic findings (separate agent pass; never blended in scoring).
+         * @enum {string}
+         */
+        CodeInsightsFindingSource: "deterministic" | "llm";
+        CodeInsightsMetricsDto: {
+            /** @description Readiness run that produced this metrics row. */
+            runId: string;
+            /** Format: date-time */
+            measuredAt: string;
+            metricsStatus: components["schemas"]["CodeInsightsMetricsStatus"];
+            locTotal?: number | null;
+            filesTotal?: number | null;
+            /** @description Mean cyclomatic complexity across analyzed functions. */
+            ccAvg?: number | null;
+            ccMax?: number | null;
+            /** @description 90th percentile function cyclomatic complexity (nearest-rank). */
+            ccP90?: number | null;
+            /** @description Duplicated lines as a percentage of analyzed lines (0–100). */
+            dupPct?: number | null;
+            maintainabilityBand?: components["schemas"]["CodeInsightsMaintainabilityBand"] | null;
+            /** @description Reserved for per-repo SonarQube enrichment (v2); null in v1. */
+            coveragePct?: number | null;
+            /** @description Reserved for per-repo SonarQube enrichment (v2); null in v1. */
+            debtRatio?: number | null;
+            /** @description Heuristic structure counters: dto/mapper/config/exception file + LOC counts, test/source LOC split, per-language LOC, functions_analyzed, test_ratio, dto_mapper_share_pct. */
+            structureCounts: {
+                [key: string]: unknown;
+            };
+            /** @description Per-metric provenance keyed by DTO field name (e.g. `ccAvg`, `dupPct`, `testRatio`). */
+            provenance: {
+                [key: string]: components["schemas"]["CodeInsightsMetricProvenance"];
+            };
+            /** @description Tool name → version string for the tools that produced this row. */
+            toolVersions: {
+                [key: string]: string;
+            };
+        };
+        CodeInsightsHotspotDto: {
+            /** @description Repo-relative file path. */
+            filePath: string;
+            loc?: number | null;
+            /** @description Max function cyclomatic complexity in the file. */
+            ccMax?: number | null;
+            paramsMax?: number | null;
+            /** @description Max nested control structures (null when the analyzer does not report nesting). */
+            nestingMax?: number | null;
+            /** @description Estimated per-file duplicated line share (0–100). */
+            dupPct?: number | null;
+            /** @description Subset of `god_file`, `high_cc`, `long_params`, `deep_nesting`. */
+            flags: string[];
+        };
+        CodeInsightsFindingDto: {
+            /** Format: uuid */
+            id: string;
+            severity: components["schemas"]["CodeInsightsFindingSeverity"];
+            category: components["schemas"]["CodeInsightsFindingCategory"];
+            title: string;
+            explanation: string;
+            /** @description Measured values and thresholds backing the finding. */
+            evidence: {
+                [key: string]: unknown;
+            };
+            remediation?: string | null;
+            source: components["schemas"]["CodeInsightsFindingSource"];
+            runId: string;
+            /** Format: date-time */
+            createdAt: string;
+        };
+        CodeInsightsFindingsBySeverityDto: {
+            critical: number;
+            high: number;
+            medium: number;
+            low: number;
+        };
+        CodeInsightsRepoListItemDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            language: string;
+            /** @description owner/repo on the VCS provider. */
+            providerSlug: string;
+            webUrl: string;
+            /**
+             * Format: date-time
+             * @description Null when the repo is pending its first metrics scan.
+             */
+            lastMeasuredAt?: string | null;
+            metricsStatus?: components["schemas"]["CodeInsightsMetricsStatus"] | null;
+            locTotal?: number | null;
+            ccAvg?: number | null;
+            ccMax?: number | null;
+            dupPct?: number | null;
+            maintainabilityBand?: components["schemas"]["CodeInsightsMaintainabilityBand"] | null;
+            /** @description Active threshold badges from the latest scan: subset of `god_files`, `high_complexity`, `duplication`, `proliferation`, `low_test_ratio`. */
+            badges: string[];
+            findingsBySeverity: components["schemas"]["CodeInsightsFindingsBySeverityDto"];
+            provenance: {
+                [key: string]: components["schemas"]["CodeInsightsMetricProvenance"];
+            };
+        };
+        CodeInsightsRepoListDto: components["schemas"]["PageMetaDto"] & {
+            items: components["schemas"]["CodeInsightsRepoListItemDto"][];
+        };
+        CodeInsightsRepoDetailDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            language: string;
+            providerSlug: string;
+            webUrl: string;
+            /** @description Null when the repo is pending its first metrics scan. */
+            metrics: components["schemas"]["CodeInsightsMetricsDto"] | null;
+            hotspots: components["schemas"]["CodeInsightsHotspotDto"][];
+            /** @description Findings from the latest scan only (history is retention-bounded). */
+            findings: components["schemas"]["CodeInsightsFindingDto"][];
+        };
+        CodeInsightsOrgHotspotDto: components["schemas"]["CodeInsightsHotspotDto"] & {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+        };
+        CodeInsightsSonarDto: {
+            /** @description Whether a SonarQube source is configured for the workspace. */
+            connected: boolean;
+            /** @description Org-level SonarQube coverage from the latest precomputed quality snapshot. */
+            coveragePct?: number | null;
+            /** @description Org-level SonarQube SQALE technical debt ratio from the latest quality snapshot. */
+            techDebtRatioPct?: number | null;
+        };
+        CodeInsightsSummaryDto: {
+            /** @description Active repos whose latest metrics scan completed (`ok`). */
+            reposMeasured: number;
+            /** @description Active repos without a completed metrics scan (never scanned, or only failed/skipped). */
+            reposPending: number;
+            /** @description Unweighted median of latest `ccAvg` across measured repos (null when none measured). */
+            ccAvgMedian?: number | null;
+            /** @description Unweighted median of latest `dupPct` across measured repos (null when none measured). */
+            dupPctMedian?: number | null;
+            findingsBySeverity: components["schemas"]["CodeInsightsFindingsBySeverityDto"];
+            /** @description Org top-10 complexity hotspots by `ccMax` (current per-repo snapshots). */
+            topHotspots: components["schemas"]["CodeInsightsOrgHotspotDto"][];
+            sonar: components["schemas"]["CodeInsightsSonarDto"];
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -7603,6 +7829,10 @@ export interface components {
         PaginationOrder: "asc" | "desc";
         /** @description Allowlisted repository sort field. */
         ReadinessRepoSort: "repoName" | "overallScore" | "lastAnalyzed" | "language";
+        /** @description Allowlisted Code Insights repo sort field. */
+        CodeInsightsRepoSort: "repoName" | "locTotal" | "ccAvg" | "dupPct" | "lastMeasuredAt";
+        /** @description Case-insensitive substring filter on repo name / provider slug. */
+        CodeInsightsRepoSearch: string;
         /** @description Case-insensitive filter on repository name, language, or provider slug. */
         ReadinessRepoSearch: string;
         /** @description Exact language filter (e.g. `typescript`). */
@@ -8013,6 +8243,22 @@ export type CodeChatCrossEdgesBodyDto = components['schemas']['CodeChatCrossEdge
 export type CodeChatCrossEdgesResultDto = components['schemas']['CodeChatCrossEdgesResultDto'];
 export type CodeChatContextPackBodyDto = components['schemas']['CodeChatContextPackBodyDto'];
 export type CodeChatContextPackDto = components['schemas']['CodeChatContextPackDto'];
+export type CodeInsightsMetricProvenance = components['schemas']['CodeInsightsMetricProvenance'];
+export type CodeInsightsMaintainabilityBand = components['schemas']['CodeInsightsMaintainabilityBand'];
+export type CodeInsightsMetricsStatus = components['schemas']['CodeInsightsMetricsStatus'];
+export type CodeInsightsFindingSeverity = components['schemas']['CodeInsightsFindingSeverity'];
+export type CodeInsightsFindingCategory = components['schemas']['CodeInsightsFindingCategory'];
+export type CodeInsightsFindingSource = components['schemas']['CodeInsightsFindingSource'];
+export type CodeInsightsMetricsDto = components['schemas']['CodeInsightsMetricsDto'];
+export type CodeInsightsHotspotDto = components['schemas']['CodeInsightsHotspotDto'];
+export type CodeInsightsFindingDto = components['schemas']['CodeInsightsFindingDto'];
+export type CodeInsightsFindingsBySeverityDto = components['schemas']['CodeInsightsFindingsBySeverityDto'];
+export type CodeInsightsRepoListItemDto = components['schemas']['CodeInsightsRepoListItemDto'];
+export type CodeInsightsRepoListDto = components['schemas']['CodeInsightsRepoListDto'];
+export type CodeInsightsRepoDetailDto = components['schemas']['CodeInsightsRepoDetailDto'];
+export type CodeInsightsOrgHotspotDto = components['schemas']['CodeInsightsOrgHotspotDto'];
+export type CodeInsightsSonarDto = components['schemas']['CodeInsightsSonarDto'];
+export type CodeInsightsSummaryDto = components['schemas']['CodeInsightsSummaryDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ResponseZenHrSyncInProgress = components['responses']['ZenHrSyncInProgress'];
@@ -8042,6 +8288,8 @@ export type ParameterPaginationLimit = components['parameters']['PaginationLimit
 export type ParameterPaginationOffset = components['parameters']['PaginationOffset'];
 export type ParameterPaginationOrder = components['parameters']['PaginationOrder'];
 export type ParameterReadinessRepoSort = components['parameters']['ReadinessRepoSort'];
+export type ParameterCodeInsightsRepoSort = components['parameters']['CodeInsightsRepoSort'];
+export type ParameterCodeInsightsRepoSearch = components['parameters']['CodeInsightsRepoSearch'];
 export type ParameterReadinessRepoSearch = components['parameters']['ReadinessRepoSearch'];
 export type ParameterReadinessRepoLanguage = components['parameters']['ReadinessRepoLanguage'];
 export type ParameterReadinessFixSort = components['parameters']['ReadinessFixSort'];
@@ -11384,6 +11632,135 @@ export interface operations {
             };
         };
     };
+    getCodeInsightsSummary: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Code Insights org summary payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeInsightsSummaryDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    listCodeInsightsRepos: {
+        parameters: {
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Allowlisted Code Insights repo sort field. */
+                sort?: components["parameters"]["CodeInsightsRepoSort"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Case-insensitive substring filter on repo name / provider slug. */
+                search?: components["parameters"]["CodeInsightsRepoSearch"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated repo code-quality metrics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeInsightsRepoListDto"];
+                };
+            };
+            /** @description Invalid pagination or sort query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getCodeInsightsRepoDetail: {
+        parameters: {
+            query?: {
+                /** @description Optional filter for findings by source. Omit to return both deterministic and llm findings. */
+                source?: components["schemas"]["CodeInsightsFindingSource"];
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Internal repo UUID (`tai_workspace_repos.id`). */
+                repoId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repo code-quality detail payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeInsightsRepoDetailDto"];
+                };
+            };
+            /** @description Malformed repoId */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repo does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAiToolMembers: {
         parameters: {
             query?: {

package/src/index.ts

@@ -328,6 +328,8 @@ export interface DashboardProductivityMetricsDto {
     }[];
     avgTimeToFixBuildHours?: number;
     testCoveragePercent?: number;
+    /** Technical debt ratio (SQALE, from SonarQube) as a percentage. */
+    techDebtRatioPercent?: number;
     escapedBugsCount?: number;
     /** Avg cyclomatic complexity (from SonarQube). */
     complexityAvg?: number;