xonecode 0.8.23 → 0.8.26

package/apps/web/dist/index.html

@@ -7,8 +7,8 @@
     <!-- El icono oficial, servido por Vite desde `iconos/`. Es el mismo fichero que la
          marca de la barra superior: dos copias del logo acaban siendo dos logos. -->
     <link rel="icon" type="image/png" href="./iconos/xonecode.png" />
-    <script type="module" crossorigin src="./assets/index-mTaG_gr6.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-CtYEobZI.css">
+    <script type="module" crossorigin src="./assets/index-LdUr7EoT.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-DKZqgHtg.css">
   </head>
   <!-- Sin el atributo aquí: el oscuro es SOLO del splash (el registro de entorno y
        modelo), no de la consola entera — `App.tsx` lo pone y lo quita él mismo, en el

package/dist/agent/dispositivos/juezVisual.js

@@ -57,17 +57,82 @@ export const PROMPT_VISUAL = [
     "",
     'Contesta SOLO este JSON: {"veredicto":"verde"|"rojo","hallazgos":["lo que se ve", …],"necesito":["Coleccion", …]}',
 ].join("\n");
+/**
+ * Lo que se le pide CUANDO hay maqueta delante, y existe por una medida.
+ *
+ * **El modelo ve las imágenes de sobra; lo que decide qué ve es qué se le pide describir.**
+ * Sobre la calculadora de MyAllXOne el crítico acertó que una captura era el login y no la
+ * pantalla pedida, y leyó los rótulos `AP_EXPRESION`/`AP_RESULTADO` cortados contra el borde.
+ * Luego dio VERDE sobre una pantalla cuyas teclas eran rectángulos donde la maqueta tenía
+ * píldoras y cuyo resultado era 1,4 veces la expresión donde la maqueta pedía 2,7. No falló:
+ * `PROMPT_VISUAL` le dice literalmente que NO opine de la paleta ni de los gustos, y la
+ * fidelidad cae entera en ese conjunto excluido. La prueba de que era la pregunta y no la
+ * vista: el orquestador llegó a escribirle «las teclas llevan esquinas redondeadas (radio
+ * alto)» y el crítico no protestó, porque no se le pidió comparar.
+ *
+ * Tres cosas que no son de forma:
+ *
+ *  - **Se nombra QUÉ comparar** —proporciones, jerarquía de tamaños, forma y alineación— en
+ *    vez de pedir «¿se parecen?». Una pregunta abierta devuelve impresiones; ésta devuelve
+ *    sitios.
+ *  - **El COLOR se compara, el GUSTO no.** «El botón es coral donde la maqueta lo pone gris»
+ *    es un hecho comprobable contra una imagen que está delante; «la paleta es fría» sigue
+ *    siendo una opinión y sigue fuera. Sin referencia no se puede distinguir, y por eso allí
+ *    se excluyen los dos.
+ *  - **Se conserva «no diagnostiques la causa»**, que está medido seis veces: describe un
+ *    texto CORTADO como «girado 180°». Acierta DÓNDE y falla en el PORQUÉ, y eso no cambia
+ *    porque haya una maqueta al lado.
+ *
+ * Y se conserva que una diferencia deliberada no es un defecto: una plataforma no da todo lo
+ * que da un navegador, así que lo que se pide es lo que SE VE distinto, no un veredicto de
+ * si estuvo bien decidido.
+ */
+export const PROMPT_VISUAL_CON_REFERENCIA = [
+    "Eres un revisor VISUAL de la pantalla de una app móvil. Te doy DOS imágenes:",
+    "1) la MAQUETA: cómo tendría que verse.",
+    "2) la CAPTURA del aparato: cómo se ve de verdad.",
+    "",
+    "Di en qué se DIFERENCIAN, sin diagnosticar: describe lo que se ve, no la causa ni cómo",
+    "arreglarlo. Quien lo lea tiene el código delante y tú no.",
+    "",
+    "Compara, y nombra el control concreto en cada diferencia:",
+    "- FORMA: esquinas (redondeadas, en píldora, en círculo o rectas), bordes, sombras.",
+    "- TAMAÑOS Y JERARQUÍA: qué es más grande que qué, y cuánto. Si en la maqueta un texto es",
+    "  el doble que otro y en la captura son casi iguales, eso es una diferencia.",
+    "- COLOR: solo comparado con la maqueta —«es gris donde la maqueta lo pone coral»—. NO",
+    "  opines de si la paleta te gusta.",
+    "- COLOCACIÓN: alineación, márgenes, huecos, orden de los elementos, qué falta y qué sobra.",
+    "- Y lo de siempre: texto cortado, ilegible, solapado o fuera de la pantalla.",
+    "",
+    "No toda diferencia es un error: una app nativa no puede dar todo lo que da un navegador.",
+    "Di lo que VES distinto y deja que lo valore quien lee.",
+    "",
+    "Si no ves ninguna diferencia que merezca contarse, dilo con la lista vacía.",
+    "",
+    "Si para dictaminar necesitas ver OTRA pantalla, pídela en `necesito` por el NOMBRE de su",
+    "colección y nada más (por ejemplo «Productos»), no con una frase. Alguien irá a por ella.",
+    "Si con lo que tienes te basta, déjalo vacío.",
+    "",
+    'Contesta SOLO este JSON: {"veredicto":"verde"|"rojo","hallazgos":["lo que se ve", …],"necesito":["Coleccion", …]}',
+].join("\n");
 /**
  * Le enseña la captura al modelo y devuelve su veredicto.
  *
  * `invocar` entra por parámetro, así que `npm test` no le pregunta a ningún modelo — el mismo
  * molde que `JuezDeTareaPort`.
  */
-export async function juzgarPantalla(imagen, contexto, invocar) {
-    const prompt = `${PROMPT_VISUAL}\n\nLa captura es de la pantalla «${contexto.pantalla}».`;
+export async function juzgarPantalla(imagen, contexto, invocar, 
+/**
+ * La maqueta, si la hay. **Cuarto parámetro y opcional**, así los dos llamadores de
+ * `cli/` no cambian: lo que hace un `xonecode` de diagnóstico es mirar una pantalla, no
+ * compararla contra nada.
+ */
+referencia) {
+    const base = referencia === undefined ? PROMPT_VISUAL : PROMPT_VISUAL_CON_REFERENCIA;
+    const prompt = `${base}\n\nLa captura es de la pantalla «${contexto.pantalla}».`;
     let texto;
     try {
-        texto = await invocar(PAPEL_DEL_JUEZ_VISUAL, prompt, imagen);
+        texto = await invocar(PAPEL_DEL_JUEZ_VISUAL, prompt, imagen, referencia);
     }
     catch (error) {
         throw new ErrorDelJuezVisual(error instanceof Error ? error.message : String(error));
@@ -116,7 +181,7 @@ export async function juzgarPantalla(imagen, contexto, invocar) {
  * el cuerpo remoto y con él cabeceras y claves redactadas.
  */
 export function invocarVisualConModelos(modelos) {
-    return async (papel, prompt, imagen) => {
+    return async (papel, prompt, imagen, referencia) => {
         let modelo;
         try {
             modelo = modelos.paraPapel(papel);
@@ -146,10 +211,29 @@ export function invocarVisualConModelos(modelos) {
              * clase de fuga que un argumento de tool en un evento. Lo que la persona tiene que
              * leer es lo que el harness decide contar con ese veredicto, no el JSON.
              */
+            /**
+             * **Cada imagen va DETRÁS de la línea que dice cuál es.** Con dos adjuntas y el prompt
+             * describiéndolas arriba, cuál es la maqueta y cuál el aparato dependería del orden en
+             * que el proveedor las numere — y eso no es un contrato, es una suposición. Una
+             * etiqueta pegada a cada una lo vuelve un dato. Si se invirtieran, el crítico contaría
+             * las diferencias al revés y se leerían igual de bien: es el fallo mudo de siempre.
+             *
+             * El orden es el del prompt: primero la MAQUETA, después la CAPTURA.
+             */
             const respuesta = await modelo.invoke([
                 new HumanMessage({
                     content: [
                         { type: "text", text: prompt },
+                        ...(referencia === undefined
+                            ? []
+                            : [
+                                { type: "text", text: "MAQUETA (cómo tendría que verse):" },
+                                {
+                                    type: "image_url",
+                                    image_url: { url: `data:${referencia.mime};base64,${referencia.base64}` },
+                                },
+                                { type: "text", text: "CAPTURA del aparato (cómo se ve de verdad):" },
+                            ]),
                         { type: "image_url", image_url: { url: `data:${imagen.mime};base64,${imagen.base64}` } },
                     ],
                 }),

package/dist/agent/dispositivos/juezVisual.js.map

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

package/dist/agent/grafo/artefactosEnDisco.js

@@ -23,7 +23,7 @@
  */
 import { readFile, realpath, stat } from "node:fs/promises";
 import { join, sep } from "node:path";
-import { RUTA_ARTEFACTOS, carpetaDeArtefactosDeSesion, esRutaDeArtefacto, mimeDeArtefacto, } from "../../core/artefactos.js";
+import { RUTA_ARTEFACTOS, carpetaDeArtefactosDeSesion, esRutaDeArtefacto, mimeDeArtefacto, nombreDeArtefacto, } from "../../core/artefactos.js";
 import { leerContenidoDeFichero } from "./arbolDeProyecto.js";
 /**
  * Bytes que la ruta HTTP sirve como mucho.
@@ -116,7 +116,7 @@ export async function leerArtefactoDeSesion(raiz, sesion, nombre) {
  * y por eso lo pide ella a `mimeDeArtefacto`.
  */
 function mimeDeImagenDeArtefacto(nombre) {
-    const mime = mimeDeArtefacto(nombre);
+    const mime = mimeDeArtefacto(nombreDeArtefacto(nombre));
     return mime !== undefined && mime.startsWith("image/") ? mime : undefined;
 }
 /** Para la RUTA HTTP: los bytes, sin recortar y sin base64. Ver `TOPE_DE_ARTEFACTO`. */
@@ -133,7 +133,18 @@ export async function leerArtefactoCrudo(raiz, sesion, nombre) {
     // comprobarlo después de `readFile` no protegería de nada.
     if (info.size > TOPE_DE_ARTEFACTO)
         return { ok: false, motivo: "demasiado-grande" };
-    const mime = mimeDeArtefacto(nombre);
-    return { ok: true, nombre, datos: await readFile(real), ...(mime === undefined ? {} : { mime }) };
+    // Del último segmento las DOS cosas, porque el `nombre` que llega puede ser una ruta
+    // relativa: un `unzip` deja un árbol en la carpeta, y esa ruta es la que el acto anunció.
+    // El `filename=` de la cabecera de descarga sale de aquí, y `stitch/pantalla/screen.png`
+    // no es un nombre de fichero; y `mimeDeArtefacto` busca el ÚLTIMO punto de lo que se le
+    // pase, así que un `v1.2/mockup` sin extensión le daría por extensión `2/mockup`.
+    const base = nombreDeArtefacto(nombre);
+    const mime = mimeDeArtefacto(base);
+    return {
+        ok: true,
+        nombre: base,
+        datos: await readFile(real),
+        ...(mime === undefined ? {} : { mime }),
+    };
 }
 //# sourceMappingURL=artefactosEnDisco.js.map

package/dist/agent/grafo/artefactosEnDisco.js.map

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

package/dist/agent/grafo/criticaVisual.js

@@ -1,6 +1,6 @@
 import { tool } from "@langchain/core/tools";
 import { z } from "zod";
-import { esRutaDeArtefacto, mimeDeArtefacto, nombreDeArtefacto } from "../../core/artefactos.js";
+import { esRutaDeArtefacto, mimeDeArtefacto, nombreDeArtefacto, rutaRelativaDeArtefacto, } from "../../core/artefactos.js";
 import { juzgarPantalla, TOPE_DE_PETICIONES, } from "../dispositivos/juezVisual.js";
 /**
  * `xone_critica_visual`: enseñarle una captura al crítico y traer su veredicto.
@@ -35,39 +35,135 @@ const Entrada = z.object({
     pantalla: z
         .string()
         .describe("De qué pantalla o colección es la captura, para que el crítico sepa qué mira"),
+    /**
+     * La MAQUETA, y su ausencia significa algo — por eso lo dice el `describe`.
+     *
+     * Sin ella el crítico solo busca ROTURAS y no dice nada de si la pantalla se parece a lo
+     * que se pidió. Medido: dio verde sobre una calculadora cuyas teclas eran rectángulos donde
+     * la maqueta tenía píldoras, y el verde se leyó como «está bien». Un parámetro que no dice
+     * qué pasa cuando falta deja ese malentendido intacto.
+     */
+    referencia: z
+        .string()
+        .optional()
+        .describe("OPCIONAL. La ruta virtual bajo /artefactos/ de la MAQUETA o diseño de referencia. " +
+        "Pásala SIEMPRE que el encargo traiga un diseño: con ella comparo la captura contra " +
+        "la maqueta (forma, tamaños, colocación). SIN ella solo busco roturas y NO digo nada " +
+        "sobre si se parece al diseño."),
 });
+/**
+ * Qué es esta ruta, o el motivo en palabras. **Comprueba y NO lee.**
+ *
+ * Separada de la lectura a propósito: con dos imágenes en juego, el orden importa. Si se
+ * comprobara y abriera cada una por turno, una referencia con la ruta mal escrita se
+ * descubriría DESPUÉS de haber leído la captura — y lo que la guarda promete es que no se
+ * abre nada hasta que todo lo que se va a abrir está comprobado. Es lo mismo que exige el
+ * test de siempre («no se lee NADA antes de comprobarlo»), solo que ahora hay dos.
+ *
+ * `que` cambia únicamente cómo se nombra en el mensaje: la comprobación es la MISMA para las
+ * dos, porque las dos acaban dentro de un modelo.
+ */
+function veredictoDeImagen(ruta, que) {
+    // Lista BLANCA de forma, sobre el TEXTO que escribe el modelo. `esRutaDeArtefacto` no es
+    // un `startsWith`: comprueba la forma entera, segmento a segmento.
+    if (!esRutaDeArtefacto(ruta)) {
+        return `«${ruta}» no es ${que} de esta sesión. Solo puedo mirar lo que hay bajo /artefactos/.`;
+    }
+    const nombre = nombreDeArtefacto(ruta);
+    const mime = mimeDeArtefacto(nombre);
+    if (mime === undefined || !mime.startsWith("image/")) {
+        return `«${nombre}» no es una imagen, así que no hay nada que mirar.`;
+    }
+    return { mime };
+}
+/**
+ * Los bytes, ya con la ruta comprobada. Nunca lanza: que falte una imagen no puede llevarse
+ * el turno por delante.
+ *
+ * **Se abre por la ruta RELATIVA y se NOMBRA por el último segmento**, que son dos preguntas
+ * distintas y confundirlas era un botón muerto: un `unzip` deja un ÁRBOL, y una maqueta
+ * descomprimida vive en `/artefactos/diseno/screen.png`. Con el basename, el `join` de quien
+ * lee apuntaba a `<carpeta>/screen.png` y contestaba «no pude abrir» sobre un fichero que
+ * estaba ahí y que la propia foto había anunciado.
+ */
+async function leer(ruta, mime, deps) {
+    try {
+        const bytes = await deps.leerArtefacto(rutaRelativaDeArtefacto(ruta));
+        return { base64: bytes.toString("base64"), mime };
+    }
+    catch (error) {
+        // El mensaje de un error de Node lleva la ruta absoluta y esto va al modelo: solo el
+        // NOMBRE del error.
+        return `No pude abrir «${nombreDeArtefacto(ruta)}» (${error instanceof Error ? error.name : "error"}).`;
+    }
+}
+/**
+ * **Fail-closed: una referencia que se pidió y no se pudo usar es un NO.**
+ *
+ * Lo tentador es juzgar sin ella y avisar. Es justo el fallo que este parámetro existe para
+ * cerrar: un veredicto sin maqueta vuelve como «verde» y se lee como «se parece al diseño».
+ * Así que no se juzga nada, y el paso siguiente que se escribe es ARREGLAR LA RUTA — nunca
+ * «o llámame sin ella», que sería dejar el modo ciego escrito dentro de la propia tool como
+ * alternativa legítima.
+ */
+function sinJuzgar(motivo) {
+    return [
+        motivo,
+        "NO he juzgado la captura: comparar contra media maqueta no es comparar, y mi veredicto",
+        "se leería como que la pantalla se parece al diseño. Comprueba la ruta de la maqueta",
+        "—tiene que ser la que anunció su evento `artefacto`, con sus subcarpetas— y vuelve a",
+        "llamarme.",
+    ].join("\n");
+}
 export function crearCriticaVisual(deps) {
     return tool(async (entrada) => {
-        // Lista BLANCA de forma, sobre el TEXTO que escribe el modelo. `esRutaDeArtefacto` no es
-        // un `startsWith`: comprueba la forma entera.
-        if (!esRutaDeArtefacto(entrada.captura)) {
-            return `«${entrada.captura}» no es una captura de esta sesión. Solo puedo mirar lo que hay bajo /artefactos/.`;
-        }
-        const nombre = nombreDeArtefacto(entrada.captura);
-        const mime = mimeDeArtefacto(nombre);
-        if (mime === undefined || !mime.startsWith("image/")) {
-            return `«${nombre}» no es una imagen, así que no hay nada que mirar.`;
-        }
-        let bytes;
-        try {
-            bytes = await deps.leerArtefacto(nombre);
-        }
-        catch (error) {
-            // El mensaje de un error de Node lleva la ruta absoluta y esto va al modelo: solo el
-            // nombre del error. Y se DEVUELVE, no se lanza: que falte una captura no puede
-            // llevarse el turno por delante.
-            return `No pude abrir «${nombre}» (${error instanceof Error ? error.name : "error"}).`;
+        // Se comprueban las DOS antes de abrir ninguna: ver `veredictoDeImagen`.
+        const deLaCaptura = veredictoDeImagen(entrada.captura, "una captura");
+        if (typeof deLaCaptura === "string")
+            return deLaCaptura;
+        const deLaReferencia = entrada.referencia === undefined
+            ? undefined
+            : veredictoDeImagen(entrada.referencia, "la referencia");
+        if (typeof deLaReferencia === "string")
+            return sinJuzgar(deLaReferencia);
+        const abierta = await leer(entrada.captura, deLaCaptura.mime, deps);
+        if (typeof abierta === "string")
+            return abierta;
+        let referencia;
+        if (entrada.referencia !== undefined && deLaReferencia !== undefined) {
+            const abiertaRef = await leer(entrada.referencia, deLaReferencia.mime, deps);
+            /**
+             * **Fail-closed: una referencia que se pidió y no se pudo abrir es un NO.**
+             *
+             * Lo tentador es juzgar sin ella y avisar. Es justo el fallo que este parámetro
+             * existe para cerrar: un veredicto sin maqueta vuelve como «verde» y se lee como
+             * «se parece al diseño». Así que no se juzga nada, y el paso siguiente que se
+             * escribe es ARREGLAR LA RUTA — nunca «o llámame sin referencia», que sería dejar
+             * el modo ciego escrito dentro de la propia tool como alternativa legítima.
+             */
+            if (typeof abiertaRef === "string")
+                return sinJuzgar(abiertaRef);
+            referencia = abiertaRef;
         }
         let veredicto;
         try {
-            veredicto = await juzgarPantalla({ base64: bytes.toString("base64"), mime }, { pantalla: entrada.pantalla }, deps.invocar);
+            veredicto = await juzgarPantalla(abierta, { pantalla: entrada.pantalla }, deps.invocar, referencia);
         }
         catch (error) {
             // Fallo del ENTORNO —sin modelo, sin clave, sin red—: se dice, y no se convierte en un
             // veredicto. Un rojo inventado culparía al trabajo de un problema de la máquina.
             return `No se pudo consultar al crítico visual: ${error instanceof Error ? error.message : "error"}`;
         }
-        const lineas = [`Veredicto visual de «${entrada.pantalla}»: ${veredicto.veredicto}.`];
+        /**
+         * **La cabecera dice si se COMPARÓ, y no repite la ruta de la referencia.** Lo primero
+         * porque «verde» contesta dos preguntas distintas según el modo y quien lo lea tiene
+         * que saber cuál le han contestado. Lo segundo porque el argumento lo acaba de escribir
+         * quien llama: devolvérselo entero es el eco que ya paga el campo `pantalla`.
+         */
+        const comparado = referencia === undefined ? "" : " (comparado con la referencia)";
+        const lineas = [
+            `Veredicto visual de «${entrada.pantalla}»${comparado}: ${veredicto.veredicto}.`,
+        ];
         if (veredicto.observaciones.length > 0) {
             /**
              * **El aviso no es cortesía: está medido.** Seis vueltas sobre la misma captura
@@ -111,7 +207,18 @@ export function crearCriticaVisual(deps) {
          * puede, porque llegar a una pantalla necesita abrir cajones y mirar el árbol.
          */
         if (veredicto.veredicto === "rojo") {
-            lineas.push("Esto es un defecto del proyecto SIN ARREGLAR, y qué hacer con él depende de TU", "encargo — que lo sabes tú y no yo:", "- Si el encargo incluye ARREGLAR o dejar la app bien: encárgaselo a `developer-xone`", "  pasándole estas observaciones tal cual, y cuando lo haya corregido manda otra vez", "  al conductor a esta misma pantalla y vuelve a llamarme con la captura nueva. No", "  des la pantalla por buena hasta que yo la vea en verde.", "- Si el encargo es OTRO —documentar, medir, inventariar—: NO toques el proyecto por", "  esto. Anótalo donde estés contando lo que ves y sigue con lo tuyo.", "Lo que NO vale en ninguno de los dos casos es callártelo.");
+            /**
+             * **Con referencia, el arreglo es de `designer-xone`.** No es un cambio de criterio:
+             * una diferencia contra una maqueta es visual por definición —forma, tamaño,
+             * colocación, color— y eso es literalmente lo que su `.md` reclama («del color o del
+             * tamaño equivocado… también cuando se arregle en un `.xne`»). Sin referencia el
+             * hallazgo puede ser cualquier cosa, así que esa rama se queda como estaba.
+             */
+            const aQuien = referencia === undefined ? "developer-xone" : "designer-xone";
+            lineas.push("Esto es un defecto del proyecto SIN ARREGLAR, y qué hacer con él depende de TU", "encargo — que lo sabes tú y no yo:", `- Si el encargo incluye ARREGLAR o dejar la app bien: encárgaselo a \`${aQuien}\``, "  pasándole estas observaciones tal cual, y cuando lo haya corregido manda otra vez", "  al conductor a esta misma pantalla y vuelve a llamarme con la captura nueva.", referencia === undefined
+                ? "  No des la pantalla por buena hasta que yo la vea en verde."
+                : "  Y vuelve CON LA MISMA `referencia`: sin ella mi verde solo diría que nada" +
+                    "\n  está roto, no que la pantalla se parezca al diseño.", "- Si el encargo es OTRO —documentar, medir, inventariar—: NO toques el proyecto por", "  esto. Anótalo donde estés contando lo que ves y sigue con lo tuyo.", "Lo que NO vale en ninguno de los dos casos es callártelo.");
         }
         if (veredicto.necesito.length > 0) {
             lineas.push(`Necesita ver ${veredicto.necesito.length === 1 ? "otra pantalla" : "otras pantallas"} para dictaminar: ${veredicto.necesito.join(", ")}.`, `Encarga al conductor que llegue ahí y capture, y vuelve a llamarme con esa captura (como mucho ${TOPE_DE_PETICIONES} veces).`);
@@ -121,7 +228,10 @@ export function crearCriticaVisual(deps) {
         name: "xone_critica_visual",
         description: "Enseña una captura de pantalla del aparato a un revisor visual y devuelve qué se ve " +
             "mal: texto cortado, controles solapados o fuera de la pantalla, cosas ilegibles. " +
-            "Ve lo que ninguna comprobación estática puede ver. Puede pedir otras pantallas.",
+            "Ve lo que ninguna comprobación estática puede ver. Puede pedir otras pantallas. " +
+            "Si el encargo trae un DISEÑO o una MAQUETA, pásala en `referencia` y además comparo " +
+            "la pantalla contra ella (forma, tamaños, colocación, color). SIN `referencia` mi " +
+            "verde significa «nada roto», NO «se parece al diseño».",
         schema: Entrada,
     });
 }

package/dist/agent/grafo/criticaVisual.js.map

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

package/dist/agent/grafo/proyecto.js

@@ -3,8 +3,9 @@ import { join } from "node:path";
 import { CompositeBackend, FilesystemBackend, LocalShellBackend } from "deepagents";
 import { RUTA_MEMORIA_INTERNA, RUTA_MEMORIA_VIRTUAL } from "./memoriaDeProyecto.js";
 import { RAIZ_SKILLS, skillsConRuta, skillsMontables } from "./skills.js";
-import { artefactoFueraDeSitio, mimeDeArtefacto, nombreDeArtefacto, RUTA_ARTEFACTOS, } from "../../core/artefactos.js";
+import { artefactoFueraDeSitio, esBasuraDeArtefacto, esRutaDeArtefacto, mimeDeArtefacto, nombreDeArtefacto, RUTA_ARTEFACTOS, } from "../../core/artefactos.js";
 import { RUTA_ADJUNTOS } from "../../core/adjuntos.js";
+import { carpetaDeHotswap, RUTA_HOTSWAP } from "../../core/hotswap.js";
 import { CARPETA_DE_PLANES, RUTA_PLANES } from "../../core/planes.js";
 import { entornoDeShell, variablesDeAndroid } from "../../core/shellDeAgente.js";
 import { localizadorDeAndroid } from "../dispositivos/dispositivosEnMaquina.js";
@@ -95,7 +96,10 @@ enSdk = localizadorDeAndroid({
         // Sin esto, `xone-arrancar-android` tendría que adivinar dónde está el SDK: en un Mac con
         // Homebrew `emulator` no está en el PATH y `ANDROID_HOME` suele estar vacía.
         android: variablesDeAndroid(enSdk),
-        ...(artefactos === undefined ? {} : { artefactos }),
+        // Las DOS carpetas, y la segunda se DERIVA de la primera: es la misma decisión —¿hay una
+        // sesión con identidad?— y un segundo parámetro sería un segundo sitio donde contestarla,
+        // que es justo el que se cae en un cableado largo.
+        ...(artefactos === undefined ? {} : { artefactos, hotswap: carpetaDeHotswap(artefactos) }),
     });
 }
 /**
@@ -280,6 +284,36 @@ export function backendConDescargas(backend, carpetaDeArtefactos) {
     }
     return new CompositeBackend(backend, montajes);
 }
+/**
+ * Cuelga `/hotswap/` al lado de los artefactos de la sesión — o sea, FUERA del proyecto.
+ *
+ * Es donde el script `xone-hotswap` deja lo que saca del contexto: el árbol de controles de
+ * una pantalla, el log del aparato. El porqué entero —y la medida de los 10 volcados de los
+ * que 6 no volvió a abrir nadie— está en `core/hotswap.ts`.
+ *
+ * La misma pieza que `/skills/`, `/artefactos/`, `/adjuntos/` y las dos de descarga: otra
+ * raíz del `CompositeBackend`, con la barra final obligatoria y sin crear la carpeta al
+ * montar. Y **no se anuncia**, igual que las descargas y al contrario que los artefactos:
+ * ésa es exactamente la diferencia que esta carpeta existe para marcar.
+ *
+ * Que esté MONTADA es la otra mitad del arreglo, y no es opcional. El agente tenía la
+ * carpeta del disco en `$XONECODE_ARTEFACTOS` y ninguna ruta virtual con la que volver a
+ * abrir lo que el script le había guardado; en la traza se le ve probando tres rutas —la
+ * absoluta de la máquina incluida— antes de rendirse y leerlo por la shell. Con esto,
+ * `read_file("/hotswap/<nombre>")` funciona y el script puede NOMBRAR esa ruta en su salida.
+ *
+ * No necesita fila en `permisosDe`: los `deny` de ahí son de `write`, así que leer ya está
+ * permitido, y escribir cae bajo el `deny` general — que es lo correcto, porque quien escribe
+ * aquí es una shell, y una shell no pasa por los permisos.
+ */
+export function backendConHotswap(backend, carpetaDeArtefactos) {
+    return new CompositeBackend(backend, {
+        [RUTA_HOTSWAP]: new FilesystemBackend({
+            rootDir: carpetaDeHotswap(carpetaDeArtefactos),
+            virtualMode: true,
+        }),
+    });
+}
 /**
  * Envuelve el backend del PROYECTO para que una descarga del agente no pueda aterrizar
  * dentro.
@@ -368,7 +402,12 @@ export function backendDeAgente(opciones) {
     const conDescargas = opciones.artefactos === undefined
         ? conArtefactos
         : backendConDescargas(conArtefactos, opciones.artefactos.carpeta);
-    const conAdjuntos = opciones.adjuntos === undefined ? conDescargas : backendConAdjuntos(conDescargas, opciones.adjuntos);
+    // Y `/hotswap/`, de la MISMA carpeta de sesión y por el mismo motivo que las descargas: lo
+    // que una shell saca del contexto se tiene que poder releer, y no se anuncia.
+    const conHotswap = opciones.artefactos === undefined
+        ? conDescargas
+        : backendConHotswap(conDescargas, opciones.artefactos.carpeta);
+    const conAdjuntos = opciones.adjuntos === undefined ? conHotswap : backendConAdjuntos(conHotswap, opciones.adjuntos);
     /**
      * Los PLANES van SIEMPRE, sin depender de la sesión: cuelgan del repo local
      * (`.xonecode/planes/`) y no de la carpeta de una sesión, porque un plan se escribe un día y
@@ -392,9 +431,24 @@ export function backendDeAgente(opciones) {
  * que decir «he dejado una captura» sin que nada lo respalde — que es la clase de afirmación
  * que este harness no quiere.
  *
- * **Se compara una FOTO de antes con una de después** (nombre → tamaño + mtime) en vez de
- * fiarse de lo que el comando diga que hizo. Un comando puede escribir tres ficheros, o
- * ninguno, o pisar el de antes; lo único que lo sabe es la carpeta.
+ * **Se compara una FOTO de antes con una de después** (ruta relativa → tamaño + mtime) en
+ * vez de fiarse de lo que el comando diga que hizo. Un comando puede escribir tres ficheros,
+ * o ninguno, o pisar el de antes; lo único que lo sabe es la carpeta.
+ *
+ * **Y la foto es RECURSIVA, porque un `unzip` deja un ÁRBOL y no un fichero.** Era
+ * `readdirSync` a secas más un `isFile()`, o sea que una carpeta se saltaba entera y con
+ * ella todo lo que llevara dentro. Medido sobre una sesión real: el zip de una maqueta se
+ * descomprimió en `/artefactos/stitch-restaurantes/stitch_screen_complex/` y salieron CERO
+ * anuncios — los tres ficheros estaban en el disco y no existían para nadie, sin pestaña
+ * Artefactos (solo existe si hay alguno) y sin tarjeta en el hilo. Es el mismo fallo que la
+ * carpeta sin crear, un escalón más adentro. No se baja por un ENLACE: `Dirent.isDirectory()`
+ * es falso para uno, y lo que cuelgue de él no es lo que esta sesión produjo.
+ *
+ * Lo que la recursión hace aparecer también se filtra, y las dos cribas son la misma idea:
+ * **no anunciar lo que acaba en una tarjeta muerta**. `esRutaDeArtefacto` es la barrera que
+ * el LECTOR aplica, así que un nombre que él rechazaría (`Diseño final.png`) pintaría una
+ * fila cuyo único final es un 403; y `esBasuraDeArtefacto` retira el `__MACOSX/._x.png` que
+ * un zip de Finder arrastra, que tiene la extensión del bueno y doscientos bytes dentro.
  *
  * **Y la carpeta se CREA aquí, antes de correr el comando.** Es la excepción a «no se crea
  * al montar», y la pagó una captura: `$XONECODE_ARTEFACTOS` la crea `FilesystemBackend.write`
@@ -410,23 +464,38 @@ export function backendDeAgente(opciones) {
 export function anunciarArtefactosDeLaShell(backend, carpeta, alEscribir) {
     const foto = () => {
         const m = new Map();
-        let nombres;
-        try {
-            nombres = readdirSync(carpeta);
-        }
-        catch {
-            return m;
-        }
-        for (const nombre of nombres) {
+        const recorrer = (dir, prefijo) => {
+            let entradas;
             try {
-                const e = statSync(join(carpeta, nombre));
-                if (e.isFile())
-                    m.set(nombre, `${e.size}:${e.mtimeMs}`);
+                entradas = readdirSync(dir, { withFileTypes: true });
             }
             catch {
-                // Un fichero que desaparece entre el listado y la medida no es un artefacto nuevo.
+                return;
             }
-        }
+            for (const entrada of entradas) {
+                // La clave se compone con `/` y nunca con `sep`: es la ruta VIRTUAL que se va a
+                // anunciar, y una barra invertida de Windows no pasaría `esRutaDeArtefacto`.
+                const relativa = prefijo + entrada.name;
+                // `isDirectory()` sobre un `Dirent` es FALSO para un enlace —el dirent dice
+                // `isSymbolicLink()`—, así que no se baja por él. Es la misma disciplina que el
+                // árbol de Ficheros, y aquí importa igual: lo que cuelga de un enlace no es lo que
+                // esta sesión produjo, y se anunciaría con ruta de artefacto.
+                if (entrada.isDirectory()) {
+                    recorrer(join(dir, entrada.name), relativa + "/");
+                    continue;
+                }
+                if (!entrada.isFile())
+                    continue;
+                try {
+                    const e = statSync(join(dir, entrada.name));
+                    m.set(relativa, `${e.size}:${e.mtimeMs}`);
+                }
+                catch {
+                    // Un fichero que desaparece entre el listado y la medida no es un artefacto nuevo.
+                }
+            }
+        };
+        recorrer(carpeta, "");
         return m;
     };
     return new Proxy(backend, {
@@ -455,10 +524,20 @@ export function anunciarArtefactosDeLaShell(backend, carpeta, alEscribir) {
                     // En el `finally`: un comando que acaba en error puede haber dejado el fichero, y
                     // un fallo al listar la carpeta no puede llevarse por delante el resultado.
                     try {
-                        for (const [nombre, marca] of foto()) {
-                            if (antes.get(nombre) === marca)
+                        for (const [relativa, marca] of foto()) {
+                            if (antes.get(relativa) === marca)
+                                continue;
+                            const ruta = RUTA_ARTEFACTOS + relativa;
+                            // Lo que el LECTOR rechazaría no se anuncia: su barrera es la lista blanca de
+                            // forma de `esRutaDeArtefacto`, y una shell escribe el nombre que quiera. Una
+                            // tarjeta cuyo único final posible es un 403 es la misma mentira que un modal
+                            // que solo puede acabar en rechazo.
+                            if (!esRutaDeArtefacto(ruta) || esBasuraDeArtefacto(relativa))
                                 continue;
-                            const ruta = RUTA_ARTEFACTOS + nombre;
+                            // Se compone igual que el Proxy de `write`/`edit`: la RUTA lleva el camino
+                            // relativo —es lo que después se le pide al lector— y el `nombre` es el
+                            // último segmento, que es lo que se le enseña a una persona.
+                            const nombre = nombreDeArtefacto(ruta);
                             const mime = mimeDeArtefacto(nombre);
                             const bytes = Number(marca.split(":")[0] ?? 0);
                             alEscribir({ ruta, nombre, bytes, ...(mime === undefined ? {} : { mime }) });