Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

2.6 KB
Raw Blame
class ApprovalException(Exception):
    """Base exception for approval-related errors"""

    pass


class PreconditionFailed(ApprovalException):
    """Raised when preconditions for applying a change no longer hold"""

    pass


class ApplyFailed(ApprovalException):
    """Raised when applying an approved change fails"""

    pass


class InvalidIntent(ApprovalException):
    """Raised when intent data is invalid"""

    pass


class PolicyEvaluationError(ApprovalException):
    """Raised when policy evaluation fails"""

    pass


class ApprovalDetectionFailed(ApprovalException):
    """Raised when the gate cannot tell whether a change needs approval.

    Detection reads the change through each action's ``detect``. When one of those raises, the
    answer is unknown, not "no policy applies". Treating it as the latter lets a bug in one action
    silently disable the policy it implements, so the write is refused instead.
    """


class ApprovalRequired(ApprovalException):
    """
    Raised when an action requires approval.

    This exception is raised from serializer methods when approval is required,
    allowing the ViewSet to catch it and return the appropriate 409 response.
    """

    def __init__(self, change_request, message: str, required_approvers: dict, error_code: str = "approval_required"):
        self.change_request = change_request
        self.message = message
        self.required_approvers = required_approvers
        self.error_code = error_code
        super().__init__(message)


class PolicyConflict(ApprovalException):
    """
    Raised when a single change would require approval under more than one policy.

    Raised from serializer methods (mirroring ApprovalRequired) so the ViewSet can catch it and
    return a 400 telling the caller to split the change — a single ChangeRequest can only carry
    one action's approval, so a change matching several policy-backed actions can't be gated safely.
    """

    def __init__(self, conflicting_policies: list, message: str, guidance: str):
        self.conflicting_policies = conflicting_policies
        self.message = message
        self.guidance = guidance
        super().__init__(message)


class ChangeRequestError(ApprovalException):
    """Base exception for change request service operations."""

    pass


class InvalidStateError(ChangeRequestError):
    """Raised when operation is invalid for the current change request state."""

    pass


class AlreadyVotedError(ChangeRequestError):
    """Raised when user has already voted on a change request."""

    pass


class ReasonRequiredError(ChangeRequestError):
    """Raised when a reason is required but not provided."""

    pass