## Problem

## Solution

## Release Note
- [ ] Internal only (no user-facing release note)
- User-facing summary (1-2 bullets, outcome-focused):
- Migration or operator note (if needed):

## Breaking Changes
- [ ] None
- [ ] Yes — details:

## Tests
- [ ] Unit
- [ ] Integration
- [ ] Performance (if applicable)

## Documentation
- [ ] CHANGELOG updated (user-visible changes)
- [ ] Docs updated (README/docs/*)
- [ ] Stability note updated (if interfaces change)

## AI usage
- [ ] No AI used
- [ ] AI used in an assistive role only, and I manually reviewed the full change
- [ ] If AI was used, I disclosed the use and can explain every part of this PR

> Please do not submit fully or predominantly AI-generated changes.

## Links
- Related tickets:

## Sign-off
- [ ] DCO: Please include a `Signed-off-by: Your Name <you@example.com>` line in each commit if using DCO

> Note: Codeowners review is appreciated. See GOVERNANCE.md for more on our process.