@ingcrea/aumic-puf 3.2.1 → 3.4.0

package/LICENSE

@@ -630,7 +630,7 @@ state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
 
     <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
+    Copyright (C) 2026  Ingeniería Creativa
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU Affero General Public License as published

package/MANIFEST.es.md

@@ -3,12 +3,12 @@
 <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--23%20Aseguramiento-gold?style=flat-square" alt="PUF-23">
+  <img src="https://img.shields.io/badge/suite-PUF--25%20Aseguramiento-gold?style=flat-square" alt="PUF-25">
 </p>
 
 > 🌐 **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 23 compuertas del **Protocolo Universal contra Fallos (PUF-23)**.
+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)**.
 
 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**).
 
@@ -49,9 +49,9 @@ Todo sistema en producción debe operar bajo 7 leyes dinámicas que rigen el flu
 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-23):** El caos no entra a producción. Antes de un release, el código debe superar la matriz de 23 compuertas de aseguramiento (**G0 a G22**), auditando desde la codificación de bytes hasta contratos de API y compatibilidad de licencias.
+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** 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.
+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.
 
 ---
@@ -78,28 +78,28 @@ Un asteroide obedece las mismas leyes fundamentales que una galaxia; sin embargo
 
 ---
 
-## MATRIZ DE CORRESPONDENCIA: AUM-IC 7 vs. PUF-23
+## MATRIZ DE CORRESPONDENCIA: AUM-IC 7 vs. PUF-25
 
-| Fuerza Cósmica AUM-IC | Compuertas PUF-23 que la Certifican | Objetivo Operativo |
+| 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`** | Ciclo rojo/verde de tests, snapshots SHA-256 de reversión y rigor estático absoluto. |
+| **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 Rutas** | **`G12`**, **`G13`**, **`G14`** | Cero enlaces 404, erradicación de botones zombies y validación de contratos API cliente/servidor. |
+| **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. |
 
 ---
 
 ## GLOSARIO TÁCTICO: EL PORQUÉ DE LAS REGLAS
 
-* **¿Por qué prohibir las consultas Raw SQL sin parametrizar?**  
-  Escribir consultas concatenando texto del usuario es apagar el Campo Magnético. Permite que cualquier inyección SQL altere la estructura de la base de datos, destruyendo la integridad relacional de la información.
+* **¿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.
-* **¿Por qué destruir listeners y desacoplar temporizadores (G1 y G11)?**  
-  Un proceso en segundo plano, worker o websocket que no se destruye explícitamente se convierte en un objeto errante que consume memoria RAM de forma indefinida (Memory Leak), provocando bloqueos en el sistema operativo y degradando la ergonomía del usuario.
 
 ---
 

package/MANIFEST.md

@@ -3,12 +3,12 @@
 <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-Pure%20Engineering%20Standard-38bdf8?style=flat-square" alt="Nature">
-  <img src="https://img.shields.io/badge/suite-PUF--23%20Assurance-gold?style=flat-square" alt="PUF-23">
+  <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)
 
-This document governs the **Multidimensional Universe Architecture Paradigm (AUM-IC 7 Standard)** and its operational correspondence with the 23-gate matrix of the **Universal Failure Prevention Protocol (PUF-23)**.
+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**).
 
@@ -49,9 +49,9 @@ Every production system must enforce 7 dynamic laws governing data flow and runt
 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-23 Closed-Loop Assurance):** Chaos does not enter production. Prior to any release, code must clear the 23-gate matrix (**G0 to G22**), auditing everything from raw byte hygiene to API contracts and licensing compliance.
+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** to isolate failing upstream dependencies and **Exponential Backoff Reconnect Loops** to revive degraded database connections autonomously.
+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.
 
 ---
@@ -78,28 +78,28 @@ An asteroid obeys the exact same gravitational laws as a galaxy; however, archit
 
 ---
 
-## MAPPING MATRIX: AUM-IC 7 vs. PUF-23
+## MAPPING MATRIX: AUM-IC 7 vs. PUF-25
 
-| Cosmic Force (AUM-IC) | Certifying PUF-23 Gates | Operational Objective |
+| 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`** | Red/Green test cycle, SHA-256 rollback snapshots, and strict multi-language static analysis. |
+| **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 & Routing** | **`G12`**, **`G13`**, **`G14`** | Dead link eradication (no 404s), zombie UI action removal, and HTTP client/server contract checks. |
+| **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 ban raw string-concatenated SQL queries?**  
-  Concatenating unchecked input into SQL statements disables your Magnetic Field, allowing trivial SQL injections to alter and compromise the integrity of relational data.
+* **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.
-* **Why terminate listeners and decouple UI timers (G1 and G11)?**  
-  Background daemons or WebSockets left running without lifecycle bounds become rogue objects leaking memory RAM indefinitely, causing system freezing and ruining desktop ergonomics.
 
 ---
 

package/README.es.md

@@ -1,12 +1,12 @@
-# AUM-IC PUF — Protocolo Universal contra Fallos (PUF-23)
+# AUM-IC PUF — Protocolo Universal contra Fallos (PUF-25)
 
 [![Licencia AGPL-3.0](https://img.shields.io/badge/licencia-AGPL--3.0-blue.svg)](LICENSE)
 [![Estándar AUM-IC 7:2026](https://img.shields.io/badge/est%C3%A1ndar-AUM--IC%207%3A2026-gold.svg)](https://github.com/ingcrea/aum-ic)
-[![npm version](https://img.shields.io/badge/npm-v3.2.1-cb3837.svg)](https://www.npmjs.com/package/@ingcrea/aumic-puf)
+[![npm version](https://img.shields.io/badge/npm-v3.4.0-cb3837.svg)](https://www.npmjs.com/package/@ingcrea/aumic-puf)
 
 > 🌐 **Navegación:** 🇲🇽 [Leer en Español](./README.es.md) | 🇺🇸 [Read in English](./README.md) | 📜 [Manifiesto (ES)](./MANIFEST.es.md) | 📜 [Manifesto (EN)](./MANIFEST.md) | 🌌 [Estándar AUM-IC 7](https://github.com/ingcrea/aum-ic)
 
-Suite oficial de aseguramiento determinista de calidad y orquestador multi-lenguaje de 23 compuertas (G0 a G22) bajo el estándar **AUM-IC 7:2026**, diseñado y mantenido por **Ingeniería Creativa (IngCrea)**.
+Suite oficial de aseguramiento determinista de calidad y orquestador multi-lenguaje de 25 compuertas (G0 a G24) bajo el estándar **AUM-IC 7:2026**, diseñado y mantenido por **Ingeniería Creativa (IngCrea)**.
 
 ---
 
@@ -16,16 +16,20 @@ El Protocolo Universal contra Fallos (PUF) no es un linter superficial ni una co
 
 Opera de forma agnóstica a través de adaptadores especializados para **Rust, TypeScript/JavaScript, Astro, Next.js, Python, PHP, Java/JVM, C#, C/C++, Flutter/Dart y Shell**, garantizando cumplimiento riguroso con normativas internacionales de fiabilidad (**ISO/IEC 25010**), seguridad de la información (**ISO 27001**) y testabilidad (**ISO 29119**).
 
-### Características Clave del Motor v3.2.1
+### Características Clave del Motor v3.4.0
 
-* **Snapshot VFS en Memoria (`LectorArbolProyecto`):** Mapeo virtual del sistema de archivos con caché volátil estructurado. Permite que múltiples compuertas analicen el repositorio de forma concurrente sin provocar saturación de I/O en disco.
+* **Auto-Sanador Quirúrgico (`puf sanar` / `puf fix`):** Remediación determinista automatizada de anomalías en G0, G8, G17, G20 y G22, asegurando respaldos inmutables G3 previos con hash SHA-256 antes de cada mutación.
+* **Modo Centinela Dual (`puf watch`):** Vigilancia reactiva en caliente que reporta en consola ANSI y despacha notificaciones Toast nativas en el sistema operativo sin robar foco de ventana (cumplimiento ergonómico G11).
+* **Servidor MCP Nativo (`puf serve` / `puf mcp`):** Protocolo Model Context Protocol por stdio (JSON-RPC) para integración directa con asistentes de IA (Antigravity, Claude, Cursor) sin latencia de subprocesos.
+* **Snapshot VFS en Memoria (`LectorArbolProyecto`):** Mapeo virtual del sistema de archivos con caché volátil estructurado. Permite que las 25 compuertas analicen el repositorio de forma concurrente sin provocar saturación de I/O en disco.
 * **Persistencia Forense Indexada (`RepositorioSqliteAudit`):** Almacenamiento nativo en SQLite (`.aumic/puf_audit.sqlite`) de cada ejecución, registrando métricas de latencia, violaciones detectadas y telemetría histórica con tiempos de consulta inferiores a 20 ms.
+* **Testing Avanzado Integrado:** Incorpora pruebas de resistencia a mutaciones (G23) e inyección de caos con validación de disyuntores de red (G24).
 * **Perfiles Dinámicos de Auditoría (`--profile`):** Flexibilidad de inspección según el ciclo de entrega (`enterprise`, `mvp`, `dev`, `security`).
 * **Zero-Black-Box Telemetry:** Reportes forenses interactivos en HTML (`puf-report.html`) con diagramas SVG gauge, tarjetas KPI de impacto y trazabilidad exacta de archivo y línea.
 
 ---
 
-## Matriz Exhaustiva de las 23 Compuertas de Calidad (G0 a G22)
+## Matriz Exhaustiva de las 25 Compuertas de Calidad (G0 a G24)
 
 ### G0: Higiene Forense Anti-Entropía y Codificación Pura (In-Process Sanitizer)
 * **Para qué sirve:** Garantiza que ningún byte corrupto, BOM invisible o secuencia de caracteres rotos ingrese al flujo de desarrollo.
@@ -37,7 +41,7 @@ Opera de forma agnóstica a través de adaptadores especializados para **Rust, T
 
 ### G2: Test de Reproducción — Fase Roja (Reproduction Test-First)
 * **Para qué sirve:** Erradica correcciones a ciegas y asunciones subjetivas al resolver anomalías.
-* **Qué hace:** Exige la existencia o creación previa de una prueba automatizada (unitaria, funcional o de integración) que replique con fidelidad el defecto reportado. El motor verifica que el test falle inequívocamente contra el código base actual (*Estado Rojo*) antes de permitir cualquier mutación de lógica.
+* **Qué hace:** Exige la existencia o creación previa de una prueba automatizada (unitaria, funcional o basada en propiedades) que replique con fidelidad el defecto reportado. El motor verifica que el test falle inequívocamente contra el código base actual (*Estado Rojo*) antes de permitir cualquier mutación de lógica.
 
 ### G3: Checkpoint Inmutable de Estado (State Snapshot Guard)
 * **Para qué sirve:** Otorga inmunidad frente a pérdidas de código o regresiones destructivas durante una reparación.
@@ -137,6 +141,16 @@ Opera de forma agnóstica a través de adaptadores especializados para **Rust, T
   * Audita la integridad de archivos JSON (detectando comas faltantes o trailing commas no permitidas).
   * Evalúa el balanceo perfecto de delimitadores (`{ }`, `[ ]`, `( )`), ignorando inteligentemente literales de cadenas, comentarios y expresiones regulares para reportar la línea precisa de cualquier desbalance.
 
+### G23: Resistencia a Mutaciones y Aserciones Vacías (Mutation Resilience Guard)
+* **Para qué sirve:** Erradica el falso confort de suites con 100% de cobertura que no tienen capacidad real de atrapar fallos lógicos.
+* **Qué hace:** Audita la efectividad de las pruebas evaluando si las aserciones son vacías, complacientes o tautológicas (`expect(true).toBe(true)`). Comprueba que los tests sometan el código a validaciones de estado reales que fallen obligatoriamente si un operador lógico, aritmético o de bifurcación es alterado en la lógica intervenida.
+
+### G24: Inyección de Caos, Disyuntores y Auto-Sanación (Chaos & Fault Injection Guard)
+* **Para qué sirve:** Garantiza que la aplicación sobreviva a la latencia extrema, micro-cortes y caídas de servicios externos sin colapsar el sistema operativo ni el proceso principal.
+* **Qué hace:** Inspecciona la arquitectura de transporte HTTP y conexiones a bases de datos en busca de vulnerabilidades ante fallas de red:
+  * Detecta invocaciones cliente sin timeouts explícitos ni señales de aborto (`AbortController`).
+  * Verifica la implementación de **Disyuntores (Circuit Breakers)** y bucles de reintento con retroceso exponencial (**Exponential Backoff**) para aislar dependencias degradadas y permitir la auto-recuperación sin intervención humana.
+
 ---
 
 ## Perfiles Dinámicos de Auditoría (`--profile`)
@@ -145,10 +159,10 @@ Para optimizar pipelines de integración continua o verificaciones rápidas ante
 
 | Perfil | Compuertas Evaluadas | Caso de Uso |
 | :--- | :--- | :--- |
-| **`enterprise`** *(Predeterminado)* | **G0 a G22 (23 compuertas)** | Certificación integral obligatoria previa a releases y despliegues productivos. |
+| **`enterprise`** *(Predeterminado)* | **G0 a G24 (25 compuertas)** | Certificación integral obligatoria previa a releases y despliegues productivos. |
 | **`mvp`** | `G0`, `G4`, `G6`, `G8`, `G22` | Verificación ágil de prototipos rápidos: higiene, lógica limpia, tipado estricto y sintaxis. |
 | **`dev`** | `G0`, `G4`, `G6`, `G8`, `G22` | Ciclo de desarrollo local ultrarrápido sin bloqueos por suites accesorias. |
-| **`security`** | `G0`, `G8`, `G9`, `G17`, `G19`, `G20` | Auditoría de ciberseguridad, permisos POSIX, blindaje legal, topología y cero inyecciones. |
+| **`security`** | `G0`, `G8`, `G9`, `G17`, `G19`, `G20`, `G24` | Auditoría de ciberseguridad, permisos POSIX, blindaje legal, topología, cero inyecciones y resiliencia ante caos. |
 
 ---
 
@@ -168,7 +182,7 @@ npx @ingcrea/aumic-puf auditar
 
 #### 1. Auditoría Completa de la Matriz (Enterprise)
 ```bash
-# Audita las 23 compuertas de calidad concurrentemente en el directorio actual
+# Audita las 25 compuertas de calidad concurrentemente en el directorio actual
 puf auditar
 
 # Ejecución fail-fast (aborta de inmediato al primer fallo detectado)
@@ -180,7 +194,7 @@ puf auditar --fast
 # Auditoría rápida para entornos de desarrollo local
 puf auditar --profile=dev
 
-# Auditoría estricta de seguridad perimetral
+# Auditoría estricta de seguridad perimetral y resiliencia
 puf auditar --profile=security
 
 # Auditoría ligera de entrega rápida (MVP)
@@ -189,20 +203,20 @@ puf auditar --profile=mvp
 
 #### 3. Auditoría Focalizada por Compuertas
 ```bash
-# Evalúa únicamente higiene forense, compliance de WordPress y sintaxis universal
-puf auditar -g G0,G21,G22
+# Evalúa mutaciones, resiliencia ante caos y compliance WordPress
+puf auditar -g G21,G23,G24
 
-# Evalúa seguridad y topología de red
-puf auditar -g G9,G19,G20
+# Evalúa higiene forense y sintaxis universal
+puf auditar -g G0,G8,G22
 ```
 
 #### 4. Gestión de Incidentes y Reversión Atómica
 ```bash
 # Inicia un incidente (genera andamio de test G2 y captura checkpoint inmutable G3)
-puf iniciar INC-104 "Corrección de cálculo en pasarela de pagos" src/checkout.ts
+puf iniciar INC-105 "Blindaje de resiliencia en pasarela" src/checkout.ts
 
 # Reversión de emergencia a partir del checkpoint SHA-256 en caso de error
-puf revertir INC-104 src/checkout.ts
+puf revertir INC-105 src/checkout.ts
 ```
 
 #### 5. Blindaje de Repositorio Git (Pre-commit Hook)
@@ -228,7 +242,7 @@ puf --version
 El repositorio incluye la plantilla oficial [`puf-github-action.yml`](puf-github-action.yml). Para blindar cualquier repositorio en GitHub:
 
 ```yaml
-name: Certificación AUM-IC PUF-23
+name: Certificación AUM-IC PUF-25
 on: [push, pull_request]
 
 jobs:

package/README.md

@@ -1,12 +1,12 @@
-# AUM-IC PUF — Universal Failure Prevention Protocol (PUF-23)
+# AUM-IC PUF — Universal Failure Prevention Protocol (PUF-25)
 
 [![AGPL-3.0 License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 [![AUM-IC 7:2026 Standard](https://img.shields.io/badge/standard-AUM--IC%207%3A2026-gold.svg)](https://github.com/ingcrea/aum-ic)
-[![npm version](https://img.shields.io/badge/npm-v3.2.1-cb3837.svg)](https://www.npmjs.com/package/@ingcrea/aumic-puf)
+[![npm version](https://img.shields.io/badge/npm-v3.4.0-cb3837.svg)](https://www.npmjs.com/package/@ingcrea/aumic-puf)
 
 > 🌐 **Navigation:** 🇺🇸 [Read in English](./README.md) | 🇲🇽 [Leer en Español](./README.es.md) | 📜 [Manifesto (EN)](./MANIFEST.md) | 📜 [Manifiesto (ES)](./MANIFEST.es.md) | 🌌 [AUM-IC 7 Standard](https://github.com/ingcrea/aum-ic)
 
-Official deterministic quality assurance engine and 23-gate universal multi-language orchestrator (G0 to G22) implementing the **AUM-IC 7:2026 Standard**, engineered and maintained by **Ingeniería Creativa (IngCrea)**.
+Official deterministic quality assurance engine and 25-gate universal multi-language orchestrator (G0 to G24) implementing the **AUM-IC 7:2026 Standard**, engineered and maintained by **Ingeniería Creativa (IngCrea)**.
 
 ---
 
@@ -16,16 +16,20 @@ The Universal Failure Prevention Protocol (PUF) is not a surface-level linter or
 
 Operating agnostically via specialized language adapters for **Rust, TypeScript/JavaScript, Astro, Next.js, Python, PHP, Java/JVM, C#, C/C++, Flutter/Dart, and Shell**, it enforces compliance with international reliability (**ISO/IEC 25010**), information security (**ISO 27001**), and testability (**ISO 29119**) benchmarks.
 
-### Key Engine Features in v3.2.1
+### Key Engine Features in v3.4.0
 
-* **In-Memory VFS Snapshot (`LectorArbolProyecto`):** Structured volatile filesystem snapshot caching. Enables multiple gates to evaluate project structure and code concurrently with zero disk I/O bottleneck.
+* **Deterministic Surgical Auto-Fix (`puf sanar` / `puf fix`):** Automated deterministic resolution for G0, G8, G17, G20, and G22 violations, creating immutable G3 checkpoints with SHA-256 hashes prior to mutating files.
+* **Dual Watch Sentinel (`puf watch`):** Reactive filesystem listener reporting both in ANSI terminal and native non-intrusive OS toast notifications (G11 ergonomic compliance).
+* **Native MCP Server (`puf serve` / `puf mcp`):** Built-in Model Context Protocol server over stdio (JSON-RPC) enabling seamless, zero-latency integration with AI agents (Antigravity, Claude, Cursor).
+* **In-Memory VFS Snapshot (`LectorArbolProyecto`):** Structured volatile filesystem snapshot caching. Enables all 25 gates to evaluate project structure and code concurrently with zero disk I/O bottleneck.
 * **Indexed Forensic Persistence (`RepositorioSqliteAudit`):** Native SQLite engine persistence (`.aumic/puf_audit.sqlite`) recording execution latency, identified infractions, and historical audit telemetry with sub-20ms query overhead.
+* **Integrated Advanced Testing:** Incorporates Mutation Resilience Verification (G23) and Chaos Fault Injection with Circuit Breaker inspection (G24).
 * **Dynamic Audit Profiles (`--profile`):** Adaptable gate execution matching pipeline requirements (`enterprise`, `mvp`, `dev`, `security`).
 * **Zero-Black-Box Telemetry:** Comprehensive HTML forensic dashboard (`puf-report.html`) complete with SVG compliance gauges, key impact KPI tiles, and pinpointed line-by-line violation reports.
 
 ---
 
-## Comprehensive Matrix of Quality Gates (G0 to G22)
+## Comprehensive Matrix of Quality Gates (G0 to G24)
 
 ### G0: Forensic Anti-Entropy & Encoding Hygiene (In-Process Sanitizer)
 * **Purpose:** Ensures zero corrupted bytes, phantom BOM markers, or invalid character sequences enter development streams.
@@ -37,7 +41,7 @@ Operating agnostically via specialized language adapters for **Rust, TypeScript/
 
 ### G2: Reproduction Test-First — Red Phase (Reproduction Test-First)
 * **Purpose:** Prevents guesswork and subjective speculation during defect resolution.
-* **What it does:** Mandates the presence or authoring of an automated test (unit, integration, or CLI-driven) faithfully reproducing the reported flaw. Verifies that the test unmistakably fails against the current codebase (*Red State*) before any production code modification is allowed.
+* **What it does:** Mandates the presence or authoring of an automated test (unit, integration, or property-based) faithfully reproducing the reported flaw. Verifies that the test unmistakably fails against the current codebase (*Red State*) before any production code modification is allowed.
 
 ### G3: Immutable State Checkpoint (State Snapshot Guard)
 * **Purpose:** Delivers immunity against destructive regressions or data loss during bug mitigation.
@@ -137,6 +141,16 @@ Operating agnostically via specialized language adapters for **Rust, TypeScript/
   * Audits JSON integrity (detecting unescaped structures, missing commas, or trailing commas).
   * Evaluates perfect bracket balance (`{ }`, `[ ]`, `( )`), smartly ignoring strings, inline comments, and regular expression literals to pinpoint the exact line of any imbalance.
 
+### G23: Mutation Resilience & Assertions Verification (Mutation Resilience Guard)
+* **Purpose:** Eradicates the illusion of safety provided by high coverage test suites lacking assertion power.
+* **What it does:** Audits test effectiveness by detecting vacuous, complacently passed, or tautological assertions (`expect(true).toBe(true)`). Verifies that tests enforce genuine state contracts capable of catching mutant logic deviations if operators are inverted in production code.
+
+### G24: Chaos Fault Injection & Circuit Breakers (Chaos & Fault Injection Guard)
+* **Purpose:** Ensures distributed microservices and database clients survive high network latency and intermittent outages without process deadlock.
+* **What it does:** Audits client HTTP transport and database connections for resilience engineering patterns:
+  * Detects unbound fetch calls lacking abort timeouts or explicit `AbortController` signals.
+  * Validates the integration of **Circuit Breakers** and **Exponential Backoff Reconnect Loops** to isolate degraded downstream dependencies without human intervention.
+
 ---
 
 ## Dynamic Audit Profiles (`--profile`)
@@ -145,10 +159,10 @@ To accelerate continuous integration pipelines and local pre-commit cycles, PUF
 
 | Profile | Evaluated Gates | Primary Use Case |
 | :--- | :--- | :--- |
-| **`enterprise`** *(Default)* | **G0 through G22 (All 23 Gates)** | Complete gate certification required prior to production release or distribution. |
+| **`enterprise`** *(Default)* | **G0 through G24 (All 25 Gates)** | Complete gate certification required prior to production release or distribution. |
 | **`mvp`** | `G0`, `G4`, `G6`, `G8`, `G22` | Rapid proof-of-concept audit: forensic hygiene, pure logic, strict static checks, and syntax. |
 | **`dev`** | `G0`, `G4`, `G6`, `G8`, `G22` | Lightning-fast local development loop without external dependency overhead. |
-| **`security`** | `G0`, `G8`, `G9`, `G17`, `G19`, `G20` | Specialized audit for infrastructure, file permissions, secret hygiene, topology, and injections. |
+| **`security`** | `G0`, `G8`, `G9`, `G17`, `G19`, `G20`, `G24` | Dedicated security, secret hygiene, topology, and network resilience audit. |
 
 ---
 
@@ -168,7 +182,7 @@ npx @ingcrea/aumic-puf auditar
 
 #### 1. Full Matrix Audit (Enterprise)
 ```bash
-# Concurrently evaluates all 23 quality gates across the current directory
+# Concurrently evaluates all 25 quality gates across the current directory
 puf auditar
 
 # Fail-fast execution (immediately halts upon encountering the first failure)
@@ -180,7 +194,7 @@ puf auditar --fast
 # Fast local development check
 puf auditar --profile=dev
 
-# Dedicated security shield audit
+# Dedicated security shield and resilience audit
 puf auditar --profile=security
 
 # Rapid prototype audit
@@ -189,20 +203,20 @@ puf auditar --profile=mvp
 
 #### 3. Granular Gate Targeting
 ```bash
-# Run only encoding hygiene, WordPress compliance, and syntax checking
-puf auditar -g G0,G21,G22
+# Run only mutation tests, chaos injection, and WordPress compliance
+puf auditar -g G21,G23,G24
 
-# Run security, attack surface, and environment topology gates
-puf auditar -g G9,G19,G20
+# Run encoding hygiene, POSIX squasher, and universal syntax guard
+puf auditar -g G0,G8,G22
 ```
 
 #### 4. Incident Workflow & Rollback
 ```bash
 # Initialize incident (generates G2 test harness and creates G3 immutable state snapshot)
-puf iniciar INC-104 "Payment gateway calculation fix" src/checkout.ts
+puf iniciar INC-105 "Resilience hardening in gateway" src/checkout.ts
 
 # Lossless rollback to SHA-256 pre-mutation state
-puf revertir INC-104 src/checkout.ts
+puf revertir INC-105 src/checkout.ts
 ```
 
 #### 5. Git Pre-Commit Hook Integration
@@ -228,7 +242,7 @@ puf --version
 The repository packages an official workflow template [`puf-github-action.yml`](puf-github-action.yml). To integrate into any GitHub repository:
 
 ```yaml
-name: AUM-IC PUF-23 Certification
+name: AUM-IC PUF-25 Certification
 on: [push, pull_request]
 
 jobs:

package/dist/cli/index.d.ts

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 /**
  * @file index.ts
- * @description Punto de entrada CLI interactivo y concurrente para `puf` / `aumic-puf`.
- * Soporta selector de compuerta única (-g / --gate), generación de reporte HTML forense
- * e integración diagnóstica con aumic-sanitizer (G0).
+ * @description Punto de entrada CLI interactivo, centinela y servidor MCP para `puf` / `aumic-puf`.
+ * Soporta selector de compuerta única (-g / --gate), perfiles, generación de reporte HTML forense,
+ * modo de vigilancia reactiva (watch), auto-remediación (sanar/fix) y servidor MCP nativo.
  * Estándar AUM-IC 7:2026.
  */
 export {};

package/dist/cli/index.js

@@ -2,9 +2,9 @@
 "use strict";
 /**
  * @file index.ts
- * @description Punto de entrada CLI interactivo y concurrente para `puf` / `aumic-puf`.
- * Soporta selector de compuerta única (-g / --gate), generación de reporte HTML forense
- * e integración diagnóstica con aumic-sanitizer (G0).
+ * @description Punto de entrada CLI interactivo, centinela y servidor MCP para `puf` / `aumic-puf`.
+ * Soporta selector de compuerta única (-g / --gate), perfiles, generación de reporte HTML forense,
+ * modo de vigilancia reactiva (watch), auto-remediación (sanar/fix) y servidor MCP nativo.
  * Estándar AUM-IC 7:2026.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -47,27 +47,35 @@ const guardian_git_js_1 = require("../hooks/guardian-git.js");
 const generador_reporte_html_js_1 = require("../core/generador-reporte-html.js");
 const interfaz_js_1 = require("./interfaz.js");
 const types_js_1 = require("../core/types.js");
+const auto_sanador_js_1 = require("../core/auto-sanador.js");
+const centinela_watch_js_1 = require("../core/centinela-watch.js");
+const servidor_mcp_js_1 = require("../core/servidor-mcp.js");
 async function main() {
     const argumentos = process.argv.slice(2);
     const comando = argumentos[0]?.toLowerCase();
     const directorioActual = process.env['PUF_TARGET_DIR'] || process.cwd();
     const orquestador = new orquestador_js_1.OrquestadorPUF15(directorioActual);
     if (comando === '-v' || comando === '--version' || comando === 'version') {
-        console.log('v3.2.1');
+        console.log('v3.4.0');
+        return;
+    }
+    // Subcomando de Servidor MCP Nativo (stdio)
+    if (comando === 'serve' || comando === 'mcp' || argumentos.includes('--mcp')) {
+        servidor_mcp_js_1.ServidorMcpPuf.iniciar(directorioActual);
         return;
     }
     switch (comando) {
         case 'iniciar':
         case 'init': {
             const idIncidente = argumentos[1];
-            const descripcion = argumentos[2] || 'Resolucion metodica de fallo bajo PUF-15';
+            const descripcion = argumentos[2] || 'Resolucion metodica de fallo bajo PUF-25';
             const archivos = argumentos.slice(3).filter((a) => typeof a === 'string');
             if (!idIncidente) {
                 console.error('Uso: puf iniciar <ID-INCIDENTE> [DESCRIPCION] [ARCHIVOS...]');
                 process.exit(1);
             }
             interfaz_js_1.InterfazConsola.mostrarBanner();
-            console.log('[PUF-15]: Inicializando incidente ' + idIncidente + '...');
+            console.log('[PUF-25]: Inicializando incidente ' + idIncidente + '...');
             const res = await orquestador.inicializarIncidente({
                 idIncidente,
                 descripcionFallo: descripcion,
@@ -78,15 +86,48 @@ async function main() {
             res.respaldosCreados.forEach((r) => console.log('  - ' + r));
             break;
         }
+        case 'sanar':
+        case 'fix': {
+            interfaz_js_1.InterfazConsola.mostrarBanner();
+            const compuertasArgs = argumentos.slice(1).map(c => c.toUpperCase().replace(/^--?G?/, 'G'));
+            console.log(`\x1b[36m⚡ [AUTO-SANADOR DETERMINISTA]:\x1b[0m Iniciando protocolo de reparación quirúrgica...`);
+            const sanaciones = await auto_sanador_js_1.AutoSanador.sanar(directorioActual, compuertasArgs.length > 0 ? compuertasArgs : undefined);
+            let totalReparaciones = 0;
+            sanaciones.forEach(s => {
+                totalReparaciones += s.reparacionesAplicadas;
+                const color = s.reparacionesAplicadas > 0 ? '\x1b[32m✔' : '\x1b[90m-';
+                console.log(`${color} [${s.compuerta}]:\x1b[0m ${s.detalle}`);
+                if (s.archivosModificados.length > 0) {
+                    s.archivosModificados.forEach(a => console.log(`    \x1b[33m↳ modificado:\x1b[0m ${a}`));
+                }
+            });
+            console.log(`\n\x1b[32m✔ Sanación completada:\x1b[0m ${totalReparaciones} anomalías corregidas con respaldos G3 atómicos.\n`);
+            break;
+        }
+        case 'watch':
+        case 'centinela': {
+            let perfilWatch = 'dev';
+            let usarToast = true;
+            for (const arg of argumentos.slice(1)) {
+                if (arg.startsWith('--profile=')) {
+                    const p = arg.split('=')[1]?.toLowerCase();
+                    if (types_js_1.COMPUERTAS_POR_PERFIL[p])
+                        perfilWatch = p;
+                }
+                else if (arg === '--no-toast') {
+                    usarToast = false;
+                }
+            }
+            centinela_watch_js_1.CentinelaWatch.iniciar(directorioActual, perfilWatch, usarToast);
+            break;
+        }
         case 'auditar':
         case 'verificar':
         case 'audit':
         case 'verify': {
             const failFast = argumentos.includes('--fast') || argumentos.includes('--fail-fast');
             const sinReporte = argumentos.includes('--no-html');
-            // Extracción de compuertas específicas con -g o --gate
             const compuertasAFiltrar = [];
-            // Extraccion de perfil con --profile=<mvp|dev|security|enterprise>
             let perfilSeleccionado = 'enterprise';
             for (let i = 0; i < argumentos.length; i++) {
                 const arg = argumentos[i];
@@ -133,7 +174,6 @@ async function main() {
                     });
                 }
             }
-            // Parsea ruta de reporte HTML si se especifica con --html o --reporte
             let rutaReportePersonalizada;
             for (let i = 0; i < argumentos.length; i++) {
                 const arg = argumentos[i];
@@ -147,7 +187,6 @@ async function main() {
                     rutaReportePersonalizada = arg.split('=')[1];
                 }
             }
-            // Filtra banderas para obtener idIncidente y archivos
             const argumentosLimpios = argumentos.filter((a, idx) => {
                 if (!a)
                     return false;
@@ -183,7 +222,6 @@ async function main() {
                 },
             });
             interfaz_js_1.InterfazConsola.renderizarResultado(resultado);
-            // Generación automática del reporte HTML forense salvo que se use --no-html
             if (!sinReporte) {
                 try {
                     const rutaHtml = rutaReportePersonalizada || path.join(directorioActual, 'puf-report.html');
@@ -208,7 +246,7 @@ async function main() {
                 process.exit(1);
             }
             interfaz_js_1.InterfazConsola.mostrarBanner();
-            console.log('[PUF-15]: Solicitando reversion atomica G3...');
+            console.log('[PUF-25]: Solicitando reversion atomica G3...');
             const resRollback = await orquestador.revertir(idIncidente, nombreArchivo);
             if (!resRollback.exitoso) {
                 console.error('✗ ' + resRollback.mensaje);
@@ -220,7 +258,7 @@ async function main() {
         case 'hook':
         case 'instalar-hook': {
             interfaz_js_1.InterfazConsola.mostrarBanner();
-            console.log('[PUF-15]: Instalando interceptor forense Git...');
+            console.log('[PUF-25]: Instalando interceptor forense Git...');
             const resHook = await guardian_git_js_1.GuardianGitHook.instalar(directorioActual);
             if (!resHook.exitoso) {
                 console.error('✗ ' + resHook.mensaje);
@@ -232,7 +270,7 @@ async function main() {
         case 'guard': {
             const resGuard = await guardian_git_js_1.GuardianGitHook.verificarStaged(directorioActual);
             if (!resGuard.exitoso) {
-                console.error('✗ [INTERCEPTOR PUF-15 DENEGO EL COMMIT AGPL-3.0]:');
+                console.error('✗ [INTERCEPTOR PUF-25 DENEGO EL COMMIT AGPL-3.0]:');
                 resGuard.errores.forEach((e) => console.error(e));
                 process.exit(1);
             }
@@ -242,18 +280,21 @@ async function main() {
         default: {
             interfaz_js_1.InterfazConsola.mostrarBanner();
             console.log('Uso:\n' +
-                '  puf iniciar <ID-INCIDENTE> [DESCRIPCION] [ARCHIVOS...]      Genera andamio test (G2) y checkpoints (G3)\n' +
-                '  puf auditar [ID-INCIDENTE] [ARCHIVOS...] [--profile=mvp]   Evalua la suite (--profile=mvp|dev|security|enterprise)\n' +
-                '  puf revertir <ID-INCIDENTE> <ARCHIVO>                       Restaura atomicamente el archivo previo al fallo\n' +
-                '  puf instalar-hook                                           Instala el guardian de Git en .git/hooks/pre-commit\n' +
-                '  puf guard                                                   Valida que los cambios en staged no violen G4 o G7\n' +
-                '  puf -v, --version                                           Muestra la version actual instalada\n');
+                '  puf auditar [ID-INCIDENTE] [--profile=mvp]                 Evalua la suite (--profile=mvp|dev|security|enterprise)\n' +
+                '  puf sanar [COMPUERTAS...]                                 Ejecuta auto-remediacion quirurgica (alias: puf fix)\n' +
+                '  puf watch [--profile=dev] [--no-toast]                    Modo centinela con notificacion dual consola + Toast SO\n' +
+                '  puf serve                                                 Inicia el servidor MCP nativo (Model Context Protocol stdio)\n' +
+                '  puf iniciar <ID-INCIDENTE> [DESCRIPCION] [ARCHIVOS...]    Genera andamio test (G2) y checkpoints (G3)\n' +
+                '  puf revertir <ID-INCIDENTE> <ARCHIVO>                     Restaura atomicamente el archivo previo al fallo\n' +
+                '  puf instalar-hook                                         Instala el guardian de Git en .git/hooks/pre-commit\n' +
+                '  puf guard                                                 Valida que los cambios en staged no violen G4 o G7\n' +
+                '  puf -v, --version                                         Muestra la version actual instalada\n');
             break;
         }
     }
 }
 main().catch((error) => {
-    console.error('[PUF-15 ERROR FATAL]: ' + error.message);
+    console.error('[PUF ERROR FATAL]: ' + error.message);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map