xonecode 0.5.0 → 0.6.0

package/dist/agent/{xoneAgent.js → grafo/xoneAgent.js}

@@ -1,15 +1,19 @@
 import { createDeepAgent, createFilesystemMiddleware } from "deepagents";
-import { promptDeAgente, repartirSkills } from "../core/agentes.js";
+import { MAPA_DEL_PROYECTO, promptDeAgente, repartirSkills } from "../../core/agentes.js";
 import { RunnableLambda } from "@langchain/core/runnables";
 import { AIMessage } from "@langchain/core/messages";
 import { MemorySaver } from "@langchain/langgraph";
-import { backendDeAgente } from "./proyecto.js";
-import { permisosDe, hitlDe } from "./perfiles.js";
+import { backendDeAgente, entornoDeLaShellDelProyecto } from "./proyecto.js";
+import { permisosDe, hitlDe, montajeDeFicheros, puedeEjecutar } from "./perfiles.js";
 import { crearBusquedaRegex } from "./busquedaRegex.js";
-import { inventarioDelProyecto } from "./escrituraExterna.js";
-import { middlewareTextoDeTool } from "./textoDeTool.js";
-import { resumenDeContexto } from "./resumenDeContexto.js";
-import { createTokenTrackingMiddleware, } from "../vendor/tokenTracking.js";
+import { crearNavegacionXone } from "./navegacionXone.js";
+import { indiceEnDisco } from "../navegacion/indiceEnDisco.js";
+import { inventarioDelProyecto } from "../subagentes/escrituraExterna.js";
+import { middlewareTextoDeTool } from "../turno/textoDeTool.js";
+import { resumenConEncargo, topeDeLlamadas, topeDeTools } from "../turno/resumenDeContexto.js";
+import { inspectorDePrompt } from "../turno/inspectorDePrompt.js";
+import { excluirTools, toolsQueNoUsa } from "./excluirTools.js";
+import { createTokenTrackingMiddleware, } from "../../vendor/tokenTracking.js";
 /**
  * El prompt del orquestador, GENERADO a partir de los subagentes que hay.
  *
@@ -36,17 +40,32 @@ export function promptOrquestador(agentes) {
     const hay = (n) => agentes.some((a) => a.nombre === n);
     return [
         "Eres el orquestador de un harness de desarrollo para la plataforma XOne.",
+        // El mapa lo ve él TAMBIÉN, y no solo los especialistas: desde que contesta lo que puede
+        // en vez de delegarlo todo, es quien más lo necesita.
+        MAPA_DEL_PROYECTO,
         // Decía «NO tienes herramientas», y era falso: tiene las seis de fichero. Ahora son de
         // SOLO LECTURA (`PERFIL_DEL_ORQUESTADOR`), así que la frase dice lo que de verdad puede.
-        "NO tienes herramientas para MODIFICAR nada: tu único trabajo es entender la petición y delegar.",
+        //
+        // Y decía «tu único trabajo es delegar», que era falso por el otro lado y CARO: medido con
+        // el banco (`docs/bancos/2026-09-17-base.json`), la misma pregunta de estructura costaba
+        // 9.462 tokens contestada aquí y 38.198 delegada, con la MISMA respuesta buena. Delegar es
+        // un viaje entero de ida y vuelta con el prompt de un especialista detrás, así que para lo
+        // que se resuelve con un `grep` no compra nada. La regla es explícita en las dos
+        // direcciones porque «puedes leer» a secas no le quitaba la orden de delegar siempre.
+        "NO tienes herramientas para MODIFICAR nada, pero SÍ para LEER y BUSCAR.",
+        "Si la pregunta se contesta mirando el proyecto —dónde se declara algo, qué colecciones hay,",
+        "qué valor tiene un atributo, qué fichero incluye a cuál—, CONTÉSTALA TÚ: busca con `grep` y",
+        "lee lo justo. Delegar cuesta varias veces más y no la contesta mejor.",
+        "Delega cuando haya que ESCRIBIR ficheros (tú no puedes), cuando el encargo tenga varios",
+        "pasos, o cuando haga falta el criterio de un especialista.",
         agentes.length === 0
             ? "AVISO: ahora mismo no hay ningún especialista dado de alta, así que no puedes delegar en nadie. Dilo en vez de intentar resolverlo tú."
             : `Los especialistas disponibles son: ${agentes.map((a) => a.nombre).join(", ")}. Elige por su descripción.`,
-        hay("planner") && hay("mockup")
-            ? "Para diagramas o esquemas de la app, delega en `mockup`; si deben reflejar el código real, encarga PRIMERO el análisis a `planner` y usa su resultado antes de dibujar."
+        hay("analyst-xone") && hay("designer-xone")
+            ? "Para diagramas o esquemas de la app, delega en `designer-xone`; si deben reflejar el código real, encarga PRIMERO el análisis a `analyst-xone` y usa su resultado antes de dibujar."
             : "",
         "Los especialistas no comparten el transcript: al encadenarlos, incluye en la descripción",
-        "de la siguiente `task` un bloque `HANDOFF DE PLANNER` compacto con los hechos verificados,",
+        "de la siguiente `task` un bloque `HANDOFF DE ANÁLISIS` compacto con los hechos verificados,",
         "rutas/evidencias y lagunas. No pidas al siguiente especialista redescubrir esos hechos.",
         "Cuando varias tareas sean independientes, delégalas EN EL MISMO mensaje para",
         "que corran a la vez.",
@@ -61,13 +80,23 @@ export function promptOrquestador(agentes) {
  * No crean herramientas ni rebajan permisos: hacen explícito el destino correcto
  * para que una skill no confunda su propia carpeta de instrucciones con la salida.
  */
+/**
+ * **`read_file` NO está aquí, y es deliberado.**
+ *
+ * Una descripción propia REEMPLAZA la de la librería, no se suma a ella, así que la nuestra
+ * —que solo hablaba de coste— borraba tres cosas que deepagents ya dice y que no son nuestras
+ * de decir: que la salida lleva una cabecera de formato **que no hay que reinyectar al
+ * editar** (eso es CORRECCIÓN, no ahorro), que conviene pedir varias lecturas en una misma
+ * respuesta, y que un resultado grande se descarga a `/large_tool_results/` y se pagina desde
+ * ahí. Medido al comparar dos parches suyos: entre `1.13.2` y `1.13.5` ese formato CAMBIÓ
+ * —de prefijos de número de línea a una cabecera `@@ … @@`— y con él la advertencia. Una copia
+ * nuestra habría quedado describiendo un formato que ya no existe, sin un error que leer.
+ *
+ * La regla: lo que describe la TOOL es de la librería y se actualiza con ella; lo que decimos
+ * nosotros es cómo QUEREMOS usarla, y eso vive en el prompt del especialista
+ * (`core/agentes.ts#promptDeAgente`), donde no compite con nada.
+ */
 export const DESCRIPCIONES_FICHEROS = {
-    read_file: [
-        "Lee únicamente el fragmento de un fichero necesario para responder.",
-        "Indica siempre `offset` y `limit`; para el reconocimiento inicial usa",
-        "`offset=0, limit=50`. No releas la misma ruta y el mismo rango: usa la",
-        "evidencia ya obtenida o una página distinta solo si hace falta.",
-    ].join(" "),
     write_file: [
         "Escribe un fichero del proyecto en una ruta absoluta.",
         "Para diagramas, esquemas, arquitecturas y flujos: carga primero la skill `archify`;",
@@ -89,9 +118,11 @@ export const DESCRIPCIONES_FICHEROS = {
         "Busca texto LITERAL (no regex) de forma progresiva para ahorrar contexto.",
         "Primero acota con `path` y `glob`; para localizar candidatos usa",
         "`output_mode=\"files_with_matches\"` o `output_mode=\"count\"`.",
-        "Usa `output_mode=\"content\"` solo con un patrón específico y lee después",
-        "el fragmento necesario con `read_file` (offset y limit). La búsqueda devuelve",
+        "Usa `output_mode=\"content\"` solo con un patrón específico: devuelve la ruta y el NÚMERO",
+        "DE LÍNEA de cada coincidencia, así que lee después con `read_file` ALREDEDOR de esa línea",
+        "(`offset` = línea menos 5), nunca desde el principio del fichero. La búsqueda devuelve",
         "como máximo 100 coincidencias salvo que justifiques subir `max_count`.",
+        "Varias búsquedas independientes van en el MISMO mensaje, igual que las lecturas.",
     ].join(" "),
 };
 /**
@@ -107,7 +138,7 @@ export const DESCRIPCIONES_FICHEROS = {
  * no consume toda la ventana antes de que actúe el resumen de conversación.
  *
  * **Esa carpeta se monta FUERA del proyecto** (`core/descargas.ts`,
- * `agent/proyecto.ts#backendConDescargas`), y hasta el 10-09-2026 no: la escribe la librería
+ * `agent/grafo/proyecto.ts#backendConDescargas`), y hasta el 10-09-2026 no: la escribe la librería
  * llamando al backend directamente, esa ruta no estaba montada en ninguna parte y caía en el
  * `FilesystemBackend` de la raíz. Medido en el AppDemo real del usuario, 26 KB de salida
  * cruda de una tool dentro de la app XOne y commiteados. Bajar este tope no era el arreglo:
@@ -132,16 +163,50 @@ export const OPCIONES_BUSQUEDA_FICHEROS = {
  *    ocupar el nombre lo sustituye en el catálogo (`agent/generalPurpose.test.ts`).
  * 4. **El HITL va en las tools de fichero**, que en la v1 son las que escriben.
  */
+/** El inspector, o nada: `inspectorDePrompt` devuelve `undefined` si no se ha pedido. */
+function inspector(raiz, origen) {
+    const mw = inspectorDePrompt(raiz, origen);
+    return mw === undefined ? [] : [mw];
+}
 export async function construirAgente(opciones) {
     // Las cuatro capas y su orden están en `backendDeAgente`, que vive en `proyecto.ts` para
     // poder PROBARSE: aquí no había forma, porque `construirAgente` se simula en todos los
     // tests que lo tocan y el cableado se quedaba sin nadie mirándolo.
-    const backend = backendDeAgente({
+    /**
+     * El cargador del índice de navegación, con la RAÍZ ya fijada.
+     *
+     * Entra por opción para poder doblarse en un test, y con su omisión real puesta aquí —no en
+     * el llamador— por el patrón de fallo de siempre: compuesto arriba, en un cierre que todos
+     * los tests simulan, el cableado quedaría escrito y sin probar. `xoneAgent.navegacion.test.ts`
+     * lo mira desde fuera.
+     *
+     * La raíz NO entra por parámetro de la tool: si el modelo pudiera decir sobre qué carpeta
+     * pregunta, esto sería una tool que lee cualquier sitio de la máquina.
+     */
+    const cargarIndice = opciones.navegacion ?? indiceEnDisco(opciones.raiz);
+    const comunes = {
         raiz: opciones.raiz,
         ficheros: opciones.ficheros,
         ...(opciones.artefactos === undefined ? {} : { artefactos: opciones.artefactos }),
         ...(opciones.adjuntos === undefined ? {} : { adjuntos: opciones.adjuntos }),
-    });
+    };
+    const backend = backendDeAgente(comunes);
+    /**
+     * El backend CON shell, y solo si alguien lo va a usar.
+     *
+     * Se construye aparte porque es otra cadena entera: la base ejecuta, y eso cambia lo que
+     * la librería registra (`execute`) y lo que se le puede pasar (`permissions` lanza junto a
+     * un backend ejecutable). Que sea `undefined` cuando nadie declara `ejecucion` no es una
+     * optimización: es lo que hace que el caso normal sea, byte a byte, el de antes.
+     */
+    const conShell = opciones.agentes.some((a) => puedeEjecutar(a))
+        ? backendDeAgente({
+            ...comunes,
+            ejecucion: {
+                entorno: entornoDeLaShellDelProyecto(opciones.raiz, opciones.artefactos?.carpeta),
+            },
+        })
+        : undefined;
     // Si no hay tracker, no se añade el middleware: es opcional a propósito arriba.
     const middlewareTracker = (origen) => opciones.tracker
         ? [
@@ -195,7 +260,7 @@ export async function construirAgente(opciones) {
                     /**
                      * Lo que diga su `.md`, y nada más. Es la PRIMERA de dos puertas: con esto en
                      * cierto, cada escritura pasa además por la política de la sesión y por las
-                     * guardas de ruta (`agent/escrituraExterna.ts`). Un agente de solo lectura no
+                     * guardas de ruta (`agent/subagentes/escrituraExterna.ts`). Un agente de solo lectura no
                      * llega a preguntar.
                      */
                     permitirEscritura: !agente.soloLectura,
@@ -211,53 +276,109 @@ export async function construirAgente(opciones) {
     }
     const subagentes = opciones.agentes
         .filter((a) => a.motor === "modelo")
-        .map((perfil) => ({
-        name: perfil.nombre,
-        description: perfil.descripcion,
-        systemPrompt: promptDeAgente(perfil, repartirSkills(perfil, catalogoDeSkills)),
-        // Los subagentes no heredan las skills del orquestador. Se entregan como fuentes
-        // directas para mantener cada perfil limitado a su catálogo declarado.
-        skills: rutasDeSkills(perfil, catalogoDeSkills),
-        // `tools` solo lleva tools PROPIAS. Pasarle los NOMBRES de las de fichero las sustituía
-        // por cadenas, dejando al especialista sin ninguna capacidad real. Las de fichero las
-        // monta el middleware; regex_search es una tool real y confinada al mismo backend.
-        tools: [crearBusquedaRegex(backend)],
-        //
-        // Las tools de fichero las monta el `FilesystemMiddleware` a partir del backend, y
-        // quien las acota por NOMBRE es su propia opción `tools` (con la restricción de que
-        // `read_file` tiene que estar siempre). Aquí el solo-lectura se impone con
-        // `permissions`, que la librería aplica sobre `ls`, `read_file`, `write_file`,
-        // `edit_file`, `glob` y `grep` — o sea, sobre todas las que importan.
-        permissions: permisosDe(perfil),
-        interruptOn: hitlDe(perfil),
-        // En CADA especialista, no solo en el orquestador: son ellos los que llaman a las
-        // tools de fichero, así que es su siguiente llamada al modelo la que reventaba.
-        // El nombre coincide con el middleware por defecto de DeepAgents y lo sustituye: así
-        // aplica tanto al especialista como al orquestador.
-        middleware: [
-            createFilesystemMiddleware({
-                backend,
-                permissions: permisosDe(perfil),
-                customToolDescriptions: DESCRIPCIONES_FICHEROS,
-                ...OPCIONES_BUSQUEDA_FICHEROS,
-            }),
-            resumenDeContexto(backend),
-            middlewareTextoDeTool(),
-            ...middlewareTracker(perfil.nombre),
-        ],
-        // El modelo que fije el agente en su fichero, y si no lo fija, el del papel que le
-        // toca por lo que hace: `rapido` para el que solo lee, `trabajo` para el que escribe.
-        // Fijarlo es la excepción y no la norma — un agente con modelo escrito se queda ahí
-        // aunque el usuario cambie el suyo con `/modelo`, que es justo lo que quiere quien
-        // escribe «este revisor corre con Claude» y no lo que quiere nadie más.
-        model: perfil.modelo === undefined
-            ? opciones.modelos.paraPapel(perfil.soloLectura ? "rapido" : "trabajo")
-            : opciones.modelos.paraModelo(perfil.modelo),
-    }));
+        .map((perfil) => {
+        // Una vez por perfil: con qué backend ve los ficheros, con qué permisos y con qué tools.
+        const ficheros = montajeDeFicheros(perfil, {
+            normal: backend,
+            ...(conShell === undefined ? {} : { conShell }),
+        });
+        return {
+            name: perfil.nombre,
+            description: perfil.descripcion,
+            systemPrompt: promptDeAgente(perfil, repartirSkills(perfil, catalogoDeSkills)),
+            // Los subagentes no heredan las skills del orquestador. Se entregan como fuentes
+            // directas para mantener cada perfil limitado a su catálogo declarado.
+            skills: rutasDeSkills(perfil, catalogoDeSkills),
+            // `tools` solo lleva tools PROPIAS. Pasarle los NOMBRES de las de fichero las sustituía
+            // por cadenas, dejando al especialista sin ninguna capacidad real. Las de fichero las
+            // monta el middleware; regex_search es una tool real y confinada al mismo backend.
+            /**
+             * Las dos tools propias, y contestan preguntas DISTINTAS: `regex_search` busca TEXTO y
+             * `xone_navegacion` contesta sobre el modelo ya resuelto. Un `mapcol` encuentra su
+             * colección aunque el nombre salga en otros veinte sitios, y el inventario cuesta 141
+             * tokens donde leer los `.xne` cuesta 18.000 (medido sobre un proyecto real).
+             *
+             * A los CINCO especialistas y no a unos pocos: los cinco trabajan sobre un proyecto XOne
+             * y la pregunta que esto abarata —«qué hay aquí»— se la hacen todos. El esquema es de una
+             * operación enumerada y un nombre, que es poco en cada llamada; el orquestador NO la
+             * recibe, porque no tiene tools propias y delega.
+             */
+            tools: [crearBusquedaRegex(ficheros.backend), crearNavegacionXone(cargarIndice, opciones.ficheros)],
+            //
+            // Las tools de fichero las monta el `FilesystemMiddleware` a partir del backend, y
+            // quien las acota por NOMBRE es su propia opción `tools` (con la restricción de que
+            // `read_file` tiene que estar siempre). Aquí el solo-lectura se impone con
+            // `permissions`, que la librería aplica sobre `ls`, `read_file`, `write_file`,
+            // `edit_file`, `glob` y `grep` — o sea, sobre todas las que importan.
+            /**
+             * **Ausente para quien EJECUTA**, y por la misma razón que en el middleware: deepagents
+             * lanza `ConfigurationError` al combinar `permissions` con un backend ejecutable. Dejarlo
+             * aquí «por si acaso» no añadiría una barrera, tumbaría la construcción del agente.
+             */
+            ...(ficheros.permissions === undefined ? {} : { permissions: ficheros.permissions }),
+            interruptOn: hitlDe(perfil),
+            // En CADA especialista, no solo en el orquestador: son ellos los que llaman a las
+            // tools de fichero, así que es su siguiente llamada al modelo la que reventaba.
+            // El nombre coincide con el middleware por defecto de DeepAgents y lo sustituye: así
+            // aplica tanto al especialista como al orquestador.
+            middleware: [
+                createFilesystemMiddleware({
+                    // Quién se lleva la shell, con qué permisos y con qué tools lo decide una función
+                    // pura y probada (`perfiles.ts#montajeDeFicheros`), no un `if` aquí dentro.
+                    ...ficheros,
+                    customToolDescriptions: DESCRIPCIONES_FICHEROS,
+                    ...OPCIONES_BUSQUEDA_FICHEROS,
+                }),
+                // El tope es del ESPECIALISTA y no del orquestador: el que contesta al usuario no
+                // puede quedarse a medias, y el que hace un encargo acotado sí debe. Ver
+                // `resumenDeContexto.ts#topeDeLlamadas`.
+                topeDeLlamadas(),
+                // Y el de TOOLS, que es el que acota lo que se ACUMULA: 43 resultados en el contexto
+                // hicieron que la última llamada costara ocho veces la primera.
+                topeDeTools(),
+                // Los DOS, y en su orden, que es lo que `resumenConEncargo` garantiza: el resumen
+                // se lleva el encargo por delante al cruzar el umbral, y el segundo lo devuelve.
+                // Sobre el backend del PERFIL: quien tiene shell descarga en SU cadena, que es la que
+                // tiene montadas `/large_tool_results/` y `/conversation_history/` con su misma raíz.
+                ...resumenConEncargo(ficheros.backend),
+                middlewareTextoDeTool(),
+                ...middlewareTracker(perfil.nombre),
+                // El ÚLTIMO, y por eso ve la petición ya pasada por todos los de arriba: el resumen, la
+                // devolución del encargo y la conversión de los `ToolMessage`. Puesto delante enseñaría
+                // lo que otros van a cambiar después, que es la mentira de un inspector.
+                ...inspector(opciones.raiz, perfil.nombre),
+            ],
+            // El modelo que fije el agente en su fichero, y si no lo fija, el del papel que le
+            // toca por lo que hace: `rapido` para el que solo lee, `trabajo` para el que escribe.
+            // Fijarlo es la excepción y no la norma — un agente con modelo escrito se queda ahí
+            // aunque el usuario cambie el suyo con `/modelo`, que es justo lo que quiere quien
+            // escribe «este revisor corre con Claude» y no lo que quiere nadie más.
+            model: perfil.modelo === undefined
+                ? opciones.modelos.paraPapel(perfil.soloLectura ? "rapido" : "trabajo")
+                : opciones.modelos.paraModelo(perfil.modelo),
+        };
+    });
     return createDeepAgent({
         model: opciones.modelos.paraPapel("rapido"),
         systemPrompt: promptOrquestador(opciones.agentes),
         backend,
+        /**
+         * **El orquestador SÍ la lleva, y eso lo decidió una medida que tumbó lo contrario.**
+         *
+         * La primera versión se la dio solo a los especialistas con el argumento de que el
+         * orquestador delega. Medido sobre un proyecto real con la pregunta que motivó la tool
+         * —«¿cuántas colecciones tiene mi proyecto?»—: **no delegó**. La contestó él, con `ls`,
+         * `glob`, `grep` y `read_file`, en once llamadas y ~88k tokens, y la tool no llegó a
+         * estar disponible porque vivía en los subagentes. O sea que el razonamiento era bueno y
+         * el comportamiento otro, que es justo lo que este repo prefiere medir antes que suponer.
+         *
+         * No le abre nada: es de LECTURA y el orquestador ya lee (`permisosDe` le deja
+         * `read`/`ls`/`glob`/`grep` y le deniega el disco entero para escribir). Lo que cambia es
+         * el precio de orientarse. Su esquema viaja en cada llamada suya —y eso no es gratis,
+         * `excluirTools` existe por eso—, pero es una operación enumerada y un nombre frente a
+         * las once llamadas que sustituye.
+         */
+        tools: [crearNavegacionXone(cargarIndice, opciones.ficheros)],
         interruptOn: hitlDe(PERFIL_DEL_ORQUESTADOR),
         checkpointer: opciones.checkpointer ?? new MemorySaver(),
         // El contenido de los `ToolMessage` va como TEXTO al modelo. Sin esto, un turno real
@@ -296,9 +417,17 @@ export async function construirAgente(opciones) {
                 customToolDescriptions: DESCRIPCIONES_FICHEROS,
                 ...OPCIONES_BUSQUEDA_FICHEROS,
             }),
-            resumenDeContexto(backend),
+            // Los DOS, y en su orden, que es lo que `resumenConEncargo` garantiza: el resumen
+            // se lleva el encargo por delante al cruzar el umbral, y el segundo lo devuelve.
+            ...resumenConEncargo(backend),
+            // Los esquemas de las tools que NO puede usar son el 25 % de su cabecera, y la cabecera
+            // es el 87 % de cada llamada (`inspectorDePrompt`). `permissions` acota el permiso; el
+            // esquema viaja igual, así que esto lo quita del prompt Y sigue rechazando la llamada.
+            // La frontera sigue siendo `permisosDe`: ver `excluirTools.ts`.
+            excluirTools(toolsQueNoUsa(PERFIL_DEL_ORQUESTADOR)),
             middlewareTextoDeTool(),
             ...middlewareTracker("orquestador"),
+            ...inspector(opciones.raiz, "orquestador"),
         ],
         subagents: [
             ...subagentes,

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

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

package/dist/agent/navegacion/indiceEnDisco.js

@@ -0,0 +1,21 @@
+// **Import PROFUNDO, y no es una optimización: es un requisito medido.** El barril
+// (`xone-linter`) reexporta también su RUNTIME —VM, HTTP, dispositivo y una conexión SQLite
+// con *top-level await*—, y eso revienta bajo `tsx`, que es el lanzador de desarrollo
+// (`./bin/xonecode`): «Top-level await is currently not supported with the cjs output
+// format». Por la ruta del modelo no hay ningún `await` de módulo, así que entra limpio — y
+// de paso no se arrastra medio runtime para leer un XML.
+import { XoneProject } from "xone-linter/dist/project/XoneProject.js";
+import { construirIndice } from "../../core/navegacion.js";
+import { modeloDeNavegacion } from "./modeloDeProyecto.js";
+/**
+ * Devuelve el cargador del índice de una raíz. La raíz se fija al crearlo y NO entra por
+ * parámetro en cada consulta: si el modelo pudiera decir sobre qué proyecto preguntar,
+ * tendríamos una tool que lee cualquier carpeta de la máquina.
+ */
+export function indiceEnDisco(raiz) {
+    return async (ficheros) => {
+        const proyecto = await XoneProject.load(raiz);
+        return construirIndice(modeloDeNavegacion(proyecto.model, raiz, ficheros));
+    };
+}
+//# sourceMappingURL=indiceEnDisco.js.map

package/dist/agent/navegacion/indiceEnDisco.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indiceEnDisco.js","sourceRoot":"","sources":["../../../src/agent/navegacion/indiceEnDisco.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,4FAA4F;AAC5F,sFAAsF;AACtF,sFAAsF;AACtF,4FAA4F;AAC5F,yDAAyD;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,eAAe,EAA2B,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAwB,MAAM,uBAAuB,CAAC;AA2BjF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,eAAe,CAAC,kBAAkB,CAAC,QAAQ,CAAC,KAAwB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC;AACJ,CAAC"}

package/dist/agent/navegacion/modeloDeProyecto.js

@@ -0,0 +1,228 @@
+import { relative, sep } from "node:path";
+import { puedeLeerRuta } from "../grafo/perfiles.js";
+import { esVistaAplanada } from "../grafo/proyecto.js";
+/**
+ * La ruta VIRTUAL de una absoluta del proyecto, o `undefined` si se sale de él.
+ *
+ * Lexical y no `realpath`: este módulo es la traducción, no la barrera del disco — quien
+ * necesite cerrar los enlaces simbólicos lo hace donde se abre el fichero. Aquí lo que se
+ * impide es que una ruta de FUERA se presente como si fuera del proyecto.
+ */
+export function rutaVirtualDelProyecto(raiz, absoluta) {
+    const rel = relative(raiz, absoluta);
+    if (rel === "" || rel.startsWith("..") || rel.startsWith(sep + ".."))
+        return undefined;
+    // Absoluta de otra unidad: `relative` la devuelve absoluta y no empieza por `..`.
+    if (rel.startsWith(sep) || /^[A-Za-z]:/.test(rel))
+        return undefined;
+    return "/" + rel.split(sep).join("/");
+}
+/**
+ * Traduce el modelo del linter al nuestro, filtrando lo que no se puede enseñar.
+ *
+ * `ficheros` son las rutas virtuales del proyecto, las mismas que ve el agente: hacen falta
+ * para reconocer una vista aplanada (`X.xml` con un `X.xne` al lado), que es una regla que
+ * depende del conjunto y no de la ruta sola.
+ */
+export function modeloDeNavegacion(delLinter, raiz, ficheros) {
+    const colecciones = [];
+    for (const coll of delLinter.colls ?? []) {
+        const nombre = coll.name;
+        const absoluta = coll.location?.file;
+        if (nombre === undefined || nombre === "" || absoluta === undefined)
+            continue;
+        const fichero = rutaVirtualDelProyecto(raiz, absoluta);
+        // Fuera del proyecto, denegada o vista aplanada: no entra en el índice. Un símbolo que
+        // el agente no puede abrir es peor que uno que falta — le manda a leer donde no debe.
+        if (fichero === undefined || !puedeLeerRuta(fichero) || esVistaAplanada(fichero, ficheros))
+            continue;
+        const campos = (coll.props ?? [])
+            .filter((p) => typeof p.name === "string" && p.name !== "")
+            .map((p) => ({ nombre: p.name, ...(p.type === undefined ? {} : { tipo: p.type }) }));
+        colecciones.push({
+            nombre,
+            fichero,
+            campos,
+            referencias: referenciasDe(coll, nombre),
+            // Un `onchange` lleva el campo que lo dispara: sin él no se sabe a qué reacciona, y eso
+            // es justo lo que hace falta antes de tocarlo.
+            eventos: (coll.events ?? [])
+                .filter((e) => typeof e.name === "string" && e.name !== "")
+                .map((e) => (e.triggerProp === undefined || e.triggerProp === "" ? e.name : `${e.name}(${e.triggerProp})`)),
+            nodos: nombresDe(coll.nodes),
+            conexiones: nombresDe(coll.connections),
+        });
+    }
+    return {
+        colecciones,
+        // El inventario entra como criba de la señal débil: sin él, «un literal que coincide con
+        // una colección» sería «cualquier literal». Por eso va DESPUÉS de componer las colecciones.
+        referenciasDeScript: referenciasDeScript(delLinter, raiz, ficheros, new Set(colecciones.map((c) => c.nombre.toLowerCase()))),
+        app: {
+            entrada: [...(delLinter.app?.entryPoints ?? [])],
+            login: [...(delLinter.app?.loginColls ?? [])],
+            // La URL de un estilo es del PROYECTO (`default.css`), no una ruta de la máquina: la
+            // declara el propio `app.xml` y por eso viaja tal cual.
+            estilos: (delLinter.app?.styles ?? [])
+                .map((e) => e.url)
+                .filter((u) => typeof u === "string" && u !== ""),
+            conexiones: nombresDe(delLinter.app?.connections),
+        },
+    };
+}
+/** Los `name` que existen de verdad, de una lista que puede traerlos a medias. */
+function nombresDe(lista) {
+    return (lista ?? []).map((x) => x.name).filter((n) => typeof n === "string" && n !== "");
+}
+/**
+ * Lo que una colección apunta hacia fuera.
+ *
+ * Los cuatro atributos son los que `xone-linter` ya valida en su `CrossReferenceRule`, y esa
+ * coincidencia es deliberada: **la semántica de qué significa `mapcol` vive en UN sitio**.
+ * Reescribirla aquí crearía un segundo sitio donde decidirlo, y el día que divergieran el
+ * linter diría una cosa y el agente otra sobre el mismo proyecto.
+ *
+ * `mapfld` y `linkedfield` se cuelgan del `mapcol` de su propio prop, que es lo que les da
+ * sentido: un `mapfld` sin `mapcol` no apunta a nada que se pueda nombrar.
+ */
+function referenciasDe(coll, nombre) {
+    const salida = [];
+    const hereda = coll.attributes?.["inherits"];
+    if (hereda !== undefined && hereda !== "") {
+        salida.push({ desde: nombre, por: "inherits", hacia: hereda });
+    }
+    for (const contenido of coll.contents ?? []) {
+        if (contenido.src !== undefined && contenido.src !== "") {
+            salida.push({ desde: nombre, por: "contents", hacia: contenido.src });
+        }
+    }
+    for (const prop of coll.props ?? []) {
+        if (typeof prop.name !== "string" || prop.name === "")
+            continue;
+        const desde = `${nombre}.${prop.name}`;
+        const mapcol = prop.attributes?.["mapcol"];
+        if (mapcol === undefined || mapcol === "")
+            continue;
+        salida.push({ desde, por: "mapcol", hacia: mapcol });
+        for (const clave of ["mapfld", "linkedfield"]) {
+            const campo = prop.attributes?.[clave];
+            if (campo !== undefined && campo !== "") {
+                salida.push({ desde, por: clave, hacia: `${mapcol}.${campo}` });
+            }
+        }
+    }
+    return salida;
+}
+/**
+ * Cómo una app XOne llega de verdad a una colección, que no es con `mapcol`.
+ *
+ * **Medido sobre un proyecto real**, y fue lo que cambió el alcance de la tool. Hay DOS
+ * señales, y van separadas a propósito porque no valen lo mismo:
+ *
+ * 1. **`appData.getCollection("X")` — señal FUERTE** (`por: "script"`). Es una llamada con su
+ *    literal: la forma en que se nombra una colección desde ES5. Los botones del menú abren
+ *    así (`onclick="javascript:var o=appData.getCollection('Deportes')…"`), y sin esto «¿quién
+ *    usa Deportes?» contestaba «nadie» con dos botones apuntándole.
+ * 2. **Un literal que COINCIDE con el nombre de una colección — señal DÉBIL**
+ *    (`por: "mencion"`). Existe porque la cadena real puede tener tres saltos:
+ *    `method="ExecuteNode(abrirColl('ConsolaReplica'))"` → un nodo con `<param name="coll">` →
+ *    `irColl(coll)` → `getCollection(collname)` + `pushValue(obj)`. El nombre solo aparece
+ *    como literal en el PRIMER salto, y perseguir la cadena sería atarse a cómo se llaman los
+ *    ayudantes de UN proyecto (`irColl`, `abrirColl`, `openMenu`), que no son de XOne.
+ *
+ * **Y se marcan distinto porque la confianza es distinta.** Una llamada resuelta y una cadena
+ * que coincide con un nombre no son lo mismo, y fundirlas haría que la segunda se leyera con
+ * la autoridad de la primera. Medido sobre el proyecto real: la débil añade cinco referencias
+ * y todas resultaron ciertas, pero eso no la convierte en la fuerte.
+ *
+ * **Límites declarados**: ninguna de las dos ve un nombre compuesto en ejecución ni dice en qué
+ * LÍNEA está —para eso harían falta rangos—, y la débil no puede distinguir un nombre de
+ * colección de una cadena que se le parece.
+ */
+const LLAMADA_A_COLECCION = /getCollection\s*\(\s*['"]([^'"]+)['"]\s*\)/gi;
+/** Cualquier literal de cadena con forma de identificador. La criba es el inventario. */
+const LITERAL_DE_CADENA = /['"]([A-Za-z_][A-Za-z0-9_]{2,40})['"]/g;
+/** Todos los sitios del proyecto donde hay script, con su origen ya traducido. */
+function trozosDeScript(delLinter, raiz) {
+    const trozos = [];
+    for (const coll of delLinter.colls ?? []) {
+        const nombre = coll.name;
+        const absoluta = coll.location?.file;
+        if (nombre === undefined || absoluta === undefined)
+            continue;
+        const fichero = rutaVirtualDelProyecto(raiz, absoluta);
+        if (fichero === undefined)
+            continue;
+        for (const prop of coll.props ?? []) {
+            if (typeof prop.name !== "string" || prop.name === "")
+                continue;
+            const desde = `${nombre}.${prop.name}`;
+            for (const evento of prop.inlineEvents ?? []) {
+                trozos.push({ desde, fichero, duena: nombre, texto: String(evento.script ?? "") });
+            }
+            // **El atributo `method` cuenta**, y no es un detalle: es donde vive
+            // `ExecuteNode(abrirColl('ConsolaReplica'))`, o sea la única aparición literal de esa
+            // colección en todo el proyecto. Sin mirarlo, el botón de información no referencia nada.
+            const metodo = prop.attributes?.["method"];
+            if (metodo !== undefined && metodo !== "") {
+                trozos.push({ desde, fichero, duena: nombre, texto: metodo });
+            }
+        }
+        for (const evento of [...(coll.events ?? []), ...(coll.nodes ?? [])]) {
+            const desde = `${nombre}:${evento.name ?? "(evento)"}`;
+            for (const accion of evento.actions ?? []) {
+                for (const texto of [accion.script, accion.value]) {
+                    if (texto !== undefined && texto !== "")
+                        trozos.push({ desde, fichero, duena: nombre, texto });
+                }
+            }
+        }
+    }
+    // Los `.js` sueltos. Sus claves son rutas RELATIVAS al proyecto, así que la virtual es
+    // directa. No tienen colección dueña: un `.js` puede nombrar a cualquiera.
+    for (const [ruta, texto] of delLinter.jsFiles ?? new Map()) {
+        const virtual = "/" + String(ruta).split(/[\\/]/).filter(Boolean).join("/");
+        trozos.push({ desde: virtual, fichero: virtual, texto: String(texto) });
+    }
+    return trozos;
+}
+function referenciasDeScript(delLinter, raiz, ficheros, conocidas) {
+    const salida = [];
+    const anotar = (desde, por, hacia, fichero) => {
+        if (!puedeLeerRuta(fichero) || esVistaAplanada(fichero, ficheros))
+            return;
+        // Sin repetir: un mismo botón puede nombrar la colección dos veces en la misma línea.
+        if (salida.some((r) => r.desde === desde && r.hacia === hacia && r.fichero === fichero))
+            return;
+        salida.push({ desde, por, hacia, fichero });
+    };
+    for (const trozo of trozosDeScript(delLinter, raiz)) {
+        const fuertes = new Set();
+        for (const x of trozo.texto.matchAll(LLAMADA_A_COLECCION)) {
+            fuertes.add(x[1].toLowerCase());
+            anotar(trozo.desde, "script", x[1], trozo.fichero);
+        }
+        for (const x of trozo.texto.matchAll(LITERAL_DE_CADENA)) {
+            const literal = x[1];
+            const clave = literal.toLowerCase();
+            // Solo si es el nombre de una colección que EXISTE: el inventario es la criba, y sin
+            // ella esto sería «cualquier cadena del proyecto».
+            if (!conocidas.has(clave))
+                continue;
+            // Ya la cogió la señal fuerte en este mismo trozo: no se degrada a mención.
+            if (fuertes.has(clave))
+                continue;
+            /**
+             * **Una colección que se nombra a sí misma no cuenta.** Medido: de las menciones que
+             * aparecían en el proyecto real, la mayoría eran los scripts de `ConsolaReplica`
+             * diciendo «ConsolaReplica» — en un SQL, en un mensaje, en un refresco. Como respuesta a
+             * «¿quién usa X?» eso es ruido, y ruido que sale en TODAS las colecciones con scripts.
+             */
+            if (trozo.duena !== undefined && trozo.duena.toLowerCase() === clave)
+                continue;
+            anotar(trozo.desde, "mencion", literal, trozo.fichero);
+        }
+    }
+    return salida;
+}
+//# sourceMappingURL=modeloDeProyecto.js.map