@thinkai/tai-api-contract 2.92.0 → 2.94.0

package/src/generated/openapi.ts

@@ -4178,6 +4178,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: {
@@ -4230,6 +4240,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. */
@@ -4249,6 +4263,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. */
@@ -4309,6 +4327,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). */
@@ -4358,6 +4380,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. */
@@ -4365,7 +4389,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. */
@@ -4435,6 +4465,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;
@@ -4471,14 +4505,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. */
@@ -4525,6 +4569,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. */
@@ -4884,6 +4930,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: {
@@ -4894,6 +4944,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;
         };
@@ -4916,6 +4970,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;
@@ -6787,6 +6843,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: {

package/src/index.ts

@@ -291,6 +291,12 @@ 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;
+    /** 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?: {
@@ -486,6 +492,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 +516,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 +565,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 +609,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 +618,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 +705,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 +731,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 +780,8 @@ export interface ProductivityInsightsNeedsAttentionItemDto {
   name: string;
   subtitle?: string;
   periodAvgMergedPrs: number;
+  /** Period average ship-weight sum per week. */
+  periodAvgShipWeight?: number;
   avgFailRatePercent?: number;
   avgCiFailRatePercent?: number;
 }