@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/colaboracion/rele/rele-servidor.js

@@ -0,0 +1,197 @@
+/**
+ * Relay de sala para colaboración E2E — AG8 (streamProxy) / CO1.
+ *
+ * Referencias omp: packages/wire/src/index.ts (relay tonto) y collab-web/
+ * src/lib/{socket,codec,link}.ts (AES-256-GCM). El hallazgo CO1 pide
+ * colaboración cifrada E2E y el AG8 el sustrato de retransmisión; este
+ * servidor es el punto de encuentro de ambos: UN proceso escucha SOLO en
+ * loopback y retransmite a N suscriptores el stream de eventos de una sesión,
+ * con cada evento sellado (scrypt + AES-256-GCM, primitiva de
+ * src/core/share/cifrado.ts, nunca duplicada) bajo el token de sala.
+ *
+ * Postura de secretos:
+ * - El token de sala son 256 bits aleatorios que NUNCA van en argv, ni en
+ *   URLs, ni en logs: viaja en la cabecera `x-rele-token` y es TAMBIÉN la
+ *   clave de sellado. Quien no lo tiene ve ruido autenticado, nada más.
+ * - Sin dependencias nuevas: solo node:*.
+ *
+ * Los tres estados de la sala:
+ * - "activa": hay al menos un suscriptor recibiendo.
+ * - "sin-suscriptores": el relay vive pero nadie escucha en vivo; los
+ *   eventos publicados quedan en el anillo de replay y un cliente que
+ *   reconecte con `x-rele-desde-seq` los recupera.
+ * - "cerrada": cerrarSala(); los suscriptores terminan limpio al recibir 410.
+ */
+import { randomBytes, timingSafeEqual } from "node:crypto";
+import { createServer } from "node:http";
+import { sellar } from "../../share/cifrado.js";
+import { BufferReplay } from "../../stream-guard/replay.js";
+const CABECERA_TOKEN = "x-rele-token";
+const CABECERA_DESDE = "x-rele-desde-seq";
+/** Tamaño del anillo de replay por sala. */
+const REPLAY_MAX_EVENTOS = 200;
+/** Comparación en tiempo constante del token presentado contra el de sala. */
+function tokenCoincide(recibido, esperado) {
+    if (!recibido) {
+        return false;
+    }
+    const a = Buffer.from(esperado, "utf8");
+    const b = Buffer.from(recibido, "utf8");
+    return a.length === b.length && timingSafeEqual(a, b);
+}
+export class ReleServidor {
+    #http;
+    #suscriptores;
+    #token;
+    #abierta;
+    #puertas;
+    #historial;
+    constructor(token) {
+        this.#token = token;
+        this.#suscriptores = new Set();
+        this.#abierta = true;
+        this.#puertas = [];
+        this.#historial = new BufferReplay(REPLAY_MAX_EVENTOS);
+        this.#http = createServer((req, res) => {
+            this.#atender(req, res);
+        });
+        this.#http.listen(0, "127.0.0.1");
+    }
+    /** Levanta el relay en un puerto efímero de loopback. */
+    static async iniciar() {
+        const servidor = new ReleServidor(randomBytes(32).toString("base64url"));
+        await new Promise((resolver, rechazar) => {
+            servidor.#http.once("listening", resolver);
+            servidor.#http.once("error", rechazar);
+        });
+        return servidor;
+    }
+    /** Token de sala: clave de acceso Y de sellado. Nunca serializar ni loguear. */
+    get token() {
+        return this.#token;
+    }
+    get puerto() {
+        const direccion = this.#http.address();
+        if (direccion === null || typeof direccion === "string") {
+            throw new Error("El relay no está escuchando.");
+        }
+        return direccion.port;
+    }
+    get url() {
+        return `http://127.0.0.1:${this.puerto}`;
+    }
+    /** activa (≥1 suscriptor) / sin-suscriptores / cerrada. */
+    get estado() {
+        if (!this.#abierta) {
+            return "cerrada";
+        }
+        return this.#suscriptores.size > 0 ? "activa" : "sin-suscriptores";
+    }
+    /**
+     * Puerta determinista sobre el recuento de suscriptores: resuelve cuando
+     * hay ≥ n conectados (o exactamente 0 si n es 0), o en cuanto la sala
+     * cierra. Evita sondeos con temporizadores reales.
+     */
+    esperarSuscriptores(n) {
+        return new Promise((resolver) => {
+            this.#puertas.push({ n, abrir: resolver });
+            this.#revisarPuertas();
+        });
+    }
+    #revisarPuertas() {
+        const pendientes = [];
+        for (const puerta of this.#puertas) {
+            const cumplida = puerta.n > 0 ? this.#suscriptores.size >= puerta.n : this.#suscriptores.size === 0;
+            if (cumplida || (!this.#abierta && puerta.n > 0)) {
+                puerta.abrir();
+            }
+            else {
+                pendientes.push(puerta);
+            }
+        }
+        this.#puertas = pendientes;
+    }
+    /**
+     * Publica un evento: le asigna seq, lo guarda en el anillo de replay y se
+     * sella (scrypt+AES-256-GCM sobre el token de sala) para retransmitirlo a
+     * los suscriptores actuales. Sin suscriptores el evento ya NO se pierde:
+     * queda en el anillo y un cliente que reconecte con `x-rele-desde-seq`
+     * lo recupera.
+     */
+    publicar(eventoBase) {
+        if (!this.#abierta) {
+            throw new Error("La sala está cerrada.");
+        }
+        const evento = { ...eventoBase, seq: this.#historial.registrar(eventoBase) };
+        const trama = Buffer.from(sellar(Buffer.from(JSON.stringify(evento), "utf8"), this.#token)).toString("base64");
+        for (const res of [...this.#suscriptores]) {
+            res.write(`data:${trama}\n\n`);
+        }
+    }
+    /**
+     * Corta las conexiones de suscriptores sin cerrar la sala: simula un
+     * corte de red para que los clientes ejerciten su reconexión con backoff.
+     */
+    cortar() {
+        for (const res of [...this.#suscriptores]) {
+            res.socket?.destroy();
+            this.#suscriptores.delete(res);
+        }
+        this.#revisarPuertas();
+    }
+    /** Cierra la sala: los suscriptores conectados terminan y recibirán 410. */
+    cerrarSala() {
+        this.#abierta = false;
+        for (const res of [...this.#suscriptores]) {
+            res.end();
+            this.#suscriptores.delete(res);
+        }
+        this.#revisarPuertas();
+    }
+    /** Apaga el servidor HTTP. Idempotente tras cerrarSala. */
+    async parar() {
+        await new Promise((resolver) => {
+            this.#http.close(() => {
+                resolver();
+            });
+            this.#http.closeAllConnections();
+        });
+    }
+    #atender(req, res) {
+        if (!this.#abierta) {
+            res.writeHead(410, { "content-type": "text/plain" });
+            res.end("sala cerrada");
+            return;
+        }
+        const presentado = req.headers[CABECERA_TOKEN];
+        if (!tokenCoincide(Array.isArray(presentado) ? presentado[0] : presentado, this.#token)) {
+            res.writeHead(401, { "content-type": "text/plain" });
+            res.end("token requerido");
+            return;
+        }
+        res.writeHead(200, {
+            "content-type": "text/event-stream",
+            "cache-control": "no-store",
+            connection: "keep-alive",
+        });
+        res.write(": rele\n\n");
+        // Reconexión con replay: semántica Last-Event-ID — el cliente declara la
+        // última seq que entregó y el relay re-envía seq > esa ANTES de engancharse
+        // al vivo. El bloque es síncrono: ningún evento cae entre replay y vivo.
+        const desdeBruto = req.headers[CABECERA_DESDE];
+        const desde = Number(Array.isArray(desdeBruto) ? desdeBruto[0] : desdeBruto);
+        if (Number.isInteger(desde) && desde >= 0 && desde < this.#historial.ultimoSeq) {
+            for (const evento of this.#historial.replayDesde(desde)) {
+                const trama = Buffer.from(sellar(Buffer.from(JSON.stringify(evento), "utf8"), this.#token)).toString("base64");
+                res.write(`data:${trama}\n\n`);
+            }
+        }
+        this.#suscriptores.add(res);
+        req.on("close", () => {
+            this.#suscriptores.delete(res);
+            this.#revisarPuertas();
+        });
+        this.#revisarPuertas();
+    }
+}
+//# sourceMappingURL=rele-servidor.js.map

package/dist/core/colaboracion/rele/rele-servidor.js.map

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

package/dist/core/colaboracion/rele/suscriptor.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cliente de suscripción al relay AG8 — reconexión con backoff y replay.
+ *
+ * El cliente es la mitad E2E del par: presenta el token de sala en cabecera
+ * (NUNCA en URL ni argv), recibe tramas selladas y las abre con la MISMA
+ * primitiva scrypt+AES-256-GCM del share (src/core/share/cifrado.ts). Lo que
+ * sale del iterador son eventos ya descifrados; lo que cruza la red es
+ * ciphertext autenticado.
+ *
+ * Reconexión: un corte de red (o `ReleServidor.cortar()`) reintenta con
+ * backoff exponencial acotado. Al reconectar declara `x-rele-desde-seq` con
+ * la última secuencia entregada; el relay re-envía lo caído en el anillo y
+ * el cliente DEDUPLICA por seq (at-least-once → exactamente-once). Dos salidas
+ * limpias:
+ * - 401: token erróneo → error inmediato, SIN reintentos (reintentar una
+ *   credencial rechazada es martillear una puerta cerrada).
+ * - 410: sala cerrada → el iterador termina normalmente.
+ */
+import type { EventoRele } from "./rele-servidor.ts";
+export interface OpcionesSuscripcion {
+    /** Retraso inicial de backoff en ms (se duplica hasta el máximo). */
+    readonly retrasoBaseMs?: number;
+    /** Techo del backoff en ms. */
+    readonly retrasoMaximoMs?: number;
+}
+export interface Suscripcion extends AsyncIterable<EventoRele> {
+    /** Deja de escuchar y cierra el iterador en cuanto termine la lectura en curso. */
+    cerrar(): void;
+}
+export declare function suscribirse(url: string, token: string, opciones?: OpcionesSuscripcion): Suscripcion;
+//# sourceMappingURL=suscriptor.d.ts.map

package/dist/core/colaboracion/rele/suscriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suscriptor.d.ts","sourceRoot":"","sources":["../../../../src/core/colaboracion/rele/suscriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IACnC,qEAAqE;IACrE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa,CAAC,UAAU,CAAC;IAC7D,mFAAmF;IACnF,MAAM,IAAI,IAAI,CAAC;CACf;AAqDD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,mBAAwB,GAAG,WAAW,CA8GvG"}

package/dist/core/colaboracion/rele/suscriptor.js

@@ -0,0 +1,173 @@
+/**
+ * Cliente de suscripción al relay AG8 — reconexión con backoff y replay.
+ *
+ * El cliente es la mitad E2E del par: presenta el token de sala en cabecera
+ * (NUNCA en URL ni argv), recibe tramas selladas y las abre con la MISMA
+ * primitiva scrypt+AES-256-GCM del share (src/core/share/cifrado.ts). Lo que
+ * sale del iterador son eventos ya descifrados; lo que cruza la red es
+ * ciphertext autenticado.
+ *
+ * Reconexión: un corte de red (o `ReleServidor.cortar()`) reintenta con
+ * backoff exponencial acotado. Al reconectar declara `x-rele-desde-seq` con
+ * la última secuencia entregada; el relay re-envía lo caído en el anillo y
+ * el cliente DEDUPLICA por seq (at-least-once → exactamente-once). Dos salidas
+ * limpias:
+ * - 401: token erróneo → error inmediato, SIN reintentos (reintentar una
+ *   credencial rechazada es martillear una puerta cerrada).
+ * - 410: sala cerrada → el iterador termina normalmente.
+ */
+import { abrir, ClaveIncorrecta } from "../../share/cifrado.js";
+const RETRASO_BASE = 100;
+const RETRASO_MAXIMO = 2000;
+/** Cola mínima productor/consumidor para convertir pushes en async iteration. */
+class Cola {
+    #pendientes = [];
+    #despertar = null;
+    #terminada = false;
+    #error = null;
+    empujar(evento) {
+        this.#pendientes.push(evento);
+        this.#despertar?.();
+        this.#despertar = null;
+    }
+    terminar(error) {
+        if (error) {
+            this.#error = error;
+        }
+        this.#terminada = true;
+        this.#despertar?.();
+        this.#despertar = null;
+    }
+    get terminada() {
+        return this.#terminada;
+    }
+    async siguiente() {
+        while (this.#pendientes.length === 0 && !this.#terminada) {
+            await new Promise((resolver) => {
+                this.#despertar = resolver;
+            });
+        }
+        if (this.#pendientes.length > 0) {
+            return this.#pendientes.shift();
+        }
+        if (this.#error) {
+            throw this.#error;
+        }
+        return undefined;
+    }
+}
+function esperar(ms) {
+    return new Promise((resolver) => {
+        setTimeout(resolver, ms);
+    });
+}
+export function suscribirse(url, token, opciones = {}) {
+    const base = opciones.retrasoBaseMs ?? RETRASO_BASE;
+    const maximo = opciones.retrasoMaximoMs ?? RETRASO_MAXIMO;
+    const cola = new Cola();
+    const control = new AbortController();
+    let ultimoEntregado = 0;
+    void (async () => {
+        let espera = base;
+        while (!control.signal.aborted && !cola.terminada) {
+            try {
+                const cabeceras = { "x-rele-token": token };
+                if (ultimoEntregado > 0) {
+                    cabeceras["x-rele-desde-seq"] = String(ultimoEntregado);
+                }
+                const respuesta = await fetch(url, {
+                    headers: cabeceras,
+                    signal: control.signal,
+                });
+                if (respuesta.status === 401) {
+                    cola.terminar(new Error("Token de sala rechazado por el relay."));
+                    break;
+                }
+                if (respuesta.status === 410) {
+                    cola.terminar();
+                    break;
+                }
+                if (!respuesta.ok || !respuesta.body) {
+                    throw new Error(`El relay respondió ${respuesta.status}.`);
+                }
+                espera = base;
+                const lector = respuesta.body.getReader();
+                const decodificador = new TextDecoder();
+                let resto = "";
+                try {
+                    for (;;) {
+                        const { done, value } = await lector.read();
+                        if (done || control.signal.aborted || cola.terminada) {
+                            break;
+                        }
+                        resto += decodificador.decode(value, { stream: true });
+                        let corte = resto.indexOf("\n\n");
+                        while (corte !== -1) {
+                            const bloque = resto.slice(0, corte);
+                            resto = resto.slice(corte + 2);
+                            corte = resto.indexOf("\n\n");
+                            for (const linea of bloque.split("\n")) {
+                                if (!linea.startsWith("data:")) {
+                                    continue;
+                                }
+                                let evento;
+                                try {
+                                    const claro = Buffer.from(abrir(Buffer.from(linea.slice(5), "base64"), token)).toString("utf8");
+                                    evento = JSON.parse(claro);
+                                }
+                                catch (e) {
+                                    if (e instanceof ClaveIncorrecta) {
+                                        throw e;
+                                    }
+                                    continue;
+                                }
+                                // Dedup por seq: el replay del relay puede re-entregar eventos
+                                // ya vistos antes del corte. Sin seq (relay viejo), pasa tal cual.
+                                if (typeof evento.seq === "number") {
+                                    if (evento.seq <= ultimoEntregado) {
+                                        continue;
+                                    }
+                                    ultimoEntregado = evento.seq;
+                                }
+                                cola.empujar(evento);
+                            }
+                        }
+                    }
+                }
+                finally {
+                    lector.cancel().catch(() => { });
+                }
+            }
+            catch (e) {
+                if (control.signal.aborted || cola.terminada) {
+                    break;
+                }
+                if (e instanceof ClaveIncorrecta) {
+                    cola.terminar(new Error("Una trama del relay no abre con el token de sala."));
+                    break;
+                }
+            }
+            if (control.signal.aborted || cola.terminada) {
+                break;
+            }
+            await esperar(espera);
+            espera = Math.min(espera * 2, maximo);
+        }
+        if (!cola.terminada) {
+            cola.terminar();
+        }
+    })();
+    return {
+        [Symbol.asyncIterator]() {
+            return {
+                next: () => cola
+                    .siguiente()
+                    .then((v) => (v === undefined ? { value: v, done: true } : { value: v, done: false })),
+            };
+        },
+        cerrar() {
+            control.abort();
+        },
+    };
+}
+//# sourceMappingURL=suscriptor.js.map

package/dist/core/colaboracion/rele/suscriptor.js.map

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

package/dist/core/colaboracion/sesion-colaborativa.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Sesión colaborativa E2E local — CO1 (Fase 4), versión mínima sin red.
+ *
+ * Referencia omp: collab-web/src/lib/{socket,codec,link}.ts (relay WebSocket +
+ * AES-256-GCM). El hallazgo CO1 pide colaboración en vivo cifrada; la pieza
+ * que se adelanta aquí es el sustrato sobre el que todo lo demás cuelga: DOS
+ * agentes (dos instancias independientes) escriben al MISMO journal arbolado
+ * (src/core/sesion/journal-tree.ts, reusado tal cual) sin pisarse.
+ *
+ * Por qué no hay relay ni cifrado todavía: el árbol de journal ya resuelve el
+ * problema duro del merge — dos ramas hermanas bajo el mismo padre son
+ * válidas por construcción, así que "sin pisarse" no necesita locks sino ids
+ * únicos por agente. El cifrado E2E y el relay llegan con AG8 (streamProxy);
+ * cuando aterricen, esta clase es la unidad que sincroniza.
+ *
+ * Contrato:
+ * - Cada agente tiene SU instancia, apuntando al mismo fichero JSONL en disco.
+ * - appendAgente genera ids con prefijo del agente + sufijo aleatorio: nunca
+ *   colisionan ni entre procesos ni tras reinicios.
+ * - sincronizar() fusiona lo que haya en disco con lo local (unión por id,
+ *   reconstrucción padres-primero) y republica el fichero atómicamente
+ *   (saveAtomic de JournalTree: temp + fsync + rename).
+ * - La fusión NUNCA pierde entradas de ningún lado: es unión, no
+ *   last-writer-wins.
+ */
+import { type JournalEntry, JournalTree } from "../sesion/journal-tree.ts";
+/** Id de la entrada raíz de toda sesión colaborativa. */
+export declare const RAIZ_COLABORACION = "colaboracion-raiz";
+export interface ResultadoSincronizacion {
+    /** Entradas locales que sobrevivieron a la fusión (todas, por contrato). */
+    readonly totales: number;
+    /** Entradas traídas desde disco que no estaban en memoria. */
+    readonly traidasDeDisco: number;
+}
+export declare class SesionColaborativa {
+    #private;
+    readonly rutaFichero: string;
+    private constructor();
+    get journal(): JournalTree;
+    /**
+     * Abre (o crea) la sesión colaborativa en `dir`. Si el fichero existe,
+     * carga su árbol; si no, crea uno nuevo con la entrada raíz.
+     */
+    static abrir(dir: string, nombre?: string): SesionColaborativa;
+    /**
+     * El agente `agenteId` añade una entrada. El padre es la leaf ACTUAL del
+     * árbol local; si otro agente colgó algo del mismo padre mientras tanto,
+     * el resultado son ramas hermanas — válido por diseño del árbol, nada se
+     * pisa.
+     */
+    appendAgente(agenteId: string, type: string, data: unknown): JournalEntry;
+    /** Ids de los agentes presentes (prefijos antes de '#' de las entradas no raíz). */
+    participantes(): string[];
+    /**
+     * Fusiona el estado de disco con el local y republica atómicamente.
+     * Unión por id, reconstrucción padres-primero: si algún ciclo o padre
+     * huérfano apareciera, lanza en vez de escribir un fichero roto.
+     */
+    sincronizar(): ResultadoSincronizacion;
+}
+//# sourceMappingURL=sesion-colaborativa.d.ts.map

package/dist/core/colaboracion/sesion-colaborativa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sesion-colaborativa.d.ts","sourceRoot":"","sources":["../../../src/core/colaboracion/sesion-colaborativa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,OAAO,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE3E,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,kBAAkB;;IAG9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO;IAKP,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAuB,GAAG,kBAAkB;IAU5E;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY;IAOzE,oFAAoF;IACpF,aAAa,IAAI,MAAM,EAAE;IAUzB;;;;OAIG;IACH,WAAW,IAAI,uBAAuB;CAyCtC"}

package/dist/core/colaboracion/sesion-colaborativa.js

@@ -0,0 +1,127 @@
+/**
+ * Sesión colaborativa E2E local — CO1 (Fase 4), versión mínima sin red.
+ *
+ * Referencia omp: collab-web/src/lib/{socket,codec,link}.ts (relay WebSocket +
+ * AES-256-GCM). El hallazgo CO1 pide colaboración en vivo cifrada; la pieza
+ * que se adelanta aquí es el sustrato sobre el que todo lo demás cuelga: DOS
+ * agentes (dos instancias independientes) escriben al MISMO journal arbolado
+ * (src/core/sesion/journal-tree.ts, reusado tal cual) sin pisarse.
+ *
+ * Por qué no hay relay ni cifrado todavía: el árbol de journal ya resuelve el
+ * problema duro del merge — dos ramas hermanas bajo el mismo padre son
+ * válidas por construcción, así que "sin pisarse" no necesita locks sino ids
+ * únicos por agente. El cifrado E2E y el relay llegan con AG8 (streamProxy);
+ * cuando aterricen, esta clase es la unidad que sincroniza.
+ *
+ * Contrato:
+ * - Cada agente tiene SU instancia, apuntando al mismo fichero JSONL en disco.
+ * - appendAgente genera ids con prefijo del agente + sufijo aleatorio: nunca
+ *   colisionan ni entre procesos ni tras reinicios.
+ * - sincronizar() fusiona lo que haya en disco con lo local (unión por id,
+ *   reconstrucción padres-primero) y republica el fichero atómicamente
+ *   (saveAtomic de JournalTree: temp + fsync + rename).
+ * - La fusión NUNCA pierde entradas de ningún lado: es unión, no
+ *   last-writer-wins.
+ */
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import { join } from "node:path";
+import { JournalTree } from "../sesion/journal-tree.js";
+/** Id de la entrada raíz de toda sesión colaborativa. */
+export const RAIZ_COLABORACION = "colaboracion-raiz";
+export class SesionColaborativa {
+    #journal;
+    #contador = 0;
+    rutaFichero;
+    constructor(rutaFichero, journal) {
+        this.rutaFichero = rutaFichero;
+        this.#journal = journal;
+    }
+    get journal() {
+        return this.#journal;
+    }
+    /**
+     * Abre (o crea) la sesión colaborativa en `dir`. Si el fichero existe,
+     * carga su árbol; si no, crea uno nuevo con la entrada raíz.
+     */
+    static abrir(dir, nombre = "colaboracion.jsonl") {
+        const rutaFichero = join(dir, nombre);
+        if (!fs.existsSync(rutaFichero)) {
+            const j = new JournalTree();
+            j.append({ id: RAIZ_COLABORACION, parentId: null, type: "colaboracion-raiz", data: {} });
+            return new SesionColaborativa(rutaFichero, j);
+        }
+        return new SesionColaborativa(rutaFichero, JournalTree.loadAtomic(rutaFichero));
+    }
+    /**
+     * El agente `agenteId` añade una entrada. El padre es la leaf ACTUAL del
+     * árbol local; si otro agente colgó algo del mismo padre mientras tanto,
+     * el resultado son ramas hermanas — válido por diseño del árbol, nada se
+     * pisa.
+     */
+    appendAgente(agenteId, type, data) {
+        if (!agenteId.trim())
+            throw new Error("appendAgente: agenteId requerido");
+        const id = `${agenteId}#${++this.#contador}-${randomUUID().slice(0, 8)}`;
+        const padre = this.#journal.getLeaf()?.id ?? RAIZ_COLABORACION;
+        return this.#journal.append({ id, parentId: padre, type, data });
+    }
+    /** Ids de los agentes presentes (prefijos antes de '#' de las entradas no raíz). */
+    participantes() {
+        const out = new Set();
+        for (const e of this.#journal.entries()) {
+            if (e.id === RAIZ_COLABORACION)
+                continue;
+            const hash = e.id.indexOf("#");
+            if (hash > 0)
+                out.add(e.id.slice(0, hash));
+        }
+        return [...out].sort();
+    }
+    /**
+     * Fusiona el estado de disco con el local y republica atómicamente.
+     * Unión por id, reconstrucción padres-primero: si algún ciclo o padre
+     * huérfano apareciera, lanza en vez de escribir un fichero roto.
+     */
+    sincronizar() {
+        const disco = fs.existsSync(this.rutaFichero) ? JournalTree.loadAtomic(this.rutaFichero) : new JournalTree();
+        const porId = new Map();
+        const orden = [];
+        for (const e of this.#journal.entries()) {
+            porId.set(e.id, e);
+            orden.push(e.id);
+        }
+        let traidasDeDisco = 0;
+        for (const e of disco.entries()) {
+            if (porId.has(e.id))
+                continue;
+            porId.set(e.id, e);
+            orden.push(e.id);
+            traidasDeDisco++;
+        }
+        // Reconstrucción padres-primero (los moves pueden dejar el orden de
+        // inserción inconsistente con la jerarquía).
+        const fusionado = new JournalTree();
+        let pendientes = [...orden];
+        while (pendientes.length > 0) {
+            let progreso = false;
+            const resto = [];
+            for (const id of pendientes) {
+                const e = porId.get(id);
+                if (e.parentId !== null && !fusionado.has(e.parentId)) {
+                    resto.push(id);
+                    continue;
+                }
+                fusionado.append({ ...e });
+                progreso = true;
+            }
+            if (!progreso)
+                throw new Error("sincronizar: ciclo o padre huérfano en la fusión");
+            pendientes = resto;
+        }
+        this.#journal = fusionado;
+        fusionado.saveAtomic(this.rutaFichero);
+        return { totales: fusionado.size, traidasDeDisco };
+    }
+}
+//# sourceMappingURL=sesion-colaborativa.js.map

package/dist/core/colaboracion/sesion-colaborativa.js.map

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