Estate navigator stack: background scene, soundscape, cone prepass (opt-in) #15

Merged

void merged 23 commits from ratatoskr/estate-navigator into main 2026-11-05 00:31:47 +00:00

Conversation 0 Commits 23 Files changed 43 +4563

void commented 2026-11-05 00:31:42 +00:00

Member

Copy link

Lands #1, #6, #7, #8, #12 (stacked into ratatoskr/estate-navigator). Verified in a clean copy: 145 vitest tests pass; vite build emits no scene chunk; nothing in the app calls startBackgroundScene; config.json backgroundScene.tier is off and resolveTier defaults to off, so the chat default keeps the CSS ground and requests no WebGL context. Soundscape is flag-off and muted by default. Does not include #13 or #14.

Lands #1, #6, #7, #8, #12 (stacked into ratatoskr/estate-navigator). Verified in a clean copy: 145 vitest tests pass; vite build emits no scene chunk; nothing in the app calls startBackgroundScene; config.json backgroundScene.tier is off and resolveTier defaults to off, so the chat default keeps the CSS ground and requests no WebGL context. Soundscape is flag-off and muted by default. Does not include #13 or #14.

void added 23 commits 2026-11-05 00:31:42 +00:00

Background scene: two-pass WebGL2 terrain and world tree with login pull-back ... e377d9f722

Pass 1 sphere-traces CultMath noise terrain (fbm plus Phacelle erosion) and the
world tree with a conservative Lipschitz step, writing colour and depth. Pass 2
marches fog and clouds only up to that depth at low resolution with TAA. The
camera pulls back from the tree on login. Vendors CultLib's generated GLSL
(658c09e). The Phacelle gradient bound is an empirical probe, not a proof.
Headless harness compiles, renders and times it; nothing run on a GPU.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Background scene: phacelleGradBound 6.3 -> 7.0 from Libby's measured sup ... b2d6d32cc4

Libby measured sup |grad| 6.63 at |side| = 1.5, n = 0 (CultLib PR #1 head
990521b3); 7.0 adds margin. The shader passes roughness 0 as a literal, so no
1/(1-n) factor is needed; the comment records it. Pass 1 under SwiftShader:
terrain 288.8 ms vs 287.5 at 960x540 level 0, 75.3 vs 75.7 at level 3 (noise).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Background scene: sky costs no noise; one sun term ... 7a498584e6

Sky rays were ~90% of pass 1 (noSkyMarch variant: 292 -> 26 ms, SwiftShader 960x540 L0).
terrainDistance now returns early where the plateau mask is 0 (height exactly 0), skipping
fbm and Phacelle there: pass 1 292 -> 159 ms, same step values. skyColor keeps one sun term
(the wide glow is gone; screenshots differ by that and by TAA/time, not compared pixelwise).
Harness: noSkyMarch variant, ONLY=<names> selects variants.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Background scene: lint and type clean, integration contract ... 093230a2c1

Fixes the 21 eslint errors and 2 tsc errors Void's review found in
features/scene (WORLD.phacelleGradBound is typed number, not the literal 7).

Adds the contract the host needs: client config backgroundScene.tier as flag and
ceiling (off by default, lowered by saveData / memory / cores), lazy
startBackgroundScene, still and low tiers, onCompileFail (createScene frees
linked programs and returns null), webglcontextlost handling, and creatureScale
where neutral overrides sizeBucket. Scene.ts gets its first tests, on a fake GL.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

creatures: cite the Bifrost creature-props contract ... 8c7113bcaf

Header names heimdall-body/ratatoskr-creature-projection, the shape,
invariants and consent rule, and marks the bucket scales as placeholders.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

creatures: cite creature-projection-v2 ... 0ec34ff19f

Header cites heimdall-body:follow_up:ratatoskr-creature-projection-v2, which
supersedes heimdall-body/ratatoskr-creature-projection. Citation only.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

soundscape: audio socket over Aqua's activity frame (flag off, muted, untested by ear) ... c4c00d7127

Reads the grammar frame (AquaSynth docs/soundscape-grammar.md @ aeae510) into a
per-mind table, plans voices (neutral overrides all, Muted, cap, master mute,
weak-device off) and the drawn set. No activity source exists yet
(ratatoskr❓activity-feed-source) and no audio assets, so nothing sounds.
Cites heimdall-body:follow_up:ratatoskr-creature-projection-v2.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scene: live reduced-motion, chunk-load failure, per-stage CultMath ... 1f4341dab6

- matchMedia 'change' listener freezes/thaws a running scene; removed on dispose and context loss
- startBackgroundScene catches a failed scene chunk import: onCompileFail, null, no throw
- shaderSource compiles each stage with only the CultMath declarations it reaches
  (cultmathTrim.ts); Phacelle stays a separate file, terrain only
- README: 'still' is a live rendered frame

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

soundscape: neutral read first; human kind subset (provisional) per grammar 5e2eaa9 ... cc99a3439d

A neutral frame yields no kind and no energy: nothing drawn, nothing sounded, never an
Idle. For a non-neutral human, a kind outside {Idle, Working, Speaking} or omitted becomes
Idle and Peak reads as High. Minds and personas keep all seven kinds. The subset is
provisional until Bifrost's steward cuts the list.
Cites heimdall-body:follow_up:ratatoskr-creature-projection-v2.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Merge pull request 'Background scene: two-pass WebGL2 terrain and world tree with login pull-back' (#1) from nibu/background-scene into ratatoskr/estate-navigator 686f72bcf1

scene: Phacelle bound says measured-not-proved; neutral creature draws nothing ... fff46492ca

world.ts already carries Libby's 7.0 (CultLib PR #1 990521b3); the comment now
states the 6.63 sup was measured, not proved.

creatures.ts follows creature-projection-v2: a neutral creature publishes no
sizeBucket, and one that arrives is ignored. creatureScale returns null (draw
nothing) for neutral, absent or unknown buckets; it never defaults to medium.
NEUTRAL_SCALE is removed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Merge PR #6: Soundscape audio socket over Aqua activity frame (flag off, muted) f9cf99faff

Merge PR #7: Soundscape neutral read first, human kind subset (provisional) 190e2e724b

soundscape: neutral carries no size; cite grammar head 0091d01 ... 5e79a1853a

NeutralFrame drops size alongside kind and energy; the reader ignores a size a producer sends on a neutral frame, and a live frame without a valid size is malformed. The human kind subset (Idle/Working/Speaking) stays PROVISIONAL, still proposed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scene: ES2016-safe hasOwnProperty, tighten undefined-bucket assertion, reflow bound comment ... 5eb0a63caa

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Merge pull request 'scene: Phacelle bound says measured-not-proved; neutral creature draws nothing' (#8) from nibu/phacelle-7-neutral-creature into ratatoskr/estate-navigator 95e24aadb5

scene: cone prepass starts pass-1 rays past empty space; opt-in steps/pixel readout ... 87c9ca6030

Pass 0 marches one ray per 8x8 tile of pass 1, each step shrunk by the widest
any ray of the tile strays from it, and stores the distance no ray of the tile
can have hit before (W_FAR when the whole tile climbs out above the highest
geometry). Pass 1 starts from it. The distance bound moves to sdf.glsl so both
passes step by the same function.

onTraceStats adds a step-count render target to pass 1 and reads it back every
8th frame through a pixel-pack buffer and fence, outside the timed span. Unset,
neither the output nor the target exists. prepass:false is the baseline.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

harness: trace and diff modes, standalone demo page with steps/pixel readout ... b055b2a5af

trace: steps per pixel and pass ms at three fixed camera poses, PREPASS=0,1 arms.
diff: one frozen frame with and without the prepass, against a 512-step render.
bundle.cjs demo: full-window page with a prepass switch and the readout.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scene: pack step bytes tightly; keep the hit tolerance clear at the far end of a prepass step ... 12469671c9

Soul pass on 87c9ca60: the R8 steps read used the default PACK_ALIGNMENT of 4, so
at widths not divisible by 4 the buffer was too small (readPixels fails) and padding
would be summed. Portrait runs read 0 steps/pixel. The prepass step now divides by
1.0006 so pass 1's tolerance, which grows with t, stays clear at the end of the step.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

harness: demo page keeps hold of the canvas it swaps in, so the prepass switch works twice ... 50ffd90560

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scene: half-float prepass start target where EXT_color_buffer_float is missing; say why createScene is null ... 7e05866437

Phone Chrome without EXT_color_buffer_float returned null with one message. Rendering to
RGBA16F only needs EXT_color_buffer_half_float, and every other target is already a half, so
only the prepass start (RGBA32F) needed a fallback. In half mode the prepass writes
t*(1-2^-10) - 2^-15, which stays below t after the half rounds to nearest, so pass 1 still
starts at or before the true distance. W_FAR stays exact. onUnavailable names no-webgl2 vs
neither float extension; Scene.startFormat and options.halfStart (force, for tests and the
harness). The standalone page shows the reason, renderer, vendor, UA and extension list.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scene README: createScene needs either float colour-buffer extension ... 293885089a

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Merge pull request 'scene: cone prepass for pass 1, opt-in steps/pixel readout' (#12) from nibu/scene-trace-prepass into ratatoskr/estate-navigator 7e632e8605

void merged commit 68f10ce414 into main 2026-11-05 00:31:47 +00:00

void referenced this pull request from a commit 2026-11-05 00:31:49 +00:00

Merge pull request 'Estate navigator stack: background scene, soundscape, cone prepass (opt-in)' (#15) from ratatoskr/estate-navigator into main

nibu referenced this pull request 2026-11-05 05:38:57 +00:00

scene: voxel terrain as painter's-order strips, the default simple background #13

nibu referenced this pull request 2026-11-05 05:38:58 +00:00

scene: voxel terrain as painter's-order strips, the default simple background #13

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

GameCult/Ratatoskr!15

No description provided.