Expand description
Deterministic exit-code taxonomy — stable contract for agent orchestrators.
Orchestrators (systemd timers, CI runners, other agents) branch on exit
code alone: 0 = go, 4 = sleep and retry, 3/7 = fix config. Changing
a code is a breaking change, so the numeric values are pinned and the
mapping from crate::cmd::CmdError is exercised by tests.
Mirrors the plan’s taxonomy:
| Code | Class |
|---|---|
| 0 | success |
| 2 | usage / argument error (clap emits this) |
| 3 | auth (401/403) |
| 4 | rate-limited (429) |
| 5 | wallet / chain / signing |
| 6 | server (5xx after retries) / network |
| 7 | validation (422, 4xx other) |
| 70 | unimplemented (transitional, scaffold-only) |