@thinkai/tai-api-contract 2.131.0 → 2.133.0

package/dist/generated/openapi.d.ts

@@ -1543,7 +1543,7 @@ export interface paths {
         };
         /**
          * GitHub App installation status for workspace
-         * @description Returns whether a GitHub App installation is linked and cached repo metadata. When no installation exists, returns 200 with `installed: false` (never 404 for missing install). Use `refresh=true` to bypass cache and re-list repositories from GitHub, and to run inline productivity ingest (`on_demand`) for the current UTC week when backfill phase is `complete`.
+         * @description Returns whether a GitHub App installation is linked and cached repo metadata. When no installation exists, returns 200 with `installed: false` (never 404 for missing install). Use `refresh=true` to bypass cache and re-list repositories from GitHub, and to run inline productivity ingest (`on_demand`) for the current UTC week.
          */
         get: operations["getWorkspaceGithubInstallationStatus"];
         put?: never;
@@ -4123,7 +4123,7 @@ export interface paths {
         };
         /**
          * 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.
+         * @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. Productivity detail may include `selfHeal` (latest depth scan and week reconcile) read from stored activity rows; this GET does not run a scan. `selfHeal` is null when neither event exists. Requires workspace membership. Disconnected sources are omitted.
          */
         get: operations["getWorkspaceIngestCoverage"];
         put?: never;
@@ -4134,6 +4134,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/ingest-runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List durable ingest runs
+         * @description Newest-first history of ingest worker ticks that polled. Quiet skips (lock held, rate-limit deferral, and other non-poll skips) are omitted. This wave writes `productivity_github` only; other kinds return an empty list. Requires workspace membership. Does not include run history on ingest-coverage.
+         */
+        get: operations["getWorkspaceIngestRuns"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/hris/status": {
         parameters: {
             query?: never;
@@ -8059,6 +8079,26 @@ export interface components {
             gaps?: components["schemas"]["IngestCoverageGapDto"][];
             lastErrorKind?: string | null;
         };
+        /** @description Latest depth scan read from stored activity. `capturePercent` is the minimum existing capture ratio over that scan's repo checks with a GitHub merge count, or null when none qualify. */
+        IngestCoverageProductivityDepthScanDto: {
+            /** Format: date-time */
+            completedAt: string | null;
+            reposScanned: number;
+            /** @description Metadata underIngestedCount from the completed depth-scan event. */
+            gapCount: number;
+            capturePercent: number | null;
+            weeksQueued: number;
+        };
+        IngestCoverageProductivityWeekReconcileDto: {
+            /** Format: date-time */
+            completedAt: string | null;
+            weeksChecked: number;
+            weeksQueued: number;
+        };
+        IngestCoverageProductivitySelfHealDto: {
+            depthScan: components["schemas"]["IngestCoverageProductivityDepthScanDto"];
+            weekReconcile: components["schemas"]["IngestCoverageProductivityWeekReconcileDto"];
+        };
         IngestCoverageProductivityDetailDto: {
             /** @enum {string|null} */
             phase?: "recent" | "historical" | "complete" | null;
@@ -8068,6 +8108,8 @@ export interface components {
             failedRepoCount?: number;
             coveragePercent?: number | null;
             repos?: components["schemas"]["IngestCoverageProductivityRepoDto"][];
+            /** @description Latest depth-scan and week-reconcile summary from stored activity rows. Null when neither event exists. The coverage GET does not run a scan. */
+            selfHeal?: components["schemas"]["IngestCoverageProductivitySelfHealDto"] | null;
         };
         IngestCoverageFactFamilyDto: {
             /** @enum {string} */
@@ -8143,6 +8185,27 @@ export interface components {
             /** Format: date-time */
             generatedAt?: string;
         };
+        IngestRunDto: {
+            /** Format: uuid */
+            runId: string;
+            /** @enum {string} */
+            kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+            /** Format: date-time */
+            startedAt: string;
+            /** Format: date-time */
+            completedAt: string | null;
+            /** @enum {string} */
+            outcome: "in_progress" | "ok" | "partial" | "failed" | "cancelled";
+            reposPolled: number | null;
+            reposOk: number | null;
+            reposFailed: number | null;
+            errorSummary: string | null;
+            /** @description ISO lastIngestAt after the cursor moved; null when it did not. */
+            watermark: string | null;
+        };
+        IngestRunListDto: {
+            runs: components["schemas"]["IngestRunDto"][];
+        };
         HrisSyncStatusDto: {
             /** @description Provider identifier (e.g. 'personio', 'zenhr'). */
             provider: string;
@@ -10316,6 +10379,9 @@ export type WorkspaceAbsenceListDto = components['schemas']['WorkspaceAbsenceLis
 export type IngestCoverageGapDto = components['schemas']['IngestCoverageGapDto'];
 export type IngestCoverageLastRunDto = components['schemas']['IngestCoverageLastRunDto'];
 export type IngestCoverageProductivityRepoDto = components['schemas']['IngestCoverageProductivityRepoDto'];
+export type IngestCoverageProductivityDepthScanDto = components['schemas']['IngestCoverageProductivityDepthScanDto'];
+export type IngestCoverageProductivityWeekReconcileDto = components['schemas']['IngestCoverageProductivityWeekReconcileDto'];
+export type IngestCoverageProductivitySelfHealDto = components['schemas']['IngestCoverageProductivitySelfHealDto'];
 export type IngestCoverageProductivityDetailDto = components['schemas']['IngestCoverageProductivityDetailDto'];
 export type IngestCoverageFactFamilyDto = components['schemas']['IngestCoverageFactFamilyDto'];
 export type IngestCoverageAiDetailDto = components['schemas']['IngestCoverageAiDetailDto'];
@@ -10324,6 +10390,8 @@ export type IngestCoverageSdlcDetailDto = components['schemas']['IngestCoverageS
 export type IngestCoverageSyncDetailDto = components['schemas']['IngestCoverageSyncDetailDto'];
 export type IngestCoveragePipelineDto = components['schemas']['IngestCoveragePipelineDto'];
 export type IngestCoverageDto = components['schemas']['IngestCoverageDto'];
+export type IngestRunDto = components['schemas']['IngestRunDto'];
+export type IngestRunListDto = components['schemas']['IngestRunListDto'];
 export type HrisSyncStatusDto = components['schemas']['HrisSyncStatusDto'];
 export type HrisSyncStatusListDto = components['schemas']['HrisSyncStatusListDto'];
 export type ZenHrReconnectResultDto = components['schemas']['ZenHrReconnectResultDto'];
@@ -14828,7 +14896,7 @@ export interface operations {
     getWorkspaceGithubInstallationStatus: {
         parameters: {
             query?: {
-                /** @description When true, bypass `tai_workspace_vcs_repos_cache` and re-fetch from GitHub. When productivity backfill phase is `complete`, also triggers inline `on_demand` ingest for the current UTC week (gap-fill only when metrics are missing). Response includes `productivityRefreshInProgress` while the workspace advisory lock is held. */
+                /** @description When true, bypass `tai_workspace_vcs_repos_cache` and re-fetch from GitHub, then poll and merge productivity metrics for the current UTC week even while historical backfill is active or metrics already exist. Response includes `productivityRefreshInProgress` while the workspace advisory lock is held. */
                 refresh?: boolean;
                 /** @description When true, re-fetch GitHub App and installation permission metadata (used by the login permission gate after the user approves on GitHub). Clears App-permission and product-settings caches so the next `productSettingsRefresh` re-probes. Does not itself call alert-list APIs; use `productSettingsRefresh` for that. */
                 permissionsRefresh?: boolean;
@@ -20942,6 +21010,55 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    getWorkspaceIngestRuns: {
+        parameters: {
+            query?: {
+                /** @description Coverage pipeline kind. Omit to list every kind stored for the workspace. */
+                kind?: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+                /** @description Page size. Default 20. Values above 100 are rejected. */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ingest runs, newest startedAt first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "runs": []
+                     *     }
+                     */
+                    "application/json": components["schemas"]["IngestRunListDto"];
+                };
+            };
+            /** @description Invalid kind or limit */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Invalid ingest-runs query",
+                     *       "code": "invalid_query"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
     getHrisSyncStatus: {
         parameters: {
             query?: never;