xonecode 0.3.0 → 0.5.0

package/dist/core/settings.js

@@ -0,0 +1,246 @@
+/**
+ * Los settings GLOBALES: los entornos de CloudStudio que el usuario registra, y dónde se
+ * crean las copias locales.
+ *
+ * Un **entorno es un servidor CloudStudio**: hoy los dos oficiales, mañana el on-premise
+ * de un cliente. Vive en global y no en el proyecto porque un entorno sirve a muchos
+ * proyectos; el proyecto solo guarda a cuál pertenece.
+ *
+ * TypeScript puro: ni disco ni red. El disco lo pone `agent/settingsEnDisco.ts`, igual
+ * que `core/config.ts` deja el I/O a `agent/configEnDisco.ts` y `agent/authEnDisco.ts`.
+ */
+import { posix } from "node:path";
+import { CLAVES_DENEGADAS } from "./config.js";
+/**
+ * Las cuatro clases de destino en que se prueba una app XOne. No son cuatro herramientas
+ * —`adb` sirve a la vez a los Android físicos y a los emuladores arrancados— sino las
+ * cuatro cosas distintas que una persona quiere mirar o dejar de mirar.
+ */
+export const PLATAFORMAS_DE_DISPOSITIVO = ["android", "androidEmulador", "ios", "iosSimulador"];
+/** ¿Se mira este destino? Ausente = sí. */
+export function seMira(ajustes, plataforma) {
+    return ajustes?.[plataforma] !== false;
+}
+/**
+ * Tope máximo del selector de concurrencia de tareas en Ajustes. La omisión (sin nada
+ * guardado) es `CONCURRENCIA_POR_OMISION` de `core/tareas.ts` — 2 — y vive ahí y no aquí
+ * porque ese fichero es el dueño de la planificación; este solo guarda la ELECCIÓN.
+ */
+export const TOPE_DE_CONCURRENCIA_DE_TAREAS = 8;
+/**
+ * ¿Se aplican las escrituras de este proyecto SIN pedir aprobación?
+ *
+ * Las tres condiciones son AND, y ninguna es redundante:
+ *
+ * - **Lo ha dicho el dueño de la máquina**, para esta ruta, en `settings.json`.
+ * - **El proyecto es OFFLINE de verdad**, y eso NO se le pregunta al `modo` del
+ *   `config.json`: se mira si hay un bloque `cloudstudio`. Un proyecto conectado escribe en
+ *   una copia que después sube a CloudStudio, o sea al trabajo de otras personas, y ahí la
+ *   aprobación no es una preferencia. Mirar el `modo` sería creerle a un campo que puede
+ *   venir en la misma carpeta que la marca.
+ * - **Hay alguien delante.** Auto-aprobar significa «el humano que está aquí ha decidido no
+ *   pulsar», no «no hace falta humano». Sin interactivo —`xonecode run` en CI, una tubería—
+ *   se sigue sin aplicar nada, que es lo que esos caminos hacen hoy: cambiar eso volcaría
+ *   el significado de un código de salida del contrato por un ajuste que nadie escribió
+ *   pensando en CI.
+ */
+export function seAplicaSinAprobacion(opciones) {
+    if (opciones.sinAprobacion?.[opciones.raiz] !== true)
+        return false;
+    if (opciones.cloudstudio !== undefined)
+        return false;
+    return opciones.interactivo;
+}
+/**
+ * Misma disciplina que `config.json` (`CLAVES_DENEGADAS`, reexportada de `config.ts` como
+ * fuente ÚNICA — dos listas de nombres de credencial ya divergieron una vez, medido: «key»,
+ * el campo exacto de `auth.json`, faltaba aquí), más las formas en castellano que solo
+ * hacían falta en este fichero. Comparación en minúsculas: quien escribe «apiKey» a mano
+ * también escribe «apikey».
+ */
+const CAMPOS_DE_CREDENCIAL = [
+    ...CLAVES_DENEGADAS,
+    "clave",
+    "password",
+    "contrasena",
+].map((c) => c.toLowerCase());
+function esCampoDeCredencial(campo) {
+    return CAMPOS_DE_CREDENCIAL.includes(campo.toLowerCase());
+}
+/**
+ * Un aviso «grave» que nombra el CAMPO y nunca el valor: el mensaje acaba en logs y
+ * capturas, y ahí es donde menos se quiere ver una clave.
+ */
+function avisoCredencial(campo, donde) {
+    return {
+        texto: `settings.json: el campo «${campo}»${donde} parece una clave de API y no se acepta; las claves van en ~/.xonecode/auth.json. Se descarta.`,
+        severidad: "grave",
+    };
+}
+/**
+ * Un entorno con campos de credencial se sigue cargando si el resto es válido — el campo
+ * sospechoso simplemente no se copia, como cualquier campo desconocido —, pero SIEMPRE
+ * deja un aviso: la asimetría con «entorno mal formado, se descarta en silencio» es
+ * deliberada, porque una credencial es el fallo que hay que ver y un `url` vacío no.
+ */
+function validarEntorno(candidato, avisos) {
+    if (typeof candidato !== "object" || candidato === null)
+        return undefined;
+    const e = candidato;
+    const idParaElAviso = typeof e.id === "string" && e.id !== "" ? ` (entorno «${e.id}»)` : "";
+    for (const campo of Object.keys(e)) {
+        if (esCampoDeCredencial(campo))
+            avisos.push(avisoCredencial(campo, idParaElAviso));
+    }
+    if (typeof e.id !== "string" || e.id === "")
+        return undefined;
+    if (typeof e.nombre !== "string" || e.nombre === "")
+        return undefined;
+    if (typeof e.url !== "string" || e.url === "")
+        return undefined;
+    return {
+        id: e.id,
+        nombre: e.nombre,
+        url: e.url,
+        ...(Array.isArray(e.scopes) ? { scopes: e.scopes.filter((s) => typeof s === "string") } : {}),
+        // Igual que `scopes`: si viene, se filtra a cadenas; si no, no se inventa una lista —
+        // y ahí la diferencia importa, porque `[]` significa «ninguno» y ausente «no lo he
+        // dicho».
+        ...(Array.isArray(e.proyectos) ? { proyectos: e.proyectos.filter((p) => typeof p === "string") } : {}),
+    };
+}
+/**
+ * Un entorno mal formado se DESCARTA en silencio; una credencial deja un AVISO grave y
+ * sigue. La asimetría es deliberada: un entorno roto es un dato de menos y el arranque
+ * puede seguir sin decir nada, pero una credencial en el fichero equivocado es un fallo de
+ * seguridad que tiene que verse — igual que hace `config.json` (`config.ts`, línea 112):
+ * un aviso «grave» que descarta el campo, no una excepción que tumbe el arranque. Este
+ * fichero antes lanzaba (`SettingsConCredencial`); se cambió a aviso porque `CLAUDE.md`
+ * exige que un fallo de CloudStudio no pueda tumbar el arranque de la consola.
+ */
+export function validarSettings(bruto) {
+    const avisos = [];
+    if (typeof bruto !== "object" || bruto === null || Array.isArray(bruto)) {
+        return { settings: { entornos: [] }, avisos };
+    }
+    const objeto = bruto;
+    for (const campo of Object.keys(objeto)) {
+        if (esCampoDeCredencial(campo))
+            avisos.push(avisoCredencial(campo, ""));
+    }
+    const lista = Array.isArray(objeto.entornos) ? objeto.entornos : [];
+    const entornos = [];
+    for (const candidato of lista) {
+        const entorno = validarEntorno(candidato, avisos);
+        if (entorno !== undefined)
+            entornos.push(entorno);
+    }
+    const workspace = typeof objeto.workspace === "string" ? objeto.workspace : undefined;
+    const dispositivos = validarDispositivos(objeto.dispositivos);
+    const sinAprobacion = validarSinAprobacion(objeto.sinAprobacion);
+    const concurrenciaDeTareas = validarConcurrenciaDeTareas(objeto.concurrenciaDeTareas);
+    return {
+        settings: {
+            entornos,
+            ...(workspace === undefined ? {} : { workspace }),
+            ...(dispositivos === undefined ? {} : { dispositivos }),
+            ...(sinAprobacion === undefined ? {} : { sinAprobacion }),
+            ...(concurrenciaDeTareas === undefined ? {} : { concurrenciaDeTareas }),
+        },
+        avisos,
+    };
+}
+/**
+ * Solo rutas absolutas con valor booleano `true`, y nada más.
+ *
+ * Un `false` no se guarda: significa lo mismo que no estar —pedir aprobación— y dejarlo
+ * escrito solo daría dos formas de decir que no. Un `"true"` de CADENA se descarta, por lo
+ * de siempre. Y una clave que no sea una ruta absoluta tampoco entra: la comparación de
+ * `seAplicaSinAprobacion` es exacta contra la raíz, así que una relativa no casaría nunca y
+ * quedaría en el fichero pareciendo que hace algo.
+ */
+function validarSinAprobacion(candidato) {
+    if (typeof candidato !== "object" || candidato === null || Array.isArray(candidato))
+        return undefined;
+    const salida = {};
+    for (const [ruta, valor] of Object.entries(candidato)) {
+        if (valor === true && (ruta.startsWith("/") || /^[A-Za-z]:[\\/]/.test(ruta)))
+            salida[ruta] = true;
+    }
+    return Object.keys(salida).length === 0 ? undefined : salida;
+}
+/**
+ * Solo BOOLEANOS, y solo los cuatro nombres conocidos: lo que no lo sea se descarta sin
+ * aviso, como cualquier campo desconocido. Un `"false"` de cadena NO se toma por falso —es
+ * verdadero en JavaScript, y esa es la trampa que este repo ya pagó con el `soloLectura`
+ * de un subagente y con el `compartido` de CloudStudio—; se descarta, y entonces manda la
+ * omisión, que es mirar. Un objeto sin ningún campo válido se devuelve como ausente: `{}`
+ * y «no lo he dicho» significan lo mismo aquí, mirar todo, y guardar un objeto vacío solo
+ * ensuciaría el fichero.
+ */
+function validarDispositivos(candidato) {
+    if (typeof candidato !== "object" || candidato === null)
+        return undefined;
+    const c = candidato;
+    const salida = {};
+    for (const plataforma of PLATAFORMAS_DE_DISPOSITIVO) {
+        if (typeof c[plataforma] === "boolean")
+            salida[plataforma] = c[plataforma];
+    }
+    return Object.keys(salida).length === 0 ? undefined : salida;
+}
+/**
+ * Solo un entero entre 0 y `TOPE_DE_CONCURRENCIA_DE_TAREAS`. Cero SÍ vale —es cómo se
+ * pausa la cola, una elección tan legítima como cualquier otra— así que lo que se descarta
+ * no es «cero», es lo que no tiene forma de entero en rango: una cadena, un decimal, un
+ * negativo o un número por encima del tope.
+ */
+function validarConcurrenciaDeTareas(candidato) {
+    if (typeof candidato !== "number" || !Number.isInteger(candidato))
+        return undefined;
+    if (candidato < 0 || candidato > TOPE_DE_CONCURRENCIA_DE_TAREAS)
+        return undefined;
+    return candidato;
+}
+/**
+ * Un segmento que no puede salirse de su carpeta ni inventar niveles.
+ *
+ * Exportada porque `web/servidor/sesiones.ts` necesita la misma guarda para el id de
+ * sesión, que llega del cliente y no puede componer una ruta: una segunda copia habría
+ * divergido de esta la primera vez que una se corrigiera y la otra no.
+ */
+export function segmentoSeguro(valor, que) {
+    if (valor === "" || valor === "." || valor === ".." || /[/\\]/.test(valor)) {
+        throw new Error(`«${valor}» no vale como ${que}: no puede llevar separadores ni ser «..»`);
+    }
+    return valor;
+}
+/**
+ * Dónde queda la copia local de un proyecto.
+ *
+ * La BASE es configurable (`settings.workspace`); la disposición de dentro NO, porque es
+ * lo que hace predecible encontrar una copia sin consultar un índice.
+ */
+/**
+ * ¿Esa raíz es una copia que creó xonecode, o una carpeta del usuario?
+ *
+ * De esto depende si el harness puede COMMITEAR solo al cerrar cada turno. En
+ * `<base>/<entorno>/workspace/<proyecto>` la carpeta la creó él y es suya; en la que abrió
+ * una persona —un proyecto offline, o `./bin/xonecode` dentro de su propio repo— un commit
+ * por turno sería ensuciarle el historial cada vez que habla con el agente.
+ *
+ * Compara por SEGMENTOS y no por prefijo de texto: `/casa/.xonecodeX` empieza por
+ * `/casa/.xonecode` y no tiene nada que ver. Y normaliza antes, porque una barra final o un
+ * `..` por medio hacen que dos rutas equivalentes no se parezcan como cadenas. La base a
+ * secas devuelve `false`: ahí no hay ningún proyecto, solo la carpeta que los contiene.
+ */
+export function dentroDelWorkspace(raiz, base) {
+    const normal = (r) => posix.normalize(r).replace(/\/+$/, "").split("/");
+    const dentro = normal(raiz);
+    const fuera = normal(base);
+    return dentro.length > fuera.length && fuera.every((seg, i) => dentro[i] === seg);
+}
+export function rutaDeWorkspace(base, entorno, proyecto) {
+    return posix.join(base, segmentoSeguro(entorno, "id de entorno"), "workspace", segmentoSeguro(proyecto, "nombre de proyecto"));
+}
+//# sourceMappingURL=settings.js.map

package/dist/core/settings.js.map

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

package/dist/core/tareas.js

@@ -0,0 +1,230 @@
+/**
+ * Las TAREAS en background: qué son, qué transiciones valen y cuáles pueden arrancar.
+ *
+ * `core/`, o sea datos y reglas: ni disco ni procesos. La planificación vive aquí y no en el
+ * corredor a propósito — dentro de un lazo con procesos no se puede probar, y es la parte
+ * donde una equivocación se paga con dos turnos a la vez sobre el mismo proyecto.
+ */
+import { tituloDesde } from "./textos.js";
+/** A dónde se puede ir desde cada estado. Lo que no esté aquí se rechaza al escribirlo. */
+export const TRANSICIONES = {
+    /**
+     * De `nuevo` se sale corriendo… o aparcando, y esa segunda salida es MEDIDA y no
+     * teórica: si el proyecto ya no está donde la tarea dice, la consola no se puede ni
+     * abrir, así que la tarea nunca pasa por `en-proceso`. Sin esta transición `conEstado`
+     * lanza, la tarea se queda en `nuevo` y el corredor la vuelve a elegir en la pasada que
+     * él mismo dispara al terminar con ella — un lazo caliente que se come una CPU y no dice
+     * nada, en vez de una tarjeta que explica que la carpeta se movió.
+     */
+    nuevo: ["en-proceso", "requiere-atencion"],
+    "en-proceso": ["terminada", "requiere-atencion"],
+    // Las dos salidas de una tarea aparcada: reintentar, o darla por buena a mano.
+    "requiere-atencion": ["nuevo", "terminada"],
+    terminada: [],
+};
+/**
+ * La ruta de un fichero tal como se apunta y se dice en una tarea: relativa a la raíz.
+ *
+ * Las rutas que llegan de un interrupt vienen del backend virtual del agente (`/app.xne`),
+ * así que nunca son de la máquina — pero la barra de delante las hace parecerlo, y estas
+ * cadenas acaban en el índice de tareas y en el registro que una persona lee. Vive aquí, y
+ * no en quien las escribe, porque la usan los dos extremos: el texto que se pinta en el
+ * transcript y la lista que se guarda. Dos copias de esto son dos reglas que divergen.
+ */
+export const rutaRelativaDeTarea = (ruta) => ruta.replace(/^\/+/, "");
+/** El título de una tarea: la primera frase de su petición, como el de una sesión. */
+export const tituloDeTarea = (peticion) => tituloDesde(peticion);
+/** Tope de concurrencia por omisión. Dos: una corriendo y otra avanzando sin que la máquina
+ *  se quede sin aire para lo que esté haciendo la persona delante. */
+export const CONCURRENCIA_POR_OMISION = 2;
+/**
+ * Cuántas RONDAS de aprobación admite el turno de una tarea. **Su propio tope, y no el de
+ * la persona.**
+ *
+ * `MAX_APPROVAL_ROUNDS` son cinco y se dimensionaron para alguien pulsando: «te lo he
+ * preguntado cinco veces, para». En una tarea autónoma una ronda no es una pregunta, es una
+ * TANDA de escrituras que se autorizan solas — y cinco tandas se agotan en un encargo
+ * mediano: medido, un turno de tarea acabó con cuatro ficheros escritos, una escritura
+ * abandonada y el verificador sin correr, porque cada tanda gastaba ronda.
+ *
+ * **Y no es infinito**, por el mismo argumento que el tope propio de los artefactos: cada
+ * pasada es una llamada al modelo y aquí no hay ningún humano que frene el bucle.
+ *
+ * **De dónde sale el 20, dicho como lo que es: una observación por cuatro, no un encargo
+ * grande medido.** Lo único medido es el turno que se cortó, que necesitaba cinco tandas;
+ * veinte deja sitio a un encargo bastante mayor y sigue cortando un bucle en un tiempo
+ * finito. No hay medida de un encargo de verdad grande detrás, y por eso es un número
+ * provisional que se puede afinar. Lo que lo hace aceptable mientras tanto es su MODO DE
+ * FALLO: al agotarse se dice, quedan escrituras sin aplicar, y `core/entrega.ts` no entrega
+ * — o sea que un tope corto aparca con un motivo VERDADERO en vez de dar por bueno un
+ * trabajo a medias. Un número provisional con un fallo honesto se afina luego; lo que no se
+ * puede es que al agotarse mienta.
+ */
+export const TOPE_DE_RONDAS_DE_TAREA = 20;
+/**
+ * Qué tareas pueden arrancar AHORA.
+ *
+ * Cuatro reglas, y las dos últimas son las que importan:
+ *  - **FIFO por fecha de creación**, global: predecible y explicable. Una prioridad es un
+ *    campo más que nadie ha pedido.
+ *  - **Tope de concurrencia**, contando las que ya corren.
+ *  - **Nunca dos del mismo proyecto**, ni con las que corren ni entre las elegidas en esta
+ *    misma pasada: comparten disco, índice de git, checkpointer y `sync`, y dos turnos a la
+ *    vez sobre eso es una carrera con escrituras de por medio.
+ *  - **Y GANA LA PERSONA**: ver `bloqueados`.
+ */
+export function siguientesAEjecutar(tareas, opciones) {
+    const corriendo = tareas.filter((t) => t.estado === "en-proceso");
+    const huecos = opciones.concurrencia - corriendo.length;
+    if (huecos <= 0)
+        return [];
+    const ocupados = new Set([...corriendo.map((t) => t.proyecto.raiz), ...(opciones.bloqueados ?? [])]);
+    const elegidas = [];
+    const candidatas = tareas
+        .filter((t) => t.estado === "nuevo")
+        .slice()
+        .sort((a, b) => (a.creada < b.creada ? -1 : a.creada > b.creada ? 1 : 0));
+    for (const t of candidatas) {
+        if (elegidas.length >= huecos)
+            break;
+        if (ocupados.has(t.proyecto.raiz))
+            continue;
+        ocupados.add(t.proyecto.raiz);
+        elegidas.push(t);
+    }
+    return elegidas;
+}
+/**
+ * La tarea con otro estado, o una excepción.
+ *
+ * Lanza en vez de devolver la tarea sin tocar: un estado imposible escrito en disco es más
+ * difícil de depurar que un error en el momento de escribirlo. Y `requiere-atencion` EXIGE
+ * motivo, porque una tarea aparcada sin decir por qué no es accionable — es la misma razón
+ * por la que el aviso de honestidad lleva los nombres de los ficheros y no un contador.
+ */
+export function conEstado(tarea, estado, motivo, sello = {}) {
+    if (!TRANSICIONES[tarea.estado].includes(estado)) {
+        throw new Error(`una tarea «${tarea.estado}» no puede pasar a «${estado}»`);
+    }
+    if (estado === "requiere-atencion" && (motivo ?? "").trim() === "") {
+        throw new Error("aparcar una tarea exige un motivo: sin él no es accionable");
+    }
+    const ahora = sello.ahora ?? new Date().toISOString();
+    const siguiente = { ...tarea, estado };
+    // El motivo vive SOLO en el estado que lo explica: pegado a una tarea reintentada
+    // enseñaría un problema ya resuelto.
+    if (estado === "requiere-atencion")
+        siguiente.motivo = motivo;
+    else
+        delete siguiente.motivo;
+    if (estado === "en-proceso") {
+        siguiente.empezada = ahora;
+        if (sello.pid !== undefined)
+            siguiente.pid = sello.pid;
+    }
+    else {
+        // Un pid pegado a una tarea que no corre haría creer que hay un proceso detrás.
+        delete siguiente.pid;
+    }
+    if (estado === "terminada")
+        siguiente.acabada = ahora;
+    return siguiente;
+}
+/**
+ * La tarea con lo que AUTORIZÓ, si es que se sabe.
+ *
+ * `undefined` significa «no se sabe» y entonces no se toca el campo: una tarea que ni
+ * llegó a correr un turno —su proyecto se movió— no autorizó nada, pero afirmarlo con una
+ * lista vacía sería contar como medido algo que nadie midió. Es la misma distinción que
+ * `Entorno.proyectos` y la que `detalles` de un acto guardado conserva.
+ *
+ * **Se SUMA a lo que ya hubiera, no lo sustituye.** Una tarea aparcada se reintenta
+ * (`requiere-atencion → nuevo`) y su segundo turno es otro turno: si esto reemplazara, el
+ * fichero que autorizó el primer intento desaparecería del registro **cuando muy
+ * probablemente siga escrito**, que es justo la clase de mentira que este campo evita. Y así `[]` sigue
+ * queriendo decir lo que dice: «este turno no autorizó nada» — no borra lo que autorizó el
+ * anterior. (`sesion` NO se pierde al reintentar: el corredor reabre la MISMA —Task 12,
+ * `corredorDeTareas.ts#correr`—, así que el segundo turno cae en el mismo hilo y Revisión
+ * sigue comparando contra el «antes» de la primera apertura, no contra uno a medias.)
+ *
+ * Normaliza en un solo sitio: rutas relativas (`rutaRelativaDeTarea`), sin huecos y sin
+ * repetidos — el mismo fichero escrito en dos rondas del turno, o en dos intentos, es un
+ * fichero tocado y no dos—, conservando el orden en que se aplicaron.
+ */
+export function conAutorizadas(tarea, autorizadas) {
+    if (autorizadas === undefined)
+        return tarea;
+    const vistos = new Set();
+    const limpios = [];
+    for (const cruda of [...(tarea.autorizadas ?? []), ...autorizadas]) {
+        const ruta = rutaRelativaDeTarea(cruda).trim();
+        if (ruta === "" || vistos.has(ruta))
+            continue;
+        vistos.add(ruta);
+        limpios.push(ruta);
+    }
+    return { ...tarea, autorizadas: limpios };
+}
+/**
+ * La tarea con un feedback nuevo, sin consumir, y devuelta al lazo (`requiere-atencion →
+ * nuevo`).
+ *
+ * **Rechaza el vacío, lanzando.** Un feedback en blanco devolvería la tarea al lazo sin
+ * nada nuevo que decirle: la aparcaron por una decisión que hacía falta tomar, y «nada» no
+ * es una decisión. Es el mismo argumento que rechaza un título vacío en
+ * `sesiones.ts#renombrarSesion` — no es validación de formulario, es que aceptarlo dejaría
+ * la tarea «resuelta» sin haberla resuelto, y el siguiente turno correría igual de
+ * bloqueado que este.
+ *
+ * **Solo vale desde `requiere-atencion`, y eso lo decide `conEstado` y no una comprobación
+ * aparte aquí.** Si la tarea no está aparcada, no hay pregunta que este feedback esté
+ * contestando; `conEstado` ya lanza con un motivo legible (`«nuevo» no puede pasar a
+ * «nuevo»`), y repetir esa regla en dos sitios es como acaban divergiendo.
+ *
+ * **Se SUMA a lo que ya hubiera, nunca lo sustituye** — la misma regla que
+ * `conAutorizadas`: un segundo feedback no puede borrar el primero, porque el agente ya
+ * actuó sobre lo que el primero dijo y perder el registro sería fingir que nunca se dijo.
+ * `consumido` nace en `false`: se pone en `true` cuando el corredor de verdad lo manda al
+ * turno (`corredorDeTareas.ts#correr`), no aquí — hasta entonces «no consta que se haya
+ * mandado» es la verdad.
+ */
+export function conFeedback(tarea, texto, ahora) {
+    const limpio = texto.trim();
+    if (limpio === "") {
+        throw new Error("un feedback vacío devolvería la tarea al lazo sin nada nuevo que decirle");
+    }
+    const nuevo = { texto: limpio, creado: ahora ?? new Date().toISOString(), consumido: false };
+    const feedback = [...(tarea.feedback ?? []), nuevo];
+    return conEstado({ ...tarea, feedback }, "nuevo");
+}
+/**
+ * La tarea con el veredicto del juez, si es que hay uno.
+ *
+ * `undefined` significa «no se le preguntó» y entonces no se toca el campo: se llega aquí
+ * también por los caminos que aparcan antes de llegar al juez —el proyecto que ya no está,
+ * el turno que revienta—, y escribir ahí una ausencia borraría el veredicto del intento
+ * anterior, que sigue siendo lo último que se supo del trabajo.
+ *
+ * Cuando SÍ hay veredicto, sustituye: ver `Tarea.veredicto`.
+ */
+export function conVeredicto(tarea, veredicto) {
+    if (veredicto === undefined)
+        return tarea;
+    return { ...tarea, veredicto };
+}
+/**
+ * La tarea que una PERSONA da por buena, con la marca puesta.
+ *
+ * `conEstado` borra el `motivo` a propósito («el motivo vive SOLO en el estado que lo
+ * explica»), así que después de esto no queda ni una palabra que diga que aquí no hubo ni
+ * verificador ni juez: eso es lo que guarda `terminadaAMano`, y de ahí sale lo que la
+ * tarjeta pinta. El `veredicto` que hubiera **no se toca** — la persona lo pisa, no lo
+ * desmiente, y lo que el juez dijo sigue siendo lo que hay que poder leer al lado.
+ *
+ * La transición la decide `conEstado`, que LANZA si no vale: repetir esa regla aquí es como
+ * acaban divergiendo (el mismo argumento de `conFeedback`).
+ */
+export function darPorBuenaAMano(tarea, ahora) {
+    return { ...conEstado(tarea, "terminada", undefined, ahora === undefined ? {} : { ahora }), terminadaAMano: true };
+}
+//# sourceMappingURL=tareas.js.map

package/dist/core/tareas.js.map

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

package/dist/core/textos.js

@@ -0,0 +1,36 @@
+/**
+ * El título que se le pone a una conversación o a una tarea: su primera frase, entera.
+ *
+ * Vivía en `web/servidor/sesiones.ts` y se movió aquí cuando las TAREAS necesitaron el mismo
+ * título: `core/` no puede importar de `web/`, y una segunda copia habría divergido — con el
+ * síntoma de que la misma frase diera dos títulos distintos según quién la mirara.
+ */
+/** Cuántos caracteres de la primera prosa del usuario se guardan como título. */
+const LARGO_TITULO = 80;
+/** Hasta dónde llega un título AUTOMÁTICO antes de cortarse en una palabra entera. */
+const LARGO_TITULO_AUTOMATICO = 60;
+/**
+ * El título automático de una sesión o de una tarea, a partir de su primera petición.
+ *
+ * Era `texto.slice(0, 80)` a secas, y medido en pantalla daba «Escribe literalmente esta
+ * frase, sin cambiar nada: «en XOne se usa $http para pe» — media frase con una comilla sin
+ * cerrar. Sin llamar a ningún modelo (un título no vale una petición), lo que sí se puede
+ * hacer es quedarse con la PRIMERA frase o línea, quitar la comilla de apertura si la
+ * petición empieza citando, y cortar en una palabra entera con puntos suspensivos. Sigue
+ * siendo lo que el usuario escribió, no un resumen: renombrar sigue estando en el «…».
+ */
+export function tituloDesde(texto) {
+    const primera = texto
+        .trim()
+        .split(/\r?\n/)[0]
+        .split(/(?<=[.!?:;])\s/)[0]
+        .replace(/[.!?:;]+$/u, "")
+        .replace(/^[«"“'‘¿¡\s]+/u, "")
+        .trim();
+    if (primera.length <= LARGO_TITULO_AUTOMATICO)
+        return primera.slice(0, LARGO_TITULO);
+    const corte = primera.slice(0, LARGO_TITULO_AUTOMATICO);
+    const enPalabra = corte.lastIndexOf(" ");
+    return `${(enPalabra > 20 ? corte.slice(0, enPalabra) : corte).replace(/[\s,;:]+$/u, "")}…`;
+}
+//# sourceMappingURL=textos.js.map

package/dist/core/textos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textos.js","sourceRoot":"","sources":["../../src/core/textos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iFAAiF;AACjF,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,sFAAsF;AACtF,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,KAAK;SAClB,IAAI,EAAE;SACN,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE;SAClB,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAE;SAC3B,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,IAAI,EAAE,CAAC;IACV,IAAI,OAAO,CAAC,MAAM,IAAI,uBAAuB;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,CAAC;AAC9F,CAAC"}