legionio 1.4.116 → 1.4.118

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6979926154eb319a990087443af9becaa5831d4eb0ab5525f1b044287e2c279f
-  data.tar.gz: '0129c7452e19e2f9c63f996ea254b44764a6caebfccb84f50ad0c8d058b910bb'
+  metadata.gz: a10f06b3cc591d8fa5aae3b31216e037826f961962df05276ba5fbd78805235c
+  data.tar.gz: 5a9e88f6bbb42b27586adba45becd7ecaedc69f190bd3f0fbddb3de27fcffd79
 SHA512:
-  metadata.gz: c1d1b49e93559deda93761855fa70fb72fe76673af87cf7c5fa4819a326d57318a2cc43c7c1f8bf9d0311487e3bbe1ee9d2154f52f14254630f4db8d7302f23f
-  data.tar.gz: fec26b4465b3806815ca5ddc62a476a54c4e88ce94654a18983aadab6940fcca9197ee8545b85038960d9688a9ba64d810499eef09374d0723081e523048766c
+  metadata.gz: 3cab7e4e400553baf1b57918d610dbb7a0dd1143dd4df52f104bd03e55d23e53bfbffd815c32b9836ec421ba58c613b32ec97d6af0b68f26cf0fdb55570e7790
+  data.tar.gz: 13c8e47feeccf21c4ea33b2ddd31f37f8afd6f73765e6df48ead40e6e2a96125019c9b5aa1107383db46958bcaf51a7cd593344f70b1d295e807dedf33b1d41f

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Legion Changelog
 
+## [1.4.118] - 2026-03-22
+
+### Added
+- `legion detect --install` interactive extension picker: multi-select via tty-prompt (when available) or numbered list fallback
+- `legion detect --install-all` for non-interactive bulk install of all missing extensions
+- Signal context shown in picker (e.g., which app/formula triggered the recommendation)
+
+## [1.4.117] - 2026-03-22
+
+### Added
+- `Legion::CLI::Error` gains `suggestions`, `code` attributes and `.actionable` factory method
+- `Legion::CLI::ErrorHandler` module: 6-pattern matcher maps common exceptions (RabbitMQ, DB, extensions, permissions, data, Vault) to actionable errors with fix suggestions
+- `ErrorHandler.wrap` wraps any `StandardError` into a `CLI::Error` with suggestions when a pattern matches
+- `ErrorHandler.format_error` prints suggestions below the error line when the error is actionable
+- `Legion::CLI::Main.start` overrides Thor's entry point to wrap unhandled exceptions through `ErrorHandler` before exiting
+
 ## [1.4.116] - 2026-03-22
 
 ### Added

data/lib/legion/cli/detect_command.rb

@@ -19,7 +19,8 @@ module Legion
       default_task :scan
 
       desc 'scan', 'Scan environment and recommend extensions (default)'
-      option :install, type: :boolean, default: false, desc: 'Install missing extensions after scan'
+      option :install, type: :boolean, default: false, desc: 'Interactive install of missing extensions after scan'
+      option :install_all, type: :boolean, default: false, desc: 'Install all missing extensions without prompting'
       option :dry_run, type: :boolean, default: false, desc: 'Show what would be installed without installing'
       option :format, type: :string, enum: %w[sarif markdown json], desc: 'Output format (sarif, markdown, json)'
       def scan
@@ -35,7 +36,11 @@ module Legion
           out.json(detections: results)
         else
           display_detections(out, results)
-          install_missing(out) if options[:install]
+          if options[:install]
+            interactive_install(out, results)
+          elsif options[:install_all]
+            install_missing(out)
+          end
         end
       end
 
@@ -130,6 +135,98 @@ module Legion
           puts "  #{installed_count} of #{total_count} extension(s) installed"
         end
 
+        def interactive_install(out, results)
+          missing_gems = Legion::Extensions::Detect.missing
+          return out.success('All detected extensions are installed') if missing_gems.empty?
+
+          signal_map = build_signal_map(results)
+          selected = pick_extensions(out, missing_gems, signal_map)
+          if selected.empty?
+            puts '  No extensions selected'
+            return
+          end
+
+          if options[:dry_run]
+            out.header('Would install')
+            selected.each { |name| puts "  #{name}" }
+            return
+          end
+
+          install_selected(out, selected)
+        end
+
+        def pick_extensions(out, missing_gems, signal_map)
+          if tty_prompt_available?
+            pick_with_tty_prompt(missing_gems, signal_map)
+          else
+            pick_with_numbers(out, missing_gems, signal_map)
+          end
+        end
+
+        def pick_with_tty_prompt(missing_gems, signal_map)
+          require 'tty-prompt'
+          prompt = ::TTY::Prompt.new
+
+          choices = missing_gems.map do |name|
+            label = signal_map[name] ? "#{name} (#{signal_map[name]})" : name
+            { name: label, value: name }
+          end
+
+          prompt.multi_select('Select extensions to install:', choices, per_page: 20, echo: false)
+        end
+
+        def pick_with_numbers(out, missing_gems, signal_map)
+          out.spacer
+          out.header('Missing Extensions')
+          missing_gems.each_with_index do |name, idx|
+            reason = signal_map[name] ? " (#{signal_map[name]})" : ''
+            puts "  #{out.colorize((idx + 1).to_s.rjust(3), :label)}  #{name}#{reason}"
+          end
+          out.spacer
+          puts '  Enter numbers to install (comma-separated), "all", or "none":'
+          print '  > '
+          input = $stdin.gets&.strip || 'none'
+
+          return missing_gems.dup if input.downcase == 'all'
+          return [] if input.empty? || input.downcase == 'none'
+
+          indices = input.split(/[,\s]+/).filter_map { |s| s.to_i - 1 if s.match?(/\A\d+\z/) }
+          indices.filter_map { |i| missing_gems[i] if i >= 0 && i < missing_gems.size }.uniq
+        end
+
+        def build_signal_map(results)
+          map = {}
+          results.each do |detection|
+            signals = detection[:matched_signals].join(', ')
+            detection[:installed].each do |gem_name, installed|
+              map[gem_name] = signals unless installed
+            end
+          end
+          map
+        end
+
+        def install_selected(out, selected)
+          out.header("Installing #{selected.size} extension(s)")
+          result = Legion::Extensions::Detect::Installer.install(selected)
+
+          result[:installed].each { |name| out.success("  Installed #{name}") }
+          result[:failed].each { |f| out.error("  Failed: #{f[:name]} — #{f[:error]}") }
+
+          out.spacer
+          if result[:failed].empty?
+            out.success("#{result[:installed].size} extension(s) installed")
+          else
+            out.warn("#{result[:installed].size} installed, #{result[:failed].size} failed")
+          end
+        end
+
+        def tty_prompt_available?
+          require 'tty-prompt'
+          true
+        rescue LoadError
+          false
+        end
+
         def install_missing(out)
           missing_gems = Legion::Extensions::Detect.missing
           return if missing_gems.empty?

data/lib/legion/cli/error.rb

@@ -2,6 +2,19 @@
 
 module Legion
   module CLI
-    class Error < StandardError; end
+    class Error < StandardError
+      attr_reader :suggestions, :code
+
+      def self.actionable(code:, message:, suggestions: [])
+        err = new(message)
+        err.instance_variable_set(:@code, code)
+        err.instance_variable_set(:@suggestions, suggestions)
+        err
+      end
+
+      def actionable?
+        !suggestions.nil? && !suggestions.empty?
+      end
+    end
   end
 end

data/lib/legion/cli/error_handler.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Legion
+  module CLI
+    module ErrorHandler
+      PATTERNS = [
+        {
+          match:       /connection refused.*5672|ECONNREFUSED.*5672|bunny.*not connected/i,
+          code:        :transport_unavailable,
+          message:     'Cannot connect to RabbitMQ',
+          suggestions: [
+            "Run 'legion doctor' to diagnose connectivity",
+            "Check transport settings: 'legion config show -s transport'",
+            'Verify RabbitMQ is running: brew services list | grep rabbitmq'
+          ]
+        },
+        {
+          match:       /table.*not.*found|no such table|PG::UndefinedTable|Sequel::DatabaseError.*exist/i,
+          code:        :database_missing,
+          message:     'Database table not found',
+          suggestions: [
+            "Run 'legion start' to apply pending migrations",
+            "Check database config: 'legion config show -s data'",
+            "Verify database is running: 'legion doctor'"
+          ]
+        },
+        {
+          match:       /extension.*not.*found|no such extension|uninitialized constant.*Extensions/i,
+          code:        :extension_missing,
+          message:     'Extension not found',
+          suggestions: [
+            "Search available extensions: 'legion marketplace search <name>'",
+            'Install with: gem install lex-<name>',
+            "List installed: 'legion lex list'"
+          ]
+        },
+        {
+          match:       /permission denied|EACCES/i,
+          code:        :permission_denied,
+          message:     'Permission denied',
+          suggestions: [
+            'Try running with sudo for system directories',
+            'Set custom config dir: LEGIONIO_CONFIG_DIR=~/.legionio',
+            'Check file permissions: ls -la ~/.legionio/'
+          ]
+        },
+        {
+          match:       /legion-data.*not.*connected|data.*not.*available/i,
+          code:        :data_unavailable,
+          message:     'Database not connected',
+          suggestions: [
+            "Check database config: 'legion config show -s data'",
+            "Run diagnostics: 'legion doctor'",
+            'Some commands work without a database — try adding --no-data flag'
+          ]
+        },
+        {
+          match:       /vault.*not.*connected|vault.*sealed|VAULT_ADDR/i,
+          code:        :vault_unavailable,
+          message:     'Vault not connected',
+          suggestions: [
+            "Check Vault config: 'legion config show -s crypt'",
+            'Verify VAULT_ADDR and VAULT_TOKEN environment variables',
+            "Run diagnostics: 'legion doctor'"
+          ]
+        }
+      ].freeze
+
+      module_function
+
+      def wrap(error)
+        pattern = PATTERNS.find { |p| error.message.match?(p[:match]) }
+        return error unless pattern
+
+        Error.actionable(
+          code:        pattern[:code],
+          message:     "#{pattern[:message]}: #{error.message}",
+          suggestions: pattern[:suggestions]
+        )
+      end
+
+      def format_error(error, formatter)
+        formatter.error(error.message)
+        return unless error.is_a?(Error) && error.actionable?
+
+        error.suggestions.each do |suggestion|
+          puts "  #{formatter.colorize('>', :label)} #{suggestion}"
+        end
+      end
+    end
+  end
+end

data/lib/legion/cli.rb

@@ -3,6 +3,7 @@
 require 'thor'
 require 'legion/version'
 require 'legion/cli/error'
+require 'legion/cli/error_handler'
 require 'legion/cli/output'
 require 'legion/cli/connection'
 
@@ -61,6 +62,19 @@ module Legion
         true
       end
 
+      def self.start(given_args = ARGV, config = {})
+        super
+      rescue Legion::CLI::Error => e
+        formatter = Output::Formatter.new(json: given_args.include?('--json'), color: !given_args.include?('--no-color'))
+        ErrorHandler.format_error(e, formatter)
+        exit(1)
+      rescue StandardError => e
+        wrapped = ErrorHandler.wrap(e)
+        formatter = Output::Formatter.new(json: given_args.include?('--json'), color: !given_args.include?('--no-color'))
+        ErrorHandler.format_error(wrapped, formatter)
+        exit(1)
+      end
+
       class_option :json, type: :boolean, default: false, desc: 'Output as JSON'
       class_option :no_color, type: :boolean, default: false, desc: 'Disable color output'
       class_option :verbose, type: :boolean, default: false, aliases: ['-V'], desc: 'Verbose logging'

data/lib/legion/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.116
+  version: 1.4.118
 platform: ruby
 authors:
 - Esity
@@ -498,6 +498,7 @@ files:
 - lib/legion/cli/doctor/vault_check.rb
 - lib/legion/cli/doctor_command.rb
 - lib/legion/cli/error.rb
+- lib/legion/cli/error_handler.rb
 - lib/legion/cli/eval_command.rb
 - lib/legion/cli/failover_command.rb
 - lib/legion/cli/function.rb