"""Deterministic time source so machine output is reproducible in tests.""" from __future__ import annotations import os from datetime import UTC, datetime class Clock: def now(self) -> datetime: override = os.environ.get("REPOCTL_CLOCK_UTC") if override: return datetime.fromisoformat(override).replace(tzinfo=UTC) return datetime.now(UTC) def now_iso(self) -> str: return self.now().replace(microsecond=0).isoformat().replace("+00:00", "Z") DEFAULT_CLOCK = Clock()