[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/nodos.rb

@@ -49,31 +49,24 @@ module ADN
     private
 
     def mostrar_ayuda
-      puts <<~AYUDA
-        #{Color::CYAN}🖥️  Gestión de Nodos#{Color::RESET}
-
-        #{Color::YELLOW}Uso:#{Color::RESET} ./adn/tools/run nodos <acción> [opciones]
-
-        #{Color::YELLOW}Acciones:#{Color::RESET}
-          info    <nodo>              Mostrar metadata completa de un nodo
-          agrupar [--servidor SRV]    Agrupar VMs por servidor anfitrión
-          listar  [--tipo TIPO]       Listar todos los nodos (fichas .md)
-          buscar  <término>           Buscar nodos por nombre o contenido
-
-        #{Color::YELLOW}Opciones de 'agrupar':#{Color::RESET}
-          --servidor SRV              Filtrar solo VMs de un servidor específico
-
-        #{Color::YELLOW}Opciones de 'listar':#{Color::RESET}
-          --tipo TIPO                 Filtrar por prefijo (srv, srvv, pcv, pc, cam, dc, sql)
-
-        #{Color::YELLOW}Ejemplos:#{Color::RESET}
-          ./adn/tools/run nodos info srv-dasu
-          ./adn/tools/run nodos agrupar
-          ./adn/tools/run nodos agrupar --servidor srv-pmox1
-          ./adn/tools/run nodos listar
-          ./adn/tools/run nodos listar --tipo srvv
-          ./adn/tools/run nodos buscar dasuten
-      AYUDA
+      ayuda = ADN::HelpFormatter.generar_help(
+        titulo: "Gestión de Nodos",
+        descripcion: "Gestión y consulta de nodos de infraestructura",
+        uso: "./adn/tools/run nodos <acción> [opciones]",
+        opciones: [
+          { names: ['agrupar [--servidor SRV]'], desc: "Agrupar VMs por servidor anfitrión" },
+          { names: ['listar [--tipo TIPO]'], desc: "Listar fichas de nodos (.md)" },
+          { names: ['buscar <término>'], desc: "Buscar nodos por nombre o contenido" }
+        ],
+        ejemplos: [
+          { cmd: "./adn/tools/run nodos agrupar", desc: "Agrupar todos los VMs por servidor" },
+          { cmd: "./adn/tools/run nodos agrupar --servidor srv-pmox1", desc: "Agrupar VMs del servidor srv-pmox1" },
+          { cmd: "./adn/tools/run nodos listar --tipo srvv", desc: "Listar nodos de tipo srvv" },
+          { cmd: "./adn/tools/run nodos buscar dasuten", desc: "Buscar nodos relacionados con dasuten" }
+        ]
+      )
+      
+      puts ayuda
     end
     # ─── Info ───────────────────────────────────────────────────────────