<!-- 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` is clean and `pnpm test` passes (the PR check enforces both).
- [ ] Verified the change (how: unit/integration tests, or a dev server on port 3100 against the test DB).

<!--
The "PR checks" workflow runs on every PR and hard-fails on: a code change with no
test change, any type-check error, or any failing unit test.
-->
