xonecode 0.2.0 → 0.5.0

package/dist/web/servidor/sesiones.js

@@ -0,0 +1,440 @@
+/**
+ * Las sesiones de un proyecto, en su `.xonecode/sesiones/`.
+ *
+ * Ahí y no en global porque la sesión es del proyecto, ya hay precedente
+ * (`conversation_history/` en `agent/memoriaDeProyecto.ts`), la carpeta está denegada
+ * entera al agente (`permisosDe`) y **no sube nunca** a CloudStudio — el mismo trato que
+ * `.xonecode/` recibe en todas partes de este repo.
+ *
+ * Se guardan **actos** (`core/actos.ts`), no `DomainEvent`. La distinción no es cosmética:
+ * ningún evento lleva el texto que escribió el usuario — `tool.detalle` es la única
+ * excepción, y es una lista blanca de campo de ruta, nunca prosa —, así que un fichero de
+ * eventos daría una sesión reabierta con respuestas y sin preguntas. Y por construcción no
+ * hay filtrado que hacer para cumplir «nada de diffs ni contenido de fichero»: el tipo
+ * `Acto` no tiene ningún campo que pueda llevarlos. El único sitio del sistema donde el
+ * contenido de un fichero viaja es el mensaje de aprobación
+ * (`consolaWeb.ts#aprobacionesTui`), que no es un acto y se suelta en cuanto hay decisión
+ * — nunca llega aquí.
+ *
+ * Reabrir ya NO es releer, y este fichero dejó de ser la única memoria. El hilo del agente
+ * vive en el checkpointer de SQLite del proyecto (`agent/checkpointer.ts`), indexado por el
+ * mismo id que titula estas entradas, así que una sesión reabierta continúa de verdad. Lo
+ * que sigue viviendo aquí es el TRANSCRIPT —lo que se pinta—, y son dos cosas distintas a
+ * propósito: un acto no puede llevar contenido de fichero ni argumentos de tool, y un
+ * checkpoint los lleva todos. Por eso el `.jsonl` puede viajar y el `.sqlite` no.
+ * `historica` deja de ser «se reabrió» y pasa a ser un hecho comprobado: se pregunta al
+ * checkpointer, y solo se marca si de ese hilo no queda memoria —una sesión de antes de que
+ * esto existiera, o una cuyo primer turno nunca corrió—. Fingir que la conversación continúa
+ * cuando el modelo no recuerda nada sería justo la clase de mentira muda que este repo evita
+ * (`bitacora.ts` es el mismo principio aplicado a los avisos de honestidad).
+ * `historica` no se escribe a disco — no es un campo de `EntradaIndice` ni del `.jsonl` —
+ * porque es un hecho del MOMENTO de reabrir, no del estado de la sesión: quien reabre
+ * decide en memoria cuándo el primer turno nuevo la desactiva, y persistir la marca
+ * obligaría a un segundo sitio a mantenerla sincronizada con ese momento.
+ *
+ * `indice.json` se reescribe entero (es pequeño, una entrada por sesión) con el mismo
+ * cuidado atómico que `agent/settingsEnDisco.ts#escribirAtomico` — temporal + `renameSync`,
+ * porque un `writeFileSync` a medias tras un crash dejaría corrompido el índice de TODAS
+ * las sesiones, no solo la que se estaba anotando. El `.jsonl` de una sesión, en cambio, se
+ * **anexa** (`appendFileSync`): reescribirlo entero en cada acto lo haría cuadrático en el
+ * número de actos de la sesión, y arriesgaría perder la sesión completa a un crash a mitad
+ * de escritura en vez de, como mucho, la última línea — que `reabrirSesion` ya tolera.
+ */
+import { appendFileSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { dirname, join } from "node:path";
+import { acumularTotales, consumoDeLosActos } from "../../core/actos.js";
+import { carpetaDeArtefactosDeSesion } from "../../core/artefactos.js";
+import { segmentoSeguro } from "../../core/settings.js";
+import { tituloDesde } from "../../core/textos.js";
+/** Cuántos caracteres de la primera prosa del usuario se guardan como título. */
+const LARGO_TITULO = 80;
+/**
+ * El título automático de una sesión, a partir de su primera petición.
+ *
+ * Se movió a `core/textos.ts` cuando las TAREAS necesitaron el mismo título: `core/` no
+ * puede importar de `web/`, y una segunda copia habría divergido. Se reexporta con su
+ * nombre de siempre porque `anotarActo`, en este mismo fichero, y sus tests lo usan desde
+ * aquí.
+ */
+export { tituloDesde };
+function carpetaSesiones(raiz) {
+    return join(raiz, ".xonecode", "sesiones");
+}
+function rutaIndice(raiz) {
+    return join(carpetaSesiones(raiz), "indice.json");
+}
+/** `crearSesion` genera el id con `randomUUID()`, pero `anotarActo` y `reabrirSesion` lo
+ * reciben tal cual llega del cliente por HTTP: sin esta guarda un id como `"../../.env"`
+ * compondría una ruta fuera de `sesiones/`. Misma función que usa `rutaDeWorkspace` en
+ * `core/settings.ts`, no una copia — dos copias es cómo diverge la guarda el día que una
+ * se corrija y la otra no.
+ */
+function rutaJsonl(raiz, id) {
+    return join(carpetaSesiones(raiz), `${segmentoSeguro(id, "id de sesión")}.jsonl`);
+}
+/** Una entrada que no es un objeto reconocible no cuenta: sin este filtro, un índice con
+ * basura colada (`[null]`, `[42]`) hace que `entradas.find` reviente en cuanto alguien lea
+ * `.id` de un elemento que no lo tiene.
+ */
+function esEntrada(v) {
+    return typeof v === "object" && v !== null && typeof v.id === "string";
+}
+/** Lee el índice para MOSTRARLO (`listarSesiones`); sin fichero o con JSON roto, una lista
+ * vacía — un índice no se puede reconstruir solo leyéndolo, así que fallar aquí no puede
+ * tumbar la reapertura de ninguna sesión (mismo principio que la línea corrupta del
+ * `.jsonl`, aplicado al índice). Nunca la uses como base de una ESCRITURA: ver
+ * `leerIndiceOAbortar`.
+ */
+function leerIndice(raiz) {
+    const ruta = rutaIndice(raiz);
+    if (!existsSync(ruta))
+        return [];
+    try {
+        const bruto = JSON.parse(readFileSync(ruta, "utf8"));
+        return Array.isArray(bruto) ? bruto.filter(esEntrada) : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Un índice roto (JSON que no parsea, o que no es una lista) no se puede persistir como
+ * base: usar aquí la lista vacía que devuelve `leerIndice` para un JSON roto BORRARÍA del
+ * disco todas las sesiones que el índice roto todavía nombraba — el `.jsonl` de cada
+ * sesión sigue intacto, pero sin su entrada es irrecuperable. Misma disciplina que
+ * `settingsEnDisco.ts#leerCrudoOAbortar`: la lectura que alimenta una escritura PARA sin
+ * escribir ante JSON roto, en vez de recuperar el fichero por su cuenta.
+ */
+export class IndiceDeSesionesRoto extends Error {
+}
+function leerIndiceOAbortar(raiz) {
+    const ruta = rutaIndice(raiz);
+    if (!existsSync(ruta))
+        return [];
+    let bruto;
+    try {
+        bruto = JSON.parse(readFileSync(ruta, "utf8"));
+    }
+    catch {
+        throw new IndiceDeSesionesRoto(`«${ruta}»: el JSON es inválido; no se sobrescribe. Edita el fichero a mano.`);
+    }
+    if (!Array.isArray(bruto)) {
+        throw new IndiceDeSesionesRoto(`«${ruta}»: el JSON raíz debe ser una lista; no se sobrescribe.`);
+    }
+    return bruto.filter(esEntrada);
+}
+/** Temporal + `renameSync`, igual que `settingsEnDisco.ts#escribirAtomico`: un rename es
+ * atómico y un `writeFileSync` directo no lo es, así que un crash a mitad de escritura
+ * dejaría el índice de TODAS las sesiones truncado en vez de solo la última entrada.
+ */
+function escribirIndice(raiz, entradas) {
+    const carpeta = carpetaSesiones(raiz);
+    mkdirSync(carpeta, { recursive: true });
+    const ruta = rutaIndice(raiz);
+    const temporal = join(carpeta, `.indice.json.${randomUUID()}.tmp`);
+    let descriptor;
+    try {
+        descriptor = openSync(temporal, "w");
+        writeFileSync(descriptor, JSON.stringify(entradas, null, 2) + "\n", "utf8");
+        closeSync(descriptor);
+        descriptor = undefined;
+        renameSync(temporal, ruta);
+    }
+    catch (error) {
+        if (descriptor !== undefined) {
+            try {
+                closeSync(descriptor);
+            }
+            catch {
+                // Un fallo al cerrar durante la recuperación no puede impedir borrar el temporal.
+            }
+        }
+        try {
+            unlinkSync(temporal);
+        }
+        catch {
+            // Si no llegó a crearse, no hay nada que limpiar.
+        }
+        throw error;
+    }
+}
+/** Crea una sesión nueva y devuelve su id. El id es `randomUUID()`: no compone rutas por
+ * construcción, pero pasa igualmente por `rutaJsonl` (vía `segmentoSeguro`) en cuanto se
+ * anota o se reabre — la guarda no distingue de dónde vino el id.
+ */
+/**
+ * Da de alta una sesión en el índice.
+ *
+ * El id ENTRA por parámetro desde que es también el `thread_id` del grafo
+ * (`agent/checkpointer.ts`): quien abre la consola lo decide al abrir, porque el hilo tiene
+ * que existir antes del primer turno, y esto solo escribe la entrada. Sin id se genera uno,
+ * que es lo que hacía siempre y lo que sigue valiendo para quien no tenga hilo.
+ */
+export function crearSesion(raiz, id = randomUUID(), tarea) {
+    const ahora = new Date().toISOString();
+    const entradas = leerIndiceOAbortar(raiz);
+    // La marca se escribe SOLO aquí, que es el único sitio donde se da de alta la entrada por
+    // el camino normal (`vestibulo.ts#volcar`, una vez por sesión) y donde se sabe por qué
+    // puerta se abrió. Ponerla en `anotarActo` la haría viajar en cada acto para decidir
+    // «solo si falta» en todos.
+    entradas.push({ id, titulo: "", creada: ahora, ultimoTurno: ahora, ...(tarea === undefined ? {} : { tarea }) });
+    escribirIndice(raiz, entradas);
+    return id;
+}
+/** Anexa un acto al `.jsonl` de la sesión y refresca su entrada en el índice: fija el
+ * título en el PRIMER acto `usuario` (y no se vuelve a tocar) y actualiza `ultimoTurno`
+ * en cada llamada, sea cual sea el tipo de acto.
+ *
+ * El anexado va ANTES de tocar el índice a propósito: si el índice está roto y
+ * `leerIndiceOAbortar` lanza, el acto ya quedó escrito. Un turno completo no se pierde
+ * solo porque el índice —que es prescindible, se puede reconstruir barriendo los
+ * `.jsonl`— esté corrompido.
+ */
+export function anotarActo(raiz, id, acto) {
+    const ruta = rutaJsonl(raiz, id);
+    mkdirSync(carpetaSesiones(raiz), { recursive: true });
+    appendFileSync(ruta, JSON.stringify(acto) + "\n", "utf8");
+    const ahora = new Date().toISOString();
+    const entradas = leerIndiceOAbortar(raiz);
+    let entrada = entradas.find((e) => e.id === id);
+    if (entrada === undefined) {
+        // Anotar sin haber pasado por `crearSesion` (no debería pasar por el flujo normal,
+        // pero un índice perdido o corrupto no puede tumbar la escritura del acto, que ya
+        // ocurrió arriba): se da de alta la entrada con lo que se sabe en este momento.
+        entrada = {
+            id,
+            titulo: acto.tipo === "usuario" ? tituloDesde(acto.texto) : "",
+            creada: ahora,
+            ultimoTurno: ahora,
+        };
+        entradas.push(entrada);
+    }
+    else {
+        if (entrada.titulo === "" && acto.tipo === "usuario")
+            entrada.titulo = tituloDesde(acto.texto);
+        entrada.ultimoTurno = ahora;
+    }
+    anotarConsumoDeActo(raiz, id, entrada, acto);
+    escribirIndice(raiz, entradas);
+}
+/**
+ * Suma al acumulado de una entrada lo que aporta este acto. Monótono: solo suma, nunca resta,
+ * y un acto que no trae consumo —o un `fin` de una sesión anterior a que se midiera— deja la
+ * entrada como estaba. **Un cero no se estampa**: ausente es «no consta», y escribir ceros ahí
+ * convertiría «no sé lo que gastó» en «no gastó nada».
+ *
+ * La regla que importa es qué hacer cuando la entrada TODAVÍA no trae acumulado, y no es sumar
+ * el delta: eso dejaría en el índice el gasto del ÚLTIMO turno con la forma de un total de la
+ * sesión —una sesión de 11k que hace un turno de 3k quedaría en 3k, y nadie lo notaría porque
+ * el número es plausible—. Ahí se relee el `.jsonl` —que ya lleva este acto dentro, porque el
+ * anexado va primero— y se suma la sesión entera. Es como mucho UNA lectura por sesión: en
+ * cuanto el acumulado consta, esto pasa a ser una suma de dos objetos.
+ *
+ * Se apoya en `reabrirSesion` y no en un lector propio: es el ÚNICO que sabe leer un `.jsonl`
+ * —saltando la línea trunca en vez de tumbar la lectura—, y un segundo lector sería un segundo
+ * sitio donde esa tolerancia puede dejar de estar.
+ */
+function anotarConsumoDeActo(raiz, id, entrada, acto) {
+    if (acto.tipo !== "fin" || acto.consumo === undefined)
+        return;
+    const bruto = entrada.consumo === undefined
+        ? consumoDeLosActos(reabrirSesion(raiz, id).actos)
+        : acumularTotales(entrada.consumo, acto.consumo);
+    // `consumoDeLosActos` contesta «no consta» si el `.jsonl` no tiene ningún `fin` con consumo
+    // —una sesión entera anterior a esto—, y entonces no hay nada que estampar.
+    //
+    // Y se NORMALIZA con `acumularTotales`, pase por donde pase, para que la ventana no entre:
+    // la que trae `consumoDeLosActos` es la del último turno que midió, y dentro de un acumulado
+    // sería un «ahora» congelado que alguien leería como el de hoy. El `.jsonl` la sigue
+    // teniendo, que es donde se mide.
+    if (bruto !== undefined)
+        entrada.consumo = acumularTotales(undefined, bruto);
+}
+/**
+ * SIEMBRA la marca de tarea en una sesión que ya estaba en el índice. Devuelve si la tocó.
+ *
+ * Existe por las sesiones de tarea anteriores a `EntradaIndice.tarea`: sin esto, la primera
+ * que hubo en cada proyecto se queda para siempre pintada como una conversación. La corre el
+ * corredor al arrancar, recorriendo su propia cola — o sea leyendo la autoridad sobre de
+ * quién es cada sesión, la misma que escribió el dato.
+ *
+ * **Es MONOTÓNICA, y de ahí sale que sea segura**: solo añade. No pisa una marca puesta —la
+ * del disco es la que escribió quien abrió la sesión— y no quita ninguna, así que no hay
+ * forma de que convierta una sesión de tarea en una conversación, que es el único fallo
+ * abierto posible por aquí. Correrla dos veces no hace nada la segunda.
+ *
+ * Y **no da de alta la entrada que falte**: la cola vive en `~/.xonecode/tareas` y el índice
+ * en el proyecto, así que una tarea puede nombrar una sesión que alguien borró; crearla la
+ * resucitaría en la barra apuntando a un `.jsonl` que ya no está.
+ */
+export function marcarTareaDeSesion(raiz, id, tarea) {
+    const entradas = leerIndiceOAbortar(raiz);
+    const entrada = entradas.find((e) => e.id === id);
+    if (entrada === undefined || entrada.tarea !== undefined)
+        return false;
+    entrada.tarea = tarea;
+    escribirIndice(raiz, entradas);
+    return true;
+}
+/** Cuántas sesiones rellena UNA pasada de `sembrarConsumosPendientes`. */
+export const SESIONES_A_SEMBRAR = 12;
+/** Y por encima de este tamaño no se siembra: la siembra es SÍNCRONA y corre en el bucle de
+ *  eventos, así que un `.jsonl` enorme congelaría el servidor mientras lo lee. */
+export const TOPE_DE_BYTES_DE_SIEMBRA = 4 * 1024 * 1024;
+/**
+ * Rellena el acumulado de las sesiones que ya existían antes de que se estampara. Devuelve
+ * cuántas tocó, que es lo que decide si merece la pena reanunciar el alta.
+ *
+ * Existe porque sin ella la función nace VACÍA en todas las sesiones anteriores: el índice solo
+ * aprende el gasto de una sesión cuando alguien la usa, y las que nadie vuelve a abrir se
+ * quedarían sin cifra para siempre. Esto es una siembra de PRESENTACIÓN, y no sostiene ninguna
+ * corrección: si no llega a una sesión —por el tope de número, por el de bytes o porque su
+ * `.jsonl` se fue— lo peor que pasa es que no enseñe cifra hasta su próximo turno, y entonces
+ * enseñará la BUENA (`anotarConsumoDeActo` relee cuando no hay acumulado del que partir).
+ *
+ * **Es MONOTÓNICA, como `marcarTareaDeSesion` y por el mismo motivo**: solo mira las entradas
+ * que NO traen acumulado, así que no puede pisar el de ninguna, y correrla dos veces no hace
+ * nada la segunda. Devuelve 0 la segunda vez.
+ *
+ * **Y no da de alta la entrada que falte**, tampoco como la otra: un `.jsonl` sin entrada en el
+ * índice es una sesión que alguien borró, y resucitarla la devolvería a la barra apuntando a un
+ * fichero que ya no está.
+ *
+ * Va de las MÁS RECIENTES hacia atrás porque el tope de número tiene que elegir, y lo que se
+ * mira en la barra es lo último que se hizo. **UNA sola escritura** al final y no una por
+ * entrada: el índice se reescribe entero cada vez.
+ */
+export function sembrarConsumosPendientes(raiz) {
+    const entradas = leerIndiceOAbortar(raiz);
+    const pendientes = entradas
+        .filter((e) => e.consumo === undefined)
+        // `String(...)` porque `esEntrada` solo comprueba el `id`: un índice tocado a mano puede
+        // traer aquí lo que sea, y esto no es sitio para reventar por un campo mal escrito.
+        .sort((a, b) => String(b.ultimoTurno).localeCompare(String(a.ultimoTurno)))
+        .slice(0, SESIONES_A_SEMBRAR);
+    let sembradas = 0;
+    for (const entrada of pendientes) {
+        const ruta = rutaJsonl(raiz, entrada.id);
+        try {
+            if (!existsSync(ruta) || statSync(ruta).size > TOPE_DE_BYTES_DE_SIEMBRA)
+                continue;
+        }
+        catch {
+            continue; // Un `.jsonl` que no se puede ni medir no se siembra; no es un error.
+        }
+        const total = consumoDeLosActos(reabrirSesion(raiz, entrada.id).actos);
+        if (total === undefined)
+            continue;
+        // Y se NORMALIZA con `acumularTotales` igual que el estampado, por la MISMA razón y con la
+        // misma función: `consumoDeLosActos` se queda con la ventana del último `fin` que la traiga
+        // —es su contrato, y hace falta en la piel—, así que sin esto la siembra escribía en el
+        // índice un «cuánto ocupa el historial ahora» de un turno de anteayer. Nadie lo pinta hoy
+        // (la ventana va en su propio mensaje), que es justo por lo que no se notó: una cifra muerta
+        // en disco es una cifra que alguien leerá mañana creyendo que es la de hoy.
+        entrada.consumo = acumularTotales(undefined, total);
+        sembradas++;
+    }
+    if (sembradas > 0)
+        escribirIndice(raiz, entradas);
+    return sembradas;
+}
+/**
+ * Borra una sesión: su `.jsonl` y su entrada del índice. Devuelve si había algo que borrar.
+ *
+ * El fichero va PRIMERO y el índice después, al revés que en `anotarActo` y por el mismo
+ * razonamiento invertido: aquí lo que no se puede quedar a medias es una entrada de índice
+ * apuntando a un fichero que ya no está —la sesión saldría en la barra y reventaría al
+ * abrirla—. Al revés, un `.jsonl` huérfano no lo ve nadie: la barra se pinta con el índice.
+ *
+ * Un id desconocido devuelve `false` en vez de lanzar: borrar dos veces la misma sesión —dos
+ * pestañas abiertas, un doble clic— no es un error, y lo único que hay que saber es si
+ * quedaba algo.
+ */
+export function borrarSesion(raiz, id) {
+    const ruta = rutaJsonl(raiz, id);
+    const habia = existsSync(ruta);
+    if (habia)
+        unlinkSync(ruta);
+    // Y sus artefactos, que son de esta sesión y de nadie más. Sin esto, borrar una
+    // conversación dejaría en disco los diagramas que se dibujaron en ella, invisibles desde
+    // la interfaz — el mismo agujero que dejaba su hilo del checkpointer antes de
+    // `olvidarHilo`. `force` porque la carpeta solo existe si el agente escribió algo.
+    rmSync(dirname(carpetaDeArtefactosDeSesion(raiz, id)), { recursive: true, force: true });
+    const entradas = leerIndiceOAbortar(raiz);
+    const quedan = entradas.filter((e) => e.id !== id);
+    if (quedan.length === entradas.length)
+        return habia;
+    escribirIndice(raiz, quedan);
+    return true;
+}
+/**
+ * Le pone nombre a una sesión. Devuelve si existía.
+ *
+ * Un título vacío se RECHAZA, y no es una validación de formulario: `anotarActo` fija el
+ * título en el primer acto de usuario y solo mientras esté vacío (`entrada.titulo === ""`).
+ * Dejarlo vacío devolvería la sesión al régimen automático, así que el siguiente turno la
+ * rebautizaría con la primera frase y el nombre que puso una persona desaparecería sin más.
+ * Se acota a `LARGO_TITULO` como los automáticos: la barra tiene el ancho que tiene.
+ */
+export function renombrarSesion(raiz, id, titulo) {
+    const limpio = titulo.trim().slice(0, LARGO_TITULO);
+    if (limpio === "")
+        return false;
+    const entradas = leerIndiceOAbortar(raiz);
+    const entrada = entradas.find((e) => e.id === id);
+    if (entrada === undefined)
+        return false;
+    entrada.titulo = limpio;
+    escribirIndice(raiz, entradas);
+    return true;
+}
+/**
+ * Fija —o quita, con `undefined`— el dispositivo preferido de una sesión.
+ *
+ * Devuelve si había una entrada que tocar: una sesión cuyo id todavía no existe en el índice
+ * (nace al volcar el primer acto) no se puede anotar aquí, y quien llama tiene que guardarlo
+ * en memoria hasta entonces — decirlo con un `false` es mejor que crear una entrada a medias
+ * que la barra enseñaría como una sesión vacía.
+ */
+export function elegirDispositivo(raiz, id, dispositivo) {
+    const entradas = leerIndiceOAbortar(raiz);
+    const entrada = entradas.find((e) => e.id === id);
+    if (entrada === undefined)
+        return false;
+    if (dispositivo === undefined)
+        delete entrada.dispositivo;
+    else
+        entrada.dispositivo = dispositivo;
+    escribirIndice(raiz, entradas);
+    return true;
+}
+/** El índice completo, tal cual lo enseña la lista de sesiones del proyecto. */
+export function listarSesiones(raiz) {
+    return leerIndice(raiz);
+}
+/** Relee una sesión entera. Una línea que no parsea (fichero truncado a mitad de un
+ * `appendFileSync`, por ejemplo por un crash) se SALTA en vez de tumbar la reapertura: una
+ * sesión que no se puede reabrir porque una línea se truncó es peor que una que reabre con
+ * una línea de menos.
+ */
+export function reabrirSesion(raiz, id) {
+    const ruta = rutaJsonl(raiz, id);
+    const actos = [];
+    if (existsSync(ruta)) {
+        for (const linea of readFileSync(ruta, "utf8").split("\n")) {
+            if (linea.trim() === "")
+                continue;
+            try {
+                actos.push(JSON.parse(linea));
+            }
+            catch {
+                // Línea corrupta: se salta, no se tumba la reapertura (ver comentario de cabecera).
+            }
+        }
+    }
+    // El dispositivo preferido sale del ÍNDICE y no del `.jsonl`: es un dato de la sesión, no
+    // uno de sus actos, y reabrir tiene que devolverlo o la elección se perdería al releer.
+    const dispositivo = leerIndice(raiz).find((e) => e.id === id)?.dispositivo;
+    return { id, actos, historica: true, ...(dispositivo === undefined ? {} : { dispositivo }) };
+}
+//# sourceMappingURL=sesiones.js.map

package/dist/web/servidor/sesiones.js.map

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

package/dist/web/servidor/transporte.js

@@ -0,0 +1,169 @@
+/**
+ * Las seis fases de un lanzamiento, EN ORDEN, y los cinco estados en que puede estar.
+ *
+ * **Se declaran aquí, en el cable, y no se importan de `agent/lanzamientoEnMaquina.ts`**, que es
+ * quien las recorre. El motivo es el de siempre en este fichero: el cable tiene su vocabulario
+ * CERRADO, y quien lo cierra es esta constante — la lista blanca del store del cliente y la
+ * validación del servidor se escriben contra ESTA lista, así que un valor que no esté aquí no
+ * llega a la pantalla. Importarlas ataría el contrato del cable al módulo que hoy lo cumple, y
+ * el día que ese módulo añada una fase el cable la aceptaría sin que nadie hubiera decidido si
+ * el cliente sabe pintarla.
+ *
+ * **Y por eso mismo hay un test que las ata** (`arranque.test.ts`: «las fases del cable son las
+ * que corre la máquina»): la lista de aquí no puede quedarse corta respecto de la de allí, o el
+ * recorrido se quedaría sin emitir justo la fase que alguien acaba de añadir.
+ *
+ * **`corriendo` no está en `EstadoDeLanzamiento` de la máquina, y aquí sí.** Allí el estado es un
+ * DESENLACE —cuatro formas de acabar—, porque `lanzarEnDispositivo` devuelve un resultado; aquí
+ * hay además un RECORRIDO EN VIVO, que es lo que permite que la pestaña enseñe en qué fase va
+ * en vez de un botón apagado sin explicación.
+ */
+export const FASES_DEL_LANZAMIENTO = [
+    "comprobando",
+    "empaquetando",
+    "subiendo",
+    "reiniciando",
+    "lanzando",
+    "comprobando-arranque",
+];
+export const ESTADOS_DEL_LANZAMIENTO = ["corriendo", "ok", "fallo", "cancelada", "colgada"];
+/**
+ * Una `Tarea` del índice traducida a lo que viaja. **La raíz del proyecto se queda aquí.**
+ *
+ * **Vive en este fichero, exportada, y eso es el arreglo de F1.** Era una copia de campos a
+ * mano enterrada en el cierre de `montarRutas` (`arranque.ts`), a mil líneas del tipo que
+ * traduce y dentro de algo que todos sus tests doblan — o sea el patrón de fallo que
+ * `CLAUDE.md` documenta cinco veces en esta misma tanda: «si una regla de producción se
+ * compone dentro de algo que los tests simulan, esa regla no está probada: está escrita».
+ * `veredicto` se cayó aquí y en el store del cliente sin que nada se pusiera rojo. Ahora
+ * `transporte.test.ts` recorre los campos de `Tarea` y exige decisión explícita por cada
+ * uno.
+ *
+ * Campo a campo, y también DENTRO del veredicto: un `...tarea.veredicto` dejaría pasar sin
+ * nombrar el campo que alguien le añada mañana a `VeredictoDeTarea`.
+ */
+export function filaDeTarea(t) {
+    return {
+        id: t.id,
+        // El ID, que es con lo que la interfaz filtra; el nombre va aparte, para leer. La RAÍZ
+        // no viaja: es una ruta de la máquina.
+        proyecto: t.proyecto.id,
+        proyectoNombre: t.proyecto.nombre,
+        titulo: t.titulo,
+        peticion: t.peticion,
+        encargo: t.encargo,
+        adjuntos: t.adjuntos,
+        estado: t.estado,
+        creada: t.creada,
+        ...(t.motivo === undefined ? {} : { motivo: t.motivo }),
+        ...(t.sesion === undefined ? {} : { sesion: t.sesion }),
+        ...(t.empezada === undefined ? {} : { empezada: t.empezada }),
+        ...(t.acabada === undefined ? {} : { acabada: t.acabada }),
+        ...(t.autorizadas === undefined ? {} : { autorizadas: t.autorizadas }),
+        ...(t.feedback === undefined ? {} : { feedback: t.feedback }),
+        ...(t.veredicto === undefined
+            ? {}
+            : {
+                veredicto: {
+                    veredicto: t.veredicto.veredicto,
+                    resumen: t.veredicto.resumen,
+                    ...(t.veredicto.hallazgos === undefined ? {} : { hallazgos: t.veredicto.hallazgos }),
+                    ...(t.veredicto.salvedad === undefined ? {} : { salvedad: t.veredicto.salvedad }),
+                },
+            }),
+        ...(t.terminadaAMano === undefined ? {} : { terminadaAMano: t.terminadaAMano }),
+    };
+}
+/**
+ * Las clases de mensaje que SON el transcript, y las únicas que llegan a un mirón.
+ *
+ * Lista blanca y no negra: con una negra, la clase que alguien añada mañana al cable
+ * llegaría permitida a quien mira una tarea de fondo — y por ahí ya pasan hoy el
+ * mensaje `turno` que apagaría su compositor y el `aprobacion` que es el único mensaje con
+ * contenido de fichero dentro.
+ *
+ * **`lanzable` y `lanzamiento` NO entran aquí, y es una decisión, no un olvido.** El recorrido
+ * de un lanzamiento es un suceso de la MÁQUINA y del proyecto, no un renglón de la
+ * conversación: quien mira una tarea de fondo no tiene por qué ver las fases del lanzamiento de
+ * otra consola, y meterlo en esta lista sería exactamente lo que la lista blanca existe para
+ * impedir — colar por la puerta de atrás un mensaje que nadie decidió que fuera transcript. Se
+ * quedan fuera por la misma razón por la que se quedan fuera `instalacion`, `dispositivos` y
+ * `tareas`, que tampoco son la conversación.
+ */
+const ES_DE_TRANSCRIPT = new Set(["acto", "sustitucion", "reemision"]);
+export function crearTransporte(actos) {
+    const traza = [];
+    const escuchasDeCorte = [];
+    /** Todos los clientes vivos. `Set` y no lista: conectar dos veces el MISMO sumidero
+     *  —una reconexión que se solapa con su propio cierre— no puede duplicar sus mensajes. */
+    const sumideros = new Set();
+    /**
+     * Quien MIRA sin ser cliente. Ver `Transporte.mirar`: aparte del otro conjunto porque no
+     * cuenta como humano y porque no recibe todo lo que se emite.
+     */
+    const mirones = new Set();
+    /**
+     * Hubo cliente alguna vez y todavía no se ha ido el último. Se lleva aparte del `Set`
+     * porque `conectar()` sin sumidero (los tests que no miran lo emitido) también cuenta
+     * como cliente: `eof()` mira esto, y decir que no hay nadie rechazaría sus aprobaciones.
+     */
+    let hayCliente = false;
+    return {
+        conectar(enviar) {
+            hayCliente = true;
+            if (enviar !== undefined)
+                sumideros.add(enviar);
+            return [...actos()];
+        },
+        desconectar(enviar) {
+            if (enviar !== undefined) {
+                sumideros.delete(enviar);
+                // Queda alguien mirando: no se despierta a nadie ni se corta nada. Lo que se fue
+                // es una pestaña, no la conversación.
+                if (sumideros.size > 0)
+                    return;
+            }
+            else {
+                sumideros.clear();
+                // Sin sumidero es «se van todos»: lo hace `cerrar()` y lo hace mudarse de consola.
+                // Un mirón de una consola que se abandona escribe en un socket que ya no está.
+                mirones.clear();
+            }
+            hayCliente = false;
+            for (const escucha of escuchasDeCorte)
+                escucha();
+        },
+        soltar(enviar) {
+            if (enviar === undefined)
+                sumideros.clear();
+            else
+                sumideros.delete(enviar);
+        },
+        conectado: () => hayCliente,
+        mirar(enviar) {
+            mirones.add(enviar);
+            return [...actos()];
+        },
+        dejarDeMirar(enviar) {
+            mirones.delete(enviar);
+        },
+        emitir(mensaje) {
+            if (mensaje.clase !== "aprobacion")
+                traza.push(mensaje);
+            // A TODOS los clientes vivos. Con una sola ranura, el último en conectar dejaba mudos
+            // a los anteriores sin decírselo.
+            for (const sumidero of sumideros)
+                sumidero(mensaje);
+            // Y a los mirones, solo el TRANSCRIPT. Ver `Transporte.mirar`.
+            if (!ES_DE_TRANSCRIPT.has(mensaje.clase))
+                return;
+            for (const miron of mirones)
+                miron(mensaje);
+        },
+        emitidos: () => traza,
+        alDesconectar(escucha) {
+            escuchasDeCorte.push(escucha);
+        },
+    };
+}
+//# sourceMappingURL=transporte.js.map

package/dist/web/servidor/transporte.js.map

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