## Description

<!-- What does this PR do? Why is it needed? -->

## Type of change

- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation update
- [ ] Refactor / chore

## Checklist

- [ ] Tested locally with Docker Compose
- [ ] TypeScript compiles without errors (`tsc --noEmit`)
- [ ] No new ESLint warnings
- [ ] **Tests added or updated** — new logic has unit/integration tests in `__tests__/`
- [ ] DB schema changes include a migration file in `packages/shared/src/db/`
- [ ] API changes follow existing guard patterns (`guardAgentWrite` / `guardAdmin`)
- [ ] Screenshots included for UI changes
- [ ] CHANGELOG.md updated (for user-facing changes)
- [ ] No breaking changes (or clearly documented in description)

## Tests

<!-- Describe what tests cover this change, or explain why tests are not applicable (e.g. pure UI tweak, docs-only change). -->
