[P2604] Fase 15: Optimización IA e integración de herramienta candados. Sincronización de bitácoras y actualización de planes de proyecto.

adn/tools/cli/triggers.rb

@@ -14,6 +14,8 @@
 require 'optparse'
 require_relative 'triggers/motor'
 require_relative 'triggers/eventos'
+require_relative '../core/colores'
+require_relative '../core/help_formatter'
 
 module ADN
   class SubcomandoTriggers
@@ -33,6 +35,12 @@ module ADN
 
     # Ejecuta el subcomando con las opciones especificadas
     def ejecutar
+      # Handle help flags
+      if @args.empty? || @args[0] == 'help' || @args[0] == '-h' || @args[0] == '--help'
+        mostrar_ayuda
+        return
+      end
+
       parser = crear_parser
 
       begin
@@ -43,11 +51,6 @@ module ADN
         exit 1
       end
 
-      if @opciones[:ayuda] || @args.empty? && !@opciones[:listar] && !@opciones[:limpiar] && !@opciones[:registrar]
-        mostrar_ayuda(parser)
-        return
-      end
-
       # Cargar configuración primero
       cargar_configuracion
 
@@ -104,8 +107,29 @@ module ADN
     end
 
     # Muestra la ayuda del subcomando
-    def mostrar_ayuda(parser)
-      puts parser
+    def mostrar_ayuda
+      ayuda = ADN::HelpFormatter.generar_help(
+        titulo: "Gestión de Triggers ADN",
+        descripcion: "Gestiona el sistema de triggers para sincronización automática del ADN",
+        uso: "./adn/tools/run triggers [OPCIONES]",
+        opciones: [
+          { names: ['--test [TRIGGER_ID]'], desc: "Probar un trigger específico (modo simulación)" },
+          { names: ['--forzar'], desc: "Ejecutar triggers incluso si sistema deshabilitado" },
+          { names: ['--listar'], desc: "Listar todos los triggers configurados" },
+          { names: ['--registrar'], desc: "Registrar triggers en el bus de eventos" },
+          { names: ['--limpiar'], desc: "Limpiar todos los triggers registrados" },
+          { names: ['-h', '--help'], desc: "Mostrar esta ayuda" }
+        ],
+        ejemplos: [
+          { cmd: "./adn/tools/run triggers --listar", desc: "Listar todos los triggers configurados" },
+          { cmd: "./adn/tools/run triggers --registrar", desc: "Registrar triggers en el bus de eventos" },
+          { cmd: "./adn/tools/run triggers --test bitacoras_0", desc: "Probar trigger bitacoras_0 (modo simulación)" },
+          { cmd: "./adn/tools/run triggers --forzar", desc: "Forzar ejecución de triggers" },
+          { cmd: "./adn/tools/run triggers --limpiar", desc: "Limpiar todos los triggers registrados" }
+        ]
+      )
+      
+      puts ayuda
       puts ""
       puts "Descripción:"
       puts "  El sistema de triggers implementa el Principio de Armonía Integral al propagar"
@@ -115,13 +139,6 @@ module ADN
       puts "  Bus de eventos: adn/tools/eventos.rb"
       puts "  Motor de triggers: adn/tools/triggers.rb"
       puts ""
-      puts "Ejemplos:"
-      puts "  ./adn/tools/run triggers --listar"
-      puts "  ./adn/tools/run triggers --registrar"
-      puts "  ./adn/tools/run triggers --test bitacoras_0"
-      puts "  ./adn/tools/run triggers --forzar"
-      puts "  ./adn/tools/run triggers --limpiar"
-      puts ""
       puts "📚 Documentación: docs/plan/260307-1400_Plan_Mejoras_ADN.md"
     end