Add explicit boot-entry visibility to asteroids_new so execution or silent failure can be confirmed immediately.

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_98A_ASTEROIDS_NEW_GAMEPLAY_SLICE_COMPLETION.md.
+Execute exactly docs/pr/BUILD_PR_GAMES_99A_ASTEROIDS_NEW_BOOT_ENTRY_VISIBILITY_AND_EXECUTION_CHECK.md.
 Modify only the exact target files listed in the PR doc.
 Do not expand scope.
 Package the delta zip to:
-<project folder>/tmp/BUILD_PR_GAMES_98A_ASTEROIDS_NEW_GAMEPLAY_SLICE_COMPLETION_delta.zip
+<project folder>/tmp/BUILD_PR_GAMES_99A_ASTEROIDS_NEW_BOOT_ENTRY_VISIBILITY_AND_EXECUTION_CHECK_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Complete the minimum gameplay slice in asteroids_new so the parallel lane is meaningfully testable, not just bootable.
+Add explicit boot-entry visibility to asteroids_new so execution or silent failure can be confirmed immediately.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-After commit, report visible gameplay behavior and decide whether the next slice should be scoring/audio/input polish or one targeted stabilization PR.
+After commit, report exactly what becomes visible at boot; use that result to choose either boot-fix or gameplay continuation.

docs/dev/reports/change_summary.txt

@@ -1,3 +1,3 @@
-- advance asteroids_new from smoke-stable boot to a meaningfully testable gameplay slice
-- keep scope limited to current runtime/gameplay files already in the parallel lane
-- preserve original Asteroids files untouched
+- narrow the next PR to boot-entry visibility only
+- expose whether asteroids_new index is executing at all
+- expose the first reached or failing stage in the runtime path

docs/dev/reports/file_tree.txt

@@ -1,4 +1,4 @@
-docs/pr/BUILD_PR_GAMES_98A_ASTEROIDS_NEW_GAMEPLAY_SLICE_COMPLETION.md
+docs/pr/BUILD_PR_GAMES_99A_ASTEROIDS_NEW_BOOT_ENTRY_VISIBILITY_AND_EXECUTION_CHECK.md
 docs/dev/codex_commands.md
 docs/dev/commit_comment.txt
 docs/dev/next_command.txt
@@ -8,10 +8,4 @@ docs/dev/reports/validation_checklist.txt
 games/asteroids_new/index.js
 games/asteroids_new/game/AsteroidsGameScene.js
 games/asteroids_new/game/AsteroidsSession.js
-games/asteroids_new/game/AsteroidsWorld.js
-games/asteroids_new/entities/Asteroid.js
-games/asteroids_new/entities/Bullet.js
-games/asteroids_new/entities/Ship.js
-games/asteroids_new/entities/Ufo.js
-games/asteroids_new/systems/ShipDebrisSystem.js
-games/asteroids_new/debug/asteroidsShowcaseDebug.js
+games/asteroids_new/game/AsteroidsWorld.js

docs/dev/reports/validation_checklist.txt

@@ -1,7 +1,5 @@
 - single PR purpose only
 - exact target files only
 - no original Asteroids file changes
-- no new files
-- no assets/platform/config/levels widening
-- asteroids_new remains runnable from its own index entry
-- gameplay slice is meaningfully testable
+- visible execution proof added
+- silent failure point exposed if boot still fails

docs/pr/BUILD_PR_GAMES_99A_ASTEROIDS_NEW_BOOT_ENTRY_VISIBILITY_AND_EXECUTION_CHECK.md

@@ -0,0 +1,39 @@
+# BUILD PR — Asteroids New Boot Entry Visibility And Execution Check
+
+## Purpose
+The current problem is not gameplay yet — the parallel lane appears not to execute at all, and there are no console messages.
+This PR is strictly for boot-entry visibility and execution proof so the game can be confirmed as actually starting.
+
+## Exact Target Files
+- `games/asteroids_new/index.js`
+- `games/asteroids_new/game/AsteroidsGameScene.js`
+- `games/asteroids_new/game/AsteroidsSession.js`
+- `games/asteroids_new/game/AsteroidsWorld.js`
+
+## Required Code Changes
+1. Add explicit, minimal boot visibility so execution can be confirmed immediately.
+2. Ensure `games/asteroids_new/index.js`:
+   - visibly proves it is being executed
+   - reports the first boot stage reached
+3. Ensure the listed downstream files report the first successful construction/entry stage reached.
+4. If boot currently exits silently, expose the failure point clearly.
+5. Keep all visibility additions minimal and temporary-style in spirit, but committed in code for this PR so the result is testable.
+
+## Hard Constraints
+- exact files only
+- do not modify any original `games/Asteroids/*` files
+- do not widen into assets, debug panels, config, or unrelated systems
+- do not redesign runtime flow
+- do not fix unrelated gameplay behavior in this PR
+- focus only on proving execution path and exposing silent failure points
+
+## Validation Steps
+- syntax-check all touched files
+- run from `games/asteroids_new/index.js`
+- confirm there is now visible proof of execution or a visible failure point
+- confirm no original `games/Asteroids/*` files changed
+
+## Acceptance Criteria
+- launching `games/asteroids_new/index.js` produces visible execution proof
+- if boot fails, the failure point is exposed instead of silent
+- original Asteroids files remain untouched

games/asteroids_new/game/AsteroidsGameScene.js

@@ -38,6 +38,16 @@ const ATTRACT_INPUT_CODES = [
   'Enter',
   'KeyP',
 ];
+let hasLoggedSceneConstruction = false;
+let hasLoggedSceneEnter = false;
+
+function logSceneBootStage(stage, details = null) {
+  if (details === null) {
+    console.info(`[AsteroidsNewBoot] scene:${stage}`);
+  } else {
+    console.info(`[AsteroidsNewBoot] scene:${stage}`, details);
+  }
+}
 
 function getBeatInterval(asteroidCount) {
   if (asteroidCount <= 1) {
@@ -84,6 +94,10 @@ function drawLives(renderer, centerX, y, lives) {
 export default class AsteroidsGameScene extends Scene {
   constructor(options = {}) {
     super();
+    if (!hasLoggedSceneConstruction) {
+      hasLoggedSceneConstruction = true;
+      logSceneBootStage('constructed');
+    }
     this.devConsoleIntegration = options.devConsoleIntegration || null;
     this.debugConfig = options.debugConfig || {
       debugMode: 'prod',
@@ -179,6 +193,10 @@ export default class AsteroidsGameScene extends Scene {
   }
 
   enter(engine) {
+    if (!hasLoggedSceneEnter) {
+      hasLoggedSceneEnter = true;
+      logSceneBootStage('enter');
+    }
     if (engine?.canvas) {
       engine.canvas.style.cursor = this.session.mode === 'playing' && !this.isPaused
         ? 'none'

games/asteroids_new/game/AsteroidsSession.js

@@ -35,9 +35,23 @@ function createSilentEvents() {
     sfx: [],
   };
 }
+let hasLoggedSessionConstruction = false;
+let hasLoggedSessionStart = false;
+
+function logSessionBootStage(stage, details = null) {
+  if (details === null) {
+    console.info(`[AsteroidsNewBoot] session:${stage}`);
+  } else {
+    console.info(`[AsteroidsNewBoot] session:${stage}`, details);
+  }
+}
 
 export default class AsteroidsSession {
   constructor(world, highScoreStore) {
+    if (!hasLoggedSessionConstruction) {
+      hasLoggedSessionConstruction = true;
+      logSessionBootStage('constructed');
+    }
     this.turnIntroTotalFlashes = 10;
     this.turnIntroInterval = 0.2;
     this.world = world;
@@ -63,6 +77,10 @@ export default class AsteroidsSession {
   }
 
   start(playerCount) {
+    if (!hasLoggedSessionStart) {
+      hasLoggedSessionStart = true;
+      logSessionBootStage('start-called', { playerCount });
+    }
     const safePlayerCount = sanitizePlayerCount(Number(playerCount));
     this.players = Array.from({ length: safePlayerCount }, (_, index) => ({
       id: index + 1,

games/asteroids_new/game/AsteroidsWorld.js

@@ -31,6 +31,16 @@ const WAVE_SPAWN_MARGIN_Y = 120;
 const WAVE_SPAWN_ATTEMPTS = 60;
 const ASTEROID_SPAWN_SAFE_PADDING = 24;
 const MAX_UPDATE_STEP_SECONDS = 1 / 60;
+let hasLoggedWorldConstruction = false;
+let hasLoggedWorldStartGame = false;
+
+function logWorldBootStage(stage, details = null) {
+  if (details === null) {
+    console.info(`[AsteroidsNewBoot] world:${stage}`);
+  } else {
+    console.info(`[AsteroidsNewBoot] world:${stage}`, details);
+  }
+}
 
 function sanitizeBoolean(value, fallback = false) {
   return typeof value === 'boolean' ? value : fallback;
@@ -127,6 +137,10 @@ function getRectOverlapDepth(x, y, radius, rect) {
 
 export default class AsteroidsWorld {
   constructor(bounds, { rng = Math.random } = {}) {
+    if (!hasLoggedWorldConstruction) {
+      hasLoggedWorldConstruction = true;
+      logWorldBootStage('constructed', bounds);
+    }
     this.rng = typeof rng === 'function' ? rng : Math.random;
     this.bounds = sanitizeBounds(bounds);
     this.starfield = Array.from({ length: 70 }, () => ({
@@ -232,6 +246,10 @@ export default class AsteroidsWorld {
   }
 
   startGame() {
+    if (!hasLoggedWorldStartGame) {
+      hasLoggedWorldStartGame = true;
+      logWorldBootStage('start-game');
+    }
     this.wave = 1;
     this.shipActive = true;
     this.respawnDelay = 0;