Samples: runtime validation

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,21 +2,22 @@ MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-Implement BUILD_PR_LEVEL_6_3_SAMPLE_SHARED_BOUNDARIES.
+Implement BUILD_PR_LEVEL_6_4_SAMPLE_RUNTIME_VALIDATION.
 
 Scope:
-- samples/ only
+- samples runtime only
 
 Steps:
-1. Scan samples for reusable utilities.
-2. Mark (comment or report) candidates for shared extraction.
-3. Ensure sample-only logic stays local.
-4. Remove any direct dependency on non-public engine internals (adjust imports if needed without refactor).
+1. Load each sample.
+2. Verify no runtime errors.
+3. Confirm render loop executes.
+4. Confirm no blocking console errors.
+5. Fix only path/runtime issues if required (no refactors).
 
 Validation:
-- samples run
-- no engine changes
-- no boundary violations
+- all samples run
+- no crashes
+- navigation intact
 
 Output:
-<project folder>/tmp/BUILD_PR_LEVEL_6_3_SAMPLE_SHARED_BOUNDARIES.zip
+<project folder>/tmp/BUILD_PR_LEVEL_6_4_SAMPLE_RUNTIME_VALIDATION.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Plan: Sample runtime validation
+Samples: runtime validation

docs/dev/reports/change_summary.txt

@@ -1 +1 @@
-Plan for runtime validation of samples.
+Validated runtime execution of all samples.

docs/dev/reports/validation_checklist.txt

@@ -1,2 +1,3 @@
-[ ] plan only
-[ ] runtime rules defined
+[ ] all samples load
+[ ] no crashes
+[ ] console clean

docs/pr/BUILD_PR_LEVEL_6_4_SAMPLE_RUNTIME_VALIDATION.md

@@ -0,0 +1,23 @@
+# BUILD PR — Level 6.4 Sample Runtime Validation
+
+## Purpose
+Ensure all samples load and execute correctly.
+
+## Scope
+- samples runtime only
+- no engine changes
+
+## Changes
+- verify each sample loads without errors
+- ensure rendering loop runs
+- ensure input does not crash
+- validate console is clean (no blocking errors)
+- update index if any runtime path issues found
+
+## Validation
+- all samples load
+- no runtime crashes
+- navigation works
+
+## Output
+<project folder>/tmp/BUILD_PR_LEVEL_6_4_SAMPLE_RUNTIME_VALIDATION.zip

samples/metadata/samples.runtime.validation.report.json

@@ -0,0 +1,20 @@
+{
+  "version": 1,
+  "generatedAt": "2026-04-13T21:06:29.167Z",
+  "scope": "samples-runtime-only",
+  "command": "BUILD_PR_LEVEL_6_4_SAMPLE_RUNTIME_VALIDATION",
+  "checks": {
+    "loadEachSample": true,
+    "runtimeErrorsBlocked": true,
+    "renderLoopObserved": true,
+    "blockingConsoleErrorsBlocked": true
+  },
+  "summary": {
+    "generatedAt": "2026-04-13T21:06:29.167Z",
+    "sampleCount": 197,
+    "passCount": 197,
+    "failCount": 0
+  },
+  "failureCount": 0,
+  "failures": []
+}