@thinkai/tai-api-contract 2.116.0 → 2.119.0

package/src/index.ts

@@ -1289,6 +1289,122 @@ export interface WorkspaceAbsenceListDto {
   syncedAt: string | null;
 }
 
+/** Inclusive missing coverage range (calendar day or UTC Monday week ISO). */
+export interface IngestCoverageGapDto {
+  from: string;
+  to: string;
+}
+
+/** Timing for the latest ingest/refresh run. */
+export interface IngestCoverageLastRunDto {
+  startedAt?: string | null;
+  completedAt?: string | null;
+  durationMs?: number | null;
+  mode?: string | null;
+  outcome?: "ok" | "failed" | "in_progress" | null;
+}
+
+export interface IngestCoverageProductivityRepoDto {
+  slug: string;
+  queueStatus: "pending" | "complete" | "failed" | "skipped";
+  weeksWithData?: number | null;
+  earliestWeek?: string | null;
+  latestWeek?: string | null;
+  missingWeeks?: number | null;
+  gaps?: IngestCoverageGapDto[];
+  lastErrorKind?: string | null;
+}
+
+export interface IngestCoverageProductivityDetailDto {
+  phase?: "recent" | "historical" | "complete" | null;
+  historicalWeekStart?: string | null;
+  pendingRepoCount?: number;
+  skippedRepoCount?: number;
+  failedRepoCount?: number;
+  coveragePercent?: number | null;
+  repos?: IngestCoverageProductivityRepoDto[];
+}
+
+export interface IngestCoverageFactFamilyDto {
+  id: "daily_usage" | "spend_daily" | "model_daily" | "product_daily";
+  expectedDays?: number;
+  daysPresent?: number;
+  ingestedFrom?: string | null;
+  ingestedTo?: string | null;
+  missingDayCount?: number;
+  gaps?: IngestCoverageGapDto[];
+}
+
+export interface IngestCoverageAiDetailDto {
+  factFamilies?: IngestCoverageFactFamilyDto[];
+  refreshInProgress?: boolean;
+}
+
+export interface IngestCoverageSdlcComponentDto {
+  id:
+    | "rollup"
+    | "security_ingest"
+    | "governance_github"
+    | "governance_auditor"
+    | "financial_ingest"
+    | "cost_refresher";
+  latestBucketDate?: string | null;
+  lookbackDays?: number;
+  mode?: string | null;
+  gaps?: IngestCoverageGapDto[];
+  missingCount?: number | null;
+  lastSuccessAt?: string | null;
+  staleForMs?: number | null;
+  isStale?: boolean;
+}
+
+export interface IngestCoverageSdlcDetailDto {
+  components?: IngestCoverageSdlcComponentDto[];
+}
+
+export interface IngestCoverageSyncDetailDto {
+  provider?: string;
+  syncStatus?: "ok" | "error" | "never";
+}
+
+export type IngestCoveragePipelineKind =
+  "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+
+export type IngestCoveragePipelineStatus =
+  "not_started" | "backfilling" | "incremental" | "complete" | "failed" | "in_progress";
+
+/** One connected ingest pipeline in GET /workspaces/:id/ingest-coverage. */
+export interface IngestCoveragePipelineDto {
+  id: string;
+  kind: IngestCoveragePipelineKind;
+  provider?: string | null;
+  status: IngestCoveragePipelineStatus;
+  targetWindowDays: number;
+  ingestedFrom?: string | null;
+  ingestedTo?: string | null;
+  progressPercent?: number | null;
+  lastSuccessAt?: string | null;
+  lastAttemptAt?: string | null;
+  lastErrorKind?: string | null;
+  lastErrorMessage?: string | null;
+  staleForMs?: number | null;
+  isStale: boolean;
+  dataLagDays?: number | null;
+  gaps?: IngestCoverageGapDto[];
+  missingCount?: number | null;
+  lastRun?: IngestCoverageLastRunDto;
+  productivity?: IngestCoverageProductivityDetailDto;
+  ai?: IngestCoverageAiDetailDto;
+  sdlc?: IngestCoverageSdlcDetailDto;
+  sync?: IngestCoverageSyncDetailDto;
+}
+
+/** Response body for GET /workspaces/:id/ingest-coverage. */
+export interface IngestCoverageDto {
+  pipelines: IngestCoveragePipelineDto[];
+  generatedAt?: string;
+}
+
 /** Sync status for a single HRIS provider connected to a workspace. */
 export interface HrisSyncStatusDto {
   /** Provider identifier ('personio', 'zenhr', …). */