<!-- All changes land via PR — no direct pushes to master. -->

## What & why

<!-- Brief summary of the change and the motivation / linked issue (e.g. Closes #NN). -->

## Checklist

- [ ] **Tests** added or updated for this change — or it is a docs/config/automation-only PR (tests not applicable). Model: the integration test on `claude/issue-12` (prod-mirror DB, raw-SQL inserts, prefix-isolated, cleans up after itself).
- [ ] **Docs** updated where relevant (App/README.md, App/CLAUDE.md, Docs/, automation/README.md, CHANGELOG.md).
- [ ] `pnpm type-check` shows no new errors in application code.
- [ ] Verified the change (how: unit/integration tests, or a dev server on port 3100 against the test DB).

<!--
The "PR checks" workflow enforces the test-presence rule automatically:
a PR that touches App/app|lib|components|hooks without any test change will fail.
-->