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

79 lines
3.8 KiB
Markdown

# Presentation Follow-Up Visual Review
Review date: 2026-07-13
This record closes the visual/story follow-up pass described by
[`presentation follow-up visual/story pass`](../historical/superpowers/plans/2026-07-13-presentation-followup-visual-story-pass.md).
It records what was checked, what is now presentable, and what remains a
factual or product follow-up rather than silently treating it as solved.
## Verification
- Presentation route contract: 7 changed routes assert one exact heading, one
primary visual region, and no outer document scroll.
- Focused evaluation, conclusion, and opening tests: 16 passed.
- Workflow graph tests: 34 passed.
- Full web gate: console 754 passed; RPC 52 passed and 6 skipped; server 46
passed.
- Full web typecheck and build passed; the build retains the known Vite chunk
size warning.
- Rehearsal capture: 42 routes at both `1280x720` and `1024x768` (84 PNGs).
- Typecheck: `pnpm --dir web typecheck` passed.
- Browser smoke: checked at `1280x720` and `1024x768` for the workflow graph,
evaluation findings, conclusion, and Scene 1 opening.
- Workflow graph: React Flow initializes with a measured `fitView`; all ten
nodes and both outcome branches remain inside the graph frame at both target
viewports.
## Fixed Visuals
| Area | Result |
|---|---|
| Scene 1 opening | Product goal, implementation boundary, and planner/tool-surface/runner decomposition are distinct. The opening caption remains editorial and borderless; its row sizes to content instead of clipping the lower padding. |
| Scene 5 to 7 story | Lifecycle vocabulary now leads into authoring and repair rather than presenting authoring as an isolated diagnostic screen. |
| Scenes 7 and 9 | Authoring and prepared-lifecycle evidence use a dominant artifact with secondary assistant/support surfaces. |
| Scene 9 graph | The graph is horizontal, factual, selectable, draggable/zoomable, and fit to the initialized React Flow viewport. Outcome shapes and edge labels remain visible. |
| Scene 12 findings | Six findings use a readable 3x2 layout with icons, campaign size, outcome counts, and the bounded-evidence statement visible together. |
| Scene 13 conclusion | The typed substrate and closing boundary are dominant; non-claims and future-work layers recede without being removed from their own beats. |
## Remaining Findings
### FACTUAL
- Scene 10 input remains a prepared-run manifest, not a factual file browser
distinguishing declared, selected, read, and produced files. This remains a
separate roadmap item.
- The prepared revision-request replay uses
`run_recorded_lda_report_revision`, while the submitted replay uses
`run_recorded_lda_report`. Do not describe the revision recording as the same
persisted run until a same-run recording is available.
### PRODUCT
- Live Scene 9-11 execution is health-checked and connectable, but still needs
a complete rehearsed start -> interrupt -> resume -> output -> trace path on
the running workflow server.
- The presentation chat remains a scripted/replay product surface. A live LLM
driver and streaming agent conversation are future work.
### BLOCKED / DEFERRED
- A full manual inspection of every screenshot generated by the 42-route,
two-viewport rehearsal script remains a rehearsal activity, not a claim that
every beat has been visually hand-approved.
- The final defense story-flow review and presenter companion assets remain
separate from this visual pass.
## Rehearsal Commands
```powershell
pnpm --dir web test -- --run
pnpm --dir web typecheck
pnpm --dir web build
./scripts/presentation-rehearsal.ps1
```
Use [`defense-presentation.md`](defense-presentation.md) for live/replay
fallbacks and [`presentation-rehearsal-matrix.md`](presentation-rehearsal-matrix.md)
for the route-by-route speaking line and evidence pointer.