src/errors.py

"""User-display-safe error types."""


class UserFacingError(Exception):
    """Raised for conditions that should be shown to end users (clear message)."""

    def __init__(self, message: str, *, details: str | None = None) -> None:
        super().__init__(message)
        self.user_message = message
        self.details = details