Run interactive UAT on stabilized tools

- Validate Vector Map Editor behavior
- Validate paint/stroke interactions
- Validate State Inspector JSON handling
- Confirm header UX consistency
- Capture issues without modifying behavior

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,60 +1,12 @@
 MODEL: GPT-5.3-codex
 REASONING: low
 
-PR purpose:
-Stabilize existing tools only. Do not add new features.
+Run interactive UAT:
 
-Priority:
-1. Fix Vector Map Editor default selection behavior first.
-2. Fix paint/fill and stroke controls.
-3. Improve State Inspector JSON usability.
-4. Remove silent fallback data.
-5. Apply header polish follow-up.
+- Open each tool in browser
+- Execute manual test steps from PR doc
+- Record PASS/FAIL per tool
+- Capture issues without fixing them
 
-Hard rules:
-- Do not use silent fallback data.
-- Do not auto-load hidden/default sample assets.
-- Do not add safe fallback behavior that hides missing tool configuration.
-- If required data or configuration is missing, show an actionable error message.
-- Do not modify start_of_day folders.
-- Do not modify sample games or unrelated engine runtime files.
-
-Header follow-up:
-- Keep fullscreen header single-line format:
-  <Tool Name> — <Short Description>
-- If tool.name or tool.shortDescription is missing, show an actionable configuration error.
-- Add hard max-width / nowrap / overflow hidden / text-overflow ellipsis.
-- Lock font size and line height.
-- Add data-tool-id to header DOM.
-
-Vector Map Editor:
-- Make initial selection/mode explicit and visible.
-- Do not silently select an object.
-- Do not silently load default/sample data.
-- Show empty state when no map/manifest is loaded.
-- Confirm selection clears correctly.
-
-Paint / stroke:
-- Ensure fill/paint controls update selected editable objects.
-- Ensure stroke controls update selected editable objects.
-- Disable controls only when there is no valid selection.
-- Disabled controls must explain why.
-
-State Inspector:
-- Format valid JSON.
-- Show clear parse errors for invalid JSON.
-- Show safe empty state for missing/empty state.
-- Do not inject sample state.
-
-Validation:
-- Run node --check on changed JavaScript files.
-- Manually verify the four target tools:
-  - Vector Map Editor
-  - Vector Asset Studio
-  - Sprite Editor
-  - State Inspector
-
-Report:
-- List changed files.
-- List validation commands/results.
-- Note any remaining issues without masking them.
+Do not modify code in this PR.
+Only report findings.

docs/dev/commit_comment.txt

@@ -1,7 +1,7 @@
-Stabilize tool UX and remove silent fallback behavior
+Run interactive UAT on stabilized tools
 
-- Fix Vector Map Editor startup/selection behavior
-- Restore reliable paint/fill and stroke control behavior
-- Improve State Inspector JSON empty/error handling
-- Replace silent fallback data with actionable messages
-- Tighten fullscreen header sizing and add data-tool-id for diagnostics
+- Validate Vector Map Editor behavior
+- Validate paint/stroke interactions
+- Validate State Inspector JSON handling
+- Confirm header UX consistency
+- Capture issues without modifying behavior

docs/dev/pr_tool_interactive_uat.md

@@ -0,0 +1,105 @@
+# PR — Tool Interactive UAT
+
+## Purpose
+Perform browser-based interactive validation of core tools after stabilization.
+
+This PR is validation-only. Do not add features or change behavior.
+
+---
+
+## Scope
+
+Tools:
+- Vector Map Editor
+- Vector Asset Studio
+- Sprite Editor
+- State Inspector
+
+---
+
+## Test Matrix
+
+### 1. Vector Map Editor
+
+- Launch tool
+- Confirm:
+  - No auto-selection
+  - No hidden data loaded
+  - Empty state visible
+
+- Load/select objects (if available)
+- Verify:
+  - Selection changes visually
+  - Selection clears correctly
+
+---
+
+### 2. Vector Asset Studio
+
+- Select editable object
+- Modify:
+  - Fill / paint
+  - Stroke
+
+- Verify:
+  - Visual updates occur
+  - Controls disable when no selection
+  - Disabled controls show reason
+
+- Remove required config (test)
+- Verify:
+  - Actionable error displayed
+  - No silent fallback
+
+---
+
+### 3. State Inspector
+
+- Input valid JSON
+  - Confirm pretty formatting
+
+- Input invalid JSON
+  - Confirm clear parse error
+
+- Input non-object JSON
+  - Confirm validation message
+
+- Empty input
+  - Confirm empty-state message
+
+---
+
+### 4. Sprite Editor
+
+- Launch tool
+- Verify:
+  - Header format correct
+  - No fallback data
+  - No unexpected errors
+
+---
+
+## Reporting
+
+For each tool:
+- PASS / FAIL
+- Notes on behavior
+- Screenshots (optional)
+- List of issues discovered
+
+---
+
+## Acceptance Criteria
+
+- All tools pass interactive validation
+- No silent fallback behavior observed
+- Errors are actionable and visible
+- Header UX consistent across tools
+
+---
+
+## Out of Scope
+
+- New features
+- Refactoring
+- Game engine changes