Lesbare Fehler, funktioniert offline, Manpage aus dem Code generiert.
Constitution — Rust CLI
Version 1.0.0 · Ratified 2026-11-10
These principles hold for every spec, plan and task of the tool. A spec may add rules; it never weakens these.
-
Readable errors. Errors tell the user what failed, why and what to try next, with the chain of causes (
anyhowormiettecontext). A raw panic message or a debug-formatted error reaching the user is a defect. -
Works offline. Every command that does not need the network works without it, and commands that do say so clearly and fail fast with a timeout. No command phones home without an opt-in.
-
Man page generated from the code. The man page and shell completions are generated from the
clapdefinitions withclap_mangenandclap_completeat build time. Help text exists in one place only. -
Typed arguments. Arguments are parsed with
clapderive into typed structs with value enums and validators, so invalid input fails at parse time with exit code 2. -
No panics in normal use.
mainreturns aResult;unwrapandexpectare denied by Clippy outside tests. Output to a closed pipe exits quietly instead of panicking. -
Tested as a binary. Integration tests run the binary with
assert_cmdand check stdout, stderr and exit codes, with snapshots for help and output. Releases are built for every target in CI withcargo-distor equivalent.