Publisher training-video plan + deterministic demo capturer#278
Open
Hackshaven wants to merge 3 commits into
Open
Publisher training-video plan + deterministic demo capturer#278Hackshaven wants to merge 3 commits into
Hackshaven wants to merge 3 commits into
Conversation
…urer
Add a 'why + how' video production plan and the capture tooling to
produce its portal footage reproducibly.
- docs/VIDEO_PRODUCTION_PLAN.md: treatment + shot-by-shot script for a
~4:30 hero film ('Reach Without Surrender', grounded in MISSION.md's
two-walls thesis) and 60-120s task chapters, plus a ship-check and a
capture runbook (deterministic portal track + seeded-live b-roll).
- scripts/screenshots/demo.ts + 'screenshots:demo': a scripted
walk-through capturer that reuses the visual-report fixture/scene
stack, so each flow (overview / node-profile / dataset / import /
events / blog / analytics) renders fully populated with no backend
and is reproducible. Emits a .webm clip per flow + numbered stills +
manifest.json into demo-out/ (gitignored).
- core/browser.ts: add withVideoPage (recordVideo context → saved .webm)
and honor PLAYWRIGHT_CHROMIUM_PATH to launch a pre-installed browser
when the pinned Playwright build isn't downloaded. Both default-off,
no effect on existing report/smoke/capture runs.
Dev-only tooling; not in the product bundle, not a CI gate. Validated
end-to-end against a live dev server (all flows render populated).
Signed-off-by: Claude <noreply@anthropic.com>
- blog flow now cites a fixture event on the Sources tab and serves a real Earth frame for the Worldview snapshot, so the Media tab renders a populated 'Satellite view' suggestion card (plus the not-shown notes) instead of an empty state — deterministic, no live NASA fetch. - add two demo flows: workflows (list + editor) and feedback (AI thumbs + general tabs, via feedbackFixtures). Nine flows total. - doc: update the flow list, chapter mapping, and blog Media note. Validated end-to-end against a live dev server; all three render populated. Signed-off-by: Claude <noreply@anthropic.com>
Contributor
🖼️ Visual report68 shot(s) · 2 viewport(s) (desktop, mobile) · 45 with problems · 105 problem(s) total Regression: 3 shot(s) changed, 0 new (baseline-less, soft pass), threshold 0.001.
Shots with problems
Full report → Advisory — this check never fails the build. Visual review only. |
Close the last automation gap in the video plan — the Act 2 'payoff'
footage — and make the output self-reviewing.
- Two live b-roll flows in screenshots:demo:
- globe: ?embed=1&rotate=on — minimal-chrome auto-rotating globe.
- orbit: /orbit?preset=planetary&fly=1 — Orbit's fly-to-Earth, with
the dev perf-HUD + debug panel hidden for a clean shot.
These record real WebGL (clips first). Fixtures are now optional so
they run against real data/tiles; the globe waits for the loading
splash to clear best-effort (the Earth imagery needs network — in a
restricted sandbox it shows the branded loading state; Orbit's
character renders regardless).
- storyboard.html: a generated, self-reviewing page pairing every clip
+ still with its narration cue (from the manifest), for scanning the
shot flow or handing to an editor.
- doc: document the b-roll flows, their network dependency, the
storyboard output, and the seeded-live path for dataset-on-globe /
tour playback.
Validated end-to-end: all flows run; Orbit renders clean; portal flows
populated. Dev-only tooling, no product code, not a CI gate.
Signed-off-by: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
New publishers face a dense portal UI with a lot of latent capability and no onboarding film (the repo had no UI-motion assets — only the still-PNG
report-out/gallery). This adds a "why + how" video production plan and the capture tooling to produce its portal footage reproducibly.Deliverables
docs/VIDEO_PRODUCTION_PLAN.md— treatment + shot-by-shot script + runbook.MISSION.md's two-walls thesis: the problem → the public payoff (globe / blog→"Play tour" / Orbit / embed) → the portal happy-path (hitting the signature moments) → reach-without-surrender + CTA. Act 3 maps each VO line to a specific capture clip.scripts/screenshots/demo.ts+npm run screenshots:demo— a scripted walk-through capturer that reuses the visual-report fixture/scene stack, so each flow renders fully populated with realistic data against a plainvitedev server (no backend) and is reproducible run-to-run. Nine flows (overview, node-profile, dataset, import, events, blog, workflows, feedback, analytics); each emits a.webmclip + numbered stills +manifest.jsonintodemo-out/(gitignored). Theblogflow cites a fixture event and serves a real Earth frame for the Worldview snapshot so the Media tab renders a populated suggestion card.scripts/screenshots/core/browser.ts— addswithVideoPage(records a clip via PlaywrightrecordVideo) and honorsPLAYWRIGHT_CHROMIUM_PATH(launch a pre-installed browser when the pinned Playwright build isn't downloaded). Both default-off; no effect on existing report/smoke/capture runs.Scope / safety
Dev-only tooling — not in the product bundle, not a CI gate;
demo-out/is gitignored. No product code changes.Verification
npm run type-check✓ andnpm run test(91 screenshot tests) ✓.npm run screenshots:demoend-to-end against a live dev server — all nine flows render populated (spot-checked the events triage, blog Media card, and feedback dashboard stills).🤖 Generated with Claude Code
Generated by Claude Code