<!--
  Thanks for the PR! Please make sure your title follows conventional commits:
    feat(scope): short description
    fix(scope): short description
    docs(scope): ...
-->

## What

<!-- One paragraph: what does this change do? -->

## Why

<!-- One paragraph: what problem does it solve, or what does it enable? -->

## How

<!-- Brief: key implementation choices, anything reviewers should look at. -->

## Checklist

- [ ] Tests pass (`npm test`)
- [ ] Typecheck clean (`npm run typecheck`)
- [ ] Added or updated tests for changed behavior
- [ ] Updated `.env.example` if a new env var was introduced
- [ ] Updated `ROADMAP.md` / `CHANGELOG.md` if this closes a roadmap item
- [ ] No `console.log` left in committed code
- [ ] No `.env.local` or other secret-bearing files staged

## Screenshots / demo (if UI)

<!-- Drop a screenshot or screen recording here. -->

## Linked issues

Closes #
