@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/banco/cow-isolation.d.ts

@@ -0,0 +1,74 @@
+/**
+ * CoWIsolation — aislamiento multi-FS con merge-back 3-way.
+ *
+ * Usa overlay temp dir + copy-on-write (copia ficheros al escribir, no antes).
+ * mergeBack aplica solo cambios que no conflictúan con base actual (3-way).
+ *
+ * Flujo típico:
+ *   const cow = new CoWIsolation();
+ *   await cow.snapshot(["/tmp/a.txt", "/tmp/b.txt"]);
+ *   await cow.runInIsolated(async (ctx) => {
+ *     await ctx.writeFile("/tmp/a.txt", "nuevo");
+ *   });
+ *   const result = await cow.mergeBack(); // 3-way
+ */
+export interface MergeResult {
+    applied: string[];
+    conflicts: string[];
+    unchanged: string[];
+}
+export declare class CoWIsolation {
+    private overlayDir;
+    private baseSnapshots;
+    private overlayWrites;
+    constructor(options?: {
+        overlayDir?: string;
+    });
+    /** Directorio overlay (expuesto para tests / diagnóstico). */
+    getOverlayDir(): string;
+    /** True si el path tiene copia en overlay (se escribió tras snapshot). */
+    hasOverlayCopy(filePath: string): boolean;
+    /** Ficheros con snapshot capturado. */
+    getSnapshotPaths(): string[];
+    /** Captura el contenido base de cada path. No copia ficheros al overlay. */
+    snapshot(fsPaths: string[]): Promise<void>;
+    snapshotSync(fsPaths: string[]): void;
+    /**
+     * Lectura con vista CoW: si hay escritura en overlay, devuelve esa;
+     * si no, lee del disco.
+     */
+    readFile(filePath: string): Promise<Buffer | null>;
+    readFileSync(filePath: string): Buffer | null;
+    /** Escritura CoW: no toca el disco base, solo overlay. */
+    writeFile(filePath: string, content: string | Buffer): Promise<void>;
+    writeFileSync(filePath: string, content: string | Buffer): void;
+    /** Borrado CoW: marca como eliminado en overlay, no borra base hasta mergeBack. */
+    deleteFile(filePath: string): Promise<void>;
+    deleteFileSync(filePath: string): void;
+    /**
+     * Ejecuta task dentro del contexto aislado. La task recibe `this` como
+     * contexto para que pueda usar writeFile/readFile CoW. Si la task no espera
+     * argumento, se invoca sin él.
+     */
+    runInIsolated(task: (ctx: CoWIsolation) => Promise<void> | void): Promise<void>;
+    /**
+     * 3-way merge: aplica al disco base solo los cambios de overlay que no
+     * conflictúan con la base actual.
+     *
+     * - Si overlay no cambió vs snapshot → unchanged (no se aplica)
+     * - Si overlay cambió y base no cambió vs snapshot → applied (se escribe)
+     * - Si ambos cambiaron pero al mismo valor → unchanged/applied sin escritura extra (sin conflicto)
+     * - Si ambos cambiaron a valores distintos → conflicts (se conserva base)
+     *
+     * @param changes - si se pasa, solo considera esos paths; si no, todos los
+     *                  paths con escritura en overlay.
+     */
+    mergeBack(changes?: string[]): Promise<MergeResult>;
+    mergeBackSync(changes?: string[]): MergeResult;
+    private applyToDisk;
+    /** Limpia overlay temp dir y estado en memoria. */
+    dispose(): void;
+    /** Alias para dispose — permite `using`. */
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=cow-isolation.d.ts.map

package/dist/core/banco/cow-isolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cow-isolation.d.ts","sourceRoot":"","sources":["../../../src/core/banco/cow-isolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AAmDD,qBAAa,YAAY;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,aAAa,CAAoC;gBAE7C,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAS7C,8DAA8D;IAC9D,aAAa,IAAI,MAAM;IAIvB,0EAA0E;IAC1E,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC,uCAAuC;IACvC,gBAAgB,IAAI,MAAM,EAAE;IAI5B,4EAA4E;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAWrC;;;OAGG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO7C,0DAA0D;IACpD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmB/D,mFAAmF;IAC7E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBtC;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrF;;;;;;;;;;;OAWG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAIzD,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW;IAyC9C,OAAO,CAAC,WAAW;IAenB,mDAAmD;IACnD,OAAO,IAAI,IAAI;IAUf,4CAA4C;IAC5C,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}

package/dist/core/banco/cow-isolation.js

@@ -0,0 +1,259 @@
+/**
+ * CoWIsolation — aislamiento multi-FS con merge-back 3-way.
+ *
+ * Usa overlay temp dir + copy-on-write (copia ficheros al escribir, no antes).
+ * mergeBack aplica solo cambios que no conflictúan con base actual (3-way).
+ *
+ * Flujo típico:
+ *   const cow = new CoWIsolation();
+ *   await cow.snapshot(["/tmp/a.txt", "/tmp/b.txt"]);
+ *   await cow.runInIsolated(async (ctx) => {
+ *     await ctx.writeFile("/tmp/a.txt", "nuevo");
+ *   });
+ *   const result = await cow.mergeBack(); // 3-way
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+function hashPath(p) {
+    return createHash("sha256").update(p).digest("hex").slice(0, 16);
+}
+function buffersEqual(a, b) {
+    if (a === null && b === null)
+        return true;
+    if (a === null || b === null)
+        return false;
+    return a.equals(b);
+}
+function readCurrent(filePath) {
+    try {
+        if (!existsSync(filePath))
+            return null;
+        const st = statSync(filePath);
+        if (st.isDirectory())
+            return null;
+        return readFileSync(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+function collectFilesRecursively(entry, out) {
+    try {
+        if (!existsSync(entry)) {
+            out.push(entry);
+            return;
+        }
+        const st = statSync(entry);
+        if (st.isFile()) {
+            out.push(entry);
+            return;
+        }
+        if (st.isDirectory()) {
+            const children = readdirSync(entry);
+            if (children.length === 0) {
+                // directorio vacío — lo tratamos como entrada sin ficheros
+                return;
+            }
+            for (const child of children) {
+                collectFilesRecursively(join(entry, child), out);
+            }
+            return;
+        }
+        out.push(entry);
+    }
+    catch {
+        out.push(entry);
+    }
+}
+export class CoWIsolation {
+    overlayDir;
+    baseSnapshots = new Map();
+    overlayWrites = new Map();
+    constructor(options) {
+        if (options?.overlayDir) {
+            this.overlayDir = options.overlayDir;
+            mkdirSync(this.overlayDir, { recursive: true });
+        }
+        else {
+            this.overlayDir = mkdtempSync(join(tmpdir(), "ada-cow-"));
+        }
+    }
+    /** Directorio overlay (expuesto para tests / diagnóstico). */
+    getOverlayDir() {
+        return this.overlayDir;
+    }
+    /** True si el path tiene copia en overlay (se escribió tras snapshot). */
+    hasOverlayCopy(filePath) {
+        return this.overlayWrites.has(filePath);
+    }
+    /** Ficheros con snapshot capturado. */
+    getSnapshotPaths() {
+        return [...this.baseSnapshots.keys()];
+    }
+    /** Captura el contenido base de cada path. No copia ficheros al overlay. */
+    async snapshot(fsPaths) {
+        this.snapshotSync(fsPaths);
+    }
+    snapshotSync(fsPaths) {
+        const expanded = [];
+        for (const p of fsPaths) {
+            collectFilesRecursively(p, expanded);
+        }
+        for (const filePath of expanded) {
+            const content = readCurrent(filePath);
+            this.baseSnapshots.set(filePath, content);
+        }
+    }
+    /**
+     * Lectura con vista CoW: si hay escritura en overlay, devuelve esa;
+     * si no, lee del disco.
+     */
+    async readFile(filePath) {
+        return this.readFileSync(filePath);
+    }
+    readFileSync(filePath) {
+        if (this.overlayWrites.has(filePath)) {
+            return this.overlayWrites.get(filePath) ?? null;
+        }
+        return readCurrent(filePath);
+    }
+    /** Escritura CoW: no toca el disco base, solo overlay. */
+    async writeFile(filePath, content) {
+        this.writeFileSync(filePath, content);
+    }
+    writeFileSync(filePath, content) {
+        const buf = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
+        this.overlayWrites.set(filePath, buf);
+        // Persistir copia en overlay dir para cumplir "usa overlay temp dir"
+        const overlayFile = join(this.overlayDir, hashPath(filePath));
+        try {
+            writeFileSync(overlayFile, buf);
+        }
+        catch {
+            // best-effort — el mapa en memoria es la fuente de verdad
+        }
+        // También guardar índice para depuración
+        try {
+            const indexFile = join(this.overlayDir, `${hashPath(filePath)}.path`);
+            writeFileSync(indexFile, filePath, "utf-8");
+        }
+        catch {
+            // ignore
+        }
+    }
+    /** Borrado CoW: marca como eliminado en overlay, no borra base hasta mergeBack. */
+    async deleteFile(filePath) {
+        this.deleteFileSync(filePath);
+    }
+    deleteFileSync(filePath) {
+        this.overlayWrites.set(filePath, null);
+        const overlayFile = join(this.overlayDir, hashPath(filePath));
+        try {
+            writeFileSync(overlayFile, Buffer.alloc(0));
+        }
+        catch {
+            // ignore
+        }
+        try {
+            const marker = join(this.overlayDir, `${hashPath(filePath)}.deleted`);
+            writeFileSync(marker, "1", "utf-8");
+        }
+        catch {
+            // ignore
+        }
+    }
+    /**
+     * Ejecuta task dentro del contexto aislado. La task recibe `this` como
+     * contexto para que pueda usar writeFile/readFile CoW. Si la task no espera
+     * argumento, se invoca sin él.
+     */
+    async runInIsolated(task) {
+        if (task.length === 0) {
+            await task();
+        }
+        else {
+            await task(this);
+        }
+    }
+    /**
+     * 3-way merge: aplica al disco base solo los cambios de overlay que no
+     * conflictúan con la base actual.
+     *
+     * - Si overlay no cambió vs snapshot → unchanged (no se aplica)
+     * - Si overlay cambió y base no cambió vs snapshot → applied (se escribe)
+     * - Si ambos cambiaron pero al mismo valor → unchanged/applied sin escritura extra (sin conflicto)
+     * - Si ambos cambiaron a valores distintos → conflicts (se conserva base)
+     *
+     * @param changes - si se pasa, solo considera esos paths; si no, todos los
+     *                  paths con escritura en overlay.
+     */
+    async mergeBack(changes) {
+        return this.mergeBackSync(changes);
+    }
+    mergeBackSync(changes) {
+        const result = { applied: [], conflicts: [], unchanged: [] };
+        const candidates = changes ?? [...this.overlayWrites.keys()];
+        for (const filePath of candidates) {
+            if (!this.overlayWrites.has(filePath)) {
+                continue;
+            }
+            const snapshotContent = this.baseSnapshots.has(filePath) ? (this.baseSnapshots.get(filePath) ?? null) : null;
+            const overlayContent = this.overlayWrites.get(filePath) ?? null;
+            const currentContent = readCurrent(filePath);
+            const overlayChanged = !buffersEqual(overlayContent, snapshotContent);
+            const baseChanged = !buffersEqual(currentContent, snapshotContent);
+            if (!overlayChanged) {
+                result.unchanged.push(filePath);
+                continue;
+            }
+            if (!baseChanged) {
+                // base intacta → aplicar overlay
+                this.applyToDisk(filePath, overlayContent);
+                result.applied.push(filePath);
+                continue;
+            }
+            // ambos cambiaron
+            if (buffersEqual(overlayContent, currentContent)) {
+                // convergieron al mismo valor → no hay conflicto real
+                result.unchanged.push(filePath);
+                continue;
+            }
+            // conflicto: conservar base
+            result.conflicts.push(filePath);
+        }
+        return result;
+    }
+    applyToDisk(filePath, content) {
+        try {
+            if (content === null) {
+                if (existsSync(filePath)) {
+                    unlinkSync(filePath);
+                }
+                return;
+            }
+            mkdirSync(dirname(filePath), { recursive: true });
+            writeFileSync(filePath, content);
+        }
+        catch {
+            // best-effort: si falla escritura, el caller verá el fichero sin cambiar
+        }
+    }
+    /** Limpia overlay temp dir y estado en memoria. */
+    dispose() {
+        try {
+            rmSync(this.overlayDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+        this.baseSnapshots.clear();
+        this.overlayWrites.clear();
+    }
+    /** Alias para dispose — permite `using`. */
+    [Symbol.dispose]() {
+        this.dispose();
+    }
+}
+//# sourceMappingURL=cow-isolation.js.map

package/dist/core/banco/cow-isolation.js.map

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

package/dist/core/banco/ejecutar.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Ejecuta casos del banco contra un agente de verdad y separa las cuatro
+ * métricas que la tarea exige no mezclar: tarea, edición, fantasma, timeout.
+ *
+ * El agente que edita es INYECTABLE (`EjecutorDeCaso`) a propósito: la
+ * implementación real (`crearEjecutorReal`) llama al proveedor de verdad y
+ * cuesta dinero; los tests inyectan una versión determinista para probar que
+ * el propio banco DETECTA una edición rota sin gastar una sola llamada.
+ */
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { CasoBanco, ResultadoCaso, ResultadosEjecucion, ResumenMetricas } from "./tipos.ts";
+export interface EjecucionCaso {
+    /** Alguna llamada a `edit`/`write` intentó tocar el fichero objetivo. */
+    tocoFichero: boolean;
+    /** De las que lo tocaron, al menos una terminó sin error. */
+    edicionOk: boolean;
+    /**
+     * El modelo devolvió al menos un turno VACÍO (ni texto, ni razonamiento, ni
+     * llamadas). Opcional porque los ejecutores deterministas de los tests no
+     * hablan con ningún proveedor y no tienen turnos que mirar.
+     */
+    turnoVacio?: boolean;
+}
+export interface EjecutorDeCaso {
+    ejecutar(opciones: {
+        cwd: string;
+        rutaFichero: string;
+        prompt: string;
+    }): Promise<EjecucionCaso>;
+}
+export declare function resumirMetricas(resultados: ResultadoCaso[]): ResumenMetricas;
+export declare function ejecutarCasos(casos: CasoBanco[], ejecutor: EjecutorDeCaso, opciones: {
+    proveedor: string;
+    modelo: string;
+    casosArchivo: string;
+    onProgreso?: (i: number, total: number, r: ResultadoCaso) => void;
+}): Promise<ResultadosEjecucion>;
+/** Implementación real: agente de Ada con `read`/`edit`/`write`, contra el proveedor de verdad. */
+export declare function crearEjecutorReal(opciones: {
+    agentDir: string;
+    model?: Model<Api>;
+    timeoutMs: number;
+}): EjecutorDeCaso;
+//# sourceMappingURL=ejecutar.d.ts.map

package/dist/core/banco/ejecutar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ejecutar.d.ts","sourceRoot":"","sources":["../../../src/core/banco/ejecutar.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjG,MAAM,WAAW,aAAa;IAC7B,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;IACrB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjG;AA+DD,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,eAAe,CAuB5E;AAED,wBAAsB,aAAa,CAClC,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CAClE,GACC,OAAO,CAAC,mBAAmB,CAAC,CAqB9B;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,cAAc,CA0DjB"}

package/dist/core/banco/ejecutar.js

@@ -0,0 +1,183 @@
+/**
+ * Ejecuta casos del banco contra un agente de verdad y separa las cuatro
+ * métricas que la tarea exige no mezclar: tarea, edición, fantasma, timeout.
+ *
+ * El agente que edita es INYECTABLE (`EjecutorDeCaso`) a propósito: la
+ * implementación real (`crearEjecutorReal`) llama al proveedor de verdad y
+ * cuesta dinero; los tests inyectan una versión determinista para probar que
+ * el propio banco DETECTA una edición rota sin gastar una sola llamada.
+ */
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { estadoDelTurno } from "../turno-vacio/detectar.js";
+/** Normaliza el salto de línea final para no fallar por un `\n` de más o de menos. */
+function normalizar(contenido) {
+    return contenido.replace(/\n*$/, "\n");
+}
+async function ejecutarUnCaso(caso, ejecutor, raizTemp) {
+    const inicio = Date.now();
+    const cwd = mkdtempSync(join(raizTemp, "caso-"));
+    const rutaFichero = join(cwd, caso.ficheroRelativo);
+    mkdirSync(dirname(rutaFichero), { recursive: true });
+    writeFileSync(rutaFichero, caso.contenidoEntrada, "utf-8");
+    let timeout = false;
+    let tocoFichero = false;
+    let edicionOk = false;
+    let turnoVacio = false;
+    let error;
+    try {
+        const resultado = await ejecutor.ejecutar({ cwd, rutaFichero: caso.ficheroRelativo, prompt: caso.prompt });
+        tocoFichero = resultado.tocoFichero;
+        edicionOk = resultado.edicionOk;
+        turnoVacio = resultado.turnoVacio === true;
+    }
+    catch (err) {
+        if (err instanceof Error && err.message === "__timeout__") {
+            timeout = true;
+        }
+        else {
+            error = err instanceof Error ? err.message : String(err);
+        }
+    }
+    let tareaOk = false;
+    try {
+        tareaOk = normalizar(readFileSync(rutaFichero, "utf-8")) === normalizar(caso.contenidoEsperado);
+    }
+    catch {
+        tareaOk = false;
+    }
+    rmSync(cwd, { recursive: true, force: true });
+    return {
+        casoId: caso.id,
+        dificultad: caso.dificultad,
+        mutacion: caso.mutacion,
+        tareaOk,
+        edicionOk: tocoFichero && edicionOk,
+        // Fantasma: nunca tocó el fichero, Y el turno terminó de verdad. Un
+        // timeout no es un fantasma (no dio tiempo a saberlo) y un ERROR
+        // tampoco (no se pudo saberlo, punto — una llamada sin API key no
+        // es un modelo "que decidió no editar").
+        //
+        // Un turno VACÍO tampoco: el modelo no contestó, así que no hay
+        // decisión suya que contar. Es el mismo error de leer un fallo como
+        // éxito que ya obligó a sacar `error` de esta cuenta.
+        fantasma: !tocoFichero && !timeout && !error && !turnoVacio,
+        vacio: turnoVacio,
+        timeout,
+        duracionMs: Date.now() - inicio,
+        error,
+    };
+}
+export function resumirMetricas(resultados) {
+    const total = resultados.length;
+    const pct = (n) => (total === 0 ? 0 : Math.round((n / total) * 1000) / 10);
+    const porDificultad = {};
+    for (const dificultad of new Set(resultados.map((r) => r.dificultad))) {
+        const delGrupo = resultados.filter((r) => r.dificultad === dificultad);
+        const pctGrupo = (n) => (delGrupo.length === 0 ? 0 : Math.round((n / delGrupo.length) * 1000) / 10);
+        porDificultad[dificultad] = {
+            total: delGrupo.length,
+            tareaOkPct: pctGrupo(delGrupo.filter((r) => r.tareaOk).length),
+            edicionOkPct: pctGrupo(delGrupo.filter((r) => r.edicionOk).length),
+        };
+    }
+    return {
+        total,
+        tareaOkPct: pct(resultados.filter((r) => r.tareaOk).length),
+        edicionOkPct: pct(resultados.filter((r) => r.edicionOk).length),
+        fantasmaPct: pct(resultados.filter((r) => r.fantasma).length),
+        vacioPct: pct(resultados.filter((r) => r.vacio).length),
+        timeoutPct: pct(resultados.filter((r) => r.timeout).length),
+        errorPct: pct(resultados.filter((r) => Boolean(r.error)).length),
+        porDificultad,
+    };
+}
+export async function ejecutarCasos(casos, ejecutor, opciones) {
+    const raizTemp = mkdtempSync(join(tmpdir(), "ada-banco-"));
+    const resultados = [];
+    try {
+        for (let i = 0; i < casos.length; i++) {
+            const r = await ejecutarUnCaso(casos[i], ejecutor, raizTemp);
+            resultados.push(r);
+            opciones.onProgreso?.(i + 1, casos.length, r);
+        }
+    }
+    finally {
+        rmSync(raizTemp, { recursive: true, force: true });
+    }
+    return {
+        version: 1,
+        ejecutadoEn: new Date().toISOString(),
+        proveedor: opciones.proveedor,
+        modelo: opciones.modelo,
+        casosArchivo: opciones.casosArchivo,
+        resultados,
+        resumen: resumirMetricas(resultados),
+    };
+}
+/** Implementación real: agente de Ada con `read`/`edit`/`write`, contra el proveedor de verdad. */
+export function crearEjecutorReal(opciones) {
+    return {
+        async ejecutar({ cwd, rutaFichero, prompt }) {
+            const { createAgentSession } = await import("../sdk.js");
+            const { SessionManager } = await import("../session-manager.js");
+            const { session } = await createAgentSession({
+                cwd,
+                agentDir: opciones.agentDir,
+                model: opciones.model,
+                tools: ["read", "edit", "write"],
+                sessionManager: SessionManager.inMemory(cwd),
+            });
+            const objetivo = resolve(cwd, rutaFichero);
+            const pendientes = new Map();
+            let tocoFichero = false;
+            let edicionOk = false;
+            let turnoVacio = false;
+            const desuscribir = session.subscribe((evento) => {
+                // Un turno sin nada dentro se contaba como fantasma («el modelo
+                // decidió no editar»). Se mira aquí, en el mismo sitio donde ya
+                // se escuchan las ediciones, y con el MISMO detector que usa la
+                // sesión interactiva.
+                if (evento.type === "message_end" && evento.message.role === "assistant") {
+                    if (estadoDelTurno(evento.message) === "vacio")
+                        turnoVacio = true;
+                }
+                if (evento.type === "tool_execution_start" && (evento.toolName === "edit" || evento.toolName === "write")) {
+                    const args = evento.args;
+                    const cruda = args?.file_path ?? args?.path;
+                    pendientes.set(evento.toolCallId, typeof cruda === "string" ? resolve(cwd, cruda) : null);
+                }
+                else if (evento.type === "tool_execution_end") {
+                    const ruta = pendientes.get(evento.toolCallId);
+                    pendientes.delete(evento.toolCallId);
+                    if (ruta !== objetivo)
+                        return;
+                    tocoFichero = true;
+                    if (!evento.isError)
+                        edicionOk = true;
+                }
+            });
+            let expiro = false;
+            try {
+                await Promise.race([
+                    session.prompt(prompt),
+                    new Promise((_resolve, reject) => {
+                        setTimeout(() => {
+                            expiro = true;
+                            reject(new Error("__timeout__"));
+                        }, opciones.timeoutMs);
+                    }),
+                ]);
+            }
+            finally {
+                desuscribir();
+                if (expiro)
+                    await session.abort();
+                session.dispose();
+            }
+            return { tocoFichero, edicionOk, turnoVacio };
+        },
+    };
+}
+//# sourceMappingURL=ejecutar.js.map

package/dist/core/banco/ejecutar.js.map

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

package/dist/core/banco/generar.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Orquesta la generación de casos: elige fichero, aplica una mutación,
+ * construye el bloque único y lo valida RESOLVIÉNDOLO antes de admitirlo.
+ *
+ * Un caso ambiguo (el bloque no se puede hacer único, o resolverlo no
+ * reproduce el fichero esperado byte a byte) se descarta y se cuenta — la
+ * puerta de la tarea exige poder enseñar ese número, no solo el de casos
+ * generados. Si `--casos 20` descarta cero, hay que poder decirlo y
+ * sospechar, no callarlo.
+ */
+import { TODAS_LAS_MUTACIONES } from "./mutaciones.ts";
+import type { CasoBanco, ConjuntoCasos, Dificultad } from "./tipos.ts";
+/** LCG determinista: misma semilla, misma secuencia de casos siempre. */
+export declare function crearRngSemilla(semilla: number): () => number;
+export interface OpcionesGeneracion {
+    corpus: string;
+    numCasos: number;
+    semilla?: number;
+    dificultades?: Dificultad[];
+    mutaciones?: typeof TODAS_LAS_MUTACIONES;
+}
+export declare function generarCasos(opciones: OpcionesGeneracion): ConjuntoCasos;
+export declare function rutaAbsolutaDeCaso(caso: CasoBanco, corpus: string): string;
+//# sourceMappingURL=generar.d.ts.map

package/dist/core/banco/generar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generar.d.ts","sourceRoot":"","sources":["../../../src/core/banco/generar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAA0B,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKvE,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,MAAM,CAM7D;AAmED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,oBAAoB,CAAC;CACzC;AAID,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,aAAa,CAwGxE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1E"}