@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/pi-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"pi-manifest.js","sourceRoot":"","sources":["../../src/core/pi-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAS5C,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAE/E,SAAS,QAAQ,CAAC,KAAc,EAAoC;IACnE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAAA,CAC5E;AAED,MAAM,UAAU,cAAc,CAAC,eAAuB,EAAqB;IAC1E,IAAI,CAAC;QACJ,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,QAAQ,GAAe,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACnF,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;YAC3B,CAAC;QACF,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AAAA,CACD","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { stripBom } from \"../utils/text.ts\";\n\nexport interface PiManifest {\n\textensions?: string[];\n\tskills?: string[];\n\tprompts?: string[];\n\tthemes?: string[];\n}\n\nconst RESOURCE_FIELDS = [\"extensions\", \"skills\", \"prompts\", \"themes\"] as const;\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function readPiManifest(packageJsonPath: string): PiManifest | null {\n\ttry {\n\t\tconst pkg: unknown = JSON.parse(stripBom(readFileSync(packageJsonPath, \"utf-8\")));\n\t\tif (!isObject(pkg) || !isObject(pkg.pi)) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst manifest: PiManifest = {};\n\t\tfor (const field of RESOURCE_FIELDS) {\n\t\t\tconst entries = pkg.pi[field];\n\t\t\tif (Array.isArray(entries) && entries.every((entry) => typeof entry === \"string\")) {\n\t\t\t\tmanifest[field] = entries;\n\t\t\t}\n\t\t}\n\t\treturn manifest;\n\t} catch {\n\t\treturn null;\n\t}\n}\n"]}
+{"version":3,"file":"pi-manifest.js","sourceRoot":"","sources":["../../src/core/pi-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAS5C,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAE/E,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,eAAuB;IACrD,IAAI,CAAC;QACJ,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,QAAQ,GAAe,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACnF,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;YAC3B,CAAC;QACF,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/core/privacidad/categorias-especiales.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Detectar las CATEGORÍAS ESPECIALES del artículo 9 del RGPD (y las condenas
+ * del artículo 10) en un texto, sin repetir el texto en el hallazgo.
+ *
+ * POR QUÉ EXISTE, medido antes de escribir nada. El escáner de
+ * `memory-engine/security.ts` tiene cinco patrones de datos personales
+ * (correo, teléfono, DNI/NIE, IBAN, fecha de nacimiento) y CERO del artículo 9.
+ * Sobre un corpus de 24 cadenas que sí deberían saltar, en nivel `strict`
+ * fallaban 20. Entre las 20: «baja por depresión», «afiliado a CCOO»,
+ * «HIV positive», «huella dactilar registrada», «tiene antecedentes penales».
+ * Ninguna de ellas tiene hoy categoría en `SensitiveCategory`, así que
+ * `redactSensitive` las devuelve idénticas, sin un solo bloque: hoy una
+ * categoría especial se escribe EN CLARO en el libro de auditoría
+ * (`audit/libro.ts`), en la exportación y en el diario de edición.
+ *
+ * El coste no es simétrico con el de un correo. Tratar datos de salud,
+ * afiliación sindical, origen étnico, religión, opinión política, vida sexual,
+ * biometría o genética está PROHIBIDO salvo excepción tasada (art. 9.1 y 9.2),
+ * y las condenas penales sólo pueden tratarse bajo control de la autoridad
+ * (art. 10). Filtrar uno de estos no es un incidente de privacidad: es un
+ * tratamiento ilícito.
+ *
+ * LAS DOS MITADES. Un detector de vocabulario ingenuo es peor que ninguno.
+ * «diagnóstico» sale de cualquier compilador, «union» de cualquier SQL,
+ * «race» de cualquier `race condition`, y un identificador interno de ocho
+ * cifras no es un DNI. Un detector que grita sobre todo se desactiva en una
+ * semana y entonces no protege de nada. Por eso aquí hay dos mecanismos, y
+ * los dos se miden contra el corpus benigno:
+ *
+ *   1. Los IDENTIFICADORES se VALIDAN, no se reconocen por su forma. DNI y NIE
+ *      por la letra de control (módulo 23 sobre TRWAGMYFPDXBNJZSQVHLCKE), IBAN
+ *      y número de la Seguridad Social por módulo 97. Esto no es sólo rigor:
+ *      es lo que hace desaparecer el único falso positivo medido del escáner
+ *      actual —el UUID `550e8400-e29b-41d4-a716-446655440000`, cuyo fragmento
+ *      `446655440000` tiene forma de NSS pero da 56 donde debería dar 00—.
+ *
+ *   2. El VOCABULARIO ambiguo exige CO-OCURRENCIA con un marcador de persona.
+ *      «diagnóstico» solo no dispara; «su diagnóstico» sí. Ver `VENTANA`.
+ *
+ * LA VENTANA es de 60 caracteres entre los bordes más cercanos del término y
+ * del marcador. Una oración simple en español ronda las 10-12 palabras, unos
+ * 60-70 caracteres; dentro de eso el marcador y el término suelen compartir
+ * sujeto. Más allá ya son dos frases distintas y la co-ocurrencia deja de
+ * significar nada: el marcador habla de una persona y el término, de otra cosa.
+ * Medido sobre el corpus: con 60 caracteres las 12 cadenas benignas salen
+ * limpias y las 19 sensibles por vocabulario salen todas.
+ *
+ * QUÉ NO HACE, y conviene que conste:
+ *
+ *   · No entiende negación ni hipótesis. «no está de baja por depresión» y
+ *     «si estuviera de baja por depresión» disparan igual. Es deliberado: en
+ *     un detector de fugas el falso negativo se paga más caro que el falso
+ *     positivo POR CADA CASO, y la negación en texto libre no se resuelve con
+ *     una lista de palabras.
+ *   · No cubre `fingerprint` ni `huella digital` como biometría, porque en
+ *     este repositorio son la huella de un certificado o de un fichero. Sí
+ *     cubre «huella dactilar», que no tiene lectura técnica.
+ *   · La matrícula española no tiene dígito de control: es la única forma sin
+ *     validar de las cinco. Se compensa exigiendo el alfabeto real de las
+ *     placas (consonantes, sin vocales ni Ñ ni Q), que descarta casi cualquier
+ *     token accidental de cuatro cifras y tres letras.
+ *   · No sustituye a `classifySensitive`: es complementario. Aquí no hay
+ *     correos, ni teléfonos, ni tarjetas.
+ */
+/** Las diez categorías que este módulo sabe nombrar. */
+export type CategoriaEspecial = "salud" | "sindical" | "origen-etnico" | "religion" | "opinion-politica" | "vida-sexual" | "biometrico" | "genetico" | "condenas" | "identificador-nacional";
+export interface HallazgoEspecial {
+    categoria: CategoriaEspecial;
+    /**
+     * El artículo del RGPD que hace especial al dato. Es lo que el DPO necesita
+     * en su informe: el 9 exige una de las excepciones del 9.2, el 10 exige
+     * control de la autoridad pública.
+     *
+     * `identificador-nacional` se marca como "9" porque la API sólo admite dos
+     * valores, pero su base real es el art. 87 (número de identificación
+     * nacional, condiciones específicas de cada Estado miembro). Quien redacte
+     * el informe debe leerlo así.
+     */
+    articulo: "9" | "10";
+    /** Posición inicial en el texto, para poder redactar sólo ese trozo. */
+    desde: number;
+    /** Posición final (exclusiva). */
+    hasta: number;
+    /**
+     * La FORMA que lo disparó. NUNCA el texto detectado: un informe de fuga que
+     * cita la fuga es otra fuga, y estos hallazgos van a un libro de auditoría
+     * que se exporta.
+     */
+    porque: string;
+}
+/**
+ * El tercer estado: «no he podido mirar».
+ *
+ * Una lista vacía significa «he mirado el texto entero y no hay nada». Si el
+ * módulo no puede analizar, devolver `[]` convertiría un fallo en un permiso:
+ * quien llama guardaría la nota creyendo que está limpia. Por eso se LANZA.
+ *
+ * Se lanza en dos casos, y sólo en dos:
+ *   · `no-es-cadena`: llega algo que no es `string` (un `null` de una API, un
+ *     objeto que alguien esperaba serializado).
+ *   · `demasiado-largo`: por encima de `LIMITE_CARACTERES`. El barrido es
+ *     lineal por patrón, pero son ~80 patrones y la búsqueda de marcadores es
+ *     cuadrática en el número de coincidencias; con un volcado de megabytes el
+ *     detector deja de responder y quien llama se queda colgado sin saber por
+ *     qué. Falla rápido y explícito.
+ */
+export declare class TextoNoAnalizable extends Error {
+    readonly motivo: "no-es-cadena" | "demasiado-largo";
+    constructor(motivo: "no-es-cadena" | "demasiado-largo", detalle: string);
+}
+/** 200.000 caracteres ≈ 200 KB. Una nota de memoria razonable no llega a 10 KB. */
+export declare const LIMITE_CARACTERES = 200000;
+/** Caracteres de distancia máxima entre el término y su marcador de persona. */
+export declare const VENTANA = 60;
+/**
+ * Devuelve el texto en minúsculas, sin acentos y con TODO espacio en blanco
+ * convertido en un espacio simple, con la MISMA longitud.
+ *
+ * Lo del salto de línea no es cosmético y se midió: con el salto intacto,
+ * «perfil\ngenético» y «trade\nunion» salían LIMPIOS —los patrones de varias
+ * palabras llevan un espacio literal— y un dato de categoría especial partido
+ * por un ajuste de línea es exactamente lo que produce cualquier editor, todo
+ * correo citado y todo comentario de código. Se arregla aquí, en el plegado,
+ * y no patrón a patrón: son ~30 patrones de varias palabras y arreglar sólo
+ * los que uno recuerda deja el resto igual de ciegos.
+ */
+export declare function plegar(texto: string): string;
+/**
+ * Letra de control del DNI: módulo 23 sobre la tabla oficial.
+ *
+ * Acepta los puntos de millar («12.345.678»), que es como se imprime en la
+ * tarjeta y como lo teclea la mitad de la gente.
+ */
+export declare function dniValido(numero: string, letra: string): boolean;
+/** NIE: la inicial X/Y/Z vale 0/1/2 y luego es el mismo módulo 23. */
+export declare function nieValido(inicial: string, numero: string, letra: string): boolean;
+/** IBAN: mover los cuatro primeros al final, letra → número, y módulo 97 = 1. */
+export declare function ibanValido(iban: string): boolean;
+/**
+ * Número de la Seguridad Social: provincia (2) + número (8) + control (2),
+ * donde el control es el módulo 97 de los diez primeros dígitos.
+ *
+ * La excepción documentada: cuando el número de afiliación es menor que
+ * 10.000.000 —es decir, empieza por cero— el código de provincia se coloca
+ * DETRÁS. Se prueban las dos lecturas y basta con que una cuadre; probar sólo
+ * la principal perdería a todos los afiliados antiguos.
+ */
+export declare function nssValido(provincia: string, numero: string, control: string): boolean;
+/**
+ * Busca categorías especiales del art. 9 y condenas del art. 10.
+ *
+ * TRES ESTADOS, no dos:
+ *   · lista con hallazgos → hay datos de categoría especial;
+ *   · lista vacía → he mirado el texto entero y no hay;
+ *   · `TextoNoAnalizable` → no he podido mirar. Nunca se confunde con la vacía.
+ *
+ * Ningún campo del hallazgo lleva el texto detectado; sólo su posición y la
+ * forma que lo disparó.
+ */
+export declare function categoriasEspeciales(texto: string): HallazgoEspecial[];
+/**
+ * Devuelve el texto con los tramos hallados —y SÓLO ésos— sustituidos por
+ * bloques.
+ *
+ * Es lo que le falta hoy a `redactSensitive`: medido,
+ * `redactSensitive("baja por depresión, afiliado a CCOO, HIV positive",
+ * "strict")` devuelve la cadena idéntica, y esa función alimenta el libro de
+ * auditoría y el diario de edición.
+ *
+ * DOS DECISIONES, las dos deliberadas:
+ *
+ *   · El bloque tiene la MISMA longitud que el tramo. Un texto tapado que
+ *     encoge delata dónde estaba el dato al comparar con el original, y además
+ *     rompe cualquier índice que alguien haya guardado sobre el texto.
+ *   · No se escribe la categoría en el hueco. Poner «[salud]» taparía el dato y
+ *     publicaría el diagnóstico: que hay información de salud sobre esta
+ *     persona ya es, por sí solo, una categoría especial. La categoría va en el
+ *     hallazgo, que es para el DPO; el texto tapado es para todos los demás.
+ *
+ * Un texto sin hallazgos sale idéntico byte a byte —se devuelve el mismo
+ * objeto—, y `TextoNoAnalizable` sube igual que en `categoriasEspeciales`:
+ * devolver aquí el texto sin tocar sería devolver el original en claro
+ * creyendo haberlo tapado.
+ */
+export declare function taparCategoriasEspeciales(texto: string): string;
+//# sourceMappingURL=categorias-especiales.d.ts.map

package/dist/core/privacidad/categorias-especiales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorias-especiales.d.ts","sourceRoot":"","sources":["../../../src/core/privacidad/categorias-especiales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAC1B,OAAO,GACP,UAAU,GACV,eAAe,GACf,UAAU,GACV,kBAAkB,GAClB,aAAa,GACb,YAAY,GACZ,UAAU,GACV,UAAU,GACV,wBAAwB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B;;;;;;;;;OASG;IACH,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC;gBACxC,MAAM,EAAE,cAAc,GAAG,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAKvE;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,SAAU,CAAC;AAEzC,gFAAgF;AAChF,eAAO,MAAM,OAAO,KAAK,CAAC;AA2D1B;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB5C;AAQD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAIjF;AASD,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAShD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKrF;AA0bD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAuFtE;AAKD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB/D"}