Align sample 1713 overlay stack to Final Reference Runtime.

Enforce bottom-right placement and remove Tab key usage.

Author: ToolboxAid

docs/dev/CODEX_COMMANDS.md

@@ -1,26 +1,9 @@
-MODEL: GPT-5.4
-REASONING: high
-
+MODEL: GPT-5.3-codex
+REASONING: medium
 COMMAND:
-Implement BUILD_PR_LEVEL_17_52_DEBUG_OVERLAY_CYCLE_KEY_AND_SAMPLE_STACK_MAP as a small, testable PR.
-
-Requirements:
-- Remove Tab as the overlay-cycle key in the touched phase-17 samples.
-- Introduce one consistent non-browser-reserved replacement key across the touched samples.
-- Keep all touched debug panels bottom-right anchored.
-- Enforce the exact sample-specific cycle maps:
-  - 1708, 1710: UI Layer -> Mission Feed -> existing title ending in ADY -> Mini-Game Runtime
-  - 1709, 1711: Movement Runtime -> Movement Lab HUD
-  - 1712: UI Layer -> Mission Feed -> existing title ending in ADY -> Telemetry Overlay
-  - 1713: UI Layer -> Mission Feed -> existing title ending in ADY -> Final Reference Runtime
-- Keep the ADY-ending title as-is unless already incorrect for another reason.
-- Update/add runtime tests so they verify the replacement key, reject Tab behavior, verify panel presence/order, and confirm bottom-right placement.
-
-Constraints:
-- Smallest scoped valid change only.
-- Do not modify start_of_day folders.
-- Do not do repo-wide scanning.
-- Keep implementation one-pass executable.
-
-Package the resulting repo-structured ZIP to:
-<project folder>/tmp/BUILD_PR_LEVEL_17_52_DEBUG_OVERLAY_CYCLE_KEY_AND_SAMPLE_STACK_MAP.zip
+Implement overlay stack mapping for sample 1713 using existing overlay system.
+- Enforce bottom-right anchor
+- Remove any Tab bindings
+- Ensure cycle key matches prior PR (17_52)
+- Validate ordering and rendering
+Package output ZIP to <project folder>/tmp/

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1,2 @@
-BUILD_PR_LEVEL_17_52: replace Tab-based debug overlay cycling in touched phase-17 samples and lock bottom-right sample-specific overlay stack maps for 1708-1713 with runtime coverage
+Align sample 1713 overlay stack to Final Reference Runtime.
+Enforce bottom-right placement and remove Tab key usage.

docs/dev/reports/validation_checklist.txt

@@ -1,10 +1,4 @@
-[ ] Runtime tests pass.
-[ ] Tab no longer advances overlay cycling in touched phase-17 samples.
-[ ] Replacement key advances overlay cycling in touched phase-17 samples.
-[ ] Sample 1708 panel cycle set matches: UI Layer, Mission Feed, *ADY, Mini-Game Runtime.
-[ ] Sample 1710 panel cycle set matches: UI Layer, Mission Feed, *ADY, Mini-Game Runtime.
-[ ] Sample 1709 panel cycle set matches: Movement Runtime, Movement Lab HUD.
-[ ] Sample 1711 panel cycle set matches: Movement Runtime, Movement Lab HUD.
-[ ] Sample 1712 panel cycle set matches: UI Layer, Mission Feed, *ADY, Telemetry Overlay.
-[ ] Sample 1713 panel cycle set matches: UI Layer, Mission Feed, *ADY, Final Reference Runtime.
-[ ] Touched overlay titles render in the bottom-right stack region.
+[ ] Sample 1713 loads
+[ ] Bottom-right overlay placement correct
+[ ] Cycle key works (non-Tab)
+[ ] Stack order matches spec

docs/pr/BUILD_PR.md

@@ -0,0 +1,24 @@
+# BUILD_PR_LEVEL_17_53_DEBUG_OVERLAY_SAMPLE_1713_FINAL_REFERENCE_ALIGNMENT
+
+## Purpose
+Align Sample 1713 overlay stack to Final Reference Runtime and validate bottom-right positioning + cycle behavior (non-Tab key).
+
+## Scope
+- Sample 1713 overlay stack:
+  - UI Layer
+  - Mission Feed
+  - <...ADY>
+  - Final Reference Runtime
+- Bottom-right anchor enforcement
+- Cycle key (non-Tab) verification
+
+## Test Steps
+1. Load sample 1713
+2. Verify overlays render bottom-right
+3. Press cycle key → confirm correct order
+4. Confirm no Tab usage
+
+## Expected
+- Correct stack order
+- No overlay overlap issues
+- Stable cycling behavior

tests/runtime/Phase17DebugOverlayBottomRightPosition.test.mjs

@@ -13,6 +13,7 @@ import DoomRaycastSpritesScene from '../../samples/phase-17/1701/RaycastDemoScen
 import TextureMaterialDemoScene from '../../samples/phase-17/1704/TextureMaterialDemoScene.js';
 import RealGameplayMiniGameScene from '../../samples/phase-17/1708/RealGameplayMiniGameScene.js';
 import GameplayMetricsTelemetryScene from '../../samples/phase-17/1712/GameplayMetricsTelemetryScene.js';
+import FinalReferenceGameScene from '../../samples/phase-17/1713/FinalReferenceGameScene.js';
 
 function createCameraStub() {
   const state = {
@@ -156,10 +157,23 @@ function assertSample1712TelemetryPlacement() {
   assertBottomRightFromTitle(telemetryTitle, 228, 244, 722, 286, 'Sample 1712 telemetry overlay');
 }
 
+function assertSample1713FinalRuntimePlacement() {
+  const scene = new FinalReferenceGameScene();
+  scene.setCamera3D(createCameraStub());
+  pressCycleKey(scene);
+  pressCycleKey(scene);
+  pressCycleKey(scene);
+  const renderer = createRendererProbe();
+  scene.render(renderer);
+  const runtimeTitle = findExactText(renderer, 'Final Reference Runtime');
+  assertBottomRightFromTitle(runtimeTitle, 228, 248, 722, 282, 'Sample 1713 final runtime overlay');
+}
+
 export function run() {
   assertSharedStackMath();
   assertSample1701RuntimePanelPlacement();
   assertSample1704StackedPanelPlacement();
   assertSample1708CyclePlacement();
   assertSample1712TelemetryPlacement();
+  assertSample1713FinalRuntimePlacement();
 }