@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/aprobacion/politica.js

@@ -0,0 +1,375 @@
+/**
+ * Aprobación por herramienta.
+ *
+ * Antes de esto no había política ninguna: `beforeToolCall` disparaba los hooks
+ * del usuario y las extensiones, y `permissions.level` —que existe en settings
+ * desde siempre— solo lo leían los propios hooks. Ninguna tool se consultaba
+ * contra él. Es decir, el nivel de permisos no gobernaba los permisos.
+ *
+ * El orden de las comprobaciones ES la propiedad de seguridad, y por eso está
+ * escrito de arriba abajo en `decidir()` y no repartido:
+ *
+ *   1. Rutas protegidas   — denegado SIEMPRE, incluso en `yolo`, no configurable
+ *   2. Deny del usuario   — denegado SIEMPRE, incluso en `yolo`
+ *   3. Modo de la sesión  — plan / manual / auto / yolo
+ *
+ * Que 1 y 2 vayan por delante del modo es lo que hace que el argumento de
+ * cumplimiento se sostenga: una política que el propio agente puede desactivar
+ * pidiendo `yolo` no es una política, es una sugerencia.
+ *
+ * Lo desconocido cuenta como ejecución. Una tool de MCP o de una extensión que
+ * nadie ha clasificado no puede colarse por el carril de lectura por no estar
+ * en ninguna lista.
+ */
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { CONFIG_DIR_NAME } from "../../config.js";
+import { DIR_INDICE, DIR_SESION } from "../audit/rutas.js";
+import { suplantadaPor } from "../extensiones/suplantacion.js";
+import { marcaDeGenerado, motivoDeGenerado } from "./generados.js";
+import { politicaDeMaquina, recortarModo } from "./politica-de-maquina.js";
+/**
+ * Segmento `.../<CONFIG_DIR_NAME>/agent/` de CUALQUIER instalación de Ada,
+ * no solo `agentDir` (que es la de ESTE equipo).
+ *
+ * Con `--remoto` los argumentos de `read`/`write`/`bash` pueden nombrar un
+ * `auth.json` o un `vault/` que viven en OTRA máquina — el destino de SSH,
+ * el contenedor de Docker, la distro de WSL — con su propio `$HOME` y por
+ * tanto un `agentDir` que `rutaProtegida` nunca conoce. Comprobar el
+ * segmento en vez del prefijo completo protege ambos sin necesitar el
+ * `agentDir` del destino, que esta política no tiene forma de calcular.
+ */
+const SEGMENTO_AGENTE_ADA = `/${CONFIG_DIR_NAME}/agent/`;
+/** Tools que solo miran. */
+const LECTURA = new Set([
+    "read",
+    "ls",
+    "find",
+    "grep",
+    "ast_search",
+    "session_search",
+    "web_fetch",
+    "web_search",
+    "memory_search",
+    "memory_list",
+    "graph_query",
+    "ask_user_question",
+    "todo_read",
+]);
+/** Tools que cambian estado nuestro, pero no ejecutan nada del sistema. */
+const ESCRITURA = new Set([
+    "edit",
+    "write",
+    "ast_edit",
+    "memory_add",
+    "memory_replace",
+    "memory_remove",
+    "update_project_memory",
+    "scratchpad",
+    "todo",
+    "todo_write",
+    "graph_add",
+]);
+/**
+ * ¿Este nombre es de una tool NUESTRA cuyo nivel de confianza da esta política?
+ *
+ * Lo consulta el registro de extensiones para saber si `registerTool` está
+ * suplantando una builtin. `bash` va aparte porque no está en ninguna de las dos
+ * listas —lo desconocido ya es ejecución— pero suplantarlo importa igual: el
+ * usuario tiene que ver que el `bash` que corre no es el nuestro.
+ */
+export function esNombreDeToolNuestra(tool) {
+    return LECTURA.has(tool) || ESCRITURA.has(tool) || tool === "bash";
+}
+/**
+ * El nivel de una herramienta. Lo que no está clasificado es ejecución.
+ *
+ * Falla cerrado a propósito: el coste de equivocarse hacia arriba es una
+ * pregunta de más; hacia abajo, es una tool desconocida corriendo sola.
+ */
+export function nivelDe(tool) {
+    // Una builtin suplantada por una extensión NO hereda su nivel.
+    //
+    // Comprobado ejecutando: una extensión registra `read`, el loader la pone
+    // encima de la nuestra y el modelo sigue creyendo que llama a la de Ada. Con
+    // `LECTURA.has("read")` por delante, ese `read` —que puede hacer lo que
+    // quiera— se permitía siempre y en cualquier modo. Devolver "ejecucion" lo
+    // devuelve al carril de lo desconocido, que es lo que es.
+    if (suplantadaPor(tool))
+        return "ejecucion";
+    if (LECTURA.has(tool))
+        return "lectura";
+    if (ESCRITURA.has(tool))
+        return "escritura";
+    return "ejecucion";
+}
+/** Un directorio protegido aparece como segmento completo de la ruta. */
+function contieneSegmento(texto, segmento) {
+    return texto.includes(`/${segmento}/`);
+}
+/**
+ * ¿El texto nombra el directorio `dir` colgado de `base`, con barra final o sin
+ * ella?
+ *
+ * La comprobación anterior solo miraba `base/dir/`, y por ahí se colaba justo el
+ * caso peor. Comprobado ejecutando `decidir`:
+ *
+ *   rm -rf <agentDir>/vault/   -> denegada  ruta-protegida
+ *   rm -rf <agentDir>/vault    -> PERMITIDA modo-yolo
+ *
+ * Es decir, el borrado entero del vault con un comando, porque el nombre de un
+ * directorio no lleva barra al final cuando se lo pasas a `rm`. Se arregla aquí,
+ * en la comprobación compartida, y no en cada llamada: la misma trampa valía
+ * para el vault, para el libro y para cualquier directorio que se añada mañana.
+ *
+ * El caso sin barra se mide sobre el token y con el final exacto para no
+ * llevarse por delante `vault-ejemplo` ni `sesiones/`. Se recorta la puntuación
+ * de shell del final porque `rm -rf x/vault;` y `rm -rf x/vault)` son el mismo
+ * comando con otro adorno.
+ */
+function nombraDirectorio(texto, base, dir) {
+    if (texto.includes(`${base}${dir}/`))
+        return true;
+    return texto.split(/[\s"'`]+/).some((t) => t.replace(/[;,)&|>]+$/, "").endsWith(`${base}${dir}`));
+}
+/**
+ * Deja la ruta en la forma con la que se compara.
+ *
+ * Sin esto la política era papel mojado, y se descubrió EJECUTANDO el producto:
+ * el modelo escribe `~/.ada/agent/vault/…`, la tool expande la tilde por dentro
+ * y abre el fichero, mientras que la política —que solo ve los argumentos
+ * crudos— comparaba contra la ruta absoluta y no reconocía nada. El vault se
+ * leyó entero con la política activada y todas las pruebas en verde, porque
+ * todas usaban rutas absolutas.
+ *
+ * Se sustituye en TODO el texto y no solo al principio porque `bash` recibe una
+ * línea entera, donde el `~` va detrás del comando.
+ */
+function normalizar(texto, home) {
+    return texto.replaceAll("$HOME/", `${home}/`).replaceAll("~/", `${home}/`);
+}
+/**
+ * Si el texto nombra algo que no se puede tocar, devuelve por qué.
+ *
+ * Se mira el texto y no una "ruta" porque los argumentos no tienen un nombre
+ * común (`path`, `file_path`, `command`…) y porque `bash` recibe una línea de
+ * shell entera. Para `bash` esto es MEJOR ESFUERZO y hay que decirlo: quien
+ * contiene de verdad un comando es el sandbox del sistema operativo, no esta
+ * comprobación. Aquí se para lo evidente, que es lo que hace un agente
+ * despistado; lo deliberado lo para el kernel.
+ */
+function rutaProtegida(texto, agentDir, escribiendo) {
+    if (nombraDirectorio(texto, `${agentDir}/`, "vault"))
+        return "el vault cifrado";
+    // Generaliza lo de arriba a un vault de Ada en OTRA máquina (ver
+    // `SEGMENTO_AGENTE_ADA`): mismo motivo, sin depender del `agentDir` local.
+    if (nombraDirectorio(texto, SEGMENTO_AGENTE_ADA, "vault"))
+        return "el vault cifrado (de este equipo o de un destino remoto)";
+    // El libro de auditoría y su índice.
+    //
+    // Agujero real, y el más grave que hemos tenido: la política protegía el
+    // vault y el `auth.json` y dejaba al agente escribir y BORRAR libremente en
+    // `<agentDir>/sesion/`, que es donde está el registro de lo que ha hecho. Es
+    // decir, el sujeto de la auditoría tenía permiso de escritura sobre la
+    // auditoría. Comprobado ejecutando `decidir`: `rm -rf <agentDir>/sesion/`
+    // salía `permitida`.
+    //
+    // Denegado también para LEER, igual que el vault: el libro guarda hashes y
+    // rutas de todo lo que ha pasado por la sesión, y no hay ninguna tarea
+    // legítima del agente que necesite leerlo por el sistema de ficheros. Quien
+    // tiene que verlo lo ve por `ada-cli audit show`, por `audit://` o por el
+    // panel, que no pasan por esta política porque no son el agente.
+    for (const dir of [DIR_SESION, DIR_INDICE]) {
+        if (nombraDirectorio(texto, `${agentDir}/`, dir))
+            return "el libro de auditoría de la sesión";
+        if (nombraDirectorio(texto, SEGMENTO_AGENTE_ADA, dir)) {
+            return "el libro de auditoría de la sesión (de este equipo o de un destino remoto)";
+        }
+    }
+    // Las credenciales de los proveedores, que viven EN CLARO en `auth.json`.
+    //
+    // Agujero real y propio: la primera versión de esta política protegía el
+    // vault, las claves SSH, AWS y los `.env`, y dejaba abierto justo el fichero
+    // donde están las claves con las que corre el agente. Se comprobó
+    // ejecutando el producto y las leyó todas. Proteger la caja fuerte y dejar
+    // las llaves encima no protege nada.
+    //
+    // Se compara con el nombre de fichero COMPLETO para no llevarse por delante
+    // `auth.json.example`, `auth-storage.ts` ni `auth.md`, que son código y
+    // documentación que el agente sí tiene que poder leer.
+    for (const parte of texto.split(/[\s"'`]+/)) {
+        const base = parte.slice(parte.lastIndexOf("/") + 1);
+        if (parte.includes(`${agentDir}/`) && base === "auth.json")
+            return "las credenciales de los proveedores";
+        // Igual, pero para el `auth.json` de un Ada corriendo en el DESTINO de
+        // `--remoto`: no comparte `agentDir` con este equipo, así que el
+        // segmento genérico es la única forma de reconocerlo.
+        if (parte.includes(SEGMENTO_AGENTE_ADA) && base === "auth.json") {
+            return "las credenciales de los proveedores (de este equipo o de un destino remoto)";
+        }
+        // Y las de las otras herramientas: están en el mismo portátil y sirven
+        // para lo mismo. Si el agente no ve las nuestras, no hay motivo para que
+        // vea las de Claude Code, Codex, gh, Docker o kubectl.
+        if (base === ".credentials.json" || base === ".netrc")
+            return "credenciales de otra herramienta";
+        if (contieneSegmento(parte, ".codex") && base === "auth.json")
+            return "las credenciales de Codex";
+        if (contieneSegmento(parte, "gh") && base === "hosts.yml")
+            return "las credenciales de GitHub CLI";
+        if (contieneSegmento(parte, ".docker") && base === "config.json")
+            return "las credenciales de Docker";
+        if (contieneSegmento(parte, ".kube") && base === "config")
+            return "el acceso al clúster de Kubernetes";
+    }
+    if (contieneSegmento(texto, ".ssh"))
+        return "las claves SSH";
+    if (contieneSegmento(texto, ".gnupg"))
+        return "las claves GPG";
+    if (contieneSegmento(texto, ".aws"))
+        return "las credenciales de AWS";
+    // `.env` como nombre de fichero completo, no como prefijo: `.environment.ts`
+    // es código normal y denegarlo dejaría medio proyecto ilegible sin que nadie
+    // entendiera por qué.
+    for (const parte of texto.split(/[\s"'`]+/)) {
+        const base = parte.slice(parte.lastIndexOf("/") + 1);
+        if (base === ".env" || base.startsWith(".env."))
+            return "un fichero de entorno";
+    }
+    // La configuración del agente se puede LEER pero no escribir. El
+    // CVE-2026-25725 de Claude Code fue exactamente esto: código dentro del
+    // sandbox creaba un settings.json e inyectaba hooks `SessionStart` que
+    // corrían FUERA. Nuestro settings.json también ejecuta hooks.
+    if (escribiendo && (texto.includes(`${agentDir}/settings.json`) || texto.includes(`${agentDir}/hooks`))) {
+        return "la configuración del agente, que ejecuta hooks";
+    }
+    return null;
+}
+/** Todas las cadenas de los argumentos, a cualquier profundidad. */
+function cadenasDe(valor, acumulado = []) {
+    if (typeof valor === "string")
+        acumulado.push(valor);
+    else if (Array.isArray(valor))
+        for (const v of valor)
+            cadenasDe(v, acumulado);
+    else if (valor && typeof valor === "object")
+        for (const v of Object.values(valor))
+            cadenasDe(v, acumulado);
+    return acumulado;
+}
+/**
+ * Lee `permissions.denied` de la configuración, tolerando que no exista.
+ *
+ * El bloque `permissions` es un `Record<string, unknown>` en settings, así que
+ * lo que hay ahí no está tipado y puede ser cualquier cosa: se filtra a cadenas
+ * en vez de confiar. Una entrada mal escrita tiene que perderse ella sola, no
+ * tumbar la política entera y con ella la sesión.
+ */
+export function leerDenegadas(config) {
+    const lista = config?.permissions?.denied;
+    return Array.isArray(lista) ? lista.filter((x) => typeof x === "string") : [];
+}
+export function decidir({ tool, args, modo, agentDir, home, denegadas, maquina: maquinaDada, }) {
+    const casa = home ?? homedir();
+    const nivel = nivelDe(tool);
+    // 1. Rutas protegidas. Por delante de todo lo demás, incluido `yolo`.
+    //    `ejecucion` cuenta como escritura: un `bash` puede reescribir el
+    //    settings.json igual de bien que un `write`.
+    const escribiendo = nivel !== "lectura";
+    for (const cadena of cadenasDe(args)) {
+        const que = rutaProtegida(normalizar(cadena, casa), agentDir, escribiendo);
+        if (que) {
+            return {
+                veredicto: "denegada",
+                politica: "ruta-protegida",
+                motivo: `Denegado: ${que}. No es configurable y no cambia con el modo de permisos. Si el usuario necesita ese dato, pídeselo.`,
+            };
+        }
+    }
+    // 2. Ficheros generados. Escribir en uno es trabajo que desaparece en la
+    //    siguiente regeneración, y entre medias deja la fuente y el generado
+    //    diciendo cosas distintas.
+    //
+    //    Va después de las rutas protegidas y antes del modo, porque no es
+    //    negociable por comodidad — pero sí lo levanta el usuario diciéndolo, y
+    //    el mensaje se lo explica al modelo para que lo pida en vez de insistir.
+    if (escribiendo) {
+        for (const cadena of cadenasDe(args)) {
+            // El filtro es "se puede abrir", no "parece una ruta".
+            //
+            // La versión anterior exigía una barra, y con eso `edit` sobre
+            // `api.pb.go` —sin directorio— se colaba entera: la guarda estaba
+            // puesta, las pruebas en verde, y el fichero generado se editó igual.
+            // Solo salió ejecutando el CLI de verdad.
+            //
+            // Lo que sí se descarta antes de tocar el disco es lo que no puede ser
+            // un nombre de fichero: contenido con saltos de línea (el `new_string`
+            // de una edición) o cadenas absurdamente largas.
+            if (cadena.length === 0 || cadena.length > 400 || cadena.includes("\n"))
+                continue;
+            let contenido;
+            try {
+                contenido = readFileSync(normalizar(cadena, casa), "utf-8");
+            }
+            catch {
+                continue; // no existe o no es un fichero: no hay nada que proteger
+            }
+            const marca = marcaDeGenerado(contenido);
+            if (marca) {
+                return { veredicto: "denegada", politica: "fichero-generado", motivo: motivoDeGenerado(cadena, marca) };
+            }
+        }
+    }
+    // 3. Lo que el usuario ha denegado. También sobrevive a `yolo`: si no,
+    //    "denegar" significaría "denegar hasta que al agente le convenga".
+    if (denegadas?.includes(tool)) {
+        return {
+            veredicto: "denegada",
+            politica: "deny-de-usuario",
+            motivo: `Denegado: el usuario ha desactivado \`${tool}\` en su configuración.`,
+        };
+    }
+    // 4. La política de MÁQUINA, que el usuario no puede editar.
+    //
+    //    Va aquí y no en cada llamante porque `decidir()` la invocan siete
+    //    sitios: un techo que haya que acordarse de poner en cada uno no es un
+    //    techo. Y va antes del modo porque su único poder es recortarlo.
+    //
+    //    Los dos ámbitos que había —global y proyecto— son ficheros del propio
+    //    usuario, así que la línea con la que el CISO prohíbe `yolo` la borraba
+    //    él mismo con un editor de texto. Ver `politica-de-maquina.ts`.
+    const maquina = maquinaDada ?? politicaDeMaquina();
+    if (maquina.politica?.denegadas?.includes(tool)) {
+        return {
+            veredicto: "denegada",
+            politica: "deny-de-maquina",
+            motivo: `Denegado: \`${tool}\` está desactivada por la política de este equipo` +
+                (maquina.politica.motivo ? `: ${maquina.politica.motivo}` : ".") +
+                " No la levanta el modo de permisos ni la configuración del usuario.",
+        };
+    }
+    const efectivo = recortarModo(modo, maquina);
+    // 5. El modo de la sesión, ya recortado.
+    if (nivel === "lectura")
+        return { veredicto: "permitida", politica: `modo-${efectivo}`, motivo: "" };
+    // Que el recorte se NOMBRE en `politica` no es cosmético: ese campo va al
+    // libro de sesión, así que un auditor puede ver que la decisión la tomó la
+    // política del equipo y no la preferencia del usuario.
+    const sufijo = efectivo === modo ? "" : "-por-politica-de-maquina";
+    switch (efectivo) {
+        case "plan":
+            return {
+                veredicto: "denegada",
+                politica: `modo-plan${sufijo}`,
+                motivo: "En modo plan no se actúa: propón el cambio en vez de aplicarlo.",
+            };
+        case "manual":
+            return { veredicto: "preguntar", politica: `modo-manual${sufijo}`, motivo: "" };
+        case "auto":
+            return nivel === "escritura"
+                ? { veredicto: "permitida", politica: `modo-auto${sufijo}`, motivo: "" }
+                : { veredicto: "preguntar", politica: `modo-auto${sufijo}`, motivo: "" };
+        default:
+            return { veredicto: "permitida", politica: `modo-yolo${sufijo}`, motivo: "" };
+    }
+}
+//# sourceMappingURL=politica.js.map

package/dist/core/aprobacion/politica.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"politica.js","sourceRoot":"","sources":["../../../src/core/aprobacion/politica.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAA0B,iBAAiB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEnG;;;;;;;;;;GAUG;AACH,MAAM,mBAAmB,GAAG,IAAI,eAAe,SAAS,CAAC;AAczD,4BAA4B;AAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;IACvB,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,eAAe;IACf,aAAa;IACb,aAAa;IACb,mBAAmB;IACnB,WAAW;CACX,CAAC,CAAC;AAEH,2EAA2E;AAC3E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACzB,MAAM;IACN,OAAO;IACP,UAAU;IACV,YAAY;IACZ,gBAAgB;IAChB,eAAe;IACf,uBAAuB;IACvB,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,WAAW;CACX,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,MAAM,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,+DAA+D;IAC/D,EAAE;IACF,0EAA0E;IAC1E,6EAA6E;IAC7E,wEAAwE;IACxE,2EAA2E;IAC3E,0DAA0D;IAC1D,IAAI,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAC5C,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,yEAAyE;AACzE,SAAS,gBAAgB,CAAC,KAAa,EAAE,QAAgB;IACxD,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,gBAAgB,CAAC,KAAa,EAAE,IAAY,EAAE,GAAW;IACjE,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;AACnG,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,UAAU,CAAC,KAAa,EAAE,IAAY;IAC9C,OAAO,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,KAAa,EAAE,QAAgB,EAAE,WAAoB;IAC3E,IAAI,gBAAgB,CAAC,KAAK,EAAE,GAAG,QAAQ,GAAG,EAAE,OAAO,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAChF,iEAAiE;IACjE,2EAA2E;IAC3E,IAAI,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC;QACxD,OAAO,0DAA0D,CAAC;IAEnE,qCAAqC;IACrC,EAAE;IACF,yEAAyE;IACzE,4EAA4E;IAC5E,6EAA6E;IAC7E,uEAAuE;IACvE,0EAA0E;IAC1E,qBAAqB;IACrB,EAAE;IACF,2EAA2E;IAC3E,uEAAuE;IACvE,4EAA4E;IAC5E,0EAA0E;IAC1E,iEAAiE;IACjE,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;QAC5C,IAAI,gBAAgB,CAAC,KAAK,EAAE,GAAG,QAAQ,GAAG,EAAE,GAAG,CAAC;YAAE,OAAO,oCAAoC,CAAC;QAC9F,IAAI,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,4EAA4E,CAAC;QACrF,CAAC;IACF,CAAC;IAED,0EAA0E;IAC1E,EAAE;IACF,yEAAyE;IACzE,6EAA6E;IAC7E,kEAAkE;IAClE,2EAA2E;IAC3E,qCAAqC;IACrC,EAAE;IACF,4EAA4E;IAC5E,wEAAwE;IACxE,uDAAuD;IACvD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,CAAC,IAAI,IAAI,KAAK,WAAW;YAAE,OAAO,qCAAqC,CAAC;QACzG,uEAAuE;QACvE,iEAAiE;QACjE,sDAAsD;QACtD,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACjE,OAAO,6EAA6E,CAAC;QACtF,CAAC;QACD,uEAAuE;QACvE,yEAAyE;QACzE,uDAAuD;QACvD,IAAI,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,kCAAkC,CAAC;QACjG,IAAI,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,KAAK,WAAW;YAAE,OAAO,2BAA2B,CAAC;QAClG,IAAI,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,WAAW;YAAE,OAAO,gCAAgC,CAAC;QACnG,IAAI,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,IAAI,KAAK,aAAa;YAAE,OAAO,4BAA4B,CAAC;QACtG,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,oCAAoC,CAAC;IACxG,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC7D,IAAI,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC/D,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC;QAAE,OAAO,yBAAyB,CAAC;IAEtE,6EAA6E;IAC7E,6EAA6E;IAC7E,sBAAsB;IACtB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,uBAAuB,CAAC;IACjF,CAAC;IAED,iEAAiE;IACjE,wEAAwE;IACxE,uEAAuE;IACvE,8DAA8D;IAC9D,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,QAAQ,gBAAgB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,QAAQ,QAAQ,CAAC,CAAC,EAAE,CAAC;QACzG,OAAO,gDAAgD,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,oEAAoE;AACpE,SAAS,SAAS,CAAC,KAAc,EAAE,YAAsB,EAAE;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;SACzE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC3G,OAAO,SAAS,CAAC;AAClB,CAAC;AA8BD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAA6D;IAC1F,MAAM,KAAK,GAAI,MAAM,EAAE,WAAgD,EAAE,MAAM,CAAC;IAChF,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EACvB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EAAE,WAAW,GACH;IACjB,MAAM,IAAI,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,sEAAsE;IACtE,sEAAsE;IACtE,iDAAiD;IACjD,MAAM,WAAW,GAAG,KAAK,KAAK,SAAS,CAAC;IACxC,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC3E,IAAI,GAAG,EAAE,CAAC;YACT,OAAO;gBACN,SAAS,EAAE,UAAU;gBACrB,QAAQ,EAAE,gBAAgB;gBAC1B,MAAM,EAAE,aAAa,GAAG,sGAAsG;aAC9H,CAAC;QACH,CAAC;IACF,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,+BAA+B;IAC/B,EAAE;IACF,uEAAuE;IACvE,4EAA4E;IAC5E,6EAA6E;IAC7E,IAAI,WAAW,EAAE,CAAC;QACjB,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,uDAAuD;YACvD,EAAE;YACF,+DAA+D;YAC/D,kEAAkE;YAClE,sEAAsE;YACtE,0CAA0C;YAC1C,EAAE;YACF,uEAAuE;YACvE,uEAAuE;YACvE,iDAAiD;YACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YAClF,IAAI,SAAiB,CAAC;YACtB,IAAI,CAAC;gBACJ,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACR,SAAS,CAAC,yDAAyD;YACpE,CAAC;YACD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACzG,CAAC;QACF,CAAC;IACF,CAAC;IAED,uEAAuE;IACvE,uEAAuE;IACvE,IAAI,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO;YACN,SAAS,EAAE,UAAU;YACrB,QAAQ,EAAE,iBAAiB;YAC3B,MAAM,EAAE,yCAAyC,IAAI,yBAAyB;SAC9E,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,EAAE;IACF,uEAAuE;IACvE,2EAA2E;IAC3E,qEAAqE;IACrE,EAAE;IACF,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,MAAM,OAAO,GAAG,WAAW,IAAI,iBAAiB,EAAE,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO;YACN,SAAS,EAAE,UAAU;YACrB,QAAQ,EAAE,iBAAiB;YAC3B,MAAM,EACL,eAAe,IAAI,oDAAoD;gBACvE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBAChE,qEAAqE;SACtE,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7C,yCAAyC;IACzC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAErG,0EAA0E;IAC1E,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B,CAAC;IAEnE,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,MAAM;YACV,OAAO;gBACN,SAAS,EAAE,UAAU;gBACrB,QAAQ,EAAE,YAAY,MAAM,EAAE;gBAC9B,MAAM,EAAE,iEAAiE;aACzE,CAAC;QACH,KAAK,QAAQ;YACZ,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACjF,KAAK,MAAM;YACV,OAAO,KAAK,KAAK,WAAW;gBAC3B,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBACxE,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC3E;YACC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAChF,CAAC;AACF,CAAC"}

package/dist/core/arranque/atajos.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Arranque del CLI con atajos: decide qué grafo de módulos hay que cargar ANTES
+ * de cargarlo.
+ *
+ * Por qué existe. Medido en este árbol (Node 22, macOS, caché caliente):
+ *
+ *     node dist/cli.js --version   ->  1,65 s  y  1927 módulos cargados
+ *     node -e ""                   ->  0,03 s
+ *
+ * (contados con un hook `load` de `node:module`; con `module.register()`, que va
+ * en otro hilo y no ve algunas cargas, salen 1315 — el número de la puerta
+ * `scripts/check-arranque.mjs` es el primero, para que se puedan comparar.)
+ *
+ * De esos 1927 módulos, 660 son de `typebox` (los esquemas de todas las tools),
+ * 206 de `core/` y 171 de `packages/ai`. Ninguno hace falta para imprimir una
+ * cadena de versión. El coste no era del lenguaje —Bun tardaba lo mismo— sino de
+ * que `cli.ts` importaba `main.ts` de forma estática, y `main.ts` importa
+ * ávidamente TODO su grafo (sdk, modos, extensiones, proveedores, motor de
+ * control del ordenador) antes de mirar el primer argumento.
+ *
+ * Lo mismo pasaba con los subcomandos que ya estaban escritos para ser
+ * perezosos: `runServeCommand` (audit, discover, banco, review, commit, wiki,
+ * usage…) carga sus dependencias con `await import()`, pero se llamaba desde
+ * dentro de `main()`, o sea DESPUÉS de haber pagado el grafo entero. La pereza
+ * estaba construida y desenchufada.
+ *
+ * Enganche en upstream: UN solo hunk, el final de `src/cli.ts`. El resto vive
+ * aquí, en un fichero nuestro.
+ */
+/**
+ * ¿Es una invocación que solo pide la versión y nada más?
+ *
+ * Se exige que sea el ÚNICO argumento a propósito. `ada-cli update --version`
+ * lo consume `handlePackageCommand` dentro de `main()` con otro significado (la
+ * versión a instalar), y atajarlo aquí cambiaría lo que hace ese comando. Un
+ * atajo que se lleva por delante un caso legítimo es peor que no tener atajo.
+ */
+export declare function esSoloVersion(args: readonly string[]): boolean;
+/**
+ * Punto de entrada real del CLI. Devuelve cuando el trabajo ha terminado.
+ *
+ * Sin `options`: `cli.ts` nunca las pasó y el SDK no entra por aquí, sino por
+ * `createAgentSession`. Un parámetro que nadie rellena es una mentira con tipo.
+ */
+export declare function arrancar(args: string[]): Promise<void>;
+//# sourceMappingURL=atajos.d.ts.map

package/dist/core/arranque/atajos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atajos.d.ts","sourceRoot":"","sources":["../../../src/core/arranque/atajos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAoBH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6D5D"}

package/dist/core/arranque/atajos.js

@@ -0,0 +1,133 @@
+/**
+ * Arranque del CLI con atajos: decide qué grafo de módulos hay que cargar ANTES
+ * de cargarlo.
+ *
+ * Por qué existe. Medido en este árbol (Node 22, macOS, caché caliente):
+ *
+ *     node dist/cli.js --version   ->  1,65 s  y  1927 módulos cargados
+ *     node -e ""                   ->  0,03 s
+ *
+ * (contados con un hook `load` de `node:module`; con `module.register()`, que va
+ * en otro hilo y no ve algunas cargas, salen 1315 — el número de la puerta
+ * `scripts/check-arranque.mjs` es el primero, para que se puedan comparar.)
+ *
+ * De esos 1927 módulos, 660 son de `typebox` (los esquemas de todas las tools),
+ * 206 de `core/` y 171 de `packages/ai`. Ninguno hace falta para imprimir una
+ * cadena de versión. El coste no era del lenguaje —Bun tardaba lo mismo— sino de
+ * que `cli.ts` importaba `main.ts` de forma estática, y `main.ts` importa
+ * ávidamente TODO su grafo (sdk, modos, extensiones, proveedores, motor de
+ * control del ordenador) antes de mirar el primer argumento.
+ *
+ * Lo mismo pasaba con los subcomandos que ya estaban escritos para ser
+ * perezosos: `runServeCommand` (audit, discover, banco, review, commit, wiki,
+ * usage…) carga sus dependencias con `await import()`, pero se llamaba desde
+ * dentro de `main()`, o sea DESPUÉS de haber pagado el grafo entero. La pereza
+ * estaba construida y desenchufada.
+ *
+ * Enganche en upstream: UN solo hunk, el final de `src/cli.ts`. El resto vive
+ * aquí, en un fichero nuestro.
+ */
+/**
+ * Prepara el proceso igual que hacía `cli.ts`: título, variables de entorno que
+ * leen otros módulos y silenciado de avisos de Node.
+ *
+ * `configureHttpDispatcher()` NO se llama aquí: es el único trozo del preámbulo
+ * que cuesta (carga `undici`, 221 módulos medidos) y solo hace falta cuando algo
+ * va a hablar por red. Se llama justo antes de `main()` —donde `runAuthCommand`
+ * ya usa la red— y dentro de `runServeCommand`, después de los subcomandos que
+ * solo leen ficheros.
+ */
+async function prepararProceso() {
+    const { APP_NAME } = await import("../../config.js");
+    process.title = APP_NAME;
+    process.env.PI_CODING_AGENT = "true";
+    process.env.AI_AGENT = "pi";
+    process.emitWarning = (() => { });
+}
+/**
+ * ¿Es una invocación que solo pide la versión y nada más?
+ *
+ * Se exige que sea el ÚNICO argumento a propósito. `ada-cli update --version`
+ * lo consume `handlePackageCommand` dentro de `main()` con otro significado (la
+ * versión a instalar), y atajarlo aquí cambiaría lo que hace ese comando. Un
+ * atajo que se lleva por delante un caso legítimo es peor que no tener atajo.
+ */
+export function esSoloVersion(args) {
+    return args.length === 1 && (args[0] === "--version" || args[0] === "-v");
+}
+/**
+ * Punto de entrada real del CLI. Devuelve cuando el trabajo ha terminado.
+ *
+ * Sin `options`: `cli.ts` nunca las pasó y el SDK no entra por aquí, sino por
+ * `createAgentSession`. Un parámetro que nadie rellena es una mentira con tipo.
+ */
+export async function arrancar(args) {
+    await prepararProceso();
+    // Atajo 1: la versión. `VERSION` sale de config.ts, que ya está cargado.
+    if (esSoloVersion(args)) {
+        const { VERSION } = await import("../../config.js");
+        console.log(VERSION);
+        return;
+    }
+    // Atajo 1b: `ada ps` — broker por proyecto inspeccionable.
+    // Vive aquí y no en `runServeCommand` para no añadir un hunk a
+    // `src/cli/serve-command.ts` (upstream-owned). El coste de este atajo
+    // es cero hunks: este fichero es Ada-owned.
+    if (args[0] === "ps" || args[0] === "broker-ps") {
+        const { getBroker } = await import("../broker/index.js");
+        const { runPs } = await import("../broker/ps.js");
+        const json = args.includes("--json");
+        const reap = args.includes("--reap");
+        const broker = getBroker();
+        if (reap) {
+            const result = broker.reapOrphans();
+            console.log(result.narrativa);
+            if (json)
+                console.log(JSON.stringify({ reaped: result.reaped }, null, 2));
+            return;
+        }
+        console.log(runPs(broker, { json }));
+        return;
+    }
+    // `--offline` tiene que estar puesto en el entorno antes de que cualquier
+    // módulo lo lea. Es lo mismo que hace `main()` en sus primeras líneas; se
+    // repite aquí porque los subcomandos del atajo 2 ya no pasan por allí.
+    if (args.includes("--offline") || esBanderaVerdadera(process.env.PI_OFFLINE)) {
+        process.env.PI_OFFLINE = "1";
+        process.env.PI_SKIP_VERSION_CHECK = "1";
+    }
+    // Atajo 2: los subcomandos que no abren el TUI (audit, discover, banco,
+    // review, commit, usage, wiki, serve, sessions, attach…). Ya cargaban sus
+    // dependencias de forma perezosa; lo que se gana es no pagar el grafo de
+    // `main.ts` para llegar hasta ellos.
+    //
+    // El orden respecto a `runAuthCommand` (que sigue dentro de `main()`) no
+    // importa: `auth` no está en la lista de `isServeCommand`, así que los dos
+    // conjuntos de argumentos son disjuntos.
+    //
+    // No se filtra con `isServeCommand` aquí: `runServeCommand` ya empieza por esa
+    // misma comprobación y devuelve false. Repetirla solo abría la puerta a que
+    // las dos listas se separaran.
+    const { runServeCommand } = await import("../../cli/serve-command.js");
+    if (await runServeCommand(args))
+        return;
+    // Camino normal: el CLI completo. El dispatcher se configura aquí y no antes
+    // porque `undici` son 221 módulos medidos y los subcomandos que solo leen
+    // ficheros no los necesitan. Tiene que ser ANTES de `main()`: `runAuthCommand`
+    // usa la red en las primeras líneas de main, antes de su propia llamada.
+    const { configureHttpDispatcher } = await import("../http-dispatcher.js");
+    configureHttpDispatcher();
+    const { main } = await import("../../main.js");
+    await main(args);
+}
+/**
+ * Copia local de la lectura de banderas de entorno de `main.ts`. Son cuatro
+ * líneas y traerlas desde allí obligaría a cargar `main.ts`, que es justo lo que
+ * este fichero existe para evitar.
+ */
+function esBanderaVerdadera(value) {
+    if (!value)
+        return false;
+    return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
+}
+//# sourceMappingURL=atajos.js.map

package/dist/core/arranque/atajos.js.map

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

package/dist/core/audit/exportacion.d.ts

@@ -0,0 +1,54 @@
+/**
+ * El libro de sesión convertido en un documento que un DPO puede archivar.
+ *
+ * El libro (`libro.ts`) es JSONL encadenado: perfecto para verificar, ilegible
+ * para quien tiene que responder a una inspección. Un delegado de protección de
+ * datos hace dos preguntas concretas y ninguna se contesta leyendo hashes:
+ *
+ *   · ¿QUÉ FICHEROS se trataron? (art. 30 RGPD, registro de actividades)
+ *   · ¿QUÉ SALIÓ DE LA MÁQUINA y hacia dónde? (art. 44 y siguientes)
+ *
+ * Sale Markdown y no JSON a propósito: el requisito es "un fichero que se pueda
+ * releer sin nuestro CLI", y un JSONL con hashes no lo cumple aunque
+ * técnicamente se pueda abrir. Texto plano, tablas, y las limitaciones escritas
+ * dentro del propio documento.
+ *
+ * Dos cosas que conviene no deshacer:
+ *
+ * 1. **Minimización.** Aquí no se reconstruye nada que el libro no guarde ya. El
+ *    libro guarda del fichero su hash antes y después, nunca el texto, así que
+ *    este informe tampoco puede tenerlo. Y por si acaso se vuelve a pasar
+ *    `redactSensitive` sobre el documento entero: es el artefacto que SALE de la
+ *    máquina y se archiva, y una entrada escrita antes de que existiera un patrón
+ *    de redacción no puede convertirse en una fuga al exportarla.
+ * 2. **Tres estados, no dos.** "No hubo transferencias" y "no se pudo
+ *    determinar" no son lo mismo, y un informe que saliera vacío en los dos casos
+ *    haría pasar por limpia una sesión cuya cadena está rota. La ausencia de un
+ *    registro solo prueba algo si el registro es completo y verificable: si la
+ *    cadena no verifica, si el libro está vacío o si la lectura se topó con el
+ *    tope, este informe dice que no lo sabe en vez de afirmar que no pasó nada.
+ */
+import type { EntradaDelLibro, Veredicto } from "./libro.ts";
+/**
+ * ¿Podemos afirmar que algo NO ocurrió?
+ *
+ * Es el tipo que impide colapsar los tres estados en dos. Solo con
+ * `{ sabemos: true }` tiene sentido escribir "no hubo transferencias"; en los
+ * demás casos el informe dice qué le falta para saberlo.
+ */
+export type Certeza = {
+    sabemos: true;
+} | {
+    sabemos: false;
+    porque: string;
+};
+export declare function certezaDe(veredicto: Veredicto, truncado: boolean): Certeza;
+/**
+ * Rinde el informe.
+ *
+ * `entradas` debe venir de más antigua a más reciente (`libro.leer` las da al
+ * revés). `truncado` es true si la lectura se topó con su límite, porque
+ * entonces no se puede afirmar ninguna ausencia.
+ */
+export declare function informeParaDpo(entradas: EntradaDelLibro[], veredicto: Veredicto, truncado: boolean, ahora?: string): string;
+//# sourceMappingURL=exportacion.d.ts.map

package/dist/core/audit/exportacion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportacion.d.ts","sourceRoot":"","sources":["../../../src/core/audit/exportacion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAwB1E;AA+DD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,OAAO,EACjB,KAAK,SAA2B,GAC9B,MAAM,CAmNR"}