legionio 1.5.19 → 1.5.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb76821fb4802e78a19c4518c18f32a961a144cd96f0ef146ce0b582ef96f699
-  data.tar.gz: c9c6eb50bef1df98a3ede6ce943e4a45a9dc4c638ce682519708d3d0008eddd5
+  metadata.gz: dc118d8800708d94fc279455bd379cda4f159cc535b6af290997aacf311765bb
+  data.tar.gz: b144e6d8fa85659d6a929f427c611ddd5e5288bfce404eeb11b41bfe1f85d82f
 SHA512:
-  metadata.gz: 2e502641a0f4177baeab32e78b839f80fa163953fe55770cd0a31364b352b5eda156e0971e67057ad5263160cc5f874b7cdbfdafc1a7cc9799fdd7a9ebd73a65
-  data.tar.gz: 90ec056445d835e01d044dd1ca6272c7e30ef5cffa0e30c39d93d4c2e8004f0e4d3ff59d83e12753bc485484a68a2526e90ebe1ccfdd1fb39e12b89e549d01d1
+  metadata.gz: ba5b7bfc06588c0a8f3e6e5d123e481a847e72614e76bb312b3dbf78bec3f55d56c539fd501db189a6827ab81a36716377084c8419a11548c5a1463fa4fe5dc8
+  data.tar.gz: 35580f0a9895e93c225fe596a02379f57a21669e67b2485805beb37ec9082c4098302b6dfb465ec5f21f06d9265e0bc103dd882ec68377e8f4e4ce2d891c3d59

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Legion Changelog
 
+## [1.5.22] - 2026-03-26
+
+### Changed
+- Consolidate 48 root CLI commands into 7 groups + 19 root commands
+- New groups: `ai`, `git`, `pipeline`, `ops`, `serve`, `admin`, `dev`
+- `ai`: chat, llm, gaia, apollo, knowledge, memory, mind-growth, swarm, plan, trace
+- `git`: commit, pr, review
+- `pipeline`: skill, prompt, eval, dataset, image, notebook
+- `ops`: telemetry, observe, detect, cost, payroll, audit, debug, failover
+- `serve`: mcp, acp
+- `admin`: rbac, auth, worker, team
+- `dev`: generate, docs, openapi, completion, marketplace, features
+- Root keepers: start, stop, status, version, check, doctor, setup, update, config, init, lex, task, chain, schedule, coldstart, tty, do, ask, dream, tree
+
+## [1.5.21] - 2026-03-26
+
+### Changed
+- `legionio setup agentic` now installs the full cognitive stack (63 gems): core libs, all agentic domains, all AI providers, and key operational extensions
+- Added `brains` and `give-me-all-the-brains` as aliases for the `agentic` subcommand
+
+## [1.5.20] - 2026-03-26
+
+### Added
+- `legion knowledge health` — local/Apollo/sync health report
+- `legion knowledge maintain` — orphan chunk detection and cleanup (dry-run by default)
+- `legion knowledge quality` — hot/cold/low-confidence chunk quality report
+
 ## [1.5.19] - 2026-03-26
 
 ### Added

data/lib/legion/cli/groups/admin_group.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    module Groups
+      class Admin < Thor
+        namespace 'admin'
+
+        def self.exit_on_failure?
+          true
+        end
+
+        desc 'rbac SUBCOMMAND', 'Role-based access control management'
+        subcommand 'rbac', Legion::CLI::Rbac
+
+        desc 'auth SUBCOMMAND', 'Authenticate with external services'
+        subcommand 'auth', Legion::CLI::Auth
+
+        desc 'worker SUBCOMMAND', 'Manage digital workers'
+        subcommand 'worker', Legion::CLI::Worker
+
+        desc 'team SUBCOMMAND', 'Team and multi-user management'
+        subcommand 'team', Legion::CLI::Team
+      end
+    end
+  end
+end

data/lib/legion/cli/groups/ai_group.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    module Groups
+      class Ai < Thor
+        namespace 'ai'
+
+        def self.exit_on_failure?
+          true
+        end
+
+        desc 'chat SUBCOMMAND', 'Interactive AI conversation'
+        subcommand 'chat', Legion::CLI::Chat
+
+        desc 'llm SUBCOMMAND', 'LLM provider diagnostics (status, ping, models)'
+        subcommand 'llm', Legion::CLI::Llm
+
+        desc 'gaia SUBCOMMAND', 'GAIA cognitive coordination'
+        subcommand 'gaia', Legion::CLI::Gaia
+
+        desc 'apollo SUBCOMMAND', 'Apollo knowledge graph'
+        subcommand 'apollo', Legion::CLI::Apollo
+
+        desc 'knowledge SUBCOMMAND', 'Search and manage the document knowledge base'
+        subcommand 'knowledge', Legion::CLI::Knowledge
+
+        desc 'memory SUBCOMMAND', 'Persistent project memory across sessions'
+        subcommand 'memory', Legion::CLI::Memory
+
+        desc 'mind-growth SUBCOMMAND', 'Autonomous cognitive architecture expansion'
+        subcommand 'mind-growth', Legion::CLI::MindGrowth
+
+        desc 'swarm SUBCOMMAND', 'Multi-agent swarm orchestration'
+        subcommand 'swarm', Legion::CLI::Swarm
+
+        desc 'plan', 'Start plan mode (read-only exploration, no writes)'
+        subcommand 'plan', Legion::CLI::Plan
+
+        desc 'trace SUBCOMMAND', 'Natural language trace search via LLM'
+        subcommand 'trace', Legion::CLI::TraceCommand
+      end
+    end
+  end
+end

data/lib/legion/cli/groups/dev_group.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    module Groups
+      class Dev < Thor
+        namespace 'dev'
+
+        def self.exit_on_failure?
+          true
+        end
+
+        desc 'generate SUBCOMMAND', 'Code generators for LEX components'
+        map 'g' => :generate
+        subcommand 'generate', Legion::CLI::Generate
+
+        desc 'docs SUBCOMMAND', 'Documentation site generator'
+        subcommand 'docs', Legion::CLI::Docs
+
+        desc 'openapi SUBCOMMAND', 'OpenAPI spec generation'
+        subcommand 'openapi', Legion::CLI::Openapi
+
+        desc 'completion SUBCOMMAND', 'Shell tab completion scripts'
+        subcommand 'completion', Legion::CLI::Completion
+
+        desc 'marketplace', 'Extension marketplace (search, info, scan)'
+        subcommand 'marketplace', Legion::CLI::Marketplace
+
+        desc 'features SUBCOMMAND', 'Install feature bundles (interactive selector)'
+        subcommand 'features', Legion::CLI::Features
+      end
+    end
+  end
+end

data/lib/legion/cli/groups/git_group.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    module Groups
+      class Git < Thor
+        namespace 'git'
+
+        def self.exit_on_failure?
+          true
+        end
+
+        desc 'commit', 'Generate AI commit message from staged changes'
+        subcommand 'commit', Legion::CLI::Commit
+
+        desc 'pr', 'Create pull request with AI-generated title and description'
+        subcommand 'pr', Legion::CLI::Pr
+
+        desc 'review', 'AI code review of changes'
+        subcommand 'review', Legion::CLI::Review
+      end
+    end
+  end
+end

data/lib/legion/cli/groups/ops_group.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    module Groups
+      class Ops < Thor
+        namespace 'ops'
+
+        def self.exit_on_failure?
+          true
+        end
+
+        desc 'telemetry SUBCOMMAND', 'Session log analytics and telemetry'
+        subcommand 'telemetry', Legion::CLI::Telemetry
+
+        desc 'observe SUBCOMMAND', 'MCP tool observation stats'
+        subcommand 'observe', Legion::CLI::ObserveCommand
+
+        desc 'detect', 'Scan environment and recommend extensions'
+        subcommand 'detect', Legion::CLI::Detect
+
+        desc 'cost', 'Cost visibility and reporting'
+        subcommand 'cost', Legion::CLI::Cost
+
+        desc 'payroll SUBCOMMAND', 'Workforce cost and labor economics'
+        subcommand 'payroll', Legion::CLI::Payroll
+
+        desc 'audit SUBCOMMAND', 'Audit log inspection and verification'
+        subcommand 'audit', Legion::CLI::Audit
+
+        desc 'debug', 'Diagnostic dump for troubleshooting (pipe to LLM for analysis)'
+        subcommand 'debug', Legion::CLI::Debug
+
+        desc 'failover SUBCOMMAND', 'Region failover management'
+        subcommand 'failover', Legion::CLI::Failover
+      end
+    end
+  end
+end

data/lib/legion/cli/groups/pipeline_group.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    module Groups
+      class Pipeline < Thor
+        namespace 'pipeline'
+
+        def self.exit_on_failure?
+          true
+        end
+
+        desc 'skill', 'Manage skills (.legion/skills/ markdown files)'
+        subcommand 'skill', Legion::CLI::Skill
+
+        desc 'prompt SUBCOMMAND', 'Manage versioned LLM prompt templates'
+        subcommand 'prompt', Legion::CLI::Prompt
+
+        desc 'eval SUBCOMMAND', 'Eval gating and experiment management'
+        subcommand 'eval', Legion::CLI::Eval
+
+        desc 'dataset SUBCOMMAND', 'Manage versioned datasets'
+        subcommand 'dataset', Legion::CLI::Dataset
+
+        desc 'image SUBCOMMAND', 'Multimodal image analysis and comparison'
+        subcommand 'image', Legion::CLI::Image
+
+        desc 'notebook', 'Read and export Jupyter notebooks'
+        subcommand 'notebook', Legion::CLI::Notebook
+      end
+    end
+  end
+end

data/lib/legion/cli/groups/serve_group.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    module Groups
+      class Serve < Thor
+        namespace 'serve'
+
+        def self.exit_on_failure?
+          true
+        end
+
+        desc 'mcp SUBCOMMAND', 'Start MCP server for AI agent integration'
+        subcommand 'mcp', Legion::CLI::Mcp
+
+        desc 'acp SUBCOMMAND', 'Start ACP agent for editor integration'
+        subcommand 'acp', Legion::CLI::Acp
+      end
+    end
+  end
+end

data/lib/legion/cli/knowledge_command.rb

@@ -91,7 +91,77 @@ module Legion
         end
       end
 
-      no_commands do
+      desc 'health', 'Show knowledge base health report (local, Apollo, sync)'
+      option :corpus_path, type: :string, desc: 'Path to corpus directory (falls back to settings)'
+      def health
+        require_maintenance!
+        path = resolve_corpus_path
+        result = knowledge_maintenance.health(path: path)
+        out = formatter
+        if options[:json]
+          out.json(result)
+        elsif result[:success]
+          out.header('Knowledge Health')
+          out.spacer
+          out.header('Local')
+          out.detail(result[:local])
+          out.spacer
+          out.header('Apollo')
+          out.detail(result[:apollo])
+          out.spacer
+          out.header('Sync')
+          out.detail(result[:sync])
+        else
+          out.warn("Health check failed: #{result[:error]}")
+        end
+      end
+
+      desc 'maintain', 'Detect and clean up orphaned knowledge chunks'
+      option :corpus_path, type: :string, desc: 'Path to corpus directory (falls back to settings)'
+      option :dry_run, type: :boolean, default: true, desc: 'Preview without archiving (default: true)'
+      def maintain
+        require_maintenance!
+        path = resolve_corpus_path
+        result = knowledge_maintenance.cleanup_orphans(path: path, dry_run: options[:dry_run])
+        out = formatter
+        if options[:json]
+          out.json(result)
+        elsif result[:success]
+          out.header("Knowledge Maintain#{' (dry run)' if options[:dry_run]}")
+          out.detail({
+                       'Orphan files'  => (result[:orphan_files] || []).join(', '),
+                       'Archived'      => result[:archived].to_s,
+                       'Files cleaned' => result[:files_cleaned].to_s,
+                       'Dry run'       => result[:dry_run].to_s
+                     })
+        else
+          out.warn("Maintenance failed: #{result[:error]}")
+        end
+      end
+
+      desc 'quality', 'Show knowledge quality report (hot, cold, low-confidence chunks)'
+      option :limit, type: :numeric, default: 10, desc: 'Max entries per category'
+      def quality
+        require_maintenance!
+        result = knowledge_maintenance.quality_report(limit: options[:limit])
+        out = formatter
+        if options[:json]
+          out.json(result)
+        elsif result[:success]
+          out.header('Knowledge Quality Report')
+          out.spacer
+          print_chunk_section('Hot Chunks (most accessed)', result[:hot_chunks], out)
+          print_chunk_section('Cold Chunks (never accessed)', result[:cold_chunks], out)
+          print_chunk_section('Low Confidence', result[:low_confidence], out)
+          out.spacer
+          out.header('Summary')
+          out.detail(result[:summary])
+        else
+          out.warn("Quality report failed: #{result[:error]}")
+        end
+      end
+
+      no_commands do # rubocop:disable Metrics/BlockLength
         def formatter
           @formatter ||= Output::Formatter.new(json: options[:json], color: !options[:no_color])
         end
@@ -108,6 +178,12 @@ module Legion
           raise CLI::Error, 'lex-knowledge extension is not loaded. Install and enable it first.'
         end
 
+        def require_maintenance!
+          return if defined?(Legion::Extensions::Knowledge::Runners::Maintenance)
+
+          raise CLI::Error, 'lex-knowledge extension is not loaded. Install and enable it first.'
+        end
+
         def knowledge_query
           Legion::Extensions::Knowledge::Runners::Query
         end
@@ -116,6 +192,20 @@ module Legion
           Legion::Extensions::Knowledge::Runners::Ingest
         end
 
+        def knowledge_maintenance
+          Legion::Extensions::Knowledge::Runners::Maintenance
+        end
+
+        def resolve_corpus_path
+          if options[:corpus_path]
+            options[:corpus_path]
+          elsif defined?(Legion::Settings)
+            Legion::Settings.dig(:knowledge, :corpus_path) || ::Dir.pwd
+          else
+            ::Dir.pwd
+          end
+        end
+
         def print_sources(sources, out, verbose:)
           return out.warn('No sources found') if sources.empty?
 
@@ -128,6 +218,18 @@ module Legion
           end
         end
 
+        def print_chunk_section(title, chunks, out)
+          out.header(title)
+          if chunks.empty?
+            out.warn('  (none)')
+          else
+            chunks.each do |c|
+              puts "  id=#{c[:id]}  confidence=#{c[:confidence]}  #{c[:source_file]}"
+            end
+          end
+          out.spacer
+        end
+
         def truncate(text, max)
           return text if text.length <= max
           return text[0, max] if max < 4

data/lib/legion/cli/setup_command.rb

@@ -27,8 +27,24 @@ module Legion
 
       PACKS = {
         agentic:  {
-          description: 'Full cognitive stack: GAIA + LLM + MCP + Apollo',
-          gems:        %w[legion-gaia legion-llm]
+          description: 'Full cognitive stack: core libs, agentic domains, AI providers, and operational extensions',
+          gems:        %w[
+            legion-apollo legion-gaia legion-llm legion-mcp legion-rbac
+            lex-acp lex-adapter lex-agentic-affect lex-agentic-attention
+            lex-agentic-defense lex-agentic-executive lex-agentic-homeostasis
+            lex-agentic-imagination lex-agentic-inference lex-agentic-integration
+            lex-agentic-language lex-agentic-learning lex-agentic-memory
+            lex-agentic-self lex-agentic-social lex-apollo lex-audit lex-autofix
+            lex-azure-ai lex-bedrock lex-claude lex-codegen lex-coldstart
+            lex-conditioner lex-cortex lex-cost-scanner lex-dataset lex-detect
+            lex-eval lex-exec lex-extinction lex-factory lex-finops lex-foundry
+            lex-gemini lex-governance lex-kerberos lex-knowledge lex-llm-gateway
+            lex-metering lex-mesh lex-microsoft_teams lex-mind-growth lex-node
+            lex-onboard lex-openai lex-pilot-infra-monitor
+            lex-pilot-knowledge-assist lex-privatecore lex-prompt lex-react
+            lex-swarm lex-swarm-github lex-synapse lex-telemetry lex-tick
+            lex-transformer lex-xai
+          ]
         },
         llm:      {
           description: 'LLM routing and provider integration (no cognitive stack)',
@@ -114,6 +130,8 @@ module Legion
       def agentic
         install_pack(:agentic)
       end
+      map 'give-me-all-the-brains' => :agentic
+      map 'brains' => :agentic
 
       desc 'llm', 'Install LLM routing and provider integration'
       option :dry_run, type: :boolean, default: false, desc: 'Show what would be installed without installing'

data/lib/legion/cli.rb

@@ -65,6 +65,16 @@ module Legion
     autoload :Features,     'legion/cli/features_command'
     autoload :Debug,        'legion/cli/debug_command'
 
+    module Groups
+      autoload :Ai,       'legion/cli/groups/ai_group'
+      autoload :Git,      'legion/cli/groups/git_group'
+      autoload :Pipeline, 'legion/cli/groups/pipeline_group'
+      autoload :Ops,      'legion/cli/groups/ops_group'
+      autoload :Serve,    'legion/cli/groups/serve_group'
+      autoload :Admin,    'legion/cli/groups/admin_group'
+      autoload :Dev,      'legion/cli/groups/dev_group'
+    end
+
     class Main < Thor
       def self.exit_on_failure?
         true
@@ -199,6 +209,7 @@ module Legion
         exit(exit_code) if exit_code != 0
       end
 
+      # --- Core framework ---
       desc 'lex SUBCOMMAND', 'Manage Legion extensions (LEXs)'
       subcommand 'lex', Legion::CLI::Lex
 
@@ -211,81 +222,18 @@ module Legion
       desc 'config SUBCOMMAND', 'View and validate configuration'
       subcommand 'config', Legion::CLI::Config
 
-      desc 'generate SUBCOMMAND', 'Code generators for LEX components'
-      map 'g' => :generate
-      subcommand 'generate', Legion::CLI::Generate
-
-      desc 'acp SUBCOMMAND', 'Start ACP agent for editor integration'
-      subcommand 'acp', Legion::CLI::Acp
-
-      desc 'mcp SUBCOMMAND', 'Start MCP server for AI agent integration'
-      subcommand 'mcp', Legion::CLI::Mcp
-
-      desc 'worker SUBCOMMAND', 'Manage digital workers'
-      subcommand 'worker', Legion::CLI::Worker
-
-      desc 'coldstart SUBCOMMAND', 'Cold start bootstrap and Claude memory ingestion'
-      subcommand 'coldstart', Legion::CLI::Coldstart
-
-      desc 'chat SUBCOMMAND', 'Interactive AI conversation'
-      subcommand 'chat', Legion::CLI::Chat
-
-      desc 'commit', 'Generate AI commit message from staged changes'
-      subcommand 'commit', Legion::CLI::Commit
-
-      desc 'pr', 'Create pull request with AI-generated title and description'
-      subcommand 'pr', Legion::CLI::Pr
-
-      desc 'review', 'AI code review of changes'
-      subcommand 'review', Legion::CLI::Review
-
-      desc 'memory SUBCOMMAND', 'Persistent project memory across sessions'
-      subcommand 'memory', Legion::CLI::Memory
-
-      desc 'mind-growth SUBCOMMAND', 'Autonomous cognitive architecture expansion'
-      subcommand 'mind-growth', Legion::CLI::MindGrowth
-
-      desc 'plan', 'Start plan mode (read-only exploration, no writes)'
-      subcommand 'plan', Legion::CLI::Plan
-
-      desc 'swarm SUBCOMMAND', 'Multi-agent swarm orchestration'
-      subcommand 'swarm', Legion::CLI::Swarm
-
-      desc 'gaia SUBCOMMAND', 'GAIA cognitive coordination'
-      subcommand 'gaia', Legion::CLI::Gaia
-
-      desc 'apollo SUBCOMMAND', 'Apollo knowledge graph'
-      subcommand 'apollo', Legion::CLI::Apollo
-
-      desc 'knowledge SUBCOMMAND', 'Search and manage the document knowledge base'
-      subcommand 'knowledge', Legion::CLI::Knowledge
-
       desc 'schedule SUBCOMMAND', 'Manage schedules'
       subcommand 'schedule', Legion::CLI::Schedule
 
-      desc 'completion SUBCOMMAND', 'Shell tab completion scripts'
-      subcommand 'completion', Legion::CLI::Completion
-
-      desc 'openapi SUBCOMMAND', 'OpenAPI spec generation'
-      subcommand 'openapi', Legion::CLI::Openapi
+      desc 'coldstart SUBCOMMAND', 'Cold start bootstrap and Claude memory ingestion'
+      subcommand 'coldstart', Legion::CLI::Coldstart
 
+      # --- Health & maintenance ---
       desc 'doctor', 'Diagnose environment and suggest fixes'
       subcommand 'doctor', Legion::CLI::Doctor
 
-      desc 'telemetry SUBCOMMAND', 'Session log analytics and telemetry'
-      subcommand 'telemetry', Legion::CLI::Telemetry
-
-      desc 'auth SUBCOMMAND', 'Authenticate with external services'
-      subcommand 'auth', Legion::CLI::Auth
-
-      desc 'rbac SUBCOMMAND', 'Role-based access control management'
-      subcommand 'rbac', Legion::CLI::Rbac
-
-      desc 'audit SUBCOMMAND', 'Audit log inspection and verification'
-      subcommand 'audit', Legion::CLI::Audit
-
-      desc 'detect', 'Scan environment and recommend extensions'
-      subcommand 'detect', Legion::CLI::Detect
+      desc 'setup SUBCOMMAND', 'Install feature packs and configure IDE integrations'
+      subcommand 'setup', Legion::CLI::Setup
 
       desc 'update', 'Update Legion gems to latest versions'
       subcommand 'update', Legion::CLI::Update
@@ -293,62 +241,31 @@ module Legion
       desc 'init', 'Initialize a new Legion workspace'
       subcommand 'init', Legion::CLI::Init
 
-      desc 'setup SUBCOMMAND', 'Install feature packs and configure IDE integrations'
-      subcommand 'setup', Legion::CLI::Setup
-
-      desc 'skill', 'Manage skills (.legion/skills/ markdown files)'
-      subcommand 'skill', Legion::CLI::Skill
-
-      desc 'prompt SUBCOMMAND', 'Manage versioned LLM prompt templates'
-      subcommand 'prompt', Legion::CLI::Prompt
-
-      desc 'dataset SUBCOMMAND', 'Manage versioned datasets'
-      subcommand 'dataset', Legion::CLI::Dataset
-
-      desc 'cost', 'Cost visibility and reporting'
-      subcommand 'cost', Legion::CLI::Cost
-
-      desc 'team SUBCOMMAND', 'Team and multi-user management'
-      subcommand 'team', Legion::CLI::Team
-
-      desc 'marketplace', 'Extension marketplace (search, info, scan)'
-      subcommand 'marketplace', Legion::CLI::Marketplace
-
-      desc 'notebook', 'Read and export Jupyter notebooks'
-      subcommand 'notebook', Legion::CLI::Notebook
-
-      desc 'llm', 'LLM provider diagnostics (status, ping, models)'
-      subcommand 'llm', Legion::CLI::Llm
-
+      # --- Interactive & shortcuts ---
       desc 'tty', 'Rich terminal UI (onboarding, AI chat, dashboard)'
       subcommand 'tty', Legion::CLI::Tty
 
-      desc 'eval SUBCOMMAND', 'Eval gating and experiment management'
-      subcommand 'eval', Legion::CLI::Eval
-
-      desc 'observe SUBCOMMAND', 'MCP tool observation stats'
-      subcommand 'observe', Legion::CLI::ObserveCommand
-
-      desc 'image SUBCOMMAND', 'Multimodal image analysis and comparison'
-      subcommand 'image', Legion::CLI::Image
+      # --- Command groups ---
+      desc 'ai SUBCOMMAND', 'AI, cognitive, and knowledge commands'
+      subcommand 'ai', Legion::CLI::Groups::Ai
 
-      desc 'payroll SUBCOMMAND', 'Workforce cost and labor economics'
-      subcommand 'payroll', Legion::CLI::Payroll
+      desc 'git SUBCOMMAND', 'AI-assisted git workflow (commit, pr, review)'
+      subcommand 'git', Legion::CLI::Groups::Git
 
-      desc 'docs SUBCOMMAND', 'Documentation site generator'
-      subcommand 'docs', Legion::CLI::Docs
+      desc 'pipeline SUBCOMMAND', 'LLM pipeline tools (prompts, evals, datasets, skills)'
+      subcommand 'pipeline', Legion::CLI::Groups::Pipeline
 
-      desc 'failover SUBCOMMAND', 'Region failover management'
-      subcommand 'failover', Legion::CLI::Failover
+      desc 'ops SUBCOMMAND', 'Observability, cost, audit, and operations'
+      subcommand 'ops', Legion::CLI::Groups::Ops
 
-      desc 'trace SUBCOMMAND', 'Natural language trace search via LLM'
-      subcommand 'trace', Legion::CLI::TraceCommand
+      desc 'serve SUBCOMMAND', 'Protocol servers (MCP, ACP)'
+      subcommand 'serve', Legion::CLI::Groups::Serve
 
-      desc 'features SUBCOMMAND', 'Install feature bundles (interactive selector)'
-      subcommand 'features', Legion::CLI::Features
+      desc 'admin SUBCOMMAND', 'Auth, RBAC, workers, and teams'
+      subcommand 'admin', Legion::CLI::Groups::Admin
 
-      desc 'debug', 'Diagnostic dump for troubleshooting (pipe to LLM for analysis)'
-      subcommand 'debug', Legion::CLI::Debug
+      desc 'dev SUBCOMMAND', 'Generators, docs, marketplace, and shell completion'
+      subcommand 'dev', Legion::CLI::Groups::Dev
 
       desc 'tree', 'Print a tree of all available commands'
       def tree

data/lib/legion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Legion
-  VERSION = '1.5.19'
+  VERSION = '1.5.22'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.5.19
+  version: 1.5.22
 platform: ruby
 authors:
 - Esity
@@ -625,6 +625,13 @@ files:
 - lib/legion/cli/gaia_command.rb
 - lib/legion/cli/generate_command.rb
 - lib/legion/cli/graph_command.rb
+- lib/legion/cli/groups/admin_group.rb
+- lib/legion/cli/groups/ai_group.rb
+- lib/legion/cli/groups/dev_group.rb
+- lib/legion/cli/groups/git_group.rb
+- lib/legion/cli/groups/ops_group.rb
+- lib/legion/cli/groups/pipeline_group.rb
+- lib/legion/cli/groups/serve_group.rb
 - lib/legion/cli/image_command.rb
 - lib/legion/cli/init/config_generator.rb
 - lib/legion/cli/init/environment_detector.rb