Reduce games workspace boot tech debt by introducing shared workspaceGameBoot module and replacing per-page duplicate guard+hydrator scripts across all launchable game index pages (batch-49 PASS).

DavidQ · DavidQ · commit 878a3664a105 · 2026-04-24T18:53:33.000-04:00
diff --git a/docs/dev/reports/samples2tools_batch_49_summary.txt b/docs/dev/reports/samples2tools_batch_49_summary.txt
@@ -0,0 +1,11 @@
+Samples2Tools batch 49 summary
+Generated: 2026-04-24T22:51:33.575Z
+Purpose: remove duplicated workspace game boot wiring across launchable game pages.
+
+Completed this batch:
+- Added shared workspaceGameBoot module to compose launch guard and runtime hydrator
+- Replaced per-page duplicate guard/hydrator imports with single boot import on all launchable games
+- Confirmed no launchable game page still imports guard/hydrator directly
+
+Primary validation artifact:
+- docs/dev/reports/samples2tools_batch_49_validation.txt (PASS)
diff --git a/docs/dev/reports/samples2tools_batch_49_validation.txt b/docs/dev/reports/samples2tools_batch_49_validation.txt
@@ -0,0 +1,10 @@
+Samples2Tools batch 49 validation
+Generated: 2026-04-24T22:51:33.575Z
+Scope: reduce game-page boot duplication by consolidating guard+hydrator into shared workspace boot module.
+
+- [PASS] All launchable game pages use unified workspace boot module only :: launchable=11, issues=0
+- [PASS] workspaceGameBoot composes guard then hydrator :: games/shared/workspaceGameBoot.js
+
+Checks: 2
+Failures: 0
+Result: PASS
diff --git a/games/AITargetDummy/index.html b/games/AITargetDummy/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("AITargetDummy");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("AITargetDummy");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("AITargetDummy");
   </script>
 
 </head>
diff --git a/games/Asteroids/index.html b/games/Asteroids/index.html
@@ -13,12 +13,8 @@
   <link rel="stylesheet" href="/games/shared/styles/vectorBattleFont.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("Asteroids");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("Asteroids");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("Asteroids");
   </script>
 
 </head>
diff --git a/games/GravityWell/index.html b/games/GravityWell/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("GravityWell");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("GravityWell");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("GravityWell");
   </script>
 
 </head>
diff --git a/games/Pacman/index.html b/games/Pacman/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("Pacman");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("Pacman");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("Pacman");
   </script>
 
 </head>
diff --git a/games/SolarSystem/index.html b/games/SolarSystem/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("SolarSystem");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("SolarSystem");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("SolarSystem");
   </script>
 
 </head>
diff --git a/games/SpaceDuel/index.html b/games/SpaceDuel/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("SpaceDuel");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("SpaceDuel");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("SpaceDuel");
   </script>
 
 </head>
diff --git a/games/SpaceInvaders/index.html b/games/SpaceInvaders/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("SpaceInvaders");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("SpaceInvaders");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("SpaceInvaders");
   </script>
 
 </head>
diff --git a/games/bouncing-ball/index.html b/games/bouncing-ball/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("Bouncing-ball");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("Bouncing-ball");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("Bouncing-ball");
   </script>
 
 </head>
diff --git a/games/breakout/index.html b/games/breakout/index.html
@@ -13,12 +13,8 @@
   <link rel="stylesheet" href="/samples/shared/debugShowcaseControls.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("Breakout");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("Breakout");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("Breakout");
   </script>
 
 </head>
diff --git a/games/pong/index.html b/games/pong/index.html
@@ -12,12 +12,8 @@
   <link rel="stylesheet" href="/src/engine/ui/baseLayout.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("Pong");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("Pong");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("Pong");
   </script>
 
 </head>
diff --git a/games/shared/workspaceGameBoot.js b/games/shared/workspaceGameBoot.js
@@ -0,0 +1,15 @@
+import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
+import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+
+function normalizeGameId(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+export function bootWorkspaceGame(gameId) {
+  const normalizedGameId = normalizeGameId(gameId);
+  if (!normalizedGameId) {
+    return null;
+  }
+  enforceWorkspaceGameLaunch(normalizedGameId);
+  return hydrateWorkspaceGameRuntime(normalizedGameId);
+}
diff --git a/games/vector-arcade-sample/index.html b/games/vector-arcade-sample/index.html
@@ -7,12 +7,8 @@
   <link rel="stylesheet" href="/games/shared/styles/vectorBattleFont.css" />
   <link rel="stylesheet" href="../../src/engine/theme/main.css" />
   <script type="module">
-    import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
-    enforceWorkspaceGameLaunch("vector-arcade-sample");
-  </script>
-  <script type="module">
-    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
-    hydrateWorkspaceGameRuntime("vector-arcade-sample");
+    import { bootWorkspaceGame } from "/games/shared/workspaceGameBoot.js";
+    bootWorkspaceGame("vector-arcade-sample");
   </script>
 
 </head>
