# P2604 - Mejoras al ADN

> Manifiesto de Proyecto | Referencia: [`adn/07_proyectos.md`](../../../adn/07_proyectos.md)

## Identificación

| Campo | Valor |
| :--- | :--- |
| **Código** | P2604 |
| **Nombre** | Mejoras al Ecosistema ADN |
| **Estado** | ⏳ En Ejecución |
| **Inicio** | 14/03/2026 |
| **Fin Estimado** | Continuo (mejora continua) |

## Objetivo

Mejoras atómicas, incrementales y reutilizables al ecosistema ADN. Una herramienta por vez, siguiendo los principios: **Menos es Más + Mejora Continua + Armonía Integral**.

## Stakeholders

| Rol | Persona | Visibilidad |
| :--- | :--- | :--- |
| **Responsable Técnico** | Lic. Ricardo MONLA | Operador directo |
| **Dirección de TIC** | (Jerárquico superior) | Dashboard asíncrono |

## Nodos Involucrados

### Nodos Exclusivos (Core)
| Nodo | IP | Rol en el Proyecto |
| :--- | :--- | :--- |
| [**srv-ns8**](../../../nodos/srv-ns8.md) | `10.0.10.8` | Servidor de desarrollo y ejecución del ADN |

## Herramientas

| Herramienta | Uso |
| :--- | :--- |
| **Ruby 3.x** | Lenguaje del ecosistema ADN |
| **RSpec** | Framework de tests |
| **RuboCop** | Lint automatizado |
| **GitHub Actions** | CI/CD (tests + lint) |

## Hitos Clave

| Fecha | ID | Estado | Hito |
| :--- | :--- | :---: | :--- |
| 14/03 | F1-F8 | ✅ | Tests core, deprecation banners, error handler, constants, logger, HelpFormatter, docs técnica, CI/CD |
| 15/03 | F9-F10 | ✅ | Integración MSPs con ADN + Saneamiento y consolidación (S1-S15) |
| 15/03 | F11-F12 | ✅ | Bitácora Web auto-refresh + Estado/Modo calculado automáticamente |
| 16/03 | RFC-01 | ✅ | Convención de nomenclature de proyectos (RFC-ADN-01) |
| 18/03 | WZ-v2  | ✅ | Plan e implementación de W-ZOMBI v2.0 (reemplazo sonda legacy) |
| — | DOC | 📍 | Actualizar README.md con funcionalidades nuevas (auto-refresh, estado/modo) |
| — | P2604.08 | ✅ | Implementación del modelo Ámbito/Nodo en el ecosistema ADN |

---

## Diagnóstico Integral

### Problemas Identificados

| # | Problema | Archivo(s) | Principio | Severidad |
| :--- | :--- | :--- | :--- | :--- |
| 1 | Sin tests para módulos core | `core/*.rb` | Menos es Más | Alta |
| 2 | Banner DEPRECATED incompleto | `cli/validador.rb` | Armonía | Media |
| 3 | core/validador.rb sin deprecation | `core/validador.rb` | Armonía | Media |
| 4 | Constantes de colores hardcodeadas | `core/colores.rb` | Menos es Más | Baja |
| 5 | Sin handler de errores global | `run` | Armonía | Alta |
| 6 | db/exporters sin tests | `db/exporters/*.rb` | Menos es Más | Media |
| 7 | Logger sin rotación | `core/logger.rb` | Mejora Cont. | Baja |
| 8 | Help inconsistente entre CLI | `cli/*.rb` | Armonía | Baja |
| 9 | Sonda W-ZOMBI monolítica e inflexible | `adn/tools/sonda_w-zombi/servidor.rb` | Menos es Más | Alta |

---

## Plan de Mejoras (13 Fases)

### Fase 1: Tests Core (Menos es Más)

| ID | Módulo | Tests | Estado |
| :--- | :--- | :--- | :--- |
| T1 | `spec/db/evento_spec.rb` | 3 | ✅ |
| T2 | `spec/core/colores_spec.rb` | 6 | ✅ |
| T3 | `spec/core/validador_spec.rb` | 6 | ✅ |
| T4 | `spec/cli/help_spec.rb` | 0 | 📍 |

### Fase 2: Deprecation Banners (Armonía)

| ID | Archivo | Acción | Estado |
| :--- | :--- | :--- | :--- |
| D1 | `cli/validador.rb` | Banner agregado | ✅ |
| D2 | `core/validador.rb` | Revisar - útil para validaciones | ⏸️ |
| D3 | `db/exporters/md_exporter.rb` | Banner agregado | ✅ |

### Fase 3: Manejo de Errores (Armonía)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| E1 | Agregar `rescue` global en `run` | ✅ |
| E2 | Estandarizar mensajes de error | ✅ |
| E3 | Logging de excepciones no manejadas | ✅ |

**Herramientas creadas:** `core/error_handler.rb`, excepciones en `core/constants.rb`

### Fase 4: Constantes y Config (Menos es Más)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| C1 | Documentar constantes en constants.rb | ✅ |
| C2 | Agregar constantes reutilizables (estados, modos) | ✅ |
| C3 | Validar constantes al inicio | ✅ |

### Fase 5: Logger Mejorado (Mejora Continua)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| L1 | Agregar rotación de logs | ✅ |
| L2 | Niveles de log configurables | ✅ |
| L3 | Output JSON estructurado | ✅ |

### Fase 6: Help Consistente (Armonía)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| H1 | HelpFormatter helper reutilizable | ✅ |

### Fase 7: Documentación Técnica

| ID | Documento | Estado |
| :--- | :--- | :--- |
| DOC1 | `docs/tecnica/adn_cli.md` | ✅ |
| DOC2 | `docs/tecnica/adn_core.md` | ✅ |
| DOC3 | `docs/tecnica/adn_tests.md` | ✅ |

### Fase 8: CI/CD

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| CI1 | GitHub Actions para tests | ✅ |
| CI2 | Lint automatizado (.rubocop.yml) | ✅ |

### Fase 9: Integración MSP (Armonía Integral)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| M1 | Auditoría de MSPs | ✅ |
| M2 | Registro de MSPs en BD | ✅ |
| M3 | Listado de MSPs disponibles | ✅ |
| M4 | Documentación de integración | ✅ |
| M5 | Reutilizar NodosInfo en CLI | ✅ |

### Fase 10: Saneamiento y Consolidación

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| S1-S9 | Limpieza de código muerto y duplicaciones | ✅ |
| S10 | Migrar SubcomandoSalud a namespace ADN | ✅ |
| S11 | CLI `ssh` — ejecución remota reutilizable | ✅ |
| S12 | Refactorizar ssh.rb — leer datos de fichas | ✅ |
| S13 | Consolidar core/ — submódulos CLI | ✅ |
| S14 | Subcomando `nodos info` | ✅ |
| S15 | Actualizar README.md con estructura real | ✅ |

### Fase 11: Bitácora Web (Mejora Continua)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| B1 | Auto-refresh cada 30 segundos | ✅ |
| B2 | Refresh al recuperar foco | ✅ |
| B3 | Smart refresh (comparando max_id) | ✅ |

### Fase 12: Consistencia de Eventos (Menos es Más)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| E1 | Estado calculado automáticamente | ✅ |
| E2 | Modo resuelto desde última jornada | ✅ |
| E3 | Estado automático al actualizar con --fin | ✅ |

### Fase 13: Implementación W-ZOMBI v2.0 (Mejora Continua)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| W1 | Implementación de arquitectura modular | ✅ |
| W2 | Integración como subcomando ADN-CLI | ✅ |
| W3 | Test de despliegue y telemetría | ✅ |

### Fase 14: Estandarización Visual (Armonía Integral)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| V1 | Implementar barras de progreso Unicode en P2604 | ✅ |
| V2 | Propagar notación de barras a P2601 | ✅ |
| V3 | Crear guía de estilo para indicadores visuales | ✅ |

### Fase 15: Optimización de Intervención IA (Mejora Continua)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| IA1 | Diagnóstico de logs y fricción (sesión 18/03) | ✅ |
| IA2 | Refactorización de directivas en 05_ia.md | ✅ |
| IA3 | Automatización de contexto de seguridad (candados) | ✅ |
| IA4 | Validación de reducción de pasos exploratorios | ✅ |

### Fase 16: Modelo Ámbito/Nodo (Armonía Integral)

| ID | Mejora | Estado |
| :--- | :--- | :--- |
| A1 | Base de Datos: tabla `ambitos`, columnas `ambito_id` | ✅ |
| A2 | CLI Ruby: comando `ambitos`, normalización `--help` | ✅ |
| A3 | API REST: endpoints `/api/ambitos/*` | ✅ |
| A4 | Frontend: AmbitoDashboard con selector de ámbito | ✅ |
| A5 | Documentación: hebras ADN actualizadas | ✅ |

---

## Progreso

```
Fase  1:  ██████████ 100%  Tests Core
Fase  2:  ██████░░░░  67%  Deprecation
Fase  3:  ██████████ 100%  Error Handler
Fase  4:  ██████████ 100%  Constants
Fase  5:  ██████████ 100%  Logger
Fase  6:  ██████████ 100%  HelpFormatter
Fase  7:  ██████████ 100%  Documentación
Fase  8:  ██████████ 100%  CI/CD
Fase  9:  ██████████ 100%  MSP
Fase 10:  ██████████ 100%  Saneamiento
Fase 11:  ██████████ 100%  Bitácora Web
Fase 12:  ██████████ 100%  Eventos
Fase 13:  ██████████ 100%  W-ZOMBI v2.0
Fase 14:  ██████████ 100%  Visibilidad
Fase 15:  ██████████ 100%  Optimización IA
Fase 16:  ██████████ 100%  Ámbito/Nodo
```

## Métricas Totales

| Métrica | Valor |
| :--- | :--- |
| Tests pasando | 15 |
| Archivos creados | 14 |
| Archivos modificados | 12 |
| Archivos limpiados/movidos | 20+ |
| Fases completadas | 13/13 (100%) |

## Planes de Ejecución

- [Estandarización de Ayudas en Pantalla para Herramientas ADN](P2604.01.01_Estandarizacion-Ayudas-ADN.md)
- [Implementación W-ZOMBI v2.0](P2604.03.01_Plan-W-ZOMBI-v2.0.md)
- [Estandarización de Indicadores Visuales de Progreso](P2604.04.01_Estandarizacion-Barras-Progreso.md)
- [Estudio de Fricción IA (Antigravity) y Mejora Continua](P2604.05.01_Estudio-Friccion-IA.md)
- [Modelo Ámbito/Nodo para el Ecosistema ADN](P2604.08_Ambito-Nodo.md)

## Referencias

- **Punto de verdad**: [`adn/README.md`](../../../adn/README.md)
- **ADN**: [Ontología](../../../adn/01_ontologia.md) | [Proyectos](../../../adn/07_proyectos.md)
- **ADN IA**: [05_ia.md](../../../adn/05_ia.md)
- **Bitácoras**: IDs 1054-1056, 1073, 1106, 1112, 1163 vía `./adn/tools/run db evento:listar --detalle`