xonecode 0.8.27 → 0.8.37

package/dist/core/trazaDeErrores.js

@@ -0,0 +1,108 @@
+/**
+ * El registro de lo que se traga un `catch`.
+ *
+ * **Por qué hace falta.** Este harness tiene 123 `catch` y casi todos callan a propósito: que
+ * no se pueda leer un adjunto, que falle el validador, que `git` no esté — ninguna de esas
+ * cosas puede tumbar un turno, y por eso se devuelven en vez de lanzarse. El precio es que
+ * cuando algo va mal **no queda rastro de nada**. Medido sobre una sesión que se colgó: el
+ * proceso estaba vivo y OCIOSO —`kevent`, sin un socket abierto, sin trabajo—, el `.jsonl`
+ * acababa en el mensaje de la persona sin su `fin`, y desde fuera no había forma de saber
+ * dónde se quedó. No es que el registro fuera pobre: es que no existía.
+ *
+ * **Es la misma pieza que `XONECODE_TRACE_TOOLS`** (`agent/turno/diagnosticoDeTools.ts`) y por
+ * la misma razón: apagado no cuesta nada, encendido deja un `.jsonl` que se puede leer después.
+ * Lo que cambia es qué anota — allí a dónde se fueron los tokens, aquí qué se calló.
+ *
+ * **Y el sumidero entra por PARÁMETRO**, como el de `core/bitacora.ts`: este módulo vive en
+ * `core/` y no toca disco, así que `npm test` no escribe nada y quien lo prueba ve lo que se
+ * anotó sin abrir un fichero.
+ */
+/**
+ * El mensaje de un error, sin lo que no puede salir de la máquina.
+ *
+ * **Un error de Node lleva la ruta absoluta dentro del mensaje** —«ENOENT: no such file or
+ * directory, open '/Users/alguien/…'»— y este registro acaba en un `.jsonl` que una persona
+ * puede mirar por un túnel. Es la misma regla que ya obliga a `codigoDe` y a quedarse con el
+ * `error.name` en las guardas: de un error de Node, solo lo que no identifica a nadie.
+ *
+ * Las rutas se SUSTITUYEN en vez de tirar el mensaje entero, porque lo que queda —«ENOENT: no
+ * such file or directory, open '<ruta>'»— sigue diciendo qué pasó.
+ */
+export function mensajeSeguro(mensaje) {
+    return mensaje
+        .replace(/(['"`])\/(?:[^'"`\s]|\\ )*\1/g, "$1<ruta>$1")
+        .replace(/(?<![\w'"`/])\/(?:Users|home|private|Volumes|tmp|var|opt)\/[^\s'"`,;)]*/g, "<ruta>");
+}
+/** De un error, lo que se puede contar. */
+export function anotable(donde, error) {
+    if (error instanceof Error) {
+        const codigo = error.code;
+        return {
+            donde,
+            nombre: error.name,
+            ...(typeof codigo === "string" ? { codigo } : {}),
+            mensaje: mensajeSeguro(error.message),
+        };
+    }
+    return { donde, nombre: "desconocido", mensaje: mensajeSeguro(String(error)) };
+}
+let sumidero;
+/**
+ * Enchufa el sumidero. Sin esto, anotar no hace NADA — que es lo que debe pasar apagado.
+ *
+ * Es global a propósito, y es la única forma que funciona aquí: los sitios que se tragan una
+ * excepción están repartidos por todo el árbol —`core/`, `agent/`, `web/`— y muchos viven en
+ * funciones puras sin sitio donde inyectar nada. Pasarlo por parámetro habría obligado a
+ * cambiar la firma de medio harness para añadir una línea de diagnóstico, y eso es justo el
+ * cambio que nadie hace.
+ */
+export function ponerSumideroDeErrores(nuevo) {
+    sumidero = nuevo;
+}
+/**
+ * Anota lo que un `catch` acaba de tragarse. **No cambia lo que pasa después.**
+ *
+ * Quien la llama sigue haciendo exactamente lo mismo que hacía: devolver `undefined`, seguir
+ * adelante, tragarse el fallo. Esto es un testigo, no una decisión — si además cambiara el
+ * control, cada sitio habría que volver a medirlo.
+ *
+ * Y NUNCA lanza: un registro de diagnóstico que rompe lo que observa es peor que no tenerlo.
+ */
+export function anotarError(donde, error) {
+    if (sumidero === undefined)
+        return;
+    emitir(anotable(donde, error));
+}
+/**
+ * Anota que algo EMPIEZA, y devuelve la función que anota que acabó.
+ *
+ * Se usa envolviendo, no con dos llamadas sueltas: `const fin = anotarPaso(...); try { … }
+ * finally { fin(); }`. Así el `fin` no se puede olvidar en la rama del error, que es
+ * justamente la rama que interesa.
+ *
+ * Apagado no cuesta nada —ni una fecha— porque se sale antes de mirar el reloj.
+ */
+export function anotarPaso(donde, detalle) {
+    if (sumidero === undefined)
+        return () => { };
+    const t0 = Date.now();
+    emitir({ donde, fase: "inicio", ...(detalle === undefined ? {} : { detalle }) });
+    let cerrado = false;
+    return () => {
+        if (cerrado)
+            return;
+        cerrado = true;
+        emitir({ donde, fase: "fin", ...(detalle === undefined ? {} : { detalle }), ms: Date.now() - t0 });
+    };
+}
+function emitir(anotado) {
+    if (sumidero === undefined)
+        return;
+    try {
+        sumidero(anotado);
+    }
+    catch {
+        // Ni el testigo puede tumbar a quien observa.
+    }
+}
+//# sourceMappingURL=trazaDeErrores.js.map

package/dist/core/trazaDeErrores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trazaDeErrores.js","sourceRoot":"","sources":["../../src/core/trazaDeErrores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiCH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO;SACX,OAAO,CAAC,+BAA+B,EAAE,YAAY,CAAC;SACtD,OAAO,CAAC,0EAA0E,EAAE,QAAQ,CAAC,CAAC;AACnG,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAc;IACpD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAI,KAA4B,CAAC,IAAI,CAAC;QAClD,OAAO;YACL,KAAK;YACL,MAAM,EAAE,KAAK,CAAC,IAAI;YAClB,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;SACtC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAKD,IAAI,QAAuC,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAoC;IACzE,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,KAAc;IACvD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAgB;IACxD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,GAAG,EAAE;QACV,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACrG,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,OAAmC;IACjD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,IAAI,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;AACH,CAAC"}

package/dist/web/servidor/consolaWeb.js

@@ -27,6 +27,7 @@
  * el prellenado del mapa, no en quién compara la cadena.
  */
 import { crearPielWeb } from "./pielWeb.js";
+import { anotarPaso } from "../../core/trazaDeErrores.js";
 import { crearTransporte } from "./transporte.js";
 import { CatalogoModelosEnMemoria } from "../../core/ports.js";
 import { REJECT_MESSAGE } from "../../vendor/hitl.js";
@@ -245,6 +246,10 @@ export function crearConsolaWeb(opciones = {}) {
             const decisiones = new Map(pendientes.map((p) => [p.id, { type: "reject", message: REJECT_MESSAGE }]));
             if (!transporte.conectado())
                 return Promise.resolve(decisiones);
+            // El hito dice CUÁNTAS escrituras se pusieron delante de alguien y cuánto tardó en
+            // contestar. Un `inicio` sin `fin` aquí es «la aprobación se quedó sin contestar», que
+            // es lo primero que hay que descartar cuando un turno no avanza.
+            const finDelPaso = anotarPaso("consolaWeb#aprobacionesTui", `${pendientes.length} pendiente(s)`);
             return new Promise((resuelto) => {
                 const temporizador = setTimeout(() => enVuelo.terminar(), msDeEspera);
                 const enVuelo = {
@@ -260,6 +265,7 @@ export function crearConsolaWeb(opciones = {}) {
                     },
                     terminar: () => {
                         clearTimeout(temporizador);
+                        finDelPaso();
                         // Soltarlo ANTES de resolver es lo que hace que una decisión tardía no tenga
                         // nada que ascender, y que el contenido no sobreviva a la decisión.
                         aprobacionEnVuelo = undefined;

package/dist/web/servidor/consolaWeb.js.map

@@ -1 +1 @@
-{"version":3,"file":"consolaWeb.js","sourceRoot":"","sources":["../../../src/web/servidor/consolaWeb.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consolaWeb.js","sourceRoot":"","sources":["../../../src/web/servidor/consolaWeb.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xonecode",
-  "version": "0.8.27",
+  "version": "0.8.37",
   "description": "Consola CLI y harness de agente para desarrollar aplicaciones XOne",
   "type": "module",
   "license": "MIT",
@@ -25,6 +25,7 @@
     "build:web": "npm run build --workspace apps/web",
     "prepack": "npm run build",
     "web": "npm run build:web && tsx src/bin.ts --web",
+    "web:trazas": "XONECODE_TRACE_ERRORES=1 XONECODE_TRACE_TOOLS=1 npm run web",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit && tsc -p apps/web/tsconfig.json --noEmit",

package/skills/xone-hotswap/SKILL.md

@@ -17,6 +17,45 @@ El servidor vive **dentro del proceso de la app**: si la app no está viva, el p
 responde. Habla dos protocolos por el mismo puerto: **WebSocket** para los comandos
 (`{"command": "..."}` → `{"result": ..., "status": ...}`) y **HTTP(S)** para lo demás.
 
+
+## Qué usar para qué (y una captura casi nunca es la respuesta)
+
+No cuestan lo mismo, ni de lejos. Por orden de lo que vas a necesitar:
+
+| quieres saber… | úsalo | por qué |
+|---|---|---|
+| **dónde estoy** | `screen` | una línea: colección activa, diálogos abiertos, ventana con el foco |
+| **qué está fallando** | `xone-log-android` | un error de JavaScript o una excepción salen ahí con su mensaje y su línea |
+| **el valor de un campo** | `getText name=X` | un viaje, una respuesta corta |
+| **varios campos** | `getFields names=A,B,C` | UN viaje; un campo que falle no tumba a los demás |
+| **el contenido de una lista** | `getRows content=X fields=…` | alcanza todas las filas, no solo las pintadas |
+| **qué hay en la pantalla** | `elements` | SOLO para explorar: decenas de miles de caracteres |
+| **si algo se VE mal** | `shot name=MAP_X` | y solo aquí |
+
+**Y la captura del CANAL no pinta los diálogos.** Lo dice la referencia del equipo del
+framework: `getScreenshot` dibuja la ventana de la ACTIVIDAD, así que un diálogo abierto —el
+«Error loading initial config» de XOne, por ejemplo— **no sale en ella** aunque la persona lo
+esté viendo. Para saber qué hay encima está `screen` (trae `dialogs`) o `elements`. La captura
+NATIVA (`xone-captura-android`, que es `adb screencap`) sí lo pinta, porque fotografía la
+pantalla entera y no la ventana — y ésa es toda la diferencia entre las dos, no el formato.
+
+**Antes de capturar, comprueba que hay algo que ver.** Si el log no da error y `screen`
+contesta con su colección, la app está bien: no hay nada que diagnosticar en una foto. El
+orden que sale barato es log → `screen` → y solo entonces, si lo que compruebas es VISUAL,
+la captura acotada.
+
+**Una captura NO es una herramienta de diagnóstico.** Para saber por qué algo falla están el
+LOG y `elements`. La captura es para lo **visual** —texto cortado, un control tapado, algo
+ilegible— o para cuando lo anterior no concluye.
+
+**Y tiene un precio medido.** Una captura de pantalla completa (1080×2400) cuesta **3.375
+tokens** en el revisor visual. El peso del fichero **da igual**: medido contra el proveedor,
+52 KB y 766 KB con las mismas dimensiones cuestan exactamente lo mismo —se paga por PÍXELES—,
+así que bajar `quality` ahorra disco y cero tokens. Lo que ahorra es `scale`, y sobre todo
+acotar: `shot name=MAP_ACEPTAR` cuesta una fracción y además **dice qué se estaba probando**
+en vez de ser una foto de la pantalla.
+
+
 ## Lo que hay que saber antes de tocar nada
 
 - **HTTPS con certificado autofirmado** en las dos plataformas. Todas las URLs son `https://`;
@@ -56,13 +95,14 @@ xone-reiniciar-android --app MiApp
 # «lanza la app», «despliégala»: la cadena ENTERA (túnel, ZIP, subida, reinicio, lanzamiento)
 # y termina diciendo si la app está VIVA, con su árbol de controles.
 xone-desplegar-android
-xone-desplegar-android --captura                  # …y deja la captura, en la MISMA orden
+xone-desplegar-android --captura                  # …y además captura: solo si quieres VERLO
 xone-desplegar-android --app MiApp --serie emulator-5554
 
 # Cualquier comando del catálogo de más abajo (varios en orden, si le pasas varios):
-xone-hotswap '{"command":"getAllElements","format":"xone"}'
-xone-hotswap '{"command":"getScreenshot"}'
-xone-hotswap '{"command":"click","name":"MAP_BT_ACEPTAR"}'
+xone-hotswap elements                    # atajo de getAllElements format=xone
+xone-hotswap shot                        # atajo de getScreenshot, a $XONECODE_ARTEFACTOS
+xone-hotswap click name=MAP_BT_ACEPTAR
+xone-hotswap waitForElement name=BTN_OK timeout=5000 -- click name=BTN_OK   # UNA conexión
 
 # Por qué algo no se pinta o la app se muere: las excepciones del aparato.
 xone-log-android
@@ -83,10 +123,18 @@ sobre un proyecto real: la app arrancaba, el árbol de controles contestaba, y l
 una fuente. Ni la captura ni `getAllElements` lo cuentan.
 
 **Encadenar órdenes cuesta más que la orden.** Lo que devuelve cada una es pequeño —1,6 KB el
-árbol de controles, 108 bytes la captura—, pero cada ida y vuelta reenvía la conversación
-entera. Por eso «lanza la app y sácame una captura» es `xone-desplegar-android --captura`, un
-viaje, y no tres órdenes encadenadas. Y `xone-hotswap` acepta varios comandos de golpe, que es
-la misma idea.
+árbol de controles— pero cada ida y vuelta reenvía la conversación entera, así que lo que se
+paga son los VIAJES. Por eso `xone-hotswap` acepta varios comandos de golpe y los scripts
+hacen la cadena entera en una orden.
+
+**Pero una CAPTURA no entra en esa cuenta, y el número de antes engañaba.** Aquí decía «108
+bytes la captura», que es lo que devuelve el comando —el fichero se guarda aparte— y no lo
+que cuesta MIRARLA: medido contra el proveedor, una de 1080×2400 son **3.375 fichas** en el
+revisor visual, pesen 52 KB o 766 KB (se paga por píxeles). Así que `--captura` no es «gratis
+porque va en el mismo viaje»: sale cara en cuanto alguien la mira, y para diagnosticar un
+fallo de arranque no hace falta — eso lo dice el log, con fichero y línea, por unas 50.
+
+Úsala cuando quieras VER algo: que un control se ve cortado, tapado o ilegible.
 
 Tres cosas de `xone-hotswap` que conviene saber antes de leer su salida:
 
@@ -283,3 +331,23 @@ Ninguno es del hotswap; los dos te van a costar una sesión si no los sabes.
 |---|---|
 | Los comandos, uno a uno: entrada, salida, errores y qué plataforma lo tiene | [references/comandos.md](references/comandos.md) |
 | Llegar al dispositivo, desplegar una app, relanzarla, y los endpoints de fichero | [references/conexion-y-despliegue.md](references/conexion-y-despliegue.md) |
+
+## El permiso que hace que un arranque arranque
+
+`xone-desplegar-android` concede `SYSTEM_ALERT_WINDOW` por `appops` antes de lanzar, y no es
+higiene: Android 10 y superiores BLOQUEAN que una app en segundo plano arranque una actividad, y
+ese permiso es la exención que reconocen. El framework se va a segundo plano **con solo apagarse
+la pantalla**, o en cuanto se cierra la app.
+
+Sin él, `launchApplication` contesta `Cannot launch app while the framework is in the background`
+y el despliegue parece que fue bien sin que arrancara nada. Si lo lanzas a mano:
+
+```sh
+adb shell appops set com.xone.android.framework SYSTEM_ALERT_WINDOW allow
+```
+
+Y **dos cosas de la versión**: el framework va por **5.0.5.5dev** con **protocolo 3**. El saludo
+no cambió de forma —solo de número— y nuestro cliente no exige ninguna, así que sigue valiendo.
+Los comandos que llegaron con él (`getFields`, `openRecord`, `setGroup`, `setTrace`) están en
+[`references/comandos.md`](references/comandos.md).
+

package/skills/xone-hotswap/references/comandos.md

@@ -15,6 +15,39 @@ promesa de paridad que no se cumple, diagnosticarás mal. Las que más caro sale
 
 Cómo llegar al dispositivo y cómo desplegar: [conexion-y-despliegue.md](conexion-y-despliegue.md).
 
+## Lo que llegó con el framework 5.0.5.5dev (protocolo 3)
+
+Tres comandos y un modo de traza que la referencia anterior no tenía. Salen del pack de
+`dispositivo-xone`, que es la documentación del equipo del framework.
+
+| comando | campos | qué hace |
+|---|---|---|
+| `getFields` | `names` (**sí**: array o lista separada por comas) | Varios campos en UN viaje, cada uno leído como lo leería `getText`. Devuelve `fields`, con `value` **o** `error` por campo. No acepta `name`. |
+| `openRecord` | `collection` (sí), `where` | Abre la ficha de un registro **directamente**, sin menú, lista ni scroll. |
+| `setGroup` | `group` (sí) | Lleva la pantalla a ese grupo. No acepta `name` ni fila. |
+| `setTrace` | `enabled` | Enciende la traza de ejecución línea a línea. Apagada por omisión. |
+
+Cuatro cosas de estos que no se deducen:
+
+- **`getFields` es la forma barata de leer varios valores.** Un campo que falle **no tumba a los
+  demás**: viene con su `error` mientras los otros traen su `value`, y eso es lo que distingue un
+  campo vacío de uno que no se pudo leer.
+- **Cada `openRecord` APILA una ficha más, no sustituye a la anterior.** Medido por el equipo del
+  framework: con dos seguidos, el primer `pressKey keyCode=4` devuelve a la ficha anterior y no a
+  la pantalla de partida. Al recorrer varios registros hay que cerrar cada ficha antes de abrir la
+  siguiente.
+- **A un grupo se llega con `setGroup`, NUNCA con `scroll`.** El contenedor de grupos no arrastra
+  cuando el gesto nace encima de un control —tampoco con el dedo de una persona—, y un comando solo
+  sabe apuntar a controles: por ahí no se llega nunca, por bien que se entregue el gesto. El nombre
+  es el del volcado (`type: "group"`), no el rótulo de su pestaña, y el cambio es ANIMADO, así que
+  se confirma con `elements` o `waitForElement` y no por la respuesta.
+- `setGroup` y `pressKey` son los dos únicos que **no aceptan** los campos de selección de control
+  (`name`, `row`, `content`, `where`): no apuntan a ningún control.
+
+Y `getFields` se suma a la lista de los que devuelven su objeto **serializado dentro de `status`**
+—con `getAllElements`, `getCurrentScreen` y `getRows`—, así que hay que volver a parsear esa cadena.
+
+
 ## Tipos de respuesta
 
 | Tipo | JSON resultante | iOS |

package/skills/xone-hotswap/references/conexion-y-despliegue.md

@@ -22,7 +22,7 @@ Con varios dispositivos: `adb -s <serial> forward tcp:8443 tcp:8443`. Para desha
 **El canal de los comandos es un WebSocket, y vive en `/hotswap`.** Medido el 16-sep-2026 contra
 `com.xone.android.framework` **5.0.2.2dev** (flavor standalone, Android): `wss://127.0.0.1:8443/hotswap`
 contesta `101`, mientras que `/`, `/ws` y `/api` contestan `400`. Y **el servidor habla primero**: al
-abrir manda `{"command":"server_hello","protocol_version":2}`, así que el cliente ESPERA el saludo en
+abrir manda `{"command":"server_hello","protocol_version":3}`, así que el cliente ESPERA el saludo en
 vez de provocarlo. En esta versión `POST /command` por HTTP da **404** — los comandos van por el
 WebSocket—, y por eso el `curl` de más abajo es solo para iOS.
 
@@ -224,3 +224,63 @@ En iOS, `POST /command` responde con el JSON del comando (incluido el de error),
 que supere su tope responde también JSON en vez de cortar la conexión. **Un cuerpo enviado sin
 `Content-Length` (`Transfer-Encoding: chunked`) funciona**: es el modo por defecto de varios
 clientes HTTP, entre ellos el `http` de Node.
+
+## El permiso de overlay, y por qué `launchApplication` fallaba
+
+**Esto es preflight, no un extra.** Sin el permiso de dibujar sobre otras apps,
+`launchApplication` **no puede arrancar nada mientras el framework esté en segundo plano**:
+Android 10 y superiores bloquean el arranque de actividades desde ahí, y ese permiso es la
+exención que reconocen.
+
+```sh
+adb shell appops set com.xone.android.framework SYSTEM_ALERT_WINDOW allow
+```
+
+Y el framework se queda en segundo plano **con solo apagarse la pantalla**, o en cuanto
+`exitApplication` cierra la app — así que sin conceder el permiso cualquier reinicio es una
+carrera contra el foco. Con él, el bucle de trabajo deja de depender de que la pantalla esté
+encendida. Es idempotente: se puede volver a lanzar sin mirar.
+
+Esto explica el síntoma que teníamos apuntado como «`result:true` significa *aceptado*, no
+*arrancó*»: buena parte de esos arranques que no arrancaban eran este permiso, y el mensaje
+del servidor lo dice — `Cannot launch app while the framework is in the background`.
+
+```sh
+adb shell appops get com.xone.android.framework SYSTEM_ALERT_WINDOW   # 'allow' = concedido
+adb shell appops set com.xone.android.framework SYSTEM_ALERT_WINDOW default   # revertir
+```
+
+**Y el paquete cambia de flavor**: en el de Play Store es `com.xone.android.developer.framework`.
+
+## Cuando el `curl` de comprobación no contesta
+
+Tres causas, en este orden:
+
+1. **El proceso de la app no está vivo.** El servidor solo existe en builds *debuggable* y
+   arranca con el proceso. La pantalla del servidor lo levanta y además enseña IP y puerto
+   reales:
+   `adb shell am start -n com.xone.android.framework/com.xone.android.hotswap.activities.SetupActivity`
+2. **El puerto no es 8443.** Si estaba ocupado —lo normal con DOS APK de framework
+   instaladas— el servidor tomó el siguiente libre. El override guardado se lee con
+   `adb shell run-as com.xone.android.framework cat shared_prefs/hotswap_preferences.xml`
+   (claves `port_number` y `use_secure_connection`); si no dice nada, se sondea 8443–8446
+   rehaciendo el forward a cada puerto remoto.
+3. **El SSL está desactivado** (`use_secure_connection` a `false`): entonces el servidor habla
+   `http://` y el cliente tiene que ir en claro.
+
+Por LAN en vez de USB no hay forward: se apunta a la IP del dispositivo, la que enseña la barra
+superior de esa pantalla.
+
+## Dos cosas del despliegue que no dan ningún error cuando se hacen mal
+
+- **El ZIP debe llamarse EXACTAMENTE `debug_app_update.zip`**: el nombre es lo que dispara la
+  descompresión en el dispositivo. Y su contenido es lo que irá dentro de `app_<appname>`, **sin
+  carpeta raíz que lo envuelva**.
+- **El ZIP no limpia el destino**: añade y sobrescribe, no borra. Un fichero que quitaste del
+  proyecto sigue en el dispositivo. Para un despliegue desde cero hay que vaciar `app_<appname>`
+  antes — y eso se PIDE, no se hace.
+- **`appName` se baja a minúsculas** para formar el directorio: `MiApp` → `app_miapp`.
+- Y los `-wal`, `-shm` y `-journal` de una base de datos **ya no hay que borrarlos a mano**: al
+  reemplazar una base, suelta o dentro del ZIP, se cierra lo que hubiera abierto y se van sus
+  ficheros auxiliares. Antes, olvidarlo dejaba la base corrupta **sin dar ningún error**.
+

package/skills/xone-hotswap/scripts/xone-arrancar-ios

@@ -36,7 +36,7 @@ if (process.argv.includes("--help") || process.argv.includes("-h")) {
   xone-arrancar-ios --app MiApp         además lanza esa app
 
 NO despliega el proyecto: en iOS no hay /file_upload y eso no está medido. Después, los comandos
-van por: HOTSWAP_URL=wss://localhost:8443/hotswap xone-hotswap '{"command":"getAllElements"}'`);
+van por: HOTSWAP_URL=wss://localhost:8443/hotswap xone-hotswap getAllElements`);
   process.exit(0);
 }
 

package/skills/xone-hotswap/scripts/xone-captura-android

@@ -2,7 +2,7 @@
 /**
  * Una captura de la pantalla del aparato, POR LA VÍA NATIVA, a la carpeta de artefactos.
  *
- * POR QUÉ EXISTE, si el canal ya sabe capturar. `xone-hotswap '{"command":"getScreenshot"}'`
+ * POR QUÉ EXISTE, si el canal ya sabe capturar. `xone-hotswap shot`
  * es la vía buena —la pide la app host, así que sale lo que la app pinta— pero necesita el
  * túnel y la app viva. Cuando eso no está, lo único que queda es `adb exec-out screencap`, y
  * medido: el modelo la compone él y redirige la salida a un fichero, que en el `cwd` de la
@@ -35,7 +35,7 @@ if (args.includes("--help") || args.includes("-h")) {
   xone-captura-android --serie <id>           con varios aparatos conectados
 
 Es la vía de RESPALDO: si el túnel y la app host están vivos, la buena es
-\`xone-hotswap '{"command":"getScreenshot"}'\`, que captura lo que la app pinta.
+\`xone-hotswap shot\`, que captura lo que la app pinta.
 Nunca redirijas \`adb exec-out screencap\` a un fichero: el \`cwd\` es la raíz del
 proyecto del usuario y ahí no se escribe.`);
   process.exit(0);
@@ -58,7 +58,21 @@ const serie = opcion("serie");
 // `basename` y no la cadena tal cual: el nombre lo elige el modelo, y un `../` aquí escribiría
 // fuera de la carpeta de la sesión. Misma regla que `esRutaDeArtefacto` en el host.
 const pedido = opcion("nombre");
-const nombre = pedido === undefined ? `captura-${Date.now()}.png` : basename(pedido);
+/**
+ * **La EXTENSIÓN se pone si falta, y no es cosmética.**
+ *
+ * Medido en una sesión: el agente pidió `--nombre arranque_error` y el fichero quedó sin
+ * extensión. Lo que hizo después es el coste: **tres comandos más** —`file` para averiguar
+ * qué había bajado, `sips` para sus dimensiones y un `python3 -c "from PIL import Image…"`
+ * para intentar abrirlo—. Un artefacto sin extensión tampoco se sabe pintar: `mimeDeArtefacto`
+ * decide por la extensión y sin ella no afirma nada, así que la tarjeta del chat no lo enseña
+ * y el revisor visual no lo acepta.
+ *
+ * Se AÑADE en vez de rechazar: lo que el modelo quería está claro y un «no» aquí cuesta otro
+ * viaje para lo mismo.
+ */
+const conExtension = (n) => (/\.[A-Za-z0-9]{2,4}$/.test(n) ? n : `${n}.png`);
+const nombre = pedido === undefined ? `captura-${Date.now()}.png` : conExtension(basename(pedido));
 if (nombre === "" || nombre === "." || nombre === "..") {
   console.error("ese nombre no vale para un fichero.");
   process.exit(1);
@@ -82,6 +96,80 @@ if (bytes.length === 0) {
   process.exit(1);
 }
 
+/**
+ * **Si XOne ha reventado, el LOG basta y la captura sobra.**
+ *
+ * Visto tres veces en sesiones reales: la app no arranca, y quien diagnostica fotografía el
+ * diálogo de error. La foto es legítima —el diálogo ES el error— pero **lo mismo está en el
+ * log en texto**, con fichero, línea, columna y la línea culpable, y cuesta unas 50 fichas
+ * contra las **3.375** que cuesta una captura de 1080×2400 en el revisor visual. Setenta veces
+ * más por saber lo mismo.
+ *
+ * Así que no se captura: se enseña la excepción y se dice por qué. Con `--igualmente` se
+ * captura de todos modos, que para una comprobación VISUAL —algo cortado, algo tapado— sigue
+ * siendo la herramienta buena aunque haya una excepción por ahí.
+ *
+ * Se mira acotado al PROCESO (`--pid`) y no a las últimas N líneas del aparato: 600 líneas de
+ * todo son un par de minutos aquí, y la excepción se sale de esa ventana — el mismo fallo que
+ * tenía `xone-desplegar-android`.
+ */
+if (!args.includes("--igualmente")) {
+  let roto;
+  try {
+    const enElAparato = (...partes) =>
+      execFileSync("adb", [...(serie ? ["-s", serie] : []), ...partes], {
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+      });
+    const pid = enElAparato("shell", "pidof", "com.xone.android.framework").trim().split(/\s+/)[0];
+    if (pid) {
+      const log = enElAparato("logcat", "-d", "--pid", pid, "-t", "600");
+      const filas = log.split("\n");
+      const i = filas.findIndex((l) => l.includes("XOneJavascriptException"));
+      if (i >= 0) {
+        roto = filas
+          .slice(i, i + 12)
+          .map((l) => l.replace(/^.*?\bSystem\.err:\s?/, "").trim())
+          .filter((l) => l !== "" && !l.startsWith("at "))
+          .slice(0, 6)
+          .join("\n");
+      }
+    }
+  } catch {
+    // Sin log no hay nada que objetar: se captura.
+  }
+  /**
+   * **Y si NO hay error, se dice también.** Es la otra mitad de la misma regla: si el log no
+   * da excepción y la app contesta en qué colección está, no hay nada que diagnosticar en una
+   * foto — y capturar «por si acaso» es el caso que más se repite. No se BLOQUEA, porque
+   * comprobar algo VISUAL sobre una app sana es legítimo y es para lo que la captura sirve;
+   * lo que se hace es decirle a quien la pidió lo que ya se sabe, para que no la pida por
+   * costumbre.
+   */
+  if (roto === undefined) {
+    try {
+      const cliente = join(import.meta.dirname, "xone-hotswap");
+      const donde = execFileSync("node", [cliente, "screen"], { encoding: "utf8" }).trim();
+      const m = /\\"collection\\":\\"([^\\"]+)/.exec(donde);
+      if (m) {
+        console.log(`(el log no da error y la app responde en «${m[1]}»: si buscabas un fallo,`);
+        console.log(" no lo hay. Capturo igual, que para lo VISUAL es la herramienta buena.)");
+      }
+    } catch {
+      // Sin canal no se puede decir nada del estado: se captura y ya.
+    }
+  }
+  if (roto !== undefined) {
+    console.log("NO capturo: XOne reventó al cargar y eso ya está en el log, en texto:");
+    console.log("");
+    console.log(roto);
+    console.log("");
+    console.log("Ahí tienes fichero, línea y columna. Una captura del diálogo diría lo mismo");
+    console.log("y cuesta ~3.375 fichas. Si de verdad quieres la imagen: --igualmente.");
+    process.exit(0);
+  }
+}
+
 const destino = join(ARTEFACTOS, nombre);
 try {
   writeFileSync(destino, bytes);