rufio 0.30.0 → 0.32.0

data/docs/CHANGELOG_v0.32.0.md

@@ -0,0 +1,288 @@
+# rufio v0.32.0 - Command Mode Enhancements
+
+**Release Date**: 2026-01-02
+
+## Overview
+
+Version 0.32.0 introduces comprehensive command mode enhancements, including shell command execution, command history, intelligent Tab completion, and the plugin system foundation with a sample Hello plugin. This release focuses on making command mode a powerful interface for daily operations.
+
+## 🎯 Major Features
+
+### 1. Shell Command Execution
+
+Execute shell commands directly from command mode using the `!` prefix.
+
+**Usage:**
+```
+:!ls -la           # List files with details
+:!git status       # Check git status
+:!grep pattern *   # Search for patterns
+```
+
+**Features:**
+- ✅ Safe execution with `Open3.capture3`
+- ✅ Separate stdout and stderr display
+- ✅ Exit code tracking and error handling
+- ✅ Result display in floating window
+
+**Implementation:**
+- `lib/rufio/command_mode.rb`: Added `execute_shell_command` method
+- `lib/rufio/command_mode_ui.rb`: Hash-based result formatting
+
+### 2. Command History
+
+Navigate through previously executed commands using arrow keys.
+
+**Usage:**
+- `↑` (Up Arrow): Previous command
+- `↓` (Down Arrow): Next command
+
+**Features:**
+- ✅ File persistence (`~/.rufio/command_history.txt`)
+- ✅ Duplicate filtering
+- ✅ Configurable history size (default: 1000)
+- ✅ Automatic save on command execution
+
+**Configuration:**
+```ruby
+# ~/.config/rufio/config.rb
+COMMAND_HISTORY_SIZE = 500  # Default: 1000
+```
+
+**Implementation:**
+- `lib/rufio/command_history.rb`: History management class
+- `lib/rufio/config_loader.rb`: Configuration support
+- `lib/rufio/terminal_ui.rb`: Integration with command mode
+
+### 3. Intelligent Tab Completion
+
+Smart Tab completion with multiple behavior modes.
+
+**Behavior:**
+
+1. **Single candidate**: Auto-complete
+   ```
+   Input: !lsbo [Tab]
+   Result: !lsbom
+   ```
+
+2. **Multiple candidates with common prefix**: Complete to common prefix
+   ```
+   Input: !lsap [Tab]
+   Result: !lsappinfo
+   ```
+
+3. **Multiple candidates, no common prefix**: Display candidate list
+   ```
+   Input: !l [Tab]
+   Result: Shows list of 115 commands starting with 'l'
+   ```
+
+**Features:**
+- ✅ Internal command completion
+- ✅ Shell command completion (PATH-based)
+- ✅ File path completion with tilde expansion
+- ✅ History-based completion
+- ✅ Case-insensitive matching
+- ✅ Candidate list display (max 20 items)
+
+**Implementation:**
+- `lib/rufio/command_completion.rb`: Main completion logic
+- `lib/rufio/shell_command_completion.rb`: Shell-specific completion
+- `lib/rufio/terminal_ui.rb`: Tab key handling with candidate display
+
+### 4. Hello Plugin (Ruby Command Example)
+
+Simple example plugin demonstrating how to create custom Ruby commands.
+
+**Usage:**
+```
+:hello             # Execute the hello command
+```
+
+**Output:**
+```
+Hello, World! 🌍
+
+このコマンドはRubyで実装されています。
+```
+
+**Features:**
+- ✅ Automatic plugin loading from `lib/rufio/plugins/`
+- ✅ Tab completion support
+- ✅ Command history integration
+- ✅ Comprehensive test coverage
+
+**Creating Your Own Plugin:**
+```ruby
+# lib/rufio/plugins/my_plugin.rb
+module Rufio
+  module Plugins
+    class MyPlugin < Plugin
+      def name
+        "MyPlugin"
+      end
+
+      def description
+        "Description of my plugin"
+      end
+
+      def commands
+        {
+          mycommand: method(:execute_command)
+        }
+      end
+
+      private
+
+      def execute_command
+        "Command result"
+      end
+    end
+  end
+end
+```
+
+**Implementation:**
+- `lib/rufio/plugins/hello.rb`: Hello plugin
+- `lib/rufio.rb`: Automatic plugin loading via `PluginManager.load_all`
+- `test/test_plugins_hello.rb`: Plugin tests
+
+### 5. Command Mode UI Improvements
+
+Cleaner and more intuitive command mode interface.
+
+**Changes:**
+- ✅ Removed "補完候補:" label (candidates shown only on Tab)
+- ✅ Floating window for candidate display
+- ✅ Better visual feedback for Tab completion
+- ✅ Color-coded windows (blue for input, yellow for candidates, green/red for results)
+
+## 📊 Technical Details
+
+### File Changes
+
+**New Files:**
+- `lib/rufio/command_history.rb` - Command history management
+- `lib/rufio/command_completion.rb` - Command completion logic
+- `lib/rufio/shell_command_completion.rb` - Shell command completion
+- `lib/rufio/plugins/hello.rb` - Hello plugin example
+- `test/test_command_history.rb` - Command history tests
+- `test/test_command_completion.rb` - Completion tests
+- `test/test_shell_command_completion.rb` - Shell completion tests
+- `test/test_plugins_hello.rb` - Hello plugin tests
+
+**Modified Files:**
+- `lib/rufio.rb` - Added plugin loading
+- `lib/rufio/command_mode.rb` - Shell command execution
+- `lib/rufio/command_mode_ui.rb` - UI improvements, Hash result formatting
+- `lib/rufio/terminal_ui.rb` - History and completion integration
+- `lib/rufio/config_loader.rb` - Command history size configuration
+
+### Test Coverage
+
+```
+390 runs, 1663 assertions, 0 failures, 0 errors, 1 skips
+```
+
+All features are fully tested with comprehensive test coverage.
+
+### Performance
+
+- Command history: O(1) access for previous/next
+- Tab completion: O(n) where n = number of PATH commands
+- File path completion: Uses efficient Dir.glob with patterns
+- Shell execution: Non-blocking with Open3.capture3
+
+## 🔧 Configuration
+
+### Command History Size
+
+```ruby
+# ~/.config/rufio/config.rb
+COMMAND_HISTORY_SIZE = 1000  # Default: 1000
+```
+
+### History File Location
+
+```
+~/.rufio/command_history.txt
+```
+
+## 🎓 Usage Examples
+
+### Shell Command Execution
+```
+:!ls               # List files
+:!pwd              # Print working directory
+:!git log --oneline # Git log
+```
+
+### Tab Completion
+```
+:h[Tab]            # Complete to 'hello'
+:!l[Tab]           # Show list of commands starting with 'l'
+:!ls /tm[Tab]      # Complete to '!ls /tmp'
+```
+
+### Command History
+```
+:[↑]               # Previous command
+:[↓]               # Next command
+```
+
+### Ruby Commands
+```
+:hello             # Execute hello plugin
+:copy              # File operations (future)
+:move              # File operations (future)
+```
+
+## 🐛 Bug Fixes
+
+- Fixed Tab completion not working for shell commands
+- Fixed command input display showing candidates unnecessarily
+- Fixed ConfigLoader method access (class method vs instance method)
+
+## 🔄 Migration Guide
+
+No breaking changes. All existing functionality remains compatible.
+
+**New users:**
+- Command history will be automatically created on first command execution
+- No configuration required for basic usage
+
+**Existing users:**
+- Command history feature works automatically
+- Previous command mode behavior preserved
+- New Tab completion enhances existing workflow
+
+## 📝 Known Limitations
+
+- Command arguments not yet supported for internal commands
+- Shell command completion limited to PATH commands
+- History limited to command strings (no metadata)
+
+## 🚀 Future Enhancements
+
+- Command arguments support
+- Command aliases
+- Custom keybindings for command mode
+- Command history search (Ctrl+R style)
+- More built-in plugins
+- Plugin dependency management
+
+## 👏 Credits
+
+Implemented following TDD (Test-Driven Development) methodology:
+1. Write tests first
+2. Run tests to confirm failures
+3. Implement features
+4. Verify all tests pass
+5. Commit
+
+All features developed with comprehensive test coverage and documentation.
+
+---
+
+For the main changelog, see [CHANGELOG.md](../CHANGELOG.md)

data/{CHANGELOG_v0.4.0.md → docs/CHANGELOG_v0.4.0.md}

@@ -126,7 +126,7 @@ This release establishes rufio as a modern, English-focused file manager with:
 
 ---
 
-**Release Date**: 2025-01-13  
+**Release Date**: 2025-09-13  
 **Version**: 0.4.0  
 **Previous Version**: 0.3.0  
 **Compatibility**: Ruby 2.7.0+  
@@ -143,4 +143,4 @@ Please report issues at: https://github.com/masisz/rufio/issues
 
 ---
 
-*This release represents a significant step forward in rufio's evolution, focusing on modern UI patterns, safety, and maintainability while streamlining the user experience.*
+*This release represents a significant step forward in rufio's evolution, focusing on modern UI patterns, safety, and maintainability while streamlining the user experience.*

data/{CHANGELOG_v0.5.0.md → docs/CHANGELOG_v0.5.0.md}

@@ -1,6 +1,7 @@
 # rufio v0.5.0 - Release Notes
 
 ## Added
+
 - **Bookmark System**: Complete bookmark functionality for quick directory navigation
 - **Interactive Bookmark Menu**: Floating dialog accessed via `b` key with Add/List/Remove operations
 - **Quick Navigation**: Number keys (1-9) for instant bookmark jumping
@@ -12,6 +13,7 @@
 - **Error Handling**: Graceful handling of non-existent paths, permission errors, and invalid inputs
 
 ## Changed
+
 - **Help Messages Updated**: Latest keybinding information including bookmark operations in footer
 - **KeybindHandler Enhanced**: Integrated bookmark menu and direct navigation functionality
 - **DirectoryListing Improved**: Added `navigate_to_path` method for bookmark-based navigation
@@ -19,6 +21,7 @@
 - **Documentation Updated**: Comprehensive README updates with bookmark usage examples and workflows
 
 ## Technical Implementation
+
 - New `Bookmark` class with full CRUD operations and JSON persistence
 - Floating window system for bookmark management dialogs
 - Integration with existing terminal UI components and color system

data/{CHANGELOG_v0.7.0.md → docs/CHANGELOG_v0.7.0.md}

@@ -1,6 +1,6 @@
 # CHANGELOG - rufio v0.7.0
 
-**Release Date**: 2024-11-29
+**Release Date**: 2025-11-29
 
 ## 🚀 New Features
 

data/{CHANGELOG_v0.8.0.md → docs/CHANGELOG_v0.8.0.md}

@@ -1,6 +1,6 @@
 # CHANGELOG - rufio v0.8.0
 
-**Release Date**: 2024-12-06
+**Release Date**: 2025-12-06
 
 ## 🚀 New Features
 

data/{CHANGELOG_v0.9.0.md → docs/CHANGELOG_v0.9.0.md}

@@ -1,6 +1,6 @@
 # CHANGELOG - rufio v0.9.0
 
-**Release Date**: 2024-12-13
+**Release Date**: 2025-12-13
 
 ## 🚀 New Features
 

data/lib/rufio/command_completion.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Rufio
+  # コマンド補完機能を提供するクラス
+  class CommandCompletion
+    # 初期化
+    # @param history [CommandHistory, nil] コマンド履歴（オプション）
+    def initialize(history = nil)
+      @command_mode = CommandMode.new
+      @shell_completion = ShellCommandCompletion.new
+      @history = history
+    end
+
+    # コマンドの補完候補を取得
+    # @param input [String] 入力されたテキスト
+    # @return [Array<String>] 補完候補のリスト
+    def complete(input)
+      # 入力が空の場合は内部コマンドを返す
+      if input.nil? || input.strip.empty?
+        return @command_mode.available_commands.map(&:to_s)
+      end
+
+      # シェルコマンド補完（!で始まる場合）
+      if input.strip.start_with?('!')
+        return complete_shell_command(input.strip)
+      end
+
+      # 通常のコマンド補完（内部コマンド）
+      available_commands = @command_mode.available_commands.map(&:to_s)
+      input_lower = input.downcase
+      candidates = available_commands.select do |command|
+        command.downcase.start_with?(input_lower)
+      end
+
+      candidates
+    end
+
+    # 補完候補の共通プレフィックスを取得
+    # @param input [String] 入力されたテキスト
+    # @return [String] 共通プレフィックス
+    def common_prefix(input)
+      candidates = complete(input)
+
+      # 候補がない場合は元の入力を返す
+      return input if candidates.empty?
+
+      # 候補が1つの場合はそのコマンド名を返す
+      return candidates.first if candidates.size == 1
+
+      # 複数の候補がある場合、共通プレフィックスを計算
+      min_candidate = candidates.min
+      max_candidate = candidates.max
+
+      min_candidate.chars.zip(max_candidate.chars).each_with_index do |(char_min, char_max), index|
+        return min_candidate[0...index] if char_min != char_max
+      end
+
+      # すべての文字が一致した場合は最小の候補を返す
+      min_candidate
+    end
+
+    private
+
+    # シェルコマンドの補完
+    # @param input [String] ! で始まる入力
+    # @return [Array<String>] 補完候補のリスト
+    def complete_shell_command(input)
+      # ! を除去
+      command_part = input[1..-1]
+
+      # スペースが含まれる場合、コマンドと引数に分離
+      if command_part.include?(' ')
+        parts = command_part.split(' ', 2)
+        cmd = parts[0]
+        arg = parts[1] || ''
+
+        # 引数部分がパスっぽい場合、ファイルパス補完
+        if arg.include?('/') || arg.start_with?('~')
+          path_candidates = @shell_completion.complete_path(arg)
+          return path_candidates.map { |path| "!#{cmd} #{path}" }
+        else
+          # 引数部分のファイル補完（カレントディレクトリ）
+          path_candidates = @shell_completion.complete_path(arg)
+          return path_candidates.map { |path| "!#{cmd} #{path}" }
+        end
+      else
+        # コマンド名の補完
+        cmd_candidates = @shell_completion.complete_command(command_part)
+
+        # 履歴からの補完も追加
+        if @history
+          history_candidates = @shell_completion.complete_from_history(command_part, @history)
+          cmd_candidates += history_candidates
+        end
+
+        # ! を付けて返す
+        cmd_candidates.uniq.map { |cmd| "!#{cmd}" }
+      end
+    end
+  end
+end

data/lib/rufio/command_history.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Rufio
+  # コマンド履歴管理クラス
+  class CommandHistory
+    DEFAULT_MAX_SIZE = 1000
+
+    attr_reader :size
+
+    # 初期化
+    # @param history_file [String] 履歴ファイルのパス
+    # @param max_size [Integer] 履歴の最大保存数
+    def initialize(history_file, max_size: DEFAULT_MAX_SIZE)
+      @history_file = history_file
+      @max_size = max_size
+      @history = []
+      @position = -1  # -1 = 最新の位置（履歴の外）
+
+      load_from_file if File.exist?(@history_file)
+    end
+
+    # コマンドを履歴に追加
+    # @param command [String] 追加するコマンド
+    def add(command)
+      # 空のコマンドは無視
+      return if command.nil? || command.strip.empty?
+
+      # 連続する重複は無視
+      return if !@history.empty? && @history.last == command
+
+      @history << command
+
+      # 最大サイズを超えたら古いものを削除
+      @history.shift if @history.size > @max_size
+
+      # 位置をリセット
+      reset_position
+    end
+
+    # 前のコマンドを取得（上矢印キー相当）
+    # @return [String, nil] 前のコマンド、存在しない場合はnil
+    def previous
+      return nil if @history.empty?
+
+      # 初回は最後のコマンドを返す
+      if @position == -1
+        @position = @history.size - 1
+        return @history[@position]
+      end
+
+      # これ以上前がない場合
+      return nil if @position <= 0
+
+      # 一つ前に移動
+      @position -= 1
+      @history[@position]
+    end
+
+    # 次のコマンドを取得（下矢印キー相当）
+    # @return [String] 次のコマンド、最新位置の場合は空文字列
+    def next
+      return "" if @history.empty? || @position == -1
+
+      # 一つ次に移動
+      @position += 1
+
+      # 最新位置を超えた場合は空文字列を返す
+      if @position >= @history.size
+        @position = -1
+        return ""
+      end
+
+      @history[@position]
+    end
+
+    # 履歴をファイルに保存
+    def save
+      File.write(@history_file, @history.join("\n") + "\n")
+    end
+
+    # 位置をリセット（新しいコマンド入力時などに使用）
+    def reset_position
+      @position = -1
+    end
+
+    # 履歴のサイズを取得
+    def size
+      @history.size
+    end
+
+    private
+
+    # ファイルから履歴を読み込む
+    def load_from_file
+      return unless File.exist?(@history_file)
+
+      File.readlines(@history_file, chomp: true).each do |line|
+        next if line.strip.empty?
+
+        @history << line
+      end
+
+      # 最大サイズを超えている場合は調整
+      while @history.size > @max_size
+        @history.shift
+      end
+    end
+  end
+end

data/lib/rufio/command_mode.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'open3'
+
 module Rufio
   # コマンドモード - プラグインコマンドを実行するためのインターフェース
   class CommandMode
@@ -13,6 +15,11 @@ module Rufio
       # 空のコマンドは無視
       return nil if command_string.nil? || command_string.strip.empty?
 
+      # シェルコマンドの実行 (! で始まる場合)
+      if command_string.strip.start_with?('!')
+        return execute_shell_command(command_string.strip[1..-1])
+      end
+
       # コマンド名を取得 (前後の空白を削除)
       command_name = command_string.strip.to_sym
 
@@ -48,6 +55,34 @@ module Rufio
 
     private
 
+    # シェルコマンドを実行する
+    def execute_shell_command(shell_command)
+      # コマンドが空の場合
+      return { success: false, error: "コマンドが指定されていません" } if shell_command.strip.empty?
+
+      begin
+        # Open3を使って標準出力と標準エラーを分離して取得
+        stdout, stderr, status = Open3.capture3(shell_command)
+
+        result = {
+          success: status.success?,
+          output: stdout.strip,
+          stderr: stderr.strip
+        }
+
+        # コマンドが失敗した場合、エラーメッセージを追加
+        unless status.success?
+          result[:error] = "コマンドが失敗しました (終了コード: #{status.exitstatus})"
+        end
+
+        result
+      rescue Errno::ENOENT => e
+        { success: false, error: "コマンドが見つかりません: #{e.message}" }
+      rescue StandardError => e
+        { success: false, error: "コマンド実行エラー: #{e.message}" }
+      end
+    end
+
     # プラグインからコマンドを読み込む
     def load_plugin_commands
       # 有効なプラグインを取得

data/lib/rufio/command_mode_ui.rb

@@ -51,16 +51,6 @@ module Rufio
       content_lines = [""]
       content_lines << "#{input}_"  # カーソルを_で表現
       content_lines << ""
-
-      # 補完候補がある場合は表示
-      unless suggestions.empty?
-        content_lines << "補完候補:"
-        suggestions.each do |suggestion|
-          content_lines << "  #{suggestion}"
-        end
-        content_lines << ""
-      end
-
       content_lines << "Tab: 補完 | Enter: 実行 | ESC: キャンセル"
 
       # ウィンドウの色設定（青）
@@ -87,16 +77,23 @@ module Rufio
     end
 
     # コマンド実行結果をフローティングウィンドウで表示
-    # @param result [String, nil] コマンド実行結果
+    # @param result [String, Hash, nil] コマンド実行結果
     def show_result(result)
       # nil または空文字列の場合は何も表示しない
       return if result.nil? || result.empty?
 
-      # 結果を行に分割
-      result_lines = result.split("\n")
+      # Hash形式の結果を処理
+      if result.is_a?(Hash)
+        result_text = format_hash_result(result)
+        is_error = !result[:success]
+      else
+        # 文字列形式の結果（従来の動作）
+        result_text = result
+        is_error = result.include?("⚠️") || result.include?("エラー")
+      end
 
-      # エラーメッセージかどうかを判定
-      is_error = result.include?("⚠️") || result.include?("エラー")
+      # 結果を行に分割
+      result_lines = result_text.split("\n")
 
       # ウィンドウの色設定
       if is_error
@@ -164,5 +161,41 @@ module Rufio
 
       strings.first[0...common_length]
     end
+
+    # Hash形式の結果を文字列に変換
+    # @param result [Hash] コマンド実行結果
+    # @return [String] フォーマットされた結果
+    def format_hash_result(result)
+      lines = []
+
+      # エラーメッセージがある場合
+      if result[:error]
+        lines << result[:error]
+        lines << ""
+      end
+
+      # 標準出力
+      if result[:output] && !result[:output].empty?
+        lines << result[:output]
+      end
+
+      # 標準エラー出力（空でない場合のみ）
+      if result[:stderr] && !result[:stderr].empty?
+        lines << "" if lines.any?
+        lines << "--- stderr ---"
+        lines << result[:stderr]
+      end
+
+      # 何も出力がない場合
+      if lines.empty?
+        if result[:success]
+          lines << "コマンドが正常に実行されました"
+        else
+          lines << "コマンドが失敗しました"
+        end
+      end
+
+      lines.join("\n")
+    end
   end
 end