feat(infra): auto-commit con 10 cambios

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

cpp/framework/app_base.cpp

@@ -23,6 +23,7 @@
 #include <atomic>
 #include <cmath>
 #include <cstdio>
+#include <cstdlib>
 #include <cstring>
 #include <filesystem>
 #include <string>
@@ -647,6 +648,25 @@ static void draw_header_badge_on_floating_panels(const AppConfig& cfg) {
     }
 }
 
+// Resuelve si la ventana GLFW debe crearse oculta (GLFW_VISIBLE=FALSE).
+//   default_hidden : politica base del path de entrada (apps reales = false,
+//                    tests de UI = true).
+//   config_headless: AppConfig.headless explicito de la app.
+// El entorno FN_HEADLESS gana sobre ambos: "0"/"false" fuerza visible,
+// cualquier otro valor no vacio fuerza oculta. Sin la variable, se respeta
+// default_hidden || config_headless.
+static bool resolve_headless(bool default_hidden, bool config_headless) {
+    bool hidden = default_hidden || config_headless;
+    if (const char* e = std::getenv("FN_HEADLESS")) {
+        if (std::strcmp(e, "0") == 0 || std::strcmp(e, "false") == 0) {
+            hidden = false;
+        } else if (e[0] != '\0') {
+            hidden = true;
+        }
+    }
+    return hidden;
+}
+
 int run_app(AppConfig config, std::function<void()> render_fn) {
     // Logger primero para capturar fallos del propio init (GLFW, ventana, GL).
     if (config.log.file_path != nullptr) {
@@ -672,6 +692,11 @@ int run_app(AppConfig config, std::function<void()> render_fn) {
     glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);
     glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);
 
+    // Apps reales: ventana visible por defecto. Solo se oculta si la app pide
+    // headless o el entorno FN_HEADLESS lo fuerza (smoke/capture sin parpadeo).
+    const bool hidden = resolve_headless(/*default_hidden=*/false, config.headless);
+    glfwWindowHint(GLFW_VISIBLE, hidden ? GLFW_FALSE : GLFW_TRUE);
+
     GLFWwindow* window = glfwCreateWindow(config.width, config.height, config.title, nullptr, nullptr);
     if (!window) {
         fprintf(stderr, "Failed to create GLFW window\n");
@@ -1178,6 +1203,13 @@ int run_app_test(AppConfig config,
     glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);
     glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);
 
+    // Tests de frontend: ventana OCULTA por defecto (headless) para no parpadear
+    // en la pantalla del desarrollador ni robar foco mientras el Test Engine
+    // ejercita la UI. El contexto GL real se crea igual, asi que el render sigue
+    // siendo fiel. Opt-out para depurar visualmente: FN_HEADLESS=0.
+    const bool hidden = resolve_headless(/*default_hidden=*/true, config.headless);
+    glfwWindowHint(GLFW_VISIBLE, hidden ? GLFW_FALSE : GLFW_TRUE);
+
     GLFWwindow* window = glfwCreateWindow(
         config.width, config.height,
         config.title ? config.title : "fn_test", nullptr, nullptr);