PR 9.10: runtime stabilization for single-manifest games

Author: DavidQ

docs/dev/reports/launch_smoke_report.md

@@ -1,6 +1,6 @@
 # Launch Smoke Report
 
-Generated: 2026-04-27T00:19:24.404Z
+Generated: 2026-04-27T00:22:36.375Z
 
 Filters: games=true, samples=false, tools=false, sampleRange=all
 

docs/dev/reports/level_9_10_single_manifest_runtime_stabilization_report.md

@@ -0,0 +1,35 @@
+# Level 9.10 Single-Manifest Runtime Stabilization Report
+
+## BUILD
+- `BUILD_PR_LEVEL_9_10_SINGLE_MANIFEST_RUNTIME_STABILIZATION`
+
+## Scope
+- Run games-only launch smoke.
+- Fix runtime issues caused by manifest flattening if reproduced.
+- Keep execution limited to games (no samples).
+
+## Validation Executed
+1. `npm run test:launch-smoke:games`
+2. Manifest presence audit for launchable game entries (`games/*/index.html` -> `games/*/game.manifest.json`).
+3. Targeted loader check in `games/shared/workspaceGameAssetCatalog.js` for direct manifest-data extraction path.
+
+## Results
+- Games-only smoke run: `PASS=12 FAIL=0 TOTAL=12`.
+- Launch filter proof: `games=true samples=false tools=false`.
+- No sample entries executed.
+- No launch failures were reproduced, so no runtime stabilization patch was required in this pass.
+- Manifest audit for launchable game entries:
+  - `game_entries=12`
+  - `missing_game_manifest_for_entries=0`
+
+## Runtime Loader Verification
+- `games/shared/workspaceGameAssetCatalog.js` already supports game-manifest payload extraction:
+  - accepts `schema: "html-js-gaming.game-manifest"`
+  - reads direct `assetCatalog` entries
+  - merges `tools["asset-browser"].assets.media` entries for runtime catalog resolution
+
+## Files Changed
+- `docs/dev/reports/level_9_10_single_manifest_runtime_stabilization_report.md` (new)
+
+## Notes
+- `start_of_day` was not modified.

docs/operations/dev/codex_commands.md

@@ -1,33 +1,11 @@
 MODEL: GPT-5.3-codex
-REASONING: medium
 
 TASK:
-Apply BUILD_PR_LEVEL_9_9_LAUNCH_SMOKE_GAMES_ONLY_FAST_PATH.
+- run games-only smoke test
+- fix runtime issues caused by manifest flattening
+- ensure all games load from manifest data
+- no sample execution
+- no start_of_day changes
 
-STEPS:
-1. Read docs/pr/PLAN_PR_LEVEL_9_9_LAUNCH_SMOKE_GAMES_ONLY_FAST_PATH.md.
-2. Read docs/pr/BUILD_PR_LEVEL_9_9_LAUNCH_SMOKE_GAMES_ONLY_FAST_PATH.md.
-3. Inspect:
-   - package.json
-   - tests/runtime/LaunchSmokeAllEntries.test.mjs
-   - scripts that invoke launch smoke tests
-4. Add or update a dedicated games-only command:
-   - preferred: npm run test:launch-smoke:games
-   - must pass: --games
-5. Ensure games-only command invokes LaunchSmokeAllEntries exactly once.
-6. Do not remove full all-entry launch smoke behavior.
-7. Ensure games-only excludes samples and tools.
-8. Write docs/dev/reports/level_9_9_launch_smoke_games_only_fast_path_report.md with final command and validation.
-9. Update docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md status only if needed:
-   - [ ] -> [.]
-   - [.] -> [x]
-   - no prose rewrite/delete
-10. Do not modify start_of_day.
-11. Create Codex delta ZIP:
-    tmp/BUILD_PR_LEVEL_9_9_LAUNCH_SMOKE_GAMES_ONLY_FAST_PATH_delta.zip
-
-ACCEPTANCE:
-- games-only launch smoke command exists
-- samples/tools excluded
-- duplicate game execution false
-- delta ZIP exists
+OUTPUT:
+tmp/BUILD_PR_LEVEL_9_10_SINGLE_MANIFEST_RUNTIME_STABILIZATION_delta.zip

docs/operations/dev/commit_comment.txt

@@ -1,9 +1 @@
-BUILD_PR_LEVEL_9_9_LAUNCH_SMOKE_GAMES_ONLY_FAST_PATH
-
-- Added games-only launch smoke fast path
-- Ensured browser smoke validation can run games only once
-- Preserved full all-entry launch smoke coverage
-
-PR Details:
-- Fixes accidental games + samples + tools browser smoke runs
-- No start_of_day changes
+PR 9.10: runtime stabilization for single-manifest games

docs/pr/BUILD_PR_LEVEL_9_10_SINGLE_MANIFEST_RUNTIME_STABILIZATION.md

@@ -0,0 +1,5 @@
+Stabilize runtime after single-manifest conversion.
+
+- ensure loaders read direct data (no refs)
+- fix any runtime breakages
+- validate all games via games-only smoke