legion-tty 0.4.19 → 0.4.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34931409185817b874f6234bb8e81b3fb9144764b53273b990e6c64168f0f087
-  data.tar.gz: 84e0e03f8dffb27b927792c5d53d49843206fc9a0b88a859b5f6cab190df29e0
+  metadata.gz: 45ef88ce519140b5056ce0b934f3c3512781a4f26e30dc74203c431e6f20cc3c
+  data.tar.gz: ba632f83ea2022683c097b5451849bf129287c46959a050a8db90b356abe1f29
 SHA512:
-  metadata.gz: b2005ab12dbb4159e9ec13118de48de9a3dfc3b555f3bceb3ccde24cf4d2466836d33d157eb2558b3303f5e61b597e3894bdb910fe9d043cc2057f6b53647392
-  data.tar.gz: b9db6191d5b9425f1fa2eb16b222bf96937d702439432199a948a56b44a14a2b6826e14f5f49ca570885b3f3dd91dd3e56c5de378a337d8b719e887f62134823
+  metadata.gz: affafac87b03a47e29ae08bfe5815ba9eb8f72de5fc3feda9350b2871021537f6319261177de1a20f349b8d38cda3295d6b5cca6ff941dbe9414744fa27562e5
+  data.tar.gz: bf14853b34688cd959cf6301a56542ec9448fc9f4db2fb2489e7c6aeec3d56e08fc6e44c1627dc31c33631a8b9291717786032dee7ab72b566c545693ca2b57e

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.4.22] - 2026-03-19
+
+### Added
+- `/truncate [N|off]` command: display-only truncation of long messages (preserves originals)
+- `/archive [name]` command: archive session to `~/.legionio/archives/` with timestamp and start fresh
+- `/archives` command: list all archived sessions with file sizes
+- `/tee <path>` command: copy new messages to file in real-time (like Unix tee)
+- `/pipe <command>` command: pipe last assistant response through a shell command
+- `/calc <expression>` command: safe math expression evaluator with Math functions
+- `/rand [N|min..max]` command: generate random numbers (float, integer, or range)
+
+## [0.4.21] - 2026-03-19
+
+### Added
+- `/annotate [N] <text>` command: add notes/annotations to specific messages with timestamps
+- `/annotations` command: list all annotated messages with their notes
+- `/filter [role|tag|pinned|clear]` command: filter displayed messages by role, tag, or pinned status
+- `/multiline` command: toggle multi-line input mode (submit with empty line)
+- `/export yaml` format: export chat history as YAML alongside existing md/json/html formats
+- Annotation rendering in message stream (displayed after reactions)
+- `[ML]` status bar indicator for multi-line input mode
+
+## [0.4.20] - 2026-03-19
+
+### Added
+- `/prompt save|load|list|delete` command: persist and reuse custom system prompts
+- `/reset` command: reset session to clean state (clears messages, modes, aliases, macros)
+- `/replace old >>> new` command: find and replace text across all messages
+- `/highlight` command: highlight text patterns in message rendering with ANSI color
+
 ## [0.4.19] - 2026-03-19
 
 ### Added

data/lib/legion/tty/app.rb

@@ -132,7 +132,7 @@ module Legion
 
       private
 
-      def boot_legion_subsystems # rubocop:disable Metrics/MethodLength
+      def boot_legion_subsystems
         # Follow the same init order as Legion::Service:
         # 1. logging  2. settings  3. crypt  4. resolve secrets  5. LLM merge
         require 'legion/logging'

data/lib/legion/tty/background/github_probe.rb

@@ -39,7 +39,7 @@ module Legion
         end
         # rubocop:enable Metrics/AbcSize
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:disable Metrics/AbcSize
         def run_async(queue, remotes: [], quick_profile: nil)
           Thread.new do
             @log&.log('github', "probing with #{remotes.size} remotes: #{remotes.first(5).inspect}")
@@ -59,7 +59,7 @@ module Legion
             queue.push({ type: :github_error, error: e.message })
           end
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:enable Metrics/AbcSize
 
         private
 
@@ -282,7 +282,6 @@ module Legion
 
         # --- Token resolution ---
 
-        # rubocop:disable Metrics/CyclomaticComplexity
         def resolve_token
           env_token = ENV.fetch('GITHUB_TOKEN', nil) ||
                       ENV.fetch('GH_TOKEN', nil) ||
@@ -301,9 +300,7 @@ module Legion
           @log&.log('github', 'no token found (no env var, no gh CLI)')
           nil
         end
-        # rubocop:enable Metrics/CyclomaticComplexity
 
-        # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
         def token_from_gh_cli
           gh_path = `which gh 2>/dev/null`.strip
           return nil if gh_path.empty?
@@ -322,8 +319,6 @@ module Legion
           @log&.log('github', "gh CLI error: #{e.message}")
           nil
         end
-        # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-
         # --- HTTP ---
 
         def api_get(path)

data/lib/legion/tty/background/kerberos_probe.rb

@@ -62,7 +62,6 @@ module Legion
           query_ldap(username: username, host: dc_host, base_dn: base_dn)
         end
 
-        # rubocop:disable Metrics/CyclomaticComplexity
         def discover_dc(realm)
           domain = realm.downcase
           srv_name = "_ldap._tcp.#{domain}"
@@ -74,7 +73,6 @@ module Legion
           @log&.log('kerberos', "SRV lookup failed: #{e.message}")
           nil
         end
-        # rubocop:enable Metrics/CyclomaticComplexity
 
         def realm_to_base_dn(realm)
           realm.downcase.split('.').map { |part| "DC=#{part}" }.join(',')
@@ -149,7 +147,7 @@ module Legion
           }.compact
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+        # rubocop:disable Metrics/AbcSize
         def calculate_tenure(when_created)
           return nil unless when_created&.length&.>=(8)
 
@@ -184,7 +182,7 @@ module Legion
 
           { years: years, months: months, days: days }
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+        # rubocop:enable Metrics/AbcSize
 
         def days_in_month(month, year)
           Time.new(year, month, -1).day

data/lib/legion/tty/background/scanner.rb

@@ -93,7 +93,6 @@ module Legion
           false
         end
 
-        # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
         def collect_repos(base, depth = 0)
           return [] unless File.directory?(base)
           return [build_repo_entry(base)] if File.directory?(File.join(base, '.git'))
@@ -110,7 +109,6 @@ module Legion
         rescue StandardError
           []
         end
-        # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
         def build_repo_entry(path)
           { path: path, name: File.basename(path), remote: git_remote(path),

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

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'English'
 require_relative '../theme'
 
 module Legion
@@ -8,12 +9,16 @@ module Legion
       # rubocop:disable Metrics/ClassLength
       class MessageStream
         attr_reader :messages, :scroll_offset
-        attr_accessor :mute_system
+        attr_accessor :mute_system, :highlights, :filter, :truncate_limit
+
+        HIGHLIGHT_COLOR = "\e[1;33m"
+        HIGHLIGHT_RESET = "\e[0m"
 
         def initialize
           @messages = []
           @scroll_offset = 0
           @mute_system = false
+          @highlights = []
         end
 
         def add_message(role:, content:)
@@ -72,13 +77,28 @@ module Legion
         private
 
         def build_all_lines(width)
-          @messages.flat_map do |msg|
+          filtered_messages.flat_map do |msg|
             next [] if @mute_system && msg[:role] == :system
 
             render_message(msg, width)
           end
         end
 
+        def filtered_messages
+          return @messages if @filter.nil?
+
+          case @filter[:type]
+          when :role
+            @messages.select { |m| m[:role].to_s == @filter[:value].to_s }
+          when :tag
+            @messages.select { |m| (m[:tags] || []).include?(@filter[:value]) }
+          when :pinned
+            @messages.select { |m| m[:pinned] }
+          else
+            @messages
+          end
+        end
+
         def render_message(msg, width)
           role_lines(msg, width) + panel_lines(msg, width)
         end
@@ -96,8 +116,10 @@ module Legion
         def user_lines(msg, _width)
           ts = format_timestamp(msg[:timestamp])
           header = "#{Theme.c(:accent, 'You')} #{Theme.c(:muted, ts)}"
-          lines = ['', "#{header}: #{msg[:content]}"]
+          content = apply_highlights(msg[:content].to_s)
+          lines = ['', "#{header}: #{content}"]
           lines << reaction_line(msg) if msg[:reactions]&.any?
+          lines.concat(annotation_lines(msg)) if msg[:annotations]&.any?
           lines
         end
 
@@ -108,17 +130,34 @@ module Legion
         end
 
         def assistant_lines(msg, width)
-          rendered = render_markdown(msg[:content], width)
+          content = display_content(msg[:content])
+          rendered = render_markdown(content, width)
+          rendered = apply_highlights(rendered)
           lines = ['', *rendered.split("\n")]
           lines << reaction_line(msg) if msg[:reactions]&.any?
+          lines.concat(annotation_lines(msg)) if msg[:annotations]&.any?
           lines
         end
 
+        def display_content(content)
+          return content unless @truncate_limit
+          return content if content.to_s.length <= @truncate_limit
+
+          "#{content[0...@truncate_limit]}... [truncated]"
+        end
+
         def reaction_line(msg)
           reactions = msg[:reactions].map { |r| "[#{r}]" }.join(' ')
           "  #{Theme.c(:muted, reactions)}"
         end
 
+        def annotation_lines(msg)
+          msg[:annotations].map do |a|
+            ts = a[:timestamp].to_s[11..15] || ''
+            "  #{Theme.c(:muted, "note [#{ts}]: #{a[:text]}")}"
+          end
+        end
+
         def render_markdown(text, width)
           require_relative 'markdown_view'
           MarkdownView.render(text, width: width)
@@ -140,6 +179,16 @@ module Legion
           msg[:tool_panels].flat_map { |panel| panel.render(width: width).split("\n") }
         end
 
+        def apply_highlights(text)
+          return text if @highlights.nil? || @highlights.empty?
+
+          @highlights.reduce(text) do |result, pattern|
+            result.gsub(pattern) { "#{HIGHLIGHT_COLOR}#{$LAST_MATCH_INFO}#{HIGHLIGHT_RESET}" }
+          end
+        rescue StandardError
+          text
+        end
+
         def apply_tool_panel_update(panel, status:, duration:, result:, error:)
           panel.instance_variable_set(:@status, status)
           panel.instance_variable_set(:@duration, duration) if duration

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

@@ -9,7 +9,7 @@ module Legion
           @current_model = current_model
         end
 
-        def available_models # rubocop:disable Metrics/CyclomaticComplexity
+        def available_models
           return [] unless defined?(Legion::LLM) && Legion::LLM.respond_to?(:settings)
 
           providers = Legion::LLM.settings[:providers]

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

@@ -10,7 +10,7 @@ module Legion
       class StatusBar
         def initialize
           @state = { model: nil, tokens: 0, cost: 0.0, session: 'default', thinking: false, plan_mode: false,
-                     debug_mode: false, message_count: 0 }
+                     debug_mode: false, message_count: 0, multiline: false }
           @notifications = []
         end
 
@@ -42,6 +42,7 @@ module Legion
           [
             model_segment,
             plan_segment,
+            multiline_segment,
             debug_segment,
             thinking_segment,
             notification_segment,
@@ -63,6 +64,12 @@ module Legion
           Theme.c(:warning, '[PLAN]')
         end
 
+        def multiline_segment
+          return nil unless @state[:multiline]
+
+          Theme.c(:accent, '[ML]')
+        end
+
         def debug_segment
           return nil unless @state[:debug_mode]
 

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

@@ -4,7 +4,6 @@ module Legion
   module TTY
     module Screens
       class Chat < Base
-        # rubocop:disable Metrics/ModuleLength
         module CustomCommands
           TEMPLATES = {
             'explain' => 'Explain the following concept in simple terms: ',
@@ -19,7 +18,6 @@ module Legion
 
           private
 
-          # rubocop:disable Metrics/MethodLength
           def handle_template(input)
             name = input.split(nil, 2)[1]
             unless name
@@ -47,7 +45,6 @@ module Legion
             )
             :handled
           end
-          # rubocop:enable Metrics/MethodLength
 
           def handle_alias(input)
             parts = input.split(nil, 3)
@@ -97,6 +94,103 @@ module Legion
             :handled
           end
 
+          def handle_prompt(input)
+            parts = input.split(nil, 3)
+            subcommand = parts[1]
+            name = parts[2]
+
+            case subcommand
+            when 'save'
+              prompt_save(name)
+            when 'load'
+              prompt_load(name)
+            when 'list'
+              prompt_list
+            when 'delete'
+              prompt_delete(name)
+            else
+              @message_stream.add_message(
+                role: :system,
+                content: 'Usage: /prompt save|load|list|delete <name>'
+              )
+            end
+            :handled
+          end
+
+          def prompt_dir
+            File.expand_path('~/.legionio/prompts')
+          end
+
+          def prompt_save(name)
+            unless name
+              @message_stream.add_message(role: :system, content: 'Usage: /prompt save <name>')
+              return
+            end
+
+            current = @llm_chat.respond_to?(:instructions) ? @llm_chat.instructions.to_s : ''
+            if current.empty?
+              @message_stream.add_message(role: :system, content: 'No system prompt is currently set.')
+              return
+            end
+
+            require 'fileutils'
+            FileUtils.mkdir_p(prompt_dir)
+            path = File.join(prompt_dir, "#{name}.txt")
+            File.write(path, current)
+            @message_stream.add_message(role: :system, content: "Prompt '#{name}' saved.")
+          end
+
+          def prompt_load(name)
+            unless name
+              @message_stream.add_message(role: :system, content: 'Usage: /prompt load <name>')
+              return
+            end
+
+            path = File.join(prompt_dir, "#{name}.txt")
+            unless File.exist?(path)
+              @message_stream.add_message(role: :system, content: "Prompt '#{name}' not found.")
+              return
+            end
+
+            content = File.read(path)
+            @llm_chat.with_instructions(content) if @llm_chat.respond_to?(:with_instructions)
+            @message_stream.add_message(role: :system, content: "Prompt '#{name}' loaded as system prompt.")
+          end
+
+          # rubocop:disable Metrics/AbcSize
+          def prompt_list
+            disk_prompts = Dir.glob(File.join(prompt_dir, '*.txt')).map { |f| File.basename(f, '.txt') }.sort
+
+            if disk_prompts.empty?
+              @message_stream.add_message(role: :system, content: 'No prompts saved.')
+              return
+            end
+
+            lines = disk_prompts.map do |pname|
+              path = File.join(prompt_dir, "#{pname}.txt")
+              preview = File.exist?(path) ? truncate_text(File.read(path), 60) : ''
+              "  #{pname}: #{preview}"
+            end
+            @message_stream.add_message(role: :system,
+                                        content: "Prompts (#{disk_prompts.size}):\n#{lines.join("\n")}")
+          end
+          # rubocop:enable Metrics/AbcSize
+
+          def prompt_delete(name)
+            unless name
+              @message_stream.add_message(role: :system, content: 'Usage: /prompt delete <name>')
+              return
+            end
+
+            path = File.join(prompt_dir, "#{name}.txt")
+            if File.exist?(path)
+              File.delete(path)
+              @message_stream.add_message(role: :system, content: "Prompt '#{name}' deleted.")
+            else
+              @message_stream.add_message(role: :system, content: "Prompt '#{name}' not found.")
+            end
+          end
+
           def snippet_dir
             File.expand_path('~/.legionio/snippets')
           end
@@ -166,7 +260,6 @@ module Legion
           end
           # rubocop:enable Metrics/AbcSize
 
-          # rubocop:disable Metrics/MethodLength
           def handle_macro(input)
             parts = input.split(nil, 3)
             subcommand = parts[1]
@@ -191,7 +284,6 @@ module Legion
             end
             :handled
           end
-          # rubocop:enable Metrics/MethodLength
 
           def macro_record(name)
             unless name
@@ -281,7 +373,7 @@ module Legion
             end
           end
 
-          # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+          # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
           def handle_chain(input)
             args = input.split(nil, 2)[1]
             unless args
@@ -315,9 +407,8 @@ module Legion
             )
             :handled
           end
-          # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+          # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
         end
-        # rubocop:enable Metrics/ModuleLength
       end
     end
   end

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

@@ -21,19 +21,22 @@ module Legion
 
           def build_export_path(input)
             format = input.split[1]&.downcase
-            format = 'md' unless %w[json md html].include?(format)
+            format = 'md' unless %w[json md html yaml].include?(format)
             exports_dir = File.expand_path('~/.legionio/exports')
             FileUtils.mkdir_p(exports_dir)
             timestamp = Time.now.strftime('%Y%m%d-%H%M%S')
-            ext = { 'json' => 'json', 'md' => 'md', 'html' => 'html' }[format]
+            ext = { 'json' => 'json', 'md' => 'md', 'html' => 'html', 'yaml' => 'yaml' }[format]
             File.join(exports_dir, "chat-#{timestamp}.#{ext}")
           end
 
           def dispatch_export(path, format)
-            if format == 'json'
+            case format
+            when 'json'
               export_json(path)
-            elsif format == 'html'
+            when 'html'
               export_html(path)
+            when 'yaml'
+              export_yaml(path)
             else
               export_markdown(path)
             end
@@ -58,6 +61,17 @@ module Legion
             File.write(path, ::JSON.pretty_generate(data))
           end
 
+          def export_yaml(path)
+            require 'yaml'
+            data = {
+              'exported_at' => Time.now.iso8601,
+              'messages' => @message_stream.messages.map do |m|
+                { 'role' => m[:role].to_s, 'content' => m[:content], 'timestamp' => m[:timestamp]&.iso8601 }
+              end
+            }
+            File.write(path, ::YAML.dump(data))
+          end
+
           # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
           def export_html(path)
             lines = [
@@ -118,6 +132,35 @@ module Legion
             :handled
           end
           # rubocop:enable Metrics/AbcSize
+
+          def handle_tee(input)
+            arg = input.split(nil, 2)[1]
+            if arg.nil?
+              status = @tee_path ? "Tee active: #{@tee_path}" : 'Tee inactive.'
+              @message_stream.add_message(role: :system, content: status)
+              return :handled
+            end
+
+            if arg.strip == 'off'
+              @tee_path = nil
+              @message_stream.add_message(role: :system, content: 'Tee stopped.')
+            else
+              @tee_path = File.expand_path(arg.strip)
+              @message_stream.add_message(role: :system, content: "Tee started: #{@tee_path}")
+            end
+            :handled
+          rescue StandardError => e
+            @message_stream.add_message(role: :system, content: "Tee error: #{e.message}")
+            :handled
+          end
+
+          def tee_message(line)
+            return unless @tee_path
+
+            File.open(@tee_path, 'a') { |f| f.puts(line) }
+          rescue StandardError
+            nil
+          end
         end
       end
     end

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

@@ -4,7 +4,6 @@ module Legion
   module TTY
     module Screens
       class Chat < Base
-        # rubocop:disable Metrics/ModuleLength
         module MessageCommands
           private
 
@@ -248,6 +247,41 @@ module Legion
             :handled
           end
 
+          def handle_replace(input)
+            args = input.split(nil, 2)[1]
+            unless args&.include?(' >>> ')
+              @message_stream.add_message(role: :system, content: 'Usage: /replace old >>> new')
+              return :handled
+            end
+
+            parts = args.split(' >>> ', 2)
+            count = apply_replace(parts[0], parts[1] || '')
+            report_replace_result(count, parts[0], parts[1] || '')
+            :handled
+          end
+
+          def apply_replace(old_text, new_text)
+            count = 0
+            @message_stream.messages.each do |msg|
+              next unless msg[:content].is_a?(::String) && msg[:content].include?(old_text)
+
+              count += msg[:content].scan(old_text).size
+              msg[:content] = msg[:content].gsub(old_text, new_text)
+            end
+            count
+          end
+
+          def report_replace_result(count, old_text, new_text)
+            if count.zero?
+              @message_stream.add_message(role: :system, content: "No occurrences of '#{old_text}' found.")
+            else
+              @message_stream.add_message(
+                role: :system,
+                content: "Replaced #{count} occurrence#{'s' unless count == 1} of '#{old_text}' with '#{new_text}'."
+              )
+            end
+          end
+
           def search_messages(query)
             pattern = query.downcase
             @message_stream.messages.select do |msg|
@@ -367,7 +401,7 @@ module Legion
             File.write(favorites_file, ::JSON.generate(favs))
           end
 
-          # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          # rubocop:disable Metrics/AbcSize
           def handle_fav(input)
             idx_str = input.split(nil, 2)[1]
             msg = if idx_str
@@ -393,7 +427,51 @@ module Legion
             @message_stream.add_message(role: :system, content: "Favorited: #{preview}")
             :handled
           end
-          # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+          # rubocop:enable Metrics/AbcSize
+
+          # rubocop:disable Metrics/AbcSize
+          def handle_annotate(input)
+            parts = input.split(nil, 3)
+            if parts.size >= 3 && parts[1].match?(/\A\d+\z/)
+              idx = parts[1].to_i
+              text = parts[2]
+              msg = @message_stream.messages[idx]
+            elsif parts.size == 2 && !parts[1].match?(/\A\d+\z/)
+              text = parts[1]
+              msg = @message_stream.messages.reverse.find { |m| m[:role] == :assistant }
+            elsif parts.size >= 3
+              text = parts[1..].join(' ')
+              msg = @message_stream.messages.reverse.find { |m| m[:role] == :assistant }
+            else
+              @message_stream.add_message(role: :system, content: 'Usage: /annotate [N] <text>')
+              return :handled
+            end
+
+            unless msg
+              @message_stream.add_message(role: :system, content: 'No message to annotate.')
+              return :handled
+            end
+
+            msg[:annotations] ||= []
+            msg[:annotations] << { text: text, timestamp: Time.now.iso8601 }
+            @message_stream.add_message(role: :system, content: "Annotation added: #{text}")
+            :handled
+          end
+          # rubocop:enable Metrics/AbcSize
+
+          def handle_annotations(_input)
+            annotated = @message_stream.messages.each_with_index.select { |m, _| m[:annotations]&.any? }
+            if annotated.empty?
+              @message_stream.add_message(role: :system, content: 'No annotated messages.')
+              return :handled
+            end
+
+            lines = annotated.flat_map do |msg, idx|
+              msg[:annotations].map { |a| "  [#{idx}][#{msg[:role]}] #{a[:text]} (#{a[:timestamp]})" }
+            end
+            @message_stream.add_message(role: :system, content: "Annotations:\n#{lines.join("\n")}")
+            :handled
+          end
 
           def handle_favs
             all_favs = load_favorites
@@ -412,8 +490,77 @@ module Legion
             )
             :handled
           end
+
+          def handle_filter(input)
+            parts = input.split(nil, 3)
+            subcommand = parts[1]
+            case subcommand
+            when 'role'
+              apply_role_filter(parts[2])
+            when 'tag'
+              apply_tag_filter(parts[2])
+            when 'pinned'
+              @message_stream.filter = { type: :pinned }
+              @message_stream.add_message(role: :system, content: 'Filter: pinned messages only.')
+            when 'clear'
+              @message_stream.filter = nil
+              @message_stream.add_message(role: :system, content: 'Filter cleared.')
+            when nil
+              show_filter_status
+            else
+              @message_stream.add_message(
+                role: :system,
+                content: 'Usage: /filter [role|tag|pinned|clear] [value]'
+              )
+            end
+            :handled
+          end
+
+          def apply_role_filter(value)
+            unless value
+              @message_stream.add_message(role: :system, content: 'Usage: /filter role <user|assistant|system>')
+              return
+            end
+
+            @message_stream.filter = { type: :role, value: value }
+            @message_stream.add_message(role: :system, content: "Filter: role=#{value}.")
+          end
+
+          def apply_tag_filter(value)
+            unless value
+              @message_stream.add_message(role: :system, content: 'Usage: /filter tag <label>')
+              return
+            end
+
+            @message_stream.filter = { type: :tag, value: value }
+            @message_stream.add_message(role: :system, content: "Filter: tag=#{value}.")
+          end
+
+          def show_filter_status
+            f = @message_stream.filter
+            content = if f.nil?
+                        'No active filter.'
+                      elsif f[:type] == :pinned
+                        'Active filter: pinned.'
+                      else
+                        "Active filter: #{f[:type]}=#{f[:value]}."
+                      end
+            @message_stream.add_message(role: :system, content: content)
+          end
+
+          def handle_truncate(input)
+            n = (input.split(nil, 2)[1] || '10').to_i.clamp(1, 500)
+            msgs = @message_stream.messages
+            if msgs.size <= n
+              @message_stream.add_message(role: :system, content: "Already #{msgs.size} messages (<=#{n}).")
+              return :handled
+            end
+
+            @message_stream.messages.replace(msgs.last(n))
+            @message_stream.add_message(role: :system, content: "Truncated to last #{n} messages.")
+            :handled
+          end
         end
-        # rubocop:enable Metrics/ModuleLength
       end
     end
   end

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

@@ -4,7 +4,6 @@ module Legion
   module TTY
     module Screens
       class Chat < Base
-        # rubocop:disable Metrics/ModuleLength
         module ModelCommands
           private
 
@@ -134,7 +133,6 @@ module Legion
             :handled
           end
         end
-        # rubocop:enable Metrics/ModuleLength
       end
     end
   end

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

@@ -4,7 +4,6 @@ module Legion
   module TTY
     module Screens
       class Chat < Base
-        # rubocop:disable Metrics/ModuleLength
         module SessionCommands
           private
 
@@ -211,6 +210,56 @@ module Legion
           end
           # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
 
+          def handle_reset
+            @message_stream.messages.clear
+            @plan_mode = false
+            @focus_mode = false
+            @debug_mode = false
+            @muted_system = false
+            @pinned_messages = []
+            @aliases = {}
+            @macros = {}
+            @recording_macro = nil
+            @macro_buffer = []
+            @session_name = 'default'
+            @status_bar.update(session: 'default', plan_mode: false, debug_mode: false)
+            cfg = safe_config
+            @message_stream.add_message(
+              role: :system,
+              content: "Welcome#{", #{cfg[:name]}" if cfg[:name]}. Type /help for commands."
+            )
+            @status_bar.notify(message: 'Session reset', level: :info, ttl: 3)
+            :handled
+          end
+
+          def handle_archive(input)
+            name = input.split(nil, 2)[1] || "#{@session_name}-#{Time.now.strftime('%Y%m%d-%H%M%S')}"
+            archive_dir = File.expand_path('~/.legionio/archives')
+            FileUtils.mkdir_p(archive_dir)
+            path = File.join(archive_dir, "#{name}.json")
+            data = { name: name, messages: @message_stream.messages, archived_at: Time.now.iso8601 }
+            File.write(path, ::JSON.generate(data))
+            @message_stream.messages.clear
+            @message_stream.add_message(role: :system, content: "Session archived as: #{name}")
+            @status_bar.notify(message: "Archived: #{name}", level: :success, ttl: 3)
+            :handled
+          end
+
+          def handle_archives
+            archive_dir = File.expand_path('~/.legionio/archives')
+            files = Dir.glob(File.join(archive_dir, '*.json'))
+            if files.empty?
+              @message_stream.add_message(role: :system, content: 'No archives found.')
+            else
+              lines = files.sort.map do |f|
+                size = File.size(f)
+                "  #{File.basename(f, '.json')} (#{size} bytes)"
+              end
+              @message_stream.add_message(role: :system, content: "Archives:\n#{lines.join("\n")}")
+            end
+            :handled
+          end
+
           def handle_merge(input)
             name = input.split(nil, 2)[1]
             unless name
@@ -234,7 +283,6 @@ module Legion
             :handled
           end
         end
-        # rubocop:enable Metrics/ModuleLength
       end
     end
   end

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

@@ -4,7 +4,6 @@ module Legion
   module TTY
     module Screens
       class Chat < Base
-        # rubocop:disable Metrics/ModuleLength
         module UiCommands
           TIPS = [
             'Press Tab after / to auto-complete commands',
@@ -31,10 +30,14 @@ module Legion
             'NAV     : /dashboard /extensions /config /palette /hotkeys',
             'DISPLAY : /theme /plan /debug /context /time /uptime',
             'TOOLS   : /tools /export /bookmark /pin /pins /alias /snippet /history',
+            'UTILS   : /calc /rand',
             '',
             'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back'
           ].freeze
 
+          CALC_SAFE_PATTERN = %r{\A[\d\s+\-*/.()%]*\z}
+          CALC_MATH_PATTERN = %r{\A[\d\s+\-*/.()%]*(Math\.\w+\([\d\s+\-*/.()%,]*\)[\d\s+\-*/.()%]*)*\z}
+
           private
 
           def handle_help
@@ -314,6 +317,39 @@ module Legion
             :handled
           end
 
+          def handle_truncate(input)
+            arg = input.split(nil, 2)[1]&.strip
+            if arg.nil?
+              status = @message_stream.truncate_limit ? "#{@message_stream.truncate_limit} chars" : 'off'
+              @message_stream.add_message(role: :system, content: "Truncation: #{status}")
+            elsif arg == 'off'
+              @message_stream.truncate_limit = nil
+              @message_stream.add_message(role: :system, content: 'Truncation disabled.')
+            else
+              limit = arg.to_i
+              if limit.positive?
+                @message_stream.truncate_limit = limit
+                @message_stream.add_message(role: :system, content: "Truncation set to #{limit} chars.")
+              else
+                @message_stream.add_message(role: :system, content: 'Usage: /truncate [N|off]')
+              end
+            end
+            :handled
+          end
+
+          def handle_multiline
+            @multiline_mode = !@multiline_mode
+            if @multiline_mode
+              @status_bar.update(multiline: true)
+              @message_stream.add_message(role: :system,
+                                          content: 'Multi-line mode ON. Submit with empty line.')
+            else
+              @status_bar.update(multiline: false)
+              @message_stream.add_message(role: :system, content: 'Multi-line mode OFF.')
+            end
+            :handled
+          end
+
           # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
           def handle_scroll(input)
             arg = input.split(nil, 2)[1]
@@ -351,7 +387,95 @@ module Legion
           end
           # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 
-          # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+          def handle_highlight(input)
+            arg = input.split(nil, 2)[1]
+            @highlights ||= []
+
+            unless arg
+              @message_stream.add_message(role: :system, content: 'Usage: /highlight <pattern> | clear | list')
+              return :handled
+            end
+
+            case arg.strip
+            when 'clear' then highlight_clear
+            when 'list'  then highlight_list
+            else              highlight_add(arg.strip)
+            end
+            :handled
+          end
+
+          def highlight_clear
+            @highlights = []
+            @message_stream.highlights = @highlights
+            @message_stream.add_message(role: :system, content: 'Highlights cleared.')
+          end
+
+          def highlight_list
+            if @highlights.empty?
+              @message_stream.add_message(role: :system, content: 'No active highlights.')
+            else
+              lines = @highlights.each_with_index.map { |p, i| "  #{i + 1}. #{p}" }
+              @message_stream.add_message(role: :system,
+                                          content: "Active highlights (#{@highlights.size}):\n#{lines.join("\n")}")
+            end
+          end
+
+          def highlight_add(pattern)
+            @highlights << pattern
+            @message_stream.highlights = @highlights
+            @message_stream.add_message(role: :system, content: "Highlight added: '#{pattern}'")
+          end
+
+          def handle_calc(input)
+            expr = input.split(nil, 2)[1]&.strip
+            unless expr
+              @message_stream.add_message(role: :system, content: 'Usage: /calc <expression>')
+              return :handled
+            end
+
+            unless safe_calc_expr?(expr)
+              @message_stream.add_message(role: :system, content: "Unsafe expression blocked: #{expr}")
+              return :handled
+            end
+
+            result = binding.send(:eval, expr)
+            @message_stream.add_message(role: :system, content: "= #{result}")
+            :handled
+          rescue SyntaxError, ZeroDivisionError, Math::DomainError => e
+            @message_stream.add_message(role: :system, content: "Error: #{e.message}")
+            :handled
+          end
+
+          def handle_rand(input)
+            arg = input.split(nil, 2)[1]&.strip
+            result = parse_rand_arg(arg)
+            if result == :invalid
+              @message_stream.add_message(role: :system, content: 'Usage: /rand [N|min..max]')
+              return :handled
+            end
+
+            @message_stream.add_message(role: :system, content: "Random: #{result}")
+            :handled
+          end
+
+          def parse_rand_arg(arg)
+            if arg.nil? || arg.empty?
+              rand
+            elsif arg.match?(/\A\d+\.\.\d+\z/)
+              parts = arg.split('..').map(&:to_i)
+              rand(parts[0]..parts[1])
+            elsif arg.match?(/\A\d+\z/)
+              rand(arg.to_i)
+            else
+              :invalid
+            end
+          end
+
+          def safe_calc_expr?(expr)
+            CALC_SAFE_PATTERN.match?(expr) || CALC_MATH_PATTERN.match?(expr)
+          end
+
+          # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
           def handle_summary
             msgs = @message_stream.messages
             elapsed = Time.now - @session_start
@@ -384,9 +508,40 @@ module Legion
             @message_stream.add_message(role: :system, content: lines.join("\n"))
             :handled
           end
-          # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+          # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
+          def handle_pipe(input)
+            cmd = input.split(nil, 2)[1]
+            unless cmd
+              @message_stream.add_message(role: :system, content: 'Usage: /pipe <shell command>')
+              return :handled
+            end
+
+            last_msg = @message_stream.messages.select { |m| m[:role] == :assistant }.last
+            unless last_msg
+              @message_stream.add_message(role: :system, content: 'No assistant message to pipe.')
+              return :handled
+            end
+
+            output = pipe_through_command(cmd, last_msg[:content].to_s)
+            @message_stream.add_message(role: :system, content: "pipe | #{cmd}:\n#{output}")
+            :handled
+          rescue StandardError => e
+            @message_stream.add_message(role: :system, content: "Pipe error: #{e.message}")
+            :handled
+          end
+
+          def pipe_through_command(cmd, content)
+            result = IO.popen(cmd, 'r+') do |io|
+              io.write(content)
+              io.close_write
+              io.read
+            end
+            result.to_s.chomp
+          rescue StandardError => e
+            raise "command failed: #{e.message}"
+          end
         end
-        # rubocop:enable Metrics/ModuleLength
       end
     end
   end

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

@@ -32,7 +32,12 @@ module Legion
                             /wc /import /mute /autosave /react /macro /tag /tags /repeat /count
                             /template /fav /favs /log /version
                             /focus /retry /merge /sort
-                            /chain /info /scroll /summary].freeze
+                            /chain /info /scroll /summary
+                            /prompt /reset /replace /highlight /multiline
+                            /annotate /annotations /filter /truncate
+                            /tee /pipe
+                            /archive /archives
+                            /calc /rand].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -72,6 +77,8 @@ module Legion
           @last_command = nil
           @focus_mode = false
           @last_user_input = nil
+          @highlights = []
+          @multiline_mode = false
         end
 
         # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
@@ -92,7 +99,7 @@ module Legion
           @running
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:disable Metrics/AbcSize
         def run
           activate
           while @running
@@ -115,7 +122,7 @@ module Legion
             end
           end
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:enable Metrics/AbcSize
 
         def handle_slash_command(input)
           return nil unless input.start_with?('/')
@@ -137,6 +144,7 @@ module Legion
         def handle_user_message(input)
           @last_user_input = input
           @message_stream.add_message(role: :user, content: input)
+          tee_message("[user] #{input}") if @tee_path
           if @plan_mode
             @message_stream.add_message(role: :system, content: '(bookmarked)')
           else
@@ -337,12 +345,27 @@ module Legion
 
         def read_input
           return nil unless @input_bar.respond_to?(:read_line)
+          return read_multiline_input if @multiline_mode
 
           @input_bar.read_line
         rescue Interrupt
           nil
         end
 
+        def read_multiline_input
+          lines = []
+          loop do
+            line = @input_bar.read_line
+            return nil if line.nil? && lines.empty?
+            break if line.nil? || line.empty?
+
+            lines << line
+          end
+          lines.empty? ? nil : lines.join("\n")
+        rescue Interrupt
+          nil
+        end
+
         # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
         def dispatch_slash(cmd, input)
           case cmd
@@ -410,6 +433,21 @@ module Legion
           when '/info' then handle_info
           when '/scroll' then handle_scroll(input)
           when '/summary' then handle_summary
+          when '/prompt' then handle_prompt(input)
+          when '/reset' then handle_reset
+          when '/replace' then handle_replace(input)
+          when '/highlight' then handle_highlight(input)
+          when '/multiline' then handle_multiline
+          when '/annotate' then handle_annotate(input)
+          when '/annotations' then handle_annotations(input)
+          when '/filter' then handle_filter(input)
+          when '/truncate' then handle_truncate(input)
+          when '/tee' then handle_tee(input)
+          when '/pipe' then handle_pipe(input)
+          when '/archive' then handle_archive(input)
+          when '/archives' then handle_archives
+          when '/calc' then handle_calc(input)
+          when '/rand' then handle_rand(input)
           else :handled
           end
         end
@@ -494,6 +532,7 @@ module Legion
           "[DEBUG] msgs:#{@message_stream.messages.size} " \
             "scroll:#{@message_stream.scroll_position&.dig(:current) || 0} " \
             "plan:#{@plan_mode} " \
+            "multiline:#{@multiline_mode} " \
             "personality:#{@personality || 'default'} " \
             "aliases:#{@aliases.size} " \
             "snippets:#{@snippets.size} " \

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

@@ -105,7 +105,7 @@ module Legion
           @viewing_file = true
         end
 
-        def edit_selected_key # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        def edit_selected_key # rubocop:disable Metrics/AbcSize
           keys = @file_data.keys
           return unless keys[@selected_key]
 

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

@@ -40,7 +40,7 @@ module Legion
 
         # rubocop:enable Metrics/AbcSize
 
-        # rubocop:disable Metrics/CyclomaticComplexity, Metrics/MethodLength
+        # rubocop:disable Metrics/CyclomaticComplexity
         def handle_input(key)
           case key
           when 'r', :f5
@@ -66,7 +66,7 @@ module Legion
           end
         end
 
-        # rubocop:enable Metrics/CyclomaticComplexity, Metrics/MethodLength
+        # rubocop:enable Metrics/CyclomaticComplexity
 
         def selected_panel
           PANELS[@selected_panel]
@@ -147,7 +147,7 @@ module Legion
 
         # rubocop:enable Metrics/AbcSize
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+        # rubocop:disable Metrics/AbcSize
         def render_system_panel(_width)
           sys = @cached_data[:system] || {}
           prefix = panel_prefix(:system)
@@ -161,7 +161,7 @@ module Legion
           lines
         end
 
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity
+        # rubocop:enable Metrics/AbcSize
 
         def render_activity_panel(_width, max_lines)
           activity = @cached_data[:activity] || []
@@ -219,7 +219,7 @@ module Legion
           :pass
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:disable Metrics/AbcSize
         def llm_info
           info = { provider: 'none', model: nil, started: false, daemon: false }
           if defined?(Legion::LLM)
@@ -237,7 +237,7 @@ module Legion
           info
         end
 
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:enable Metrics/AbcSize
 
         def probe_services
           require 'socket'

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

@@ -195,7 +195,7 @@ module Legion
           end
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        # rubocop:disable Metrics/AbcSize
         def run_gaia_awakening
           typed_output('Scanning for active cognition threads...')
           sleep 1.2
@@ -225,7 +225,7 @@ module Legion
 
           @output.puts
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+        # rubocop:enable Metrics/AbcSize
 
         def collect_background_results
           @log.log('collect', 'waiting for scanner results (10s timeout)')
@@ -438,7 +438,7 @@ module Legion
           end
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:disable Metrics/AbcSize
         def run_intro_with_github
           gh = @github_quick
           name = gh[:name] || gh[:username]
@@ -462,7 +462,7 @@ module Legion
 
           @output.puts
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:enable Metrics/AbcSize
 
         def collect_kerberos_identity
           @log.log('kerberos', 'collecting identity (2s timeout)')
@@ -475,7 +475,7 @@ module Legion
           end
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        # rubocop:disable Metrics/AbcSize
         def run_intro_with_identity
           id = @kerberos_identity
           typed_output("I see you, #{id[:first_name]}.")
@@ -505,7 +505,7 @@ module Legion
           @output.puts
           @output.puts
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+        # rubocop:enable Metrics/AbcSize
 
         def ask_for_name
           if @kerberos_identity
@@ -515,7 +515,7 @@ module Legion
           end
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+        # rubocop:disable Metrics/AbcSize
         def identity_summary_lines
           return [] unless @kerberos_identity
 
@@ -529,7 +529,7 @@ module Legion
           lines << "  Email: #{id[:email]}" if id[:email]
           lines
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity
+        # rubocop:enable Metrics/AbcSize
 
         def scan_summary_lines(scan_data)
           return [] unless scan_data.is_a?(Hash)
@@ -622,7 +622,7 @@ module Legion
           ['', "Terraform: #{dotfiles_tf[:hosts].join(', ')}"]
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/MethodLength
+        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
         def github_summary_lines(github_data)
           return [] unless github_data.is_a?(Hash)
 
@@ -655,9 +655,9 @@ module Legion
 
           lines
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/MethodLength
+        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
         def format_tenure(tenure)
           return tenure.to_s unless tenure.is_a?(Hash)
 
@@ -670,7 +670,7 @@ module Legion
           parts << "#{d} day#{'s' if d != 1}" if d&.positive?
           parts.join(', ')
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity
 
         def typed_output(text, delay: TYPED_DELAY)
           text.chars.each do |char|

data/lib/legion/tty/theme.rb

@@ -2,7 +2,6 @@
 
 module Legion
   module TTY
-    # rubocop:disable Metrics/ModuleLength
     module Theme
       # rubocop:disable Naming/VariableNumber
       THEMES = {
@@ -125,6 +124,5 @@ module Legion
         end
       end
     end
-    # rubocop:enable Metrics/ModuleLength
   end
 end

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.19'
+    VERSION = '0.4.22'
   end
 end

metadata

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