Skip to content
Docs home

DEVELOPER · UPDATED AUGUST 2026

Errors & Failure Model

Typed errors, fail-closed protection boundaries, fail-open availability boundaries — how QUE tells you what actually went wrong.

Typed errors

QUE returns typed errors rather than generic failures: an availability rejection names the computation it ran, an auth failure names the missing session or role, a provider failure surfaces what the external system returned. The operator view and the API surface both carry these typed results so recovery decisions can be made from the error itself, not from guesswork.

Fail-closed and fail-open

Boundaries that protect customers fail closed; boundaries that protect availability fail open. Redis failure makes rate limiting deny rather than allow. An unreachable database makes booking reads return errors rather than stale data. A missing alertmanager secret makes the webhook sink refuse everything rather than accept unauthenticated payloads. Server error reporting is fail-open for availability (an unset DSN logs locally and never throws) but the reported data itself is fail-closed for correctness — malformed releases and forbidden customer keys are dropped with a stated reason.

Dependency failureBoundaryBehavior
Redis unreachableRate limitingDeny (fail-closed)
Database unreachableBooking readsTyped error, no stale data (fail-closed)
Alertmanager secret unsetAlert webhook401 on every request (fail-closed)
Sentry DSN unsetError reportingConsole log, no throw (fail-open)

No raw exceptions in public surfaces

Public and customer-facing responses never expose raw exception traces. Internal failures are captured with context for operators; what customers see is the typed, actionable form. If you encounter a raw stack trace on a public surface, report it — that is a defect.

STILL READING

Something here still feels worth checking together.

This documentation describes the product exactly as it is implemented. If a behavior you expected is not here — or is here and does not match your deployment — tell the team. Implementation questions start on the contact page.