legion-tty 0.4.23 → 0.4.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f33a9d4d3640c42054bc91b873ec04898386dc635d5b3097e037c7695a3a9594
-  data.tar.gz: 469499bb265ededb47d2c1a03778174b8cae152a163808ba5a606b1aaa3b94ee
+  metadata.gz: ab1a18bdbec9078051e19b84ede94cdaacb600ed12006674dc5696f711230349
+  data.tar.gz: 6735876baede0f4fd45637f6a5cb0cef4284f7117298fa96cb97c8ca667a23d4
 SHA512:
-  metadata.gz: 79090a1ed32486fa0e15f59312d34ee601c8cc92e8d596ccffda4cc7951cedd3d8461801b90669c1a34d22b32caa6c794836d7dc00633636d64c940dfc757633
-  data.tar.gz: 3ccb8fde2f3e285cbed4f06ddc46132d9f5fd45bad3c5cc5a80d22bca704c2a8e1e90bf799e8e7095228fe1c1330318156792392a67ddcaba4b3eea9f439d094
+  metadata.gz: '01294f74d7805fb5aad66aa1538ffe38cb1f8b407aaaa662d90cacaf7f8c0b4e787257636007f8a74e88e1e13b76a5432da4a2ff47aad0dd5b6f81852116ddfb'
+  data.tar.gz: 789298565c5285d7ef1787fd7dfbf8034b181f57f3cab243cd4b424712b0ec7251836e8c8f5ff3b79faf4b0d98c5416e919e8cf80c42df09adbe443d5b77905f

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [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/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,70 @@ 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_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
         end
       end
     end

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

@@ -41,7 +41,11 @@ module Legion
                             /echo /env
                             /ls /pwd
                             /wrap /number
-                            /speak /silent].freeze
+                            /speak /silent
+                            /color /timestamps
+                            /top /bottom /head /tail
+                            /draft /revise
+                            /mark /freq].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -85,6 +89,7 @@ module Legion
           @multiline_mode = false
           @speak_mode = false
           @silent_mode = false
+          @draft = nil
         end
 
         # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
@@ -477,6 +482,16 @@ 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
           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.24'
   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.24
 platform: ruby
 authors:
 - Esity