@thinkai/tai-api-contract 2.118.0 → 2.120.0

package/src/generated/openapi.ts

@@ -3924,6 +3924,26 @@ export interface paths {
         patch: operations["patchWorkspaceZenHrBranch"];
         trace?: never;
     };
+    "/workspaces/{workspaceId}/ingest-coverage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Ingest / backfill data coverage
+         * @description Read-only snapshot of historical ingest coverage for connected pipelines (productivity GitHub, AI usage/spend per provider, SDLC components, monitoring, HRIS). Aggregates existing watermarks and stored day/week evidence — does not trigger ingest or refresh. Requires workspace membership. Disconnected sources are omitted.
+         */
+        get: operations["getWorkspaceIngestCoverage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/hris/status": {
         parameters: {
             query?: never;
@@ -7651,6 +7671,119 @@ export interface components {
              */
             syncedAt: string | null;
         };
+        IngestCoverageGapDto: {
+            /** @description Inclusive gap start (ISO date or UTC Monday week start). */
+            from: string;
+            /** @description Inclusive gap end (ISO date or UTC Monday week start). */
+            to: string;
+        };
+        IngestCoverageLastRunDto: {
+            /** Format: date-time */
+            startedAt?: string | null;
+            /** Format: date-time */
+            completedAt?: string | null;
+            /** Format: int64 */
+            durationMs?: number | null;
+            /** @description Pipeline-specific run mode (e.g. recent, historical, refresh). */
+            mode?: string | null;
+            /** @enum {string|null} */
+            outcome?: "ok" | "failed" | "in_progress" | null;
+        };
+        IngestCoverageProductivityRepoDto: {
+            slug: string;
+            /** @enum {string} */
+            queueStatus: "pending" | "complete" | "failed" | "skipped";
+            weeksWithData?: number | null;
+            earliestWeek?: string | null;
+            latestWeek?: string | null;
+            missingWeeks?: number | null;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+            lastErrorKind?: string | null;
+        };
+        IngestCoverageProductivityDetailDto: {
+            /** @enum {string|null} */
+            phase?: "recent" | "historical" | "complete" | null;
+            historicalWeekStart?: string | null;
+            pendingRepoCount?: number;
+            skippedRepoCount?: number;
+            failedRepoCount?: number;
+            coveragePercent?: number | null;
+            repos?: components["schemas"]["IngestCoverageProductivityRepoDto"][];
+        };
+        IngestCoverageFactFamilyDto: {
+            /** @enum {string} */
+            id: "daily_usage" | "spend_daily" | "model_daily" | "product_daily";
+            expectedDays?: number;
+            daysPresent?: number;
+            ingestedFrom?: string | null;
+            ingestedTo?: string | null;
+            missingDayCount?: number;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+        };
+        IngestCoverageAiDetailDto: {
+            factFamilies?: components["schemas"]["IngestCoverageFactFamilyDto"][];
+            refreshInProgress?: boolean;
+        };
+        IngestCoverageSdlcComponentDto: {
+            /** @enum {string} */
+            id: "rollup" | "security_ingest" | "governance_github" | "governance_auditor" | "financial_ingest" | "cost_refresher";
+            latestBucketDate?: string | null;
+            lookbackDays?: number;
+            mode?: string | null;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+            missingCount?: number | null;
+            /** Format: date-time */
+            lastSuccessAt?: string | null;
+            /** Format: int64 */
+            staleForMs?: number | null;
+            isStale?: boolean;
+            /** @enum {string|null} */
+            staleReason?: "sync_age" | "data_lag" | "both" | null;
+        };
+        IngestCoverageSdlcDetailDto: {
+            components?: components["schemas"]["IngestCoverageSdlcComponentDto"][];
+        };
+        IngestCoverageSyncDetailDto: {
+            provider?: string;
+            /** @enum {string} */
+            syncStatus?: "ok" | "error" | "never";
+        };
+        IngestCoveragePipelineDto: {
+            id: string;
+            /** @enum {string} */
+            kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+            provider?: string | null;
+            /** @enum {string} */
+            status: "not_started" | "backfilling" | "incremental" | "complete" | "failed" | "in_progress";
+            targetWindowDays: number;
+            ingestedFrom?: string | null;
+            ingestedTo?: string | null;
+            progressPercent?: number | null;
+            /** Format: date-time */
+            lastSuccessAt?: string | null;
+            /** Format: date-time */
+            lastAttemptAt?: string | null;
+            lastErrorKind?: string | null;
+            lastErrorMessage?: string | null;
+            /** Format: int64 */
+            staleForMs?: number | null;
+            isStale: boolean;
+            dataLagDays?: number | null;
+            /** @enum {string|null} */
+            staleReason?: "sync_age" | "data_lag" | "both" | null;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+            missingCount?: number | null;
+            lastRun?: components["schemas"]["IngestCoverageLastRunDto"];
+            productivity?: components["schemas"]["IngestCoverageProductivityDetailDto"];
+            ai?: components["schemas"]["IngestCoverageAiDetailDto"];
+            sdlc?: components["schemas"]["IngestCoverageSdlcDetailDto"];
+            sync?: components["schemas"]["IngestCoverageSyncDetailDto"];
+        };
+        IngestCoverageDto: {
+            pipelines: components["schemas"]["IngestCoveragePipelineDto"][];
+            /** Format: date-time */
+            generatedAt?: string;
+        };
         HrisSyncStatusDto: {
             /** @description Provider identifier (e.g. 'personio', 'zenhr'). */
             provider: string;
@@ -7933,7 +8066,7 @@ export interface components {
         InsightsResponseMeta: {
             /**
              * Format: date-time
-             * @description ISO timestamp when numbers were computed server-side
+             * @description ISO timestamp when numbers were computed server-side. An empty string means the workspace has no successful AI-tool refresh or productivity ingest timestamp yet.
              */
             syncedAt: string;
             /**
@@ -9597,6 +9730,17 @@ export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
 export type ActivityLogEntryDto = components['schemas']['ActivityLogEntryDto'];
 export type WorkspaceAbsenceDto = components['schemas']['WorkspaceAbsenceDto'];
 export type WorkspaceAbsenceListDto = components['schemas']['WorkspaceAbsenceListDto'];
+export type IngestCoverageGapDto = components['schemas']['IngestCoverageGapDto'];
+export type IngestCoverageLastRunDto = components['schemas']['IngestCoverageLastRunDto'];
+export type IngestCoverageProductivityRepoDto = components['schemas']['IngestCoverageProductivityRepoDto'];
+export type IngestCoverageProductivityDetailDto = components['schemas']['IngestCoverageProductivityDetailDto'];
+export type IngestCoverageFactFamilyDto = components['schemas']['IngestCoverageFactFamilyDto'];
+export type IngestCoverageAiDetailDto = components['schemas']['IngestCoverageAiDetailDto'];
+export type IngestCoverageSdlcComponentDto = components['schemas']['IngestCoverageSdlcComponentDto'];
+export type IngestCoverageSdlcDetailDto = components['schemas']['IngestCoverageSdlcDetailDto'];
+export type IngestCoverageSyncDetailDto = components['schemas']['IngestCoverageSyncDetailDto'];
+export type IngestCoveragePipelineDto = components['schemas']['IngestCoveragePipelineDto'];
+export type IngestCoverageDto = components['schemas']['IngestCoverageDto'];
 export type HrisSyncStatusDto = components['schemas']['HrisSyncStatusDto'];
 export type HrisSyncStatusListDto = components['schemas']['HrisSyncStatusListDto'];
 export type ZenHrReconnectResultDto = components['schemas']['ZenHrReconnectResultDto'];
@@ -19710,6 +19854,30 @@ export interface operations {
             503: components["responses"]["ZenHrSyncInProgress"];
         };
     };
+    getWorkspaceIngestCoverage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ingest coverage for connected pipelines */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestCoverageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
     getHrisSyncStatus: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -1289,6 +1289,127 @@ 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;
+}
+
+/** Why a pipeline or SDLC component is marked stale. */
+export type IngestCoverageStaleReason = "sync_age" | "data_lag" | "both";
+
+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;
+  staleReason?: IngestCoverageStaleReason | null;
+}
+
+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;
+  staleReason?: IngestCoverageStaleReason | 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', …). */