Make game.manifest.json the SSoT for game data and workspace state - PR_26128_007-game-manifest-ssot

Author: DavidQ

docs/dev/reports/game_manifest_ssot.md

@@ -0,0 +1,34 @@
+# PR_26128_007 Game Manifest SSoT
+
+## Summary
+- Added `tools/schemas/game.manifest.schema.json` as the dedicated schema for `games/**/game.manifest.json`.
+- Reworked the Workspace Manager V2 discovery path to validate discovered `game.manifest.json` files against the dedicated game schema, not `workspace.manifest.schema.json`.
+- Converted the current Workspace Manager V2 game project manifests for Asteroids, Gravity Well, and Pong into the game-manifest SSoT envelope.
+- Preserved existing Workspace Manager V2 launch/session behavior by deriving the runtime workspace context from `game.workspace`.
+
+## SSoT Shape
+- `game.gameData` owns runtime-facing game data.
+- `game.workspace` owns tool/editor/workspace state used to edit and build the game.
+- No separate `games/**/workspace.manifest.json` file is required for Active Game discovery or launch.
+- The root game manifest is `schema: html-js-gaming.game-manifest`; the nested `game.workspace` payload remains the runtime workspace container used by existing Workspace Manager V2 tool launches.
+
+## Discovery Behavior
+- Active Game starts empty and disabled.
+- Repo load clears the current Active Game immediately.
+- Successful repo discovery enables Active Game with schema-valid `game.manifest.json` entries only.
+- Invalid manifests are skipped with visible status log entries that include the manifest path and validation reason.
+- Missing manifests are skipped, not fatal.
+- No default Active Game is auto-selected.
+
+## Scope Notes
+- No sample JSON was modified.
+- No roadmap content was modified.
+- No cross-tool communication was added.
+- Session/toolState behavior was preserved; existing launches still receive the same workspace-shaped session context.
+- Full samples smoke test was skipped because this BUILD explicitly requested targeted Workspace Manager V2 validation and to skip full samples smoke.
+
+## Validation
+- PASS: `node --check tools/workspace-manager-v2/js/services/WorkspaceManagerV2ContextService.js`
+- PASS: `node --check tests/playwright/tools/WorkspaceManagerV2.spec.mjs`
+- PASS: JSON parse for `tools/schemas/game.manifest.schema.json`, `games/Asteroids/game.manifest.json`, `games/GravityWell/game.manifest.json`, and `games/Pong/game.manifest.json`
+- PASS: `npm run test:workspace-v2` - 11 passed

docs/dev/reports/playwright_game_manifest_ssot.md

@@ -0,0 +1,23 @@
+# Playwright Game Manifest SSoT
+
+## Command
+`npm run test:workspace-v2`
+
+## Result
+PASS: 11 passed
+
+## Targeted Coverage
+- Verified Workspace Manager V2 launches from the tools index.
+- Verified Active Game starts empty and disabled before repo selection.
+- Verified Active Game enables only after successful repo discovery.
+- Verified Active Game discovers schema-valid `game.manifest.json` files.
+- Verified discovered game manifests validate through `validateGameManifest`.
+- Verified Asteroids `game.manifest.json` has no root workspace/document payload and instead owns `game.gameData` plus `game.workspace`.
+- Verified `game.workspace` still validates as the runtime workspace context used by existing tool launches.
+- Verified invalid manifests are skipped and logged with path plus validation reason.
+- Verified repo load failure clears and disables Active Game.
+- Verified no default game is auto-selected.
+- Verified Workspace Manager V2, Preview Generator V2, Asset Manager V2, Palette Manager V2, and Templates V2 launch paths still work from the derived workspace context.
+
+## Skipped
+- Full samples smoke test was skipped as requested. The targeted Workspace Manager V2 Playwright suite covers the schema ownership change, manifest discovery, invalid-manifest logging, and affected launch/session paths.