Implement real gameplay sample demonstrating full engine integration including rendering, input, camera, and debug systems.

PR: BUILD_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,3 +1,3 @@
 MODEL: GPT-5.3-codex
 REASONING: high
-COMMAND: Implement real gameplay sample using existing engine systems and package to <project folder>/tmp/PLAN_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE.zip
+COMMAND: Build full mini-game sample using existing engine systems and package to <project folder>/tmp/BUILD_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1,3 +1,3 @@
-Add real gameplay sample demonstrating full engine integration (rendering, input, camera, debug)
+Implement real gameplay sample demonstrating full engine integration including rendering, input, camera, and debug systems.
 
-PR: PLAN_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE
+PR: BUILD_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE

docs/dev/reports/validation_checklist.txt

@@ -1,4 +1,5 @@
-- [ ] sample runs
-- [ ] input works
+- [ ] game runs
+- [ ] player movement works
 - [ ] camera follows
-- [ ] debug panels visible
+- [ ] scoring/objective works
+- [ ] debug panels active

docs/pr/BUILD_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE.md

@@ -0,0 +1,38 @@
+# BUILD_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE
+
+## Purpose
+Build one real, playable Level 17 mini-game sample using existing engine systems only.
+
+## Source of Truth
+- `docs/pr/PLAN_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE.md`
+- `docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md` (`## 17. 3D Activation, Validation, and Execution (Phase 16)`)
+
+## Exact Build Target
+1. Add new sample `samples/phase-17/1708/` with:
+   - `index.html`
+   - `main.js`
+   - one scene file implementing a complete mini-game loop
+2. Integrate sample `1708` into `samples/index.html`.
+3. Implement gameplay using existing engine systems only:
+   - rendering, input, scene/camera, and existing debug providers/panels
+   - player movement in bounded 3D space
+   - obstacle/enemy interaction
+   - objective/score and end-state messaging
+   - camera follow readability
+4. Add targeted runtime validation for sample `1708` behavior and launcher link.
+
+## Non-Goals
+- no engine-core feature additions
+- no new generic debug framework features
+- no additional Level 17 samples beyond `1708`
+- no roadmap status updates
+
+## Validation
+- sample `1708` link exists in `samples/index.html`
+- sample scene updates/render path execute without runtime errors in targeted test
+- gameplay loop is verifiably complete (movement + interaction + objective/end-state)
+- debug panel/provider integration emits visible panel lines
+
+## Packaging Rule
+Package only this PR's created/modified files into:
+`tmp/BUILD_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE.zip`

samples/index.html

@@ -508,6 +508,7 @@ <h2>Phase 17 - Rendering Technique Expansion</h2>
         <a class="live" href="./phase-17/1705/index.html" title="Unreal-style skinned character presentation with image-backed animation frames." data-tags="camera3d, unreal-style, image-skinned, animation, character, scene, themetokens" data-primary="unreal-skinned-mesh">Sample 1705 - Unreal Skinned Mesh Demo</a>
         <a class="live" href="./phase-17/1706/index.html" title="Minecraft-style filled voxel terrain blocks with visible height variation." data-tags="camera3d, minecraft-style, voxel, terrain, filled-render, scene, themetokens" data-primary="minecraft-voxel-terrain">Sample 1706 - Minecraft Voxel Terrain</a>
         <a class="live" href="./phase-17/1707/index.html" title="Minecraft-style voxel chunk-window streaming around a movable camera anchor." data-tags="camera3d, minecraft-style, voxel, chunk-streaming, filled-render, scene, themetokens" data-primary="minecraft-chunk-streaming">Sample 1707 - Minecraft Chunk Streaming</a>
+        <a class="live" href="./phase-17/1708/index.html" title="Real 3D mini-game loop with movement, hazard interaction, objective scoring, camera follow, and standard 3D debug panels." data-tags="camera3d, gameplay, objective, hazards, debug-panels, scene, themetokens" data-primary="real-gameplay-mini-game">Sample 1708 - Real Gameplay Mini-Game</a>
       </div>
     </section>
     <section>