rufio 0.30.0 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f639904d46c7c6cff1424a06e22df2ec476aab1e575a442a47a329af208c555
-  data.tar.gz: 4f682afe7f35715ae18b4fcdc08efef03d00677c621d0422567a23d897b6b30b
+  metadata.gz: aff3f0a1c50ec0a854769b6cd89a559872db6edd9618fe000e80a89160018887
+  data.tar.gz: 244a77b3555472fccecfe13638ae53f72bc971f6cbc3649ded6bd09a127b4004
 SHA512:
-  metadata.gz: 8f6ee453b1868123c11d987244735ce092088f7b720dc6f445e21aed0b191e25b47501ff003720647dc17343accdefd88a72b0dfaf69ca644a160e693ec1a1cf
-  data.tar.gz: d1ddf57189b941111a314f11c5b6dbcddbda54d96e6fef4eccb8b7a7fec27a9903ca6b29d66e62181a2d98fe5009026ca2609620cef370eba680851cb710ec31
+  metadata.gz: 59dbee8f1030310696f3f113c85ebc9f6ed236e7ce24ca0fc834a174f3614b2f609dc7c5471efd905d113b8d61d490779da8222c7984c3827c095d1ff0c14d67
+  data.tar.gz: a75e8048e9b6ddaf81d32d7fc772a6231462a9e81e221147329c8726ef59d65e63ecd115397f80dbd8274ced4b3a5b14d3d3d2a5c3cd247b36d8d1275518595c

data/CHANGELOG.md

@@ -7,7 +7,86 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.10.0] - 2025-01-XX
+## [0.32.0] - 2026-01-02
+
+### Added
+- **🎯 Shell Command Execution**: Execute shell commands with `!` prefix (e.g., `:!ls`, `:!git status`)
+- **📜 Command History**: Navigate command history with arrow keys, persistent storage
+- **⌨️ Intelligent Tab Completion**: Smart completion with candidate list display
+- **🔌 Hello Plugin**: Example Ruby plugin demonstrating command implementation
+- **⚙️ Command History Configuration**: Configurable history size (default: 1000)
+
+### Changed
+- Command mode UI improvements: cleaner interface, better visual feedback
+- Tab completion now shows candidate list when multiple matches exist
+- Plugin system now auto-loads from `lib/rufio/plugins/`
+
+### Fixed
+- Tab completion not working for shell commands
+- Command input display showing candidates unnecessarily
+
+For detailed information, see [CHANGELOG_v0.32.0.md](./docs/CHANGELOG_v0.32.0.md)
+
+## [0.31.0] - 2026-01-01
+
+### Added
+- **🚀 Experimental Native Scanner**: High-performance directory scanning with Rust/Go implementations
+- **Rust implementation** (`lib_rust/scanner/`): Fastest, memory-safe implementation
+- **Go implementation** (`lib_go/scanner/`): Fast with excellent concurrency
+- **NativeScanner abstraction layer**: Unified interface with automatic fallback to Ruby
+- **Launch options**: `--native`, `--native=rust`, `--native=go` for performance optimization
+- **Environment variable**: `RUFIO_NATIVE` for configuration
+
+### Changed
+- Default scanner remains Ruby implementation for stability
+- Auto-detection priority: Rust > Go > Ruby
+
+For detailed information, see [CHANGELOG_v0.31.0.md](./docs/CHANGELOG_v0.31.0.md)
+
+## [0.30.0] - 2025-12-30
+
+### Added
+- **📚 Help System Overhaul**: Full-screen help mode with Markdown documentation
+- **Preview Pane Scrolling**: `Enter` on files focuses preview pane, `j/k` for scrolling
+- **Help documentation**: `info/welcome.md`, `info/help.md`, `info/keybindings.md`
+- **Enhanced file preview**: `.docx`, `.xlsx`, `.pptx` preview support via `pandoc`
+
+### Changed
+- All help documentation converted to English and Markdown format
+- Help mode uses full file manager UI for browsing
+- Preview pane shows `[PREVIEW MODE]` indicator when focused
+
+For detailed information, see [CHANGELOG_v0.30.0.md](./docs/CHANGELOG_v0.30.0.md)
+
+## [0.21.0] - 2025-12-29
+
+### Added
+- **📋 Copy Feature**: `c` key to copy selected files with floating dialog UI
+- **Cross-directory selection**: Select files in one directory and copy/move to another
+- **Multiple selection delete**: Enhanced `x` key for deleting multiple files
+- **Code refactoring**: Extracted dialog confirmation logic to shared methods
+
+### Changed
+- Improved SelectionManager with source directory tracking
+- Unified confirmation dialog UI across copy/move/delete operations
+
+For detailed information, see [CHANGELOG_v0.21.0.md](./docs/CHANGELOG_v0.21.0.md)
+
+## [0.20.0] - 2025-12-28
+
+### Added
+- **🎯 Project Mode UI Unification**: Consistent UI between normal and project modes
+- **Script directory support**: Execute custom Ruby scripts from `~/.config/rufio/scripts`
+- **Bookmark rename feature**: `r` key in project mode to rename bookmarks
+- **Enhanced command mode**: `:` command with script execution
+
+### Changed
+- Project mode shows bookmark list with consistent UI
+- Improved bookmark management with rename capability
+
+For detailed information, see [CHANGELOG_v0.20.0.md](./docs/CHANGELOG_v0.20.0.md)
+
+## [0.10.0] - 2025-12-21
 
 ### 🎨 Enhanced - Bookmark UI Overhaul
 - **Floating input dialogs**: All bookmark operations now use modern floating window interface
@@ -31,9 +110,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - New input dialog system with multi-byte character support
 - Enhanced BookmarkManager with private helper methods for dialogs
 - Improved cursor positioning calculations
-- **Detailed changelog**: [CHANGELOG_v0.10.0.md](./CHANGELOG_v0.10.0.md)
+- **Detailed changelog**: [CHANGELOG_v0.10.0.md](./docs/CHANGELOG_v0.10.0.md)
 
-## [0.9.0] - 2025-01-XX
+## [0.9.0] - 2025-12-13
 
 ### Added
 - **Escape key support for file/directory creation**: Press `Esc` to cancel file (`a`) or directory (`A`) creation prompts and return to the main view
@@ -47,8 +126,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - New `read_line_with_escape` method for cancelable input handling
 - Comprehensive test suite for escape key functionality
 - Support for multi-byte characters (Japanese, etc.) in filename/directory input
+- **Detailed changelog**: [CHANGELOG_v0.9.0.md](./docs/CHANGELOG_v0.9.0.md)
+
+## [0.8.0] - 2025-12-06
 
-## [0.7.0] - 2024-11-29
+For detailed information, see [CHANGELOG_v0.8.0.md](./docs/CHANGELOG_v0.8.0.md)
+
+## [0.7.0] - 2025-11-29
 
 ### Added
 - **🔌 Plugin System**: Complete extensible plugin architecture for rufio
@@ -70,9 +154,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - New `PluginConfig` for configuration file handling
 - Plugin directory structure: `lib/rufio/plugins/` and `~/.rufio/plugins/`
 - Case-insensitive plugin name matching in configuration
-- **Detailed changelog**: [CHANGELOG_v0.7.0.md](./CHANGELOG_v0.7.0.md)
+- **Detailed changelog**: [CHANGELOG_v0.7.0.md](./docs/CHANGELOG_v0.7.0.md)
 
-## [0.6.0] - 2025-01-XX
+## [0.6.0] - 2025-09-28
 
 ### Added
 - **🚀 zoxide Integration**: Complete zoxide directory history navigation functionality
@@ -95,7 +179,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Extended `HealthChecker` with zoxide version checking
 - Comprehensive test suite for zoxide functionality
 - Safe path escaping using Ruby's Shellwords module
-- **Detailed changelog**: [CHANGELOG_v0.6.0.md](./CHANGELOG_v0.6.0.md)
+- **Detailed changelog**: [CHANGELOG_v0.6.0.md](./docs/CHANGELOG_v0.6.0.md)
 
 ## [0.5.0] - 2025-09-20
 
@@ -120,7 +204,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Maximum 9 bookmarks with automatic sorting
 - Floating window system for bookmark management
 - Integration with existing terminal UI components
-- **Detailed changelog**: [CHANGELOG_v0.5.0.md](./CHANGELOG_v0.5.0.md)
+- **Detailed changelog**: [CHANGELOG_v0.5.0.md](./docs/CHANGELOG_v0.5.0.md)
 
 ## [0.4.0] - 2025-09-13
 
@@ -153,7 +237,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Enhanced error handling** patterns throughout codebase
 - **Improved file system safety** checks and validation
 
-For detailed information, see [CHANGELOG_v0.4.0.md](./CHANGELOG_v0.4.0.md)
+For detailed information, see [CHANGELOG_v0.4.0.md](./docs/CHANGELOG_v0.4.0.md)
 
 ## [0.3.0] - 2025-09-06
 
@@ -189,9 +273,22 @@ For detailed information, see [CHANGELOG_v0.4.0.md](./CHANGELOG_v0.4.0.md)
 
 ## Release Links
 
-- [v0.6.0 Detailed Release Notes](./CHANGELOG_v0.6.0.md) - zoxide Integration and Enhanced Health Checking
-- [v0.5.0 Detailed Release Notes](./CHANGELOG_v0.5.0.md) - Bookmark System Implementation
-- [v0.4.0 Detailed Release Notes](./CHANGELOG_v0.4.0.md) - Comprehensive changelog with technical details
+### Detailed Release Notes
+
+- [v0.31.0](./docs/CHANGELOG_v0.31.0.md) - Experimental Native Scanner Implementation
+- [v0.30.0](./docs/CHANGELOG_v0.30.0.md) - Help System Overhaul
+- [v0.21.0](./docs/CHANGELOG_v0.21.0.md) - Copy Feature & Code Refactoring
+- [v0.20.0](./docs/CHANGELOG_v0.20.0.md) - Project Mode Enhancement & UI Unification
+- [v0.10.0](./docs/CHANGELOG_v0.10.0.md) - Bookmark UI Overhaul
+- [v0.9.0](./docs/CHANGELOG_v0.9.0.md) - Escape Key Support & Input Improvements
+- [v0.8.0](./docs/CHANGELOG_v0.8.0.md) - Additional Features
+- [v0.7.0](./docs/CHANGELOG_v0.7.0.md) - Plugin System
+- [v0.6.0](./docs/CHANGELOG_v0.6.0.md) - zoxide Integration
+- [v0.5.0](./docs/CHANGELOG_v0.5.0.md) - Bookmark System Implementation
+- [v0.4.0](./docs/CHANGELOG_v0.4.0.md) - Floating Dialog System & English Interface
+
+### External Links
+
 - [GitHub Releases](https://github.com/masisz/rufio/releases) - Download releases and view release history
 - [Installation Guide](./README.md#installation) - How to install rufio
 - [Usage Documentation](./README.md#usage) - Complete usage guide

data/README.md

@@ -13,7 +13,11 @@ rufioは、Yaziにインスパイアされたターミナル上で動作する
 - **軽量でシンプル**: Rubyで書かれた軽量なファイルマネージャー
 - **直感的な操作**: Vimライクなキーバインド
 - **プラグインシステム**: 拡張可能なプラグインアーキテクチャ
-- **コマンドモード**: Tab補完とフローティングウィンドウを備えた強力なコマンドシステム
+- **強力なコマンドモード** (v0.32.0):
+  - シェルコマンド実行 (`!ls`, `!git status` など)
+  - コマンド履歴（上下矢印キーでナビゲーション）
+  - インテリジェントなTab補完（候補リスト表示）
+  - Rubyプラグインによる拡張可能なコマンド
 - **ファイルプレビュー**: テキストファイルの内容をその場で確認
 - **ファイル選択・操作**: 複数ファイルの選択、移動、コピー、削除が可能
 - **リアルタイムフィルター**: sキーでファイル名の絞り込み表示
@@ -46,6 +50,61 @@ rufio           # カレントディレクトリで起動
 rufio /path/to  # 指定したディレクトリで起動
 ```
 
+### ネイティブスキャナー（実験的機能）
+
+rufio v0.31.0以降では、高速なディレクトリスキャンのためのネイティブ実装（Rust/Go）をサポートしています。デフォルトは安定したRuby実装を使用し、オプションでネイティブ実装に切り替え可能です。
+
+#### 起動オプション
+
+```bash
+# デフォルト（Ruby実装 - 安定）
+rufio
+
+# ネイティブ実装を有効化（自動検出: Rust > Go > Ruby）
+rufio --native
+rufio --native=auto
+
+# Rust実装を強制使用
+rufio --native=rust
+rufio --native rust /path/to/dir
+
+# Go実装を強制使用
+rufio --native=go
+rufio --native go /path/to/dir
+
+# 環境変数でも制御可能
+RUFIO_NATIVE=rust rufio
+RUFIO_NATIVE=go rufio /path/to/dir
+```
+
+#### ネイティブ実装について
+
+- **Rust実装**: 最も高速でメモリ安全。推奨。
+- **Go実装**: 高速で並行処理に優れる。
+- **Ruby実装** (デフォルト): 依存なし、安定動作保証。
+
+#### ビルド方法
+
+ネイティブ実装を使用するには、事前にビルドが必要です：
+
+```bash
+# Rust実装のビルド
+cd lib_rust/scanner
+cargo build --release
+make install
+
+# Go実装のビルド
+cd lib_go/scanner
+make install
+```
+
+#### 注意事項
+
+- ネイティブ実装は実験的機能です
+- デフォルトではRuby実装を使用（`--native`オプションなし）
+- ネイティブライブラリがない場合、自動的にRuby実装にフォールバック
+- gemインストール時はネイティブライブラリが含まれます（ビルド不要）
+
 ### ヘルスチェック
 
 ```bash
@@ -125,15 +184,29 @@ rufio --help           # ヘルプメッセージを表示
 | ---- | ---------------------------------- |
 | `z`  | zoxide履歴からディレクトリを選択移動 |
 
-#### コマンドモード
+#### コマンドモード (v0.32.0 強化版)
 
 | キー   | 機能                                     |
 | ------ | ---------------------------------------- |
 | `:`    | コマンドモードを起動                     |
-| `Tab`  | コマンド補完（コマンドモード中）         |
+| `Tab`  | コマンド補完・候補リスト表示（コマンドモード中）|
+| `↑`    | 前のコマンドを表示（コマンドモード中）   |
+| `↓`    | 次のコマンドを表示（コマンドモード中）   |
 | `Enter`| コマンドを実行（コマンドモード中）       |
 | `ESC`  | コマンドモードをキャンセル（コマンドモード中） |
 
+**シェルコマンド実行** (v0.32.0):
+```
+:!ls -la          # ファイル一覧を表示
+:!git status      # Gitステータスを確認
+:!pwd             # 現在のディレクトリを表示
+```
+
+**Rubyコマンド** (v0.32.0):
+```
+:hello            # Hello プラグインを実行
+```
+
 #### ヘルプ
 
 | キー | 機能                               |

data/README_EN.md

@@ -13,9 +13,14 @@ rufio is a terminal-based file manager inspired by Yazi. It's implemented in Rub
 - **Lightweight & Simple**: A lightweight file manager written in Ruby
 - **Intuitive Operation**: Vim-like key bindings
 - **Plugin System**: Extensible plugin architecture
+- **Powerful Command Mode** (v0.32.0):
+  - Shell command execution (`!ls`, `!git status`, etc.)
+  - Command history (navigate with arrow keys)
+  - Intelligent Tab completion (with candidate list display)
+  - Extensible commands via Ruby plugins
 - **File Preview**: View text file contents on the fly
-- **File Selection & Operations**: Select multiple files, move, and delete
-- **Real-time Filter**: Filter files by name using s key
+- **File Selection & Operations**: Select multiple files, move, copy, and delete
+- **Real-time Filter**: Filter files by name using f key
 - **Advanced Search**: Powerful search using fzf and rga
 - **Multi-platform**: Runs on macOS, Linux, and Windows
 - **External Editor Integration**: Open files with your favorite editor
@@ -118,6 +123,29 @@ rufio --help           # Show help message
 | --- | ---------------------------------- |
 | `z` | Select directory from zoxide history |
 
+#### Command Mode (v0.32.0 Enhanced)
+
+| Key     | Function                                  |
+| ------- | ----------------------------------------- |
+| `:`     | Activate command mode                     |
+| `Tab`   | Command completion / Show candidate list  |
+| `↑`     | Previous command (in command mode)        |
+| `↓`     | Next command (in command mode)            |
+| `Enter` | Execute command (in command mode)         |
+| `ESC`   | Cancel command mode (in command mode)     |
+
+**Shell Command Execution** (v0.32.0):
+```
+:!ls -la          # List files with details
+:!git status      # Check git status
+:!pwd             # Print working directory
+```
+
+**Ruby Commands** (v0.32.0):
+```
+:hello            # Execute Hello plugin
+```
+
 #### System Operations
 
 | Key | Function    |

data/bin/rufio

@@ -6,27 +6,98 @@ require_relative '../lib/rufio'
 # プラグインを読み込む
 Rufio::PluginManager.load_all
 
-# コマンドライン引数の処理
+# コマンドライン引数のパース
+native_mode = nil
+start_directory = nil
+skip_next = false
+
+ARGV.each_with_index do |arg, idx|
+  if skip_next
+    skip_next = false
+    next
+  end
+
+  case arg
+  when '--native'
+    # 次の引数がモード指定かチェック
+    if idx + 1 < ARGV.length && !ARGV[idx + 1].start_with?('--') && !ARGV[idx + 1].start_with?('/')
+      next_arg = ARGV[idx + 1]
+      if %w[rust go auto ruby].include?(next_arg)
+        native_mode = next_arg
+        skip_next = true
+      else
+        native_mode = 'auto'
+      end
+    else
+      native_mode = 'auto'
+    end
+  when /^--native=(rust|go|auto|ruby)$/
+    native_mode = $1
+  when '-c', '--check-health', '--help', '-h'
+    # これらは後で処理
+  when /^--/
+    # 未知のオプションは無視
+  else
+    # 最初の非オプション引数をディレクトリとして扱う
+    start_directory ||= arg
+  end
+end
+
+# ネイティブスキャナーモードを設定（native_scannerが存在する場合のみ）
+if native_mode && defined?(Rufio::NativeScanner)
+  Rufio::NativeScanner.mode = native_mode
+end
+
+# 環境変数でも制御可能
+if ENV['RUFIO_NATIVE'] && defined?(Rufio::NativeScanner)
+  Rufio::NativeScanner.mode = ENV['RUFIO_NATIVE']
+end
+
+# コマンド処理
 if ARGV.include?('--check-health') || ARGV.include?('-c')
   # ヘルスチェック実行
   health_checker = Rufio::HealthChecker.new
   success = health_checker.run_check
   exit(success ? 0 : 1)
-elsif ARGV.include?('--help')
+elsif ARGV.include?('--help') || ARGV.include?('-h')
   puts "rufio - Terminal-based file manager"
   puts ""
   puts "Usage:"
-  puts "  rufio [DIRECTORY]     Start rufio in specified directory"
-  puts "  rufio -c, --check-health  Check system dependencies"
-  puts "  rufio --help          Show this help message"
+  puts "  rufio [OPTIONS] [DIRECTORY]"
+  puts ""
+  puts "Options:"
+  puts "  -c, --check-health        Check system dependencies"
+  puts "  -h, --help                Show this help message"
+  if defined?(Rufio::NativeScanner)
+    puts "  --native[=MODE]           Enable native scanner (experimental)"
+    puts "                            MODE: auto|rust|go (default: auto)"
+    puts ""
+    puts "Native Scanner:"
+    puts "  By default, rufio uses Ruby implementation for stability."
+    puts "  Native scanners (Rust/Go) are experimental and can be enabled with --native."
+    puts ""
+    puts "  --native                  Auto-detect (Rust > Go > Ruby)"
+    puts "  --native=rust             Use Rust implementation"
+    puts "  --native=go               Use Go implementation"
+    puts "  --native=auto             Same as --native"
+    puts "  --native=ruby             Use Ruby implementation (default)"
+    puts ""
+    puts "  Environment variable: RUFIO_NATIVE=rust|go|auto"
+  end
   puts ""
   puts "Examples:"
-  puts "  rufio                 # Start in current directory"
-  puts "  rufio /path/to/dir    # Start in specific directory"
-  puts "  rufio -c              # Check if all dependencies are available"
+  puts "  rufio                     # Start in current directory"
+  puts "  rufio /path/to/dir        # Start in specific directory"
+  if defined?(Rufio::NativeScanner)
+    puts "  rufio --native            # Use native scanner (auto-detect)"
+    puts "  rufio --native=rust       # Use Rust scanner"
+    puts "  rufio --native rust /tmp  # Use Rust scanner in /tmp"
+    puts "  RUFIO_NATIVE=rust rufio   # Use Rust via environment variable"
+  end
+  puts "  rufio -c                  # Check dependencies"
   exit(0)
 else
-  start_directory = ARGV[0] || Dir.pwd
+  start_directory ||= Dir.pwd
 
   # アプリケーション開始
   app = Rufio::Application.new(start_directory)

data/docs/CHANGELOG_v0.31.0.md

@@ -0,0 +1,125 @@
+# Changelog - v0.31.0
+
+## 🚀 New Features
+
+### Experimental Native Scanner Implementation
+
+Added high-performance directory scanning with Rust/Go implementations. By default, uses stable Ruby implementation with optional native implementations available via command-line options.
+
+#### Implementation Languages
+- **Rust implementation** (`lib_rust/scanner/`): Fastest, memory-safe
+- **Go implementation** (`lib_go/scanner/`): Fast, excellent concurrency
+- **Ruby implementation** (default): Stable, no dependencies
+
+#### NativeScanner Abstraction Layer
+- `lib/rufio/native_scanner.rb`: Unified interface independent of implementation
+- Automatic fallback (falls back to Ruby if native implementation unavailable)
+
+#### Launch Options
+```bash
+# Default (Ruby implementation)
+rufio
+
+# Enable native implementation (auto-detect: Rust > Go > Ruby)
+rufio --native
+rufio --native=auto
+
+# Force Rust implementation
+rufio --native=rust
+
+# Force Go implementation
+rufio --native=go
+
+# Environment variable control
+RUFIO_NATIVE=rust rufio
+```
+
+#### Priority
+- **Default**: Ruby (stability focused)
+- **`--native=auto`**: Rust > Go > Ruby
+- **`--native=rust`**: Rust (fallback to Ruby if unavailable)
+- **`--native=go`**: Go (fallback to Ruby if unavailable)
+
+## 🔧 Improvements
+
+### GitHub Actions CI/CD
+- **Build**: Automatically build native libraries on 3 OSes (Linux, macOS, Windows)
+- **Test**: Run tests on all platforms (both Ruby fallback and native implementations)
+- **Release**: Auto-build and publish gem on tag push, attach binaries
+
+### Development Environment
+- `.gitignore`: Ignore build artifacts (`target/`, `*.dylib`, `*.so`, `*.dll`, etc.)
+- gemspec: Configure to include native libraries in gem (optional)
+
+### Command-Line Argument Processing
+- Added `--native` option
+- Improved argument parser (accurate path and option discrimination)
+- Added native scanner description to `--help`
+
+## 📦 Dependencies
+
+### Ruby Dependencies (unchanged)
+- io-console ~> 0.6
+- pastel ~> 0.8
+- tty-cursor ~> 0.7
+- tty-screen ~> 0.8
+- ffi (only when using native scanner)
+
+### Build-time Dependencies (optional)
+- **Rust**: cargo, rustc (to build Rust implementation)
+- **Go**: go 1.21+ (to build Go implementation)
+
+## 🧪 Tests
+
+Added new tests:
+- `test/test_rust_scanner.rb`: Rust scanner tests
+- `test/test_go_scanner.rb`: Go scanner tests
+- `test/test_native_scanner.rb`: NativeScanner abstraction layer tests
+  - Verify default mode is Ruby
+  - Mode switching tests
+  - Auto-detection tests
+  - Fallback behavior tests
+
+All tests passing: 279+ runs, 1299+ assertions, 0 failures, 0 errors
+
+## 📝 Documentation
+
+- README.md: Added launch options documentation
+- Help message: Detailed `--native` option description
+
+## 🔒 Compatibility
+
+- **Backward compatibility**: Fully maintained (default is Ruby implementation)
+- **Native libraries**: Optional (works without them)
+- **Platforms**: Linux, macOS, Windows supported
+
+## 📌 Notes
+
+### Experimental Feature
+Rust/Go implementations are experimental:
+- Not used by default (requires `--native` option)
+- Thorough testing recommended for production use
+- Use default Ruby implementation if issues occur
+
+### Build Instructions
+
+#### Rust Implementation
+```bash
+cd lib_rust/scanner
+cargo build --release
+make install
+```
+
+#### Go Implementation
+```bash
+cd lib_go/scanner
+make install
+```
+
+## 🙏 Acknowledgments
+
+Native Rust/Go implementations enable faster scanning of large directories. We welcome your feedback.
+
+---
+
+Release Date: 2026-01-01