<!-- Keep it short. Match length to the change. -->

**What**

<!-- One or two sentences on what changed. -->

**Why**

<!-- The problem this solves, or the issue/doc it came from. Link it. -->

**Risk / priority**

<!-- Severity x reach / effort, and anything reviewers should watch. -->

**How verified**

- [ ] `npm run verify` green
- [ ] regression test added (for a bug or security fix)
- [ ] `CHANGELOG.md` updated (for user-visible change)
- [ ] semver bump + migration note (if public surface changed)
