97 lines
3.9 KiB
Markdown
97 lines
3.9 KiB
Markdown
---
|
|
phase: 10-ux-interaction
|
|
plan: "05"
|
|
subsystem: frontend-tests
|
|
tags: [wave-0, test-stubs, nyquist, ux, vitest]
|
|
dependency_graph:
|
|
requires: []
|
|
provides: [wave-0-stubs-ux-02-03-04-05-06-07-08-09-11-13-14]
|
|
affects: [plans/10-06, plans/10-07, plans/10-08, plans/10-09]
|
|
tech_stack:
|
|
added: []
|
|
patterns: [vitest-it-todo-stub-pattern, nyquist-red-before-green]
|
|
key_files:
|
|
created:
|
|
- frontend/src/components/storage/__tests__/StorageBrowser.skeleton.test.js
|
|
- frontend/src/components/layout/__tests__/AppSidebar.empty.test.js
|
|
- frontend/src/views/admin/__tests__/AdminAuditView.skeleton.test.js
|
|
- frontend/src/views/admin/__tests__/AdminUsersView.skeleton.test.js
|
|
- frontend/src/components/ui/__tests__/dropdown.test.js
|
|
- frontend/src/__tests__/keyboard.test.js
|
|
- frontend/src/components/layout/__tests__/OsDragOverlay.test.js
|
|
- frontend/src/components/storage/__tests__/StorageBrowser.dragmove.test.js
|
|
modified: []
|
|
decisions:
|
|
- "it.todo() stubs chosen over it.skip() — todo produces pending rather than skipped, giving clear Wave 1-4 promotion targets"
|
|
- "Separate describe blocks per requirement ID — each UX-XX maps to an isolatable test group"
|
|
metrics:
|
|
duration_minutes: 3
|
|
completed_date: "2026-06-15T18:13:21Z"
|
|
tasks_completed: 2
|
|
tasks_total: 2
|
|
files_created: 8
|
|
files_modified: 0
|
|
---
|
|
|
|
# Phase 10 Plan 05: Wave 0 xfail Test Stubs Summary
|
|
|
|
**One-liner:** 53 `it.todo` stubs across 8 files giving each of UX-02..09, UX-11, UX-13, UX-14 a promotion target before any Wave 1-4 implementation code is written.
|
|
|
|
## What Was Built
|
|
|
|
Created 8 Vitest stub test files using the Nyquist pattern (RED stubs before implementation). Each file contains `describe('UX-XX: ...')` blocks with `it.todo(...)` entries that Wave 1-4 implementing plans will promote to real assertions.
|
|
|
|
### Task 1: Skeleton + Dropdown Stubs (UX-02, UX-03, UX-04, UX-13, UX-14)
|
|
|
|
| File | Requirements | Stub Count |
|
|
|------|-------------|-----------|
|
|
| `StorageBrowser.skeleton.test.js` | UX-02, UX-13 | 7 |
|
|
| `AppSidebar.empty.test.js` | UX-03, UX-01 (micro), UX-14 | 10 |
|
|
| `AdminAuditView.skeleton.test.js` | UX-04, UX-01 (audit empty) | 5 |
|
|
| `AdminUsersView.skeleton.test.js` | UX-04 | 3 |
|
|
| `dropdown.test.js` | UX-13 | 4 |
|
|
|
|
**Task 1 commit:** `7597035` — 5 files, 29 it.todo stubs
|
|
|
|
### Task 2: Keyboard + OS-Drag + Drag-to-Move Stubs (UX-05..09, UX-11)
|
|
|
|
| File | Requirements | Stub Count |
|
|
|------|-------------|-----------|
|
|
| `keyboard.test.js` | UX-05, UX-06, UX-07, UX-08 | 11 |
|
|
| `OsDragOverlay.test.js` | UX-09 | 7 |
|
|
| `StorageBrowser.dragmove.test.js` | UX-11 | 6 |
|
|
|
|
**Task 2 commit:** `794ff42` — 3 files, 24 it.todo stubs
|
|
|
|
### Total
|
|
|
|
- **8 stub files** created
|
|
- **53 `it.todo` stubs** total
|
|
- **11 requirements** covered: UX-02, UX-03, UX-04, UX-05, UX-06, UX-07, UX-08, UX-09, UX-11, UX-13, UX-14
|
|
|
|
## Verification Results
|
|
|
|
- All 8 files exist at the specified paths
|
|
- Main repo test suite: 153/153 tests pass — no regressions
|
|
- Stub files contain no assertions; `it.todo()` produces "pending" status in Vitest, not failures
|
|
- Each requirement ID appears in at least one `describe('UX-XX: ...')` block
|
|
- Grep coverage count: 14 lines match `UX-0[23456789]|UX-1[1345]|UX-14` across all 8 files (minimum was 11)
|
|
|
|
## Deviations from Plan
|
|
|
|
None — plan executed exactly as written.
|
|
|
|
## Known Stubs
|
|
|
|
By design, all 53 test entries are `it.todo()` stubs. These are intentional Wave 0 placeholders — they exist specifically to be promoted to real `it(...)` assertions by the implementing waves (Waves 1-4, plans 10-06 through 10-11). They are not integration or correctness gaps.
|
|
|
|
## Threat Flags
|
|
|
|
None — this plan creates only test stub files with no source code changes, no new network surface, and no security-relevant implementation.
|
|
|
|
## Self-Check: PASSED
|
|
|
|
- All 8 files confirmed present on disk
|
|
- Commits 7597035 and 794ff42 confirmed in git log
|
|
- No unexpected file deletions in either commit
|