Repository navigation
feat(tour): the grand tour opens on Earth - #1070
Merged
Merged
Conversation
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>
…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>
Deploying with
|
| 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 |
…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>
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.
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.
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
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.
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
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
clockToscene cue animates the sim clock, with optional easing.pinsEye, inprojectFramePose).Still open, so this stays a draft
youAreHere.ts./feature-donehaven'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