| name | agent-smoke-harness |
| description | Run DICOM Viewer V3 agent smoke checks and manual UI smoke checklist after UX or loading changes. Use when verifying harness health, post-implementation smoke, or orchestrator requests manual smoke. |
Agent smoke harness
When to use
- After changing loading, navigator, MPR, overlays, SR, or main-window UX.
- Before claiming a slice is merge-ready (with
pytest).
- When
check_repo_harness.py or CI Repo harness job fails.
Automated steps
From repo root with venv activated:
python scripts/agent_smoke_harness.py --write-report
python scripts/check_repo_harness.py
python -m pytest tests/test_agent_smoke_harness.py tests/test_repo_harness.py -q
Optional Qt headless import check (local or CI with display libs):
python scripts/agent_smoke_harness.py --qt-smoke
Report path: logs/agent-smoke-report.json (gitignored if logs/ is ignored).
Manual UI smoke
Follow dev-docs/orchestration/AGENT_SMOKE.md:
python src/main.py- Load
tests/fixtures/dicom_rdsr/synthetic_ct_dose_comprehensive_sr.dcm
- Spot-check Space overlay on image pane and MPR pane
Full regression
python -m pytest tests/ -v
Use long timeout (~10 minutes) for full suite on slow machines (see AGENTS.md).
Handoff
- Status: complete — include
agent-smoke-report.json version field and pytest summary.
- Status: blocked — note failing step; do not skip
pytest failures.
