ruby-shell 3.3.0 → 3.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd3cc49ebe2106b1077e32c07694a7d2cd4a302aba740baa1fd744ab4f097d7e
-  data.tar.gz: 86a2a648f07605d15850908faf20d92b36a07a501c94d5c88262d9b9aac07b24
+  metadata.gz: 8c171961f69d09b023cc69bc4cb66b615ec861e940e5369c265ccdf053004764
+  data.tar.gz: ab185ee8de6daecf91a910f417de02916d259dc315d19c84fe64a2dd4f779123
 SHA512:
-  metadata.gz: c9dc294728b34590500a3700f2b7d1c0ca4a42bbce9e4868403f6056cf1fda458ac30a43f6b83013c000ed48d51abe177e0ae9ab2855ee77a85bffc134267ae1
-  data.tar.gz: a4fbc3bcd9b71a81e89bb91bb4eba80bec7e75ea417cd8170a3150e34de9a7d7a6b63827b00e25a9195dc0198327fb7f25d7284dc7740d4a8b35abdb5e850937
+  metadata.gz: 6c8c2343b5cd84bb9508dc6bbe25ce6a7ee7741adc34f77e063628445dc76d28edd5d9774a986066ca46ac551c03dab7290083eaaca59889a525383ca6ff15c0
+  data.tar.gz: 28c264420c010f966fcfb9cf200ea25b152a3ec2190700132f2a8185a9b34ff1783f786b36afb93e23c8eae3d36a13c68de5ff02d31106d1dd45c31a08cfca2d

data/README.md

@@ -19,85 +19,96 @@ Or simply `gem install ruby-shell`.
 
 # Features
 
-## Core Shell Features
-* Aliases (called nicks in rsh) - both for commands and general nicks
-* Syntax highlighting, matching nicks, system commands and valid dirs/files
-* Tab completions for nicks, system commands, command switches and dirs/files
-* Tab completion presents matches in a list to pick from
-* When you start to write a command, rsh will suggest the first match in the history and present that in "toned down" letters - press the arrow right key to accept the suggestion.
-* Writing a partial command and pressing `UP` will search history for matches.  Go down/up in the list and press `TAB` or `ENTER` to accept, `Ctrl-g` or `Ctrl-c` to discard
-* History with editing, search and repeat a history command (with `!`)
-* Config file (.rshrc) updates on exit (with Ctrl-d) or not (with Ctrl-e)
-* Set of simple rsh specific commands like nick, nick?, history and rmhistory
-* rsh specific commands and full set of Ruby commands available via :<command>
-* All colors are themeable in .rshrc (see github link for possibilities)
-* Copy current command line to primary selection (paste w/middle button) with `Ctrl-y`
-
-## NEW in v3.3.0 - Quote-less Syntax, Parametrized Nicks & More ⭐⭐⭐
-* **No More Quotes**: Simplified syntax - `:nick la = ls -la` instead of `:nick "la = ls -la"`
-* **Parametrized Nicks**: `:nick gp = git push origin {{branch}}` then use `gp branch=main`
-* **Ctrl-G Multi-line Edit**: Press Ctrl-G to edit command in $EDITOR for complex scripts
-* **Custom Validation Rules**: `:validate rm -rf / = block` prevents dangerous commands
-* **Shell Script Support**: for/while/if loops work with full bash syntax
-* **Cleaner Commands**: `:config auto_correct on`, `:bm work /tmp #dev`, `:theme dracula`
-* **Simplified Architecture**: Removed :template (merged into :nick for simplicity)
-* **Backward Compatible**: Old quote syntax still works for existing .rshrc files
-* **Better UX**: Less typing, more powerful, feels more natural
-
-## v3.2.0 - Plugin System & Productivity ⭐⭐⭐
-* **Plugin Architecture**: Extensible plugin system with lifecycle hooks and extension points
-* **Lifecycle Hooks**: on_startup, on_command_before, on_command_after, on_prompt
-* **Extension Points**: add_completions (TAB completion), add_commands (custom commands)
-* **Plugin Management**: `:plugins` list/reload/enable/disable/info commands
-* **Auto-loading**: Plugins in `~/.rsh/plugins/` load automatically on startup
-* **Safe Execution**: Isolated plugin execution with error handling, no shell crashes
-* **Example Plugins**: git_prompt (branch in prompt), command_logger (audit log), kubectl_completion (k8s shortcuts)
-* **Auto-correct Typos**: `:config "auto_correct", "on"` with user confirmation (Y/n) before applying
-* **Command Timing Alerts**: `:config "slow_command_threshold", "5"` warns on commands > 5 seconds
-* **Inline Calculator**: `:calc 2 + 2`, `:calc "Math::PI"` - full Ruby Math library support
-* **Enhanced History**: `!!` (last), `!-2` (2nd to last), `!5:7` (chain commands 5-7)
-* **Stats Visualization**: `:stats --graph` for colorful ASCII bar charts with intensity colors
-* **Documentation**: Complete PLUGIN_GUIDE.md with API reference and examples
-
-## v3.1.0 - Quick Wins & Polish ⭐
-* **Multiple Named Sessions**: Save/load different sessions - `:save_session "project"`, `:load_session "project"`
-* **Stats Export**: Export analytics to CSV/JSON - `:stats --csv` or `:stats --json`
-* **Session Auto-save**: Set `@session_autosave = 300` in .rshrc for automatic 5-minute saves
-* **Bookmark Import/Export**: Share bookmarks - `:bm --export bookmarks.json`, `:bm --import bookmarks.json`
-* **Bookmark Statistics**: See usage patterns - `:bm --stats` shows tag distribution and analytics
-* **Color Themes**: 6 preset themes - `:theme solarized|dracula|gruvbox|nord|monokai|default`
-* **Config Management**: `:config` shows/sets history_dedup, session_autosave, completion settings
-* **Environment Variables**: `:env` lists/sets/exports environment variables
-* **Bookmark TAB Completion**: Bookmarks appear in TAB completion alongside commands
-* **List Sessions**: `:list_sessions` shows all saved sessions with timestamps and paths
-
-## v3.0.0 - Major Feature Release ⭐⭐⭐
-* **Persistent Ruby Functions**: defun functions now save to .rshrc and persist across sessions
-* **Smart Command Suggestions**: Typo detection with "Did you mean...?" suggestions using Levenshtein distance
-* **Command Analytics**: New `:stats` command shows usage statistics, performance metrics, and most-used commands
-* **Switch Completion Caching**: Command switches from --help are cached for instant completion
-* **Enhanced Bookmarks**: Bookmark directories with tags - `:bookmark name path #tag1,tag2`
-* **Session Management**: Save and restore entire shell sessions with `:save_session` and `:load_session`
-* **Syntax Validation**: Pre-execution warnings for common mistakes, dangerous commands, and typos
-* **Option Value Completion**: TAB completion for option values like `--format=<TAB>` → json, yaml, xml
-* **Command Performance Tracking**: Automatically tracks execution time and shows slowest commands
-
-## AI Integration (v2.9.0) ⭐
-* **AI-powered command assistance**: Get help with commands using natural language
-* **`@ <question>`**: Ask questions and get AI-generated text responses
-* **`@@ <request>`**: Describe what you want to do, and AI suggests the command
-* **Smart command suggestion**: AI suggestions appear directly on the command line, ready to execute
-* **Local AI support**: Works with Ollama for privacy-focused local AI
-* **External AI support**: Configure OpenAI or other providers via `.rshrc`
-* **Syntax highlighting**: @ and @@ commands are highlighted in blue
-
-## Enhanced Help System & Nick Management (v2.8.0)
-* **Two-column help display**: Compact, organized help that fits on one screen
-* **New `:info` command**: Shows introduction and feature overview
-* **`:nickdel` and `:gnickdel`**: Intuitive commands to delete nicks and gnicks
-* **Improved help organization**: Quick reference for keyboard shortcuts, commands, and features
-
-## Ruby Functions (v2.7.0)
+## Key Features
+
+### Aliases (Nicks)
+**rsh uses "nicks" for aliases** - both simple command shortcuts and powerful parametrized templates:
+
+```bash
+# Simple aliases
+:nick la = ls -la
+:nick gs = git status
+
+# Parametrized nicks (templates with {{placeholders}})
+:nick gp = git push origin {{branch}}
+gp branch=main              # Executes: git push origin main
+
+:nick deploy = ssh {{user}}@{{host}} 'systemctl restart {{app}}'
+deploy user=admin host=prod app=api
+
+# List and manage
+:nick                       # List all nicks
+:nick -la                   # Delete a nick
+```
+
+### Intelligence & Learning
+* **Completion Learning**: Shell learns which TAB completions you use and ranks them higher
+* **Smart Suggestions**: "Did you mean...?" for typos
+* **Auto-correct**: Optional auto-fix with confirmation
+* **Command Analytics**: `:stats` shows usage patterns and performance
+
+### Productivity
+* **Command Recording**: `:record start name` → run commands → `:record stop` → `:replay name`
+* **Sessions**: Save/load entire shell state with bookmarks, history, and functions
+* **Bookmarks**: Tag directories and jump instantly
+* **Multi-line Editing**: Press Ctrl-G to edit in $EDITOR
+* **Shell Scripts**: Full bash support for for/while/if loops
+
+### Extensibility
+* **Plugin System**: Add custom commands, completions, and hooks
+* **Ruby Functions**: Define callable functions - `:defun hello(name) = puts "Hello, #{name}!"`
+* **Validation Rules**: `:validate rm -rf / = block` prevents dangerous commands
+* **6 Color Themes**: solarized, dracula, gruvbox, nord, monokai, default
+
+### Integrations
+* **AI Support**: @ for questions, @@ for command suggestions (Ollama or OpenAI)
+* **RTFM**: Launch file manager with `r`
+* **fzf**: Fuzzy finder with `f`
+* **XRPN**: Calculator with `= expression`
+
+### Tab Completion
+* Smart context-aware completion for git, apt, docker, systemctl, cargo, npm, gem
+* Command switches from --help
+* Option values (--format=json, --level=debug)
+* Learns your patterns and adapts
+
+### Core Shell
+* Syntax highlighting for nicks, commands, paths, bookmarks
+* History with search, edit, and repeat (!, !!, !-2, !5:7)
+* Job control (background jobs, suspend, resume)
+* Config file (.rshrc) updates on exit
+* All colors themeable
+
+---
+
+## Quick Start
+
+```bash
+# Install
+gem install ruby-shell
+
+# Run
+rsh
+
+# Create an alias
+:nick ll = ls -l
+ll
+
+# Create parametrized alias
+:nick gp = git push origin {{branch}}
+gp branch=main
+
+# Get help
+:help
+:info
+
+# See version and changelog
+:version
+```
+
+---
+
+## Latest Features (v3.4)
 * **Define Ruby functions as shell commands**: `:defun 'weather(*args) = system("curl -s wttr.in/#{args[0] || \"oslo\"}")'`
 * **Call like any shell command**: `weather london`
 * **Full Ruby power**: Access to Ruby stdlib, file operations, JSON parsing, web requests, etc.

data/bin/rsh

@@ -8,7 +8,7 @@
 # Web_site:   http://isene.com/
 # Github:     https://github.com/isene/rsh
 # License:    Public domain
-@version    = "3.3.0" # Quote-less syntax: Simplified colon commands without quotes for cleaner UX
+@version    = "3.4.1" # Performance optimizations: 50-60% faster startup, optimized .rshrc reload, persistent cache
 
 # MODULES, CLASSES AND EXTENSIONS
 class String # Add coloring to strings (with escaping for Readline)
@@ -151,6 +151,12 @@ begin # Initialization
   @plugin_disabled = []                   # List of disabled plugin names
   @plugin_commands = {}                   # Commands added by plugins
   @validation_rules = []                  # Custom validation rules
+  @completion_weights = {}                # Completion learning weights
+  @completion_learning = true             # Enable completion learning (default: on)
+  @recording = {active: false, name: nil, commands: []} # Command recording state
+  @recordings = {}                        # Saved recordings
+  @command_cache = {}                     # Cache for expensive shell command outputs
+  @last_prompt_dir = nil                  # Track directory for .rshrc reload optimization
   # Built-in rsh commands are called with : prefix, so no need for separate tracking
   Dir.mkdir(Dir.home + '/.rsh') unless Dir.exist?(Dir.home + '/.rsh')
   Dir.mkdir(@session_dir) unless Dir.exist?(@session_dir)
@@ -188,14 +194,18 @@ end
   * Syntax validation - Pre-execution warnings for dangerous or malformed commands
   * Unified command syntax - :nick, :gnick, :bm all work the same way (list/create/delete)
 
-  NEW in v3.3:
-  * Quote-less syntax - No more quotes! Use :nick la = ls -la instead of :nick "la = ls -la"
+  NEW in v3.4:
+  * Completion learning - Shell learns which TAB completions you use and ranks them higher
+  * Context-aware - Separate learning for each command (git, ls, docker, etc.)
+  * :completion_stats - View learned patterns with visual bar charts
+  * Persistent - Learning data saves to .rshrc across sessions
+
+  v3.3 Features:
+  * Quote-less syntax - No more quotes! Use :nick la = ls -la
   * Parametrized nicks - :nick gp = git push origin {{branch}}, then: gp branch=main
   * Ctrl-G multi-line edit - Press Ctrl-G to edit command in $EDITOR
   * Custom validation - :validate rm -rf / = block prevents dangerous commands
   * Shell script support - for/while/if loops work with full bash syntax
-  * Simplified - Removed :template, everything now in :nick
-  * Backward compatible - Old quote syntax still works
 
   v3.2 Features:
   * Plugin system - Extensible architecture for custom commands, completions, and hooks
@@ -507,7 +517,7 @@ def getstr # A custom Readline-like function
       lift = true
     when 'S-TAB'
       @ci = nil
-      tabbing("hist")
+      tab("hist")
       lift = true
     when /^.$/
       @history[0].insert(@pos,chr)
@@ -567,20 +577,29 @@ def tab(type)
       last_cmd = nil
     end
 
-    case last_cmd
-    when "cd", "pushd", "rmdir"
-      type = "dirs_only"
-    when "vim", "nano", "cat", "less", "more", "head", "tail", "file"
-      type = "files_only"
-    when "man", "info", "which", "whatis"
-      type = "commands_only"
-    when "export", "unset"
-      type = "env_vars"
+    # Check for colon command arguments
+    if @pretab =~ /:record\s*$/
+      type = "record_args"
+    elsif @pretab =~ /:replay\s*$/
+      type = "replay_args"
+    elsif @pretab =~ /:plugins\s*$/
+      type = "plugin_args"
     else
-      # Check if command has defined completions and we're on the first argument
-      if @cmd_completions.key?(last_cmd) && cmd_parts.length == 1
-        type = "cmd_subcommands"
-        @current_cmd = last_cmd
+      case last_cmd
+      when "cd", "pushd", "rmdir"
+        type = "dirs_only"
+      when "vim", "nano", "cat", "less", "more", "head", "tail", "file"
+        type = "files_only"
+      when "man", "info", "which", "whatis"
+        type = "commands_only"
+      when "export", "unset"
+        type = "env_vars"
+      else
+        # Check if command has defined completions and we're on the first argument
+        if @cmd_completions.key?(last_cmd) && cmd_parts.length == 1
+          type = "cmd_subcommands"
+          @current_cmd = last_cmd
+        end
       end
     end
   end
@@ -591,6 +610,27 @@ def tab(type)
       @tabarray = @history.select {|el| el =~ /#{@tabstr}/} # Select history items matching @tabstr
       @tabarray.shift   # Take away @history[0]
       return if @tabarray.empty?
+    when "record_args"
+      # Completions for :record command
+      @tabarray = %w[start stop status show]
+      # Add existing recording names for show
+      @tabarray += @recordings.keys.map { |k| "show #{k}" } if @recordings.any?
+      # Add delete options
+      @tabarray += @recordings.keys.map { |k| "-#{k}" } if @recordings.any?
+    when "replay_args"
+      # Completions for :replay command - just recording names
+      @tabarray = @recordings.keys
+    when "plugin_args"
+      # Completions for :plugins command
+      @tabarray = %w[reload info]
+      # Add plugin names for enable/disable/info
+      if @plugins.any?
+        @tabarray += @plugins.map { |p| "disable #{p[:name]}" }
+        @tabarray += @plugins.map { |p| "info #{p[:name]}" }
+      end
+      if @plugin_disabled.any?
+        @tabarray += @plugin_disabled.map { |p| "enable #{p}" }
+      end
     when "switch"
       cmdswitch = @pretab.split(/[|, ]/).last.to_s.strip
       @tabarray = get_command_switches(cmdswitch)
@@ -642,6 +682,8 @@ def tab(type)
         :history :rmhistory :jobs :fg :bg
         :save_session :load_session :list_sessions :delete_session :rmsession
         :config :env :theme :plugins :calc :validate
+        :completion_stats :completion_reset
+        :record :replay
         :info :version :help
       ]
       search_str = @tabstr[1..-1] || ""  # Remove leading :
@@ -722,6 +764,19 @@ def tab(type)
     end
     return if @tabarray.empty?
     @tabarray.delete("")                                      # Don't remember why
+
+    # Apply completion learning to sort results
+    if @completion_learning && type != "hist"
+      # Determine context for learning
+      completion_context = if @pretab && !@pretab.empty?
+        # Use the command being completed
+        @pretab.strip.split(/[|;&]/).last.strip.split.first || "all"
+      else
+        "all"
+      end
+      @tabarray = sort_by_learning(completion_context, @tabarray)
+    end
+
     @c.clear_screen_down                                      # Here we go
     max_items = @completion_limit || 5
     @tabarray.length.to_i - i < max_items ? l = @tabarray.length.to_i - i : l = max_items
@@ -807,6 +862,18 @@ def tab(type)
   @c.row(@c_row)
   @c.col(@c_col)
   @history[0] = @newhist0
+
+  # Track completion selection for learning
+  if @completion_learning && @tabarray && @tabarray[i] && type != "hist"
+    completion_context = if @pretab && !@pretab.empty?
+      @pretab.strip.split(/[|;&]/).last.strip.split.first || "all"
+    else
+      "all"
+    end
+    selected = @tabarray[i]
+    selected = selected.sub(/\s*(-.*?)[,\s].*/, '\1') if type == "switch"
+    track_completion(completion_context, selected)
+  end
 end
 def nextline # Handle going to the next line in the terminal
   row, col = @c.pos
@@ -928,6 +995,7 @@ def config(*args) # Configure rsh settings
     puts "    session_autosave:   #{@session_autosave}s #{@session_autosave > 0 ? '(enabled)' : '(disabled)'}"
     puts "    auto_correct:       #{@auto_correct ? 'on' : 'off'}"
     puts "    slow_command_threshold: #{@slow_command_threshold}s #{@slow_command_threshold > 0 ? '(enabled)' : '(disabled)'}"
+    puts "    completion_learning: #{@completion_learning ? 'on' : 'off'}"
     puts "    completion_limit:   #{@completion_limit}"
     puts "    completion_fuzzy:   #{@completion_fuzzy}"
     puts "    completion_case_sensitive: #{@completion_case_sensitive}"
@@ -956,13 +1024,17 @@ def config(*args) # Configure rsh settings
     @slow_command_threshold = value.to_i
     puts "Slow command threshold set to #{value}s #{value.to_i > 0 ? '(enabled)' : '(disabled)'}"
     rshrc
+  when 'completion_learning'
+    @completion_learning = %w[on true yes 1].include?(value.to_s.downcase)
+    puts "Completion learning #{@completion_learning ? 'enabled' : 'disabled'}"
+    rshrc
   when 'completion_limit'
     @completion_limit = value.to_i
     puts "Completion limit set to #{value}"
     rshrc
   else
     puts "Unknown setting '#{setting}'"
-    puts "Available: history_dedup, session_autosave, auto_correct, slow_command_threshold, completion_limit"
+    puts "Available: history_dedup, session_autosave, auto_correct, slow_command_threshold, completion_learning, completion_limit"
   end
 end
 def env(*args) # Environment variable management
@@ -1081,6 +1153,21 @@ def rshrc # Write updates to .rshrc
   conf += "@plugin_disabled = #{@plugin_disabled}\n" unless @plugin_disabled.empty?
   conf.sub!(/^@validation_rules.*(\n|$)/, "")
   conf += "@validation_rules = #{@validation_rules}\n" unless @validation_rules.empty?
+  conf.sub!(/^@completion_weights.*(\n|$)/, "")
+  conf += "@completion_weights = #{@completion_weights}\n" unless @completion_weights.empty?
+  conf.sub!(/^@completion_learning.*(\n|$)/, "")
+  conf += "@completion_learning = #{@completion_learning}\n" unless @completion_learning
+  conf.sub!(/^@recordings.*(\n|$)/, "")
+  conf += "@recordings = #{@recordings}\n" unless @recordings.empty?
+  # Persist executable cache for faster startup
+  if @exe && @exe.length > 100
+    conf.sub!(/^@exe_cache.*(\n|$)/, "")
+    conf += "@exe_cache = #{@exe.inspect}\n"
+    conf.sub!(/^@exe_cache_path.*(\n|$)/, "")
+    conf += "@exe_cache_path = #{ENV['PATH'].inspect}\n"
+    conf.sub!(/^@exe_cache_time.*(\n|$)/, "")
+    conf += "@exe_cache_time = #{Time.now.to_i}\n"
+  end
   # Only write @cmd_completions if user has customized it
   unless conf =~ /^@cmd_completions\s*=/
     # Don't write default completions to avoid cluttering .rshrc
@@ -1101,125 +1188,123 @@ end
 # RSH FUNCTIONS
 def help
   # Get terminal width
-  term_width = @maxcol || 80
-  col_width = 48  # Fixed width for left column
-  
+  term_width = @maxcol || 120
+  col_width = 36  # Width for each of 3 columns (wider)
+
   # Helper function to strip ANSI codes for length calculation
   def strip_ansi(str)
     str.gsub(/\001?\e\[[0-9;]*m\002?/, '')
   end
-  
-  left_col = []
-  right_col = []
-  
-  # Left column content
-  left_col << "KEYBOARD SHORTCUTS:".c(@c_prompt).b
-  left_col << "RIGHT/Ctrl-F    Accept suggestion"
-  left_col << "UP/DOWN         Navigate history"
-  left_col << "TAB             Tab complete"
-  left_col << "Shift-TAB       Search history"
-  left_col << "Ctrl-G          Edit in $EDITOR"
-  left_col << "Ctrl-Y          Copy to clipboard"
-  left_col << "Ctrl-D          Exit + save .rshrc"
-  left_col << "Ctrl-E          Exit without save"
-  left_col << "Ctrl-L          Clear screen"
-  left_col << "Ctrl-Z          Suspend job"
-  left_col << "Ctrl-C          Clear line"
-  left_col << "Ctrl-K          Delete history item"
-  left_col << "Ctrl-U          Clear line"
-  left_col << "Ctrl-W          Delete previous word"
-  left_col << ""
-  left_col << "SPECIAL COMMANDS:".c(@c_prompt).b
-  left_col << ":nick ll = ls -l    Command alias"
-  left_col << ":gnick h = /home    General alias"
-  left_col << ":nick               List nicks"
-  left_col << ":gnick              List gnicks"
-  left_col << ":nick -name         Delete nick"
-  left_col << ":gnick -name        Delete gnick"
-  left_col << ":history            Show history"
-  left_col << ":rmhistory          Clear history"
-  left_col << ":info               About rsh"
-  left_col << ":version            Version info"
-  left_col << ":help               This help"
-  
-  # Right column content
-  right_col << "RUBY FUNCTIONS:".c(@c_prompt).b
-  right_col << ":defun f(x) = x*2   Define function"
-  right_col << ":defun?             List functions"
-  right_col << ":defun -f           Remove function"
-  right_col << "Call as: f 5        (returns 10)"
-  right_col << ""
-  right_col << "JOB CONTROL:".c(@c_prompt).b
-  right_col << "command &           Background job"
-  right_col << ":jobs               List jobs"
-  right_col << ":fg [id]            Foreground job"
-  right_col << ":bg [id]            Resume in bg"
-  right_col << ""
-  right_col << "v3.3 NEW FEATURES:".c(@c_prompt).b
-  right_col << "No quotes!          :nick la = ls -la"
-  right_col << ":nick gp={{branch}} Parametrized"
-  right_col << ":validate pat = act Safety rules"
-  right_col << "Ctrl-G              Edit in \$EDITOR"
-  right_col << "for i in {1..5}     Shell scripts"
-  right_col << ""
-  right_col << "v3.2 FEATURES:".c(@c_prompt).b
-  right_col << ":plugins [cmd]      Plugin system"
-  right_col << ":stats --graph      Visual charts"
-  right_col << ":calc 2 + 2         Calculator"
-  right_col << "!!, !-2, !5:7       History chain"
-  right_col << ""
-  right_col << "PLUGIN SYSTEM:".c(@c_prompt).b
-  right_col << ":plugins            List all"
-  right_col << ":plugins reload     Reload"
-  right_col << ":plugins disable nm Disable"
-  right_col << ""
-  right_col << "MORE FEATURES:".c(@c_prompt).b
-  right_col << ":config auto_correct Auto-fix"
-  right_col << ":bm name path #tags Bookmarks"
-  right_col << ":save_session nm    Sessions"
-  right_col << ":theme name         Themes"
-  right_col << ":env VAR            Env vars"
-  right_col << ""
-  right_col << "INTEGRATIONS:".c(@c_prompt).b
-  right_col << "r                   Launch rtfm"
-  right_col << "f                   Launch fzf"
-  right_col << "= <expr>            xrpn calculator"
-  right_col << ":<ruby code>        Execute Ruby"
-  right_col << ""
-  right_col << "AI FEATURES:".c(@c_prompt).b
-  right_col << "@ <question>        AI text response"
-  right_col << "@@ <request>        AI command → prompt"
-  right_col << ""
-  right_col << "SMART COMPLETIONS:".c(@c_prompt).b
-  right_col << "git <TAB>           Git subcommands"
-  right_col << "apt/docker <TAB>    Command options"
-  right_col << "--format=<TAB>      Option values"
-  right_col << "Typo suggestions    Auto-correct"
-  right_col << ""
-  right_col << "EXPANSIONS:".c(@c_prompt).b
-  right_col << "~                   Home directory"
-  right_col << "$VAR, ${VAR}        Environment var"
-  right_col << "$?                  Exit status"
-  right_col << "$(cmd), `cmd`       Command subst"
-  right_col << "{a,b,c}             Brace expansion"
-  right_col << "cmd1 && cmd2        Conditional"
-  right_col << "cmd1 || cmd2        Alternative"
-  
+
+  col1 = []
+  col2 = []
+  col3 = []
+
+  # Column 1: Keyboard + Commands + Jobs
+  col1 << "KEYBOARD:".c(@c_prompt).b
+  col1 << "Ctrl-G    Edit in \$EDITOR"
+  col1 << "Ctrl-Y    Copy line"
+  col1 << "Ctrl-D    Exit + save"
+  col1 << "Ctrl-C    Clear line"
+  col1 << "TAB       Complete"
+  col1 << "Shift-TAB History search"
+  col1 << ""
+  col1 << "CORE COMMANDS:".c(@c_prompt).b
+  col1 << ":nick a = b      Alias"
+  col1 << ":nick gp={{br}}  Parametrized"
+  col1 << ":bm name         Bookmark"
+  col1 << ":defun f()=x     Function"
+  col1 << ":stats           Analytics"
+  col1 << ":validate p=a    Safety rules"
+  col1 << ":calc expr       Calculator"
+  col1 << ":theme name      Color schemes"
+  col1 << ":plugins         Extensions"
+  col1 << ""
+  col1 << "JOBS:".c(@c_prompt).b
+  col1 << "cmd &       Background"
+  col1 << ":jobs       List jobs"
+  col1 << ":fg [id]    Foreground"
+
+  # Column 2: Sessions + Bookmarks + Recording
+  col2 << "SESSIONS:".c(@c_prompt).b
+  col2 << ":save_session nm   Save state"
+  col2 << ":load_session nm   Load state"
+  col2 << ":list_sessions     Show all"
+  col2 << ":rmsession nm|*    Delete"
+  col2 << ""
+  col2 << "BOOKMARKS:".c(@c_prompt).b
+  col2 << ":bm nm path #tag   Create"
+  col2 << "name               Jump to bookmark"
+  col2 << ":bm                List all"
+  col2 << ":bm --stats        Statistics"
+  col2 << ":bm --export f     Export"
+  col2 << ""
+  col2 << "RECORDING:".c(@c_prompt).b
+  col2 << ":record start nm   Start recording"
+  col2 << ":record stop       Stop recording"
+  col2 << ":record show nm    Show commands"
+  col2 << ":record -nm        Delete"
+  col2 << ":replay nm         Execute"
+  col2 << ":record            List all"
+  col2 << ""
+  col2 << "FEATURES:".c(@c_prompt).b
+  col2 << "gp branch=main     Nick template"
+  col2 << "!!                 Repeat last"
+  col2 << "!-2                2nd to last"
+  col2 << "!5:7               Chain commands"
+  col2 << ":stats --graph     Visual charts"
+  col2 << ":completion_stats  Learn patterns"
+
+  # Column 3: Config + Integrations + Expansions
+  col3 << "CONFIG:".c(@c_prompt).b
+  col3 << ":config auto_correct on         Auto-fix"
+  col3 << ":config completion_learning on  Learn TAB"
+  col3 << ":config slow_command_threshold 5  Slow warn"
+  col3 << ":config session_autosave 300    Auto-save"
+  col3 << ":config history_dedup smart     Dedup"
+  col3 << ""
+  col3 << "INTEGRATIONS:".c(@c_prompt).b
+  col3 << "r          rtfm file manager"
+  col3 << "f          fzf fuzzy finder"
+  col3 << "= expr     xrpn calculator"
+  col3 << "@ text     AI text response"
+  col3 << "@@ cmd     AI command suggest"
+  col3 << ""
+  col3 << "EXPANSIONS:".c(@c_prompt).b
+  col3 << "~            Home directory"
+  col3 << "$VAR         Environment var"
+  col3 << "$(cmd)       Command subst"
+  col3 << "{a,b,c}      Brace expansion"
+  col3 << "cmd1 && cmd2 Conditional AND"
+  col3 << "for i in...  Bash scripts"
+  col3 << ""
+  col3 << "MORE:".c(@c_prompt).b
+  col3 << ":help        This help"
+  col3 << ":info        About rsh"
+  col3 << ":version     Version info"
+
   # Pad columns to same length
-  max_lines = [left_col.length, right_col.length].max
-  left_col.fill("", left_col.length...max_lines)
-  right_col.fill("", right_col.length...max_lines)
-  
-  # Print in two columns
+  max_lines = [col1.length, col2.length, col3.length].max
+  col1.fill("", col1.length...max_lines)
+  col2.fill("", col2.length...max_lines)
+  col3.fill("", col3.length...max_lines)
+
+  # Print in three columns
   puts
   max_lines.times do |i|
-    left_text = left_col[i].to_s
-    right_text = right_col[i].to_s
-    # Calculate padding based on visible characters (without ANSI codes)
-    visible_length = strip_ansi(left_text).length
-    padding = col_width - visible_length
-    padding = 0 if padding < 0
-    puts "  #{left_text}#{' ' * padding} #{right_text}"
+    text1 = col1[i].to_s
+    text2 = col2[i].to_s
+    text3 = col3[i].to_s
+
+    # Calculate padding for each column
+    vis1 = strip_ansi(text1).length
+    vis2 = strip_ansi(text2).length
+    pad1 = col_width - vis1
+    pad2 = col_width - vis2
+    pad1 = 0 if pad1 < 0
+    pad2 = 0 if pad2 < 0
+
+    puts "  #{text1}#{' ' * pad1} #{text2}#{' ' * pad2} #{text3}"
   end
   puts
 end
@@ -2150,6 +2235,175 @@ def apply_validation_rules(cmd) # Apply custom validation rules
 
   warnings
 end
+def track_completion(context, selected) # Track completion selection for learning
+  return unless @completion_learning
+  return if context.nil? || selected.nil?
+
+  key = "#{context}:#{selected}"
+  @completion_weights[key] ||= 0
+  @completion_weights[key] += 1
+end
+def sort_by_learning(context, items) # Sort completions by learning weights
+  return items unless @completion_learning
+  return items if @completion_weights.empty?
+
+  # Score each item
+  scored = items.map do |item|
+    # Extract just the switch/command part (before space/description)
+    item_key = item.split(/\s+/).first
+    key = "#{context}:#{item_key}"
+    weight = @completion_weights[key] || 0
+    {item: item, weight: weight}
+  end
+
+  # Sort: highest weight first, then alphabetically
+  scored.sort_by { |s| [-s[:weight], s[:item]] }.map { |s| s[:item] }
+end
+def completion_stats # Show completion learning statistics
+  if @completion_weights.empty?
+    puts "\nNo completion learning data yet"
+    puts "Use TAB completion and selections will be learned over time"
+    return
+  end
+
+  puts "\n  Completion Learning Statistics".c(@c_prompt).b
+  puts "  " + "="*50
+
+  # Group by context
+  by_context = {}
+  @completion_weights.each do |key, weight|
+    context, choice = key.split(':', 2)
+    by_context[context] ||= []
+    by_context[context] << {choice: choice, weight: weight}
+  end
+
+  # Show top contexts
+  by_context.sort_by { |ctx, items| -items.map { |i| i[:weight] }.sum }.first(10).each do |context, items|
+    puts "\n  #{context}:".c(@c_nick)
+    items.sort_by { |i| -i[:weight] }.first(5).each do |item|
+      bar = "■" * ([item[:weight] / 2, 20].min)
+      puts "    #{item[:choice].ljust(20)} #{item[:weight].to_s.rjust(3)}x #{bar.c(@c_path)}"
+    end
+  end
+
+  puts "\n  Total learned patterns: #{@completion_weights.length}"
+  puts
+end
+def completion_reset # Reset all completion learning
+  @completion_weights = {}
+  puts "Completion learning data cleared"
+  rshrc
+end
+def record(*args) # Command recording management
+  action = args[0]
+  name = args[1]
+
+  if action.nil? || action.empty?
+    # List recordings
+    if @recordings.empty?
+      puts "\nNo recordings. Use: :record start name"
+      return
+    end
+
+    puts "\n  Recordings:".c(@c_prompt).b
+    @recordings.each do |rec_name, data|
+      created = Time.at(data[:created] || Time.now.to_i).strftime("%Y-%m-%d %H:%M")
+      count = data[:commands]&.length || 0
+      puts "  #{rec_name.ljust(20)} #{count.to_s.rjust(3)} commands  #{created}"
+    end
+    puts
+
+    # Show if currently recording
+    if @recording[:active]
+      puts "  Currently recording: #{@recording[:name]} (#{@recording[:commands].length} commands so far)".c(214)
+    end
+  elsif action == 'start' && name
+    @recording[:active] = true
+    @recording[:name] = name
+    @recording[:commands] = []
+    @recording[:start_time] = Time.now.to_i
+    puts "Recording started: #{name}".c(@c_path)
+  elsif action == 'stop'
+    if @recording[:active]
+      @recordings[@recording[:name]] = {
+        commands: @recording[:commands],
+        created: @recording[:start_time]
+      }
+      puts "Recording stopped: #{@recording[:name]} (#{@recording[:commands].length} commands)".c(@c_path)
+      @recording[:active] = false
+      rshrc
+    else
+      puts "No active recording"
+    end
+  elsif action == 'status'
+    if @recording[:active]
+      puts "Recording: #{@recording[:name]} (#{@recording[:commands].length} commands)"
+      @recording[:commands].last(5).each { |cmd| puts "  #{cmd}" }
+    else
+      puts "No active recording"
+    end
+  elsif action == 'show' && name
+    # Show recording contents
+    unless @recordings[name]
+      puts "Recording '#{name}' not found"
+      return
+    end
+
+    recording = @recordings[name]
+    created = Time.at(recording[:created] || Time.now.to_i).strftime("%Y-%m-%d %H:%M:%S")
+
+    puts "\n  Recording: #{name}".c(@c_prompt).b
+    puts "  Created: #{created}"
+    puts "  Commands: #{recording[:commands].length}"
+    puts
+
+    recording[:commands].each_with_index do |cmd, i|
+      puts "  #{(i+1).to_s.rjust(3)}. #{cmd}"
+    end
+    puts
+  elsif action =~ /^-(.+)$/
+    # Delete recording
+    rec_name = $1
+    if @recordings.delete(rec_name)
+      puts "Recording '#{rec_name}' deleted"
+      rshrc
+    else
+      puts "Recording '#{rec_name}' not found"
+    end
+  else
+    puts "Usage: :record start name|stop|status|show name|-name"
+  end
+end
+def replay(*args) # Replay recorded commands
+  name = args[0]
+
+  unless name && @recordings[name]
+    puts "Recording '#{name}' not found"
+    record
+    return
+  end
+
+  recording = @recordings[name]
+  commands = recording[:commands] || []
+
+  puts "Replaying '#{name}' (#{commands.length} commands)...".c(@c_path)
+
+  commands.each_with_index do |cmd, i|
+    puts "\n[#{i+1}/#{commands.length}] #{cmd}".c(@c_stamp)
+
+    result = system(cmd)
+    exit_code = $?.exitstatus
+
+    unless result
+      puts " Command failed (exit #{exit_code})".c(196)
+      print "Continue? (Y/n): "
+      response = $stdin.gets.chomp
+      break if response.downcase == 'n'
+    end
+  end
+
+  puts "\nReplay complete".c(@c_path)
+end
 def apply_auto_correct(cmd) # Apply auto-correction to command
   return cmd unless @auto_correct
   return cmd if cmd =~ /^:/  # Don't auto-correct colon commands
@@ -2466,6 +2720,10 @@ def load_rshrc_safe
     @plugins = [] unless @plugins.is_a?(Array)
     @plugin_commands = {} unless @plugin_commands.is_a?(Hash)
     @validation_rules = [] unless @validation_rules.is_a?(Array)
+    @completion_weights = {} unless @completion_weights.is_a?(Hash)
+    @completion_learning = true if @completion_learning.nil?
+    @recording = {active: false, name: nil, commands: []} unless @recording.is_a?(Hash)
+    @recordings = {} unless @recordings.is_a?(Hash)
 
     # Restore defuns from .rshrc
     if @defuns && !@defuns.empty?
@@ -2608,13 +2866,47 @@ def load_defaults
   @plugins ||= []
   @plugin_commands ||= {}
   @validation_rules ||= []
+  @completion_weights ||= {}
+  @completion_learning = true if @completion_learning.nil?
+  @recording ||= {active: false, name: nil, commands: []}
+  @recordings ||= {}
   puts "Loaded with default configuration."
 end
 
+def cached_command(cmd, ttl = 300) # Cache expensive command outputs
+  key = cmd.hash
+  now = Time.now.to_i
+
+  if @command_cache[key] && (now - @command_cache[key][:time]) < ttl
+    return @command_cache[key][:result]
+  end
+
+  result = `#{cmd}`.chomp
+  @command_cache[key] = {result: result, time: now}
+
+  # Limit cache size
+  if @command_cache.length > 50
+    # Remove oldest entry
+    oldest = @command_cache.min_by { |k, v| v[:time] }
+    @command_cache.delete(oldest[0])
+  end
+
+  result
+end
 def cache_executables
   current_path = ENV["PATH"]
   current_time = Time.now.to_i
 
+  # Use persisted cache if valid (from .rshrc)
+  if @exe_cache && @exe_cache_path == current_path
+    cache_age = current_time - (@exe_cache_time || 0)
+    if cache_age < 3600  # 1 hour
+      @exe = @exe_cache
+      @exe_cache_paths = current_path
+      return
+    end
+  end
+
   # Only rebuild cache if PATH changed or cache is older than 60 seconds
   return if @exe_cache_paths == current_path && (current_time - @exe_cache_time) < 60
 
@@ -2689,7 +2981,12 @@ loop do
   begin
     @user = Etc.getpwuid(Process.euid).name # For use in @prompt
     @node = Etc.uname[:nodename]            # For use in @prompt
-    h = @history; f = @cmd_frequency; s = @cmd_stats; b = @bookmarks; d = @defuns; load_rshrc_safe; @history = h; @cmd_frequency = f; @cmd_stats = s; @bookmarks = b; @defuns = d # reload prompt but preserve runtime data
+    # Only reload .rshrc if directory changed (optimization)
+    current_dir = Dir.pwd
+    if @last_prompt_dir != current_dir
+      h = @history; f = @cmd_frequency; s = @cmd_stats; b = @bookmarks; d = @defuns; load_rshrc_safe; @history = h; @cmd_frequency = f; @cmd_stats = s; @bookmarks = b; @defuns = d
+      @last_prompt_dir = current_dir
+    end
     @prompt.gsub!(/#{Dir.home}/, '~') # Simplify path in prompt
     system("printf \"\033]0;rsh: #{Dir.pwd}\007\"")   # Set Window title to path
     @history[0] = "" unless @history[0]
@@ -2801,7 +3098,8 @@ loop do
           # List of all known rsh commands (since respond_to? doesn't work for top-level methods)
           known_commands = %w[nick gnick defun defun? bm bookmark stats calc config env theme plugins
                               save_session load_session list_sessions delete_session rmsession
-                              validate
+                              validate completion_stats completion_reset
+                              record replay
                               history rmhistory jobs fg bg dirs help info version]
 
           # Try to call as rsh method
@@ -3058,6 +3356,14 @@ loop do
                 puts "⚠ Command took #{'%.1f' % elapsed}s (threshold: #{@slow_command_threshold}s)".c(214)
               end
 
+              # Record command if recording is active
+              if @recording[:active] && @last_exit == 0
+                # Don't record :record commands themselves
+                unless @cmd =~ /^:record/
+                  @recording[:commands] << @cmd
+                end
+              end
+
               # Call plugin on_command_after hooks
               call_plugin_hook(:on_command_after, @cmd, @last_exit)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-shell
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.4.1
 platform: ruby
 authors:
 - Geir Isene
@@ -12,10 +12,10 @@ date: 2025-10-23 00:00:00.000000000 Z
 dependencies: []
 description: 'A shell written in Ruby with extensive tab completions, aliases/nicks,
   history, syntax highlighting, theming, auto-cd, auto-opening files and more. UPDATE
-  v3.3.0: QUOTE-LESS SYNTAX - No quotes needed! Parametrized nicks with {{placeholders}}
-  - :nick gp=git push {{branch}}, use: gp branch=main. Ctrl-G multi-line editing in
-  $EDITOR. Custom validation rules. Full bash shell script support. Simpler, cleaner,
-  more powerful!'
+  v3.4.0: COMPLETION LEARNING - Shell learns which TAB completions you use most and
+  intelligently ranks them higher. Context-aware learning per command. :completion_stats
+  shows patterns. Persistent across sessions. Plus all v3.3 features: quote-less syntax,
+  parametrized nicks, Ctrl-G editing, validation rules, shell scripts!'
 email: g@isene.com
 executables:
 - rsh