Auto-mount selected Workspace Manager tool

PR Details:
- Places one tool dropdown above Editors.
- Locks/overlays Editors until explicit tool selection.
- Automatically mounts/activates the selected tool from the dropdown.
- Removes the extra Select Tool + Mount requirement from initial game-launched flow.
- Does not restore default/fallback tool selection.
- Leaves sample Open <tool> behavior untouched.

Author: DavidQ

docs/dev/codex_rules.md

@@ -4,10 +4,10 @@ These rules OVERRIDE all other instructions.
 
 ## This PR
 
-Fix only the initial Workspace Manager tool-banner visibility.
+Fix only Workspace Manager game-launched tool selection UX.
 
 Allowed:
-- targeted Workspace Manager render/visibility/CSS changes
+- targeted Workspace Manager render/selection/CSS changes
 - validation report
 
 Forbidden:
@@ -26,13 +26,20 @@ Forbidden:
 On game-launched Workspace Manager open:
 - show Workspace Manager shell/status
 - show Game Source and workspace status
-- do not show detached Tool banner
+- show one tool dropdown above Editors
+- show Editors locked/overlaid until selection
 - do not mount a tool
 - do not auto-select a tool
 
-## Tool Controls Visibility Rule
+## Required Selection Behavior
 
-Tool controls may appear only after explicit tool selection or explicit valid tool context.
+When the user selects a valid tool from the dropdown:
+- validate against registry/SSoT
+- automatically activate/mount selected tool
+- clear/hide overlay
+- update status
+
+No separate Select Tool or Mount click may be required for the initial flow.
 
 ## Forbidden Restorations
 

docs/dev/reports/workspace_manager_auto_mount_tool_selection_validation.md

@@ -0,0 +1,157 @@
+# Workspace Manager Auto Mount Tool Selection Validation
+
+## Changed Files
+
+- `tools/Workspace Manager/index.html`
+- `tools/Workspace Manager/main.js`
+- `tools/Workspace Manager/toolHost.css`
+- `docs/dev/reports/workspace_manager_auto_mount_tool_selection_validation.md`
+
+## Proof Initial Page Shows One Dropdown Above Editors
+
+Page shell/status and a single explicit dropdown above the editor surface:
+
+- title: `tools/Workspace Manager/index.html:11`
+- game source: `tools/Workspace Manager/index.html:12`
+- workspace status: `tools/Workspace Manager/index.html:13`
+- first-class tools surface copy: `tools/Workspace Manager/index.html:21`
+- one dropdown above Editors: `tools/Workspace Manager/index.html:24`
+- editors region: `tools/Workspace Manager/index.html:29`
+
+Required URL resolver output:
+
+```text
+{
+  href: '/tools/Workspace%20Manager/index.html?gameId=Bouncing-ball&mount=game',
+  error: ''
+}
+```
+
+## Proof Detached Top Banner/Tool Controls Are Gone
+
+`tools/Workspace Manager/index.html` no longer includes detached button/banner controls:
+
+```text
+actionApplyCount 0
+mountButtonCountExact 0
+prevButtonCount 0
+nextButtonCount 0
+unmountButtonCount 0
+standaloneCount 0
+stateInputCount 0
+currentLabelCount 0
+switchMetaCount 0
+```
+
+## Proof Editors/Tools Are Overlaid/Disabled Before Tool Selection
+
+Overlay markup exists directly over the editors region:
+
+- editor region: `tools/Workspace Manager/index.html:29`
+- overlay node: `tools/Workspace Manager/index.html:31`
+
+Overlay lock behavior is enforced in runtime:
+
+- overlay lock helper: `tools/Workspace Manager/main.js:220`
+- init starts locked: `tools/Workspace Manager/main.js:713`
+- no explicit tool remains locked: `tools/Workspace Manager/main.js:771`
+- missing/invalid context remains locked: `tools/Workspace Manager/main.js:644`, `tools/Workspace Manager/main.js:655`
+
+Overlay styling proves visual lock layer above editors:
+
+- `tools/Workspace Manager/toolHost.css:97`
+- `tools/Workspace Manager/toolHost.css:113`
+- `tools/Workspace Manager/toolHost.css:127`
+
+## Proof No Default Tool Selected On Load
+
+Tool select is populated with explicit empty option first, and only set to requested tool when explicitly present:
+
+- placeholder option: `tools/Workspace Manager/main.js:516`
+- explicit tool query validation: `tools/Workspace Manager/main.js:284-291`
+- no requested tool path returns without mount: `tools/Workspace Manager/main.js:771-773`
+
+## Proof Selecting Tool From Dropdown Auto-Mounts/Activates It
+
+Auto-mount is bound directly to dropdown change (no extra action required):
+
+- dropdown change event: `tools/Workspace Manager/main.js:632-636`
+- `mountSelectedTool("select")` invoked directly: `tools/Workspace Manager/main.js:635`
+- mount call path executes runtime mount: `tools/Workspace Manager/main.js:593-603`
+- overlay clears after activation: `tools/Workspace Manager/main.js:542`
+
+## Proof Separate Select Tool/Mount Actions Are Not Required For Initial Flow
+
+- No `Select Tool` button exists (`actionApplyCount 0`).
+- No `Mount` button exists (`mountButtonCountExact 0`).
+- Initial flow uses one dropdown; selection directly mounts via change handler (`tools/Workspace Manager/main.js:632-636`).
+
+## Proof `toolIds[0]` Not Restored
+
+Command output:
+
+```text
+toolIds0 0
+```
+
+## Proof `gameId || game` Not Restored
+
+Command output:
+
+```text
+gameIdOrGame 0
+legacyGameParamRead 0
+```
+
+## Proof Valid `gameId` Still Loads Game Context
+
+- valid game context status update: `tools/Workspace Manager/main.js:663-665`
+- init valid game context status update: `tools/Workspace Manager/main.js:748-750`
+
+## Proof Invalid/Missing Context Renders Visible Diagnostic
+
+- missing gameId diagnostic: `tools/Workspace Manager/main.js:648`, `tools/Workspace Manager/main.js:731`
+- invalid gameId diagnostic: `tools/Workspace Manager/main.js:659`, `tools/Workspace Manager/main.js:741`
+- diagnostic panel in markup: `tools/Workspace Manager/index.html:14-17`
+
+## Proof External Memory Clear Remains Intact
+
+Runtime check output:
+
+```text
+clearResult true
+localAfterClear [ [ 'keep.one', 'x' ] ]
+sessionAfterClear [ [ 'keep.two', 'y' ] ]
+launchResult true
+assignCalls [
+  '/tools/Workspace%20Manager/index.html?gameId=Bouncing-ball&mount=game'
+]
+localAfterLaunch [ [ 'keep.one', 'x' ] ]
+sessionAfterLaunch [ [ 'keep.two', 'y' ] ]
+```
+
+## Proof Samples `Open <tool>` Remain Untouched
+
+- sample label remains: `samples/index.render.js:104`
+- sample launch memory-reset path unchanged: `samples/index.render.js:539`
+
+## Static Validation
+
+Commands run successfully:
+
+```bash
+node --check tools/Workspace\ Manager/main.js
+node --check games/index.render.js
+node --check samples/index.render.js
+```
+
+## Anti-Pattern Self-Check
+
+- No sample launch behavior/labels changed.
+- No `gameId || game` fallback restored.
+- No `toolIds[0]` fallback restored.
+- No first-tool auto-selection restored.
+- No tool mounted on initial game launch before explicit selection.
+- No second SSoT introduced.
+- No broad Workspace Manager refactor performed.
+- No start_of_day files changed.

docs/operations/dev/codex_commands.md

@@ -1,4 +1,4 @@
-# Codex Commands — BUILD_PR_LEVEL_20_17_HIDE_TOOL_BANNER_UNTIL_TOOL_SELECTED
+# Codex Commands — BUILD_PR_LEVEL_20_18_AUTO_MOUNT_TOOL_SELECTION_WORKSPACE_SURFACE
 
 ## Model
 GPT-5.4 or GPT-5.3-codex
@@ -10,30 +10,30 @@ High
 
 ```text
 Read docs/dev/codex_rules.md first.
-Read docs/dev/reports/workspace_manager_tool_selector_surface_validation.md if present.
+Read docs/dev/reports/workspace_manager_hide_tool_banner_validation.md if present.
 Read docs/dev/specs/TOOL_LAUNCH_SSOT.md if present.
 
-Execute BUILD_PR_LEVEL_20_17_HIDE_TOOL_BANNER_UNTIL_TOOL_SELECTED.
+Execute BUILD_PR_LEVEL_20_18_AUTO_MOUNT_TOOL_SELECTION_WORKSPACE_SURFACE.
 
 User UAT finding:
-- Detached Tool banner is still visible.
-- User wants the banner removed/hidden until a tool is selected.
-- Initial Workspace Manager page should show the Workspace Manager shell/status page with:
-  - Workspace Manager title
-  - First-Class Tools Surface copy
-  - Game Source
-  - workspace actions
-  - Workspace loaded status
-  - shared palette/assets status
+- Current flow forces the user to choose dropdown workspace action, click Select Tool, select the tool, then Mount.
+- User wants one dropdown above Editors.
+- Tools/cards below should be hidden/locked with an overlay until a tool is selected.
+- When a tool is selected, automatically do the next step: activate/mount that selected tool.
+- No separate Select Tool + Mount flow should be required for initial game-launched use.
 
 Goal:
-Hide/remove the detached Tool banner until explicit tool selection.
+Simplify Workspace Manager game-launched tool selection UX while preserving no-default/no-fallback rules.
 
-Required initial behavior:
-- URL tools/Workspace Manager/index.html?gameId=SolarSystem&mount=game renders visible Workspace Manager shell/status page.
-- Do not show Tool / Prev / Next / Mount / Unmount / Open Standalone / Optional JSON state / No tool mounted banner on initial load.
-- Do not mount or auto-select a tool on initial load.
-- Tool controls may appear only after explicit tool selection or explicit valid tool context.
+Required behavior:
+- URL tools/Workspace Manager/index.html?gameId=Bouncing-ball&mount=game renders visible Workspace Manager shell/status page.
+- Show one explicit tool dropdown above Editors.
+- Do not show detached top banner/tool controls.
+- Editors/tool cards below are locked/overlaid until tool selection.
+- Do not auto-select or mount a default tool on load.
+- When user selects a valid tool from dropdown, automatically activate/mount selected tool.
+- Remove/hide overlay after activation.
+- Do not require Select Tool button or Mount button for initial flow.
 - Keep game context loaded.
 - Keep external memory clear.
 - Keep visible diagnostics for invalid/missing context.
@@ -44,7 +44,7 @@ Forbidden:
 - restoring gameId || game
 - restoring toolIds[0]
 - auto-selecting first tool
-- mounting a tool on initial game launch
+- mounting a tool on initial game launch before user selection
 - broad Workspace Manager refactor
 - second SSoT
 - fallback/default behavior
@@ -56,12 +56,14 @@ Likely files:
 - Workspace Manager CSS only if needed
 
 Validation:
-Create docs/dev/reports/workspace_manager_hide_tool_banner_validation.md with:
+Create docs/dev/reports/workspace_manager_auto_mount_tool_selection_validation.md with:
 - changed files
-- proof initial game-launched page shows Workspace Manager shell/status
-- proof detached tool banner is not visible before tool selection
-- proof tool controls appear only after explicit tool selection
-- proof no first-tool/default selection restored
+- proof initial page shows one dropdown above Editors
+- proof detached top banner/tool controls are gone
+- proof Editors/tools are overlaid/disabled before tool selection
+- proof no default tool selected on load
+- proof selecting a tool from dropdown auto-mounts/activates it
+- proof separate Select Tool and Mount actions are not required for initial flow
 - proof toolIds[0] not restored
 - proof gameId || game not restored
 - proof valid gameId still loads game context
@@ -70,5 +72,5 @@ Create docs/dev/reports/workspace_manager_hide_tool_banner_validation.md with:
 - anti-pattern self-check
 
 Return ZIP at:
-tmp/BUILD_PR_LEVEL_20_17_HIDE_TOOL_BANNER_UNTIL_TOOL_SELECTED.zip
+tmp/BUILD_PR_LEVEL_20_18_AUTO_MOUNT_TOOL_SELECTION_WORKSPACE_SURFACE.zip
 ```

docs/operations/dev/commit_comment.txt

@@ -1,9 +1,9 @@
-Hide Workspace Manager tool banner until selection
+Auto-mount selected Workspace Manager tool
 
 PR Details:
-- Hides detached Tool banner on initial game-launched Workspace Manager load.
-- Shows Workspace Manager shell/status surface first.
-- Shows tool controls only after explicit tool selection.
-- Preserves explicit gameId context and memory clear behavior.
+- Places one tool dropdown above Editors.
+- Locks/overlays Editors until explicit tool selection.
+- Automatically mounts/activates the selected tool from the dropdown.
+- Removes the extra Select Tool + Mount requirement from initial game-launched flow.
 - Does not restore default/fallback tool selection.
 - Leaves sample Open <tool> behavior untouched.