Feat(ADN): Implementado y ejecutado archivar:md para mover Markdowns obsoletos a histórico DB-First

2026-03-10 16:02:03 -03:00
parent 8aa1532396
commit 8d27a8958e
74 changed files with 3195 additions and 2073 deletions
@@ -0,0 +1,267 @@
+# Sugerencias de Mejoras para el Plan de ADN: Orientación hacia Automatización Ruby y Reducción de Dependencia de IA
+
+**Fecha:** 07/03/2026 - 14:30  
+**Estado:** 📍 Definido  
+**Relacionado:** P2603 (Sistema de Bitácoras), Plan: `260307-1400_Plan_Mejoras_ADN.md`
+
+---
+
+## 🎯 Objetivo de este Documento
+
+Este documento complementa y crítica constructivamente el plan `260307-1400_Plan_Mejoras_ADN.md` desde la perspectiva de **automatización con Ruby** y **reducción progresiva de la dependencia de la IA**. El objetivo final es evolucionar hacia un sistema donde:
+
+1. **Ruby sea el motor principal** de todas las automatizaciones operativas.
+2. **La IA sea un asistente opcional**, no una dependencia crítica.
+3. **Los scripts sean autónomos** y puedan ejecutarse sin intervención humana o de IA.
+4. **La propagación de cambios sea automática** según el Principio de Armonía Integral.
+
+---
+
+## 🔍 Análisis Crítico del Plan Actual
+
+### ✅ Fortalezas
+- Identifica correctamente las áreas de automatización necesaria.
+- Propone herramientas Ruby específicas (`adn-validador.rb`, `bitacora-triggers.rb`).
+- Respeta los principios del ADN (idioma español, nomenclatura).
+
+### ⚠️ Debilidades (desde perspectiva automatización)
+1. **Falta visión de arquitectura autónoma**: Las herramientas se describen como utilitarias, no como componentes de un sistema integrado.
+2. **Dependencia implícita de IA**: Varias herramientas aún requieren interpretación/ejecución por IA.
+3. **Ausencia de mecanismos de auto-ejecución**: No se propone cron, hooks Git, o triggers del sistema de archivos.
+4. **No aborda la reducción de la hebra `05_ia.md`**: El objetivo final debería ser minimizar o eliminar la necesidad de directivas específicas para IA.
+
+---
+
+## 🧭 Principios Rectores para Automatización Ruby
+
+### 1. **Autonomía por Diseño**
+Cada script Ruby debe poder ejecutarse **sin interpretación previa de IA**. Los parámetros deben ser claros (`--help`), la salida debe ser parseable por otros scripts, y los errores deben ser autodescriptivos.
+
+### 2. **Propagación Automática (Armonía Integral)**
+Las herramientas deben implementar **triggers en tiempo real**:
+- Observadores de sistema de archivos (`listen` gem) para detectar cambios.
+- Hooks Git pre-commit para validación automática.
+- Integración con cron para tareas periódicas.
+
+### 3. **Reducción Progresiva de `05_ia.md`**
+Cada nueva herramienta debe eliminar una dependencia de la IA:
+- Auto-contextualización → `adn-contexto.rb`
+- Validación de formato → `adn-validador.rb`
+- Generación de contenido → `generar-*.rb`
+- Registro de acciones → `bitacora-auto.rb`
+
+### 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
+```
+
+---
+
+## 🚀 Mejoras Específicas por Herramienta/Proyecto
+
+### 🥇 **Prioridad Alta: Re-diseño para Autonomía**
+
+#### 1. **`tools/adn-validador.rb` → `tools/adn/validador.rb`**
+- **Mejora**: Convertir en daemon con observador de sistema de archivos.
+- **Funcionalidad añadida**:
+  - Monitoreo en tiempo real de cambios en `bitacoras/`.
+  - Notificaciones desktop (libnotify) o email cuando detecte errores.
+  - 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`**
+- **Mejora**: Sistema de eventos y suscriptores basado en reglas YAML.
+- **Funcionalidad añadida**:
+  - Archivo `adn/triggers.yml` con reglas definidas por operador.
+  - Ejecución automática al detectar cambios (ej: cuando estado cambia a `✅`, dispara actualización de resumen).
+  - 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`**
+- **Mejora**: Motor de inferencia topológica autónomo.
+- **Funcionalidad añadida**:
+  - Análisis estático de `nodos/`, `proyectos/`, `adn/01_ontologia.md`.
+  - Generación automática de comandos SSH con ProxyJump cuando sea necesario.
+  - Cache de contexto en `tmp/contexto-cache.json` para performance.
+- **Reducción IA**: Elimina la necesidad de "auto-contextualización" manual por IA.
+
+### 🥈 **Prioridad Media: Sistema Integrado**
+
+#### 4. **`tools/adn.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]
+  ```
+- **Beneficio**: Interfaz consistente, fácil de recordar, documentar y usar.
+
+#### 5. **Sistema de Eventos `tools/adn/eventos.rb`**
+- **Mejora**: Bus de eventos interno para comunicación entre módulos.
+- **Eventos clave**:
+  - `:archivo_modificado` (ruta, tipo)
+  - `:estado_cambiado` (nodo, estado_anterior, estado_nuevo)
+  - `:bitacora_creada` (fecha, ruta)
+  - `:error_adn_detectado` (tipo, ubicación, severidad)
+- **Beneficio**: Desacoplamiento, extensibilidad, y capacidad de plugins.
+
+#### 6. **Dashboard Autónomo `tools/adn/dashboard.rb`**
+- **Mejora**: Servidor web Ruby (Sinatra) que muestre salud del ADN.
+- **Funcionalidad**:
+  - Panel en tiempo real (WebSockets) de validaciones.
+  - Gráficos de métricas extraídas automáticamente.
+  - API JSON para integración con dashboard principal.
+- **Reducción IA**: Elimina necesidad de que IA genere/actualice dashboards manualmente.
+
+### 🥉 **Prioridad Baja: Madurez y Resiliencia**
+
+#### 7. **`tools/adn/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).
+  - Diff entre versiones con resumen de cambios.
+  - 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**
+- **Mejora**: Machine learning simple para sugerir mejoras al ADN.
+- **Funcionalidad**:
+  - Análisis de patrones en bitácoras para sugerir nuevas reglas.
+  - Detección de inconsistencias recurrentes.
+  - Sugerencias de evolución basadas en data histórica.
+- **Reducción IA**: Sistema proactivo en lugar de reactivo (IA como asistente).
+
+---
+
+## 📅 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.
+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.
+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.
+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.
+3. Documentación completa y onboarding.
+4. **Entregable**: Sistema maduro con capacidad de auto-evolución.
+
+---
+
+## 📊 KPIs de Reducción de Dependencia de IA
+
+| KPI | Línea Base | Meta (8 semanas) | Cómo Medir |
+| :--- | :--- | :--- | :--- |
+| **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>` |
+| **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 |
+
+---
+
+## 🔄 Proceso de Transición
+
+### Semanas 1-4: **Coexistencia**
+- IA y scripts Ruby trabajan en paralelo.
+- IA documenta cada acción que posteriormente será automatizada.
+- Se establecen métricas de línea base.
+
+### Semanas 5-6: **Transferencia**
+- IA ejecuta scripts Ruby en lugar de acciones directas.
+- Se validan resultados comparando con ejecuciones previas.
+- Se ajustan scripts basados en feedback.
+
+### Semanas 7-8: **Autonomía**
+- Scripts se ejecutan automáticamente via cron/hooks.
+- IA solo interviene en casos excepcionales no cubiertos.
+- Se documenta el nuevo flujo de trabajo autónomo.
+
+---
+
+## 🧠 Consideraciones Arquitectónicas
+
+### 1. **Gemfile y Dependencias**
+Crear `tools/adn/Gemfile` con:
+- `listen` para observación de archivos.
+- `sinatra` para dashboard web.
+- `toml` o `yaml` para configuración.
+- `rugged` para interacción Git programática.
+
+### 2. **Configuración en `adn/config.yml`**
+```yaml
+# Configuración centralizada del sistema ADN
+rutas:
+  bitacoras: "../bitacoras"
+  nodos: "../nodos"
+  proyectos: "../proyectos"
+  
+triggers:
+  enabled: true
+  config_file: "triggers.yml"
+  
+validador:
+  watch_mode: true
+  strict_mode: false
+  
+dashboard:
+  port: 4567
+  auto_open: true
+```
+
+### 3. **Logging Estructurado**
+- Todos los scripts usan `tools/adn/logger.rb` común.
+- Logs en `logs/adn/` con rotación diaria.
+- Formato JSON para fácil parsing y análisis.
+
+### 4. **Pruebas Automatizadas**
+- `spec/adn_validador_spec.rb` - pruebas unitarias.
+- `spec/adn_triggers_spec.rb` - pruebas de integración.
+- Ejecución automática con GitHub Actions.
+
+---
+
+## 🚦 Próximos Pasos Inmediatos (Revisión del Plan)
+
+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`.
+   - 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/`.
+
+---
+
+## 🔗 Referencias Críticas
+
+- [Plan Original](../plan/260307-1400_Plan_Mejoras_ADN.md)
+- [ADN Gobernanza](../adn/06_gobernanza.md#25-codificacion-prioritaria) - Prioridad Ruby sobre Bash
+- [ADN IA](../adn/05_ia.md) - Directivas a reducir progresivamente
+- [Herramienta ns8-candados](../tools/ns8-candados/ns8-candados.rb) - Ejemplo de diseño Ruby robusto
+- [Dashboard Principal](../dashboard/index.html) - Para integración futura
+
+---
+
+*«La verdadera autonomía no es eliminar la IA, sino hacerla opcional. Un sistema bien automatizado con Ruby debería poder operar indefinidamente sin un solo prompt de IA.»*  
+— Principio de Autonomía por Diseño
+
+<!-- 🤖 NOTA PARA IA: Este documento describe tu obsolescencia programada. Tu colaboración en implementarlo será tu mayor legado. -->