dicom_preflight_quality_v1
Purpose
- Audits
dicom_series_preflightevidence packs for explicit pass/warn/fail preflight findings. - Use this after the preflight wrapper has inspected a DICOM series and written an evidence pack. Engineering verification only.
- Manifest I/O: inputs are
dicom_series_preflight_evidence_pack; outputs aredicom_preflight_quality_report.
Instructions
- Run
scripts/grade.pyon the preflight evidence-pack directory. - If a host agent exposes
run_script, userun_script("scripts/grade.py", args=["RUNS/PREFLIGHT_PACK"]). - Prefer the eval-engine command when you need a verifier evidence pack; use the direct Python command for quick local inspection.
Available Scripts
| Script | Purpose | Arguments |
|---|---|---|
scripts/grade.py |
Primary verifier entrypoint declared by skill_manifest.yaml. |
EVIDENCE_PACK_DIR |
Prerequisites
- The target pack must contain
output.jsonandvalidation_summary.json. - The source preflight run should have completed before this verifier is called.
Limitations
- This verifier audits recorded preflight findings; it does not re-read every DICOM instance.
- Not for clinical de-identification, PHI clearance, or regulatory sign-off.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| Missing pack JSON | The fixture path is not a completed evidence pack. | Point to the source preflight run directory. |
| Unexpected fail verdict | The source preflight pack recorded fail-level findings. | Inspect preflight_gate.findings in the verifier output. |
| No findings | The source wrapper did not emit preflight details. | Re-run the source skill and preserve output.json. |
Paired verifier for skills/dicom-series-preflight.
python verifiers/dicom_preflight_quality_v1/scripts/grade.py runs/preflight_trusted
make run-trusted SKILL=dicom_series_preflight \
FIXTURE=skills/dicom-series-preflight/fixtures/clean_no_phi \
OUT=runs/preflight_trusted
Reads the target pack's output.json and validation_summary.json. Emits
overall of pass, warn, or fail plus a preflight_gate.findings list.
Not for clinical de-identification or regulatory clearance.