## Problem

Describe the user-visible problem this pull request addresses.

## Changes

Explain the implementation and the affected components.

## Verification

List the commands and manual checks used to verify the change.

## Checklist

- [ ] This pull request targets the `beta` branch, not `main`.
- [ ] I followed `GUIDELINES.md`.
- [ ] I added or updated focused tests for changed behavior.
- [ ] I updated documentation for user-visible commands, settings, APIs, or workflows.
- [ ] I did not add credentials, personal data, runtime data, or generated secrets.
- [ ] I called out migrations, security implications, and platform-specific behavior above.
