Add adaptive UI behavior to overlay system.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,9 +2,9 @@ MODEL: GPT-5.4
 REASONING: medium
 
 COMMAND:
-Implement contextual input mapping:
-- Add context-aware input resolution
-- Use overlay stack and active layer
-- Integrate with existing gesture + keybind systems
-- Do not duplicate gesture logic
+Implement adaptive UI behavior for overlays:
+- Add rule system for adaptive UI (visibility, size, emphasis)
+- React to gameplay + overlay context + telemetry
+- Respect layout constraints and safe zones
+- Do not modify existing rendering pipeline unnecessarily
 - Update roadmap status only

docs/dev/COMMIT_COMMENT.txt

@@ -1,5 +1,5 @@
-Add contextual input mapping for overlays.
+Add adaptive UI behavior to overlay system.
 
 PR Details:
-- Enables input behavior based on active overlay context
-- Integrates with existing input systems
+- Introduces runtime adaptive UI rules
+- Enhances responsiveness of overlays

docs/dev/reports/validation_checklist.txt

@@ -1,4 +1,4 @@
-[ ] Context switching updates input behavior
-[ ] No conflicts across overlays
-[ ] Gesture + keybind compatibility maintained
+[ ] UI adapts to gameplay state
+[ ] No layout conflicts
+[ ] Stable rendering
 [ ] Roadmap updated

docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md

@@ -637,6 +637,7 @@
 - [x] Level 21 advanced overlay interactions implemented (click/drag/resize) with gameplay-safe explicit interaction mode
 - [x] Level 22 gesture abstraction added for overlays (tap/hold/swipe mapped to runtime actions with explicit gameplay-safe gating)
 - [x] Level 22 contextual input mapping added (active overlay/layer stack-aware resolution across keybind and gesture actions)
+- [x] Level 22 adaptive overlay UI rules added (visibility/size/emphasis responsive to gameplay state, overlay context, and telemetry)
 
 ### Sample Phase Tracks
 - [x] 3D phase normalized

docs/pr/BUILD_PR.md

@@ -1,21 +1,21 @@
-# BUILD_PR_LEVEL_22_3_OVERLAY_CONTEXTUAL_INPUT_MAPPING
+# BUILD_PR_LEVEL_22_4_OVERLAY_ADAPTIVE_UI_BEHAVIOR
 
 ## Purpose
-Introduce context-aware input mapping for overlays based on runtime state.
+Enable overlays to adapt their UI behavior dynamically based on runtime conditions.
 
 ## Roadmap Improvement
-Advances Level 22 by aligning input behavior with active overlay context.
+Extends Level 22 into adaptive UI systems layered on contextual input.
 
 ## Scope
-- Map inputs based on overlay stack/context
-- Support priority-based input resolution
-- Integrate with existing gesture and keybind systems
+- Define adaptive UI rules (visibility, size, emphasis)
+- React to gameplay state, overlay stack, and telemetry
+- Avoid conflicts with layout constraints and safe zones
 
 ## Test Steps
-1. Activate different overlay contexts
-2. Verify input behavior changes correctly
-3. Ensure no cross-context leakage
+1. Trigger different gameplay states
+2. Verify UI adapts (size/visibility/emphasis)
+3. Confirm no layout violations
 
 ## Expected
-- Context-driven input behavior
-- Stable and predictable mapping
+- UI responds dynamically to context
+- No overlap or instability