"""Time utilities for consistent timezone handling.

All datetime values in the domain should be UTC-aware to prevent:
- Naive/aware comparison errors
- Incorrect .timestamp() conversions
- Timezone drift between components
"""

from datetime import UTC, datetime


def utc_now() -> datetime:
    """Return current UTC datetime (timezone-aware).

    Use this instead of datetime.now() throughout the codebase to ensure
    consistent timezone-aware datetime handling.

    Returns:
        Current datetime in UTC timezone with microsecond precision.
    """
    now = datetime.now(UTC)
    return now
