---
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
