@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/web/tools.js

@@ -0,0 +1,273 @@
+/**
+ * Tools de web: `web_search` y `web_fetch`.
+ *
+ * Existían por su NOMBRE en el builtin `deep_research` pero nadie las
+ * registraba, así que ese workflow —uno de los cinco que anunciamos— no podía
+ * funcionar: le pedía al agente usar herramientas inexistentes. Un nombre de
+ * tool dentro de un prompt no lo comprueba ni el compilador ni los tests.
+ *
+ * `web_search` prueba, en orden: la búsqueda nativa del proveedor de modelo
+ * activo (ya es la credencial con la que corre el agente) → el registro de
+ * proveedores de terceros con clave configurada (`proveedores/registro.ts`,
+ * vault primero, variable de entorno después) → los proveedores sin clave
+ * (DuckDuckGo, Mojeek, Ecosia), que garantizan que `web_search` funciona de
+ * fábrica incluso sin ninguna credencial de terceros y con un modelo que no
+ * traiga búsqueda propia.
+ *
+ * `web_fetch` prueba primero un scraper especializado (`scrapers/registro.ts`)
+ * que devuelve datos ESTRUCTURADOS de la API pública del sitio —versión y
+ * licencia de un paquete, no el HTML de la página—; si ninguno encaja o falla,
+ * cae al fetch genérico + limpieza de HTML de siempre.
+ *
+ * `web_fetch` trae guardas contra SSRF. Una tool que descarga cualquier URL que
+ * el modelo proponga es, sin ellas, una puerta a la red interna: basta con que
+ * el modelo lea una URL en un README para que acabe pidiéndola.
+ *
+ * El acceso a estas tools es opt-in por agente (`web: true`), nunca implícito
+ * en `readOnly` — ver `resolveAllowedTools` en workflows/agent-runner.ts.
+ */
+import { Type } from "typebox";
+import { assertFetchableUrl, destinoPermitido } from "./destino.js";
+import { buscarConProveedores } from "./proveedores/registro.js";
+import { encontrarScraper } from "./scrapers/registro.js";
+import { htmlToText } from "./texto.js";
+export { assertFetchableUrl } from "./destino.js";
+export { htmlToText };
+const MAX_FETCH_BYTES = 512 * 1024;
+const DEFAULT_TIMEOUT_MS = 20_000;
+function textResult(text) {
+    return { content: [{ type: "text", text }], details: undefined };
+}
+/** Cuántos saltos se siguen antes de rendirse. Cada uno se revalida. */
+const MAX_REDIRECCIONES = 5;
+const searchParams = Type.Object({
+    query: Type.String({ description: "Consulta de búsqueda." }),
+    count: Type.Optional(Type.Number({ description: "Número de resultados (por defecto 5, máximo 10)." })),
+});
+const fetchParams = Type.Object({
+    url: Type.String({ description: "URL http(s) a descargar." }),
+});
+/** Formatea resultados de búsqueda (nativos o de un proveedor) como texto numerado. */
+function formatearResultados(resultados) {
+    return resultados
+        .map((r, i) => {
+        const partes = [`${i + 1}. ${r.titulo}`, `   ${r.url}`];
+        if (r.resumen)
+            partes.push(`   ${r.resumen}`);
+        if (r.edad)
+            partes.push(`   (${r.edad})`);
+        return partes.join("\n");
+    })
+        .join("\n\n");
+}
+/**
+ * El dominio de destino, o `null` si no se puede leer.
+ *
+ * Solo el hostname: la ruta y la query se descartan aquí a propósito, porque es
+ * el único sitio por el que pasan y un `?api_key=…` en el libro sería la fuga
+ * que el libro existe para no tener.
+ */
+// `Parameters<typeof fetch>[0]` y no `RequestInfo`: el proyecto compila sin la
+// librería DOM, así que ese nombre global no existe aquí.
+function dominioDe(destino) {
+    try {
+        const crudo = typeof destino === "string" ? destino : destino instanceof URL ? destino.href : destino.url;
+        return new URL(crudo).hostname || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function createWebTools(options) {
+    const fetchCrudo = options.fetchImpl ?? fetch;
+    const anotarRed = options.anotarRed;
+    // Un solo punto para todas las salidas: este `fetchImpl` es el que reciben los
+    // scrapers (`modulo.scrapear(url, fetchImpl, …)`) y los proveedores de
+    // búsqueda (`buscarConProveedores(…, { fetchImpl })`), así que envolverlo una
+    // vez registra las salidas de los tres caminos y no solo del fetch genérico.
+    const fetchImpl = anotarRed
+        ? (destino, init) => {
+            const dominio = dominioDe(destino);
+            // `try` porque el registro es best-effort y la descarga no lo es.
+            if (dominio) {
+                try {
+                    anotarRed(dominio, true);
+                }
+                catch {
+                    // Un fallo del libro no puede impedir una descarga.
+                }
+            }
+            return fetchCrudo(destino, init);
+        }
+        : fetchCrudo;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    /** Aborta la petición si tarda demasiado, y respeta el abort del agente. */
+    const withTimeout = async (outer, run) => {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const onAbort = () => controller.abort();
+        outer?.addEventListener("abort", onAbort);
+        try {
+            return await run(controller.signal);
+        }
+        finally {
+            clearTimeout(timer);
+            outer?.removeEventListener("abort", onAbort);
+        }
+    };
+    const webSearch = {
+        name: "web_search",
+        label: "Buscar en la web",
+        description: "Busca en la web y devuelve resultados con título, URL y extracto. " +
+            "Úsalo para hechos que puedan haber cambiado o que no estén en el repositorio. " +
+            "Cita siempre la URL exacta: un resultado sin fuente no vale como evidencia.",
+        promptSnippet: "buscar en la web",
+        parameters: searchParams,
+        async execute(_toolCallId, input, signal) {
+            const query = String(input.query ?? "").trim();
+            if (!query)
+                return textResult("Error: 'query' es obligatorio.");
+            const count = Math.min(Math.max(Number(input.count) || 5, 1), 10);
+            // 1) Nativo del proveedor de modelo: la credencial que el usuario ya paga.
+            if (options.buscarNativo) {
+                try {
+                    const nativos = await options.buscarNativo(query, count);
+                    if (nativos !== null) {
+                        if (nativos.length === 0)
+                            return textResult(`Sin resultados para: ${query}`);
+                        return textResult(formatearResultados(nativos));
+                    }
+                    // null: el proveedor activo no trae búsqueda propia — seguir al registro.
+                }
+                catch (error) {
+                    return textResult(`La búsqueda con el modelo falló: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            // 2) Registro de proveedores: clave configurada > sin clave. Los tres sin
+            // clave (duckduckgo, mojeek, ecosia) están siempre en la lista, así que
+            // esto SIEMPRE tiene algo que probar — nunca "no configurado".
+            try {
+                const { resultados } = await buscarConProveedores(query, count, {
+                    obtenerClave: options.obtenerClave,
+                    fetchImpl,
+                    signal,
+                });
+                if (resultados.length === 0)
+                    return textResult(`Sin resultados para: ${query}`);
+                return textResult(formatearResultados(resultados));
+            }
+            catch (error) {
+                // Un fallo de red o de todos los proveedores es un FALLO, no "sin
+                // resultados": el agente debe saber que no se ha buscado de verdad.
+                return textResult(`La búsqueda falló: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+    const webFetch = {
+        name: "web_fetch",
+        label: "Descargar URL",
+        description: "Descarga una URL y devuelve su texto. Úsalo tras web_search para leer una fuente concreta. " +
+            "Para registros de paquetes (npm, PyPI, crates.io…), GitHub, MDN, Stack Overflow y CVEs (NVD, CISA " +
+            "KEV) devuelve datos estructurados en vez de HTML. Solo http/https públicos: la red interna está bloqueada.",
+        promptSnippet: "leer el contenido de una URL",
+        parameters: fetchParams,
+        async execute(_toolCallId, input, signal) {
+            const raw = String(input.url ?? "").trim();
+            if (!raw)
+                return textResult("Error: 'url' es obligatorio.");
+            let url;
+            try {
+                url = assertFetchableUrl(raw);
+            }
+            catch (error) {
+                const motivo = error instanceof Error ? error.message : String(error);
+                // Un intento BLOQUEADO es tan auditable como una salida consumada, y es
+                // el único que no pasa por el `fetchImpl` envuelto: la guarda SSRF corta
+                // antes. Sin esta línea el libro solo tendría `permitido: true` y el
+                // campo `permitido` sería decorativo — un registro que dice siempre lo
+                // mismo no distingue nada.
+                try {
+                    anotarRed?.(dominioDe(raw) ?? "(url ilegible)", false, motivo);
+                }
+                catch {
+                    // best-effort, igual que arriba.
+                }
+                return textResult(`Error: ${motivo}`);
+            }
+            // Scraper especializado primero: datos estructurados de la API del sitio
+            // en vez del HTML de la página. Si no encaja o falla, se cae al fetch
+            // genérico de siempre — la URL sigue siendo legible aunque no se pueda
+            // enriquecer.
+            const descriptor = encontrarScraper(url);
+            if (descriptor) {
+                try {
+                    const modulo = await descriptor.cargar();
+                    const resultado = await modulo.scrapear(url, fetchImpl, signal);
+                    if (resultado) {
+                        return textResult(`${resultado.titulo}\n${resultado.url}\n\n${resultado.resumen}\n\nDatos estructurados:\n` +
+                            JSON.stringify(resultado.datos, null, 2));
+                    }
+                }
+                catch {
+                    // El scraper falló: se cae al fetch genérico en vez de dejar la
+                    // tool en blanco. La URL sigue siendo lo que el usuario pidió leer.
+                }
+            }
+            // La dirección, no el nombre. `assertFetchableUrl` compara cadenas y deja
+            // pasar todo lo que llega al mismo sitio por otro camino: medido,
+            // `[::ffff:127.0.0.1]` y un dominio que resuelve a 127.0.0.1 pasaban
+            // enteros. Ver `core/web/destino.ts`.
+            const rechazo = await destinoPermitido(url);
+            if (rechazo) {
+                anotarRed?.(url.hostname, false, rechazo.motivo);
+                return textResult(`Descarga bloqueada: ${rechazo.motivo}${rechazo.direccion ? ` (${rechazo.direccion})` : ""}. ` +
+                    "Las tools web no alcanzan la red interna ni la propia máquina.");
+            }
+            try {
+                // `redirect: "manual"` y cada salto revalidado. Con `follow`, una URL
+                // pública que responde 302 hacia loopback llegaba igual, porque solo se
+                // miraba la primera — era el tercer camino abierto de los tres.
+                let destino = url;
+                let response;
+                for (let salto = 0; salto <= MAX_REDIRECCIONES; salto++) {
+                    response = await withTimeout(signal, (s) => fetchImpl(destino.toString(), {
+                        redirect: "manual",
+                        signal: s,
+                        headers: { "user-agent": "ada-cli" },
+                    }));
+                    if (response.status < 300 || response.status >= 400)
+                        break;
+                    const siguiente = response.headers.get("location");
+                    if (!siguiente)
+                        break;
+                    if (salto === MAX_REDIRECCIONES) {
+                        return textResult(`La descarga dio más de ${MAX_REDIRECCIONES} redirecciones y se ha parado.`);
+                    }
+                    // Relativa respecto al destino actual, como manda el estándar.
+                    destino = new URL(siguiente, destino);
+                    assertFetchableUrl(destino.toString());
+                    const rechazoSalto = await destinoPermitido(destino);
+                    if (rechazoSalto) {
+                        anotarRed?.(destino.hostname, false, `redirección a ${rechazoSalto.motivo}`);
+                        return textResult(`Descarga bloqueada: la redirección lleva a ${rechazoSalto.motivo}` +
+                            `${rechazoSalto.direccion ? ` (${rechazoSalto.direccion})` : ""}.`);
+                    }
+                    anotarRed?.(destino.hostname, true, "redirección");
+                }
+                if (!response)
+                    return textResult("La descarga no devolvió respuesta.");
+                if (!response.ok)
+                    return textResult(`La descarga devolvió HTTP ${response.status}.`);
+                const body = await response.text();
+                const truncated = body.length > MAX_FETCH_BYTES;
+                const text = htmlToText(body.slice(0, MAX_FETCH_BYTES));
+                return textResult(truncated ? `${text}\n\n[truncado en ${MAX_FETCH_BYTES} bytes]` : text);
+            }
+            catch (error) {
+                return textResult(`La descarga falló: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+    return { web_search: webSearch, web_fetch: webFetch };
+}
+//# sourceMappingURL=tools.js.map

package/dist/core/web/tools.js.map

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

package/dist/core/wiki/almacen.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dónde vive la wiki y cómo se indexa.
+ *
+ * En `<proyecto>/<configDir>/wiki/`: páginas en Markdown y un `citas.json` con
+ * la huella de cada cita. Va dentro del proyecto y no en el agentDir a
+ * propósito — es documentación del repositorio, debe poder versionarse y
+ * revisarse en un pull request como cualquier otro fichero.
+ */
+import { type Afirmacion } from "./citas.ts";
+export interface Wiki {
+    version: 1;
+    afirmaciones: Afirmacion[];
+}
+export declare function rutaWiki(cwd: string, configDirName: string): string;
+export declare function leerWiki(cwd: string, configDirName: string): Wiki;
+export declare function escribirWiki(cwd: string, configDirName: string, wiki: Wiki): void;
+/**
+ * Lector de ficheros del proyecto, con la raíz cerrada.
+ *
+ * Una cita es texto que puede haber escrito un modelo. Sin esta comprobación,
+ * `../../.ssh/id_rsa` en una página de la wiki haría que `wiki check` leyera
+ * cualquier cosa del disco.
+ */
+export declare function lectorDelProyecto(cwd: string): (fichero: string) => string | null;
+/**
+ * Indexa las páginas Markdown: saca sus citas y les calcula la huella.
+ *
+ * Cada párrafo no vacío es una afirmación. Es una regla tonta a propósito: si
+ * el troceado fuera listo, dos ejecuciones sobre el mismo texto podrían dar
+ * afirmaciones distintas y el fichero de citas cambiaría sin que cambiara nada.
+ */
+export declare function indexarPaginas(cwd: string, configDirName: string): Wiki;
+//# sourceMappingURL=almacen.d.ts.map

package/dist/core/wiki/almacen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"almacen.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/almacen.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,YAAY,CAAC;AAErF,MAAM,WAAW,IAAI;IACpB,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,UAAU,EAAE,CAAC;CAC3B;AAID,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAUjE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAIjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAYjF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CA2BvE"}

package/dist/core/wiki/almacen.js

@@ -0,0 +1,93 @@
+/**
+ * Dónde vive la wiki y cómo se indexa.
+ *
+ * En `<proyecto>/<configDir>/wiki/`: páginas en Markdown y un `citas.json` con
+ * la huella de cada cita. Va dentro del proyecto y no en el agentDir a
+ * propósito — es documentación del repositorio, debe poder versionarse y
+ * revisarse en un pull request como cualquier otro fichero.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import { extraerCitas, huellaDeTexto } from "./citas.js";
+const VACIA = { version: 1, afirmaciones: [] };
+export function rutaWiki(cwd, configDirName) {
+    return join(cwd, configDirName, "wiki");
+}
+export function leerWiki(cwd, configDirName) {
+    const fichero = join(rutaWiki(cwd, configDirName), "citas.json");
+    if (!existsSync(fichero))
+        return { ...VACIA };
+    try {
+        const datos = JSON.parse(readFileSync(fichero, "utf8"));
+        return Array.isArray(datos.afirmaciones) ? datos : { ...VACIA };
+    }
+    catch {
+        // Un citas.json corrupto no puede impedir regenerar la wiki.
+        return { ...VACIA };
+    }
+}
+export function escribirWiki(cwd, configDirName, wiki) {
+    const dir = rutaWiki(cwd, configDirName);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "citas.json"), `${JSON.stringify(wiki, null, 2)}\n`, "utf8");
+}
+/**
+ * Lector de ficheros del proyecto, con la raíz cerrada.
+ *
+ * Una cita es texto que puede haber escrito un modelo. Sin esta comprobación,
+ * `../../.ssh/id_rsa` en una página de la wiki haría que `wiki check` leyera
+ * cualquier cosa del disco.
+ */
+export function lectorDelProyecto(cwd) {
+    const raiz = resolve(cwd);
+    return (fichero) => {
+        const absoluta = resolve(raiz, fichero);
+        const dentro = relative(raiz, absoluta);
+        if (dentro.startsWith("..") || resolve(raiz, dentro) !== absoluta)
+            return null;
+        try {
+            return readFileSync(absoluta, "utf8");
+        }
+        catch {
+            return null;
+        }
+    };
+}
+/**
+ * Indexa las páginas Markdown: saca sus citas y les calcula la huella.
+ *
+ * Cada párrafo no vacío es una afirmación. Es una regla tonta a propósito: si
+ * el troceado fuera listo, dos ejecuciones sobre el mismo texto podrían dar
+ * afirmaciones distintas y el fichero de citas cambiaría sin que cambiara nada.
+ */
+export function indexarPaginas(cwd, configDirName) {
+    const dir = rutaWiki(cwd, configDirName);
+    if (!existsSync(dir))
+        return { ...VACIA };
+    const leer = lectorDelProyecto(cwd);
+    const afirmaciones = [];
+    for (const fichero of readdirSync(dir)
+        .filter((f) => f.endsWith(".md"))
+        .sort()) {
+        const contenido = readFileSync(join(dir, fichero), "utf8");
+        const parrafos = contenido
+            .split(/\n\s*\n/)
+            .map((p) => p.trim())
+            .filter(Boolean);
+        parrafos.forEach((parrafo, i) => {
+            const citas = [];
+            for (const sinHuella of extraerCitas(parrafo)) {
+                const fuente = leer(sinHuella.fichero);
+                if (fuente === null)
+                    continue;
+                const lineas = fuente.split("\n").slice(sinHuella.desde - 1, sinHuella.hasta);
+                if (lineas.length === 0)
+                    continue;
+                citas.push({ ...sinHuella, huella: huellaDeTexto(lineas) });
+            }
+            afirmaciones.push({ id: `${fichero}#${i}`, texto: parrafo.slice(0, 400), citas });
+        });
+    }
+    return { version: 1, afirmaciones };
+}
+//# sourceMappingURL=almacen.js.map

package/dist/core/wiki/almacen.js.map

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

package/dist/core/wiki/citas.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Citas verificables para la wiki del repositorio.
+ *
+ * Una wiki generada por un modelo envejece mal: describe un código que ya no
+ * existe y nadie se entera hasta que alguien la sigue y pierde una tarde. La
+ * diferencia que buscamos no es generar mejor prosa, es que **cada afirmación
+ * lleve su cita a `fichero:línea` y se sepa cuándo deja de ser cierta**.
+ *
+ * Aquí vive esa parte. Es pura: recibe texto y contenidos de fichero, no toca
+ * disco ni llama a ningún modelo.
+ *
+ * La decisión que la hace útil en vez de molesta: si las líneas citadas
+ * **cambiaron**, la afirmación queda obsoleta; pero si solo se **movieron** —el
+ * mismo texto está más arriba o más abajo— la cita se reubica y la afirmación
+ * sigue viva. Sin eso, insertar un import al principio de un fichero invalidaría
+ * cada cita del fichero entero, la wiki daría cientos de falsos positivos y en
+ * dos días nadie volvería a mirarla.
+ */
+export interface Cita {
+    fichero: string;
+    /** 1-indexado e inclusivo, como lo escribe la gente. */
+    desde: number;
+    hasta: number;
+    /** Huella del texto citado cuando se escribió la afirmación. */
+    huella: string;
+}
+export interface Afirmacion {
+    id: string;
+    texto: string;
+    citas: Cita[];
+}
+export type EstadoCita = {
+    estado: "vigente";
+    cita: Cita;
+} | {
+    estado: "movida";
+    cita: Cita;
+    desde: number;
+    hasta: number;
+} | {
+    estado: "obsoleta";
+    cita: Cita;
+    motivo: string;
+};
+/**
+ * Huella del texto citado.
+ *
+ * Se normaliza el final de línea y los espacios al final de cada línea: un
+ * formateador que quita un espacio sobrante no cambia lo que el código dice, y
+ * marcar eso como obsoleto entrenaría a todo el mundo a ignorar los avisos.
+ * La indentación de la izquierda SÍ cuenta: en un lenguaje con bloques, mover
+ * algo de nivel sí cambia lo que hace.
+ */
+export declare function huellaDeTexto(lineas: string[]): string;
+/**
+ * Busca el texto citado en otro sitio del fichero.
+ *
+ * Devuelve la primera línea (1-indexada) donde encaja el bloque entero, o
+ * `null`. Es una búsqueda literal por bloques, no difusa: reubicar una cita
+ * sobre un parecido sería peor que declararla obsoleta, porque la afirmación
+ * pasaría a apuntar a un código que no es el suyo.
+ */
+export declare function buscarBloque(lineas: string[], huella: string, alto: number): number | null;
+/**
+ * Comprueba una cita contra el contenido actual del fichero.
+ *
+ * `contenido` es `null` si el fichero ya no existe.
+ */
+export declare function verificarCita(cita: Cita, contenido: string | null): EstadoCita;
+export interface EstadoAfirmacion {
+    afirmacion: Afirmacion;
+    citas: EstadoCita[];
+    /** Obsoleta si CUALQUIERA de sus citas lo está. Ver más abajo. */
+    obsoleta: boolean;
+}
+/**
+ * Comprueba una afirmación entera.
+ *
+ * Basta una cita obsoleta para marcarla: una afirmación apoyada en tres trozos
+ * de código de los que uno ya no dice lo que decía es, como mínimo,
+ * sospechosa. Exigir que fallen todas dejaría pasar justo el caso peligroso —
+ * la media verdad.
+ */
+export declare function verificarAfirmacion(afirmacion: Afirmacion, leer: (fichero: string) => string | null): EstadoAfirmacion;
+export interface ResumenWiki {
+    total: number;
+    vigentes: number;
+    movidas: number;
+    obsoletas: number;
+    sinCitas: number;
+    detalles: EstadoAfirmacion[];
+}
+export declare function verificarWiki(afirmaciones: Afirmacion[], leer: (fichero: string) => string | null): ResumenWiki;
+/**
+ * Reescribe las citas que solo se movieron.
+ *
+ * Devuelve las afirmaciones con las líneas actualizadas; las obsoletas se
+ * dejan intactas a propósito: arreglarlas requiere leer el código nuevo y
+ * decidir si la frase sigue siendo cierta, y eso no lo hace un `replace`.
+ */
+export declare function reubicarCitas(resumen: ResumenWiki): Afirmacion[];
+/** `fichero:12-30` o `fichero:12`. Es lo que la gente escribe a mano. */
+export declare function formatearCita(cita: Cita): string;
+/**
+ * Saca las citas de un texto en Markdown.
+ *
+ * Sin huella: quien escribe a mano no la conoce. La calcula quien indexa, que
+ * es el que tiene el fichero delante.
+ */
+export declare function extraerCitas(markdown: string): Array<Omit<Cita, "huella">>;
+//# sourceMappingURL=citas.d.ts.map

package/dist/core/wiki/citas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citas.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/citas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,IAAI;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACd;AAED,MAAM,MAAM,UAAU,GACnB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAGtD;AAOD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,CA2B9E;AAED,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACtC,gBAAgB,CAGlB;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,WAAW,CAiB/G;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,EAAE,CAOhE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAQ1E"}