APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER

- Added on-canvas debug HUD renderer
- Wired HUD draw into sample-level debug integration
- Preserved combo-key controls and HUD-last draw order

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -7,29 +7,23 @@ MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Create BUILD_PR_CANVAS_DEBUG_OVERLAY_RENDERER implementation.
+Apply the canvas debug HUD renderer implementation.
 
 Requirements:
-- Create tools/dev/canvasDebugHudRenderer.js
-- Update tools/dev/devConsoleIntegration.js to use the HUD renderer
-- Modify ONE sample/dev entry file only
-- Draw debug HUD on canvas after world rendering
-- Keep combo keys exactly as currently implemented:
-  - Shift + ` => toggle console
-  - Ctrl + Shift + ` => toggle overlay
-  - Ctrl + Shift + R => reload
-  - Ctrl + Shift + ] => next panel
-  - Ctrl + Shift + [ => previous panel
-- No engine core changes
-- No F-key bindings
-- Use save()/restore() around canvas mutations
-- Keep commit_comment.txt header-free
+- Keep changes isolated to:
+  - tools/dev/canvasDebugHudRenderer.js
+  - tools/dev/devConsoleIntegration.js
+  - one sample entry file only
+- Do not modify engine core
+- Draw HUD last on canvas
+- Preserve combo-key bindings exactly
+- Use canvas save()/restore()
 - Run node --check on touched JS files
-- Package implementation output to:
-  <project folder>/tmp/BUILD_PR_CANVAS_DEBUG_OVERLAY_RENDERER_delta.zip
+- Package result to:
+  <project folder>/tmp/APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER_delta.zip
 
 Report back:
 - exact files changed
-- sample file selected
+- selected sample file
 - how HUD draw is invoked
-- validation command results
+- validation results

docs/dev/COMMIT_COMMENT.txt

@@ -1,5 +1,5 @@
-BUILD_PR_CANVAS_DEBUG_OVERLAY_RENDERER
+APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER
 
-- Added canvas-based debug HUD renderer
-- Wired HUD draw into sample-level dev console integration
-- Rendered overlay after gameplay with existing combo-key controls
+- Added on-canvas debug HUD renderer
+- Wired HUD draw into sample-level debug integration
+- Preserved combo-key controls and HUD-last draw order

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER
+PLAN_PR_SAMPLE_GAME_USING_FULL_PIPELINE

docs/dev/change_summary.txt

@@ -4,7 +4,6 @@ David Quesenberry
 change_summary.txt
 
 Summary
-- Added BUILD PR for a real on-canvas debug HUD
-- Scoped implementation to tools/dev plus one sample entry
-- Preserved combo-key debug controls
-- Preserved docs-first workflow and commit_comment no-header exception
+- Applied canvas HUD implementation path
+- Locked draw-order, combo keys, and sample-only integration
+- Preserved no-header rule for docs/dev/commit_comment.txt

docs/dev/file_tree.txt

@@ -3,7 +3,7 @@ David Quesenberry
 04/05/2026
 file_tree.txt
 
-docs/pr/BUILD_PR_CANVAS_DEBUG_OVERLAY_RENDERER.md
+docs/pr/APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER.md
 docs/dev/codex_commands.md
 docs/dev/commit_comment.txt
 docs/dev/change_summary.txt

docs/dev/validation_checklist.txt

@@ -6,31 +6,25 @@ validation_checklist.txt
 VALIDATION CHECKLIST
 
 Workflow
-- BUILD_PR created
+- APPLY_PR created
 - One PR per purpose
-- Commit comment has no header
+- commit_comment.txt has no header
 
-Implementation Targets
-- tools/dev/canvasDebugHudRenderer.js created
+Files
+- tools/dev/canvasDebugHudRenderer.js present
 - tools/dev/devConsoleIntegration.js updated
 - one sample entry updated
 
 Functional
-- Shift + ` toggles console state
 - Ctrl + Shift + ` toggles HUD visibility
-- Ctrl + Shift + R triggers reload action
-- Ctrl + Shift + ] moves to next panel
-- Ctrl + Shift + [ moves to previous panel
-- HUD draws on canvas after gameplay/world rendering
-- HUD survives missing diagnostics safely
+- HUD draws on canvas
+- HUD draws after gameplay content
+- Panel navigation works
+- Missing diagnostics do not crash draw path
+- Reload combo remains browser-safe
 
 Safety
 - No engine core files modified
 - No F-key bindings remain
 - Canvas save/restore used
-- No duplicate listeners/runtime instances after repeated init/reload
-
-Validation Commands
-- node --check tools/dev/canvasDebugHudRenderer.js
-- node --check tools/dev/devConsoleIntegration.js
-- node --check <selected sample file>
+- No duplicate listeners/runtime instances

docs/pr/APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER.md

@@ -0,0 +1,50 @@
+Toolbox Aid
+David Quesenberry
+04/05/2026
+APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER.md
+
+# APPLY PR
+Canvas Debug Overlay Renderer
+
+## Objective
+Apply the canvas HUD implementation produced from the build PR and lock the runtime behavior into one sample with minimal, isolated changes.
+
+## Apply Scope
+- Add `tools/dev/canvasDebugHudRenderer.js`
+- Update `tools/dev/devConsoleIntegration.js`
+- Update one sample entry file only
+- Keep draw order world-first, HUD-last
+- Preserve current combo keys:
+  - Shift + ` => toggle console
+  - Ctrl + Shift + ` => toggle overlay
+  - Ctrl + Shift + R => reload
+  - Ctrl + Shift + ] => next panel
+  - Ctrl + Shift + [ => previous panel
+
+## Apply Requirements
+- No engine core file changes
+- No F-key bindings
+- No duplicate listeners or duplicate runtime instances
+- Canvas state must use save()/restore()
+- HUD must tolerate missing diagnostics
+- Commit comment file must have no header
+
+## Runtime Expectations
+- HUD appears on-canvas when overlay is enabled
+- HUD updates every frame
+- HUD renders after gameplay content
+- Panel switching is visible
+- Reload combo does not trigger browser refresh
+
+## Validation
+- node --check tools/dev/canvasDebugHudRenderer.js
+- node --check tools/dev/devConsoleIntegration.js
+- node --check <selected sample file>
+- Manual browser run
+- Verify overlay visibility toggle
+- Verify panel navigation
+- Verify no console/runtime duplication after repeated toggles
+
+## Deliverable
+Codex applies the implementation and packages:
+<project folder>/tmp/APPLY_PR_CANVAS_DEBUG_OVERLAY_RENDERER_delta.zip