@@ -83,8 +83,12 @@ keep the same versioning pattern but remove the static-only flags.
## Config
- TOML config: `BurntSushi/toml`.
+- Default config file: read from `$XDG_CONFIG_HOME/<app-name>/config.toml`,
+ falling back to `~/.config/<app-name>/config.toml` when `XDG_CONFIG_HOME` is
+ unset.
- Env vars: read at the boundary, validate early, and store in a typed config
struct.
+- Config precedence is flag, then environment variable, then config file.
- Config discovery should be explicit and documented; avoid magical precedence
unless the project truly needs layering.