Skip to main content

Status Model

Zex uses explicit status surfaces and treats uncertainty as a first-class outcome. When the system cannot confirm an outcome, it returns UNKNOWN rather than inferring success or failure.

Canonical vocabularies (source-of-truth)​

Avoid copy/pasting enums into documentation. Refer to canonical repo contracts:

  • Platform contracts: docs/contracts/v1/ in the platform repo.

What we can’t know yet (UNKNOWN)​

UNKNOWN indicates the system cannot confirm an outcome (for example, a dependency outage).

  • Avoid implied success
  • Provide stable references and replay guidance