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.
- {stackhelx-1.1.2 → stackhelx-1.1.4}/CHANGELOG.md +29 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/PKG-INFO +14 -12
- {stackhelx-1.1.2 → stackhelx-1.1.4}/README.es.md +10 -9
- {stackhelx-1.1.2 → stackhelx-1.1.4}/README.md +13 -11
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/deteccion.md +17 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/comandos.md +5 -5
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/deteccion.md +17 -1
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/interfaz.md +22 -3
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/es/stack-yaml.md +4 -4
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/interfaz.md +29 -12
- stackhelx-1.1.4/stackhelx/__init__.py +2 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/cli.py +228 -290
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/docker.py +31 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/ports.py +55 -24
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/registry.py +49 -1
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/runner.py +30 -1
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/server.py +103 -14
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/web/app.css +178 -48
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/web/app.js +738 -419
- stackhelx-1.1.4/stackhelx/web/index.html +579 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/web/tokens.css +0 -1
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/conftest.py +10 -1
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_cli.py +19 -19
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_ports.py +63 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_registry.py +68 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_runner.py +30 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_server.py +143 -1
- {stackhelx-1.1.2 → stackhelx-1.1.4}/uv.lock +59 -33
- stackhelx-1.1.2/stackhelx/__init__.py +0 -2
- stackhelx-1.1.2/stackhelx/web/index.html +0 -415
- {stackhelx-1.1.2 → stackhelx-1.1.4}/.github/workflows/ci.yml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/.github/workflows/release.yml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/.gitignore +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/AGENTS.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/CLAUDE.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/LICENSE +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/comandos.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/docs/stack-yaml.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/pyproject.toml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/scripts/check_docs.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/scripts/check_metadata.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stack.example.yaml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/__main__.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/browse.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/config.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/detect.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/doctor.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/guardrails.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/history.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/mcp.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/scripts.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/stackhelx/tunnel.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_browse.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_config.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_conftest.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_detect.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_guardrails.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_history.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_mcp.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.4}/tests/test_scripts.py +0 -0
- {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.
|
|
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
|
-
|
|
175
|
-
|
|
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
|
|
178
|
-
|
|
179
|
-
|
|
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 `
|
|
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
|
-
|
|
256
|
-
3000
|
|
257
|
-
8080
|
|
258
|
-
5432
|
|
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 "
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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
|
-
|
|
116
|
-
|
|
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
|
|
119
|
-
|
|
120
|
-
|
|
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 `
|
|
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
|
-
|
|
197
|
-
3000
|
|
198
|
-
8080
|
|
199
|
-
5432
|
|
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 "
|
|
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
|
-
|
|
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\
|
|
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.
|
|
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
|
|
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
|
|
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).
|
|
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).
|
|
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`
|
|
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
|
-
|
|
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).
|
|
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
|
|
23
|
-
arranca todo, que es lo que casi siempre
|
|
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
|
|
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 `
|
|
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 `
|
|
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 `
|
|
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 `
|
|
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 `
|
|
34
|
-
top-level `
|
|
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
|
|
43
|
-
or `Docker
|
|
44
|
-
is down, or `
|
|
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 (`
|
|
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
|
|
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: `
|
|
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
|