Full subfolder copy of Asteroids into asteroids_new for testable state: Flatten duplicated nested asteroids_new subfolders and keep only the correct root-level copies.

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

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Recover blocked 95A by building a smoke-testable asteroids_new vertical slice from existing Asteroids source files only.
+Flatten duplicated nested asteroids_new subfolders and keep only the correct root-level copies.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-After commit, inspect whether one additional exact gameplay dependency is needed or whether the vertical slice is already smoke-testable enough to validate.
+After commit, validate asteroids_new runtime/imports and then continue with the next testable vertical slice only.

docs/dev/reports/change_summary.txt

@@ -1,4 +1,3 @@
-- replace blocked 95A with an existing-sources-only vertical slice BUILD
-- use current asteroids_new boot/flow shell instead of missing original Asteroids boot/flow files
-- copy only world/debug/core-entity files that actually exist in the repo
-- keep original Asteroids files untouched
+- fix duplicated nested folders created by the full-copy burst
+- keep only the intended root-level asteroids_new files
+- preserve the smoke-testable parallel lane

docs/dev/reports/file_tree.txt

@@ -1,22 +1,12 @@
-docs/pr/BUILD_PR_GAMES_95B_ASTEROIDS_NEW_TESTABLE_VERTICAL_SLICE_EXISTING_SOURCES_ONLY.md
+docs/pr/BUILD_PR_GAMES_96A_ASTEROIDS_NEW_FLATTEN_DUPLICATE_SUBFOLDERS.md
 docs/dev/codex_commands.md
 docs/dev/commit_comment.txt
 docs/dev/next_command.txt
 docs/dev/reports/file_tree.txt
 docs/dev/reports/change_summary.txt
 docs/dev/reports/validation_checklist.txt
-games/Asteroids/game/AsteroidsWorld.js
-games/Asteroids/debug/asteroidsShowcaseDebug.js
-games/Asteroids/entities/Bullet.js
-games/Asteroids/entities/Ship.js
-games/Asteroids/entities/Asteroid.js
-games/Asteroids/entities/Ufo.js
-games/asteroids_new/index.js
-games/asteroids_new/flow/attract.js
-games/asteroids_new/flow/intro.js
-games/asteroids_new/game/AsteroidsWorld.js
-games/asteroids_new/debug/asteroidsShowcaseDebug.js
-games/asteroids_new/entities/Bullet.js
-games/asteroids_new/entities/Ship.js
-games/asteroids_new/entities/Asteroid.js
-games/asteroids_new/entities/Ufo.js
+games/asteroids_new/assets/assets/*
+games/asteroids_new/debug/debug/*
+games/asteroids_new/entities/entities/*
+games/asteroids_new/game/game/*
+games/asteroids_new/systems/systems/*

docs/dev/reports/validation_checklist.txt

@@ -1,7 +1,6 @@
 - single PR purpose only
-- exact target files only
-- existing source files only
+- exact folders/files only
 - no original Asteroids file changes
-- no missing source-file assumptions
-- asteroids_new files parse and import cleanly together
-- result is substantial enough for a real smoke test
+- no content changes to correct root-level files
+- duplicate nested folders removed
+- asteroids_new remains smoke-testable

docs/pr/BUILD_PR_GAMES_96A_ASTEROIDS_NEW_FLATTEN_DUPLICATE_SUBFOLDERS.md

@@ -0,0 +1,79 @@
+# BUILD PR — Asteroids New Flatten Duplicate Subfolders
+
+## Purpose
+Fix the incorrectly duplicated nested directories created during the full-copy burst so `games/asteroids_new` uses the intended template-aligned structure and remains testable.
+
+## Exact Target Files
+
+### Files currently in correct root-level folders (must remain)
+- `games/asteroids_new/assets/Asteroids Deluxe.png`
+- `games/asteroids_new/assets/asteroids-bezel.png`
+- `games/asteroids_new/assets/bangLarge.wav`
+- `games/asteroids_new/assets/bangMedium.wav`
+- `games/asteroids_new/assets/bangSmall.wav`
+- `games/asteroids_new/assets/beat1.wav`
+- `games/asteroids_new/assets/beat2.wav`
+- `games/asteroids_new/assets/extraShip.wav`
+- `games/asteroids_new/assets/fire.wav`
+- `games/asteroids_new/assets/preview.png`
+- `games/asteroids_new/assets/saucerBig.wav`
+- `games/asteroids_new/assets/saucerSmall.wav`
+- `games/asteroids_new/assets/thrust.wav`
+- `games/asteroids_new/assets/vector_battle.ttf`
+- `games/asteroids_new/debug/asteroidsShowcaseDebug.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/game/AsteroidsAttractAdapter.js`
+- `games/asteroids_new/game/AsteroidsGameScene.js`
+- `games/asteroids_new/game/AsteroidsSession.js`
+- `games/asteroids_new/game/AsteroidsWorld.js`
+- `games/asteroids_new/systems/AsteroidsAudio.js`
+- `games/asteroids_new/systems/AsteroidsHighScoreService.js`
+- `games/asteroids_new/systems/AsteroidsInitialsEntry.js`
+- `games/asteroids_new/systems/HighScoreStore.js`
+- `games/asteroids_new/systems/ShipDebrisSystem.js`
+
+### Incorrect duplicate nested folders/files to remove
+- `games/asteroids_new/assets/assets/*`
+- `games/asteroids_new/debug/debug/*`
+- `games/asteroids_new/entities/entities/*`
+- `games/asteroids_new/game/game/*`
+- `games/asteroids_new/systems/systems/*`
+
+## Required Code Changes
+1. Verify the root-level copies listed above are present and intact.
+2. Remove the duplicate nested folders and their duplicate contents:
+   - `assets/assets`
+   - `debug/debug`
+   - `entities/entities`
+   - `game/game`
+   - `systems/systems`
+3. Do not move, rename, or modify the correct root-level copies.
+4. Do not modify unrelated folders such as:
+   - `config`
+   - `flow`
+   - `levels`
+   - `platform`
+   - `ui`
+   - `utils`
+
+## Hard Constraints
+- exact scope only
+- do not touch original `games/Asteroids/*`
+- do not change file contents in the correct root-level copies
+- do not widen into import refactors unless removal of duplicate nested paths requires a minimum fix in an already-listed `games/asteroids_new` file
+- no repo-wide cleanup
+- no formatting-only churn
+
+## Validation Steps
+- confirm the duplicate nested folders no longer exist
+- confirm the root-level copies still exist
+- confirm `games/asteroids_new` still parses/imports cleanly after duplicate-folder removal
+- confirm no original `games/Asteroids/*` files changed
+
+## Acceptance Criteria
+- `games/asteroids_new` has one intended copy of each file in the correct folder
+- no `assets/assets`, `debug/debug`, `entities/entities`, `game/game`, or `systems/systems` folders remain
+- the parallel lane remains smoke-testable