legionio 1.5.18 → 1.5.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa969cacd00cbd7fcd3234d1d7b46e720da00a4193b4faa967d0f4e9b662b4e4
-  data.tar.gz: 2afe90f9456b0c5abf07f7180d562dd84ac7c901e81aea1b841288f3aae929d6
+  metadata.gz: ff2178b95e28c31128ad05f307d30f9cc4eb805210144dd7b579e3e526046045
+  data.tar.gz: d49fdcfa4b32c25cb0757abdac503e26cac31b5f134e4764219d79afe7b1141b
 SHA512:
-  metadata.gz: bf23f83209770f3e9b7c66bd59ccae187f24c136b94059b5bc54a58e9e80188280a94f01ce557eab19eb1a903bcd9e1a9d69cf7a46077ab89297f934ca1b5244
-  data.tar.gz: cf041438573f2eb546929ef68e35c527b52af9f552e129fd79b6c94f75862361eeee9d63d4f1fc2b26fecbd70078cc97614c6e928c7fa45cb317b3de858c4eea
+  metadata.gz: d4636401d967346d0db79ed299ed6bcb0bccd854a1ff58af1f88dfba545610bca4d6ea1f95c992ad206a90091b8510f214392f236d9f35fca8e347f0f76d61c9
+  data.tar.gz: e477f818ab50a7edcbdf8be7b5e5e62ac4c65d9394f224401104cc646140d9dfa7e6ab356fdea1dc69c764ca3f1144a36e8c42998978b3fa73620358166b4e2d

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Legion Changelog
 
+## [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
+- `legion knowledge` CLI subcommand: query, retrieve, ingest, status (closes #36)
+  - `legion knowledge query QUESTION` — synthesized LLM answer + ranked source chunks
+  - `legion knowledge retrieve QUESTION` — raw source chunks without synthesis
+  - `legion knowledge ingest PATH` — ingest file or directory corpus
+  - `legion knowledge status` — show corpus file count and size
+
 ## [1.5.18] - 2026-03-25
 
 ### Added

data/lib/legion/cli/knowledge_command.rb

@@ -0,0 +1,242 @@
+# frozen_string_literal: true
+
+module Legion
+  module CLI
+    class Knowledge < Thor
+      def self.exit_on_failure?
+        true
+      end
+
+      class_option :json,     type: :boolean, default: false, desc: 'Output as JSON'
+      class_option :no_color, type: :boolean, default: false, desc: 'Disable color output'
+
+      desc 'query QUESTION', 'Query the knowledge base with optional LLM synthesis'
+      option :top_k,      type: :numeric, default: 5, desc: 'Number of source chunks'
+      option :synthesize, type: :boolean, default: true,  desc: 'Synthesize an LLM answer'
+      option :verbose,    type: :boolean, default: false, desc: 'Show full source metadata'
+      def query(question)
+        require_knowledge!
+        result = knowledge_query.query(question: question, top_k: options[:top_k],
+                                       synthesize: options[:synthesize])
+        out = formatter
+        if options[:json]
+          out.json(result)
+        elsif result[:success]
+          out.header('Knowledge Query')
+          if result[:answer]
+            out.spacer
+            puts result[:answer]
+            out.spacer
+          end
+          print_sources(result[:sources] || [], out, verbose: options[:verbose])
+        else
+          out.warn("Query failed: #{result[:error]}")
+        end
+      end
+      default_task :help
+
+      desc 'retrieve QUESTION', 'Retrieve source chunks without LLM synthesis'
+      option :top_k, type: :numeric, default: 5, desc: 'Number of source chunks'
+      def retrieve(question)
+        require_knowledge!
+        result = knowledge_query.retrieve(question: question, top_k: options[:top_k])
+        out = formatter
+        if options[:json]
+          out.json(result)
+        elsif result[:success]
+          out.header("Knowledge Retrieve (#{(result[:sources] || []).size} chunks)")
+          print_sources(result[:sources] || [], out, verbose: true)
+        else
+          out.warn("Retrieve failed: #{result[:error]}")
+        end
+      end
+
+      desc 'ingest PATH', 'Ingest a file or directory into the knowledge base'
+      option :force,   type: :boolean, default: false, desc: 'Re-ingest even unchanged files'
+      option :dry_run, type: :boolean, default: false, desc: 'Preview without writing'
+      def ingest(path)
+        require_ingest!
+        result = if ::File.directory?(path)
+                   knowledge_ingest.ingest_corpus(path: path, force: options[:force],
+                                                  dry_run: options[:dry_run])
+                 else
+                   knowledge_ingest.ingest_file(file_path: path, force: options[:force],
+                                                dry_run: options[:dry_run])
+                 end
+        out = formatter
+        if options[:json]
+          out.json(result)
+        elsif result[:success]
+          out.success('Ingest complete')
+          out.detail(result.except(:success))
+        else
+          out.warn("Ingest failed: #{result[:error]}")
+        end
+      end
+
+      desc 'status', 'Show knowledge base status'
+      def status
+        require_ingest!
+        result = knowledge_ingest.scan_corpus(path: ::Dir.pwd)
+        out = formatter
+        if options[:json]
+          out.json(result)
+        else
+          out.header('Knowledge Status')
+          out.detail({
+                       'Path'       => result[:path].to_s,
+                       'Files'      => result[:file_count].to_s,
+                       'Total size' => "#{result[:total_bytes]} bytes"
+                     })
+        end
+      end
+
+      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
+
+        def require_knowledge!
+          return if defined?(Legion::Extensions::Knowledge::Runners::Query)
+
+          raise CLI::Error, 'lex-knowledge extension is not loaded. Install and enable it first.'
+        end
+
+        def require_ingest!
+          return if defined?(Legion::Extensions::Knowledge::Runners::Ingest)
+
+          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
+
+        def knowledge_ingest
+          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?
+
+          out.header("Sources (#{sources.size})")
+          sources.each_with_index do |s, i|
+            score   = format('%.2f', s[:score].to_f)
+            heading = s[:heading].to_s.empty? ? '' : " \u00a7 #{s[:heading]}"
+            puts "  #{i + 1}. #{s[:source_file]}#{heading}   score: #{score}"
+            puts "     #{truncate(s[:content].to_s, 100)}" if verbose
+          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
+
+          "#{text[0, max - 3]}..."
+        end
+      end
+    end
+  end
+end

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

@@ -42,6 +42,7 @@ module Legion
     autoload :Eval,       'legion/cli/eval_command'
     autoload :Update,     'legion/cli/update_command'
     autoload :Init,       'legion/cli/init_command'
+    autoload :Knowledge,  'legion/cli/knowledge_command'
     autoload :Setup,      'legion/cli/setup_command'
     autoload :Skill,      'legion/cli/skill_command'
     autoload :Prompt,     'legion/cli/prompt_command'
@@ -256,6 +257,9 @@ module Legion
       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
 
@@ -348,7 +352,7 @@ module Legion
 
       desc 'tree', 'Print a tree of all available commands'
       def tree
-        legion_print_command_tree(self.class, 'legion', '')
+        legion_print_command_tree(self.class, ::File.basename($PROGRAM_NAME), '')
       end
 
       desc 'ask TEXT', 'Quick AI prompt (shortcut for chat prompt)'

data/lib/legion/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.5.18
+  version: 1.5.21
 platform: ruby
 authors:
 - Esity
@@ -630,6 +630,7 @@ files:
 - lib/legion/cli/init/environment_detector.rb
 - lib/legion/cli/init_command.rb
 - lib/legion/cli/interactive.rb
+- lib/legion/cli/knowledge_command.rb
 - lib/legion/cli/lex/actor.rb
 - lib/legion/cli/lex/exchange.rb
 - lib/legion/cli/lex/message.rb