xonecode 0.3.0 → 0.5.0

package/dist/agent/subagenteOpencode.js

@@ -0,0 +1,389 @@
+/**
+ * OpenCode como subagente: un turno contra `opencode acp`.
+ *
+ * **Todo lo de aquí está MEDIDO contra el binario real (opencode 1.18.27, 11-09-2026), no
+ * deducido.** De las tres superficies que ofrece —`run --format json`, el servidor HTTP de
+ * `serve`, y ACP— se usa **ACP** (Agent Client Protocol): es JSON-RPC 2.0 por línea sobre
+ * stdio, o sea el mismo molde que `subagenteCodex.ts`, y es la única de las tres que da un
+ * portón de permiso por stdio. `run` no lo tiene y `serve` es otro transporte entero.
+ *
+ * El baile: `initialize` → `session/new {cwd, mcpServers}` → `session/prompt {sessionId,
+ * prompt:[{type:"text"}]}`. Por el camino llegan `session/update` con el razonamiento, el
+ * texto, las tools y el consumo, y el agente nos hace peticiones —`session/request_permission`
+ * y las `fs/*`—.
+ *
+ * **Y da MÁS que los otros dos motores**: su petición de permiso trae la ruta y el antes y el
+ * después en el MISMO mensaje, así que no hace falta ni registro de items (Codex manda solo un
+ * `itemId`) ni parser de hunks. La traducción vive en `escrituraDeOpencode.ts`.
+ *
+ * ## Las TRES puertas por las que el proyecto podía mandar, y cómo se cierran
+ *
+ * Esto es lo que decide si esta integración se puede tener, y las tres están medidas contra un
+ * proyecto que las llevaba a la vez:
+ *
+ * 1. **Un `opencode.json` DEL PROYECTO pisa nuestra configuración.** Medido: leyó el `.env` y
+ *    soltó el secreto, corrió shell y escribió con CERO peticiones de permiso. Ese fichero
+ *    puede venir de CloudStudio — es la misma amenaza que `settingSources: ["user"]` cierra
+ *    para Claude Code.
+ * 2. **Un PLUGIN del proyecto** (`.opencode/plugin/*.ts`) **ejecuta código arbitrario** dentro
+ *    del proceso de opencode, y desde ahí engancha sus hooks. Medido con su control: sin la
+ *    variable corre; con ella, no.
+ * 3. **La configuración GLOBAL del usuario también nos pisa**, así que `OPENCODE_CONFIG` es el
+ *    eslabón débil y no se puede sostener nada encima: alguien con `edit: "allow"` en su
+ *    `~/.config` mataría la aprobación en silencio.
+ *
+ * Las tres se cierran con `OPENCODE_CONFIG_DIR` apuntando a una carpeta NUESTRA (que pasa a
+ * ser «la global», y por eso gana) más `OPENCODE_DISABLE_PROJECT_CONFIG=1`. Las credenciales
+ * del usuario siguen resolviendo: su `auth.json` vive en el directorio de DATOS y no en el de
+ * configuración, así que mudar éste no le desautentica. **`OPENCODE_CONFIG` no se usa**, a
+ * propósito: es el que pierde.
+ *
+ * ## Lo que NO se puede guardar, y está declarado
+ *
+ * **La LECTURA se guarda por PATRÓN y no por código**, que es más flojo que en Claude Code. El
+ * motivo está medido: la petición de permiso de un `kind: "read"` llega con `locations: []` y
+ * `rawInput: {}` —sin ruta—, así que no hay nada que pasarle a una guarda; la ruta solo aparece
+ * en el `tool_call_update` posterior, cuando el permiso ya se concedió. Con `edit` no pasa: ése
+ * sí trae ruta y diff. Así que queda entre los otros dos: mejor que Codex, que no puede guardar
+ * la lectura de ninguna forma, y peor que Claude Code, donde la decide `veredictoDeLectura`.
+ */
+import { spawn } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { consumoDeOpencode } from "./consumoExterno.js";
+import { decisionDeEscrituraDeOpencode } from "./escrituraDeOpencode.js";
+/** El binario. `OPENCODE_BIN` gana, igual que `CODEX_BIN` en el otro motor. */
+export function binarioDeOpencode() {
+    const puesto = process.env["OPENCODE_BIN"];
+    return puesto !== undefined && puesto.trim() !== "" ? puesto : "opencode";
+}
+/** La carpeta de configuración que gobernamos. Fuera del proyecto, a propósito. */
+export function carpetaDeConfigDeOpencode(base) {
+    return join(base ?? join(homedir(), ".xonecode"), "opencode");
+}
+/** Diez minutos, igual que Codex, y por lo mismo: un hijo colgado colgaría el turno. */
+const TOPE_MS = 10 * 60 * 1000;
+/**
+ * La configuración con la que corre el hijo. **Es pura y por eso se puede probar entera.**
+ *
+ * Lo que deniega, y por qué cada uno:
+ * - `bash`: medido, no lo deniega — **le quita la tool**: «No tengo un tool de shell en este
+ *   entorno». Es el análogo de la lista de tools denegadas del otro motor, y hace falta porque
+ *   un comando escribe el proyecto entero sin diff que mirar.
+ * - `webfetch` y `websearch`: sacan el proyecto de la máquina.
+ * - `external_directory`: escribir o leer fuera de la carpeta. Medido contra `/tmp`.
+ * - `task`: un hijo suyo sería una segunda superficie de permisos sin medir. Se abrirá cuando
+ *   se mida, no antes.
+ * - `question`: pregunta a una persona que aquí no hay.
+ * - `read`: una lista de patrones, porque su permiso no trae la ruta (ver la cabecera). Las
+ *   **vistas aplanadas entran una a una**, con su ruta, porque «es un `.xml` que tiene un
+ *   `.xne` al lado» no se puede escribir como un patrón — y si el agente las ve, edita el
+ *   fichero equivocado y el cambio se pierde en la siguiente compilación.
+ * - `edit`: `ask`, que es lo que hace que cada escritura pase por `pedirAprobacion`.
+ */
+export function configuracionDeOpencode(opciones) {
+    const negadas = {
+        "**/.env": "deny",
+        "**/.env.*": "deny",
+        "**/.git/**": "deny",
+        "**/.xonecode/**": "deny",
+    };
+    for (const vista of opciones.vistasAplanadas ?? [])
+        negadas[`**${vista}`] = "deny";
+    return `${JSON.stringify({
+        $schema: "https://opencode.ai/config.json",
+        ...(opciones.modelo === undefined ? {} : { model: opciones.modelo }),
+        permission: {
+            // El orden importa: lo permitido primero y las denegaciones después, que es como se
+            // midió que gana la regla más específica.
+            read: { "*": "allow", ...negadas },
+            edit: "ask",
+            bash: "deny",
+            webfetch: "deny",
+            websearch: "deny",
+            external_directory: "deny",
+            task: "deny",
+            question: "deny",
+        },
+    }, null, 2)}\n`;
+}
+/** ¿Está el binario? Se pregunta lanzándolo, que es la única respuesta que no miente. */
+export async function opencodeDisponible() {
+    return new Promise((resolver) => {
+        let hijo;
+        try {
+            hijo = spawn(binarioDeOpencode(), ["--version"], { stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch {
+            resolver(false);
+            return;
+        }
+        // El `error` del spawn hay que escucharlo o un binario que no existe se lleva el proceso.
+        hijo.on("error", () => resolver(false));
+        hijo.on("close", (codigo) => resolver(codigo === 0));
+    });
+}
+/** Cómo se llama aquí cada tool, para que el colapsador la agrupe con las de todos. */
+const NOMBRE_CANONICO = {
+    read: "read_file",
+    write: "write_file",
+    edit: "edit_file",
+    glob: "glob",
+    grep: "grep",
+    list: "ls",
+};
+export async function correrOpencode(peticion, opciones = {}) {
+    const carpeta = carpetaDeConfigDeOpencode(opciones.casa);
+    mkdirSync(carpeta, { recursive: true });
+    // Se REESCRIBE en cada arranque a propósito: así no puede quedarse una configuración vieja
+    // —más permisiva— de una versión anterior de xonecode.
+    writeFileSync(join(carpeta, "opencode.json"), configuracionDeOpencode({
+        vistasAplanadas: opciones.vistasAplanadas?.() ?? [],
+        ...(peticion.modelo === undefined ? {} : { modelo: peticion.modelo }),
+    }), { mode: 0o600 });
+    const hijo = spawn(binarioDeOpencode(), ["acp", "--cwd", peticion.cwd], {
+        stdio: ["pipe", "pipe", "pipe"],
+        cwd: peticion.cwd,
+        env: {
+            ...process.env,
+            OPENCODE_CONFIG_DIR: carpeta,
+            OPENCODE_DISABLE_PROJECT_CONFIG: "1",
+        },
+    });
+    return new Promise((cumplir, fallar) => {
+        let buffer = "";
+        let sesion;
+        let terminado = false;
+        let rechazadas = 0;
+        const texto = [];
+        let aprobando = 0;
+        let reloj;
+        /** Lo que cada tool iba a hacer, hasta saber si lo hizo. Se vacía al cerrarla. */
+        const enCurso = new Map();
+        const pararReloj = () => {
+            if (reloj !== undefined)
+                clearTimeout(reloj);
+            reloj = undefined;
+        };
+        const armarReloj = () => {
+            if (terminado || aprobando > 0)
+                return;
+            pararReloj();
+            reloj = setTimeout(() => acabar(new Error(`opencode no terminó en ${Math.round(TOPE_MS / 60000)} minutos`)), TOPE_MS);
+        };
+        const mandar = (objeto) => {
+            if (!terminado)
+                hijo.stdin.write(`${JSON.stringify(objeto)}\n`);
+        };
+        const acabar = (error, salida) => {
+            if (terminado)
+                return;
+            // `session/cancel` ANTES de matarlo: ACP tiene cancelación y Codex no, así que aquí sí
+            // se puede cerrar el turno del hijo en vez de dejarlo a medias.
+            if (sesion !== undefined)
+                mandar({ jsonrpc: "2.0", method: "session/cancel", params: { sessionId: sesion } });
+            terminado = true;
+            pararReloj();
+            hijo.kill();
+            if (error !== undefined)
+                fallar(error);
+            else
+                cumplir(salida ?? "");
+        };
+        armarReloj();
+        hijo.on("error", (e) => acabar(new Error(`no se pudo lanzar opencode: ${e.message}`)));
+        hijo.on("close", () => {
+            if (!terminado)
+                acabar(new Error("opencode terminó sin devolver ninguna respuesta"));
+        });
+        hijo.stdout.on("data", (trozo) => {
+            buffer += trozo.toString();
+            let corte;
+            while ((corte = buffer.indexOf("\n")) >= 0) {
+                const linea = buffer.slice(0, corte);
+                buffer = buffer.slice(corte + 1);
+                if (linea.trim() === "")
+                    continue;
+                let m;
+                try {
+                    m = JSON.parse(linea);
+                }
+                catch {
+                    // Una línea que no es JSON se descarta: el binario mezcla trazas suyas por stdout.
+                    continue;
+                }
+                atender(m);
+            }
+        });
+        /** Una petición del AGENTE hacia nosotros: lleva `id` **y** `method`. */
+        const atenderPeticion = (id, metodo, params) => {
+            if (metodo === "session/request_permission") {
+                const toolCall = params?.["toolCall"];
+                aprobando += 1;
+                pararReloj();
+                void decisionDeEscrituraDeOpencode({
+                    cwd: peticion.cwd,
+                    agente: peticion.agente,
+                    toolCall,
+                    ficheros: opciones.ficheros?.() ?? new Set(),
+                    ...(opciones.real === undefined ? {} : { real: opciones.real }),
+                    // La primera puerta es el papel del `.md`: a un agente de solo lectura no se le
+                    // pregunta a nadie, se le dice que no.
+                    ...(peticion.permitirEscritura && opciones.aprobar !== undefined ? { aprobar: opciones.aprobar } : {}),
+                })
+                    .then(({ concedida }) => {
+                    if (!concedida)
+                        rechazadas += 1;
+                    // **`always` no se manda NUNCA**: es la pre-aprobación de sesión, y lo que aquí
+                    // se autoriza es una escritura concreta con su diff delante — la misma regla que
+                    // `acceptForSession` y `grantRoot` en Codex.
+                    responderPermiso(id, concedida ? "once" : "reject");
+                }, () => {
+                    rechazadas += 1;
+                    responderPermiso(id, "reject");
+                })
+                    .finally(() => {
+                    aprobando -= 1;
+                    armarReloj();
+                });
+                return;
+            }
+            /**
+             * Lo demás que el agente puede pedirnos son las `fs/*`, y no las hacemos.
+             *
+             * **Y `fs/write_text_file` NO es la escritura, está medido**: rechazándola con un error,
+             * el fichero apareció igual. O sea que es un aviso y no un portón — creerse lo contrario
+             * habría dejado una guarda que no guarda nada. El único portón es el permiso de arriba.
+             *
+             * Un error de JSON-RPC es la forma que el propio protocolo tiene de decir «eso no lo
+             * hago», así que aquí no se aborta el turno (al contrario que en Codex, donde no había
+             * forma medida de contestar que no): medido, el hijo lo encaja y sigue.
+             */
+            mandar({ jsonrpc: "2.0", id, error: { code: -32601, message: "xonecode no implementa este método" } });
+        };
+        const responderPermiso = (id, optionId) => mandar({ jsonrpc: "2.0", id, result: { outcome: { outcome: "selected", optionId } } });
+        const atenderActualizacion = (u) => {
+            const clase = u["sessionUpdate"];
+            if (clase === "agent_message_chunk") {
+                const t = u["content"]?.text;
+                if (typeof t === "string")
+                    texto.push(t);
+                return;
+            }
+            if (clase !== "tool_call_update")
+                return;
+            const id = u["toolCallId"];
+            if (typeof id !== "string")
+                return;
+            /**
+             * **El nombre y la ruta se APUNTAN en `in_progress`, y la línea sale en `completed`.**
+             *
+             * Las dos mitades son medidas. La primera: el `completed` trae `locations: null` y la
+             * ruta metida dentro del `title`, así que los datos hay que cogerlos antes. La segunda:
+             * **una tool que acaba en `failed` NO se anuncia** — es el invariante de
+             * `core/entrelazar.ts`, «solo se cuenta lo que va a ocurrir», porque una línea que diga
+             * que el hijo leyó algo que se le denegó afirma un hecho falso. Medido en vivo: con una
+             * lectura de `.env` denegada por patrón salía «lee /.env», y el `.env` no se leyó.
+             *
+             * De aquí sale un evento `tool` NORMAL, con el nombre canónico y la ruta VIRTUAL, para
+             * que el colapsador lo agrupe con los demás y ninguna piel sepa que hay dos orígenes.
+             */
+            if (u["status"] === "in_progress") {
+                const titulo = typeof u["title"] === "string" ? u["title"] : "";
+                const nombre = NOMBRE_CANONICO[titulo] ?? titulo;
+                if (nombre === "")
+                    return;
+                const sitios = u["locations"];
+                const cruda = Array.isArray(sitios) ? sitios[0]?.path : undefined;
+                const detalle = typeof cruda === "string" && cruda.startsWith(peticion.cwd)
+                    ? cruda.slice(peticion.cwd.length) || "/"
+                    : undefined;
+                enCurso.set(id, { nombre, ...(detalle === undefined ? {} : { detalle }) });
+                return;
+            }
+            const apuntada = enCurso.get(id);
+            if (apuntada === undefined)
+                return;
+            enCurso.delete(id);
+            if (u["status"] === "completed")
+                opciones.alUsarTool?.(apuntada);
+        };
+        const atender = (m) => {
+            if (m.id !== undefined && m.method !== undefined) {
+                atenderPeticion(m.id, m.method, m.params);
+                return;
+            }
+            if (m.id === 1 && m.result !== undefined) {
+                mandar({ jsonrpc: "2.0", id: 2, method: "session/new", params: { cwd: peticion.cwd, mcpServers: [] } });
+                return;
+            }
+            if (m.id === 2) {
+                sesion = m.result?.sessionId;
+                if (sesion === undefined) {
+                    acabar(new Error("opencode abrió la sesión sin devolver su id"));
+                    return;
+                }
+                mandar({
+                    jsonrpc: "2.0",
+                    id: 3,
+                    method: "session/prompt",
+                    params: {
+                        sessionId: sesion,
+                        // Las instrucciones van DELANTE de la tarea en el mismo turno: ACP no expone un
+                        // prompt de sistema por sesión, igual que el app-server de Codex.
+                        prompt: [
+                            { type: "text", text: peticion.instrucciones },
+                            { type: "text", text: peticion.tarea },
+                        ],
+                    },
+                });
+                return;
+            }
+            if (m.id === 3) {
+                if (m.error !== undefined) {
+                    acabar(new Error(`opencode: ${m.error.message ?? "error sin mensaje"}`));
+                    return;
+                }
+                const consumo = consumoDeOpencode(m.result?.usage);
+                if (consumo !== undefined)
+                    opciones.alConsumir?.(consumo);
+                acabar(undefined, respuestaFinal());
+                return;
+            }
+            if (m.method === "session/update") {
+                const u = m.params?.update;
+                if (u !== undefined)
+                    atenderActualizacion(u);
+            }
+        };
+        /**
+         * Lo que se devuelve como respuesta del especialista.
+         *
+         * **Una respuesta vacía tras un rechazo no es un fallo, y tampoco es silencio**: medido,
+         * al rechazar una escritura el turno acaba bien (`stopReason: end_turn`) y a veces sin una
+         * sola palabra. Devolver `""` la haría pasar por «el especialista no tenía nada que
+         * decir», y lanzar tumbaría un turno que fue correcto. Así que se dice lo que pasó, con
+         * voz del harness y sin ponerle palabras al agente.
+         */
+        const respuestaFinal = () => {
+            const dicho = texto.join("").trim();
+            if (dicho !== "")
+                return dicho;
+            return rechazadas > 0
+                ? `(opencode terminó sin decir nada; se le rechazaron ${rechazadas} escritura(s))`
+                : "(opencode terminó sin decir nada)";
+        };
+        mandar({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: {
+                protocolVersion: 1,
+                // Las dos en `false` y a propósito: no servimos el sistema de ficheros del cliente.
+                clientCapabilities: { fs: { readTextFile: false, writeTextFile: false } },
+            },
+        });
+    });
+}
+//# sourceMappingURL=subagenteOpencode.js.map

package/dist/agent/subagenteOpencode.js.map

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

package/dist/agent/subida.js

@@ -0,0 +1,202 @@
+/**
+ * La subida: del plan a las llamadas MCP, y de ahí a la ref y al registro.
+ *
+ * **Una sola rama**: se sube a la MISMA rama de la que se bajó el proyecto (`config.rama`).
+ * Hubo una rama de trabajo (`xonecode/<origen>`) para no escribir en la rama que el cliente
+ * tuviera abierta en Studio, y el precio era que lo subido vivía en un sitio que nadie mira
+ * mientras la rama del proyecto se quedaba quieta. Se sigue creando la rama si no existe
+ * —un proyecto cuyo `config.rama` nombra una rama que aún no está en el servidor—, pero con
+ * su propio nombre.
+ *
+ * Dos propiedades que no son negociables:
+ * - La ref se mueve SOLO si todo terminó. Con fallos parciales se queda donde estaba, así
+ *   que el siguiente `/sync` vuelve a calcular el plan ENTERO contra esa misma ref sin
+ *   mover —no solo lo que falló— y lo reenvía completo, incluidas las operaciones que la
+ *   vez anterior SÍ funcionaron. Eso NO es «idempotente por construcción»: es seguro
+ *   únicamente si escribir/borrar dos veces la misma ruta en CloudStudio no tiene efecto
+ *   observable la segunda vez. Esta función no lo garantiza ni lo comprueba, solo lo
+ *   asume del servidor.
+ * - La rama activa del servidor se restaura al terminar (incluso si falló al posicionar
+ *   la rama, antes de tocar un solo fichero): `switch` le mueve el suelo a quien tenga
+ *   Studio abierto en el navegador.
+ */
+import { appendFileSync, mkdirSync, readFileSync, statSync, existsSync, readdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { planDeSubida } from "../core/planDeSubida.js";
+import { NOMBRE_CARPETA } from "./configEnDisco.js";
+import { cambiosPendientes, marcarSubido } from "./gitSync.js";
+import { rutaSyncJson } from "./descarga.js";
+export function rutaSyncLog(raiz) {
+    return join(raiz, NOMBRE_CARPETA, "cloudstudio", "sync.log");
+}
+/** Los `.xne` presentes en local: con ellos se reconocen las vistas aplanadas. */
+function fuentesXne(raiz) {
+    const salida = new Set();
+    const recorrer = (dir, prefijo) => {
+        for (const entrada of readdirSync(dir, { withFileTypes: true })) {
+            if (entrada.name === ".git" || entrada.name === NOMBRE_CARPETA)
+                continue;
+            const relativa = prefijo === "" ? entrada.name : `${prefijo}/${entrada.name}`;
+            if (entrada.isDirectory())
+                recorrer(join(dir, entrada.name), relativa);
+            else if (entrada.name.endsWith(".xne"))
+                salida.add(relativa);
+        }
+    };
+    recorrer(raiz, "");
+    return salida;
+}
+/**
+ * Lo que la descarga trajo DE VERDAD, según `sync.json` — **y solo si ese `sync.json` es
+ * de ESTE proyecto y de ESTA rama**.
+ *
+ * `descargados` es la única pata del candado de borrado que puede MENTIR: el manifiesto y
+ * el diff se calculan en el momento, pero esto es un fichero en disco que sobrevive a
+ * cambios de configuración. Un `/connect-studio` a otro proyecto, o un cambio de rama
+ * origen, deja el `sync.json` de la descarga ANTERIOR ahí quieto; sus rutas afirmarían
+ * «esto lo bajamos» sobre un proyecto en el que nunca entramos, y con eso el candado
+ * autorizaría borrados en el Studio del cliente equivocado.
+ *
+ * `EstadoDeSync` ya guarda proyecto y rama: se comparan, y si no casan se cae a conjunto
+ * vacío —que prohíbe TODO borrado— en vez de a uno inventado. Fail-closed, como el resto.
+ */
+function descargadosDe(raiz, proyecto, rama, informar) {
+    const ruta = rutaSyncJson(raiz);
+    if (!existsSync(ruta))
+        return new Set();
+    try {
+        const estado = JSON.parse(readFileSync(ruta, "utf8"));
+        if (estado.proyecto?.id !== proyecto.id || estado.rama !== rama) {
+            informar("el sync.json en disco no es de este proyecto/rama: no se borrará nada en Studio " +
+                "hasta que vuelvas a bajar con /sync bajar\n");
+            return new Set();
+        }
+        return new Set(estado.descargados ?? []);
+    }
+    catch {
+        // Sin manifiesto legible no se puede afirmar qué se bajó, y sin eso el candado no
+        // existe: mejor un conjunto vacío (que prohíbe TODO borrado) que uno inventado.
+        return new Set();
+    }
+}
+export async function subir(opciones) {
+    const { puerto, raiz, ramaOrigen, proyecto, politicaDeAprobacion, informar = () => { } } = opciones;
+    const cambios = await cambiosPendientes(raiz, ramaOrigen);
+    const tamanos = new Map();
+    for (const cambio of cambios) {
+        const ruta = join(raiz, cambio.ruta);
+        if (existsSync(ruta))
+            tamanos.set(cambio.ruta, statSync(ruta).size);
+    }
+    const { operaciones: plan, omitidas } = planDeSubida({
+        cambios,
+        descargados: descargadosDe(raiz, proyecto, ramaOrigen, informar),
+        tamanos,
+        fuentesXne: fuentesXne(raiz),
+    });
+    const informe = { ok: [], fallos: [], omitidas };
+    // El log es «una línea por OPERACIÓN de sync» (criterio de aceptación), no una línea
+    // por fichero movido: un `/sync` sin nada pendiente también es una operación y queda
+    // registrado, o el JSONL mentiría por omisión sobre cuántas veces se sincronizó.
+    // `error` es el fallo ESTRUCTURAL (posicionar la rama, abrir el proyecto) que impide
+    // intentar el plan siquiera — el otro camino, un fichero suelto que falla, ya vive en
+    // `fallos` y no necesita este campo.
+    const registrar = (error) => {
+        const linea = JSON.stringify({
+            fecha: new Date().toISOString(),
+            dir: "subida",
+            proyecto: proyecto.nombre,
+            rama: ramaOrigen,
+            ok: informe.ok,
+            fallos: informe.fallos,
+            // Lo IMPOSIBLE queda por escrito igual que lo fallido: el usuario tiene que poder
+            // volver mañana y saber qué se quedó sin subir y por qué, no solo verlo pasar.
+            omitidas: informe.omitidas,
+            ...(error === undefined ? {} : { error }),
+        });
+        const log = rutaSyncLog(raiz);
+        mkdirSync(dirname(log), { recursive: true });
+        appendFileSync(log, `${linea}\n`);
+    };
+    // Las omisiones se dicen SIEMPRE, y antes de pedir autorización: quien autoriza tiene
+    // que ver también lo que NO se va a hacer. Y se dicen aunque el plan quede vacío, que
+    // es justo el caso en que callarlas haría creer que no había nada pendiente.
+    for (const omitida of omitidas)
+        informar(`no se sube «${omitida.ruta}»: ${omitida.motivo}\n`);
+    if (plan.length === 0) {
+        if (omitidas.length === 0)
+            informar("no hay nada que subir\n");
+        // La ref NO se mueve aquí: no se ha escrito nada en CloudStudio, y una ref que dice
+        // «esto ya está arriba» sin haber subido nada es exactamente la clase de mentira que
+        // se corrige en otra parte de esta misma ola. Lo omitido se vuelve a declarar en cada
+        // `/sync` mientras siga en el diff, que es la verdad: sigue sin sincronizar. Cuando
+        // haya OTRAS operaciones, la ref avanzará con ellas y arrastrará también lo omitido
+        // —por eso queda además escrito en `sync.log`, que sí sobrevive al turno—.
+        registrar();
+        return informe;
+    }
+    // La política decide ANTES de tocar el puerto: ni `abrir` ni `contexto` ni una sola
+    // escritura corren sin su autorización. Que no autorice deja el disco, el puerto y la
+    // ref exactamente como estaban — sea cual sea la política que haya detrás.
+    if (!(await politicaDeAprobacion(plan))) {
+        informar("subida cancelada: no se ha aplicado nada\n");
+        registrar();
+        return informe;
+    }
+    await puerto.abrir(proyecto.nombre);
+    const antes = await puerto.contexto();
+    try {
+        try {
+            // Posicionarse en la rama del PROYECTO. Aquí hubo un `crearRama` perezoso para la
+            // rama de trabajo —que no existía hasta la primera subida—, y sin rama de trabajo no
+            // tiene qué crear: `config.rama` salió de la lista de ramas del servidor en el alta,
+            // así que existir existe. Si alguien la borró en Studio desde entonces, el `switch`
+            // falla, queda en `sync.log` y se relanza: inventarse una rama desde sí misma no
+            // arreglaría nada y firmaría un linaje falso.
+            await puerto.cambiarRama(ramaOrigen);
+            for (const operacion of plan) {
+                try {
+                    if (operacion.tipo === "borrado")
+                        await puerto.borrarTexto(operacion.ruta);
+                    else if (operacion.tipo === "texto") {
+                        await puerto.escribirTexto(operacion.ruta, readFileSync(join(raiz, operacion.ruta), "utf8"));
+                    }
+                    else {
+                        await puerto.subirBinario(operacion.ruta, readFileSync(join(raiz, operacion.ruta)));
+                    }
+                    informe.ok.push(operacion.ruta);
+                }
+                catch (error) {
+                    informe.fallos.push({ ruta: operacion.ruta, motivo: error.message });
+                }
+            }
+        }
+        finally {
+            // La rama que estaba de VERDAD, no la que suponíamos: por eso se lee `contexto`
+            // antes. Este `finally` corre TAMBIÉN si `cambiarRama` revienta antes
+            // de llegar al plan — es precisamente el camino para el que existe: un fallo
+            // posicionando la rama no puede dejar el suelo movido bajo quien tenga Studio
+            // abierto en el navegador.
+            await puerto.cambiarRama(antes.rama);
+        }
+    }
+    catch (error) {
+        // No se pudo ni intentar el plan (crear/cambiar de rama falló): se registra el
+        // intento —es la clase de fallo, de red o servidor, para la que existe el log— y
+        // se relanza, porque a diferencia de un fichero suelto que falla, aquí no hay
+        // informe de fallos por ruta que devolver: la sesión de subida ni llegó a empezar.
+        registrar(error.message);
+        throw error;
+    }
+    if (informe.fallos.length === 0) {
+        await marcarSubido(raiz, ramaOrigen, `sync: ${informe.ok.length} ficheros a ${ramaOrigen}`);
+    }
+    else {
+        // La ref no se mueve: el siguiente `/sync` recalcula el plan entero desde ahí y lo
+        // reenvía completo, incluido lo que sí subió esta vez (ver la nota de cabecera).
+        informar(`${informe.fallos.length} ficheros no subieron; la ref no se mueve y el próximo /sync reintenta\n`);
+    }
+    registrar();
+    return informe;
+}
+//# sourceMappingURL=subida.js.map

package/dist/agent/subida.js.map

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