46 lines
2.9 KiB
Markdown
46 lines
2.9 KiB
Markdown
## 1. Playwright Foundation and Harness
|
|
|
|
- [x] 1.1 Add Playwright project setup (config, scripts, browser install, test directory layout).
|
|
- [x] 1.2 Implement shared fixtures for seeded app state, authless startup, and deterministic article data assumptions.
|
|
- [x] 1.3 Define viewport profiles (mobile/tablet/desktop) and theme profile helpers (light/dark/contrast).
|
|
- [x] 1.4 Add stable selector strategy for critical controls (role/test-id fallback rules) to reduce locator fragility.
|
|
|
|
## 2. Capability Coverage Matrix and Strategy
|
|
|
|
- [x] 2.1 Create capability-to-test mapping document covering all current OpenSpec UI-facing capabilities.
|
|
- [x] 2.2 Define scenario taxonomy (journey, accessibility-state, responsive, modal, microinteraction, deep-link).
|
|
- [x] 2.3 Define smoke vs full regression profiles and execution criteria per CI stage.
|
|
|
|
## 3. Core Journey and Modal Flows
|
|
|
|
- [x] 3.1 Implement Playwright scenarios for hero/feed browsing and summary modal open/close across entry paths.
|
|
- [x] 3.2 Add deep-link permalink tests validating valid, invalid, and hero-origin modal flows.
|
|
- [x] 3.3 Add source CTA/share/copy interaction tests in modal and verify non-breaking navigation behavior.
|
|
|
|
## 4. Accessibility and Interaction State Regression
|
|
|
|
- [x] 4.1 Implement keyboard-navigation and focus-visible assertions for primary interactive controls.
|
|
- [x] 4.2 Implement color-contrast/state assertions for text/link/control states across light/dark/contrast themes.
|
|
- [x] 4.3 Add icon-only control accessible-name assertions (share, copy, back-to-top, theme controls, modal actions).
|
|
- [x] 4.4 Add policy modal accessibility tests for open, escape-close, focus-return, and focus containment behavior.
|
|
|
|
## 5. Responsive and Footer Microinteractions
|
|
|
|
- [x] 5.1 Implement responsive regression tests for mobile/tablet/desktop ensuring no overflow/clipping on key surfaces.
|
|
- [x] 5.2 Add sticky header/footer and floating back-to-top behavior checks across breakpoints.
|
|
- [x] 5.3 Add footer contact-email tooltip tests for mouse hover/move/leave and keyboard focus/blur interactions.
|
|
- [x] 5.4 Add env-driven footer link rendering tests for present/absent GitHub/contact config combinations.
|
|
|
|
## 6. Quality Gate Integration and Reporting
|
|
|
|
- [x] 6.1 Integrate Playwright smoke suite into pull-request quality gate with fail-on-regression policy.
|
|
- [x] 6.2 Integrate full Playwright profile into main/nightly pipeline stage with artifact retention.
|
|
- [x] 6.3 Enable trace/screenshot/video capture on failure and expose artifact links in CI logs.
|
|
- [x] 6.4 Document triage workflow and ownership for UI/UX regression failures.
|
|
|
|
## 7. Validation and Readiness
|
|
|
|
- [ ] 7.1 Run smoke profile locally and in CI, fixing flakiness until deterministic pass criteria are met.
|
|
- [ ] 7.2 Run full profile and confirm required capability coverage matrix is satisfied.
|
|
- [ ] 7.3 Verify OpenSpec capability requirements in this change are test-mapped and implementation-ready.
|