legion-tty 0.4.25 → 0.4.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2baad187737411e10cb975111c2e766cd5b1b1c20bc27b7731cc990672597a0
-  data.tar.gz: e2d8eaabf4459beba0805f830025321c11fa70ea572aba05640b005e20dbd12a
+  metadata.gz: 8afc2aa24b5ae5e56f84d7f7ff538e9d0ccc0b9274fd983cec26116fb234b774
+  data.tar.gz: 2d442f8ca2ec7a2624f4f3de63defb569c3b324babfff9e8f98c9540bef984d3
 SHA512:
-  metadata.gz: 53b05dc182ec33a56c75c58a3936c9753b018c8a78ac3ae83f2fac588bafdf5ecb09026a9f70120b86d7685ce75d484bd993ef83efabf84ee0f63c4d81daefb8
-  data.tar.gz: 6f6849814bba37b3ebee42a88be6a927efaa913437d1c050586902aa4850cbf334df571e310818b6ddc711ff5d0828ef89e12cb8e249d9b704248e73898e200c
+  metadata.gz: f1cd31e1a7fff97bd1de1088247fa1c195c27beaaef7f7d94df5e0ebaf6e46bca7c31a55c2321956c9fbbb46a88e862b6db6139f5df54b104785e1061766b37e
+  data.tar.gz: f38bec5c06b804f6b74fc103804a7b46cb9a9b762ec73c4eac3409d0ea72db235b69638b93cd8342a9052d4a5eb20399498b05e0cda59a303c911c4b08e734f2

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.4.26] - 2026-03-19
+
+### Added
+- `/goto <N>` command: jump to specific message by index
+- `/inject <role> <text>` command: inject a message with specific role (user/assistant/system)
+- `/stopwatch [start|stop|lap|reset]` command: built-in stopwatch with MM:SS.ms format
+- `/ago <N>` command: show what was said N messages ago
+
+### Changed
+- Updated README.md and CLAUDE.md to reflect 107 slash commands, 1732 specs, 146 files
+
 ## [0.4.25] - 2026-03-19
 
 ### Added

data/README.md

@@ -2,15 +2,15 @@
 
 Rich terminal UI for the LegionIO async cognition engine.
 
-**Version**: 0.4.18
+**Version**: 0.4.25
 
-Think Claude Code meets Codex CLI, but for LegionIO: onboarding wizard with identity detection, streaming AI chat shell with 60 slash commands, 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 103 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 60 slash commands, tab completion, markdown rendering, and tool panels
+- **AI chat shell** - Streaming LLM chat with 103 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
@@ -35,6 +35,26 @@ Think Claude Code meets Codex CLI, but for LegionIO: onboarding wizard with iden
 - **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
+- **Session chaining** - `/chain` sends pipe-separated prompts sequentially; `/info` shows full session state
+- **Scroll navigation** - `/scroll`, `/top`, `/bottom`, `/head`, `/tail` for precise history navigation
+- **Conversation editing** - `/replace`, `/reset`, `/prompt`, `/highlight` for post-hoc message editing
+- **Multi-line input** - `/multiline` toggles submit-on-empty-line mode with `[ML]` status indicator
+- **Message annotations** - `/annotate` and `/annotations` for inline notes on specific messages
+- **Message filtering** - `/filter` by role, tag, or pinned status
+- **Export YAML** - `/export yaml` alongside existing md/json/html formats
+- **Session archiving** - `/archive` moves session to `~/.legionio/archives/` and starts fresh
+- **Shell integration** - `/tee` mirrors messages to a file in real-time; `/pipe` pipes output through a shell command
+- **Math utilities** - `/calc` for safe expression evaluation; `/rand` for random number generation
+- **Shell-like commands** - `/ls`, `/pwd`, `/echo`, `/env` for quick filesystem and environment inspection
+- **Display controls** - `/wrap`, `/number`, `/color`, `/timestamps`, `/truncate`, `/silent`, `/speak`
+- **Draft buffer** - `/draft` and `/revise` for composing and editing messages before sending
+- **Word frequency** - `/freq` shows top-20 words in conversation (excludes stop words)
+- **Named markers** - `/mark` inserts named bookmarks; list all markers with `/mark`
+- **Persistent preferences** - `/prefs` reads/writes `~/.legionio/prefs.json` across sessions
+- **Quick Q&A** - `/ask` and `/define` for concise one-paragraph LLM answers
+- **Status overview** - `/status` shows all 18 toggleable modes and settings at a glance
+- **Command discovery** - `/commands [pattern]` lists all slash commands with optional pattern filter
+- **About info** - `/about` shows gem name, version, author, license, and GitHub URL
 
 ## Installation
 
@@ -76,64 +96,108 @@ legion chat prompt "explain async cognition"
 
 | Command | Description |
 |---------|-------------|
-| `/help` | Show all commands and hotkeys |
-| `/quit` | Exit (auto-saves session) |
+| `/about` | Show gem name, version, author, license, and GitHub URL |
+| `/alias [name] [cmd]` | Create or list command aliases |
+| `/annotate [N] <text>` | Add a note to a specific message |
+| `/annotations` | List all annotated messages with their notes |
+| `/archive [name]` | Archive session to `~/.legionio/archives/` and start fresh |
+| `/archives` | List all archived sessions with file sizes |
+| `/ask <question>` | Quick concise Q&A mode (LLM answers in one paragraph) |
+| `/autosave [N\|off]` | Toggle periodic auto-save with configurable interval |
+| `/bookmark` | Export pinned messages to a markdown file |
+| `/bottom` | Scroll to bottom of message history |
+| `/calc <expression>` | Evaluate a math expression (supports Math functions) |
+| `/chain <p1\|p2\|...>` | Send pipe-separated prompts to LLM sequentially |
 | `/clear` | Clear message history |
-| `/model <name>` | Switch LLM model at runtime |
-| `/session <name>` | Set session name |
+| `/color [on\|off]` | Toggle colorized output (strips ANSI codes when off) |
+| `/commands [pattern]` | List all slash commands with optional pattern filter |
+| `/compact [N]` | Keep last N message pairs, remove older |
+| `/config` | View and edit `~/.legionio/settings/*.json` files |
+| `/context` | Show active session state summary |
+| `/copy` | Copy last assistant response to clipboard |
 | `/cost` | Show token usage and estimated cost |
-| `/export [md\|json\|html]` | Export chat history to file |
-| `/tools` | List discovered LEX extensions |
+| `/count <pattern>` | Count messages matching a pattern with per-role breakdown |
 | `/dashboard` | Toggle operational dashboard |
-| `/hotkeys` | Show registered hotkey bindings |
-| `/save [name]` | Save current session |
-| `/load <name>` | Load a saved session |
-| `/sessions` | List all saved sessions |
-| `/system <prompt>` | Set or override system prompt |
+| `/debug` | Toggle debug mode |
+| `/define <term>` | Ask LLM for a concise definition |
 | `/delete <session>` | Delete a saved session |
-| `/plan` | Toggle read-only bookmark mode |
-| `/palette` | Open command palette (fuzzy search) |
+| `/diff` | Show new messages since last session load |
+| `/draft [text\|send\|clear]` | Save text to draft buffer, show, send, or clear it |
+| `/echo <text>` | Add a user-defined system message note |
+| `/env` | Show environment info (Ruby version, platform, terminal, PID) |
+| `/export [md\|json\|html\|yaml]` | Export chat history to file |
 | `/extensions` | Browse installed LEX extensions |
-| `/config` | View and edit settings files |
-| `/theme [name]` | Switch color theme (purple/green/blue/amber) |
-| `/search <text>` | Search message history |
+| `/fav [N]` | Favorite a message (persists to `~/.legionio/favorites.json`) |
+| `/favs` | Show all favorited messages |
+| `/filter [role\|tag\|pinned\|clear]` | Filter displayed messages |
+| `/focus` | Toggle minimal UI (hide status bar) |
+| `/freq` | Word frequency analysis with top 20 words (excludes stop words) |
 | `/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 |
+| `/head [N]` | Peek at first N messages (default 5) |
+| `/help` | Show all commands and hotkeys |
+| `/highlight <pattern>` | Highlight text patterns in message rendering |
 | `/history` | Show input history |
+| `/hotkeys` | Show registered hotkey bindings |
+| `/import <path>` | Import session from a JSON file |
+| `/info` | Comprehensive session info (modes, counts, aliases, macros, provider) |
+| `/load <name>` | Load a saved session |
+| `/log [N]` | View last N lines of boot log (default 20) |
+| `/ls [path]` | List directory contents |
+| `/macro <action>` | Record/stop/play/list/delete command macros |
+| `/mark <label>` | Insert a named marker/bookmark in conversation |
+| `/merge <session>` | Merge another session into current |
+| `/model <name>` | Switch LLM model at runtime |
+| `/multiline` | Toggle multi-line input mode (submit with empty line) |
+| `/mute` | Toggle system message display |
+| `/number [on\|off]` | Toggle message numbering with `[N]` prefix |
+| `/palette` | Open command palette (fuzzy search) |
+| `/personality [style]` | Switch personality (default/concise/detailed/friendly/technical) |
 | `/pin [N]` | Pin a message (last assistant or by index) |
 | `/pins` | Show all pinned messages |
+| `/pipe <command>` | Pipe last assistant response through a shell command |
+| `/plan` | Toggle read-only bookmark mode |
+| `/prefs [key] [value]` | Read or write persistent user preferences |
+| `/prompt save\|load\|list\|delete` | Persist and reuse custom system prompts |
+| `/pwd` | Show current working directory |
+| `/quit` | Exit (auto-saves session) |
+| `/rand [N\|min..max]` | Generate random numbers (float, integer, or range) |
+| `/react <emoji>` | Add emoji reaction to a message |
 | `/rename <name>` | Rename current session (moves saved file) |
-| `/context` | Show active session state summary |
-| `/alias [name] [cmd]` | Create or list command aliases |
+| `/repeat` | Re-execute the last slash command |
+| `/replace old >>> new` | Find and replace text across all messages |
+| `/reset` | Reset session to clean state |
+| `/retry` | Resend last user message to LLM |
+| `/revise <text>` | Replace the content of the last user message |
+| `/save [name]` | Save current session |
+| `/scroll [top\|bottom\|N]` | Navigate to a specific scroll position |
+| `/search <text>` | Search message history |
+| `/session <name>` | Set session name |
+| `/sessions` | List all saved sessions |
+| `/silent` | Toggle silent mode (responses tracked but not displayed) |
 | `/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 |
-| `/autosave [N\|off]` | Toggle periodic auto-save with interval |
-| `/react <emoji>` | Add emoji reaction to a message |
-| `/macro <action>` | Record/stop/play/list/delete command macros |
+| `/sort [length\|role]` | Show messages sorted by length or grouped by role |
+| `/speak [on\|off]` | Toggle text-to-speech for assistant messages (macOS only) |
+| `/stats` | Show conversation statistics |
+| `/status` | Show all 18 toggleable modes and settings |
+| `/summary` | Generate a local conversation summary |
+| `/system <prompt>` | Set or override system prompt |
 | `/tag <label>` | Tag a message with a label |
 | `/tags [label]` | Show tag statistics or filter by tag |
-| `/repeat` | Re-execute the last slash command |
-| `/count <pattern>` | Count messages matching a pattern |
-| `/template [name]` | List or use prompt templates |
-| `/fav [N]` | Favorite a message (persists to disk) |
-| `/favs` | Show all favorited messages |
-| `/log [N]` | View last N lines of boot log |
+| `/tail [N]` | Peek at last N messages (default 5) |
+| `/tee <path>` | Copy new messages to a file in real-time |
+| `/template [name]` | List or use prompt templates (8 built-in) |
+| `/theme [name]` | Switch color theme (purple/green/blue/amber) |
+| `/time` | Show current date and time |
+| `/timestamps [on\|off]` | Toggle timestamp display on messages |
+| `/tools` | List discovered LEX extensions |
+| `/top` | Scroll to top of message history |
+| `/truncate [N\|off]` | Display-only truncation of long messages |
+| `/undo` | Remove last user+assistant message pair |
+| `/uptime` | Show session elapsed time |
 | `/version` | Show version and platform info |
-| `/focus` | Toggle minimal UI (hide status bar) |
-| `/retry` | Resend last message to LLM |
-| `/merge <session>` | Merge another session into current |
-| `/sort [length\|role]` | Show messages sorted by length or role |
-| `/import <path>` | Import session from a JSON file |
-| `/mute` | Toggle system message display |
-| `/wc` | Show word count statistics |
+| `/wc` | Show word count statistics per role |
+| `/welcome` | Redisplay the welcome message |
+| `/wrap [N\|off]` | Set custom word wrap width |
 
 ## Hotkeys
 
@@ -158,13 +222,13 @@ legion-tty
 
   Screens/
     Onboarding           # First-run wizard (rain -> intro -> wizard -> reveal)
-    Chat                 # AI chat REPL with streaming + 60 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
+    Chat                 # AI chat REPL with streaming + 103 slash commands
+      SessionCommands    # save/load/sessions/delete/rename/import/merge/autosave
+      ExportCommands     # export/bookmark/html/json/markdown/yaml
+      MessageCommands    # compact/copy/diff/search/grep/undo/pin/pins/react/tag/fav/sort/count
+      UiCommands         # help/clear/dashboard/hotkeys/palette/context/stats/debug/history/uptime/time/tips/welcome/focus/wc/log/version/mute + calc/rand/mark/freq/color/timestamps/top/bottom/head/tail/echo/env/speak/silent/wrap/number/truncate/about/commands/ask/define/status/prefs
+      ModelCommands      # model/system/personality switching/retry/chain/info/scroll/summary/prompt/reset/replace/highlight/multiline/filter/annotate/annotations
+      CustomCommands     # alias/snippet/template/macro/draft/revise/tee/pipe/archive/archives/ls/pwd/rand/calc
     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
@@ -213,8 +277,8 @@ Boot logs go to `~/.legionio/logs/tty-boot.log`.
 
 ```bash
 bundle install
-bundle exec rspec       # 1143 examples, 0 failures
-bundle exec rubocop     # 106 files, 0 offenses
+bundle exec rspec       # 1687 examples, 0 failures
+bundle exec rubocop     # 143 files, 0 offenses
 ```
 
 ## License

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

@@ -5,6 +5,8 @@ module Legion
     module Screens
       class Chat < Base
         module MessageCommands
+          INJECT_VALID_ROLES = %w[user assistant system].freeze
+
           private
 
           # rubocop:disable Metrics/AbcSize
@@ -655,6 +657,46 @@ module Legion
             @message_stream.add_message(role: :system, content: "Revised: #{new_content}")
             :handled
           end
+
+          def handle_inject(input)
+            parts = input.split(nil, 3)
+            role_str = parts[1]
+            text = parts[2]
+
+            unless role_str && INJECT_VALID_ROLES.include?(role_str) && text && !text.strip.empty?
+              @message_stream.add_message(
+                role: :system,
+                content: 'Usage: /inject <user|assistant|system> <text>'
+              )
+              return :handled
+            end
+
+            @message_stream.add_message(role: role_str.to_sym, content: text.strip)
+            @status_bar.update(message_count: @message_stream.messages.size)
+            @message_stream.add_message(role: :system, content: "Injected [#{role_str}] message.")
+            :handled
+          end
+
+          def handle_ago(input)
+            n = (input.split(nil, 2)[1] || '1').to_i
+            msgs = @message_stream.messages
+            if n < 1 || n > msgs.size
+              @message_stream.add_message(
+                role: :system,
+                content: "No message #{n} ago (conversation has #{msgs.size} message(s))."
+              )
+              return :handled
+            end
+
+            idx = msgs.size - n
+            msg = msgs[idx]
+            preview = truncate_text(msg[:content].to_s, 200)
+            @message_stream.add_message(
+              role: :system,
+              content: "[#{n} ago | ##{idx} | #{msg[:role]}] #{preview}"
+            )
+            :handled
+          end
         end
       end
     end

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

@@ -393,6 +393,37 @@ module Legion
           end
           # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 
+          def handle_goto(input)
+            n_str = input.split(nil, 2)[1]
+            unless n_str&.match?(/\A\d+\z/)
+              @message_stream.add_message(role: :system, content: 'Usage: /goto <N>')
+              return :handled
+            end
+
+            idx = n_str.to_i
+            return goto_out_of_range(idx) unless goto_in_range?(idx)
+
+            scroll_to_message(idx)
+            @message_stream.add_message(role: :system, content: "Jumped to message #{idx}.")
+            :handled
+          end
+
+          def goto_in_range?(idx)
+            idx >= 0 && idx < @message_stream.messages.size
+          end
+
+          def goto_out_of_range(idx)
+            total = @message_stream.messages.size
+            @message_stream.add_message(role: :system, content: "Message #{idx} out of range (0..#{total - 1}).")
+            :handled
+          end
+
+          def scroll_to_message(idx)
+            total = @message_stream.messages.size
+            @message_stream.scroll_down(@message_stream.scroll_offset)
+            @message_stream.scroll_up([total - idx - 1, 0].max)
+          end
+
           def handle_highlight(input)
             arg = input.split(nil, 2)[1]
             @highlights ||= []
@@ -852,6 +883,67 @@ module Legion
             when 'timestamps'  then handle_timestamps("/timestamps #{value}")
             end
           end
+
+          def handle_stopwatch(input)
+            sub = input.split(nil, 2)[1]&.strip
+            case sub
+            when 'start'  then stopwatch_start
+            when 'stop'   then stopwatch_stop
+            when 'lap'    then stopwatch_lap
+            when 'reset'  then stopwatch_reset
+            else               stopwatch_status
+            end
+            :handled
+          end
+
+          def stopwatch_start
+            @stopwatch_start = Time.now
+            @message_stream.add_message(role: :system, content: 'Stopwatch started.')
+          end
+
+          def stopwatch_stop
+            unless @stopwatch_start
+              @message_stream.add_message(role: :system, content: 'Stopwatch is not running.')
+              return
+            end
+
+            @stopwatch_elapsed += Time.now - @stopwatch_start
+            @stopwatch_start = nil
+            @message_stream.add_message(role: :system,
+                                        content: "Stopwatch stopped. Elapsed: #{format_stopwatch(@stopwatch_elapsed)}")
+          end
+
+          def stopwatch_lap
+            total = @stopwatch_elapsed
+            total += Time.now - @stopwatch_start if @stopwatch_start
+            @message_stream.add_message(role: :system, content: "Lap: #{format_stopwatch(total)}")
+          end
+
+          def stopwatch_reset
+            @stopwatch_start = nil
+            @stopwatch_elapsed = 0
+            @message_stream.add_message(role: :system, content: 'Stopwatch reset.')
+          end
+
+          def stopwatch_status
+            if @stopwatch_start
+              total = @stopwatch_elapsed + (Time.now - @stopwatch_start)
+              @message_stream.add_message(role: :system, content: "Stopwatch running: #{format_stopwatch(total)}")
+            elsif @stopwatch_elapsed.positive?
+              @message_stream.add_message(role: :system,
+                                          content: "Stopwatch stopped at: #{format_stopwatch(@stopwatch_elapsed)}")
+            else
+              @message_stream.add_message(role: :system, content: 'Stopwatch: 00:00.000 (not started)')
+            end
+          end
+
+          def format_stopwatch(seconds)
+            total_ms = (seconds * 1000).to_i
+            ms   = total_ms % 1000
+            secs = (total_ms / 1000) % 60
+            mins = total_ms / 60_000
+            format('%<mins>02d:%<secs>02d.%<ms>03d', mins: mins, secs: secs, ms: ms)
+          end
         end
       end
     end

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

@@ -48,7 +48,9 @@ module Legion
                             /mark /freq
                             /about /commands
                             /ask /define
-                            /status /prefs].freeze
+                            /status /prefs
+                            /stopwatch /ago
+                            /goto /inject].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -93,6 +95,8 @@ module Legion
           @speak_mode = false
           @silent_mode = false
           @draft = nil
+          @stopwatch_start = nil
+          @stopwatch_elapsed = 0
         end
 
         # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
@@ -501,6 +505,10 @@ module Legion
           when '/define' then handle_define(input)
           when '/status' then handle_status
           when '/prefs' then handle_prefs(input)
+          when '/stopwatch' then handle_stopwatch(input)
+          when '/ago' then handle_ago(input)
+          when '/goto' then handle_goto(input)
+          when '/inject' then handle_inject(input)
           else :handled
           end
         end

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.25'
+    VERSION = '0.4.26'
   end
 end

metadata

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