feat(sim): scrub-driven altitude transitions #28

2026-06-28T01:46:43Z

benstull commented

2026-06-28 01:46:43 +00:00

Scrub-driven altitude transitions + 4 operator-eyeball rounds of polish.

Feature (per approved design docs/superpowers/specs/2026-06-27-scrub-driven-altitude-transitions-design.md): knob position continuously drives the morph video currentTime + a two-track audio crossfade; hold-partway (no auto-complete), fully reversible, re-roll destination per fresh approach; wheel/tap auto-scrub then lock; lock-per-altitude preserved. Pure scrub math (scrub.js) + 9 node unit tests; 154 morphs re-baked all-intra (git-LFS) for smooth seeking.

Eyeball fixes: loop-from-tail landing alignment; reef_snapper NOAA title-card strip + morph re-bake; double-buffered video (no morph→loop load stall); audio on/off → 0–10 level dial (first video → 3/10); cancel in-flight volume fades (audio-off-after-landing race); constant per-altitude auto-scrub speed (2× slower, proportional to distance).

Verification: 11 Playwright E2E + 9 node unit + 302 pytest, all green.

🤖 Generated with Claude Code

Scrub-driven altitude transitions + 4 operator-eyeball rounds of polish. **Feature (per approved design `docs/superpowers/specs/2026-06-27-scrub-driven-altitude-transitions-design.md`):** knob position continuously drives the morph video currentTime + a two-track audio crossfade; hold-partway (no auto-complete), fully reversible, re-roll destination per fresh approach; wheel/tap auto-scrub then lock; lock-per-altitude preserved. Pure scrub math (`scrub.js`) + 9 node unit tests; 154 morphs re-baked all-intra (git-LFS) for smooth seeking. **Eyeball fixes:** loop-from-tail landing alignment; reef_snapper NOAA title-card strip + morph re-bake; double-buffered video (no morph→loop load stall); audio on/off → 0–10 level dial (first video → 3/10); cancel in-flight volume fades (audio-off-after-landing race); constant per-altitude auto-scrub speed (2× slower, proportional to distance). **Verification:** 11 Playwright E2E + 9 node unit + 302 pytest, all green. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

benstull added 14 commits 2026-06-28 01:46:44 +00:00

docs(plan): scrub-driven altitude transitions implementation plan 937461e3ba

Plan for the approved design at
docs/superpowers/specs/2026-06-27-scrub-driven-altitude-transitions-design.md.
Two phases: (1) scrub interaction against current morphs, (2) all-intra re-bake.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(sim): pure altitude-scrub math module + node unit suite 3dc3e3491f

Per plan Task 1. position->segment, frac->currentTime, audio gains, and
integer-crossing detection; 9 node --test cases green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(sim): two-element audio crossfade keyed by scrub fraction 0548e9a82b

Per plan Task 2. Adds <audio id=aud-b>; blendAudio(lo,frac) mixes the two
adjacent scale soundtracks by knob fraction (element reuse across crossings so
only the genuinely-new scale reloads); restAudio settles a single scale at rest.
Diagnostic readout now reports whichever element is audible.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(sim): scrub engine — drag drives pos, seeks morph, commits+locks+re-rolls 20f49e936a

Per plan Task 3. A continuous float pos is the knob: setPos() seeks the segment's
morph currentTime by frac (throttled one seek/rAF), crossfades audio, sweeps the
needle live, and commits+locks+re-rolls on each integer crossing. Drag live-scrubs
(no more commit-on-release); release holds the blend (no auto-complete). Client-side
pool pick replaces the server round-trip for drag.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(sim): wheel + label-tap auto-scrub then lock; retire discrete advance() 8458ab59eb

Per plan Task 4. onWheel + jumpToScale now animate pos via autoScrub() (drives the
same setPos scrub path, ~600ms, lands exactly on the integer + locks). Removes the
now-dead advance()/playTransition()/FAST_BLEND_RATE (the server /api/ring/advance
round-trip is no longer used by the client). Post-landing morph warm-up folded into
setPos's settle branch.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

test(e2e): scrub tier — currentTime + gains track dial, reverse, commit-lock, wheel 31a3fd733f

Per plan Task 5. Replaces the .rev-asserting zoom-out test with a turn-back test
(same forward morph seeked backward, audio recedes, re-locks the start clip); adds
a detent-crossing commit+lock test via a new window.__hefState diagnostic seam.
Full tier (6 tests) green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(pipeline): all-intra ffmpeg builders for seekable morph re-bake f2f242a411

Per plan Task 7. Extracts transition_cmd/reverse_cmd argv builders and adds the
ALL_INTRA flag set (-g 1 -keyint_min 1 -sc_threshold 0) so every baked frame is a
keyframe — smooth arbitrary-frame seeking for the scrub interaction. Unit-tested.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(pipeline): re-bake 154 morphs all-intra for smooth scrub seeking (LFS) 70fc9a46ab

Per plan Task 7. Every frame now a keyframe (verified 93/93 I-frames on a sample),
so the scrub interaction seeks to arbitrary frames smoothly. Total transitions
173M -> 504M; largest clip ~5.8M (well under the 25MB LFS/proxy ceiling).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

fix(sim): loop base from morph-tail offset so landed morphs don't jitter 614411b5e4

Operator eyeball feedback: landing on an altitude jump-cut the loop back to frame 0.
Each morph reproduces the destination clip's first 3s (pipeline trim=0:3) and ends on
dst@~3s, so the steady-state loop now starts at LOOP_TAIL_S=3.0 and loops within
[3.0, duration] — the morph's last frame hands straight off to the loop, and the
morph-covered intro never re-shows at rest (removes the overlapping 'altitude video
that is part of the morph'). E2E asserts a landed clip loops from ~3s, not 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

fix(content): strip NOAA title card from reef_snapper base + re-bake its morphs 0752746f7b

Operator eyeball feedback: the red snapper clip opened with a black 'Northern Red
Snapper / fishwatch.gov' title card. Re-trimmed reef_snapper/base.mp4 to drop the
first 3.0s (the card; footage is clean from 3.0s), 23s->20s, and re-baked the 7
reef_snapper morph pairs (+ reverses) all-intra from the clean base. Verified the
snapper-dominant morph frames are text-free.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

fix(sim): double-buffer video so morph->loop handoff doesn't stall ea530b3df6

Operator eyeball: a jolt/pause when the morph ends and the next altitude's loop
loads. Root cause: swapping vid.src to the base + seeking to the tail reloaded the
ON-SCREEN element (decode + seek stall). Now a dedicated #vid-loop element carries
the steady-state base loop; during a scrub it is PRELOADED to the clip we're heading
toward, seeked to the tail and paused on that exact frame. The paint shader reads the
active source (busy ? morph : loop), so landing is an instant source swap — no reload,
no seek. E2E asserts the loop element is armed + playing from ~3s after landing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(sim): audio on/off toggle -> 0-10 level dial; first video lifts it to 3/10 e862fb498b

Operator request. Replaces the Audio checkbox with a 0-10 range slider that sets the
master soundtrack gain (audioVol = level/10), scaling both the per-scale rest volume
and the two-track scrub crossfade. Level 0 = silent. Turning Video on for the first
time now raises audio to 3/10 (was: full on) so the experience opens gently; raising
the slider from 0 unlocks playback in-gesture (Safari). E2E: dial is range 0-10
default 0, and first video-on lifts it to 3/10.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

fix(sim): cancel in-flight volume fades so audio isn't silenced after landing 4b1d3afe7b

Operator: audio turned off sometimes after landing on a new altitude. Root cause:
fadeVolume started a setInterval ramp that was never cancelled. When restAudio faded
the idle element to 0 and — within FADE_MS — that same element became the newly-landed
ACTIVE scale (assignElements reuses an element per soundtrack url), the stale fade-to-0
kept running and dragged the now-active element back to silence. Fix: cancelFade()
supersedes any in-flight fade when a new fade starts (fadeVolume) or a direct volume
is set (ensurePlaying). E2E proves a new fade supersedes a stale one (fails without
the fix).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(sim): auto-scrub at constant per-altitude speed, 2x slower 0e401c9a42

Operator: slow click/auto transitions 2x and make them the same speed between any two
altitudes (2 away should take twice as long as 1). autoScrub duration is now
PROPORTIONAL to distance (PER_ALTITUDE_MS=1200, ~2x the old fixed 600ms total): a
label-click or wheel jump of N altitudes takes N*1200ms, so per-step speed is constant.
Manual drag is unaffected (operator drives its speed). E2E asserts a 2-step jump is
~2x a 1-step.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

benstull merged commit 108e6207ba into main

2026-06-28 01:46:55 +00:00

benstull deleted branch session-0026

2026-06-28 01:46:55 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: benstull/human-experience-filter-art#28