feat(infra): auto-commit con 29 cambios

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-14 02:06:44 +02:00
parent 47fac22230
commit ca1bf5a59b
29 changed files with 2148 additions and 11 deletions
+1 -1
View File
@@ -7,7 +7,7 @@ version: "1.0.0"
purity: impure
signature: "build_cpp_windows(target?: string) -> void"
description: "Cross-compila las funciones y apps C++ del registry para Windows usando mingw-w64"
tags: [cpp, build, cmake, windows, cross-compile, mingw, imgui]
tags: [cpp, build, cmake, windows, cross-compile, mingw, imgui, cpp-windows]
uses_functions: []
uses_types: []
returns: []
@@ -7,7 +7,7 @@ version: "1.0.0"
purity: impure
signature: "deploy_cpp_exe_to_windows(app_name: string, app_dir: string) -> void"
description: "Copia el .exe de Windows (compilado por build_cpp_windows) y sus assets al escritorio de Windows /mnt/c/Users/lucas/Desktop/apps/<APP>/. Mata el proceso si esta corriendo (taskkill.exe pre-autorizado), copia DLLs, sincroniza assets/ y enrichers/ con rsync, maneja runtime Python embebido si python_runtime: true en app.md, y copia extras gx-cli. Preserva siempre local_files/ (estado del usuario)."
tags: [cpp, deploy, windows, exe, dll, assets, rsync]
tags: [cpp, deploy, windows, exe, dll, assets, rsync, cpp-windows]
uses_functions: []
uses_types: []
returns: []
+1 -1
View File
@@ -3,7 +3,7 @@ name: e2e_run_cpp_windows
lang: bash
domain: infra
description: "Cross-compila una app C++ del registry para Windows con mingw-w64, deploy al Desktop\\apps de Windows (matando instancia previa con taskkill.exe), lanza el .exe nativamente desde WSL y devuelve stdout + exit code. Pensado para tests headless tipo altsnap_jitter_test."
tags: [windows, e2e, cross-compile, test, mingw, pendiente-usar]
tags: [windows, e2e, cross-compile, test, mingw, pendiente-usar, cpp-windows]
purity: impure
kind: function
signature: "e2e_run_cpp_windows(target string, --no-build, --no-deploy) int"
@@ -0,0 +1,70 @@
---
name: is_cpp_app_running_windows
kind: function
lang: bash
domain: infra
version: "1.0.0"
purity: impure
signature: "is_cpp_app_running_windows(app_name: string) -> void"
description: "Comprueba si un ejecutable Windows esta corriendo via tasklist.exe desde WSL2. Exit 0 si el proceso existe, exit 1 si no."
tags: [cpp, windows, monitoring, wsl, tasklist, process, cpp-windows]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/infra/is_cpp_app_running_windows.sh"
params:
- name: app_name
desc: "Nombre del binario sin extension .exe (ej. registry_dashboard). Se le añade .exe internamente para el filtro de tasklist."
output: "Exit 0 con stdout 'RUNNING: PID=<pid> MEM=<mem>' si el proceso existe. Exit 1 con stdout 'NOT_RUNNING: <app_name>' si no. Exit 1 con stderr si tasklist.exe no esta disponible."
---
## Ejemplo
```bash
if is_cpp_app_running_windows "registry_dashboard"; then
echo "Ya esta corriendo"
else
launch_cpp_app_windows "registry_dashboard"
fi
```
Composicion tipica en pipelines de redeploy:
```bash
# Matar antes de copiar si esta vivo
if is_cpp_app_running_windows "$app"; then
taskkill.exe /IM "${app}.exe" /F
fi
deploy_cpp_exe_to_windows "$app" "$app_dir"
launch_cpp_app_windows "$app"
```
## Comportamiento
El exit code es la API principal; stdout es informacion adjunta parseable por el caller:
| Situacion | Exit | Stdout |
|---|---|---|
| Proceso encontrado | 0 | `RUNNING: PID=<n> MEM=<n>K` |
| Proceso no encontrado | 1 | `NOT_RUNNING: <app_name>` |
| `tasklist.exe` no disponible | 1 | (stderr) `ERROR: tasklist.exe no encontrado` |
| `app_name` vacio | 1 | (stderr) `ERROR: uso: ...` |
El formato `RUNNING: PID=N MEM=...K` esta pensado para ser parseado por `cut -d= -f2` si el caller necesita el PID.
## Prerequisitos
- WSL2 con acceso a herramientas Windows (`/mnt/c/Windows/System32/tasklist.exe`).
- El proceso debe haber sido lanzado via `launch_cpp_app_windows` o cualquier otro mecanismo que cree un proceso Windows con el nombre del `.exe`.
## Notas
Util para componer con `launch_cpp_app_windows` y `deploy_cpp_exe_to_windows` en pipelines de redeploy desde WSL2. `deploy_cpp_exe_to_windows` ya incluye un `taskkill.exe` interno antes de copiar, pero esta funcion permite tomar la decision de matar/no matar de forma explicita en el caller.
Tasklist con `/NH /FO CSV` no emite header, por lo que la primera linea de salida con el nombre de imagen es directamente el primer proceso coincidente. Si hay multiples instancias del mismo `.exe`, se informa solo del primero (PID mas bajo en el listado del sistema).
@@ -0,0 +1,45 @@
#!/usr/bin/env bash
# is_cpp_app_running_windows — Comprueba si un .exe de Windows esta corriendo
# via tasklist.exe desde WSL2. Exit 0 si vivo, exit 1 si no.
is_cpp_app_running_windows() {
local app_name="${1:-}"
if [ -z "$app_name" ]; then
echo "ERROR: uso: is_cpp_app_running_windows <app_name>" >&2
return 1
fi
# Verificar que tasklist.exe esta disponible
if ! command -v tasklist.exe >/dev/null 2>&1; then
echo "ERROR: tasklist.exe no encontrado (requiere WSL2 con acceso a Windows tools)" >&2
return 1
fi
# /NH: sin header, /FO CSV: salida CSV, /FI: filtro por imagen
local output
output=$(tasklist.exe /FI "IMAGENAME eq ${app_name}.exe" /NH /FO CSV 2>/dev/null)
# tasklist.exe devuelve "INFO: No tasks..." cuando no hay coincidencia.
# Con CSV+NH, cada proceso encontrado produce: "imagen.exe","pid","tipo","sesion","mem"
if echo "$output" | grep -qi "\"${app_name}.exe\""; then
# Extraer PID y memoria de la primera linea que coincida
local line
line=$(echo "$output" | grep -i "\"${app_name}.exe\"" | head -n1)
# Campos CSV: "imagen","PID","tipo","sesion","MEM K"
local pid mem
pid=$(echo "$line" | cut -d',' -f2 | tr -d '"')
mem=$(echo "$line" | cut -d',' -f5 | tr -d '"' | tr -d ' ')
echo "RUNNING: PID=${pid} MEM=${mem}"
return 0
else
echo "NOT_RUNNING: ${app_name}"
return 1
fi
}
if [ "${BASH_SOURCE[0]}" = "$0" ]; then
is_cpp_app_running_windows "$@"
fi
@@ -0,0 +1,70 @@
---
name: launch_cpp_app_windows
kind: function
lang: bash
domain: infra
version: "1.0.0"
purity: impure
signature: "launch_cpp_app_windows(app_name: string, [desktop_dir: string]) -> void"
description: "Lanza un binario .exe en Windows desde WSL2. Asume que deploy_cpp_exe_to_windows ya copió el exe a Desktop/apps/<app_name>/. Usa cmd.exe /c start para desacoplar el proceso y retornar inmediatamente."
tags: [cpp, windows, launch, wsl, exe, cpp-windows]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/infra/launch_cpp_app_windows.sh"
params:
- name: app_name
desc: "Nombre de la app (ej: registry_dashboard). Localiza Desktop/apps/<app_name>/<app_name>.exe."
- name: desktop_dir
desc: "Override opcional del directorio escritorio Windows. Default: /mnt/c/Users/lucas/Desktop."
output: "Imprime 'OK: <app_name> launched at <ts>' en stdout si el exe existe y el comando se lanza. Errores fatales a stderr con exit 1."
---
## Ejemplo
```bash
source bash/functions/infra/launch_cpp_app_windows.sh
# Lanzar con default desktop dir
launch_cpp_app_windows "registry_dashboard"
# OK: registry_dashboard launched at 2026-05-14T10:32:01
# Override de desktop_dir (ej. otro usuario)
launch_cpp_app_windows "chart_demo" "/mnt/c/Users/otrouser/Desktop"
# OK: chart_demo launched at 2026-05-14T10:32:05
```
## Comportamiento
`cmd.exe /c start` es la clave: lanza el proceso en Windows y **retorna inmediatamente** sin esperar a que el exe termine. El proceso queda desacoplado del shell WSL2. Esta funcion **no verifica** que el exe arranco correctamente ni que sigue corriendo — esa responsabilidad recae en `is_cpp_app_running_windows` (funcion complementaria).
El `cd /d` previo al `start` es esencial: los apps C++ del registry buscan sus assets, `local_files/` y DLLs relativos al directorio de trabajo. Sin el `cd`, Windows buscaria desde `C:\Windows\System32` y el exe no encontraria nada.
## Prerequisitos
- **WSL2**: la funcion usa `wslpath -w` y `cmd.exe`, ambos solo disponibles en WSL2.
- **`/mnt/c/` montado**: el exe debe ser accesible via la ruta `/mnt/c/...`.
- **Exe ya copiado**: `deploy_cpp_exe_to_windows` debe haberse ejecutado antes. Esta funcion no compila ni copia nada.
## Notes
Mitad complementaria de `deploy_cpp_exe_to_windows_bash_infra`. El flujo completo para actualizar y relanzar una app es:
```bash
# 1. Compilar para Windows
build_cpp_windows "registry_dashboard"
# 2. Copiar al escritorio (mata proceso si corre, copia DLLs+assets)
deploy_cpp_exe_to_windows "registry_dashboard" "/home/lucas/fn_registry/apps/registry_dashboard"
# 3. Lanzar
launch_cpp_app_windows "registry_dashboard"
```
No se incluyen tests automatizados porque requieren entorno WSL2 con Windows activo y no son automatizables en CI.
@@ -0,0 +1,42 @@
#!/usr/bin/env bash
# launch_cpp_app_windows — Lanza un .exe en Windows desde WSL2 via cmd.exe /c start.
# Asume que el exe ya fue copiado por deploy_cpp_exe_to_windows al escritorio.
launch_cpp_app_windows() {
local app="${1:-}"
local desktop_dir="${2:-/mnt/c/Users/lucas/Desktop}"
if [ -z "$app" ]; then
echo "ERROR: uso: launch_cpp_app_windows <app_name> [desktop_dir]" >&2
return 1
fi
local exe_path="$desktop_dir/apps/$app/$app.exe"
if [ ! -f "$exe_path" ]; then
echo "ERROR: exe no encontrado: $exe_path" >&2
echo "Copia primero con: deploy_cpp_exe_to_windows $app <app_dir>" >&2
return 1
fi
# Usamos PowerShell en vez de cmd.exe — los backslashes de paths Windows
# no rompen el escaping aqui (cmd.exe `\"` interpreta como escape de
# comilla y deja el string sin cerrar; PowerShell single-quote es literal).
local win_app_dir win_exe
win_app_dir=$(wslpath -w "$desktop_dir/apps/$app")
win_exe="$win_app_dir\\$app.exe"
# Start-Process detacha (equivale a `start` de cmd) y respeta -WorkingDirectory.
# Las comillas simples en PowerShell son literales — no procesa \ ni $.
powershell.exe -NoProfile -Command \
"Start-Process -FilePath '$win_exe' -WorkingDirectory '$win_app_dir'" \
>/dev/null 2>&1
local ts
ts=$(date '+%Y-%m-%dT%H:%M:%S')
echo "OK: $app launched at $ts"
}
if [ "${BASH_SOURCE[0]}" = "$0" ]; then
launch_cpp_app_windows "$@"
fi