@thinkai/tai-api-contract 2.118.0 → 2.120.0

package/dist/generated/openapi.d.ts

@@ -3923,6 +3923,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;
@@ -7650,6 +7670,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;
@@ -7932,7 +8065,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;
             /**
@@ -9596,6 +9729,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'];
@@ -19709,6 +19853,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;