Skip to content

feat(tour): the grand tour opens on Earth - #1070

Merged
rulkens merged 55 commits into
mainfrom
worktree-tour-start-earth
Nov 18, 2026
Merged

rulkens merged 55 commits into
mainfrom
worktree-tour-start-earth

Conversation

@rulkens

@rulkens rulkens commented Nov 6, 2026 •

Copy link
Copy Markdown
Owner

The grand tour "The Long Way Out" now opens on Earth. It starts in Søndermarken park, Copenhagen, and climbs one step at a time out to the existing deep-space beats. "Home again" ends back over Copenhagen.

Plan: docs/superpowers/plans/2026-11-05-tour-opens-on-earth.md. Spec: docs/superpowers/specs/2026-11-05-tour-opens-on-earth-design.md.

Beats

  • 00 The Long Way Out: standing in the park on 2026-09-05, facing south. The camera pans west with the setting Sun, the clock runs to night, and the view tilts up to the Milky Way. Planet, star and mission labels are hidden until a beat names them.
  • 01 You are here: the rise out of the park to the whole night-side Earth.
  • 02 Earth and Moon: the Earth and Moon side-on, at their true relative sizes, with the ecliptic pole up.
  • 03 The Solar System: about 52 au out.
  • 04 Our stellar neighbourhood: ends near Alpha Centauri, looking back at the Sun.
  • 05 The Milky Way: one continuous pull-out from the star field to the whole galaxy.
  • 17 Home again: ends over Copenhagen at night, from 2,000 km.

Every beat sets its own date, frame and roll when it starts, so skipping to a beat or stepping back with Prev lands the same view.

Engine changes

  • A new clockTo scene cue animates the sim clock, with optional easing.
  • The sky camera arm releases once the view has moved to another frame (pinsEye, in projectFramePose).

Still open, so this stays a draft

  • More in-between beats from Alpha Centauri to the Milky Way (about 100 ly and 1,500 ly, maybe a turn toward the centre).
  • The whole-tour review rulings are pending: the camera position after leaving the tour, Home again as one move, and renaming youAreHere.ts.
  • The tour holding the loading veil over its first cut is parked (brief written).
  • Beats 02 and 03 each keep one ~45 ms hitch from a solar-system sky capture; Solar-system sky re-bakes at most every 4 s while thumbnails fade; capture toggles #1081 removed the rest of the stutter.
  • Beat 02 hands over to its dwell still zooming out (a coast); the other beats get the same treatment once the owner passes it.
  • The final whole-branch review and /feature-done haven't been run yet.

Known issues that are backlogged: stopping the tour in the park leaves no input (the sky look-around is being built in another session), the dark noon sky, and the floating treetops in the park.

🤖 Generated with Claude Code

rulkens and others added 30 commits November 5, 2026 18:09
Picks up the backlog item 'Grand tour: Earth start + scale rungs' (line and
detail file deleted). Files two findings from the ground check: the tour's
skip/Prev pole gap and the clip's hand-rolled clock restore.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A tour beat dispatches clockTo({ simDays, overSec }) through the existing
scene() cue; watchClockToSaga plays it as a two-sample ClockProfile from
the live instant, held at its end. overSec 0 snaps and pauses, replacing
any running profile. The type sits on tour/, off the time route that
drops a running profile.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tourBodySaga pauses the clock once, inside the takeover bracket that
already captured it, so a live clock cannot drift under the beats; only
a beat's clockTo cue moves it. Exit restores the viewer's clock, a
running clockTo profile included.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…t its end

Pausing a dwell puts the time slice's pause, so a running clockTo profile
holds with the camera; the clip's replay on resume restarts the move from
the held instant. A timed clockTo pauses at its end (takeLatest, and only
while its profile is still on the clock, so a tour exit's restored clock
is never frozen by a stale end). The test seeds its paused start with
setSimDays + pause, and clockTo's header drops its what-line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Stage docs and shipping captions for beats 00-05: the park opening, the
rise to the whole Earth, Earth and Moon, the Solar System, the stellar
neighbourhood, and the Milky Way beat retitled from "You are here". The
existing stages move up four; the Milky Way cold open is retired. Figures
carry their NASA/UN sources in each stage doc.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The tour opens standing in Søndermarken at noon, looking north up the
open lawn; the dwell tilts up to 80° while clockTo runs the clock to
20:00 UTC. The enter clip carries the scene strip, the galactic pole
and the noon snap, all instant, so the cold-load gate waits on a still
frame. openingTitle retires: its Milky Way approach moves into
youAreHere, which now frames home itself. beatDates pins that each
Earth beat snaps its own date; the frame ladder finds approachM31 by
clip instead of index.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…arth

# Conflicts:
#	src/data/animation/tours/grandTour.ts
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The tour's second beat rises from Søndermarken to the whole Earth in one
enter clip of three frame legs: on the sky arm the eye looks down at its
feet, in Earth's body frame only the distance moves so the eye climbs the
park's radial over Copenhagen and Denmark, and a world leg carries the last
of the pull-back. The dwell re-pivots on Earth's centre and drifts.

Beat 01 now shows the layers beat 00 hid; the Milky Way beat no longer
does. The park's bearing and night altitude move to PARK_VIEW so beat 01
restates exactly where beat 00 ends.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The sky arm's tag pins the eye, so refolding a pose into it throws the
position away. Over a { sky } regime with no focus, the fold put every
world-arm clip pose back in the park, and Earth was drawn from there
(the tour's world legs came out flat grey). A new ClimbRow property,
pinsEye, marks such an arm; projectFramePose releases it to its parent
whenever the produced pose is in another frame, so that pose is folded
into the body arm (lossless) and drawn where it was produced.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The backlog line it named was picked up by this branch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The rise no longer stops at the nadir before it climbs. The sky leg turns
to 23 degrees below the north horizon and hands over still turning; the
body leg finishes the turn while the eye lifts off, orbiting up over the
lawn it was looking at. The climb then holds a constant log speed, so
Copenhagen stays on screen for about 2.5 s instead of 1. The world leg
focuses Earth.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…later beats

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The tour's third beat pulls back from the whole night-side Earth until the
Moon stands across the gap. On the tour date (a new Moon) the Moon sits 4°
from the Sun's direction, so the camera swings round to a side-on view turned
40° sunward and 30° off the galactic plane: Earth and the Moon both show
gibbous, and no other planet whose caption shares the Moon's switch is in
frame. Every pose is absolute, read from the tour date's ephemeris; the beat
restates beat 01's whole-Earth view so a skip or Prev pulls back from it.

The beat clears Earth's focus (a focused moving body pins the target to its
centre whenever no clip runs), tweens away the roll beat 01's rise leaves,
and shows the planet and moon captions again. The whole-Earth height moves to
WHOLE_EARTH_HEIGHT_M so both beats read one value.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… entry

Beat 02 states the ecliptic pole, so the Earth–Moon gap (4° off the
ecliptic) runs flat, and is re-framed closer: 50° up off the ecliptic and
40° sunward, 240,000 km from a point in the gap. Earth lands lower left at
about 24 px and the Moon, gibbous on its ring, upper right at about 16 px,
with no other named planet in frame.

Every beat up to the M31 approach now states its pole on entry, as the
Earth beats state their date: the rise and the Milky Way beat state
galactic, so a skip or Prev lands on the right pole. The rise's world leg
keeps the body leg's roll (about −36°), so beat 02 and the Milky Way beat
state roll 0. frameLadder.test.ts enters each beat cold from every pole;
beatRolls.test.ts enters from the rise's roll.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
clockTo takes an optional camera-tween Ease; an eased run is a ClockProfile
sampled per frame that lands exactly on its instant. Beat 00 drops its eight
0.5 s steps for one linear leg and a 4 s easeOutQuad to night.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The tour's fourth beat pulls out from the Earth–Moon gap until Neptune's
orbit rings the frame. Beat 02 looks away from the Sun, so the view first
turns about the gap while the range is small (a straight pull-back would
dolly the eye past the Sun), then the log dolly runs out to 52 au and the
target leans to the Sun. The landing looks down 35° from ecliptic north
toward longitude 125°, which puts Pluto behind the eye and its caption below
the frame; the aim sits 10 au below the Sun on its ecliptic axis to centre
Neptune's orbit, so the dwell's yaw circles the Sun.

The beat snaps the tour date, states the ecliptic pole and level roll on
entry, and restates beat 02's target and range (now EARTH_AND_MOON_VIEW,
read by both beats) so a skip or Prev pulls out from the gap. It names the
Sun with the scoped 'label:starCatalog:sun'; the other star names stay
hidden.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ches the Sun set

The opening stands at the north end of Søndermarken's lawn, looks south
past the treetops at the noon Sun, pans west with it through sunset in
the clock's own profile, and tilts up to the Milky Way, ending on
PARK_VIEW so beat 01 starts as before.

The tour date is the day after last quarter: the first evening the Moon
is still down once the sky is fully dark. Noon, sunset and night are
read off the ephemeris (skyPoseOfBodyAt) and pinned by tourDayTimes.test.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…he Milky Way

Beat 02 looks steeply across the ecliptic, side-on to the Earth-Moon gap,
from an eye as far from Earth as from the Moon, so the discs keep their true
3.7 ratio and both show near half lit whatever the Moon's phase. The view is
derived from the tour date's ephemeris in EARTH_AND_MOON_VIEW; a new test
fails if a date change breaks the equal range or the lighting.

missionTrails (Voyager and kin) stay hidden from beat 00 until the Milky Way
beat, instead of returning with beat 01's orbit trails.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
rulkens and others added 5 commits November 6, 2026 15:33
…arth

# Conflicts:
#	src/services/engine/frame/projectFramePose.ts
#	tests/state/tour/visitBeatSaga.test.ts
Main's #1064 moved selection kinds onto the Layers; a test that resolves clip
foci now installs them first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The pull-out from the Solar System to half a parsec off a point near Alpha
Centauri, looking back at the Sun: Alpha Centauri and Proxima Centauri lower
left, the Sun upper right. The beat snaps the tour date, states the ecliptic
pole and level roll, restates beat 03's landing (now SOLAR_SYSTEM_VIEW, shared
with beat 03) and names the star map's stars.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Beat 05 takes the caption "The Milky Way", and the debugger's beat labels
follow the new order (05-17). Home again snaps the tour date, states the
galactic pole, rushes in from the edge to the whole Earth along Copenhagen's
zenith, arrives rolled north up, and hands over to a { body: 'earth' } leg that
sinks to 2,000 km over Copenhagen (DENMARK_VIEW_HEIGHT_M, shared with the
rise): below the body arm's release height, so the camera rides Earth when the
tour restores the viewer's clock. Tests pin the landing, the date and the cold
entry pole; docs and the website's tour facts follow (18 steps, about 7
minutes, the Earth opening).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
One log pull-out from beat 04's view near Alpha Centauri to the whole
galaxy replaces the cut to 100 Mpc and fly-in: the Gaia field thins as the
disc fades in around it. Beat 04's landed view moves to
stellarNeighbourhoodView so beat 05 restates it for a skip or Prev.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
skymap 5058d24 Commit Preview URL

Branch Preview URL
Nov 18 2026, 10:29 PM

rulkens and others added 9 commits November 6, 2026 18:49
…arth

# Conflicts:
#	docs/BACKLOG.md
#	docs/backlog/2026-11-06-earth-night-ground-haze.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The dwell's yaw orbit starts inside the pull-back (dwellLeadIn, on the
velocity layer beside the aim move) and the dwell enters already turning
at that rate (dwellDrift flowIn), so the camera never comes to rest on the
landing. The lead-in turns the landing ~1°, so the true-size check allows 2%.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…arth

# Conflicts:
#	src/services/engine/camera/arms/sky/skyCameraArm.ts
The pull-back lands short of the view, still zooming out at 12% of the
range per second, and the dwell eases that speed to rest, ending on the
view. Beat 03's restated start is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
rulkens and others added 11 commits November 11, 2026 01:25
Four dev-only preview clips (teleEarth/teleMoon x 10M/3M km) for the owner's
pick: swing, dolly zoom out, back in, swing to the overview, as one seq with
overlaps [2, 2, 4] s. Earth's side is a true dolly zoom. Deleted once a
variant is picked and folded into earthAndMoon.ts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…arth

# Conflicts:
#	docs/backlog/2026-07-22-grand-tour-earth-start.md
#	src/services/engine/camera/arms/sky/skyCameraArm.ts
…arth

Conflict: both sides added src/utils/time/easedClockProfile.ts. Kept the
branch's general one (any camera Ease, 60 Hz samples, lands bit-exact);
main's sky clock skip now calls it with easeInOutSine (was smoothstep).

Semantic clash: the branch's sky-arm release (pinsEye) fired on every
world pose off the spot, but main's sky wheel produces such poses for the
refold to discard, so standing in the sky released at once and lift-off
never ran. The release now applies only to a clip leg's world pose
(clipAuthored), which is what the tour's rise needs.

Also: tour tests repointed to cameraIntentSlice (#1130); the
projectFramePose test takes main's ArmFocus ctx.
The frame between the rise clip and its dwell belongs to the focus-follow
pin, which put the target on Earth's centre at the old distance: two
frames an Earth radius closer. The re-pivot now ends the clip, on Earth's
position at the frozen tour night.
Every focus action re-extracts the focus row, and a new row restarts the
follow approach: Home again landed on Earth and flew straight out to
Earth's framing distance when the tour ended.
The tour lands without the telephoto redesign; the four preview clips leave
the registry and live on as commit 2020062, pointed at from the backlog.

This reverts commit 2020062.
From the deletion audit: dwellLeadIn had one caller and was one rate() call;
youAreHereEarthDwell re-wrapped what dwellDrift returns; FRAME_ROLL_SEC and
two notes still described beats as unbuilt or untuned.
DoD audit READY: npm test 35079 pass, typecheck clean, 32/32 boxes, no new
TODOs or debug probes; deletion audit's safe-now bin applied in f7f6fe8.
Owner ruled to land now and iterate; follow-ups are in the backlog.
@rulkens
rulkens marked this pull request as ready for review November 18, 2026 22:26
@rulkens
rulkens merged commit 10501e1 into main Nov 18, 2026
3 checks passed
@rulkens
rulkens deleted the worktree-tour-start-earth branch November 19, 2026 00:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant