legionio 1.5.18 → 1.5.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa969cacd00cbd7fcd3234d1d7b46e720da00a4193b4faa967d0f4e9b662b4e4
-  data.tar.gz: 2afe90f9456b0c5abf07f7180d562dd84ac7c901e81aea1b841288f3aae929d6
+  metadata.gz: bb76821fb4802e78a19c4518c18f32a961a144cd96f0ef146ce0b582ef96f699
+  data.tar.gz: c9c6eb50bef1df98a3ede6ce943e4a45a9dc4c638ce682519708d3d0008eddd5
 SHA512:
-  metadata.gz: bf23f83209770f3e9b7c66bd59ccae187f24c136b94059b5bc54a58e9e80188280a94f01ce557eab19eb1a903bcd9e1a9d69cf7a46077ab89297f934ca1b5244
-  data.tar.gz: cf041438573f2eb546929ef68e35c527b52af9f552e129fd79b6c94f75862361eeee9d63d4f1fc2b26fecbd70078cc97614c6e928c7fa45cb317b3de858c4eea
+  metadata.gz: 2e502641a0f4177baeab32e78b839f80fa163953fe55770cd0a31364b352b5eda156e0971e67057ad5263160cc5f874b7cdbfdafc1a7cc9799fdd7a9ebd73a65
+  data.tar.gz: 90ec056445d835e01d044dd1ca6272c7e30ef5cffa0e30c39d93d4c2e8004f0e4d3ff59d83e12753bc485484a68a2526e90ebe1ccfdd1fb39e12b89e549d01d1

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Legion Changelog
 
+## [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,140 @@
+# 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
+
+      no_commands do
+        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 knowledge_query
+          Legion::Extensions::Knowledge::Runners::Query
+        end
+
+        def knowledge_ingest
+          Legion::Extensions::Knowledge::Runners::Ingest
+        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 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.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.19'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.5.18
+  version: 1.5.19
 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