kimai-plugin-heatmap/.planning/phases/04-heatmap-interaction/04-VALIDATION.md

2.3 KiB

phase slug status nyquist_compliant wave_0_complete created
4 heatmap-interaction draft false false 2026-04-08

Phase 4 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.


Test Infrastructure

Property Value
Framework Vitest 3.x (JS) + PHPUnit (PHP)
Config file vitest.config.ts / phpunit.xml.dist
Quick run command npx vitest run
Full suite command npx vitest run && php vendor/bin/phpunit
Estimated runtime ~5 seconds

Sampling Rate

  • After every task commit: Run npx vitest run
  • After every plan wave: Run npx vitest run && php vendor/bin/phpunit
  • Before /gsd-verify-work: Full suite must be green
  • Max feedback latency: 5 seconds

Per-Task Verification Map

Task ID Plan Wave Requirement Threat Ref Secure Behavior Test Type Automated Command File Exists Status
04-01-01 01 1 HEAT-07 N/A unit npx vitest run W0 pending
04-01-02 01 1 INTR-01 N/A unit npx vitest run W0 pending
04-02-01 02 2 TEST-04 N/A unit npx vitest run W0 pending

Status: pending · green · red · ⚠️ flaky


Wave 0 Requirements

  • Existing test infrastructure covers all phase requirements (Vitest + jsdom already configured from Phase 3).

Manual-Only Verifications

Behavior Requirement Why Manual Test Instructions
Click navigates to Kimai timesheet HEAT-07 window.location.href mock in jsdom Verify in browser: click cell, check URL
Filter dropdown visual placement INTR-01 Layout/positioning Visual inspection in browser

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 < 5s
  • nyquist_compliant: true set in frontmatter

Approval: pending