@thinkai/tai-api-contract 2.92.0 → 2.93.0

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;
 }