Sky Garden Body-First Stabilization - 2026-05-05

Sky Garden Body-First Stabilization - 2026-05-05

Goal

Keep `Serenity Ethereal Sky Garden` centered on the live human body before adding more spectacle. The performer is the conductor; sky, water, glow, petals, and post effects are supporting layers only.

Live Finding

During Mac4 Unity Play Mode validation, the W11 procedural sky rendered as a full-frame white oval. Disabling body glow and mirror water did not remove it; disabling `LumeSkySunsetRenderer` did. The Femto/depth feed was still live, and the performer returned once the sky layer was gated off.

Second validation showed the performer could still be buried by floating-island geometry even after sky/water/glow/post were disabled. The first safe-mode patch had not gated W11.2 scenic geometry or W11.5 decorative emitters, so a huge island layer could sit in the foreground and defeat the body-first rule.

Safe Baseline

`LumeVisualDirector` now exposes `Sky Garden Body-First Safety` controls:

• `skyGardenBodyFirstSafeMode`: default `true`
• `skyGardenEnableProceduralSky`: default `false`
• `skyGardenEnableScenicGeometry`: default `false`
• `skyGardenEnableNarrativeTrack`: default `false`
• `skyGardenEnableMirrorWater`: default `false`
• `skyGardenEnableAmbientParticles`: default `false`
• `skyGardenEnableBodyGlow`: default `false`
• `skyGardenEnablePainterlyPost`: default `false`

When safe mode is on, Sky Garden uses the live depth body plus the stable dark atmospheric backdrop. The experimental W11 sky, scenic geometry, timed narrative cameras, mirror water, lotus/firefly decoration, body glow, and painterly pass stay disabled.

Framing Controls

Sky Garden body framing is now inspector-tunable on `LumeVisualDirector`:

• `skyGardenDepthRangeM`: `0.55..3.20`
• `skyGardenStageScale`: `(1.02, 1.00)`
• `skyGardenStageCenterOffset`: `(-0.28, 0.72)`
• `skyGardenActiveRegionMin`: `(-0.85, -1.28, -3.25)`
• `skyGardenActiveRegionMax`: `(1.65, 2.85, -0.55)`

`LumeDepthReprojector.ConfigureSkyGardenBodyFocus(...)` applies those values after the default Sky Garden body-focus profile.

Guardrails Added

• `LumePointInstanced.shader` keeps a still performer visible; motion now adds energy instead of granting permission for the body to exist. In body-priority mode, non-hero room-shell alpha is nearly black so an empty room cannot dominate the composition.
• `LumeSkySunset.shader` clamps luminance and peak RGB so the sky cannot become a full-screen white card when re-enabled.
• `LumeVisualDirector` now gates W11.2 scenic geometry, W11.5 narrative, and W11.5 decorative emitters behind explicit safe-mode toggles.
• `LumeWaterPlane` disables its renderer when the plane would rise near the camera and includes a selected-object gizmo for debugging plane placement.
• `LumeBodyGlowEnabler` refuses to activate unless the renderer feature, composite material, and `LumeBodyGlow` layer are all present.
• `LumeBodyGlowFeature` no-ops if the body layer is missing.

Verification Screenshot

Safe baseline after disabling the blown-out sky and tightening the active region:

`[home]/Desktop/lume-screenshots/sky-garden-room-trim-centered-20260505.png`

The performer is visible and centered enough to tune from. Remaining visual issue: Mac4's Femto still sees some left-side wall geometry. Tighten `skyGardenActiveRegionMin.x` further or physically rotate the camera if that wall remains prominent.

Re-Enable Protocol

Re-enable one layer at a time:

1. Turn `skyGardenBodyFirstSafeMode` off.
2. Enable only one of:
- `skyGardenEnableProceduralSky`
- `skyGardenEnableScenicGeometry`
- `skyGardenEnableNarrativeTrack`
- `skyGardenEnableMirrorWater`
- `skyGardenEnableAmbientParticles`
- `skyGardenEnableBodyGlow`
- `skyGardenEnablePainterlyPost`
3. Enter Play Mode and capture a screenshot.
4. Confirm:
- no white/full-frame oval
- no foreground plane covering the body
- still performer remains visible
- body stays more legible than scene layers
5. Only then leave the layer enabled for the next validation pass.

Next Pass

After this safe baseline holds for a full movement take, proceed to W12 density/spectacle work. Do not add more density before the body-first baseline is stable.