legion-tty 0.4.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7b05c783669ce2e8482bd36b3654b75d626d3fc2b738e684a6b9fad407881e1
-  data.tar.gz: 34418c0af4571764d36096de930f126a92b192fe87ff22c2acbbcbb71f45a090
+  metadata.gz: 3985cb489efcaf4eaf208514bee79ff9650b1f841a00cd76a32468a0734e4198
+  data.tar.gz: fa7c612dac3248efe49762a4bd6b869b8348c4388ee569fdbd60c030501db918
 SHA512:
-  metadata.gz: 1f913c1e7ec15e45a7d27d24393e721852ffd28e7d61c1d3284996fe564bd30ee2dcd9910676eb40bf5239cfbf9068f5561c95f61bf55c0f1beb8ff95677925f
-  data.tar.gz: 995fc6176e39c16dae3b1570149ed8292c0c30174fa5eecd5effcafcfa5004eb8006a135b8c815199bf1003e46f26c227a65f1ecb3f00a35ebcc0b48d16f5fc6
+  metadata.gz: 9909b4d373d5b22892611dd3c302d02cb4960bfec8524da602c117b62de5d8fbacb9f39a777b97e5eabe9c379e4918fb79aab313d2f67e5c4129ff1214153d32
+  data.tar.gz: 3b8e072e3ad9cb3bd73b9e7e7bb5b6fb6baa86527e4da6e0045564c40851ec77e5e67a89cf7409d1280b59dc1a34831780859d56632e6e4c9a7b6095991a555f

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.4.2] - 2026-03-19
+
+### Added
+- Multi-provider model switching: `/model <provider>` creates new Legion::LLM.chat instance
+- Model picker integration: `open_model_picker` for interactive provider/model selection
+- ToolPanel wiring in MessageStream: `add_tool_call`, `update_tool_call` methods
+- Tool call rendering in chat messages (`:tool` role with panel display)
+
+### Fixed
+- Flaky table_view_spec: added explicit `require 'tty-table'` to prevent test ordering failures
+
+## [0.4.1] - 2026-03-19
+
+### Added
+- Progress panel component wrapping tty-progressbar for long operations
+- Tab completion for slash commands (type `/` + Tab to cycle through matches)
+- InputBar now accepts `completions:` parameter for configurable auto-complete
+
+### Changed
+- README.md updated to reflect 0.4.x features, hotkeys, architecture
+- CLAUDE.md updated to reflect current version, components, LLM integration notes
+
 ## [0.4.0] - 2026-03-19
 
 ### Fixed

data/README.md

@@ -2,19 +2,26 @@
 
 Rich terminal UI for the LegionIO async cognition engine.
 
-**Version**: 0.2.9
+**Version**: 0.4.1
 
-Think Claude Code meets Codex CLI, but for LegionIO: onboarding wizard with identity detection, streaming AI chat shell, operational dashboard, 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, 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 slash commands, tool panels, and markdown rendering
+- **AI chat shell** - Streaming LLM chat with 19 slash commands, tab completion, markdown rendering, and tool panels
 - **Operational dashboard** - Service status, extension inventory, system info, recent activity (Ctrl+D or `/dashboard`)
-- **Session persistence** - Auto-save on quit, `/save`, `/load`, `/sessions` to manage history across runs
-- **Token tracking** - Real-time input/output token counts and estimated cost via `/cost`
-- **Hotkey navigation** - Ctrl+D (dashboard), Ctrl+L (refresh), ? (help overlay)
+- **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
+- **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)
+- **Token tracking** - Per-model pricing for 9 models across 8 providers via `/cost`
+- **Plan mode** - Bookmark messages without sending to LLM (`/plan`)
+- **Hotkey navigation** - Ctrl+D (dashboard), Ctrl+K (palette), Ctrl+S (sessions), Escape (back)
+- **Tab completion** - Type `/` and Tab to auto-complete slash commands
+- **Progress panel** - Visual progress bars for long operations (extension scanning, gem ops)
 - **Second-run flow** - Skips onboarding, re-scans environment, drops into chat
 
 ## Installation
@@ -35,6 +42,7 @@ brew install legion
 
 ```bash
 legion-tty
+legion-tty --skip-rain    # skip digital rain animation
 ```
 
 ### Via LegionIO CLI
@@ -56,7 +64,7 @@ legion chat prompt "explain async cognition"
 
 | Command | Description |
 |---------|-------------|
-| `/help` | Show all commands |
+| `/help` | Show all commands and hotkeys |
 | `/quit` | Exit (auto-saves session) |
 | `/clear` | Clear message history |
 | `/model <name>` | Switch LLM model at runtime |
@@ -69,6 +77,23 @@ legion chat prompt "explain async cognition"
 | `/save [name]` | Save current session |
 | `/load <name>` | Load a saved session |
 | `/sessions` | List all saved sessions |
+| `/system <prompt>` | Set or override system prompt |
+| `/delete <session>` | Delete a saved session |
+| `/plan` | Toggle read-only bookmark mode |
+| `/palette` | Open command palette (fuzzy search) |
+| `/extensions` | Browse installed LEX extensions |
+| `/config` | View and edit settings files |
+
+## Hotkeys
+
+| Key | Action |
+|-----|--------|
+| Ctrl+D | Toggle dashboard |
+| Ctrl+K | Open command palette |
+| Ctrl+S | Open session picker |
+| Ctrl+L | Refresh screen |
+| Escape | Go back / dismiss overlay |
+| Tab | Auto-complete slash commands |
 
 ## Architecture
 
@@ -84,16 +109,23 @@ legion-tty
     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
 
   Components/
     DigitalRain          # Matrix-style falling characters
-    InputBar             # Prompt line with thinking indicator
-    MessageStream        # Scrollable message history
-    StatusBar            # Model, tokens, cost, session display
+    InputBar             # Prompt line with tab completion + thinking indicator
+    MessageStream        # Scrollable message history with markdown rendering
+    StatusBar            # Model, plan mode, thinking, tokens, cost, session
     ToolPanel            # Expandable tool use panels
     MarkdownView         # TTY::Markdown rendering
     WizardPrompt         # TTY::Prompt wrappers
-    TokenTracker         # Token counting and cost estimation
+    TokenTracker         # Per-model token counting and cost estimation
+    CommandPalette       # Fuzzy-search command/screen/session overlay
+    ModelPicker          # LLM provider/model selection
+    SessionPicker        # Session list and selection
+    TableView            # TTY::Table wrapper
+    ProgressPanel        # TTY::ProgressBar wrapper
 
   Background/
     Scanner              # Service port probing, git repo discovery, shell history
@@ -101,20 +133,11 @@ legion-tty
     KerberosProbe        # klist + LDAP profile resolution
 ```
 
-## Comparison
-
-| Feature | legion-tty | Claude Code | Codex CLI |
-|---------|-----------|-------------|-----------|
-| Onboarding wizard | Yes (identity detection) | No (API key only) | No |
-| Streaming chat | Yes | Yes | Yes |
-| Tool use panels | Yes | Yes | Yes |
-| Dashboard | Yes (services, extensions) | No | No |
-| Session persistence | Yes | Yes (conversations) | No |
-| Environment scanning | Yes (services, repos, history) | Yes (git context) | Yes (git context) |
-| Extension ecosystem | Yes (LEX gems) | Yes (MCP servers) | Yes (tools) |
-| Identity probing | Yes (Kerberos, GitHub, LDAP) | No | No |
-| Token/cost tracking | Yes | Yes | Yes |
-| Hotkey navigation | Yes | Yes | No |
+## LLM Integration
+
+legion-tty uses **Legion::LLM exclusively** for all LLM operations. No direct RubyLLM calls. If Legion::LLM is not available or not started, the chat shell runs without LLM (commands still work, messages show "LLM not configured").
+
+The boot sequence mirrors `Legion::Service`: logging -> settings -> crypt -> resolve_secrets -> LLM merge -> start.
 
 ## Configuration
 
@@ -131,8 +154,8 @@ Boot logs go to `~/.legionio/logs/tty-boot.log`.
 
 ```bash
 bundle install
-bundle exec rspec
-bundle exec rubocop
+bundle exec rspec       # 598 examples, 0 failures
+bundle exec rubocop     # 68 files, 0 offenses
 ```
 
 ## License

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

@@ -6,8 +6,11 @@ module Legion
   module TTY
     module Components
       class InputBar
-        def initialize(name: 'User', reader: nil)
+        attr_reader :completions
+
+        def initialize(name: 'User', reader: nil, completions: [])
           @name = name
+          @completions = completions
           @reader = reader || build_default_reader
           @thinking = false
         end
@@ -32,14 +35,47 @@ module Legion
           @thinking
         end
 
+        def complete(partial)
+          return [] if partial.nil? || partial.empty?
+
+          @completions.select { |c| c.start_with?(partial) }.sort
+        end
+
         private
 
         def build_default_reader
           require 'tty-reader'
-          ::TTY::Reader.new
+          reader = ::TTY::Reader.new
+          register_tab_completion(reader)
+          reader
         rescue LoadError
           nil
         end
+
+        def register_tab_completion(reader)
+          return if @completions.empty?
+
+          @tab_matches = []
+          @tab_index = 0
+
+          reader.on(:keypress) do |event|
+            handle_tab(event) if event.value == "\t"
+          end
+        end
+
+        def handle_tab(event)
+          line = event.line.text.to_s
+          matches = complete(line)
+          return if matches.empty?
+
+          if matches.size == 1
+            event.line.replace(matches.first)
+          else
+            @tab_matches = matches unless @tab_matches == matches
+            event.line.replace(@tab_matches[@tab_index % @tab_matches.size])
+            @tab_index += 1
+          end
+        end
       end
     end
   end

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

@@ -29,6 +29,21 @@ module Legion
           @messages.last[:tool_panels] << panel
         end
 
+        def add_tool_call(name:, args: {}, status: :running)
+          require_relative 'tool_panel'
+          panel = ToolPanel.new(name: name, args: args, status: status)
+          @messages << { role: :tool, content: panel, tool_panel: true }
+        end
+
+        def update_tool_call(name:, status:, duration: nil, result: nil, error: nil)
+          tool_msg = @messages.reverse.find do |m|
+            m[:tool_panel] && m[:content].is_a?(ToolPanel) && m[:content].instance_variable_get(:@name) == name
+          end
+          return unless tool_msg
+
+          apply_tool_panel_update(tool_msg[:content], status: status, duration: duration, result: result, error: error)
+        end
+
         def scroll_up(lines = 1)
           @scroll_offset += lines
         end
@@ -60,6 +75,7 @@ module Legion
           when :user then user_lines(msg)
           when :assistant then assistant_lines(msg, width)
           when :system then system_lines(msg)
+          when :tool then tool_call_lines(msg, width)
           else []
           end
         end
@@ -85,9 +101,22 @@ module Legion
           msg[:content].split("\n").map { |l| "  #{Theme.c(:muted, l)}" }
         end
 
+        def tool_call_lines(msg, width)
+          return [] unless msg[:tool_panel] && msg[:content].respond_to?(:render)
+
+          msg[:content].render(width: width).split("\n")
+        end
+
         def panel_lines(msg, width)
           msg[:tool_panels].flat_map { |panel| panel.render(width: width).split("\n") }
         end
+
+        def apply_tool_panel_update(panel, status:, duration:, result:, error:)
+          panel.instance_variable_set(:@status, status)
+          panel.instance_variable_set(:@duration, duration) if duration
+          panel.instance_variable_set(:@result, result) if result
+          panel.instance_variable_set(:@error, error) if error
+        end
       end
     end
   end

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

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require_relative '../theme'
+
+module Legion
+  module TTY
+    module Components
+      class ProgressPanel
+        attr_reader :title, :total, :current
+
+        def initialize(title:, total:, output: $stdout)
+          @title = title
+          @total = total
+          @current = 0
+          @output = output
+          @bar = build_bar
+        end
+
+        def advance(step = 1)
+          @current = [@current + step, @total].min
+          @bar&.advance(step)
+        end
+
+        def finish
+          remaining = @total - @current
+          @bar&.advance(remaining) if remaining.positive?
+          @current = @total
+        end
+
+        def finished?
+          @current >= @total
+        end
+
+        def percent
+          return 0 if @total.zero?
+
+          ((@current.to_f / @total) * 100).round(1)
+        end
+
+        def render(width: 80)
+          pct = percent
+          label = Theme.c(:accent, @title)
+          bar = build_render_bar(width, pct)
+          "#{label} [#{bar}] #{Theme.c(:secondary, "#{pct}%")}"
+        end
+
+        private
+
+        def build_render_bar(width, pct)
+          bar_width = [width - @title.length - 12, 10].max
+          filled = (bar_width * pct / 100.0).round
+          empty = bar_width - filled
+          Theme.c(:primary, '#' * filled) + Theme.c(:muted, '-' * empty)
+        end
+
+        def build_bar
+          require 'tty-progressbar'
+          ::TTY::ProgressBar.new(
+            "#{@title} [:bar] :percent",
+            total: @total,
+            output: @output,
+            width: 40
+          )
+        rescue LoadError
+          nil
+        end
+      end
+    end
+  end
+end

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

@@ -92,20 +92,16 @@ module Legion
         end
 
         def send_to_llm(message)
-          unless @llm_chat
+          unless @llm_chat || daemon_available?
             @message_stream.append_streaming('LLM not configured. Use /help for commands.')
             return
           end
 
-          @status_bar.update(thinking: true)
-          render_screen
-          response = @llm_chat.ask(message) do |chunk|
-            @status_bar.update(thinking: false)
-            @message_stream.append_streaming(chunk.content) if chunk.content
-            render_screen
+          if daemon_available?
+            send_via_daemon(message)
+          else
+            send_via_direct(message)
           end
-          @status_bar.update(thinking: false)
-          track_response_tokens(response)
         rescue StandardError => e
           @status_bar.update(thinking: false)
           @message_stream.append_streaming("\n[Error: #{e.message}]")
@@ -142,6 +138,40 @@ module Legion
           @llm_chat.with_instructions(prompt) if @llm_chat.respond_to?(:with_instructions)
         end
 
+        def send_via_daemon(message)
+          result = Legion::LLM.ask(message: message)
+
+          case result&.dig(:status)
+          when :done
+            @message_stream.append_streaming(result[:response])
+          when :error
+            err = result.dig(:error, :message) || 'Unknown error'
+            @message_stream.append_streaming("\n[Daemon error: #{err}]")
+          else
+            send_via_direct(message)
+          end
+        rescue StandardError
+          send_via_direct(message)
+        end
+
+        def send_via_direct(message)
+          return unless @llm_chat
+
+          @status_bar.update(thinking: true)
+          render_screen
+          response = @llm_chat.ask(message) do |chunk|
+            @status_bar.update(thinking: false)
+            @message_stream.append_streaming(chunk.content) if chunk.content
+            render_screen
+          end
+          @status_bar.update(thinking: false)
+          track_response_tokens(response)
+        end
+
+        def daemon_available?
+          !!(defined?(Legion::LLM::DaemonClient) && Legion::LLM::DaemonClient.available?)
+        end
+
         # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
         def build_system_prompt(cfg)
           lines = ['You are Legion, an async cognition engine and AI assistant.']
@@ -282,16 +312,50 @@ module Legion
             return
           end
 
-          if @llm_chat.respond_to?(:with_model)
+          apply_model_switch(name)
+        rescue StandardError => e
+          @message_stream.add_message(role: :system, content: "Failed to switch model: #{e.message}")
+        end
+
+        def apply_model_switch(name)
+          new_chat = try_provider_switch(name)
+          if new_chat
+            @llm_chat = new_chat
+            @status_bar.update(model: name)
+            @token_tracker.update_model(name)
+            @message_stream.add_message(role: :system, content: "Switched to provider: #{name}")
+          elsif @llm_chat.respond_to?(:with_model)
             @llm_chat.with_model(name)
             @status_bar.update(model: name)
+            @token_tracker.update_model(name)
             @message_stream.add_message(role: :system, content: "Model switched to: #{name}")
           else
             @status_bar.update(model: name)
             @message_stream.add_message(role: :system, content: "Model set to: #{name}")
           end
-        rescue StandardError => e
-          @message_stream.add_message(role: :system, content: "Failed to switch model: #{e.message}")
+        end
+
+        def try_provider_switch(name)
+          return nil unless defined?(Legion::LLM)
+
+          providers = Legion::LLM.settings[:providers]
+          return nil unless providers.is_a?(Hash) && providers.key?(name.to_sym)
+
+          Legion::LLM.chat(provider: name)
+        rescue StandardError
+          nil
+        end
+
+        def open_model_picker
+          require_relative '../components/model_picker'
+          picker = Components::ModelPicker.new(
+            current_provider: safe_config[:provider],
+            current_model: @llm_chat.respond_to?(:model) ? @llm_chat.model.to_s : nil
+          )
+          selection = picker.select_with_prompt(output: @output)
+          return unless selection
+
+          switch_model(selection[:provider])
         end
 
         def show_current_model
@@ -551,7 +615,7 @@ module Legion
         def build_default_input_bar
           cfg = safe_config
           name = cfg[:name] || 'User'
-          Components::InputBar.new(name: name)
+          Components::InputBar.new(name: name, completions: SLASH_COMMANDS)
         end
 
         def terminal_width

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.0'
+    VERSION = '0.4.2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-tty
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - Esity
@@ -207,6 +207,7 @@ files:
 - lib/legion/tty/components/markdown_view.rb
 - lib/legion/tty/components/message_stream.rb
 - lib/legion/tty/components/model_picker.rb
+- lib/legion/tty/components/progress_panel.rb
 - lib/legion/tty/components/session_picker.rb
 - lib/legion/tty/components/status_bar.rb
 - lib/legion/tty/components/table_view.rb