@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/edicion/limpiar-carga.js

@@ -0,0 +1,121 @@
+/**
+ * Quitarle a un `oldText` el ruido que no es código.
+ *
+ * EL CASO MÁS VERGONZOSO ES EL NUESTRO. Nuestro propio `read` añade al final de
+ * lo que devuelve una línea como:
+ *
+ *     [Showing lines 1-5 of 5. Use offset=6 to continue.]
+ *
+ * El modelo lee un fichero, copia el bloque que quiere cambiar —cabecera
+ * incluida, porque venía pegada— y nosotros rechazamos la edición porque «el
+ * texto no coincide exactamente». Generamos la contaminación y luego la
+ * castigamos.
+ *
+ * Los otros tres son ruido que los modelos añaden solos y que ninguna de las
+ * dos partes discute que sea ruido: vallas de markdown, sentinelas de sobre de
+ * parche, y los números de línea de un `grep`.
+ *
+ * LA REGLA QUE EVITA HACER DAÑO: solo se quita lo que es INEQUÍVOCO. Un `3:` al
+ * principio de una línea podría ser una etiqueta de código real, así que solo se
+ * trata como número de línea cuando TODAS las líneas lo llevan y además los
+ * números van en orden. Preferimos dejar ruido que borrar código: quitar de más
+ * cambia el patrón y lo casa en el sitio equivocado, y eso es corrupción
+ * silenciosa — la clase de fallo que más cara nos ha salido.
+ */
+/** ```ts … ``` envolviendo el bloque entero. */
+function quitarValla(lineas) {
+    if (lineas.length < 2)
+        return undefined;
+    const primera = lineas[0].trim();
+    const ultima = lineas[lineas.length - 1].trim();
+    if (!primera.startsWith("```") || ultima !== "```")
+        return undefined;
+    // La apertura puede llevar el lenguaje (```ts); el cierre nunca lleva nada.
+    lineas.splice(lineas.length - 1, 1);
+    lineas.splice(0, 1);
+    return "valla de markdown";
+}
+/** `*** Begin Patch` / `*** End Patch` y sus variantes. */
+const SOBRE = /^\*{3}\s*(begin|end)\b|^(begin|end)(\s+of)?\s+(patch|edits?|file)\b/i;
+function quitarSobre(lineas) {
+    let quitadas = 0;
+    while (lineas.length > 0 && SOBRE.test(lineas[0].trim())) {
+        lineas.shift();
+        quitadas++;
+    }
+    while (lineas.length > 0 && SOBRE.test(lineas[lineas.length - 1].trim())) {
+        lineas.pop();
+        quitadas++;
+    }
+    return quitadas > 0 ? "sentinelas de sobre de parche" : undefined;
+}
+/**
+ * La cabecera que añade NUESTRO `read`.
+ *
+ * Se reconoce por su forma exacta y solo al principio o al final, nunca en
+ * medio: en medio sería contenido del fichero.
+ */
+const CABECERA_READ = /^\[Showing lines \d+-\d+ of \d+\.( Use offset=\d+ to continue\.)?\]$/;
+/** Y la de un fichero truncado, del mismo sitio. */
+const CABECERA_TRUNCADO = /^\[(File truncated|Truncated|Showing first) .*\]$/i;
+function quitarCabeceraPropia(lineas) {
+    const es = (l) => CABECERA_READ.test(l.trim()) || CABECERA_TRUNCADO.test(l.trim());
+    let quitadas = 0;
+    while (lineas.length > 0 && es(lineas[0])) {
+        lineas.shift();
+        quitadas++;
+    }
+    while (lineas.length > 0 && es(lineas[lineas.length - 1])) {
+        lineas.pop();
+        quitadas++;
+    }
+    return quitadas > 0 ? "la cabecera que añade nuestro propio read" : undefined;
+}
+/**
+ * Números de línea de un `grep` o un `read` numerado: `12:` o `12-`.
+ *
+ * Solo si TODAS las líneas no vacías lo llevan Y los números son consecutivos.
+ * Con una sola de las dos condiciones se dejaría de tocar código real: un
+ * `case 3:` o un fragmento de YAML con `80:` cumplirían la primera.
+ */
+function quitarNumerosDeLinea(lineas) {
+    const noVacias = lineas.filter((l) => l.trim() !== "");
+    if (noVacias.length === 0)
+        return undefined;
+    const numeros = [];
+    for (const linea of noVacias) {
+        const m = linea.match(/^\s*(\d+)[:\-\t]/);
+        if (!m)
+            return undefined;
+        numeros.push(Number(m[1]));
+    }
+    // Consecutivos, y por tanto números de línea y no datos.
+    for (let i = 1; i < numeros.length; i++) {
+        if (numeros[i] !== numeros[i - 1] + 1)
+            return undefined;
+    }
+    for (let i = 0; i < lineas.length; i++) {
+        lineas[i] = lineas[i].replace(/^\s*\d+[:\-\t]/, "");
+    }
+    return "números de línea";
+}
+/**
+ * Limpia `oldText`. Devuelve el texto y qué se quitó.
+ *
+ * Si no había nada que quitar, `quitado` viene vacío y `texto` es idéntico al
+ * de entrada — quien llama puede así distinguir «lo he limpiado» de «no había
+ * nada», sin comparar cadenas.
+ */
+export function limpiarCarga(oldText) {
+    const lineas = oldText.split("\n");
+    const quitado = [];
+    // Orden: primero los envoltorios de fuera adentro, y los números al final
+    // porque una valla o un sobre romperían la comprobación de consecutivos.
+    for (const paso of [quitarValla, quitarSobre, quitarCabeceraPropia, quitarNumerosDeLinea]) {
+        const que = paso(lineas);
+        if (que)
+            quitado.push(que);
+    }
+    return { texto: lineas.join("\n"), quitado };
+}
+//# sourceMappingURL=limpiar-carga.js.map

package/dist/core/edicion/limpiar-carga.js.map

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

package/dist/core/edicion/observador.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Observa cada edición: avisa si ha dejado el fichero roto, intenta
+ * repararlo solo cuando puede, y deja constancia de las tres cosas en el
+ * diario.
+ *
+ * Se engancha en los dos manejadores que ya existen: `beforeToolCall` guarda la
+ * preimagen y `afterToolCall` compara. Vive en su propio módulo, y no dentro de
+ * `agent-session.ts`, porque ese fichero es de upstream y el presupuesto de
+ * fork está en el tope: cuanto menos código nuestro viva ahí, menos cuesta
+ * seguir siendo un fork.
+ *
+ * Lee el fichero dos veces por edición. Es a propósito: la alternativa es
+ * tocar las tools `edit` y `write`, que también son de upstream, y una lectura
+ * de más en una operación que ya escribe a disco no se nota. Si algún día pesa,
+ * la respuesta es un `EditToolOptions` aguas arriba, no cachear aquí.
+ */
+/**
+ * Lo que el libro de sesión necesita saber de una edición.
+ *
+ * Sale de aquí y no de `agent-session.ts` porque este observador YA lee el
+ * fichero antes y después: pedirlo en otro sitio obligaría a leerlo una tercera
+ * vez, y sobre todo dejaría fuera el caso reparado, donde el contenido final no
+ * es el que dejó la tool.
+ */
+export interface CambioDeFichero {
+    ruta: string;
+    /** Contenido previo, o `null` si el fichero no existía. Lo hashea el libro. */
+    antes: string | null;
+    /** Contenido final, ya con la reparación aplicada si hubo. `null` = borrado. */
+    despues: string | null;
+}
+export declare class ObservadorDeEdiciones {
+    /** Preimagen por id de llamada. La borra quien la consume. */
+    private readonly previas;
+    /**
+     * Cambio observado por id de llamada, a la espera de que el libro lo anote.
+     *
+     * Es un hueco de estado y no un valor de retorno porque `despuesDe` ya
+     * devuelve el aviso para el modelo y tiene dieciocho llamadas en pruebas:
+     * cambiarle la firma para colar un segundo dato habría costado dieciocho
+     * ediciones sin comprar nada.
+     *
+     * Va por id y no en una sola ranura, y esto lo enseñó la prueba de la ruta
+     * real: el modelo puede pedir dos `write` en el mismo turno y el bucle del
+     * agente los ejecuta entrelazados, así que con una ranura única el segundo
+     * pisaba al primero antes de que nadie lo leyera. El libro registraba UN
+     * fichero de los dos — un fallo silencioso que se lee como éxito, porque el
+     * informe salía con una tabla poblada y creíble a la que le faltaba una fila.
+     */
+    private readonly cambios;
+    /**
+     * El cambio de fichero de esa llamada, o `null` si no editó nada. Lo consume:
+     * dos lecturas seguidas devuelven `null` la segunda, así que una llamada no
+     * puede heredar el cambio de otra y anotarlo dos veces en el libro.
+     */
+    ultimoCambio(idLlamada: string): CambioDeFichero | null;
+    private readonly cwd;
+    private readonly agentDir;
+    /** `undefined` cuando no hay modelo disponible (p. ej. en pruebas): la reparación queda "no-aplicable", nunca "rechazada". */
+    private readonly completar?;
+    /**
+     * Se crea una vez por sesión y mantiene vivo el programa de TypeScript entre
+     * ediciones: es lo que hace que la primera comprobación cueste 2,5 s y las
+     * siguientes 124 ms.
+     */
+    private readonly tipos;
+    constructor(cwd: () => string, agentDir: () => string, completar?: (prompt: string) => Promise<string | null>);
+    /** Antes de editar: guarda cómo estaba el fichero. */
+    antesDe(idLlamada: string, tool: string, args: unknown): Promise<void>;
+    /**
+     * Después de editar: devuelve el aviso (roto, o reparado — hay algo que
+     * decir en los dos casos), o `null` si no hay nada que decir. Deja
+     * constancia en el diario pase lo que pase.
+     *
+     * `null` en la inmensa mayoría de ediciones es lo correcto y lo que hace que
+     * el aviso signifique algo cuando aparece.
+     */
+    despuesDe(idLlamada: string, huboError: boolean): Promise<string | null>;
+}
+//# sourceMappingURL=observador.d.ts.map

package/dist/core/edicion/observador.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observador.d.ts","sourceRoot":"","sources":["../../../src/core/edicion/observador.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gFAAgF;IAChF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAkBD,qBAAa,qBAAqB;IACjC,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6D;IAErF;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAE9D;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAMvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,8HAA8H;IAC9H,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA6C;IACxE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAItC,GAAG,EAAE,MAAM,MAAM,EAAE,QAAQ,EAAE,MAAM,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM7G,sDAAsD;IAChD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;;;;;;OAOG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAkF9E"}

package/dist/core/edicion/observador.js

@@ -0,0 +1,183 @@
+/**
+ * Observa cada edición: avisa si ha dejado el fichero roto, intenta
+ * repararlo solo cuando puede, y deja constancia de las tres cosas en el
+ * diario.
+ *
+ * Se engancha en los dos manejadores que ya existen: `beforeToolCall` guarda la
+ * preimagen y `afterToolCall` compara. Vive en su propio módulo, y no dentro de
+ * `agent-session.ts`, porque ese fichero es de upstream y el presupuesto de
+ * fork está en el tope: cuanto menos código nuestro viva ahí, menos cuesta
+ * seguir siendo un fork.
+ *
+ * Lee el fichero dos veces por edición. Es a propósito: la alternativa es
+ * tocar las tools `edit` y `write`, que también son de upstream, y una lectura
+ * de más en una operación que ya escribe a disco no se nota. Si algún día pesa,
+ * la respuesta es un `EditToolOptions` aguas arriba, no cachear aquí.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { resolveToCwd } from "../tools/path-utils.js";
+import { anotarEnDiario } from "./diario.js";
+import { avisoDeParseoRoto, primerErrorDe, rompioElParseo } from "./parseo.js";
+import { intentarReparar } from "./reparacion.js";
+import { avisoDeTipos, ComprobadorDeTipos } from "./tipos.js";
+/** Tools cuya salida es un fichero con contenido nuevo. */
+const TOOLS_DE_EDICION = new Set(["edit", "write"]);
+/** Lee el fichero, o `null` si no existe o no se puede leer. */
+async function contenido(ruta) {
+    try {
+        return await readFile(ruta, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/** La ruta que la tool va a tocar, ya resuelta contra el cwd. */
+function rutaDe(args, cwd) {
+    const a = args;
+    const cruda = typeof a?.file_path === "string" ? a.file_path : typeof a?.path === "string" ? a.path : null;
+    return cruda === null ? null : resolveToCwd(cruda, cwd);
+}
+export class ObservadorDeEdiciones {
+    /** Preimagen por id de llamada. La borra quien la consume. */
+    previas = new Map();
+    /**
+     * Cambio observado por id de llamada, a la espera de que el libro lo anote.
+     *
+     * Es un hueco de estado y no un valor de retorno porque `despuesDe` ya
+     * devuelve el aviso para el modelo y tiene dieciocho llamadas en pruebas:
+     * cambiarle la firma para colar un segundo dato habría costado dieciocho
+     * ediciones sin comprar nada.
+     *
+     * Va por id y no en una sola ranura, y esto lo enseñó la prueba de la ruta
+     * real: el modelo puede pedir dos `write` en el mismo turno y el bucle del
+     * agente los ejecuta entrelazados, así que con una ranura única el segundo
+     * pisaba al primero antes de que nadie lo leyera. El libro registraba UN
+     * fichero de los dos — un fallo silencioso que se lee como éxito, porque el
+     * informe salía con una tabla poblada y creíble a la que le faltaba una fila.
+     */
+    cambios = new Map();
+    /**
+     * El cambio de fichero de esa llamada, o `null` si no editó nada. Lo consume:
+     * dos lecturas seguidas devuelven `null` la segunda, así que una llamada no
+     * puede heredar el cambio de otra y anotarlo dos veces en el libro.
+     */
+    ultimoCambio(idLlamada) {
+        const cambio = this.cambios.get(idLlamada) ?? null;
+        this.cambios.delete(idLlamada);
+        return cambio;
+    }
+    cwd;
+    agentDir;
+    /** `undefined` cuando no hay modelo disponible (p. ej. en pruebas): la reparación queda "no-aplicable", nunca "rechazada". */
+    completar;
+    /**
+     * Se crea una vez por sesión y mantiene vivo el programa de TypeScript entre
+     * ediciones: es lo que hace que la primera comprobación cueste 2,5 s y las
+     * siguientes 124 ms.
+     */
+    tipos = new ComprobadorDeTipos();
+    // Campos explícitos y no propiedades de parámetro: el proyecto compila con
+    // `erasableSyntaxOnly`, que prohíbe la forma corta por no ser borrable.
+    constructor(cwd, agentDir, completar) {
+        this.cwd = cwd;
+        this.agentDir = agentDir;
+        this.completar = completar;
+    }
+    /** Antes de editar: guarda cómo estaba el fichero. */
+    async antesDe(idLlamada, tool, args) {
+        if (!TOOLS_DE_EDICION.has(tool))
+            return;
+        const ruta = rutaDe(args, this.cwd());
+        if (ruta === null)
+            return;
+        // Tope de seguridad por si alguna llamada muere antes de consumirse.
+        if (this.previas.size > 256)
+            this.previas.clear();
+        this.previas.set(idLlamada, { ruta, antes: await contenido(ruta) });
+    }
+    /**
+     * Después de editar: devuelve el aviso (roto, o reparado — hay algo que
+     * decir en los dos casos), o `null` si no hay nada que decir. Deja
+     * constancia en el diario pase lo que pase.
+     *
+     * `null` en la inmensa mayoría de ediciones es lo correcto y lo que hace que
+     * el aviso signifique algo cuando aparece.
+     */
+    async despuesDe(idLlamada, huboError) {
+        const previa = this.previas.get(idLlamada);
+        this.previas.delete(idLlamada);
+        if (!previa || huboError)
+            return null;
+        const despues = await contenido(previa.ruta);
+        // Para el libro de sesión: el fichero se tocó, pase lo que pase con el
+        // parseo. Una edición que deja el fichero roto es MÁS auditable, no menos,
+        // así que esto va antes de cualquier rama y no dentro de la de éxito.
+        // Tope de seguridad, igual que en `previas`: si alguna llamada muriera sin
+        // que nadie consumiera su cambio, el mapa no puede crecer sin fin.
+        if (this.cambios.size > 256)
+            this.cambios.clear();
+        this.cambios.set(idLlamada, { ruta: previa.ruta, antes: previa.antes, despues });
+        // El orden es: sintaxis → reparación → tipos. No es arbitrario.
+        //
+        // Si el fichero no parsea, los errores de tipos son CONSECUENCIA de eso:
+        // enseñarlos mandaría al modelo a perseguir síntomas en vez de la causa.
+        // Y si la reparación funciona, los tipos hay que mirarlos sobre el
+        // fichero YA REPARADO, no sobre el roto — mirarlos antes daría una lista
+        // de errores que dejan de existir un instante después.
+        if (!rompioElParseo({ ruta: previa.ruta, antes: previa.antes, despues })) {
+            await anotarEnDiario(this.agentDir(), { ruta: previa.ruta, antes: previa.antes, despues, resultado: "ok" });
+            if (despues === null)
+                return null;
+            // Los tipos, que es lo que un comprobador de sintaxis nunca puede ver:
+            // cambiar una firma y romper a quien la llama en OTRO fichero.
+            return avisoDeTipos(previa.ruta, this.tipos.introducidos(previa.ruta, previa.antes, despues));
+        }
+        // `rompioElParseo` solo devuelve `true` cuando `antes` y `despues` no son
+        // `null` (así lo garantiza su propio contrato en parseo.ts) — el cast de
+        // abajo es ese contrato leído, no una suposición nueva.
+        //
+        // Todo este bloque va protegido: un fallo aquí (disco lleno, permisos, el
+        // fichero borrado por debajo entre la edición y este punto) no puede
+        // tumbar el turno entero solo por intentar mejorar el aviso — se degrada
+        // al aviso normal de parseo roto, igual que si la reparación se hubiera
+        // rechazado.
+        let reparacion;
+        try {
+            reparacion = await intentarReparar({ ruta: previa.ruta, antes: previa.antes, despues: despues }, this.completar);
+            if (reparacion.estado === "reparado") {
+                await writeFile(previa.ruta, reparacion.contenido, "utf-8");
+            }
+        }
+        catch {
+            reparacion = { estado: "rechazada" };
+        }
+        if (reparacion.estado === "reparado") {
+            // El libro tiene que llevar el hash de lo que QUEDÓ en disco, no el del
+            // intermedio roto que la reparación acaba de sobrescribir: si no, el hash
+            // del registro no coincidiría con el fichero y la auditoría acusaría una
+            // manipulación donde solo hubo una reparación.
+            this.cambios.set(idLlamada, { ruta: previa.ruta, antes: previa.antes, despues: reparacion.contenido });
+            await anotarEnDiario(this.agentDir(), {
+                ruta: previa.ruta,
+                antes: previa.antes,
+                despues,
+                resultado: "reparada",
+            });
+            const intentos = reparacion.intentos > 1 ? ` (hicieron falta ${reparacion.intentos} intentos)` : "";
+            // Sobre el fichero YA reparado: reparar la sintaxis no garantiza que
+            // los tipos cuadren, y callarlo aquí convertiría un "✓ reparado" en una
+            // media verdad.
+            const tipos = avisoDeTipos(previa.ruta, this.tipos.introducidos(previa.ruta, previa.antes, reparacion.contenido));
+            const nota = `✓ Esta edición dejó \`${previa.ruta}\` sintácticamente roto, pero se ha reparado sola conservando el cambio pretendido${intentos}.`;
+            return tipos ? `${nota}\n${tipos}` : nota;
+        }
+        void anotarEnDiario(this.agentDir(), {
+            ruta: previa.ruta,
+            antes: previa.antes,
+            despues,
+            resultado: reparacion.estado === "rechazada" ? "reparacion-rechazada" : "rota",
+        });
+        return avisoDeParseoRoto(previa.ruta, primerErrorDe(despues ?? "", previa.ruta));
+    }
+}
+//# sourceMappingURL=observador.js.map

package/dist/core/edicion/observador.js.map

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

package/dist/core/edicion/parecido.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Casar un bloque que el modelo retecleó con una errata.
+ *
+ * EL CASO. El modelo quiere cambiar una línea y, para dar contexto, retipea las
+ * de alrededor. Al retipear se equivoca en una letra:
+ *
+ *     for (const it of item) {      ← el fichero dice `items`
+ *         suma += it.precio;
+ *     }
+ *
+ * Hoy eso se rechaza entero y cuesta un turno. Y es un error frecuente: cuanto
+ * más contexto pedimos, más superficie tiene el modelo para equivocarse en algo
+ * que no pretendía cambiar.
+ *
+ * LO QUE COPIAMOS DE oh-my-pi, Y LO QUE NO. Ellos localizan por parecido con
+ * Levenshtein (`edit/modes/replace.ts:449`), y eso está bien. Lo que hacen
+ * después NO: escriben el `newText` del modelo tal cual, erratas incluidas.
+ * Medido sobre este mismo caso, su motor produce un fichero con `item` — una
+ * variable que no existe — y no compila. Aplicar no es aplicar bien.
+ *
+ * LA IDEA QUE LO ARREGLA, y es la razón de este módulo: el modelo no está
+ * proponiendo el contexto, está CITÁNDOLO. Solo las líneas donde `oldText` y
+ * `newText` DIFIEREN entre sí son su propuesta; las que repite idénticas son
+ * una cita, y una cita con errata sigue señalando al original. Así que se casa
+ * por parecido, y luego se escribe la versión del FICHERO para todo lo que el
+ * modelo no pidió cambiar.
+ *
+ * TRES PUERTAS, porque sin ellas esta pasada compra una recuperación y paga
+ * varias corrupciones:
+ *
+ *   1. **Umbral alto.** 0,92 de similitud media por línea. Por debajo, no es
+ *      una errata: es otro sitio.
+ *   2. **Dominancia.** El mejor candidato tiene que ganarle al segundo por un
+ *      margen claro. Dos posiciones parecidas significa que no sabemos cuál
+ *      quería, y elegir por el modelo es peor que rechazar.
+ *   3. **Las líneas citadas se leen del fichero, no del modelo.** Es la que
+ *      convierte una recuperación arriesgada en una segura.
+ */
+export interface CasadoPorParecido {
+    indice: number;
+    longitud: number;
+    /** Ya empalmado: propuesta del modelo donde la hubo, fichero donde no. */
+    textoNuevo: string;
+}
+/**
+ * Casa `oldText` contra `contenido` tolerando erratas, y construye el texto
+ * nuevo respetando las líneas que el modelo solo citaba.
+ *
+ * Devuelve `null` cuando no hay candidato claro. `null` significa «no puedo»,
+ * nunca «no hay»: quien llama debe seguir con su propio error.
+ */
+export declare function casarPorParecido(contenido: string, oldText: string, newText: string): CasadoPorParecido | null;
+//# sourceMappingURL=parecido.d.ts.map

package/dist/core/edicion/parecido.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parecido.d.ts","sourceRoot":"","sources":["../../../src/core/edicion/parecido.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAwCH,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAoD9G"}

package/dist/core/edicion/parecido.js

@@ -0,0 +1,145 @@
+/**
+ * Casar un bloque que el modelo retecleó con una errata.
+ *
+ * EL CASO. El modelo quiere cambiar una línea y, para dar contexto, retipea las
+ * de alrededor. Al retipear se equivoca en una letra:
+ *
+ *     for (const it of item) {      ← el fichero dice `items`
+ *         suma += it.precio;
+ *     }
+ *
+ * Hoy eso se rechaza entero y cuesta un turno. Y es un error frecuente: cuanto
+ * más contexto pedimos, más superficie tiene el modelo para equivocarse en algo
+ * que no pretendía cambiar.
+ *
+ * LO QUE COPIAMOS DE oh-my-pi, Y LO QUE NO. Ellos localizan por parecido con
+ * Levenshtein (`edit/modes/replace.ts:449`), y eso está bien. Lo que hacen
+ * después NO: escriben el `newText` del modelo tal cual, erratas incluidas.
+ * Medido sobre este mismo caso, su motor produce un fichero con `item` — una
+ * variable que no existe — y no compila. Aplicar no es aplicar bien.
+ *
+ * LA IDEA QUE LO ARREGLA, y es la razón de este módulo: el modelo no está
+ * proponiendo el contexto, está CITÁNDOLO. Solo las líneas donde `oldText` y
+ * `newText` DIFIEREN entre sí son su propuesta; las que repite idénticas son
+ * una cita, y una cita con errata sigue señalando al original. Así que se casa
+ * por parecido, y luego se escribe la versión del FICHERO para todo lo que el
+ * modelo no pidió cambiar.
+ *
+ * TRES PUERTAS, porque sin ellas esta pasada compra una recuperación y paga
+ * varias corrupciones:
+ *
+ *   1. **Umbral alto.** 0,92 de similitud media por línea. Por debajo, no es
+ *      una errata: es otro sitio.
+ *   2. **Dominancia.** El mejor candidato tiene que ganarle al segundo por un
+ *      margen claro. Dos posiciones parecidas significa que no sabemos cuál
+ *      quería, y elegir por el modelo es peor que rechazar.
+ *   3. **Las líneas citadas se leen del fichero, no del modelo.** Es la que
+ *      convierte una recuperación arriesgada en una segura.
+ */
+/** Distancia de edición, acotada: si supera `tope` se corta y devuelve `tope + 1`. */
+function distancia(a, b, tope) {
+    if (a === b)
+        return 0;
+    if (Math.abs(a.length - b.length) > tope)
+        return tope + 1;
+    // Una sola fila: no hace falta la matriz entera para una distancia acotada.
+    let anterior = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const actual = [i];
+        let minimoDeLaFila = i;
+        for (let j = 1; j <= b.length; j++) {
+            const coste = a[i - 1] === b[j - 1] ? 0 : 1;
+            const v = Math.min(actual[j - 1] + 1, anterior[j] + 1, anterior[j - 1] + coste);
+            actual.push(v);
+            if (v < minimoDeLaFila)
+                minimoDeLaFila = v;
+        }
+        // Toda la fila supera el tope: no hay forma de bajar de ahí.
+        if (minimoDeLaFila > tope)
+            return tope + 1;
+        anterior = actual;
+    }
+    return anterior[b.length];
+}
+/** 1 = idénticas, 0 = nada que ver. Sobre el texto recortado. */
+function similitud(a, b) {
+    const x = a.trim();
+    const y = b.trim();
+    if (x === y)
+        return 1;
+    if (x.length === 0 || y.length === 0)
+        return 0;
+    const largo = Math.max(x.length, y.length);
+    const tope = Math.ceil(largo * 0.2); // más allá no interesa: ya está por debajo del umbral
+    const d = distancia(x, y, tope);
+    return d > tope ? 0 : 1 - d / largo;
+}
+const UMBRAL = 0.92;
+/** Cuánto tiene que ganarle el mejor al segundo para que no sea ambiguo. */
+const MARGEN = 0.05;
+/**
+ * Casa `oldText` contra `contenido` tolerando erratas, y construye el texto
+ * nuevo respetando las líneas que el modelo solo citaba.
+ *
+ * Devuelve `null` cuando no hay candidato claro. `null` significa «no puedo»,
+ * nunca «no hay»: quien llama debe seguir con su propio error.
+ */
+export function casarPorParecido(contenido, oldText, newText) {
+    const patron = oldText.split("\n");
+    const propuesta = newText.split("\n");
+    // Con una sola línea no hay contexto que distinguir de la propuesta: todo
+    // sería propuesta, y entonces esta pasada no aporta nada sobre las de arriba.
+    if (patron.length < 2)
+        return null;
+    const lineas = contenido.split("\n");
+    if (patron.length > lineas.length)
+        return null;
+    let mejor = -1;
+    let mejorPuntuacion = 0;
+    let segundaPuntuacion = 0;
+    for (let i = 0; i + patron.length <= lineas.length; i++) {
+        let suma = 0;
+        for (let j = 0; j < patron.length; j++)
+            suma += similitud(lineas[i + j], patron[j]);
+        const puntuacion = suma / patron.length;
+        if (puntuacion > mejorPuntuacion) {
+            segundaPuntuacion = mejorPuntuacion;
+            mejorPuntuacion = puntuacion;
+            mejor = i;
+        }
+        else if (puntuacion > segundaPuntuacion) {
+            segundaPuntuacion = puntuacion;
+        }
+    }
+    // Puerta 1: por debajo del umbral no es una errata, es otro sitio.
+    if (mejor < 0 || mejorPuntuacion < UMBRAL)
+        return null;
+    // Puerta 2: dos candidatos parecidos = no sabemos cuál quería.
+    if (mejorPuntuacion - segundaPuntuacion < MARGEN)
+        return null;
+    // Y si casaba EXACTO, esta pasada no pinta nada: la de arriba ya lo cogió.
+    if (mejorPuntuacion === 1)
+        return null;
+    // Puerta 3, la que hace segura la recuperación.
+    //
+    // Solo las líneas donde `oldText` y `newText` DIFIEREN son propuesta del
+    // modelo. Las que repite idénticas son una CITA, y una cita con errata sigue
+    // señalando al original: se escribe lo que el fichero dice, no lo que el
+    // modelo tecleó. Sin esto, la errata entraría en el fichero — que es
+    // exactamente lo que hace oh-my-pi y por lo que su motor produce código que
+    // no compila.
+    //
+    // Solo se puede alinear línea a línea cuando el modelo mandó el mismo número
+    // de líneas. Si añadió o quitó, no hay correspondencia y se rechaza: no se
+    // adivina.
+    if (propuesta.length !== patron.length)
+        return null;
+    const bloque = lineas.slice(mejor, mejor + patron.length);
+    const resultado = propuesta.map((linea, j) => (linea === patron[j] ? bloque[j] : linea));
+    let indice = 0;
+    for (let i = 0; i < mejor; i++)
+        indice += lineas[i].length + 1;
+    const longitud = bloque.reduce((n, l) => n + l.length + 1, 0) - 1;
+    return { indice, longitud, textoNuevo: resultado.join("\n") };
+}
+//# sourceMappingURL=parecido.js.map

package/dist/core/edicion/parecido.js.map

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