PR 8.29B: Asteroids direct launch fix

- Preview now launches game directly
- Workspace Manager decoupled from preview

Author: ToolboxAid

docs/dev/reports/expected_delta_template.md

@@ -1,23 +1,6 @@
-# Expected Codex Return / Delta Template
+# Expected Codex Output
 
-## Expected Changed/Added Files
-- `games/Asteroids/game.manifest.json`
-- `games/Asteroids/assets/palettes/asteroids-hud.palette.json` if HUD is converted to separate palette
-- `docs/dev/reports/level_8_28_asteroids_manifest_ssot_report.md`
-- `docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md` if status update needed
-
-## Expected Validation Summary
-- `asteroids_game_manifest_exists=true`
-- `asteroids_bezel_override_wired=true`
-- `asteroids_main_palette_wired=true`
-- `asteroids_hud_data_typed=true`
-- `asteroids_unreferenced_json_after=<count>`
-- `legacy_catalogs_deleted=0`
-- `runtime_changes=0`
-- `validators_added=0`
-- `start_of_day_changes=0`
-
-## Expected Delta ZIP
-Codex must create:
-
-`tmp/BUILD_PR_LEVEL_8_28_MANIFEST_SSOT_IMPLEMENTATION_ASTEROIDS_FIRST_delta.zip`
+- asteroids_preview_direct_launch=true
+- workspace_manager_not_used_for_preview=true
+- runtime_changes=minimal link/config only
+- no validators added

docs/operations/dev/codex_commands.md

@@ -1,46 +1,14 @@
 MODEL: GPT-5.3-codex
-REASONING: high
 
 TASK:
-Apply BUILD_PR_LEVEL_8_28_MANIFEST_SSOT_IMPLEMENTATION_ASTEROIDS_FIRST.
+Fix Asteroids preview to launch game directly.
 
 STEPS:
-1. Read docs/pr/PLAN_PR_LEVEL_8_28_MANIFEST_SSOT_IMPLEMENTATION_ASTEROIDS_FIRST.md.
-2. Read docs/pr/BUILD_PR_LEVEL_8_28_MANIFEST_SSOT_IMPLEMENTATION_ASTEROIDS_FIRST.md.
-3. Inspect:
-   - games/Asteroids/assets/workspace.asset-catalog.json
-   - games/Asteroids/assets/tools.manifest.json
-   - games/Asteroids/assets/palettes/asteroids-classic.palette.json
-   - games/Asteroids/assets/palettes/hud.json
-   - games/Asteroids/assets/images/bezel.stretch.override.json
-4. Create or normalize:
-   - games/Asteroids/game.manifest.json
-5. Preserve existing asset data. Do not delete old catalogs.
-6. Ensure game.manifest.json references:
-   - asteroids-classic.palette.json
-   - bezel.stretch.override.json
-   - HUD palette/skin data after conversion
-   - existing referenced vector/sprite/tilemap/parallax JSON assets
-7. If hud.json is color data:
-   - convert to palette schema as games/Asteroids/assets/palettes/asteroids-hud.palette.json
-   - do not leave hud.json as loose untyped color data
-   - if retaining hud.json for compatibility, mark legacy in report
-8. Normalize palette colors:
-   - #RRGGBBFF -> #RRGGBB
-   - preserve non-FF alpha
-9. Write docs/dev/reports/level_8_28_asteroids_manifest_ssot_report.md.
-10. Update docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md status only:
-    - [ ] -> [.] or [.] -> [x]
-    - no prose rewrite/delete
-11. Do not add validators.
-12. Do not modify start_of_day.
-13. Avoid runtime code changes unless only a safe manifest input reference is required.
-14. Create Codex delta ZIP:
-    tmp/BUILD_PR_LEVEL_8_28_MANIFEST_SSOT_IMPLEMENTATION_ASTEROIDS_FIRST_delta.zip
+1. Locate preview.svg click handler / link source
+2. Replace Workspace Manager route with direct game launch route
+3. Ensure no gameId/mount query required
+4. Do not modify runtime logic beyond routing
+5. Do not modify start_of_day
 
-ACCEPTANCE:
-- asteroids_game_manifest_exists=true
-- asteroids_bezel_override_wired=true
-- asteroids_hud_data_typed=true
-- old catalogs intact
-- no validators/start_of_day changes
+OUTPUT:
+tmp/BUILD_PR_LEVEL_8_29B_ASTEROIDS_DIRECT_LAUNCH_FIX_delta.zip

docs/operations/dev/commit_comment.txt

@@ -1,11 +1,4 @@
-BUILD_PR_LEVEL_8_28_MANIFEST_SSOT_IMPLEMENTATION_ASTEROIDS_FIRST
+PR 8.29B: Asteroids direct launch fix
 
-- Added Asteroids-first game manifest SSoT plan
-- Wired Asteroids palette/HUD/bezel requirements into manifest acceptance
-- Kept legacy catalogs intact for parity review
-
-PR Details:
-- First concrete SSoT implementation pattern
-- No broad all-games rollout
-- No validators
-- No start_of_day changes
+- Preview now launches game directly
+- Workspace Manager decoupled from preview

docs/pr/BUILD_PR_LEVEL_8_29B_ASTEROIDS_DIRECT_LAUNCH_FIX.md

@@ -0,0 +1,24 @@
+# BUILD_PR_LEVEL_8_29B_ASTEROIDS_DIRECT_LAUNCH_FIX
+
+## Objective
+Correct preview click behavior.
+
+## Current (WRONG)
+preview.svg → Workspace Manager route
+
+## Correct (TARGET)
+preview.svg → direct game launch route
+
+## Rules
+- Preview click launches game directly
+- Workspace Manager must NOT be used for preview
+- Workspace Manager remains available via separate action
+
+## Expected Route
+Use existing game runtime entry:
+- games/Asteroids runtime entry point (index/runtime bootstrap)
+
+## Acceptance
+- Asteroids preview launches game directly
+- No Workspace Manager diagnostic appears
+- No query parameters required for direct launch

docs/pr/PLAN_PR_LEVEL_8_29B_ASTEROIDS_DIRECT_LAUNCH_FIX.md

@@ -0,0 +1,10 @@
+# PLAN_PR_LEVEL_8_29B_ASTEROIDS_DIRECT_LAUNCH_FIX
+
+## Purpose
+Fix Asteroids preview behavior so it launches the game directly instead of routing through Workspace Manager.
+
+## Scope
+- Update preview link target
+- Ensure direct game launch route is used
+- Keep Workspace Manager as optional action
+- Advance roadmap status only

games/Asteroids/index.html

@@ -12,11 +12,6 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="/games/shared/styles/vectorBattleFont.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
-  <script type="module">
-    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
-    bootWorkspaceGame("Asteroids");
-  </script>
-
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>