stackhelx 1.0.1__tar.gz → 1.1.0__tar.gz

{stackhelx-1.0.1 → stackhelx-1.1.0}/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.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
@@ -558,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.1 → stackhelx-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stackhelx
-Version: 1.0.1
+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.1 → 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.1 → 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.1.0/stackhelx/__init__.py

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

{stackhelx-1.0.1 → 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.1 → 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.1 → stackhelx-1.1.0}/stackhelx/runner.py

@@ -348,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}

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

@@ -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.
     """

{stackhelx-1.0.1 → 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.1 → 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;

{stackhelx-1.0.1 → stackhelx-1.1.0}/stackhelx/web/app.js

@@ -52,6 +52,11 @@ const ui = {
   mcpQuotaUsed: document.getElementById("mcp-quota-used"),
   mcpBreakdown: document.getElementById("mcp-breakdown"),
   mcpTbody: document.getElementById("mcp-tbody"),
+  mcpSetup: document.getElementById("mcp-setup"),
+  mcpJsonSnippet: document.getElementById("mcp-json-snippet"),
+  btnMcpCopyJson: document.getElementById("btn-mcp-copy-json"),
+  btnMcpDownloadJson: document.getElementById("btn-mcp-download-json"),
+  btnMcpCopyPrompt: document.getElementById("btn-mcp-copy-prompt"),
 };
 
 const TITLE = document.title;
@@ -993,8 +998,15 @@ function updateCard(entry, project) {
     if (badge && metrics[s.name]) {
       const m = metrics[s.name];
       if (m.memory_mb > 0 || m.cpu_percent > 0) {
+        const coresEquiv = (m.cpu_percent / 100).toFixed(1);
+        const cpuInfo = m.cpu_percent > 100
+          ? `CPU: ${m.cpu_percent}% (~${coresEquiv} núcleos en paralelo)`
+          : `CPU: ${m.cpu_percent}% de 1 núcleo`;
+        const memInfo = `RAM: ${m.memory_mb} MB (memoria física residente RSS)`;
+
         badge.textContent = `${m.cpu_percent}% · ${m.memory_mb} MB`;
-        badge.setAttribute("aria-label", `CPU: ${m.cpu_percent}%, Memoria: ${m.memory_mb} MB`);
+        badge.title = `${cpuInfo}\n${memInfo}`;
+        badge.setAttribute("aria-label", `${cpuInfo}, ${memInfo}`);
         badge.hidden = false;
       } else {
         badge.hidden = true;
@@ -2298,9 +2310,47 @@ async function refreshPortsModal() {
 
 /* mcp modal ----------------------------------------------------------------- */
 
+const MCP_CONFIGS = {
+  shx: JSON.stringify(
+    {
+      mcpServers: {
+        stackhelx: {
+          command: "shx",
+          args: ["mcp"],
+        },
+      },
+    },
+    null,
+    2,
+  ),
+  uvx: JSON.stringify(
+    {
+      mcpServers: {
+        stackhelx: {
+          command: "uvx",
+          args: ["stackhelx", "mcp"],
+        },
+      },
+    },
+    null,
+    2,
+  ),
+};
+
+const MCP_AGENT_PROMPT =
+  "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 tomados (`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`).";
+
+function updateMcpSnippet() {
+  if (!ui.mcpJsonSnippet) return;
+  const checked = document.querySelector('input[name="mcp-cmd-type"]:checked');
+  const mode = checked ? checked.value : "shx";
+  ui.mcpJsonSnippet.textContent = MCP_CONFIGS[mode] || MCP_CONFIGS.shx;
+}
+
 if (ui.btnMcpModal && ui.mcpModal) {
   ui.btnMcpModal.addEventListener("click", () => {
     ui.mcpModal.showModal();
+    updateMcpSnippet();
     refreshMcpModal();
   });
   const closeBtn = ui.mcpModal.querySelector('[data-mcp-modal="close"]');
@@ -2309,7 +2359,57 @@ if (ui.btnMcpModal && ui.mcpModal) {
       ui.mcpModal.close();
     });
   }
+
+  document.querySelectorAll('input[name="mcp-cmd-type"]').forEach((radio) => {
+    radio.addEventListener("change", updateMcpSnippet);
+  });
+
+  if (ui.btnMcpCopyJson) {
+    ui.btnMcpCopyJson.addEventListener("click", () => {
+      const text = ui.mcpJsonSnippet ? ui.mcpJsonSnippet.textContent : "";
+      if (navigator.clipboard && text) {
+        navigator.clipboard.writeText(text).then(() => {
+          const orig = ui.btnMcpCopyJson.textContent;
+          ui.btnMcpCopyJson.textContent = "Copiado";
+          setTimeout(() => {
+            ui.btnMcpCopyJson.textContent = orig;
+          }, 1600);
+        });
+      }
+    });
+  }
+
+  if (ui.btnMcpDownloadJson) {
+    ui.btnMcpDownloadJson.addEventListener("click", () => {
+      const text = ui.mcpJsonSnippet ? ui.mcpJsonSnippet.textContent : "";
+      if (!text) return;
+      const blob = new Blob([text], { type: "application/json" });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement("a");
+      a.href = url;
+      a.download = "stackhelx-mcp.json";
+      document.body.append(a);
+      a.click();
+      a.remove();
+      URL.revokeObjectURL(url);
+    });
+  }
+
+  if (ui.btnMcpCopyPrompt) {
+    ui.btnMcpCopyPrompt.addEventListener("click", () => {
+      if (navigator.clipboard) {
+        navigator.clipboard.writeText(MCP_AGENT_PROMPT).then(() => {
+          const orig = ui.btnMcpCopyPrompt.textContent;
+          ui.btnMcpCopyPrompt.textContent = "Copiado";
+          setTimeout(() => {
+            ui.btnMcpCopyPrompt.textContent = orig;
+          }, 1600);
+        });
+      }
+    });
+  }
 }
+updateMcpSnippet();
 
 async function refreshMcpModal() {
   if (!ui.mcpModal) return;

{stackhelx-1.0.1 → stackhelx-1.1.0}/stackhelx/web/index.html

@@ -166,10 +166,39 @@
 
       <dialog class="picker mcp-modal" id="mcp-modal" aria-label="Telemetría de Agentes MCP">
         <div class="picker__head">
-          <p class="picker__path">Telemetría de Agentes MCP</p>
+          <p class="picker__path">Servidor MCP para Agentes</p>
           <button class="btn btn--quiet" type="button" data-mcp-modal="close">Cerrar</button>
         </div>
         <div class="mcp__content">
+          <details class="mcp__setup" id="mcp-setup">
+            <summary class="mcp__setup-summary">
+              <span>Configuración y Prompt para Agentes</span>
+              <span class="mcp__setup-icon" aria-hidden="true">▾</span>
+            </summary>
+            <div class="mcp__setup-body">
+              <div class="mcp__setup-tabs">
+                <label class="mcp__setup-radio">
+                  <input type="radio" name="mcp-cmd-type" value="shx" checked>
+                  <span>shx (recomendado)</span>
+                </label>
+                <label class="mcp__setup-radio">
+                  <input type="radio" name="mcp-cmd-type" value="uvx">
+                  <span>uvx (sin instalación)</span>
+                </label>
+              </div>
+              <pre class="mcp__code" id="mcp-json-snippet"></pre>
+              <div class="mcp__setup-actions">
+                <button class="btn btn--quiet" type="button" id="btn-mcp-copy-json">Copiar JSON</button>
+                <button class="btn btn--quiet" type="button" id="btn-mcp-download-json">Descargar .json</button>
+                <button class="btn btn--quiet" type="button" id="btn-mcp-copy-prompt">Copiar Prompt</button>
+              </div>
+              <p class="mcp__setup-hint">
+                <strong>Claude Desktop (Windows):</strong> <code>%APPDATA%\Claude\claude_desktop_config.json</code><br>
+                <strong>Cursor:</strong> <code>.cursor/mcp.json</code>
+              </p>
+            </div>
+          </details>
+
           <div class="mcp__stats">
             <span class="mcp__stat">Llamadas totales: <strong id="mcp-total-calls">0</strong></span>
             <span class="mcp__stat">Cuota activa: <strong id="mcp-quota-used">0/30</strong> req/min</span>

{stackhelx-1.0.1 → stackhelx-1.1.0}/tests/test_cli.py

@@ -992,3 +992,37 @@ def test_mcp_status_cli():
     assert "stackhelx_status" in resultado.output
 
 
+def test_project_scripts_register_stackhelx_and_shx():
+    """pyproject.toml debe registrar tanto 'stackhelx' como el alias corto 'shx'."""
+    from pathlib import Path
+
+    pyproject_path = Path(__file__).resolve().parent.parent / "pyproject.toml"
+    try:
+        import tomllib
+
+        with open(pyproject_path, "rb") as f:
+            data = tomllib.load(f)
+        scripts = data["project"]["scripts"]
+        assert scripts.get("stackhelx") == "stackhelx.cli:app"
+        assert scripts.get("shx") == "stackhelx.cli:app"
+    except ImportError:
+        texto = pyproject_path.read_text(encoding="utf-8")
+        assert 'stackhelx = "stackhelx.cli:app"' in texto
+        assert 'shx = "stackhelx.cli:app"' in texto
+
+
+def test_mcp_config_and_prompt_cli():
+    """El comando mcp --config y --prompt imprimen el JSON y las instrucciones del agente."""
+    res_cfg = runner.invoke(cli.app, ["mcp", "--config"])
+    assert res_cfg.exit_code == 0
+    assert "mcpServers" in res_cfg.output
+    assert "stackhelx" in res_cfg.output
+
+    res_prompt = runner.invoke(cli.app, ["mcp", "--prompt"])
+    assert res_prompt.exit_code == 0
+    assert "stackhelx_*" in res_prompt.output
+    assert "stackhelx_ports" in res_prompt.output
+
+
+
+

{stackhelx-1.0.1 → stackhelx-1.1.0}/tests/test_scripts.py

@@ -174,7 +174,7 @@ def test_un_ciclo_entre_scripts_se_detecta(tmp_path):
 def test_un_argumento_extra_no_ejecuta_un_segundo_comando(tmp_path):
     """Los extra_args iban con un `" ".join` y esto corre con `shell=True`.
 
-    Desde el CLI el argumento lo escribe el usuario, pero `portmaster_run` los
+    Desde el CLI el argumento lo escribe el usuario, pero `stackhelx_run` (o `portmaster_run`) los
     recibe de un agente de IA: un separador adentro de un argumento ejecutaba lo
     que viniera despues.
 

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

@@ -2278,3 +2278,36 @@ def test_cache_invalidation_race_no_reinyecta_viejo(tmp_path):
 
     with server._stack_lock:
         assert clave not in server._stack_seen
+
+
+def test_metrics_badge_has_tooltip_and_cursor_help():
+    """El badge de consumo debe proveer tooltip explicativo (title) y cursor help."""
+    js = (server.WEB / "app.js").read_text(encoding="utf-8")
+    assert "badge.title = `${cpuInfo}\\n${memInfo}`" in js
+    assert "núcleos en paralelo" in js
+    assert "memoria física residente RSS" in js
+
+    css = (server.WEB / "app.css").read_text(encoding="utf-8")
+    assert ".service__metrics" in css
+    assert "cursor: help" in css
+
+
+def test_mcp_setup_collapsible_details():
+    """El modal de MCP debe tener una sección desplegable para configuración y prompt."""
+    html = (server.WEB / "index.html").read_text(encoding="utf-8")
+    assert '<details class="mcp__setup" id="mcp-setup">' in html
+    assert 'id="btn-mcp-copy-json"' in html
+    assert 'id="btn-mcp-download-json"' in html
+    assert 'id="btn-mcp-copy-prompt"' in html
+
+    js = (server.WEB / "app.js").read_text(encoding="utf-8")
+    assert "btnMcpCopyJson" in js
+    assert "btnMcpDownloadJson" in js
+    assert "btnMcpCopyPrompt" in js
+    assert "stackhelx-mcp.json" in js
+
+    css = (server.WEB / "app.css").read_text(encoding="utf-8")
+    assert ".mcp__setup" in css
+    assert ".mcp__setup-summary" in css
+
+

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

@@ -199,7 +199,7 @@ def test_start_tunnel_no_espera_a_un_cliente_que_ya_murio(proveedor_falso):
     """`ngrok` sin autenticar imprime el error y se va en menos de un segundo.
 
     Esperar el timeout entero ahi es tiempo regalado: el proceso esta muerto y
-    la URL no va a aparecer nunca. Con 15s por defecto, `portmaster share`
+    la URL no va a aparecer nunca. Con 15s por defecto, `stackhelx share`
     parecia colgado antes de dar un error que ya se sabia.
     """
     proveedor_falso("ngrok", ["ERR authentication failed"], vivo=False)
@@ -229,7 +229,7 @@ def test_tailscale_no_confunde_un_enlace_del_log_con_el_tunel():
 
 
 def test_el_mcp_cierra_sus_tuneles_al_terminar_la_sesion(tmp_path, proveedor_falso):
-    """`portmaster_share` abria el tunel y nadie lo cerraba nunca.
+    """`stackhelx_share` abria el tunel y nadie lo cerraba nunca.
 
     Es el mismo agujero que `server._ciclo_de_vida` ya documenta para la
     interfaz: la sesion terminaba y el cliente seguia vivo, con el puerto
@@ -242,7 +242,7 @@ def test_el_mcp_cierra_sus_tuneles_al_terminar_la_sesion(tmp_path, proveedor_fal
     proveedor_falso("cloudflared", lineas)
     mcp.cerrar_tuneles()  # arrancar de cero: el registro es de modulo
 
-    # `portmaster_share` solo publica puertos que el proyecto declara, asi que
+    # `stackhelx_share` solo publica puertos que el proyecto declara, asi que
     # el test necesita un proyecto. Antes corria contra el cwd, que es este
     # repo, que no tiene stack.yaml: la validacion nueva lo dejo en rojo y con
     # el se cayo la unica prueba de que la sesion no deja el cliente vivo.

stackhelx-1.0.1/stackhelx/__init__.py

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