xonecode 0.3.0 → 0.5.1

package/dist/core/agentes.js

@@ -0,0 +1,227 @@
+/**
+ * Los subagentes como DATOS: qué es uno, cómo se lee de un fichero y cómo se compone su
+ * prompt. TypeScript puro — leer el disco es cosa de `agent/agentesEnDisco.ts`.
+ *
+ * Hasta ahora los cuatro especialistas (`agent/perfiles.ts`) vivían a fuego en un
+ * `Record`, y su prompt lo componía `xoneAgent.ts#promptDe` con un `nombre === "planner"`
+ * dentro. Eso ya estaba señalado como provisional ahí mismo («los prompts pasan a ficheros
+ * `.md` en la fase 9»); esto es esa fase, y con ella los cuatro dejan de ser un caso
+ * especial: son los mismos ficheros que puede escribir el usuario, sembrados la primera vez.
+ *
+ * **Lo que NO sale del fichero, y es deliberado.** Las reglas de XOne se anteponen SIEMPRE,
+ * desde código, a todo subagente venga de donde venga (`REGLAS_XONE`). Un subagente que no
+ * sepa que XOne ignora en silencio lo desconocido escribirá un atributo inventado y no dará
+ * error — dará un bug mudo, que es la razón de ser de este producto. Poder borrarlas
+ * editando un `.md` convertiría el invariante en una preferencia; es el mismo principio por
+ * el que los avisos de honestidad son código y no prompt (`core/bitacora.ts`).
+ */
+export const MOTORES = ["modelo", "claude-code", "codex", "opencode"];
+/**
+ * Las reglas del dominio, iguales para todos y NO editables desde el fichero.
+ *
+ * Están aquí y no repetidas en cada `.md` sembrado por lo mismo que `marca.css` tiene los
+ * colores en un solo sitio: cuatro copias de esto es como se acaba con una que se queda
+ * vieja. Y un agente que el usuario escriba mañana las hereda sin tener que copiarlas.
+ */
+export const REGLAS_XONE = [
+    "REGLAS DE XONE, no negociables:",
+    "- No es desarrollo web: no existen DOM, React, Vue, ni `async/await` en el runtime.",
+    "- La fuente de una colección es su `.xne`. Los `.xml` los genera Studio y no se tocan.",
+    "- No inventes atributos XML, funciones ni propiedades CSS: XOne ignora lo desconocido",
+    "  en silencio, así que un invento no da error — da un bug mudo.",
+].join("\n");
+/**
+ * El prompt completo de un subagente: sus reglas, su descripción y sus instrucciones.
+ *
+ * Las reglas van PRIMERO y las instrucciones al final, en ese orden a propósito: lo último
+ * que lee el modelo es lo que más pesa, y lo que el usuario escribió es lo específico de la
+ * tarea. Las reglas no se pueden perder por ir arriba — son cinco líneas, no un preámbulo
+ * largo del que el modelo se despiste.
+ */
+export function promptDeAgente(agente, skills) {
+    return [
+        REGLAS_XONE,
+        "",
+        agente.descripcion,
+        ...(agente.instrucciones.trim() === "" ? [] : ["", agente.instrucciones.trim()]),
+        "",
+        // Las skills que tiene, y las que NO. El aviso es la misma disciplina de siempre: un
+        // doble nunca se disfraza, y una skill declarada en el `.md` que no está en el catálogo
+        // haría que el modelo intentara cargarla y fallara sin saber por qué. Se dice.
+        ...(skills === undefined || skills.suyas.length === 0
+            ? []
+            : [`Tus skills: ${skills.suyas.join(", ")}. Cárgalas antes de responder.`]),
+        ...(skills === undefined || skills.faltan.length === 0
+            ? []
+            : [`AVISO: te faltan estas skills y no las tienes: ${skills.faltan.join(", ")}.`]),
+        // La línea de escritura es ESTRUCTURAL y va aquí, no en el cuerpo del fichero: no
+        // depende de lo que el usuario escriba, sino de `soloLectura`, y un agente que escribe
+        // sin saber que sus escrituras se aprueban insistiría al ver un rechazo.
+        agente.soloLectura
+            ? "No modificas nada."
+            : "Tus escrituras requieren aprobación humana. Si te la rechazan, no insistas: explica qué pretendías y por qué.",
+        /**
+         * **Un agente EXTERNO no ve el backend virtual: ve el disco.** Y eso cambia lo que
+         * significa una ruta, que es el detalle que más fácil se cuela — un `.md` que diga
+         * «guarda en /doc» describe la carpeta `doc` del PROYECTO si el motor es `modelo` (ahí
+         * `/` es la raíz montada) y la carpeta `/doc` del SISTEMA si es Claude Code, que es
+         * fuera del proyecto y se deniega. El usuario que lo escribe no tiene por qué saber de
+         * qué lado cae, así que se dice desde código en vez de esperar a que lo aprenda por un
+         * rechazo: es la misma disciplina que la línea de las escrituras y la de las skills.
+         *
+         * Va con `relativas` y no reescribiendo la ruta: adivinar que un `/doc` «quería decir»
+         * `doc/` sería inventar la intención de una escritura, que es justo lo que ninguna
+         * guarda de este repo hace.
+         */
+        ...(agente.motor === "modelo"
+            ? []
+            : [
+                "RUTAS: trabajas sobre la carpeta del proyecto directamente, así que una ruta que " +
+                    "empiece por «/» es la raíz del SISTEMA y está fuera del proyecto. Escribe las rutas " +
+                    "relativas a la carpeta del proyecto («doc/GUIA.md»), nunca «/doc/GUIA.md».",
+            ]),
+    ]
+        .join("\n")
+        // Los huecos que dejan las partes ausentes (sin instrucciones, sin skills) se colapsan
+        // a una línea en blanco: tres saltos seguidos en un prompt no separan nada, solo gastan
+        // tokens y hacen que el texto se lea como si faltara algo.
+        .replace(/\n{3,}/g, "\n\n");
+}
+/** Reparte las skills declaradas entre las que hay y las que no. Puro: el catálogo entra. */
+export function repartirSkills(agente, disponibles) {
+    return {
+        suyas: agente.skills.filter((s) => disponibles.has(s)),
+        faltan: agente.skills.filter((s) => !disponibles.has(s)),
+    };
+}
+function esMotor(v) {
+    return MOTORES.includes(v);
+}
+/**
+ * El frontmatter, en el subconjunto que hace falta: `clave: valor` y listas en línea
+ * (`skills: [a, b]`). No se trae un parser de YAML entero por dos motivos: la superficie
+ * que aceptamos es la de arriba y nada más —cuanto menos acepte, menos formas hay de
+ * escribir algo que parezca válido y no lo sea—, y una dependencia nueva en `core/` hay
+ * que justificarla contra la frontera que `imports.test.ts` vigila.
+ *
+ * Comillas fuera si las hay: `descripcion: "algo"` y `descripcion: algo` son lo mismo, que
+ * es lo que espera quien escribe el fichero a mano.
+ */
+function leerFrontmatter(texto) {
+    const campos = {};
+    for (const linea of texto.split("\n")) {
+        const corte = linea.indexOf(":");
+        if (corte <= 0)
+            continue;
+        const clave = linea.slice(0, corte).trim();
+        let valor = linea.slice(corte + 1).trim();
+        if ((valor.startsWith('"') && valor.endsWith('"') && valor.length >= 2) ||
+            (valor.startsWith("'") && valor.endsWith("'") && valor.length >= 2)) {
+            valor = valor.slice(1, -1);
+        }
+        campos[clave] = valor;
+    }
+    return campos;
+}
+/** `[a, b]` o `a, b` — las dos formas, porque las dos se escriben. Vacío da lista vacía. */
+function leerLista(valor) {
+    if (valor === undefined)
+        return [];
+    const dentro = valor.trim().replace(/^\[/, "").replace(/\]$/, "");
+    return dentro
+        .split(",")
+        .map((s) => s.trim().replace(/^["']|["']$/g, ""))
+        .filter((s) => s !== "");
+}
+/**
+ * Un `.md` con frontmatter, a `Agente`. Devuelve el motivo en vez de lanzar: un fichero
+ * roto no puede tumbar el arranque de la consola — se salta, se dice cuál y por qué, y los
+ * demás siguen. Es la misma postura que `sesiones.ts` con una línea corrupta del `.jsonl`.
+ */
+export function leerAgente(nombre, contenido, origen) {
+    const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(contenido);
+    if (m === null)
+        return { error: "no tiene frontmatter: hace falta un bloque «---» al principio" };
+    const campos = leerFrontmatter(m[1]);
+    const instrucciones = m[2] ?? "";
+    const descripcion = (campos["descripcion"] ?? "").trim();
+    // Sin descripción NO se carga, y no se le inventa una por el nombre: es lo que el
+    // orquestador lee para decidir cuándo delegar, así que un agente sin ella o no se usaría
+    // nunca o se usaría para todo. Las dos cosas son peores que no tenerlo.
+    if (descripcion === "")
+        return { error: "le falta «descripcion», que es lo que el orquestador lee para elegirlo" };
+    const motorCrudo = (campos["motor"] ?? "modelo").trim();
+    if (!esMotor(motorCrudo)) {
+        return { error: `«motor: ${motorCrudo}» no existe. Los que hay: ${MOTORES.join(", ")}` };
+    }
+    const modelo = (campos["modelo"] ?? "").trim();
+    // Cualquier cosa que no sea exactamente «true» es false — ver abajo.
+    const soloLectura = (campos["soloLectura"] ?? "").trim() === "true";
+    /**
+     * **Un agente EXTERNO ya puede pedir escribir, y esta guarda se levantó CON el cableado y
+     * no antes.** Existía porque sus escrituras se denegaban siempre, así que dejar pasar un
+     * `soloLectura: false` le prometía a quien escribió el `.md` una capacidad que no iba a
+     * tener — y lo habría descubierto cuando el agente le contestara que no pudo tocar nada.
+     *
+     * El orden importaba en la otra dirección también: levantarla antes de que
+     * `PoliticaDeEscrituraExterna` estuviera montada de punta a punta habría creado justo el
+     * caso que la guarda existía para evitar. Hoy las dos puertas están puestas —el papel del
+     * `.md` y la autorización por escritura, con las guardas de ruta delante— así que la
+     * promesa se cumple.
+     *
+     * Lo que NO cambia: `soloLectura` sigue siendo cierto solo con exactamente «true» (la
+     * trampa del `"false"` de CloudStudio).
+     *
+     * **Codex también escribe ya, y su guarda se levantó igual: CON el cableado, no antes.**
+     * Estuvo cerrada mientras el argumento fue cierto —que su escritura la bloqueaba el
+     * sandbox del sistema operativo, y que abrirla exigía `sandbox: "workspace-write"`, con lo
+     * que las guardas de ruta de xonecode no verían ni una—. Lo que la medida contra el
+     * binario real (0.152.1, 11-09-2026) enseñó es que esa disyuntiva era falsa: la palanca no
+     * es el sandbox, es el `approvalPolicy`. Con `read-only` + `on-request` el sandbox sigue
+     * siendo la denegación del sistema operativo y cada escritura llega como una petición que
+     * xonecode contesta, con las mismas guardas de ruta y la misma
+     * `PoliticaDeEscrituraExterna` que el otro motor (`agent/escrituraDeCodex.ts`).
+     */
+    return {
+        agente: {
+            nombre,
+            descripcion,
+            motor: motorCrudo,
+            ...(modelo === "" ? {} : { modelo }),
+            // Cualquier cosa que no sea exactamente «true» es false: un `soloLectura: quizá` no
+            // puede acabar concediendo escritura por ser una cadena verdadera en JavaScript —
+            // es la misma trampa que `compartido` con el `"false"` de CloudStudio.
+            soloLectura,
+            skills: leerLista(campos["skills"]),
+            instrucciones,
+            origen,
+        },
+    };
+}
+/**
+ * Junta las dos carpetas: el de PROYECTO gana sobre el global con el mismo nombre.
+ *
+ * Misma precedencia que los modelos (`core/modelos.ts`), y por lo mismo: un «revisor de
+ * XOne» se quiere en todos los proyectos, y un «experto en esta app» solo en uno — y el
+ * segundo tiene que poder pisar al primero sin borrarlo.
+ */
+export function fusionarAgentes(global, proyecto) {
+    const porNombre = new Map();
+    for (const a of global)
+        porNombre.set(a.nombre, a);
+    for (const a of proyecto)
+        porNombre.set(a.nombre, a);
+    return [...porNombre.values()].sort((a, b) => a.nombre.localeCompare(b.nombre));
+}
+/** El `.md` de un agente, para escribirlo. Lo inverso de `leerAgente`. */
+export function escribirAgente(agente) {
+    const campos = [
+        `descripcion: ${agente.descripcion}`,
+        `motor: ${agente.motor}`,
+        ...(agente.modelo === undefined ? [] : [`modelo: ${agente.modelo}`]),
+        `soloLectura: ${agente.soloLectura}`,
+        `skills: [${agente.skills.join(", ")}]`,
+    ];
+    return `---\n${campos.join("\n")}\n---\n${agente.instrucciones}`;
+}
+//# sourceMappingURL=agentes.js.map

package/dist/core/agentes.js.map

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

package/dist/core/artefactos.js

@@ -0,0 +1,149 @@
+/**
+ * Los ARTEFACTOS de una sesión: lo que el agente produce y **no es del proyecto**.
+ *
+ * Un diagrama de `archify`, un panel de `artifacts-builder`, la captura que el
+ * `xone-device-tester`
+ * traerá del móvil el día que hable con él. Son salidas de la conversación, no código de la
+ * app: nacen de una pregunta, se miran una vez y no tienen por qué sobrevivir al proyecto.
+ *
+ * **Hasta ahora acababan DENTRO de la app XOne, y eso era un fallo de verdad.** Las dos
+ * skills visuales reparten su entrega entre dos tools —`renderizar_diagrama` y
+ * `publish_artifact`— y en xonecode no existe ninguna de las dos (cero apariciones en
+ * `src/`), así que el `mockup` caía siempre en el camino de reserva, que dice literalmente
+ * «con `write_file`, entrega el HTML autocontenido» en `/artifacts/<nombre>.html`. O sea: la
+ * raíz del proyecto. Pasaba por la aprobación humana, entraba en git y, en un proyecto
+ * cloud, **subía a CloudStudio**. Un diagrama dentro de la app del cliente.
+ *
+ * La carpeta virtual `/artefactos/` lo corta de raíz, y es la misma pieza que ya monta
+ * `/skills/`: otra raíz colgada del `CompositeBackend` (`agent/proyecto.ts`). Cuatro cosas
+ * salen de ahí sin escribir una línea de más, porque cuelga de `.xonecode/`: no entra en el
+ * árbol del proyecto, no sube a CloudStudio, no aparece en Revisión y no engorda
+ * `.git/objects` (`sacarXonecodeDelIndice`).
+ *
+ * Este módulo es `core/`: datos puros, una barrera y la regla de dónde va la carpeta. Quién
+ * la monta en el backend es de `agent/`.
+ */
+import { join } from "node:path";
+import { segmentoSeguro } from "./settings.js";
+/**
+ * Dónde caen en DISCO los artefactos de una sesión: `.xonecode/sesiones/<id>/artefactos/`.
+ *
+ * Vive en `core/` y no en `web/servidor/sesiones.ts` porque lo necesitan los dos lados —el
+ * que borra la sesión y el que monta el backend—, y `cli/` no puede importar de `web/`. Es
+ * lo que ya son las rutas de `core/settings.ts`: una regla de dónde va cada cosa.
+ *
+ * Pasa por `segmentoSeguro` por lo mismo que el `.jsonl`: el id llega del cliente por HTTP,
+ * y sin esa guarda un `"../../.env"` compondría una ruta fuera de `sesiones/`.
+ *
+ * Convive con `<id>.jsonl` sin chocar —uno es fichero con extensión, otra es carpeta—, así
+ * que no hay nada que mover. Meter el transcript dentro (`<id>/sesion.jsonl`) es una mudanza
+ * aparte, con su respaldo de lectura para las sesiones que ya existen.
+ */
+export function carpetaDeArtefactosDeSesion(raiz, id) {
+    return join(raiz, ".xonecode", "sesiones", segmentoSeguro(id, "id de sesión"), "artefactos");
+}
+/** El prefijo virtual. Con barra final: `CompositeBackend` la exige para no reconstruir
+ *  `//nombre` fuera de la raíz montada — la misma trampa medida con `/skills/`. */
+export const RUTA_ARTEFACTOS = "/artefactos/";
+/**
+ * ¿Es esta ruta la de un artefacto, sin lugar a dudas?
+ *
+ * Se usa para DOS cosas y una de ellas es una decisión de seguridad: una escritura aquí no
+ * pide aprobación humana (ver `agent/turnoReal.ts`), así que esto no puede ser un
+ * `startsWith` a secas. Un `/artefactos/../app.xml` que colara por aquí sería una escritura
+ * al proyecto aprobada sola.
+ *
+ * Por eso es una lista blanca de forma y no una lista negra de trampas: cada segmento tiene
+ * que ser texto llano (letras, cifras, punto, guion y guion bajo), lo que deja fuera `..`,
+ * `.`, los segmentos vacíos de un `//`, la barra invertida de Windows, el NUL y cualquier
+ * `%2e%2e` sin decodificar. Lo que no case se trata como una ruta normal, o sea que pasa por
+ * la aprobación de siempre — el lado conservador.
+ *
+ * Medido contra deepagents: un `write` de `/artefactos/../pwn.html` NO llega al proyecto (el
+ * `virtualMode` de la raíz montada lo sujeta), pero devuelve OK sin escribir en ninguna
+ * parte. Que la barrera esté aquí no depende de eso: depende de que el día que alguien
+ * cambie el montaje, el permiso siga siendo del segmento y no del prefijo.
+ */
+const SEGMENTO = /^[A-Za-z0-9._-]+$/;
+export function esRutaDeArtefacto(ruta) {
+    if (ruta === undefined || !ruta.startsWith(RUTA_ARTEFACTOS))
+        return false;
+    const segmentos = ruta.slice(RUTA_ARTEFACTOS.length).split("/");
+    if (segmentos.length === 0)
+        return false;
+    return segmentos.every((s) => SEGMENTO.test(s) && s !== "." && s !== "..");
+}
+/**
+ * ¿Es esta ruta un artefacto escrito en el SITIO EQUIVOCADO? Y si lo es, dónde iba.
+ *
+ * **Esto existe porque el prompt se agotó.** La carpeta buena la nombran los cuatro sitios
+ * que el modelo puede leer —las instrucciones del `mockup`, la skill `artifacts-builder`,
+ * `archify` y la descripción de `write_file`—, y aun así, medido el 2026-09-07 en dos
+ * delegaciones CONSECUTIVAS del mismo proyecto: la primera escribió
+ * `/artifacts/login_flow.html` y la segunda, un minuto después, `/artefactos/diagrama.html`.
+ * No falta ninguna instrucción: es deriva del modelo. Y el fallo no es cosmético — ahí el
+ * diagrama pasa por la aprobación humana, entra en git y **sube a CloudStudio, dentro de la
+ * app del cliente**.
+ *
+ * Es la misma clase de regla que las vistas aplanadas: se aplica en el BACKEND
+ * (`agent/proyecto.ts#sinArtefactosEnElProyecto`) y no en un prompt, porque un permiso solo
+ * protege a quien lo choca. Aquí vive solo la regla, que es datos puros.
+ *
+ * **Se mira el PRIMER segmento y nada más**, y eso acota el falso positivo a propósito: un
+ * `/src/artifacts.js` o un `/scripts/artifacts/util.js` del proyecto pasan sin enterarse.
+ * Lo que se deniega es la carpeta de la raíz que XOne no tiene y que ninguna convención de
+ * la plataforma usa. El precio, dicho: un proyecto que de verdad tuviera un `artifacts/` en
+ * su raíz no podría escribir ahí con el agente. Se acepta, porque el otro lado del error es
+ * un diagrama subido a la app del cliente sin que nadie se entere.
+ *
+ * Sin distinguir mayúsculas, que es la lección de APFS: `/Artifacts/` abre el mismo sitio.
+ */
+const CARPETAS_EQUIVOCADAS = new Set(["artifacts", "artifact"]);
+/** El fichero suelto que nombra el contrato de `publish_artifact` (`path="/artifact.html"`). */
+const FICHERO_EQUIVOCADO = "artifact.html";
+export function artefactoFueraDeSitio(ruta) {
+    const segmentos = ruta.split(/[\\/]+/).filter((s) => s.length > 0);
+    if (segmentos.length === 0)
+        return undefined;
+    const primero = segmentos[0].toLowerCase();
+    const esCarpeta = CARPETAS_EQUIVOCADAS.has(primero) && segmentos.length > 1;
+    const esFichero = primero === FICHERO_EQUIVOCADO && segmentos.length === 1;
+    if (!esCarpeta && !esFichero)
+        return undefined;
+    // La carpeta de la sesión es PLANA hacia fuera: de `/artifacts/sub/x.html` se propone
+    // `x.html`, no `sub/x.html`. Un artefacto es una salida, no un árbol.
+    return `${RUTA_ARTEFACTOS}${segmentos[segmentos.length - 1]}`;
+}
+/** El nombre que se le enseña a una persona: el último segmento y nada más. */
+export function nombreDeArtefacto(ruta) {
+    return ruta.slice(ruta.lastIndexOf("/") + 1);
+}
+/**
+ * De qué es este artefacto, por su EXTENSIÓN.
+ *
+ * Tabla cerrada y por extensión, igual que el visor de Ficheros: olfatear los bytes no vale
+ * —un PNG lleva ceros en su cabecera y caería por el camino del texto— y aquí además el
+ * fichero lo acaba de escribir el agente, así que su nombre es lo que él eligió decir que
+ * es. Lo que no esté en la tabla no se afirma: `undefined` es «no lo sé», que es distinto de
+ * «es binario».
+ */
+const MIMES = {
+    html: "text/html",
+    svg: "image/svg+xml",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    gif: "image/gif",
+    md: "text/markdown",
+    txt: "text/plain",
+    json: "application/json",
+    csv: "text/csv",
+};
+export function mimeDeArtefacto(nombre) {
+    const punto = nombre.lastIndexOf(".");
+    if (punto <= 0)
+        return undefined;
+    return MIMES[nombre.slice(punto + 1).toLowerCase()];
+}
+//# sourceMappingURL=artefactos.js.map

package/dist/core/artefactos.js.map

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

package/dist/core/cloudstudio.js

@@ -0,0 +1,7 @@
+/**
+ * Los tipos que cruzan la frontera CloudStudio ↔ xonecode.
+ *
+ * Viven en `core/` a propósito: son datos, no transporte. El SDK MCP se queda en `agent/`.
+ */
+export {};
+//# sourceMappingURL=cloudstudio.js.map

package/dist/core/cloudstudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudstudio.js","sourceRoot":"","sources":["../../src/core/cloudstudio.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}