@thinkai/tai-api-contract 2.131.0 → 2.132.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;
@@ -8059,6 +8059,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 +8088,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} */
@@ -10316,6 +10338,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'];
@@ -14828,7 +14853,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;