legion-tty 0.4.24 → 0.4.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab1a18bdbec9078051e19b84ede94cdaacb600ed12006674dc5696f711230349
-  data.tar.gz: 6735876baede0f4fd45637f6a5cb0cef4284f7117298fa96cb97c8ca667a23d4
+  metadata.gz: c2baad187737411e10cb975111c2e766cd5b1b1c20bc27b7731cc990672597a0
+  data.tar.gz: e2d8eaabf4459beba0805f830025321c11fa70ea572aba05640b005e20dbd12a
 SHA512:
-  metadata.gz: '01294f74d7805fb5aad66aa1538ffe38cb1f8b407aaaa662d90cacaf7f8c0b4e787257636007f8a74e88e1e13b76a5432da4a2ff47aad0dd5b6f81852116ddfb'
-  data.tar.gz: 789298565c5285d7ef1787fd7dfbf8034b181f57f3cab243cd4b424712b0ec7251836e8c8f5ff3b79faf4b0d98c5416e919e8cf80c42df09adbe443d5b77905f
+  metadata.gz: 53b05dc182ec33a56c75c58a3936c9753b018c8a78ac3ae83f2fac588bafdf5ecb09026a9f70120b86d7685ce75d484bd993ef83efabf84ee0f63c4d81daefb8
+  data.tar.gz: 6f6849814bba37b3ebee42a88be6a927efaa913437d1c050586902aa4850cbf334df571e310818b6ddc711ff5d0828ef89e12cb8e249d9b704248e73898e200c

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.4.25] - 2026-03-19
+
+### Added
+- `/ask <question>` command: quick concise Q&A mode (instructs LLM to answer in one paragraph)
+- `/define <term>` command: ask LLM for a concise definition
+- `/status` command: comprehensive view of all 18 toggleable modes and settings
+- `/prefs [key] [value]` command: persistent user preferences in `~/.legionio/prefs.json`
+- `/about` command: show legion-tty name, version, author, license, GitHub URL
+- `/commands [pattern]` command: list all slash commands with optional pattern filter and count
+
+### Changed
+- Total slash commands: 103 (milestone)
+
 ## [0.4.24] - 2026-03-19
 
 ### Added

data/lib/legion/tty/screens/chat/model_commands.rb

@@ -154,6 +154,32 @@ module Legion
             end
             :handled
           end
+
+          def handle_ask(input)
+            question = input.split(nil, 2)[1]&.strip
+            unless question && !question.empty?
+              @message_stream.add_message(role: :system, content: 'Usage: /ask <question>')
+              return :handled
+            end
+
+            @message_stream.add_message(role: :user, content: question)
+            @message_stream.add_message(role: :assistant, content: '')
+            send_to_llm("Answer the following question concisely in one paragraph: #{question}")
+            :handled
+          end
+
+          def handle_define(input)
+            term = input.split(nil, 2)[1]&.strip
+            unless term && !term.empty?
+              @message_stream.add_message(role: :system, content: 'Usage: /define <term>')
+              return :handled
+            end
+
+            @message_stream.add_message(role: :user, content: term)
+            @message_stream.add_message(role: :assistant, content: '')
+            send_to_llm("Define the following term concisely: #{term}")
+            :handled
+          end
         end
       end
     end

data/lib/legion/tty/screens/chat/ui_commands.rb

@@ -680,6 +680,49 @@ module Legion
             :handled
           end
 
+          def handle_about
+            lines = [
+              'legion-tty',
+              'Description : Rich terminal UI for the LegionIO async cognition engine',
+              "Version     : #{Legion::TTY::VERSION}",
+              'Author      : Matthew Iverson (@Esity)',
+              'License     : Apache-2.0',
+              'GitHub      : https://github.com/LegionIO/legion-tty'
+            ]
+            @message_stream.add_message(role: :system, content: lines.join("\n"))
+            :handled
+          end
+
+          def handle_commands(input)
+            pattern = input.split(nil, 2)[1]&.strip&.downcase
+            cmds = filter_commands(pattern)
+            header = commands_header(pattern, cmds)
+            rows = format_command_columns(cmds)
+            @message_stream.add_message(role: :system, content: "#{header}\n#{rows.join("\n")}")
+            :handled
+          end
+
+          def filter_commands(pattern)
+            cmds = SLASH_COMMANDS.sort
+            return cmds unless pattern && !pattern.empty?
+
+            cmds.select { |c| c.include?(pattern) }
+          end
+
+          def commands_header(pattern, cmds)
+            if pattern && !pattern.empty?
+              "Commands matching '#{pattern}' (#{cmds.size}):"
+            else
+              "All commands (#{cmds.size}):"
+            end
+          end
+
+          def format_command_columns(cmds)
+            col_width = cmds.map(&:length).max.to_i + 2
+            cols = [terminal_width / [col_width, 1].max, 1].max
+            cmds.each_slice(cols).map { |row| row.map { |c| c.ljust(col_width) }.join.rstrip }
+          end
+
           def handle_freq
             words = collect_freq_words
             if words.empty?
@@ -707,6 +750,108 @@ module Legion
               format(FREQ_ROW_FMT, rank: rank, word: word, count: count, pct: pct)
             end
           end
+
+          # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+          def handle_status
+            autosave_val = @autosave_enabled ? "on (every #{@autosave_interval}s)" : 'off'
+            filter_val   = @message_stream.filter ? @message_stream.filter[:type].to_s : 'none'
+            wrap_val     = @message_stream.wrap_width ? @message_stream.wrap_width.to_s : 'off'
+            truncate_val = @message_stream.truncate_limit ? @message_stream.truncate_limit.to_s : 'off'
+            tee_val      = @tee_path || 'off'
+            lines = [
+              'Mode Status:',
+              "  Plan mode  : #{@plan_mode ? 'on' : 'off'}",
+              "  Focus mode : #{@focus_mode ? 'on' : 'off'}",
+              "  Debug mode : #{@debug_mode ? 'on' : 'off'}",
+              "  Silent mode: #{@silent_mode ? 'on' : 'off'}",
+              "  Mute system: #{@muted_system ? 'on' : 'off'}",
+              "  Multi-line : #{@multiline_mode ? 'on' : 'off'}",
+              "  Speak mode : #{defined?(@speak_mode) && @speak_mode ? 'on' : 'off'}",
+              "  Autosave   : #{autosave_val}",
+              "  Color      : #{@message_stream.colorize ? 'on' : 'off'}",
+              "  Timestamps : #{@message_stream.show_timestamps ? 'on' : 'off'}",
+              "  Numbers    : #{@message_stream.show_numbers ? 'on' : 'off'}",
+              "  Wrap       : #{wrap_val}",
+              "  Truncate   : #{truncate_val}",
+              "  Filter     : #{filter_val}",
+              "  Tee        : #{tee_val}",
+              "  Theme      : #{Theme.current_theme}",
+              "  Personality: #{@personality || 'default'}"
+            ]
+            @message_stream.add_message(role: :system, content: lines.join("\n"))
+            :handled
+          end
+          # rubocop:enable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
+          def handle_prefs(input)
+            parts = input.split(nil, 3)
+            key   = parts[1]
+            value = parts[2]
+            if key.nil?
+              show_all_prefs
+            elsif value.nil?
+              show_one_pref(key)
+            else
+              set_pref(key, value)
+            end
+            :handled
+          end
+
+          def prefs_path
+            File.expand_path('~/.legionio/prefs.json')
+          end
+
+          def load_prefs
+            return {} unless File.exist?(prefs_path)
+
+            require 'json'
+            ::JSON.parse(File.read(prefs_path))
+          rescue ::JSON::ParserError
+            {}
+          end
+
+          def save_prefs(prefs)
+            require 'fileutils'
+            require 'json'
+            FileUtils.mkdir_p(File.dirname(prefs_path))
+            File.write(prefs_path, ::JSON.pretty_generate(prefs))
+          end
+
+          def show_all_prefs
+            prefs = load_prefs
+            if prefs.empty?
+              @message_stream.add_message(role: :system, content: 'No preferences saved.')
+            else
+              lines = prefs.map { |k, v| "  #{k}: #{v}" }
+              @message_stream.add_message(role: :system, content: "Preferences:\n#{lines.join("\n")}")
+            end
+          end
+
+          def show_one_pref(key)
+            val = load_prefs[key]
+            if val.nil?
+              @message_stream.add_message(role: :system, content: "No preference set for '#{key}'.")
+            else
+              @message_stream.add_message(role: :system, content: "#{key}: #{val}")
+            end
+          end
+
+          def set_pref(key, value)
+            prefs = load_prefs
+            prefs[key] = value
+            save_prefs(prefs)
+            apply_pref(key, value)
+            @message_stream.add_message(role: :system, content: "Preference set: #{key} = #{value}")
+          end
+
+          def apply_pref(key, value)
+            case key
+            when 'theme'       then handle_theme("/theme #{value}")
+            when 'personality' then handle_personality("/personality #{value}")
+            when 'color'       then handle_color("/color #{value}")
+            when 'timestamps'  then handle_timestamps("/timestamps #{value}")
+            end
+          end
         end
       end
     end

data/lib/legion/tty/screens/chat.rb

@@ -45,7 +45,10 @@ module Legion
                             /color /timestamps
                             /top /bottom /head /tail
                             /draft /revise
-                            /mark /freq].freeze
+                            /mark /freq
+                            /about /commands
+                            /ask /define
+                            /status /prefs].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -492,6 +495,12 @@ module Legion
           when '/revise' then handle_revise(input)
           when '/mark' then handle_mark(input)
           when '/freq' then handle_freq
+          when '/about' then handle_about
+          when '/commands' then handle_commands(input)
+          when '/ask' then handle_ask(input)
+          when '/define' then handle_define(input)
+          when '/status' then handle_status
+          when '/prefs' then handle_prefs(input)
           else :handled
           end
         end

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.24'
+    VERSION = '0.4.25'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-tty
 version: !ruby/object:Gem::Version
-  version: 0.4.24
+  version: 0.4.25
 platform: ruby
 authors:
 - Esity