## Summary
- 
- 
- 

## Background
- Current limitation:
- Why this feature is being added now:

## Scope
- Areas touched:
- Explicitly not changed:

## Validation
- [x] `uv run ruff check .`
- [x] `uv run ruff format --check .`
- [x] `uv run pytest tests/ -x --timeout=60`
- [x] Functional, smoke, or E2E verification is listed below
- [x] UI changes include `raw.githubusercontent.com` screenshot URLs when applicable
- [x] Any screenshots, recordings, or demos use real `.traces/` data
- [ ] If any gate or evidence is skipped, explain why and get reviewer approval before merge

## Results
- 
- 

## Evidence
- Screenshots / recordings / trace files:

## Follow-up
- Known gaps left out of this PR:

## Risk / Rollback
- Main risk:
- Rollback plan:
