Guardrail for the dedicated 120Hz off-MainActor input thread and the onInputReady wiring between GameControllerManager and StreamingService.startStreamingV2(). Load before editing HighFrequencyInputController.swift, GameControllerManager.swift, StreamingService.swift, VirtualSteeringWheelService.swift, or any controller-input code. Severity medium — violating it regresses input latency or leaks the streaming session.
Guardrail keeping ACES Filmic as the active tonemapper and Reinhard (tonemapLuminance) as a preserved legacy fallback. Load before editing ColorSpaceConverter.swift, YUVToRGB.metal, or any shader/tonemapping code. Severity medium — violating it regresses HDR color quality on the Vision Pro EDR display.
Guardrail for the buffer-pool exhaustion path — markForRecovery() (IDR re-request) plus the 1Hz lastBufferExhaustionTime debounce. Load before editing SafeBufferPool.swift, VideoDecoder.swift, StreamingService.swift, or any chiaki video-callback failure handling. Severity medium — violating it causes visible smearing or log-spam stalls.
Guardrail for the manual ChiakiSession struct offsets (1552/1560/1568) in ChiakiCore.c. Load before editing ChiakiCore.c, ChiakiBridge.swift, ChiakiFullSession.swift, or any code that registers chiaki callbacks. Severity critical — violating it silently corrupts the video stream.
Guardrail keeping spatialAudioEnabled = false (Direct Stereo, HRTF bypass) as the default in LowLatencyAudioPlayer.swift — the PS5 Tempest Engine already outputs binaural audio. Load before editing LowLatencyAudioPlayer.swift or any audio output/spatialization code. Severity high — flipping the default causes metallic double-spatialization artifacts.
Guardrail requiring CACurrentMediaTime() (monotonic) for all streaming-pipeline time deltas — never CFAbsoluteTimeGetCurrent(), Date(), DispatchTime, or ContinuousClock. Load before editing StreamingService.swift, anything under Streaming/, or writing any new code that measures latency or time deltas in the pipeline. Severity high — wall-clock time breaks latency math under NTP drift.
Guardrail for "#define CHIAKI_LIB_ENABLE_OPUS 1" ordering — it MUST precede every chiaki header include. Load before editing ChiakiCore.c, ChiakiCore.h, the bridging header, or creating any C file that includes <chiaki/...> headers. Severity critical — violating it causes silent memory corruption (944-byte struct skew).
Guardrail for Frameworks/Chiaki.xcframework — the hand-merged libchiaki_full.a and its .orig/.backup siblings are immutable except via scripts/merge_chiaki_opus.sh. Load before touching anything under VisionRemotePS5/Frameworks/ or proposing library regeneration/cleanup. Severity critical — violating it produces a non-reproducible or non-linking build.