@thinkai/tai-api-contract 2.35.0 → 2.37.0-pr.798.0cc49094

package/src/generated/openapi.ts

@@ -426,6 +426,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/persons/{personId}/erase": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Erase person-level insights data (workspace admin)
+         * @description Workspace admin only. Deletes or anonymizes a person's developer-insights rows for the workspace: org-chart node, person-scope dashboard metrics, AI-tool fact rows, HRIS absences, and readiness run requester linkage. Granular categories default to all enabled when the body is omitted. `personId` is the org-chart `person_id` (typically work email); URL-encode the path segment (e.g. `alice%40example.com`).
+         */
+        post: operations["eraseInsightsPerson"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/insights/ai-usage-spend/aggregated-teams": {
         parameters: {
             query?: never;
@@ -2085,6 +2105,27 @@ export interface components {
             /** @enum {string} */
             role: "admin" | "editor" | "viewer";
         };
+        /** @description Granular person erasure categories. All default to true when omitted. */
+        EraseInsightsPersonBodyDto: {
+            /** @description Remove the person node from `tai_workspace_config.org_chart`. */
+            orgChart?: boolean;
+            /** @description Delete person-scope rows in `tai_workspace_dashboard_metrics`. */
+            dashboardMetrics?: boolean;
+            /** @description Delete AI-tool seats and fact rows keyed to the person. */
+            aiToolData?: boolean;
+            /** @description Delete HRIS absence rows for the person's email. */
+            absences?: boolean;
+            /** @description Clear `requested_by_user_id` on readiness runs for matching app users. */
+            readinessAnonymize?: boolean;
+        };
+        EraseInsightsPersonResultDto: {
+            /** @enum {boolean} */
+            deleted: true;
+            aiToolRowsDeleted: number;
+            absencesDeleted: number;
+            readinessRunsAnonymized: number;
+            auditEntriesAnonymized: number;
+        };
         OrgChartNodeDto: {
             id: string;
             name: string;
@@ -2394,7 +2435,12 @@ export interface components {
             /** @description Short label for the week column (MM/DD), aligned with Measure charts. */
             weekLabel?: string;
             mergedPrCount: 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. */
+            ciFailRatePercent?: number;
+            /** @description Count of build.failed events in the week bucket when CI ingest is enabled. */
+            ciBuildFailuresCount?: number;
             /** @description Mean hours from PR creation to first review in this week bucket. */
             avgReviewWaitHours?: number;
             /** @description Mean hours from first review to first approval in this week bucket. */
@@ -2427,6 +2473,8 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
+            /** @description True when the workspace has opted in to GitHub Actions CI ingest. */
+            githubActionsCiEnabled?: boolean;
             teams: components["schemas"]["ProductivityInsightsAggregatedTeamRowDto"][];
         };
         ProductivityInsightsMergedPrTrendWeekDto: {
@@ -2471,11 +2519,16 @@ export interface components {
             periodAvgMergedPrs: 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. */
+            avgCiFailRatePercent?: number;
         };
         ProductivityInsightsTeamSummaryDto: {
             totalMergedPrs: number;
             avgMergedPrsPerWeek: 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. */
+            avgCiFailRatePercent?: number;
             headcount: number;
         };
         ProductivityInsightsTeamDetailDto: {
@@ -2502,6 +2555,8 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
+            /** @description True when the workspace has opted in to GitHub Actions CI ingest. */
+            githubActionsCiEnabled?: boolean;
             /** @description Present when `teamId` query is omitted — top-ranked teams. */
             items?: components["schemas"]["ProductivityInsightsTeamLeaderItemDto"][];
             /** @description Present when `teamId` query is set — single-team drilldown. */
@@ -2529,6 +2584,8 @@ export interface components {
             absenceType?: string;
             failureSignal: boolean;
             failures: string[];
+            /** @description Failed GitHub Actions workflow runs for this UTC day when CI ingest is enabled. */
+            failureItems?: components["schemas"]["ProductivityInsightsContributorFailureItemDto"][];
             /** @description Optional PR rows with GitHub links when ingest stored URLs. */
             mergedPrItems?: components["schemas"]["ProductivityInsightsContributorMergedPrItemDto"][];
         };
@@ -2537,6 +2594,17 @@ export interface components {
             /** Format: uri */
             url?: string;
         };
+        ProductivityInsightsContributorFailureItemDto: {
+            label: string;
+            /** Format: uri */
+            url?: string;
+            workflowName?: string;
+            /** @description GitHub repository slug (owner/repo). */
+            repo?: string;
+            branch?: string;
+            /** Format: date-time */
+            occurredAt?: string;
+        };
         ProductivityInsightsContributorActivityWeekDto: {
             label: string;
             /** Format: date-time */
@@ -2549,11 +2617,16 @@ export interface components {
             totalMergedPrs: number;
             avgMergedPrsPerWeek: 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;
             avgMergedPrsPerWeekDelta: number;
             totalAbsenceDaysDelta: number;
             avgFailRateDelta: number;
+            /** @description Change in average CI build failure rate vs the prior comparison window. */
+            avgCiFailRateDelta?: number;
         };
         ProductivityInsightsContributorDetailDto: {
             /** Format: uuid */
@@ -2565,6 +2638,8 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
+            /** @description True when the workspace has opted in to GitHub Actions CI ingest. */
+            githubActionsCiEnabled?: boolean;
             contributor: components["schemas"]["ProductivityInsightsContributorProfileDto"];
             weeks: components["schemas"]["ProductivityInsightsContributorActivityWeekDto"][];
             summary: components["schemas"]["ProductivityInsightsContributorActivitySummaryDto"];
@@ -2583,6 +2658,8 @@ export interface components {
             periodAvgMergedPrs: 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. */
+            avgCiFailRatePercent?: number;
         };
         ProductivityInsightsNeedsAttentionDto: {
             /** Format: uuid */
@@ -2593,6 +2670,8 @@ export interface components {
             entityType: "teams" | "contributors";
             /** Format: date-time */
             generatedAt: string;
+            /** @description True when GitHub Actions CI ingest is enabled for this workspace. */
+            githubActionsCiEnabled?: boolean;
             items: components["schemas"]["ProductivityInsightsNeedsAttentionItemDto"][];
         };
         AiUsageSpendAggregatedTeamWeekDto: {
@@ -4303,6 +4382,8 @@ export type TeamMemberDto = components['schemas']['TeamMemberDto'];
 export type TeamMemberListDto = components['schemas']['TeamMemberListDto'];
 export type InviteTeamMemberBodyDto = components['schemas']['InviteTeamMemberBodyDto'];
 export type UpdateTeamMemberRoleBodyDto = components['schemas']['UpdateTeamMemberRoleBodyDto'];
+export type EraseInsightsPersonBodyDto = components['schemas']['EraseInsightsPersonBodyDto'];
+export type EraseInsightsPersonResultDto = components['schemas']['EraseInsightsPersonResultDto'];
 export type OrgChartNodeDto = components['schemas']['OrgChartNodeDto'];
 export type OrgChartTreeNodeDto = components['schemas']['OrgChartTreeNodeDto'];
 export type ScoringOrgChartDto = components['schemas']['ScoringOrgChartDto'];
@@ -4345,6 +4426,7 @@ export type ProductivityInsightsTeamsResponseDto = components['schemas']['Produc
 export type ProductivityInsightsContributorProfileDto = components['schemas']['ProductivityInsightsContributorProfileDto'];
 export type ProductivityInsightsContributorActivityDayDto = components['schemas']['ProductivityInsightsContributorActivityDayDto'];
 export type ProductivityInsightsContributorMergedPrItemDto = components['schemas']['ProductivityInsightsContributorMergedPrItemDto'];
+export type ProductivityInsightsContributorFailureItemDto = components['schemas']['ProductivityInsightsContributorFailureItemDto'];
 export type ProductivityInsightsContributorActivityWeekDto = components['schemas']['ProductivityInsightsContributorActivityWeekDto'];
 export type ProductivityInsightsContributorActivitySummaryDto = components['schemas']['ProductivityInsightsContributorActivitySummaryDto'];
 export type ProductivityInsightsContributorDetailDto = components['schemas']['ProductivityInsightsContributorDetailDto'];
@@ -5648,6 +5730,63 @@ export interface operations {
             };
         };
     };
+    eraseInsightsPerson: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Org-chart person_id (URL-encoded when it contains `@`). */
+                personId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                /**
+                 * @example {
+                 *       "orgChart": true,
+                 *       "dashboardMetrics": true,
+                 *       "aiToolData": true,
+                 *       "absences": true,
+                 *       "readinessAnonymize": true
+                 *     }
+                 */
+                "application/json": components["schemas"]["EraseInsightsPersonBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Person data erased or anonymized */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EraseInsightsPersonResultDto"];
+                };
+            };
+            /** @description Invalid body or personId */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace not found, malformed workspaceId, or person not in org chart */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAiUsageSpendAggregatedTeams: {
         parameters: {
             query?: {

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