@thinkai/tai-api-contract 2.97.0 → 2.99.0

package/src/generated/openapi.ts

@@ -1315,7 +1315,11 @@ export interface paths {
          */
         get: operations["getCodeInsightsRepoDetail"];
         put?: never;
-        post?: never;
+        /**
+         * Code Insights — enqueue Design risks analysis
+         * @description Enqueues an on-demand Design risks run (`run_kind=code_insights_design`) for the repository. Reuses the readiness worker queue but never grades the readiness rubric. Editor/admin only. Returns `409` when a design run is already queued or running for the same provider slug (independent of readiness runs).
+         */
+        post: operations["postCodeInsightsDesignAnalyze"];
         delete?: never;
         options?: never;
         head?: never;
@@ -4642,13 +4646,17 @@ export interface components {
             failures: string[];
             /** @description Failed GitHub Actions workflow runs for this UTC day when CI ingest is enabled. */
             failureItems?: components["schemas"]["ProductivityInsightsContributorFailureItemDto"][];
-            /** @description Optional PR rows with GitHub links when ingest stored URLs. */
+            /** @description Optional merged PR rows for day drilldown (label, optional GitHub URL, optional ship-weight score / pending flag). Includes label-only rows so unscored or URL-less merges still surface ship-weight state. */
             mergedPrItems?: components["schemas"]["ProductivityInsightsContributorMergedPrItemDto"][];
         };
         ProductivityInsightsContributorMergedPrItemDto: {
             label: string;
             /** Format: uri */
             url?: string;
+            /** @description v13 ship-weight score for this PR when scored (typically 0–10). */
+            shipWeight?: number;
+            /** @description True when this GitHub PR is still awaiting ship-weight scoring. */
+            shipWeightPending?: boolean;
         };
         ProductivityInsightsContributorFailureItemDto: {
             label: string;
@@ -7124,7 +7132,7 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed";
         ActivityLogActorDto: {
             /** Format: uuid */
             userId: string;
@@ -7527,6 +7535,8 @@ export interface components {
             /** Format: date */
             weekStartIso: string;
             mergedPrs: number;
+            /** @description Sum of ship-weight scores for merged PRs in this week bucket. */
+            shipWeightSum?: number;
             ciFailRatePct: number;
             /** @description False when CI metrics were not available for this week bucket. */
             hasCiMetrics?: boolean;
@@ -7535,6 +7545,8 @@ export interface components {
             weeks: components["schemas"]["InsightsVelocityQualityWeek"][];
             targetFailRatePct: number;
             volumeGrowthPct: number;
+            /** @description Ship-weight volume growth vs the prior equal-length window. */
+            shipWeightVolumeGrowthPct?: number;
         };
         InsightsRecommendationsVelocityQualityResponse: components["schemas"]["InsightsRecommendationsVelocityQuality"] & {
             _meta: components["schemas"]["InsightsResponseMeta"];
@@ -8196,8 +8208,27 @@ export interface components {
             /** @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). */
+            /** @description Deterministic findings from the latest metrics scan plus LLM findings from the latest **succeeded** Design risks run only. Stale LLM rows from older design runs are not returned. */
             findings: components["schemas"]["CodeInsightsFindingDto"][];
+            /** @description Latest Design risks run of any status (for UI polling). Null when Design risks has never been enqueued for this repo. */
+            designAnalysis: components["schemas"]["CodeInsightsDesignAnalysisDto"] | null;
+        };
+        CodeInsightsDesignAnalysisDto: {
+            /** Format: uuid */
+            runId: string;
+            /** @enum {string} */
+            status: "queued" | "running" | "succeeded" | "failed" | "partial_failed";
+            /** Format: date-time */
+            finishedAt: string | null;
+            errorCode: string | null;
+            errorDetail: string | null;
+        };
+        CodeInsightsDesignAnalyzeResponseDto: {
+            /**
+             * Format: uuid
+             * @description Enqueued Design risks run id (`tai_workspace_readiness_runs.id`).
+             */
+            runId: string;
         };
         CodeInsightsOrgHotspotDto: components["schemas"]["CodeInsightsHotspotDto"] & {
             /** Format: uuid */
@@ -8758,6 +8789,8 @@ export type CodeInsightsFindingsBySeverityDto = components['schemas']['CodeInsig
 export type CodeInsightsRepoListItemDto = components['schemas']['CodeInsightsRepoListItemDto'];
 export type CodeInsightsRepoListDto = components['schemas']['CodeInsightsRepoListDto'];
 export type CodeInsightsRepoDetailDto = components['schemas']['CodeInsightsRepoDetailDto'];
+export type CodeInsightsDesignAnalysisDto = components['schemas']['CodeInsightsDesignAnalysisDto'];
+export type CodeInsightsDesignAnalyzeResponseDto = components['schemas']['CodeInsightsDesignAnalyzeResponseDto'];
 export type CodeInsightsOrgHotspotDto = components['schemas']['CodeInsightsOrgHotspotDto'];
 export type CodeInsightsSonarDto = components['schemas']['CodeInsightsSonarDto'];
 export type CodeInsightsSummaryDto = components['schemas']['CodeInsightsSummaryDto'];
@@ -12404,6 +12437,59 @@ export interface operations {
             };
         };
     };
+    postCodeInsightsDesignAnalyze: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Internal repo UUID (`tai_workspace_repos.id`). */
+                repoId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Design risks analysis enqueued */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeInsightsDesignAnalyzeResponseDto"];
+                };
+            };
+            /** @description Malformed repoId, unsupported provider, or GitHub not connected */
+            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"];
+                };
+            };
+            /** @description An active Design risks run already exists for this repo slug */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAiToolMembers: {
         parameters: {
             query?: {

package/src/index.ts

@@ -31,7 +31,7 @@ export interface ScoreDto {
   createdAt?: string;
   tenantId?: string;
   personId?: string;
-   /** Optional fingerprint of sources config used when this score was computed. */
+  /** Optional fingerprint of sources config used when this score was computed. */
   sourcesVersion?: string;
   metrics: Record<string, number>;
   dimensionScores: Record<string, number>;
@@ -686,6 +686,10 @@ export interface ProductivityInsightsContributorProfileDto {
 export interface ProductivityInsightsContributorMergedPrItemDto {
   label: string;
   url?: string;
+  /** v13 ship-weight score for this PR when scored. */
+  shipWeight?: number;
+  /** True when this PR is still awaiting ship-weight scoring. */
+  shipWeightPending?: boolean;
 }
 
 /** One failed GitHub Actions workflow run on a contributor activity day. */
@@ -888,11 +892,7 @@ export type AiAssistedCodeDataQuality = "estimated" | "measured";
 
 /** How AI-assisted code % was derived when not measured from productivity ingest. */
 export type AiAssistedCodeEstimationSource =
-  | "ingest"
-  | "token_volume"
-  | "spend_proxy"
-  | "adoption"
-  | "unavailable";
+  "ingest" | "token_volume" | "spend_proxy" | "adoption" | "unavailable";
 
 /** One weekly bucket in the AI-assisted code percentage series. */
 export interface AiUsageSpendAiAssistedCodeWeekDto {
@@ -1617,6 +1617,8 @@ export interface InsightsRecommendationsRoiQuadrant {
 export interface InsightsVelocityQualityWeek {
   weekStartIso: string;
   mergedPrs: number;
+  /** Sum of ship-weight scores for merged PRs in this week bucket. */
+  shipWeightSum?: number;
   ciFailRatePct: number;
   /** False when CI metrics were not available for this week bucket. */
   hasCiMetrics?: boolean;
@@ -1626,6 +1628,8 @@ export interface InsightsRecommendationsVelocityQuality {
   weeks: InsightsVelocityQualityWeek[];
   targetFailRatePct: number;
   volumeGrowthPct: number;
+  /** Ship-weight volume growth vs prior equal-length window. */
+  shipWeightVolumeGrowthPct?: number;
 }
 
 export const INSIGHTS_REVIEW_STAGE_IDS = [

package/src/journeySteps.test.ts

@@ -36,7 +36,10 @@ if (droppedUnknown.unknown?.length !== 1 || droppedUnknown.unknown[0] !== "/stal
 }
 
 const rejectUnknown = parseJourneyStepInputs(["/stale/route"], { rejectUnknown: true });
-if (rejectUnknown.error !== "Unknown journey step" || rejectUnknown.unknown?.[0] !== "/stale/route") {
+if (
+  rejectUnknown.error !== "Unknown journey step" ||
+  rejectUnknown.unknown?.[0] !== "/stale/route"
+) {
   throw new Error(`rejectUnknown failed: ${JSON.stringify(rejectUnknown)}`);
 }