legion-tty 0.4.8 → 0.4.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49d5dd5b69b7fa3412226bc38e93b0adb0df6be7c3b0317955bf7f9698a0759d
-  data.tar.gz: ed73f018bbb85ee31fdf11aba24f5b6f332f28ef85970f9189ba5164402d8690
+  metadata.gz: b4f6ee315fe6ff9851580bebff6f0187665a2c53f1719c48ad807879651eee44
+  data.tar.gz: 938e195e473fb65a27840f31b82cefa9032c9f500d828f2844d8ca58b7f9bc95
 SHA512:
-  metadata.gz: 67a87dfd8538f4c42e5c9897d4460d8457071660e95df3fe019757d3e9e56ef95627d4a5a3576914611257f78fd766190909e4e95f8f4bee26b1c0328745c35f
-  data.tar.gz: a6f9bd2210d04ad3d2200a4029e32141eb82b29043dee974cb5b37d5d6b927b1f2b284cac1d3e39c77c6105fa7c08f61a3da8a678e4d77e88de675cfe9cac2ea
+  metadata.gz: 27167cd635e065fca190930586ba383ffe8b8595c772eb917dd243aa7832b6d23807198e2e73b25b942154fb155c455e239c52e51b68ad16675beb363224be28
+  data.tar.gz: cdbcae2d8a592ea9b6316f3069f593c49b11f242ddfedd5306313a53b6bce48e5c718c06fb2cbb21e44f4c8b323a4fae06839b47fda2cb41bd8c7312a405be55

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.4.10] - 2026-03-19
+
+### Added
+- `/context` command: display active session state summary (model, personality, plan mode, system prompt, session, message count, pinned count, token usage)
+- `/alias` command: create short aliases for frequently used slash commands; aliases expand and re-dispatch transparently
+- `/snippet save|load|list|delete <name>` command: save last assistant message as a named snippet, insert snippets as user messages, persist to `~/.legionio/snippets/`
+- `/debug` command: toggle debug mode; adds `[DEBUG]` line to render output showing msgs/scroll/plan/personality/aliases/snippets/pinned counts; StatusBar shows `[DBG]` indicator
+
+## [0.4.9] - 2026-03-19
+
+### Added
+- StatusBar notifications: transient toast-style messages with TTL expiry (wired to save/load/export/theme)
+- `/undo` command: remove last user+assistant message pair
+- `/history` command: show last 20 input entries
+- `/pin` and `/pins` commands: pin important messages, view pinned list
+- `/rename <name>` command: rename current session (deletes old, saves new)
+
 ## [0.4.8] - 2026-03-19
 
 ### Added

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

@@ -1,13 +1,20 @@
 # frozen_string_literal: true
 
 require_relative '../theme'
+require_relative 'notification'
 
 module Legion
   module TTY
     module Components
       class StatusBar
         def initialize
-          @state = { model: nil, tokens: 0, cost: 0.0, session: 'default', thinking: false, plan_mode: false }
+          @state = { model: nil, tokens: 0, cost: 0.0, session: 'default', thinking: false, plan_mode: false,
+                     debug_mode: false }
+          @notifications = []
+        end
+
+        def notify(message:, level: :info, ttl: 5)
+          @notifications << Notification.new(message: message, level: level, ttl: ttl)
         end
 
         def update(**fields)
@@ -34,7 +41,9 @@ module Legion
           [
             model_segment,
             plan_segment,
+            debug_segment,
             thinking_segment,
+            notification_segment,
             tokens_segment,
             cost_segment,
             session_segment,
@@ -52,6 +61,12 @@ module Legion
           Theme.c(:warning, '[PLAN]')
         end
 
+        def debug_segment
+          return nil unless @state[:debug_mode]
+
+          Theme.c(:muted, '[DBG]')
+        end
+
         def thinking_segment
           return nil unless @state[:thinking]
 
@@ -60,6 +75,13 @@ module Legion
           Theme.c(:warning, "#{frame} thinking...")
         end
 
+        def notification_segment
+          @notifications.reject!(&:expired?)
+          return nil if @notifications.empty?
+
+          @notifications.first.render
+        end
+
         def tokens_segment
           Theme.c(:secondary, "#{format_number(@state[:tokens])} tokens") if @state[:tokens].to_i.positive?
         end

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

@@ -14,7 +14,8 @@ module Legion
       class Chat < Base
         SLASH_COMMANDS = %w[/help /quit /clear /compact /copy /diff /model /session /cost /export /tools /dashboard
                             /hotkeys /save /load /sessions /system /delete /plan /palette /extensions /config
-                            /theme /search /stats /personality].freeze
+                            /theme /search /stats /personality /undo /history /pin /pins /rename
+                            /context /alias /snippet /debug].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -38,6 +39,10 @@ module Legion
           @session_store = SessionStore.new
           @session_name = 'default'
           @plan_mode = false
+          @pinned_messages = []
+          @aliases = {}
+          @snippets = {}
+          @debug_mode = false
         end
 
         def activate
@@ -84,7 +89,12 @@ module Legion
           return nil unless input.start_with?('/')
 
           cmd = input.split.first
-          return nil unless SLASH_COMMANDS.include?(cmd)
+          unless SLASH_COMMANDS.include?(cmd)
+            expanded = @aliases[cmd]
+            return nil unless expanded
+
+            return handle_slash_command("#{expanded} #{input.split(nil, 2)[1]}".strip)
+          end
 
           dispatch_slash(cmd, input)
         end
@@ -119,10 +129,14 @@ module Legion
         def render(width, height)
           bar_line = @status_bar.render(width: width)
           divider = Theme.c(:muted, '-' * width)
-          stream_height = [height - 2, 1].max
+          dbg = debug_segment
+          extra_rows = dbg ? 1 : 0
+          stream_height = [height - 2 - extra_rows, 1].max
           stream_lines = @message_stream.render(width: width, height: stream_height)
           @status_bar.update(scroll: @message_stream.scroll_position)
-          stream_lines + [divider, bar_line]
+          lines = stream_lines + [divider, bar_line]
+          lines << dbg if dbg
+          lines
         end
 
         def handle_input(key)
@@ -263,7 +277,7 @@ module Legion
           nil
         end
 
-        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
         def dispatch_slash(cmd, input)
           case cmd
           when '/quit' then :quit
@@ -292,11 +306,21 @@ module Legion
           when '/search' then handle_search(input)
           when '/stats' then handle_stats
           when '/personality' then handle_personality(input)
+          when '/undo' then handle_undo
+          when '/history' then handle_history
+          when '/pin' then handle_pin(input)
+          when '/pins' then handle_pins
+          when '/rename' then handle_rename(input)
+          when '/context' then handle_context
+          when '/alias' then handle_alias(input)
+          when '/snippet' then handle_snippet(input)
+          when '/debug' then handle_debug
           else :handled
           end
         end
-        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
 
+        # rubocop:disable Metrics/MethodLength
         def handle_help
           @message_stream.add_message(
             role: :system,
@@ -309,11 +333,21 @@ module Legion
                      "/copy -- copy last assistant message to clipboard\n  " \
                      "/diff -- show new messages since session was loaded\n  " \
                      "/stats -- show conversation statistics\n  " \
-                     "/personality [name] -- switch assistant personality\n\n" \
+                     "/personality [name] -- switch assistant personality\n  " \
+                     "/undo -- remove last user+assistant message pair\n  " \
+                     "/history -- show recent input history\n  " \
+                     "/pin [N] -- pin last assistant message (or message at index N)\n  " \
+                     "/pins -- show all pinned messages\n  " \
+                     "/rename <name> -- rename current session\n  " \
+                     "/context -- show active session context summary\n  " \
+                     "/alias [shortname /command] -- create or list command aliases\n  " \
+                     "/snippet save|load|list|delete <name> -- manage reusable text snippets\n  " \
+                     "/debug -- toggle debug mode (shows internal state)\n\n" \
                      'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back'
           )
           :handled
         end
+        # rubocop:enable Metrics/MethodLength
 
         def handle_clear
           @message_stream.messages.clear
@@ -403,6 +437,7 @@ module Legion
           @session_name = name
           @session_store.save(name, messages: @message_stream.messages)
           @status_bar.update(session: name)
+          @status_bar.notify(message: "Saved '#{name}'", level: :success, ttl: 3)
           @message_stream.add_message(role: :system, content: "Session saved as '#{name}'.")
           :handled
         end
@@ -422,6 +457,7 @@ module Legion
           @loaded_message_count = @message_stream.messages.size
           @session_name = name
           @status_bar.update(session: name)
+          @status_bar.notify(message: "Loaded '#{name}'", level: :info, ttl: 3)
           @message_stream.add_message(role: :system,
                                       content: "Session '#{name}' loaded (#{data[:messages].size} messages).")
           :handled
@@ -454,16 +490,29 @@ module Legion
           :handled
         end
 
-        # rubocop:disable Metrics/AbcSize
         def handle_export(input)
           require 'fileutils'
+          path = build_export_path(input)
+          dispatch_export(path, input.split[1]&.downcase)
+          @status_bar.notify(message: 'Exported', level: :success, ttl: 3)
+          @message_stream.add_message(role: :system, content: "Exported to: #{path}")
+          :handled
+        rescue StandardError => e
+          @message_stream.add_message(role: :system, content: "Export failed: #{e.message}")
+          :handled
+        end
+
+        def build_export_path(input)
           format = input.split[1]&.downcase
           format = 'md' unless %w[json md html].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]
-          path = File.join(exports_dir, "chat-#{timestamp}.#{ext}")
+          File.join(exports_dir, "chat-#{timestamp}.#{ext}")
+        end
+
+        def dispatch_export(path, format)
           if format == 'json'
             export_json(path)
           elsif format == 'html'
@@ -471,15 +520,8 @@ module Legion
           else
             export_markdown(path)
           end
-          @message_stream.add_message(role: :system, content: "Exported to: #{path}")
-          :handled
-        rescue StandardError => e
-          @message_stream.add_message(role: :system, content: "Export failed: #{e.message}")
-          :handled
         end
 
-        # rubocop:enable Metrics/AbcSize
-
         # rubocop:disable Metrics/AbcSize
         def handle_tools
           lex_gems = Gem::Specification.select { |s| s.name.start_with?('lex-') }
@@ -605,6 +647,7 @@ module Legion
           name = input.split(nil, 2)[1]
           if name
             if Theme.switch(name)
+              @status_bar.notify(message: "Theme: #{name}", level: :info, ttl: 2)
               @message_stream.add_message(role: :system, content: "Theme switched to: #{name}")
             else
               available = Theme.available_themes.join(', ')
@@ -853,6 +896,260 @@ module Legion
           text.gsub('&', '&amp;').gsub('<', '&lt;').gsub('>', '&gt;').gsub('"', '&quot;')
         end
 
+        def handle_undo
+          msgs = @message_stream.messages
+          last_user_idx = msgs.rindex { |m| m[:role] == :user }
+          unless last_user_idx
+            @message_stream.add_message(role: :system, content: 'Nothing to undo.')
+            return :handled
+          end
+
+          msgs.slice!(last_user_idx..)
+          :handled
+        end
+
+        def handle_history
+          entries = @input_bar.history
+          if entries.empty?
+            @message_stream.add_message(role: :system, content: 'No input history.')
+          else
+            recent = entries.last(20)
+            lines = recent.each_with_index.map { |entry, i| "  #{i + 1}. #{entry}" }
+            @message_stream.add_message(role: :system,
+                                        content: "Input history (last #{recent.size}):\n#{lines.join("\n")}")
+          end
+          :handled
+        end
+
+        def handle_pin(input)
+          idx_str = input.split(nil, 2)[1]
+          msg = if idx_str
+                  @message_stream.messages[idx_str.to_i]
+                else
+                  @message_stream.messages.reverse.find { |m| m[:role] == :assistant }
+                end
+          unless msg
+            @message_stream.add_message(role: :system, content: 'No message to pin.')
+            return :handled
+          end
+
+          @pinned_messages << msg
+          preview = truncate_text(msg[:content].to_s, 60)
+          @message_stream.add_message(role: :system, content: "Pinned: #{preview}")
+          :handled
+        end
+
+        def handle_pins
+          if @pinned_messages.empty?
+            @message_stream.add_message(role: :system, content: 'No pinned messages.')
+          else
+            lines = @pinned_messages.each_with_index.map do |msg, i|
+              "  #{i + 1}. [#{msg[:role]}] #{truncate_text(msg[:content].to_s, 70)}"
+            end
+            @message_stream.add_message(role: :system,
+                                        content: "Pinned messages (#{@pinned_messages.size}):\n#{lines.join("\n")}")
+          end
+          :handled
+        end
+
+        def handle_rename(input)
+          name = input.split(nil, 2)[1]
+          unless name
+            @message_stream.add_message(role: :system, content: 'Usage: /rename <new-name>')
+            return :handled
+          end
+
+          old_name = @session_name
+          @session_store.delete(old_name) if old_name != 'default'
+          @session_name = name
+          @status_bar.update(session: name)
+          @session_store.save(name, messages: @message_stream.messages)
+          @message_stream.add_message(role: :system, content: "Session renamed to '#{name}'.")
+          :handled
+        end
+
+        # rubocop:disable Metrics/AbcSize
+        def handle_context
+          cfg = safe_config
+          model_info = @llm_chat.respond_to?(:model) ? @llm_chat.model.to_s : (cfg[:provider] || 'none')
+          sys_prompt = if @llm_chat.respond_to?(:instructions) && @llm_chat.instructions
+                         truncate_text(@llm_chat.instructions.to_s, 80)
+                       else
+                         'default'
+                       end
+          lines = [
+            'Session Context:',
+            "  Model/Provider : #{model_info}",
+            "  Personality    : #{@personality || 'default'}",
+            "  Plan mode      : #{@plan_mode ? 'on' : 'off'}",
+            "  System prompt  : #{sys_prompt}",
+            "  Session        : #{@session_name}",
+            "  Messages       : #{@message_stream.messages.size}",
+            "  Pinned         : #{@pinned_messages.size}",
+            "  Tokens         : #{@token_tracker.summary}"
+          ]
+          @message_stream.add_message(role: :system, content: lines.join("\n"))
+          :handled
+        end
+        # rubocop:enable Metrics/AbcSize
+
+        def handle_alias(input)
+          parts = input.split(nil, 3)
+          if parts.size < 2
+            if @aliases.empty?
+              @message_stream.add_message(role: :system, content: 'No aliases defined.')
+            else
+              lines = @aliases.map { |k, v| "  #{k} => #{v}" }
+              @message_stream.add_message(role: :system, content: "Aliases:\n#{lines.join("\n")}")
+            end
+            return :handled
+          end
+
+          shortname = parts[1]
+          expansion = parts[2]
+          unless expansion
+            @message_stream.add_message(role: :system, content: 'Usage: /alias <shortname> <command and args>')
+            return :handled
+          end
+
+          alias_key = shortname.start_with?('/') ? shortname : "/#{shortname}"
+          @aliases[alias_key] = expansion
+          @message_stream.add_message(role: :system, content: "Alias created: #{alias_key} => #{expansion}")
+          :handled
+        end
+
+        def handle_snippet(input)
+          parts = input.split(nil, 3)
+          subcommand = parts[1]
+          name = parts[2]
+
+          case subcommand
+          when 'save'
+            snippet_save(name)
+          when 'load'
+            snippet_load(name)
+          when 'list'
+            snippet_list
+          when 'delete'
+            snippet_delete(name)
+          else
+            @message_stream.add_message(
+              role: :system,
+              content: 'Usage: /snippet save|load|list|delete <name>'
+            )
+          end
+          :handled
+        end
+
+        def handle_debug
+          @debug_mode = !@debug_mode
+          if @debug_mode
+            @status_bar.update(debug_mode: true)
+            @message_stream.add_message(role: :system, content: 'Debug mode ON -- internal state shown below.')
+          else
+            @status_bar.update(debug_mode: false)
+            @message_stream.add_message(role: :system, content: 'Debug mode OFF.')
+          end
+          :handled
+        end
+
+        def debug_segment
+          return nil unless @debug_mode
+
+          "[DEBUG] msgs:#{@message_stream.messages.size} " \
+            "scroll:#{@message_stream.scroll_position&.dig(:current) || 0} " \
+            "plan:#{@plan_mode} " \
+            "personality:#{@personality || 'default'} " \
+            "aliases:#{@aliases.size} " \
+            "snippets:#{@snippets.size} " \
+            "pinned:#{@pinned_messages.size}"
+        end
+
+        def snippet_dir
+          File.expand_path('~/.legionio/snippets')
+        end
+
+        # rubocop:disable Metrics/AbcSize
+        def snippet_save(name)
+          unless name
+            @message_stream.add_message(role: :system, content: 'Usage: /snippet save <name>')
+            return
+          end
+
+          last_assistant = @message_stream.messages.reverse.find { |m| m[:role] == :assistant }
+          unless last_assistant
+            @message_stream.add_message(role: :system, content: 'No assistant message to save as snippet.')
+            return
+          end
+
+          require 'fileutils'
+          FileUtils.mkdir_p(snippet_dir)
+          path = File.join(snippet_dir, "#{name}.txt")
+          File.write(path, last_assistant[:content].to_s)
+          @snippets[name] = last_assistant[:content].to_s
+          @message_stream.add_message(role: :system, content: "Snippet '#{name}' saved.")
+        end
+        # rubocop:enable Metrics/AbcSize
+
+        def snippet_load(name)
+          unless name
+            @message_stream.add_message(role: :system, content: 'Usage: /snippet load <name>')
+            return
+          end
+
+          content = @snippets[name]
+          if content.nil?
+            path = File.join(snippet_dir, "#{name}.txt")
+            content = File.read(path) if File.exist?(path)
+          end
+
+          unless content
+            @message_stream.add_message(role: :system, content: "Snippet '#{name}' not found.")
+            return
+          end
+
+          @snippets[name] = content
+          @message_stream.add_message(role: :user, content: content)
+          @message_stream.add_message(role: :system, content: "Snippet '#{name}' inserted.")
+        end
+
+        # rubocop:disable Metrics/AbcSize
+        def snippet_list
+          disk_snippets = Dir.glob(File.join(snippet_dir, '*.txt')).map { |f| File.basename(f, '.txt') }
+          all_names = (@snippets.keys + disk_snippets).uniq.sort
+
+          if all_names.empty?
+            @message_stream.add_message(role: :system, content: 'No snippets saved.')
+            return
+          end
+
+          lines = all_names.map do |sname|
+            content = @snippets[sname] || begin
+              path = File.join(snippet_dir, "#{sname}.txt")
+              File.exist?(path) ? File.read(path) : ''
+            end
+            "  #{sname}: #{truncate_text(content.to_s, 60)}"
+          end
+          @message_stream.add_message(role: :system, content: "Snippets (#{all_names.size}):\n#{lines.join("\n")}")
+        end
+        # rubocop:enable Metrics/AbcSize
+
+        def snippet_delete(name)
+          unless name
+            @message_stream.add_message(role: :system, content: 'Usage: /snippet delete <name>')
+            return
+          end
+
+          @snippets.delete(name)
+          path = File.join(snippet_dir, "#{name}.txt")
+          if File.exist?(path)
+            File.delete(path)
+            @message_stream.add_message(role: :system, content: "Snippet '#{name}' deleted.")
+          else
+            @message_stream.add_message(role: :system, content: "Snippet '#{name}' not found.")
+          end
+        end
+
         def build_default_input_bar
           cfg = safe_config
           name = cfg[:name] || 'User'

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.8'
+    VERSION = '0.4.10'
   end
 end

metadata

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