@thinkai/tai-api-contract 2.199.0 → 2.200.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5215,7 +5215,7 @@ export interface paths {
5215
5215
  };
5216
5216
  /**
5217
5217
  * Ingest / backfill data coverage
5218
- * @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`.
5218
+ * @description Read-only snapshot of historical ingest coverage for connected pipelines (productivity GitHub/Bitbucket, AI usage/spend per provider, SDLC components, monitoring, HRIS, Jira, PagerDuty). 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`, optional pipeline `sourceReconcile`, pipeline `status`). It does not replace Source verified, Spend matched, or Backfill complete fields. Optional `sourceReconcile` generalizes Source verified (count/checksum vs provider) for L2 reconcilers; omit/null when no scheduled reconcile snapshot exists. 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 spend 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`.
5219
5219
  */
5220
5220
  get: operations["getWorkspaceIngestCoverage"];
5221
5221
  put?: never;
@@ -10812,6 +10812,36 @@ export interface components {
10812
10812
  /** @description Monitoring meta event count. Null for HRIS and when the stored count is unset. */
10813
10813
  eventCount?: number | null;
10814
10814
  };
10815
+ /**
10816
+ * @description Pipeline-level source reconcile outcome (L2). Same values as productivity Source verified, plus `not_applicable` when the provider has no countable or checksum reconcile surface.
10817
+ * @enum {string}
10818
+ */
10819
+ IngestCoverageSourceReconcileStatus: "unverified" | "verified" | "below_target" | "insufficient_sample" | "stale" | "not_applicable";
10820
+ /**
10821
+ * @description Which L2 reconcile check produced `sourceReconcile.verificationStatus`. Prefer `source_count` or `checksum` when mapping into `dataTrust.verificationMethod`.
10822
+ * @enum {string}
10823
+ */
10824
+ IngestCoverageSourceReconcileMethod: "source_count" | "checksum" | "none";
10825
+ /** @description Generalized Source verified / reconcile snapshot on a coverage pipeline. Optional until a scheduled reconciler writes a row. Does not replace nested productivity verify fields or AI spend reconcile. */
10826
+ IngestCoverageSourceReconcileDto: {
10827
+ verificationStatus: components["schemas"]["IngestCoverageSourceReconcileStatus"];
10828
+ /** @description Minimum provider-vs-stored capture for a count reconcile (0–100, up to two decimals). Null when the check is checksum-only, thin, not applicable, or no sample exists. */
10829
+ sourceCapturePercent: number | null;
10830
+ verificationMethod: components["schemas"]["IngestCoverageSourceReconcileMethod"];
10831
+ /**
10832
+ * Format: date-time
10833
+ * @description When the snapshot was written. Null when unverified with no row.
10834
+ */
10835
+ checkedAt: string | null;
10836
+ /** @description Provider-side count for the reconcile window. Null when unset or N/A. */
10837
+ providerCount: number | null;
10838
+ /** @description Stored platform count for the reconcile window. Null when unset or N/A. */
10839
+ storedCount: number | null;
10840
+ /** @description Provider-side checksum (opaque). Null when method is not checksum. */
10841
+ providerChecksum: string | null;
10842
+ /** @description Stored platform checksum (opaque). Null when method is not checksum. */
10843
+ storedChecksum: string | null;
10844
+ };
10815
10845
  /**
10816
10846
  * @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.
10817
10847
  * @enum {string}
@@ -10845,7 +10875,7 @@ export interface components {
10845
10875
  IngestCoveragePipelineDto: {
10846
10876
  id: string;
10847
10877
  /** @enum {string} */
10848
- kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
10878
+ kind: "productivity_github" | "productivity_bitbucket" | "ai_usage" | "sdlc_github" | "monitoring" | "hris" | "jira" | "pagerduty";
10849
10879
  provider?: string | null;
10850
10880
  /** @enum {string} */
10851
10881
  status: "not_started" | "backfilling" | "incremental" | "complete" | "failed" | "in_progress";
@@ -10878,6 +10908,8 @@ export interface components {
10878
10908
  ai?: components["schemas"]["IngestCoverageAiDetailDto"];
10879
10909
  sdlc?: components["schemas"]["IngestCoverageSdlcDetailDto"];
10880
10910
  sync?: components["schemas"]["IngestCoverageSyncDetailDto"];
10911
+ /** @description Optional L2 source-reconcile snapshot (count / checksum vs provider API). Null when no scheduled reconcile has written a row for this pipeline. Does not replace nested productivity verify fields or AI spend reconcile. */
10912
+ sourceReconcile?: components["schemas"]["IngestCoverageSourceReconcileDto"] | null;
10881
10913
  dataTrust: components["schemas"]["DataTrustDto"];
10882
10914
  };
10883
10915
  IngestCoverageDto: {
@@ -10889,7 +10921,7 @@ export interface components {
10889
10921
  /** Format: uuid */
10890
10922
  runId: string;
10891
10923
  /** @enum {string} */
10892
- kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
10924
+ kind: "productivity_github" | "productivity_bitbucket" | "ai_usage" | "sdlc_github" | "monitoring" | "hris" | "jira" | "pagerduty";
10893
10925
  /** Format: date-time */
10894
10926
  startedAt: string;
10895
10927
  /** Format: date-time */
@@ -13643,6 +13675,9 @@ export type IngestCoverageAiDetailDto = components['schemas']['IngestCoverageAiD
13643
13675
  export type IngestCoverageSdlcComponentDto = components['schemas']['IngestCoverageSdlcComponentDto'];
13644
13676
  export type IngestCoverageSdlcDetailDto = components['schemas']['IngestCoverageSdlcDetailDto'];
13645
13677
  export type IngestCoverageSyncDetailDto = components['schemas']['IngestCoverageSyncDetailDto'];
13678
+ export type IngestCoverageSourceReconcileStatus = components['schemas']['IngestCoverageSourceReconcileStatus'];
13679
+ export type IngestCoverageSourceReconcileMethod = components['schemas']['IngestCoverageSourceReconcileMethod'];
13680
+ export type IngestCoverageSourceReconcileDto = components['schemas']['IngestCoverageSourceReconcileDto'];
13646
13681
  export type DataTrustStatus = components['schemas']['DataTrustStatus'];
13647
13682
  export type DataTrustVerificationMethod = components['schemas']['DataTrustVerificationMethod'];
13648
13683
  export type DataTrustDto = components['schemas']['DataTrustDto'];
@@ -28103,7 +28138,7 @@ export interface operations {
28103
28138
  parameters: {
28104
28139
  query?: {
28105
28140
  /** @description Coverage pipeline kind. Omit to list every kind stored for the workspace. */
28106
- kind?: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
28141
+ kind?: "productivity_github" | "productivity_bitbucket" | "ai_usage" | "sdlc_github" | "monitoring" | "hris" | "jira" | "pagerduty";
28107
28142
  /** @description Page size. Default 20. Values above 100 are rejected. */
28108
28143
  limit?: number;
28109
28144
  };