@thinkai/tai-api-contract 2.35.0 → 2.37.0-pr.810.cb825825

package/src/index.ts

@@ -302,6 +302,26 @@ export interface DashboardProductivityMetricsDto {
   quality?: {
     codeReviewHoursPerWeek?: number;
     buildFailuresPerWeek?: number;
+    /** Share of completed CI runs that failed (GitHub Actions / Checks). */
+    ciBuildFailRatePercent?: number;
+    /** Count of build.failed events in the bucket window. */
+    ciBuildFailuresCount?: number;
+    /** Share of completed CI runs that failed (GitHub Actions / Checks). Alias of ciFailureRatePercent. */
+    ciFailureRatePercent?: number;
+    /** Count of build.passed + build.failed events in the bucket window. */
+    ciRunsTotal?: number;
+    /** Count of build.failed events in the bucket window. Alias of ciBuildFailuresCount. */
+    ciFailuresTotal?: number;
+    /** Failed CI workflow runs in the bucket window (for contributor day mapping). */
+    ciFailureRuns?: {
+      occurredAt: string;
+      label: string;
+      url?: string;
+      workflowName?: string;
+      repo?: string;
+      branch?: string;
+      prNumber?: number;
+    }[];
     avgTimeToFixBuildHours?: number;
     testCoveragePercent?: number;
     escapedBugsCount?: number;
@@ -460,6 +480,10 @@ export interface ProductivityInsightsAggregatedTeamWeekDto {
   weekLabel?: string;
   mergedPrCount: number;
   failRatePercent: number;
+  /** GitHub Actions CI build failure rate (failed / (failed + passed) * 100). */
+  ciFailRatePercent?: number;
+  /** Count of build.failed events in the bucket when CI ingest is enabled. */
+  ciBuildFailuresCount?: number;
   avgReviewWaitHours?: number;
   avgApprovalHours?: number;
   avgTimeToMergeHours?: number;
@@ -484,6 +508,8 @@ export interface ProductivityInsightsAggregatedTeamsDto {
   range: "4w" | "8w" | "q" | "12w" | "16w";
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
   generatedAt: string;
+  /** True when the workspace has opted in to GitHub Actions CI ingest. */
+  githubActionsCiEnabled?: boolean;
   teams: ProductivityInsightsAggregatedTeamRowDto[];
 }
 
@@ -525,6 +551,7 @@ export interface ProductivityInsightsTeamLeaderItemDto {
   subtitle?: string;
   periodAvgMergedPrs: number;
   avgFailRatePercent?: number;
+  avgCiFailRatePercent?: number;
 }
 
 /** Period summary for a single-team drilldown. */
@@ -532,6 +559,8 @@ export interface ProductivityInsightsTeamSummaryDto {
   totalMergedPrs: number;
   avgMergedPrsPerWeek: number;
   avgFailRatePercent: number;
+  /** Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
+  avgCiFailRatePercent?: number;
   headcount: number;
 }
 
@@ -560,6 +589,8 @@ export interface ProductivityInsightsTeamsResponseDto {
   year?: number;
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
   generatedAt: string;
+  /** True when the workspace has opted in to GitHub Actions CI ingest. */
+  githubActionsCiEnabled?: boolean;
   /** Top-ranked teams when `teamId` query is omitted. */
   items?: ProductivityInsightsTeamLeaderItemDto[];
   /** Single-team drilldown when `teamId` query is set. */
@@ -585,6 +616,18 @@ export interface ProductivityInsightsContributorMergedPrItemDto {
   url?: string;
 }
 
+/** One failed GitHub Actions workflow run on a contributor activity day. */
+export interface ProductivityInsightsContributorFailureItemDto {
+  label: string;
+  url?: string;
+  workflowName?: string;
+  repo?: string;
+  branch?: string;
+  occurredAt?: string;
+  /** GitHub pull request number when CI ingest captured it on the failed run. */
+  prNumber?: number;
+}
+
 /** One calendar day in contributor activity heatmap. */
 export interface ProductivityInsightsContributorActivityDayDto {
   date: string;
@@ -597,6 +640,8 @@ export interface ProductivityInsightsContributorActivityDayDto {
   absenceType?: string;
   failureSignal: boolean;
   failures: string[];
+  /** Failed CI workflow runs for this UTC day when GitHub Actions CI ingest is enabled. */
+  failureItems?: ProductivityInsightsContributorFailureItemDto[];
 }
 
 /** One weekly row in contributor activity heatmap. */
@@ -612,11 +657,16 @@ export interface ProductivityInsightsContributorActivitySummaryDto {
   totalMergedPrs: number;
   avgMergedPrsPerWeek: 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;
   avgMergedPrsPerWeekDelta: number;
   totalAbsenceDaysDelta: number;
   avgFailRateDelta: number;
+  /** Change in average CI build failure rate vs the prior comparison window. */
+  avgCiFailRateDelta?: number;
 }
 
 /** Response for GET /workspaces/:workspaceId/insights/productivity-insights/contributors/:contributorId */
@@ -628,6 +678,8 @@ export interface ProductivityInsightsContributorDetailDto {
   year?: number;
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
   generatedAt: string;
+  /** True when the workspace has opted in to GitHub Actions CI ingest. */
+  githubActionsCiEnabled?: boolean;
   contributor: ProductivityInsightsContributorProfileDto;
   weeks: ProductivityInsightsContributorActivityWeekDto[];
   summary: ProductivityInsightsContributorActivitySummaryDto;
@@ -642,6 +694,7 @@ export interface ProductivityInsightsNeedsAttentionItemDto {
   subtitle?: string;
   periodAvgMergedPrs: number;
   avgFailRatePercent?: number;
+  avgCiFailRatePercent?: number;
 }
 
 /** Response for GET /workspaces/:workspaceId/insights/productivity-insights/needs-attention */
@@ -651,6 +704,7 @@ export interface ProductivityInsightsNeedsAttentionDto {
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
   entityType: "teams" | "contributors";
   generatedAt: string;
+  githubActionsCiEnabled?: boolean;
   items: ProductivityInsightsNeedsAttentionItemDto[];
 }