xonecode 0.6.0 → 0.8.1

package/dist/agent/dispositivos/sensorDeArranque.js

@@ -0,0 +1,154 @@
+/**
+ * El APARATO como sensor del bucle de reparación: ¿qué dice la app al arrancar?
+ *
+ * Es la tercera fuente de hallazgos, y contesta una pregunta que las otras dos no pueden.
+ * `xone-simulator validate` mira la estructura y `smoke` ejecuta el ciclo de vida en un
+ * runtime de Node; ninguno de los dos sabe si la app ARRANCA en un Android de verdad, con su
+ * SQLite, sus recursos y su Rhino. Medido sobre AppDemo: el simulador daba verde y el aparato
+ * decía `Invalid resource ID 0x6000000N` cinco veces distintas.
+ *
+ * CUATRO REGLAS, y las cuatro salieron de medir:
+ *
+ *  - **Despliega SIEMPRE antes de leer.** Sin eso el log sería de la versión anterior del
+ *    proyecto, y devolverle al agente errores que ya arregló es la peor clase de feedback:
+ *    plausible y falso. El despliegue en caliente costó 5 s sobre un `pixel8`.
+ *  - **El buffer se vacía ANTES de reiniciar.** Es lo que ya hace `xone-desplegar-android` por
+ *    su cuenta y por el mismo motivo: si no, lo que se lee es la excepción del intento
+ *    anterior, que es la forma más fácil de creer que algo sigue roto cuando ya no lo está.
+ *  - **Sin aparato es fallo del ENTORNO, no un rojo.** La misma familia que
+ *    `ErrorDelSimulador`: un informe rojo diría «tu proyecto está mal» cuando lo que pasa es
+ *    que no hay móvil enchufado. Y **no se arranca uno solo**: levantar un emulador cuesta
+ *    minutos de la máquina de alguien, y esa decisión no la toma un sensor — para eso está
+ *    `xone-arrancar-android`, que el agente puede llamar.
+ *  - **Solo ve la pantalla de ENTRADA, y se declara.** El despliegue reinicia la app, así que
+ *    lo que se lee es lo que pasa al arrancar. Para tener hallazgos de una colección concreta
+ *    hay que NAVEGAR hasta ella, y eso es trabajo del `device-controller` dentro del turno, no
+ *    de un sensor automático.
+ *
+ * Todo entra por dependencias: `npm test` no puede necesitar un aparato.
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { hallazgosDeLog } from "../../core/logDeDispositivo.js";
+import { RAIZ_SKILLS } from "../grafo/skills.js";
+import { localizadorDeAndroid, TOPES_MS } from "./dispositivosEnMaquina.js";
+import { parsearAdbDevices } from "../../core/dispositivos.js";
+/** No se pudo PREGUNTARLE al aparato. Entorno, no proyecto. */
+export class ErrorDelAparato extends Error {
+    constructor(motivo) {
+        super(motivo);
+        this.name = "ErrorDelAparato";
+    }
+}
+/**
+ * Despliega y devuelve lo que el aparato dijo, en la forma que el bucle ya consume.
+ *
+ * **Verde es que no hay hallazgos DE LA APP.** Lo de la plataforma viaja en el informe —no se
+ * tira nunca, ver `core/logDeDispositivo.ts`— pero como `warning`, así que no pinta el turno
+ * de rojo: son quejas de Android sobre sí mismo y nadie las puede arreglar desde un `.xne`.
+ */
+export async function arranqueEnDispositivo(raiz, deps) {
+    if (!(await deps.hayAparato())) {
+        throw new ErrorDelAparato("no hay ningún aparato conectado, así que no se ha podido probar el arranque");
+    }
+    await deps.limpiarLog();
+    const despliegue = await deps.desplegar(raiz);
+    if (!despliegue.ok) {
+        /**
+         * Que el despliegue falle NO es un proyecto roto: puede ser el túnel, el canal o que el
+         * host no esté instalado. Se lanza, y quien llama lo dice como aviso — igual que el
+         * binario del simulador que falta.
+         */
+        throw new ErrorDelAparato(`no se pudo desplegar en el aparato: ${despliegue.detalle}`);
+    }
+    const { aHallazgosDelTurno } = hallazgosDeLog(await deps.leerLog());
+    const hallazgos = aHallazgosDelTurno();
+    return { verde: !hallazgos.some((h) => h.severidad === "error"), hallazgos };
+}
+/** El host de XOne en Android. Vive aquí y en los scripts de la skill, que son otro proceso. */
+const PAQUETE = "com.xone.android.framework";
+/**
+ * Cuánto se le da al despliegue. El script hace la cadena entera —túnel, ZIP, subida,
+ * reinicio, lanzamiento y comprobación de que la app está VIVA— y sobre un `pixel8` en
+ * caliente tardó 5 s con un proyecto de 6,8 MB. El tope es para el caso frío con un proyecto
+ * grande, y por debajo del tope de reloj de un comando del harness.
+ */
+export const TOPE_DE_DESPLIEGUE_MS = 300_000;
+/**
+ * El sensor de verdad: `adb` para el log y el script de la skill para el despliegue.
+ *
+ * **El despliegue NO se reimplementa aquí.** `xone-desplegar-android` ya es la cadena medida
+ * —y la única que sabe que hay que reiniciar con `SetupActivity` y no con `.mainEntry`, y que
+ * el ZIP va sin `.xonecode`—. Reescribirla sería un segundo sitio donde esa secuencia puede
+ * divergir, que es como este repo se ha roto siempre.
+ */
+export function sensorDeArranqueReal() {
+    const { enSdk } = localizadorDeAndroid({
+        plataforma: process.platform,
+        entorno: process.env,
+        home: process.env["HOME"] ?? "",
+        existe: (ruta) => existsSync(ruta),
+    });
+    const adb = enSdk("adb", "platform-tools");
+    const correr = (binario, args, ms) => new Promise((resolver, rechazar) => {
+        execFile(binario, args, { timeout: ms, maxBuffer: 64 * 1024 * 1024 }, (error, stdout) => {
+            if (error !== null)
+                rechazar(error);
+            else
+                resolver(stdout);
+        });
+    });
+    const exigirAdb = () => {
+        if (adb === undefined)
+            throw new ErrorDelAparato("no encuentro «adb»: ni en el PATH ni en el SDK");
+        return adb;
+    };
+    return {
+        hayAparato: async () => {
+            try {
+                return parsearAdbDevices(await correr(exigirAdb(), ["devices"], TOPES_MS.adb)).some((d) => d.estado === "conectado");
+            }
+            catch {
+                // No poder preguntar no es «no hay»: se dice arriba, con su motivo.
+                throw new ErrorDelAparato("no se pudo preguntar a adb qué aparatos hay");
+            }
+        },
+        limpiarLog: async () => {
+            await correr(exigirAdb(), ["logcat", "-c"], TOPES_MS.adb);
+        },
+        desplegar: async (raiz) => {
+            const script = join(RAIZ_SKILLS, "xone-hotswap", "scripts", "xone-desplegar-android");
+            if (!existsSync(script))
+                return { ok: false, detalle: "falta xone-desplegar-android en el paquete" };
+            try {
+                // El `cwd` es la raíz del proyecto: el script empaqueta lo que hay ahí.
+                await new Promise((resolver, rechazar) => {
+                    execFile(process.execPath, [script], { cwd: raiz, timeout: TOPE_DE_DESPLIEGUE_MS, maxBuffer: 16 * 1024 * 1024 }, (error) => (error === null ? resolver() : rechazar(error)));
+                });
+                return { ok: true, detalle: "" };
+            }
+            catch (error) {
+                // Una línea, no el volcado: esto va a un aviso del turno.
+                const texto = error instanceof Error ? error.message : String(error);
+                return { ok: false, detalle: texto.split("\n")[0] ?? "falló el despliegue" };
+            }
+        },
+        leerLog: async () => {
+            const pid = (await correr(exigirAdb(), ["shell", "pidof", PAQUETE], TOPES_MS.adb))
+                .trim()
+                .split(/\s+/)[0];
+            if (pid === undefined || pid === "") {
+                /**
+                 * La app NO está viva tras desplegar. Es un hecho del proyecto y no del entorno —el
+                 * despliegue dijo que sí—, así que no se lanza: se devuelve lo que haya sin acotar por
+                 * PID, que es donde estará la traza de la muerte. Filtrar por un PID que ya no existe
+                 * se llevaría por delante justo esa traza.
+                 */
+                return correr(exigirAdb(), ["logcat", "-d", "-t", "400"], TOPES_MS.adb);
+            }
+            return correr(exigirAdb(), ["logcat", "-d", "--pid", pid], TOPES_MS.adb);
+        },
+    };
+}
+//# sourceMappingURL=sensorDeArranque.js.map

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

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

package/dist/agent/exportarPdf.js

@@ -0,0 +1,140 @@
+/**
+ * Convertir un documento del proyecto a PDF, imprimiéndolo con un NAVEGADOR.
+ *
+ * El porqué de que esto lo haga el harness y no el agente está en `core/exportacion.ts`.
+ * Aquí está lo que toca disco, y tres decisiones que no son de forma:
+ *
+ * - **El navegador se busca en una lista CERRADA de rutas conocidas**, igual que las
+ *   herramientas de `core/dispositivos.ts`: lo que no está en la lista no se lanza. Y su RUTA
+ *   se queda en el host — por el cable viaja que hay navegador o que no, nunca dónde.
+ * - **Se imprime SIN JavaScript** (`--blink-settings=scriptEnabled=false`). Un `.md` o un
+ *   `.html` del proyecto puede traer un `<script>` dentro, y un PDF no necesita ejecutar
+ *   nada: es la misma razón por la que un artefacto se sirve en un iframe con origen opaco.
+ * - **El HTML intermedio se escribe FUERA del proyecto.** Dentro entraría en git, en el
+ *   commit de cada turno y en la siguiente subida a CloudStudio — un fichero de andamiaje en
+ *   la app del cliente.
+ */
+import { execFile } from "node:child_process";
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { conPoliticaSinScripts, documentoImprimible, esMarkdown, motivoDeExportacionInaceptable, rutaDePdf, } from "../core/exportacion.js";
+import { motivoDeRutaInaceptable } from "./grafo/arbolDeProyecto.js";
+/**
+ * Dónde puede estar un navegador que sepa imprimir. Lista CERRADA y en este orden.
+ *
+ * Son todos Chromium por dentro, que es el que trae `--print-to-pdf`: Safari y Firefox no
+ * tienen equivalente en línea de comandos, así que no están y no es un olvido.
+ */
+export const NAVEGADORES_CONOCIDOS = [
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+    "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+    "/usr/bin/google-chrome",
+    "/usr/bin/google-chrome-stable",
+];
+/** El primero que exista, o AUSENTE. Ausente = aquí no se puede imprimir, y se DICE con el
+ *  remedio: no hay forma de adivinar que lo que falta es un navegador. */
+export function navegadorParaImprimir(existe = existsSync) {
+    return NAVEGADORES_CONOCIDOS.find((ruta) => existe(ruta));
+}
+/** Qué decir cuando no hay ninguno. Vive aquí y no en quien llama para que las tres pieles
+ *  digan lo mismo. */
+export const SIN_NAVEGADOR = "no encuentro un navegador con el que imprimir. El PDF se genera con Chrome, Chromium, Edge o Brave " +
+    "en modo headless; instala uno y vuelve a intentarlo.";
+/**
+ * Exporta `ruta` (relativa al proyecto) a un PDF hermano. Nunca LANZA.
+ *
+ * Las barreras son las MISMAS que usa la pestaña Ficheros y en el mismo orden: la criba de
+ * balde sobre el texto (`motivoDeRutaInaceptable`) y luego el camino REAL, porque un enlace
+ * simbólico dentro de la raíz puede apuntar fuera. No hay una segunda copia de esas reglas
+ * aquí: un segundo sitio donde decidir sobre una ruta es un segundo sitio donde el
+ * fail-closed puede dejar de estarlo.
+ */
+export async function exportarAPdf(opciones) {
+    const malaRuta = motivoDeRutaInaceptable(opciones.ruta);
+    if (malaRuta !== undefined)
+        return { error: malaRuta };
+    const malaExtension = motivoDeExportacionInaceptable(opciones.ruta);
+    if (malaExtension !== undefined)
+        return { error: malaExtension };
+    const navegador = opciones.navegador ?? (opciones.buscarNavegador ?? navegadorParaImprimir)();
+    if (navegador === undefined)
+        return { error: SIN_NAVEGADOR };
+    const origen = resolve(opciones.raiz, opciones.ruta);
+    if (!existsSync(origen))
+        return { error: `«${opciones.ruta}» no está en el proyecto` };
+    let fuente;
+    try {
+        fuente = readFileSync(origen, "utf8");
+    }
+    catch {
+        // El mensaje de Node lleva la ruta absoluta y esto viaja por el cable (`sinRutas`).
+        return { error: `no se pudo leer «${opciones.ruta}»` };
+    }
+    let cuerpo;
+    try {
+        cuerpo = esMarkdown(opciones.ruta) ? await (opciones.aHtml ?? marcadoAHtml)(fuente) : fuente;
+    }
+    catch {
+        return { error: `no se pudo convertir «${opciones.ruta}»` };
+    }
+    // Fuera del proyecto: dentro entraría en git, en el commit del turno y en la subida.
+    const taller = mkdtempSync(join(tmpdir(), "xonecode-pdf-"));
+    const html = join(taller, "documento.html");
+    const destino = resolve(opciones.raiz, rutaDePdf(opciones.ruta));
+    try {
+        writeFileSync(html, esMarkdown(opciones.ruta)
+            ? documentoImprimible(cuerpo, basename(opciones.ruta))
+            : // Un `.html` no pasa por la plantilla, así que se le inyecta la política aparte. No
+                // se envuelve dentro de la nuestra: meter un documento entero en nuestro `<body>`
+                // lo rompería.
+                conPoliticaSinScripts(cuerpo), "utf8");
+        await (opciones.imprimir ?? lanzarNavegador)(navegador, [
+            "--headless",
+            "--disable-gpu",
+            // **Aquí NO va ningún flag para desactivar JavaScript**, y no es un olvido: medido
+            // contra el Chrome instalado, ni `--disable-javascript` ni
+            // `--blink-settings=scriptEnabled=false` lo desactivan — y el segundo además hace que
+            // `--print-to-pdf` no escriba nada, en silencio y saliendo con 0. Lo que sí funciona es
+            // la CSP del documento (`POLITICA_SIN_SCRIPTS`).
+            "--no-pdf-header-footer",
+            `--print-to-pdf=${destino}`,
+            `file://${html}`,
+        ]);
+    }
+    catch (error) {
+        const motivo = error instanceof Error ? error.message : String(error);
+        return { error: `el navegador no pudo imprimir: ${motivo}` };
+    }
+    finally {
+        // El taller se borra pase lo que pase: son ficheros nuestros en un temporal.
+        rmSync(taller, { recursive: true, force: true });
+    }
+    // «Terminó bien» y «hay PDF» son dos cosas: el navegador sale con 0 aunque no escriba nada.
+    // Es la misma regla que ya usa la instalación de dispositivos — manda la MEDIDA, no el
+    // código de salida.
+    if (!existsSync(destino))
+        return { error: "el navegador terminó sin escribir ningún PDF" };
+    return { ruta: rutaDePdf(opciones.ruta) };
+}
+/** `marked` cargado perezosamente, por lo dicho arriba. */
+async function marcadoAHtml(markdown) {
+    const { marked } = await import("marked");
+    return marked.parse(markdown, { async: false });
+}
+function lanzarNavegador(navegador, argumentos) {
+    return new Promise((resolver, rechazar) => {
+        execFile(navegador, [...argumentos], { timeout: TOPE_DE_IMPRESION_MS }, (error) => 
+        // Su stderr trae avisos del sistema gráfico incluso cuando todo va bien, así que lo que
+        // se mira es el error del proceso y después si el fichero está.
+        error === null ? resolver() : rechazar(error));
+    });
+}
+/** Un documento largo con tablas tarda segundos, no minutos; un navegador que no vuelve en
+ *  este plazo está colgado y no imprimiendo. */
+export const TOPE_DE_IMPRESION_MS = 2 * 60 * 1000;
+//# sourceMappingURL=exportarPdf.js.map

package/dist/agent/exportarPdf.js.map

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

package/dist/agent/grafo/criticaVisual.js

@@ -0,0 +1,115 @@
+import { tool } from "@langchain/core/tools";
+import { z } from "zod";
+import { esRutaDeArtefacto, mimeDeArtefacto, nombreDeArtefacto } 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.
+ *
+ * **Por qué es una TOOL y no un paso del cierre.** El crítico necesita PEDIR pantallas —juzga
+ * la captura que le den, así que si el conductor fotografió el login, dictamina sobre el
+ * login—, y quien puede ir a buscarlas es el conductor. Las tres formas de resolver eso se
+ * midieron contra los invariantes del repo y dos se caen solas:
+ *
+ *  - Que el conductor haga de crítico es que el que trabaja se puntúe a sí mismo. Es lo que
+ *    `juezDeTarea` ya prohíbe por escrito —«a un modelo se le puede pedir que avise y a veces
+ *    no avisa»— y lo que el prompt del conductor tiene prohibido («no digas que hiciste un
+ *    paso que no hiciste»). Medido el mismo día: un turno describió los 19 botones de una
+ *    pantalla leyéndolos del `.xne` y se leía como si los hubiera visto.
+ *  - Que el crítico conduzca el aparato es darle una shell, y el invariante es «backend con
+ *    shell, exactamente UNO»: una shell no pasa por `permisosDe` ni por el `virtualMode`, o
+ *    sea que concederla es conceder la máquina — y precisamente al que existe para ser
+ *    independiente.
+ *
+ * Queda ésta: el crítico **pide por nombre** y el orquestador vuelve a delegar en el
+ * conductor. La tool no toca el aparato, no escribe nada y solo lee de la carpeta de
+ * artefactos de la sesión.
+ *
+ * **La guarda de ruta se RE-APLICA a mano**, como en las otras dos tools propias: una tool de
+ * LangChain añadida por xonecode NO pasa por el middleware de permisos, así que sin esto sería
+ * una forma de leer cualquier fichero de la máquina y mandárselo a un modelo.
+ */
+const Entrada = z.object({
+    captura: z
+        .string()
+        .describe("La ruta virtual de la captura, siempre bajo /artefactos/ (la que anunció el evento)"),
+    pantalla: z
+        .string()
+        .describe("De qué pantalla o colección es la captura, para que el crítico sepa qué mira"),
+});
+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"}).`;
+        }
+        let veredicto;
+        try {
+            veredicto = await juzgarPantalla({ base64: bytes.toString("base64"), mime }, { pantalla: entrada.pantalla }, deps.invocar);
+        }
+        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}.`];
+        if (veredicto.observaciones.length > 0) {
+            /**
+             * **El aviso no es cortesía: está medido.** Seis vueltas sobre la misma captura
+             * describieron un texto CORTADO como «girado 180°», y pedirle en el prompt que no
+             * diagnostique no lo evitó. A dónde apunta sí acertó las seis veces. Sin esta línea,
+             * el desarrollador se pone a buscar una rotación que no existe.
+             */
+            lineas.push("Lo que dice que ve (la REDACCIÓN no es fiable: describe mal la causa. Fíate de QUÉ", "control señala, no de su explicación, y míralo tú):");
+            for (const o of veredicto.observaciones)
+                lineas.push(`- ${o}`);
+        }
+        /**
+         * **Un rojo tiene que ENTERAR a alguien, y el sitio fuerte es aquí.**
+         *
+         * La regla de «lo que salga vuelve a `developer-xone`» vive en el prompt del
+         * orquestador, o sea a miles de tokens del momento en que llega el veredicto. Eso es
+         * una sugerencia. Este repo ya tiene escrito que «los avisos de honestidad son código,
+         * no prompt», y el patrón para que un modelo haga lo siguiente es el de
+         * `xone_navegacion` cuando no sabe contestar: se devuelve el PASO SIGUIENTE escrito, no
+         * un consejo — a un modelo al que se le dice qué hacer sin decirle cómo se le inventa
+         * los argumentos.
+         *
+         * **Límite declarado, y es el que queda abierto**: esto no es un tope. No puede serlo
+         * desde aquí, porque la tool se construye por SESIÓN y no por turno, así que no tiene
+         * dónde contar las vueltas. Lo que acota hoy es que cada arreglo pasa por una
+         * aprobación humana. Un tope de verdad exige que el bucle lo lleve el harness
+         * (`conVerificacion`), y eso pide conducir el aparato desde código — medido: no se
+         * 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: no lo cuentes y ya está. 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.");
+        }
+        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).`);
+        }
+        return lineas.join("\n");
+    }, {
+        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.",
+        schema: Entrada,
+    });
+}
+//# sourceMappingURL=criticaVisual.js.map

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

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

package/dist/agent/grafo/navegacionXone.js

@@ -1,6 +1,8 @@
 import { tool } from "@langchain/core/tools";
 import { z } from "zod";
+import { partirNombre } from "../../core/navegacion.js";
 import { llamadaDeBusqueda } from "./busquedaRegex.js";
+import { pintarEstiloDeProp } from "../../core/estilos.js";
 /**
  * `xone_navegacion`: preguntar por la ESTRUCTURA del proyecto sin leer ficheros.
  *
@@ -36,16 +38,19 @@ export const LIMITES_NAVEGACION = {
 };
 const ESQUEMA = z.object({
     operacion: z
-        .enum(["inventario", "definicion", "referencias", "campos", "detalle", "app", "problemas"])
+        .enum(["inventario", "definicion", "referencias", "campos", "detalle", "app", "problemas", "estilos"])
         .describe("inventario: todas las colecciones. definicion: dónde se declara. referencias: quién la usa. " +
         "campos: los campos de una colección. detalle: todo de una (campos, eventos, nodos, conexiones). " +
-        "app: por dónde arranca la aplicación, login y estilos. problemas: referencias rotas y colecciones que no usa nadie"),
+        "app: por dónde arranca la aplicación, login y estilos. problemas: referencias rotas y colecciones que no usa nadie. " +
+        "estilos: qué estilo acaba aplicándosele a un control y de qué clase y fichero sale — resuelve la cascada, " +
+        "que es lo que no se puede averiguar leyendo una hoja de arriba abajo"),
     nombre: z
         .string()
         .min(1)
         .max(200)
         .optional()
-        .describe("`Coleccion` o `Coleccion.CAMPO`. No hace falta en `inventario`"),
+        .describe("`Coleccion` o `Coleccion.CAMPO`. No hace falta en `inventario`. En `estilos` tiene que ser " +
+        "`Coleccion.CONTROL`"),
 });
 /** Recorta y DICE lo que se dejó fuera. */
 function recortar(lista, tope, pinta) {
@@ -61,7 +66,7 @@ const pintarReferencia = (r) => `${r.desde} --${r.por}--> ${r.hacia}  ${r.ficher
  * pueda decir sobre QUÉ proyecto pregunta: si pudiera, esto sería una tool que lee cualquier
  * carpeta de la máquina.
  */
-export function crearNavegacionXone(cargar, ficheros) {
+export function crearNavegacionXone(cargar, ficheros, cargarEstilos) {
     return tool(async (entrada) => {
         let indice;
         try {
@@ -127,6 +132,34 @@ export function crearNavegacionXone(cargar, ficheros) {
             }
             return recortar(campos, LIMITES_NAVEGACION.campos, pintarDeclaracion);
         }
+        if (entrada.operacion === "estilos") {
+            /**
+             * **La capa que no tenía índice.** Medido sobre diez pasadas del mismo encargo visual:
+             * el turno se iba en 30-42 `grep` de los cuales ~22 de cada 30 eran la MISMA clase con
+             * variantes (`xnTituloHeaderC`, `.xnTituloHeader`, `xnHeader`…), más cinco ficheros CSS
+             * y varios `.xne` ajenos buscando ejemplos. Nada de eso lo contestaba este índice,
+             * porque indexa el modelo `.xne` y el arreglo visual vive en los estilos.
+             *
+             * La cascada la resuelve `xone-linter` (`Stylesheet.lookup`, fiel a
+             * `FindStylesheetByClassName`), no nosotros: ver `agent/navegacion/estilosEnDisco.ts`.
+             */
+            if (cargarEstilos === undefined) {
+                return "Esta operación no está disponible en este montaje: no se cableó el resolvedor de estilos.";
+            }
+            const { coleccion, campo } = partirNombre(nombre);
+            if (campo === undefined || campo === "") {
+                return ("`estilos` necesita el control, no solo la colección: escríbelo como " +
+                    "`Coleccion.CONTROL`. Con `detalle Coleccion` sale la lista de sus campos.");
+            }
+            const estilo = await cargarEstilos(coleccion, campo);
+            if (estilo === undefined) {
+                // Ni la coll ni el prop: se dice cómo averiguar CUÁL de las dos falta, en vez de
+                // dejar al agente probando nombres. Misma postura que `detalle`.
+                return (`No encuentro el control «${nombre}». Prueba \`detalle ${coleccion}\` para ver sus ` +
+                    `campos, o búscalo como texto:\n${llamadaDeBusqueda(campo)}`);
+            }
+            return pintarEstiloDeProp(estilo);
+        }
         if (entrada.operacion === "detalle") {
             const d = indice.detalle(nombre);
             // `undefined` y no un detalle vacío: «no existe» y «existe y está vacía» son dos

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

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

package/dist/agent/grafo/perfiles.js

@@ -8,6 +8,8 @@
  * monta su aprobación humana. Un `.md` puede cambiar el prompt de un agente; no puede
  * concederle leer `/.env`.
  */
+import { esRutaDeArtefacto, RUTA_ARTEFACTOS } from "../../core/artefactos.js";
+import { esRutaDePlan, RUTA_PLANES } from "../../core/planes.js";
 import { artefactoFueraDeSitio } from "../../core/artefactos.js";
 /** Las tools de fichero que monta deepagents sobre el backend. */
 export const TOOLS_LECTURA = ["ls", "read_file", "glob", "grep"];
@@ -54,14 +56,35 @@ export function permisosDe(perfil) {
     const base = [...DENEGADO_SIEMPRE];
     if (!perfil.soloLectura)
         return base;
-    // OJO: este `/**` también deniega `/artefactos/**`, así que un agente de SOLO LECTURA no
-    // puede dejar una captura CON UNA TOOL DE FICHERO. `device-controller` la deja igual, pero
-    // por otro camino —un comando, que no pasa por aquí— y por eso el anuncio del artefacto
-    // tuvo que ir aparte (`proyecto.ts#anunciarArtefactosDeLaShell`). Si algún día hace falta
-    // un productor de solo lectura SIN shell, la excepción va aquí, y antes hay que medir el
-    // orden de reglas de deepagents (¿gana la primera que casa, o gana la denegación?), porque
-    // de eso depende que un `allow` sobre `/artefactos/**` haga algo o sea decorativo.
-    return [...base, { operations: ["write"], paths: ["/**"], mode: "deny" }];
+    /**
+     * **Un agente de SOLO LECTURA sí puede dejar ARTEFACTOS, y la medida que lo permite está
+     * hecha.** Este `/**` también denegaba `/artefactos/**`, así que un productor sin shell no
+     * podía dejar nada escrito —un análisis, un plan, un informe— aunque no tocara el proyecto.
+     * `device-controller` los deja por otro camino, un comando, que no pasa por aquí, y por eso
+     * su anuncio vive aparte (`proyecto.ts#anunciarArtefactosDeLaShell`).
+     *
+     * La duda que quedaba anotada era si un `allow` haría algo o sería decorativo. **Medido
+     * contra la librería**: `decidePathAccess` es *first-match-wins* con default permisivo, y su
+     * propio docstring lo dice. O sea que la excepción funciona **si va delante** del `deny`
+     * general — y por eso el orden de estas tres líneas no es estilo, es la regla.
+     *
+     * Va DETRÁS de `DENEGADO_SIEMPRE` a propósito: con first-match-wins, eso es lo que mantiene
+     * ganando a `/.env`, `/.git` y `/.xonecode`. Delante de ellas, un patrón más ancho escrito
+     * mañana los abriría.
+     *
+     * Y lo que concede está acotado por construcción: `/artefactos/` no es del proyecto, no
+     * entra en git, no sube a CloudStudio, no pasa por aprobación —por eso se ANUNCIA con su
+     * evento— y `artefactoFueraDeSitio` ya impide que nada de ahí acabe dentro de la app.
+     */
+    return [
+        ...base,
+        { operations: ["write"], paths: [`${RUTA_ARTEFACTOS}**`], mode: "allow" },
+        // Y los PLANES, por lo mismo: quien analiza escribe el plan y quien desarrolla marca ahí
+        // lo hecho, así que los dos tienen que poder escribir — y ninguno de los dos está tocando
+        // el proyecto. `.xonecode/planes/` no entra en git ni sube a CloudStudio.
+        { operations: ["write"], paths: [`${RUTA_PLANES}**`], mode: "allow" },
+        { operations: ["write"], paths: ["/**"], mode: "deny" },
+    ];
 }
 /**
  * Las tools de fichero de un agente con EJECUCIÓN.
@@ -195,13 +218,33 @@ export function hitlDe(perfil) {
  *
  * Lo que pasa después es lo que se busca: la tool corre, el backend devuelve su `{error}` con
  * la ruta buena, y el modelo reintenta en `/artefactos/`.
+ *
+ * **Y un SEGUNDO motivo, que es de coherencia y no de relajación**: tampoco se pregunta por lo
+ * que NO ES EL PROYECTO —`/artefactos/` y `/planes/`—. No es una excepción nueva: un perfil de
+ * SOLO LECTURA ya escribe esas dos rutas sin aprobación ninguna, porque `hitlDe` le devuelve
+ * `{}` y sus `permissions` lo confinan exactamente ahí. O sea que la misma ruta no se aprobaba
+ * para el analista y sí para el desarrollador, y eso no es una barrera: es una incoherencia que
+ * se paga cara — medido, el desarrollador fue a marcar como hecha una tarea de un plan, salió
+ * un modal, se rechazó, y el plan se quedó viejo en silencio. En una tarea de fondo no hay
+ * nadie que pulse, así que el plan NUNCA se marcaría.
+ *
+ * Ninguna de las dos rutas es la app del cliente: no entran en el commit del turno, no van a
+ * git y no suben a CloudStudio. Lo que sigue intacto es lo único que importa: **por un fichero
+ * del PROYECTO siempre se pregunta**, y el test lo comprueba ruta a ruta.
  */
 export function seDetieneEn(peticion) {
     const args = peticion?.toolCall?.args;
     const ruta = args?.["file_path"];
     if (typeof ruta !== "string")
         return true;
+    // (1) Lo que el backend va a rechazar de todas formas: un modal cuyo único final posible es
+    //     un rechazo enseña a aprobar sin mirar.
+    if (artefactoFueraDeSitio(ruta) !== undefined)
+        return false;
+    // (2) Lo que NO es el proyecto. Ver la cabecera: esto quita una incoherencia, no una barrera.
+    if (esRutaDeArtefacto(ruta) || esRutaDePlan(ruta))
+        return false;
     // Ante la duda, se PREGUNTA: es la dirección conservadora de siempre.
-    return artefactoFueraDeSitio(ruta) === undefined;
+    return true;
 }
 //# sourceMappingURL=perfiles.js.map