@thinkai/tai-api-contract 2.91.0 → 2.93.0

package/src/generated/openapi.ts

@@ -2609,6 +2609,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-intelligence": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Update Code Intelligence workspace settings
+         * @description Admin-only. Enables/disables Code Intelligence for the workspace, chooses whether to reuse the Agent Execution key or a dedicated `code_intelligence` source credential, and optional Cursor/Claude model overrides. Does not store secrets — use `PUT .../sources` with `type: code_intelligence` and `executionToken` when key mode is `dedicated` (except `thinkai_platform_cursor`, which uses the platform key). Preview UI remains behind `?code_kn=true`.
+         */
+        put: operations["putCodeIntelligenceSettings"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/repo-eligibility": {
         parameters: {
             query?: never;
@@ -3872,6 +3892,20 @@ export interface components {
             /** @description Masked preview of the stored insights key (prefix + last four characters). Never includes the full secret. */
             insightsTokenHint?: string;
         };
+        /** @description Dedicated Engineering Context Graph execution credential for `PUT /workspaces/{workspaceId}/sources` when `codeIntelligenceKeyMode` is `dedicated`. Provide `executionToken` (Cursor user/service key or Anthropic `sk-ant-api…`). Admin keys are rejected. Reads from `GET /workspaces/{workspaceId}/config` redact the secret to `hasExecutionToken` via `CodeIntelligenceSourceConfigDto`. */
+        CodeIntelligenceSourcePatchDto: {
+            /** @enum {string} */
+            type: "code_intelligence";
+            /** @description Execution key for wiki/chat LLM calls in dedicated key mode. Whitespace and `env:` prefix are rejected. */
+            executionToken?: string;
+        };
+        /** @description Redacted Engineering Context Graph source returned by `GET /workspaces/{workspaceId}/config`. Raw `executionToken` values are never returned. */
+        CodeIntelligenceSourceConfigDto: {
+            /** @enum {string} */
+            type: "code_intelligence";
+            /** @description Whether a dedicated ECG execution token is stored for this workspace. */
+            hasExecutionToken: boolean;
+        };
         /** @description New Relic monitoring source for `PUT /workspaces/{workspaceId}/sources` and `POST /workspaces/{workspaceId}/sources/test`. Requires a User API key and numeric account ID. */
         NewRelicSourceDto: {
             /** @enum {string} */
@@ -4013,8 +4047,17 @@ export interface components {
          * @enum {string}
          */
         AgentExecutionProviderDto: "thinkai_platform_cursor" | "cursor_user_api_key" | "claude_api_key";
+        /** @description Partial update for Code Intelligence workspace settings (admin-only). */
+        PutCodeIntelligenceSettingsDto: {
+            enabled?: boolean;
+            /** @enum {string} */
+            keyMode?: "reuse_agent_execution" | "dedicated";
+            provider?: components["schemas"]["AgentExecutionProviderDto"] | null;
+            cursorModel?: string | null;
+            claudeModel?: string | null;
+        };
         WorkspaceConfigDto: {
-            sources: (components["schemas"]["CursorSourceConfigDto"] | components["schemas"]["ClaudeSourceConfigDto"] | components["schemas"]["NewRelicSourceConfigDto"] | components["schemas"]["PrometheusSourceConfigDto"] | components["schemas"]["GrafanaSourceConfigDto"] | components["schemas"]["SonarQubeSourceConfigDto"] | components["schemas"]["PagerDutySourceConfigDto"] | components["schemas"]["TenantSourceEntryDto"])[];
+            sources: (components["schemas"]["CursorSourceConfigDto"] | components["schemas"]["ClaudeSourceConfigDto"] | components["schemas"]["CodeIntelligenceSourceConfigDto"] | components["schemas"]["NewRelicSourceConfigDto"] | components["schemas"]["PrometheusSourceConfigDto"] | components["schemas"]["GrafanaSourceConfigDto"] | components["schemas"]["SonarQubeSourceConfigDto"] | components["schemas"]["PagerDutySourceConfigDto"] | components["schemas"]["TenantSourceEntryDto"])[];
             orgChart?: components["schemas"]["ScoringOrgChartDto"] | null;
             /** @enum {string|null} */
             region?: "us" | "eu" | "me" | null;
@@ -4025,6 +4068,21 @@ export interface components {
             cursorPlatformKeyEnabled?: boolean;
             /** @description The single active agent execution account for this workspace's readiness scanner and fix processor. Defaults to `cursor_user_api_key`. Change via `PUT /workspaces/{workspaceId}/agent-execution-provider`. */
             agentExecutionProvider?: components["schemas"]["AgentExecutionProviderDto"];
+            /** @description When false (default), Code Intelligence write APIs (`/code-chat/*` index/sync/wiki/messages) return 403. Preview UI still requires `?code_kn=true`. Change via `PUT /workspaces/{workspaceId}/code-intelligence`. */
+            codeIntelligenceEnabled?: boolean;
+            /**
+             * @description `reuse_agent_execution` uses the workspace Agent Execution key. `dedicated` uses the `code_intelligence` source token (or platform Cursor when provider is `thinkai_platform_cursor`).
+             * @enum {string}
+             */
+            codeIntelligenceKeyMode?: "reuse_agent_execution" | "dedicated";
+            /** @description Active when `codeIntelligenceKeyMode` is `dedicated`. Null when reusing Agent Execution. */
+            codeIntelligenceProvider?: components["schemas"]["AgentExecutionProviderDto"] | null;
+            /** @description Optional Cursor model override for Code Intelligence (null/empty → env default). */
+            codeIntelligenceCursorModel?: string | null;
+            /** @description Optional Claude model override for Code Intelligence (null/empty → env default). */
+            codeIntelligenceClaudeModel?: string | null;
+            /** @description True when a dedicated `code_intelligence` source has a stored executionToken. */
+            hasCodeIntelligenceExecutionToken?: boolean;
         };
         TestConnectionResponseDto: {
             success: boolean;
@@ -4172,6 +4230,10 @@ export interface components {
              */
             date: string;
             mergedPrCount: number;
+            /** @description Sum of ship-weight scores for PRs merged on this day. */
+            shipWeightSum?: number;
+            /** @description GitHub merged PRs on this day still awaiting ship-weight scoring. */
+            shipWeightPendingCount?: number;
             /** @description GitHub Actions CI build failures on this day from `ciFailureRuns` ledger when CI ingest is enabled. */
             ciFailuresCount?: number;
             /** @description Mean hours from PR creation to first review for PRs merged on this day. */
@@ -4191,6 +4253,10 @@ export interface components {
             /** @description Short label for the week column (MM/DD), aligned with Measure charts. */
             weekLabel?: string;
             mergedPrCount: number;
+            /** @description Sum of ship-weight scores for PRs merged in this week bucket. */
+            shipWeightSum?: number;
+            /** @description GitHub merged PRs in this week bucket still awaiting ship-weight scoring. */
+            shipWeightPendingCount?: number;
             /** @description DORA change failure rate (deployments/incidents), not CI build failures. */
             failRatePercent: number;
             /** @description GitHub Actions / Checks CI build failure rate for the week bucket (failed runs / (failed + passed) * 100). Zero when GitHub Actions CI is disabled. */
@@ -4251,6 +4317,10 @@ export interface components {
             /** @description Short label for the week column (MM/DD), aligned with Measure charts. */
             weekLabel?: string;
             mergedPrCount: number;
+            /** @description Sum of ship-weight scores for PRs merged in this week bucket. */
+            shipWeightSum?: number;
+            /** @description GitHub merged PRs in this week bucket still awaiting ship-weight scoring. */
+            shipWeightPendingCount?: number;
         };
         ProductivityInsightsMergedPrContributorRowDto: {
             /** @description Canonical person identifier (matches org chart person_id / employeeId). */
@@ -4300,6 +4370,8 @@ export interface components {
             subtitle?: string;
             /** @description Average weekly merged PR count over the selected range. */
             periodAvgMergedPrs: number;
+            /** @description Average weekly ship-weight sum over the selected range. */
+            periodAvgShipWeight?: number;
             /** @description Average change failure rate over the range when available. */
             avgFailRatePercent?: number;
             /** @description Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
@@ -4307,7 +4379,13 @@ export interface components {
         };
         ProductivityInsightsTeamSummaryDto: {
             totalMergedPrs: number;
+            /** @description Sum of ship-weight scores for merged PRs over the selected range. */
+            totalShipWeight?: number;
+            /** @description True when merged GitHub PRs in scope still lack ship-weight scores (ingest backfill in progress). */
+            shipWeightBackfillPending?: boolean;
             avgMergedPrsPerWeek: number;
+            /** @description Mean weekly ship-weight sum over the selected range. */
+            avgShipWeightPerWeek?: number;
             /** @description Average DORA change failure rate over the range when available. */
             avgFailRatePercent: number;
             /** @description Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
@@ -4377,6 +4455,10 @@ export interface components {
             date: string;
             dayIndex: number;
             mergedPrCount: number;
+            /** @description Sum of ship-weight scores for PRs merged on this day. */
+            shipWeightSum?: number;
+            /** @description GitHub merged PRs on this day still awaiting ship-weight scoring. */
+            shipWeightPendingCount?: number;
             mergedPrs: string[];
             absent: boolean;
             absenceType?: string;
@@ -4413,14 +4495,24 @@ export interface components {
         };
         ProductivityInsightsContributorActivitySummaryDto: {
             totalMergedPrs: number;
+            /** @description Sum of ship-weight scores for merged PRs over the selected range. */
+            totalShipWeight?: number;
+            /** @description True when merged GitHub PRs in scope still lack ship-weight scores (ingest backfill in progress). */
+            shipWeightBackfillPending?: boolean;
             avgMergedPrsPerWeek: number;
+            /** @description Mean weekly ship-weight sum over the selected range. */
+            avgShipWeightPerWeek?: number;
             totalAbsenceDays: number;
             /** @description CI failure rate (%) over the selected range when GitHub Actions CI ingest is enabled (failures / runs × 100); otherwise average DORA change failure rate when available. */
             avgFailRate: number;
             /** @description Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
             avgCiFailRate?: number;
             mergedPrDelta: number;
+            /** @description Change in total ship-weight sum vs the prior comparison window. */
+            shipWeightDelta?: number;
             avgMergedPrsPerWeekDelta: number;
+            /** @description Change in mean weekly ship-weight sum vs the prior comparison window. */
+            avgShipWeightPerWeekDelta?: number;
             totalAbsenceDaysDelta: number;
             avgFailRateDelta: number;
             /** @description Change in average CI build failure rate vs the prior comparison window. */
@@ -4467,6 +4559,8 @@ export interface components {
             subtitle?: string;
             /** @description Mean weekly merged PR count across the selected range. */
             periodAvgMergedPrs: number;
+            /** @description Mean weekly ship-weight sum across the selected range. */
+            periodAvgShipWeight?: number;
             /** @description Mean weekly change-failure rate when available. */
             avgFailRatePercent?: number;
             /** @description Mean weekly GitHub Actions CI build failure rate when CI ingest is enabled. */
@@ -4826,6 +4920,10 @@ export interface components {
             date: string;
             dayLabel?: string;
             mergedPrCount: number;
+            /** @description Sum of ship-weight scores for PRs merged on this day. */
+            shipWeightSum?: number;
+            /** @description GitHub merged PRs on this day still awaiting ship-weight scoring. */
+            shipWeightPendingCount?: number;
             tokenCount: number;
         };
         AiUsageSpendRoiProductivitySignalWeekDto: {
@@ -4836,6 +4934,10 @@ export interface components {
             weekLabel?: string;
             /** @description Estimated merged PR count in the bucket from dashboard velocity metrics. */
             mergedPrCount: number;
+            /** @description Sum of ship-weight scores for PRs merged in this week bucket. */
+            shipWeightSum?: number;
+            /** @description GitHub merged PRs in this week bucket still awaiting ship-weight scoring. */
+            shipWeightPendingCount?: number;
             /** @description Total AI-tool tokens consumed in the bucket. */
             tokenCount: number;
         };
@@ -4858,6 +4960,8 @@ export interface components {
             /** Format: date-time */
             generatedAt: string;
             totalMergedPrs: number;
+            /** @description Sum of ship-weight scores for merged PRs over the selected range. */
+            totalShipWeight?: number;
             totalSpendCents: number;
             activeUsers: number;
             totalEngineers: number;
@@ -6729,6 +6833,10 @@ export interface components {
             bucketEnd: string;
             weekLabel: string;
             mergedPrCount: number;
+            /** @description Sum of ship-weight scores for PRs merged in this week bucket. */
+            shipWeightSum?: number;
+            /** @description GitHub merged PRs in this week bucket still awaiting ship-weight scoring. */
+            shipWeightPendingCount?: number;
             tokenCount: number;
         };
         YourAiJourneyAiSpendDto: {
@@ -6806,7 +6914,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" | "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" | "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;
@@ -8051,6 +8159,8 @@ export type CursorSourceConfigDto = components['schemas']['CursorSourceConfigDto
 export type ClaudeSourceDto = components['schemas']['ClaudeSourceDto'];
 export type ClaudeSourcePatchDto = components['schemas']['ClaudeSourcePatchDto'];
 export type ClaudeSourceConfigDto = components['schemas']['ClaudeSourceConfigDto'];
+export type CodeIntelligenceSourcePatchDto = components['schemas']['CodeIntelligenceSourcePatchDto'];
+export type CodeIntelligenceSourceConfigDto = components['schemas']['CodeIntelligenceSourceConfigDto'];
 export type NewRelicSourceDto = components['schemas']['NewRelicSourceDto'];
 export type NewRelicSourceConfigDto = components['schemas']['NewRelicSourceConfigDto'];
 export type PrometheusSourceDto = components['schemas']['PrometheusSourceDto'];
@@ -8062,6 +8172,7 @@ export type SonarQubeSourceConfigDto = components['schemas']['SonarQubeSourceCon
 export type PagerDutySourceDto = components['schemas']['PagerDutySourceDto'];
 export type PagerDutySourceConfigDto = components['schemas']['PagerDutySourceConfigDto'];
 export type AgentExecutionProviderDto = components['schemas']['AgentExecutionProviderDto'];
+export type PutCodeIntelligenceSettingsDto = components['schemas']['PutCodeIntelligenceSettingsDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
 export type TestConnectionResponseDto = components['schemas']['TestConnectionResponseDto'];
 export type CursorKeyUsageDto = components['schemas']['CursorKeyUsageDto'];
@@ -10026,7 +10137,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    sources: (components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
+                    sources: (components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
                 };
             };
         };
@@ -10080,7 +10191,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["TenantSourceEntryDto"];
+                "application/json": components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["TenantSourceEntryDto"];
             };
         };
         responses: {
@@ -15299,7 +15410,52 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorMessageDto"];
+                    "application/json": {
+                        /** @example invalid_body */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    putCodeIntelligenceSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PutCodeIntelligenceSettingsDto"];
+            };
+        };
+        responses: {
+            /** @description Settings updated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ok: boolean;
+                    };
+                };
+            };
+            /** @description Invalid request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_body */
+                        error: string;
+                    };
                 };
             };
             401: components["responses"]["Unauthorized"];

package/src/index.ts

@@ -291,6 +291,10 @@ export interface DashboardProductivityMetricsDto {
     prsPerDeveloperPerWeek?: number;
     /** Raw merged PR count in the metrics window (all scopes). */
     mergedPrCount?: number;
+    /** Sum of ship-weight scores for PRs merged in the metrics window. */
+    shipWeightSum?: number;
+    /** Alias of shipWeightSum for single-window productivity cards. */
+    totalShipWeight?: number;
     avgPrMergeTimeHours?: number;
     /** Per-PR summaries for contributor drilldown (stored during productivity ingest). */
     mergedPullRequests?: {
@@ -486,6 +490,10 @@ export type ProductivityInsightsGranularity = "day" | "week";
 export interface ProductivityInsightsDailyBucketDto {
   date: string;
   mergedPrCount: number;
+  /** Sum of ship-weight scores for PRs merged on this day. */
+  shipWeightSum?: number;
+  /** GitHub merged PRs on this day still awaiting ship-weight scoring. */
+  shipWeightPendingCount?: number;
   ciFailuresCount?: number;
   /** Mean hours from PR creation to first review for PRs merged on this day. */
   avgReviewWaitHours?: number;
@@ -506,6 +514,10 @@ export interface ProductivityInsightsAggregatedTeamWeekDto {
   bucketEnd: string;
   weekLabel?: string;
   mergedPrCount: number;
+  /** Sum of ship-weight scores for PRs merged in this week bucket. */
+  shipWeightSum?: number;
+  /** GitHub merged PRs in this week bucket still awaiting ship-weight scoring. */
+  shipWeightPendingCount?: number;
   failRatePercent: number;
   /** GitHub Actions CI build failure rate (failed / (failed + passed) * 100). */
   ciFailRatePercent?: number;
@@ -551,6 +563,10 @@ export interface ProductivityInsightsMergedPrTrendWeekDto {
   bucketEnd: string;
   weekLabel?: string;
   mergedPrCount: number;
+  /** Sum of ship-weight scores for PRs merged in this week bucket. */
+  shipWeightSum?: number;
+  /** GitHub merged PRs in this week bucket still awaiting ship-weight scoring. */
+  shipWeightPendingCount?: number;
 }
 
 /** Per-contributor merged PR weekly series. */
@@ -591,6 +607,8 @@ export interface ProductivityInsightsTeamLeaderItemDto {
   teamName: string;
   subtitle?: string;
   periodAvgMergedPrs: number;
+  /** Period average ship-weight sum per week. */
+  periodAvgShipWeight?: number;
   avgFailRatePercent?: number;
   avgCiFailRatePercent?: number;
 }
@@ -598,7 +616,11 @@ export interface ProductivityInsightsTeamLeaderItemDto {
 /** Period summary for a single-team drilldown. */
 export interface ProductivityInsightsTeamSummaryDto {
   totalMergedPrs: number;
+  totalShipWeight?: number;
+  /** True when merged GitHub PRs in scope still lack ship-weight scores. */
+  shipWeightBackfillPending?: boolean;
   avgMergedPrsPerWeek: number;
+  avgShipWeightPerWeek?: number;
   avgFailRatePercent: number;
   /** Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
   avgCiFailRatePercent?: number;
@@ -681,6 +703,10 @@ export interface ProductivityInsightsContributorActivityDayDto {
   date: string;
   dayIndex: number;
   mergedPrCount: number;
+  /** Sum of ship-weight scores for PRs merged on this day. */
+  shipWeightSum?: number;
+  /** GitHub merged PRs on this day still awaiting ship-weight scoring. */
+  shipWeightPendingCount?: number;
   mergedPrs: string[];
   /** Optional PR links when ingest stored URLs. */
   mergedPrItems?: ProductivityInsightsContributorMergedPrItemDto[];
@@ -703,14 +729,20 @@ export interface ProductivityInsightsContributorActivityWeekDto {
 /** Summary stats for contributor activity drilldown. */
 export interface ProductivityInsightsContributorActivitySummaryDto {
   totalMergedPrs: number;
+  totalShipWeight?: number;
+  /** True when merged GitHub PRs in scope still lack ship-weight scores. */
+  shipWeightBackfillPending?: boolean;
   avgMergedPrsPerWeek: number;
+  avgShipWeightPerWeek?: number;
   totalAbsenceDays: number;
   /** CI failure rate (%) over the range when GitHub Actions CI ingest is enabled; otherwise DORA change failure rate when available. */
   avgFailRate: number;
   /** Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
   avgCiFailRate?: number;
   mergedPrDelta: number;
+  shipWeightDelta?: number;
   avgMergedPrsPerWeekDelta: number;
+  avgShipWeightPerWeekDelta?: number;
   totalAbsenceDaysDelta: number;
   avgFailRateDelta: number;
   /** Change in average CI build failure rate vs the prior comparison window. */
@@ -746,6 +778,8 @@ export interface ProductivityInsightsNeedsAttentionItemDto {
   name: string;
   subtitle?: string;
   periodAvgMergedPrs: number;
+  /** Period average ship-weight sum per week. */
+  periodAvgShipWeight?: number;
   avgFailRatePercent?: number;
   avgCiFailRatePercent?: number;
 }