feat(infra): auto-commit con 29 cambios

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 02:06:44 +02:00
parent 47fac22230
commit ca1bf5a59b
29 changed files with 2148 additions and 11 deletions
@@ -0,0 +1,80 @@
+# cpp-windows
+
+Operar apps C++ del registry en Windows desde WSL2: compilar, desplegar, lanzar, verificar y relanzar.
+
+## Funciones del grupo
+
+| ID | Firma corta | Que hace |
+|---|---|---|
+| `build_cpp_windows_bash_infra` | `build_cpp_windows([target])` | Cross-compila apps C++ para Windows con mingw-w64 |
+| `deploy_cpp_exe_to_windows_bash_infra` | `deploy_cpp_exe_to_windows(app_name, app_dir)` | Copia .exe + DLLs + assets al Desktop Windows, mata proceso previo |
+| `launch_cpp_app_windows_bash_infra` | `launch_cpp_app_windows(app_name, [desktop_dir])` | Lanza .exe en Windows via cmd.exe /c start, retorna inmediatamente |
+| `is_cpp_app_running_windows_bash_infra` | `is_cpp_app_running_windows(app_name)` | Exit 0 si el proceso esta vivo (tasklist.exe), stdout: `RUNNING: PID=N MEM=...K` |
+| `launch_cpp_app_windows_bash_infra` | `launch_cpp_app_windows(app_name, [desktop_dir])` | Lanza .exe en Windows via cmd.exe /c start, retorna inmediatamente |
+| `e2e_run_cpp_windows_bash_infra` | `e2e_run_cpp_windows(target, [--no-build], [--no-deploy])` | Build + deploy + run headless de app C++ (tests e2e tipo altsnap) |
+| `redeploy_cpp_app_windows_bash_pipelines` | `redeploy_cpp_app_windows(app_name, app_dir, [--build])` | Pipeline completo: build? + deploy + launch + verify en un comando |
+
+## Ejemplo canonico
+
+### Redeploy rapido (build ya hecho)
+
+```bash
+source bash/functions/infra/deploy_cpp_exe_to_windows.sh
+source bash/functions/infra/launch_cpp_app_windows.sh
+source bash/functions/infra/is_cpp_app_running_windows.sh
+
+deploy_cpp_exe_to_windows "registry_dashboard" \
+    "/home/lucas/fn_registry/projects/fn_monitoring/apps/registry_dashboard"
+launch_cpp_app_windows "registry_dashboard"
+sleep 1
+if is_cpp_app_running_windows "registry_dashboard"; then
+    echo "OK: arrancado"
+else
+    echo "ERROR: no arranco" >&2; exit 1
+fi
+```
+
+### Via pipeline (un solo comando)
+
+```bash
+source bash/functions/pipelines/redeploy_cpp_app_windows.sh
+
+# Sin recompilar
+redeploy_cpp_app_windows "registry_dashboard" \
+    "/home/lucas/fn_registry/projects/fn_monitoring/apps/registry_dashboard"
+
+# Con recompilacion previa
+redeploy_cpp_app_windows "chart_demo" \
+    "/home/lucas/fn_registry/cpp/apps/chart_demo" --build
+```
+
+### Comprobar si esta vivo antes de decidir
+
+```bash
+source bash/functions/infra/is_cpp_app_running_windows.sh
+
+if is_cpp_app_running_windows "registry_dashboard"; then
+    echo "Ya esta corriendo — skip launch"
+else
+    launch_cpp_app_windows "registry_dashboard"
+fi
+```
+
+## Fronteras
+
+- No gestiona builds Linux ni assets de Linux — solo el flujo Windows.
+- No verifica que la app funcione correctamente, solo que el proceso existe (`tasklist.exe`).
+- No gestiona credenciales ni configuracion de la app — eso es responsabilidad de cada app via `local_files/`.
+- Tests automatizados en CI no son posibles — requieren WSL2 con Windows activo.
+
+## Prerequisitos
+
+- WSL2 con interop a Windows habilitado (`tasklist.exe`, `cmd.exe`, `wslpath` accesibles).
+- `mingw-w64` instalado en WSL para `build_cpp_windows` (`sudo apt install mingw-w64`).
+- El .exe compilado en `cpp/build/windows/apps/<app>/` antes de `deploy_cpp_exe_to_windows`.
+
+## Notas
+
+El flujo estandar es: `build_cpp_windows` → `deploy_cpp_exe_to_windows` → `launch_cpp_app_windows` → `is_cpp_app_running_windows`. El pipeline `redeploy_cpp_app_windows` encapsula los pasos 2-4 (con 1 opcional via `--build`).
+
+`deploy_cpp_exe_to_windows` ya incluye un `taskkill.exe` interno — no es necesario matar el proceso manualmente antes de llamarlo. `is_cpp_app_running_windows` es util cuando se quiere tomar la decision de matar/no matar de forma explicita antes del deploy.