stackhelx 1.1.2__tar.gz → 1.1.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. {stackhelx-1.1.2 → stackhelx-1.1.4}/CHANGELOG.md +29 -0
  2. {stackhelx-1.1.2 → stackhelx-1.1.4}/PKG-INFO +14 -12
  3. {stackhelx-1.1.2 → stackhelx-1.1.4}/README.es.md +10 -9
  4. {stackhelx-1.1.2 → stackhelx-1.1.4}/README.md +13 -11
  5. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/deteccion.md +17 -0
  6. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/comandos.md +5 -5
  7. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/deteccion.md +17 -1
  8. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/interfaz.md +22 -3
  9. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/stack-yaml.md +4 -4
  10. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/interfaz.md +29 -12
  11. stackhelx-1.1.4/stackhelx/__init__.py +2 -0
  12. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/cli.py +228 -290
  13. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/docker.py +31 -0
  14. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/ports.py +55 -24
  15. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/registry.py +49 -1
  16. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/runner.py +30 -1
  17. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/server.py +103 -14
  18. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/web/app.css +178 -48
  19. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/web/app.js +738 -419
  20. stackhelx-1.1.4/stackhelx/web/index.html +579 -0
  21. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/web/tokens.css +0 -1
  22. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/conftest.py +10 -1
  23. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_cli.py +19 -19
  24. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_ports.py +63 -0
  25. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_registry.py +68 -0
  26. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_runner.py +30 -0
  27. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_server.py +143 -1
  28. {stackhelx-1.1.2 → stackhelx-1.1.4}/uv.lock +59 -33
  29. stackhelx-1.1.2/stackhelx/__init__.py +0 -2
  30. stackhelx-1.1.2/stackhelx/web/index.html +0 -415
  31. {stackhelx-1.1.2 → stackhelx-1.1.4}/.github/workflows/ci.yml +0 -0
  32. {stackhelx-1.1.2 → stackhelx-1.1.4}/.github/workflows/release.yml +0 -0
  33. {stackhelx-1.1.2 → stackhelx-1.1.4}/.gitignore +0 -0
  34. {stackhelx-1.1.2 → stackhelx-1.1.4}/AGENTS.md +0 -0
  35. {stackhelx-1.1.2 → stackhelx-1.1.4}/CLAUDE.md +0 -0
  36. {stackhelx-1.1.2 → stackhelx-1.1.4}/LICENSE +0 -0
  37. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/comandos.md +0 -0
  38. {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/stack-yaml.md +0 -0
  39. {stackhelx-1.1.2 → stackhelx-1.1.4}/pyproject.toml +0 -0
  40. {stackhelx-1.1.2 → stackhelx-1.1.4}/scripts/check_docs.py +0 -0
  41. {stackhelx-1.1.2 → stackhelx-1.1.4}/scripts/check_metadata.py +0 -0
  42. {stackhelx-1.1.2 → stackhelx-1.1.4}/stack.example.yaml +0 -0
  43. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/__main__.py +0 -0
  44. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/browse.py +0 -0
  45. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/config.py +0 -0
  46. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/detect.py +0 -0
  47. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/doctor.py +0 -0
  48. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/guardrails.py +0 -0
  49. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/history.py +0 -0
  50. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/mcp.py +0 -0
  51. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/scripts.py +0 -0
  52. {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/tunnel.py +0 -0
  53. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_browse.py +0 -0
  54. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_config.py +0 -0
  55. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_conftest.py +0 -0
  56. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_detect.py +0 -0
  57. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_guardrails.py +0 -0
  58. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_history.py +0 -0
  59. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_mcp.py +0 -0
  60. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_scripts.py +0 -0
  61. {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_tunnel.py +0 -0
@@ -4,6 +4,35 @@ Formato de [Keep a Changelog](https://keepachangelog.com/es/1.1.0/).
4
4
  Versionado semántico: la superficie pública son los comandos del CLI, el
5
5
  esquema de `stack.yaml` y las rutas de la API local.
6
6
 
7
+ ## [1.1.4] - 2026-10-31
8
+
9
+ ### Corregido
10
+
11
+ - **Servidores arrancados fuera de StackHelx (`registry.py`, `server.py`):** un `astro dev` corriendo desde otra terminal no aparecía en la tarjeta ni en la pestaña "De proyectos", porque `detect` no adivina puertos y `ready: listen` solo los descubre en el árbol propio. Ahora se atribuyen al proyecto por la ruta en la línea de comandos, o por la carpeta de trabajo si el proceso es un intérprete. Un proyecto con un solo servicio sin puerto lo muestra listo y `externo`; con más, lista los puertos sin adivinar el servicio (`external_ports`).
12
+ - **Un contenedor ajeno ponía listo al servicio (`docker.py`, `server.py`):** el `postgres` de un proyecto salía listo y Apagar no hacía nada porque el 5432 lo publicaba un contenedor suelto de otro proyecto. Un servicio con contenedor solo sale listo si `docker ps` dice que el contenedor es de su compose.
13
+ - **Puertos declarados (`registry.py`):** `declared_ports` miraba solo el perfil por defecto y los intrusos todos los servicios, así que un puerto salía declarado en un lado y no en el otro. Ahora cuentan todos los servicios.
14
+ - El aviso de token inválido sale en el idioma de la interfaz; el favicon se pone verde con proyectos externos; la pastilla live de los logs y el punto listo del grafo vuelven a tener color.
15
+ - **Astro 7 se desacoplaba bajo un agente (`runner.py`):** `astro dev` detecta agentes por variables de entorno (`am-i-vibing`) y se va a segundo plano: `up` terminaba con 0 y el servidor quedaba fuera del árbol. `build_env` ya no pasa esas variables a los servicios, salvo que las declare `env.global` o el `env` del servicio.
16
+
17
+ ### Añadido
18
+
19
+ - **Vista global de puertos real (`ports.py`, `/api/ports/system`, `web/`):** un registro por protocolo, puerto y proceso (antes uno por puerto), con dirección de escucha, carpeta del proceso y proyecto atribuido. UDP opcional con `?udp=1`. El mapa abre en "Todo el sistema" con filtro, "Ocultar procesos de Windows", "Incluir UDP" y "Refrescar"; sigue siendo a pedido, sin sondeo.
20
+ - El mapa muestra el error y un botón Reintentar en vez de quedar en silencio cuando falla la lectura.
21
+ - **Acceso al mapa de puertos:** botón "Puertos" en el encabezado y "Mapa completo →" en la sección de procesos intrusos.
22
+
23
+ ### Cambiado
24
+
25
+ - **Tipografía por roles (`web/`):** serif para nombrar, sans para leer (estados y controles incluidos) y monoespaciada solo para datos que se copian o comparan. Dos pesos y seis tamaños.
26
+ - Español neutro (tuteo) en la interfaz, `README.es.md` y `docs/es/`.
27
+
28
+ ## [1.1.3] - 2026-10-09
29
+
30
+ ### Añadido y Mejorado
31
+
32
+ - **Selector de idioma en vivo (EN / ES) en la interfaz Web (`index.html`, `app.css`, `app.js`):** Botón selector accesible en el encabezado (`#btn-lang`) que conmuta toda la interfaz web en tiempo real sin recargar la página. Arranca en inglés por defecto y persiste la preferencia en `localStorage` (`stackhelx.lang`).
33
+ - **CLI internacionalizado a Inglés (`cli.py`):** Todos los comandos, ayudas (`shx --help`, `stackhelx <cmd> --help`), encabezados de tablas, confirmaciones y mensajes del CLI pasan a inglés.
34
+ - **Documentación y pruebas actualizadas (`README.md`, `README.es.md`, `docs/`, `tests/`):** Ejemplos de consola y referencias de interfaz actualizadas, aserciones del CLI en inglés y nueva prueba para el selector de idioma web (482/482 pruebas pasando al 100%).
35
+
7
36
  ## [1.1.2] - 2026-10-06
8
37
 
9
38
  ### Añadido y Mejorado
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: stackhelx
3
- Version: 1.1.2
3
+ Version: 1.1.4
4
4
  Summary: Local development environment orchestrator: ports, Docker, backend, and frontend with a single command
5
5
  Project-URL: Homepage, https://github.com/TicoraX/StackHelx
6
6
  Project-URL: Repository, https://github.com/TicoraX/StackHelx
@@ -171,12 +171,12 @@ root:
171
171
  | `package.json` with a server script (`dev`, `start:dev`, `serve`, `start`) | `npm run dev`, switching to `pnpm`/`yarn`/`bun` based on lockfile or `packageManager` |
172
172
 
173
173
  ```
174
- mi-app A:\Proyectos\mi-app
175
- Sin stack.yaml. Detectado:
174
+ my-app A:\Proyectos\my-app
175
+ No stack.yaml. Detected:
176
176
  docker docker compose up -d 5433
177
- web pnpm run dev al arrancar
178
- Para congelarlo en un archivo editable: stackhelx init
179
- Arrancar? [Y/n]
177
+ web pnpm run dev on start
178
+ To freeze into an editable file: stackhelx init
179
+ Start? [Y/n]
180
180
  ```
181
181
 
182
182
  Services start in that order and chain dependencies automatically: frontend
@@ -234,7 +234,9 @@ stackhelx serve # opens http://127.0.0.1:7666
234
234
  ```
235
235
 
236
236
  Included out of the box with no extra dependencies. Register projects directly
237
- from the browser via `Explorar…` or from the terminal with `stackhelx add .`.
237
+ from the browser via `Browse…` or from the terminal with `stackhelx add .`. Use
238
+ the `EN / ES` toggle in the header to switch the interface between English and
239
+ Spanish at any time.
238
240
 
239
241
  Monitor service states, start and stop stacks, free ports held by stray
240
242
  processes, inspect system-wide listening ports, and stream live logs per project.
@@ -252,10 +254,10 @@ stackhelx ports 3000 8080 # specific ports
252
254
  ```
253
255
 
254
256
  ```
255
- PUERTO ESTADO PID PROCESO COMANDO
256
- 3000 ocupado 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
257
- 8080 libre - - -
258
- 5432 ocupado 9012 com.docker.backend.exe
257
+ PORT STATUS PID PROCESS COMMAND
258
+ 3000 occupied 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
259
+ 8080 free - - -
260
+ 5432 occupied 9012 com.docker.backend.exe
259
261
  ```
260
262
 
261
263
  Free a port held by a zombie process:
@@ -284,7 +286,7 @@ The CLI does not track which processes you started in other terminals: if anothe
284
286
  stack is running in a separate shell, its services appear in that list too. That
285
287
  is why the CLI prints the full list before touching anything and defaults the
286
288
  prompt to "no". The web dashboard tracks its own active sessions and excludes
287
- them automatically when clicking "Liberar todos".
289
+ them automatically when clicking "Free all".
288
290
 
289
291
  ## What the kill switch refuses to do
290
292
 
@@ -73,7 +73,7 @@ shx up --env-file .env.qa # carga ese .env antes de arrancar
73
73
  archivo en el entorno del proceso antes de resolver el stack, así que lo ven
74
74
  todos los servicios. Es para la corrida puntual contra otro entorno, sin editar
75
75
  el archivo. A diferencia de `env_file:`, acepta rutas fuera de la raíz del
76
- proyecto, porque acá la ruta la escribiste vos en la terminal y no viene de un
76
+ proyecto, porque aquí la ruta la escribiste tú en la terminal y no viene de un
77
77
  archivo de un repo ajeno.
78
78
 
79
79
  Antes de arrancar libera los puertos declarados que tenga otro proceso, y
@@ -129,7 +129,7 @@ Dónde busca cada lenguaje y por qué reconoce eso y no otra cosa, en
129
129
 
130
130
  ## stack.yaml
131
131
 
132
- En la raíz del proyecto. StackHelx lo busca hacia arriba, así que podés correr
132
+ En la raíz del proyecto. StackHelx lo busca hacia arriba, así que puedes correr
133
133
  los comandos desde cualquier subdirectorio.
134
134
 
135
135
  ```yaml
@@ -165,7 +165,7 @@ healthchecks de `ready` y los perfiles heredados de un compose están en
165
165
 
166
166
  ## Interfaz web
167
167
 
168
- Cuando tenés varios proyectos, el CLI se queda corto: trabaja sobre el
168
+ Cuando tienes varios proyectos, el CLI se queda corto: trabaja sobre el
169
169
  directorio actual. La interfaz los muestra todos a la vez.
170
170
 
171
171
  ```bash
@@ -173,8 +173,9 @@ stackhelx serve # abre http://127.0.0.1:7666
173
173
  ```
174
174
 
175
175
  Viene con la instalación, no hace falta nada más. Registrar proyectos se puede
176
- desde la propia interfaz con `Explorar…`, o desde la terminal con
177
- `stackhelx add .`.
176
+ desde la propia interfaz con `Explorar…` (`Browse…`), o desde la terminal con
177
+ `stackhelx add .`. En el encabezado puedes conmutar el idioma de toda la interfaz
178
+ en vivo con el selector `EN / ES`.
178
179
 
179
180
  Estado de cada servicio, arrancar y apagar stacks, liberar puertos tomados por
180
181
  procesos ajenos, y logs en vivo por proyecto.
@@ -204,7 +205,7 @@ Liberar un puerto tomado por un proceso zombie:
204
205
  stackhelx free 3000
205
206
  ```
206
207
 
207
- Muestra qué proceso lo ocupa y pide confirmación antes de cerrarlo. Si decís
208
+ Muestra qué proceso lo ocupa y pide confirmación antes de cerrarlo. Si dices
208
209
  que no, sugiere el siguiente puerto disponible.
209
210
 
210
211
  Opciones: `--yes` salta la confirmación (para scripts), `--force` aplica
@@ -220,7 +221,7 @@ Recorre los puertos declarados por todos los proyectos registrados, lista lo
220
221
  que encuentre ocupado y pide una sola confirmación. Sale con código 1 si no
221
222
  pudo cerrar alguno.
222
223
 
223
- El CLI no sabe qué arrancaste vos: si tenés un stack levantado en otra
224
+ El CLI no sabe qué arrancaste tú: si tienes un stack levantado en otra
224
225
  terminal, sus servicios aparecen en esa lista y también se cierran. Por eso la
225
226
  muestra entera antes de tocar nada, y por eso la confirmación viene con "no"
226
227
  por defecto. La interfaz web sí lo sabe, y ahí el botón "Liberar todos"
@@ -233,7 +234,7 @@ Estas reglas están en el código, no en la documentación:
233
234
  - Nunca cierra PID 0, PID 4, el propio StackHelx ni un proceso padre suyo.
234
235
  Matar tu propia terminal no es una función.
235
236
  - Revalida la hora de creación del proceso entre el escaneo y el cierre. Los
236
- PID se reciclan; sin ese chequeo terminás matando algo al azar.
237
+ PID se reciclan; sin ese chequeo terminas matando algo al azar.
237
238
  - Manda `terminate()` y espera 5 segundos. `kill()` solo con `--force`
238
239
  explícito, porque un `npm run dev` matado a lo bruto deja hijos huérfanos.
239
240
  - Sin permisos, lo dice y corta. No reintenta escalando privilegios.
@@ -250,7 +251,7 @@ Estas reglas están en el código, no en la documentación:
250
251
  ## Modelo de confianza
251
252
 
252
253
  `stack.yaml` ejecuta comandos arbitrarios, igual que `package.json` o un
253
- `Makefile`. StackHelx no lo sandboxea: sería teatro. Tratá un `stack.yaml`
254
+ `Makefile`. StackHelx no lo sandboxea: sería teatro. Trata un `stack.yaml`
254
255
  de un repo ajeno con el mismo cuidado que sus scripts de build.
255
256
 
256
257
  Sin `stack.yaml`, los comandos salen de la detección, y `scripts.dev` de un
@@ -112,12 +112,12 @@ root:
112
112
  | `package.json` with a server script (`dev`, `start:dev`, `serve`, `start`) | `npm run dev`, switching to `pnpm`/`yarn`/`bun` based on lockfile or `packageManager` |
113
113
 
114
114
  ```
115
- mi-app A:\Proyectos\mi-app
116
- Sin stack.yaml. Detectado:
115
+ my-app A:\Proyectos\my-app
116
+ No stack.yaml. Detected:
117
117
  docker docker compose up -d 5433
118
- web pnpm run dev al arrancar
119
- Para congelarlo en un archivo editable: stackhelx init
120
- Arrancar? [Y/n]
118
+ web pnpm run dev on start
119
+ To freeze into an editable file: stackhelx init
120
+ Start? [Y/n]
121
121
  ```
122
122
 
123
123
  Services start in that order and chain dependencies automatically: frontend
@@ -175,7 +175,9 @@ stackhelx serve # opens http://127.0.0.1:7666
175
175
  ```
176
176
 
177
177
  Included out of the box with no extra dependencies. Register projects directly
178
- from the browser via `Explorar…` or from the terminal with `stackhelx add .`.
178
+ from the browser via `Browse…` or from the terminal with `stackhelx add .`. Use
179
+ the `EN / ES` toggle in the header to switch the interface between English and
180
+ Spanish at any time.
179
181
 
180
182
  Monitor service states, start and stop stacks, free ports held by stray
181
183
  processes, inspect system-wide listening ports, and stream live logs per project.
@@ -193,10 +195,10 @@ stackhelx ports 3000 8080 # specific ports
193
195
  ```
194
196
 
195
197
  ```
196
- PUERTO ESTADO PID PROCESO COMANDO
197
- 3000 ocupado 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
198
- 8080 libre - - -
199
- 5432 ocupado 9012 com.docker.backend.exe
198
+ PORT STATUS PID PROCESS COMMAND
199
+ 3000 occupied 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
200
+ 8080 free - - -
201
+ 5432 occupied 9012 com.docker.backend.exe
200
202
  ```
201
203
 
202
204
  Free a port held by a zombie process:
@@ -225,7 +227,7 @@ The CLI does not track which processes you started in other terminals: if anothe
225
227
  stack is running in a separate shell, its services appear in that list too. That
226
228
  is why the CLI prints the full list before touching anything and defaults the
227
229
  prompt to "no". The web dashboard tracks its own active sessions and excludes
228
- them automatically when clicking "Liberar todos".
230
+ them automatically when clicking "Free all".
229
231
 
230
232
  ## What the kill switch refuses to do
231
233
 
@@ -98,5 +98,22 @@ even when Vite sees port 5173 occupied and shifts to 5174. The trade-off is that
98
98
  is only known after the process binds it. Compose ports are declared statically
99
99
  and freed beforehand.
100
100
 
101
+ A server started from another terminal (say, `astro dev` in the project folder)
102
+ is not in StackHelx's process tree, so its port cannot be discovered that way.
103
+ The dashboard attributes it from OS evidence instead: a project path in the
104
+ process command line, or the working directory when the process is an
105
+ interpreter (`node`, `python`, `bun`, `deno`, `java`, `dotnet`, `php`, `ruby`).
106
+ A tool binary that merely inherited the folder as its working directory, such as
107
+ an editor or an MCP server, is not attributed. If the project has exactly one
108
+ service without a declared port, that service shows as ready with the port and
109
+ an `external` mark; with two or more, the ports are listed for the project
110
+ without guessing which service owns them.
111
+
112
+ StackHelx also drops agent-identifying variables (`CLAUDECODE`, `AI_AGENT`,
113
+ `OPENCODE`, `GEMINI_CLI` and similar) from the environment it passes to services.
114
+ Astro 7 backgrounds `astro dev` as a daemon when it sees them, which would leave
115
+ the server outside the process tree with no port and no way to stop it. A
116
+ variable you set in `env.global` or in the service's `env` still applies.
117
+
101
118
  `stackhelx init` writes the detected stack to `stack.yaml` for manual editing
102
119
  and refuses to overwrite an existing file.
@@ -5,7 +5,7 @@
5
5
  > **Nota:** Todos los comandos del sistema pueden ejecutarse indistintamente con `stackhelx <cmd>` o mediante el alias corto oficial **`shx <cmd>`** (por ejemplo: `shx down`, `shx doctor`, `shx switch`, `shx run`, `shx share`).
6
6
 
7
7
  `up`, `serve`, `ports` y `free` están en el [README](../../README.es.md#comandos).
8
- Acá están los cuatro que quedan, con qué revisa cada uno y por qué.
8
+ Aquí están los cuatro que quedan, con qué revisa cada uno y por qué.
9
9
 
10
10
  ## Bajar lo que sobrevive a la terminal
11
11
 
@@ -49,7 +49,7 @@ contesta, y qué puertos declarados están ocupados y por quién. Cada chequeo e
49
49
  rojo trae la línea para arreglarlo.
50
50
 
51
51
  ```
52
- ok token C:\Users\vos\.stackhelx\token
52
+ ok token C:\Users\tu-usuario\.stackhelx\token
53
53
  ok stack detectado (3 servicios)
54
54
  ok comando docker C:\Program Files\Docker\...\docker.EXE
55
55
  FALLA daemon de docker no esta en ejecucion
@@ -102,7 +102,7 @@ stackhelx share --provider ngrok # fuerza el proveedor (cloudflared, ngrok, lt,
102
102
  ```
103
103
 
104
104
  Genera un túnel HTTPS seguro y efímero hacia el puerto local, ideal para probar webhooks,
105
- compartir vistas previas con clientes o probar en dispositivos móviles. Presioná `Ctrl-C` para
105
+ compartir vistas previas con clientes o probar en dispositivos móviles. Presiona `Ctrl-C` para
106
106
  cerrar el túnel de inmediato.
107
107
 
108
108
  **No se puede compartir el puerto de `stackhelx serve`.** Detrás de ese puerto está la API
@@ -149,7 +149,7 @@ stackhelx test-stack ../otro-proyecto
149
149
 
150
150
  Carga el `stack.yaml`, resuelve el orden topológico y mira si los puertos
151
151
  declarados están libres. No arranca nada, así que es lo más barato para saber si
152
- un archivo que acabás de editar carga bien.
152
+ un archivo que acabas de editar carga bien.
153
153
 
154
154
  ```
155
155
  Validando stack demo en C:\...\demo...
@@ -262,7 +262,7 @@ cosas están cortadas a propósito y no son las mismas que en el CLI:
262
262
  - **`stackhelx_share` solo publica puertos que el proyecto declara.** Pedir uno
263
263
  ajeno responde `El puerto 5432 no pertenece a los puertos declarados`, y el
264
264
  puerto de la propia interfaz está vetado aparte. El CLI no tiene esta
265
- restricción: ahí el puerto lo escribís vos.
265
+ restricción: ahí el puerto lo escribes tú.
266
266
  - **`stackhelx_clean` no borra volúmenes.** El flag existe en el CLI y no en el
267
267
  esquema de la herramienta.
268
268
  - **Hay un tope de 30 llamadas por minuto.** Pasado eso contesta `Límite de
@@ -4,7 +4,7 @@
4
4
 
5
5
  Cuando un proyecto no tiene `stack.yaml`, StackHelx infiere los servicios de
6
6
  lo que encuentra en el disco. La tabla de qué reconoce está en el
7
- [README](../../README.es.md#sin-stackyaml). Acá está por qué reconoce eso y no otra
7
+ [README](../../README.es.md#sin-stackyaml). Aquí está por qué reconoce eso y no otra
8
8
  cosa, que es lo que hay que leer antes de agregar un detector.
9
9
 
10
10
  La regla que ordena todo lo de abajo: solo se detecta lo que sirve en un
@@ -117,5 +117,21 @@ se le pregunta cuál quedó escuchando. Es más confiable que parsear
117
117
  antes de arrancar, porque no se saben hasta después. Los de compose sí, que
118
118
  están declarados en el archivo.
119
119
 
120
+ Un servidor arrancado desde otra terminal (por ejemplo `astro dev` en la carpeta
121
+ del proyecto) no está en el árbol de StackHelx, así que su puerto no se descubre
122
+ por ahí. La interfaz lo atribuye con evidencia del sistema: una ruta del proyecto
123
+ en la línea de comandos del proceso, o su carpeta de trabajo si el proceso es un
124
+ intérprete (`node`, `python`, `bun`, `deno`, `java`, `dotnet`, `php`, `ruby`). Un
125
+ binario que solo heredó la carpeta, como un editor o un servidor MCP, no se
126
+ atribuye. Si el proyecto tiene un solo servicio sin puerto declarado, ese
127
+ servicio sale listo, con el puerto y la marca `externo`; con dos o más, los
128
+ puertos se listan en el proyecto sin adivinar de cuál son.
129
+
130
+ StackHelx además saca del entorno de los servicios las variables que delatan a un
131
+ agente (`CLAUDECODE`, `AI_AGENT`, `OPENCODE`, `GEMINI_CLI` y parecidas). Astro 7
132
+ manda `astro dev` a segundo plano cuando las ve, y el servidor queda fuera del
133
+ árbol, sin puerto y sin forma de apagarlo. Si la declaras en `env.global` o en
134
+ el `env` del servicio, vale.
135
+
120
136
  `stackhelx init` escribe lo detectado como `stack.yaml` para editarlo a mano.
121
137
  No sobreescribe uno existente.
@@ -3,13 +3,20 @@
3
3
  [English](../interfaz.md) · **Español**
4
4
 
5
5
  Cómo se arranca y qué muestra está en el
6
- [README](../../README.es.md#interfaz-web). Acá está el detalle de cada control y por
6
+ [README](../../README.es.md#interfaz-web). Aquí está el detalle de cada control y por
7
7
  qué se comporta como se comporta.
8
8
 
9
+ ## Selector de idioma (EN / ES)
10
+
11
+ El encabezado incluye un botón `EN / ES` que conmuta todas las etiquetas, estados,
12
+ tooltips y modales entre inglés y español en tiempo real sin recargar la página.
13
+ La interfaz abre en inglés por defecto y recuerda tu elección en `localStorage`
14
+ (`stackhelx.lang`).
15
+
9
16
  ## Caídas y avisos
10
17
 
11
18
  Cuando un servicio se muere solo, el título de la pestaña lleva un contador y
12
- el encabezado dice cuántos hay caídos. Con `Avisarme` podés además pedir
19
+ el encabezado dice cuántos hay caídos. Con `Avisarme` puedes además pedir
13
20
  notificaciones del navegador, que solo avisan de caídas nuevas y nunca de un
14
21
  `Apagar` ni de un `Reiniciar`. El permiso se pide con ese click y nunca al
15
22
  cargar la página.
@@ -71,6 +78,18 @@ error del propio Docker. Cuando el motor termina de levantar, el botón no
71
78
  desaparece: pasa a decir `Reiniciar Docker`. Lo mueve la misma vista de estado
72
79
  que ya sondea `docker info`.
73
80
 
81
+ ## Mapa de puertos
82
+
83
+ El mapa abre en `Todo el sistema`: cada socket que el sistema reporta en escucha,
84
+ con protocolo, dirección (`0.0.0.0` o `::` sale marcado como expuesto a la red),
85
+ proceso, línea de comandos y, si se puede atribuir, el proyecto registrado al que
86
+ pertenece. Se lee al abrir el mapa o al tocar `Refrescar`, nunca en segundo
87
+ plano. `Ocultar procesos de Windows` (activo por defecto) esconde RPC, SMB y
88
+ parecidos, `Incluir UDP` suma los sockets UDP ligados, y el filtro busca por
89
+ puerto, proceso, proyecto o comando. La pestaña `De proyectos` muestra solo los
90
+ puertos de proyectos registrados, incluidos los servidores arrancados fuera de
91
+ StackHelx.
92
+
74
93
  ## Explorar carpetas
75
94
 
76
95
  Para registrar un proyecto no hace falta copiar la ruta: `Explorar…` abre un
@@ -86,4 +105,4 @@ El servidor escucha solo en loopback y exige un token que `serve` genera en
86
105
  `~/.stackhelx/token` y pasa en la URL de arranque. Ejecuta los comandos de tus
87
106
  `stack.yaml`, así que se trata como superficie sensible: rate limit en todas las
88
107
  rutas, CSP estricta, y validación del header `Host` contra rebinding de DNS.
89
- Podés fijar el token vos mismo con `STACKHELX_TOKEN`.
108
+ Puedes fijar el token tú mismo con `STACKHELX_TOKEN`.
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](../stack-yaml.md) · **Español**
4
4
 
5
- El ejemplo mínimo está en el [README](../../README.es.md#stackyaml). Acá está cada
5
+ El ejemplo mínimo está en el [README](../../README.es.md#stackyaml). Aquí está cada
6
6
  campo, con el ejemplo completo y comentado en
7
7
  [`stack.example.yaml`](../../stack.example.yaml).
8
8
 
@@ -19,8 +19,8 @@ cada nivel en lugar de la suma de todos, a cambio de que los logs de los
19
19
  primeros segundos se entreveren. Van prefijados por servicio y con un color
20
20
  propio cada uno, así que se siguen leyendo.
21
21
 
22
- `default` es opcional y lista qué arranca cuando no pedís perfil. Sin él,
23
- arranca todo, que es lo que casi siempre querés. Existe para el caso de abajo.
22
+ `default` es opcional y lista qué arranca cuando no pides perfil. Sin él,
23
+ arranca todo, que es lo que casi siempre quieres. Existe para el caso de abajo.
24
24
 
25
25
  ## Perfiles de un compose detectado
26
26
 
@@ -55,7 +55,7 @@ archivo congelado prendería lo que el compose deja apagado a propósito.
55
55
  | `none` | nada (default si no hay `port`) |
56
56
 
57
57
  `listen` es para servicios que eligen su propio puerto. Es incompatible con
58
- `port`: si lo conocés, el healthcheck es `port`.
58
+ `port`: si lo conoces, el healthcheck es `port`.
59
59
 
60
60
  `port` no distingue quién contesta. Si alguien ya escuchaba ahí antes de
61
61
  arrancar, el servicio se declara listo en el acto aunque el `listo` sea de otro
@@ -6,17 +6,24 @@ How to launch the dashboard and what it displays is covered in the
6
6
  [README](../README.md#web-dashboard). This document explains how each control
7
7
  behaves under the hood and why.
8
8
 
9
+ ## Language selector (EN / ES)
10
+
11
+ The header includes an `EN / ES` toggle that switches every label, status badge,
12
+ tooltip, and modal between English and Spanish in real time without reloading the
13
+ page. The dashboard defaults to English and persists your choice in
14
+ `localStorage` (`stackhelx.lang`).
15
+
9
16
  ## Crashes and browser notifications
10
17
 
11
18
  When a running service exits unexpectedly, the browser tab title shows a counter
12
- and the header reports how many services have fallen. Clicking `Avisarme`
19
+ and the header reports how many services have fallen. Clicking `Notify me`
13
20
  requests browser notification permissions so you get alerted on unexpected
14
- crashes, never when you click `Apagar` or `Reiniciar` yourself. Permission is
21
+ crashes, never when you click `Stop` or `Restart` yourself. Permission is
15
22
  requested only on that click, never on page load.
16
23
 
17
24
  ## Freezing to stack.yaml
18
25
 
19
- Auto-detected projects show a `Congelar a stack.yaml` button, which runs
26
+ Auto-detected projects show a `Freeze to stack.yaml` button, which runs
20
27
  `stackhelx init` directly from the browser. Useful when you want to customize a
21
28
  detected command or pin a port. It asks for confirmation inline on the same
22
29
  button, writes to the registered project path on the server (never trusting a
@@ -24,14 +31,14 @@ path sent from the client), and refuses to overwrite an existing file.
24
31
 
25
32
  ## Restarting a single service
26
33
 
27
- Every service started from the dashboard has its own `Reiniciar` button that
34
+ Every service started from the dashboard has its own `Restart` button that
28
35
  cycles only that service. When your frontend hangs, your database containers do
29
36
  not need to restart with it.
30
37
 
31
38
  ## The Open button
32
39
 
33
- Services that answer HTTP display an `Abrir` button, and the project card has a
34
- top-level `Abrir` button that opens the last HTTP-capable service in startup
40
+ Services that answer HTTP display an `Open` button, and the project card has a
41
+ top-level `Open` button that opens the last HTTP-capable service in startup
35
42
  order (typically the frontend). StackHelx does not guess by service name: once a
36
43
  service is ready, it probes the bound port over HTTP. Even a `404` counts as an
37
44
  HTTP server because many APIs do not serve a root route; only non-HTTP listeners
@@ -39,22 +46,32 @@ like databases are excluded.
39
46
 
40
47
  ## Docker controls
41
48
 
42
- When any registered project uses Docker, the toolbar displays `Docker corriendo`
43
- or `Docker cerrado` alongside an action button: `Abrir Docker` when the daemon
44
- is down, or `Reiniciar Docker` when the daemon is up. Both controls remain
49
+ When any registered project uses Docker, the toolbar displays `Docker running`
50
+ or `Docker stopped` alongside an action button: `Start Docker` when the daemon
51
+ is down, or `Restart Docker` when the daemon is up. Both controls remain
45
52
  visible whenever a project uses Docker: a status indicator that disappears when
46
53
  healthy cannot distinguish "everything is fine" from "the check stopped
47
54
  working".
48
55
 
49
- The stray processes section (`Procesos intrusos`) follows the same principle: as
56
+ The stray processes section (`Stray processes`) follows the same principle: as
50
57
  long as at least one project is registered, the section stays visible and
51
58
  explicitly states when zero stray processes are holding your ports.
52
59
 
60
+ The port map opens on `All system`: every socket the OS reports as listening,
61
+ with protocol, bind address (`0.0.0.0` or `::` is marked as exposed to the
62
+ network), process, command line and, when it can be attributed, the registered
63
+ project it belongs to. It is read on demand when you open the map or press
64
+ `Refresh`, never polled. `Hide Windows processes` (on by default) hides RPC,
65
+ SMB and similar system listeners, `Include UDP` adds bound UDP sockets, and the
66
+ filter matches port, process, project or command line. The `Projects` tab shows
67
+ only ports tied to registered projects, including servers started outside
68
+ StackHelx.
69
+
53
70
  Restarting Docker asks for inline confirmation because it restarts every running
54
71
  container on the machine, including containers from other projects. Starting
55
72
  Docker runs immediately without confirmation.
56
73
 
57
- Note that `Docker cerrado` checks whether the Docker daemon answers `docker
74
+ Note that `Docker stopped` checks whether the Docker daemon answers `docker
58
75
  info`, not whether the Docker Desktop window is open.
59
76
 
60
77
  Under the hood, StackHelx runs `docker desktop start --detach` or
@@ -64,7 +81,7 @@ boots.
64
81
 
65
82
  ## Folder browser
66
83
 
67
- You do not need to copy-paste paths to register a project: `Explorar…` opens a
84
+ You do not need to copy-paste paths to register a project: `Browse…` opens a
68
85
  directory browser starting at your home folder and mounted drives, highlighting
69
86
  folders that contain `stack.yaml`, a Compose file, `package.json`, or
70
87
  `manage.py`. The server builds the listing and returns only folder names and
@@ -0,0 +1,2 @@
1
+ __version__ = "1.1.4"
2
+