stackhelx 1.0.0__tar.gz → 1.0.1__tar.gz

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

@@ -4,6 +4,16 @@ 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.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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stackhelx
-Version: 1.0.0
+Version: 1.0.1
 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

{stackhelx-1.0.0 → stackhelx-1.0.1}/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.0.1}/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.0.1}/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.0.1/stackhelx/__init__.py

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

{stackhelx-1.0.0 → stackhelx-1.0.1}/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.0.1}/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.0.1}/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:
@@ -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.0.1}/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.0.1}/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
@@ -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.0.1}/tests/test_cli.py

@@ -29,7 +29,7 @@ def sin_color(texto: str) -> str:
     Rich pinta los numeros, asi que `f"El puerto {port} ya esta ocupado"` llega
     partido por un `\x1b[1;36m` en el medio y un `in` plano no lo encuentra. Solo
     aparece cuando el entorno trae `FORCE_COLOR` (la terminal del desarrollador,
-    o un `portmaster up` que se lo pone a sus hijos): sin eso Rich ve que no hay
+    o un `stackhelx up` que se lo pone a sus hijos): sin eso Rich ve que no hay
     tty y no pinta nada, que es por lo que en CI el test daba verde.
 
     Afirmar sobre el texto pelado, y no sobre como se ve, es lo correcto igual:
@@ -245,7 +245,7 @@ def _proyecto_con_puerto(tmp_path, nombre, port):
 
 
 def test_doctor_avisa_si_otro_proyecto_declara_el_mismo_puerto(tmp_path, monkeypatch, free_ports):
-    """El dato que solo PortMaster tiene: ningun compose sabe del de al lado."""
+    """El dato que solo StackHelx tiene: ningun compose sabe del de al lado."""
     (port,) = free_ports(1)
     _proyecto_con_puerto(tmp_path, "blog", port)
     fitness = _proyecto_con_puerto(tmp_path, "fitness", port)
@@ -819,7 +819,7 @@ def test_open_sin_puerto_no_tapa_al_servicio_que_si_contesta(
 def test_share_rechaza_un_puerto_fuera_de_rango(tmp_path, monkeypatch):
     """`target` es texto porque tambien acepta el nombre de un servicio, asi que
     se pierde el min/max que traen los demas comandos. Sin la validacion a mano,
-    `portmaster share 0` levantaba el cliente de tuneles contra 127.0.0.1:0.
+    `stackhelx share 0` levantaba el cliente de tuneles contra 127.0.0.1:0.
     """
     monkeypatch.chdir(tmp_path)
     for target in ("0", "70000", "99999"):

{stackhelx-1.0.0 → stackhelx-1.0.1}/tests/test_detect.py

@@ -471,7 +471,7 @@ COMPOSE_CON_PERFILES = """
 
 
 def test_un_contenedor_con_perfil_no_arranca_por_defecto(tmp_path):
-    """En compose, `profiles:` excluye. En PortMaster un perfil es una lista de
+    """En compose, `profiles:` excluye. En StackHelx un perfil es una lista de
     lo que se arranca. Traducirlos al reves arranca lo que compose apaga."""
     write(tmp_path, "compose.yaml", COMPOSE_CON_PERFILES)
     stack = detect.detect(tmp_path)
@@ -541,7 +541,7 @@ def test_un_compose_sin_perfiles_arranca_todo(tmp_path):
 
 
 def test_congelar_un_compose_con_perfiles_no_cambia_lo_que_arranca(tmp_path):
-    """`portmaster init` tiene que ser fiel: el archivo congelado arranca lo
+    """`stackhelx init` tiene que ser fiel: el archivo congelado arranca lo
     mismo que la deteccion, ni un contenedor mas."""
     write(tmp_path, "compose.yaml", COMPOSE_CON_PERFILES)
     detectado = detect.detect(tmp_path)

{stackhelx-1.0.0 → stackhelx-1.0.1}/tests/test_mcp.py

@@ -318,7 +318,7 @@ def test_mcp_una_peticion_con_id_si_se_contesta():
 
 
 def test_mcp_tool_call_doctor(tmp_path):
-    """Prueba que portmaster_doctor ejecuta los checks sin crash."""
+    """Prueba que stackhelx_doctor ejecuta los checks sin crash."""
     req = {
         "jsonrpc": "2.0",
         "id": 30,
@@ -332,7 +332,7 @@ def test_mcp_tool_call_doctor(tmp_path):
 
 
 def test_mcp_tool_call_history(tmp_path, monkeypatch):
-    """Prueba que portmaster_history lee la telemetria."""
+    """Prueba que stackhelx_history lee la telemetria."""
     monkeypatch.setattr(mcp.registry, "HOME", tmp_path)
     pid = mcp.registry.project_id(tmp_path)
     mcp.history.append(pid, {"event": "test", "duration_s": 1.5})
@@ -352,7 +352,7 @@ def test_mcp_tool_call_history(tmp_path, monkeypatch):
 
 
 def test_mcp_tool_call_ports(free_ports):
-    """Prueba que portmaster_ports retorna lista de puertos formateada."""
+    """Prueba que stackhelx_ports retorna lista de puertos formateada."""
     (port,) = free_ports(1)
     req = {
         "jsonrpc": "2.0",

{stackhelx-1.0.0 → stackhelx-1.0.1}/tests/test_runner.py

@@ -657,7 +657,7 @@ def test_niveles_de_una_cadena_lineal():
 
 def test_env_file_inyecta_variables(tmp_path, free_ports):
     (port,) = free_ports(1)
-    (tmp_path / ".env").write_text("CUSTOM_VAR=portmaster_rocks\n", encoding="utf-8")
+    (tmp_path / ".env").write_text("CUSTOM_VAR=stackhelx_rocks\n", encoding="utf-8")
     flag = tmp_path / "env_result.txt"
 
     stack = stack_from(
@@ -674,7 +674,7 @@ def test_env_file_inyecta_variables(tmp_path, free_ports):
     try:
         engine.up()
         assert flag.exists()
-        assert flag.read_text(encoding="utf-8") == "portmaster_rocks"
+        assert flag.read_text(encoding="utf-8") == "stackhelx_rocks"
     finally:
         engine.down()
 
@@ -726,7 +726,7 @@ def test_pre_start_fallo_aborta_arranque(tmp_path, free_ports):
 
 @pytest.fixture
 def sin_env_global(tmp_path, monkeypatch):
-    """`build_env` lee `~/.portmaster/env.global`, o sea el disco de quien corre.
+    """`build_env` lee `~/.stackhelx/env.global` (o `~/.portmaster/env.global`), o sea el disco de quien corre.
 
     Las reglas de precedencia dejan las aserciones de abajo a salvo hoy, pero un
     env.global que defina una de las variables que estos tests dan por ausentes
@@ -1271,3 +1271,41 @@ def test_bun_detectado_arranca_y_abre_el_puerto(tmp_path, free_ports):
     while time.time() < deadline and not ports.is_free(port):
         time.sleep(0.1)
     assert ports.is_free(port), "el puerto quedo tomado despues de down()"
+
+
+def test_build_env_compatibilidad_stackhelx_y_portmaster(tmp_path, monkeypatch):
+    """build_env lee ~/.stackhelx/env.global y usa ~/.portmaster/env.global como fallback."""
+    hogar = tmp_path / "home"
+    hogar.mkdir()
+    monkeypatch.setattr(Path, "home", classmethod(lambda cls: hogar))
+
+    srv = config.Service(
+        name="srv",
+        command="echo ok",
+        cwd=tmp_path,
+        port=8080,
+        ready="port",
+        needs=(),
+        env={},
+        detached=False,
+    )
+
+    # 1. Sin archivo
+    env = runner.build_env(srv)
+    assert "MI_GLOBAL" not in env
+
+    # 2. Solo portmaster legacy
+    dir_portmaster = hogar / ".portmaster"
+    dir_portmaster.mkdir()
+    (dir_portmaster / "env.global").write_text("MI_GLOBAL=desde_portmaster\nOTRA_VAR=1\n", encoding="utf-8")
+    env = runner.build_env(srv)
+    assert env.get("MI_GLOBAL") == "desde_portmaster"
+    assert env.get("OTRA_VAR") == "1"
+
+    # 3. StackHelx sobrescribe portmaster legacy
+    dir_stackhelx = hogar / ".stackhelx"
+    dir_stackhelx.mkdir()
+    (dir_stackhelx / "env.global").write_text("MI_GLOBAL=desde_stackhelx\n", encoding="utf-8")
+    env = runner.build_env(srv)
+    assert env.get("MI_GLOBAL") == "desde_stackhelx"
+

{stackhelx-1.0.0 → stackhelx-1.0.1}/tests/test_server.py

@@ -1024,7 +1024,7 @@ def test_el_chequeo_de_docker_no_corre_en_cada_request(client, tmp_path, monkeyp
 
 
 def _sesion_recuperada(tmp_path, port):
-    """Simula un reinicio de `portmaster serve` con el proceso todavia vivo."""
+    """Simula un reinicio de `stackhelx serve` con el proceso todavia vivo."""
     import json
 
     root = tmp_path / "sobreviviente"
@@ -1279,7 +1279,7 @@ def _tunel_falso(monkeypatch, proc):
 
 
 def test_los_tuneles_se_cierran_al_apagar_el_servidor(monkeypatch, free_ports):
-    """`portmaster serve` terminaba y el cliente de tuneles seguia vivo.
+    """`stackhelx serve` terminaba y el cliente de tuneles seguia vivo.
 
     El puerto quedaba expuesto a internet, sin nada en pantalla que lo dijera y
     sin forma de cerrarlo salvo matar el proceso a mano.
@@ -2088,7 +2088,7 @@ def test_browse_frecuentes(client, tmp_path, monkeypatch):
 
 
 def test_share_rechaza_el_puerto_propio(client, monkeypatch):
-    """PortMaster no se publica a si mismo.
+    """StackHelx no se publica a si mismo.
 
     Detras de ese puerto esta la API que corre los comandos de stack.yaml, o
     sea ejecucion arbitraria: el token pasa a ser lo unico entre internet y tu
@@ -2107,7 +2107,7 @@ def test_share_rechaza_el_puerto_propio(client, monkeypatch):
 
     res = client.post("/api/share?port=80")
     assert res.status_code == 400
-    assert llamadas == [], "se abrio un tunel hacia el puerto de PortMaster"
+    assert llamadas == [], "se abrio un tunel hacia el puerto de StackHelx"
 
 
 def test_share_no_confia_en_el_header_host(client, monkeypatch):

{stackhelx-1.0.0 → stackhelx-1.0.1}/tests/test_tunnel.py

@@ -275,12 +275,12 @@ def test_el_mcp_rechaza_un_puerto_fuera_de_rango():
         mcp._execute_tool("stackhelx_share", {"port": 0})
 
 
-def test_no_se_publica_un_portmaster_serve(monkeypatch):
+def test_no_se_publica_un_stackhelx_serve(monkeypatch):
     """El unico choke point de los tuneles se niega a exponer la propia API.
 
     Detras de ese puerto esta lo que corre los comandos de stack.yaml. Va aca y
     no en el comando porque por `start_tunnel` pasan los tres caminos: el boton
-    de la interfaz, `portmaster share` y el CLI.
+    de la interfaz, `stackhelx share` y el CLI.
 
     Se afirma el efecto: que no se lance ningun cliente de tuneles.
     """
@@ -290,7 +290,7 @@ def test_no_se_publica_un_portmaster_serve(monkeypatch):
         tunnel.ports,
         "scan",
         lambda port: tunnel.ports.PortStatus(
-            port=port, free=False, pid=123, cmdline="python -m portmaster serve --port 7666"
+            port=port, free=False, pid=123, cmdline="python -m stackhelx serve --port 7666"
         ),
     )
 
@@ -299,7 +299,7 @@ def test_no_se_publica_un_portmaster_serve(monkeypatch):
     assert lanzados == [], "se levanto un cliente de tuneles contra la propia API"
 
 
-def test_un_puerto_ajeno_no_se_confunde_con_portmaster(monkeypatch):
+def test_un_puerto_ajeno_no_se_confunde_con_stackhelx(monkeypatch):
     """La otra mitad: la guarda no puede frenar un tunel legitimo.
 
     Sin esto, un `return True` constante pasaria el test de arriba.

stackhelx-1.0.0/stackhelx/__init__.py

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