Files
ImpTune/.planning/phases/02-driver-management/02-VALIDATION.md
T

4.1 KiB

phase, slug, status, nyquist_compliant, wave_0_complete, created
phase slug status nyquist_compliant wave_0_complete created
2 driver-management draft false false 2026-04-10

Phase 2 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.


Test Infrastructure

Property Value
Framework pytest (already installed in requirements-dev.txt from Phase 1)
Config file None — uses pytest auto-discovery
Quick run command pytest tests/ -x -q
Full suite command pytest tests/ -v
Estimated runtime ~5 seconds

Sampling Rate

  • After every task commit: Run pytest tests/ -x -q
  • After every plan wave: Run pytest tests/ -v
  • Before /gsd:verify-work: Full suite must be green
  • Max feedback latency: 10 seconds

Per-Task Verification Map

Task ID Plan Wave Requirement Test Type Automated Command File Exists Status
02-01-01 01 1 DRV-01 integration pytest tests/test_driver_upload.py::test_upload_valid_zip -x W0 pending
02-01-02 01 1 DRV-01 unit pytest tests/test_driver_upload.py::test_upload_non_zip -x W0 pending
02-01-03 01 1 DRV-01 unit pytest tests/test_driver_upload.py::test_upload_no_inf -x W0 pending
02-02-01 02 1 DRV-02 unit pytest tests/test_inf_parser.py::test_simple_driver_desc -x W0 pending
02-02-02 02 1 DRV-02 unit pytest tests/test_inf_parser.py::test_token_resolution -x W0 pending
02-02-03 02 1 DRV-02 unit pytest tests/test_inf_parser.py::test_utf16_encoding -x W0 pending
02-02-04 02 1 DRV-02 unit pytest tests/test_inf_parser.py::test_multi_model_inf -x W0 pending
02-03-01 03 2 DRV-03 integration pytest tests/test_driver_upload.py::test_drivers_page -x W0 pending
02-03-02 03 2 DRV-03 integration pytest tests/test_driver_upload.py::test_upload_returns_select -x W0 pending
02-04-01 01 1 DRV-04 integration pytest tests/test_driver_upload.py::test_driver_persisted -x W0 pending
02-04-02 01 1 DRV-04 integration pytest tests/test_driver_upload.py::test_dedup_upload -x W0 pending
02-05-01 02 1 DRV-05 unit pytest tests/test_inf_parser.py::test_unused_files -x W0 pending
02-05-02 03 2 DRV-05 integration pytest tests/test_driver_upload.py::test_unused_files_in_response -x W0 pending

Status: pending · green · red · ⚠️ flaky


Wave 0 Requirements

  • tests/test_inf_parser.py — stubs for DRV-02 (INF parsing, token resolution, encoding, multi-model)
  • tests/test_driver_upload.py — stubs for DRV-01, DRV-03, DRV-04, DRV-05 (upload endpoint integration tests)
  • tests/fixtures/sample.inf — minimal valid INF fixture with %TOKEN% values
  • tests/fixtures/sample_utf16.inf — UTF-16 LE encoded INF fixture
  • tests/fixtures/sample_multi_model.inf — INF with NTamd64 and undecorated sections
  • imptune/services/__init__.py — package marker (services/ directory)

Framework already installed; conftest.py with tmp_data_dir fixture already covers DB isolation


Manual-Only Verifications

Behavior Requirement Why Manual Test Instructions
Upload form renders correctly in browser DRV-03 Visual layout verification Open /drivers, verify file input and submit button visible
Dropdown populated after upload in browser DRV-03 HTMX swap visual verification Upload sample ZIP, verify <select> appears with driver names

Validation Sign-Off

  • All tasks have <automated> verify or Wave 0 dependencies
  • Sampling continuity: no 3 consecutive tasks without automated verify
  • Wave 0 covers all MISSING references
  • No watch-mode flags
  • Feedback latency < 10s
  • nyquist_compliant: true set in frontmatter

Approval: pending