# HyperTwist Phase I-B immersion and focus-presence controls preparation packet

Date: `2026-05-31`

## Goal

Reopen the landed `Phase I-A` immersive foundations lane one bounded step
further through explicit first-party focus-presence controls.

## Why this slice is justified

After `Phase I-A`, the immersive lane still lacked the user-facing controls
promised by the roadmap scaffold:

- immersion intensity
- reduced-distraction scenic presets
- comfort and vignette posture
- seated and standing posture variants
- session-local environment recall

Those are real product-side needs for making the scenic training shell usable
across long drills, review blocks, and calmer study sessions, but they do not
require widening into a generic XR settings takeover.

## Bounded implementation target

Land the first focus-presence controls packet only:

- first-party immersive presence-control contract
- first-party comfort/vignette boundary
- first-party posture-variant contract
- first-party session-recall boundary
- runtime-library accessors for all four surfaces
- focused automation coverage

## Explicit non-goals

Do not widen this packet into:

- platform-global XR settings ownership
- locomotion rig or guardian ownership
- cross-session cloud profile ownership
- cross-product preference memory ownership
- later immersive phases like spatial coaching staging or reactive session-state
  cues

## Files expected to move

- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingImmersiveEnvironmentLibrary.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingImmersiveEnvironmentLibrary.cpp`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Tests/HyperTwistImmersivePhaseIBPresenceControlContractTest.cpp`
- canon sync docs

## Validation target

Safe source-level validation only on this VPS:

- focused contract coverage for the new presence, comfort, posture, and recall surfaces
- targeted wiring sweep
- `git diff --check`
