stackhelx 1.0.0__tar.gz → 1.1.0__tar.gz

{stackhelx-1.0.0 → stackhelx-1.1.0}/CHANGELOG.md

@@ -4,6 +4,26 @@ Formato de [Keep a Changelog](https://keepachangelog.com/es/1.1.0/).
 Versionado semántico: la superficie pública son los comandos del CLI, el
 esquema de `stack.yaml` y las rutas de la API local.
 
+## [1.1.0] - 2026-09-18
+
+### Añadido y Mejorado
+
+- **Onboarding de Agentes MCP:** Modal web interactivo con panel desplegable colapsable para configurar clientes de IA (Claude Desktop, Cursor, Antigravity, VS Code), con generación de snippets JSON (`shx` / `uvx`), descarga directa de `stackhelx-mcp.json` y copia de System Prompt para agentes.
+- **Banderas CLI para MCP:** Se incorporan las opciones `shx mcp --config` (imprime bloque JSON de configuración) y `shx mcp --prompt` (imprime instrucciones recomendadas para agentes).
+- **Telemetría y Métricas en Tiempo Real:** Tooltip explicativo (`title` y `aria-label`) con cursor `help` sobre el badge de métricas de servicio (`.service__metrics`). Desglosa el uso de CPU multi-core (equivalencia de núcleos activos) y aclara que la memoria es física residente (RSS).
+- **Documentación del alias `shx`:** `README.md` y `docs/comandos.md` documentan formalmente la instalación y uso del comando abreviado `shx` 1:1 junto con `stackhelx`.
+- **Diseño sin emojis:** Estilo visual puro y tipográfico, conforme a los principios de diseño sobrio y accesible.
+
+## [1.0.1] - 2026-09-13
+
+### Seguridad y Limpieza
+
+- **Purga de mensajes de seguridad y excepciones (`ports.py`):** Los mensajes de `KillRefused` ante intento de cerrar el PID propio o el de la terminal padre ahora identifican explícitamente a `StackHelx`.
+- **Precedencia de entorno global (`runner.py`):** `build_env()` lee `~/.stackhelx/env.global` y mantiene fallback transparente a `~/.portmaster/env.global` si existe, con pruebas de precedencia añadidas a la suite.
+- **Títulos y logs de servidor (`server.py`):** Título de FastAPI fijado a `StackHelx`, logger migrado a `stackhelx.server`, y mensajes de guarda en `/api/share` actualizados para rechazar túneles contra la consola de `StackHelx`.
+- **Plantilla de configuración (`stack.example.yaml`):** Actualizada para documentar `stackhelx init` y la nueva identidad de StackHelx.
+- **Suite de pruebas:** 474 pruebas en verde (+1 test de precedencia de entorno global).
+
 ## [1.0.0] - 2026-09-13
 
 ### Rebrand y Nuevo Comienzo
@@ -548,8 +568,7 @@ Primera versión publicada. Lo que sigue es el alcance completo, no un diff.
 [1.3.0]: https://github.com/TicoraX/PortMaster/releases/tag/v1.3.0
 [1.2.0]: https://github.com/TicoraX/PortMaster/releases/tag/v1.2.0
 [1.1.1]: https://github.com/TicoraX/PortMaster/releases/tag/v1.1.1
-[1.1.0]: https://github.com/TicoraX/PortMaster/releases/tag/v1.1.0
-[1.0.3]: https://github.com/TicoraX/PortMaster/releases/tag/v1.0.3
-[1.0.2]: https://github.com/TicoraX/PortMaster/releases/tag/v1.0.2
-[1.0.1]: https://github.com/TicoraX/PortMaster/releases/tag/v1.0.1
-[1.0.0]: https://github.com/TicoraX/PortMaster/releases/tag/v1.0.0
+[1.1.0]: https://github.com/TicoraX/StackHelx/releases/tag/v1.1.0
+[1.0.1]: https://github.com/TicoraX/StackHelx/releases/tag/v1.0.1
+[1.0.0]: https://github.com/TicoraX/StackHelx/releases/tag/v1.0.0
+

{stackhelx-1.0.0 → stackhelx-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stackhelx
-Version: 1.0.0
+Version: 1.1.0
 Summary: Orquestador de entornos de desarrollo locales: puertos, Docker, backend y frontend con un solo comando
 Project-URL: Homepage, https://github.com/TicoraX/StackHelx
 Project-URL: Repository, https://github.com/TicoraX/StackHelx
@@ -59,7 +59,7 @@ Description-Content-Type: text/markdown
 
 # StackHelx
 
-[![pypi](https://img.shields.io/pypi/v/stackhelx)](https://pypi.org/project/stackhelx/)
+[![pypi](https://img.shields.io/pypi/v/stackhelx?logo=pypi&logoColor=white)](https://pypi.org/project/stackhelx/)
 [![tests](https://github.com/TicoraX/StackHelx/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/TicoraX/StackHelx/actions/workflows/ci.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](pyproject.toml)
@@ -76,11 +76,15 @@ uv tool install stackhelx
 pipx install stackhelx
 ```
 
+La instalación registra dos ejecutables idénticos en el sistema: el comando principal **`stackhelx`** y su versión abreviada **`shx`**.
+
 Requiere Python 3.10 o superior. Funciona en Windows, macOS y Linux.
 
 ## Comandos
 
-| Comando | Qué hace |
+Todos los comandos pueden ejecutarse como `stackhelx <comando>` o de forma abreviada con su alias oficial **`shx <comando>`** (ej. `shx up`, `shx down`, `shx doctor`, `shx ports`):
+
+| Comando (`stackhelx` / `shx`) | Qué hace |
 |---|---|
 | `stackhelx up` | Levanta el stack entero: libera puertos, arranca en orden y sigue los logs |
 | `stackhelx down` | Baja lo que sobrevive a la terminal, o sea contenedores |
@@ -113,10 +117,13 @@ Cada uno con `--help`.
 ## Arrancar un stack
 
 ```bash
+shx up
+# o
 stackhelx up
-stackhelx up --profile backend    # solo un subconjunto
-stackhelx up --no-free            # no tocar los puertos ocupados
-stackhelx up --env-file .env.qa   # carga ese .env antes de arrancar
+
+shx up --profile backend    # solo un subconjunto
+shx up --no-free            # no tocar los puertos ocupados
+shx up --env-file .env.qa   # carga ese .env antes de arrancar
 ```
 
 `--env-file` no reemplaza al `env_file:` de `stack.yaml`, se suma: carga el

{stackhelx-1.0.0 → stackhelx-1.1.0}/README.md

@@ -1,6 +1,6 @@
 # StackHelx
 
-[![pypi](https://img.shields.io/pypi/v/stackhelx)](https://pypi.org/project/stackhelx/)
+[![pypi](https://img.shields.io/pypi/v/stackhelx?logo=pypi&logoColor=white)](https://pypi.org/project/stackhelx/)
 [![tests](https://github.com/TicoraX/StackHelx/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/TicoraX/StackHelx/actions/workflows/ci.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](pyproject.toml)
@@ -17,11 +17,15 @@ uv tool install stackhelx
 pipx install stackhelx
 ```
 
+La instalación registra dos ejecutables idénticos en el sistema: el comando principal **`stackhelx`** y su versión abreviada **`shx`**.
+
 Requiere Python 3.10 o superior. Funciona en Windows, macOS y Linux.
 
 ## Comandos
 
-| Comando | Qué hace |
+Todos los comandos pueden ejecutarse como `stackhelx <comando>` o de forma abreviada con su alias oficial **`shx <comando>`** (ej. `shx up`, `shx down`, `shx doctor`, `shx ports`):
+
+| Comando (`stackhelx` / `shx`) | Qué hace |
 |---|---|
 | `stackhelx up` | Levanta el stack entero: libera puertos, arranca en orden y sigue los logs |
 | `stackhelx down` | Baja lo que sobrevive a la terminal, o sea contenedores |
@@ -54,10 +58,13 @@ Cada uno con `--help`.
 ## Arrancar un stack
 
 ```bash
+shx up
+# o
 stackhelx up
-stackhelx up --profile backend    # solo un subconjunto
-stackhelx up --no-free            # no tocar los puertos ocupados
-stackhelx up --env-file .env.qa   # carga ese .env antes de arrancar
+
+shx up --profile backend    # solo un subconjunto
+shx up --no-free            # no tocar los puertos ocupados
+shx up --env-file .env.qa   # carga ese .env antes de arrancar
 ```
 
 `--env-file` no reemplaza al `env_file:` de `stack.yaml`, se suma: carga el

{stackhelx-1.0.0 → stackhelx-1.1.0}/docs/comandos.md

@@ -1,13 +1,16 @@
 # Otros comandos
 
+> **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`).
+
 `up`, `serve`, `ports` y `free` están en el [README](../README.md#comandos).
 Acá están los cuatro que quedan, con qué revisa cada uno y por qué.
 
 ## Bajar lo que sobrevive a la terminal
 
 ```bash
-stackhelx down
-stackhelx down --profile backend
+shx down
+# o stackhelx down
+shx down --profile backend
 ```
 
 `Ctrl-C` sobre un `stackhelx up` apaga a sus hijos, pero un

{stackhelx-1.0.0 → stackhelx-1.1.0}/docs/plan-expansion.md

@@ -1,9 +1,9 @@
-# Plan de Expansión Estratégica: PortMaster 2.0 (Ecosistema Completo de Desarrollo)
+# Plan de Expansión Estratégica: StackHelx (Ecosistema Completo de Desarrollo)
 
 Fecha: 14 de agosto de 2026.  
 Rama: `feature/expansion-plan`
 
-Este documento define la evolución de PortMaster desde un orquestador de *stacks* locales hacia una **plataforma integral de productividad, diagnóstico, automatización y control del entorno de desarrollo local**.
+Este documento define la evolución de StackHelx desde un orquestador de *stacks* locales hacia una **plataforma integral de productividad, diagnóstico, automatización y control del entorno de desarrollo local**.
 
 ---
 
@@ -11,17 +11,17 @@ Este documento define la evolución de PortMaster desde un orquestador de *stack
 
 ```
 ┌─────────────────────────────────────────────────────────────────────────────┐
-│                           PORTMASTER ECOSYSTEM                              │
+│                            STACKHELX ECOSYSTEM                              │
 ├───────────────────────────────┬───────────────────────────────┬─────────────┤
 │ 1. ORQUESTACIÓN DE STACK      │ 2. RUNNER DE TAREAS           │ 3. TÚNELES  │
 │ - Topological sort & health   │ - Scripts y pipelines locales │ - ngrok     │
 │ - env_file & pre_start hooks  │ - Inyección de variables      │ - cloudflare│
-│ - Monorrepos (pnpm/turbo/uv)  │ - portmaster run <tarea>      │ - share     │
+│ - Monorrepos (pnpm/turbo/uv)  │ - stackhelx run <tarea>       │ - share     │
 ├───────────────────────────────┼───────────────────────────────┼─────────────┤
 │ 4. MULTI-PROYECTO COMPUESTO   │ 5. HIGIENE Y MANTENIMIENTO    │ 6. MCP & AI │
 │ - Inclusión inter-repositorios│ - Docker prune inteligente    │ - Tools MCP │
 │ - Grupos de servicios         │ - Detección de zombies        │ - AI Agent  │
-│ - Matriz de colisiones        │ - portmaster clean            │   Diagnosis │
+│ - Matriz de colisiones        │ - stackhelx clean             │   Diagnosis │
 └───────────────────────────────┴───────────────────────────────┴─────────────┘
 ```
 
@@ -30,15 +30,15 @@ Este documento define la evolución de PortMaster desde un orquestador de *stack
 ## 2. Especificación de Fases y Módulos
 
 ### Fase 1: Variables de Entorno y Hooks del Stack
-*   **Módulo**: [`portmaster/config.py`](../portmaster/config.py), [`portmaster/runner.py`](../portmaster/runner.py)
+*   **Módulo**: [`stackhelx/config.py`](../stackhelx/config.py), [`stackhelx/runner.py`](../stackhelx/runner.py)
 *   **`env_file`**: Carga de `.env`, `.env.local` o lista ordenada sin dependencias externas.
 *   **Hooks de Ciclo de Vida**:
     *   `pre_start`: Ejecución síncrona preparatoria (ej. migraciones, build).
     *   `post_start`: Ejecución tras confirmación de salud (ej. `seed`, notificación).
-*   **Bóveda Global (`~/.portmaster/env.global`)**: Herencia automática de variables comunes entre proyectos.
+*   **Bóveda Global (`~/.stackhelx/env.global`)**: Herencia automática de variables comunes entre proyectos.
 
-### Fase 2: Runner de Tareas y Scripts de Proyecto (`portmaster run`)
-*   **Módulo**: [`portmaster/scripts.py`](../portmaster/scripts.py), [`portmaster/cli.py`](../portmaster/cli.py)
+### Fase 2: Runner de Tareas y Scripts de Proyecto (`stackhelx run`)
+*   **Módulo**: [`stackhelx/scripts.py`](../stackhelx/scripts.py), [`stackhelx/cli.py`](../stackhelx/cli.py)
 *   **Declaración en `stack.yaml`**:
     ```yaml
     scripts:
@@ -47,15 +47,15 @@ Este documento define la evolución de PortMaster desde un orquestador de *stack
       migrate: alembic upgrade head
       check: [lint, test]  # Pipeline secuencial
     ```
-*   **Comando CLI**: `portmaster run <script>` ejecuta en la raíz del proyecto, con el contexto de variables del stack.
+*   **Comando CLI**: `stackhelx run <script>` ejecuta en la raíz del proyecto, con el contexto de variables del stack.
 
-### Fase 3: Exposición Segura y Compartir (`portmaster share`)
-*   **Módulo**: [`portmaster/tunnel.py`](../portmaster/tunnel.py), [`portmaster/cli.py`](../portmaster/cli.py)
+### Fase 3: Exposición Segura y Compartir (`stackhelx share`)
+*   **Módulo**: [`stackhelx/tunnel.py`](../stackhelx/tunnel.py), [`stackhelx/cli.py`](../stackhelx/cli.py)
 *   **Integración de Túneles**: Detección y manejo de binarios locales (`cloudflared`, `ngrok`, `tailscale`).
-*   **Comando CLI & Web**: `portmaster share web` genera URL pública temporal, QR en consola y botón directo en la UI web.
+*   **Comando CLI & Web**: `stackhelx share web` genera URL pública temporal, QR en consola y botón directo en la UI web.
 
 ### Fase 4: Orquestación Multi-Proyecto y Dependencias Inter-Repositorios
-*   **Módulo**: [`portmaster/registry.py`](../portmaster/registry.py), [`portmaster/runner.py`](../portmaster/runner.py)
+*   **Módulo**: [`stackhelx/registry.py`](../stackhelx/registry.py), [`stackhelx/runner.py`](../stackhelx/runner.py)
 *   **Proyectos Compuestos (`includes`)**:
     ```yaml
     # frontend/stack.yaml
@@ -63,28 +63,28 @@ Este documento define la evolución de PortMaster desde un orquestador de *stack
     includes:
       - ../backend-api  # Levanta backend automáticamente si no está corriendo
     ```
-*   **Grupos de Proyectos**: `portmaster group up <nombre_grupo>` y matriz preventiva de colisión de puertos.
+*   **Grupos de Proyectos**: `stackhelx group up <nombre_grupo>` y matriz preventiva de colisión de puertos.
 
-### Fase 5: Higiene del Sistema y Docker (`portmaster clean`)
-*   **Módulo**: [`portmaster/docker.py`](../portmaster/docker.py), [`portmaster/cli.py`](../portmaster/cli.py)
+### Fase 5: Higiene del Sistema y Docker (`stackhelx clean`)
+*   **Módulo**: [`stackhelx/docker.py`](../stackhelx/docker.py), [`stackhelx/cli.py`](../stackhelx/cli.py)
 *   **Limpieza Asistida**:
-    *   `portmaster clean` (con `--volumes` opcional): Remueve contenedores parados, imágenes huérfanas, build-cache y redes no usadas.
-    *   `portmaster doctor`: Diagnóstico integral del entorno local y detección de problemas.
+    *   `stackhelx clean` (con `--volumes` opcional): Remueve contenedores parados, imágenes huérfanas, build-cache y redes no usadas.
+    *   `stackhelx doctor`: Diagnóstico integral del entorno local y detección de problemas.
 
 ### Fase 6: Servidor MCP e Integración con Agentes de IA
-*   **Módulo**: [`portmaster/mcp.py`](../portmaster/mcp.py)
+*   **Módulo**: [`stackhelx/mcp.py`](../stackhelx/mcp.py)
 *   **Herramientas MCP Expuestas**:
-    *   `portmaster_status`: Estado de salud, puertos y procesos.
-    *   `portmaster_restart`: Reinicio atómico de un servicio específico.
-    *   `portmaster_logs`: Consulta de logs con filtrado para depuración autónoma.
-    *   `portmaster_free_port`: Liberación de puertos conflictivos.
-    *   `portmaster_clean`: Limpieza segura de recursos Docker.
-    *   `portmaster_doctor`: Diagnóstico integral del sistema.
-    *   `portmaster_history`: Historial de arranques de proyectos.
-    *   `portmaster_init`: Inicialización asistida de `stack.yaml`.
+    *   `stackhelx_status`: Estado de salud, puertos y procesos.
+    *   `stackhelx_restart`: Reinicio atómico de un servicio específico.
+    *   `stackhelx_logs`: Consulta de logs con filtrado para depuración autónoma.
+    *   `stackhelx_free_port`: Liberación de puertos conflictivos.
+    *   `stackhelx_clean`: Limpieza segura de recursos Docker.
+    *   `stackhelx_doctor`: Diagnóstico integral del sistema.
+    *   `stackhelx_history`: Historial de arranques de proyectos.
+    *   `stackhelx_init`: Inicialización asistida de `stack.yaml`.
 
 ### Fase 7: Detección Avanzada (Monorrepos, `uv`, Frameworks) y UI Web Polish
-*   **Módulo**: [`portmaster/detect.py`](../portmaster/detect.py), [`portmaster/web/`](../portmaster/web)
+*   **Módulo**: [`stackhelx/detect.py`](../stackhelx/detect.py), [`stackhelx/web/`](../stackhelx/web)
 *   Detección de `pnpm-workspace.yaml`, `turbo.json`, `uv.lock`, Astro (`4321`), Vite (`5173`).
 *   UI Web: Pausa y búsqueda en streaming de logs, editor de `stack.yaml` y disparador de tareas `run`.
 

{stackhelx-1.0.0 → stackhelx-1.1.0}/docs/plan-lenguajes.md

@@ -15,7 +15,7 @@
 
 Fecha: 7 de septiembre de 2026. Rama `main`, 432 tests en verde.
 
-PortMaster detecta hoy compose, Python, Node, Deno, Go, Rust, Ruby, PHP y .NET.
+StackHelx detecta hoy compose, Python, Node, Deno, Go, Rust, Ruby, PHP y .NET.
 Una carpeta con un proyecto de otro lenguaje no devuelve nada y obliga a escribir
 el `stack.yaml` a mano. Este plan cierra los tres huecos que tienen usuarios
 reales de desarrollo local multi-servicio: la JVM (Java y Kotlin), Elixir y Bun
@@ -298,8 +298,8 @@ primero). Y se verifica revirtiendo, como todo lo demás acá.
 
 Cada PR toca:
 
-- `portmaster/detect.py`: las dos funciones, sus constantes, y el nombre en la tupla de `detect()`.
-- `portmaster/browse.py`: el marcador nuevo en `MARKERS` (`pom.xml`, `build.gradle`, `mix.exs`, `bunfig.toml`), que es lo que pinta el badge en el explorador de carpetas.
+- `stackhelx/detect.py`: las dos funciones, sus constantes, y el nombre en la tupla de `detect()`.
+- `stackhelx/browse.py`: el marcador nuevo en `MARKERS` (`pom.xml`, `build.gradle`, `mix.exs`, `bunfig.toml`), que es lo que pinta el badge en el explorador de carpetas.
 - `tests/test_detect.py`: los casos de arriba, negativo incluido.
 - `docs/deteccion.md`, `README.md` y `CHANGELOG.md`. De `CLAUDE.md`: lo que se escribe en la doc se comprueba corriendo el comando, no recordándolo.
 

{stackhelx-1.0.0 → stackhelx-1.1.0}/stack.example.yaml

@@ -1,7 +1,7 @@
-# Esquema de configuracion de PortMaster.
+# Esquema de configuracion de StackHelx.
 #
-# El archivo es opcional: sin uno, PortMaster detecta los servicios del proyecto.
-# `portmaster init` escribe lo detectado aca para editarlo a mano.
+# El archivo es opcional: sin uno, StackHelx detecta los servicios del proyecto.
+# `stackhelx init` (o `shx init`) escribe lo detectado aca para editarlo a mano.
 
 name: mi-proyecto
 

stackhelx-1.1.0/stackhelx/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "1.1.0"
+

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/cli.py

@@ -892,19 +892,33 @@ def mcp_cmd(
         "-c",
         help="Muestra el bloque de configuracion JSON para Claude Desktop, Cursor o Antigravity.",
     ),
+    show_prompt: bool = typer.Option(
+        False,
+        "--prompt",
+        "-p",
+        help="Muestra las instrucciones recomendadas para el agente de IA.",
+    ),
 ) -> None:
     """Inicia el servidor Model Context Protocol (MCP) sobre stdio para agentes de IA."""
     if show_config:
         cfg = {
             "mcpServers": {
                 "stackhelx": {
-                    "command": "stackhelx",
+                    "command": "shx",
                     "args": ["mcp"],
                 }
             }
         }
         console.print(json.dumps(cfg, indent=2))
         return
+    if show_prompt:
+        console.print(
+            "Tienes a tu disposición las herramientas MCP de StackHelx (`stackhelx_*`). "
+            "Úsalas para inspeccionar el estado de puertos (`stackhelx_ports`), diagnosticar problemas de entorno (`stackhelx_doctor`), "
+            "liberar puertos en conflicto (`stackhelx_free`), levantar el stack del proyecto (`stackhelx_up`), "
+            "apagarlo (`stackhelx_down`), ejecutar scripts declarados (`stackhelx_run`) y compartir servicios vía túneles HTTPS (`stackhelx_share`)."
+        )
+        return
     mcp.serve_stdio()
 
 

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/mcp.py

@@ -420,7 +420,7 @@ def _reservar_stdout():
     """Deja el descriptor 1 solo para el protocolo y manda lo demas a stderr.
 
     Sobre stdio el JSON-RPC comparte el descriptor 1 con todo lo que imprima el
-    proceso. `portmaster_run` lanza los comandos del usuario heredando ese
+    proceso. `stackhelx_run` (o `portmaster_run`) lanza los comandos del usuario heredando ese
     descriptor, asi que un `echo` adentro de un script se metia entre dos
     respuestas y el cliente perdia la sesion.
 

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/ports.py

@@ -39,7 +39,7 @@ TERMINATE_TIMEOUT = 5
 
 
 class KillRefused(Exception):
-    """El proceso existe pero PortMaster se niega a matarlo."""
+    """El proceso existe pero StackHelx se niega a matarlo."""
 
 
 @dataclass(frozen=True)
@@ -356,7 +356,7 @@ def kill(
     no existe, y psutil.AccessDenied si faltan permisos.
     """
     # psutil.Process(None) es el proceso actual: sin esto, un scan que no vio al
-    # dueno del puerto termina en PortMaster matandose a si mismo.
+    # dueno del puerto termina en StackHelx matandose a si mismo.
     if pid is None:
         raise KillRefused("no hay PID que cerrar")
     if pid in PROTECTED_PIDS:
@@ -364,9 +364,9 @@ def kill(
 
     me = psutil.Process()
     if pid == me.pid:
-        raise KillRefused("ese PID es PortMaster")
+        raise KillRefused("ese PID es StackHelx")
     if pid in {ancestor.pid for ancestor in me.parents()}:
-        raise KillRefused(f"PID {pid} es un proceso padre de PortMaster (tu terminal)")
+        raise KillRefused(f"PID {pid} es un proceso padre de StackHelx (tu terminal)")
 
     proc = psutil.Process(pid)
     if create_time is not None and proc.create_time() != create_time:

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/registry.py

@@ -116,7 +116,7 @@ _docker_cache: tuple[float, bool] | None = None
 def declared_ports(max_age: float = 0.0) -> dict[int, list[Path]]:
     """Puerto declarado -> proyectos registrados que lo piden.
 
-    Es el unico dato que PortMaster tiene y las herramientas de un proyecto solo
+    Es el unico dato que StackHelx tiene y las herramientas de un proyecto solo
     no pueden tener: cada compose se conoce a si mismo y ninguno sabe del de al
     lado. Sin esto, que dos proyectos peleen por el 3000 se descubre cuando el
     segundo no arranca.
@@ -251,7 +251,7 @@ def _save(items: list[Path]) -> None:
 def token() -> str:
     """Token de la API local.
 
-    Prioriza PORTMASTER_TOKEN. Si no esta, usa uno generado en el directorio del
+    Prioriza STACKHELX_TOKEN (con fallback a PORTMASTER_TOKEN). Si no esta, usa uno generado en el directorio del
     usuario. Ver la desviacion documentada en CLAUDE.md: una herramienta que se
     instala con pipx no puede traer un .env, y un token generado con permisos
     0600 fuera del repo es mas seguro que uno que el usuario copia a mano.

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/runner.py

@@ -32,13 +32,15 @@ from .config import Service, Stack
 def build_env(service: Service, extra_env: dict[str, str] | None = None) -> dict[str, str]:
     """Construye el entorno de ejecucion con precedencia clara:
     1. os.environ
-    2. ~/.portmaster/env.global (si existe)
+    2. ~/.stackhelx/env.global (o legacy ~/.portmaster/env.global si existe)
     3. service.env_file (en orden)
     4. service.env (declarado explicito)
     5. extra_env (e.g. desde --env-file en CLI)
     """
     env = dict(os.environ)
-    global_env = Path.home() / ".portmaster" / "env.global"
+    global_env = Path.home() / ".stackhelx" / "env.global"
+    if not global_env.is_file():
+        global_env = Path.home() / ".portmaster" / "env.global"
     if global_env.is_file():
         env.update(config.parse_env_file(global_env))
     for env_path in service.env_file:
@@ -346,7 +348,7 @@ class Runner:
         if estrenados:
             # Un solo respiro para todo el lote, no uno por proceso: sin esto,
             # la primera lectura de un servicio recien arrancado seria 0.0 y
-            # `portmaster stats`, que hace una sola consulta, nunca mediria nada.
+            # `stackhelx stats`, que hace una sola consulta, nunca mediria nada.
             time.sleep(CPU_MUESTRA)
 
         vivos = {proc.pid for arbol in arboles.values() for proc in arbol}
@@ -692,7 +694,7 @@ def dependency_graph(stack: Stack, profile: str | None = None) -> dict:
 def run_stop(service: Service, extra_env: dict[str, str] | None = None) -> subprocess.CompletedProcess | None:
     """Corre el `stop:` de un servicio. None si no termino a tiempo.
 
-    Vive afuera del `Runner` porque `portmaster down` tiene que poder apagar un
+    Vive afuera del `Runner` porque `stackhelx down` tiene que poder apagar un
     stack que arranco otro proceso: los contenedores de un `docker compose up -d`
     sobreviven a la terminal que los levanto, y ahi no hay ningun `Proc` vivo del
     que colgarse.
@@ -755,7 +757,7 @@ def _port_hint(proc: Proc) -> str:
         quien = dueno.name or f"pid {dueno.pid}"
         return (
             f"; el puerto {declarado} ya lo tenia {quien} (pid {dueno.pid}):"
-            f" liberalo con `portmaster free {declarado}` y reintenta"
+            f" liberalo con `stackhelx free {declarado}` y reintenta"
         )
     return ""
 

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/scripts.py

@@ -33,7 +33,7 @@ def _entrecomillar(args: Sequence[str]) -> str:
 
     Iban con un `" ".join`, y estos comandos corren con `shell=True`: un
     argumento con un separador ejecutaba lo que viniera despues. Desde el CLI lo
-    escribe el usuario, pero `portmaster_run` los recibe de un agente de IA.
+    escribe el usuario, pero `stackhelx_run` (o `portmaster_run`) los recibe de un agente de IA.
 
     Por plataforma, porque el shell no es el mismo. `shlex.join` entrecomilla al
     estilo POSIX y `cmd.exe` no entiende las comillas simples: un `&` adentro le

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/server.py

@@ -54,7 +54,7 @@ from . import (
 # `browse_module` porque el endpoint de /api/browse ya se llama browse.
 from . import browse as browse_module
 
-log = logging.getLogger("portmaster.server")
+log = logging.getLogger("stackhelx.server")
 
 WEB = Path(__file__).parent / "web"
 LOG_LINES = 500
@@ -265,7 +265,7 @@ class Session:
         self.stopped_by_user = False
         self.state = "starting"
         self.sink.write(
-            f"\n[portmaster] Conmutando al perfil '{new_profile or 'default'}'...\n"
+            f"\n[stackhelx] Conmutando al perfil '{new_profile or 'default'}'...\n"
         )
         console = Console(
             file=self.sink, force_terminal=False, no_color=True, width=160, soft_wrap=True
@@ -695,7 +695,7 @@ def _cerrar_tuneles() -> None:
 async def _ciclo_de_vida(app: FastAPI):
     """Al apagar, cierra los tuneles.
 
-    Sin esto `portmaster serve` terminaba y el cliente de tuneles seguia vivo,
+    Sin esto `stackhelx serve` terminaba y el cliente de tuneles seguia vivo,
     con el puerto expuesto a internet, sin nada en pantalla que lo dijera y sin
     forma de cerrarlo que no fuera matarlo a mano.
     """
@@ -707,7 +707,7 @@ def create_app(token: str | None = None) -> FastAPI:
     _load_sessions_state()
     token = token or registry.token()
     app = FastAPI(
-        title="PortMaster",
+        title="StackHelx",
         docs_url=None,
         redoc_url=None,
         openapi_url=None,
@@ -1520,7 +1520,7 @@ def create_app(token: str | None = None) -> FastAPI:
             log.info("puerto rechazado: %s", exc)
             raise HTTPException(400, str(exc))
 
-        # PortMaster no se publica a si mismo. Detras de este puerto esta la API
+        # StackHelx no se publica a si mismo. Detras de este puerto esta la API
         # que arranca stack.yaml, o sea ejecucion de comandos: exponerla deja al
         # token como unica puerta contra internet entero. La validacion de Host
         # del middleware ya rechaza al cliente de tuneles, asi que hoy el efecto
@@ -1534,7 +1534,7 @@ def create_app(token: str | None = None) -> FastAPI:
         if propio is not None and port == propio:
             raise HTTPException(
                 400,
-                f"el puerto {port} es el de PortMaster. Publicarlo expone la API "
+                f"el puerto {port} es el de StackHelx. Publicarlo expone la API "
                 "que ejecuta los comandos de tu stack.yaml, no tu proyecto.",
             )
 

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/tunnel.py

@@ -146,7 +146,7 @@ def start_tunnel(
 
     # Mirando tambien si el proceso se murio, y no solo el reloj. Un cliente que
     # falla al arrancar (`ngrok` sin autenticar) se va en menos de un segundo, y
-    # esperarle el plazo entero dejaba a `portmaster share` pareciendo colgado
+    # esperarle el plazo entero dejaba a `stackhelx share` pareciendo colgado
     # antes de dar un error que ya se sabia.
     limite = time.monotonic() + timeout
     while not ready_event.wait(0.1):

{stackhelx-1.0.0 → stackhelx-1.1.0}/stackhelx/web/app.css

@@ -635,6 +635,7 @@ body {
   border-radius: var(--radius-sm);
   white-space: nowrap;
   align-self: center;
+  cursor: help;
 }
 
 .service__act {
@@ -1653,6 +1654,107 @@ body {
   margin-top: var(--space-sm);
 }
 
+.mcp__setup {
+  border: var(--rule) solid var(--color-rule);
+  border-radius: var(--radius);
+  background: var(--color-paper-2);
+  overflow: hidden;
+}
+
+.mcp__setup-summary {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: var(--space-xs) var(--space-sm);
+  font-size: var(--text-sm);
+  font-weight: 500;
+  color: var(--color-ink-2);
+  cursor: pointer;
+  user-select: none;
+  list-style: none;
+}
+
+.mcp__setup-summary::-webkit-details-marker {
+  display: none;
+}
+
+.mcp__setup-summary:hover {
+  color: var(--color-ink);
+  background: var(--color-paper-3);
+}
+
+.mcp__setup-summary:focus-visible {
+  outline: 2px solid var(--color-focus);
+  outline-offset: -2px;
+}
+
+.mcp__setup-icon {
+  font-size: var(--text-xs);
+  transition: transform 0.15s ease;
+}
+
+.mcp__setup[open] .mcp__setup-icon {
+  transform: rotate(180deg);
+}
+
+.mcp__setup-body {
+  padding: var(--space-sm) var(--space-md) var(--space-md);
+  border-top: var(--rule) solid var(--color-rule);
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-xs);
+}
+
+.mcp__setup-tabs {
+  display: flex;
+  gap: var(--space-md);
+  font-size: var(--text-xs);
+  color: var(--color-ink-2);
+}
+
+.mcp__setup-radio {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  cursor: pointer;
+}
+
+.mcp__code {
+  font-family: var(--font-mono);
+  font-size: var(--text-xs);
+  background: var(--color-paper);
+  border: var(--rule) solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  padding: var(--space-xs) var(--space-sm);
+  margin: 0;
+  white-space: pre;
+  overflow-x: auto;
+  color: var(--color-ink);
+}
+
+.mcp__setup-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-xs);
+  margin-top: 0.25rem;
+}
+
+.mcp__setup-hint {
+  font-size: var(--text-xs);
+  color: var(--color-ink-3);
+  margin: 0.25rem 0 0;
+  line-height: 1.4;
+}
+
+.mcp__setup-hint code {
+  font-family: var(--font-mono);
+  color: var(--color-ink-2);
+  background: var(--color-paper);
+  padding: 0.1rem 0.3rem;
+  border-radius: 3px;
+  border: var(--rule) solid var(--color-rule);
+}
+
 .mcp__stats {
   display: flex;
   flex-wrap: wrap;