Install and wire debug system in asteroids_new and enable keybindings.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,8 +2,8 @@ MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Execute exactly docs/pr/BUILD_PR_GAMES_102C_ASTEROIDS_NEW_GAME_OVER_SCREEN_TIMER.md.
-Modify only the exact target files listed in the PR doc.
+Execute exactly docs/pr/BUILD_PR_GAMES_103A_ASTEROIDS_NEW_DEBUG_INSTALL_AND_KEYBINDINGS.md.
+Modify only listed files.
 Do not expand scope.
-Package the delta zip to:
-<project folder>/tmp/BUILD_PR_GAMES_102C_ASTEROIDS_NEW_GAME_OVER_SCREEN_TIMER_delta.zip
+Package:
+<project folder>/tmp/BUILD_PR_GAMES_103A_ASTEROIDS_NEW_DEBUG_INSTALL_AND_KEYBINDINGS_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Make the visible Game Over screen in asteroids_new trigger a 30-second auto-return using the exact same path as Enter.
+Install and wire debug system in asteroids_new and enable keybindings.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-After commit, test at games/asteroids_new/index.html: press Enter on Game Over, then wait ~30 seconds on Game Over and confirm the same return occurs.
+Test Ctrl+Shift+` and Shift+` in asteroids_new.

docs/dev/reports/change_summary.txt

@@ -1,3 +1 @@
-- bind the timer to the visible Game Over screen, not a guessed internal state
-- make the timeout behave exactly like pressing Enter
-- keep scope to the current asteroids_new game files only
+Wire debug init + keybindings

docs/dev/reports/validation_checklist.txt

@@ -1,6 +1 @@
-- single PR purpose only
-- exact target files only
-- no original Asteroids file changes
-- no new files
-- Enter works on visible Game Over screen
-- 30 seconds on visible Game Over screen triggers same return path
+Debug visible + keys work

docs/pr/BUILD_PR_GAMES_103A_ASTEROIDS_NEW_DEBUG_INSTALL_AND_KEYBINDINGS.md

@@ -0,0 +1,57 @@
+# BUILD PR — Asteroids New Debug Install + Keybindings
+
+## Purpose
+Ensure debug system is actually installed and keybindings work:
+
+- Ctrl+Shift+`
+- Shift+`
+
+Currently debug is not active even though game runs.
+
+## Exact Target Files
+- `games/asteroids_new/index.html`
+- `games/asteroids_new/index.js`
+- `src/engine/debug/**` (READ ONLY for reference, do not modify)
+- `games/asteroids_new/debug/**` (only if wiring exists)
+
+## Required Code Changes
+
+1. Ensure debug system is initialized
+   - locate how other working samples enable debug
+   - replicate the same initialization pattern in asteroids_new
+
+2. Ensure debug host is attached to DOM
+   - debug UI/container must be created and appended
+   - must run after DOM is ready
+
+3. Ensure keybindings are registered
+   - Ctrl+Shift+` → toggle debug
+   - Shift+` → alternate debug view
+   - verify event listeners are attached
+
+4. Verify correct import paths
+   - debug modules must import from:
+     `/src/engine/debug/...`
+   - no relative path drift
+
+5. Do NOT modify debug engine implementation
+   - only fix wiring/installation
+
+## Hard Constraints
+- no engine changes
+- no new debug system
+- no widening beyond asteroids_new wiring
+- minimal changes only
+
+## Validation Steps
+- load: games/asteroids_new/index.html
+- press Ctrl+Shift+`
+- press Shift+`
+- confirm debug UI appears
+- confirm no console errors
+- confirm gameplay unaffected
+
+## Acceptance Criteria
+- debug system is visible and toggleable
+- keybindings work
+- no engine modifications

games/asteroids_new/index.js

@@ -5,6 +5,7 @@ import Engine from "/src/engine/core/Engine.js";
 import { InputService } from "/src/engine/input/index.js";
 import { Theme, ThemeTokens } from "/src/engine/theme/index.js";
 import { resolveDebugConfig } from "../../src/shared/utils/debugConfigUtils.js";
+import { createSampleGameDevConsoleIntegration } from "../../tools/dev/devConsoleIntegration.js";
 import AsteroidsGameScene from "./game/AsteroidsGameScene.js";
 
 export const asteroidFlow = Object.freeze({
@@ -89,7 +90,7 @@ export function bootAsteroidsNew({
   EngineClass = Engine,
   InputServiceClass = InputService,
   SceneClass = AsteroidsGameScene,
-  createDevConsoleIntegration = null
+  createDevConsoleIntegration = createSampleGameDevConsoleIntegration
 } = {}) {
   let stage = "entered";
   traceBoot(stage);
@@ -184,12 +185,20 @@ export function bootAsteroidsNew({
   }
 }
 
-if (typeof document !== "undefined") {
+function tryAutoBoot() {
   try {
     void bootAsteroidsNew();
   } catch (error) {
     traceBootFailure("auto-boot", error);
   }
 }
 
+if (typeof document !== "undefined") {
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", tryAutoBoot, { once: true });
+  } else {
+    tryAutoBoot();
+  }
+}
+
 export default asteroidFlow;