## Summary

Brief description of what this PR does and why.

Fixes # (issue number, if applicable)

## Type of change

- [ ] Bug fix (non-breaking)
- [ ] New feature (non-breaking)
- [ ] Breaking change (requires migration or version bump)
- [ ] Documentation / tests only

## Checklist

- [ ] `cargo test` passes
- [ ] `cargo clippy -- -D warnings` is clean
- [ ] `cargo fmt --check` passes
- [ ] New code has tests (unit and/or integration)
- [ ] Error paths are tested, not just happy paths
- [ ] No `unwrap()` / `expect()` in library code paths
- [ ] `CHANGELOG.md` updated under `Unreleased`
- [ ] I have read [PHILOSOPHY.md](../PHILOSOPHY.md) and this change aligns with it

## Notes for reviewer

Anything the reviewer should pay particular attention to (tricky logic, deliberate trade-offs, areas of uncertainty).
