@thinkai/tai-api-contract 2.199.0 → 2.200.0

package/src/index.ts

@@ -1457,6 +1457,47 @@ export interface IngestCoverageProductivitySelfHealDto {
 export type IngestCoverageVerificationStatus =
   "unverified" | "verified" | "below_target" | "insufficient_sample" | "stale";
 
+/**
+ * Pipeline-level source reconcile outcome (L2).
+ * Reuses the productivity Source verified statuses and adds `not_applicable`
+ * when a connected provider exposes no countable/checksum reconcile surface.
+ */
+export type IngestCoverageSourceReconcileStatus =
+  IngestCoverageVerificationStatus | "not_applicable";
+
+/**
+ * Which L2 reconcile check produced `sourceReconcile.verificationStatus`.
+ * Maps into L1 `dataTrust.verificationMethod` (`source_count` / `checksum`).
+ */
+export type IngestCoverageSourceReconcileMethod = "source_count" | "checksum" | "none";
+
+/**
+ * Generalized Source verified / reconcile snapshot on a coverage pipeline.
+ * Optional until a scheduled reconciler has written a row. Productivity GitHub
+ * keeps nested `productivity.verificationStatus` / `sourceCapturePercent`;
+ * AI spend stays on `ai.spendReconciliationStatus`.
+ */
+export interface IngestCoverageSourceReconcileDto {
+  verificationStatus: IngestCoverageSourceReconcileStatus;
+  /**
+   * 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.
+   */
+  sourceCapturePercent: number | null;
+  verificationMethod: IngestCoverageSourceReconcileMethod;
+  /** When the snapshot was written. Null when status is unverified with no row. */
+  checkedAt: string | null;
+  /** Provider-side count for the reconcile window. Null when unset or N/A. */
+  providerCount: number | null;
+  /** Stored platform count for the reconcile window. Null when unset or N/A. */
+  storedCount: number | null;
+  /** Provider-side checksum (opaque). Null when method is not checksum. */
+  providerChecksum: string | null;
+  /** Stored platform checksum (opaque). Null when method is not checksum. */
+  storedChecksum: string | null;
+}
+
 export interface IngestCoverageProductivityDetailDto {
   phase?: "recent" | "historical" | "complete" | null;
   historicalWeekStart?: string | null;
@@ -1564,7 +1605,14 @@ export interface IngestCoverageSyncDetailDto {
 }
 
 export type IngestCoveragePipelineKind =
-  "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+  | "productivity_github"
+  | "productivity_bitbucket"
+  | "ai_usage"
+  | "sdlc_github"
+  | "monitoring"
+  | "hris"
+  | "jira"
+  | "pagerduty";
 
 export type IngestCoveragePipelineStatus =
   "not_started" | "backfilling" | "incremental" | "complete" | "failed" | "in_progress";
@@ -1628,6 +1676,12 @@ export interface IngestCoveragePipelineDto {
   ai?: IngestCoverageAiDetailDto;
   sdlc?: IngestCoverageSdlcDetailDto;
   sync?: IngestCoverageSyncDetailDto;
+  /**
+   * Optional L2 source-reconcile snapshot (count / checksum vs provider API).
+   * Null/omit when no scheduled reconcile has written a row for this pipeline.
+   * Does not replace nested productivity verify fields or AI spend reconcile.
+   */
+  sourceReconcile?: IngestCoverageSourceReconcileDto | null;
   /**
    * Always present. Unified Data trust summary for this pipeline.
    * Additive to Source verified / Spend matched / Backfill complete.