@ingcrea/aumic-puf 3.2.0 → 3.3.0

package/MANIFEST.es.md

@@ -1,172 +1,106 @@
-# 📜 MANIFIESTO ARQUITECTÓNICO: ESTÁNDAR AUM-IC 7
+# 📜 MANIFIESTO ARQUITECTÓNICO: ESTÁNDAR AUM-IC 7 (EDICIÓN 2026)
 
-> 🌍 **Navegación:** 🇲🇽 [Leer en Español](./MANIFEST.es.md) | 🇺🇸 [Read in English](./MANIFEST.md) | 📖 [README (ES)](./README.es.md)
+<p align="center">
+  <img src="https://img.shields.io/badge/version-7.0.0-crimson?style=flat-square" alt="Versión 7.0.0">
+  <img src="https://img.shields.io/badge/naturaleza-Estandar%20de%20Ingenieria%20Pura-38bdf8?style=flat-square" alt="Naturaleza">
+  <img src="https://img.shields.io/badge/suite-PUF--25%20Aseguramiento-gold?style=flat-square" alt="PUF-25">
+</p>
 
-Este documento rige el **Paradigma de Universos Multidimensionales de Ingeniería Creativa (Estándar AUM-IC 7)**. No es solo una guía de carpetas; es una estructura física, matemática y de ingeniería de software diseñada para cumplir de manera nativa con las normativas internacionales de calidad **ISO/IEC 25010** e **ISO 27001**.
-
----
+> 🌐 **Navegación:** 🇲🇽 [Leer en Español](./MANIFEST.es.md) | 🇺🇸 [Read in English](./MANIFEST.md) | 📖 [README (ES)](./README.es.md) | 📖 [README (EN)](./README.md) | 🌌 [Estándar AUM-IC 7](https://github.com/ingcrea/aum-ic)
 
+Este documento rige el **Paradigma de Universos Multidimensionales de Ingeniería Creativa (Estándar AUM-IC 7)** y su correspondencia operativa con la matriz de 25 compuertas del **Protocolo Universal contra Fallos (PUF-25)**.
 
-> 🏆 **LA VISIÓN AUM-IC:** Todo proyecto creado desde su inicio o migrado íntegramente al Paradigma AUM-IC es un proyecto que aspira al cumplimiento nativo de los más altos estándares globales. Al adoptar esta arquitectura, el sistema hereda las aristas de calidad de software (**ISO/IEC 25010**), blinda su infraestructura bajo máxima seguridad y privacidad corporativa (**ISO 27001, ISO 27701, SOC 2**), garantiza su testabilidad (**ISO 29119**) y asegura la inclusión y posicionamiento absoluto mediante un código semánticamente perfecto (**ISO 40500 / WCAG / SEO**).
+No es una convención arbitraria de directorios ni una sugerencia cosmética: es un marco riguroso de arquitectura, física fractal e ingeniería de software concebido para satisfacer de forma nativa los estándares internacionales de calidad de producto (**ISO/IEC 25010**), seguridad de la información (**ISO 27001**), testabilidad (**ISO 29119**) y accesibilidad web (**ISO 40500 / WCAG 2.2**).
 
+---
 
-## 🌌 El Porqué Fundamental: Entropía vs. Perfección Matemática
+## 🌌 El Porqué Fundamental: Entropía vs. Precisión Matemática
 
-**La programación creada por humanos es entropía pura.** Es energía caótica que se dispersa: código espagueti, dependencias circulares, sistemas que se degradan con el tiempo y lógicas que colapsan. 
+**El desarrollo de software sin rigor es entropía descontrolada.** Es dispersión caótica: dependencias circulares, parches superficiales, acoplamiento destructivo, pérdidas de memoria y sistemas que colapsan ante condiciones imprevistas de concurrencia.
 
-El Universo real, aunque a simple vista parece caótico, es **brutal y matemáticamente preciso**. Desde la física cuántica hasta la mecánica celeste, todo obedece a un diseño quirúrgico impecable. 
+El universo físico, aunque parezca caótico, opera bajo un equilibrio matemático implacable. Desde las interacciones cuánticas elementales hasta la mecánica de cuerpos celestes masivos, nada queda al azar.
 
-**El Paradigma AUM-IC nace para llevar la programación a esta perfección matemática universal.** Somete el caos del código a las leyes de la física cósmica. Es un modelo mental absoluto, **100% agnóstico al lenguaje** (TypeScript, Python, Rust, Go, C#), que divide el desarrollo en Materia Observable, Fuerzas Invisibles y Leyes del Tiempo.
+**El Paradigma AUM-IC somete el código a estas mismas leyes universales.** Es un modelo mental absoluto, **100% agnóstico al lenguaje** (Rust, TypeScript, Python, Astro, PHP, Java, C#, Swift, Shell), que divide el desarrollo en **Materia Observable** (estructura fractal del código), **Fuerzas Invisibles** (flujo de datos y resiliencia SRE) y **Leyes de Correspondencia** (escalabilidad por masa crítica).
 
 ---
 
 ## PARTE I: LA MATERIA OBSERVABLE (Estructura Fractal)
 
-El Principio Hermético dicta: *"Como es arriba, es abajo"*. El ensamblaje de componentes sigue un ordenamiento jerárquico estricto. **Esta regla aplica simétricamente para la Interfaz (UI), las APIs (Controladores) y las Bases de Datos (Modelos).**
-
-Para detener la entropía, los directorios utilizan obligatoriamente prefijos numéricos:
+El Principio de Correspondencia establece: *"Como es arriba, es abajo"*. Los componentes del software se organizan en simetría fractal estricta tanto en Frontend (interfaces de usuario), como en Backend (controladores y microservicios) y Persistencia (modelos de datos):
 
-### ⚛️ Nivel 1: Átomos (`1-atoms/`)
-* **Concepto:** La unidad base indivisible (Botones en UI / Helpers y Utils puros en Backend).
-* **Regla:** 100% ignorantes. No importan otros archivos, no hacen peticiones, no tienen estado.
+```text
+src/
+├── 1-atoms/       # Elementos puros e indivisibles (Botones, inputs, helpers matemáticos puros)
+├── 2-molecules/   # Agrupaciones simples (Campos de formulario con label/error, middlewares)
+├── 3-cells/       # Contenedores funcionales (Tarjetas de producto, entidades ORM, servicios unitarios)
+├── 4-organisms/   # Módulos autónomos de negocio (Formulario de checkout, casos de uso, orquestadores)
+├── 5-planets/     # Vistas completas o controladores API (Páginas de dashboard, endpoints REST/gRPC)
+└── 6-layouts/     # Malla espacial y contenedores maestros (Plantillas estructurales, server app modules)
+```
 
-### 🧬 Nivel 2: Moléculas (`2-molecules/`)
-* **Concepto:** La unión de dos o más átomos (Campos de formulario en UI / Middlewares y Validadores en Backend).
-* **Regla:** Tienen propósito específico pero carecen de lógica de negocio profunda.
+* **Regla de Gravedad Cero:** Los átomos (`1-atoms/`) no pueden depender de capas superiores ni importar estado mutable o conexiones a base de datos. La densidad y gravedad se reservan para los organismos y planetas.
 
-### 🦠 Nivel 3: Células (`3-cells/`)
-* **Concepto:** Contenedores funcionales interactivos (Formularios completos en UI / Entidades ORM o Servicios unitarios en Backend).
-* **Regla:** Manejan eventos de usuario pero delegan el procesamiento masivo a capas superiores.
+---
 
-### 🦎 Nivel 4: Organismos (`4-organisms/`)
-* **Concepto:** Bloques complejos y autónomos (Secciones dinámicas en UI / Casos de Uso y Orquestadores en Backend).
-* **Regla:** Agrupan células. Pueden ser inyectados en diferentes planetas y funcionar de manera independiente.
+## PARTE II: LAS 7 FUERZAS CÓSMICAS (Núcleo SRE y Seguridad)
 
-### 🌍 Nivel 5: Planetas (`5-planets/`)
-* **Concepto:** Macro-secciones semánticas (Headers/Footers en UI / Endpoints y Controladores API en Backend).
-* **Regla:** Son el "hogar" de los organismos. Estructuran y enrutan la información.
+Todo sistema en producción debe operar bajo 7 leyes dinámicas que rigen el flujo de datos:
 
-### 🌌 Nivel 6: Sistemas Solares y Galaxias (`6-layouts/`)
-* **Concepto:** El esqueleto gravitacional maestro (Plantillas maestras en UI / Configuración de Servidores y App Modules en Backend).
-* **Regla:** Manejan los metadatos y abren el "espacio" para que los planetas existan.
+1. **Materia Oscura (Estado Global):** La gravedad invisible. La información global de la aplicación (Zustand, Redux, Daemons de memoria) unifica a los organismos sin acoplarlos de forma directa (*Prop Drilling* prohibido).
+2. **Horizonte de Eventos (Seguridad Perimetral):** Frontera impenetrable. Aplica Content Security Policy (CSP), Rate Limiting estricto, challenge anti-bots y validación criptográfica de firmas JWT. Todo payload sin firma válida es repelido en el middleware.
+3. **Campo Magnético (ORM y Sanitización):** Protege el núcleo del sistema contra radiación cósmica (inyecciones SQL y ataques XSS). Queda prohibido el SQL en texto plano sin parametrizar. La materia no se destruye arbitrariamente: se exige el **Borrado Lógico (Soft Deletes)** y el control estricto de esquemas mediante migraciones declarativas.
+4. **El Colisionador de Hadrones (Ciclo Cerrado de Calidad PUF-25):** El caos no entra a producción. Antes de un release, el código debe superar la matriz de 25 compuertas de aseguramiento (**G0 a G24**), auditando desde la codificación de bytes hasta contratos de API, pruebas de mutación (G23) y resiliencia ante caos (G24).
+5. **Agujeros de Gusano (Caché y Arquitectura Offline-First):** Supera la latencia de la red. Despliega bases de datos locales incrustadas (SQLite, Realm) en clientes Desktop/Mobile o clústeres Redis en la nube, garantizando que el sistema opere y facture aun en condiciones de desconexión.
+6. **La Malla Cósmica (Resiliencia Distribuida):** Implementación obligatoria de **Circuit Breakers (G24)** para aislar servicios externos caídos y bucles exponenciales de reconexión (**Exponential Backoff**) para revivir enlaces a bases de datos de forma autónoma.
+7. **Radiación Cósmica de Fondo (Observabilidad Forense y RUM):** Toda interacción deja una huella digital determinista. Telemetría de usuario real (RUM), captura de excepciones de runtime globales, monitoreo de 404s y despacho inmediato de alertas al centro de comando.
 
 ---
 
-## PARTE II: LAS FUERZAS INVISIBLES Y LA CINEMÁTICA (Datos y Flujos)
-
-Un universo estático está muerto. Estas leyes dictan cómo interactúa la materia.
+## PARTE III: LEY DE CORRESPONDENCIA (Escalabilidad por Masa Crítica)
 
-### 🌑 1. Materia Oscura (Manejo del Estado Global)
-* **El Concepto:** Son los datos globales de la aplicación en memoria (Redux, Zustand, Daemons).
-* **Uso Práctico:** En lugar de pasar un dato bajando por 10 archivos distintos (*Prop Drilling*), guardas ese dato en la "Materia Oscura". Cualquier archivo lo absorbe directamente. Es la **Fuente Única de Verdad**.
-* **Estándar ISO:** Mantenibilidad y Modularidad.
+Un asteroide obedece las mismas leyes fundamentales que una galaxia; sin embargo, las fuerzas activas se encienden en proporción a su **Masa Crítica**:
 
-### 🧲 2. Gravedad Cero (Acoplamiento)
-* **El Concepto:** Nivel de Acoplamiento (Dependency Injection).
-* **Uso Práctico:** Un Átomo debe tener "Gravedad Cero". No puede importar conexiones a Base de Datos. La gravedad pesada (lógica compleja) se reserva solo para los Organismos y Planetas.
-* **Estándar ISO:** Reusabilidad y Portabilidad (Principios SOLID).
-
-### ⚡ 3. Velocidad de la Luz y Agujeros de Gusano (Latencia y Caché)
-* **El Concepto:** Peticiones de red, tiempos de espera y memoria a corto plazo.
-* **Uso Práctico:** Superamos el límite de la velocidad de la luz mediante **UI Optimista** (mostrar resultados al instante mientras el dato viaja). Además, utilizamos **Agujeros de Gusano (Redis, Caché de Navegador, CDNs)** para doblar el espacio-tiempo, entregando información frecuente instantáneamente desde la memoria sin tener que hacer el viaje completo hasta la Base de Datos.
-* **Estándar ISO:** Eficiencia de Rendimiento y Escalabilidad.
+### 🪨 Nivel 1: El Asteroide (Sistemas de Propósito Único)
+* **Ejemplos:** Landing pages, herramientas CLI, scripts de procesamiento, utilidades de una sola pantalla.
+* **Materia Oscura (Estado Global):** **APAGADA.** No requiere almacenes pesados; el estado reside localmente.
+* **Campo Magnético Perimetral:** **MÁXIMO.** Todo input exterior es letal. En web se aplican filtros contra tráfico malicioso; en mobile/desktop se aplican validadores tipados estrictos (Zod, TypeBox, serde).
+* **La Biósfera (Accesibilidad y SEO):** **MÁXIMA.** Marcado semántico riguroso y consumo nativo de APIs de accesibilidad del sistema operativo.
 
-### 🕸️ 4. La Malla Cósmica (Microservicios e Interoperabilidad)
-* **El Concepto:** Distintas aplicaciones o módulos se comunican a través de "hilos" de energía (APIs, Webhooks, gRPC).
-* **Uso Práctico:** Dos galaxias distintas no comparten bases de datos. Si una galaxia explota, el resto sobrevive ignorando ese hilo cortado (Circuit Breaker).
-* **Estándar ISO:** Tolerancia a Fallos e Interoperabilidad.
+### 🌍 Nivel 2: El Planeta (Sistemas Transaccionales)
+* **Ejemplos:** Plataformas de comercio electrónico, puntos de venta (POS), aplicaciones móviles transaccionales.
+* **Agujeros de Gusano (Offline-First):** **ENCENDIDO.** Bases de datos SQLite locales mantienen la operatividad continua si la conexión a internet colapsa.
+* **Firmas Espectrales (Seguridad de Sesión):** **ENCENDIDO.** Almacenamiento seguro en Credential Manager de Windows, Keychain de macOS o cookies HttpOnly con banderas `Secure` y `SameSite`. Prohibido el almacenamiento en texto plano.
 
-### ☄️ 5. Órbitas Cerradas (Ciclo de Vida)
-* **El Concepto:** Los Listeners, WebSockets y procesos en segundo plano.
-* **Uso Práctico:** Todo proceso cíclico debe ser destruido explícitamente al dejar de usarse (Limpieza / Unmount). Una órbita abierta es un planeta rebelde que consume RAM hasta destruir el dispositivo (Memory Leak).
-* **Estándar ISO:** Utilización Eficiente de Recursos.
+### 🌌 Nivel 3: La Galaxia (Ecosistemas Masivos y Distribuidos)
+* **Ejemplos:** Sistemas ERP en la nube, plataformas Fintech / Core Bancario, suites industriales de escritorio.
+* **La Malla Cósmica (IPC y Microservicios):** **MÁXIMA POTENCIA.** Comunicación asíncrona tipada y desacoplamiento de subprocesos. Si un microservicio o worker falla, el resto de la galaxia permanece intacto.
+* **Telemetría y Observabilidad:** **MÁXIMA POTENCIA.** Auditoría continua de logs, monitoreo de tiempos de respuesta, trazas distribuidas y mitigación proactiva de incidentes.
 
 ---
 
-## PARTE III: LEYES DEL TIEMPO Y EL MULTIVERSO (Control de Versiones)
+## MATRIZ DE CORRESPONDENCIA: AUM-IC 7 vs. PUF-25
 
-### ⏱️ El Multiverso y las Líneas Temporales (Git)
-* **El Concepto:** El control de versiones no es una herramienta, es la manipulación del espaciotiempo.
-* **Uso Práctico:** Un `commit` congela el universo en el tiempo. Un `branch` crea un Universo Paralelo para experimentar. Jamás se altera el Universo Real (`main`) sin que el Paralelo sea matemáticamente perfecto. Si algo falla, se colapsa la línea temporal (`git revert`).
+| Fuerza Cósmica AUM-IC | Compuertas PUF-25 que la Certifican | Objetivo Operativo |
+| :--- | :--- | :--- |
+| **Higiene Fundamental** | **`G0`**, **`G8`**, **`G22`** | Codificación UTF-8 pura, saltos LF, erradicación de mojibake y balanceo universal de delimitadores. |
+| **Colisionador de Hadrones** | **`G2`**, **`G3`**, **`G5`**, **`G6`**, **`G23`** | Ciclo rojo/verde de tests, snapshots SHA-256 de reversión, rigor estático y resistencia a mutaciones lógicas. |
+| **Campo Magnético** | **`G4`**, **`G19`**, **`G21`** | Refactor limpio, cero inyecciones SQL, erradicación de secretos y compliance estricto WordPress/WooCommerce. |
+| **Horizonte de Eventos** | **`G9`**, **`G17`**, **`G20`** | Permisos POSIX restrictivos, consistencia de licencias y aislamiento de entornos (cero localhost en producción). |
+| **Gravedad Cero y Estructura** | **`G1`**, **`G11`**, **`G18`** | Desacoplamiento de hilos UI, cero robo de foco (`CREATE_NO_WINDOW`) y coexistencia limpia de motores CSS. |
+| **Malla Cósmica y Resiliencia** | **`G12`**, **`G13`**, **`G14`**, **`G24`** | Cero enlaces 404, erradicación de botones zombies, contratos API y tolerancia a caos de red (Circuit Breakers). |
+| **Radiación de Fondo** | **`G7`**, **`G10`**, **`G15`**, **`G16`** | Registro ADR en `BITACORA.md`, purga de cachés corruptas, pruebas E2E y Core Web Vitals. |
 
 ---
 
-## PARTE IV: CERTIFICACIÓN Y SUPERVIVENCIA (Estándares ISO y Cumplimiento)
-
-Para que un proyecto sea considerado formalmente AUM-IC, debe cumplir con los 4 pilares de supervivencia cósmica. Estos garantizan que la plataforma cumpla de forma automatizada y nativa con los estándares más estrictos del mundo corporativo (**ISO 25010, ISO 27001, ISO 27701, ISO 40500, ISO 29119 y SOC 2**).
-
-### 🛡️ 1. Horizonte de Sucesos, Firmas Espectrales y Campos Magnéticos (Seguridad Total)
-* **Las Normas:** ISO/IEC 27001 (Seguridad) e ISO/IEC 27701 (Privacidad de la Información).
-* **El Horizonte y La Singularidad:** Las contraseñas y secretos viven en el Backend (Horizonte). La "Privacy by Design" comprime y cifra identidades para que nadie pueda ver datos en claro (Singularidad).
-* **Firmas Espectrales (Auth y JWT):** Cada petición debe portar una "Firma Espectral" validada criptográficamente (JWT, Sesiones con Cookies `HttpOnly`). Si un viajero presenta una firma alterada, el Middleware rechaza la conexión instantáneamente.
-* **Campos Magnéticos (ORMs y Sanitización):** Así como el campo magnético de la Tierra desvía la radiación solar mortal, el uso estricto de **ORMs (Object-Relational Mapping)** y validadores (ej. Zod) actúa como un escudo magnético. Atrapa, filtra y desvía caracteres maliciosos e Inyecciones SQL o XSS antes de que toquen el núcleo de la base de datos. Está estrictamente prohibido apagar el campo magnético ejecutando "Raw SQL" con inputs de usuario.
-
-### 💥 2. El Colisionador de Hadrones (Testing y Calidad)
-* **La Norma:** ISO/IEC/IEEE 29119 (Pruebas de Software).
-* **Uso Práctico:** Todo Átomo y Organismo debe sobrevivir a colisiones a alta velocidad en ambientes controlados (Unit Testing, E2E, TDD). Si el código se rompe bajo estrés simulado en el pipeline automatizado (CI/CD), el Universo rechaza el despliegue. El caos no entra a Producción.
-
-### 📡 3. Radiación de Fondo Cósmica (Observabilidad y Auditoría)
-* **La Norma:** SOC 2 Tipo II (Integridad de Procesamiento y Disponibilidad).
-* **Uso Práctico:** El Big Bang dejó un rastro que nos cuenta la historia del universo. Del mismo modo, todo error, acción del usuario o caída del servidor deja un **Rastro Radiactivo inmutable** (Telemetría, Sentry, Datadog, Audit Logs). Es imposible silenciar fallos; todo debe ser rastreable forensemente. Esto incluye la observabilidad del cliente (**RUM - Real User Monitoring**), capturando globalmente excepciones del navegador, recursos rotos (404) y *Dead Clicks* (botones inactivos) enviando el rastro instantáneamente al centro de mando.
-
-### 🌍 4. La Biósfera y el Espectro Invisible (Accesibilidad y SEO)
-* **La Norma:** ISO/IEC 40500 (Pautas de Accesibilidad WCAG) y Directrices de Motores de Búsqueda (SEO).
-* **Uso Práctico:** La **Biósfera** exige que el ecosistema visual soporte toda forma de vida humana (validación matemática de contraste de colores, navegación por teclado). Sin embargo, el **Espectro Invisible** (Infrarrojo/Ultravioleta) es como las máquinas ven tu aplicación. Motores de búsqueda (Googlebots) y Tecnologías de Asistencia (Screen Readers) consumen tu código a través de etiquetas Semánticas, *ARIA-labels* y metadatos. Si tu planeta no emite en el espectro invisible, no existe en la web.
-
-## PARTE V: EL MOTOR DE EJECUCIÓN (Protocolo de Creación y Telemetría)
-
-Para garantizar que el universo no colapse al expandirse (desarrollo de nuevas *features*) o mutar (refactorización), todo arquitecto AUM-IC debe regirse por el siguiente flujo de operaciones inquebrantable.
+## GLOSARIO TÁCTICO: EL PORQUÉ DE LAS REGLAS
 
-### Fase 1: El Protocolo de Mutación Segura
-1. **Identificar Comportamientos:** Mapear la gravedad (dependencias) y las órbitas (ciclo de vida) del componente antes de alterar su código.
-2. **Línea Base en el Colisionador:** Escribir los tests automatizados y comprobar que pasan en verde con el código *actual*. Esta es la red de seguridad matemática.
-3. **Refactorización AUM-IC:** Aplicar la simetría fractal (mover de 1-atoms a 6-layouts, aplicar gravedad cero, aislar lógicas).
-4. **Punto de Control Temporal (Checkpoint):** Congelar la línea de tiempo en el Multiverso (Commit en Git). Si la entropía ataca, se colapsa la línea temporal sin daños.
-5. **Fichas de Anatomía:** Comentar el código (JSDoc invisible en producción) explicando el *porqué* atómico para futuras inteligencias artificiales o humanos.
-
-### Fase 2: Observabilidad y Respuesta Inmediata (Telemetría de Supernova)
-6. **Caja Negra de Logs Atómicos:** Se debe programar un sistema interno de trazabilidad. Toda interacción crítica, desde un fallo silencioso en un Átomo hasta un *Fatal Error* en una Galaxia, genera un Log estructurado. Se establecen *breakpoints* y *checkpoints* internos en la ejecución para permitir análisis forense forense y gestión de fallos.
-7. **Alarma de Supernova (Intercepción y Alerta en Tiempo Real):** El sistema de logs no es pasivo; es proactivo. Al interceptar un fallo (Warn, Error, Fatal), el paradigma exige emitir un pulso a la Velocidad de la Luz al Centro de Mando de Desarrollo. A través de NTFY, Webhooks (Discord/Telegram), SMS o bots de WhatsApp, el equipo de ingeniería es notificado en el milisegundo exacto del fallo, garantizando soporte técnico preventivo antes de que el usuario final lo reporte.
-
-
-
-## PARTE VI: LA LEY DE CORRESPONDENCIA (Escalabilidad y Plataformas Agnósticas)
-
-El argumento de *"Este paradigma es demasiada sobreingeniería"* nace de la incomprensión de las leyes del universo. **Como es arriba, es abajo.** El estándar AUM-IC 7 obedece a la **Ley de Correspondencia del Kybalión**: un asteroide obedece la misma física que una galaxia, y una App Móvil obedece la misma arquitectura que un ERP de escritorio o una web en la nube. Las fuerzas solo se encienden en proporción a su Masa Crítica.
-
-Para mantener la velocidad de desarrollo sin sacrificar las certificaciones ISO, el arquitecto debe clasificar su proyecto:
-
-### 🪨 Nivel 1: El Asteroide (Sistemas de Propósito Único)
-* **Ejemplos:** Landing Pages, Scripts CLI, Apps Móviles unidireccionales (Calculadora, Lector QR), Utilidades Desktop pequeñas.
-* **Materia Observable:** Solo carpetas `1-atoms` a `4-organisms`.
-* **Materia Oscura (Estado Global):** **APAGADA.** No necesitas Redux, Vuex ni Singletons pesados. El estado vive localmente (Energía Cinética).
-* **Campo Magnético Perimetral:** **ENCENDIDO.** Todo input externo es un rayo cósmico mortal. En Web, usas filtros de desafío invisible anti-bots. En Móvil/Desktop, usas validadores biométricos (FaceID) o sanitización estricta (Zod/Regex) para evitar *Buffer Overflows* o ejecución de macros maliciosos.
-* **La Biósfera (Accesibilidad):** **MÁXIMA.** En web es SEO semántico. En Móvil/Desktop, obligas el uso de APIs nativas (*VoiceOver, TalkBack*) para que la tecnología de asistencia pueda "leer" tu interfaz.
-
-### 🌍 Nivel 2: El Planeta (Sistemas Transaccionales y Puntos de Venta)
-* **Ejemplos:** E-Commerce, Puntos de Venta locales (Sistemas de Punto de Venta (POS) locales), Apps Móviles transaccionales.
-* **Agujeros de Gusano (Caché y Offline-First):** **ENCENDIDO.** En la nube usas Redis. En POS Desktop o Móvil, enciendes bases de datos locales incrustadas (SQLite, Realm, CoreData). Si el internet se cae, el planeta sigue girando y facturando gracias al Agujero de Gusano.
-* **Firmas Espectrales (Seguridad de Sesión):** **ENCENDIDO.** Implementas JWT para web, o el **Keychain / Windows Credential Manager** para proteger contraseñas localmente en Desktop/Móvil. Jamás se guarda texto plano en disco.
-
-### 🌌 Nivel 3: La Galaxia (Ecosistemas Masivos y Distribuidos)
-* **Ejemplos:** Sistemas ERP distribuidos en la nube, Core Bancario, Suites de Escritorio pesadas (Suites de escritorio de alto rendimiento).
-* **Malla Cósmica (Microservicios / IPC):** **ENCENDIDA.** En la nube, las galaxias se comunican por APIs REST/gRPC. En Desktop, se comunican mediante hilos aislados (IPC - Inter-Process Communication). Si un hilo colapsa, el programa no se cierra. La arquitectura implementa **Circuit Breakers (Disyuntores)** para cortar comunicación con APIs externas caídas y **Bucles de Auto-Sanación (Exponential Reconnects)** para revivir conexiones a bases de datos sin intervención humana.
-* **Materia Oscura y Telemetría:** **MÁXIMA POTENCIA.** El estado global dicta todo. El sistema de Logs (Radiación de Fondo) reporta cada *Fatal Error* de inmediato vía Sentry, Datadog o Webhooks (NTFY/Discord) al centro de mando.
+* **¿Por qué auditar la Resistencia a Mutaciones (G23)?**  
+  Una suite con 100% de cobertura que no falla cuando un operador se invierte es una ilusión de seguridad. G23 verifica que las aserciones validen lógica de estado real y no existan tests complacientes.
+* **¿Por qué inyectar Caos y Disyuntores de Red (G24)?**  
+  En un sistema distribuido, las caídas no son una excepción sino una certeza matemática. G24 audita que el cliente no se quede bloqueado indefinidamente esperando una respuesta de red, forzando timeouts y disyuntores.
+* **¿Por qué capturar Checkpoints inmutables con SHA-256 (G3)?**  
+  Toda modificación de código sin respaldo verificado introduce riesgo de entropía irreversible. Un checkpoint criptográfico asegura que cualquier intento fallido de reparación pueda colapsarse y revertirse al estado exacto previo al fallo.
 
 ---
 
-## GLOSARIO TÁCTICO: EL PORQUÉ DE LAS COSAS (Respuestas para la Élite)
-
-Para que AUM-IC 7 no sea visto como un capricho estético, todo arquitecto debe saber defender la física de sus decisiones en *cualquier* lenguaje (C#, Python, JS, Swift):
-
-* **¿Por qué y cuándo encender el Campo Magnético (ORMs o Query Builders)?**
-  * *Cuándo:* Siempre que el software (Web, POS o App) interactúe con una base de datos o sistema de archivos.
-  * *Por qué:* Escribir consultas "Raw SQL" (SQL crudo) combinadas con variables del usuario es apagar el campo magnético de tu planeta. Los rayos cósmicos (Inyecciones SQL) freirán tu núcleo, ya sea en un clúster en la nube o en la base local de SQLite de la caja registradora. El ORM actúa como una magnetósfera que purifica los comandos maliciosos antes de que toquen el disco. Además, la materia nunca se destruye: se exige el **Borrado Lógico (Soft Deletes)** y el control estricto de esquemas mediante Archivos de Migración.
-
-* **¿Por qué y cuándo hacer un Commit (Punto de Control en el Multiverso)?**
-  * *Cuándo:* Jamás al final del día por costumbre. Se hace **cada vez que un átomo o ruta alcanza la estabilidad matemática (Test en verde)**.
-  * *Por qué:* El desarrollo es una lucha contra la entropía (el caos). Si en la siguiente hora tu código colapsa, el *commit* te permite colapsar esa línea temporal fallida y regresar instantáneamente al último punto donde el universo era estable.
-
-* **¿Por qué destruir los Listeners (Órbitas Cerradas)?**
-  * *Cuándo:* Cuando una ventana modal, un componente o una sub-rutina se cierra o destruye.
-  * *Por qué:* Un Webhook, un proceso *Background Worker* en C#, o un WebSocket que no se destruye explícitamente se convierte en un "Planeta Errante". Seguirá orbitando invisible en la memoria RAM (Memory Leak) hasta destruir la capacidad del dispositivo, forzando al usuario a reiniciar su computadora o teléfono.
+> 🏛️ Propiedad Intelectual de **Ingeniería Creativa (IngCrea)**. Estándar libre publicado bajo licenciamiento dual CC BY-SA 4.0 / MIT.

package/MANIFEST.md

@@ -1,64 +1,106 @@
-
-# 🌌 AUM-IC 7 Standard (2026 Edition)
-**Multidimensional Universe Architecture - Engineering Standard**
+# 📜 ARCHITECTURAL MANIFESTO: AUM-IC 7 STANDARD (2026 EDITION)
 
 <p align="center">
   <img src="https://img.shields.io/badge/version-7.0.0-crimson?style=flat-square" alt="Version 7.0.0">
-  <img src="https://img.shields.io/badge/nature-Clean%20Architecture%20Standard-38bdf8?style=flat-square" alt="Nature">
+  <img src="https://img.shields.io/badge/nature-Pure%20Engineering%20Standard-38bdf8?style=flat-square" alt="Nature">
+  <img src="https://img.shields.io/badge/suite-PUF--25%20Assurance-gold?style=flat-square" alt="PUF-25">
 </p>
 
 > 🌐 **Navigation:** 🇺🇸 [Read in English](./MANIFEST.md) | 🇲🇽 [Leer en Español](./MANIFEST.es.md) | 📖 [README (EN)](./README.md) | 📖 [README (ES)](./README.es.md) | 🌌 [AUM-IC 7 Standard](https://github.com/ingcrea/aum-ic)
 
-## THE PARADIGM
-AUM-IC is not just a folder structure. It is a universal framework of laws that governs software behavior, drawing parallels from quantum mechanics and astrophysics to deliver **Military-Grade Security, High Availability (SRE), and Fractal Scalability**.
-
-### 1. ⚛️ Atomic Physics (The Structure)
-Software must follow fractal symmetry.
-- `1-atoms`: The irreducible elements (Buttons, Inputs).
-- `2-molecules`: Simple compositions (Form Fields).
-- `3-cells`: Reusable blocks (Cards, Navbars).
-- `4-organisms`: Self-contained features (Login Form).
-- `5-planets`: Full views or screens (Dashboard).
-- `6-layouts`: The spatial grid that holds planets.
-
-### 2. 🌌 The 7 Cosmic Forces (SRE & Security Core)
-AUM-IC defines 7 laws that must govern the software's execution engine:
-
-1. **Dark Matter (Global State):** The invisible gravitational pull. State (like Redux or Zustand) connects organisms without direct coupling.
-2. **Event Horizon (Perimeter Security):** The impenetrable border. Enforces **CSP (Content Security Policy)**, strict Rate Limiting, and JWT signatures. If a request lacks proper spectral signatures, the Middleware rejects it instantly.
-3. **Magnetic Field (ORM & Sanitization):** Protects the core from cosmic radiation (SQL Injection). Raw SQL is forbidden. Additionally, matter is never truly destroyed: **Soft Deletes** and declarative schema Migrations are mandatory.
-4. **The Hadron Collider (CI/CD Testing):** Chaos does not enter Production. Before deploying, the pipeline mandates **CVE Vulnerability Audits** (Supply Chain Defense) and deterministic tests.
-5. **Wormholes (Cache & Offline-First):** Bypasses the speed of light. Uses local SQLite/Realm databases for Desktop/Mobile or Redis for Web, ensuring the system survives network outages.
-6. **The Cosmic Web (Resilience):** For massive systems. Implements **Circuit Breakers** to cut off failing external APIs and **Exponential Reconnect Loops** to revive database connections autonomously.
-7. **Cosmic Microwave Background (RUM Observability):** Every action leaves a forensic trace. Enforces **Real User Monitoring (RUM)**, catching global browser exceptions, dead clicks, and 404s, sending real-time alerts to the command center (SOC 2 Compliance).
+This document governs the **Multidimensional Universe Architecture Paradigm (AUM-IC 7 Standard)** and its operational correspondence with the 25-gate matrix of the **Universal Failure Prevention Protocol (PUF-25)**.
+
+It is neither an arbitrary folder recommendation nor a cosmetic convention: it is a deterministic framework of architecture, fractal symmetry, and software physics engineered to inherently satisfy international product quality (**ISO/IEC 25010**), information security (**ISO 27001**), testability (**ISO 29119**), and web accessibility standards (**ISO 40500 / WCAG 2.2**).
+
+---
+
+## 🌌 The Fundamental Philosophy: Entropy vs. Mathematical Precision
+
+**Human software development without discipline is uncontrolled entropy.** It degrades into chaotic sprawl: circular imports, shallow monkey-patches, toxic coupling, memory leaks, and services collapsing under unanticipated concurrency spikes.
+
+The physical universe, while seemingly chaotic, operates under immutable mathematical laws. From elementary quantum interactions to massive planetary mechanics, nothing is left to chance.
+
+**The AUM-IC Paradigm binds software to these same universal laws.** It serves as an absolute mental model, **100% language-agnostic** (Rust, TypeScript, Python, Astro, PHP, Java, C#, Swift, Shell), categorizing systems into **Observable Matter** (fractal codebase structure), **Invisible Forces** (data flow and SRE resilience), and **Laws of Correspondence** (critical mass scalability).
+
+---
+
+## PART I: OBSERVABLE MATTER (Fractal Code Structure)
+
+The Hermetic Principle of Correspondence dictates: *"As above, so below"*. Software components are arranged in strict fractal symmetry across the UI, API Controllers, and Persistence layers:
+
+```text
+src/
+├── 1-atoms/       # Irreducible elements (Buttons, pure math helpers, primitives)
+├── 2-molecules/   # Simple composite groups (Form fields with label/error, middlewares)
+├── 3-cells/       # Functional interactive containers (Cards, ORM entities, unitary services)
+├── 4-organisms/   # Autonomous business modules (Checkout flows, domain use-cases, orchestrators)
+├── 5-planets/     # Full application views or API controllers (Dashboard screens, REST/gRPC handlers)
+└── 6-layouts/     # Structural gravitational grid (Master templates, server bootstrap modules)
+```
+
+* **Zero-Gravity Rule:** Atoms (`1-atoms/`) must remain entirely stateless and cannot import higher-level modules, state managers, or database connections. Gravitational mass and logic density are reserved strictly for organisms and planets.
 
 ---
 
-## PART VI: THE LAW OF CORRESPONDENCE (Critical Mass Scalability)
-"As above, so below." AUM-IC obeys the Hermetic Law of Correspondence: an asteroid obeys the same physics as a galaxy, but forces ignite proportionally to their **Critical Mass**.
+## PART II: THE 7 COSMIC FORCES (SRE & Security Core)
+
+Every production system must enforce 7 dynamic laws governing data flow and runtime resilience:
+
+1. **Dark Matter (Global State):** The invisible gravitational bond. Global application state (Zustand, Redux, background memory daemons) connects organisms without toxic coupling (*Prop Drilling is strictly forbidden*).
+2. **Event Horizon (Perimeter Security):** The impenetrable boundary. Enforces strict Content Security Policy (CSP), rate limiting, bot challenges, and cryptographic JWT verification. Any payload lacking a valid spectral signature is rejected at the middleware gateway.
+3. **Magnetic Field (ORM & Sanitization):** Shields the system core against cosmic radiation (SQL Injections and XSS attacks). Raw unparameterized SQL strings are banned. Matter cannot be arbitrarily destroyed: **Soft Deletes** and declarative schema migrations are mandatory.
+4. **The Hadron Collider (PUF-25 Closed-Loop Assurance):** Chaos does not enter production. Prior to any release, code must clear the 25-gate matrix (**G0 to G24**), auditing everything from raw byte hygiene to API contracts, mutation testing resilience (G23), and chaos fault injection (G24).
+5. **Wormholes (Cache & Offline-First Architecture):** Defeats network latency. Employs embedded local databases (SQLite, Realm) in desktop/mobile apps or distributed Redis clusters in cloud backends, guaranteeing uninterrupted operation and transactional capability during network dropouts.
+6. **The Cosmic Web (Distributed Resilience):** Implements **Circuit Breakers (G24)** to isolate failing upstream dependencies and **Exponential Backoff Reconnect Loops** to revive degraded database connections autonomously.
+7. **Cosmic Microwave Background (Forensic Observability & RUM):** Every user action leaves a forensic signature. Real User Monitoring (RUM), global runtime exception traps, 404 tracking, and immediate alerting dispatch to the incident response center.
+
+---
+
+## PART III: LAW OF CORRESPONDENCE (Critical Mass Scalability)
+
+An asteroid obeys the exact same gravitational laws as a galaxy; however, architectural forces ignite proportionally to the system's **Critical Mass**:
 
 ### 🪨 Level 1: The Asteroid (Single-Purpose Systems)
-* **Examples:** Landing Pages, CLI Scripts, Utility Mobile Apps.
-* **Dark Matter (State):** **OFF.**
-* **Perimeter Magnetic Field:** **MAXIMUM.** Inputs are deadly. Web requires invisible challenge filters (WAF/CAPTCHAs). Desktop/Mobile requires strict biometric validation or Zod sanitization.
-* **The Biosphere (Accessibility/SEO):** **MAXIMUM.** Semantic HTML or native OS Accessibility APIs (VoiceOver/TalkBack).
+* **Examples:** Landing pages, CLI utilities, single-screen mobile apps.
+* **Dark Matter (Global State):** **OFF.** No heavy stores needed; state lives locally.
+* **Perimeter Magnetic Field:** **MAXIMUM.** External input is lethal. Applies strict schema validation (Zod, TypeBox, serde) and bot challenges.
+* **The Biosphere (Accessibility & SEO):** **MAXIMUM.** Semantic HTML structure and native OS accessibility APIs (VoiceOver/TalkBack).
 
 ### 🌍 Level 2: The Planet (Transactional Systems)
-* **Examples:** E-Commerce, Local POS Systems, Transactional Apps.
-* **Wormholes (Cache & Offline-First):** **ON.** Local DBs (SQLite) keep the system running during outages.
-* **Spectral Signatures (Auth):** **ON.** Secrets saved in OS Keychains or secure HttpOnly cookies.
+* **Examples:** E-Commerce platforms, Point of Sale (POS) applications, transactional mobile apps.
+* **Wormholes (Offline-First):** **ON.** Local SQLite databases keep the business running during internet outages.
+* **Spectral Signatures (Auth):** **ON.** Secrets saved in OS Keychains, Windows Credential Manager, or secure HttpOnly cookies. Plaintext credential storage is banned.
 
 ### 🌌 Level 3: The Galaxy (Massive Ecosystems)
-* **Examples:** Cloud ERPs, Core Banking, Heavy Desktop Suites.
-* **The Cosmic Web (Microservices/IPC):** **ON.**
-* **Telemetry & Dark Matter:** **MAXIMUM.**
+* **Examples:** Cloud ERP systems, Core Banking, high-performance desktop suites.
+* **The Cosmic Web (IPC & Microservices):** **MAXIMUM POWER.** Typed asynchronous messaging and decoupled execution threads.
+* **Forensic Telemetry & Observability:** **MAXIMUM POWER.** Real-time log aggregation, distributed tracing, and automated failure isolation.
 
 ---
 
-## TACTICAL GLOSSARY (The "Why")
-* **Why use an ORM always?** Writing Raw SQL is shutting down your magnetic field. Cosmic rays (SQL Injections) will fry your core, whether on an AWS cluster or a local cash register POS.
-* **When to Commit?** Never "at the end of the day." Commit the millisecond an atom achieves mathematical stability (Green Test). It is a temporal save point in the multiverse.
-* **Why destroy Listeners?** A background worker or WebSocket that isn't explicitly closed becomes a "Rogue Planet" causing Memory Leaks until it crashes the user's OS.
+## MAPPING MATRIX: AUM-IC 7 vs. PUF-25
+
+| Cosmic Force (AUM-IC) | Certifying PUF-25 Gates | Operational Objective |
+| :--- | :--- | :--- |
+| **Fundamental Hygiene** | **`G0`**, **`G8`**, **`G22`** | Pure UTF-8 encoding, LF line endings, mojibake eradication, and universal delimiter balance. |
+| **Hadron Collider** | **`G2`**, **`G3`**, **`G5`**, **`G6`**, **`G23`** | Red/Green test cycle, SHA-256 rollback snapshots, strict static analysis, and mutation test resilience. |
+| **Magnetic Field** | **`G4`**, **`G19`**, **`G21`** | Pure logic refactor, zero SQL injection, secret purge, and WordPress/WooCommerce compliance. |
+| **Event Horizon** | **`G9`**, **`G17`**, **`G20`** | POSIX permissions, license integrity, and environment isolation (zero localhost in production). |
+| **Zero Gravity & Layout** | **`G1`**, **`G11`**, **`G18`** | UI thread decoupling, zero-focus stealing (`CREATE_NO_WINDOW`), and clean styling engine consistency. |
+| **Cosmic Web & Resilience** | **`G12`**, **`G13`**, **`G14`**, **`G24`** | Dead link eradication (no 404s), zombie UI action removal, HTTP contracts, and chaos fault isolation. |
+| **Background Radiation** | **`G7`**, **`G10`**, **`G15`**, **`G16`** | ADR logging in `BITACORA.md`, stale cache flushes, E2E validation, and Core Web Vitals audit. |
+
+---
+
+## TACTICAL GLOSSARY: THE "WHY" BEHIND THE RULES
+
+* **Why audit Mutation Testing Resilience (G23)?**  
+  High test coverage with empty or tautological assertions is a dangerous illusion. G23 enforces that assertions genuinely evaluate state deviations, ensuring mutants are actively killed.
+* **Why audit Chaos Fault Injection and Circuit Breakers (G24)?**  
+  In distributed software, remote API and database delays are mathematically inevitable. G24 verifies that network queries include timeouts and circuit breakers, preventing whole-system lockups.
+* **Why capture immutable SHA-256 checkpoints (G3)?**  
+  Modifying code without verified checkpoints introduces irreversible entropy. An atomic cryptographic snapshot guarantees that any failed remediation step can be immediately collapsed and restored.
 
 ---
-> 🏛️ Intellectual Property of **Ingeniería Creativa (IngCrea)**. Standard released under CC BY-SA 4.0 / MIT.
+
+> 🏛️ Intellectual Property of **Ingeniería Creativa (IngCrea)**. Standard released under dual CC BY-SA 4.0 / MIT licensing.