@nac3/forge-cli 1.15.0 → 1.16.0

package/dist/audit/persistence_async.d.ts

@@ -0,0 +1,101 @@
+/**
+ * El candado que faltaba: la interfaz de persistencia es ASINCRONICA desde la
+ * linea 1.
+ *
+ * POR QUE EXISTE (Pablo, 13-oct-2026, mirando ADIP-Kikan). El brain construyo
+ * Kikan bien en lo estructural: el primer commit dice "nucleo kawa/sazanami +
+ * persistencia MariaDB", hay capa de repositorio, y `mysqlStore` hace
+ * write-through a MariaDB con hidratacion al arranque -- el dato productivo es
+ * durable y siempre lo fue. La decision equivocada fue UNA, y es una FIRMA:
+ * la interfaz del repositorio quedo SINCRONICA. De ahi sale todo lo demas, por
+ * mecanica pura:
+ *
+ *   1. un driver SQL real es asincronico, y una interfaz sincronica no lo puede
+ *      envolver;
+ *   2. entonces el store "de MariaDB" tuvo que quedarse el working set en RAM
+ *      para servir lecturas sincronas -- su propia cabecera lo dice: "lecturas
+ *      sincronas, interfaz IDENTICA a createMemoryStore -> no reescribe el
+ *      motor";
+ *   3. y como un working set en memoria no necesita columnas, el esquema
+ *      degenero en UNA tabla generica de JSON (`engine_rows`), con las 57
+ *      tablas 3NF como read-model DERIVADO en vez de sistema de registro.
+ *
+ * Una firma de funcion, y de ahi 1.543 puntos de deuda y nueve slices de
+ * conversion.
+ *
+ * LA ASIMETRIA, que es la razon por la que esto no necesita ninguna ronda de
+ * dimensionamiento para decidirse:
+ *
+ *   - `await` sobre un valor que no es Promise NO HACE NADA. Declarar el store
+ *     asincronico desde la linea 1 cuesta CERO cuando el store es de memoria.
+ *   - El camino inverso -- sincronico a asincronico -- es cada punto de
+ *     llamada del sistema. En Kikan fueron 1.543.
+ *
+ * Dos opciones donde una es gratis y reversible y la otra es una reescritura no
+ * son dos opciones: una decision asimetrica se toma SIEMPRE del lado
+ * recuperable, incluso sin un solo dato de volumetria.
+ *
+ * POR QUE "DECLARADO async" Y NO "DEVUELVE UNA PROMISE": la segunda es mas
+ * precisa y requiere analisis de flujo. La primera es trivial de cumplir
+ * (`async` sobre algo que ya devuelve una promesa no cambia nada) y trivial de
+ * verificar. Una regla estricta y simple que cualquiera puede satisfacer vale
+ * mas que una regla astuta que hay que interpretar.
+ *
+ * EL MODO DE FALLAR QUE IMPORTA ES EL FALSO NEGATIVO: un store que el detector
+ * no reconoce es deuda que el candado no cuenta, y el numero daria verde sin
+ * que nadie haya hecho nada. Por eso un archivo que no se puede analizar va a
+ * `ilegibles` y el control FALLA, en vez de contar cero. Misma disciplina que
+ * el trinquete de Kikan.
+ *
+ * ASCII-only.
+ */
+/** Los verbos que tocan una fila. Si un modulo expone varios de estos, es un
+ *  store, se llame como se llame. */
+export declare const VERBOS_DATOS: readonly ["insert", "bulkInsert", "insertMany", "update", "patch", "upsert", "save", "remove", "removeAll", "delete", "deleteAll", "destroy", "get", "getById", "find", "findOne", "findAll", "findMany", "all", "list", "query", "select", "count", "exists", "first"];
+/** Cuantos verbos distintos tiene que exponer un modulo sin nombre delator
+ *  para que lo tratemos como store. */
+export declare const VERBOS_MINIMOS_POR_FORMA = 4;
+export type Forma = 'metodo' | 'propiedad-funcion' | 'propiedad-flecha';
+export interface Hallazgo {
+    archivo: string;
+    linea: number;
+    metodo: string;
+    forma: Forma;
+}
+export interface Exento {
+    archivo: string;
+    linea: number;
+    metodo: string;
+    motivo: string;
+}
+export interface Resultado {
+    /** Los modulos que el detector trata como store. */
+    modulos: string[];
+    /** Metodos de acceso a datos vistos en esos modulos. */
+    vistos: number;
+    /** De esos, los declarados async. */
+    asincronicos: number;
+    /** Los SINCRONICOS: cada uno es una ocasion de repetir el defecto de Kikan. */
+    hallazgos: Hallazgo[];
+    /** Eximidos a mano, con su motivo. */
+    exentos: Exento[];
+    /** No se pudieron analizar. El control FALLA con esto no vacio. */
+    ilegibles: string[];
+}
+export declare function enmascarar(texto: string): string;
+/** Las llaves balancean. Si no, el archivo no se puede analizar con confianza. */
+export declare function balancea(mascara: string): boolean;
+/** Es este archivo un store? */
+export declare function esStore(ruta: string, mascara: string): boolean;
+/**
+ * Analiza un archivo. `fuentes` es [ruta, texto].
+ *
+ * Devuelve null cuando el archivo NO es un store (nada que decir), y un
+ * resultado parcial cuando si lo es.
+ */
+export declare function analizarArchivo(ruta: string, texto: string): Resultado | null;
+/** Junta el analisis de muchos archivos. */
+export declare function analizar(fuentes: Array<[string, string]>): Resultado;
+/** Pasa el control? Un ilegible lo hace fallar: no se afirma lo que no se midio. */
+export declare function aprueba(r: Resultado): boolean;
+//# sourceMappingURL=persistence_async.d.ts.map

package/dist/audit/persistence_async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence_async.d.ts","sourceRoot":"","sources":["../../src/audit/persistence_async.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH;qCACqC;AACrC,eAAO,MAAM,YAAY,yQAMf,CAAC;AAIX;uCACuC;AACvC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAuB1C,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAExE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAgHD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqDhD;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOjD;AAyDD,gCAAgC;AAChC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK9D;AAQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAqC7E;AAED,4CAA4C;AAC5C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAepE;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAE7C"}

package/dist/audit/persistence_async.js

@@ -0,0 +1,435 @@
+/**
+ * El candado que faltaba: la interfaz de persistencia es ASINCRONICA desde la
+ * linea 1.
+ *
+ * POR QUE EXISTE (Pablo, 13-oct-2026, mirando ADIP-Kikan). El brain construyo
+ * Kikan bien en lo estructural: el primer commit dice "nucleo kawa/sazanami +
+ * persistencia MariaDB", hay capa de repositorio, y `mysqlStore` hace
+ * write-through a MariaDB con hidratacion al arranque -- el dato productivo es
+ * durable y siempre lo fue. La decision equivocada fue UNA, y es una FIRMA:
+ * la interfaz del repositorio quedo SINCRONICA. De ahi sale todo lo demas, por
+ * mecanica pura:
+ *
+ *   1. un driver SQL real es asincronico, y una interfaz sincronica no lo puede
+ *      envolver;
+ *   2. entonces el store "de MariaDB" tuvo que quedarse el working set en RAM
+ *      para servir lecturas sincronas -- su propia cabecera lo dice: "lecturas
+ *      sincronas, interfaz IDENTICA a createMemoryStore -> no reescribe el
+ *      motor";
+ *   3. y como un working set en memoria no necesita columnas, el esquema
+ *      degenero en UNA tabla generica de JSON (`engine_rows`), con las 57
+ *      tablas 3NF como read-model DERIVADO en vez de sistema de registro.
+ *
+ * Una firma de funcion, y de ahi 1.543 puntos de deuda y nueve slices de
+ * conversion.
+ *
+ * LA ASIMETRIA, que es la razon por la que esto no necesita ninguna ronda de
+ * dimensionamiento para decidirse:
+ *
+ *   - `await` sobre un valor que no es Promise NO HACE NADA. Declarar el store
+ *     asincronico desde la linea 1 cuesta CERO cuando el store es de memoria.
+ *   - El camino inverso -- sincronico a asincronico -- es cada punto de
+ *     llamada del sistema. En Kikan fueron 1.543.
+ *
+ * Dos opciones donde una es gratis y reversible y la otra es una reescritura no
+ * son dos opciones: una decision asimetrica se toma SIEMPRE del lado
+ * recuperable, incluso sin un solo dato de volumetria.
+ *
+ * POR QUE "DECLARADO async" Y NO "DEVUELVE UNA PROMISE": la segunda es mas
+ * precisa y requiere analisis de flujo. La primera es trivial de cumplir
+ * (`async` sobre algo que ya devuelve una promesa no cambia nada) y trivial de
+ * verificar. Una regla estricta y simple que cualquiera puede satisfacer vale
+ * mas que una regla astuta que hay que interpretar.
+ *
+ * EL MODO DE FALLAR QUE IMPORTA ES EL FALSO NEGATIVO: un store que el detector
+ * no reconoce es deuda que el candado no cuenta, y el numero daria verde sin
+ * que nadie haya hecho nada. Por eso un archivo que no se puede analizar va a
+ * `ilegibles` y el control FALLA, en vez de contar cero. Misma disciplina que
+ * el trinquete de Kikan.
+ *
+ * ASCII-only.
+ */
+/** Los verbos que tocan una fila. Si un modulo expone varios de estos, es un
+ *  store, se llame como se llame. */
+export const VERBOS_DATOS = [
+    'insert', 'bulkInsert', 'insertMany',
+    'update', 'patch', 'upsert', 'save',
+    'remove', 'removeAll', 'delete', 'deleteAll', 'destroy',
+    'get', 'getById', 'find', 'findOne', 'findAll', 'findMany',
+    'all', 'list', 'query', 'select', 'count', 'exists', 'first',
+];
+const VERBOS = new Set(VERBOS_DATOS);
+/** Cuantos verbos distintos tiene que exponer un modulo sin nombre delator
+ *  para que lo tratemos como store. */
+export const VERBOS_MINIMOS_POR_FORMA = 4;
+/** El nombre del archivo o su carpeta ya lo delatan. */
+const NOMBRE_DELATOR = /(^|[^a-z])(store|repo|repository|dao|persistence|datastore)([^a-z]|$)/i;
+const CARPETA_DELATORA = /(^|[\\/])(data|stores?|repositor(y|ies)|persistence|dao)([\\/]|$)/i;
+/**
+ * Parte camelCase para que el delator se vea: `memoryStore` -> `memory Store`,
+ * `userRepository` -> `user Repository`.
+ *
+ * Sin esto el detector se perdia `userRepository.ts` -- la palabra delatora
+ * estaba ahi, pero pegada a la anterior, y el borde que pedia el regex no
+ * existia. Es exactamente un FALSO NEGATIVO del detector, la clase de error que
+ * hace mentir a un candado, y lo encontro su propia bateria.
+ */
+function separarCamel(s) {
+    return s.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
+}
+/** La marca para eximir un metodo a mano. Se CUENTA y se reporta: una exencion
+ *  invisible es un agujero, una exencion contada es una decision. */
+const MARCA_EXENTO = /persistence-async-ok:\s*(.+)$/;
+/**
+ * Tapa comentarios y literales de cadena con espacios, conservando los saltos
+ * de linea para que los numeros de linea sigan siendo validos.
+ *
+ * Sin esto, un `insert(` dentro de un comentario o de un template string cuenta
+ * como declaracion, y la frase "no uses insert() sin await" en un comentario
+ * generaria un hallazgo fantasma.
+ */
+/** Fin de una cadena simple (`'` o `"`): el indice DESPUES de la comilla que cierra. */
+function finDeCadena(texto, inicio, cierre) {
+    const n = texto.length;
+    let j = inicio + 1;
+    while (j < n) {
+        if (texto[j] === '\\') {
+            j += 2;
+            continue;
+        }
+        if (texto[j] === cierre)
+            return j + 1;
+        if (texto[j] === '\n')
+            return j; /* cadena sin cerrar: no arrastra el archivo */
+        j++;
+    }
+    return n;
+}
+/**
+ * Fin de un template literal, el indice DESPUES del backtick que cierra.
+ *
+ * Tiene que entender `${...}` porque la interpolacion es CODIGO y puede
+ * contener otro template adentro. El caso real que lo trajo aca, de
+ * `sqlStore.js` de Kikan (encontrado calibrando, 13-oct-2026):
+ *
+ *     `UPDATE \`${t}\` SET ${cols.map((c) => `\`${c}\` = ?`).join(', ')} WHERE ...`
+ *
+ * Un escaner ingenuo cierra el string en el backtick ANIDADO y a partir de ahi
+ * lee la mitad del template como codigo: en `sqlStore.js` eso dejaba tres `}`
+ * de mas y el archivo entero caia en `ilegibles`. O sea: el defecto no era un
+ * falso positivo molesto, era el candado dandose por vencido sobre el store
+ * mas importante del proyecto.
+ */
+function finDeTemplate(texto, inicio) {
+    const n = texto.length;
+    let j = inicio + 1;
+    while (j < n) {
+        const c = texto[j];
+        if (c === '\\') {
+            j += 2;
+            continue;
+        }
+        if (c === '`')
+            return j + 1;
+        if (c === '$' && texto[j + 1] === '{') {
+            j = finDeInterpolacion(texto, j + 2);
+            continue;
+        }
+        j++;
+    }
+    return n;
+}
+/** Desde justo despues de `${`, el indice DESPUES del `}` que cierra. */
+function finDeInterpolacion(texto, desde) {
+    const n = texto.length;
+    let profundidad = 1;
+    let j = desde;
+    while (j < n && profundidad > 0) {
+        const c = texto[j];
+        if (c === '\\') {
+            j += 2;
+            continue;
+        }
+        if (c === '`') {
+            j = finDeTemplate(texto, j);
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            j = finDeCadena(texto, j, c);
+            continue;
+        }
+        if (c === '{') {
+            profundidad++;
+            j++;
+            continue;
+        }
+        if (c === '}') {
+            profundidad--;
+            j++;
+            continue;
+        }
+        j++;
+    }
+    return j;
+}
+/* Palabras tras las cuales un `/` abre una expresion regular y no es division.
+ * `return /x/.test(s)` es el caso que importa. */
+const ANTES_DE_REGEX = /(^|[^\w$])(return|typeof|case|in|of|new|delete|void|do|else|yield|await|throw)$/;
+/**
+ * Abre una expresion regular este `/`, o es una division?
+ *
+ * La regla: es regex salvo que lo anterior sea algo que PUEDE TERMINAR una
+ * expresion -- un identificador, un numero, `)`, `]` o `}`. Mas la excepcion de
+ * las palabras clave, porque `return` termina en una letra pero no es un valor.
+ *
+ * Un `/` mal clasificado como division deja las llaves del regex contadas; mal
+ * clasificado como regex se come codigo hasta el proximo `/`. Las dos cosas
+ * terminan en `ilegibles`, que es ruidoso pero HONESTO: nunca en un conteo
+ * silenciosamente bajo.
+ */
+function abreRegex(texto, i) {
+    let k = i - 1;
+    while (k >= 0 && /\s/.test(texto[k]))
+        k--;
+    if (k < 0)
+        return true;
+    const c = texto[k];
+    if (/[)\]}]/.test(c))
+        return false;
+    if (/[\w$]/.test(c))
+        return ANTES_DE_REGEX.test(texto.slice(Math.max(0, k - 11), k + 1));
+    return true;
+}
+/** Fin de una expresion regular: el indice DESPUES del `/` que cierra. Si no
+ *  cierra en la misma linea, no era un regex y no se tapa nada. */
+function finDeRegex(texto, inicio) {
+    const n = texto.length;
+    let j = inicio + 1;
+    let enClase = false;
+    while (j < n) {
+        const c = texto[j];
+        if (c === '\\') {
+            j += 2;
+            continue;
+        }
+        if (c === '\n')
+            return inicio + 1; /* no era un regex */
+        if (enClase) {
+            if (c === ']')
+                enClase = false;
+            j++;
+            continue;
+        }
+        if (c === '[') {
+            enClase = true;
+            j++;
+            continue;
+        }
+        if (c === '/')
+            return j + 1;
+        j++;
+    }
+    return inicio + 1;
+}
+export function enmascarar(texto) {
+    const out = texto.split('');
+    let i = 0;
+    const n = texto.length;
+    const tapar = (desde, hasta) => {
+        for (let k = desde; k < hasta && k < n; k++) {
+            if (out[k] !== '\n')
+                out[k] = ' ';
+        }
+    };
+    while (i < n) {
+        const c = texto[i];
+        const d = texto[i + 1];
+        if (c === '/' && d === '/') {
+            let j = i + 2;
+            while (j < n && texto[j] !== '\n')
+                j++;
+            tapar(i, j);
+            i = j;
+            continue;
+        }
+        if (c === '/' && d === '*') {
+            let j = i + 2;
+            while (j < n && !(texto[j] === '*' && texto[j + 1] === '/'))
+                j++;
+            tapar(i, Math.min(j + 2, n));
+            i = j + 2;
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            const fin = finDeCadena(texto, i, c);
+            tapar(i, fin);
+            i = fin;
+            continue;
+        }
+        if (c === '`') {
+            /* Se tapa el template COMPLETO, interpolaciones incluidas. Las llaves de
+             * una interpolacion vienen de a pares, asi que taparlas no desbalancea
+             * nada -- y el codigo de una interpolacion no declara metodos de store. */
+            const fin = finDeTemplate(texto, i);
+            tapar(i, fin);
+            i = fin;
+            continue;
+        }
+        if (c === '/' && abreRegex(texto, i)) {
+            /* Los literales de regex traen llaves: `{0,400}`, `\{`, `[^{}]`. Sin
+             * taparlos el balanceo miente -- y lo encontre con el candado corriendo
+             * sobre ESTE archivo, que es el que mas regex tiene del repo. */
+            const fin = finDeRegex(texto, i);
+            tapar(i, fin);
+            i = fin;
+            continue;
+        }
+        i++;
+    }
+    return out.join('');
+}
+/** Las llaves balancean. Si no, el archivo no se puede analizar con confianza. */
+export function balancea(mascara) {
+    let n = 0;
+    for (const c of mascara) {
+        if (c === '{')
+            n++;
+        else if (c === '}') {
+            n--;
+            if (n < 0)
+                return false;
+        }
+    }
+    return n === 0;
+}
+/** Los verbos distintos que el modulo expone como DECLARACION. */
+function verbosDeclarados(mascara) {
+    const vistos = new Set();
+    for (const m of declaraciones(mascara)) {
+        if (VERBOS.has(m.nombre))
+            vistos.add(m.nombre);
+    }
+    return vistos;
+}
+/**
+ * Las declaraciones de metodo del texto enmascarado.
+ *
+ * Una DECLARACION tiene su lista de parametros seguida de `{` o de `=>`; una
+ * LLAMADA termina en `;`, en `)` o en `,`. Eso es lo que separa
+ * `insert(table, row) {` de `store.insert(table, row);`. Y el `(?<![.\w$])`
+ * de adelante descarta `store.insert(` y `reinsert(`.
+ *
+ * La lista de parametros puede ocupar varias lineas, asi que se admiten saltos
+ * adentro -- acotados, para que un parentesis sin cerrar no arrastre el archivo
+ * entero.
+ */
+function* declaraciones(mascara) {
+    /* metodo de objeto o de clase: `nombre(...) {` con `async` opcional */
+    const reMetodo = /(?<![.\w$])(async\s+)?([A-Za-z_$][\w$]*)\s*\(([^()]{0,400})\)\s*\{/g;
+    for (let m = reMetodo.exec(mascara); m; m = reMetodo.exec(mascara)) {
+        const nombre = m[2];
+        /* `if (...) {`, `for (...) {`, `catch (...) {` tienen la misma forma */
+        if (CONTROL.has(nombre))
+            continue;
+        yield { nombre, indice: m.index, esAsync: !!m[1], forma: 'metodo' };
+    }
+    /* propiedad con funcion: `nombre: async function (...)` / `nombre: function` */
+    const reFn = /(?<![.\w$])([A-Za-z_$][\w$]*)\s*:\s*(async\s+)?function\b/g;
+    for (let m = reFn.exec(mascara); m; m = reFn.exec(mascara)) {
+        yield { nombre: m[1], indice: m.index, esAsync: !!m[2], forma: 'propiedad-funcion' };
+    }
+    /* propiedad con flecha: `nombre: async (...) =>` / `nombre: (...) =>` */
+    const reFlecha = /(?<![.\w$])([A-Za-z_$][\w$]*)\s*:\s*(async\s+)?\(([^()]{0,400})\)\s*=>/g;
+    for (let m = reFlecha.exec(mascara); m; m = reFlecha.exec(mascara)) {
+        yield { nombre: m[1], indice: m.index, esAsync: !!m[2], forma: 'propiedad-flecha' };
+    }
+}
+/* Palabras de control que tienen la misma forma que un metodo. */
+const CONTROL = new Set([
+    'if', 'for', 'while', 'switch', 'catch', 'function', 'return', 'do', 'else',
+    'with', 'typeof', 'await', 'new', 'delete_', 'try', 'finally',
+]);
+/** Es este archivo un store? */
+export function esStore(ruta, mascara) {
+    const base = ruta.split(/[\\/]/).pop() ?? ruta;
+    if (NOMBRE_DELATOR.test(separarCamel(base)))
+        return true;
+    if (CARPETA_DELATORA.test(ruta))
+        return true;
+    return verbosDeclarados(mascara).size >= VERBOS_MINIMOS_POR_FORMA;
+}
+function lineaDe(texto, indice) {
+    let n = 1;
+    for (let i = 0; i < indice && i < texto.length; i++)
+        if (texto[i] === '\n')
+            n++;
+    return n;
+}
+/**
+ * Analiza un archivo. `fuentes` es [ruta, texto].
+ *
+ * Devuelve null cuando el archivo NO es un store (nada que decir), y un
+ * resultado parcial cuando si lo es.
+ */
+export function analizarArchivo(ruta, texto) {
+    const mascara = enmascarar(texto);
+    if (!esStore(ruta, mascara))
+        return null;
+    const res = {
+        modulos: [ruta], vistos: 0, asincronicos: 0, hallazgos: [], exentos: [], ilegibles: [],
+    };
+    if (!balancea(mascara)) {
+        res.ilegibles.push(ruta);
+        return res;
+    }
+    const lineas = texto.split('\n');
+    for (const d of declaraciones(mascara)) {
+        if (!VERBOS.has(d.nombre))
+            continue;
+        res.vistos++;
+        const linea = lineaDe(texto, d.indice);
+        if (d.esAsync) {
+            res.asincronicos++;
+            continue;
+        }
+        /* exencion a mano: en la misma linea o en la de arriba */
+        const cerca = (lineas[linea - 1] ?? '') + '\n' + (lineas[linea - 2] ?? '');
+        const marca = MARCA_EXENTO.exec(cerca);
+        if (marca) {
+            res.exentos.push({ archivo: ruta, linea, metodo: d.nombre, motivo: marca[1].trim() });
+            continue;
+        }
+        res.hallazgos.push({ archivo: ruta, linea, metodo: d.nombre, forma: d.forma });
+    }
+    /* LA CONTRACARA: si la FORMA dijo que es un store porque vio N verbos y el
+     * escaner de declaraciones encontro menos, entonces uno de los dos esta mal
+     * y el archivo no se puede afirmar. Vale sobre todo para un store con listas
+     * de parametros largas, que es justo donde el regex se queda corto. */
+    const porForma = verbosDeclarados(mascara).size;
+    if (res.vistos < porForma)
+        res.ilegibles.push(ruta);
+    return res;
+}
+/** Junta el analisis de muchos archivos. */
+export function analizar(fuentes) {
+    const total = {
+        modulos: [], vistos: 0, asincronicos: 0, hallazgos: [], exentos: [], ilegibles: [],
+    };
+    for (const [ruta, texto] of fuentes) {
+        const r = analizarArchivo(ruta, texto);
+        if (!r)
+            continue;
+        total.modulos.push(...r.modulos);
+        total.vistos += r.vistos;
+        total.asincronicos += r.asincronicos;
+        total.hallazgos.push(...r.hallazgos);
+        total.exentos.push(...r.exentos);
+        total.ilegibles.push(...r.ilegibles);
+    }
+    return total;
+}
+/** Pasa el control? Un ilegible lo hace fallar: no se afirma lo que no se midio. */
+export function aprueba(r) {
+    return r.hallazgos.length === 0 && r.ilegibles.length === 0;
+}
+//# sourceMappingURL=persistence_async.js.map

package/dist/audit/persistence_async.js.map

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

package/dist/bin/yf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsEpC,wBAAgB,YAAY,IAAI,OAAO,CA6GtC"}
+{"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuEpC,wBAAgB,YAAY,IAAI,OAAO,CA8GtC"}

package/dist/bin/yf.js

@@ -20,6 +20,7 @@ import { registerEmbedCommand } from '../commands/embed.js';
 import { registerLicenseCommand } from '../commands/license.js';
 import { registerDoctorCommand } from '../commands/doctor.js';
 import { registerValidateCommand } from '../commands/validate.js';
+import { registerAuditPersistenceCommand } from '../commands/audit-persistence.js';
 import { registerPilotCommand } from '../commands/pilot.js';
 import { registerGenTestsCommand } from '../commands/gen-tests.js';
 import { registerGenFlowTestsCommand } from '../commands/gen-flow-tests.js';
@@ -106,6 +107,7 @@ export function buildProgram() {
     registerLicenseCommand(program);
     registerDoctorCommand(program);
     registerValidateCommand(program);
+    registerAuditPersistenceCommand(program);
     registerEmbedCommand(program);
     registerPilotCommand(program);
     registerGenTestsCommand(program);

package/dist/bin/yf.js.map

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

package/dist/chat/doctrine_digest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctrine_digest.d.ts","sourceRoot":"","sources":["../../src/chat/doctrine_digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,eAAe,EAAE,mBAAmB,EAoJhD,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,MAAM,WAAW,qBAAqB;IACpC;4EACwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;uEACuE;AACvE,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,qBAA0B,GAAG,MAAM,EAAE,CAiBnF"}
+{"version":3,"file":"doctrine_digest.d.ts","sourceRoot":"","sources":["../../src/chat/doctrine_digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,eAAe,EAAE,mBAAmB,EA4JhD,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,MAAM,WAAW,qBAAqB;IACpC;4EACwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;uEACuE;AACvE,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,qBAA0B,GAAG,MAAM,EAAE,CAiBnF"}

package/dist/chat/doctrine_digest.js

@@ -96,19 +96,27 @@ export const DOCTRINE_DIGEST = [
             + 'instruccion precisa, pending o ticket. Full: discover.',
     },
     {
-        slugs: ['sizing'],
+        slugs: ['sizing', 'persistence-interface'],
         /* Deliberately terse: tests/prompt-invariants.test.ts caps the static
          * prompt, and a longer line here would have to come out of another
          * doctrine. The verbs carry the detail in their descriptions, and the
-         * fixed option catalogue lives in docs/doctrine/sizing.md. */
+         * fixed option catalogue lives in docs/doctrine/sizing.md.
+         *
+         * The async-interface clause was compressed INTO this entry rather than
+         * added as a new one (13-oct-2026): there were 124 chars of prompt budget
+         * left, so the sizing text was tightened to pay for it. It belongs here
+         * anyway -- it is the half of the persistence decision that needs NO
+         * sizing input, and reading them together is the point. */
         rule: 'SIZE BEFORE YOU BUILD (G9, hard gate). Volumetry = entities x '
-            + 'events/year x ROWS PER EVENT (every table it writes) + retention PER '
-            + 'CLASS (business vs trace; 0 = forever = unbounded) + concurrency + '
-            + 'HARDWARE (heap_cap_mb is the runtime heap ceiling, NOT machine RAM). '
-            + 'Ask the owner, never invent it. Pick one option per axis from the '
-            + 'FIXED catalogue (yujin.sizing.show); yujin.sizing.record REFUSES one '
-            + 'outside its envelope and construction cannot start without an '
-            + 'admissible record. Full: discover.',
+            + 'events/year x ROWS PER EVENT (every table) + retention PER CLASS '
+            + '(0 = forever = unbounded) + concurrency + HARDWARE (heap_cap_mb = '
+            + 'heap ceiling, NOT machine RAM). Ask the owner; never invent. One '
+            + 'option per axis from the FIXED catalogue (yujin.sizing.show); record '
+            + 'REFUSES one outside its envelope and construction cannot start '
+            + 'without it. NEEDS NO SIZING: every store/repo method declared async '
+            + 'from commit 1 -- await on a non-Promise is free, sync->async later '
+            + 'is every call site (Kikan 1543). yf audit persistence. '
+            + 'Full: discover.',
     },
     {
         slugs: ['concurrency-scale'],

package/dist/chat/doctrine_digest.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctrine_digest.js","sourceRoot":"","sources":["../../src/chat/doctrine_digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,MAAM,CAAC,MAAM,eAAe,GAA0B;IACpD;QACE,KAAK,EAAE,CAAC,sBAAsB,CAAC;QAC/B,IAAI,EACF,8DAA8D;cAC5D,6DAA6D;cAC7D,+DAA+D;cAC/D,uDAAuD;cACvD,6DAA6D;cAC7D,yDAAyD;cACzD,gEAAgE;cAChE,4DAA4D;cAC5D,mCAAmC;KACxC;IACD;QACE,KAAK,EAAE,CAAC,gBAAgB,CAAC;QACzB,IAAI,EACF,gEAAgE;cAC9D,0DAA0D;cAC1D,4CAA4C;KACjD;IACD;QACE,KAAK,EAAE,CAAC,YAAY,CAAC;QACrB,IAAI,EAAE,2FAA2F;KAClG;IACD;QACE,KAAK,EAAE,CAAC,eAAe,CAAC;QACxB,IAAI,EAAE,2IAA2I;KAClJ;IACD;QACE,KAAK,EAAE,CAAC,OAAO,CAAC;QAChB,IAAI,EAAE,qFAAqF;KAC5F;IACD;QACE,KAAK,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC;QACtC,IAAI,EAAE,2IAA2I;KAClJ;IACD;QACE,KAAK,EAAE,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,uTAAuT;KAC9T;IACD;QACE,KAAK,EAAE,CAAC,OAAO,CAAC;QAChB,IAAI,EAAE,iGAAiG;KACxG;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,CAAC;QAC1B,IAAI,EAAE,qFAAqF;KAC5F;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,CAAC;QAC1B,IAAI,EAAE,4GAA4G;KACnH;IACD;QACE,KAAK,EAAE,CAAC,sBAAsB,CAAC;QAC/B,IAAI,EAAE,kJAAkJ;KACzJ;IACD;QACE,KAAK,EAAE,CAAC,uBAAuB,CAAC;QAChC,IAAI,EAAE,mFAAmF;KAC1F;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,CAAC;QAC1B,IAAI,EACF,+EAA+E;cAC7E,+EAA+E;cAC/E,+EAA+E;cAC/E,yEAAyE;cACzE,2EAA2E;cAC3E,kEAAkE;KACvE;IACD;QACE,KAAK,EAAE,CAAC,cAAc,CAAC;QACvB,IAAI,EACF,8EAA8E;cAC5E,gFAAgF;cAChF,gFAAgF;cAChF,+EAA+E;cAC/E,yEAAyE;cACzE,gFAAgF;cAChF,wEAAwE;cACxE,wDAAwD;KAC7D;IACD;QACE,KAAK,EAAE,CAAC,QAAQ,CAAC;QACjB;;;sEAG8D;QAC9D,IAAI,EACF,gEAAgE;cAC9D,uEAAuE;cACvE,qEAAqE;cACrE,uEAAuE;cACvE,oEAAoE;cACpE,uEAAuE;cACvE,gEAAgE;cAChE,oCAAoC;KACzC;IACD;QACE,KAAK,EAAE,CAAC,mBAAmB,CAAC;QAC5B,IAAI,EACF,uEAAuE;cACrE,6EAA6E;cAC7E,4EAA4E;cAC5E,mEAAmE;cACnE,gCAAgC;KACrC;IACD;QACE,KAAK,EAAE,CAAC,uBAAuB,CAAC;QAChC,IAAI,EACF,yEAAyE;cACvE,4EAA4E;cAC5E,8EAA8E;cAC9E,2EAA2E;cAC3E,8EAA8E;cAC9E,qEAAqE;cACrE,uEAAuE;cACvE,6DAA6D;KAClE;IACD;QACE,KAAK,EAAE,CAAC,kBAAkB,CAAC;QAC3B,IAAI,EAAE,6XAA6X;KACpY;IACD;QACE,KAAK,EAAE,CAAC,UAAU,CAAC;QACnB,IAAI,EAAE,qeAAqe;KAC5e;IACD;QACE,KAAK,EAAE,CAAC,UAAU,CAAC;QACnB,IAAI,EAAE,iFAAiF;KACxF;IACD;QACE,KAAK,EAAE,CAAC,uBAAuB,CAAC;QAChC,IAAI,EAAE,+UAA+U;KACtV;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;QACpD,IAAI,EAAE,wHAAwH;KAC/H;IACD;QACE,KAAK,EAAE,CAAC,cAAc,CAAC;QACvB,IAAI,EAAE,6RAA6R;KACpS;IACD;QACE,KAAK,EAAE,CAAC,sBAAsB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,CAAC;QAC3G,IAAI,EAAE,gLAAgL;KACvL;CACF,CAAC;AAEF,6DAA6D;AAC7D,MAAM,UAAU,WAAW;IACzB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAQD;uEACuE;AACvE,MAAM,UAAU,wBAAwB,CAAC,OAA8B,EAAE;IACvE,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3C,IAAI,CAAC,cAAc,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAa;QACtB,mEAAmE;QACnE,2DAA2D;QAC3D,mEAAmE;QACnE,EAAE;QACF,gEAAgE;QAChE,6DAA6D;QAC7D,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"doctrine_digest.js","sourceRoot":"","sources":["../../src/chat/doctrine_digest.ts"],"names":[],"mappings":"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"}

package/dist/commands/audit-persistence.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `yf audit persistence [path]` -- la interfaz de persistencia es ASINCRONICA.
+ *
+ * El candado que le faltaba a Forge, y la razon esta en ADIP-Kikan (Pablo,
+ * 13-oct-2026): el brain construyo la capa de repositorio bien y persiste en
+ * MariaDB desde el primer commit, pero definio la interfaz SINCRONICA. Eso
+ * obligo al store de MariaDB a mantener el working set en RAM para servir
+ * lecturas sincronas, y de ahi el esquema degenero en una tabla generica de
+ * JSON. Una firma de funcion, 1.543 puntos de deuda y nueve slices de
+ * conversion.
+ *
+ * El analisis vive en `src/audit/persistence_async.ts`, puro y con bateria.
+ * Este archivo es solo el recorrido del arbol y el reporte.
+ *
+ * Corre sobre CUALQUIER proyecto -- recien nacido o heredado -- y no necesita
+ * configuracion: el detector reconoce un store por su nombre, por su carpeta o
+ * por su forma.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface AuditPersistenceOptions {
+    json?: boolean;
+}
+export interface Recolectado {
+    fuentes: Array<[string, string]>;
+    /** Salteados por generados/minificados. Se REPORTAN: un salteo invisible es
+     *  un agujero del mismo tipo que un ilegible que cuenta cero. */
+    generados: string[];
+}
+export declare function recolectarFuentes(raiz: string): Recolectado;
+export declare function registerAuditPersistenceCommand(program: Command): void;
+//# sourceMappingURL=audit-persistence.d.ts.map

package/dist/commands/audit-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-persistence.d.ts","sourceRoot":"","sources":["../../src/commands/audit-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCzC,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjC;qEACiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CA4B3D;AAoED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBtE"}

package/dist/commands/audit-persistence.js

@@ -0,0 +1,173 @@
+import path from 'node:path';
+import { readdirSync, statSync, readFileSync } from 'node:fs';
+import { c, header } from '../ui/colors.js';
+import { analizar, aprueba } from '../audit/persistence_async.js';
+const OMITIR = new Set([
+    'node_modules', 'dist', 'coverage', '.git', '.next', 'build', '.expo',
+    '.turbo', 'out', 'vendor', 'third_party', '__pycache__', 'site-packages',
+    'bower_components', '.cache', '.tox', 'target', '.gradle', '.idea',
+]);
+/* Los entornos virtuales de Python se llaman `.venv`, `venv`, `.venv_test`,
+ * `env`... y adentro traen el chromium de Playwright con sus bundles. */
+const OMITIR_PREFIJO = ['.venv', 'venv', '.env-', 'env-'];
+const EXT = /\.(js|mjs|cjs|ts|tsx)$/;
+/* Las baterias quedan afuera: un doble de test SINCRONICO es legitimo -- lo que
+ * no puede ser sincronico es el store del que depende el producto. */
+const ES_TEST = /\.(test|spec)\.[jt]sx?$/;
+const ES_MINIFICADO = /\.(min|bundle|chunk)\.[jt]s$/;
+/* Una linea de mas de 1000 caracteres no la escribio una persona: es un bundle,
+ * un minificado o un blob generado. Nunca es la capa de persistencia de nadie,
+ * y ademas no se puede analizar con sentido.
+ *
+ * Calibrado contra ADIP-Kikan (13-oct-2026): la primera corrida reporto 26
+ * hallazgos dentro de `xtermModule-COQkjINf.js`, un bundle de Playwright
+ * metido en un `.venv_harness`. Ese ruido es exactamente lo que hace que un
+ * equipo apague un control, y un control apagado no vigila nada. */
+const LARGO_DE_LINEA_GENERADO = 1000;
+function pareceGenerado(texto) {
+    let largo = 0;
+    for (let i = 0; i < texto.length; i++) {
+        if (texto[i] === '\n') {
+            largo = 0;
+            continue;
+        }
+        if (++largo > LARGO_DE_LINEA_GENERADO)
+            return true;
+    }
+    return false;
+}
+export function recolectarFuentes(raiz) {
+    const fuentes = [];
+    const generados = [];
+    const omitirDir = (n) => OMITIR.has(n) || OMITIR_PREFIJO.some((p) => n.startsWith(p));
+    const rec = (dir) => {
+        let items;
+        try {
+            items = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const nombre of items.sort()) {
+            const p = path.join(dir, nombre);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (!omitirDir(nombre))
+                    rec(p);
+                continue;
+            }
+            if (!EXT.test(nombre) || ES_TEST.test(nombre))
+                continue;
+            const rel = path.relative(raiz, p).split(path.sep).join('/');
+            if (ES_MINIFICADO.test(nombre)) {
+                generados.push(rel);
+                continue;
+            }
+            let texto;
+            try {
+                texto = readFileSync(p, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            if (pareceGenerado(texto)) {
+                generados.push(rel);
+                continue;
+            }
+            fuentes.push([rel, texto]);
+        }
+    };
+    rec(raiz);
+    return { fuentes, generados };
+}
+function imprimir(raiz, r, archivos, generados) {
+    header('Yujin Forge -- audit persistence');
+    console.log('');
+    console.log('  Proyecto: ' + c.dim(raiz));
+    console.log('  ' + c.dim(archivos + ' archivos leidos, ' + r.modulos.length + ' modulo(s) de persistencia'
+        + (generados ? ', ' + generados + ' generado(s)/minificado(s) salteado(s)' : '')));
+    console.log('');
+    if (r.modulos.length === 0) {
+        console.log(c.dim('  No se detecto ninguna capa de persistencia.'));
+        console.log('');
+        console.log(c.success('  OK') + c.dim(' -- nada que vigilar todavia.'));
+        return;
+    }
+    console.log('  Metodos de acceso a datos: ' + r.vistos
+        + c.dim('  (async ' + r.asincronicos + ' / sincronicos ' + r.hallazgos.length + ')'));
+    console.log('');
+    if (r.hallazgos.length > 0) {
+        console.log(c.error('  SINCRONICOS -- cada uno es una interfaz que no puede envolver una base real:'));
+        const porArchivo = new Map();
+        for (const h of r.hallazgos) {
+            const lista = porArchivo.get(h.archivo) ?? [];
+            lista.push(h);
+            porArchivo.set(h.archivo, lista);
+        }
+        for (const [archivo, lista] of porArchivo) {
+            console.log('    ' + c.dim(archivo));
+            for (const h of lista) {
+                console.log('      ' + c.error('x') + ' linea ' + String(h.linea).padStart(4)
+                    + '  ' + h.metodo + '()' + c.dim('  [' + h.forma + ']'));
+            }
+        }
+        console.log('');
+    }
+    if (r.exentos.length > 0) {
+        console.log(c.warn('  Eximidos a mano (' + r.exentos.length + '):'));
+        for (const e of r.exentos) {
+            console.log('    ' + c.dim(e.archivo + ':' + e.linea) + '  ' + e.metodo + '()  -- ' + e.motivo);
+        }
+        console.log('');
+    }
+    if (r.ilegibles.length > 0) {
+        console.log(c.error('  NO SE PUDIERON ANALIZAR (' + r.ilegibles.length + '):'));
+        for (const f of r.ilegibles)
+            console.log('    ' + c.error('?') + ' ' + f);
+        console.log(c.dim('    Un archivo que no se puede afirmar NO cuenta como cero: el control falla.'));
+        console.log('');
+    }
+    if (aprueba(r)) {
+        console.log(c.success('  OK') + ' -- toda la interfaz de persistencia es asincronica.');
+        return;
+    }
+    console.log(c.error('  FALLA'));
+    console.log('');
+    console.log(c.dim('  Por que esto importa, y por que se arregla AHORA y no despues:'));
+    console.log(c.dim('    `await` sobre un valor que no es Promise no hace nada, asi que declarar'));
+    console.log(c.dim('    el store async hoy cuesta CERO -- incluso con el store en memoria. El'));
+    console.log(c.dim('    camino inverso es cada punto de llamada del sistema: en ADIP-Kikan'));
+    console.log(c.dim('    fueron 1.543, en nueve slices. Las dos opciones no son simetricas.'));
+}
+export function registerAuditPersistenceCommand(program) {
+    const audit = program.commands.find((cmd) => cmd.name() === 'audit')
+        ?? program.command('audit').description('Controles estaticos sobre un proyecto.');
+    audit
+        .command('persistence [path]')
+        .description('Exige que todo metodo de un store/repositorio este declarado async.')
+        .option('--json', 'emitir JSON en vez del reporte legible')
+        .action(async (where, opts) => {
+        const raiz = path.resolve(process.cwd(), where ?? '.');
+        const { fuentes, generados } = recolectarFuentes(raiz);
+        const r = analizar(fuentes);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({
+                root: raiz, files: fuentes.length, skipped_generated: generados,
+                ok: aprueba(r), ...r,
+            }, null, 2) + '\n');
+            if (!aprueba(r))
+                process.exitCode = 1;
+            return;
+        }
+        imprimir(raiz, r, fuentes.length, generados.length);
+        if (!aprueba(r))
+            process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=audit-persistence.js.map

package/dist/commands/audit-persistence.js.map

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

package/dist/docs/doctrine/persistence-interface.md

@@ -0,0 +1,113 @@
+# The persistence interface is async from line one
+
+A rule with no sizing round, no questions to the owner, and no exceptions
+worth arguing about. It is free to obey and it is the most expensive thing
+in this repo to disobey.
+
+## The rule
+
+**Every method of every store, repository or DAO is declared `async`, from
+the first commit, whatever is behind it.** In memory, on disk, over a
+network, a stub that returns `null` -- all of them.
+
+Mechanically enforced by `yf audit persistence`. New projects carry it in
+their own CI. The check fails on a synchronous method and it also fails on a
+file it cannot analyse: a store whose signature cannot be asserted is not a
+store that passed.
+
+## Why it needs no information to decide
+
+The two directions are not symmetric:
+
+| Direction | Cost |
+|---|---|
+| async interface, synchronous implementation behind it | **zero.** `await` on a non-Promise is a no-op |
+| synchronous interface, later made async | **every call site in the system** |
+
+An asymmetric decision is always taken on the recoverable side. There is no
+volumetry that makes the sync interface the better bet, because the sync
+interface's only advantage is that it is marginally shorter to type.
+
+So this rule does not wait for G9, does not wait for the owner to answer how
+many rows per year, and does not appear in the options catalogue. It is not a
+choice.
+
+## What it actually prevents: ADIP-Kikan
+
+Measured, 13-oct-2026. Kikan's first commit reads *"nucleo kawa/sazanami +
+persistencia MariaDB"*. The brain built the repository layer, built two
+implementations, and wired production to MariaDB with write-through and
+boot-time hydration. The data was durable and always had been.
+
+One decision was wrong, and it was a **signature**: the repository interface
+was synchronous. Everything else followed mechanically.
+
+1. A real SQL driver is asynchronous, and a synchronous interface cannot
+   wrap one.
+2. So the "MariaDB store" had to keep the working set in RAM to serve reads
+   synchronously. Its own header says so: *"lecturas sincronas, interfaz
+   IDENTICA a createMemoryStore -> no reescribe el motor"*.
+3. And because an in-memory working set needs no columns, the schema
+   degenerated into **one generic table of JSON rows** (`engine_rows`), with
+   the 57 normalised tables demoted to a derived read-model instead of being
+   the system of record.
+
+The bill: **1.543 call sites**, nine conversion slices, a static ratchet
+built to hold the line, and a reengineering plan of its own.
+
+## Why a brain walks into it
+
+Not from ignorance. Every step is locally correct:
+
+- When the engine is being written there is **no database yet**. The first
+  store you write so the engine is testable is the in-memory one, and its
+  natural signature is synchronous -- correct, at that moment.
+- The engine is written against that signature. Now every future store must
+  match it or the engine breaks.
+- When the real SQL store finally gets written, that signature is
+  load-bearing for hundreds of call sites. Making it async is a repo-wide
+  change no single turn can justify and nobody asked for. So the SQL store
+  contorts to fit the signature instead.
+
+Each step is reasonable. The aggregate is wrong. That is the failure mode of
+incremental construction without an invariant that is checked, and it is why
+this one is a mechanical gate and not a paragraph of advice.
+
+Note also what the model never wrote: it never wrote "in-memory
+persistence". It wrote "a repository with a synchronous interface", and that
+shape is everywhere in any training corpus -- every test double, every
+in-process repo, every small app without an ORM. The dangerous default is
+the *common* one, not an exotic one.
+
+## The decision that was never taken
+
+There was no turn whose subject was "choose the persistence architecture".
+It accumulated. `docs/doctrine/sizing.md` carries the same finding for
+volumetry; this file carries it for the interface, because the interface is
+the half that costs nothing to get right and everything to get wrong.
+
+## Exemptions
+
+A genuinely synchronous accessor that will never cross a process boundary
+can be marked in place:
+
+```js
+// persistence-async-ok: in-RAM index, never touches disk or network
+get(key) { return this.index.get(key); }
+```
+
+The checker **counts and reports** exemptions. An invisible exemption is a
+hole; a counted one is a decision someone can review. Blanket-disabling the
+check is not an exemption, it is the defect.
+
+## What this rule does NOT say
+
+- It does not say the store must be SQL. A memory store is fine for a
+  prototype; the sizing gate decides that. This rule is only about the
+  **signature**.
+- It does not require returning a real Promise. `async` on something that
+  already returns one changes nothing; the rule is "declared `async`"
+  because that is trivial to satisfy and trivial to verify, and a strict
+  simple rule beats a clever one that needs interpreting.
+- It does not apply to test doubles. A synchronous fake inside a battery is
+  legitimate; the checker skips `*.test.*` and `*.spec.*` for that reason.

package/dist/version.d.ts

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export declare const VERSION = "1.15.0";
+export declare const VERSION = "1.16.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export const VERSION = '1.15.0';
+export const VERSION = '1.16.0';
 //# sourceMappingURL=version.js.map

package/docs/doctrine/persistence-interface.md

@@ -0,0 +1,113 @@
+# The persistence interface is async from line one
+
+A rule with no sizing round, no questions to the owner, and no exceptions
+worth arguing about. It is free to obey and it is the most expensive thing
+in this repo to disobey.
+
+## The rule
+
+**Every method of every store, repository or DAO is declared `async`, from
+the first commit, whatever is behind it.** In memory, on disk, over a
+network, a stub that returns `null` -- all of them.
+
+Mechanically enforced by `yf audit persistence`. New projects carry it in
+their own CI. The check fails on a synchronous method and it also fails on a
+file it cannot analyse: a store whose signature cannot be asserted is not a
+store that passed.
+
+## Why it needs no information to decide
+
+The two directions are not symmetric:
+
+| Direction | Cost |
+|---|---|
+| async interface, synchronous implementation behind it | **zero.** `await` on a non-Promise is a no-op |
+| synchronous interface, later made async | **every call site in the system** |
+
+An asymmetric decision is always taken on the recoverable side. There is no
+volumetry that makes the sync interface the better bet, because the sync
+interface's only advantage is that it is marginally shorter to type.
+
+So this rule does not wait for G9, does not wait for the owner to answer how
+many rows per year, and does not appear in the options catalogue. It is not a
+choice.
+
+## What it actually prevents: ADIP-Kikan
+
+Measured, 13-oct-2026. Kikan's first commit reads *"nucleo kawa/sazanami +
+persistencia MariaDB"*. The brain built the repository layer, built two
+implementations, and wired production to MariaDB with write-through and
+boot-time hydration. The data was durable and always had been.
+
+One decision was wrong, and it was a **signature**: the repository interface
+was synchronous. Everything else followed mechanically.
+
+1. A real SQL driver is asynchronous, and a synchronous interface cannot
+   wrap one.
+2. So the "MariaDB store" had to keep the working set in RAM to serve reads
+   synchronously. Its own header says so: *"lecturas sincronas, interfaz
+   IDENTICA a createMemoryStore -> no reescribe el motor"*.
+3. And because an in-memory working set needs no columns, the schema
+   degenerated into **one generic table of JSON rows** (`engine_rows`), with
+   the 57 normalised tables demoted to a derived read-model instead of being
+   the system of record.
+
+The bill: **1.543 call sites**, nine conversion slices, a static ratchet
+built to hold the line, and a reengineering plan of its own.
+
+## Why a brain walks into it
+
+Not from ignorance. Every step is locally correct:
+
+- When the engine is being written there is **no database yet**. The first
+  store you write so the engine is testable is the in-memory one, and its
+  natural signature is synchronous -- correct, at that moment.
+- The engine is written against that signature. Now every future store must
+  match it or the engine breaks.
+- When the real SQL store finally gets written, that signature is
+  load-bearing for hundreds of call sites. Making it async is a repo-wide
+  change no single turn can justify and nobody asked for. So the SQL store
+  contorts to fit the signature instead.
+
+Each step is reasonable. The aggregate is wrong. That is the failure mode of
+incremental construction without an invariant that is checked, and it is why
+this one is a mechanical gate and not a paragraph of advice.
+
+Note also what the model never wrote: it never wrote "in-memory
+persistence". It wrote "a repository with a synchronous interface", and that
+shape is everywhere in any training corpus -- every test double, every
+in-process repo, every small app without an ORM. The dangerous default is
+the *common* one, not an exotic one.
+
+## The decision that was never taken
+
+There was no turn whose subject was "choose the persistence architecture".
+It accumulated. `docs/doctrine/sizing.md` carries the same finding for
+volumetry; this file carries it for the interface, because the interface is
+the half that costs nothing to get right and everything to get wrong.
+
+## Exemptions
+
+A genuinely synchronous accessor that will never cross a process boundary
+can be marked in place:
+
+```js
+// persistence-async-ok: in-RAM index, never touches disk or network
+get(key) { return this.index.get(key); }
+```
+
+The checker **counts and reports** exemptions. An invisible exemption is a
+hole; a counted one is a decision someone can review. Blanket-disabling the
+check is not an exemption, it is the defect.
+
+## What this rule does NOT say
+
+- It does not say the store must be SQL. A memory store is fine for a
+  prototype; the sizing gate decides that. This rule is only about the
+  **signature**.
+- It does not require returning a real Promise. `async` on something that
+  already returns one changes nothing; the rule is "declared `async`"
+  because that is trivial to satisfy and trivial to verify, and a strict
+  simple rule beats a clever one that needs interpreting.
+- It does not apply to test doubles. A synchronous fake inside a battery is
+  legitimate; the checker skips `*.test.*` and `*.spec.*` for that reason.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Yujin Forge -- voice-first NAC-3 React development framework. CLI + chat panel + spec ingest + 10-format document reader + voice loop.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pablo Kuschnirof <pablo@rpaforce.com>",

package/templates/nextjs-app/package.json

@@ -11,7 +11,8 @@
     "test:watch": "vitest",
     "test:e2e": "playwright test",
     "lint": "next lint",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && yf audit persistence",
+    "audit:persistence": "yf audit persistence",
     "yf": "yf"
   },
   "dependencies": {

package/templates/react-app/package.json

@@ -11,7 +11,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:e2e": "playwright test",
-    "lint": "tsc --noEmit",
+    "lint": "tsc --noEmit && yf audit persistence",
+    "audit:persistence": "yf audit persistence",
     "yf": "yf"
   },
   "dependencies": {