"""Application-specific failures with predictable command-line handling."""

from __future__ import annotations


class UvmError(Exception):
    """An expected error that should be rendered without a traceback."""

    def __init__(self, message: str, exit_code: int = 1) -> None:
        super().__init__(message)
        self.exit_code = exit_code


class ConfigurationError(UvmError):
    """Raised when local uvm configuration is invalid."""


class ValidationError(UvmError):
    """Raised when a command argument is invalid."""


class StateError(UvmError):
    """Raised when persisted VM state cannot be safely used."""


class NotFoundError(UvmError):
    """A requested registry entry does not exist."""


class ConflictError(UvmError):
    """An allocation or pending operation prevents the requested action."""


class CommandError(UvmError):
    """Raised when a required host command cannot be executed successfully."""


class FirecrackerError(UvmError):
    """Raised when Firecracker cannot be started or configured."""


class GuestAgentUnavailableError(UvmError):
    """The VM's execution agent could not be reached before submission."""


class GuestExecutionError(UvmError):
    """Guest execution failed; a lost response does not prove the command failed."""

    def __init__(self, message: str, *, outcome_unknown: bool = False) -> None:
        super().__init__(message)
        self.outcome_unknown = outcome_unknown


class TapCreationError(UvmError):
    """Raised when TAP setup fails after creating a host interface."""

    def __init__(self, message: str, *, tap_created: bool) -> None:
        super().__init__(message)
        self.tap_created = tap_created