@thinkai/tai-api-contract 2.131.0 → 2.133.0

package/src/generated/openapi.ts

@@ -1544,7 +1544,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;
@@ -4124,7 +4124,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;
@@ -4135,6 +4135,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;
@@ -8060,6 +8080,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;
@@ -8069,6 +8109,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} */
@@ -8144,6 +8186,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;
@@ -10317,6 +10380,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'];
@@ -10325,6 +10391,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'];
@@ -14829,7 +14897,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;
@@ -20943,6 +21011,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;

package/src/index.ts

@@ -1315,6 +1315,34 @@ export interface IngestCoverageProductivityRepoDto {
   lastErrorKind?: string | null;
 }
 
+/** Latest depth-scan summary read from activity rows. Does not start a scan. */
+export interface IngestCoverageProductivityDepthScanDto {
+  /** Newest `productivity.ingest.depth_scan_completed` time, or null when none. */
+  completedAt: string | null;
+  reposScanned: number;
+  /** Metadata `underIngestedCount` on that completed event (0 when the scan found none). */
+  gapCount: number;
+  /**
+   * Minimum `capturePercent(platformPrs, githubMerged180d)` over that scan's repo checks
+   * with `githubMerged180d` > 0. Null when no such row.
+   */
+  capturePercent: number | null;
+  weeksQueued: number;
+}
+
+/** Latest week-reconcile summary read from activity rows. */
+export interface IngestCoverageProductivityWeekReconcileDto {
+  /** Newest `productivity.ingest.week_reconcile` time, or null when none. */
+  completedAt: string | null;
+  weeksChecked: number;
+  weeksQueued: number;
+}
+
+export interface IngestCoverageProductivitySelfHealDto {
+  depthScan: IngestCoverageProductivityDepthScanDto;
+  weekReconcile: IngestCoverageProductivityWeekReconcileDto;
+}
+
 export interface IngestCoverageProductivityDetailDto {
   phase?: "recent" | "historical" | "complete" | null;
   historicalWeekStart?: string | null;
@@ -1323,6 +1351,11 @@ export interface IngestCoverageProductivityDetailDto {
   failedRepoCount?: number;
   coveragePercent?: number | null;
   repos?: IngestCoverageProductivityRepoDto[];
+  /**
+   * Null when the pipeline exists but no depth-scan completed event and no week-reconcile
+   * event are stored. Absent from pipelines that are omitted.
+   */
+  selfHeal?: IngestCoverageProductivitySelfHealDto | null;
 }
 
 export interface IngestCoverageFactFamilyDto {
@@ -1410,6 +1443,30 @@ export interface IngestCoverageDto {
   generatedAt?: string;
 }
 
+export type IngestRunKind = IngestCoveragePipelineKind;
+
+/** Finish state for one durable ingest tick. `cancelled` is legal and unused this wave. */
+export type IngestRunOutcome = "in_progress" | "ok" | "partial" | "failed" | "cancelled";
+
+/** One persisted ingest tick from GET /workspaces/:id/ingest-runs. */
+export interface IngestRunDto {
+  runId: string;
+  kind: IngestRunKind;
+  startedAt: string;
+  completedAt: string | null;
+  outcome: IngestRunOutcome;
+  reposPolled: number | null;
+  reposOk: number | null;
+  reposFailed: number | null;
+  errorSummary: string | null;
+  watermark: string | null;
+}
+
+/** Response body for GET /workspaces/:id/ingest-runs. */
+export interface IngestRunListDto {
+  runs: IngestRunDto[];
+}
+
 /** Sync status for a single HRIS provider connected to a workspace. */
 export interface HrisSyncStatusDto {
   /** Provider identifier ('personio', 'zenhr', …). */