Add governed source freshness audit

frontend/src/types.ts

@@ -663,6 +663,52 @@ export interface DatasetListResponse {
   offset: number
 }
 
+export type SourceFreshnessStatus = 'current' | 'due' | 'review_required' | 'local'
+
+export interface SourceIntegritySummary {
+  missing_version_count: number
+  checksum_mismatch_count: number
+  missing_storage_file_count: number
+  size_mismatch_count: number
+}
+
+export interface SourceFreshnessItem {
+  source_name: string
+  display_name: string
+  dataset_count: number
+  ready_count: number
+  version_count: number
+  latest_imported_at?: string | null
+  latest_observed_at?: string | null
+  latest_source_version?: string | null
+  refresh_policy: 'rolling_snapshot' | 'annual_release' | 'edition' | 'scenario' | 'archive' | 'local'
+  review_interval_days?: number | null
+  next_review_at?: string | null
+  status: SourceFreshnessStatus
+  historical_series: boolean
+  auto_refresh_supported: false
+  reason: string
+  recommended_action: string
+  integrity: SourceIntegritySummary
+}
+
+export interface SourceFreshnessReport {
+  project_id: string
+  generated_at: string
+  summary: {
+    source_count: number
+    dataset_count: number
+    current_count: number
+    due_count: number
+    review_required_count: number
+    local_count: number
+    sources_with_integrity_issues: number
+    integrity_issue_count: number
+  }
+  items: SourceFreshnessItem[]
+  limitations: string[]
+}
+
 export interface GeojsonEnvelopeResponse {
   data: object
 }