rmonla/dtic-DIIAA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files
docs/bitacoras/_hist/2026-03-07.md
+1 -1
View File
@@ -22,7 +22,7 @@
| I | F | Descripción | E |
| :--- | :--- | :--- | :--- |
| 08:31 | 08:45 | Análisis de seguridad y corrección del flujo de backup. Implementación de `ns8-candados run`. | [R] ✅ |
| 08:45 | 13:00 | Relanzando backup mediante comando seguro `sshpass -e`. Reestructuración del CLI de ADN (`tools/adn/run`, subdirectorios `core`, `comando`, etc) para optimización del Contexto ADN. | [R] ✅ |
| 08:45 | 13:00 | Relanzando backup mediante comando seguro `sshpass -e`. Reestructuración del CLI de ADN (`adn/tools/run`, subdirectorios `core`, `comando`, etc) para optimización del Contexto ADN. | [R] ✅ |
| 13:00 | 16:00 | Ejecución Fase 1 Plan Integración BD: Implementación de Búsquedas PostgreSQL, Pruebas Unitarias Minitest con transacciones efímeras y Documentación de BD Automática (Tareas 2.2, 2.4, 2.5). | [R] ✅ |
---
docs/configuracion_bd.md
+3 -3
View File
@@ -27,7 +27,7 @@ La persistencia de nuestras bitácoras vive dentro de un contenedor dedicado.
```
## 3. Configuración de Credenciales CLI (`tools/config/database.yml`)
Las herramientas ADN alojadas en `tools/adn/run` delegaron su configuración al archivo maestro que se sitúa en `tools/config/database.yml`.
Las herramientas ADN alojadas en `adn/tools/run` delegaron su configuración al archivo maestro que se sitúa en `tools/config/database.yml`.
> [!IMPORTANT]
> El entorno de `development` se define por defecto e interactúa en el puerto `5433` usando credenciales locales (`dtic_user` / `dtic_pass_2026`).
@@ -48,7 +48,7 @@ Inmediatamente, la CLI redirigirá los accesos al nodo principal configurado.
La mejor forma de testear que todo se ha inicializado y configurado correctamente es utilizando el Reporte de Salud de la BD proporcionado por la consola ADN:
```bash
./tools/adn/run db salud:bd
./adn/tools/run db salud:bd
```
Si recibes el siguiente dictamen, el sistema funciona correctamente:
`✅ Conexión a PostgreSQL establecida`
@@ -57,5 +57,5 @@ Si recibes el siguiente dictamen, el sistema funciona correctamente:
Si estás desarrollando nuevas funcionalidades o has migrado el esquema, ejecuta el paquete `bitacora_db_test.rb` incluido para validar CRUD sin ensuciar la base de datos final. El sistema de tests encapsula todo el script dentro de comandos `BEGIN` / `ROLLBACK`.
```bash
ruby tools/adn/spec/bitacora_db_test.rb
ruby adn/tools/spec/bitacora_db_test.rb
```
docs/plan/adn/260307-0806_ArquitecturaADN.md
+6 -6
View File
@@ -1,6 +1,6 @@
# 🧬 Investigación: Arquitectura y Sincronía del ADN
Este documento detalla la relación técnica y conceptual entre el directorio de definiciones (`/adn`) y el motor de ejecución (`/tools/adn`) del ecosistema `srv-ns8`.
Este documento detalla la relación técnica y conceptual entre el directorio de definiciones (`/adn`) y el motor de ejecución (`/adn/tools`) del ecosistema `srv-ns8`.
---
@@ -13,7 +13,7 @@ El directorio `/adn` funciona como el **repositorio de la verdad** o la "Constit
---
## 2. El Directorio `/tools/adn`: El Motor (Ejecutable)
## 2. El Directorio `/adn/tools`: El Motor (Ejecutable)
Es el brazo ejecutable que procesa las definiciones del `/adn`. Está escrito íntegramente en **Ruby**, siguiendo la directiva de la hebra `06_gobernanza.md`.
### Componentes Clave:
@@ -27,7 +27,7 @@ Es el brazo ejecutable que procesa las definiciones del `/adn`. Está escrito í
## 3. Interrelación Simbiótica
La relación entre ambos directorios es de **Especificación ↔ Ejecución**:
| Aspecto | `/adn` (La Inteligencia) | `/tools/adn` (La Fuerza) |
| Aspecto | `/adn` (La Inteligencia) | `/adn/tools` (La Fuerza) |
| :--- | :--- | :--- |
| **Rol** | Define el "qué" y el "cómo". | Ejecuta el "cómo" y valida el "qué". |
| **Cambios** | Si se agrega un nuevo ícono en `04_iconografia.md`. | Se debe actualizar el `validador.rb` para reconocerlo. |
@@ -38,14 +38,14 @@ La relación entre ambos directorios es de **Especificación ↔ Ejecución**:
## 4. Flujo de Trabajo Típico
1. **Evento**: Un usuario o IA edita una bitácora en `/bitacoras`.
2. **Detección**: `tools/adn` detecta el cambio (vía hooks o ejecución manual).
2. **Detección**: `adn/tools` detecta el cambio (vía hooks o ejecución manual).
3. **Validación**: `validador.rb` lee las reglas de `/adn/02_bitacora.md` y verifica el archivo.
4. **Propagación**: Si el `triggers.yml` indica que un cambio de estado en la bitácora debe actualizar la ficha de un nodo en `/nodos`, `tools/adn/triggers.rb` realiza la escritura automáticamente.
4. **Propagación**: Si el `triggers.yml` indica que un cambio de estado en la bitácora debe actualizar la ficha de un nodo en `/nodos`, `adn/tools/triggers.rb` realiza la escritura automáticamente.
---
## 5. Conclusión de la Investigación
La arquitectura es **declarativa-operativa**. El sistema no depende de la "buena voluntad" del operador para mantener la coherencia (Armonía Integral), sino que utiliza `tools/adn` como una capa de software que garantiza que la realidad del repositorio coincida con la teoría definida en el `/adn`.
La arquitectura es **declarativa-operativa**. El sistema no depende de la "buena voluntad" del operador para mantener la coherencia (Armonía Integral), sino que utiliza `adn/tools` como una capa de software que garantiza que la realidad del repositorio coincida con la teoría definida en el `/adn`.
---
*Investigación realizada por el Asistente Antigravity - 2026-03-07*
docs/plan/adn/260307-1400_Plan_Mejoras_ADN.md
+38 -38
View File
@@ -10,7 +10,7 @@
El **ADN del proyecto** (conjunto de 7 hebras en `adn/`) constituye la fuente única de verdad que gobierna la operación, documentación y evolución del sistema `srv-ns8`. Este plan propone una **transformación hacia la autonomía completa** mediante:
1. **Arquitectura Ruby unificada**: Sistema integrado en `tools/adn/` con CLI única.
1. **Arquitectura Ruby unificada**: Sistema integrado en `adn/tools/` con CLI única.
2. **Reducción progresiva de dependencia de IA**: KPIs cuantificables para minimizar intervención de IA.
3. **Automatización end-to-end**: Observadores de archivos, hooks Git, triggers automáticos y cron.
4. **Propagación automática**: Implementación real del Principio de Armonía Integral.
@@ -22,7 +22,7 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
## 🎯 Objetivos Estratégicos
1. **Autonomía por Diseño**: Cada script Ruby debe ejecutarse sin interpretación previa de IA.
2. **Arquitectura Integrada**: Sistema unificado `tools/adn/` con CLI común y API coherente.
2. **Arquitectura Integrada**: Sistema unificado `adn/tools/` con CLI común y API coherente.
3. **Reducción Medible de Dependencia IA**: Disminuir acciones IA/día de 5-10 a <2 en 8 semanas.
4. **Propagación Automática (Armonía)**: Cambios en una hebra se propaguen automáticamente a dependientes.
5. **Validación Continua en Tiempo Real**: Observadores de archivos y hooks Git que validen cada cambio.
@@ -34,13 +34,13 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
| Hebra | Fortalezas | Oportunidades de Mejora (Visión Automatización) |
| :--- | :--- | :--- |
| **00_indice.md** | Visión clara de interconexiones. | Podría incluir mapa visual generado automáticamente por `tools/adn.rb mapa`. |
| **01_ontologia.md** | Topología completa y actualizada. | Actualización automática de estados de nodos via `tools/adn.rb ontologia --sync`. |
| **02_bitacora.md** | Triggers bien definidos. | Implementación automática via `tools/adn/triggers.rb` con reglas YAML. |
| **00_indice.md** | Visión clara de interconexiones. | Podría incluir mapa visual generado automáticamente por `adn/tools.rb mapa`. |
| **01_ontologia.md** | Topología completa y actualizada. | Actualización automática de estados de nodos via `adn/tools.rb ontologia --sync`. |
| **02_bitacora.md** | Triggers bien definidos. | Implementación automática via `adn/tools/triggers.rb` con reglas YAML. |
| **03_seguridad.md** | Bóveda robusta (`ns8-candados`). | Auditoría automática de uso de secretos y logs estructurados JSON. |
| **04_iconografia.md** | Taxonomía visual útil. | Extensión a dashboards automáticos generados por Sinatra. |
| **05_ia.md** | Fuente única de verdad clara. | **Reducción progresiva**: De referencia diaria a semanal, luego mensual. |
| **06_gobernanza.md** | Principios sólidos (Armonía, Evolución). | Proceso de evolución formal con CLI `tools/adn.rb evolucion`. |
| **06_gobernanza.md** | Principios sólidos (Armonía, Evolución). | Proceso de evolución formal con CLI `adn/tools.rb evolucion`. |
| **07_proyectos.md** | Modelo transversal efectivo. | Integración automática con bitácoras via sistema de eventos. |
---
@@ -49,11 +49,11 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
### 🥇 **Prioridad Alta: Núcleo Autónomo**
#### 1. **`tools/adn/` - Arquitectura Unificada**
#### 1. **`adn/tools/` - Arquitectura Unificada**
- **Problema**: Scripts Ruby dispersos sin interfaz común.
- **Solución**: Directorio estructurado con módulos integrados:
```
tools/adn/
adn/tools/
├── adn.rb # CLI principal
├── validador.rb # Validación en tiempo real
├── triggers.rb # Sistema de eventos YAML
@@ -66,24 +66,24 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
```
- **Reducción IA**: Elimina necesidad de interpretación de comandos dispersos.
#### 2. **`tools/adn.rb` - CLI Unificada**
#### 2. **`adn/tools.rb` - CLI Unificada**
- **Problema**: Múltiples comandos Ruby con interfaces inconsistentes.
- **Solución**: Interfaz única con subcomandos estandarizados:
```bash
ruby tools/adn.rb validador [--watch] [--fix] # Validación automática
ruby tools/adn.rb triggers [--test] [--force] # Ejecución triggers
ruby tools/adn.rb contexto <nodo> [--cmd] # Contexto automático
ruby tools/adn.rb evolucion <propuesta.md> # Gestión evolución
ruby tools/adn.rb salud [--dashboard] [--json] # Salud del ADN
ruby tools/adn.rb generar bitacora [fecha] # Generadores
ruby tools/adn.rb generar nodo <nombre> # Plantillas
ruby tools/adn.rb generar proyecto <codigo> # Manifiestos
ruby adn/tools.rb validador [--watch] [--fix] # Validación automática
ruby adn/tools.rb triggers [--test] [--force] # Ejecución triggers
ruby adn/tools.rb contexto <nodo> [--cmd] # Contexto automático
ruby adn/tools.rb evolucion <propuesta.md> # Gestión evolución
ruby adn/tools.rb salud [--dashboard] [--json] # Salud del ADN
ruby adn/tools.rb generar bitacora [fecha] # Generadores
ruby adn/tools.rb generar nodo <nombre> # Plantillas
ruby adn/tools.rb generar proyecto <codigo> # Manifiestos
```
- **Beneficio**: Interfaz coherente, fácil de documentar y usar sin IA.
#### 3. **Validación en Tiempo Real con Hooks Git**
- **Problema**: Validación manual o por IA de cumplimiento del ADN.
- **Solución**: `tools/adn/validador.rb` con:
- **Solución**: `adn/tools/validador.rb` con:
- Observador de sistema de archivos (`listen` gem) para `bitacoras/`.
- Hook Git pre-commit que rechace commits con errores de formato.
- Notificaciones desktop/libnotify cuando detecte inconsistencias.
@@ -93,7 +93,7 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
#### 4. **Sistema de Triggers Basado en YAML**
- **Problema**: Triggers de `02_bitacora.md` implementados manualmente.
- **Solución**: `tools/adn/triggers.rb` con reglas en `adn/triggers.yml`:
- **Solución**: `adn/tools/triggers.rb` con reglas en `adn/triggers.yml`:
```yaml
- evento: "estado_cambiado"
condicion: "estado_nuevo == '✅'"
@@ -106,7 +106,7 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
#### 5. **Motor de Contexto Automático**
- **Problema**: IA debe "auto-contextualizarse" manualmente antes de operar.
- **Solución**: `tools/adn/contexto.rb` que:
- **Solución**: `adn/tools/contexto.rb` que:
- Analiza estáticamente `nodos/`, `proyectos/`, `adn/01_ontologia.md`.
- Determina topología de red y requisitos de acceso.
- Genera comandos SSH con ProxyJump cuando sea necesario.
@@ -115,7 +115,7 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
#### 6. **Dashboard Autónomo Sinatra**
- **Problema**: Dashboard requiere actualización manual o por IA.
- **Solución**: `tools/adn/dashboard.rb` - Servidor web Ruby con:
- **Solución**: `adn/tools/dashboard.rb` - Servidor web Ruby con:
- Panel en tiempo real (WebSockets) de validaciones.
- Gráficos de métricas extraídas automáticamente de bitácoras.
- API JSON para integración con dashboard principal.
@@ -125,7 +125,7 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
#### 7. **Versionado Semántico del ADN**
- **Problema**: Backup del ADN limitado a Git, sin versionado específico.
- **Solución**: `tools/adn/backup.rb` con:
- **Solución**: `adn/tools/backup.rb` con:
- Versiones semánticas: `adn-1.2.3.tar.gz` (major.features.fixes).
- Diff entre versiones con resumen de cambios.
- Integración con `dtic-BKPs` para almacenamiento cifrado.
@@ -133,7 +133,7 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
#### 8. **Sistema de Recomendaciones Automáticas**
- **Problema**: Evolución del ADN reactiva en lugar de proactiva.
- **Solución**: `tools/adn/aprendizaje.rb` con:
- **Solución**: `adn/tools/aprendizaje.rb` con:
- 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.
@@ -144,29 +144,29 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
## 📅 Plan de Implementación (8 semanas - 4 Fases)
### **Fase 1: Núcleo Autónomo (Semanas 1-2)**
1. **`tools/adn/`** - Estructura de directorios y `Gemfile` con dependencias.
2. **`tools/adn.rb`** - CLI unificada con subcomandos básicos.
3. **`tools/adn/validador.rb`** - Validador en tiempo real con hooks Git.
4. **`tools/adn/logger.rb`** - Logging estructurado JSON en `logs/adn/`.
1. **`adn/tools/`** - Estructura de directorios y `Gemfile` con dependencias.
2. **`adn/tools.rb`** - CLI unificada con subcomandos básicos.
3. **`adn/tools/validador.rb`** - Validador en tiempo real con hooks Git.
4. **`adn/tools/logger.rb`** - Logging estructurado JSON en `logs/adn/`.
5. **`adn/config.yml`** - Configuración centralizada.
6. **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. **`tools/adn/eventos.rb`** - Bus de eventos interno.
1. **`adn/tools/triggers.rb`** - Sistema de eventos basado en YAML.
2. **`adn/tools/contexto.rb`** - Motor de inferencia topológica.
3. **`adn/tools/eventos.rb`** - Bus de eventos interno.
4. **Integración con cron** - Tareas periódicas de validación y sync.
5. **Entregable**: Triggers automáticos operativos sin intervención IA.
### **Fase 3: Sistema Integrado (Semanas 5-6)**
1. **`tools/adn/dashboard.rb`** - Servidor web Sinatra (puerto 4567).
1. **`adn/tools/dashboard.rb`** - Servidor web Sinatra (puerto 4567).
2. **API JSON** para integración con dashboard principal.
3. **`tools/adn/backup.rb`** - Sistema de versionado semántico.
3. **`adn/tools/backup.rb`** - Sistema de versionado semántico.
4. **Especificaciones** - Pruebas unitarias en `spec/adn_*_spec.rb`.
5. **Entregable**: Dashboard autónomo en tiempo real.
### **Fase 4: Madurez y Evolución (Semanas 7-8)**
1. **`tools/adn/aprendizaje.rb`** - Sistema de recomendaciones.
1. **`adn/tools/aprendizaje.rb`** - Sistema de recomendaciones.
2. **Documentación completa** - `docs/adn/automatizacion.md`.
3. **Onboarding** - `docs/onboarding/primero-60-minutos.md`.
4. **Revisión y refinamiento** basado en feedback operativo.
@@ -179,8 +179,8 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
### KPIs de Autonomía Operativa
| KPI | Línea Base | Meta (8 semanas) | Cómo Medir |
| :--- | :--- | :--- | :--- |
| **Tiempo creación bitácora** | 10-15 min | < 2 min | `time ruby tools/adn.rb generar bitacora` |
| **Errores formato en bitácoras** | 2-3 por semana | 0 por semana | Reporte `tools/adn.rb validador --stats` |
| **Tiempo creación bitácora** | 10-15 min | < 2 min | `time ruby adn/tools.rb generar bitacora` |
| **Errores formato en bitácoras** | 2-3 por semana | 0 por semana | Reporte `adn/tools.rb validador --stats` |
| **Consistencia entre hebras** | Manual | Automatizada 95%+ | Validación cruzada automática |
| **Cobertura triggers automáticos** | 0% | 90% | % de triggers en `02_bitacora.md` implementados |
@@ -190,7 +190,7 @@ El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo pro
| **Acciones IA en bitácoras/día** | 5-10 | < 2 | Conteo de "(IA)" en bitácoras diarias |
| **Uso `05_ia.md` como referencia** | Diario | Semanal | Frecuencia de consulta a la hebra |
| **Scripts ejecutados sin IA** | 40% | 85% | Comandos ejecutados directamente vs via IA |
| **Tiempo auto-contextualización** | 2-3 min | < 30 seg | `time ruby tools/adn.rb contexto <nodo>` |
| **Tiempo 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 |
---
@@ -243,9 +243,9 @@ Respetar y fortalecer la directiva de `06_gobernanza.md#25-codificacion-priorita
1. **[ ] Presentar este plan actualizado** en la bitácora `2026-03-07.md`.
2. **[ ] Crear ticket en P2603**: "Automatización Ruby del ADN - Fase 1".
3. **[ ] Iniciar Fase 1**: Crear estructura básica de `tools/adn/`.
3. **[ ] Iniciar Fase 1**: Crear estructura básica de `adn/tools/`.
```bash
mkdir -p tools/adn logs/adn spec
mkdir -p adn/tools logs/adn spec
```
4. **[ ] Configurar hook Git pre-commit** con validación básica.
5. **[ ] Establecer reunión de revisión** en 7 días (14/03/2026).
docs/plan/adn/260307-1430_Sugerencias_Mejoras_ADN_Automatizacion.md
+29 -29
View File
@@ -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/`.
---
docs/plan/adn/260308-1200_Plan_Integral_ADN_BITACORAs.md
+1 -1
View File
@@ -29,7 +29,7 @@ Este plan establece la integración completa del sistema ADN (actualmente basado
---
## 🔄 Reutilización de Herramientas Existentes (`tools/adn/`)
## 🔄 Reutilización de Herramientas Existentes (`adn/tools/`)
### Componentes Directamente Reutilizables
- [ ] **CLI Framework** (`adn.rb`) - Extensible para comandos de BD
docs/proyectos/_hist/P2605_Migracion_Solo_Bitacoras_Web.md
+8 -8
View File
@@ -69,20 +69,20 @@ Asegurar que no se perdió nada en la transición.
```
# Flujo diario (DB-First)
./tools/adn/run inicio de jornada presencial|remoto
./tools/adn/run cierre de jornada presencial|remoto
./adn/tools/run inicio de jornada presencial|remoto
./adn/tools/run cierre de jornada presencial|remoto
# Importar MD existente → DB
./tools/adn/run db migrar:md FECHA [--sobrescribir]
./tools/adn/run db migrar:md --todo [--sobrescribir]
./adn/tools/run db migrar:md FECHA [--sobrescribir]
./adn/tools/run db migrar:md --todo [--sobrescribir]
# Exportar DB → MD (respaldo)
./tools/adn/run db exportar:md FECHA
./tools/adn/run db exportar:md --todo
./adn/tools/run db exportar:md FECHA
./adn/tools/run db exportar:md --todo
# Auditoría
./tools/adn/run db verificar
./tools/adn/run db estadisticas
./adn/tools/run db verificar
./adn/tools/run db estadisticas
```
---