@thinkai/tai-api-contract 2.195.0 → 2.196.1

package/dist/generated/openapi.d.ts

@@ -5175,7 +5175,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. 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. AI usage detail includes spend reconciliation (`spendReconciliationStatus`, `spendDataQuality`, provider and stored cent totals, `spendReconcileCheckedAt`) read from the refresh-status snapshot. This GET does not call Cursor or Claude. Productivity, HR, monitoring, and SDLC pipelines omit those fields. `nextScheduledAt` is the scheduled poll instant for `ai_usage`, `hris`, and `monitoring`. It is null for productivity and SDLC, when that sync worker is disabled, or when there has been no attempt. A past instant means the poll is overdue; it is not moved forward to now and is not an ETA. Monitoring `sync` copies stored `issueCount`, `deploymentCount`, and `eventCount` (null when unset). HRIS leaves those three null. 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. Every pipeline includes always-present `dataTrust` (`status` + `verificationMethod`) as a unified trust summary derived from existing coverage signals (stale, gaps, productivity `verificationStatus`, AI `spendReconciliationStatus`, pipeline `status`). It does not replace Source verified, Spend matched, or Backfill complete fields. 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. AI usage detail includes spend reconciliation (`spendReconciliationStatus`, `spendDataQuality`, provider and stored cent totals, `spendReconcileCheckedAt`) read from the refresh-status snapshot. This GET does not call Cursor or Claude. Productivity, HR, monitoring, and SDLC pipelines omit those fields. `nextScheduledAt` is the scheduled poll instant for `ai_usage`, `hris`, and `monitoring`. It is null for productivity and SDLC, when that sync worker is disabled, or when there has been no attempt (`hris`/`monitoring` use last status `never`). For `hris` and `monitoring`, the value is the next PHASE2 daily UTC cron after now (`15 2` / `30 2`, not lastAttempt plus interval) and is therefore in the future when set. For `ai_usage`, it is the next weekly workspace slot and a past instant means that poll is overdue; it is not moved forward to now and is not an ETA. Monitoring `sync` copies stored `issueCount`, `deploymentCount`, and `eventCount` (null when unset). HRIS leaves those three null. Requires workspace membership. Disconnected sources are omitted. Insights / Measure / Engineering Health response DTOs do not include `dataTrust`.
          */
         get: operations["getWorkspaceIngestCoverage"];
         put?: never;
@@ -10770,6 +10770,21 @@ export interface components {
             /** @description Monitoring meta event count. Null for HRIS and when the stored count is unset. */
             eventCount?: number | null;
         };
+        /**
+         * @description Unified data-trust summary for one ingest-coverage pipeline. Derived from existing coverage signals; does not rename Source verified, Spend matched, or Backfill complete.
+         * @enum {string}
+         */
+        DataTrustStatus: "verified" | "provisional" | "degraded" | "unknown";
+        /**
+         * @description Which check decided `dataTrust.status` (or `none` when no applicable check). When several checks tie, prefer checksum > source_count > calendar_gap > none.
+         * @enum {string}
+         */
+        DataTrustVerificationMethod: "calendar_gap" | "source_count" | "checksum" | "none";
+        /** @description Always-present Data trust summary on each ingest-coverage pipeline (`GET …/ingest-coverage` only). Additive to Source verified / Spend matched / Backfill complete lines. Derived from existing coverage signals only. Not added to Insights / Measure / Engineering Health response DTOs. */
+        DataTrustDto: {
+            status: components["schemas"]["DataTrustStatus"];
+            verificationMethod: components["schemas"]["DataTrustVerificationMethod"];
+        };
         IngestCoveragePipelineDto: {
             id: string;
             /** @enum {string} */
@@ -10790,7 +10805,7 @@ export interface components {
             lastErrorMessage?: string | null;
             /**
              * Format: date-time
-             * @description Scheduled poll instant. Set for ai_usage (next weekly workspace slot), hris, and monitoring (last attempt plus the worker interval, including when that instant is already past). Null for productivity_github and sdlc_github, when the sync worker is disabled, or when lastAttemptAt is null. Not an ETA and not advanced to now when the worker is late.
+             * @description Scheduled poll instant. Set for ai_usage (next weekly workspace slot; a past instant means the poll is overdue and is not advanced to now), hris (next PHASE2 daily UTC cron `15 2` after now), and monitoring (next PHASE2 daily UTC cron `30 2` after now). HRIS/Monitoring values are always in the future when set — not lastAttempt plus interval. Null for productivity_github and sdlc_github, when the sync worker is disabled, or when there has been no attempt (hris/monitoring: last status never). Not an ETA.
              */
             nextScheduledAt?: string | null;
             /** Format: int64 */
@@ -10806,6 +10821,7 @@ export interface components {
             ai?: components["schemas"]["IngestCoverageAiDetailDto"];
             sdlc?: components["schemas"]["IngestCoverageSdlcDetailDto"];
             sync?: components["schemas"]["IngestCoverageSyncDetailDto"];
+            dataTrust: components["schemas"]["DataTrustDto"];
         };
         IngestCoverageDto: {
             pipelines: components["schemas"]["IngestCoveragePipelineDto"][];
@@ -13532,6 +13548,9 @@ export type IngestCoverageAiDetailDto = components['schemas']['IngestCoverageAiD
 export type IngestCoverageSdlcComponentDto = components['schemas']['IngestCoverageSdlcComponentDto'];
 export type IngestCoverageSdlcDetailDto = components['schemas']['IngestCoverageSdlcDetailDto'];
 export type IngestCoverageSyncDetailDto = components['schemas']['IngestCoverageSyncDetailDto'];
+export type DataTrustStatus = components['schemas']['DataTrustStatus'];
+export type DataTrustVerificationMethod = components['schemas']['DataTrustVerificationMethod'];
+export type DataTrustDto = components['schemas']['DataTrustDto'];
 export type IngestCoveragePipelineDto = components['schemas']['IngestCoveragePipelineDto'];
 export type IngestCoverageDto = components['schemas']['IngestCoverageDto'];
 export type IngestRunDto = components['schemas']['IngestRunDto'];