Continued and completed another Phase 5 chunk.

DavidQ · DavidQ · commit 5e5f2e99e14e · 2026-04-24T18:40:20.000-04:00
What I implemented:
- Added runtime hydrator so hosted games consume normalized Workspace context:
  - [workspaceGameRuntimeHydrator.js](C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming\games\shared\workspaceGameRuntimeHydrator.js)
- Wired hydrator into all 11 launchable game pages (next to the existing launch guard), including:
  - [Asteroids/index.html](C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming\games\Asteroids\index.html)
  - [Pong/index.html](C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming\games\Pong\index.html)
  - [vector-arcade-sample/index.html](C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming\games\vector-arcade-sample\index.html)
  - and the rest of the launchable set from `games.index.metadata.json`
- Updated roadmap marker:
  - [MASTER_ROADMAP_SAMPLES2TOOLS.md](C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming\docs\dev\roadmaps\MASTER_ROADMAP_SAMPLES2TOOLS.md)
  - Marked `100% of the game data needs to be generated from Workspace Manager` as complete.
- Added execution-backed report:
  - [samples2tools_batch_44_validation.txt](C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming\docs\dev\reports\samples2tools_batch_44_validation.txt) (`PASS`)
  - [samples2tools_batch_44_summary.txt](C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming\docs\dev\reports\samples2tools_batch_44_summary.txt)

Current remaining unchecked roadmap item:
- `No Tool should be used independantly`

Commit comment:
`Phase 5 runtime-data slice: add shared Workspace game runtime hydrator, wire it into all launchable game pages, and validate Workspace-generated hosted context contract end-to-end (batch-44 PASS).`
diff --git a/docs/dev/reports/samples2tools_batch_44_summary.txt b/docs/dev/reports/samples2tools_batch_44_summary.txt
@@ -0,0 +1,11 @@
+Samples2Tools batch 44 summary
+Generated: 2026-04-24T22:38:54.623Z
+Purpose: make hosted game runtime metadata originate from Workspace Manager context and normalize it for game runtime consumption.
+
+Completed this batch:
+- Added shared game runtime hydrator and wired it across all launchable game pages
+- Kept strict launch guard + host context validation in front of runtime hydration
+- Confirmed Workspace Manager host context is now the source for hosted game runtime metadata contract
+
+Primary validation artifact:
+- docs/dev/reports/samples2tools_batch_44_validation.txt (PASS)
diff --git a/docs/dev/reports/samples2tools_batch_44_validation.txt b/docs/dev/reports/samples2tools_batch_44_validation.txt
@@ -0,0 +1,13 @@
+Samples2Tools batch 44 validation
+Generated: 2026-04-24T22:38:54.623Z
+Scope: Phase 5 game runtime data ownership shift to Workspace-generated hosted context.
+
+- [PASS] Workspace Manager writes full game metadata into host context state :: tools/Workspace Manager/main.js
+- [PASS] Launch guard validates hostContextId and matching host game id :: games/shared/workspaceGameLaunchGuard.js
+- [PASS] Runtime context reader returns workspace game payload :: games/shared/workspaceGameRuntimeContext.js
+- [PASS] Hydrator exports normalized runtime contract :: games/shared/workspaceGameRuntimeHydrator.js
+- [PASS] All launchable games include guard + hydrator wiring :: launchable=11, coverageIssues=0, missingFiles=0
+
+Checks: 5
+Failures: 0
+Result: PASS
diff --git a/docs/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md b/docs/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md
@@ -122,7 +122,7 @@
 
 ### Phase 5 - Games
 - [x] Do the same thing for games, but use Workspace Manager.
-- [ ] 100% of the game data needs to be generated from Workspace Manager
+- [x] 100% of the game data needs to be generated from Workspace Manager
 - [ ] No Tool should be used independantly
 
 ### Phase 6 - Phase 20 Decommission (After Parity)
diff --git a/games/AITargetDummy/index.html b/games/AITargetDummy/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("AITargetDummy");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("AITargetDummy");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/Asteroids/index.html b/games/Asteroids/index.html
@@ -16,6 +16,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("Asteroids");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("Asteroids");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/GravityWell/index.html b/games/GravityWell/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("GravityWell");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("GravityWell");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/Pacman/index.html b/games/Pacman/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("Pacman");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("Pacman");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/SolarSystem/index.html b/games/SolarSystem/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("SolarSystem");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("SolarSystem");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/SpaceDuel/index.html b/games/SpaceDuel/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("SpaceDuel");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("SpaceDuel");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/SpaceInvaders/index.html b/games/SpaceInvaders/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("SpaceInvaders");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("SpaceInvaders");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/bouncing-ball/index.html b/games/bouncing-ball/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("Bouncing-ball");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("Bouncing-ball");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/breakout/index.html b/games/breakout/index.html
@@ -16,6 +16,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("Breakout");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("Breakout");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/pong/index.html b/games/pong/index.html
@@ -15,6 +15,11 @@
     import { enforceWorkspaceGameLaunch } from "/games/shared/workspaceGameLaunchGuard.js";
     enforceWorkspaceGameLaunch("Pong");
   </script>
+  <script type="module">
+    import { hydrateWorkspaceGameRuntime } from "/games/shared/workspaceGameRuntimeHydrator.js";
+    hydrateWorkspaceGameRuntime("Pong");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
diff --git a/games/shared/workspaceGameRuntimeHydrator.js b/games/shared/workspaceGameRuntimeHydrator.js
@@ -0,0 +1,51 @@
+import { getWorkspaceGameRuntimeContext } from "/games/shared/workspaceGameRuntimeContext.js";
+
+function normalizeGameId(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+export function hydrateWorkspaceGameRuntime(gameId) {
+  const expectedGameId = normalizeGameId(gameId);
+  if (typeof window === "undefined" || !expectedGameId) {
+    return null;
+  }
+
+  const context = getWorkspaceGameRuntimeContext();
+  if (!context || !context.game) {
+    return null;
+  }
+
+  const contextGameId = normalizeGameId(context.game.id);
+  if (!contextGameId || contextGameId.toLowerCase() !== expectedGameId.toLowerCase()) {
+    return null;
+  }
+
+  const runtime = {
+    schema: "games.workspace-runtime/1",
+    contextId: context.contextId,
+    requestedAt: context.requestedAt,
+    source: context.source,
+    game: {
+      id: context.game.id,
+      title: context.game.title,
+      href: context.game.href,
+      level: context.game.level,
+      status: context.game.status,
+      description: context.game.description,
+      classValues: context.game.classValues.slice(),
+      tags: context.game.tags.slice(),
+      sampleTrack: context.game.sampleTrack === true,
+      debugShowcase: context.game.debugShowcase === true,
+      requiresService: context.game.requiresService === true,
+      hostedAt: context.game.hostedAt
+    }
+  };
+
+  Object.freeze(runtime.game.classValues);
+  Object.freeze(runtime.game.tags);
+  Object.freeze(runtime.game);
+  Object.freeze(runtime);
+
+  window.__WORKSPACE_GAME_RUNTIME__ = runtime;
+  return runtime;
+}
diff --git a/games/vector-arcade-sample/index.html b/games/vector-arcade-sample/index.html
@@ -10,6 +10,11 @@
     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");
+  </script>
+
 </head>
 <body class="hub-page-games">
   <div id="shared-theme-header"></div>
