UPDATE

config/integration_contract.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+
+def _isoformat(value: Any) -> Any:
+    if isinstance(value, datetime):
+        return value.isoformat()
+    return value
+
+
+def build_integration_meta(
+    *,
+    flow_type: str,
+    source_type: str,
+    source_service: str,
+    ownership: str,
+    live: bool,
+    cached: bool,
+    generated_at: Any = None,
+    snapshot_at: Any = None,
+    notes: list[str] | None = None,
+) -> dict[str, Any]:
+    meta = {
+        "flow_type": flow_type,
+        "source_type": source_type,
+        "source_service": source_service,
+        "ownership": ownership,
+        "live": live,
+        "cached": cached,
+    }
+    if generated_at is not None:
+        meta["generated_at"] = _isoformat(generated_at)
+    if snapshot_at is not None:
+        meta["snapshot_at"] = _isoformat(snapshot_at)
+    if notes:
+        meta["notes"] = notes
+    return meta