BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST

- Consolidated Asteroids JSON into game.manifest.json
- Removed all legacy Asteroids JSON files
- Updated Asteroids references to manifest-owned data
- Verified direct launch

PR Details:
- Hard cutover to true single-manifest Asteroids model
- No validators
- No start_of_day changes

Author: DavidQ

docs/dev/reports/expected_delta_template.md

@@ -1,6 +1,26 @@
-# Expected Codex Output
+# Expected Codex Return / Delta Template
 
-- legacy_catalogs_checked = ALL
-- legacy_catalogs_deleted = <count>
-- legacy_catalogs_retained = <count>
-- runtime_breakage = 0
+## Expected Changed Files
+- `games/Asteroids/game.manifest.json`
+- Asteroids loader/runtime files only where needed to read manifest-owned data
+- `docs/dev/reports/level_9_6_asteroids_hard_cutover_report.md`
+- `docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md` if status update needed
+
+## Expected Deleted Files
+All Asteroids JSON except `game.manifest.json`.
+
+## Expected Validation Summary
+- `asteroids_json_before=22`
+- `asteroids_json_after=1`
+- `only_remaining_json=games/Asteroids/game.manifest.json`
+- `deleted_json_files=21`
+- `old_json_references_remaining=0`
+- `json_404s=0`
+- `asteroids_direct_launch=true`
+- `validators_added=0`
+- `start_of_day_changes=0`
+
+## Expected Delta ZIP
+Codex must create:
+
+`tmp/BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST_delta.zip`

docs/dev/reports/level_9_6_asteroids_hard_cutover_report.md

@@ -0,0 +1,11 @@
+# Level 9.6 Asteroids Hard Cutover Report
+
+## To Be Completed By Codex
+- Before JSON inventory.
+- Inline mapping for every deleted JSON file.
+- Runtime references updated.
+- Deleted file list.
+- After JSON inventory.
+- Direct launch result.
+- 404 check result.
+- No start_of_day change confirmation.

docs/operations/dev/codex_commands.md

@@ -1,9 +1,41 @@
 MODEL: GPT-5.3-codex
+REASONING: high
 
 TASK:
-- verify all games fully manifest-driven
-- confirm no hidden JSON dependencies
-- produce final verification report
+Apply BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST.
 
-OUTPUT:
-tmp/BUILD_PR_LEVEL_9_5_FINAL_REVIEW_AND_NEXT_PHASE_PREP_delta.zip
+THIS IS A HARD CUTOVER.
+Final Asteroids state must have only:
+- games/Asteroids/game.manifest.json
+
+STEPS:
+1. Read docs/pr/PLAN_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST.md.
+2. Read docs/pr/BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST.md.
+3. Inventory all `games/Asteroids/**/*.json`.
+4. For each JSON except `game.manifest.json`:
+   - load contents
+   - inline actual JSON data into `game.manifest.json`
+   - map data to the owning tool section
+5. Search Asteroids code/config for deleted JSON references.
+6. Update Asteroids-scoped loaders/references to read from `game.manifest.json`.
+7. Delete all old Asteroids JSON files except `game.manifest.json`.
+8. Verify:
+   - JSON count under games/Asteroids is 1
+   - no old JSON path references remain
+   - Asteroids launches directly
+   - no 404s for deleted JSON
+9. Update docs/dev/reports/level_9_6_asteroids_hard_cutover_report.md.
+10. Update docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md status only if needed:
+    - [ ] -> [.]
+    - [.] -> [x]
+    - no prose rewrite/delete
+11. Do not add validators.
+12. Do not modify start_of_day.
+13. Create Codex delta ZIP:
+    tmp/BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST_delta.zip
+
+ACCEPTANCE:
+- asteroids_json_after=1
+- only remaining JSON is games/Asteroids/game.manifest.json
+- Asteroids launches directly
+- delta ZIP exists

docs/operations/dev/commit_comment.txt

@@ -1 +1,11 @@
-PR 9.5: final review and next phase prep
+BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST
+
+- Consolidated Asteroids JSON into game.manifest.json
+- Removed all legacy Asteroids JSON files
+- Updated Asteroids references to manifest-owned data
+- Verified direct launch
+
+PR Details:
+- Hard cutover to true single-manifest Asteroids model
+- No validators
+- No start_of_day changes

docs/pr/BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST.md

@@ -0,0 +1,128 @@
+# BUILD_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST
+
+## Objective
+Complete Asteroids hard cutover to a single JSON manifest.
+
+## Current Failure
+Asteroids still has 22 JSON files:
+
+```text
+games/Asteroids/assets/images/bezel.stretch.override.json
+games/Asteroids/assets/palettes/asteroids-classic.palette.json
+games/Asteroids/assets/palettes/asteroids-hud.palette.json
+games/Asteroids/assets/palettes/hud.json
+games/Asteroids/assets/parallax/data/overlay.data.json
+games/Asteroids/assets/parallax/data/title.data.json
+games/Asteroids/assets/parallax/overlay.json
+games/Asteroids/assets/parallax/title.json
+games/Asteroids/assets/sprites/data/demo.data.json
+games/Asteroids/assets/sprites/demo.json
+games/Asteroids/assets/tilemaps/data/stage.data.json
+games/Asteroids/assets/tilemaps/stage.json
+games/Asteroids/assets/tilesets/ui.json
+games/Asteroids/assets/tools.manifest.json
+games/Asteroids/assets/vectors/asteroid-large.json
+games/Asteroids/assets/vectors/asteroid-medium.json
+games/Asteroids/assets/vectors/asteroid-small.json
+games/Asteroids/assets/vectors/data/library.data.json
+games/Asteroids/assets/vectors/ship.json
+games/Asteroids/assets/vectors/title.json
+games/Asteroids/assets/workspace.asset-catalog.json
+games/Asteroids/game.manifest.json
+```
+
+## Required Final State
+
+```text
+games/Asteroids/game.manifest.json
+```
+
+Only this JSON file may remain under `games/Asteroids`.
+
+## Hard Cutover Steps
+
+### 1. Read and Inline
+For every Asteroids JSON file except `game.manifest.json`:
+- read JSON
+- place actual JSON object content into the correct owning tool section in `game.manifest.json`
+- do not place references to deleted JSON files
+
+### 2. Owning Tool Sections
+Use these ownership rules:
+
+| Source Data | Manifest Tool Section |
+|---|---|
+| HUD/skin colors | `primitive-skin-editor` |
+| classic palette swatches | palette/palette-browser or primitive skin section, based on current usage |
+| vector files | `vector-asset-studio.vectors` |
+| vector library data | `vector-asset-studio.libraries` |
+| sprites | `sprite-editor.sprites` |
+| tilemaps | `tile-map-editor.maps` |
+| tilesets | `tile-map-editor.tilesets` |
+| parallax | `parallax-editor.parallaxLevels` |
+| bezel/stretch override | `asset-browser.assets.bezel` metadata, or explicit `bezel` manifest section if already present |
+| tools.manifest data | merge useful lineage/tool data, then delete |
+| workspace.asset-catalog data | merge useful asset catalog data, then delete |
+
+### 3. Fix Runtime References
+Search Asteroids files for all deleted JSON paths and update them to use `game.manifest.json`.
+
+Required search terms:
+- `.json`
+- `workspace.asset-catalog`
+- `tools.manifest`
+- `asteroids-classic.palette`
+- `asteroids-hud.palette`
+- `hud.json`
+- `bezel.stretch.override`
+- `overlay.data`
+- `title.data`
+- `demo.data`
+- `stage.data`
+- `library.data`
+
+### 4. Delete Old JSON
+After data preservation and reference fixes, delete every Asteroids JSON except:
+
+```text
+games/Asteroids/game.manifest.json
+```
+
+### 5. Verify
+- Asteroids launches directly.
+- No network/file 404s for deleted JSON.
+- No old JSON path references remain.
+- JSON count under `games/Asteroids` is exactly 1.
+
+## Forbidden
+- Do not add embedded game data to `workspace.schema.json`.
+- Do not create new generic schema buckets unless already supported.
+- Do not leave reference-to-reference JSON.
+- Do not keep legacy catalogs.
+- Do not modify `start_of_day`.
+
+## Required Report
+Create:
+
+```text
+docs/dev/reports/level_9_6_asteroids_hard_cutover_report.md
+```
+
+Report:
+- before JSON count
+- after JSON count
+- files inlined
+- files deleted
+- runtime references fixed
+- direct launch result
+- any retained JSON and reason; expected retained count is 1
+
+## Acceptance
+- `games/Asteroids/**/*.json` count = 1.
+- Only `games/Asteroids/game.manifest.json` remains.
+- Asteroids direct launch works.
+- No 404s for deleted JSON files.
+- No legacy catalog references remain.
+- No validators added.
+- No `start_of_day` changes.
+- Delta ZIP returned.

docs/pr/PLAN_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST.md

@@ -0,0 +1,29 @@
+# PLAN_PR_LEVEL_9_6_ASTEROIDS_HARD_CUTOVER_SINGLE_MANIFEST
+
+## Purpose
+Finish Asteroids single-manifest consolidation with a hard cutover.
+
+## Target Final State
+Asteroids should have exactly one JSON file:
+
+```text
+games/Asteroids/game.manifest.json
+```
+
+All other Asteroids JSON files must be:
+- copied into the manifest as actual JSON data
+- loader references updated
+- deleted after verification
+
+## Scope
+- Asteroids only.
+- Inline all Asteroids JSON data into `game.manifest.json`.
+- Update Asteroids loaders/runtime references to use manifest-owned data.
+- Delete all other `games/Asteroids/**/*.json`.
+- Verify direct launch.
+
+## Non-Goals
+- No all-games rollout.
+- No tool schema redesign.
+- No validators.
+- No `start_of_day` changes.