legionio 1.4.92 → 1.4.93

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d9e1879209235490bdbd660fc1d57fcc57d9487b4a17b96fce351311682fabd
-  data.tar.gz: 05e9a1fea38e182e9d2d33df3decc365f6af12d5f1a58e7496e33dfdfd5431e4
+  metadata.gz: 318839858d16ecbaaf6c7db4a0d9562e1641ca24d174fda914b9d359f3f91e69
+  data.tar.gz: 91e1415070e2f547bc7c71646e79312f048f8973b2cb004045a8d546a0000387
 SHA512:
-  metadata.gz: 2d56827c6a9bd485fb2a1e72e4b9dcd651074c1222016e3f369eee43d22d580d3c7a369bb0a07d9f47e21c453b476bf7132ec217834c3fb06fefcc1f82079b7a
-  data.tar.gz: 72c7bf18dc56f721e290a576ac71798b9559e5a91aeab6db2a720d8b5e97125e2909d62f1489dd7aea2806009b84392db5ab7cac32618e7b7b24ccc53677bfa3
+  metadata.gz: e5cd6e2ff71cc11db2a1e8928aae0c53104f931c18829bf470658bbcac3e2f90a18aeb7c564dcc7eb3f113fa9c65b54bb165a0f322fc3b1021a0ebf98148bf66
+  data.tar.gz: ff3c9e796fef50d7ca2e7b1970c4516a2d839031f8bee6036fc43b758f0035d85b5bc80fd631c5e55d8a83ce28fe5a7ccfa55fa69b67237b868331d1606d3d34

data/.rubocop.yml

@@ -41,6 +41,7 @@ Metrics/BlockLength:
     - 'lib/legion/api/auth_human.rb'
     - 'lib/legion/cli/auth_command.rb'
     - 'lib/legion/cli/detect_command.rb'
+    - 'lib/legion/cli/prompt_command.rb'
     - 'lib/legion/api/acp.rb'
 
 Metrics/AbcSize:

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Legion Changelog
 
+## [1.4.93] - 2026-03-20
+
+### Added
+- `legion prompt` CLI subcommand for versioned LLM prompt template management (list, show, create, tag, diff)
+- `legion dataset` CLI subcommand for versioned dataset management (list, show, import, export)
+- Both commands wrap `lex-prompt` and `lex-dataset` extension clients via `begin/rescue LoadError` guards
+- Both commands guard with `Connection.ensure_data` and follow existing `with_*_client` pattern
+- Tab completion entries for `prompt` and `dataset` in `completions/legion.bash` and `completions/_legion`
+
 ## [1.4.92] - 2026-03-20
 
 ### Added

data/completions/_legion

@@ -45,6 +45,8 @@ _legion() {
         commit)     _legion_commit ;;
         pr)         _legion_pr ;;
         review)     _legion_review ;;
+        prompt)     _legion_prompt ;;
+        dataset)    _legion_dataset ;;
       esac
       ;;
   esac
@@ -62,6 +64,8 @@ _legion_commands() {
     'init:Interactive project setup wizard'
     'tty:Launch interactive TTY shell'
     'ask:Quick AI prompt (shortcut for chat prompt)'
+    'prompt:Manage versioned LLM prompt templates'
+    'dataset:Manage versioned datasets'
     'version:Show version information'
     'help:Show help'
   )
@@ -837,4 +841,123 @@ _legion_check() {
     '--no-color[Disable color output]'
 }
 
+_legion_prompt() {
+  local -a subcmds
+  subcmds=(
+    'list:List all prompts'
+    'show:Show a prompt template and parameters'
+    'create:Create a new prompt'
+    'tag:Tag a prompt version'
+    'diff:Show text diff between two versions of a prompt'
+  )
+
+  _arguments -C \
+    '--json[Output as JSON]' \
+    '--no-color[Disable color output]' \
+    '--help[Show help]' \
+    '1: :->cmd' \
+    '*:: :->args'
+
+  case $state in
+    cmd)  _describe 'prompt command' subcmds ;;
+    args)
+      case $words[1] in
+        list)
+          _arguments \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+        show)
+          _arguments \
+            ':prompt name:' \
+            '--version[Specific version number]:version:' \
+            '--tag[Tag name to resolve]:tag:' \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+        create)
+          _arguments \
+            ':prompt name:' \
+            '--template[Prompt template text]:template:' \
+            '--description[Short description]:desc:' \
+            '--model-params[Model parameters as JSON]:json:' \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+        tag)
+          _arguments \
+            ':prompt name:' \
+            ':tag name:' \
+            '--version[Version to tag]:version:' \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+        diff)
+          _arguments \
+            ':prompt name:' \
+            ':version 1:' \
+            ':version 2:' \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_legion_dataset() {
+  local -a subcmds
+  subcmds=(
+    'list:List all datasets'
+    'show:Show dataset info and first 10 rows'
+    'import:Import a dataset from a file'
+    'export:Export a dataset to a file'
+  )
+
+  _arguments -C \
+    '--json[Output as JSON]' \
+    '--no-color[Disable color output]' \
+    '--help[Show help]' \
+    '1: :->cmd' \
+    '*:: :->args'
+
+  case $state in
+    cmd)  _describe 'dataset command' subcmds ;;
+    args)
+      case $words[1] in
+        list)
+          _arguments \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+        show)
+          _arguments \
+            ':dataset name:' \
+            '--version[Specific version number]:version:' \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+        import)
+          _arguments \
+            ':dataset name:' \
+            ':file path:_files' \
+            '--format[File format]:format:(json csv jsonl)' \
+            '--description[Dataset description]:desc:' \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+        export)
+          _arguments \
+            ':dataset name:' \
+            ':output path:_files' \
+            '--format[File format]:format:(json csv jsonl)' \
+            '--version[Version to export]:version:' \
+            '--json[Output as JSON]' \
+            '--no-color[Disable color output]'
+          ;;
+      esac
+      ;;
+  esac
+}
+
 _legion "$@"

data/completions/legion.bash

@@ -26,7 +26,7 @@ _legion_complete() {
     cword=$COMP_CWORD
   }
 
-  local top_commands="chat commit pr review memory plan init tty ask version help"
+  local top_commands="chat commit pr review memory plan init tty ask prompt dataset version help"
   local global_flags="--json --no-color --verbose --config-dir --help"
 
   # Top-level command
@@ -264,6 +264,33 @@ _legion_complete() {
       COMPREPLY=($(compgen -W "--json --no-color --help" -- "${cur}"))
       ;;
 
+    prompt)
+      if [[ $cword -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "list show create tag diff" -- "${cur}"))
+      else
+        case "${words[2]}" in
+          list)   COMPREPLY=($(compgen -W "--json --no-color --help" -- "${cur}")) ;;
+          show)   COMPREPLY=($(compgen -W "--version --tag --json --no-color --help" -- "${cur}")) ;;
+          create) COMPREPLY=($(compgen -W "--template --description --model-params --json --no-color --help" -- "${cur}")) ;;
+          tag)    COMPREPLY=($(compgen -W "--version --json --no-color --help" -- "${cur}")) ;;
+          diff)   COMPREPLY=($(compgen -W "--json --no-color --help" -- "${cur}")) ;;
+        esac
+      fi
+      ;;
+
+    dataset)
+      if [[ $cword -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "list show import export" -- "${cur}"))
+      else
+        case "${words[2]}" in
+          list)   COMPREPLY=($(compgen -W "--json --no-color --help" -- "${cur}")) ;;
+          show)   COMPREPLY=($(compgen -W "--version --json --no-color --help" -- "${cur}")) ;;
+          import) COMPREPLY=($(compgen -W "--format --description --json --no-color --help" -- "${cur}")) ;;
+          export) COMPREPLY=($(compgen -W "--format --version --json --no-color --help" -- "${cur}")) ;;
+        esac
+      fi
+      ;;
+
     dream)
       COMPREPLY=($(compgen -W "--wait --json --no-color --help" -- "${cur}"))
       ;;

data/lib/legion/cli/dataset_command.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    class Dataset < 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'
+      class_option :verbose,    type: :boolean, default: false, aliases: ['-V'], desc: 'Verbose logging'
+      class_option :config_dir, type: :string,                  desc: 'Config directory path'
+
+      desc 'list', 'List all datasets'
+      def list
+        out = formatter
+        with_dataset_client do |client|
+          datasets = client.list_datasets
+          if options[:json]
+            out.json(datasets)
+          elsif datasets.empty?
+            out.warn('No datasets found')
+          else
+            rows = datasets.map do |d|
+              [d[:name].to_s, (d[:description] || '').to_s,
+               (d[:latest_version] || '-').to_s, (d[:row_count] || 0).to_s]
+            end
+            out.table(%w[name description version row_count], rows)
+          end
+        end
+      end
+      default_task :list
+
+      desc 'show NAME', 'Show dataset info and first 10 rows'
+      option :version, type: :numeric, desc: 'Specific version number'
+      def show(name)
+        out = formatter
+        with_dataset_client do |client|
+          kwargs = { name: name }
+          kwargs[:version] = options[:version] if options[:version]
+          result = client.get_dataset(**kwargs)
+          if result[:error]
+            out.error("Dataset '#{name}': #{result[:error]}")
+            raise SystemExit, 1
+          end
+
+          if options[:json]
+            out.json(result)
+          else
+            out.header("Dataset: #{result[:name]}")
+            out.spacer
+            out.detail({ version: result[:version], row_count: result[:row_count] })
+            out.spacer
+            preview = (result[:rows] || []).first(10)
+            if preview.empty?
+              out.warn('No rows in this dataset version')
+            else
+              rows = preview.map do |r|
+                [r[:row_index].to_s, r[:input].to_s.slice(0, 60), (r[:expected_output] || '').to_s.slice(0, 60)]
+              end
+              out.table(%w[index input expected_output], rows)
+              remaining = result[:row_count].to_i - preview.size
+              out.warn("... #{remaining} more rows not shown") if remaining.positive?
+            end
+          end
+        end
+      end
+
+      desc 'import NAME PATH', 'Import a dataset from a file'
+      option :format,      type: :string, default: 'json', enum: %w[json csv jsonl], desc: 'File format'
+      option :description, type: :string, desc: 'Dataset description'
+      def import(name, path)
+        out = formatter
+        with_dataset_client do |client|
+          unless File.exist?(path)
+            out.error("File not found: #{path}")
+            raise SystemExit, 1
+          end
+
+          result = client.import_dataset(
+            name:        name,
+            path:        path,
+            format:      options[:format],
+            description: options[:description]
+          )
+          if options[:json]
+            out.json(result)
+          else
+            out.success("Imported '#{result[:name]}' v#{result[:version]} (#{result[:row_count]} rows)")
+          end
+        end
+      end
+
+      desc 'export NAME PATH', 'Export a dataset to a file'
+      option :format,  type: :string,  default: 'json', enum: %w[json csv jsonl], desc: 'File format'
+      option :version, type: :numeric, desc: 'Version to export'
+      def export(name, path)
+        out = formatter
+        with_dataset_client do |client|
+          kwargs = { name: name, path: path, format: options[:format] }
+          kwargs[:version] = options[:version] if options[:version]
+          result = client.export_dataset(**kwargs)
+          if options[:json]
+            out.json(result)
+          else
+            out.success("Exported #{result[:row_count]} rows to #{result[:path]}")
+          end
+        end
+      end
+
+      no_commands do
+        def formatter
+          @formatter ||= Output::Formatter.new(
+            json:  options[:json],
+            color: !options[:no_color]
+          )
+        end
+
+        def with_dataset_client
+          Connection.config_dir = options[:config_dir] if options[:config_dir]
+          Connection.log_level  = options[:verbose] ? 'debug' : 'error'
+          Connection.ensure_data
+
+          begin
+            require 'legion/extensions/dataset'
+            require 'legion/extensions/dataset/runners/dataset'
+            require 'legion/extensions/dataset/client'
+          rescue LoadError
+            formatter.error('lex-dataset gem is not installed (gem install lex-dataset)')
+            raise SystemExit, 1
+          end
+
+          db = Legion::Data.db
+          client = Legion::Extensions::Dataset::Client.new(db: db)
+          yield client
+        rescue CLI::Error => e
+          formatter.error(e.message)
+          raise SystemExit, 1
+        ensure
+          Connection.shutdown
+        end
+      end
+    end
+  end
+end

data/lib/legion/cli/prompt_command.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Legion
+  module CLI
+    class Prompt < 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'
+      class_option :verbose,    type: :boolean, default: false, aliases: ['-V'], desc: 'Verbose logging'
+      class_option :config_dir, type: :string,                  desc: 'Config directory path'
+
+      desc 'list', 'List all prompts'
+      def list
+        out = formatter
+        with_prompt_client do |client|
+          prompts = client.list_prompts
+          if options[:json]
+            out.json(prompts)
+          elsif prompts.empty?
+            out.warn('No prompts found')
+          else
+            rows = prompts.map do |p|
+              [p[:name].to_s, (p[:description] || '').to_s,
+               (p[:latest_version] || '-').to_s, (p[:updated_at] || '-').to_s]
+            end
+            out.table(%w[name description version updated_at], rows)
+          end
+        end
+      end
+      default_task :list
+
+      desc 'show NAME', 'Show a prompt template and parameters'
+      option :version, type: :numeric, desc: 'Specific version number'
+      option :tag,     type: :string,  desc: 'Tag name to resolve'
+      def show(name)
+        out = formatter
+        with_prompt_client do |client|
+          kwargs = { name: name }
+          kwargs[:version] = options[:version] if options[:version]
+          kwargs[:tag]     = options[:tag]     if options[:tag]
+          result = client.get_prompt(**kwargs)
+          if result[:error]
+            out.error("Prompt '#{name}': #{result[:error]}")
+            raise SystemExit, 1
+          end
+
+          if options[:json]
+            out.json(result)
+          else
+            out.header("Prompt: #{result[:name]}")
+            out.spacer
+            out.detail({ version: result[:version], content_hash: result[:content_hash],
+                         created_at: result[:created_at] })
+            unless result[:model_params].nil? || result[:model_params].empty?
+              out.spacer
+              out.header('Model Params')
+              out.detail(result[:model_params])
+            end
+            out.spacer
+            puts result[:template]
+          end
+        end
+      end
+
+      desc 'create NAME', 'Create a new prompt'
+      option :template,     type: :string, required: true, desc: 'Prompt template text'
+      option :description,  type: :string,                  desc: 'Short description'
+      option :model_params, type: :string,                  desc: 'Model parameters as JSON'
+      def create(name)
+        out = formatter
+        with_prompt_client do |client|
+          params = parse_model_params(options[:model_params], out)
+          return if params.nil?
+
+          result = client.create_prompt(
+            name:         name,
+            template:     options[:template],
+            description:  options[:description],
+            model_params: params
+          )
+          if options[:json]
+            out.json(result)
+          else
+            out.success("Created prompt '#{result[:name]}' (version #{result[:version]})")
+          end
+        end
+      end
+
+      desc 'tag NAME TAG', 'Tag a prompt version'
+      option :version, type: :numeric, desc: 'Version to tag (defaults to latest)'
+      def tag(name, tag_name)
+        out = formatter
+        with_prompt_client do |client|
+          kwargs = { name: name, tag: tag_name }
+          kwargs[:version] = options[:version] if options[:version]
+          result = client.tag_prompt(**kwargs)
+          if result[:error]
+            out.error("Prompt '#{name}': #{result[:error]}")
+            raise SystemExit, 1
+          end
+
+          if options[:json]
+            out.json(result)
+          else
+            out.success("Tagged '#{result[:name]}' v#{result[:version]} as '#{result[:tag]}'")
+          end
+        end
+      end
+
+      desc 'diff NAME V1 V2', 'Show text diff between two versions of a prompt'
+      def diff(name, ver1, ver2)
+        out = formatter
+        with_prompt_client do |client|
+          r1 = client.get_prompt(name: name, version: ver1.to_i)
+          r2 = client.get_prompt(name: name, version: ver2.to_i)
+
+          if r1[:error]
+            out.error("Version #{ver1}: #{r1[:error]}")
+            raise SystemExit, 1
+          end
+          if r2[:error]
+            out.error("Version #{ver2}: #{r2[:error]}")
+            raise SystemExit, 1
+          end
+
+          if options[:json]
+            out.json({ name: name, v1: ver1.to_i, v2: ver2.to_i,
+                       template_v1: r1[:template], template_v2: r2[:template] })
+          else
+            require 'diff/lcs' if defined?(Diff::LCS)
+            puts "--- v#{ver1}"
+            puts "+++ v#{ver2}"
+            puts diff_lines(r1[:template].to_s, r2[:template].to_s)
+          end
+        end
+      end
+
+      no_commands do
+        def formatter
+          @formatter ||= Output::Formatter.new(
+            json:  options[:json],
+            color: !options[:no_color]
+          )
+        end
+
+        def with_prompt_client
+          Connection.config_dir = options[:config_dir] if options[:config_dir]
+          Connection.log_level  = options[:verbose] ? 'debug' : 'error'
+          Connection.ensure_data
+
+          begin
+            require 'legion/extensions/prompt'
+            require 'legion/extensions/prompt/runners/prompt'
+            require 'legion/extensions/prompt/client'
+          rescue LoadError
+            formatter.error('lex-prompt gem is not installed (gem install lex-prompt)')
+            raise SystemExit, 1
+          end
+
+          db = Legion::Data.db
+          client = Legion::Extensions::Prompt::Client.new(db: db)
+          yield client
+        rescue CLI::Error => e
+          formatter.error(e.message)
+          raise SystemExit, 1
+        ensure
+          Connection.shutdown
+        end
+
+        def parse_model_params(raw, out)
+          return {} if raw.nil? || raw.empty?
+
+          ::JSON.parse(raw)
+        rescue ::JSON::ParserError => e
+          out.error("Invalid JSON for --model-params: #{e.message}")
+          nil
+        end
+
+        def diff_lines(old_text, new_text)
+          old_lines = old_text.split("\n")
+          new_lines = new_text.split("\n")
+          result    = []
+          old_set   = old_lines.to_set
+          new_set   = new_lines.to_set
+          old_lines.each { |l| result << "- #{l}" unless new_set.include?(l) }
+          new_lines.each { |l| result << "+ #{l}" unless old_set.include?(l) }
+          result.join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/legion/cli.rb

@@ -41,6 +41,8 @@ module Legion
     autoload :Update,     'legion/cli/update_command'
     autoload :Init,       'legion/cli/init_command'
     autoload :Skill,      'legion/cli/skill_command'
+    autoload :Prompt,     'legion/cli/prompt_command'
+    autoload :Dataset,    'legion/cli/dataset_command'
     autoload :Cost,        'legion/cli/cost_command'
     autoload :Marketplace, 'legion/cli/marketplace_command'
     autoload :Notebook,    'legion/cli/notebook_command'
@@ -238,6 +240,12 @@ module Legion
       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
 

data/lib/legion/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.92
+  version: 1.4.93
 platform: ruby
 authors:
 - Esity
@@ -450,6 +450,7 @@ files:
 - lib/legion/cli/dashboard/data_fetcher.rb
 - lib/legion/cli/dashboard/renderer.rb
 - lib/legion/cli/dashboard_command.rb
+- lib/legion/cli/dataset_command.rb
 - lib/legion/cli/detect_command.rb
 - lib/legion/cli/doctor/bundle_check.rb
 - lib/legion/cli/doctor/cache_check.rb
@@ -533,6 +534,7 @@ files:
 - lib/legion/cli/payroll_command.rb
 - lib/legion/cli/plan_command.rb
 - lib/legion/cli/pr_command.rb
+- lib/legion/cli/prompt_command.rb
 - lib/legion/cli/rbac_command.rb
 - lib/legion/cli/relationship.rb
 - lib/legion/cli/review_command.rb