xonecode 0.1.0

package/dist/cli/main.js

@@ -0,0 +1,520 @@
+/**
+ * El despachador. Cada comando expone `cmdX(...)` y se registra aquí.
+ *
+ * Sin librería de argumentos a propósito: hoy hay un comando y una bandera, y una
+ * dependencia más es una dependencia más que fijar y vigilar. Cuando haya cinco, se mete.
+ */
+import * as readline from "node:readline";
+import { randomUUID } from "node:crypto";
+import { basename } from "node:path";
+import { cmdRun } from "./run.js";
+import { cmdDescribe } from "./describe.js";
+import { cmdConfig } from "./config.js";
+import { cmdDoctor } from "./doctor.js";
+import { cmdVerify } from "./verify.js";
+import { ModeloMalEscrito, parsear, resolver } from "../core/modelos.js";
+import { topeResuelto } from "../core/contextos.js";
+import { cargar } from "../agent/configEnDisco.js";
+import { COMANDOS, correrConsola, crearCompleter, } from "./consola.js";
+import { crearLeerSecreto, crearPreguntar, crearPielStdio, escribirEnStdout } from "./stdio.js";
+import { crearTema } from "./tema.js";
+import { pedirDecisiones } from "./aprobar.js";
+import { inspeccionar } from "../agent/entorno.js";
+import { SkillsEnDisco } from "../agent/skills.js";
+import { Modelos } from "../agent/modelos.js";
+import { abrirSesionReal, ficherosDelProyecto } from "../agent/turnoReal.js";
+import { crearProyecto } from "../agent/crearProyecto.js";
+import { createTokenTracker } from "../vendor/tokenTracking.js";
+/**
+ * Estilo, y solo con TTY detrás.
+ *
+ * Los códigos viven en `cli/tema.ts` — el único fichero con ANSI de todo `src/`,
+ * vigilado por `cli/tema.test.ts` — y este fichero pide SIGNIFICADO (`tema.mudo`),
+ * nunca color. Sin TTY el tema apagado lo convierte todo en cadena vacía, así que
+ * las tuberías y los logs de CI quedan limpios sin ramificar por aquí.
+ */
+const CON_COLOR = process.stdout.isTTY === true;
+const tema = crearTema(CON_COLOR);
+const DIM = tema.mudo;
+const BOLD = tema.negrita;
+const RESET = tema.reset;
+/** El prompt. Se ve dónde acaba la respuesta y empieza lo que uno escribe. */
+const PROMPT = CON_COLOR ? `${tema.prompt}❯${tema.reset} ` : "> ";
+/**
+ * Envuelve las líneas de `readline` para pintar la barra y el prompt ANTES de cada una.
+ *
+ * Hace falta un envoltorio porque `readline.Interface` es un `AsyncIterable` que NO pinta
+ * el prompt por su cuenta al iterarlo: hay que llamar a `rl.prompt()` a mano, y el sitio
+ * correcto es justo antes de esperar cada línea. Iterándolo a pelo —como estaba— la consola
+ * no enseña nada y parece colgada.
+ *
+ * Sin TTY no se pinta ni barra ni prompt: en una tubería son ruido que ensucia la salida
+ * que alguien va a comparar o a parsear.
+ */
+async function* conPrompt(rl, escribir, barra) {
+    if (CON_COLOR) {
+        escribir(barra());
+        rl.prompt();
+    }
+    for await (const linea of rl) {
+        yield linea;
+        // Tras el turno o el comando, la barra vuelve a decir dónde estás: el modelo puede
+        // haber cambiado con /modelo y los tokens haber subido.
+        if (CON_COLOR) {
+            escribir(barra());
+            rl.prompt();
+        }
+    }
+}
+const AYUDA = `xonecode — harness de XOne
+
+  xonecode run "<peticion>"      un turno, de un disparo (pipeable)
+  xonecode run --real "<peticion>"   el agente real sobre el proyecto del cwd
+  xonecode describe              qué hay montado y qué es de pega (sin red)
+  xonecode config                qué config y credenciales cogería (sin claves)
+  xonecode config --json         lo mismo, en JSON parseable
+  xonecode doctor                ¿hay un proyecto aquí? ¿responde el simulador?
+  xonecode verify [ruta]         valida el proyecto con xone-simulator (por omisión, aquí)
+  xonecode --guion               la consola con el agente de pega, sin gastar
+  xonecode --help                esto
+
+Modelo:
+  --modelo <proveedor>/<modelo>          fija los tres papeles
+  --modelo-rapido / --modelo-trabajo / --modelo-afilado <p>/<m>   fija uno
+  XONECODE_MODELO=<p>/<m>                por entorno
+
+  Proveedores: gemini, openai, anthropic, ollama
+`;
+/**
+ * Las banderas de modelo llevan valor suelto (`--modelo x`, no `--modelo=x`), y ese
+ * valor NO empieza por `--`: si no se quita aquí, el join de la petición en `run` lo
+ * comería como texto. Devuelve las fuentes ya resueltas y el argv SIN las banderas ni
+ * sus valores sueltos, para que `--lento` y el filtro de `--` sigan funcionando igual.
+ */
+export function extraerBanderasDeModelo(argv) {
+    let bandera;
+    const porPapel = {};
+    const resto = [];
+    /** Qué papel fija cada bandera específica. `undefined` = no es una de ellas. */
+    const papelDeBandera = (n) => n === "--modelo-rapido" ? "rapido" : n === "--modelo-trabajo" ? "trabajo" : n === "--modelo-afilado" ? "afilado" : undefined;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const nombre = a.slice(0, a.indexOf("=") === -1 ? undefined : a.indexOf("="));
+        const valorConIgual = a.indexOf("=") === -1 ? undefined : a.slice(a.indexOf("=") + 1);
+        const papel = papelDeBandera(nombre);
+        if (nombre === "--modelo" || papel) {
+            if (valorConIgual !== undefined) {
+                // Forma con '=': el valor viene pegado a la bandera.
+                if (nombre === "--modelo")
+                    bandera = valorConIgual;
+                else
+                    porPapel[papel] = valorConIgual;
+            }
+            else {
+                // Forma con espacio: el valor suelto siguiente se consume, sea o sea '--'.
+                const valor = argv[i + 1];
+                if (valor === undefined) {
+                    throw new ModeloMalEscrito(`la bandera «${nombre}» necesita un valor <proveedor>/<modelo>`);
+                }
+                if (nombre === "--modelo")
+                    bandera = valor;
+                else
+                    porPapel[papel] = valor;
+                i++;
+            }
+            continue;
+        }
+        resto.push(a);
+    }
+    return {
+        fuentes: { bandera, porPapel, entorno: { XONECODE_MODELO: process.env.XONECODE_MODELO } },
+        resto,
+    };
+}
+/**
+ * Token compacto para la línea de estado: `0 tokens` hasta 999, `12.8K tokens` a partir
+ * de 1000. Un decimal basta para un indicador de cabecera; la cifra exacta la da quien
+ * la necesita (printTokenUsage al final de los experimentos).
+ */
+function formatearTokens(total) {
+    return total < 1000 ? `${total} tokens` : `${(total / 1000).toFixed(1)}K tokens`;
+}
+/** El tope de contexto, compacto: `131K`, `200K`, `1M`. Sin decimales de cortesía. */
+function formatearTope(tope) {
+    if (tope >= 1_000_000)
+        return `${tope / 1_000_000}M`;
+    return `${Math.round(tope / 1000)}K`;
+}
+/**
+ * La barra de estado como función PURA: la compone quien tiene los valores y
+ * la pinta quien tiene el color. Así la barra se puede probar sin TTY — y es
+ * que solo se pinta con TTY, que es justo el caso que los tests no pueden ser.
+ *
+ * La sección `ctx` solo existe si hay algo que medir, y el porcentaje solo si
+ * hay tope: sin tope conocido, la cifra va pelada antes que calcular un
+ * porcentaje sobre un número inventado.
+ */
+export function formatearBarra(p) {
+    const ctx = p.contexto > 0
+        ? ` · ctx ${formatearTokens(p.contexto).replace(" tokens", "")}` +
+            (p.tope !== undefined
+                ? `/${formatearTope(p.tope)} (${Math.round((p.contexto / p.tope) * 100)}%)`
+                : "")
+        : "";
+    return `─ ${p.proyecto} (${p.colecciones} colls) · ${p.modelo} · ${formatearTokens(p.tokens)}${ctx} · /ayuda`;
+}
+/**
+ * El ejecutor de turno REAL de la consola: cada línea de prosa corre sobre una `SesionReal`
+ * que sobrevive entre turnos (mismo agente, mismo hilo).
+ *
+ * La sesión se construye PEREZOSA, en el primer turno de prosa y no al arrancar
+ * `entrarEnConsola`, por dos razones:
+ *  - El `Entorno` completo lo pide `inspeccionar` (el real de `agent/entorno.js`), no el
+ *    doble `{colecciones}` de la cabecera, y abrir la sesión construye el grafo: hacerlo en
+ *    el arranque gastaría en una consola que quizá solo se use para `/ayuda` o `/config`.
+ *  - El detector de `/modelo` y `/nuevo` es la comparación de `estado` entre turnos: los
+ *    manejadores de `consola.ts` no tocan la sesión (no la conocen), así que la única
+ *    costura es el `estado` que este ejecutor recibe en cada llamada.
+ *
+ * `alAbrirSesion` se llama UNA vez, justo tras `abrirSesionReal`, y es la costura por la
+ * que `entrarEnConsola` apunta la barra de estado al tracker de la sesión (que alimenta
+ * el agente; el de `createTokenTracker()` de cabecera se descarta al reasignarse).
+ */
+function crearEjecutorReal(alAbrirSesion) {
+    let sesion;
+    let fuentesVistas;
+    let hiloVisto;
+    return async (peticion, estado, consolaReal) => {
+        if (sesion === undefined) {
+            // Mismo diagnóstico y mismas frases que `run --real`: no se construye NADA sobre un
+            // sitio que no es un proyecto XOne, y la consola sigue viva para otros comandos.
+            const entorno = await inspeccionar(estado.raiz);
+            if (!entorno.esProyectoXone) {
+                consolaReal.escribir(`${entorno.raiz}  (no hay app.xml aquí)\n`);
+                consolaReal.escribir("✗ falta algo imprescindible: xonecode no puede trabajar aquí.\n");
+                return;
+            }
+            sesion = await abrirSesionReal({
+                raiz: estado.raiz,
+                modelos: new Modelos(estado.fuentes),
+                skills: new SkillsEnDisco(),
+                entorno,
+                // Las aprobaciones entran por el `preguntar` de la propia consola: el turno para
+                // y pregunta DENTRO de la sesión, sin salir de ella ni montar otro lector de stdin.
+                pedirAprobacion: (lista, ficheros, diffs) => pedirDecisiones(lista, consolaReal.preguntar, consolaReal.escribir, {
+                    interactive: consolaReal.interactivo,
+                    fichero: (id) => ficheros.get(id),
+                    diff: (id) => diffs.get(id),
+                }),
+            });
+            alAbrirSesion(sesion);
+            // Recién construida: no hay cambio que detectar en esta primera vuelta.
+            fuentesVistas = estado.fuentes;
+            hiloVisto = estado.hilo;
+        }
+        else {
+            // `/modelo` solo actualizó `estado.fuentes`; aquí es donde deja de ser un cambio
+            // cosmético: el agente se reconstruye con el modelo nuevo y el hilo SE CONSERVA.
+            if (JSON.stringify(estado.fuentes) !== JSON.stringify(fuentesVistas)) {
+                await sesion.cambiarModelos(new Modelos(estado.fuentes));
+                consolaReal.escribir("  (agente reconstruido con el modelo nuevo — el hilo se conserva)\n");
+                fuentesVistas = estado.fuentes;
+            }
+            // `/nuevo` generó su propio UUID, que no coincide con el hilo interno de la sesión:
+            // lo que importa es que CAMBIÓ, y se abre uno nuevo. El aviso ya lo imprimió el
+            // manejador de consola.ts.
+            if (estado.hilo !== hiloVisto) {
+                // **Se le pasa el id de la consola.** Sin esto había DOS ids para un mismo hilo —
+                // el de la consola y el que generaba la sesión— y `/hilo` enseñaba el que NO usaba
+                // el grafo. Un identificador que no identifica es peor que no darlo.
+                sesion.nuevoHilo(estado.hilo);
+                hiloVisto = estado.hilo;
+            }
+        }
+        await sesion.turno(peticion, crearPielStdio(consolaReal.escribir));
+    };
+}
+/**
+ * La sesión interactiva: `xonecode` a secas.
+ *
+ * Mismo patrón de inyección que `cmdDescribe(fuentes, escribir, raiz)`: todo lo que toca
+ * el exterior (cwd, stdout, el proceso del simulador dentro de `inspeccionar`, y el
+ * propio stdin a través de readline) entra como parámetro con su valor de producción por
+ * omisión, así el test la recorre entera sin TTY ni procesos externos.
+ *
+ * Devuelve el código de salida, que es el que devuelva `correrConsola` (0 tanto por
+ * `/salir` como por EOF).
+ */
+/** ¿La respuesta a una pregunta sí/no es SÍ? Enter a secas y cualquier otra cosa: NO. */
+function esSi(respuesta) {
+    return ["s", "si", "y", "yes"].includes(respuesta.trim().toLowerCase());
+}
+/**
+ * El asistente de creación de proyecto: cuatro preguntas y el esqueleto en disco.
+ *
+ * La oferta inicial es sí/no con **omisión No**, como las aprobaciones: crear
+ * ficheros en la carpeta del usuario es opt-in, y quien no ha entendido la
+ * pregunta no ha pedido nada. Lo que se escribe es `core/esqueleto.ts` (el
+ * «Hola Mundo» de la documentación XOne, nada inventado), a través de
+ * `agent/crearProyecto.ts`, que no pisa lo que ya exista.
+ */
+async function ofrecerCrearProyecto(raiz, consola) {
+    const respuesta = await consola.preguntar("¿Creo un proyecto XOne aquí? (s/N) ");
+    if (!esSi(respuesta))
+        return false;
+    const datos = await preguntarDatos(consola);
+    const informe = crearProyecto(raiz, datos);
+    consola.escribir(`✓ proyecto creado: ${informe.creados.length} ficheros` +
+        `${informe.saltados.length > 0 ? ` (${informe.saltados.length} existentes no tocados: ${informe.saltados.join(", ")})` : ""}\n`);
+    // Las carpetas del runtime van VACÍAS a propósito, y eso hay que decirlo: quien
+    // no sepa que el .db lo genera el simulador pensará que falta algo.
+    consola.escribir("  (bd/, icons/ y files/ están vacías: la base de datos la genera el simulador y los iconos se añaden a mano)\n");
+    return true;
+}
+/** Las cuatro preguntas, cada una re-preguntada hasta que la respuesta sirva. */
+async function preguntarDatos(consola) {
+    // El nombre interno no admite espacios (es `Name=` del app.ini y el prefijo de
+    // las clases de pantallas): re-preguntar, no «arreglarlo» por debajo.
+    let nombre = "";
+    for (;;) {
+        nombre = (await consola.preguntar("Nombre interno de la app (sin espacios): ")).trim();
+        if (nombre.length > 0 && !/\s/.test(nombre))
+            break;
+        consola.escribir("  (sin espacios y no vacío)\n");
+    }
+    const titulo = (await consola.preguntar(`Título visible [${nombre}]: `)).trim() || nombre;
+    let orientacion = "portrait";
+    for (;;) {
+        const respuesta = (await consola.preguntar("Orientación (portrait/landscape) [portrait]: "))
+            .trim()
+            .toLowerCase();
+        if (respuesta === "")
+            break;
+        if (respuesta === "portrait" || respuesta === "landscape") {
+            orientacion = respuesta;
+            break;
+        }
+        consola.escribir("  (portrait o landscape)\n");
+    }
+    const login = esSi(await consola.preguntar("¿La app lleva login? (s/N) "));
+    return { nombre, titulo, orientacion, login };
+}
+/**
+ * El completer que monta la consola: comandos Y, tras una «@», ficheros del proyecto.
+ *
+ * Los ficheros se piden en el momento del Tab (`() => ficherosDelProyecto(raiz)`, no la
+ * lista ya hecha): el completer se construye una sola vez al arrancar el rl y la lista
+ * quedaría congelada en el primer instante de la sesión.
+ */
+export function crearCompleterDelProyecto(raiz, escribir = escribirEnStdout) {
+    return crearCompleter(escribir, () => ficherosDelProyecto(raiz));
+}
+export async function entrarEnConsola(fuentes, raiz = process.cwd(), escribir = escribirEnStdout, inspeccionarProyecto = inspeccionar, crearRl = () => readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: process.stdin.isTTY === true,
+    completer: crearCompleterDelProyecto(raiz),
+    // **El prompt.** Sin él la consola es un cursor pelado: no se sabe que espera, ni
+    // dónde acaba la respuesta y empieza lo que uno escribió. `readline` no lo pinta si
+    // no se le da uno Y se llama a `rl.prompt()` — las dos cosas hacen falta.
+    prompt: PROMPT,
+}), guion = false, 
+/** Costura de test del «¿hay alguien al otro lado?»: sin TTY no se pregunta nada. */
+interactivo = process.stdin.isTTY === true) {
+    // `let` porque el asistente de creación puede cambiarlo TODO: si el usuario acepta,
+    // la carpeta pasa de «0 colls, sin app.xml» a proyecto de verdad, y la cabecera se
+    // re-inspecciona para no mentir en la primera línea que se ve.
+    let entorno = await inspeccionarProyecto(raiz);
+    // El papel `trabajo` es el que representa a la sesión. Sin el sufijo `(origen)` que
+    // añade `Modelos.descripcion()`: la cabecera es breve y la procedencia se puede ver
+    // con /describe. `let` porque /modelo <p>/<m> la cambia EN CALIENTE dentro de la sesión.
+    let modeloTrabajo;
+    {
+        const { proveedor, modelo } = resolver(fuentes).trabajo;
+        modeloTrabajo = `${proveedor}/${modelo}`;
+    }
+    /**
+     * Los tokens acumulados de la sesión. Con `--guion` se queda en 0 a propósito: el turno
+     * guionizado no corre ningún modelo. Sin ella, la sesión real se construye PEREZOSA (al
+     * primer turno de prosa) y entonces esta variable se REASIGNA al tracker de la sesión —
+     * `let` y no `const` por eso: `barraDeEstado` y `cabecera` leen la variable en cada
+     * llamada (no una copia congelada), así que empiezan a leer del tracker real en cuanto
+     * la sesión existe. Lo que importa es que el OBJETO no se copia: el agente sigue
+     * alimentando ese mismo tracker, y la barra lo refleja sin tocar nada más.
+     */
+    let tracker = createTokenTracker();
+    // Las dos líneas de cabecera, construidas por una función porque se emiten DOS veces:
+    // al arrancar y tras cada /nuevo o /modelo. La lista de comandos se GENERA recorriendo
+    // el registro — una lista escrita a mano se queda vieja en cuanto alguien añade uno.
+    /**
+     * El tope de la ventana del modelo ACTUAL: tabla de `core/contextos.ts` + lo que el
+     * usuario haya fijado en `config.json` (lo de proyecto gana a lo global, como los
+     * modelos). Se lee en cada barra y no en el arranque porque `modeloTrabajo` cambia
+     * en caliente con /modelo, y un tope del modelo equivocado es un porcentaje que miente.
+     * Si el id no parsea —no debería, viene de `resolver`—, no hay tope y no pasa nada.
+     */
+    const topeDelModelo = (id) => {
+        try {
+            const { proveedor, modelo } = parsear(id);
+            const { config } = cargar(raiz);
+            // Misma resolución que /config (`topeResuelto`): proyecto gana a global, y la
+            // tabla es el último recurso. El origen aquí no se mira, pero así no puede
+            // divergir entre lo que la barra calcula y lo que /config declara.
+            return topeResuelto(proveedor, modelo, {
+                proyecto: config.proyecto?.contextos,
+                global: config.global?.contextos,
+            })?.tope;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    /**
+     * La barra de estado, al estilo de la de opencode: lo que uno necesita tener delante sin
+     * pedirlo. En stdio no se puede clavar al fondo de la pantalla —eso pide control de
+     * cursor, y es lo que trae la TUI de Ink— así que se emite ANTES de cada prompt, que es
+     * el sitio donde de verdad se mira.
+     *
+     * Lleva el modelo porque es lo que uno olvida haber cambiado, el proyecto porque la
+     * consola se lanza desde donde toque y equivocarse de carpeta es fácil, los tokens
+     * porque es el coste acumulándose, y el contexto porque es el margen que va
+     * consumiéndose — la cifra que dice si toca resumir el hilo.
+     */
+    const barraDeEstado = () => `${DIM}${formatearBarra({
+        proyecto: basename(raiz),
+        colecciones: entorno.colecciones,
+        modelo: modeloTrabajo,
+        tokens: tracker.input + tracker.output,
+        contexto: tracker.contexto,
+        tope: topeDelModelo(modeloTrabajo),
+    })}${RESET}\n`;
+    /** La cabecera larga: solo al arrancar y tras /nuevo o /modelo, nunca por turno. */
+    const cabecera = () => {
+        const comandos = Object.keys(COMANDOS)
+            .map((nombre) => `/${nombre}`)
+            .join(" ");
+        return (`${BOLD}xonecode${RESET} · ${basename(raiz)} (${entorno.colecciones} colls) · ${modeloTrabajo} · ` +
+            `${formatearTokens(tracker.input + tracker.output)}\n` +
+            `${DIM}${Object.keys(COMANDOS).length} comandos: ${comandos}${RESET}\n`);
+    };
+    const lineaDeEstado = cabecera; // el nombre que ya usan los tests
+    // El rl y la consola se crean ANTES de la cabecera: si la carpeta no es un proyecto
+    // XOne, la oferta de crearlo se pregunta aquí mismo, y para preguntar hace falta
+    // el `preguntar` de la consola (que comparte este rl con el lazo de líneas).
+    const rl = crearRl();
+    const consola = {
+        // Envuelto para que pinte la barra de estado y el prompt antes de cada línea. Ver
+        // `conPrompt`: `readline` no pinta el prompt solo al iterarlo como AsyncIterable.
+        lineas: conPrompt(rl, escribir, barraDeEstado),
+        escribir: (t) => {
+            escribir(t);
+            // La línea de estado se reimprime tras /nuevo y /modelo (los DOS, no
+            // /modelo-rapido/-trabajo/-afilado: así lo pide la tarea). Ambos manejadores
+            // escriben su resultado en UNA sola llamada a escribir, así que basta con anclar
+            // al principio de esa cadena exacta:
+            //   "modelo (los tres papeles): <p>/<m>\n"   → /modelo
+            //   "hilo nuevo: <id>\n"                     → /nuevo
+            const comoModelo = /^modelo \(los tres papeles\): (.+)\n$/.exec(t);
+            if (comoModelo) {
+                modeloTrabajo = comoModelo[1];
+                escribir(lineaDeEstado());
+            }
+            else if (/^hilo nuevo: /.test(t)) {
+                escribir(lineaDeEstado());
+            }
+        },
+        preguntar: crearPreguntar(rl),
+        interactivo,
+        leerSecreto: crearLeerSecreto(rl),
+    };
+    // El asistente de creación: la única escritura fuera de un turno del agente, y
+    // por eso la única que pregunta ANTES de escribir. Si se crea, la carpeta ya ES
+    // un proyecto XOne y `entorno` se re-inspecciona; si no, la consola sigue viva
+    // para /config, /doctor o lo que haga falta (el control del primer turno de
+    // prosa sigue ahí como red de seguridad).
+    if (!entorno.esProyectoXone) {
+        consola.escribir(`✗ ${basename(raiz)} no es un proyecto XOne (falta app.xml)\n`);
+        if (interactivo && (await ofrecerCrearProyecto(raiz, consola))) {
+            entorno = await inspeccionarProyecto(raiz);
+        }
+    }
+    escribir(cabecera());
+    // Mismo patrón de prefijo que run.ts y el manejador /nuevo de consola.ts.
+    const estado = { hilo: `xonecode-${randomUUID()}`, raiz, fuentes };
+    // `--guion` conserva el agente de pega (el valor por omisión de `correrConsola`): es lo
+    // que permite ver la consola correr sin gastar. Sin ella, el ejecutor real corre cada
+    // línea de prosa sobre una sesión que se abre en el PRIMER turno y sobrevive a los demás.
+    const ejecutar = guion
+        ? undefined
+        : crearEjecutorReal((sesion) => {
+            tracker = sesion.tracker;
+        });
+    const codigo = await correrConsola(consola, estado, ejecutar);
+    // Siempre, tanto si se sale por /salir como por EOF: sin rl.close() el proceso queda
+    // escuchando stdin y `xonecode` no vuelve nunca a la shell.
+    rl.close();
+    return codigo;
+}
+export async function main(argv) {
+    const [comando, ...resto] = argv;
+    // Las banderas de la consola (`--guion` y las de modelo) no son subcomandos:
+    // `xonecode --guion` entra en la consola igual que `xonecode` a secas, pero con el
+    // agente de pega. `--help`/`-h` NO entran aquí: son el subcomando de ayuda de abajo.
+    // El resto de banderas (`--real`, `--json`, …) pertenecen a otros subcomandos y siguen
+    // cayendo en «no conozco el comando».
+    // `--guion` se quita del argv ANTES de extraerBanderasDeModelo: no es una bandera de
+    // modelo y no debe llegar como `resto` a ninguna parte.
+    if (!comando || comando === "--guion" || comando.startsWith("--modelo")) {
+        const guion = argv.includes("--guion");
+        // extraerBanderasDeModelo también con argv vacío, para que fuentes.entorno
+        // .XONECODE_MODELO se rellene igual que en todos los demás subcomandos: la consola
+        // no puede ser la única vía que ignora esa variable.
+        const { fuentes } = extraerBanderasDeModelo(argv.filter((a) => a !== "--guion"));
+        return entrarEnConsola(fuentes, undefined, undefined, undefined, undefined, guion);
+    }
+    if (comando === "--help" || comando === "-h") {
+        process.stdout.write(AYUDA);
+        return 0;
+    }
+    try {
+        if (comando === "run") {
+            const { fuentes, resto: sinModelo } = extraerBanderasDeModelo(resto);
+            const peticion = sinModelo.filter((a) => !a.startsWith("--")).join(" ");
+            if (!peticion) {
+                process.stderr.write("run necesita una petición: xonecode run \"...\"\n");
+                return 64; // EX_USAGE
+            }
+            const lento = sinModelo.includes("--lento");
+            const real = sinModelo.includes("--real");
+            return cmdRun({ peticion, retardoMs: lento ? 120 : 0, real, fuentes });
+        }
+        if (comando === "describe") {
+            const { fuentes } = extraerBanderasDeModelo(resto);
+            return cmdDescribe(fuentes);
+        }
+        if (comando === "config") {
+            const { fuentes, resto: sinModelo } = extraerBanderasDeModelo(resto);
+            const json = sinModelo.includes("--json");
+            return cmdConfig(fuentes, { json });
+        }
+        if (comando === "doctor") {
+            return await cmdDoctor();
+        }
+        if (comando === "verify") {
+            const ruta = resto.filter((a) => !a.startsWith("--"))[0] ?? process.cwd();
+            return await cmdVerify(ruta);
+        }
+    }
+    catch (e) {
+        // Un modelo mal escrito es un error del USUARIO, no del harness: su mensaje, sin
+        // traza, y código de uso (64). No se propaga como un fallo de software.
+        if (e instanceof ModeloMalEscrito) {
+            process.stderr.write(`${e.message}\n`);
+            return 64; // EX_USAGE
+        }
+        throw e;
+    }
+    process.stderr.write(`no conozco el comando «${comando}». xonecode --help\n`);
+    return 64;
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/markdown.js

@@ -0,0 +1,90 @@
+/**
+ * El markdown del asistente, pintado en una consola que NO repinta.
+ *
+ * Esa es la regla que gobierna todo el módulo: **lo escrito, escrito está**. Una línea
+ * solo se puede renderizar cuando su texto es definitivo, y un párrafo largo que llega
+ * en trozos solo se puede cortar por donde el corte no rompa un marcador — de ahí
+ * `puntoSeguro`. No hay reflow posible: el historial vive en el scrollback del
+ * terminal, que no es direccionable.
+ *
+ * Se pinta lo que los modelos EMITEN de verdad (medido): negritas, `código` en línea,
+ * cabeceras, viñetas y cercos ```. Lo que no empareja queda literal — inventarse un
+ * cierre sería un bug mudo delante del usuario.
+ */
+/**
+ * Los marcadores EN LÍNEA: `**negrita**` y `` `código` ``.
+ *
+ * Puro: recibe el tema y devuelve la línea lista para escribir. Con un tema sin color
+ * (pipe, CI) los tokens son cadena vacía y la salida queda limpia.
+ */
+export function renderizarInline(texto, tema) {
+    // **Sin color no se despinta el markdown.** Los marcadores son la única pista del
+    // énfasis que le queda a un pipe o a un CI que lea esta salida; quitárselos es
+    // quitarle información y no darle nada a cambio.
+    if (tema.negrita === "" && tema.mudo === "")
+        return texto;
+    return texto
+        .replace(/\*\*([^*\n]+)\*\*/g, (_, t) => `${tema.negrita}${t}${tema.reset}`)
+        .replace(/`([^`\n]+)`/g, (_, t) => `${tema.mudo}${t}${tema.reset}`);
+}
+/**
+ * Por dónde cortar un párrafo que llega en trozos y aún no ha visto su `\n`.
+ *
+ * El streaming tiene que verse (un colchón que solo se suelta al final es un `ainvoke`
+ * disfrazado), pero cortar por donde sea rompe marcadores: un `**` partido entre dos
+ * escrituras queda literal para siempre. Así que el corte es en un ESPACIO, con los
+ * pares `**` y `` ` `` CERRADOS en lo escrito. Se devuelve el ÚLTIMO corte seguro
+ * (menos escrituras), y `undefined` si no hay ninguno — entonces se espera.
+ */
+export function puntoSeguro(colchon, minimo) {
+    let corte;
+    for (let i = minimo; i <= colchon.length; i++) {
+        if (colchon[i - 1] !== " ")
+            continue;
+        const prefijo = colchon.slice(0, i);
+        if (prefijo.split("**").length % 2 !== 1)
+            continue; // una negrita abierta
+        if (prefijo.split("`").length % 2 !== 1)
+            continue; // un código abierto
+        corte = i;
+    }
+    return corte;
+}
+/** El estado de bloque que sobrevive entre líneas: solo el cerco de código. */
+export class RenderizadorDeMarkdown {
+    tema;
+    enCerco = false;
+    constructor(tema) {
+        this.tema = tema;
+    }
+    /**
+     * Una línea (o un corte de párrafo) tal como llega del flujo, SIN su `\n`.
+     *
+     * `inicioDeLinea` dice si este trozo empieza línea de verdad: una continuación de
+     * párrafo no puede ser cabecera ni viñeta, aunque empiece por «##» o «- ».
+     *
+     * **Sin color (pipe, CI), la línea sale tal cual**: no se quitan «##», ni «- » se
+     * vuelve «•», ni el cerco desaparece. Despintar el markdown sin dar nada a cambio
+     * es quitarle información a quien lee la salida.
+     */
+    linea(texto, inicioDeLinea = true) {
+        if (this.tema.negrita === "" && this.tema.mudo === "")
+            return texto;
+        if (texto.trimStart().startsWith("```")) {
+            this.enCerco = !this.enCerco;
+            return ""; // el cerco es ruido del formato: no se pinta
+        }
+        if (this.enCerco)
+            return `${this.tema.mudo}${texto}${this.tema.reset}`;
+        if (inicioDeLinea) {
+            const cabecera = /^(#{1,3})\s+(.*)$/.exec(texto.trim());
+            if (cabecera)
+                return `${this.tema.negrita}${cabecera[2]}${this.tema.reset}`;
+            const vineta = /^[-*]\s+(.*)$/.exec(texto.trim());
+            if (vineta)
+                return `• ${vineta[1]}`;
+        }
+        return renderizarInline(texto, this.tema);
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/cli/markdown.js.map

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