@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/undo/journal.js

@@ -0,0 +1,178 @@
+/**
+ * Diario para deshacer los cambios de ficheros de un turno.
+ *
+ * Guarda el estado ANTERIOR de cada fichero justo antes de tocarlo, agrupado
+ * por turno. `deshacer()` devuelve todos los ficheros del último turno a la vez,
+ * o ninguno: revertir la mitad de un cambio deja el repositorio en un estado que
+ * el agente no produjo nunca y que nadie ha revisado.
+ *
+ * El punto de captura es `withFileMutationQueue`, por donde pasan tanto `edit`
+ * como `write`. Engancharse ahí cubre las dos herramientas con un solo sitio, y
+ * cualquier herramienta futura que escriba ficheros entra gratis.
+ */
+import { createHash } from "node:crypto";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Un fichero más grande que esto no se fotografía.
+ *
+ * Se registra igualmente, marcado, para poder DECIRLO al deshacer. Callarlo
+ * sería peor: el usuario creería que revirtió todo cuando faltó un fichero.
+ */
+const MAX_FOTO_BYTES = 4 * 1024 * 1024;
+/** El turno abierto ahora mismo. La cola de mutaciones no conoce la sesión. */
+let activo = null;
+function rutaDelDiario(agentDir, cwd) {
+    const clave = createHash("sha256").update(cwd).digest("hex").slice(0, 16);
+    return join(agentDir, "undo", `${clave}.jsonl`);
+}
+/**
+ * Abre un turno nuevo. Todo lo que se escriba a partir de aquí se agrupa junto.
+ *
+ * El número de turno sale del diario, no de un contador en memoria: si el
+ * proceso se reinicia a mitad de sesión, el turno siguiente no puede reutilizar
+ * un número y mezclarse con cambios viejos.
+ */
+export function abrirTurno(agentDir, cwd, ahora) {
+    const rutaDiario = rutaDelDiario(agentDir, cwd);
+    mkdirSync(dirname(rutaDiario), { recursive: true, mode: 0o700 });
+    const turno = (leerEntradas(rutaDiario).at(-1)?.turno ?? 0) + 1;
+    activo = { rutaDiario, turno, vistos: new Set() };
+    void ahora;
+    return turno;
+}
+export function cerrarTurno() {
+    activo = null;
+}
+/**
+ * Fotografía un fichero antes de que lo toquen.
+ *
+ * Solo la PRIMERA vez dentro del turno: si el agente edita el mismo fichero
+ * cinco veces, deshacer debe devolverlo a como estaba antes de las cinco, no
+ * antes de la última.
+ */
+export function registrarPrevio(rutaFichero) {
+    if (!activo || activo.vistos.has(rutaFichero))
+        return;
+    activo.vistos.add(rutaFichero);
+    let entrada;
+    try {
+        if (!existsSync(rutaFichero)) {
+            entrada = { turno: activo.turno, path: rutaFichero, previo: null, ts: Date.now() };
+        }
+        else if (statSync(rutaFichero).size > MAX_FOTO_BYTES) {
+            entrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };
+        }
+        else {
+            entrada = {
+                turno: activo.turno,
+                path: rutaFichero,
+                previo: readFileSync(rutaFichero, "utf8"),
+                ts: Date.now(),
+            };
+        }
+    }
+    catch {
+        // Un fichero ilegible no puede impedir la edición; se marca omitido para
+        // que deshacer lo diga en vez de fingir que lo revirtió.
+        entrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };
+    }
+    try {
+        appendFileSync(activo.rutaDiario, `${JSON.stringify(entrada)}\n`, { mode: 0o600 });
+    }
+    catch {
+        // El diario es una comodidad, no una garantía: si no se puede escribir,
+        // la edición sigue adelante.
+    }
+}
+function leerEntradas(rutaDiario) {
+    if (!existsSync(rutaDiario))
+        return [];
+    const entradas = [];
+    for (const linea of readFileSync(rutaDiario, "utf8").split("\n")) {
+        if (!linea.trim())
+            continue;
+        try {
+            entradas.push(JSON.parse(linea));
+        }
+        catch {
+            // Una línea corrupta no invalida el resto del diario.
+        }
+    }
+    return entradas;
+}
+/**
+ * Deshace el último turno con cambios. Todo o nada.
+ *
+ * Antes de escribir nada se fotografía el estado actual de cada objetivo; si
+ * una escritura falla a mitad, se devuelven todas atrás. Sin eso, un fallo de
+ * permisos en el tercer fichero dejaría dos revertidos y tres no — un estado
+ * que nadie escribió ni revisó.
+ */
+export function deshacer(agentDir, cwd) {
+    const rutaDiario = rutaDelDiario(agentDir, cwd);
+    const entradas = leerEntradas(rutaDiario);
+    const ultimo = entradas.at(-1)?.turno;
+    if (ultimo === undefined)
+        return { turno: null, restaurados: [], borrados: [], omitidos: [] };
+    const delTurno = entradas.filter((e) => e.turno === ultimo);
+    const aplicables = delTurno.filter((e) => !e.omitido);
+    const omitidos = delTurno.filter((e) => e.omitido).map((e) => e.path);
+    // Foto de seguridad para poder retroceder si algo peta a mitad.
+    const seguro = new Map();
+    for (const e of aplicables) {
+        seguro.set(e.path, existsSync(e.path) ? readFileSync(e.path, "utf8") : null);
+    }
+    const restaurados = [];
+    const borrados = [];
+    try {
+        for (const e of aplicables) {
+            if (e.previo === null) {
+                // El turno creó el fichero: deshacer es borrarlo.
+                if (existsSync(e.path))
+                    unlinkSync(e.path);
+                borrados.push(e.path);
+            }
+            else {
+                mkdirSync(dirname(e.path), { recursive: true });
+                writeFileSync(e.path, e.previo, "utf8");
+                restaurados.push(e.path);
+            }
+        }
+    }
+    catch (error) {
+        for (const [ruta, contenido] of seguro) {
+            try {
+                if (contenido === null) {
+                    if (existsSync(ruta))
+                        unlinkSync(ruta);
+                }
+                else {
+                    writeFileSync(ruta, contenido, "utf8");
+                }
+            }
+            catch {
+                // Poco más se puede hacer; el mensaje de error lo dirá.
+            }
+        }
+        return {
+            turno: ultimo,
+            restaurados: [],
+            borrados: [],
+            omitidos,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    // El turno deshecho sale del diario: deshacer dos veces debe ir al anterior,
+    // no repetir el mismo.
+    const restantes = entradas.filter((e) => e.turno !== ultimo);
+    writeFileSync(rutaDiario, restantes.map((e) => `${JSON.stringify(e)}\n`).join(""), { mode: 0o600 });
+    return { turno: ultimo, restaurados, borrados, omitidos };
+}
+/** Qué haría un `undo` sin llegar a hacerlo. */
+export function previsualizar(agentDir, cwd) {
+    const entradas = leerEntradas(rutaDelDiario(agentDir, cwd));
+    const ultimo = entradas.at(-1)?.turno;
+    return ultimo === undefined ? [] : entradas.filter((e) => e.turno === ultimo);
+}
+//# sourceMappingURL=journal.js.map

package/dist/core/undo/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../../src/core/undo/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAkBvC,+EAA+E;AAC/E,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC,SAAS,aAAa,CAAC,QAAgB,EAAE,GAAW;IACnD,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,GAAW,EAAE,KAAa;IACtE,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAChE,MAAM,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAClD,KAAK,KAAK,CAAC;IACX,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,MAAM,GAAG,IAAI,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO;IACtD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE/B,IAAI,OAAsB,CAAC;IAC3B,IAAI,CAAC;QACJ,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9B,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACpF,CAAC;aAAM,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;YACxD,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnG,CAAC;aAAM,CAAC;YACP,OAAO,GAAG;gBACT,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC;gBACzC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;aACd,CAAC;QACH,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,yEAAyE;QACzE,yDAAyD;QACzD,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACnG,CAAC;IACD,IAAI,CAAC;QACJ,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACR,wEAAwE;QACxE,6BAA6B;IAC9B,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,UAAkB;IACvC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,SAAS;QAC5B,IAAI,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAkB,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACR,sDAAsD;QACvD,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAUD;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,GAAW;IACrD,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAE9F,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEtE,gEAAgE;IAChE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC;QACJ,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACvB,kDAAkD;gBAClD,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;oBAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC3C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACP,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACxC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACF,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;YACxC,IAAI,CAAC;gBACJ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACxB,IAAI,UAAU,CAAC,IAAI,CAAC;wBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACP,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBACxC,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,wDAAwD;YACzD,CAAC;QACF,CAAC;QACD,OAAO;YACN,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,QAAQ;YACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC7D,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,uBAAuB;IACvB,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IAC7D,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEpG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC3D,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,GAAW;IAC1D,MAAM,QAAQ,GAAG,YAAY,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IACtC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;AAC/E,CAAC"}

package/dist/core/urls-internas/auditoria.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `audit://<n>` — las últimas `n` entradas del libro de sesión
+ * (`audit/libro.ts`), con el veredicto de la cadena de hashes.
+ *
+ * El veredicto va SIEMPRE, no solo cuando algo falla: "válida" es tan
+ * informativo como "alterada" para quien pregunta qué hizo el agente.
+ */
+import type { LibroDeSesion } from "../audit/libro.ts";
+export declare function leerAuditoria(libro: LibroDeSesion, resto: string): Promise<string>;
+//# sourceMappingURL=auditoria.d.ts.map

package/dist/core/urls-internas/auditoria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditoria.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/auditoria.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAavD,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BxF"}

package/dist/core/urls-internas/auditoria.js

@@ -0,0 +1,42 @@
+/**
+ * `audit://<n>` — las últimas `n` entradas del libro de sesión
+ * (`audit/libro.ts`), con el veredicto de la cadena de hashes.
+ *
+ * El veredicto va SIEMPRE, no solo cuando algo falla: "válida" es tan
+ * informativo como "alterada" para quien pregunta qué hizo el agente.
+ */
+const LIMITE_DEFECTO = 20;
+function resumenSuceso(suceso) {
+    const tipo = String(suceso.tipo ?? "?");
+    const resto = Object.entries(suceso)
+        .filter(([k]) => k !== "tipo")
+        .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+        .join(" ");
+    return resto ? `${tipo} ${resto}` : tipo;
+}
+export async function leerAuditoria(libro, resto) {
+    const texto = resto.trim();
+    let limite = LIMITE_DEFECTO;
+    if (texto) {
+        limite = Number.parseInt(texto, 10);
+        if (!Number.isFinite(limite) || limite <= 0) {
+            throw new Error(`audit://: "${resto}" no es un número positivo. Usa audit://<n>, por ejemplo audit://5.`);
+        }
+    }
+    const entradas = await libro.leer(limite);
+    const veredicto = await libro.verificar();
+    // El caso «falta un fichero entero» no tiene `alteradaEn`, porque no hay
+    // ninguna entrada que no cuadre: lo que no cuadra es el inventario. Sin esta
+    // rama el texto decía «cadena ALTERADA en undefined», que es la peor versión
+    // de un aviso — grita y no dice qué.
+    const cadena = veredicto.faltan?.length
+        ? `FALTAN ${veredicto.faltan.length} fichero(s) del libro con ${veredicto.faltan.reduce((n, f) => n + f.entradas, 0)} entrada(s), borrados de sesion/ y recuperados del índice`
+        : veredicto.valido
+            ? `cadena válida (${veredicto.comprobadas} entrada(s) comprobada(s))`
+            : `cadena ALTERADA${veredicto.alteradaEn ? ` en ${veredicto.alteradaEn}` : ""} (${veredicto.comprobadas} entrada(s) válidas antes de eso${veredicto.motivo ? `; ${veredicto.motivo}` : ""})`;
+    if (entradas.length === 0)
+        return `audit://${resto}: el libro de sesión está vacío. ${cadena}.`;
+    const lineas = entradas.map((e) => `#${e.seq} ${e.ts} ${resumenSuceso(e.suceso)}`);
+    return `${entradas.length} entrada(s) (de más reciente a más antigua), ${cadena}:\n${lineas.join("\n")}`;
+}
+//# sourceMappingURL=auditoria.js.map

package/dist/core/urls-internas/auditoria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditoria.js","sourceRoot":"","sources":["../../../src/core/urls-internas/auditoria.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,SAAS,aAAa,CAAC,MAA+B;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAoB,EAAE,KAAa;IACtE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,IAAI,KAAK,EAAE,CAAC;QACX,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,qEAAqE,CAAC,CAAC;QAC3G,CAAC;IACF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IAC1C,yEAAyE;IACzE,6EAA6E;IAC7E,6EAA6E;IAC7E,qCAAqC;IACrC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM;QACtC,CAAC,CAAC,UAAU,SAAS,CAAC,MAAM,CAAC,MAAM,6BAA6B,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,2DAA2D;QAC/K,CAAC,CAAC,SAAS,CAAC,MAAM;YACjB,CAAC,CAAC,kBAAkB,SAAS,CAAC,WAAW,4BAA4B;YACrE,CAAC,CAAC,kBAAkB,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,WAAW,mCAAmC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAE/L,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,KAAK,oCAAoC,MAAM,GAAG,CAAC;IAEhG,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnF,OAAO,GAAG,QAAQ,CAAC,MAAM,gDAAgD,MAAM,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1G,CAAC"}

package/dist/core/urls-internas/boveda.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `vault://<nombre>` — lista los NOMBRES del vault y su clasificación.
+ *
+ * Nunca el valor. La política de aprobación (`aprobacion/politica.ts`,
+ * `rutaProtegida`) deniega a propósito leer `<agentDir>/vault/…` incluso en
+ * modo `yolo` — es la única ruta que no es configurable. Este esquema no
+ * puede ser la puerta trasera que deshaga esa decisión, así que ni siquiera
+ * llama a `VaultManager.getSecret()`: solo a `.list()`, que por construcción
+ * no puede devolver un valor porque `VaultListEntry` no tiene ese campo.
+ */
+import type { VaultManager } from "../memory-engine/vault.ts";
+export declare function leerBoveda(vault: VaultManager | null, nombre: string): string;
+//# sourceMappingURL=boveda.d.ts.map

package/dist/core/urls-internas/boveda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boveda.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/boveda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAO9E,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAwB7E"}

package/dist/core/urls-internas/boveda.js

@@ -0,0 +1,40 @@
+/**
+ * `vault://<nombre>` — lista los NOMBRES del vault y su clasificación.
+ *
+ * Nunca el valor. La política de aprobación (`aprobacion/politica.ts`,
+ * `rutaProtegida`) deniega a propósito leer `<agentDir>/vault/…` incluso en
+ * modo `yolo` — es la única ruta que no es configurable. Este esquema no
+ * puede ser la puerta trasera que deshaga esa decisión, así que ni siquiera
+ * llama a `VaultManager.getSecret()`: solo a `.list()`, que por construcción
+ * no puede devolver un valor porque `VaultListEntry` no tiene ese campo.
+ */
+function formatoEntrada(e) {
+    const categoria = e.category ?? "sin categoría";
+    return `- ${e.name} [${categoria}] (${e.source})${e.note ? ` — ${e.note}` : ""}`;
+}
+export function leerBoveda(vault, nombre) {
+    if (!vault)
+        throw new Error("vault://: no hay vault configurado en esta sesión.");
+    const objetivo = nombre.trim();
+    const entradas = vault.list();
+    // TRES estados, no dos.
+    //
+    // `VaultManager.list()` devuelve `[]` tanto cuando el vault está VACÍO como
+    // cuando está BLOQUEADO —`projectVault` es `null` hasta que alguien lo
+    // desbloquea—, así que un usuario con doce secretos guardados leía «no hay
+    // secretos guardados». Es «no puedo» disfrazado de «no hay», y en la ruta de
+    // seguridad: le empujaría a volver a guardarlos o a dar el vault por roto.
+    if (entradas.length === 0 && vault.exists() && !vault.isUnlocked) {
+        return "vault://: el vault de este proyecto existe pero está BLOQUEADO. No es que no haya secretos: no se han podido leer. Desbloquéalo para listarlos.";
+    }
+    if (!objetivo) {
+        if (entradas.length === 0)
+            return "vault://: no hay secretos guardados en este proyecto.";
+        return `${entradas.length} secreto(s) en el vault (solo nombre y clasificación, nunca el valor):\n${entradas.map(formatoEntrada).join("\n")}`;
+    }
+    const encontrada = entradas.find((e) => e.name === objetivo);
+    if (!encontrada)
+        return `vault://${objetivo}: no existe una entrada con ese nombre.`;
+    return `${formatoEntrada(encontrada)}\n(el valor no se expone por esta vía: la política de aprobación deniega leer el vault)`;
+}
+//# sourceMappingURL=boveda.js.map

package/dist/core/urls-internas/boveda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boveda.js","sourceRoot":"","sources":["../../../src/core/urls-internas/boveda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,SAAS,cAAc,CAAC,CAAiB;IACxC,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,IAAI,eAAe,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,SAAS,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA0B,EAAE,MAAc;IACpE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE9B,wBAAwB;IACxB,EAAE;IACF,4EAA4E;IAC5E,uEAAuE;IACvE,2EAA2E;IAC3E,6EAA6E;IAC7E,2EAA2E;IAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAClE,OAAO,iJAAiJ,CAAC;IAC1J,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,uDAAuD,CAAC;QAC1F,OAAO,GAAG,QAAQ,CAAC,MAAM,2EAA2E,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/I,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU;QAAE,OAAO,WAAW,QAAQ,yCAAyC,CAAC;IACrF,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,yFAAyF,CAAC;AAC/H,CAAC"}

package/dist/core/urls-internas/lector.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Engancha las URLs internas en la tool `read`, SIN tocar `core/tools/read.ts`.
+ *
+ * `read.ts` es de upstream y el presupuesto de sincronización está al límite
+ * (ver `scripts/sync-ada.sh --check`): un hunk más ahí hace fallar la
+ * construcción. La tool en sí ya expone el hueco que hace falta — es un
+ * `ToolDefinition` normal, y `agent-session.ts` construye el registro de
+ * tools con `Map<string, ToolDefinition>` donde el nombre gana por inserción
+ * — así que envolver la definición y reemplazarla con
+ * `_baseToolDefinitions.set("read", …)` no es un rodeo, es como Ada ya
+ * registra `memory_*`, `web_*` y el resto de sus capacidades en ese mismo
+ * método.
+ *
+ * Antes eran 4 esquemas (memory/vault/rule/audit). Ahora son 8
+ * (patch/cleanse/lsp/share añadidos) vía `core/rutas/router.ts`. Este fichero
+ * es la fachada histórica: delega en el router canónico para no duplicar la
+ * lista ni los handlers. Delega TODO lo que no sea una URL interna al `read`
+ * original: rutas de fichero, imágenes, `offset`/`limit`… nada de eso cambia.
+ */
+import type { LibroDeSesion } from "../audit/libro.ts";
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { MemoryEngine } from "../memory-engine/engine.ts";
+import type { VaultManager } from "../memory-engine/vault.ts";
+export interface DependenciasUrlsInternas {
+    memoryEngine: MemoryEngine | null;
+    vaultManager: VaultManager | null;
+    cwd: string;
+    /** Perezoso porque el libro también lo es (ver `RegistroDeSesion.libro()`). */
+    libro: () => LibroDeSesion;
+}
+export declare function envolverReadConUrlsInternas(base: ToolDefinition, deps: DependenciasUrlsInternas): ToolDefinition;
+/** Alias para `edit`: mismo router, mismo contrato, distinta tool. */
+export declare function envolverEditConUrlsInternas(base: ToolDefinition, deps: DependenciasUrlsInternas): ToolDefinition;
+//# sourceMappingURL=lector.d.ts.map

package/dist/core/urls-internas/lector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lector.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/lector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,WAAW,wBAAwB;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,KAAK,EAAE,MAAM,aAAa,CAAC;CAC3B;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,wBAAwB,GAAG,cAAc,CAwBhH;AAED,sEAAsE;AACtE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,wBAAwB,GAAG,cAAc,CAqBhH"}

package/dist/core/urls-internas/lector.js

@@ -0,0 +1,70 @@
+/**
+ * Engancha las URLs internas en la tool `read`, SIN tocar `core/tools/read.ts`.
+ *
+ * `read.ts` es de upstream y el presupuesto de sincronización está al límite
+ * (ver `scripts/sync-ada.sh --check`): un hunk más ahí hace fallar la
+ * construcción. La tool en sí ya expone el hueco que hace falta — es un
+ * `ToolDefinition` normal, y `agent-session.ts` construye el registro de
+ * tools con `Map<string, ToolDefinition>` donde el nombre gana por inserción
+ * — así que envolver la definición y reemplazarla con
+ * `_baseToolDefinitions.set("read", …)` no es un rodeo, es como Ada ya
+ * registra `memory_*`, `web_*` y el resto de sus capacidades en ese mismo
+ * método.
+ *
+ * Antes eran 4 esquemas (memory/vault/rule/audit). Ahora son 8
+ * (patch/cleanse/lsp/share añadidos) vía `core/rutas/router.ts`. Este fichero
+ * es la fachada histórica: delega en el router canónico para no duplicar la
+ * lista ni los handlers. Delega TODO lo que no sea una URL interna al `read`
+ * original: rutas de fichero, imágenes, `offset`/`limit`… nada de eso cambia.
+ */
+import { parseaUrlInterna, routerPorDefecto } from "../rutas/router.js";
+export function envolverReadConUrlsInternas(base, deps) {
+    const esquemas = routerPorDefecto
+        .listarEsquemas()
+        .map((e) => `${e}://`)
+        .join(", ");
+    return {
+        ...base,
+        description: `${base.description} Además de rutas de fichero, acepta URIs internas: ${esquemas}.`,
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            const ruta = params.path;
+            const url = typeof ruta === "string" ? parseaUrlInterna(ruta) : null;
+            if (!url)
+                return base.execute(toolCallId, params, signal, onUpdate, ctx);
+            // El router es quien decide si es conocido y cómo despachar.
+            // Así un `registrar()` futuro se ve aquí sin tocar este fichero.
+            const texto = await routerPorDefecto.resolver(url.esquema, url.resto, {
+                memoryEngine: deps.memoryEngine,
+                vaultManager: deps.vaultManager,
+                cwd: deps.cwd,
+                libro: deps.libro,
+            });
+            return { content: [{ type: "text", text: texto }], details: undefined };
+        },
+    };
+}
+/** Alias para `edit`: mismo router, mismo contrato, distinta tool. */
+export function envolverEditConUrlsInternas(base, deps) {
+    const esquemas = routerPorDefecto
+        .listarEsquemas()
+        .map((e) => `${e}://`)
+        .join(", ");
+    return {
+        ...base,
+        description: `${base.description} Además de rutas de fichero, acepta URIs internas: ${esquemas}.`,
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            const ruta = params.path;
+            const url = typeof ruta === "string" ? parseaUrlInterna(ruta) : null;
+            if (!url)
+                return base.execute(toolCallId, params, signal, onUpdate, ctx);
+            const texto = await routerPorDefecto.resolver(url.esquema, url.resto, {
+                memoryEngine: deps.memoryEngine,
+                vaultManager: deps.vaultManager,
+                cwd: deps.cwd,
+                libro: deps.libro,
+            });
+            return { content: [{ type: "text", text: texto }], details: undefined };
+        },
+    };
+}
+//# sourceMappingURL=lector.js.map

package/dist/core/urls-internas/lector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lector.js","sourceRoot":"","sources":["../../../src/core/urls-internas/lector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAUxE,MAAM,UAAU,2BAA2B,CAAC,IAAoB,EAAE,IAA8B;IAC/F,MAAM,QAAQ,GAAG,gBAAgB;SAC/B,cAAc,EAAE;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;SACrB,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO;QACN,GAAG,IAAI;QACP,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,sDAAsD,QAAQ,GAAG;QACjG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;YACtD,MAAM,IAAI,GAAI,MAA6B,CAAC,IAAI,CAAC;YACjD,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACrE,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAEzE,6DAA6D;YAC7D,iEAAiE;YACjE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE;gBACrE,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;aACjB,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACzE,CAAC;KACD,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,2BAA2B,CAAC,IAAoB,EAAE,IAA8B;IAC/F,MAAM,QAAQ,GAAG,gBAAgB;SAC/B,cAAc,EAAE;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;SACrB,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO;QACN,GAAG,IAAI;QACP,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,sDAAsD,QAAQ,GAAG;QACjG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;YACtD,MAAM,IAAI,GAAI,MAA6B,CAAC,IAAI,CAAC;YACjD,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACrE,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YACzE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE;gBACrE,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;aACjB,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACzE,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/urls-internas/memoria.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `memory://<consulta>` — busca en el motor de memoria (`memory-engine/engine.ts`).
+ *
+ * No es un tool nuevo: es el mismo `searchMemories` que ya usa `memory_search`
+ * en `memory-engine/tools.ts`, con el mismo formato de salida. Reutilizarlo en
+ * vez de reimplementar la búsqueda es justo el punto del hueco — un `read` en
+ * vez de veinte tools.
+ */
+import type { MemoryEngine } from "../memory-engine/engine.ts";
+export declare function leerMemoria(engine: MemoryEngine | null, consulta: string): string;
+//# sourceMappingURL=memoria.d.ts.map

package/dist/core/urls-internas/memoria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoria.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/memoria.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAajF"}

package/dist/core/urls-internas/memoria.js

@@ -0,0 +1,25 @@
+/**
+ * `memory://<consulta>` — busca en el motor de memoria (`memory-engine/engine.ts`).
+ *
+ * No es un tool nuevo: es el mismo `searchMemories` que ya usa `memory_search`
+ * en `memory-engine/tools.ts`, con el mismo formato de salida. Reutilizarlo en
+ * vez de reimplementar la búsqueda es justo el punto del hueco — un `read` en
+ * vez de veinte tools.
+ */
+const LIMITE = 10;
+export function leerMemoria(engine, consulta) {
+    if (!engine)
+        throw new Error("memory://: el motor de memoria no está disponible en esta sesión.");
+    const texto = consulta.trim();
+    if (!texto)
+        throw new Error("memory://: falta la consulta. Usa memory://<lo que buscas>.");
+    const hits = engine.searchMemories({ text: texto, limit: LIMITE });
+    if (hits.length === 0)
+        return `memory://${consulta}: sin resultados.`;
+    const lineas = hits.map((hit, i) => {
+        const alcance = hit.observation.project ? "project" : "global/user";
+        return `${i + 1}. [${hit.observation.type} · ${alcance}] ${hit.observation.text}`;
+    });
+    return `${hits.length} resultado(s) para memory://${consulta}:\n${lineas.join("\n")}`;
+}
+//# sourceMappingURL=memoria.js.map

package/dist/core/urls-internas/memoria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoria.js","sourceRoot":"","sources":["../../../src/core/urls-internas/memoria.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,GAAG,EAAE,CAAC;AAElB,MAAM,UAAU,WAAW,CAAC,MAA2B,EAAE,QAAgB;IACxE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAClG,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAE3F,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,QAAQ,mBAAmB,CAAC;IAEtE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;QACpE,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,WAAW,CAAC,IAAI,MAAM,OAAO,KAAK,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IACnF,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,IAAI,CAAC,MAAM,+BAA+B,QAAQ,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACvF,CAAC"}

package/dist/core/urls-internas/parse.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parseo de URLs internas: `esquema://resto`.
+ *
+ * oh-my-pi (el competidor, ver `/Users/31017423z/auditoria-omp/oh-my-pi`)
+ * tiene veinte esquemas y un parser que reconstruye `URL` a mano para
+ * aguantar dos puntos dentro del host (`skill://plugin:name`). Nosotros no
+ * tenemos esa forma — nuestro "resto" es una consulta, un nombre o un número,
+ * nunca un host con puerto — así que un regex basta y no hace falta
+ * replicar esa máquina.
+ *
+ * La frontera es literal: cualquier texto con forma `algo://algo` entra en
+ * este espacio de nombres y YA NO se intenta como ruta de fichero. Una ruta
+ * real de disco no lleva `://`, así que no hay colisión que resolver.
+ *
+ * Este módulo es la fachada histórica (4 esquemas). El router canónico vive
+ * en `core/rutas/router.ts` con 8 esquemas y extensibilidad. Aquí
+ * re-exportamos desde allí para que ambos caminos vean el mismo origen de
+ * verdad y no haya dos listas que diverjan en silencio.
+ */
+export { ESQUEMAS_INTERNOS, type EsquemaInterno, errorEsquemaDesconocido, esEsquemaConocido, parseaUrlInterna, type UrlInterna, } from "../rutas/router.ts";
+//# sourceMappingURL=parse.d.ts.map

package/dist/core/urls-internas/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,iBAAiB,EACjB,KAAK,cAAc,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,UAAU,GACf,MAAM,oBAAoB,CAAC"}

package/dist/core/urls-internas/parse.js

@@ -0,0 +1,21 @@
+/**
+ * Parseo de URLs internas: `esquema://resto`.
+ *
+ * oh-my-pi (el competidor, ver `/Users/31017423z/auditoria-omp/oh-my-pi`)
+ * tiene veinte esquemas y un parser que reconstruye `URL` a mano para
+ * aguantar dos puntos dentro del host (`skill://plugin:name`). Nosotros no
+ * tenemos esa forma — nuestro "resto" es una consulta, un nombre o un número,
+ * nunca un host con puerto — así que un regex basta y no hace falta
+ * replicar esa máquina.
+ *
+ * La frontera es literal: cualquier texto con forma `algo://algo` entra en
+ * este espacio de nombres y YA NO se intenta como ruta de fichero. Una ruta
+ * real de disco no lleva `://`, así que no hay colisión que resolver.
+ *
+ * Este módulo es la fachada histórica (4 esquemas). El router canónico vive
+ * en `core/rutas/router.ts` con 8 esquemas y extensibilidad. Aquí
+ * re-exportamos desde allí para que ambos caminos vean el mismo origen de
+ * verdad y no haya dos listas que diverjan en silencio.
+ */
+export { ESQUEMAS_INTERNOS, errorEsquemaDesconocido, esEsquemaConocido, parseaUrlInterna, } from "../rutas/router.js";
+//# sourceMappingURL=parse.js.map

package/dist/core/urls-internas/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/core/urls-internas/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,iBAAiB,EAEjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GAEhB,MAAM,oBAAoB,CAAC"}

package/dist/core/urls-internas/reglas.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `rule://<origen>` — las reglas que `descubrimiento/reglas.ts` ya encuentra
+ * (`.cursorrules`, `.clinerules`, `.windsurfrules`, GEMINI.md, Copilot…).
+ *
+ * `descubrirReglas` ya hace la deduplicación por contenido y el tope de
+ * tamaño; aquí solo se filtra por origen y se recorta el texto final para no
+ * volcar un fichero de 32KB entero en una respuesta de `read`.
+ */
+export declare function leerReglas(cwd: string, origen: string): string;
+//# sourceMappingURL=reglas.d.ts.map

package/dist/core/urls-internas/reglas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reglas.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/reglas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAiB9D"}

package/dist/core/urls-internas/reglas.js

@@ -0,0 +1,31 @@
+/**
+ * `rule://<origen>` — las reglas que `descubrimiento/reglas.ts` ya encuentra
+ * (`.cursorrules`, `.clinerules`, `.windsurfrules`, GEMINI.md, Copilot…).
+ *
+ * `descubrirReglas` ya hace la deduplicación por contenido y el tope de
+ * tamaño; aquí solo se filtra por origen y se recorta el texto final para no
+ * volcar un fichero de 32KB entero en una respuesta de `read`.
+ */
+import { descubrirReglas } from "../descubrimiento/reglas.js";
+import { truncateHead } from "../tools/truncate.js";
+const TOPE_SALIDA = 8 * 1024;
+export function leerReglas(cwd, origen) {
+    const { reglas, omitidas } = descubrirReglas(cwd);
+    const filtro = origen.trim().toLowerCase();
+    const encontradas = filtro ? reglas.filter((r) => r.origen.toLowerCase().includes(filtro)) : reglas;
+    if (reglas.length === 0)
+        return "rule://: no se ha descubierto ninguna regla en este proyecto.";
+    if (encontradas.length === 0) {
+        const origenes = [...new Set(reglas.map((r) => r.origen))].join(", ");
+        return `rule://${origen}: ninguna regla descubierta de ese origen. Orígenes presentes: ${origenes}.`;
+    }
+    const cuerpo = encontradas.map((r) => `── ${r.ruta} (${r.origen}) ──\n${r.contenido}`).join("\n\n");
+    const recortado = truncateHead(cuerpo, { maxBytes: TOPE_SALIDA });
+    let salida = `${encontradas.length} regla(s) de ${filtro ? origen : "todos los orígenes"}:\n${recortado.content}`;
+    if (recortado.truncated)
+        salida += "\n\n[recortado; pide un origen más concreto para ver el resto]";
+    if (omitidas.length > 0)
+        salida += `\n\nOmitidas: ${omitidas.map((o) => `${o.ruta} (${o.motivo})`).join("; ")}`;
+    return salida;
+}
+//# sourceMappingURL=reglas.js.map

package/dist/core/urls-internas/reglas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reglas.js","sourceRoot":"","sources":["../../../src/core/urls-internas/reglas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC;AAE7B,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,MAAc;IACrD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEpG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,+DAA+D,CAAC;IAChG,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,UAAU,MAAM,kEAAkE,QAAQ,GAAG,CAAC;IACtG,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpG,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAClE,IAAI,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,gBAAgB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;IAClH,IAAI,SAAS,CAAC,SAAS;QAAE,MAAM,IAAI,gEAAgE,CAAC;IACpG,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAChH,OAAO,MAAM,CAAC;AACf,CAAC"}