apply: presets + advanced ux execution pack

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,17 +2,15 @@ MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Create PLAN_PR_DEBUG_SURFACES_ADVANCED_UX
+Apply APPLY_PR_DEBUG_SURFACES_PRESETS and APPLY_PR_DEBUG_SURFACES_ADVANCED_UX
 
 Requirements:
-- Follow PLAN_PR -> BUILD_PR -> APPLY_PR
-- Docs-first only
-- One PR per purpose
-- Plan a reusable advanced UX layer for promoted debug surfaces
-- Define panel group infrastructure, quick toggles, macro registry/executor, optional shortcut helpers, command surfaces, naming conventions, and target structure
-- Keep the first version small and opt-in
-- Ensure macros compose only public APIs and approved commands/actions
-- Exclude layout editors, docking systems, 3D-specific, network-specific, and project-specific workflow implementations from the shared layer
-- Write outputs under docs/pr and docs/dev/reports
-- Put codex command and commit comment under docs/dev
-- Package to <project folder>/tmp/PLAN_PR_DEBUG_SURFACES_ADVANCED_UX_delta.zip
+- Execute both APPLY PRs in sequence
+- Do not introduce new features
+- Preserve behavior parity
+- Use existing public APIs only
+- Validate after both APPLY steps
+- Do not refactor unrelated systems
+- Keep project-specific logic outside engine-debug
+- Ensure preset system and advanced UX integrate cleanly
+- Maintain persistence compatibility

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-docs: plan advanced UX layer for debug surfaces with public-API-only macro composition and opt-in groups/toggles/shortcuts
+apply: presets + advanced ux execution pack

docs/dev/NEXT_COMMAND.txt

@@ -1,2 +1,2 @@
 Next:
-BUILD_PR_DEBUG_SURFACES_ADVANCED_UX
+PLAN_PR_DEBUG_SURFACES_3D_SUPPORT

docs/dev/reports/change_summary.txt

@@ -1,29 +1,5 @@
-PLAN_PR_DEBUG_SURFACES_ADVANCED_UX change summary
-
-Summary
-- Refined docs-only plan bundle for advanced debug surfaces UX.
-- Kept one PR purpose: advanced UX planning only.
-- Kept v1 small and opt-in.
-
-Plan now defines
-- panel group infrastructure
-- quick toggles
-- macro registry/executor with hard public-API composition rules
-- optional shortcut helpers
-- command surfaces
-- naming conventions
-- target structure
-
-Scope controls preserved
-- excludes layout editors, docking systems, 3D-specific, network-specific, and project-specific shared workflow implementations
-
-Outputs
-- docs/pr/PLAN_PR_DEBUG_SURFACES_ADVANCED_UX.md
-- docs/dev/codex_commands.md
-- docs/dev/commit_comment.txt
-- docs/dev/reports/change_summary.txt
-- docs/dev/reports/validation_checklist.txt
-- docs/dev/reports/file_tree.txt
-
-Next recommended command
-- BUILD_PR_DEBUG_SURFACES_ADVANCED_UX
+Execution pack v2:
+- Includes APPLY presets + advanced UX
+- Includes codex_commands.md (required)
+- Provides execution steps and validation
+- Ready for Codex execution

docs/dev/reports/file_tree.txt

@@ -1,13 +1,13 @@
-HTML-JavaScript-Gaming/
-|-- docs/
-|   |-- pr/
-|   |   `-- PLAN_PR_DEBUG_SURFACES_ADVANCED_UX.md
-|   `-- dev/
-|       |-- codex_commands.md
-|       |-- commit_comment.txt
-|       `-- reports/
-|           |-- change_summary.txt
-|           |-- validation_checklist.txt
-|           `-- file_tree.txt
-`-- tmp/
-    `-- PLAN_PR_DEBUG_SURFACES_ADVANCED_UX_delta.zip
+APPLY_PR_DEBUG_SURFACES_EXECUTION_PACK_v2/
+└── docs/
+    ├── dev/
+    │   ├── codex_commands.md
+    │   ├── commit_comment.txt
+    │   ├── next_command.txt
+    │   └── reports/
+    │       ├── change_summary.txt
+    │       ├── validation_checklist.txt
+    │       └── file_tree.txt
+    └── pr/
+        ├── APPLY_PR_DEBUG_SURFACES_PRESETS.md
+        └── APPLY_PR_DEBUG_SURFACES_ADVANCED_UX.md

docs/dev/reports/validation_checklist.txt

@@ -1,31 +1,9 @@
-PLAN_PR_DEBUG_SURFACES_ADVANCED_UX validation checklist
-
-Workflow
-- [done] PLAN_PR -> BUILD_PR -> APPLY_PR structure referenced
-- [done] Docs-first only
-- [done] One PR per purpose
-
-Plan Content
-- [done] Panel group infrastructure defined
-- [done] Quick toggles defined
-- [done] Macro registry/executor defined
-- [done] Optional shortcut helpers defined
-- [done] Command surfaces defined
-- [done] Naming conventions defined
-- [done] Target structure defined
-- [done] Macros constrained to public APIs and approved commands/actions
-
-Scope Controls
-- [done] v1 remains small and opt-in
-- [done] layout editor scope excluded
-- [done] docking system scope excluded
-- [done] 3D-specific scope excluded
-- [done] network-specific scope excluded
-- [done] project-specific shared workflow implementations excluded
-
-Outputs
-- [done] Plan doc under docs/pr
-- [done] Codex command under docs/dev
-- [done] Commit comment under docs/dev
-- [done] Reports under docs/dev/reports
-- [done] Delta zip generated at <project folder>/tmp/PLAN_PR_DEBUG_SURFACES_ADVANCED_UX_delta.zip
+Validation Checklist
+
+[ ] Presets apply correctly
+[ ] Overlay responds to preset changes
+[ ] Persistence remains stable
+[ ] Panel groups work
+[ ] Macros execute correctly
+[ ] Toggles behave correctly
+[ ] No regression in console or overlay

docs/pr/APPLY_PR_DEBUG_SURFACES_ADVANCED_UX.md

@@ -1,38 +1,18 @@
 # APPLY_PR_DEBUG_SURFACES_ADVANCED_UX
 
-## Purpose
-
-Apply the approved advanced UX plan by creating the first reusable panel groups, quick toggles, macros, and optional shortcut helpers for the promoted debug surfaces platform.
-
-## Apply Scope
-
-### Create Shared Group Infrastructure
-- panel group registry
-- shared panel group registrations
-- group commands
-
-### Create Shared Macro Infrastructure
-- macro registry
-- macro executor
-- shared macro registrations
-- macro commands
-
-### Create Shared Toggle Helpers
-- quick toggle commands
-
-### Create Optional Shortcut Helpers
-- optional debug shortcut registration
-
-### Keep Local
-- project-specific macros
-- project-specific shortcuts
-- scene-specific workflow helpers
-- tool-specific workflow helpers
-
-## Apply Rules
-
-- keep adoption opt-in
-- preserve public API boundaries
-- macros compose approved public commands/actions only
-- shortcut registration remains optional and debug-only
-- validate through sample and tool integrations
+## Execution Steps
+1. Create DebugPanelGroupRegistry
+2. Create DebugMacroRegistry and DebugMacroExecutor
+3. Implement group commands (group.*)
+4. Implement macro commands (macro.*)
+5. Implement quick toggle commands (toggle.*)
+6. Optional: shortcut bindings
+7. Validate:
+   - groups toggle correctly
+   - macros execute via public commands
+   - toggles behave consistently
+
+## Rules
+- Macros compose public APIs only
+- No direct runtime mutation
+- Keep shortcuts optional

docs/pr/APPLY_PR_DEBUG_SURFACES_PRESETS.md

@@ -1,27 +1,21 @@
 # APPLY_PR_DEBUG_SURFACES_PRESETS
 
-## Objective
-Apply the approved presets build as a focused implementation PR with no expansion beyond the v1 preset scope.
+## Execution Steps
+1. Create DebugPresetRegistry and DebugPresetApplier
+2. Implement preset commands (preset.*)
+3. Add shared presets:
+   - gameplay
+   - rendering
+   - systems
+   - minimal
+   - qa
+4. Register via registerStandardDebugPresets()
+5. Validate:
+   - overlay updates correctly
+   - preset switching works
+   - persistence behavior is correct
 
-## Apply Scope
-- implement `DebugPresetRegistry`
-- implement `DebugPresetApplier`
-- implement `registerStandardDebugPresets()` with v1 shared inventory
-- implement `registerPresetCommands()` with v1 command set
-
-## Guardrails
-- keep v1 to visibility + optional ordering
-- use public APIs only
-- keep project-specific presets outside shared layer
-- preserve precedence with persistence exactly as defined
-- no excluded scope features
-
-## Apply Validation
-- preset registry/applier functions pass deterministic behavior checks
-- shared preset inventory loads and applies
-- preset command set works with safe failures
-- precedence with persistence is correct
-- no project-specific preset implementation leaks into shared layer
-
-## Expected Outcome
-A small, opt-in presets system for promoted debug surfaces is ready with clear extension boundaries.
+## Rules
+- Presets = configuration only (no runtime logic)
+- Use public APIs only
+- No feature expansion