xonecode 0.2.0 → 0.5.0

package/dist/core/planDeSubida.js.map

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

package/dist/core/ports.js

@@ -21,8 +21,60 @@
  * editar su propia definición.
  */
 export const ES_DOBLE = Symbol.for("xonecode.es-doble");
+/**
+ * Acepta objeto O función: en JS una función también es un objeto en tiempo de ejecución
+ * y puede llevar una propiedad-symbol igual que cualquier otro. Hace falta para
+ * `cli/consola.ts#ejecutarTurnoGuionizado` — un `EjecutorDeTurno` es un tipo función, no
+ * una clase con instancia, y es SIEMPRE de pega (todo turno que pasa por ahí usa
+ * `new AgenteGuionizado()`), así que la marca vive en la función exportada y no en un
+ * booleano en quien la invoca (`web/servidor/vestibulo.ts#volcar`).
+ */
 export function esDoble(puerto) {
-    return typeof puerto === "object" && puerto !== null && ES_DOBLE in puerto;
+    return ((typeof puerto === "object" || typeof puerto === "function") &&
+        puerto !== null &&
+        ES_DOBLE in puerto);
+}
+/**
+ * El consumo vivo de una sesión, en la forma que se PERSISTE (`ConsumoDeTurno`).
+ *
+ * Son las mismas cifras con otro nombre en la ventana: lo que aquí se llama `contexto` es un
+ * nivel que se mide al cerrar el turno, y allí se llama `ventana` porque es lo que ocupaba
+ * el historial. Se traduce en una función CON NOMBRE, y no con un literal donde se use, por
+ * la razón de siempre en este repo: una regla de producción compuesta dentro de un cierre
+ * que los tests doblan deja de estar probada y pasa a estar solo escrita.
+ *
+ * Copia las cuentas en vez de reenviarlas: lo que se guarda en el `.jsonl` no puede
+ * compartir objeto con el tracker vivo, o el siguiente turno lo movería por debajo.
+ *
+ * **Un `contexto` de cero sale SIN `ventana`**, y no es una comodidad: es la diferencia entre
+ * «no se midió» y «midió cero». El ejecutor declara `contexto: number`, así que un turno que no
+ * pudo leer la ventana llega con un cero, y estamparlo escribiría en el `.jsonl` una medición
+ * que nadie hizo — con una consecuencia concreta: `consumoDeLosActos` se queda con la última
+ * ventana que CONSTA, así que ese cero falso borraría el nivel que sí midió el turno anterior,
+ * que es justo lo que su regla dice que no puede pasar. Cero no es un nivel: un historial con
+ * turnos dentro nunca ocupa nada.
+ */
+export function consumoPersistible(c) {
+    return {
+        modelo: { ...c.modelo },
+        externo: { ...c.externo },
+        ...(c.contexto === 0 ? {} : { ventana: c.contexto }),
+    };
+}
+/**
+ * La vuelta: lo que se guardó en un `fin`, en la forma que el cable ya manda.
+ *
+ * `ventana` ausente —una sesión sin ninguna medición de contexto, o escrita por una versión
+ * anterior— vuelve como `contexto: 0`, que es «no consta» y no «cero tokens»: quien pinta ya
+ * distingue los dos casos por el `> 0` de siempre, y por eso el cero es la traducción
+ * honesta de una ausencia.
+ */
+export function consumoDeLaSesion(c) {
+    return {
+        modelo: { ...c.modelo },
+        externo: { ...c.externo },
+        contexto: c.ventana ?? 0,
+    };
 }
 /**
  * La huella de un hallazgo, para detectar NO-PROGRESO: la misma huella dos veces seguidas
@@ -77,6 +129,11 @@ export class ModeloGuionizado {
     paraPapel() {
         return { guion: this.respuestas };
     }
+    /** El mismo guion venga por papel o por id: el modo offline no distingue modelos, y
+     *  fingir que sí obligaría a los tests a saber qué modelo pide cada agente. */
+    paraModelo() {
+        return { guion: this.respuestas };
+    }
     descripcion() {
         return {
             rapido: "[DOBLE] guionizado",
@@ -85,6 +142,64 @@ export class ModeloGuionizado {
         };
     }
 }
+/**
+ * El doble del aumentador: devuelve el texto original, DICIENDO que no lo redactó nadie.
+ *
+ * La marca `[DOBLE]` no es adorno y es la misma disciplina que `McpVacio` y
+ * `SkillsEnMemoria`: este texto se le enseña a una persona en la ventana de crear —para que
+ * lo edite— y después se le manda al agente, así que sin la marca pasaría por una redacción
+ * de verdad. Con `--guion` es lo que se monta, que es exactamente el caso que la marca
+ * describe.
+ *
+ * La plantilla entra por parámetro para que un test pueda afirmar sobre el paso de datos sin
+ * la marca de por medio.
+ */
+export class AumentadorGuionizado {
+    plantilla;
+    [ES_DOBLE] = true;
+    constructor(plantilla = (t) => `[DOBLE] no hay aumentador real en esta consola, así que este encargo es la petición tal cual:\n\n${t}`) {
+        this.plantilla = plantilla;
+    }
+    async augmentar(peticion) {
+        return this.plantilla(peticion.texto);
+    }
+}
+/**
+ * El doble: contesta sin lanzar ningún proceso.
+ *
+ * `disponible` devuelve `false` por omisión a propósito. Un doble que dijera que sí haría
+ * que los tests recorrieran la rama de «hay Claude Code» sin haberlo, que es justo la
+ * mentira que `ES_DOBLE` existe para impedir — y el modo offline enseñaría un especialista
+ * que no puede correr.
+ */
+export class SubagenteExternoGuionizado {
+    hay;
+    respuesta;
+    [ES_DOBLE] = true;
+    constructor(hay = false, respuesta = "[DOBLE] respuesta guionizada del agente externo") {
+        this.hay = hay;
+        this.respuesta = respuesta;
+    }
+    async disponible() {
+        return this.hay;
+    }
+    async correr(peticion) {
+        if (!this.hay)
+            throw new Error(`[DOBLE] no hay ${peticion.motor} instalado`);
+        return this.respuesta;
+    }
+}
+/** Catálogo determinista para recorrer la CLI sin red ni credenciales. */
+export class CatalogoModelosEnMemoria {
+    porProveedor;
+    [ES_DOBLE] = true;
+    constructor(porProveedor = {}) {
+        this.porProveedor = porProveedor;
+    }
+    async listar(proveedor) {
+        return this.porProveedor[proveedor] ?? [];
+    }
+}
 /**
  * Verificador que siempre dice verde.
  *
@@ -111,4 +226,77 @@ export class VerifierGuionizado {
         return r;
     }
 }
+/** El proyecto remoto en memoria: recorre el flujo entero sin red ni credenciales. */
+export class CloudStudioEnMemoria {
+    opciones;
+    [ES_DOBLE] = true;
+    /** Lo escrito, para poder afirmar sobre ello en los tests. */
+    escrituras = [];
+    abierto;
+    ramaActual;
+    constructor(opciones = {}) {
+        this.opciones = opciones;
+        this.ramaActual = opciones.rama ?? "master";
+    }
+    async abrir(nombre) {
+        this.abierto = nombre;
+    }
+    exigirAbierto() {
+        // El servidor real responde «No project is open»; el doble no puede ser más blando,
+        // o el adaptador nunca ejercitaría su reapertura.
+        if (this.abierto === undefined)
+            throw new Error("No project is open");
+    }
+    async contexto() {
+        this.exigirAbierto();
+        return { proyecto: this.abierto, rama: this.ramaActual };
+    }
+    async descargarZip() {
+        this.exigirAbierto();
+        if (this.opciones.zipFalla !== undefined)
+            throw new Error(this.opciones.zipFalla);
+        if (this.opciones.zipBase64 === undefined)
+            throw new Error("[DOBLE] falta `zipBase64`");
+        return this.opciones.zipBase64;
+    }
+    async estructura(directorio = "") {
+        this.exigirAbierto();
+        const todas = [
+            ...Object.entries(this.opciones.textos ?? {}).map(([ruta, texto]) => ({ ruta, bytes: texto.length })),
+            ...Object.entries(this.opciones.binarios ?? {}).map(([ruta, bytes]) => ({ ruta, bytes })),
+        ].filter((e) => directorio === "" || e.ruta.startsWith(`${directorio}/`));
+        const tope = this.opciones.topeEstructura;
+        const truncado = tope !== undefined && todas.length > tope;
+        return { entradas: truncado ? todas.slice(0, tope) : todas, truncado };
+    }
+    async leerTexto(ruta) {
+        this.exigirAbierto();
+        const texto = this.opciones.textos?.[ruta];
+        // El servidor rechaza por EXTENSIÓN, no por ausencia: el mensaje se replica para que
+        // la vía degradada aprenda a distinguir «no existe» de «no se puede bajar así».
+        if (texto === undefined)
+            throw new Error(`File extension not allowed or missing: ${ruta}`);
+        return texto;
+    }
+    async escribirTexto(ruta, contenido) {
+        this.exigirAbierto();
+        this.escrituras.push({ tipo: "texto", ruta, bytes: contenido.length });
+    }
+    async borrarTexto(ruta) {
+        this.exigirAbierto();
+        this.escrituras.push({ tipo: "borrado", ruta });
+    }
+    async subirBinario(ruta, datos) {
+        this.exigirAbierto();
+        this.escrituras.push({ tipo: "binario", ruta, bytes: datos.byteLength });
+    }
+    async ramas() {
+        this.exigirAbierto();
+        return [this.ramaActual];
+    }
+    async cambiarRama(nombre) {
+        this.exigirAbierto();
+        this.ramaActual = nombre;
+    }
+}
 //# sourceMappingURL=ports.js.map

package/dist/core/ports.js.map

@@ -1 +1 @@
-{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/core/ports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAkB,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,MAAe;IACrC,OAAO,CACL,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC;QAC5D,MAAM,KAAK,IAAI;QACf,QAAQ,IAAI,MAAM,CACnB,CAAC;AACJ,CAAC;AAsHD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAA2B;IAC5D,OAAO;QACL,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE;QACzB,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAiB;IACjD,OAAO;QACL,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE;QACzB,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC;KACzB,CAAC;AACJ,CAAC;AA8JD;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,CAAW;IAChC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC;AA+GD,qEAAqE;AACrE,oFAAoF;AACpF,yFAAyF;AACzF,kFAAkF;AAElF,MAAM,OAAO,QAAQ;IACV,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,qDAAqD,CAC1F,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,MAAM,KAAmB,CAAC;CACjC;AAED,MAAM,OAAO,eAAe;IAEG;IADpB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,YAA6B,YAAoC,EAAE;QAAtC,cAAS,GAAT,SAAS,CAA6B;IAAG,CAAC;IACvE,QAAQ;QACN,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClD,MAAM;YACN,WAAW,EAAE,0BAA0B;YACvC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACtD,CAAC,CAAC,CAAC;IACN,CAAC;IACD,MAAM,CAAC,MAAc;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,cAAc,CAAC,CAAC;QACpF,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAED,MAAM,OAAO,gBAAgB;IAEE;IADpB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,YAA6B,aAAuB,CAAC,wBAAwB,CAAC;QAAjD,eAAU,GAAV,UAAU,CAAuC;IAAG,CAAC;IAClF,SAAS;QACP,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;IACD;mFAC+E;IAC/E,UAAU;QACR,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;IACD,WAAW;QACT,OAAO;YACL,MAAM,EAAE,oBAAoB;YAC5B,OAAO,EAAE,oBAAoB;YAC7B,OAAO,EAAE,oBAAoB;SAC9B,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oBAAoB;IAGZ;IAFV,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,YACmB,YAAY,CAAC,CAAS,EAAE,EAAE,CACzC,oGAAoG,CAAC,EAAE;QADxF,cAAS,GAAT,SAAS,CAC+E;IACxG,CAAC;IACJ,KAAK,CAAC,SAAS,CAAC,QAAyB;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA0B;IAGlB;IACA;IAHV,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,YACmB,MAAe,KAAK,EACpB,YAAoB,iDAAiD;QADrE,QAAG,GAAH,GAAG,CAAiB;QACpB,cAAS,GAAT,SAAS,CAA4D;IACrF,CAAC;IACJ,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,QAAyB;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,CAAC,KAAK,YAAY,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,wBAAwB;IAGhB;IAFV,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,YACmB,eAA+D,EAAE;QAAjE,iBAAY,GAAZ,YAAY,CAAqD;IACjF,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,SAAoB;QAC/B,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACd,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,SAAS;QACb,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;CACF;AAED,+FAA+F;AAC/F,MAAM,OAAO,kBAAkB;IAGA;IAFpB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACnB,CAAC,GAAG,CAAC,CAAC;IACd,YAA6B,KAA4B;QAA5B,UAAK,GAAL,KAAK,CAAuB;IAAG,CAAC;IAC7D,KAAK,CAAC,SAAS;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAE,CAAC;QAC/D,IAAI,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAmCD,sFAAsF;AACtF,MAAM,OAAO,oBAAoB;IAWF;IAVpB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,8DAA8D;IACrD,UAAU,GAIf,EAAE,CAAC;IACC,OAAO,CAAqB;IAC5B,UAAU,CAAS;IAE3B,YAA6B,WAAyC,EAAE;QAA3C,aAAQ,GAAR,QAAQ,CAAmC;QACtE,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAEO,aAAa;QACnB,oFAAoF;QACpF,kDAAkD;QAClD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAU,GAAG,EAAE;QAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,KAAK,GAAoB;YAC7B,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACrG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SAC1F,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3C,qFAAqF;QACrF,gFAAgF;QAChF,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,SAAiB;QACjD,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,KAAiB;QAChD,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;IAC3B,CAAC;CACF"}

package/dist/core/puedeLanzarse.js

@@ -0,0 +1,239 @@
+/**
+ * El veredicto de «¿se puede lanzar esta app en este dispositivo?»: el predicado de listo y el
+ * catálogo de causas por las que NO lo está, cada una con su frase y con dónde se arregla.
+ *
+ * **Por qué esto existe, y es un caso medido.** El `launchApplication` del framework contesta
+ * `{"result":true}` y eso es un ACUSE, no una medida: a un proyecto cuyo `app.xml` declara
+ * `<connection name="main" connstring="bd/gestion.db" />` y que **no tiene** ese fichero le
+ * contestó `true`, y la app murió detrás en un diálogo «Error opening database». El verificador
+ * no lo caza —`xone-simulator validate` sobre ese mismo proyecto da `success: true`, 0 errores
+ * y 0 avisos, porque **no mira la conexión**—, así que el síntoma es el peor de todos: nada
+ * falla por ningún lado y la app no arranca.
+ *
+ * **Y lo que se comprueba NO se deduce de `app.xml`: la base es `bd/gestion.db` POR DEFECTO.**
+ * Aquí hubo una regla que solo miraba los `connstring` declarados con forma de ruta, y es un
+ * **falso negativo**, que es el error peligroso de este módulo: medido sobre los proyectos
+ * reales, **solo MinitsMT declara su base** (`<connection name="NoReplica"
+ * connstring="bd/gestion.db" />`); MyAllXOne y Replanteos_2026 declaran únicamente conexiones de
+ * proveedor (`Provider=…`), AppDemo no declara **ninguna**, y **los cuatro tienen su
+ * `bd/gestion.db`**. O sea: la declaración es la forma RARA, y una regla que dependiera de ella
+ * dejaría sin comprobar justo lo que se quería comprobar —el caso medido, el diálogo «Database
+ * not found»— en tres de cada cuatro proyectos. Comprobado en el aparato: XOne usa esa ruta por
+ * defecto, se declare o no. Así que la comprobación tiene DOS entradas y una sola pregunta: la
+ * ruta de la convención siempre, más cualquier otra ruta que el `app.xml` declare —una segunda
+ * base es un sitio distinto donde puede faltar un fichero—.
+ *
+ * Datos puros y sin efectos: lo caro entra por parámetro (`existe`, los textos de los ficheros),
+ * que es lo que deja `npm test` sin disco y sin dispositivo. Quien lee el proyecto y mide la
+ * máquina es `web/servidor` / `agent/`.
+ *
+ * **Y el catálogo es una unión discriminada y no una lista de booleanos.** Cada causa lleva sus
+ * datos (el nombre del dispositivo, el `connstring` que falta) porque la frase los necesita, y
+ * el `switch` de `motivoDeBloqueo` va exhaustivo y sin `default`: añadir una causa es un error de
+ * compilación hasta que alguien escriba qué decir y dónde se arregla. Una lista de booleanos se
+ * amplía en silencio, y lo que se amplía en silencio es lo que acaba sin frase.
+ */
+import { esAlcanzable } from "./dispositivos.js";
+import { conexionesDeApp, esRutaDeFichero, nombreDeApp, } from "./descriptoresDeApp.js";
+/**
+ * La base local de una app XOne, siempre en el mismo sitio: `bd/gestion.db`.
+ *
+ * **Es una convención de la plataforma, no algo que haya que leer de `app.xml`.** XOne la usa
+ * por defecto cuando no se declara ninguna conexión, así que un proyecto que no la declara **sí
+ * la necesita**, y comprobar solo lo declarado dejaría sin comprobar el caso más común —está
+ * medido: de cuatro proyectos reales, tres no la declaran y los cuatro la tienen—.
+ *
+ * Se comprueba tal cual, sin normalizar, porque es como la nombra el propio XOne y como la
+ * declara el esqueleto de `core/esqueleto.ts`.
+ */
+export const RUTA_DE_LA_BASE = "bd/gestion.db";
+/**
+ * ¿Está este dispositivo listo para lanzar? Alcanzable **y** con el framework instalado.
+ *
+ * **Un framework sin medir NO es un framework ausente, y aquí las dos cosas dan «no listo» pero
+ * la frase que lo acompaña es distinta** —«no se sabe» no se arregla instalando nada—. El
+ * predicado se queda con el lado conservador: un botón de lanzar sobre un «no se sabe» es la
+ * promesa que este repo no se permite, porque el acuse del framework llega igual y el fallo
+ * aparece detrás, en la app.
+ *
+ * Es el eje DISPOSITIVO de `puedeLanzarse`, no el veredicto entero: un proyecto sin `app.xml`
+ * bloquea aunque esto diga que sí. `puedeLanzarse` no lo recalcula por su cuenta —el veredicto
+ * sale de su lista de causas, que es exhaustiva sobre este eje— y hay un test que ata las dos
+ * respuestas para que no puedan divergir.
+ */
+export function dispositivoListo(dispositivo, framework) {
+    if (dispositivo === undefined)
+        return false;
+    // El camino (adb, su túnel y la subida) todavía solo existe para Android: un iPhone
+    // arrancado tampoco está listo, porque desde aquí no se llega a él.
+    if (dispositivo.plataforma !== "android")
+        return false;
+    if (!esAlcanzable(dispositivo.estado))
+        return false;
+    return framework?.instalado === true;
+}
+/**
+ * El veredicto entero: el dispositivo, el camino, la medida del framework y el proyecto.
+ *
+ * **El orden de las causas es el de la lectura**, y no es alfabético a propósito: primero lo que
+ * hay que arreglar antes de que nada más importe —elegir un dispositivo— y al final el proyecto,
+ * para que quien esté mirando la pantalla no arregle una cosa y descubra la siguiente después.
+ * Las causas son todas las que hay, no la primera.
+ */
+export function puedeLanzarse(entrada) {
+    const causas = [];
+    const { dispositivo } = entrada;
+    if (dispositivo === undefined) {
+        causas.push(entrada.elegido === undefined
+            ? { causa: "sin-dispositivo-elegido" }
+            : { causa: "dispositivo-desconocido" });
+    }
+    else {
+        if (!esAlcanzable(dispositivo.estado)) {
+            causas.push({
+                causa: "dispositivo-no-alcanzable",
+                nombre: dispositivo.nombre,
+                estado: dispositivo.estado,
+            });
+        }
+        if (dispositivo.plataforma !== "android") {
+            causas.push({ causa: "plataforma-sin-camino", plataforma: dispositivo.plataforma });
+            // Y no se pregunta por el framework: `frameworkEnDispositivo` contesta «iOS todavía no»
+            // sin lanzar nada, así que aquí no hay medida que leer y decir «falta el framework»
+            // culparía al dispositivo de que el camino no exista.
+        }
+        else if (entrada.framework === undefined) {
+            causas.push({ causa: "framework-no-medido", nombre: dispositivo.nombre });
+        }
+        else if (entrada.framework.instalado !== true) {
+            causas.push({ causa: "framework-ausente", nombre: dispositivo.nombre });
+        }
+    }
+    const conexiones = entrada.xml === undefined ? [] : conexionesDeApp(entrada.xml);
+    const app = entrada.ini === undefined ? undefined : nombreDeApp(entrada.ini);
+    if (entrada.xml === undefined) {
+        causas.push(entrada.motivoDeLectura === undefined
+            ? { causa: "sin-app-xml" }
+            : { causa: "app-xml-ilegible", motivo: entrada.motivoDeLectura });
+    }
+    else {
+        // Un `app.xml` sin ninguna `<connection>` NO bloquea por eso y no se cuenta: no declarar
+        // ninguna no es síntoma de nada —AppDemo, la app con la que se prueba, declara cero y
+        // arranca—. Lo que el recorrido diga de las conexiones lo lleva `Veredicto.conexiones`, que
+        // es un dato.
+        //
+        // **Pero la base se comprueba igual, porque la ruta es una convención y no una
+        // declaración.** XOne arranca con `bd/gestion.db` sin que nadie la declare —medido, y es
+        // como arrancan MyAllXOne, Replanteos_2026 y AppDemo—, así que mirar solo lo declarado
+        // dejaría pasar el caso medido justo en los proyectos donde más pasa. Las dos entradas son
+        // una sola pregunta: la convención siempre, y además cualquier OTRA ruta que el `app.xml`
+        // declare, porque una segunda base es un sitio distinto donde puede faltar un fichero.
+        //
+        // **Y solo las declaradas que son RUTAS de fichero.** Medido: un `connstring` de proveedor
+        // (`Provider=…;ProgID=…`) no es un fichero de aquí y esos proyectos arrancan perfectamente,
+        // así que preguntar por su existencia bloquearía proyectos que funcionan. El fichero que
+        // falta de verdad es el caso medido: `{"result":true}` y el diálogo de error detrás.
+        const declaradas = conexiones.filter((c) => esRutaDeFichero(c.connstring));
+        const candidatas = declaradas.map((c) => ({
+            ruta: c.connstring,
+            declarada: true,
+        }));
+        if (!declaradas.some((c) => c.connstring === RUTA_DE_LA_BASE)) {
+            candidatas.push({ ruta: RUTA_DE_LA_BASE, declarada: false });
+        }
+        // Dos conexiones a la misma base son una frase y no dos: la segunda no dice nada nuevo. Y
+        // una base que el `app.xml` SÍ declara se cuenta con la verdad más específica —que está
+        // declarada y que no está—, que es la que dice dónde mirar.
+        const yaDicho = new Set();
+        for (const { ruta, declarada } of candidatas) {
+            if (yaDicho.has(ruta))
+                continue;
+            if (entrada.existe(ruta))
+                continue;
+            yaDicho.add(ruta);
+            causas.push(declarada
+                ? { causa: "falta-el-fichero-de-la-conexion", connstring: ruta }
+                : { causa: "falta-la-base" });
+        }
+    }
+    return {
+        // Las causas son exhaustivas sobre los tres ejes, así que esto ES `dispositivoListo(...)`
+        // y el proyecto — y hay un test que lo comprueba, para que no puedan divergir.
+        listo: causas.length === 0,
+        causas,
+        ...(app === undefined ? {} : { app }),
+        conexiones,
+    };
+}
+/** Cómo se escribe la plataforma en la ventana. Exhaustivo por tipo, como todo lo que reparte. */
+function nombreDePlataforma(plataforma) {
+    switch (plataforma) {
+        case "android":
+            return "Android";
+        case "ios":
+            return "iOS";
+    }
+}
+/**
+ * El estado medido, como se dice en la ventana.
+ *
+ * Es la TERCERA copia de esta tabla en el repo —`Equipo.tsx` e `inventarioDeDispositivos.ts`
+ * tienen las suyas— y el motivo es la frontera: `apps/web/` redeclara los tipos del cable y no
+ * importa de aquí, y esta vive donde viven las frases que salen del servidor. El
+ * `Record<…, string>` la deja exhaustiva por tipo: un estado nuevo no compila hasta que alguien
+ * decida cómo se escribe.
+ */
+const ETIQUETA_DE_ESTADO = {
+    conectado: "conectado",
+    arrancado: "arrancado",
+    apagado: "apagado",
+    "sin-autorizar": "sin autorizar",
+    offline: "offline",
+    "no-disponible": "no disponible",
+};
+/**
+ * UNA frase por causa, en español, y **cada una dice DÓNDE se arregla**.
+ *
+ * El `switch` va exhaustivo y sin `default` a propósito: un `default` que devolviera «no se
+ * puede» taparía la causa nueva en vez de obligar a escribir qué falta y con qué se arregla, que
+ * es justo lo único que esta pestaña tiene que decir. Y por eso ninguna frase es un «no se
+ * puede» a secas: quien la lee está mirando una pantalla que le acaba de negar algo, y lo único
+ * que puede hacer con un «no se puede» es irse a buscar por su cuenta —o creer que xonecode
+ * tenía que haberlo puesto él.
+ */
+export function motivoDeBloqueo(causa) {
+    switch (causa.causa) {
+        case "sin-dispositivo-elegido":
+            return "Esta sesión no tiene ningún dispositivo elegido: elígelo en la pastilla del compositor, junto al modelo —es donde se elige el de ESTA sesión—, y vuelve a intentarlo.";
+        case "dispositivo-desconocido":
+            return "El dispositivo que esta sesión tenía elegido ya no aparece en la última medida del equipo: los identificadores no son estables (el de un emulador es un puerto). Vuelve a elegirlo en la pastilla del compositor.";
+        case "dispositivo-no-alcanzable":
+            return `«${causa.nombre}» no está alcanzable ahora: su estado es «${ETIQUETA_DE_ESTADO[causa.estado]}». Arranca el dispositivo o conéctalo del todo —y acepta la depuración si es un teléfono— y vuelve a mirar en Ajustes → Dispositivos.`;
+        case "framework-ausente":
+            return `«${causa.nombre}» no tiene instalado el framework de XOne, que es la app con la que se habla para lanzar (XOneStudio). Instálalo en el dispositivo —XOne Studio lo distribuye— y vuelve a mirar en Ajustes → Dispositivos.`;
+        case "framework-no-medido":
+            return `Todavía no se ha mirado si «${causa.nombre}» tiene el framework de XOne, así que no se puede prometer que la app vaya a arrancar. Vuelve a mirar en Ajustes → Dispositivos y espera a que llegue la medida.`;
+        case "sin-app-xml":
+            return "El proyecto no tiene app.xml —o la raíz que se abrió no es la carpeta que lo contiene—: es el fichero que declara la app, y sin él no hay nada que lanzar. Ábrelo en XOne Studio, o comprueba que abriste la carpeta del proyecto y no una de dentro.";
+        case "app-xml-ilegible":
+            return `No se pudo leer app.xml: ${causa.motivo}. Es el fichero que declara la app, así que sin leerlo no se sabe qué se va a lanzar: ábrelo y vuelve a guardarlo desde XOne Studio.`;
+        case "falta-el-fichero-de-la-conexion":
+            // Larga a propósito: lo que un despliegue tiene que decir es QUÉ falta, DE DÓNDE sale y
+            // qué pasa si se ignora. Una frase corta aquí manda a la persona a buscar sola y la deja
+            // creyendo que el fichero lo pone xonecode.
+            return `app.xml declara la conexión «${causa.connstring}» y ese fichero no está en el proyecto. La base la genera el simulador fuera de xonecode —xonecode no la crea—, así que hay que abrir el proyecto en XOne Studio y arrancarlo una vez, o traerlo de donde se generó. Sin él la app recibe el lanzamiento y muere en un diálogo «Error opening database».`;
+        case "falta-la-base":
+            // La hermana de la de arriba, y la que más veces va a salir: medido, tres de cada cuatro
+            // proyectos reales NO declaran su base y la necesitan igual, porque la ruta es la de por
+            // defecto de XOne.
+            //
+            // **Y lleva la única frase que reconoce un falso positivo propio**: el fichero se mira en
+            // el PROYECTO, y una app que ya se lanzó antes en ese dispositivo tiene allí su copia, así
+            // que volver a lanzarla no la necesita. No se puede preguntar al aparato todavía, así que
+            // lo honesto es decir que no se puede prometer — y lo que hay que hacer si ese es el caso.
+            return `El proyecto no tiene ${RUTA_DE_LA_BASE}, que es la base local de XOne: la usa POR DEFECTO, se declare en app.xml o no, y sin ella la app recibe el lanzamiento y muere en un diálogo «Error opening database». La genera el simulador fuera de xonecode —xonecode no la crea—, así que hay que abrir el proyecto en XOne Studio y arrancarlo una vez, o traerla de donde se generó. (Se mira el proyecto, no el aparato: si esta app ya se lanzó antes en ese dispositivo, allí sigue su copia y no hace falta esto.)`;
+        case "plataforma-sin-camino":
+            return `Lanzar desde xonecode todavía solo está montado para Android —el túnel, el canal y la subida son los de esa plataforma—, así que sobre ${nombreDePlataforma(causa.plataforma)} no hay camino. Elige un dispositivo de Android en Ajustes → Dispositivos, o lanza la app desde XOne Studio.`;
+    }
+}
+//# sourceMappingURL=puedeLanzarse.js.map

package/dist/core/puedeLanzarse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puedeLanzarse.js","sourceRoot":"","sources":["../../src/core/puedeLanzarse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,EAAE,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAEL,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAgBhC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAwE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAoC,EACpC,SAAsC;IAEtC,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5C,oFAAoF;IACpF,oEAAoE;IACpE,IAAI,WAAW,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEhC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,OAAO,CAAC,OAAO,KAAK,SAAS;YAC3B,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE;YACtC,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CACzC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,2BAA2B;gBAClC,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,MAAM,EAAE,WAAW,CAAC,MAAM;aAC3B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,WAAW,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;YACpF,wFAAwF;YACxF,oFAAoF;YACpF,sDAAsD;QACxD,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7E,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,OAAO,CAAC,eAAe,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE;YAC1B,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,CACnE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,yFAAyF;QACzF,sFAAsF;QACtF,4FAA4F;QAC5F,cAAc;QACd,EAAE;QACF,+EAA+E;QAC/E,yFAAyF;QACzF,uFAAuF;QACvF,2FAA2F;QAC3F,0FAA0F;QAC1F,uFAAuF;QACvF,EAAE;QACF,2FAA2F;QAC3F,4FAA4F;QAC5F,yFAAyF;QACzF,qFAAqF;QACrF,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC3E,MAAM,UAAU,GAA2C,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChF,IAAI,EAAE,CAAC,CAAC,UAAU;YAClB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC,EAAE,CAAC;YAC9D,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,0FAA0F;QAC1F,wFAAwF;QACxF,4DAA4D;QAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAChC,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,SAAS;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM,CAAC,IAAI,CACT,SAAS;gBACP,CAAC,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,UAAU,EAAE,IAAI,EAAE;gBAChE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAC/B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,0FAA0F;QAC1F,+EAA+E;QAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QACrC,UAAU;KACX,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,SAAS,kBAAkB,CAAC,UAAqC;IAC/D,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,kBAAkB,GAA0C;IAChE,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,eAAe;IAChC,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,eAAe;CACjC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,yBAAyB;YAC5B,OAAO,uKAAuK,CAAC;QACjL,KAAK,yBAAyB;YAC5B,OAAO,mNAAmN,CAAC;QAC7N,KAAK,2BAA2B;YAC9B,OAAO,IAAI,KAAK,CAAC,MAAM,6CAA6C,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,uIAAuI,CAAC;QAC9O,KAAK,mBAAmB;YACtB,OAAO,IAAI,KAAK,CAAC,MAAM,4MAA4M,CAAC;QACtO,KAAK,qBAAqB;YACxB,OAAO,+BAA+B,KAAK,CAAC,MAAM,kKAAkK,CAAC;QACvN,KAAK,aAAa;YAChB,OAAO,uPAAuP,CAAC;QACjQ,KAAK,kBAAkB;YACrB,OAAO,4BAA4B,KAAK,CAAC,MAAM,sIAAsI,CAAC;QACxL,KAAK,iCAAiC;YACpC,wFAAwF;YACxF,yFAAyF;YACzF,4CAA4C;YAC5C,OAAO,gCAAgC,KAAK,CAAC,UAAU,0SAA0S,CAAC;QACpW,KAAK,eAAe;YAClB,yFAAyF;YACzF,yFAAyF;YACzF,mBAAmB;YACnB,EAAE;YACF,0FAA0F;YAC1F,2FAA2F;YAC3F,0FAA0F;YAC1F,2FAA2F;YAC3F,OAAO,wBAAwB,eAAe,gdAAgd,CAAC;QACjgB,KAAK,uBAAuB;YAC1B,OAAO,0IAA0I,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,8GAA8G,CAAC;IACxS,CAAC;AACH,CAAC"}

package/dist/core/rutaVirtual.js

@@ -0,0 +1,42 @@
+import { resolve, sep } from "node:path";
+/**
+ * La ruta REAL de una ruta VIRTUAL del backend del agente, o `undefined` si se sale del
+ * proyecto.
+ *
+ * El backend del agente es un `FilesystemBackend` con `virtualMode: true`, así que lo que el
+ * modelo escribe —y lo que llega en los argumentos de un `interrupt`— viene ROOTEADO en el
+ * proyecto: `/app.xne`, `/artefactos/x.html`. Es la forma que usan las descripciones de las
+ * tools, las skills y el predicado `seDetieneEn`.
+ *
+ * Y ahí estaba la trampa, medida: `resolve(raiz, "/app.xne")` devuelve `/app.xne`, porque una
+ * ruta absoluta DESCARTA la base. Quien leyera el disco así con la forma rooteada no
+ * encontraba nada — con la relativa sí, que es por lo que pasó desapercibido: el test que lo
+ * cubría usaba `"app.xne"` sin barra. En el ANTES del diff de una aprobación eso significaba
+ * un fichero existente enseñado como si fuera NUEVO, con sus líneas quitadas invisibles. Es
+ * el peor sitio posible para una media verdad: el diff de la aprobación es el único momento
+ * en que alguien ve lo que el agente va a escribir antes de que exista.
+ *
+ * Las dos formas se aceptan —la relativa y la rooteada— porque las dos funcionan contra el
+ * backend y por tanto las dos pueden llegar. Los separadores se normalizan antes de resolver:
+ * en POSIX `resolve` trata «\» como un carácter más del nombre, la misma lección que ya pagó
+ * `leerFicheroDeProyecto`.
+ *
+ * La contención se comprueba porque `..` sí puede salir del proyecto, y de aquí sale una
+ * lectura de disco: sin ella, el contenido de un fichero de FUERA acabaría en la pantalla de
+ * la aprobación. Es lexical y no `realpath` —esta función es pura y no toca disco—, así que
+ * quien necesite además cerrar los enlaces simbólicos recomprueba después, como hace
+ * `arbolDeProyecto.ts`.
+ */
+export function rutaRealDeVirtual(raiz, virtual) {
+    const normal = virtual.split(/[\\/]/).filter((s) => s.length > 0).join("/");
+    if (normal.length === 0)
+        return undefined;
+    const real = resolve(raiz, normal);
+    // Se exige estar DEBAJO, no «dentro o ser»: la raíz misma no es un fichero que leer, y un
+    // «.» o un «/» resuelven a ella. Devolverla haría que el llamante intentara leer un
+    // directorio y se llevara un `EISDIR` donde esperaba texto.
+    const dentro = resolve(raiz);
+    const prefijo = dentro.endsWith(sep) ? dentro : dentro + sep;
+    return real.startsWith(prefijo) ? real : undefined;
+}
+//# sourceMappingURL=rutaVirtual.js.map

package/dist/core/rutaVirtual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rutaVirtual.js","sourceRoot":"","sources":["../../src/core/rutaVirtual.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,0FAA0F;IAC1F,oFAAoF;IACpF,4DAA4D;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IAC7D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}