Normalize _template asset structure and add fullscreen bezel foundation

BUILD_PR_LEVEL_10_15_TEMPLATE_ASSET_STRUCTURE_AND_FULLSCREEN_BEZEL_FOUNDATION

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,11 +1,50 @@
-MODEL: GPT-5.3-codex
-REASONING: medium
+MODEL: GPT-5.4
+REASONING: high
 
 COMMAND:
-1. Run full validation suite
-2. Verify manifest-driven loading across all asset types
-3. Confirm no references to assets.json remain
-4. Confirm all renamed files resolve correctly
-5. Fix any breakages found
-6. Package repo ZIP to:
-   <project folder>/tmp/BUILD_PR_LEVEL_10_14_ASTEROIDS_RUNTIME_VALIDATION_PASS.zip
+Create `BUILD_PR_LEVEL_10_15_TEMPLATE_ASSET_STRUCTURE_AND_FULLSCREEN_BEZEL_FOUNDATION` as one small bundled PR with exactly these changes:
+
+1. Normalize `games/_template/assets/` to match the current Asteroids asset directory structure:
+   - audio/
+   - fonts/
+   - images/
+   - palettes/
+   - parallax/
+   - parallax/data/.gitkeep
+   - sprites/
+   - sprites/data/.gitkeep
+   - tilemaps/
+   - tilemaps/data/.gitkeep
+   - tilesets/
+   - vectors/
+   - vectors/data/.gitkeep
+   - preserve `.gitkeep` where needed
+   - do NOT copy Asteroids-specific content into `_template`
+
+2. Add a minimal fullscreen bezel foundation that is clearly NOT Parallax:
+   - use Asteroids `games/Asteroids/assets/images/bezel.png` as the first candidate asset
+   - bezel only applies in fullscreen mode
+   - bezel is screen-space, not world-space
+   - implement as a dedicated explicit surface/class/module name such as `FullscreenBezelOverlay` or equivalent clear name
+   - support draw mode contract with:
+     - default `overlay` (draw last)
+     - optional `underlay` support point for future use
+   - keep scope minimal and engine-safe
+
+3. Add/update focused tests or validation coverage for:
+   - `_template` directory scaffold exists
+   - bezel path/contract resolves correctly
+   - fullscreen-only gating is covered
+   - no Parallax coupling is introduced
+
+4. Update roadmap status only by adding the bezel foundation item in the appropriate high-level roadmap area without rewriting unrelated roadmap text.
+
+5. Final packaging step is REQUIRED:
+   - package ALL changed files into this exact repo-structured ZIP:
+     `<project folder>/tmp/BUILD_PR_LEVEL_10_15_TEMPLATE_ASSET_STRUCTURE_AND_FULLSCREEN_BEZEL_FOUNDATION.zip`
+
+Hard rules:
+- no commit-only result
+- no missing ZIP
+- no repo-wide unrelated edits
+- keep changes surgical

docs/dev/COMMIT_COMMENT.txt

@@ -1,2 +1,2 @@
-Validate runtime after asset normalization and manifest deduplication
-BUILD_PR_LEVEL_10_14_ASTEROIDS_RUNTIME_VALIDATION_PASS
+Normalize _template asset structure and add fullscreen bezel foundation
+BUILD_PR_LEVEL_10_15_TEMPLATE_ASSET_STRUCTURE_AND_FULLSCREEN_BEZEL_FOUNDATION

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-BUILD_PR_LEVEL_10_15_BEZEL_RENDER_LAYER_FOUNDATION
+BUILD_PR_LEVEL_10_16_ASTEROIDS_FULLSCREEN_BEZEL_IMPLEMENTATION_CANDIDATE

docs/dev/reports/change_summary.txt

@@ -1,4 +1,4 @@
-Runtime validation pass completed after manifest deduplication and filename normalization.
-Expanded manifest discovery test to assert all active domains resolve through tools.manifest.json.
-Confirmed no remaining runtime references to deprecated games/<game>/assets/assets.json paths.
-No runtime breakages found in loader or renamed asset path resolution.
+- Bundled _template asset scaffold normalization with fullscreen bezel foundation
+- Declared bezel as dedicated screen-space overlay, not Parallax
+- Set Asteroids bezel.png as first candidate asset
+- Enforced required Codex ZIP packaging output

docs/dev/reports/validation_checklist.txt

@@ -1,6 +1,8 @@
-- npm test: FAIL at pretest shared-extraction guard (existing baseline drift: baseline_unexpected=26)
-- node ./scripts/run-node-tests.mjs: PASS (127/127 explicit tests, launch smoke PASS=227 FAIL=0)
-- PASS GameAssetManifestDiscovery (expanded all-domain manifest assertions)
-- PASS manifest-runtime-resolution (sprites/tilemaps/parallax/vectors)
-- PASS renamed-files-resolve (all runtimePath/toolDataPath entries exist)
-- no matches for deprecated games/<game>/assets/assets.json references
+- `_template` asset folders match Asteroids structure
+- `.gitkeep` files preserved where needed
+- No Asteroids-specific content copied into `_template`
+- Bezel is fullscreen-only
+- Bezel is screen-space, not camera/parallax space
+- Default draw mode is overlay, with explicit future underlay hook
+- Focused validation/tests added
+- Output ZIP created at `<project folder>/tmp/BUILD_PR_LEVEL_10_15_TEMPLATE_ASSET_STRUCTURE_AND_FULLSCREEN_BEZEL_FOUNDATION.zip`