@hoilab/ada-cli 0.85.0 → 0.85.1

package/dist/core/gc/blobs-gc.js

@@ -0,0 +1,143 @@
+/**
+ * GC de blobs por referencias con gracia.
+ *
+ * Recorre sessions (JSONL) buscando sha256 (64 hex) referenciados, construye
+ * Set<hash>, y purga del AlmacenDeBlobs las entradas no referenciadas cuya
+ * edad supera la gracia (por defecto 7 días). También limpia ficheros sueltos
+ * en <agentDir>/blobs/<sha256> si existen (cache de disco por hash).
+ */
+import { existsSync } from "node:fs";
+import { readdir, readFile, stat, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { AlmacenDeBlobs } from "../blobs/almacen.js";
+const SHA256_RE = /[0-9a-fA-F]{64}/g;
+const DEFAULT_TTL_DIAS = 7;
+async function recolectarHashesReferenciados(sessionsDir) {
+    const refs = new Set();
+    if (!existsSync(sessionsDir))
+        return refs;
+    const stack = [sessionsDir];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries = [];
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry);
+            let st;
+            try {
+                st = await stat(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                // no entrar en cold/ para no re-referenciar archivados
+                if (entry === "cold")
+                    continue;
+                stack.push(full);
+                continue;
+            }
+            if (!entry.endsWith(".jsonl"))
+                continue;
+            // tombstones no aportan referencias reales; saltar si parece tombstone
+            try {
+                const text = await readFile(full, "utf-8");
+                if (text.trimStart().startsWith('{"_cold"'))
+                    continue;
+                let m = SHA256_RE.exec(text);
+                while (m !== null) {
+                    refs.add(m[0].toLowerCase());
+                    m = SHA256_RE.exec(text);
+                }
+            }
+            catch {
+                // fichero ilegible — ignorar
+            }
+        }
+    }
+    return refs;
+}
+export async function gcBlobs(opciones) {
+    const ttlDias = opciones.ttlDias ?? DEFAULT_TTL_DIAS;
+    const ahora = opciones.ahora ?? Date.now();
+    const graciaMs = ttlDias * 24 * 60 * 60 * 1000;
+    const sessionsDir = opciones.sessionsDir ?? join(opciones.agentDir, "sessions");
+    const referenciados = await recolectarHashesReferenciados(sessionsDir);
+    const almacen = new AlmacenDeBlobs(opciones.agentDir);
+    await almacen.cargar();
+    // Inspeccionar entradas internas via volcado temporal del fichero
+    // AlmacenDeBlobs no expone iterador público; leemos el fichero directamente
+    // para no mutar estado antes de decidir.
+    let entradas = {};
+    try {
+        const raw = await readFile(almacen.rutaFichero, "utf-8");
+        const doc = JSON.parse(raw);
+        entradas = doc.entradas ?? {};
+    }
+    catch {
+        entradas = {};
+    }
+    const total = Object.keys(entradas).length;
+    const borradasClaves = [];
+    for (const [clave, entrada] of Object.entries(entradas)) {
+        const hash = clave.split("|").pop()?.toLowerCase() ?? "";
+        if (referenciados.has(hash))
+            continue;
+        const edad = ahora - (entrada.usadoEn ?? 0);
+        if (edad < graciaMs)
+            continue;
+        const proveedor = clave.split("|")[0] ?? "";
+        if (!opciones.dryRun) {
+            almacen.olvidar(proveedor, hash);
+        }
+        borradasClaves.push(clave);
+    }
+    if (!opciones.dryRun && borradasClaves.length > 0) {
+        await almacen.volcar();
+    }
+    // Ficheros sueltos en <agentDir>/blobs/  (por si existe cache de blobs en disco por hash)
+    let ficherosSueltosBorrados = 0;
+    const blobsDir = join(opciones.agentDir, "blobs");
+    if (existsSync(blobsDir)) {
+        try {
+            const files = await readdir(blobsDir);
+            for (const f of files) {
+                const hash = f.toLowerCase();
+                if (!/^[0-9a-f]{64}$/.test(hash))
+                    continue;
+                if (referenciados.has(hash))
+                    continue;
+                // comprobar gracia por mtime del fichero
+                const p = join(blobsDir, f);
+                try {
+                    const st = await stat(p);
+                    if (ahora - st.mtimeMs < graciaMs)
+                        continue;
+                    if (!opciones.dryRun)
+                        await unlink(p);
+                    ficherosSueltosBorrados++;
+                }
+                catch {
+                    // ignorar
+                }
+            }
+        }
+        catch {
+            // dir ilegible
+        }
+    }
+    return {
+        referenciados: referenciados.size,
+        entradasTotales: total,
+        borradas: borradasClaves.length,
+        borradasClaves,
+        conservadas: total - borradasClaves.length,
+        ficherosSueltosBorrados,
+    };
+}
+//# sourceMappingURL=blobs-gc.js.map

package/dist/core/gc/blobs-gc.js.map

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

package/dist/core/gc/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GC de almacenamiento productivo — CLI-06.
+ *
+ * Orquesta: blobs por referencias con gracia, archivo frío gzip+tombstone,
+ * reconciliación stats/history, WAL TRUNCATE y breaker-lock.
+ *
+ * Wiring CLI: expone `ejecutarGC(opts)`; el builtin futuro es 1 línea:
+ *   pi.registerCommand("gc", { handler: (args) => ejecutarGC({ agentDir, ... }) })
+ * o `ada gc` / `ada maintenance gc` vía args.ts (patrón C01/D07).
+ */
+import { archivarSesionesFrias } from "./archivo-frio.ts";
+import { gcBlobs } from "./blobs-gc.ts";
+import { reconciliar } from "./reconciliacion.ts";
+import { walCheckpoint } from "./wal.ts";
+export type { OpcionesArchivoFrio, ResultadoArchivoFrio } from "./archivo-frio.ts";
+export { archivarSesionesFrias, rehidratarSesion } from "./archivo-frio.ts";
+export type { OpcionesGcBlobs, ResultadoGcBlobs } from "./blobs-gc.ts";
+export { gcBlobs } from "./blobs-gc.ts";
+export { adquirirLockGc, GcLockError } from "./lock.ts";
+export type { ResultadoReconciliacion } from "./reconciliacion.ts";
+export { reconciliar } from "./reconciliacion.ts";
+export type { ResultadoWal } from "./wal.ts";
+export { walCheckpoint } from "./wal.ts";
+export interface OpcionesGC {
+    agentDir: string;
+    sessionsDir?: string;
+    ttlDiasBlobs?: number;
+    ttlDiasFrio?: number;
+    dryRun?: boolean;
+    ahora?: number;
+    skipWal?: boolean;
+    skipArchivoFrio?: boolean;
+    skipReconciliacion?: boolean;
+}
+export interface ResultadoGC {
+    blobs: Awaited<ReturnType<typeof gcBlobs>>;
+    archivoFrio: Awaited<ReturnType<typeof archivarSesionesFrias>> | null;
+    reconciliacion: Awaited<ReturnType<typeof reconciliar>> | null;
+    wal: Awaited<ReturnType<typeof walCheckpoint>> | null;
+}
+export declare function ejecutarGC(opciones: OpcionesGC): Promise<ResultadoGC>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/gc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/gc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,UAAU;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC;IAC3C,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,GAAG,IAAI,CAAC;IACtE,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC;CACtD;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA+B3E"}

package/dist/core/gc/index.js

@@ -0,0 +1,50 @@
+/**
+ * GC de almacenamiento productivo — CLI-06.
+ *
+ * Orquesta: blobs por referencias con gracia, archivo frío gzip+tombstone,
+ * reconciliación stats/history, WAL TRUNCATE y breaker-lock.
+ *
+ * Wiring CLI: expone `ejecutarGC(opts)`; el builtin futuro es 1 línea:
+ *   pi.registerCommand("gc", { handler: (args) => ejecutarGC({ agentDir, ... }) })
+ * o `ada gc` / `ada maintenance gc` vía args.ts (patrón C01/D07).
+ */
+import { archivarSesionesFrias } from "./archivo-frio.js";
+import { gcBlobs } from "./blobs-gc.js";
+import { adquirirLockGc } from "./lock.js";
+import { reconciliar } from "./reconciliacion.js";
+import { walCheckpoint } from "./wal.js";
+export { archivarSesionesFrias, rehidratarSesion } from "./archivo-frio.js";
+export { gcBlobs } from "./blobs-gc.js";
+export { adquirirLockGc, GcLockError } from "./lock.js";
+export { reconciliar } from "./reconciliacion.js";
+export { walCheckpoint } from "./wal.js";
+export async function ejecutarGC(opciones) {
+    const liberar = await adquirirLockGc({ agentDir: opciones.agentDir });
+    try {
+        const blobs = await gcBlobs({
+            agentDir: opciones.agentDir,
+            sessionsDir: opciones.sessionsDir,
+            ttlDias: opciones.ttlDiasBlobs,
+            ahora: opciones.ahora,
+            dryRun: opciones.dryRun,
+        });
+        const archivoFrio = opciones.skipArchivoFrio
+            ? null
+            : await archivarSesionesFrias({
+                agentDir: opciones.agentDir,
+                sessionsDir: opciones.sessionsDir,
+                ttlDias: opciones.ttlDiasFrio,
+                ahora: opciones.ahora,
+                dryRun: opciones.dryRun,
+            });
+        const reconciliacion = opciones.skipReconciliacion
+            ? null
+            : await reconciliar(opciones.agentDir, opciones.sessionsDir);
+        const wal = opciones.skipWal || opciones.dryRun ? null : await walCheckpoint(opciones.agentDir);
+        return { blobs, archivoFrio, reconciliacion, wal };
+    }
+    finally {
+        await liberar();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/gc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/gc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqBzC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAoB;IACpD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,QAAQ,CAAC,YAAY;YAC9B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,eAAe;YAC3C,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,MAAM,qBAAqB,CAAC;gBAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,OAAO,EAAE,QAAQ,CAAC,WAAW;gBAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAC;QAEL,MAAM,cAAc,GAAG,QAAQ,CAAC,kBAAkB;YACjD,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,MAAM,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE9D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEhG,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;IACpD,CAAC;YAAS,CAAC;QACV,MAAM,OAAO,EAAE,CAAC;IACjB,CAAC;AACF,CAAC"}

package/dist/core/gc/lock.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Breaker-lock para GC: evita dos GC concurrentes sobre el mismo agentDir.
+ *
+ * Usa creación atómica de fichero (O_EXCL) como mutex entre procesos.
+ * Si el lock existe, reintenta cada 500ms hasta agotar intentos.
+ */
+export declare const GC_LOCK_FILE = "gc.lock";
+export declare const GC_LOCK_REINTENTOS_POR_DEFECTO = 3;
+export declare const GC_LOCK_INTERVALO_MS = 500;
+export declare class GcLockError extends Error {
+    constructor(message: string);
+}
+export interface AdquirirLockOpciones {
+    agentDir: string;
+    reintentos?: number;
+    intervaloMs?: number;
+}
+export declare function adquirirLockGc(opciones: AdquirirLockOpciones): Promise<() => Promise<void>>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/core/gc/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/core/gc/lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,qBAAa,WAAY,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI3B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA2BjG"}

package/dist/core/gc/lock.js

@@ -0,0 +1,48 @@
+/**
+ * Breaker-lock para GC: evita dos GC concurrentes sobre el mismo agentDir.
+ *
+ * Usa creación atómica de fichero (O_EXCL) como mutex entre procesos.
+ * Si el lock existe, reintenta cada 500ms hasta agotar intentos.
+ */
+import { open, unlink } from "node:fs/promises";
+import { join } from "node:path";
+export const GC_LOCK_FILE = "gc.lock";
+export const GC_LOCK_REINTENTOS_POR_DEFECTO = 3;
+export const GC_LOCK_INTERVALO_MS = 500;
+export class GcLockError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GcLockError";
+    }
+}
+export async function adquirirLockGc(opciones) {
+    const reintentos = opciones.reintentos ?? GC_LOCK_REINTENTOS_POR_DEFECTO;
+    const intervaloMs = opciones.intervaloMs ?? GC_LOCK_INTERVALO_MS;
+    const ruta = join(opciones.agentDir, GC_LOCK_FILE);
+    for (let intento = 0; intento <= reintentos; intento++) {
+        try {
+            const handle = await open(ruta, "wx");
+            await handle.writeFile(`${process.pid}:${Date.now()}`, "utf-8");
+            await handle.close();
+            return async () => {
+                try {
+                    await unlink(ruta);
+                }
+                catch {
+                    // best-effort
+                }
+            };
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== "EEXIST")
+                throw err;
+            if (intento === reintentos) {
+                throw new GcLockError(`GC ya en ejecución (lock ${ruta} ocupado tras ${reintentos} reintentos)`);
+            }
+            await new Promise((r) => setTimeout(r, intervaloMs));
+        }
+    }
+    throw new GcLockError("No se pudo adquirir lock de GC");
+}
+//# sourceMappingURL=lock.js.map

package/dist/core/gc/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/core/gc/lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,MAAM,OAAO,WAAY,SAAQ,KAAK;IACrC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC3B,CAAC;CACD;AAQD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAA8B;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,8BAA8B,CAAC;IACzE,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,oBAAoB,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEnD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,KAAK,IAAI,EAAE;gBACjB,IAAI,CAAC;oBACJ,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;gBAAC,MAAM,CAAC;oBACR,cAAc;gBACf,CAAC;YACF,CAAC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;YACjC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC5B,MAAM,IAAI,WAAW,CAAC,4BAA4B,IAAI,iBAAiB,UAAU,cAAc,CAAC,CAAC;YAClG,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QAC5D,CAAC;IACF,CAAC;IACD,MAAM,IAAI,WAAW,CAAC,gCAAgC,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/gc/reconciliacion.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Reconciliación stats/history: re-cuenta sessions/index.json vs filesystem
+ * (número de sesiones, tamaño total, huérfanas) y reporta divergencias.
+ */
+export interface Divergencia {
+    tipo: "huérfana_en_fs" | "falta_en_fs" | "tamano_divergente";
+    detalle: string;
+}
+export interface ResultadoReconciliacion {
+    sesionesEnFs: number;
+    sesionesEnIndex: number;
+    tamanoTotalFs: number;
+    tamanoTotalIndex: number;
+    huerfanas: string[];
+    faltantes: string[];
+    divergencias: Divergencia[];
+}
+export declare function reconciliar(agentDir: string, sessionsDir?: string, indexPath?: string): Promise<ResultadoReconciliacion>;
+//# sourceMappingURL=reconciliacion.d.ts.map

package/dist/core/gc/reconciliacion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliacion.d.ts","sourceRoot":"","sources":["../../../src/core/gc/reconciliacion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,gBAAgB,GAAG,aAAa,GAAG,mBAAmB,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC5B;AAsCD,wBAAsB,WAAW,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAqElC"}

package/dist/core/gc/reconciliacion.js

@@ -0,0 +1,102 @@
+/**
+ * Reconciliación stats/history: re-cuenta sessions/index.json vs filesystem
+ * (número de sesiones, tamaño total, huérfanas) y reporta divergencias.
+ */
+import { existsSync } from "node:fs";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+async function listarJsonlRecursivo(root) {
+    const out = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries = [];
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = join(dir, e);
+            if (e === "cold")
+                continue;
+            let st;
+            try {
+                st = await stat(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                stack.push(full);
+                continue;
+            }
+            if (e.endsWith(".jsonl"))
+                out.push({ path: full, size: st.size });
+        }
+    }
+    return out;
+}
+export async function reconciliar(agentDir, sessionsDir, indexPath) {
+    const sessionsRoot = sessionsDir ?? join(agentDir, "sessions");
+    const indexFile = indexPath ?? join(agentDir, "sessions", "index.json");
+    let indexEntries = [];
+    let tamanoTotalIndex = 0;
+    if (existsSync(indexFile)) {
+        try {
+            const raw = await readFile(indexFile, "utf-8");
+            const doc = JSON.parse(raw);
+            const arr = Array.isArray(doc) ? doc : (doc.sessions ?? []);
+            indexEntries = arr;
+            for (const e of indexEntries)
+                tamanoTotalIndex += e.size ?? 0;
+        }
+        catch {
+            // índice ilegible → tratar como vacío, reportará todo como huérfano
+            indexEntries = [];
+        }
+    }
+    const fsEntries = existsSync(sessionsRoot) ? await listarJsonlRecursivo(sessionsRoot) : [];
+    const tamanoTotalFs = fsEntries.reduce((acc, e) => acc + e.size, 0);
+    const fsSet = new Set(fsEntries.map((e) => e.path));
+    const indexSet = new Set(indexEntries
+        .map((e) => (e.file ? join(sessionsRoot, e.file) : undefined))
+        .filter((p) => typeof p === "string"));
+    // Si index no tiene file, comparar por id contra basename
+    const fsBasenames = new Set(fsEntries.map((e) => e.path.split("/").pop() ?? e.path));
+    const indexBasenames = new Set(indexEntries.map((e) => e.file?.split("/").pop() ?? e.id).filter((v) => typeof v === "string"));
+    const huerfanas = [];
+    const faltantes = [];
+    const divergencias = [];
+    for (const fe of fsEntries) {
+        const base = fe.path.split("/").pop() ?? fe.path;
+        if (!indexBasenames.has(base) && !indexSet.has(fe.path)) {
+            huerfanas.push(fe.path);
+            divergencias.push({ tipo: "huérfana_en_fs", detalle: fe.path });
+        }
+    }
+    for (const ie of indexEntries) {
+        const base = (ie.file?.split("/").pop() ?? ie.id ?? "");
+        if (!fsBasenames.has(base) && ie.file && !fsSet.has(join(sessionsRoot, ie.file))) {
+            faltantes.push(ie.file);
+            divergencias.push({ tipo: "falta_en_fs", detalle: ie.file });
+        }
+    }
+    if (tamanoTotalFs !== tamanoTotalIndex && indexEntries.length > 0) {
+        divergencias.push({
+            tipo: "tamano_divergente",
+            detalle: `fs=${tamanoTotalFs} index=${tamanoTotalIndex}`,
+        });
+    }
+    return {
+        sesionesEnFs: fsEntries.length,
+        sesionesEnIndex: indexEntries.length,
+        tamanoTotalFs,
+        tamanoTotalIndex,
+        huerfanas,
+        faltantes,
+        divergencias,
+    };
+}
+//# sourceMappingURL=reconciliacion.js.map

package/dist/core/gc/reconciliacion.js.map

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

package/dist/core/gc/wal.d.ts

@@ -0,0 +1,15 @@
+/**
+ * WAL checkpoint TRUNCATE.
+ *
+ * Si existe un SQLite journal en modo WAL (p. ej. sessions.db, audit.db),
+ * ejecuta wal_checkpoint(TRUNCATE). Si no hay SQLite (JSONL puro), documenta
+ * el equivalente: truncar el journal archivado (no-op con mensaje).
+ *
+ * No falla si no hay fichero o no hay sqlite: es best-effort.
+ */
+export interface ResultadoWal {
+    accion: "checkpoint" | "no-op";
+    detalle: string;
+}
+export declare function walCheckpoint(agentDir: string, dbPath?: string): Promise<ResultadoWal>;
+//# sourceMappingURL=wal.d.ts.map

package/dist/core/gc/wal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wal.d.ts","sourceRoot":"","sources":["../../../src/core/gc/wal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+B5F"}

package/dist/core/gc/wal.js

@@ -0,0 +1,44 @@
+/**
+ * WAL checkpoint TRUNCATE.
+ *
+ * Si existe un SQLite journal en modo WAL (p. ej. sessions.db, audit.db),
+ * ejecuta wal_checkpoint(TRUNCATE). Si no hay SQLite (JSONL puro), documenta
+ * el equivalente: truncar el journal archivado (no-op con mensaje).
+ *
+ * No falla si no hay fichero o no hay sqlite: es best-effort.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+export async function walCheckpoint(agentDir, dbPath) {
+    const candidatos = dbPath
+        ? [dbPath]
+        : [join(agentDir, "sessions.db"), join(agentDir, "audit.db"), join(agentDir, "sessions", "index.db")];
+    for (const p of candidatos) {
+        if (!existsSync(p))
+            continue;
+        try {
+            // node:sqlite solo existe en Node >=22 y no está disponible en todos los entornos
+            // (p. ej. algunos CI sin libsqlite). Import dinámico por eso: static fallaría el build
+            // donde el módulo no existe.
+            const { DatabaseSync } = await import("node:sqlite");
+            const db = new DatabaseSync(p);
+            try {
+                // TRUNCATE reinicia el WAL a 0 tras checkpoint
+                db.exec("PRAGMA wal_checkpoint(TRUNCATE);");
+            }
+            finally {
+                db.close();
+            }
+            return { accion: "checkpoint", detalle: `wal_checkpoint(TRUNCATE) en ${p}` };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { accion: "no-op", detalle: `no se pudo hacer checkpoint en ${p}: ${msg}` };
+        }
+    }
+    return {
+        accion: "no-op",
+        detalle: "sin SQLite WAL (JSONL puro): equivalente = truncar el journal archivado (cold/*.jsonl.gz ya archivado). No hay WAL que reiniciar.",
+    };
+}
+//# sourceMappingURL=wal.js.map

package/dist/core/gc/wal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wal.js","sourceRoot":"","sources":["../../../src/core/gc/wal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,MAAe;IACpE,MAAM,UAAU,GAAG,MAAM;QACxB,CAAC,CAAC,CAAC,MAAM,CAAC;QACV,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAEvG,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC;YACJ,kFAAkF;YAClF,uFAAuF;YACvF,6BAA6B;YAC7B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACrD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC;gBACJ,+CAA+C;gBAC/C,EAAE,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YAC7C,CAAC;oBAAS,CAAC;gBACV,EAAE,CAAC,KAAK,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,+BAA+B,CAAC,EAAE,EAAE,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,kCAAkC,CAAC,KAAK,GAAG,EAAE,EAAE,CAAC;QACpF,CAAC;IACF,CAAC;IAED,OAAO;QACN,MAAM,EAAE,OAAO;QACf,OAAO,EACN,mIAAmI;KACpI,CAAC;AACH,CAAC"}

package/dist/core/harness/fuentes-de-contexto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fuentes-de-contexto.d.ts","sourceRoot":"","sources":["../../../src/core/harness/fuentes-de-contexto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAiBzF","sourcesContent":["/**\n * Lo que Ada añade a los ficheros de contexto del proyecto, en una llamada.\n *\n * Son dos cosas con el mismo destino: las notas durables del harness y las\n * reglas que el proyecto ya tiene escritas para otras herramientas\n * (`.cursor/rules`, `.clinerules`, `GEMINI.md`, copilot-instructions…).\n *\n * Van juntas aquí y no sueltas en `resource-loader.ts` por una razón medible:\n * ese fichero es de upstream y cada región nuestra que vive dentro es un hunk\n * que se reaplica en cada sincronización. Con los dos bloques separados el\n * presupuesto se pasó a 116/115; con una función y un import, no. La regla la\n * dice el propio guion de sincronización: mover la lógica a un fichero nuestro\n * antes que subir el número.\n */\n\nimport { comoFicherosDeContexto } from \"../descubrimiento/reglas.ts\";\nimport { HarnessStore } from \"./store.ts\";\n\nexport interface FicheroDeContexto {\n\tpath: string;\n\tcontent: string;\n}\n\n/**\n * Las fuentes de contexto propias de Ada, en el orden en que deben leerse.\n *\n * Ninguna puede impedir que se construya el prompt: un harness corrupto o un\n * `.cursor/rules` ilegible degradan el contexto, no tumban la sesión. Pero el\n * `try` va alrededor de la OPERACIÓN y nunca del import — los imports son\n * estáticos a propósito, porque envolverlos convirtió durante meses un\n * `require` inexistente en «no hay notas» sin que nadie se enterara.\n */\nexport function fuentesDeContextoDeAda(cwd: string, agentDir: string): FicheroDeContexto[] {\n\tconst salida: FicheroDeContexto[] = [];\n\n\ttry {\n\t\tconst bloque = new HarnessStore(`${agentDir}/memory-engine`, \"project\").promptBlock();\n\t\tif (bloque) salida.push({ path: \"<ada-harness>\", content: bloque });\n\t} catch {\n\t\t// Notas ilegibles: se sigue sin ellas.\n\t}\n\n\ttry {\n\t\tsalida.push(...comoFicherosDeContexto(cwd));\n\t} catch {\n\t\t// Un directorio de reglas ilegible no puede dejar sin prompt al agente.\n\t}\n\n\treturn salida;\n}\n"]}
+{"version":3,"file":"fuentes-de-contexto.d.ts","sourceRoot":"","sources":["../../../src/core/harness/fuentes-de-contexto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAiBzF"}

package/dist/core/harness/fuentes-de-contexto.js.map

@@ -1 +1 @@
-{"version":3,"file":"fuentes-de-contexto.js","sourceRoot":"","sources":["../../../src/core/harness/fuentes-de-contexto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,QAAgB,EAAuB;IAC1F,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,QAAQ,gBAAgB,EAAE,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACtF,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACR,uCAAuC;IACxC,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACR,wEAAwE;IACzE,CAAC;IAED,OAAO,MAAM,CAAC;AAAA,CACd","sourcesContent":["/**\n * Lo que Ada añade a los ficheros de contexto del proyecto, en una llamada.\n *\n * Son dos cosas con el mismo destino: las notas durables del harness y las\n * reglas que el proyecto ya tiene escritas para otras herramientas\n * (`.cursor/rules`, `.clinerules`, `GEMINI.md`, copilot-instructions…).\n *\n * Van juntas aquí y no sueltas en `resource-loader.ts` por una razón medible:\n * ese fichero es de upstream y cada región nuestra que vive dentro es un hunk\n * que se reaplica en cada sincronización. Con los dos bloques separados el\n * presupuesto se pasó a 116/115; con una función y un import, no. La regla la\n * dice el propio guion de sincronización: mover la lógica a un fichero nuestro\n * antes que subir el número.\n */\n\nimport { comoFicherosDeContexto } from \"../descubrimiento/reglas.ts\";\nimport { HarnessStore } from \"./store.ts\";\n\nexport interface FicheroDeContexto {\n\tpath: string;\n\tcontent: string;\n}\n\n/**\n * Las fuentes de contexto propias de Ada, en el orden en que deben leerse.\n *\n * Ninguna puede impedir que se construya el prompt: un harness corrupto o un\n * `.cursor/rules` ilegible degradan el contexto, no tumban la sesión. Pero el\n * `try` va alrededor de la OPERACIÓN y nunca del import — los imports son\n * estáticos a propósito, porque envolverlos convirtió durante meses un\n * `require` inexistente en «no hay notas» sin que nadie se enterara.\n */\nexport function fuentesDeContextoDeAda(cwd: string, agentDir: string): FicheroDeContexto[] {\n\tconst salida: FicheroDeContexto[] = [];\n\n\ttry {\n\t\tconst bloque = new HarnessStore(`${agentDir}/memory-engine`, \"project\").promptBlock();\n\t\tif (bloque) salida.push({ path: \"<ada-harness>\", content: bloque });\n\t} catch {\n\t\t// Notas ilegibles: se sigue sin ellas.\n\t}\n\n\ttry {\n\t\tsalida.push(...comoFicherosDeContexto(cwd));\n\t} catch {\n\t\t// Un directorio de reglas ilegible no puede dejar sin prompt al agente.\n\t}\n\n\treturn salida;\n}\n"]}
+{"version":3,"file":"fuentes-de-contexto.js","sourceRoot":"","sources":["../../../src/core/harness/fuentes-de-contexto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,QAAgB;IACnE,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,QAAQ,gBAAgB,EAAE,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACtF,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACR,uCAAuC;IACxC,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACR,wEAAwE;IACzE,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/core/harness/refine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refine.d.ts","sourceRoot":"","sources":["../../../src/core/harness/refine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,iFAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,cAAc,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,eAAO,MAAM,oBAAoB,84BAckG,CAAC;AAEpI,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAqB5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,cAAc,EAAE,EAC3B,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,MAAM,GACV,YAAY,CA6Bd;AAED,qEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAmB/D","sourcesContent":["/**\n * Refinado del harness: convertir lo aprendido en una sesión en notas durables.\n *\n * Equivalente a `/refine` del competidor, con la diferencia que importa: cada\n * cambio EXIGE evidencia citada, y el modelo devuelve JSON estructurado en vez\n * de prosa. Si no cita, no se aplica.\n *\n * El prompt de sistema base NUNCA se toca — esto solo produce material\n * suplementario, y ese material entra al prompt marcado como no confiable.\n */\n\nimport type { HarnessKind, HarnessScope, HarnessStore } from \"./store.ts\";\n\nexport interface RefineProposal {\n\taction: \"create\" | \"update\" | \"delete\";\n\tid: string;\n\tkind: HarnessKind;\n\ttitle: string;\n\tcontent: string;\n\t/** Cita concreta: `fichero:línea`, un comando ejecutado, o el id de sesión. */\n\tevidence: string;\n}\n\nexport interface RefineResult {\n\tapplied: RefineProposal[];\n\trejected: Array<{ proposal: RefineProposal; reason: string }>;\n}\n\nexport const REFINE_SYSTEM_PROMPT = `Eres el refinador del harness de Ada.\n\nRecibes un resumen de la sesión reciente. Tu tarea es extraer lecciones DURABLES\nque ayudarían en sesiones futuras de este proyecto, y NADA más.\n\nReglas duras:\n- Cada propuesta EXIGE evidencia concreta: \"fichero:línea\", un comando que se\n  ejecutó y su resultado, o un mensaje del usuario. Sin evidencia, no propongas.\n- No propongas nada específico de esta tarea. Solo lo que se repetirá.\n- No propongas preferencias de estilo que el usuario no haya pedido.\n- No copies contenido de ficheros del repo: eso ya está en el repo.\n- Prefiere 0 propuestas a una especulativa. Devolver una lista vacía es correcto.\n\nResponde SOLO con JSON:\n{\"proposals\":[{\"action\":\"create|update|delete\",\"id\":\"slug-corto\",\"kind\":\"prompt|skill\",\"title\":\"…\",\"content\":\"…\",\"evidence\":\"…\"}]}`;\n\n/** Extrae el JSON de la respuesta del modelo (tolera fences y prosa alrededor). */\nexport function parseProposals(raw: string): RefineProposal[] {\n\tconst cleaned = raw\n\t\t.replace(/```json/gi, \"\")\n\t\t.replace(/```/g, \"\")\n\t\t.trim();\n\tconst start = cleaned.indexOf(\"{\");\n\tconst end = cleaned.lastIndexOf(\"}\");\n\tif (start === -1 || end === -1) return [];\n\ttry {\n\t\tconst parsed = JSON.parse(cleaned.slice(start, end + 1)) as { proposals?: RefineProposal[] };\n\t\tif (!Array.isArray(parsed.proposals)) return [];\n\t\treturn parsed.proposals.filter(\n\t\t\t(proposal) =>\n\t\t\t\tproposal &&\n\t\t\t\ttypeof proposal.id === \"string\" &&\n\t\t\t\tproposal.id.trim().length > 0 &&\n\t\t\t\t[\"create\", \"update\", \"delete\"].includes(proposal.action),\n\t\t);\n\t} catch {\n\t\treturn [];\n\t}\n}\n\n/**\n * Aplica propuestas al store.\n *\n * Todo lo que no cite evidencia se rechaza aquí, no solo en el prompt: un modelo\n * puede ignorar una instrucción, pero no puede saltarse esta comprobación.\n */\nexport function applyProposals(\n\tstore: HarnessStore,\n\tproposals: RefineProposal[],\n\tscope: HarnessScope,\n\tnow?: string,\n): RefineResult {\n\tconst applied: RefineProposal[] = [];\n\tconst rejected: Array<{ proposal: RefineProposal; reason: string }> = [];\n\n\tfor (const proposal of proposals) {\n\t\tif (proposal.action === \"delete\") {\n\t\t\tconst removed = store.remove(proposal.id);\n\t\t\tif (removed.ok) applied.push(proposal);\n\t\t\telse rejected.push({ proposal, reason: `No existe la entrada '${proposal.id}'.` });\n\t\t\tcontinue;\n\t\t}\n\t\tif (!proposal.evidence?.trim()) {\n\t\t\trejected.push({ proposal, reason: \"Sin evidencia citada.\" });\n\t\t\tcontinue;\n\t\t}\n\t\tconst result = store.upsert({\n\t\t\tid: proposal.id,\n\t\t\tkind: proposal.kind === \"skill\" ? \"skill\" : \"prompt\",\n\t\t\ttitle: proposal.title || proposal.id,\n\t\t\tcontent: proposal.content ?? \"\",\n\t\t\tscope,\n\t\t\tevidence: proposal.evidence,\n\t\t\tnow,\n\t\t});\n\t\tif (result.ok) applied.push(proposal);\n\t\telse rejected.push({ proposal, reason: result.error ?? \"rechazado\" });\n\t}\n\n\treturn { applied, rejected };\n}\n\n/** Resumen legible de un refinado, para enseñárselo al usuario. */\nexport function renderRefineResult(result: RefineResult): string {\n\tif (result.applied.length === 0 && result.rejected.length === 0) {\n\t\treturn \"Nada que refinar: no salieron lecciones durables de esta sesión.\";\n\t}\n\tconst lines: string[] = [];\n\tif (result.applied.length > 0) {\n\t\tlines.push(`Aplicadas (${result.applied.length}):`);\n\t\tfor (const proposal of result.applied) {\n\t\t\tlines.push(`  ${proposal.action === \"delete\" ? \"−\" : \"+\"} ${proposal.title || proposal.id}`);\n\t\t\tif (proposal.evidence) lines.push(`      evidencia: ${proposal.evidence}`);\n\t\t}\n\t}\n\tif (result.rejected.length > 0) {\n\t\tlines.push(\"\", `Rechazadas (${result.rejected.length}):`);\n\t\tfor (const entry of result.rejected) {\n\t\t\tlines.push(`  · ${entry.proposal.title || entry.proposal.id}: ${entry.reason}`);\n\t\t}\n\t}\n\treturn lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"refine.d.ts","sourceRoot":"","sources":["../../../src/core/harness/refine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,cAAc,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,eAAO,MAAM,oBAAoB,84BAckG,CAAC;AAEpI,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAqB5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,cAAc,EAAE,EAC3B,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,MAAM,GACV,YAAY,CA6Bd;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAmB/D"}

package/dist/core/harness/refine.js.map

@@ -1 +1 @@
-{"version":3,"file":"refine.js","sourceRoot":"","sources":["../../../src/core/harness/refine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Refinado del harness: convertir lo aprendido en una sesión en notas durables.\n *\n * Equivalente a `/refine` del competidor, con la diferencia que importa: cada\n * cambio EXIGE evidencia citada, y el modelo devuelve JSON estructurado en vez\n * de prosa. Si no cita, no se aplica.\n *\n * El prompt de sistema base NUNCA se toca — esto solo produce material\n * suplementario, y ese material entra al prompt marcado como no confiable.\n */\n\nimport type { HarnessKind, HarnessScope, HarnessStore } from \"./store.ts\";\n\nexport interface RefineProposal {\n\taction: \"create\" | \"update\" | \"delete\";\n\tid: string;\n\tkind: HarnessKind;\n\ttitle: string;\n\tcontent: string;\n\t/** Cita concreta: `fichero:línea`, un comando ejecutado, o el id de sesión. */\n\tevidence: string;\n}\n\nexport interface RefineResult {\n\tapplied: RefineProposal[];\n\trejected: Array<{ proposal: RefineProposal; reason: string }>;\n}\n\nexport const REFINE_SYSTEM_PROMPT = `Eres el refinador del harness de Ada.\n\nRecibes un resumen de la sesión reciente. Tu tarea es extraer lecciones DURABLES\nque ayudarían en sesiones futuras de este proyecto, y NADA más.\n\nReglas duras:\n- Cada propuesta EXIGE evidencia concreta: \"fichero:línea\", un comando que se\n  ejecutó y su resultado, o un mensaje del usuario. Sin evidencia, no propongas.\n- No propongas nada específico de esta tarea. Solo lo que se repetirá.\n- No propongas preferencias de estilo que el usuario no haya pedido.\n- No copies contenido de ficheros del repo: eso ya está en el repo.\n- Prefiere 0 propuestas a una especulativa. Devolver una lista vacía es correcto.\n\nResponde SOLO con JSON:\n{\"proposals\":[{\"action\":\"create|update|delete\",\"id\":\"slug-corto\",\"kind\":\"prompt|skill\",\"title\":\"…\",\"content\":\"…\",\"evidence\":\"…\"}]}`;\n\n/** Extrae el JSON de la respuesta del modelo (tolera fences y prosa alrededor). */\nexport function parseProposals(raw: string): RefineProposal[] {\n\tconst cleaned = raw\n\t\t.replace(/```json/gi, \"\")\n\t\t.replace(/```/g, \"\")\n\t\t.trim();\n\tconst start = cleaned.indexOf(\"{\");\n\tconst end = cleaned.lastIndexOf(\"}\");\n\tif (start === -1 || end === -1) return [];\n\ttry {\n\t\tconst parsed = JSON.parse(cleaned.slice(start, end + 1)) as { proposals?: RefineProposal[] };\n\t\tif (!Array.isArray(parsed.proposals)) return [];\n\t\treturn parsed.proposals.filter(\n\t\t\t(proposal) =>\n\t\t\t\tproposal &&\n\t\t\t\ttypeof proposal.id === \"string\" &&\n\t\t\t\tproposal.id.trim().length > 0 &&\n\t\t\t\t[\"create\", \"update\", \"delete\"].includes(proposal.action),\n\t\t);\n\t} catch {\n\t\treturn [];\n\t}\n}\n\n/**\n * Aplica propuestas al store.\n *\n * Todo lo que no cite evidencia se rechaza aquí, no solo en el prompt: un modelo\n * puede ignorar una instrucción, pero no puede saltarse esta comprobación.\n */\nexport function applyProposals(\n\tstore: HarnessStore,\n\tproposals: RefineProposal[],\n\tscope: HarnessScope,\n\tnow?: string,\n): RefineResult {\n\tconst applied: RefineProposal[] = [];\n\tconst rejected: Array<{ proposal: RefineProposal; reason: string }> = [];\n\n\tfor (const proposal of proposals) {\n\t\tif (proposal.action === \"delete\") {\n\t\t\tconst removed = store.remove(proposal.id);\n\t\t\tif (removed.ok) applied.push(proposal);\n\t\t\telse rejected.push({ proposal, reason: `No existe la entrada '${proposal.id}'.` });\n\t\t\tcontinue;\n\t\t}\n\t\tif (!proposal.evidence?.trim()) {\n\t\t\trejected.push({ proposal, reason: \"Sin evidencia citada.\" });\n\t\t\tcontinue;\n\t\t}\n\t\tconst result = store.upsert({\n\t\t\tid: proposal.id,\n\t\t\tkind: proposal.kind === \"skill\" ? \"skill\" : \"prompt\",\n\t\t\ttitle: proposal.title || proposal.id,\n\t\t\tcontent: proposal.content ?? \"\",\n\t\t\tscope,\n\t\t\tevidence: proposal.evidence,\n\t\t\tnow,\n\t\t});\n\t\tif (result.ok) applied.push(proposal);\n\t\telse rejected.push({ proposal, reason: result.error ?? \"rechazado\" });\n\t}\n\n\treturn { applied, rejected };\n}\n\n/** Resumen legible de un refinado, para enseñárselo al usuario. */\nexport function renderRefineResult(result: RefineResult): string {\n\tif (result.applied.length === 0 && result.rejected.length === 0) {\n\t\treturn \"Nada que refinar: no salieron lecciones durables de esta sesión.\";\n\t}\n\tconst lines: string[] = [];\n\tif (result.applied.length > 0) {\n\t\tlines.push(`Aplicadas (${result.applied.length}):`);\n\t\tfor (const proposal of result.applied) {\n\t\t\tlines.push(`  ${proposal.action === \"delete\" ? \"−\" : \"+\"} ${proposal.title || proposal.id}`);\n\t\t\tif (proposal.evidence) lines.push(`      evidencia: ${proposal.evidence}`);\n\t\t}\n\t}\n\tif (result.rejected.length > 0) {\n\t\tlines.push(\"\", `Rechazadas (${result.rejected.length}):`);\n\t\tfor (const entry of result.rejected) {\n\t\t\tlines.push(`  · ${entry.proposal.title || entry.proposal.id}: ${entry.reason}`);\n\t\t}\n\t}\n\treturn lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"refine.js","sourceRoot":"","sources":["../../../src/core/harness/refine.ts"],"names":[],"mappings":"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"}