xonecode 0.1.0

package/dist/core/ports.js

@@ -0,0 +1,114 @@
+/**
+ * Los puertos: todo lo caro entra por aquí, con su doble determinista al lado.
+ *
+ * La regla dura: los puertos se PASAN al construir, nunca se importan dentro de quien
+ * los usa. Es lo que hace que el lazo completo se recorra sin API, sin red y sin
+ * CloudStudio — la propiedad que sostiene los tests offline del laboratorio.
+ *
+ * Este fichero es TypeScript puro: no importa langchain, langgraph, deepagents, MCP,
+ * Ink ni React. La frontera está probada en `core/imports.test.ts`.
+ */
+/**
+ * La marca de «esto es un doble», y por qué es un Symbol y no un booleano.
+ *
+ * En el harness Python equivalente el flag `verifier_is_stub` no es un campo que alguien
+ * rellene: es una propiedad derivada de la CLASE del objeto. La diferencia importa —
+ * un booleano se puede olvidar, o poner a false sobre un doble, y entonces los tres
+ * avisos de honestidad callan justo cuando más falta hacen.
+ *
+ * Aquí la traducción fiel es una marca que solo los dobles llevan: un puerto real no
+ * puede fingir que no lo es porque no la tiene, y un doble no puede quitársela sin
+ * editar su propia definición.
+ */
+export const ES_DOBLE = Symbol.for("xonecode.es-doble");
+export function esDoble(puerto) {
+    return typeof puerto === "object" && puerto !== null && ES_DOBLE in puerto;
+}
+/**
+ * La huella de un hallazgo, para detectar NO-PROGRESO: la misma huella dos veces seguidas
+ * significa que reparar no está avanzando, y se bloquea ANTES de agotar el presupuesto.
+ *
+ * Ignora el mensaje a propósito: lleva nombres interpolados que varían sin que el problema
+ * cambie. Y tolera la ausencia de línea, que es el caso normal según la medición.
+ */
+export function huella(h) {
+    return [h.code, h.fichero ?? "", h.linea ?? ""].join("|");
+}
+// ─────────────────────────── LOS DOBLES ───────────────────────────
+// Viven aquí, junto a los puertos, y NO en una carpeta de tests. El motivo: el modo
+// offline es un modo de USO de primera clase (`xonecode describe` lo enseña al usuario),
+// no un detalle de la suite. Un doble escondido en fixtures no lo puede reportar.
+export class McpVacio {
+    [ES_DOBLE] = true;
+    async catalogo() {
+        return { cloudstudio: [], ide: [] };
+    }
+    async invocar(tool) {
+        throw new Error(`[DOBLE] No hay MCP: la tool «${tool}» no se ha ejecutado y el proyecto NO se ha tocado.`);
+    }
+    async cerrar() { }
+}
+export class SkillsEnMemoria {
+    contenido;
+    [ES_DOBLE] = true;
+    constructor(contenido = {}) {
+        this.contenido = contenido;
+    }
+    catalogo() {
+        return Object.keys(this.contenido).map((nombre) => ({
+            nombre,
+            descripcion: `[DOBLE] skill en memoria`,
+            tokens: Math.ceil(this.contenido[nombre].length / 4),
+        }));
+    }
+    cargar(nombre) {
+        const c = this.contenido[nombre];
+        if (c === undefined)
+            throw new Error(`[DOBLE] no hay skill «${nombre}» en memoria`);
+        return c;
+    }
+}
+export class ModeloGuionizado {
+    respuestas;
+    [ES_DOBLE] = true;
+    constructor(respuestas = ["(respuesta guionizada)"]) {
+        this.respuestas = respuestas;
+    }
+    paraPapel() {
+        return { guion: this.respuestas };
+    }
+    descripcion() {
+        return {
+            rapido: "[DOBLE] guionizado",
+            trabajo: "[DOBLE] guionizado",
+            afilado: "[DOBLE] guionizado",
+        };
+    }
+}
+/**
+ * Verificador que siempre dice verde.
+ *
+ * Peligroso a propósito: es el doble que más miente si nadie lo declara, porque un verde
+ * falso deja pasar código roto. Por eso lleva la marca y por eso `describe` lo canta.
+ */
+export class StubVerifier {
+    [ES_DOBLE] = true;
+    async verificar() {
+        return { verde: true, hallazgos: [] };
+    }
+}
+/** Verificador con guion, para recorrer el lazo de reparación sin LLM: [rojo, rojo, verde]. */
+export class VerifierGuionizado {
+    guion;
+    [ES_DOBLE] = true;
+    i = 0;
+    constructor(guion) {
+        this.guion = guion;
+    }
+    async verificar() {
+        const r = this.guion[Math.min(this.i, this.guion.length - 1)];
+        this.i++;
+        return r;
+    }
+}
+//# sourceMappingURL=ports.js.map

package/dist/core/ports.js.map

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

package/dist/core/turno.js

@@ -0,0 +1,127 @@
+import { Bitacora } from "./bitacora.js";
+import { Colapsador } from "./notify.js";
+/** Cómo se le cuenta cada fase al usuario. En un solo sitio, no repartido por el motor. */
+const TEXTO_DE_FASE = {
+    entendiendo: "entendiendo la petición",
+    planificando: "planificando",
+    "esperando-aprobacion": "esperando tu aprobación",
+    ejecutando: "desarrollando",
+    verificando: "verificando con el simulador",
+    juzgando: "revisando el resultado",
+    subiendo: "publicando",
+    respondiendo: "redactando la respuesta",
+};
+/**
+ * Un turno completo: consume los eventos, cuenta lo que hay que contar, devuelve la
+ * bitácora.
+ *
+ * Nunca deja la línea de tokens abierta: el `finally` la cierra tanto si el turno termina
+ * bien como si el flujo revienta a mitad. Sin eso, el mensaje de error se pegaría al final
+ * de una respuesta a medio escribir.
+ */
+export async function correrTurno(eventos, piel, opciones = {}) {
+    const bitacora = new Bitacora();
+    const colapsador = new Colapsador();
+    const t0 = Date.now();
+    let abierta = false;
+    let ultimoId;
+    /** Cualquier cosa que no sea un token empieza su propia línea. */
+    const escribirLinea = (texto) => {
+        if (abierta) {
+            piel.cerrarLinea();
+            abierta = false;
+        }
+        piel.linea(texto);
+    };
+    try {
+        for await (const ev of eventos) {
+            switch (ev.tipo) {
+                case "token":
+                    if (abierta && ev.msgId !== undefined && ev.msgId !== ultimoId) {
+                        piel.cerrarLinea();
+                        abierta = false;
+                    }
+                    ultimoId = ev.msgId;
+                    abierta = true;
+                    piel.token(ev.texto);
+                    break;
+                case "fase": {
+                    bitacora.anota(ev.fase, ev.detalle ?? "");
+                    const texto = `${TEXTO_DE_FASE[ev.fase]}${ev.detalle ? ` — ${ev.detalle}` : ""}`;
+                    // La fase DURA: la piel que sabe animarla la recibe delegada (con la línea de
+                    // tokens cerrada, como cualquier otra cosa que empieza su propia línea); la
+                    // que no, la pinta como la línea estática de siempre.
+                    if (piel.fase) {
+                        if (abierta) {
+                            piel.cerrarLinea();
+                            abierta = false;
+                        }
+                        piel.fase(texto);
+                    }
+                    else {
+                        escribirLinea(`·  ${texto}`);
+                    }
+                    break;
+                }
+                case "tool":
+                    bitacora.anota("tool", ev.nombre);
+                    for (const linea of colapsador.lineas({ nombre: ev.nombre, detalle: ev.detalle, error: ev.error })) {
+                        escribirLinea(linea);
+                    }
+                    break;
+                case "plan":
+                    bitacora.anota("plan", `${ev.tareas.length} tareas`);
+                    escribirLinea(`📋 plan de ${ev.tareas.length} tarea(s):`);
+                    ev.tareas.forEach((t, i) => escribirLinea(`   ${i + 1}. ${t.descripcion}`));
+                    break;
+                case "tarea":
+                    bitacora.anota("tarea", `${ev.id} ${ev.estado}`);
+                    escribirLinea(`▶  tarea ${ev.indice}/${ev.total}: ${ev.id} — ${ev.estado}`);
+                    break;
+                case "verificacion":
+                    bitacora.anota("verify", ev.verde ? "verde" : `${ev.errores} errores`);
+                    escribirLinea(ev.verde
+                        ? "✓  verificación en verde"
+                        : `✗  verificación: ${ev.errores} error(es), ${ev.avisos} aviso(s)`);
+                    break;
+                case "reparacion":
+                    bitacora.anota("reparacion", `${ev.intento}/${ev.tope}`);
+                    escribirLinea(`🔁 reparando (intento ${ev.intento} de ${ev.tope})`);
+                    break;
+                case "bloqueado":
+                    bitacora.anota("bloqueado", ev.motivo);
+                    escribirLinea(`⛔ bloqueado (${ev.motivo}): ${ev.explicacion}`);
+                    break;
+                case "pausa":
+                    if (abierta) {
+                        piel.cerrarLinea();
+                        abierta = false;
+                    }
+                    bitacora.anota("pausa", `${ev.pendientes.length} pendiente(s)`);
+                    piel.pausa(ev.pendientes);
+                    break;
+                case "aviso":
+                    bitacora.anota("aviso", ev.texto);
+                    escribirLinea(ev.texto);
+                    break;
+                case "fin":
+                    break;
+            }
+        }
+    }
+    finally {
+        // La cuenta de la última racha de tools, aunque el turno reviente: si se cayó a
+        // mitad, el «×17» es justo el dato que explica dónde se quedó.
+        const cierre = colapsador.cierre();
+        if (cierre)
+            escribirLinea(cierre);
+        // Los avisos deterministas van DESPUÉS de todo, y también si hubo excepción.
+        for (const aviso of opciones.avisos?.(bitacora) ?? [])
+            escribirLinea(aviso);
+        if (abierta)
+            piel.cerrarLinea();
+        piel.fin(Date.now() - t0);
+    }
+    return bitacora;
+}
+//# sourceMappingURL=turno.js.map

package/dist/core/turno.js.map

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

package/dist/vendor/hitl.js

@@ -0,0 +1,103 @@
+/**
+ * Aprobación humana de N escrituras concurrentes.
+ *
+ * La forma de este módulo sale de la verificación en vivo, no de la intuición:
+ *
+ * 1. Los interrupts de un subagente SÍ propagan al stream de arriba.
+ * 2. Con el orquestador emitiendo dos `task` en un turno, quedan DOS interrupts
+ *    pendientes a la vez (`tasks.length === 2`, `next === ["tools","tools"]`).
+ * 3. El resume tiene que ser un MAPA por id de interrupt. Un array pelado falla con
+ *    "Invalid HITLResponse: decisions must be a non-empty array".
+ * 4. El interrupt NO dice de qué subagente viene, así que la atribución viaja en la
+ *    `description` que cada subagente pone en su `InterruptOnConfig`.
+ *
+ * De ahí que esto no pueda ser un "pregunta una cosa y reanuda": hay que recoger
+ * todos los pendientes, preguntar por cada uno, y reanudar con un único Command.
+ */
+/**
+ * Tope de rondas de aprobación. Sin él, un modelo que insista tras cada rechazo
+ * convierte el bucle en un ciclo automático de ~200k tokens por ronda. Lo comparten
+ * da04 y la consola.
+ */
+export const MAX_APPROVAL_ROUNDS = 5;
+/**
+ * El mensaje de rechazo tiene que dejar clarísimo que NO se aplicó nada: si solo dice
+ * "no la reintentes", el modelo puede sintetizar la respuesta final como si la
+ * escritura hubiese quedado lista — la salida contradiciendo lo que realmente pasó.
+ */
+export const REJECT_MESSAGE = "RECHAZADO por el usuario. Esta operación NO se ha ejecutado y el proyecto NO se " +
+    "ha modificado. No la reintentes ni la reformules. En tu respuesta final di " +
+    "explícitamente que el cambio no se aplicó porque fue rechazado, y explica qué " +
+    "pretendías hacer y por qué, para que el usuario pueda decidir.";
+export function collectPending(state) {
+    const tasks = state?.tasks;
+    if (!Array.isArray(tasks))
+        return [];
+    const pending = [];
+    for (const task of tasks) {
+        const interrupts = task.interrupts;
+        if (!Array.isArray(interrupts))
+            continue;
+        for (const interrupt of interrupts) {
+            const { id, value } = interrupt;
+            const action = value?.actionRequests?.[0];
+            if (!id || !action?.name)
+                continue;
+            pending.push({
+                id,
+                tool: action.name,
+                args: action.args ?? {},
+                description: action.description ?? `Ejecutar ${action.name}`,
+                allowedDecisions: value?.reviewConfigs?.[0]?.allowedDecisions ?? ["approve", "reject"],
+            });
+        }
+    }
+    return pending;
+}
+/** El mapa `{ id → { decisions: [...] } }` que espera `new Command({ resume })`. */
+export function buildResume(decisions) {
+    const resume = {};
+    for (const [id, decision] of decisions) {
+        resume[id] = { decisions: [decision] };
+    }
+    return resume;
+}
+/**
+ * Respuestas que cuentan como aprobar.
+ *
+ * El Enter a secas ("") solo vale con un terminal de verdad detrás. Fuera de un TTY
+ * —un pipe, CI, un cron— una línea en blanco no demuestra que haya nadie mirando, y
+ * esto aprueba escrituras sobre un proyecto real. Ahí se exige un "s" explícito.
+ */
+const APPROVALS_TTY = new Set(["", "s", "si", "sí", "y", "yes"]);
+const APPROVALS_NO_TTY = new Set(["s", "si", "sí", "y", "yes"]);
+/**
+ * Interpreta una respuesta de aprobación, sin imprimir nada ni preguntar: es la
+ * parte pura de promptForDecisions, para que la consola TUI la reutilice.
+ *
+ * Fail-closed: el Enter a secas solo aprueba con `interactive: true` explícito (un
+ * TTY de verdad detrás); cualquier otra respuesta que no se entiende es rechazo.
+ */
+export function interpretAnswer(answer, opts = {}) {
+    const approvals = opts.interactive === true ? APPROVALS_TTY : APPROVALS_NO_TTY;
+    if (approvals.has(answer.trim().toLowerCase()))
+        return { type: "approve" };
+    return { type: "reject", message: REJECT_MESSAGE };
+}
+export async function promptForDecisions(pending, ask, opts = {}) {
+    const decisions = new Map();
+    for (const [i, p] of pending.entries()) {
+        console.log(`\n${"─".repeat(64)}`);
+        console.log(`APROBACIÓN ${i + 1}/${pending.length}: ${p.description}`);
+        console.log(`  tool: ${p.tool}`);
+        // La `description` propia sustituye a la autogenerada, que era la que traía los
+        // args. Hay que imprimirlos aquí o el usuario aprueba a ciegas.
+        console.log(`  args: ${JSON.stringify(p.args, null, 2).replace(/\n/g, "\n        ")}`);
+        const answer = await ask("¿Aprobar? [S/n] ");
+        const decision = interpretAnswer(answer, opts);
+        decisions.set(p.id, decision);
+        console.log(decision.type === "approve" ? "  → aprobado" : "  → rechazado");
+    }
+    return decisions;
+}
+//# sourceMappingURL=hitl.js.map

package/dist/vendor/hitl.js.map

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

package/dist/vendor/skillLoaders/catalog.js

@@ -0,0 +1,74 @@
+/**
+ * Descubrimiento de skills propio, independiente del middleware de deepagents.
+ *
+ * Existe porque el experimento necesita construir el catálogo y el cuerpo del skill
+ * por su cuenta: el middleware interno solo sabe hacerlo de una manera (metadatos al
+ * prompt + `read_file` para el cuerpo), y lo que se quiere medir es justo qué pasa
+ * cuando se hace de otras.
+ */
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+/**
+ * Frontmatter YAML mínimo: `clave: valor` de una línea entre delimitadores `---`.
+ * No se usa un parser de YAML a propósito — los skills reales solo necesitan esto y
+ * una dependencia más sería ruido en un experimento sobre coste de contexto.
+ */
+export function parseFrontmatter(content) {
+    if (!content.startsWith("---"))
+        return { data: {}, body: content };
+    const end = content.indexOf("\n---", 3);
+    if (end === -1)
+        return { data: {}, body: content };
+    const raw = content.slice(3, end);
+    const data = {};
+    for (const line of raw.split("\n")) {
+        const i = line.indexOf(":");
+        if (i === -1)
+            continue;
+        const key = line.slice(0, i).trim();
+        const value = line.slice(i + 1).trim();
+        if (key === "name")
+            data.name = value;
+        else if (key === "description")
+            data.description = value;
+    }
+    // El cuerpo empieza tras la línea de cierre.
+    const after = content.indexOf("\n", end + 1);
+    return { data, body: after === -1 ? "" : content.slice(after + 1) };
+}
+/** Ficheros del skill salvo el propio SKILL.md, en rutas relativas con `/`, ordenadas. */
+export function listSkillFiles(dir, limit = Infinity) {
+    const out = [];
+    const walk = (current) => {
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries.sort()) {
+            const full = join(current, entry);
+            if (statSync(full).isDirectory())
+                walk(full);
+            else if (full !== join(dir, "SKILL.md"))
+                out.push(relative(dir, full).split(sep).join("/"));
+        }
+    };
+    walk(dir);
+    return out.sort().slice(0, limit);
+}
+/** Lee un directorio de skill: frontmatter, cuerpo y ficheros. */
+export function loadSkill(dir, fileLimit = Infinity) {
+    const raw = readFileSync(join(dir, "SKILL.md"), "utf-8");
+    const { data, body } = parseFrontmatter(raw);
+    const fallback = dir.replace(/[/\\]$/, "").split(/[/\\]/).pop() ?? "skill";
+    return {
+        name: data.name ?? fallback,
+        description: data.description ?? "",
+        content: body,
+        dir,
+        files: listSkillFiles(dir, fileLimit),
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/vendor/skillLoaders/catalog.js.map

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

package/dist/vendor/tokenTracking.js

@@ -0,0 +1,58 @@
+import { createMiddleware } from "langchain";
+export function createTokenTracker() {
+    return { input: 0, output: 0, cache: 0, calls: 0, contexto: 0 };
+}
+export function createTokenTrackingMiddleware(tracker) {
+    return createMiddleware({
+        name: "TokenTrackingMiddleware",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        afterModel: (state) => {
+            const messages = (state?.messages ?? []);
+            const lastMsg = messages[messages.length - 1];
+            if (!lastMsg)
+                return;
+            let inputTokens = 0;
+            let outputTokens = 0;
+            let cacheRead = 0;
+            // usage_metadata (LangChain standard)
+            const usage = lastMsg.usage_metadata;
+            if (usage) {
+                inputTokens = usage.input_tokens ?? 0;
+                outputTokens = usage.output_tokens ?? 0;
+                const inputDetails = usage.input_token_details;
+                cacheRead = inputDetails?.cache_read ?? 0;
+            }
+            else {
+                // Fallback: response_metadata.token_usage
+                const responseMeta = lastMsg.response_metadata;
+                const tokenUsage = responseMeta?.token_usage;
+                if (tokenUsage) {
+                    inputTokens = tokenUsage.prompt_tokens ?? 0;
+                    outputTokens = tokenUsage.completion_tokens ?? 0;
+                    const details = tokenUsage.prompt_tokens_details;
+                    cacheRead = details?.cached_tokens ?? 0;
+                }
+            }
+            tracker.input += inputTokens;
+            tracker.output += outputTokens;
+            tracker.cache += cacheRead;
+            tracker.calls += 1;
+            tracker.contexto = inputTokens;
+        },
+    });
+}
+export function printTokenUsage(tracker, latencyMs) {
+    console.log("\n=== Token Usage ===");
+    console.log(`Input tokens:  ${tracker.input}`);
+    console.log(`Output tokens: ${tracker.output}`);
+    console.log(`Cache tokens:  ${tracker.cache}`);
+    console.log(`LLM calls:     ${tracker.calls}`);
+    if (latencyMs) {
+        const tps = latencyMs > 0 && tracker.output > 0
+            ? (tracker.output / latencyMs) * 1000
+            : 0;
+        console.log(`Latency:       ${latencyMs}ms`);
+        console.log(`Speed:         ${tps.toFixed(1)} tok/s`);
+    }
+}
+//# sourceMappingURL=tokenTracking.js.map

package/dist/vendor/tokenTracking.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "xonecode",
+  "version": "0.1.0",
+  "description": "Consola CLI y harness de agente para desarrollar aplicaciones XOne",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "xonecode": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && chmod +x dist/bin.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "xonecode": "tsx src/bin.ts"
+  },
+  "dependencies": {
+    "@langchain/anthropic": "1.5.2",
+    "@langchain/core": "1.2.3",
+    "@langchain/google-genai": "2.2.0",
+    "@langchain/langgraph": "1.4.8",
+    "@langchain/ollama": "1.3.0",
+    "@langchain/openai": "1.5.5",
+    "deepagents": "1.12.0",
+    "langchain": "1.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "tsx": "^4.23.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
+  }
+}

package/skills/xone-debugging/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: xone-debugging
+description: Diagnóstico sistemático de errores y rendimiento en aplicaciones XOne. Usar al depurar pantallas vacías, botones que no responden, eventos que no disparan, colecciones sin datos, self null, errores -8100 y -11888, problemas de refresh o de persistencia MAP_, lentitud en listas, o al analizar un fallo con xone-simulator.
+---
+
+# XOne Debugging
+
+Diagnostica por capas: reproduce, aísla, corrige y verifica. Antes de cambiar código, ejecuta el caso con `xone-simulator` y confirma el síntoma exacto. No propongas cambios a ciegas: formula una hipótesis comprobable y compruébala.
+
+## Proceso
+
+1. Reproduce el fallo.
+2. Aísla la capa: XML/UI, evento JavaScript, colección o persistencia.
+3. Busca el síntoma en las referencias.
+4. Corrige con el patrón documentado.
+5. Vuelve a validar y hacer smoke.
+
+```bash
+xone-simulator validate ./proyecto
+xone-simulator run ./proyecto --coll MiColl --event before-edit
+xone-simulator render ./proyecto --coll MiColl
+xone-simulator smoke ./proyecto --json
+```
+
+`--coll` acota, `--json` da salida estructurada y `--db-path` debe apuntar a una **copia** de la BD: el simulador puede mutarla. El validador detecta `ANTIPATTERN_LOAD_EVENT` y `ANTIPATTERN_MULTIPLE_BEFORE_EDIT`.
+
+## Diagnóstico rápido
+
+- **Pantalla vacía**: revisa `loadAll()`, `visible`, `unlock`, `ui.refresh()`, filtros `##FLD_CAMPO##`, que el `contents` del `prop type="Z"` coincida con el `<contents name>`, nombres duplicados en la coll, `special` junto a `sql`, y `newline="false"` en el primer elemento de un frame.
+- **CSS que no se aplica**: comprueba primero `compatibility-mode` en el nodo `<app>` (regla en `xone-development`).
+- **Botón mudo**: `visible`, `disableedit`, solapamientos, y que exista el handler de `onclick` o `method="ExecuteNode(nombre)"` (nunca los dos a la vez).
+- **Evento que no dispara**: nombres exactos y case-sensitive, y errores JavaScript silenciosos.
+- **`onchange` que no salta**: en `type="T"` ocurre al perder el foco; para cada tecla, `ontextchanged`. `onchange` acepta comandos (`refresh`, `refresh(MAP_CAMPO)`), no booleanos.
+- **Refresh que no repinta**: usa el nombre exacto del `<prop>`. Tras `setFieldPropertyValue` hay que llamar a `ui.refresh(prop)`: no repinta solo. En callbacks, conserva `self` y comprueba `ui.getView(...)`.
+- **Datos que no persisten**: los campos `MAP_` son transitorios y el framework los excluye de INSERT y UPDATE. Para guardar, usa un campo con columna.
+- **Pantalla que no se inicializa**: la lógica está en `<load>`. Muévela a `<before-edit>`.
+- **`-8100`**: falta un campo obligatorio.
+- **`-11888`**: distingue `##EXIT##` de `##EXITAPP##` (regla en `xone-development`).
+- **Lentitud**: trabajo pesado en `<load>`, `loadall="true"` en tablas grandes, refrescos dentro de bucles.
+
+## Reglas
+
+Las reglas de XOne detrás de estos síntomas viven en la skill `xone-development`. Aquí solo se diagnostica: para la forma correcta, consulta allí antes de aplicar una corrección.
+
+## Referencias
+
+| Para… | Lee |
+|---|---|
+| Preguntas frecuentes por área: general, XML/UI, JavaScript, CSS y estructura de proyecto | [references/faq.md](references/faq.md) |
+| Troubleshooting completo por síntoma (incluye «`load` no inicializa la pantalla») y glosario de términos XOne | [references/troubleshooting-y-glosario.md](references/troubleshooting-y-glosario.md) |
+
+Para las reglas y anti-patrones de cada capa, `xone-development`. Para el flujo completo de validación y auditoría, `xone-review`.