@thinkai/tai-api-contract 2.48.0 → 2.49.0

package/src/index.ts

@@ -473,6 +473,19 @@ export interface ProductivityInsightsAggregatedTeamsScopeDto {
   team: string;
 }
 
+/** Resolved time bucket for productivity insights responses. */
+export type ProductivityInsightsGranularity = "day" | "week";
+
+/** Daily merged PR / CI failure bucket for productivity trend charts. */
+export interface ProductivityInsightsDailyBucketDto {
+  date: string;
+  mergedPrCount: number;
+  ciFailuresCount?: number;
+}
+
+/** Productivity insights range id — daily (`7d`, `30d`, `cr:…`) or weekly legacy. */
+export type ProductivityInsightsRangeId = string;
+
 /** One weekly bucket in an aggregated team row. */
 export interface ProductivityInsightsAggregatedTeamWeekDto {
   bucketStart: string;
@@ -499,13 +512,18 @@ export interface ProductivityInsightsAggregatedTeamRowDto {
   managerLabel?: string;
   /** True when the team aggregates GitHub logins not mapped in the org chart (`teamId` `__other`). */
   notInOrgChart?: boolean;
-  weeks: ProductivityInsightsAggregatedTeamWeekDto[];
+  /** Present in day-mode responses. */
+  days?: ProductivityInsightsDailyBucketDto[];
+  weeks?: ProductivityInsightsAggregatedTeamWeekDto[];
 }
 
 /** Response for GET /workspaces/:workspaceId/insights/productivity-insights/aggregated-teams */
 export interface ProductivityInsightsAggregatedTeamsDto {
   workspaceId: string;
-  range: "4w" | "8w" | "q" | "12w" | "16w";
+  range: ProductivityInsightsRangeId;
+  granularity?: ProductivityInsightsGranularity;
+  from?: string;
+  to?: string;
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
   generatedAt: string;
   /** True when the workspace has opted in to GitHub Actions CI ingest. */
@@ -532,16 +550,23 @@ export interface ProductivityInsightsMergedPrContributorRowDto {
   notInOrgChart?: boolean;
   /** GitHub login for unattributed contributors (`notInOrgChart: true`). */
   githubLogin?: string;
-  weeks: ProductivityInsightsMergedPrTrendWeekDto[];
+  /** Present in day-mode responses. */
+  days?: ProductivityInsightsDailyBucketDto[];
+  weeks?: ProductivityInsightsMergedPrTrendWeekDto[];
 }
 
 /** Response for GET /workspaces/:workspaceId/insights/productivity-insights/merged-pr-trends */
 export interface ProductivityInsightsMergedPrTrendsDto {
   workspaceId: string;
-  range: "4w" | "8w" | "q" | "12w" | "16w";
+  range: ProductivityInsightsRangeId;
+  granularity?: ProductivityInsightsGranularity;
+  from?: string;
+  to?: string;
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
   generatedAt: string;
-  weeks: ProductivityInsightsMergedPrTrendWeekDto[];
+  /** Portfolio daily series in day mode. */
+  days?: ProductivityInsightsDailyBucketDto[];
+  weeks?: ProductivityInsightsMergedPrTrendWeekDto[];
   contributors: ProductivityInsightsMergedPrContributorRowDto[];
 }
 
@@ -574,7 +599,9 @@ export interface ProductivityInsightsTeamDetailDto {
   managerLabel?: string;
   /** True when the team aggregates GitHub logins not mapped in the org chart (`teamId` `__other`). */
   notInOrgChart?: boolean;
-  weeks: ProductivityInsightsAggregatedTeamWeekDto[];
+  /** Daily merged PR series for the selected period in day mode. */
+  days?: ProductivityInsightsDailyBucketDto[];
+  weeks?: ProductivityInsightsAggregatedTeamWeekDto[];
   summary: ProductivityInsightsTeamSummaryDto;
   /** Present when the request included `year` — calendar-year heatmap mode. */
   year?: number;
@@ -588,7 +615,10 @@ export interface ProductivityInsightsTeamDetailDto {
 /** Response for GET /workspaces/:workspaceId/insights/productivity-insights/teams */
 export interface ProductivityInsightsTeamsResponseDto {
   workspaceId: string;
-  range: "4w" | "8w" | "q" | "12w" | "16w";
+  range: ProductivityInsightsRangeId;
+  granularity?: ProductivityInsightsGranularity;
+  from?: string;
+  to?: string;
   /** Present when the request included `year` — calendar-year heatmap mode. */
   year?: number;
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
@@ -677,7 +707,10 @@ export interface ProductivityInsightsContributorActivitySummaryDto {
 export interface ProductivityInsightsContributorDetailDto {
   workspaceId: string;
   contributorId: string;
-  range: "4w" | "8w" | "q" | "12w" | "16w";
+  range: ProductivityInsightsRangeId;
+  granularity?: ProductivityInsightsGranularity;
+  from?: string;
+  to?: string;
   /** Present when the request included `year` — calendar-year contribution heatmap mode. */
   year?: number;
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
@@ -685,7 +718,9 @@ export interface ProductivityInsightsContributorDetailDto {
   /** True when the workspace has opted in to GitHub Actions CI ingest. */
   githubActionsCiEnabled?: boolean;
   contributor: ProductivityInsightsContributorProfileDto;
-  weeks: ProductivityInsightsContributorActivityWeekDto[];
+  /** Daily merged PR series for the selected period in day mode. */
+  days?: ProductivityInsightsDailyBucketDto[];
+  weeks?: ProductivityInsightsContributorActivityWeekDto[];
   summary: ProductivityInsightsContributorActivitySummaryDto;
 }
 
@@ -704,7 +739,10 @@ export interface ProductivityInsightsNeedsAttentionItemDto {
 /** Response for GET /workspaces/:workspaceId/insights/productivity-insights/needs-attention */
 export interface ProductivityInsightsNeedsAttentionDto {
   workspaceId: string;
-  range: "4w" | "8w" | "q" | "12w" | "16w";
+  range: ProductivityInsightsRangeId;
+  granularity?: ProductivityInsightsGranularity;
+  from?: string;
+  to?: string;
   scope: ProductivityInsightsAggregatedTeamsScopeDto;
   entityType: "teams" | "contributors";
   generatedAt: string;