xonecode 0.6.0 → 0.8.0

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":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,EACV,8BAA8B,EAC9B,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,8DAA8D;IAC9D,oDAAoD;IACpD,gEAAgE;IAChE,8DAA8D;IAC9D,mBAAmB;IACnB,2BAA2B;IAC3B,wBAAwB;IACxB,+BAA+B;CACvB,CAAC;AAEX;0EAC0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,SAAoC,UAAU;IAClF,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;sBACsB;AACtB,MAAM,CAAC,MAAM,aAAa,GACxB,qGAAqG;IACrG,sDAAsD,CAAC;AAIzD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAmBlC;IACC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACvD,MAAM,aAAa,GAAG,8BAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAEjE,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,qBAAqB,CAAC,EAAE,CAAC;IAC9F,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAE7D,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,IAAI,0BAA0B,EAAE,CAAC;IAEvF,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,oFAAoF;QACpF,OAAO,EAAE,KAAK,EAAE,oBAAoB,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,yBAAyB,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;IAC9D,CAAC;IAED,qFAAqF;IACrF,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,aAAa,CACX,IAAI,EACJ,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC,CAAC,oFAAoF;gBACpF,kFAAkF;gBAClF,eAAe;gBACf,qBAAqB,CAAC,MAAM,CAAC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,eAAe,CAAC,CAAC,SAAS,EAAE;YACtD,YAAY;YACZ,eAAe;YACf,mFAAmF;YACnF,2DAA2D;YAC3D,sFAAsF;YACtF,wFAAwF;YACxF,iDAAiD;YACjD,wBAAwB;YACxB,kBAAkB,OAAO,EAAE;YAC3B,UAAU,IAAI,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,EAAE,KAAK,EAAE,kCAAkC,MAAM,EAAE,EAAE,CAAC;IAC/D,CAAC;YAAS,CAAC;QACT,6EAA6E;QAC7E,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,4FAA4F;IAC5F,uFAAuF;IACvF,oBAAoB;IACpB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;IAC3F,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,2DAA2D;AAC3D,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAW,CAAC;AAC5D,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB,EAAE,UAA6B;IACvE,OAAO,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE;QACxC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;QAChF,wFAAwF;QACxF,gEAAgE;QAChE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;gDACgD;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC"}

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

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

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

package/dist/agent/grafo/proyecto.js

@@ -1,11 +1,13 @@
-import { existsSync, readdirSync, statSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
 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 { RUTA_ADJUNTOS } from "../../core/adjuntos.js";
-import { entornoDeShell } from "../../core/shellDeAgente.js";
+import { CARPETA_DE_PLANES, RUTA_PLANES } from "../../core/planes.js";
+import { entornoDeShell, variablesDeAndroid } from "../../core/shellDeAgente.js";
+import { localizadorDeAndroid } from "../dispositivos/dispositivosEnMaquina.js";
 import { RUTAS_DE_DESCARGA, carpetaDeDescargas, descargaFueraDeSitio, porQueNoEsDelProyecto, } from "../../core/descargas.js";
 /**
  * El backend del proyecto: confinado, y sin las vistas aplanadas.
@@ -66,7 +68,19 @@ export function backendDelProyectoConShell(raiz, entorno) {
  * backend y que `cargarAgentes`: una skill instalada con la consola abierta no alcanza a la
  * sesión en curso, que es el límite ya anotado en CLAUDE.md y no uno nuevo.
  */
-export function entornoDeLaShellDelProyecto(raiz, artefactos) {
+export function entornoDeLaShellDelProyecto(raiz, artefactos, 
+/**
+ * El buscador de binarios del SDK de Android. Entra por parámetro **solo** para que un test
+ * pueda ver que está montado: esta función toca `process.env` y `existsSync`, así que sin
+ * inyectarlo la composición viviría donde ningún test la alcanza — el patrón de fallo que
+ * este repo lleva contadas nueve veces. En producción no lo pasa nadie.
+ */
+enSdk = localizadorDeAndroid({
+    plataforma: process.platform,
+    entorno: process.env,
+    home: process.env["HOME"] ?? "",
+    existe: (ruta) => existsSync(ruta),
+}).enSdk) {
     // `skillsConRuta` y no `skillsMontables`: aquélla deja fuera las de SERIE —su raíz se cuelga
     // entera en el backend— y una shell necesita la ruta real de todas. Sin esto, los scripts de
     // las skills de serie no llegan al PATH y el agente se queda buscándolos por el disco.
@@ -78,6 +92,9 @@ export function entornoDeLaShellDelProyecto(raiz, artefactos) {
         // va aquí porque `entornoDeShell` es puro: prometer en el PATH una carpeta que no está es
         // el botón muerto de siempre, solo que en una variable de entorno.
         binarios: skills.map((s) => join(s.dir, "scripts")).filter((d) => existsSync(d)),
+        // 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 }),
     });
 }
@@ -155,6 +172,30 @@ export function backendConAdjuntos(backend, carpeta) {
         [RUTA_ADJUNTOS]: new FilesystemBackend({ rootDir: carpeta, virtualMode: true }),
     });
 }
+/**
+ * Cuelga `/planes/` de `.xonecode/planes/`, en el repo LOCAL.
+ *
+ * El porqué de ese sitio está en `core/planes.ts`. Lo que aporta esto es el montaje, y tiene
+ * las mismas dos trampas que `/artefactos/` y `/skills/`:
+ *
+ *  - **La barra final es obligatoria**: `CompositeBackend` la retira antes de delegar, y sin
+ *    ella reconstruye `//favoritos/PLAN.md`, que `FilesystemBackend` interpreta fuera de su
+ *    raíz.
+ *  - **La carpeta NO se crea al montar**: la crea `FilesystemBackend.write` la primera vez que
+ *    se escribe. Un proyecto en el que nadie ha planificado no tiene por qué tener la carpeta.
+ *
+ * Y una diferencia con los artefactos que es el motivo de que exista: esto **no se anuncia**.
+ * Un artefacto se enseña una vez; un plan se escribe, se lee y se ACTUALIZA por varios
+ * especialistas a lo largo de varios turnos, así que un evento por escritura sería ruido.
+ */
+export function backendConPlanes(backend, raiz) {
+    return new CompositeBackend(backend, {
+        [RUTA_PLANES]: new FilesystemBackend({
+            rootDir: join(raiz, CARPETA_DE_PLANES),
+            virtualMode: true,
+        }),
+    });
+}
 /**
  * Cuelga `/artefactos/` de la carpeta de la SESIÓN, fuera del proyecto.
  *
@@ -328,12 +369,18 @@ export function backendDeAgente(opciones) {
         ? conArtefactos
         : backendConDescargas(conArtefactos, opciones.artefactos.carpeta);
     const conAdjuntos = opciones.adjuntos === undefined ? conDescargas : backendConAdjuntos(conDescargas, 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
+     * se implementa otro. Es la diferencia con los artefactos, que mueren con su sesión.
+     */
+    const conPlanes = backendConPlanes(conAdjuntos, opciones.raiz);
     // Lo que deje un COMANDO en la carpeta de artefactos también se anuncia. Sin esto, la
     // captura que escribe un script existe en el disco y no existe para nadie: el evento
     // `artefacto` lo emite el Proxy de `write`/`edit`, y una shell no pasa por ahí.
     return opciones.ejecucion === undefined || opciones.artefactos === undefined
-        ? conAdjuntos
-        : anunciarArtefactosDeLaShell(conAdjuntos, opciones.artefactos.carpeta, opciones.artefactos.alEscribir);
+        ? conPlanes
+        : anunciarArtefactosDeLaShell(conPlanes, opciones.artefactos.carpeta, opciones.artefactos.alEscribir);
 }
 /**
  * Anuncia lo que un COMANDO deja en la carpeta de artefactos.
@@ -347,8 +394,18 @@ export function backendDeAgente(opciones) {
  *
  * **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. Y si la carpeta no
- * existe —no se crea al montar, a propósito— la foto es vacía y no falla.
+ * ninguno, o pisar el de antes; lo único que lo sabe es la carpeta.
+ *
+ * **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`
+ * la primera vez que el agente escribe un artefacto por una TOOL, y una shell no pasa por
+ * ahí — así que en una sesión que no había dibujado nada, el `writeFileSync` del script de
+ * captura reventaba con ENOENT (reproducido) y el modelo se replegaba a dejar el `.png` en
+ * la raíz del proyecto, que es justo lo que la regla existe para impedir. El sitio es este y
+ * no el script: quien SABE que va a correr una shell y DÓNDE está la carpeta es el harness,
+ * y arreglarlo en el script lo dejaría arreglado en uno de cinco —y en ninguna skill del
+ * usuario—, que es el patrón de fallo de siempre. Se crea solo cuando hay ejecución, así que
+ * una sesión de los otros cuatro especialistas sigue sin carpeta vacía.
  */
 export function anunciarArtefactosDeLaShell(backend, carpeta, alEscribir) {
     const foto = () => {
@@ -380,6 +437,16 @@ export function anunciarArtefactosDeLaShell(backend, carpeta, alEscribir) {
             if (prop !== "execute")
                 return valor.bind(destino);
             return async (...args) => {
+                try {
+                    // Antes de la foto: si el comando es el que escribe la captura, la carpeta tiene
+                    // que existir YA. Un fallo al crearla no puede tumbar el comando —se podía correr
+                    // sin carpeta antes de esto—, así que se traga y la foto sigue tolerando su
+                    // ausencia.
+                    mkdirSync(carpeta, { recursive: true });
+                }
+                catch {
+                    // Sin carpeta no hay artefactos que anunciar, y el comando no es asunto suyo.
+                }
                 const antes = foto();
                 try {
                     return await valor.apply(destino, args);