## What

<!-- Brief description of the change -->

## Why

<!-- Context and motivation -->

## How to Test

<!-- Steps to verify it works -->

## Checklist

- [ ] Tests added/updated (`python -m pytest tests/ -v`)
- [ ] Type hints on all new functions
- [ ] No hardcoded paths or secrets
- [ ] Conventional commit messages