rust-dev

# Rust Development ## Core Rules 1. **Edition 2024**: Always `edition = "2024"` in Cargo.toml 2. **FAIL FAST**: Every error MUST propagate with `?` or `return Err`. Logging is NOT handling. See [error-handling.md](references/error-handling.md) 3. **Dependency versions**: Use `x.x` format (e.g., `serde = "1.0"`). Find latest with `python3 scripts/check_crate_version.py <crate>` 4. **Workspace architecture**: Root Cargo.toml defines workspace only. Separate crates for lib/cli/client 5. **Error types**: `thiserror` (with backtrace) for libraries, `anyhow` for binaries/tests 6. **CLI-first config**: Never bypass CLI args. Use `from_cli_args()`, never `Default` that reads env 7. **No `env::set_var` in tests**: Pass config through function parameters 8. **Async**: Use tokio consistently 9. **Visibility**: Private (default) > `pub(crate)` > `pub` 10. **No magic numbers**: Use `const` or CLI args ## Adding Dependencies 1. Run `python3 scripts/check_crate_version.py <crate-name>` to find latest version 2. Add to `[workspace.dependencies]` in root Cargo.toml with `x.x` format 3. Reference in member crates: `serde = { workspace = true }` Common deps: `thiserror = "2.0"`, `anyhow = "1.0"`, `tokio = { version = "1", features = ["full"] }`, `serde = { version = "1.0", features = ["derive"] }`, `clap = { version = "4.5", features = ["derive"] }` ## Creating New Projects Use the template in `assets/workspace-template/`: ``` project/ ├── Cargo.toml # Workspace root, no co...