legion-tty 0.4.11 → 0.4.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e2b8a679110725634b3db870bb623fc8f5cef89706890f9c57c579490c85114
-  data.tar.gz: 6487e27647ed48406731a9c0c1bf1664b64831b60139dd698ae794d2dc8d3871
+  metadata.gz: bc958211b7004e0392a9e96cf2a874d6c54d6f0c6f183d87d80f428e16d3b014
+  data.tar.gz: 13264f1761391724054983f250767d9308aab1a397d0dc1577292268a0f7e031
 SHA512:
-  metadata.gz: 9c89fb3dbcb807c628889b2b60566b3b23cad1356c26de42cd1d02d75a2977e7856528b0193e8bb9dd630ee4cf52b2b55e06e009c8fc3e34550a1712d6768b68
-  data.tar.gz: ae426495d1eb8708723a5c2804a4a77e4a557480324c23b370b0ebe324ea1a7ece957665b133f7810952f03f586cb0e87dcef3e1c78e9fcde81fe13e0e6e4760
+  metadata.gz: fd92069e863ebb5bd1185068adf3f50323fb276a2ae0479a8253e0220c1e4bc22a76abb7b8eb73a4c4a22c84be9f22cddf6eea22d510d7772fd459d3d74a1ff9
+  data.tar.gz: afcce634192c2e16f133b0d237cd3720536dfce07e2cae17089f208867546d82d75a58bb352887da1d0d29c0e651d047b79596fea0428d35f152e48f17707069

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [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
+- `/grep <pattern>` command: regex search across message history (case-insensitive, with RegexpError handling)
+- `/time` command: display current date, time, and timezone
+
+### Changed
+- Refactored Chat screen into 6 concern modules (chat.rb 1220 -> 466 lines):
+  - `chat/session_commands.rb` — save/load/sessions/delete/rename
+  - `chat/export_commands.rb` — export/bookmark/html/json/markdown
+  - `chat/message_commands.rb` — compact/copy/diff/search/grep/undo/pin/pins
+  - `chat/ui_commands.rb` — help/clear/dashboard/hotkeys/palette/context/stats/debug/history/uptime/time
+  - `chat/model_commands.rb` — model/system/personality switching
+  - `chat/custom_commands.rb` — alias/snippet management
+
 ## [0.4.11] - 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/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/custom_commands.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+module Legion
+  module TTY
+    module Screens
+      class Chat < Base
+        # rubocop:disable Metrics/ModuleLength
+        module CustomCommands
+          private
+
+          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 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
+        end
+        # rubocop:enable Metrics/ModuleLength
+      end
+    end
+  end
+end

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

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module Legion
+  module TTY
+    module Screens
+      class Chat < Base
+        module ExportCommands
+          private
+
+          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]
+            File.join(exports_dir, "chat-#{timestamp}.#{ext}")
+          end
+
+          def dispatch_export(path, format)
+            if format == 'json'
+              export_json(path)
+            elsif format == 'html'
+              export_html(path)
+            else
+              export_markdown(path)
+            end
+          end
+
+          def export_markdown(path)
+            lines = ["# Chat Export\n", "_Exported: #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}_\n\n---\n"]
+            @message_stream.messages.each do |msg|
+              role_label = msg[:role].to_s.capitalize
+              lines << "\n**#{role_label}**\n\n#{msg[:content]}\n"
+            end
+            File.write(path, lines.join)
+          end
+
+          def export_json(path)
+            require 'json'
+            data = {
+              exported_at: Time.now.iso8601,
+              token_summary: @token_tracker.summary,
+              messages: @message_stream.messages.map { |m| { role: m[:role].to_s, content: m[:content] } }
+            }
+            File.write(path, ::JSON.pretty_generate(data))
+          end
+
+          # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+          def export_html(path)
+            lines = [
+              '<!DOCTYPE html><html><head>',
+              '<meta charset="utf-8">',
+              '<title>Chat Export</title>',
+              '<style>',
+              'body { font-family: system-ui; max-width: 800px; margin: 0 auto; ' \
+              'padding: 20px; background: #1e1b2e; color: #d0cce6; }',
+              '.msg { margin: 12px 0; padding: 8px 12px; border-radius: 8px; }',
+              '.user { background: #2a2640; }',
+              '.assistant { background: #1a1730; }',
+              '.system { background: #25223a; color: #8b85a8; font-style: italic; }',
+              '.role { font-weight: bold; color: #9d91e6; font-size: 0.85em; }',
+              '</style></head><body>',
+              '<h1>Chat Export</h1>',
+              "<p>Exported: #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}</p>"
+            ]
+            @message_stream.messages.each do |msg|
+              role = msg[:role].to_s
+              content = escape_html(msg[:content].to_s).gsub("\n", '<br>')
+              lines << "<div class='msg #{role}'>"
+              lines << "<span class='role'>#{role.capitalize}</span>"
+              lines << "<p>#{content}</p>"
+              lines << '</div>'
+            end
+            lines << '</body></html>'
+            File.write(path, lines.join("\n"))
+          end
+          # rubocop:enable Metrics/MethodLength, Metrics/AbcSize
+
+          def escape_html(text)
+            text.gsub('&', '&amp;').gsub('<', '&lt;').gsub('>', '&gt;').gsub('"', '&quot;')
+          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
+        end
+      end
+    end
+  end
+end