## Summary
Describe the change and its motivation. Link related issues.

## Changes
- What was added/changed/removed?
- Any notable design decisions?

## Tests
- What tests cover this change?
- If no tests were added/updated, explain why automated tests are not appropriate and include manual validation steps.

## Checklist
- [ ] All tests pass locally: `poetry run pytest -q`
- [ ] Tests added/updated for new or changed behavior, or justification provided
- [ ] Backward compatibility preserved (or breaking change documented)
- [ ] Minimal dependencies; none added unnecessarily
- [ ] Public APIs typed and documented where relevant
- [ ] Docs updated (README/usage guides where applicable)

## Additional Notes
Anything else reviewers should know.
