Files
lda-wf/docs/runbooks/presentation-visual-review.md
T

97 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Presentation Visual Review
## Review States
Open each URL in a browser at 100% zoom, 1280x720 viewport:
1. **Scene 6 root**: `http://127.0.0.1:5173/present#scene/architecture/overview`
2. **Scene 6 runtime**: `http://127.0.0.1:5173/present#scene/architecture/runtime/focus/runtime-providers`
3. **Scene 6 providers**: `http://127.0.0.1:5173/present#scene/architecture/runtime/focus/runtime-providers/configured-providers`
4. **Console**: `http://127.0.0.1:5173/console`
## Adaptive Canvas Matrix
Review these routes at `1024x768`, `1200x800`, and `1280x720`, always at 100%
browser zoom:
1. `/present#scene/architecture/overview/focus/node-use`
2. `/present#scene/resume-output-evidence/trace`
The logical canvas widths must be `960`, `1080`, and `1280` respectively.
Capture the receipt state and open-inspector state at each viewport. Confirm
no page scroll, unchanged primary geometry, bounded raw evidence, focus
restoration, compact chat exclusion, and a clean browser console.
## Repeatable Rehearsal Capture
With the presentation dev server running, capture every canonical route at both
supported rehearsal viewports:
```powershell
pwsh -File scripts/presentation-rehearsal.ps1
```
Review the generated screenshots in story order, then inspect any route that
shows clipping, stale chrome, unreadable copy, or a changed primary visual.
The runner waits for the settled route before each capture and writes ignored
output under `web/apps/console/.visual-smoke/rehearsal/`.
## Automated Smoke
```bash
pnpm --filter @lda/console exec vitest run
pnpm --filter @lda/console typecheck
pnpm --filter @lda/console build
```
## Browser Checklist
1. 1024x768 uses a 960x720 logical canvas without vertical letterboxing
2. 1200x800 uses a 1080x720 logical canvas
3. 1280x720 uses a 1280x720 logical canvas
4. Ratios outside 4:3 through 16:9 letterbox at the nearest supported ratio
5. Warm Editorial Canvas unchanged across Scene 1 and Scene 6
6. Non-demo routes have no demo rail, replay label, discussion button, or presenter controls; Scenes 7-11 retain the approved compact demo footer rail
7. Scene 6 root has one primary figure and no competing card grid
8. Runtime & providers expands in place with breadcrumb
9. Configured providers expands second level
10. Escape pops exactly one level
11. Tab, arrows, and Enter work without advancing presentation while figure focus active
12. Deep links reproduce both focus depths after reload
13. Every visible node readable without relying on color
14. No vertical or horizontal scrollbar
15. Console retains connection, lifecycle, graph, and execution layouts
16. Reduced-motion mode preserves all figure content
17. Evidence beats show a receipt but never auto-open the inspector
18. Opening the inspector leaves primary geometry unchanged
19. Escape closes the inspector and restores focus
20. Compact chat is hidden while the inspector is open
Screenshots require human approval and are not pixel-diff tests.
## Scene 8 Staged Message Review
Review these six deep links at `1280x720` and `1024x768`, at 100% zoom:
- `/present#scene/prepared-lifecycle/discover`
- `/present#scene/prepared-lifecycle/draft`
- `/present#scene/prepared-lifecycle/diagnose`
- `/present#scene/prepared-lifecycle/repair`
- `/present#scene/prepared-lifecycle/artifact`
- `/present#scene/prepared-lifecycle/deployment`
Confirm that one labelled textarea remains visible in every phase, is empty in
Discover, and contains the exact prepared prompt in Draft, Diagnose, Repair,
Artifact, and Deployment. Confirm the right phase projection remains dominant,
the panes do not overlap, and `document.documentElement.scrollHeight` equals
`clientHeight`. Reload direct hashes before capture: in dev mode, immediate
screenshots during an in-place hash transition can catch the presentation
animation between surfaces even though the settled/reloaded route is correct.
Edit and Send in Draft, then verify Diagnose and Repair contain that exact edited
user turn. Repeat from Artifact to Deployment. On Deployment, Send must show only
`Run request prepared for the next execution slice.`; compare `/api/rpc`
request counts before and after to confirm no execution call was made. Scenes
911 own the subsequent run activation and live execution path; do not use
Scene 8 to claim a run has started.