<!--
Thanks for sending a PR! Keep it focused on a single change — unrelated
refactors are easier to review separately. See CONTRIBUTING.md for the
full process.
-->

## Summary

<!-- What does this PR change and why? Link related issues. -->

## Test plan

<!-- How did you verify the change? Commands run, scenarios covered.
Include before/after numbers for performance changes. -->

- [ ]

## Checklist

- [ ] `just check` passes locally (fmt + clippy + tests)
- [ ] New behaviour is covered by tests where it makes sense
- [ ] Commit messages follow [conventional commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `docs:`, …)
- [ ] User-visible changes (CLI, config, output) are reflected in the README or relevant docs
