feat(infra): auto-commit con 10 cambios

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.claude/commands/e2e-cpp.md

@@ -173,23 +173,39 @@ Si el build falla:
 - "undefined reference to render" → falta quitar `static` o falta el `#ifndef FN_TEST_BUILD` en main.cpp.
 - "multiple definition of main" → falta el `target_compile_definitions(... FN_TEST_BUILD)` en CMakeLists.
 
-### 8. Ejecutar (headless en WSL)
+### 8. Ejecutar (headless preferente — sin parpadeo)
 
-WSL no tiene GLX 4.3 nativo — los tests corren bajo `xvfb` con software renderer Mesa. Wrapper canonico:
+`fn::run_app_test` crea la ventana GLFW **oculta por defecto** (`GLFW_VISIBLE=FALSE`, ver `cpp/framework/app_base.cpp`). El contexto GL real se crea igual, así que el render que ejercita el Test Engine es fiel, pero la ventana nunca se mapea en pantalla: cero parpadeo, no roba foco. Por eso los tests de frontend C++ corren headless por defecto, sin tocar el código de cada app.
+
+Dos formas de lanzar, según el entorno:
 
 ```bash
 cd "$ROOT/cpp/build/linux_tests"
 TEST_BIN="$(find . -name "${APP_ARG}_tests" -type f -executable | head -1)"
 [ -z "$TEST_BIN" ] && { echo "no encuentro el binario de tests"; exit 1; }
 
-timeout 90 xvfb-run -a -s "-screen 0 1280x800x24" \
-    env LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=llvmpipe \
-    "$TEST_BIN" 2>&1
+if [ -n "$DISPLAY" ] && command -v glxinfo >/dev/null 2>&1 \
+   && glxinfo 2>/dev/null | grep -q "OpenGL core profile version"; then
+  # Host con GL nativo (PC enmanuel, X11 + GPU): binario directo.
+  # La ventana ya nace oculta -> sin parpadeo, y usa la GPU real (rapido).
+  timeout 90 "$TEST_BIN" 2>&1
+else
+  # CI / WSL sin GLX 4.3 nativo: display virtual en RAM + software Mesa.
+  timeout 90 xvfb-run -a -s "-screen 0 1280x800x24" \
+      env LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=llvmpipe \
+      "$TEST_BIN" 2>&1
+fi
 EXIT=$?
 echo "EXIT: $EXIT"
 ```
 
-Si en el host el usuario tiene GL nativo y `DISPLAY` funciona, el wrapper xvfb-run sigue siendo seguro (ejecuta dentro de su propio display).
+Ambas vías son headless. `xvfb-run` sigue siendo seguro en host con display (corre en su propio display virtual), así que si el sniff de GL falla puedes usar siempre la rama xvfb.
+
+**Para depurar un test a ojo** (ver la UI mientras el engine la maneja), desactiva el headless con `FN_HEADLESS=0`:
+
+```bash
+FN_HEADLESS=0 timeout 90 "$TEST_BIN" 2>&1
+```
 
 ### 9. Reportar