@hoilab/ada-cli 0.85.0 → 0.85.1

package/dist/core/memoria/almacen.js

@@ -0,0 +1,214 @@
+/**
+ * Almacén de memoria vectorial híbrida con ciclo de vida (ME1+ME2).
+ *
+ * - ME2: embeddings locales hash-based (ver embeddings.ts) y ciclo de vida
+ *   completo: creación → refresco → decaimiento → purga. La lectura filtra
+ *   SIEMPRE expirados (`expiraEn`) y sustituidos (`sustituidoPor`).
+ * - ME1: recall híbrido = coseno vectorial + BM25 léxico simple + decaimiento
+ *   exponencial por frescura + peso por fuente.
+ * - PR6: toda escritura pasa por redactarSecretos() ANTES de tocar el
+ *   almacén — no hay ruta que se lo salte (es privada por construcción).
+ *
+ * Persistencia opcional: JSON atómico en `<directorio>/memoria-hibrida.json`.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { writeTextAtomicSync } from "../utils/atomic-write.js";
+import { coseno, crearEmbedding, tokenizar } from "./embeddings.js";
+import { redactarSecretos } from "./redaccion.js";
+import { PESO_POR_FUENTE, } from "./tipos.js";
+const TTL_POR_DEFECTO_MS = 30 * 24 * 60 * 60 * 1000; // 30 días
+const VIDA_MEDIA_MS = 14 * 24 * 60 * 60 * 1000; // decaimiento: media vida de 14 días
+/** Pesos de la mezcla híbrida. BM25 algo por encima del vector: el léxico exacto manda en empates. */
+const PESO_VECTOR = 0.4;
+const PESO_BM25 = 0.45;
+const PESO_FUENTE = 0.15;
+const K_BM25 = 1.5;
+const B_BM25 = 0.75;
+/** Mínimo de señal léxica/vectorial para considerar un resultado relevante (filtra colisiones de hash). */
+const UMBRAL_RELEVANCIA = 0.05;
+export class MemoriaHibrida {
+    registros = new Map();
+    ahora;
+    ttlPorDefectoMs;
+    fichero;
+    contador = 0;
+    constructor(opciones) {
+        this.ahora = opciones?.ahora ?? (() => Date.now());
+        this.ttlPorDefectoMs = opciones?.ttlPorDefectoMs ?? TTL_POR_DEFECTO_MS;
+        if (opciones?.directorio)
+            this.fichero = join(opciones.directorio, "memoria-hibrida.json");
+        if (this.fichero)
+            this.cargar();
+    }
+    /**
+     * Escribe una memoria nueva. PR6: el contenido pasa por redacción de
+     * secretos antes de calcular embedding ni persistir nada.
+     */
+    escribir(contenido, opciones) {
+        const resultado = redactarSecretos(contenido);
+        if ("error" in resultado)
+            return { ok: false, motivo: resultado.error };
+        const ahoraMs = this.ahora();
+        const id = `mem-${ahoraMs.toString(36)}-${(++this.contador).toString(36)}-${Math.random()
+            .toString(36)
+            .slice(2, 8)}`;
+        const registro = {
+            id,
+            contenido: resultado.texto,
+            embedding: crearEmbedding(resultado.texto),
+            creadoEn: ahoraMs,
+            refrescadoEn: ahoraMs,
+            expiraEn: ahoraMs + (opciones?.ttlMs ?? this.ttlPorDefectoMs),
+            fuente: opciones?.fuente ?? "agente",
+        };
+        this.registros.set(id, registro);
+        this.persistir();
+        return { ok: true, id, redacciones: resultado.redacciones };
+    }
+    /**
+     * Recall híbrido: solo vivos (no expirados, no sustituidos), puntuados por
+     * coseno + BM25 + frescura decae exponencial desde el último refresco +
+     * peso por fuente. `recordar` refresca lo que acierta: lo usado no muere.
+     */
+    recordar(consulta, limite = 5) {
+        const ahoraMs = this.ahora();
+        const vivos = [...this.registros.values()].filter((r) => this.estaVivo(r, ahoraMs));
+        if (vivos.length === 0 || tokenizar(consulta).length === 0)
+            return [];
+        const embConsulta = crearEmbedding(consulta);
+        const tokensConsulta = new Set(tokenizar(consulta));
+        const longitudes = vivos.map((r) => tokenizar(r.contenido).length);
+        const longitudMedia = longitudes.reduce((a, b) => a + b, 0) / Math.max(longitudes.length, 1);
+        const df = new Map();
+        for (const r of vivos) {
+            for (const t of new Set(tokenizar(r.contenido))) {
+                if (tokensConsulta.has(t))
+                    df.set(t, (df.get(t) ?? 0) + 1);
+            }
+        }
+        const n = vivos.length;
+        const resultados = vivos.map((r, i) => {
+            const vector = Math.max(coseno(embConsulta, r.embedding), 0);
+            const bm25 = this.bm25(r, tokensConsulta, df, n, longitudes[i], longitudMedia);
+            if (vector === 0 && bm25 === 0) {
+                // Sin coincidencia ni vectorial ni léxica: fuera, aunque sea reciente.
+                return {
+                    id: r.id,
+                    contenido: r.contenido,
+                    puntuacion: 0,
+                    componentes: { vector, bm25, frescura: 0, fuente: PESO_POR_FUENTE[r.fuente] },
+                };
+            }
+            const edad = ahoraMs - r.refrescadoEn;
+            const frescura = Math.exp(-edad / VIDA_MEDIA_MS);
+            const fuente = PESO_POR_FUENTE[r.fuente];
+            const puntuacion = PESO_VECTOR * vector + PESO_BM25 * bm25 + PESO_FUENTE * frescura * fuente;
+            return {
+                id: r.id,
+                contenido: r.contenido,
+                puntuacion,
+                componentes: { vector, bm25, frescura, fuente },
+            };
+        });
+        resultados.sort((a, b) => b.puntuacion - a.puntuacion);
+        const top = resultados
+            .filter((r) => PESO_VECTOR * r.componentes.vector + PESO_BM25 * r.componentes.bm25 >= UMBRAL_RELEVANCIA)
+            .slice(0, limite);
+        // Refresco por uso: recordar una memoria extiende su vida (fase "refresco").
+        for (const r of top)
+            this.refrescar(r.id);
+        return top;
+    }
+    /** Refresca un registro: reinicia su reloj de decaimiento y extiende el TTL. */
+    refrescar(id) {
+        const r = this.registros.get(id);
+        if (!r || !this.estaVivo(r, this.ahora()))
+            return false;
+        r.refrescadoEn = this.ahora();
+        r.expiraEn = this.ahora() + this.ttlPorDefectoMs;
+        this.registros.set(id, r);
+        this.persistir();
+        return true;
+    }
+    /** Marca un registro como sustituido: desaparece de la lectura, purgable después. */
+    sustituir(idViejo, idNuevo) {
+        const viejo = this.registros.get(idViejo);
+        if (!viejo)
+            return false;
+        viejo.sustituidoPor = idNuevo;
+        this.persistir();
+        return true;
+    }
+    /** Purga física: elimina expirados y sustituidos. Devuelve los ids eliminados. */
+    purgar() {
+        const ahoraMs = this.ahora();
+        const eliminados = [];
+        for (const [id, r] of this.registros) {
+            if (!this.estaVivo(r, ahoraMs)) {
+                this.registros.delete(id);
+                eliminados.push(id);
+            }
+        }
+        if (eliminados.length > 0)
+            this.persistir();
+        return eliminados;
+    }
+    tamano() {
+        const ahoraMs = this.ahora();
+        let vivos = 0;
+        for (const r of this.registros.values())
+            if (this.estaVivo(r, ahoraMs))
+                vivos++;
+        return { total: this.registros.size, vivos };
+    }
+    /** Copia de los registros vivos — entrada para el grafo episódico (ME5). */
+    vivos() {
+        const ahoraMs = this.ahora();
+        return [...this.registros.values()].filter((r) => this.estaVivo(r, ahoraMs));
+    }
+    /** Lee un registro por id; undefined si no existe. */
+    obtener(id) {
+        return this.registros.get(id);
+    }
+    estaVivo(r, ahoraMs) {
+        return r.expiraEn > ahoraMs && r.sustituidoPor === undefined;
+    }
+    /** BM25 simple sobre los tokens de la consulta presentes en el documento. */
+    bm25(r, tokensConsulta, df, nTotal, longitud, longitudMedia) {
+        const frecuencias = new Map();
+        for (const t of tokenizar(r.contenido)) {
+            if (tokensConsulta.has(t))
+                frecuencias.set(t, (frecuencias.get(t) ?? 0) + 1);
+        }
+        let score = 0;
+        for (const [t, f] of frecuencias) {
+            const idf = Math.log(1 + (nTotal - (df.get(t) ?? 0) + 0.5) / ((df.get(t) ?? 0) + 0.5));
+            score += idf * ((f * (K_BM25 + 1)) / (f + K_BM25 * (1 - B_BM25 + B_BM25 * (longitud / longitudMedia))));
+        }
+        // Normalización defensiva a [0,1] para mezclar con el coseno.
+        return score / (score + 1);
+    }
+    cargar() {
+        if (!this.fichero)
+            return;
+        try {
+            const raw = readFileSync(this.fichero, "utf8");
+            if (!raw)
+                return;
+            const datos = JSON.parse(raw);
+            for (const r of datos)
+                this.registros.set(r.id, r);
+            this.contador = datos.length;
+        }
+        catch {
+            // Fichero corrupto o ausente: arrancamos vacío, nunca bloqueamos el arranque.
+        }
+    }
+    persistir() {
+        if (!this.fichero)
+            return;
+        writeTextAtomicSync(this.fichero, JSON.stringify([...this.registros.values()], null, "\t"));
+    }
+}
+//# sourceMappingURL=almacen.js.map

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

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

package/dist/core/memoria/dr/respaldo.d.ts

@@ -0,0 +1,34 @@
+import type { AlmacenMemoria } from "../servidor/tipos.ts";
+export interface ManifiestoRespaldo {
+    version: 1;
+    creado: string;
+    sha256Cifrado: string;
+    bytes: number;
+}
+export interface OpcionesRespaldo {
+    /** Directorio donde escribir el fichero .adadr y su manifiesto. */
+    directorio: string;
+    /** Frase de la que deriva la clave (nunca se guarda). */
+    frase: string;
+    /** Cuántos backups conservar antes de podar los más viejos (0 = todos). */
+    maxBackups?: number;
+    /** Inyectable para tests. */
+    ahora?: () => Date;
+}
+export declare function crearRespaldo(datos: string | Uint8Array, opts: OpcionesRespaldo): ManifiestoRespaldo;
+export interface ResultadoRestauracion {
+    datos: string;
+    manifiesto: ManifiestoRespaldo;
+}
+/** Lee un backup, verifica ambos checksums + tag GCM y devuelve el volcado. */
+export declare function leerRespaldo(fichero: string, frase: string): ResultadoRestauracion;
+/**
+ * Respalda el estado completo de un almacén y restaura sobre él.
+ *
+ * Requieren que el almacén exponga `listar`/`reemplazarTodo`; sin ellas no
+ * hay forma honesta de volcarlo completo y se rechaza en vez de inventarse un
+ * backup parcial que daría falsa seguridad.
+ */
+export declare function respaldarAlmacen(almacen: AlmacenMemoria, opts: OpcionesRespaldo): ManifiestoRespaldo;
+export declare function restaurarAlmacen(almacen: AlmacenMemoria, fichero: string, frase: string): number;
+//# sourceMappingURL=respaldo.d.ts.map

package/dist/core/memoria/dr/respaldo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respaldo.d.ts","sourceRoot":"","sources":["../../../../src/core/memoria/dr/respaldo.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,sBAAsB,CAAC;AAyBrE,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAChC,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CAgCpG;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,kBAAkB,CAAC;CAC/B;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAyClF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CAGpG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhG"}

package/dist/core/memoria/dr/respaldo.js

@@ -0,0 +1,133 @@
+import { createCipheriv, createDecipheriv, createHash, randomBytes, scryptSync } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import * as path from "node:path";
+/**
+ * DR (recuperación ante desastres) del almacén de memoria. Hallazgo ME4 de la
+ * auditoría omp: mnemopi respalda el almacén con checksums dobles y restore
+ * verificada (`dr/recovery.ts`); aquí no había NINGÚN backup.
+ *
+ * Diseño:
+ * - El volcado del almacén se cifra con AES-256-GCM; la clave se deriva de una
+ *   frase con scrypt (sal aleatoria por backup). Sin frase no hay lectura ni
+ *   manipulación: la integridad la garantiza el tag GCM y la confidencialidad
+ *   el cifrado — un backup en claro con recuerdos es un fichero de datos
+ *   personales esperando fuga.
+ * - Doble checksum como mnemopi: el manifiesto (en claro, para identificar y
+ *   verificar ANTES de descifrar) guarda el SHA-256 del criptograma; dentro,
+ *   el volcado cifrado guarda el SHA-256 del texto plano. Restaurar verifica
+ *   los dos: si cualquiera no cuadra, el backup está corrompido o manipulado
+ *   y se rechaza sin tocar el almacén.
+ */
+const MAGICO = "ADADR1\n";
+const LONGITUD_SAL = 16;
+const LONGITUD_IV = 12;
+const COSTE_SCRYPT = 16384;
+export function crearRespaldo(datos, opts) {
+    const creado = (opts.ahora ?? (() => new Date()))().toISOString();
+    const sal = randomBytes(LONGITUD_SAL);
+    const iv = randomBytes(LONGITUD_IV);
+    const clave = scryptSync(opts.frase, sal, 32, { N: COSTE_SCRYPT });
+    const volcado = JSON.stringify({
+        version: 1,
+        sha256Datos: createHash("sha256").update(datos).digest("hex"),
+        datos: typeof datos === "string" ? datos : Buffer.from(datos).toString("base64"),
+        esBase64: typeof datos !== "string",
+    });
+    // Layout del fichero: MAGICO + [sal | iv | criptograma | tag GCM]. El
+    // manifiesto hashea TODO el cuerpo (sal e iv incluidos), de modo que
+    // cualquier alteración —también de los parámetros KDF— se detecta antes
+    // de intentar descifrar.
+    const cifrador = createCipheriv("aes-256-gcm", clave, iv);
+    const cuerpo = Buffer.concat([sal, iv, cifrador.update(volcado, "utf-8"), cifrador.final(), cifrador.getAuthTag()]);
+    const fichero = path.join(opts.directorio, `memoria-${creado.replaceAll(/[:.]/g, "-")}.adadr`);
+    mkdirSync(opts.directorio, { recursive: true });
+    writeFileSync(fichero, Buffer.concat([Buffer.from(MAGICO), cuerpo]));
+    const manifiesto = {
+        version: 1,
+        creado,
+        sha256Cifrado: createHash("sha256").update(cuerpo).digest("hex"),
+        bytes: cuerpo.length,
+    };
+    writeFileSync(`${fichero}.manifiesto.json`, `${JSON.stringify(manifiesto, null, "\t")}\n`);
+    if ((opts.maxBackups ?? 0) > 0)
+        podar(opts.directorio, opts.maxBackups ?? 0);
+    return manifiesto;
+}
+/** Lee un backup, verifica ambos checksums + tag GCM y devuelve el volcado. */
+export function leerRespaldo(fichero, frase) {
+    if (!existsSync(fichero))
+        throw new Error(`Backup no encontrado: ${fichero}`);
+    const manifiestoRuta = `${fichero}.manifiesto.json`;
+    if (!existsSync(manifiestoRuta))
+        throw new Error("Manifiesto ausente: backup incompleto");
+    let manifiesto;
+    try {
+        manifiesto = JSON.parse(readFileSync(manifiestoRuta, "utf-8"));
+    }
+    catch {
+        throw new Error("Manifiesto corrupto: no es JSON válido");
+    }
+    if (manifiesto.version !== 1)
+        throw new Error(`Versión de manifiesto desconocida: ${String(manifiesto.version)}`);
+    const bruto = readFileSync(fichero);
+    const cabecera = Buffer.from(MAGICO);
+    if (!bruto.subarray(0, cabecera.length).equals(cabecera))
+        throw new Error("Cabecera inválida: no es un backup de memoria");
+    const cuerpo = bruto.subarray(cabecera.length);
+    const sha256Cifrado = createHash("sha256").update(cuerpo).digest("hex");
+    if (manifiesto.sha256Cifrado !== sha256Cifrado) {
+        throw new Error("Checksum del criptograma no coincide con el manifiesto: backup corrupto o manipulado");
+    }
+    if (manifiesto.bytes !== cuerpo.length)
+        throw new Error("Tamaño no coincide con el manifiesto");
+    const sal = cuerpo.subarray(0, LONGITUD_SAL);
+    const iv = cuerpo.subarray(LONGITUD_SAL, LONGITUD_SAL + LONGITUD_IV);
+    const clave = scryptSync(frase, sal, 32, { N: COSTE_SCRYPT });
+    const descifrador = createDecipheriv("aes-256-gcm", clave, iv);
+    descifrador.setAuthTag(cuerpo.subarray(cuerpo.length - 16));
+    let volcadoJson;
+    const cifradoSolo = cuerpo.subarray(LONGITUD_SAL + LONGITUD_IV, cuerpo.length - 16);
+    try {
+        volcadoJson = Buffer.concat([descifrador.update(cifradoSolo), descifrador.final()]).toString("utf-8");
+    }
+    catch {
+        throw new Error("Descifrado fallido: frase incorrecta o contenido alterado");
+    }
+    const volcado = JSON.parse(volcadoJson);
+    const datos = volcado.esBase64 ? Buffer.from(volcado.datos, "base64").toString("utf-8") : volcado.datos;
+    if (createHash("sha256").update(datos).digest("hex") !== volcado.sha256Datos) {
+        throw new Error("Checksum del contenido no coincide tras descifrar: backup corrupto");
+    }
+    return { datos, manifiesto };
+}
+/**
+ * Respalda el estado completo de un almacén y restaura sobre él.
+ *
+ * Requieren que el almacén exponga `listar`/`reemplazarTodo`; sin ellas no
+ * hay forma honesta de volcarlo completo y se rechaza en vez de inventarse un
+ * backup parcial que daría falsa seguridad.
+ */
+export function respaldarAlmacen(almacen, opts) {
+    if (typeof almacen.listar !== "function")
+        throw new Error("El almacén no soporta listado completo: no respaldable");
+    return crearRespaldo(JSON.stringify({ recuerdos: almacen.listar() }), opts);
+}
+export function restaurarAlmacen(almacen, fichero, frase) {
+    if (typeof almacen.reemplazarTodo !== "function")
+        throw new Error("El almacén no soporta restauración completa");
+    const { datos } = leerRespaldo(fichero, frase);
+    const recuerdos = JSON.parse(datos);
+    almacen.reemplazarTodo(recuerdos.recuerdos);
+    return recuerdos.recuerdos.length;
+}
+/** Deja solo los `max` backups más recientes (por nombre, que lleva fecha ISO). */
+function podar(directorio, max) {
+    const ficheros = readdirSync(directorio)
+        .filter((n) => n.endsWith(".adadr"))
+        .sort();
+    for (const viejo of ficheros.slice(0, Math.max(0, ficheros.length - max))) {
+        rmSync(path.join(directorio, viejo), { force: true });
+        rmSync(path.join(directorio, `${viejo}.manifiesto.json`), { force: true });
+    }
+}
+//# sourceMappingURL=respaldo.js.map

package/dist/core/memoria/dr/respaldo.js.map

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

package/dist/core/memoria/embeddings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Embeddings locales hash-based para la memoria híbrida (ME2).
+ *
+ * Sin red, sin modelo, sin sidecars: cada token se proyecta con FNV-1a sobre
+ * un espacio fijo de DIM dimensiones (dos posiciones con signo por token) y
+ * el vector resultante se normaliza L2. Es determinista entre procesos, así
+ * que los vectores guardados en disco siguen siendo comparables tras un
+ * reinicio — propiedad que un embedding de red no garantiza sin
+ * reconciliación.
+ */
+export declare const DIM_EMBEDDING = 512;
+/** Tokeniza para embedding y BM25: minúsculas, sin acentos, alfanumérico, sin palabras vacías. */
+export declare function tokenizar(texto: string): string[];
+/**
+ * Embedding determinista local: bolsa de tokens proyectada por hash.
+ * Normalizado L2 → coseno entre dos embeddings es su producto escalar.
+ */
+export declare function crearEmbedding(texto: string): number[];
+/** Coseno entre dos embeddings ya normalizados (= producto escalar). */
+export declare function coseno(a: readonly number[], b: readonly number[]): number;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/core/memoria/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../src/core/memoria/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,MAAM,CAAC;AA8CjC,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAIjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CActD;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKzE"}

package/dist/core/memoria/embeddings.js

@@ -0,0 +1,87 @@
+/**
+ * Embeddings locales hash-based para la memoria híbrida (ME2).
+ *
+ * Sin red, sin modelo, sin sidecars: cada token se proyecta con FNV-1a sobre
+ * un espacio fijo de DIM dimensiones (dos posiciones con signo por token) y
+ * el vector resultante se normaliza L2. Es determinista entre procesos, así
+ * que los vectores guardados en disco siguen siendo comparables tras un
+ * reinicio — propiedad que un embedding de red no garantiza sin
+ * reconciliación.
+ */
+export const DIM_EMBEDDING = 512;
+/** Longitud mínima de token: descarta artículos/ruido de una sola letra. */
+const TOKEN_MIN = 2;
+/** Palabras vacías españolas frecuentes: sin valor de recuperación, contaminan BM25 y el vector. */
+const STOPWORD = {
+    de: true,
+    del: true,
+    el: true,
+    la: true,
+    los: true,
+    las: true,
+    un: true,
+    una: true,
+    unos: true,
+    unas: true,
+    y: true,
+    o: true,
+    en: true,
+    al: true,
+    con: true,
+    por: true,
+    para: true,
+    es: true,
+    son: true,
+    que: true,
+    se: true,
+    su: true,
+    sus: true,
+    como: true,
+};
+function fnv1a(texto) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < texto.length; i++) {
+        h ^= texto.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+function quitarAcentos(texto) {
+    return texto.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+}
+/** Tokeniza para embedding y BM25: minúsculas, sin acentos, alfanumérico, sin palabras vacías. */
+export function tokenizar(texto) {
+    return quitarAcentos(texto.toLowerCase())
+        .split(/[^a-z0-9ñ_]+/)
+        .filter((t) => t.length >= TOKEN_MIN && STOPWORD[t] !== true);
+}
+/**
+ * Embedding determinista local: bolsa de tokens proyectada por hash.
+ * Normalizado L2 → coseno entre dos embeddings es su producto escalar.
+ */
+export function crearEmbedding(texto) {
+    const vec = new Array(DIM_EMBEDDING).fill(0);
+    for (const token of tokenizar(texto)) {
+        const h = fnv1a(token);
+        vec[h % DIM_EMBEDDING] += (h & 1) === 0 ? 1 : -1;
+        // Segunda posición derivada para reducir colisiones de un solo hash.
+        const h2 = fnv1a(`${token}#2`);
+        vec[h2 % DIM_EMBEDDING] += (h2 & 1) === 0 ? 1 : -1;
+    }
+    let norma = 0;
+    for (const v of vec)
+        norma += v * v;
+    norma = Math.sqrt(norma);
+    if (norma === 0)
+        return vec;
+    return vec.map((v) => v / norma);
+}
+/** Coseno entre dos embeddings ya normalizados (= producto escalar). */
+export function coseno(a, b) {
+    let dot = 0;
+    const n = Math.min(a.length, b.length);
+    for (let i = 0; i < n; i++)
+        dot += a[i] * b[i];
+    return dot;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/core/memoria/embeddings.js.map

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

package/dist/core/memoria/grafo.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Grafo episódico que alimenta el recall (ME5, AUDITORIA-OMP.md :225).
+ *
+ * Nodos = memorias vivas; aristas = afinidad entre dos memorias medida con
+ * tres señales baratas y locales (sin NLP pesado):
+ *   - Jaccard de tokens (reutiliza tokenizar() de embeddings.ts),
+ *   - entidades compartidas (@menciones, rutas de fichero, nombres propios
+ *     capitalizados extraídos con regex simples),
+ *   - proximidad temporal (decae exponencialmente con la distancia entre
+ *     fechas de creación).
+ *
+ * El recall plano (ME1) solo encuentra memorias que comparten léxico con la
+ * consulta; el grafo permite recuperar memorias conectadas a los aciertos
+ * aunque no compartan ninguna palabra con ella (un salto de expansión).
+ */
+import type { MemoriaHibrida } from "./almacen.ts";
+import type { ResultadoRecall } from "./tipos.ts";
+/** Mezcla del re-ranking grafo+recall (contrato del hallazgo ME5). */
+export declare const PESO_RECALL = 0.7;
+export declare const PESO_GRAFO = 0.3;
+/** Entrada mínima para construir el grafo: lo que cualquier registro expone. */
+export interface EntradaGrafo {
+    id: string;
+    contenido: string;
+    creadoEn: number;
+}
+/** Arista dirigida implícita (el grafo es no dirigido; se guarda simétrico). */
+export interface Arista {
+    origen: string;
+    destino: string;
+    peso: number;
+}
+export interface Grafo {
+    nodos: string[];
+    aristas: Arista[];
+    /** vecinosDe(id, k): top-k vecinos por peso de arista. */
+    vecinosDe(id: string, k: number): Array<{
+        id: string;
+        peso: number;
+    }>;
+}
+/**
+ * Extrae entidades con regex simples: @menciones, rutas de fichero (con
+ * separador o extensión plausible) y nombres propios capitalizados. Sin NLP.
+ */
+export declare function extraerEntidades(texto: string): Set<string>;
+/** Construye el grafo episódico completo sobre las entradas dadas. O(n²) en pares — n es pequeño. */
+export declare function construirGrafo(entradas: readonly EntradaGrafo[]): Grafo;
+/**
+ * Recall con expansión por grafo (ME5): reúsa `recordar()` del almacén como
+ * seeds, expande un salto por los vecinos de los top seeds y re-ranquea con
+ * `puntuacion * 0.7 + pesoAristaHaciaSeed * 0.3`. Las memorias conectadas a
+ * un acierto pero invisibles para el recall plano entran por su arista.
+ */
+export declare function recallConGrafo(almacen: MemoriaHibrida, consulta: string, k?: number): ResultadoRecall[];
+//# sourceMappingURL=grafo.d.ts.map

package/dist/core/memoria/grafo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafo.d.ts","sourceRoot":"","sources":["../../../src/core/memoria/grafo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAalD,sEAAsE;AACtE,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,MAAM;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,KAAK;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAe3D;AAeD,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,KAAK,CAmCvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,eAAe,EAAE,CAiClG"}