Expand description
Diagnostics as data: the closed reason vocabulary and the typed error report.
An error is a value with named parts, rendered at the boundary — never
a pre-formatted string assembled where the failure happened. The exit
code stays the coarse machine signal; the reason beside it is the
fine one, drawn from one closed vocabulary agents can branch on the
way scripts branch on exit codes. The vocabulary is append-only: a
reason is never renamed and never reused.
Structs§
- Diagnostic
- One failure, with its parts named.
Enums§
- Reason
- The closed reason vocabulary, the machine twin of the exit-code matrix.
Constants§
- DIAGNOSTIC_
SCHEMA - The version of the JSON diagnostic’s shape.
- REASONS
- Every reason, in declaration order; a test asserts against this so an addition is deliberate and a rename impossible.