rufio 0.32.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aff3f0a1c50ec0a854769b6cd89a559872db6edd9618fe000e80a89160018887
-  data.tar.gz: 244a77b3555472fccecfe13638ae53f72bc971f6cbc3649ded6bd09a127b4004
+  metadata.gz: 6d9ba235b051414a23404dd8afdd87f292aef48b07f89612e57f0fcb2c0c99b0
+  data.tar.gz: e9a9273be387d14026c35cd36f7f9d805c0a951814e935f883d4138b0fe302d3
 SHA512:
-  metadata.gz: 59dbee8f1030310696f3f113c85ebc9f6ed236e7ce24ca0fc834a174f3614b2f609dc7c5471efd905d113b8d61d490779da8222c7984c3827c095d1ff0c14d67
-  data.tar.gz: a75e8048e9b6ddaf81d32d7fc772a6231462a9e81e221147329c8726ef59d65e63ecd115397f80dbd8274ced4b3a5b14d3d3d2a5c3cd247b36d8d1275518595c
+  metadata.gz: 25e64b32573b24ab97c7719c4a3a0ead75e1d6f7965732c6b71ffe6dd753786413f346247ec835d8774ad3333a51caed21efca9b8cc0ee010a4d8944f4d72014
+  data.tar.gz: 3021168e7cb48ffa747d32416a7d24379fd2f8155998a6a74ff6734703818c525bacb1ee545033e65334c1f6b340fbdb49969354ba5ff6c6620bec71f716bb89

data/CHANGELOG.md

@@ -7,6 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.34.0] - 2026-01-10
+
+### Added
+- **🚀 Async Scanner Architecture**: Complete async/parallel scanning implementation
+  - **Phase 1: Basic Async Scan**
+    - Zig pthread-based threading implementation
+    - State management (idle → scanning → done/cancelled/failed)
+    - Polling-based completion with progress tracking
+  - **Phase 2: Progress Reporting**
+    - Real-time progress API with mutex protection
+    - Thread-safe cancellation support
+    - Timeout handling for scan operations
+  - **Phase 3: Advanced Features**
+    - Promise-style interface with method chaining
+    - Fiber integration with Async library
+    - Parallel scanner with thread pool optimization
+- **💎 AsyncScannerPromise**: Promise-style interface
+  - Method chaining with `.then()` callbacks
+  - Automatic resource cleanup on completion
+  - Works with both Ruby and Zig backends
+- **🧵 AsyncScannerFiberWrapper**: Async/Fiber integration
+  - Non-blocking I/O with Ruby's Async library
+  - Concurrent scanning support
+  - Progress reporting with fiber-aware sleep
+- **⚡ ParallelScanner**: Parallel scanning optimization
+  - Thread pool management (configurable max_workers)
+  - Batch directory scanning with result merging
+  - Error handling with partial failure support
+  - Backend switching (Ruby/Zig)
+- **⚡ Zig Native Scanner**: Experimental implementation with minimal binary size (52.6 KB)
+  - Direct Ruby C API integration (no FFI overhead)
+  - Competitive performance (within 6% of fastest implementations)
+  - 5.97x smaller than Rust/Magnus implementation
+  - Async-ready handle-based design
+- **📊 YJIT Performance Analysis**: Comprehensive benchmarking of JIT compiler impact
+  - Pure Ruby: 2-5% improvement with YJIT
+  - Native extensions: No significant impact
+- **📈 Performance Documentation**: Extensive benchmarking suite and analysis
+  - 7 new benchmark scripts
+  - 4 detailed performance reports
+  - Complete implementation comparison
+
+### Fixed
+- **🚨 CRITICAL: File Preview Performance Bug**: Fixed severe rendering delays (80ms → 1-2ms)
+  - Root cause: Redundant processing inside rendering loop (38x per frame)
+  - Impact: 97-99% improvement, 40-86x faster file preview
+  - All text file previews now render in < 2ms
+- **🔧 Zig Cancellation Handling**: Fixed cancelled state not properly propagating
+  - Changed error handling to preserve cancellation state
+  - Prevents "failed" state when scan is intentionally cancelled
+
+### Changed
+- **Ruby 4.0 Compatibility**: Added `fiddle` gem dependency (required in Ruby 4.0+)
+- **Async Library Integration**: Deprecated API warnings resolved
+  - Updated to use `Kernel#sleep` instead of `Async::Task#sleep`
+
+### Technical Details
+- **Test Coverage**: 483 tests, 1899 assertions (100% pass rate)
+- **Async Scanner Tests**: 8 fiber tests, 10 promise tests, 10 parallel tests
+- **Ruby ABI Independence**: Handle-based design (u64) avoids Ruby ABI coupling
+- **Thread Safety**: Pthread mutex protection for all shared state
+- **GVL Freedom**: Native threads run independently of Ruby's GVL
+
+For detailed information, see [CHANGELOG_v0.34.0.md](./docs/CHANGELOG_v0.34.0.md)
+
 ## [0.32.0] - 2026-01-02
 
 ### Added

data/README.md

@@ -8,6 +8,14 @@ Ruby製のターミナルベースファイルマネージャー
 
 rufioは、Yaziにインスパイアされたターミナル上で動作するファイルマネージャーです。Rubyで実装されており、プラグインサポートを備えています。軽量で高速な操作性を提供し、ファイルの閲覧・管理・検索機能を備えています。
 
+### 🚀 v0.33.0の重要な更新
+
+- **🚨 重大なパフォーマンス改善**: ファイルプレビューが40-86倍高速化（80ms → 1-2ms）
+- **⚡ Zig実装追加**: 最小バイナリサイズ（52.6 KB）のネイティブスキャナー
+- **📊 YJIT対応**: Ruby 3.4+ のJITコンパイラで全体的な性能向上
+
+詳細は [CHANGELOG v0.33.0](./docs/CHANGELOG_v0.33.0.md) を参照してください。
+
 ## 特徴
 
 - **軽量でシンプル**: Rubyで書かれた軽量なファイルマネージャー
@@ -18,7 +26,19 @@ rufioは、Yaziにインスパイアされたターミナル上で動作する
   - コマンド履歴（上下矢印キーでナビゲーション）
   - インテリジェントなTab補完（候補リスト表示）
   - Rubyプラグインによる拡張可能なコマンド
-- **ファイルプレビュー**: テキストファイルの内容をその場で確認
+- **バックグラウンドコマンド実行** (v0.33.0):
+  - `:!command` でシェルコマンドを非同期実行
+  - 実行中もrufioの操作が可能
+  - 完了時に通知メッセージを表示
+  - 実行結果を自動的にログファイルに保存
+- **実行ログビューワ** (v0.33.0):
+  - `L`キーでコマンド実行ログを閲覧
+  - ログファイルのタイムスタンプ付き管理
+  - ヘルプモードと同様の直感的なUI
+- **高速ファイルプレビュー** (v0.33.0最適化):
+  - 大幅な性能改善（40-86倍高速化）
+  - 大規模ファイルも瞬時に表示（< 2ms）
+  - スムーズなスクロールと快適な操作性
 - **ファイル選択・操作**: 複数ファイルの選択、移動、コピー、削除が可能
 - **リアルタイムフィルター**: sキーでファイル名の絞り込み表示
 - **高度な検索機能**: fzfとrgaを使った強力な検索
@@ -52,7 +72,7 @@ rufio /path/to  # 指定したディレクトリで起動
 
 ### ネイティブスキャナー（実験的機能）
 
-rufio v0.31.0以降では、高速なディレクトリスキャンのためのネイティブ実装（Rust/Go）をサポートしています。デフォルトは安定したRuby実装を使用し、オプションでネイティブ実装に切り替え可能です。
+rufio v0.31.0以降では、高速なディレクトリスキャンのためのネイティブ実装（Rust/Go/Zig）をサポートしています。デフォルトは安定したRuby実装を使用し、オプションでネイティブ実装に切り替え可能です。
 
 #### 起動オプション
 
@@ -60,10 +80,13 @@ rufio v0.31.0以降では、高速なディレクトリスキャンのための
 # デフォルト（Ruby実装 - 安定）
 rufio
 
-# ネイティブ実装を有効化（自動検出: Rust > Go > Ruby）
+# ネイティブ実装を有効化（自動検出: Magnus > Zig > Rust > Go > Ruby）
 rufio --native
 rufio --native=auto
 
+# Zig実装を使用（v0.33.0 - 実験的）
+rufio --native=zig
+
 # Rust実装を強制使用
 rufio --native=rust
 rufio --native rust /path/to/dir
@@ -73,21 +96,34 @@ rufio --native=go
 rufio --native go /path/to/dir
 
 # 環境変数でも制御可能
+RUFIO_NATIVE=zig rufio
 RUFIO_NATIVE=rust rufio
 RUFIO_NATIVE=go rufio /path/to/dir
 ```
 
 #### ネイティブ実装について
 
-- **Rust実装**: 最も高速でメモリ安全。推奨。
-- **Go実装**: 高速で並行処理に優れる。
-- **Ruby実装** (デフォルト): 依存なし、安定動作保証。
+- **Zig実装** (v0.33.0 - 実験的): 最小バイナリサイズ（52.6 KB）、高速、FFI不要
+- **Magnus (Rust)**: 最速、メモリ安全、FFI不要（バイナリ: 314 KB）
+- **Rust (FFI)**: 高速、メモリ安全、JSON経由
+- **Go (FFI)**: 高速、並行処理に優れる
+- **Ruby実装** (デフォルト): 依存なし、安定動作保証
+
+**性能比較（163エントリ）:**
+- Go (FFI): 0.242 ms（最速）
+- Pure Ruby + YJIT: 0.242 ms（同等）
+- Rust (FFI): 0.244 ms
+- Zig: 0.253 ms（最小バイナリ）
 
 #### ビルド方法
 
 ネイティブ実装を使用するには、事前にビルドが必要です：
 
 ```bash
+# Zig実装のビルド（v0.33.0 - 実験的）
+cd lib_zig/rufio_native
+make
+
 # Rust実装のビルド
 cd lib_rust/scanner
 cargo build --release
@@ -98,6 +134,11 @@ cd lib_go/scanner
 make install
 ```
 
+**必要な開発ツール:**
+- Zig: Zig 0.15.2以降（`brew install zig` または https://ziglang.org/）
+- Rust: Cargo（`curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`）
+- Go: Go 1.16以降（`brew install go` または https://golang.org/）
+
 #### 注意事項
 
 - ネイティブ実装は実験的機能です
@@ -174,7 +215,7 @@ rufio --help           # ヘルプメッセージを表示
 | キー      | 機能                                 |
 | --------- | ------------------------------------ |
 | `b`       | 現在のディレクトリをブックマークに追加 |
-| `p`       | プロジェクトモードに入る             |
+| `P`       | プロジェクトモードに入る (v0.33.0で変更) |
 | `0`       | 起動したディレクトリに移動           |
 | `1`-`9`   | 対応する番号のブックマークに移動     |
 
@@ -202,11 +243,26 @@ rufio --help           # ヘルプメッセージを表示
 :!pwd             # 現在のディレクトリを表示
 ```
 
+**バックグラウンド実行** (v0.33.0):
+- `:!command` でシェルコマンドを非同期実行
+- 実行中もrufioの操作が可能
+- 完了時に通知メッセージを3秒間表示
+- 実行結果は自動的に `~/.config/rufio/log/` に保存
+
 **Rubyコマンド** (v0.32.0):
 ```
 :hello            # Hello プラグインを実行
 ```
 
+#### ログビューワ (v0.33.0)
+
+| キー | 機能                               |
+| ---- | ---------------------------------- |
+| `L`  | コマンド実行ログを閲覧             |
+| `ESC`| ログビューワモードを終了           |
+
+コマンド実行ログは `~/.config/rufio/log/` に保存され、`L`キーで閲覧できます。
+
 #### ヘルプ
 
 | キー | 機能                               |

data/README_EN.md

@@ -18,6 +18,15 @@ rufio is a terminal-based file manager inspired by Yazi. It's implemented in Rub
   - Command history (navigate with arrow keys)
   - Intelligent Tab completion (with candidate list display)
   - Extensible commands via Ruby plugins
+- **Background Command Execution** (v0.33.0):
+  - Execute shell commands asynchronously with `:!command`
+  - rufio remains operational during execution
+  - Displays completion notification
+  - Automatically saves execution results to log files
+- **Execution Log Viewer** (v0.33.0):
+  - View command execution logs with `L` key
+  - Timestamp-based log file management
+  - Intuitive UI similar to help mode
 - **File Preview**: View text file contents on the fly
 - **File Selection & Operations**: Select multiple files, move, copy, and delete
 - **Real-time Filter**: Filter files by name using f key
@@ -115,6 +124,7 @@ rufio --help           # Show help message
 | Key     | Function                        |
 | ------- | ------------------------------- |
 | `b`     | Show bookmark menu              |
+| `P`     | Enter project mode (Changed in v0.33.0) |
 | `1`-`9` | Go to corresponding bookmark    |
 
 #### zoxide Integration
@@ -141,11 +151,26 @@ rufio --help           # Show help message
 :!pwd             # Print working directory
 ```
 
+**Background Execution** (v0.33.0):
+- Execute shell commands asynchronously with `:!command`
+- rufio remains operational during execution
+- Displays completion notification for 3 seconds
+- Execution results automatically saved to `~/.config/rufio/log/`
+
 **Ruby Commands** (v0.32.0):
 ```
 :hello            # Execute Hello plugin
 ```
 
+#### Log Viewer (v0.33.0)
+
+| Key   | Function                     |
+| ----- | ---------------------------- |
+| `L`   | View command execution logs  |
+| `ESC` | Exit log viewer mode         |
+
+Command execution logs are saved to `~/.config/rufio/log/` and can be viewed with the `L` key.
+
 #### System Operations
 
 | Key | Function    |