legion-tty 0.4.12 → 0.4.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9506a28fb68d7623dd1e70e2b69b80e80b2a96486c068dbc2d13a7e2bd9a80ab
-  data.tar.gz: 7ce9e32334ba94891569b073e04246240d8b1637edb930f0c8c86ed80841a155
+  metadata.gz: bce8d6f696692fc8e9173eee8cb0afd87f37dc48b12325a149a7de1748f13447
+  data.tar.gz: d0e115df860ddd59c02e92b27d65a74a3a1413bafd25c7484f8dcc8c631832fb
 SHA512:
-  metadata.gz: b7cf759adc8fcaad726906fd6e95d12a00d5e09bbf3724685a1fae91bdd31d9df31036bc4d826cc7b756f2cb97ae2d560290dbb6c1f0473b8334da48508d5a39
-  data.tar.gz: 7fcce87bc7f909f1e5b5c6d468871860a0a2be6f621a8b446d7948cf2761bf354035911d946c134b74d04b226e19f2b174c010d1fb9e7a39533162f826883865
+  metadata.gz: c6bc9b9eb07cf1838830fddd0bf626c4d9a0404db3330f7f6a658c5dd6425f9293d316a3a6f013858262f47ddb2875421c768a849a14213432028d66f56d94c7
+  data.tar.gz: 4eddcc425c258ec26d3c74e9ec3a9ce1ac470f8b25e985bed26db41f504e3825a61f21113587ccb70c5e7ce35789e06325affba7b704e0580687165687d4dbf5

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.4.14] - 2026-03-19
+
+### Added
+- LLM response timing: tracks elapsed time per response, shows notification, includes avg in `/stats`
+- `/wc` command: word count statistics per role (user/assistant/system) with averages
+- `/import <path>` command: import session from any JSON file path with validation
+- `/mute` command: toggle system message display in chat (messages still tracked, just hidden)
+
+## [0.4.13] - 2026-03-19
+
+### Added
+- Help overlay: `/help` now renders as a categorized overlay (SESSION/CHAT/LLM/NAV/DISPLAY/TOOLS) via screen manager
+- Session message count in status bar ("N msgs" segment)
+- `/welcome` command: redisplay the welcome message
+- `/tips` command: show random usage tips (15 tips covering commands, hotkeys, features)
+
 ## [0.4.12] - 2026-03-19
 
 ### Added

data/README.md

@@ -2,30 +2,36 @@
 
 Rich terminal UI for the LegionIO async cognition engine.
 
-**Version**: 0.4.8
+**Version**: 0.4.12
 
-Think Claude Code meets Codex CLI, but for LegionIO: onboarding wizard with identity detection, streaming AI chat shell, operational dashboard, extensions browser, config editor, and session persistence - all rendered with the [tty-ruby](https://ttytoolkit.org/) gem ecosystem.
+Think Claude Code meets Codex CLI, but for LegionIO: onboarding wizard with identity detection, streaming AI chat shell with 40 slash commands, operational dashboard, extensions browser, config editor, and session persistence - all rendered with the [tty-ruby](https://ttytoolkit.org/) gem ecosystem.
 
 ## Features
 
 - **Onboarding wizard** - First-run setup with Kerberos identity detection, GitHub profile probing, environment scanning, and LLM provider selection
 - **Digital rain intro** - Matrix-style rain using discovered LEX extension names
-- **AI chat shell** - Streaming LLM chat with 27 slash commands, tab completion, markdown rendering, and tool panels
-- **Operational dashboard** - Service status, extension inventory, system info, recent activity (Ctrl+D or `/dashboard`)
-- **Extensions browser** - Browse installed LEX gems by category (core, agentic, service, AI, other) with detail view
-- **Config viewer/editor** - View and edit `~/.legionio/settings/*.json` with vault:// masking
+- **AI chat shell** - Streaming LLM chat with 40 slash commands, tab completion, markdown rendering, and tool panels
+- **Operational dashboard** - Service/LLM status, extension inventory, system info, panel navigation (Ctrl+D or `/dashboard`)
+- **Extensions browser** - Browse installed LEX gems by category with detail view and homepage opener ('o' key)
+- **Config viewer/editor** - View and edit `~/.legionio/settings/*.json` with vault:// masking and JSON validation
 - **Command palette** - Fuzzy-search overlay for all commands, screens, and sessions (Ctrl+K or `/palette`)
 - **Model picker** - Switch LLM providers interactively
-- **Session management** - Auto-save on quit, `/save`, `/load`, `/sessions`, session picker (Ctrl+S)
+- **Session management** - Auto-save on quit, `/save`, `/load`, `/sessions`, `/rename`, session picker (Ctrl+S)
 - **Token tracking** - Per-model pricing for 9 models across 8 providers via `/cost`
 - **Plan mode** - Bookmark messages without sending to LLM (`/plan`)
 - **Personality styles** - Switch between default, concise, detailed, friendly, technical (`/personality`)
 - **Theme selection** - Four built-in themes: purple (default), green, blue, amber (`/theme`)
-- **Conversation tools** - `/compact`, `/copy`, `/diff`, `/search`, `/stats`
+- **Conversation tools** - `/compact`, `/copy`, `/diff`, `/search`, `/grep`, `/stats`, `/undo`
+- **Message pinning** - Pin important messages (`/pin`), view pins (`/pins`), export bookmarks (`/bookmark`)
+- **Command aliases** - Create custom shortcuts for frequently used commands (`/alias`)
+- **Code snippets** - Save and load reusable text snippets (`/snippet`)
+- **Debug mode** - Toggle internal state display (`/debug`)
+- **Session context** - View active settings summary (`/context`)
+- **Toast notifications** - Transient status bar messages for save/load/export/theme actions
 - **Hotkey navigation** - Ctrl+D (dashboard), Ctrl+K (palette), Ctrl+S (sessions), Escape (back)
 - **Tab completion** - Type `/` and Tab to auto-complete slash commands
-- **Input history** - Up/down arrow to navigate previous inputs
-- **Progress panel** - Visual progress bars for long operations (extension scanning, gem ops)
+- **Input history** - Up/down arrow to navigate previous inputs, `/history` to view
+- **Progress panel** - Visual progress bars for long operations
 - **Animated spinner** - Status bar spinner during LLM thinking
 - **Daemon routing** - Routes through LegionIO daemon when available, falls back to direct
 - **Second-run flow** - Skips onboarding, re-scans environment, drops into chat
@@ -74,9 +80,9 @@ legion chat prompt "explain async cognition"
 | `/quit` | Exit (auto-saves session) |
 | `/clear` | Clear message history |
 | `/model <name>` | Switch LLM model at runtime |
-| `/session <name>` | Rename current session |
+| `/session <name>` | Set session name |
 | `/cost` | Show token usage and estimated cost |
-| `/export [md\|json]` | Export chat history to file |
+| `/export [md\|json\|html]` | Export chat history to file |
 | `/tools` | List discovered LEX extensions |
 | `/dashboard` | Toggle operational dashboard |
 | `/hotkeys` | Show registered hotkey bindings |
@@ -91,11 +97,24 @@ legion chat prompt "explain async cognition"
 | `/config` | View and edit settings files |
 | `/theme [name]` | Switch color theme (purple/green/blue/amber) |
 | `/search <text>` | Search message history |
+| `/grep <pattern>` | Regex search across messages |
 | `/compact [N]` | Keep last N message pairs, remove older |
 | `/copy` | Copy last assistant response to clipboard |
 | `/diff` | Show new messages since last session load |
 | `/stats` | Show conversation statistics |
 | `/personality [style]` | Switch personality (default/concise/detailed/friendly/technical) |
+| `/undo` | Remove last user+assistant message pair |
+| `/history` | Show input history |
+| `/pin [N]` | Pin a message (last assistant or by index) |
+| `/pins` | Show all pinned messages |
+| `/rename <name>` | Rename current session (moves saved file) |
+| `/context` | Show active session state summary |
+| `/alias [name] [cmd]` | Create or list command aliases |
+| `/snippet <action>` | Save/load/list/delete code snippets |
+| `/debug` | Toggle debug mode |
+| `/uptime` | Show session elapsed time |
+| `/bookmark` | Export pinned messages to file |
+| `/time` | Show current date and time |
 
 ## Hotkeys
 
@@ -120,16 +139,22 @@ legion-tty
 
   Screens/
     Onboarding           # First-run wizard (rain -> intro -> wizard -> reveal)
-    Chat                 # AI chat REPL with streaming + slash commands
-    Dashboard            # Operational status panels
-    Extensions           # LEX gem browser by category
-    Config               # Settings file viewer/editor
+    Chat                 # AI chat REPL with streaming + 40 slash commands
+      SessionCommands    # save/load/sessions/delete/rename
+      ExportCommands     # export/bookmark/html/json/markdown
+      MessageCommands    # compact/copy/diff/search/grep/undo/pin/pins
+      UiCommands         # help/clear/dashboard/hotkeys/palette/context/stats/debug/history/uptime/time
+      ModelCommands      # model/system/personality switching
+      CustomCommands     # alias/snippet management
+    Dashboard            # Service/LLM status, panel navigation (j/k/1-5)
+    Extensions           # LEX gem browser by category with homepage opener
+    Config               # Settings file viewer/editor with JSON validation
 
   Components/
     DigitalRain          # Matrix-style falling characters
-    InputBar             # Prompt line with tab completion + thinking indicator
-    MessageStream        # Scrollable message history with markdown rendering
-    StatusBar            # Model, plan mode, thinking, tokens, cost, session
+    InputBar             # Prompt line with tab completion + input history
+    MessageStream        # Scrollable message history with markdown + timestamps
+    StatusBar            # Model, plan, debug, notifications, thinking, tokens, cost, session, scroll
     ToolPanel            # Expandable tool use panels
     MarkdownView         # TTY::Markdown rendering
     WizardPrompt         # TTY::Prompt wrappers
@@ -161,6 +186,7 @@ Identity and credentials are stored in `~/.legionio/settings/`:
 - `credentials.json` - LLM provider and API key (chmod 600)
 
 Sessions are stored in `~/.legionio/sessions/`.
+Snippets are stored in `~/.legionio/snippets/`.
 Exports go to `~/.legionio/exports/`.
 Boot logs go to `~/.legionio/logs/tty-boot.log`.
 
@@ -168,8 +194,8 @@ Boot logs go to `~/.legionio/logs/tty-boot.log`.
 
 ```bash
 bundle install
-bundle exec rspec       # 653 examples, 0 failures
-bundle exec rubocop     # 77 files, 0 offenses
+bundle exec rspec       # 836 examples, 0 failures
+bundle exec rubocop     # 92 files, 0 offenses
 ```
 
 ## License

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

@@ -5,12 +5,15 @@ require_relative '../theme'
 module Legion
   module TTY
     module Components
+      # rubocop:disable Metrics/ClassLength
       class MessageStream
         attr_reader :messages, :scroll_offset
+        attr_accessor :mute_system
 
         def initialize
           @messages = []
           @scroll_offset = 0
+          @mute_system = false
         end
 
         def add_message(role:, content:)
@@ -69,7 +72,11 @@ module Legion
         private
 
         def build_all_lines(width)
-          @messages.flat_map { |msg| render_message(msg, width) }
+          @messages.flat_map do |msg|
+            next [] if @mute_system && msg[:role] == :system
+
+            render_message(msg, width)
+          end
         end
 
         def render_message(msg, width)
@@ -131,6 +138,7 @@ module Legion
           panel.instance_variable_set(:@error, error) if error
         end
       end
+      # rubocop:enable Metrics/ClassLength
     end
   end
 end

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

@@ -6,10 +6,11 @@ require_relative 'notification'
 module Legion
   module TTY
     module Components
+      # rubocop:disable Metrics/ClassLength
       class StatusBar
         def initialize
           @state = { model: nil, tokens: 0, cost: 0.0, session: 'default', thinking: false, plan_mode: false,
-                     debug_mode: false }
+                     debug_mode: false, message_count: 0 }
           @notifications = []
         end
 
@@ -46,6 +47,7 @@ module Legion
             notification_segment,
             tokens_segment,
             cost_segment,
+            message_count_segment,
             session_segment,
             scroll_segment
           ].compact
@@ -90,6 +92,11 @@ module Legion
           Theme.c(:success, format('$%.3f', @state[:cost])) if @state[:cost].to_f.positive?
         end
 
+        def message_count_segment
+          count = @state[:message_count].to_i
+          Theme.c(:muted, "#{count} msgs") if count.positive?
+        end
+
         def session_segment
           Theme.c(:muted, @state[:session]) if @state[:session]
         end
@@ -132,6 +139,7 @@ module Legion
           result
         end
       end
+      # rubocop:enable Metrics/ClassLength
     end
   end
 end

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

@@ -4,6 +4,7 @@ module Legion
   module TTY
     module Screens
       class Chat < Base
+        # rubocop:disable Metrics/ModuleLength
         module SessionCommands
           private
 
@@ -76,6 +77,42 @@ module Legion
             :handled
           end
 
+          def handle_import(input)
+            path = input.split(nil, 2)[1]
+            unless path
+              @message_stream.add_message(role: :system, content: 'Usage: /import <path>')
+              return :handled
+            end
+
+            load_import_file(File.expand_path(path))
+          rescue ::JSON::ParserError => e
+            @message_stream.add_message(role: :system, content: "Invalid JSON: #{e.message}")
+            :handled
+          end
+
+          def load_import_file(path)
+            unless File.exist?(path)
+              @message_stream.add_message(role: :system, content: "File not found: #{path}")
+              return :handled
+            end
+
+            data = ::JSON.parse(File.read(path), symbolize_names: true)
+            unless data.is_a?(Hash) && data[:messages].is_a?(Array)
+              @message_stream.add_message(role: :system, content: 'Invalid session file: missing messages array.')
+              return :handled
+            end
+
+            apply_imported_messages(data[:messages], path)
+          end
+
+          def apply_imported_messages(messages, path)
+            imported = messages.map { |m| { role: m[:role].to_sym, content: m[:content].to_s } }
+            @message_stream.messages.replace(imported)
+            @status_bar.notify(message: "Imported #{imported.size} messages", level: :success, ttl: 3)
+            @message_stream.add_message(role: :system, content: "Imported #{imported.size} messages from #{path}.")
+            :handled
+          end
+
           def auto_save_session
             return if @message_stream.messages.empty?
 
@@ -87,6 +124,7 @@ module Legion
             nil
           end
         end
+        # rubocop:enable Metrics/ModuleLength
       end
     end
   end

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

@@ -6,40 +6,61 @@ module Legion
       class Chat < Base
         # rubocop:disable Metrics/ModuleLength
         module UiCommands
+          TIPS = [
+            'Press Tab after / to auto-complete commands',
+            'Use /alias to create shortcuts (e.g., /alias s /save)',
+            'Press Ctrl+K to open the command palette',
+            'Use /grep for regex search (e.g., /grep error|warning)',
+            'Pin important messages with /pin, export with /bookmark',
+            'Use /compact 3 to keep only the last 3 message pairs',
+            "Press 'o' in Extensions browser to open gem homepage",
+            '/export html creates a styled dark-theme HTML export',
+            'Use /snippet save name to save assistant responses for reuse',
+            'The dashboard updates every 5 seconds; press r to refresh',
+            '/context shows your full session state at a glance',
+            'Use /personality technical for code-focused responses',
+            '/debug shows internal state counters in the status bar',
+            'Navigate dashboard panels with j/k or number keys 1-5',
+            'Use /diff to see new messages since a session was loaded'
+          ].freeze
+
+          HELP_TEXT = [
+            'SESSION : /save /load /sessions /delete /rename',
+            'CHAT    : /clear /undo /compact /copy /search /grep /diff /stats',
+            'LLM     : /model /system /personality /cost',
+            'NAV     : /dashboard /extensions /config /palette /hotkeys',
+            'DISPLAY : /theme /plan /debug /context /time /uptime',
+            'TOOLS   : /tools /export /bookmark /pin /pins /alias /snippet /history',
+            '',
+            'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back'
+          ].freeze
+
           private
 
-          # rubocop:disable Metrics/MethodLength
           def handle_help
+            text = HELP_TEXT.join("\n")
+            if @app.respond_to?(:screen_manager) && @app.screen_manager
+              @app.screen_manager.show_overlay(text)
+            else
+              @message_stream.add_message(role: :system, content: text)
+            end
+            :handled
+          end
+
+          def handle_welcome
+            cfg = safe_config
             @message_stream.add_message(
               role: :system,
-              content: "Commands:\n  /help /quit /clear /model <name> /session <name> /cost\n  " \
-                       "/export [md|json] /tools /dashboard /hotkeys /save /load /sessions\n  " \
-                       "/system <prompt> /delete <session> /plan /palette /extensions /config\n  " \
-                       "/theme [name] -- switch color theme (purple, green, blue, amber)\n  " \
-                       "/search <text> -- search message history\n  " \
-                       "/grep <regex> -- regex search message history\n  " \
-                       "/compact [n] -- keep last n message pairs (default 5)\n  " \
-                       "/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  " \
-                       "/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  " \
-                       "/uptime -- show how long this session has been active\n  " \
-                       "/time -- show current date, time, and timezone\n  " \
-                       "/bookmark -- export pinned messages to a markdown file\n\n" \
-                       'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back'
+              content: "Welcome#{", #{cfg[:name]}" if cfg[:name]}. Type /help for commands."
             )
             :handled
           end
-          # rubocop:enable Metrics/MethodLength
+
+          def handle_tips
+            tip = TIPS.sample
+            @message_stream.add_message(role: :system, content: "Tip: #{tip}")
+            :handled
+          end
 
           def handle_clear
             @message_stream.messages.clear
@@ -183,15 +204,62 @@ module Legion
             end
           end
 
+          def handle_wc
+            msgs = @message_stream.messages
+            by_role = word_counts_by_role(msgs)
+            total = by_role.values.sum
+            avg = (total.to_f / [msgs.size, 1].max).round
+            @message_stream.add_message(role: :system, content: build_wc_lines(by_role, total, avg).join("\n"))
+            :handled
+          end
+
+          def word_counts_by_role(msgs)
+            %i[user assistant system].to_h do |role|
+              words = msgs.select { |m| m[:role] == role }.sum { |m| m[:content].to_s.split.size }
+              [role, words]
+            end
+          end
+
+          def build_wc_lines(by_role, total, avg)
+            [
+              'Word count:',
+              "  Total: #{format_stat_number(total)}",
+              "  User: #{format_stat_number(by_role[:user])}",
+              "  Assistant: #{format_stat_number(by_role[:assistant])}",
+              "  System: #{format_stat_number(by_role[:system])}",
+              "  Avg words/message: #{avg}"
+            ]
+          end
+
+          def handle_mute
+            @muted_system = !@muted_system
+            @message_stream.mute_system = @muted_system
+            if @muted_system
+              @status_bar.notify(message: 'System messages hidden', level: :info, ttl: 3)
+            else
+              @status_bar.notify(message: 'System messages visible', level: :info, ttl: 3)
+            end
+            :handled
+          end
+
           def build_stats_lines
             msgs = @message_stream.messages
             counts = count_by_role(msgs)
             total_chars = msgs.sum { |m| m[:content].to_s.length }
             lines = stats_header_lines(msgs, counts, total_chars)
             lines << "  Tool calls: #{counts[:tool]}" if counts[:tool].positive?
+            append_response_time_stat(lines, msgs)
             lines
           end
 
+          def append_response_time_stat(lines, msgs)
+            timed = msgs.select { |m| m[:response_time] }
+            return unless timed.any?
+
+            avg_rt = timed.sum { |m| m[:response_time] }.to_f / timed.size
+            lines << "  Avg response time: #{avg_rt.round(2)}s (#{timed.size} responses)"
+          end
+
           def count_by_role(msgs)
             %i[user assistant system tool].to_h { |role| [role, msgs.count { |m| m[:role] == role }] }
           end

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

@@ -28,7 +28,8 @@ module Legion
         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 /grep /stats /personality /undo /history /pin /pins /rename
-                            /context /alias /snippet /debug /uptime /time /bookmark].freeze
+                            /context /alias /snippet /debug /uptime /time /bookmark /welcome /tips
+                            /wc /import /mute].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -58,6 +59,7 @@ module Legion
           @snippets = {}
           @debug_mode = false
           @session_start = Time.now
+          @muted_system = false
         end
 
         # rubocop:enable Metrics/AbcSize
@@ -71,6 +73,7 @@ module Legion
             role: :system,
             content: "Welcome#{", #{cfg[:name]}" if cfg[:name]}. Type /help for commands."
           )
+          @status_bar.update(message_count: @message_stream.messages.size)
         end
 
         def running?
@@ -124,6 +127,7 @@ module Legion
             @message_stream.add_message(role: :assistant, content: '')
             send_to_llm(input)
           end
+          @status_bar.update(message_count: @message_stream.messages.size)
           render_screen
         end
 
@@ -200,15 +204,23 @@ module Legion
 
           @status_bar.update(thinking: true)
           render_screen
+          start_time = Time.now
           response = @llm_chat.ask(message) do |chunk|
             @status_bar.update(thinking: false)
             @message_stream.append_streaming(chunk.content) if chunk.content
             render_screen
           end
+          record_response_time(Time.now - start_time)
           @status_bar.update(thinking: false)
           track_response_tokens(response)
         end
 
+        def record_response_time(elapsed)
+          @last_response_time = elapsed
+          @message_stream.messages.last[:response_time] = elapsed if @message_stream.messages.last
+          @status_bar.notify(message: "Response: #{elapsed.round(1)}s", level: :info, ttl: 4)
+        end
+
         def daemon_available?
           !!(defined?(Legion::LLM::DaemonClient) && Legion::LLM::DaemonClient.available?)
         end
@@ -336,6 +348,11 @@ module Legion
           when '/uptime' then handle_uptime
           when '/time' then handle_time
           when '/bookmark' then handle_bookmark
+          when '/welcome' then handle_welcome
+          when '/tips' then handle_tips
+          when '/wc' then handle_wc
+          when '/import' then handle_import(input)
+          when '/mute' then handle_mute
           else :handled
           end
         end

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.12'
+    VERSION = '0.4.14'
   end
 end

metadata

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