legion-tty 0.4.23 → 0.4.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f33a9d4d3640c42054bc91b873ec04898386dc635d5b3097e037c7695a3a9594
-  data.tar.gz: 469499bb265ededb47d2c1a03778174b8cae152a163808ba5a606b1aaa3b94ee
+  metadata.gz: c2baad187737411e10cb975111c2e766cd5b1b1c20bc27b7731cc990672597a0
+  data.tar.gz: e2d8eaabf4459beba0805f830025321c11fa70ea572aba05640b005e20dbd12a
 SHA512:
-  metadata.gz: 79090a1ed32486fa0e15f59312d34ee601c8cc92e8d596ccffda4cc7951cedd3d8461801b90669c1a34d22b32caa6c794836d7dc00633636d64c940dfc757633
-  data.tar.gz: 3ccb8fde2f3e285cbed4f06ddc46132d9f5fd45bad3c5cc5a80d22bca704c2a8e1e90bf799e8e7095228fe1c1330318156792392a67ddcaba4b3eea9f439d094
+  metadata.gz: 53b05dc182ec33a56c75c58a3936c9753b018c8a78ac3ae83f2fac588bafdf5ecb09026a9f70120b86d7685ce75d484bd993ef83efabf84ee0f63c4d81daefb8
+  data.tar.gz: 6f6849814bba37b3ebee42a88be6a927efaa913437d1c050586902aa4850cbf334df571e310818b6ddc711ff5d0828ef89e12cb8e249d9b704248e73898e200c

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # 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
+- `/mark <label>` command: insert named markers/bookmarks in conversation, list all markers
+- `/freq` command: word frequency analysis with top 20 words (excludes stop words)
+- `/draft <text>` command: save text to draft buffer, show/clear/send draft
+- `/revise <text>` command: replace content of last user message
+- `/color [on|off]` command: toggle colorized output (strip ANSI codes when off)
+- `/timestamps [on|off]` command: toggle timestamp display on messages
+- `/top` command: scroll to top of message history
+- `/bottom` command: scroll to bottom of message history
+- `/head [N]` command: peek at first N messages (default 5)
+- `/tail [N]` command: peek at last N messages (default 5)
+
 ## [0.4.23] - 2026-03-19
 
 ### Added

data/lib/legion/tty/components/message_stream.rb

@@ -9,7 +9,8 @@ module Legion
       # rubocop:disable Metrics/ClassLength
       class MessageStream
         attr_reader :messages, :scroll_offset
-        attr_accessor :mute_system, :silent_mode, :highlights, :filter, :truncate_limit, :wrap_width, :show_numbers
+        attr_accessor :mute_system, :silent_mode, :highlights, :filter, :truncate_limit, :wrap_width, :show_numbers,
+                      :colorize, :show_timestamps
 
         HIGHLIGHT_COLOR = "\e[1;33m"
         HIGHLIGHT_RESET = "\e[0m"
@@ -22,6 +23,8 @@ module Legion
           @highlights = []
           @wrap_width = nil
           @show_numbers = false
+          @colorize = true
+          @show_timestamps = true
         end
 
         def add_message(role:, content:)
@@ -70,6 +73,7 @@ module Legion
           start_idx = [total - height - @scroll_offset, 0].max
           start_idx = [start_idx, total].min
           result = all_lines[start_idx, height] || []
+          result = result.map { |l| strip_ansi(l) } unless @colorize
           @last_visible_count = result.size
           result
         end
@@ -128,15 +132,18 @@ module Legion
         end
 
         def user_lines(msg, _width)
-          ts = format_timestamp(msg[:timestamp])
-          header = "#{Theme.c(:accent, 'You')} #{Theme.c(:muted, ts)}"
           content = apply_highlights(msg[:content].to_s)
-          lines = ['', "#{header}: #{content}"]
+          lines = ['', "#{user_header(msg[:timestamp])}: #{content}"]
           lines << reaction_line(msg) if msg[:reactions]&.any?
           lines.concat(annotation_lines(msg)) if msg[:annotations]&.any?
           lines
         end
 
+        def user_header(timestamp)
+          ts = @show_timestamps ? format_timestamp(timestamp) : ''
+          ts.empty? ? Theme.c(:accent, 'You') : "#{Theme.c(:accent, 'You')} #{Theme.c(:muted, ts)}"
+        end
+
         def format_timestamp(time)
           return '' unless time
 
@@ -209,6 +216,10 @@ module Legion
           panel.instance_variable_set(:@result, result) if result
           panel.instance_variable_set(:@error, error) if error
         end
+
+        def strip_ansi(text)
+          text.gsub(/\e\[[0-9;]*m/, '')
+        end
       end
       # rubocop:enable Metrics/ClassLength
     end

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

@@ -560,6 +560,101 @@ module Legion
             @message_stream.add_message(role: :system, content: "Truncated to last #{n} messages.")
             :handled
           end
+
+          def handle_mark(input)
+            label = input.split(nil, 2)[1]
+            return list_markers if label.nil?
+
+            msg = { role: :system, content: "--- #{label} ---", marker: label }
+            @message_stream.messages << msg
+            @status_bar.update(message_count: @message_stream.messages.size)
+            :handled
+          end
+
+          def list_markers
+            markers = @message_stream.messages.each_with_index.select { |m, _| m[:marker] }
+            if markers.empty?
+              @message_stream.add_message(role: :system, content: 'No markers set.')
+            else
+              lines = markers.map { |m, i| "  [#{i}] #{m[:content]}" }
+              @message_stream.add_message(role: :system, content: "Markers:\n#{lines.join("\n")}")
+            end
+            :handled
+          end
+
+          def handle_head(input)
+            n = (input.split(nil, 2)[1] || '5').to_i.clamp(1, 500)
+            msgs = @message_stream.messages.first(n)
+            if msgs.empty?
+              @message_stream.add_message(role: :system, content: 'No messages.')
+              return :handled
+            end
+
+            lines = msgs.map { |m| "  [#{m[:role]}] #{truncate_text(m[:content].to_s, 80)}" }
+            @message_stream.add_message(role: :system, content: "First #{msgs.size} message(s):\n#{lines.join("\n")}")
+            :handled
+          end
+
+          def handle_tail(input)
+            n = (input.split(nil, 2)[1] || '5').to_i.clamp(1, 500)
+            msgs = @message_stream.messages.last(n)
+            if msgs.empty?
+              @message_stream.add_message(role: :system, content: 'No messages.')
+              return :handled
+            end
+
+            lines = msgs.map { |m| "  [#{m[:role]}] #{truncate_text(m[:content].to_s, 80)}" }
+            @message_stream.add_message(role: :system, content: "Last #{msgs.size} message(s):\n#{lines.join("\n")}")
+            :handled
+          end
+
+          def handle_draft(input)
+            arg = input.split(nil, 2)[1]
+            case arg
+            when nil
+              content = @draft ? "Draft: #{@draft}" : 'No draft saved.'
+              @message_stream.add_message(role: :system, content: content)
+            when 'clear'
+              @draft = nil
+              @message_stream.add_message(role: :system, content: 'Draft cleared.')
+            when 'send'
+              return draft_send
+            else
+              @draft = arg
+              @message_stream.add_message(role: :system, content: "Draft saved: #{@draft}")
+            end
+            :handled
+          end
+
+          def draft_send
+            unless @draft
+              @message_stream.add_message(role: :system, content: 'No draft to send.')
+              return :handled
+            end
+
+            text = @draft
+            @draft = nil
+            handle_user_message(text)
+            :handled
+          end
+
+          def handle_revise(input)
+            new_content = input.split(nil, 2)[1]
+            unless new_content
+              @message_stream.add_message(role: :system, content: 'Usage: /revise <new content>')
+              return :handled
+            end
+
+            msg = @message_stream.messages.reverse.find { |m| m[:role] == :user }
+            unless msg
+              @message_stream.add_message(role: :system, content: 'No user message to revise.')
+              return :handled
+            end
+
+            msg[:content] = new_content
+            @message_stream.add_message(role: :system, content: "Revised: #{new_content}")
+            :handled
+          end
         end
       end
     end

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

@@ -37,6 +37,12 @@ module Legion
 
           CALC_SAFE_PATTERN = %r{\A[\d\s+\-*/.()%]*\z}
           CALC_MATH_PATTERN = %r{\A[\d\s+\-*/.()%]*(Math\.\w+\([\d\s+\-*/.()%,]*\)[\d\s+\-*/.()%]*)*\z}
+          FREQ_STOP_WORDS = %w[
+            the a an is are was were be been have has had do does did will would could should
+            may might can shall to of in for on with at by from it this that i you we they
+            he she my your our their and or but not no if then so as
+          ].freeze
+          FREQ_ROW_FMT = '  %<rank>2d. %-<word>20s %<count>5d  %<pct>5.1f%%'
 
           private
 
@@ -637,6 +643,215 @@ module Legion
             end
             :handled
           end
+
+          def handle_color(input)
+            arg = input.split(nil, 2)[1]&.strip
+            new_state = case arg
+                        when 'on'  then true
+                        when 'off' then false
+                        else            !@message_stream.colorize
+                        end
+            @message_stream.colorize = new_state
+            state_label = new_state ? 'ON' : 'OFF'
+            @message_stream.add_message(role: :system, content: "Color output #{state_label}.")
+            :handled
+          end
+
+          def handle_timestamps(input)
+            arg = input.split(nil, 2)[1]&.strip
+            new_state = case arg
+                        when 'on'  then true
+                        when 'off' then false
+                        else            !@message_stream.show_timestamps
+                        end
+            @message_stream.show_timestamps = new_state
+            state_label = new_state ? 'ON' : 'OFF'
+            @message_stream.add_message(role: :system, content: "Timestamps #{state_label}.")
+            :handled
+          end
+
+          def handle_top
+            @message_stream.scroll_up(@message_stream.messages.size * 5)
+            :handled
+          end
+
+          def handle_bottom
+            @message_stream.scroll_down(@message_stream.scroll_offset)
+            :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?
+              @message_stream.add_message(role: :system, content: 'No words to analyse.')
+              return :handled
+            end
+
+            top = words.tally.sort_by { |_, c| -c }.first(20)
+            header = '    #  word                 count      %'
+            lines = format_freq_lines(top, words.size)
+            @message_stream.add_message(role: :system,
+                                        content: "Word frequency (top #{top.size}):\n#{header}\n#{lines.join("\n")}")
+            :handled
+          end
+
+          def collect_freq_words
+            @message_stream.messages
+                           .flat_map { |m| m[:content].to_s.downcase.scan(/[a-z']+/) }
+                           .reject { |w| FREQ_STOP_WORDS.include?(w) || w.length < 2 }
+          end
+
+          def format_freq_lines(top, total)
+            top.map.with_index(1) do |(word, count), rank|
+              pct = (count.to_f / total * 100).round(1)
+              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

@@ -41,7 +41,14 @@ module Legion
                             /echo /env
                             /ls /pwd
                             /wrap /number
-                            /speak /silent].freeze
+                            /speak /silent
+                            /color /timestamps
+                            /top /bottom /head /tail
+                            /draft /revise
+                            /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.',
@@ -85,6 +92,7 @@ module Legion
           @multiline_mode = false
           @speak_mode = false
           @silent_mode = false
+          @draft = nil
         end
 
         # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
@@ -477,6 +485,22 @@ module Legion
           when '/number' then handle_number(input)
           when '/speak' then handle_speak(input)
           when '/silent' then handle_silent
+          when '/color' then handle_color(input)
+          when '/timestamps' then handle_timestamps(input)
+          when '/top' then handle_top
+          when '/bottom' then handle_bottom
+          when '/head' then handle_head(input)
+          when '/tail' then handle_tail(input)
+          when '/draft' then handle_draft(input)
+          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.23'
+    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.23
+  version: 0.4.25
 platform: ruby
 authors:
 - Esity