legion-tty 0.4.9 → 0.4.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a862cd998ed05b3eb9a633c41602683425e79ea59f9634f0c2826e24e981291
-  data.tar.gz: 7cda3afc03dfa47d640d7fd4eca2dce80c8701fea820e3077e7bf3f4a37fc30d
+  metadata.gz: 3e2b8a679110725634b3db870bb623fc8f5cef89706890f9c57c579490c85114
+  data.tar.gz: 6487e27647ed48406731a9c0c1bf1664b64831b60139dd698ae794d2dc8d3871
 SHA512:
-  metadata.gz: 9f65b4afeeed674a49e59a43e4116eee383db5bdc2083cd648342c9134ba2e971d8403d8d3fc57ebbcacacbf9dcec293d482cce818a97c84ce4485d843ad1490
-  data.tar.gz: cd51d5ede4592418fe9a25226c054a2cf26adec493f7efc94763c6165c4bef50b1fdfe74f039759fb4cabdf0fec36ab679b643f28273f8a8573011e8a063c3d8
+  metadata.gz: 9c89fb3dbcb807c628889b2b60566b3b23cad1356c26de42cd1d02d75a2977e7856528b0193e8bb9dd630ee4cf52b2b55e06e009c8fc3e34550a1712d6768b68
+  data.tar.gz: ae426495d1eb8708723a5c2804a4a77e4a557480324c23b370b0ebe324ea1a7ece957665b133f7810952f03f586cb0e87dcef3e1c78e9fcde81fe13e0e6e4760

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.4.11] - 2026-03-19
+
+### Added
+- Dashboard LLM status panel: shows provider, model, started/daemon status with green/red icons
+- Dashboard panel navigation: j/k/arrows to move between panels, 1-5 to jump, 'e' to open extensions
+- `/uptime` command: show current chat session elapsed time
+- `/bookmark` command: export all pinned messages to markdown file
+
+## [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

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

@@ -8,7 +8,8 @@ module Legion
     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
 
@@ -40,6 +41,7 @@ module Legion
           [
             model_segment,
             plan_segment,
+            debug_segment,
             thinking_segment,
             notification_segment,
             tokens_segment,
@@ -59,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]
 

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 /undo /history /pin /pins /rename].freeze
+                            /theme /search /stats /personality /undo /history /pin /pins /rename
+                            /context /alias /snippet /debug /uptime /bookmark].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -26,6 +27,7 @@ module Legion
 
         attr_reader :message_stream, :status_bar
 
+        # rubocop:disable Metrics/AbcSize
         def initialize(app, output: $stdout, input_bar: nil)
           super(app)
           @output = output
@@ -39,8 +41,14 @@ module Legion
           @session_name = 'default'
           @plan_mode = false
           @pinned_messages = []
+          @aliases = {}
+          @snippets = {}
+          @debug_mode = false
+          @session_start = Time.now
         end
 
+        # rubocop:enable Metrics/AbcSize
+
         def activate
           @running = true
           cfg = safe_config
@@ -85,7 +93,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
@@ -120,10 +133,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)
@@ -264,7 +281,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
@@ -298,11 +315,18 @@ module Legion
           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
+          when '/uptime' then handle_uptime
+          when '/bookmark' then handle_bookmark
           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,
@@ -320,11 +344,18 @@ module Legion
                      "/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\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  " \
+                     "/uptime -- show how long this session has been active\n  " \
+                     "/bookmark -- export pinned messages to a markdown file\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
@@ -945,6 +976,224 @@ module Legion
           :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 handle_uptime
+          elapsed = Time.now - @session_start
+          hours   = (elapsed / 3600).to_i
+          minutes = ((elapsed % 3600) / 60).to_i
+          seconds = (elapsed % 60).to_i
+          @message_stream.add_message(role: :system, content: "Session uptime: #{hours}h #{minutes}m #{seconds}s")
+          :handled
+        end
+
+        # rubocop:disable Metrics/AbcSize
+        def handle_bookmark
+          require 'fileutils'
+          if @pinned_messages.empty?
+            @message_stream.add_message(role: :system, content: 'No pinned messages to export.')
+            return :handled
+          end
+
+          exports_dir = File.expand_path('~/.legionio/exports')
+          FileUtils.mkdir_p(exports_dir)
+          timestamp = Time.now.strftime('%Y%m%d-%H%M%S')
+          path = File.join(exports_dir, "bookmarks-#{timestamp}.md")
+          lines = ["# Pinned Messages\n", "_Exported: #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}_\n\n---\n"]
+          @pinned_messages.each_with_index do |msg, i|
+            role_label = msg[:role].to_s.capitalize
+            lines << "\n## Bookmark #{i + 1} (#{role_label})\n\n#{msg[:content]}\n"
+          end
+          File.write(path, lines.join)
+          @message_stream.add_message(role: :system, content: "Bookmarks exported to: #{path}")
+          :handled
+        rescue StandardError => e
+          @message_stream.add_message(role: :system, content: "Bookmark export failed: #{e.message}")
+          :handled
+        end
+
+        # rubocop:enable Metrics/AbcSize
+
+        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/screens/dashboard.rb

@@ -8,11 +8,14 @@ module Legion
     module Screens
       # rubocop:disable Metrics/ClassLength
       class Dashboard < Base
+        PANELS = %i[services llm extensions system activity].freeze
+
         def initialize(app)
           super
           @last_refresh = nil
           @refresh_interval = 5
           @cached_data = {}
+          @selected_panel = 0
         end
 
         def activate
@@ -26,6 +29,7 @@ module Legion
           rows = []
           rows.concat(render_header(width))
           rows.concat(render_services_panel(width))
+          rows.concat(render_llm_panel(width))
           rows.concat(render_extensions_panel(width))
           rows.concat(render_system_panel(width))
           rows.concat(render_activity_panel(width, remaining_height(height, rows.size)))
@@ -36,6 +40,7 @@ module Legion
 
         # rubocop:enable Metrics/AbcSize
 
+        # rubocop:disable Metrics/CyclomaticComplexity, Metrics/MethodLength
         def handle_input(key)
           case key
           when 'r', :f5
@@ -43,15 +48,35 @@ module Legion
             :handled
           when 'q', :escape
             :pop_screen
+          when 'j', :down
+            @selected_panel = (@selected_panel + 1) % PANELS.size
+            :handled
+          when 'k', :up
+            @selected_panel = (@selected_panel - 1) % PANELS.size
+            :handled
+          when '1' then navigate_to_panel(0)
+          when '2' then navigate_to_panel(1)
+          when '3' then navigate_to_panel(2)
+          when '4' then navigate_to_panel(3)
+          when '5' then navigate_to_panel(4)
+          when 'e'
+            extensions_shortcut
           else
             :pass
           end
         end
 
+        # rubocop:enable Metrics/CyclomaticComplexity, Metrics/MethodLength
+
+        def selected_panel
+          PANELS[@selected_panel]
+        end
+
         def refresh_data
           @last_refresh = Time.now
           @cached_data = {
             services: probe_services,
+            llm: llm_info,
             extensions: discover_extensions,
             system: system_info,
             activity: recent_activity
@@ -73,7 +98,8 @@ module Legion
 
         def render_services_panel(_width)
           services = @cached_data[:services] || {}
-          lines = [Theme.c(:accent, '  Services')]
+          prefix = panel_prefix(:services)
+          lines = [Theme.c(:accent, "#{prefix}Services")]
           services.each do |name, info|
             icon = info[:running] ? Theme.c(:success, "\u2713") : Theme.c(:error, "\u2717")
             port_str = Theme.c(:muted, ":#{info[:port]}")
@@ -83,10 +109,29 @@ module Legion
           lines
         end
 
+        # rubocop:disable Metrics/AbcSize
+        def render_llm_panel(_width)
+          llm = @cached_data[:llm] || {}
+          prefix = panel_prefix(:llm)
+          lines = [Theme.c(:accent, "#{prefix}LLM")]
+          started_icon = llm[:started] ? Theme.c(:success, "\u2713") : Theme.c(:error, "\u2717")
+          daemon_icon  = llm[:daemon]  ? Theme.c(:success, "\u2713") : Theme.c(:error, "\u2717")
+          lines << "    #{started_icon} Legion::LLM started"
+          lines << "    #{daemon_icon} Daemon available"
+          lines << "    Provider: #{Theme.c(:secondary, llm[:provider] || 'none')}"
+          lines << "    Model:    #{Theme.c(:secondary, llm[:model] || 'none')}" if llm[:model]
+          lines << ''
+          lines
+        end
+
+        # rubocop:enable Metrics/AbcSize
+
+        # rubocop:disable Metrics/AbcSize
         def render_extensions_panel(_width)
           extensions = @cached_data[:extensions] || []
           count = extensions.size
-          lines = [Theme.c(:accent, "  Extensions (#{count})")]
+          prefix = panel_prefix(:extensions)
+          lines = [Theme.c(:accent, "#{prefix}Extensions (#{count})")]
           if extensions.empty?
             lines << Theme.c(:muted, '    No lex-* gems found')
           else
@@ -100,10 +145,13 @@ module Legion
           lines
         end
 
+        # rubocop:enable Metrics/AbcSize
+
         # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
         def render_system_panel(_width)
           sys = @cached_data[:system] || {}
-          lines = [Theme.c(:accent, '  System')]
+          prefix = panel_prefix(:system)
+          lines = [Theme.c(:accent, "#{prefix}System")]
           lines << "    Ruby:     #{Theme.c(:secondary, sys[:ruby_version] || 'unknown')}"
           lines << "    OS:       #{Theme.c(:secondary, sys[:os] || 'unknown')}"
           lines << "    Host:     #{Theme.c(:secondary, sys[:hostname] || 'unknown')}"
@@ -117,7 +165,8 @@ module Legion
 
         def render_activity_panel(_width, max_lines)
           activity = @cached_data[:activity] || []
-          lines = [Theme.c(:accent, '  Recent Activity')]
+          prefix = panel_prefix(:activity)
+          lines = [Theme.c(:accent, "#{prefix}Recent Activity")]
           if activity.empty?
             lines << Theme.c(:muted, '    No recent activity')
           else
@@ -132,7 +181,8 @@ module Legion
 
         def render_help_bar(width)
           help = "  #{Theme.c(:muted, 'r')}=refresh  #{Theme.c(:muted, 'q')}=back  " \
-                 "#{Theme.c(:muted, 'Ctrl+D')}=dashboard  #{Theme.c(:muted, 'Ctrl+C')}=quit"
+                 "#{Theme.c(:muted, 'j/k')}=navigate  #{Theme.c(:muted, '1-5')}=jump  " \
+                 "#{Theme.c(:muted, 'e')}=extensions  #{Theme.c(:muted, 'Ctrl+C')}=quit"
           [Theme.c(:muted, '-' * width), help]
         end
 
@@ -148,6 +198,47 @@ module Legion
           end
         end
 
+        def panel_prefix(panel_name)
+          PANELS[@selected_panel] == panel_name ? '>> ' : '  '
+        end
+
+        def navigate_to_panel(index)
+          @selected_panel = index
+          :handled
+        end
+
+        def extensions_shortcut
+          if PANELS[@selected_panel] == :extensions && @app.respond_to?(:screen_manager)
+            require_relative '../screens/extensions'
+            @app.screen_manager.push(Screens::Extensions.new(@app))
+            :handled
+          else
+            :pass
+          end
+        rescue LoadError, StandardError
+          :pass
+        end
+
+        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        def llm_info
+          info = { provider: 'none', model: nil, started: false, daemon: false }
+          if defined?(Legion::LLM)
+            info[:started] = Legion::LLM.respond_to?(:started?) && Legion::LLM.started?
+            settings = Legion::LLM.respond_to?(:settings) ? Legion::LLM.settings : {}
+            info[:provider] = settings[:default_provider]&.to_s || 'none'
+            info[:model] = settings[:model]&.to_s
+          end
+          if defined?(Legion::LLM::DaemonClient)
+            info[:daemon] = Legion::LLM::DaemonClient.respond_to?(:available?) &&
+                            Legion::LLM::DaemonClient.available?
+          end
+          info
+        rescue StandardError
+          info
+        end
+
+        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
         def probe_services
           require 'socket'
           {

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.9'
+    VERSION = '0.4.11'
   end
 end

metadata

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