legion-tty 0.4.20 → 0.4.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2d9ef0fe2336f2750785f4742bc14661032836b05fab83062ba5de23c60cbbc
-  data.tar.gz: cf9fe410cc87ba108cc52e994b5210351bb403b84aa43a27cbcb5ad94ff65232
+  metadata.gz: f33a9d4d3640c42054bc91b873ec04898386dc635d5b3097e037c7695a3a9594
+  data.tar.gz: 469499bb265ededb47d2c1a03778174b8cae152a163808ba5a606b1aaa3b94ee
 SHA512:
-  metadata.gz: 194101f68a10f6e0c9b7a9c14d38690adcfe37724fcb5c2ee894d5a13b757a897aa3b4e85fe48e5db5b44b14f597ffffa9ce1a88ede2da54a1858ca42f759bc9
-  data.tar.gz: 1eb5e7cafbdc7e1025fcdd8424256eea456c3b24f3d03077effd4417a694bddf5f77fd232b6514e89dad53d813161b2d753b6e9a4d7564c1b13ecea6dde1cd95
+  metadata.gz: 79090a1ed32486fa0e15f59312d34ee601c8cc92e8d596ccffda4cc7951cedd3d8461801b90669c1a34d22b32caa6c794836d7dc00633636d64c940dfc757633
+  data.tar.gz: 3ccb8fde2f3e285cbed4f06ddc46132d9f5fd45bad3c5cc5a80d22bca704c2a8e1e90bf799e8e7095228fe1c1330318156792392a67ddcaba4b3eea9f439d094

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.4.23] - 2026-03-19
+
+### Added
+- `/wrap [N|off]` command: set custom word wrap width for message display
+- `/number [on|off]` command: toggle message numbering with `[N]` prefix
+- `/echo <text>` command: add user-defined system messages (notes/markers)
+- `/env` command: show environment info (Ruby version, platform, terminal, PID, Legion gems)
+- `/speak [on|off]` command: toggle text-to-speech for assistant messages (macOS only, via `say`)
+- `/silent` command: toggle silent mode (responses tracked but not displayed), `[SILENT]` indicator
+- `/ls [path]` command: list directory contents with directory markers
+- `/pwd` command: show current working directory
+
+## [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

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

@@ -9,7 +9,7 @@ module Legion
       # rubocop:disable Metrics/ClassLength
       class MessageStream
         attr_reader :messages, :scroll_offset
-        attr_accessor :mute_system, :highlights
+        attr_accessor :mute_system, :silent_mode, :highlights, :filter, :truncate_limit, :wrap_width, :show_numbers
 
         HIGHLIGHT_COLOR = "\e[1;33m"
         HIGHLIGHT_RESET = "\e[0m"
@@ -18,7 +18,10 @@ module Legion
           @messages = []
           @scroll_offset = 0
           @mute_system = false
+          @silent_mode = false
           @highlights = []
+          @wrap_width = nil
+          @show_numbers = false
         end
 
         def add_message(role:, content:)
@@ -61,7 +64,8 @@ module Legion
         end
 
         def render(width:, height:)
-          all_lines = build_all_lines(width)
+          effective_width = @wrap_width || width
+          all_lines = build_all_lines(effective_width)
           total = all_lines.size
           start_idx = [total - height - @scroll_offset, 0].max
           start_idx = [start_idx, total].min
@@ -77,15 +81,40 @@ module Legion
         private
 
         def build_all_lines(width)
-          @messages.flat_map do |msg|
+          filtered_messages.each_with_index.flat_map do |msg, idx|
             next [] if @mute_system && msg[:role] == :system
+            next [] if @silent_mode && msg[:role] == :assistant
 
-            render_message(msg, width)
+            render_message(msg, width, @show_numbers ? idx + 1 : nil)
           end
         end
 
-        def render_message(msg, width)
-          role_lines(msg, width) + panel_lines(msg, width)
+        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, number = nil)
+          lines = role_lines(msg, width) + panel_lines(msg, width)
+          prepend_number(lines, number)
+        end
+
+        def prepend_number(lines, number)
+          return lines unless number
+
+          lines.each_with_index.map do |line, i|
+            i == 1 ? "[#{number}] #{line}" : line
+          end
         end
 
         def role_lines(msg, width)
@@ -104,6 +133,7 @@ module Legion
           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
 
@@ -114,18 +144,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)

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, silent: false }
           @notifications = []
         end
 
@@ -42,6 +42,8 @@ module Legion
           [
             model_segment,
             plan_segment,
+            silent_segment,
+            multiline_segment,
             debug_segment,
             thinking_segment,
             notification_segment,
@@ -63,6 +65,18 @@ module Legion
           Theme.c(:warning, '[PLAN]')
         end
 
+        def multiline_segment
+          return nil unless @state[:multiline]
+
+          Theme.c(:accent, '[ML]')
+        end
+
+        def silent_segment
+          return nil unless @state[:silent]
+
+          Theme.c(:warning, '[SILENT]')
+        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)
@@ -263,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]
@@ -288,7 +284,6 @@ module Legion
             end
             :handled
           end
-          # rubocop:enable Metrics/MethodLength
 
           def macro_record(name)
             unless name
@@ -378,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
@@ -412,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
 
@@ -402,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
@@ -428,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
@@ -447,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
 
@@ -133,8 +132,29 @@ module Legion
             send_to_llm(@last_user_input)
             :handled
           end
+
+          def handle_speak(input)
+            unless RUBY_PLATFORM =~ /darwin/
+              @message_stream.add_message(role: :system, content: 'Text-to-speech is only available on macOS.')
+              return :handled
+            end
+
+            arg = input.split(nil, 2)[1]&.strip&.downcase
+            case arg
+            when 'on'
+              @speak_mode = true
+              @message_stream.add_message(role: :system, content: 'Text-to-speech ON.')
+            when 'off'
+              @speak_mode = false
+              @message_stream.add_message(role: :system, content: 'Text-to-speech OFF.')
+            else
+              @speak_mode = !@speak_mode
+              state = @speak_mode ? 'ON' : 'OFF'
+              @message_stream.add_message(role: :system, content: "Text-to-speech #{state}.")
+            end
+            :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
 
@@ -233,6 +232,34 @@ module Legion
             :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
@@ -256,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]
@@ -390,7 +426,121 @@ module Legion
             @message_stream.add_message(role: :system, content: "Highlight added: '#{pattern}'")
           end
 
-          # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+          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 handle_wrap(input)
+            arg = input.split(nil, 2)[1]&.strip
+            if arg.nil?
+              status = @message_stream.wrap_width ? "#{@message_stream.wrap_width} columns" : 'off'
+              @message_stream.add_message(role: :system, content: "Wrap: #{status}")
+            elsif arg == 'off'
+              @message_stream.wrap_width = nil
+              @message_stream.add_message(role: :system, content: 'Word wrap disabled.')
+            else
+              n = arg.to_i
+              if n >= 20
+                @message_stream.wrap_width = n
+                @message_stream.add_message(role: :system, content: "Word wrap set to #{n} columns.")
+              else
+                @message_stream.add_message(role: :system, content: 'Usage: /wrap [N|off]')
+              end
+            end
+            :handled
+          end
+
+          def handle_number(input)
+            arg = input.split(nil, 2)[1]&.strip
+            case arg
+            when 'on'
+              @message_stream.show_numbers = true
+              @message_stream.add_message(role: :system, content: 'Message numbering ON.')
+            when 'off'
+              @message_stream.show_numbers = false
+              @message_stream.add_message(role: :system, content: 'Message numbering OFF.')
+            else
+              @message_stream.show_numbers = !@message_stream.show_numbers
+              state = @message_stream.show_numbers ? 'ON' : 'OFF'
+              @message_stream.add_message(role: :system, content: "Message numbering #{state}.")
+            end
+            :handled
+          end
+
+          def safe_calc_expr?(expr)
+            CALC_SAFE_PATTERN.match?(expr) || CALC_MATH_PATTERN.match?(expr)
+          end
+
+          def handle_echo(input)
+            text = input.split(nil, 2)[1]&.strip
+            unless text && !text.empty?
+              @message_stream.add_message(role: :system, content: 'Usage: /echo <text>')
+              return :handled
+            end
+
+            @message_stream.add_message(role: :system, content: text)
+            :handled
+          end
+
+          def handle_env
+            width  = terminal_width
+            height = terminal_height
+            legion_gems = Gem::Specification.select { |s| s.name.start_with?('legion-', 'lex-') }
+                                            .map { |s| "#{s.name} #{s.version}" }
+                                            .sort
+            lines = [
+              "Ruby:     #{RUBY_VERSION} (#{RUBY_PLATFORM})",
+              "Terminal: #{width}x#{height}",
+              "PID:      #{::Process.pid}",
+              "TTY:      legion-tty v#{Legion::TTY::VERSION}",
+              "Gems (#{legion_gems.size}): #{legion_gems.join(', ')}"
+            ]
+            @message_stream.add_message(role: :system, content: lines.join("\n"))
+            :handled
+          end
+
+          # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
           def handle_summary
             msgs = @message_stream.messages
             elapsed = Time.now - @session_start
@@ -423,9 +573,71 @@ 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
+
+          # rubocop:disable Metrics/AbcSize
+          def handle_ls(input)
+            path = File.expand_path(input.split(nil, 2)[1]&.strip || '.')
+            entries = Dir.entries(path).sort.reject { |e| ['.', '..'].include?(e) }
+            entries = entries.map { |e| File.directory?(File.join(path, e)) ? "#{e}/" : e }
+            @message_stream.add_message(role: :system, content: "#{path}:\n#{entries.join("\n")}")
+            :handled
+          rescue Errno::ENOENT, Errno::EACCES => e
+            @message_stream.add_message(role: :system, content: "ls: #{e.message}")
+            :handled
+          end
+          # rubocop:enable Metrics/AbcSize
+
+          def handle_pwd
+            @message_stream.add_message(role: :system, content: Dir.pwd)
+            :handled
+          end
+
+          def handle_silent
+            @silent_mode = !@silent_mode
+            @message_stream.silent_mode = @silent_mode
+            if @silent_mode
+              @status_bar.update(silent: true)
+              @message_stream.add_message(role: :system, content: 'Silent mode ON -- assistant responses hidden.')
+            else
+              @status_bar.update(silent: false)
+              @message_stream.add_message(role: :system, content: 'Silent mode OFF -- assistant responses visible.')
+            end
+            :handled
+          end
         end
-        # rubocop:enable Metrics/ModuleLength
       end
     end
   end

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

@@ -33,7 +33,15 @@ module Legion
                             /template /fav /favs /log /version
                             /focus /retry /merge /sort
                             /chain /info /scroll /summary
-                            /prompt /reset /replace /highlight].freeze
+                            /prompt /reset /replace /highlight /multiline
+                            /annotate /annotations /filter /truncate
+                            /tee /pipe
+                            /archive /archives
+                            /calc /rand
+                            /echo /env
+                            /ls /pwd
+                            /wrap /number
+                            /speak /silent].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -74,6 +82,9 @@ module Legion
           @focus_mode = false
           @last_user_input = nil
           @highlights = []
+          @multiline_mode = false
+          @speak_mode = false
+          @silent_mode = false
         end
 
         # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
@@ -94,7 +105,7 @@ module Legion
           @running
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # rubocop:disable Metrics/AbcSize
         def run
           activate
           while @running
@@ -117,7 +128,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?('/')
@@ -139,6 +150,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
@@ -238,20 +250,35 @@ module Legion
           send_via_direct(message)
         end
 
+        # rubocop:disable Metrics/AbcSize
         def send_via_direct(message)
           return unless @llm_chat
 
           @status_bar.update(thinking: true)
           render_screen
           start_time = Time.now
+          response_text = +''
           response = @llm_chat.ask(message) do |chunk|
             @status_bar.update(thinking: false)
-            @message_stream.append_streaming(chunk.content) if chunk.content
+            if chunk.content
+              response_text << chunk.content
+              @message_stream.append_streaming(chunk.content)
+            end
             render_screen
           end
           record_response_time(Time.now - start_time)
           @status_bar.update(thinking: false)
           track_response_tokens(response)
+          speak_response(response_text) if @speak_mode
+        end
+        # rubocop:enable Metrics/AbcSize
+
+        def speak_response(text)
+          return unless RUBY_PLATFORM =~ /darwin/
+
+          ::Process.spawn('say', text[0..500], err: '/dev/null', out: '/dev/null')
+        rescue StandardError
+          nil
         end
 
         def record_response_time(elapsed)
@@ -339,12 +366,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
@@ -416,6 +458,25 @@ module Legion
           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)
+          when '/echo' then handle_echo(input)
+          when '/env' then handle_env
+          when '/ls' then handle_ls(input)
+          when '/pwd' then handle_pwd
+          when '/wrap' then handle_wrap(input)
+          when '/number' then handle_number(input)
+          when '/speak' then handle_speak(input)
+          when '/silent' then handle_silent
           else :handled
           end
         end
@@ -500,6 +561,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.20'
+    VERSION = '0.4.23'
   end
 end

metadata

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