Refactor(ADN): Migración de tools/adn a adn/tools en busca de la Armonía Integral del DIIAA

This commit is contained in:
Ricardo Monla
2026-03-10 22:25:01 -03:00
parent 174ef7d53c
commit 78006032eb
69 changed files with 432 additions and 671 deletions
@@ -53,7 +53,7 @@ Cada nueva herramienta debe eliminar una dependencia de la IA:
### 4. **API de Comandos Unificada**
Todas las herramientas deben compartir interfaz común:
```bash
ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contexto, adn.rb trigger
ruby adn/tools.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contexto, adn.rb trigger
```
---
@@ -62,7 +62,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
### 🥇 **Prioridad Alta: Re-diseño para Autonomía**
#### 1. **`tools/adn-validador.rb` → `tools/adn/validador.rb`**
#### 1. **`adn/tools-validador.rb` → `adn/tools/validador.rb`**
- **Mejora**: Convertir en daemon con observador de sistema de archivos.
- **Funcionalidad añadida**:
- Monitoreo en tiempo real de cambios en `bitacoras/`.
@@ -70,7 +70,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
- Integración con pre-commit hook que rechace commits con errores de ADN.
- **Reducción IA**: Elimina necesidad de que IA verifique manualmente el formato.
#### 2. **`tools/bitacora-triggers.rb` → `tools/adn/triggers.rb`**
#### 2. **`tools/bitacora-triggers.rb` → `adn/tools/triggers.rb`**
- **Mejora**: Sistema de eventos y suscriptores basado en reglas YAML.
- **Funcionalidad añadida**:
- Archivo `adn/triggers.yml` con reglas definidas por operador.
@@ -78,7 +78,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
- Log de triggers ejecutados en `logs/triggers.log`.
- **Reducción IA**: Implementa automáticamente los triggers que hoy ejecuta manualmente la IA.
#### 3. **`tools/adn-contexto.rb` → `tools/adn/contexto.rb`**
#### 3. **`adn/tools-contexto.rb` → `adn/tools/contexto.rb`**
- **Mejora**: Motor de inferencia topológica autónomo.
- **Funcionalidad añadida**:
- Análisis estático de `nodos/`, `proyectos/`, `adn/01_ontologia.md`.
@@ -88,19 +88,19 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
### 🥈 **Prioridad Media: Sistema Integrado**
#### 4. **`tools/adn.rb` - CLI Unificada**
#### 4. **`adn/tools.rb` - CLI Unificada**
- **Mejora**: Comando único con subcomandos para todas las operaciones ADN.
- **Estructura propuesta**:
```bash
ruby tools/adn.rb validador [--watch] [--fix]
ruby tools/adn.rb triggers [--test] [--force]
ruby tools/adn.rb contexto <nodo> [--cmd]
ruby tools/adn.rb evolucion <propuesta.md> [--aprobar]
ruby tools/adn.rb salud [--dashboard] [--json]
ruby adn/tools.rb validador [--watch] [--fix]
ruby adn/tools.rb triggers [--test] [--force]
ruby adn/tools.rb contexto <nodo> [--cmd]
ruby adn/tools.rb evolucion <propuesta.md> [--aprobar]
ruby adn/tools.rb salud [--dashboard] [--json]
```
- **Beneficio**: Interfaz consistente, fácil de recordar, documentar y usar.
#### 5. **Sistema de Eventos `tools/adn/eventos.rb`**
#### 5. **Sistema de Eventos `adn/tools/eventos.rb`**
- **Mejora**: Bus de eventos interno para comunicación entre módulos.
- **Eventos clave**:
- `:archivo_modificado` (ruta, tipo)
@@ -109,7 +109,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
- `:error_adn_detectado` (tipo, ubicación, severidad)
- **Beneficio**: Desacoplamiento, extensibilidad, y capacidad de plugins.
#### 6. **Dashboard Autónomo `tools/adn/dashboard.rb`**
#### 6. **Dashboard Autónomo `adn/tools/dashboard.rb`**
- **Mejora**: Servidor web Ruby (Sinatra) que muestre salud del ADN.
- **Funcionalidad**:
- Panel en tiempo real (WebSockets) de validaciones.
@@ -119,7 +119,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
### 🥉 **Prioridad Baja: Madurez y Resiliencia**
#### 7. **`tools/adn/backup.rb` con Versionado Semántico**
#### 7. **`adn/tools/backup.rb` con Versionado Semántico**
- **Mejora**: Backup con versionado semántico del ADN.
- **Funcionalidad**:
- Versiones: `adn-1.2.3.tar.gz` (major.features.fixes).
@@ -127,7 +127,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
- Integración con `dtic-BKPs` para almacenamiento cifrado.
- **Beneficio**: Capacidad de rollback y auditoría histórica.
#### 8. **`tools/adn/aprendizaje.rb` - Sistema de Recomendaciones**
#### 8. **`adn/tools/aprendizaje.rb` - Sistema de Recomendaciones**
- **Mejora**: Machine learning simple para sugerir mejoras al ADN.
- **Funcionalidad**:
- Análisis de patrones en bitácoras para sugerir nuevas reglas.
@@ -140,26 +140,26 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
## 📅 Hoja de Ruta Revisada (8 semanas)
### **Fase 1: Núcleo Autónomo (Semanas 1-2)**
1. `tools/adn/` - Estructura de directorios y gemas base.
2. `tools/adn.rb` - CLI unificada con subcomandos básicos.
3. `tools/adn/validador.rb` - Validador en tiempo real con hooks Git.
1. `adn/tools/` - Estructura de directorios y gemas base.
2. `adn/tools.rb` - CLI unificada con subcomandos básicos.
3. `adn/tools/validador.rb` - Validador en tiempo real con hooks Git.
4. **Entregable**: Sistema que valida automáticamente cada commit.
### **Fase 2: Automatización Inteligente (Semanas 3-4)**
1. `tools/adn/triggers.rb` - Sistema de eventos basado en YAML.
2. `tools/adn/contexto.rb` - Motor de inferencia topológica.
1. `adn/tools/triggers.rb` - Sistema de eventos basado en YAML.
2. `adn/tools/contexto.rb` - Motor de inferencia topológica.
3. Integración con cron (tareas periódicas de validación).
4. **Entregable**: Triggers automáticos operativos sin intervención IA.
### **Fase 3: Sistema Integrado (Semanas 5-6)**
1. `tools/adn/eventos.rb` - Bus de eventos interno.
2. `tools/adn/dashboard.rb` - Servidor web de monitoreo.
1. `adn/tools/eventos.rb` - Bus de eventos interno.
2. `adn/tools/dashboard.rb` - Servidor web de monitoreo.
3. API JSON para integración con dashboard principal.
4. **Entregable**: Dashboard autónomo en tiempo real.
### **Fase 4: Madurez y Evolución (Semanas 7-8)**
1. `tools/adn/backup.rb` - Sistema de versionado semántico.
2. `tools/adn/aprendizaje.rb` - Recomendaciones automáticas.
1. `adn/tools/backup.rb` - Sistema de versionado semántico.
2. `adn/tools/aprendizaje.rb` - Recomendaciones automáticas.
3. Documentación completa y onboarding.
4. **Entregable**: Sistema maduro con capacidad de auto-evolución.
@@ -171,7 +171,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
| :--- | :--- | :--- | :--- |
| **Acciones IA en bitácoras/día** | 5-10 | < 2 | Conteo de "(IA)" en bitácoras |
| **Porcentaje de triggers automáticos** | 0% | 90% | Triggers ejecutados automáticamente vs manualmente |
| **Tiempo de auto-contextualización** | 2-3 min | < 30 seg | `time ruby tools/adn.rb contexto <nodo>` |
| **Tiempo de auto-contextualización** | 2-3 min | < 30 seg | `time ruby adn/tools.rb contexto <nodo>` |
| **Errores detectados por humano** | 70% | < 30% | Origen de detección de errores de ADN |
| **Uso de `05_ia.md` como referencia** | Diario | Semanal | Frecuencia de consulta a la hebra |
| **Scripts ejecutados sin interpretación IA** | 40% | 85% | Comandos ejecutados directamente vs via IA |
@@ -200,7 +200,7 @@ ruby tools/adn.rb <subcomando> [opciones] # Ej: adn.rb validador, adn.rb contex
## 🧠 Consideraciones Arquitectónicas
### 1. **Gemfile y Dependencias**
Crear `tools/adn/Gemfile` con:
Crear `adn/tools/Gemfile` con:
- `listen` para observación de archivos.
- `sinatra` para dashboard web.
- `toml` o `yaml` para configuración.
@@ -228,7 +228,7 @@ dashboard:
```
### 3. **Logging Estructurado**
- Todos los scripts usan `tools/adn/logger.rb` común.
- Todos los scripts usan `adn/tools/logger.rb` común.
- Logs en `logs/adn/` con rotación diaria.
- Formato JSON para fácil parsing y análisis.
@@ -243,11 +243,11 @@ dashboard:
1. **[ ] Revisar estas sugerencias** en la próxima bitácora diaria.
2. **[ ] Actualizar `260307-1400_Plan_Mejoras_ADN.md`** con:
- Arquitectura de directorio `tools/adn/`.
- CLI unificada `tools/adn.rb`.
- Arquitectura de directorio `adn/tools/`.
- CLI unificada `adn/tools.rb`.
- KPIs específicos de reducción de IA.
3. **[ ] Crear ticket en P2603** para "Automatización Ruby del ADN".
4. **[ ] Iniciar Fase 1** con estructura básica de `tools/adn/`.
4. **[ ] Iniciar Fase 1** con estructura básica de `adn/tools/`.
---