MODEL: GPT-5.3-codex

REASONING: medium
COMMAND:
Implement overlay alignment for samples 1709 and 1711.
- Apply movement-specific stack definition
- Enforce bottom-right anchor
- Ensure non-Tab cycle key
- Validate ordering and rendering
Package ZIP to <project folder>/tmp/

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,14 +1,9 @@
-MODEL: GPT-5.4
+MODEL: GPT-5.3-codex
 REASONING: medium
-
 COMMAND:
-Create BUILD_PR_LEVEL_17_56_DEBUG_OVERLAY_TEST_INPUT_KEY_REMAP as a smallest-scope test-only PR.
-
-Requirements:
-- Find Level 17 tests that still use `makeInput(['Tab'])` for debug overlay cycling
-- Replace each stale Tab-based test input with the active non-Tab cycle key already used by the current Level 17 runtime behavior
-- Keep scope limited to affected Level 17 tests and the smallest supporting test helper change if required
-- Do not change runtime keybinding code
-- Do not change overlay positioning or sample stack mapping
-- Do not modify start_of_day folders
-- Run the affected tests and package the repo-structured ZIP to <project folder>/tmp/BUILD_PR_LEVEL_17_56_DEBUG_OVERLAY_TEST_INPUT_KEY_REMAP.zip
+Implement overlay alignment for samples 1709 and 1711.
+- Apply movement-specific stack definition
+- Enforce bottom-right anchor
+- Ensure non-Tab cycle key
+- Validate ordering and rendering
+Package ZIP to <project folder>/tmp/

docs/dev/COMMIT_COMMENT.txt

@@ -1,6 +1,2 @@
-Replace stale Level 17 Tab-based overlay cycle tests with the approved non-Tab input.
-
-PR Details:
-- Updates affected Level 17 tests that still use makeInput(['Tab'])
-- Keeps scope test-only and aligned to current overlay cycle behavior
-- Confirms Level 17 debug overlay checks no longer validate browser-reserved Tab input
+Align overlay stacks for samples 1709 and 1711 (movement).
+Standardize bottom-right placement and non-Tab cycle behavior.

docs/dev/reports/validation_checklist.txt

@@ -1,5 +1,7 @@
-[ ] Level 17 tests using makeInput(['Tab']) were identified
-[ ] Each affected test now uses the approved non-Tab cycle key
-[ ] No runtime keybinding code was changed
-[ ] Affected Level 17 tests pass
-[ ] No remaining Level 17 overlay cycle tests reference Tab
+[ ] Sample 1709 loads
+[ ] Sample 1711 loads
+[ ] Bottom-right placement correct
+[ ] Cycle key works (non-Tab)
+[ ] Movement Runtime renders
+[ ] Movement Lab HUD renders
+[ ] Stack order correct

docs/pr/BUILD_PR.md

@@ -1,36 +1,23 @@
-# BUILD_PR_LEVEL_17_56_DEBUG_OVERLAY_TEST_INPUT_KEY_REMAP
+# BUILD_PR_LEVEL_17_57_DEBUG_OVERLAY_SAMPLE_1709_1711_MOVEMENT_ALIGNMENT
 
 ## Purpose
-Replace stale Level 17 test inputs that still simulate `Tab` for debug overlay cycling so the automated checks validate the current non-Tab interaction contract.
+Align overlay stacks for samples 1709 and 1711 (movement-focused) with correct order, bottom-right placement, and non-Tab cycle behavior.
 
 ## Scope
-This PR is limited to Level 17 test coverage and test helpers that still encode the old cycle key.
-
-Included:
-- Update Level 17 tests that currently use `makeInput(['Tab'])`
-- Align those tests to the active non-Tab overlay cycle key already established by the runtime-facing PRs
-- Verify no Level 17 debug overlay tests continue to require browser-reserved Tab behavior
-
-Excluded:
-- Runtime keybinding changes
-- Overlay layout changes
-- Sample stack mapping changes
-- Non-Level-17 test cleanup
-
-## Implementation Notes
-- Use the already-approved replacement cycle key from the current Level 17 overlay work
-- Prefer shared test constants/helpers if they already exist; otherwise introduce the smallest local test-safe normalization needed
-- Do not broaden this into a repo-wide input cleanup
-- Do not modify `start_of_day` content
+- Samples: 1709, 1711
+- Stack:
+  - Movement Runtime
+  - Movement Lab HUD
+- Bottom-right anchor
+- Non-Tab cycle key validation
 
 ## Test Steps
-1. Search Level 17 tests for `makeInput(['Tab'])`
-2. Replace each stale input with the approved non-Tab cycle key
-3. Run the affected Level 17 test files
-4. Confirm overlay cycle assertions still pass under the new input
-5. Confirm no remaining Level 17 tests reference `Tab` for overlay cycling
+1. Load samples 1709 and 1711
+2. Verify bottom-right placement
+3. Cycle overlays and confirm order
+4. Confirm Movement Runtime and HUD render correctly
 
-## Expected Result
-- Level 17 tests validate the current non-Tab overlay cycle behavior
-- No stale `makeInput(['Tab'])` calls remain in the affected Level 17 test surface
-- The change stays test-only and does not alter runtime behavior
+## Expected
+- Correct stack order
+- Stable cycling behavior
+- No Tab usage

samples/phase-17/1709/MovementModelsLabScene.js

@@ -14,6 +14,12 @@ import {
   setTabDebugOverlayCycleKey,
   stepTabDebugOverlayController,
 } from '/samples/phase-17/shared/tabDebugOverlayCycle.js';
+import {
+  createMovementOverlayCycleMap,
+  MOVEMENT_DEBUG_CYCLE_KEY,
+  OVERLAY_MOVEMENT_HUD,
+  OVERLAY_MOVEMENT_RUNTIME,
+} from '/samples/phase-17/shared/movementOverlayStack.js';
 import {
   applyPhase16CameraMode,
   createPhase16ViewState,
@@ -38,9 +44,6 @@ const MODE_ORDER = Object.freeze([
   MOVEMENT_MODES.TANK,
   MOVEMENT_MODES.WEIGHTED,
 ]);
-const DEBUG_CYCLE_KEY = 'KeyG';
-const OVERLAY_MOVEMENT_RUNTIME = 'movement-runtime';
-const OVERLAY_MOVEMENT_HUD = 'movement-lab-hud';
 
 function clamp(value, min, max) {
   return Math.max(min, Math.min(max, value));
@@ -98,13 +101,10 @@ export default class MovementModelsLabScene extends Scene {
     this.lastInputSummary = '';
     this.lastSpeed = 0;
     this.tabDebugOverlays = createTabDebugOverlayController({
-      overlays: [
-        { id: OVERLAY_MOVEMENT_RUNTIME, label: 'Movement Runtime' },
-        { id: OVERLAY_MOVEMENT_HUD, label: 'Movement Lab HUD' },
-      ],
+      overlays: createMovementOverlayCycleMap(),
       initialOverlayId: OVERLAY_MOVEMENT_RUNTIME,
     });
-    setTabDebugOverlayCycleKey(this.tabDebugOverlays, DEBUG_CYCLE_KEY);
+    setTabDebugOverlayCycleKey(this.tabDebugOverlays, MOVEMENT_DEBUG_CYCLE_KEY);
   }
 
   setCamera3D(camera3D) {

samples/phase-17/1711/MovementModelsLabScene.js

@@ -14,6 +14,12 @@ import {
   setTabDebugOverlayCycleKey,
   stepTabDebugOverlayController,
 } from '/samples/phase-17/shared/tabDebugOverlayCycle.js';
+import {
+  createMovementOverlayCycleMap,
+  MOVEMENT_DEBUG_CYCLE_KEY,
+  OVERLAY_MOVEMENT_HUD,
+  OVERLAY_MOVEMENT_RUNTIME,
+} from '/samples/phase-17/shared/movementOverlayStack.js';
 import {
   applyPhase16CameraMode,
   createPhase16ViewState,
@@ -38,9 +44,6 @@ const MODE_ORDER = Object.freeze([
   MOVEMENT_MODES.TANK,
   MOVEMENT_MODES.WEIGHTED,
 ]);
-const DEBUG_CYCLE_KEY = 'KeyG';
-const OVERLAY_MOVEMENT_RUNTIME = 'movement-runtime';
-const OVERLAY_MOVEMENT_HUD = 'movement-lab-hud';
 
 function clamp(value, min, max) {
   return Math.max(min, Math.min(max, value));
@@ -98,13 +101,10 @@ export default class MovementModelsLabScene extends Scene {
     this.lastInputSummary = '';
     this.lastSpeed = 0;
     this.tabDebugOverlays = createTabDebugOverlayController({
-      overlays: [
-        { id: OVERLAY_MOVEMENT_RUNTIME, label: 'Movement Runtime' },
-        { id: OVERLAY_MOVEMENT_HUD, label: 'Movement Lab HUD' },
-      ],
+      overlays: createMovementOverlayCycleMap(),
       initialOverlayId: OVERLAY_MOVEMENT_RUNTIME,
     });
-    setTabDebugOverlayCycleKey(this.tabDebugOverlays, DEBUG_CYCLE_KEY);
+    setTabDebugOverlayCycleKey(this.tabDebugOverlays, MOVEMENT_DEBUG_CYCLE_KEY);
   }
 
   setCamera3D(camera3D) {

samples/phase-17/shared/movementOverlayStack.js

@@ -0,0 +1,16 @@
+/*
+Toolbox Aid
+David Quesenberry
+04/16/2026
+movementOverlayStack.js
+*/
+export const MOVEMENT_DEBUG_CYCLE_KEY = 'KeyG';
+export const OVERLAY_MOVEMENT_RUNTIME = 'movement-runtime';
+export const OVERLAY_MOVEMENT_HUD = 'movement-lab-hud';
+
+export function createMovementOverlayCycleMap() {
+  return [
+    { id: OVERLAY_MOVEMENT_RUNTIME, label: 'Movement Runtime' },
+    { id: OVERLAY_MOVEMENT_HUD, label: 'Movement Lab HUD' },
+  ];
+}

tests/runtime/Phase17DebugOverlayBottomRightPosition.test.mjs

@@ -12,7 +12,9 @@ import {
 import DoomRaycastSpritesScene from '../../samples/phase-17/1701/RaycastDemoScene.js';
 import TextureMaterialDemoScene from '../../samples/phase-17/1704/TextureMaterialDemoScene.js';
 import RealGameplayMiniGameScene from '../../samples/phase-17/1708/RealGameplayMiniGameScene.js';
+import MovementModelsLab1709Scene from '../../samples/phase-17/1709/MovementModelsLabScene.js';
 import RealGameplayMiniGame1710Scene from '../../samples/phase-17/1710/RealGameplayMiniGameScene.js';
+import MovementModelsLab1711Scene from '../../samples/phase-17/1711/MovementModelsLabScene.js';
 import GameplayMetricsTelemetryScene from '../../samples/phase-17/1712/GameplayMetricsTelemetryScene.js';
 import FinalReferenceGameScene from '../../samples/phase-17/1713/FinalReferenceGameScene.js';
 
@@ -157,6 +159,38 @@ function assertSample1710CyclePlacement() {
   assertBottomRightFromTitle(runtimeTitle, 300, 120, 650, 410, 'Sample 1710 runtime overlay');
 }
 
+function assertSample1709MovementOverlayPlacement() {
+  const scene = new MovementModelsLab1709Scene();
+  scene.setCamera3D(createCameraStub());
+
+  const runtimeRenderer = createRendererProbe();
+  scene.render(runtimeRenderer);
+  const runtimeTitle = findExactText(runtimeRenderer, 'Movement Runtime');
+  assertBottomRightFromTitle(runtimeTitle, 360, 212, 590, 318, 'Sample 1709 movement runtime overlay');
+
+  pressCycleKey(scene);
+  const hudRenderer = createRendererProbe();
+  scene.render(hudRenderer);
+  const hudTitle = findExactText(hudRenderer, 'Movement Lab HUD');
+  assertBottomRightFromTitle(hudTitle, 360, 138, 590, 392, 'Sample 1709 movement hud overlay');
+}
+
+function assertSample1711MovementOverlayPlacement() {
+  const scene = new MovementModelsLab1711Scene();
+  scene.setCamera3D(createCameraStub());
+
+  const runtimeRenderer = createRendererProbe();
+  scene.render(runtimeRenderer);
+  const runtimeTitle = findExactText(runtimeRenderer, 'Movement Runtime');
+  assertBottomRightFromTitle(runtimeTitle, 360, 212, 590, 318, 'Sample 1711 movement runtime overlay');
+
+  pressCycleKey(scene);
+  const hudRenderer = createRendererProbe();
+  scene.render(hudRenderer);
+  const hudTitle = findExactText(hudRenderer, 'Movement Lab HUD');
+  assertBottomRightFromTitle(hudTitle, 360, 138, 590, 392, 'Sample 1711 movement hud overlay');
+}
+
 function assertSample1712TelemetryPlacement() {
   const scene = new GameplayMetricsTelemetryScene();
   scene.setCamera3D(createCameraStub());
@@ -186,7 +220,9 @@ export function run() {
   assertSample1701RuntimePanelPlacement();
   assertSample1704StackedPanelPlacement();
   assertSample1708CyclePlacement();
+  assertSample1709MovementOverlayPlacement();
   assertSample1710CyclePlacement();
+  assertSample1711MovementOverlayPlacement();
   assertSample1712TelemetryPlacement();
   assertSample1713FinalRuntimePlacement();
 }