@thinkai/tai-api-contract 2.93.0 → 2.95.0

package/src/generated/openapi.ts

@@ -606,6 +606,44 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/sonarqube/repo-mappings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List SonarQube repo to project key mappings */
+        get: operations["listSonarQubeRepoMappings"];
+        /**
+         * Replace SonarQube repo mappings (full list)
+         * @description Replaces all SonarQube repo→projectKey rows for the workspace. Validate rows in the UI before save; optional `POST .../validate` probes keys with the workspace token.
+         */
+        put: operations["putSonarQubeRepoMappings"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/sonarqube/repo-mappings/validate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Validate SonarQube mapping rows against the workspace token */
+        post: operations["validateSonarQubeRepoMappings"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/sources/{type}": {
         parameters: {
             query?: never;
@@ -2133,8 +2171,8 @@ export interface paths {
         /**
          * Export repository readiness issues as Markdown
          * @description Download outstanding readiness issues for one repository as a Markdown (`.md`) attachment for local IDE workflows. Reuses the same scorecard as `GET .../readiness/repos/{repoId}` (issues plus optional remediation from `criteriaDetails`).
-         *     The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section lists matching issues sorted by severity. Issue sections include severity in the heading and do not emit per-issue `Fix status` / `Fix tier` lines. Default filter is outstanding issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is true (default), each issue includes a Remediation section from the matching criterion when available. Timestamps use the optional `timeZone` query (IANA; default `UTC`).
-         *     The response sets `Content-Disposition: attachment` with filename `readiness-issues-{providerSlug}-{date}.md`.
+         *     The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section lists matching issues sorted by severity. Issue sections include severity in the heading, export format version, issue/rubric metadata, agent workflow, and agent instructions from the rubric when available. Default filter is outstanding issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is true (default), each issue also includes criterion summary/status in metadata and remediation from `criteriaDetails` when it differs from agent instructions. Agent workflow and rubric agent instructions are emitted regardless of `includeCriteria`. Timestamps use the optional `timeZone` query (IANA; default `UTC`).
+         *     The response sets `Content-Disposition: attachment` with filename `readiness-remediations-{providerSlug}-{date}.md`.
          */
         get: operations["exportReadinessRepoIssuesMarkdown"];
         put?: never;
@@ -3991,17 +4029,17 @@ export interface components {
             orgId?: string;
             orgName?: string;
         };
-        /** @description SonarQube source for workspace sources PUT and connection test. Every field is re-submitted on each save; `token` is never round-tripped from `GET` workspace config. */
+        /** @description SonarQube source for workspace sources PUT and connection test. Credentials only — per-repository Sonar project keys are configured via repo mappings. Every field is re-submitted on each save; `token` is never round-tripped from `GET` workspace config. */
         SonarQubeSourceDto: {
             /** @enum {string} */
             type: "sonarqube";
-            /** @description SonarQube server URL, e.g. https://sonarqube.example.com. */
+            /** @description SonarQube server URL, e.g. https://sonarcloud.io or https://sonarqube.example.com. */
             baseUrl: string;
-            /** @description User or project analysis token (write-only on PUT). Literal tokens are encrypted at rest. Operator-managed secrets may use an `env:VAR` reference (resolved at runtime / batch poll), matching other non-AI-tool sources. */
+            /** @description User or project analysis token (write-only on PUT). Literal tokens are encrypted at rest. Operator-managed secrets may use an `env:VAR` reference (resolved at runtime), matching other non-AI-tool sources. */
             token: string;
-            /** @description SonarQube project key (component key). */
-            projectKey: string;
-            /** @description Optional branch name for branch-scoped measures. */
+            /** @description SonarCloud organization key (required for project search on SonarCloud). */
+            organization?: string;
+            /** @description Optional workspace default branch fallback for per-repo Sonar probes. */
             branch?: string;
         };
         /** @description Redacted SonarQube source returned by GET workspace config. */
@@ -4010,9 +4048,38 @@ export interface components {
             type: "sonarqube";
             hasToken: boolean;
             baseUrl: string;
+            organization?: string;
+            branch?: string;
+        };
+        SonarQubeRepoMappingDto: {
+            /** @description Repository slug (`owner/repo`) in the workspace catalog. */
+            providerSlug: string;
             projectKey: string;
+            /** @description Optional branch override for Sonar API calls for this repo. */
             branch?: string;
         };
+        SonarQubeRepoMappingRowDto: components["schemas"]["SonarQubeRepoMappingDto"] & {
+            /** Format: uuid */
+            repoId: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        SonarQubeRepoMappingsPutDto: {
+            mappings: components["schemas"]["SonarQubeRepoMappingDto"][];
+        };
+        SonarQubeRepoMappingsListDto: {
+            mappings: components["schemas"]["SonarQubeRepoMappingRowDto"][];
+        };
+        SonarQubeRepoMappingValidateRowDto: {
+            providerSlug: string;
+            projectKey: string;
+            branch?: string;
+            ok: boolean;
+            error?: string;
+        };
+        SonarQubeRepoMappingsValidateResponseDto: {
+            results: components["schemas"]["SonarQubeRepoMappingValidateRowDto"][];
+        };
         /** @description PagerDuty incident monitoring source for `PUT /workspaces/{workspaceId}/sources` and `POST /workspaces/{workspaceId}/sources/test`. Requires a REST API v2 token (an "API Access Key" from PagerDuty → **Integrations → API Access Keys**). */
         PagerDutySourceDto: {
             /** @enum {string} */
@@ -4178,6 +4245,16 @@ export interface components {
         };
         /** @description Nested metric groups; see TypeScript `DashboardProductivityMetricsDto` in @thinkai/tai-api-contract. */
         DashboardProductivityMetricsDto: {
+            velocity?: {
+                mergedPrCount?: number;
+                shipWeightSum?: number;
+                totalShipWeight?: number;
+                /** @description GitHub merged PR ledger rows in the metrics window still awaiting ship-weight scoring (omit when zero). */
+                shipWeightPendingCount?: number;
+            } & {
+                [key: string]: unknown;
+            };
+        } & {
             [key: string]: unknown;
         };
         DashboardProductivityDto: {
@@ -8169,6 +8246,12 @@ export type GrafanaSourceDto = components['schemas']['GrafanaSourceDto'];
 export type GrafanaSourceConfigDto = components['schemas']['GrafanaSourceConfigDto'];
 export type SonarQubeSourceDto = components['schemas']['SonarQubeSourceDto'];
 export type SonarQubeSourceConfigDto = components['schemas']['SonarQubeSourceConfigDto'];
+export type SonarQubeRepoMappingDto = components['schemas']['SonarQubeRepoMappingDto'];
+export type SonarQubeRepoMappingRowDto = components['schemas']['SonarQubeRepoMappingRowDto'];
+export type SonarQubeRepoMappingsPutDto = components['schemas']['SonarQubeRepoMappingsPutDto'];
+export type SonarQubeRepoMappingsListDto = components['schemas']['SonarQubeRepoMappingsListDto'];
+export type SonarQubeRepoMappingValidateRowDto = components['schemas']['SonarQubeRepoMappingValidateRowDto'];
+export type SonarQubeRepoMappingsValidateResponseDto = components['schemas']['SonarQubeRepoMappingsValidateResponseDto'];
 export type PagerDutySourceDto = components['schemas']['PagerDutySourceDto'];
 export type PagerDutySourceConfigDto = components['schemas']['PagerDutySourceConfigDto'];
 export type AgentExecutionProviderDto = components['schemas']['AgentExecutionProviderDto'];
@@ -10229,6 +10312,100 @@ export interface operations {
             };
         };
     };
+    listSonarQubeRepoMappings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Mappings for repos in this workspace */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SonarQubeRepoMappingsListDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    putSonarQubeRepoMappings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SonarQubeRepoMappingsPutDto"];
+            };
+        };
+        responses: {
+            /** @description Mappings saved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SonarQubeRepoMappingsListDto"];
+                };
+            };
+            /** @description Unknown repo slug or invalid body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    validateSonarQubeRepoMappings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SonarQubeRepoMappingsPutDto"];
+            };
+        };
+        responses: {
+            /** @description Per-row probe results */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SonarQubeRepoMappingsValidateResponseDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description SonarQube source not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     deleteSourceByType: {
         parameters: {
             query?: never;
@@ -14116,7 +14293,7 @@ export interface operations {
                 fixStatus?: "open" | "pr-pending" | "fixed";
                 dimensionId?: components["schemas"]["ReadinessDimensionId"];
                 severity?: "critical" | "high" | "medium" | "low";
-                /** @description Include remediation from criteriaDetails (default true). */
+                /** @description When true (default), include criterion summary/status in issue metadata and remediation from `criteriaDetails` (plus inline scan remediation paragraphs). Agent workflow and rubric agent instructions are always included. When false, omit criterion-derived metadata and criterion remediation only. */
                 includeCriteria?: boolean;
                 /** @description IANA time zone for human-readable `Last analyzed` / `Exported` timestamps and the calendar date in the attachment filename (e.g. `Europe/Berlin`). Defaults to `UTC`. */
                 timeZone?: string;

package/src/index.ts

@@ -295,6 +295,8 @@ export interface DashboardProductivityMetricsDto {
     shipWeightSum?: number;
     /** Alias of shipWeightSum for single-window productivity cards. */
     totalShipWeight?: number;
+    /** GitHub ledger rows in the window still awaiting ship-weight scoring. */
+    shipWeightPendingCount?: number;
     avgPrMergeTimeHours?: number;
     /** Per-PR summaries for contributor drilldown (stored during productivity ingest). */
     mergedPullRequests?: {