@ingcrea/aumic-puf 0.0.0-stage → 3.0.0

package/PUF-15.md

@@ -0,0 +1,118 @@
+---
+name: aumic-puf15
+description: Protocolo Universal contra Fallos (PUF-15) del Estándar AUM-IC 7:2026. Matriz de 15 compuertas de calidad agnóstica (Rust, Astro, Python, PHP, C#) para auditoría, detección, resolución metódica de fallos, refactorización limpia sin deuda técnica y blindaje de ergonomía del sistema operativo.
+---
+# Protocolo Universal contra Fallos (PUF-15) — AUM-IC 7:2026
+### Matriz de Compuertas de Calidad Agnóstica (Rust, Astro, Python, PHP, C#)
+
+Cuando el usuario invoque **PUF-15** (o PUF) o solicite resolver un fallo bajo este estándar, se debe ejecutar con rigor militar este ciclo cerrado de 15 compuertas consecutivas (G1 a G15), reportando el progreso y las evidencias en consola:
+
+---
+
+## Matriz de Compuertas de Calidad (G1 - G15)
+
+### 1. G1: Mapeo de Comportamientos y Límites (Behavior & Boundary Mapping)
+- **Alcance:** Analizar el flujo completo de ejecución y ciclo de vida de la UI.
+- **Acciones:**
+  - Identificar entradas, tipos, contratos, mutaciones y salidas esperadas.
+  - Definir formalmente casos de borde: valores nulos (`None`, `null`, `Option::None`), cadenas vacías, desbordamientos numéricos, condiciones de carrera/concurrencia y accesos no autenticados o permisos insuficientes.
+  - **Aislamiento del Bucle de UI:** Prohibido disparar I/O pesado, comandos o procesos síncronos dentro de temporizadores o callbacks de interfaz gráfica (`slint::Timer`, `setInterval`, `requestAnimationFrame`). Deben delegarse a tareas de fondo asíncronas con canales o cachearse de forma atómica.
+
+### 2. G2: Test de Reproducción — Fase Roja (Reproduction Test-First)
+- **Alcance:** Probar y demostrar empíricamente el defecto antes de tocar una sola línea de lógica.
+- **Acciones:**
+  - Escribir un test automatizado (unitario, integración o CLI determinista) que replique la falla reportada con fidelidad.
+  - Ejecutar el test y confirmar que falle contra el código actual (*Red State*), validando que el bug ha sido capturado de forma determinista.
+
+### 3. G3: Checkpoint Inmutable (State Snapshot)
+- **Alcance:** Blindaje de rollback y preservación de estado pre-mutación.
+- **Acciones:**
+  - Generar un respaldo atómico timestamped en `checkpoints/` o tag git (`<archivo>.bak_YYYYMMDD_HHMMSS`).
+  - Registrar hash de verificación o estado previo para permitir reversión instantánea sin pérdida de información ni corrupción colateral.
+
+### 4. G4: Reparación Focalizada y Refactorización Limpia (Pure Logic Refactor)
+- **Alcance:** Corrección quirúrgica de la causa raíz.
+- **Acciones:**
+  - Atacar la causa raíz sin aplicar parches superficiales ni parches ciegos.
+  - Cero código muerto, cero dependencias circulares, bajo acoplamiento y alta cohesión.
+  - Cumplir principios de código limpio del stack correspondiente:
+    - **Rust:** Cero `unwrap()` no justificado; manejo exhaustivo con `Result` / `Option`.
+    - **Astro:** Componentes puros, separación de lógica frontmatter y JSX estático/reactivo.
+    - **Python:** Tipado estricto (Type hints), PEP 8, manejo explícito de excepciones.
+    - **PHP:** POO fuertemente tipada, tipos estrictos (`declare(strict_types=1);`), inyección de dependencias.
+  - **Prohibición Absoluta de CSS Inline:** Queda terminantemente prohibido inyectar atributos `style="..."` o estilos en línea en el HTML/PHP/JSX/Astro. Si se encuentran estilos inline preexistentes, es obligatorio refactorizarlos y extraerlos a su archivo `.css` o `.scss` respectivo con clases semánticas estructuradas.
+
+### 5. G5: Validación de Test y No-Regresión — Fase Verde (Green State & Non-Regression)
+- **Alcance:** Verificación de solución completa y estabilidad perimetral.
+- **Acciones:**
+  - Reejecutar el test de reproducción desarrollado en G2 y validar el 100% de aserciones aprobadas (*Green State*).
+  - Ejecutar la suite de pruebas perimetral/completa para certificar cero efectos secundarios o regresiones colaterales.
+
+### 6. G6: Análisis Estático, Tipado y Compilador Estricto (Static Gate)
+- **Alcance:** Tolerancia cero a advertencias del compilador o linters.
+- **Acciones:**
+  - Ejecutar compilador y análisis estático en modo estricto según el stack:
+    - **Rust:** `cargo clippy -- -D warnings` y `cargo check`.
+    - **Astro / TypeScript:** `npx astro check` y `npx eslint`.
+    - **Python:** `ruff check` y `mypy --strict`.
+    - **PHP:** `php -l` (sintaxis) y `phpstan analyse --level=max`.
+  - Cero advertencias o errores tolerados.
+
+### 7. G7: Documentación Semántica y Registro ADR (Intent & Architecture Decision)
+- **Alcance:** Memoria técnica e intención arquitectónica.
+- **Acciones:**
+  - Explicar en comentarios de código el *por qué* de la decisión y no solo el *qué hace*.
+  - Registrar en `BITACORA.md` de la raíz del proyecto bajo el formato estricto:
+    ```markdown
+    [Timestamp] | Contexto | Decisión | Consecuencia
+    ```
+
+### 8. G8: Aplanadora POSIX y Sanitización Anti-Mojibake (aumic-sanitizer)
+- **Alcance:** Integridad de codificación y terminación de línea.
+- **Acciones:**
+  - Barrer los archivos con `node C:\Users\NexoRemoto\Proyectos\aumic-sanitizer\index.js` (o `npx aumic-sanitizer`).
+  - Purgar de raíz cualquier carácter corrupto Mojibake (ej. `ó`, `’`, `ñ`) forzando UTF-8 puro sin BOM.
+  - Aplanar y forzar saltos de línea Unix LF (`\n`), erradicando Windows CRLF (`\r\n`).
+
+### 9. G9: Integridad Operativa, Permisos y Secretos Zero-Trust (Ops Shield)
+- **Alcance:** Blindaje de infraestructura y seguridad de credenciales.
+- **Acciones:**
+  - Verificar permisos restrictivos en sistema de archivos (`chmod 644` archivos / `755` directorios, llaves SSH `600`, propietario correcto del servicio `chown`).
+  - Cero credenciales, tokens o contraseñas en texto plano. Gestionar accesos vía variables de entorno seguras o `SECRETOS.py`.
+
+### 10. G10: Invalidación y Purga de Estado Efímero (State Flush)
+- **Alcance:** Consumo garantizado del código fresco en runtime.
+- **Acciones:**
+  - Purgar deterministamente memoria compartida, caché de objetos (`wp cache flush`, Redis, Memcached, Opcache).
+  - Limpiar transientes de base de datos o reiniciar workers (Gunicorn, Systemd, SSR Node, PM2) para garantizar que los clientes o servicios consuman el código recién validado sin residuos en memoria.
+
+### 11. G11: Blindaje de Ergonomía del SO, Foco de Ventanas y Aislamiento UI (OS & Desktop Ergonomics Gate)
+- **Alcance:** Experiencia de usuario inmaculada, ausencia total de robo de foco y persistencia limpia en el Sistema Operativo.
+- **Acciones:**
+  - **Inmunidad al Robo de Foco (Zero-Focus Stealing):** Toda invocación de subprocesos en Windows (`Command::new`, `powershell`, `cmd`, `sc`, `reg`, `net`) DEBE incorporar obligatoriamente `.creation_flags(0x08000000)` (`CREATE_NO_WINDOW`) para erradicar consolas emergentes o parpadeos (flickering) que desactiven la ventana activa del usuario.
+  - **Zero-Ghost Processes:** Comprobar que al cerrar la aplicación no queden procesos huérfanos (`conhost`, workers zombies) consumiendo CPU.
+  - **Caché de Consultas de Privilegios:** Consultas de privilegios (`is_admin`) o del SCM deben usar caché atómico perezoso (`AtomicU8` / `OnceLock`), evitando invocaciones repetidas de subprocesos en bucles de tiempo.
+
+---
+### 12. G12: Topología de Rutas Vivas & Dead Link Sweeper (Living Routes Gate)
+- **Alcance:** Integridad de navegación sin pantallas 404 ni rutas huérfanas en Web (Astro, React, Next, Vue), Mobile (Flutter, React Native) y Desktop (Slint, C /WPF, Tauri).
+- Cero enlaces rotos hacia destinos locales inexistentes.
+
+### 13. G13: Grafo de Interactividad & Erradicación Zombie (Living UI Actions Gate)
+- Cero botones decorativos, pseudoelementos inertes o acciones no conectadas que no responden al usuario.
+
+- Todo control interactivo debe resolver en un evento real (API, modal, mutación o feedback).
+
+### 14. G14: Traza de Contratos HTTP & Endpoints Vivos (Living API Contract Gate)
+- Consistencia granular entre las llamadas del cliente y los controladores declarados en el backend.
+- Cero llamadas fetch o solicitudes HTTP a paths huérfanos o inexistentes.
+
+### 15. G15: Headless E2E Crawler & Runtime Exceptions (Headless Handshake Gate)
+- Detección de errores silenciosos, excepciones de runtime y bloqueos de interfaz.
+- Certificación del pase limpio de interactividad antes de liberar a producción.
+
+## Reglas Inviolables de Ejecución
+
+1. **Cero Complacencia o Respuestas Evasivas:** No dejar tareas a medias ni usar marcadores vacíos (`// el resto del código aquí`).
+2. **Determinismo Técnico:** Todo entregable debe ser determinista, verificado en consola y listo para producción.
+3. **Reporte por Compuerta:** Reportar siempre el estado de cada compuerta (G1 a G15) con su respectiva evidencia de consola.

package/PUF_G16_Lighthouse.md

@@ -0,0 +1,70 @@
+# PUF G16 – Integración de auditorías Lighthouse
+
+## Objetivo
+Incorporar métricas críticas de rendimiento, accesibilidad, SEO y buenas prácticas que Lighthouse evalúa, para enriquecer el Protocolo Universal de Fallos (PUF) bajo el paradigma AUM‑IC 7:2026.
+
+## KPI Prioritarios de Lighthouse (basados en Google PSI)
+| Categoría | Métrica | Umbral de PASS | Umbral de WARN | Umbral de FAIL |
+|-----------|---------|----------------|----------------|----------------|
+| **Core Web Vitals** | **Largest Contentful Paint (LCP)** | < 2.5 s | 2.5 s – 4 s | > 4 s |
+| | **Cumulative Layout Shift (CLS)** | < 0.1 | 0.1 – 0.25 | > 0.25 |
+| | **First Input Delay (FID)** (o **Total Blocking Time** si FID no está disponible) | < 100 ms | 100 ms – 300 ms | > 300 ms |
+| **Performance** | **Speed Index** | < 3 s | 3 s – 4.5 s | > 4.5 s |
+| | **Time to Interactive (TTI)** | < 5 s | 5 s – 7 s | > 7 s |
+| **Accessibility** | **Contrast Ratio** (texto vs fondo) | ≥ 4.5:1 (normal) ≥ 3:1 (large) | – | < 3:1 |
+| | **ARIA roles & labels** | Todos presentes | – | Falta alguno |
+| | **Form labels** | 100 % etiquetado | – | < 100 % |
+| **SEO** | **Meta description** | Presente y 50‑160 caracteres | – | Ausente o fuera de rango |
+| | **Title length** | 50‑60 caracteres | – | < 30 o > 70 |
+| | **Canonical link** | Presente y válido | – | Ausente o inválido |
+| **Best Practices** | **HTTPS** | Sí | – | No |
+| | **Sin contenido mixto** | Sí | – | No |
+| | **Política de caché** (Cache‑Control) | > 1 día para assets estáticos | – | < 1 día |
+
+## Mapeo a checkpoints del PUF y pesos (siguiendo la distribución de Google PSI)
+- **G16‑01**: LCP – **Peso 10 %** del bloque G16.
+- **G16‑02**: CLS – **Peso 10 %**.
+- **G16‑03**: FID/TBT – **Peso 10 %**.
+- **G16‑04**: Speed Index – **Peso 8 %**.
+- **G16‑05**: TTI – **Peso 7 %**.
+- **G16‑06**: Accesibilidad (contrast, ARIA, labels) – **Peso 15 %**.
+- **G16‑07**: SEO (meta, title, canonical) – **Peso 10 %**.
+- **G16‑08**: Buenas prácticas (HTTPS, mixed‑content, cache) – **Peso 10 %**.
+- **G16‑09**: Peso agregado de **Performance** dentro del PUF global – **40 %** del puntaje total (suma de los pesos anteriores).
+- **G16‑10**: Peso de **Accesibilidad** dentro del PUF global – **15 %**.
+- **G16‑11**: Peso de **SEO** dentro del PUF global – **10 %**.
+- **G16‑12**: Peso de **Best Practices** dentro del PUF global – **10 %**.
+
+## Umbrales de salud del PUF (Google PSI style)
+- **Excelente**: Todos los KPI en PASS.
+- **Adecuado**: Máximo 2 WARN, sin FAIL.
+- **Deficiente**: ≥ 1 FAIL o > 2 WARN.
+
+## Prototipo de auditoría Lighthouse (`lighthouse-audit.js`)
+Se añadirá un script Node que:
+1. Recibe una URL como argumento.
+2. Ejecuta `lighthouse` con `--only-categories=performance,accessibility,seo,best-practices`.
+3. Extrae los scores y métricas clave (LCP, CLS, FID/TBT, Speed Index, TTI, contrast, ARIA, etc.).
+4. Genera un JSON compatible con el formato actual de `report-generator.js`.
+5. Opcional: actualiza el puntaje global del PUF según los pesos definidos.
+
+## Integración CI/CD (opciones)
+- **GitHub Actions**: workflow que instala `node`, corre `npm ci`, ejecuta `node scripts/lighthouse-audit.js <URL>`, falla si algún KPI está en FAIL y publica artefacto HTML.
+- **Azure Pipelines**: pipeline YAML con etapas `npm install`, `npm run lighthouse-audit -- <URL>`, `PublishTestResults` para fallos.
+- **GitLab CI**: similar a GH Actions, usando `script:` secciones.
+- **Local on‑demand**: ejecutable vía `npx lighthouse-audit <URL>` o `npm run lighthouse-audit -- <URL>`.
+
+## Dependencias
+```bash
+npm i lighthouse chrome-launcher --save-dev
+```
+
+## Próximos pasos
+1. Crear `scripts/lighthouse-audit.js` con el esqueleto descrito.
+2. Extender `report-generator.js` para consumir los nuevos campos.
+3. Añadir script a `package.json` (`"lighthouse-audit": "node scripts/lighthouse-audit.js"`).
+4. Configurar CI (GitHub Actions o Azure Pipelines) según tu preferencia.
+5. Ejecutar pruebas en `https://segurosiller.com/` y validar visualmente.
+
+---
+*Este documento está listo para ser versionado en el repositorio `aumic-puf`.*

package/README.md

@@ -1,3 +1,254 @@
-# Temporary Holding Version
+# AUM-IC PUF — Protocolo Universal contra Fallos (PUF-23)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![Licencia AGPL-3.0](https://img.shields.io/badge/license-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.0.0-cb3837.svg)](https://www.npmjs.com/package/@ingcrea/aumic-puf)
+
+> Suite oficial de aseguramiento de calidad y orquestador determinista para facilitar el cumplimiento del estándar [AUM-IC 7:2026](https://github.com/ingcrea/aum-ic) por **Ingeniería Creativa (IngCrea)**.
+
+---
+
+## Matriz de 23 Compuertas de Calidad (G0 - G22)
+
+### 0. G0: Higiene Forense Anti-Entropía y Codificación Pura (aumic-sanitizer Audit)
+- **Alcance:** Diagnóstico in-process de mojibake, entropía de caracteres, saltos CRLF y codificación UTF-8 pura.
+
+### 1. G1: Mapeo de Comportamientos y Límites (Behavior & Boundary Mapping)
+- **Alcance:** Analizar el flujo completo de ejecución, ciclo de vida de la UI y desacoplamiento de hilos pesados.
+
+### 2. G2: Test de Reproducción — Fase Roja (Reproduction Test-First)
+- **Alcance:** Escribir y verificar test automatizado previo a tocar código de lógica (*Red State*).
+
+### 3. G3: Checkpoint Inmutable (State Snapshot)
+- **Alcance:** Respaldos atómicos con hash SHA-256 en `checkpoints/` para permitir reversión instantánea.
+
+### 4. G4: Reparación Focalizada y Cero CSS Inline (Pure Logic Refactor)
+- **Alcance:** Erradicación de causa raíz, cero código muerto y prohibición de atributos `style="..."` inline.
+
+### 5. G5: Validación de Test y No-Regresión — Fase Verde (Green State & Non-Regression)
+- **Alcance:** 100% de aserciones aprobadas y verificación perimetral contra regresiones colaterales.
+
+### 6. G6: Análisis Estático Estricto (Static Gate Multi-Ecosystem)
+- **Alcance:** Compiladores y linters en modo estricto (Rust, TypeScript, Python, PHP, Java, C#, C++, Swift, etc.).
+
+### 7. G7: Documentación Semántica y Registro ADR (Intent & Architecture Decision)
+- **Alcance:** Registro obligatorio de decisiones de arquitectura en `BITACORA.md`.
+
+### 8. G8: Aplanadora POSIX y Sanitización Anti-Mojibake
+- **Alcance:** Blindaje de bytes LF puros y UTF-8 estricto sin BOM.
+
+### 9. G9: Integridad Operativa, Permisos y Secretos Zero-Trust
+- **Alcance:** Permisos POSIX (644/755) y cero credenciales en texto plano.
+
+### 10. G10: Invalidación y Purga de Estado Efímero
+- **Alcance:** Purga de cachés de compilación (.next, .turbo, target, __pycache__, .phpunit.cache).
+
+### 11. G11: Ergonomía del SO, Foco de Ventanas y Aislamiento UI (Zero-Focus Stealing)
+- **Alcance:** Compuerta obligatoria contra robo de foco en Windows (`CREATE_NO_WINDOW`) e I/O desacoplado de loops UI.
+
+### 12. G12: Topología de Rutas Vivas & Dead Link Sweeper
+- **Alcance:** Detección de enlaces y destinos locales rotos en código web.
+
+### 13. G13: Grafo de Interactividad & Erradicación Zombie
+- **Alcance:** Erradicación de botones decorativos o handlers de eventos inertes.
+
+### 14. G14: Traza de Contratos HTTP & Endpoints Vivos
+- **Alcance:** Detección estática de contratos HTTP rotos o paths huérfanos.
+
+### 15. G15: Headless E2E Crawler & Runtime Exceptions
+- **Alcance:** Suites E2E (Playwright / Cypress) para verificación de flujo funcional.
+
+### 16. G16: Calidad Visual, Core Web Vitals y Auditoría Web (Lighthouse / CWV)
+- **Alcance:** Puntuación de experiencia de usuario, layouts DOM estables y Core Web Vitals.
+
+### 17. G17: Blindaje Legal, Integridad de Licencias y Compatibilidad (IP & License Guard)
+- **Alcance:** Consistencia entre manifiestos (`package.json`, `Cargo.toml`) y archivos `LICENSE`, titularidad y copyright.
+
+### 18. G18: Consistencia de Motores de Estilo y Erradicación de Antipatrones (Style Engine Consistency)
+- **Alcance:** Prevención de colisión entre frameworks (ej. Tailwind + Bootstrap) y control de deuda de `!important`.
+
+### 19. G19: Blindaje de Superficie de Ataque y Cero Inyecciones (Zero-Injection Guard)
+- **Alcance:** Erradicación de archivos expuestos (`.env`, `dump.sql`) y prevención de concatenación SQL directa.
+
+### 20. G20: Topología de Entornos, Aislamiento de Red y Cero Conexiones Fantasma (Topology Guard)
+- **Alcance:** Erradicación de referencias hardcodeadas a `localhost` / `127.0.0.1` en entornos de producción.
+
+### 21. G21: Cumplimiento Oficial WordPress & WooCommerce (WPCS & WC Guidelines)
+- **Alcance:** Auditoría estricta de sanitización de superglobales, prepared queries en `$wpdb`, compatibilidad obligatoria con High-Performance Order Storage (HPOS) y métodos CRUD canónicos de `WC_Order`.
+
+### 22. G22: Diagnóstico Universal de Sintaxis y Delimitadores (Universal Syntax Guard)
+- **Alcance:** Localización exacta de omisiones de punto y coma (`;`), comas en JSON y llaves/corchetes/paréntesis desbalanceados en memoria sin requerir compiladores externos.
+
+---
+
+## Uso del Orquestador (CLI)
+
+```bash
+# Instalación global desde npm
+npm install -g @ingcrea/aumic-puf
+
+# Auditar todas las compuertas de la matriz (G0 a G22)
+puf auditar
+
+# Auditar compuertas focalizadas (G0, G21, G22)
+puf auditar -g G0,G21,G22
+
+# Modo fail-fast (aborta al primer fallo detectado)
+puf auditar --fast
+
+# Consultar versión instalada
+puf -v
+```
+
+### 1. G1: Mapeo de Comportamientos y Limites (Behavior & Boundary Mapping)
+- **Alcance:** Analizar el flujo completo de ejecucion y ciclo de vida de la UI.
+- **Acciones:**
+  - Identificar entradas, tipos, contratos, mutaciones y salidas esperadas.
+  - Definir formalmente casos de borde: valores nulos (`None`, `null`, `Option::None`), cadenas vacias, desbordamientos numericos, condiciones de carrera/concurrencia y accesos no autenticados.
+  - **Aislamiento del Bucle de UI:** Prohibido disparar I/O pesado, comandos o procesos sincronos dentro de temporizadores o callbacks de interfaz grafica (`slint::Timer`, `setInterval`, `requestAnimationFrame`). Deben delegarse a tareas de fondo asincronas o cachearse atomicamente.
+
+### 2. G2: Test de Reproduccion -- Fase Roja (Reproduction Test-First)
+- **Alcance:** Probar y demostrar empiricamente el defecto antes de tocar una sola linea de logica.
+- **Acciones:**
+  - Escribir un test automatizado (unitario, integracion o CLI determinista) que replique la falla reportada con fidelidad.
+  - Ejecutar el test y confirmar que falle contra el codigo actual (*Red State*).
+
+### 3. G3: Checkpoint Inmutable (State Snapshot)
+- **Alcance:** Blindaje de rollback y preservacion de estado pre-mutacion.
+- **Acciones:**
+  - Generar un respaldo atomico timestamped en `checkpoints/` (`<archivo>.bak_YYYYMMDDHHMMSS`).
+  - Registrar hash SHA-256 para permitir reversion instantanea sin perdida de informacion.
+
+### 4. G4: Reparacion Focalizada y Refactorizacion Limpia (Pure Logic Refactor)
+- **Alcance:** Correccion quirurgica de la causa raiz.
+- **Acciones:**
+  - Atacar la causa raiz sin parches superficiales. Cero codigo muerto, cero dependencias circulares.
+  - Cumplir principios de codigo limpio del stack correspondiente:
+    - **Rust:** Cero `unwrap()` no justificado; manejo exhaustivo con `Result` / `Option`.
+    - **Astro:** Componentes puros, separacion de logica frontmatter y JSX estatico/reactivo.
+    - **Python:** Tipado estricto (Type hints), PEP 8, manejo explicito de excepciones.
+    - **PHP:** POO fuertemente tipada, `declare(strict_types=1);`, inyeccion de dependencias.
+  - **Prohibicion Absoluta de CSS Inline:** Queda terminantemente prohibido inyectar `style="..."` en HTML/PHP/JSX/Astro. Si existen estilos inline preexistentes, refactorizarlos a archivos `.css`/`.scss`.
+
+### 5. G5: Validacion de Test y No-Regresion -- Fase Verde (Green State & Non-Regression)
+- **Alcance:** Verificacion de solucion completa y estabilidad perimetral.
+- **Acciones:**
+  - Reejecutar el test de G2 y validar el 100% de aserciones aprobadas (*Green State*).
+  - Ejecutar la suite de pruebas perimetral/completa para certificar cero regresiones colaterales.
+
+### 6. G6: Analisis Estatico, Tipado y Compilador Estricto (Static Gate)
+- **Alcance:** Tolerancia cero a advertencias del compilador o linters.
+- **Acciones:**
+  - Ejecutar compilador y analisis estatico en modo estricto segun el stack:
+    - **Rust:** `cargo clippy -- -D warnings` y `cargo check`.
+    - **Astro / TypeScript:** `npx astro check` y `npx eslint`.
+    - **Python:** `ruff check` y `mypy --strict`.
+    - **PHP:** `php -l` y `phpstan analyse --level=max`.
+  - Cero advertencias o errores tolerados.
+
+### 7. G7: Documentacion Semantica y Registro ADR (Intent & Architecture Decision)
+- **Alcance:** Memoria tecnica e intencion arquitectonica.
+- **Acciones:**
+  - Explicar en comentarios de codigo el *por que* de la decision y no solo el *que hace*.
+  - Registrar en `BITACORA.md` de la raiz del proyecto bajo el formato estricto:
+    ```
+    [Timestamp] | Contexto | Decision | Consecuencia
+    ```
+
+### 8. G8: Aplanadora POSIX y Sanitizacion Anti-Mojibake (aumic-sanitizer)
+- **Alcance:** Integridad de codificacion y terminacion de linea.
+- **Acciones:**
+  - Barrer los archivos con `node C:\Users\NexoRemoto\Proyectos\aumic-sanitizer\dist\index.js audit .`
+  - Purgar caracteres Mojibake forzando UTF-8 puro sin BOM.
+  - Aplanar y forzar saltos de linea Unix LF (`\n`), erradicando Windows CRLF (`\r\n`).
+
+### 9. G9: Integridad Operativa, Permisos y Secretos Zero-Trust (Ops Shield)
+- **Alcance:** Blindaje de infraestructura y seguridad de credenciales.
+- **Acciones:**
+  - Verificar permisos restrictivos en sistema de archivos (`chmod 644` archivos / `755` directorios, llaves SSH `600`).
+  - Cero credenciales, tokens o contrasenas en texto plano. Gestionar accesos via variables de entorno seguras o `SECRETOS.py`.
+
+### 10. G10: Invalidacion y Purga de Estado Efimero (State Flush)
+- **Alcance:** Consumo garantizado del codigo fresco en runtime.
+- **Acciones:**
+  - Purgar deterministamente cache de objetos (Redis, Memcached, Opcache, `.next`, `dist`).
+  - Reiniciar workers (Gunicorn, Systemd, SSR Node, PM2) para garantizar que los clientes consuman el codigo validado.
+
+### 11. G11: Blindaje de Ergonomia del SO, Foco de Ventanas y Aislamiento UI (OS & Desktop Ergonomics Gate)
+- **Alcance:** Experiencia de usuario inmaculada, ausencia total de robo de foco.
+- **Acciones:**
+  - **Inmunidad al Robo de Foco (Zero-Focus Stealing):** Toda invocacion de subprocesos en Windows (`Command::new`, `powershell`, `cmd`) DEBE incorporar `.creation_flags(0x08000000)` (`CREATE_NO_WINDOW`).
+  - **Zero-Ghost Processes:** Al cerrar la aplicacion, no deben quedar procesos huerfanos consumiendo CPU.
+  - **Cache de Consultas de Privilegios:** Usar cache atomico perezoso (`AtomicU8` / `OnceLock`), evitando invocaciones repetidas en bucles.
+
+---
+
+### 12. G12: Topologia de Rutas Vivas & Dead Link Sweeper (Living Routes Gate)
+- **Alcance:** Integridad de navegacion sin pantallas 404 ni rutas huerfanas en Web (Astro, React, Next, Vue), Mobile (Flutter) y Desktop (Slint, C#/WPF, Tauri).
+- **Acciones:**
+  - Escanear los archivos HTML/JSX/Astro/PHP afectados con el metodo `auditarRutasVivas()` del adaptador.
+  - Detectar atributos `href`, `src`, `to`, `action` que apunten a rutas locales que no existen en el filesystem.
+  - Cero enlaces rotos hacia destinos locales inexistentes. Toda ruta relativa debe resolverse a un archivo real.
+  - El orquestador informa la lista exacta: `archivo.astro -> "/ruta/inexistente" (no existe en filesystem)`.
+  - **Solo aplica a extensiones web:** `.astro`, `.jsx`, `.tsx`, `.html`, `.php`, `.vue`, `.svelte`.
+
+### 13. G13: Grafo de Interactividad & Erradicacion Zombie (Living UI Actions Gate)
+- **Alcance:** Cero botones decorativos, pseudoelementos inertes o acciones no conectadas.
+- **Acciones:**
+  - Escanear los archivos web afectados con el metodo `auditarInteractividad()` del adaptador.
+  - Detectar patrones de handler inerte: `onClick=""`, `onClick={undefined}`, `on:click=""`, `@click=""`.
+  - Todo control interactivo debe resolver en un evento real (API call, modal, mutacion de estado o feedback visual).
+  - El orquestador reporta exactamente que archivo y linea contiene el handler zombie.
+  - **Solo aplica a extensiones web:** `.astro`, `.jsx`, `.tsx`, `.html`, `.php`, `.vue`, `.svelte`.
+
+### 14. G14: Traza de Contratos HTTP & Endpoints Vivos (Living API Contract Gate)
+- **Alcance:** Consistencia granular entre las llamadas del cliente y los controladores declarados en el backend.
+- **Acciones:**
+  - Analizar los archivos afectados buscando llamadas `fetch(...)` o `axios.get/post/...` con rutas hardcodeadas locales (no `/api/`, no variables de entorno `${}`).
+  - Cero llamadas HTTP a paths huerfanos o inexistentes detectados estaticamente.
+  - Si se detectan inconsistencias, listar exactamente el archivo y el endpoint problematico.
+
+### 15. G15: Headless E2E Crawler & Runtime Exceptions (Headless Handshake Gate)
+- **Alcance:** Deteccion de errores silenciosos, excepciones de runtime y bloqueos de interfaz.
+- **Acciones:**
+  - Verificar si existe suite E2E (Playwright `playwright.config.ts`, Cypress `cypress.config.ts`) en la raiz del proyecto.
+  - Si existe: marcar como **APROBADA** e instruir al Jefe Maestro a ejecutarla manualmente para certificacion completa.
+  - Si NO existe: marcar como **OMITIDA** (no bloquea certificacion) con recomendacion de configurar Playwright.
+  - **G15 OMITIDA no es un fallo:** `todasAprobadas` acepta tanto `aprobada` como `omitida`.
+
+---
+
+## Reglas Inviolables de Ejecucion
+
+1. **Cero Complacencia:** No dejar tareas a medias ni usar marcadores vacios (`// el resto del codigo aqui`).
+2. **Determinismo Tecnico:** Todo entregable debe ser determinista, verificado en consola y listo para produccion.
+3. **Reporte por Compuerta:** Reportar siempre el estado de cada compuerta (G1 a G15) con su respectiva evidencia.
+4. **G15 es OMITIDA, no RECHAZADA:** Si no hay suite E2E, G15 se omite sin bloquear la certificacion.
+5. **G12 y G13 aplican solo a archivos web:** Para proyectos Rust/Python/Shell sin frontend, estas compuertas se aprueban automaticamente por ausencia de extensiones web en los archivos afectados.
+
+## Uso del Orquestador (CLI)
+
+```bash
+# Inicializar incidente (crea andamio G2 + checkpoints G3)
+puf iniciar INC-042 "Descripcion del fallo" src/archivo.ts
+
+# Auditar las 15 compuertas concurrentemente
+puf auditar INC-042 src/archivo.ts
+
+# Modo fail-fast (aborta al primer fallo)
+puf auditar INC-042 src/archivo.ts --fast
+
+# Revertir a estado pre-fallo (usando checkpoint G3)
+puf revertir INC-042 archivo.ts
+
+# Instalar guardian de Git (pre-commit hook)
+puf instalar-hook
+```
+
+## Licencia
+
+Distribuido bajo licencia **GNU Affero General Public License v3.0 (AGPL-3.0)**. Ver [LICENSE](LICENSE).
+
+---
+
+**[Ingeniería Creativa](https://ingcrea.com)** | [Estándar AUM-IC](https://github.com/ingcrea/aum-ic)

package/dist/adapters/astro.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file astro.ts
+ * @description Adaptador heurístico especializado para Astro / Modern SSR.
+ * Compatible cross-platform (Windows & POSIX) con npx.cmd y fallback a npm run build.
+ * Estándar AUM-IC 7:2026.
+ */
+import type { EcosistemaLenguaje } from '../core/types.js';
+import { AdaptadorBase } from './base.js';
+export declare class AdaptadorAstro extends AdaptadorBase {
+    readonly ecosistema: EcosistemaLenguaje;
+    readonly nombreLegible: string;
+    protected readonly criterios: {
+        manifiestos: string[];
+        configuraciones: string[];
+        lockfiles: string[];
+        extensiones: string[];
+    };
+    ejecutarLinterEstricto(directorioRaiz: string): Promise<{
+        exitoso: boolean;
+        mensaje: string;
+    }>;
+    generarAndamioTest(idIncidente: string, descripcionFallo: string): Promise<string>;
+    purgarEstado(directorioRaiz: string): Promise<{
+        exitoso: boolean;
+        mensaje: string;
+    }>;
+}
+//# sourceMappingURL=astro.d.ts.map

package/dist/adapters/astro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.d.ts","sourceRoot":"","sources":["../../src/adapters/astro.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAgB,UAAU,EAAE,kBAAkB,CAAW;IACzD,SAAgB,aAAa,EAAE,MAAM,CAAwB;IAE7D,SAAS,CAAC,QAAQ,CAAC,SAAS;;;;;MAK1B;IAEW,sBAAsB,CACjC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBpC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBlF,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAIlG"}

package/dist/adapters/astro.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * @file astro.ts
+ * @description Adaptador heurístico especializado para Astro / Modern SSR.
+ * Compatible cross-platform (Windows & POSIX) con npx.cmd y fallback a npm run build.
+ * Estándar AUM-IC 7:2026.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptadorAstro = void 0;
+const base_js_1 = require("./base.js");
+const ejecutor_js_1 = require("../utils/ejecutor.js");
+class AdaptadorAstro extends base_js_1.AdaptadorBase {
+    ecosistema = 'astro';
+    nombreLegible = 'Astro / Modern SSR';
+    criterios = {
+        manifiestos: ['package.json'],
+        configuraciones: ['astro.config.mjs', 'astro.config.ts', 'astro.config.js'],
+        lockfiles: ['package-lock.json', 'pnpm-lock.yaml', 'yarn.lock'],
+        extensiones: ['.astro'],
+    };
+    async ejecutarLinterEstricto(directorioRaiz) {
+        // 1. Intentar astro check o tsc con comando agnóstico
+        const esWindows = process.platform === 'win32';
+        const comandoCheck = esWindows ? 'npx.cmd astro check' : 'npx astro check';
+        const comandoBuild = esWindows ? 'npm.cmd run build' : 'npm run build';
+        let res = await ejecutor_js_1.EjecutorComando.ejecutar(comandoCheck, directorioRaiz);
+        if (!res.exitoso) {
+            // Fallback a build estricto de Astro (valida tipos, sintaxis y templates al 100%)
+            res = await ejecutor_js_1.EjecutorComando.ejecutar(comandoBuild, directorioRaiz);
+        }
+        if (!res.exitoso) {
+            return {
+                exitoso: false,
+                mensaje: 'Astro Build / TypeScript detectó errores:\n' + (res.salidaError || res.salidaEstandar),
+            };
+        }
+        return {
+            exitoso: true,
+            mensaje: 'Auditoría estricta de compilación y contratos Astro aprobada sin errores.',
+        };
+    }
+    async generarAndamioTest(idIncidente, descripcionFallo) {
+        return [
+            '/**',
+            ' * Andamio de Test Determinista PUF-15 [Fase Roja G2 / Fase Verde G5]',
+            ' * Incidente: ' + idIncidente,
+            ' * Descripción: ' + descripcionFallo,
+            ' * Estándar AUM-IC 7:2026',
+            ' */',
+            "import { describe, it } from 'node:test';",
+            "import assert from 'node:assert/strict';",
+            '',
+            "describe('Incidente ' + idIncidente, () => {",
+            "  it('debe reproducir el fallo documentado', () => {",
+            '    const condicion = true;',
+            "    assert.ok(condicion, 'Falla resuelta');",
+            '  });',
+            '});',
+            '',
+        ].join('\n');
+    }
+    async purgarEstado(directorioRaiz) {
+        await ejecutor_js_1.EjecutorComando.ejecutar('rm -rf .astro 2>/dev/null || true', directorioRaiz);
+        return { exitoso: true, mensaje: 'Caché de compilación Astro purgada.' };
+    }
+}
+exports.AdaptadorAstro = AdaptadorAstro;
+//# sourceMappingURL=astro.js.map

package/dist/adapters/astro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.js","sourceRoot":"","sources":["../../src/adapters/astro.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,uCAA0C;AAC1C,sDAAuD;AAEvD,MAAa,cAAe,SAAQ,uBAAa;IAC/B,UAAU,GAAuB,OAAO,CAAC;IACzC,aAAa,GAAW,oBAAoB,CAAC;IAE1C,SAAS,GAAG;QAC7B,WAAW,EAAE,CAAC,cAAc,CAAC;QAC7B,eAAe,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,CAAC;QAC3E,SAAS,EAAE,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,WAAW,CAAC;QAC/D,WAAW,EAAE,CAAC,QAAQ,CAAC;KACxB,CAAC;IAEK,KAAK,CAAC,sBAAsB,CACjC,cAAsB;QAEtB,sDAAsD;QACtD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC/C,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAC3E,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,eAAe,CAAC;QAEvE,IAAI,GAAG,GAAG,MAAM,6BAAe,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,kFAAkF;YAClF,GAAG,GAAG,MAAM,6BAAe,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,6CAA6C,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,cAAc,CAAC;aACjG,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,2EAA2E;SACrF,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAAC,WAAmB,EAAE,gBAAwB;QAC3E,OAAO;YACL,KAAK;YACL,uEAAuE;YACvE,gBAAgB,GAAG,WAAW;YAC9B,kBAAkB,GAAG,gBAAgB;YACrC,2BAA2B;YAC3B,KAAK;YACL,2CAA2C;YAC3C,0CAA0C;YAC1C,EAAE;YACF,8CAA8C;YAC9C,sDAAsD;YACtD,6BAA6B;YAC7B,6CAA6C;YAC7C,OAAO;YACP,KAAK;YACL,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,cAAsB;QAC9C,MAAM,6BAAe,CAAC,QAAQ,CAAC,mCAAmC,EAAE,cAAc,CAAC,CAAC;QACpF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;IAC3E,CAAC;CACF;AA9DD,wCA8DC"}

package/dist/adapters/base.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @file base.ts
+ * @description Clase base abstracta para adaptadores con motor de puntuacion heuristica de confianza.
+ * Extiende la interfaz AdaptadorLenguaje con G12 (Rutas Vivas) y G13 (Interactividad).
+ * Estandar AUM-IC 7:2026.
+ */
+import type { AdaptadorLenguaje, ContextoDeteccion, EcosistemaLenguaje } from '../core/types.js';
+export interface CriteriosHeuristicos {
+    readonly manifiestos: readonly string[];
+    readonly configuraciones: readonly string[];
+    readonly lockfiles: readonly string[];
+    readonly extensiones: readonly string[];
+    readonly shebangs?: readonly string[];
+}
+export declare abstract class AdaptadorBase implements AdaptadorLenguaje {
+    abstract readonly ecosistema: EcosistemaLenguaje;
+    abstract readonly nombreLegible: string;
+    protected abstract readonly criterios: CriteriosHeuristicos;
+    /** Extensiones web que aplican para G12/G13 */
+    private static readonly EXT_WEB;
+    /** G12: Regex que captura href/src/to con rutas locales (no http, no #, no {}) */
+    private static readonly REGEX_RUTA_LOCAL;
+    /** G13: Detecta handlers de eventos vacios o inertes */
+    private static readonly REGEX_HANDLER_INERTE;
+    calcularPuntaje(contexto: ContextoDeteccion): Promise<number>;
+    detectar(directorioRaiz: string): Promise<boolean>;
+    abstract ejecutarLinterEstricto(directorioRaiz: string): Promise<{
+        exitoso: boolean;
+        mensaje: string;
+    }>;
+    abstract generarAndamioTest(idIncidente: string, descripcionFallo: string): Promise<string>;
+    abstract purgarEstado(directorioRaiz: string): Promise<{
+        exitoso: boolean;
+        mensaje: string;
+    }>;
+    /**
+     * G12: Dead Link Sweeper — detecta hrefs/srcs locales rotos en archivos web.
+     * Implementacion base compartida; los adaptadores especializados pueden sobreescribirla.
+     */
+    auditarRutasVivas(archivosAfectados: readonly string[], directorioRaiz: string): Promise<{
+        exitoso: boolean;
+        violaciones: readonly string[];
+    }>;
+    /**
+     * G13: Living UI Actions — detecta handlers de eventos vacios o inertes.
+     * Implementacion base compartida; los adaptadores especializados pueden sobreescribirla.
+     */
+    auditarInteractividad(archivosAfectados: readonly string[], directorioRaiz: string): Promise<{
+        exitoso: boolean;
+        violaciones: readonly string[];
+    }>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEjG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,8BAAsB,aAAc,YAAW,iBAAiB;IAC9D,kBAAyB,UAAU,EAAE,kBAAkB,CAAC;IACxD,kBAAyB,aAAa,EAAE,MAAM,CAAC;IAC/C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAE5D,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAA2E;IAE1G,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAC+B;IAEvE,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CACkD;IAEjF,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB7D,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;aAK/C,sBAAsB,CACpC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;aAEjC,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC;aAEF,YAAY,CAC1B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAEjD;;;OAGG;IACU,iBAAiB,CAC5B,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IA4BhE;;;OAGG;IACU,qBAAqB,CAChC,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAuBjE"}