rufio 0.82.1 → 0.83.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95f95e73aa18690cd88f4c18a1c1b4c7d5bccf7a07ba7c507cd569acdc3985e3
-  data.tar.gz: c7a636b0fe589fcfa516d3109186e310132bdb478a0357d0542be76239dfc6fc
+  metadata.gz: b75328867a09d6dfa3b4c759e242d239ab8d087540a43af19471473cc0515c4c
+  data.tar.gz: 798358451d71a8b74ee70ce2d362b2f24fb887e6de9b574f700c0f25a449e389
 SHA512:
-  metadata.gz: 5bfda6ac1bdd743ca4c54a5b5e6dc1c72614900ec280a8c972ae14e7effb1cb84d9d693ee4f74115595e5a68a7d8e81ec350a7fd03506ff413257c8d9a270066
-  data.tar.gz: 1ab9a355aaf8d5be8f8b66458935886b210fbd2bf17519b1b6793644fe6f0f2f69ccacd5cd376986d0a1dd6be7d0692200da61080172db5a1b6db2c24fd6e6c7
+  metadata.gz: 8072bc03c642bbc3043caca4cfa4899c72b6622ab7a74517ef7964010a9257e938005191de9a8e8aaed444749108ef1ef983b6b4dc8483aa8b4d2a6a8cb075a6
+  data.tar.gz: d6fb6e10e070e94120518d5a883bd241b46a957e7938b375b09e7dc3e28e73e9652aabe7b6a191e2575872764919581ac6d4b163d48fbb2d5dcd50e7740e2e2f

data/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to rufio will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.83.0] - 2026-03-14
+
+### Added
+- **Mouse input support**: Enabled SGR extended mouse reporting (`\e[?1003h\e[?1006h`) with click and scroll handling
+  - **Left click (file list)**: Move cursor to the clicked row
+  - **Left double-click (file list)**: Re-click within 0.5s opens the file (equivalent to Enter)
+  - **Left click (right panel)**: Toggle preview focus on/off
+  - **Wheel scroll (file list)**: Scroll up/down (equivalent to j/k)
+  - **Wheel scroll (preview focused)**: Scroll the preview panel
+  - Mouse reporting is disabled on exit via `cleanup_terminal` (`\e[?1003l\e[?1006l`)
+- **Architecture documentation**: Added `docs/architecture_concurrency_ja_v0.82.1.md`
+  - Documents rufio's concurrency model (single-threaded UI + worker threads + child processes)
+  - Documents memory model characteristics (screen buffer, preview cache, job history)
+
+### Changed
+- **`read_next_input_byte` helper**: Extracted common ESC sequence reading logic to reduce duplication
+- **`UIRenderer#left_panel_ratio` exposed**: Added `attr_reader` for use in mouse click panel detection
+
 ## [0.82.1] - 2026-03-07
 
 ### Fixed

data/docs/architecture_concurrency_ja_v0.82.1.md

@@ -0,0 +1,169 @@
+# rufio 並行実行アーキテクチャ
+
+## 結論（Single Thread / Thread / Process / Event Loop）
+
+rufio は **単一のメインプロセス**で動作し、UIは **シングルスレッドのイベントループ**で駆動されます。
+ただし、実行中に以下を併用します。
+
+- `Thread`: バックグラウンド実行、非同期スキャン、非同期ハイライト、Windows入力補助
+- `Process`（子プロセス）: `Open3` / `IO.popen` / `system` による外部コマンド実行
+
+つまり実態は、**「シングルスレッドUI + 補助スレッド + 外部プロセス」構成**です。
+
+## 1. 起動とプロセス境界
+
+- エントリポイントは [`bin/rufio`](../bin/rufio)
+- 本体は [`Rufio::Application`](../lib/rufio/application.rb) が初期化し、[`TerminalUI#main_loop`](../lib/rufio/terminal_ui.rb) に入る
+- アプリ自身は `fork`/常駐ワーカープロセスを持たない（コード上 `fork` 使用なし）
+
+### 子プロセスを作る経路
+
+- `Open3.capture3` / `Open3.popen3`
+  - [`lib/rufio/background_command_executor.rb`](../lib/rufio/background_command_executor.rb)
+  - [`lib/rufio/command_mode.rb`](../lib/rufio/command_mode.rb)
+  - [`lib/rufio/script_runner.rb`](../lib/rufio/script_runner.rb)
+  - [`lib/rufio/script_executor.rb`](../lib/rufio/script_executor.rb)
+- `IO.popen`（`bat` 実行）
+  - [`lib/rufio/syntax_highlighter.rb`](../lib/rufio/syntax_highlighter.rb)
+- `system`（`tput`, `which` 等）
+  - [`lib/rufio/terminal_ui.rb`](../lib/rufio/terminal_ui.rb)
+  - [`lib/rufio/syntax_highlighter.rb`](../lib/rufio/syntax_highlighter.rb)
+
+## 2. Event Loop（UIの中心）
+
+メインループは [`TerminalUI#main_loop`](../lib/rufio/terminal_ui.rb) で実装されています。
+
+- ループ周期の基準: 約30FPS（`min_sleep_interval = 0.0333`）
+- フェーズ: `UPDATE -> DRAW -> RENDER -> SLEEP`
+- 入力: ノンブロッキング
+  - Unix: `IO.select(..., timeout=0)` + `STDIN.read_nonblock`
+  - Windows: 補助入力スレッド + `Queue` 受信
+- 定期監視
+  - バックグラウンドコマンド完了チェック（約0.1秒周期）
+  - 通知ランプ期限チェック
+  - 非同期ハイライト完了フラグチェック
+
+ポイントは「**UIスレッドはブロックしない**」ことで、重い処理は別スレッド/別プロセスへ逃がしています。
+
+## 3. Thread モデル
+
+### 3.1 常時/都度の補助スレッド
+
+- バックグラウンドコマンド
+  - [`BackgroundCommandExecutor`](../lib/rufio/background_command_executor.rb)
+  - `Thread.new` で1ジョブ実行（同時1本に制限）
+- スクリプトジョブ
+  - [`ScriptRunner`](../lib/rufio/script_runner.rb)
+  - [`CommandMode`](../lib/rufio/command_mode.rb)
+  - ジョブごとに `Thread.new` で実行
+- 非同期ディレクトリスキャン
+  - [`NativeScannerRubyCore`](../lib/rufio/native_scanner.rb)
+  - スキャンごとに1スレッド
+- 並列スキャン
+  - [`ParallelScanner`](../lib/rufio/parallel_scanner.rb)
+  - `Queue` + ワーカースレッドプール（既定4）
+- 非同期シンタックスハイライト
+  - [`SyntaxHighlighter#highlight_async`](../lib/rufio/syntax_highlighter.rb)
+  - `Thread` + `Mutex` + pendingガード
+- Windows入力補助
+  - [`TerminalUI#setup_terminal`](../lib/rufio/terminal_ui.rb)
+  - `STDIN.read(1)` を読む専用スレッド
+
+### 3.2 スレッド安全性の扱い
+
+- `Mutex` で共有状態を保護（例: `NativeScannerRubyCore`, `SyntaxHighlighter`）
+- `Queue` で producer/consumer 連携（`ParallelScanner`, Windows入力）
+- UI反映はメインループでポーリング/フラグ監視し、描画系の責務を集中
+
+## 4. Process モデル
+
+外部コマンド実行は Ruby プロセス内で直接処理せず、子プロセスに委譲しています。
+
+- シェルコマンド・スクリプト・rake は `Open3` 経由で実行
+- タイムアウト付き実行では `Process.kill("TERM"/"KILL")` を使用
+  - [`ScriptExecutor`](../lib/rufio/script_executor.rb)
+- ハイライトは `bat` 子プロセスから出力取得
+
+このため、重い外部処理があっても UI スレッド停止を避けやすい構造です。
+
+## 5. Single Thread か？への回答
+
+質問に対しては次の回答が正確です。
+
+- UI制御: **シングルスレッド（イベントループ）**
+- 並行処理: **マルチスレッドを使用**
+- 実処理実行: **外部子プロセスを多用**
+- アーキテクチャ全体: **単一メインプロセス + イベントループ + ワーカースレッド + 子プロセス**
+
+## 6. 補足（運用上の含意）
+
+- RubyスレッドはI/O待ちや外部プロセス待ちの分離には有効
+- CPUバウンド処理をRubyスレッドで増やしても、処理系制約（GVL）で伸びにくい可能性がある
+- 現状設計は「UI応答性優先」「外部コマンド委譲型」のTUIとして合理的
+
+## 7. メモリモデル
+
+rufio のメモリは、概ね次の4種類で構成されます。
+
+- 固定サイズの描画バッファ（画面サイズ依存）
+- ディレクトリ/プレビューなどの作業データ（操作対象依存）
+- キャッシュ/履歴（セッション経過で増える可能性あり）
+- 外部プロセス実行時の一時データ（子プロセス出力依存）
+
+### 7.1 オブジェクトの寿命
+
+- プロセス寿命で生存（起動時作成）
+  - `TerminalUI`, `UIRenderer`, `KeybindHandler`, `JobManager` など
+- 画面更新ごとに再生成される一時データ
+  - 行描画文字列、差分描画バッファ
+- ジョブ/コマンド実行中のみ生存
+  - ワーカースレッド、`Open3` の入出力文字列、スキャナーインスタンス
+
+### 7.2 固定上限に近い領域
+
+- ダブルバッファ
+  - [`Screen`](../lib/rufio/screen.rb): `@cells`（`height x width`）
+  - [`Renderer`](../lib/rufio/renderer.rb): `@front`（`height` 行ぶんの表示文字列）
+- これらは基本的に「端末サイズに比例」し、無制限には伸びない
+
+### 7.3 変動するが上限管理される領域
+
+- 通知
+  - [`NotificationManager`](../lib/rufio/notification_manager.rb) は最大3件
+- コマンド履歴（メモリ内）
+  - [`CommandHistory`](../lib/rufio/command_history.rb) は `max_size`（既定1000）
+- ディレクトリエントリ
+  - [`DirectoryListing`](../lib/rufio/directory_listing.rb) は `refresh` ごとに `@entries` を再構築
+
+### 7.4 増加しやすい領域（要注意）
+
+- プレビューキャッシュ
+  - [`UIRenderer`](../lib/rufio/ui_renderer.rb) の `@preview_cache` は閲覧ファイルパス単位で蓄積
+  - `wrapped` / `highlighted_wrapped` も幅ごとに追加される
+  - `clear_preview_cache` は実装されているが、通常フローからは呼ばれていない
+- ジョブ一覧
+  - [`JobManager`](../lib/rufio/job_manager.rb) の `@jobs` は追加され続ける
+  - `clear_completed` はあるが、通常キー操作には接続されていない
+- ジョブログ
+  - [`TaskStatus`](../lib/rufio/task_status.rb) の `@logs` は配列で蓄積（上限なし）
+  - 標準出力/標準エラーが大きいジョブはメモリ圧迫要因になる
+- ログファイル（ディスク）
+  - [`CommandLogger`](../lib/rufio/command_logger.rb) はログファイルを増やし続ける
+  - `cleanup_old_logs` は実装済みだが、通常フローで自動実行はされない
+
+### 7.5 外部プロセス実行時のメモリ特性
+
+- `Open3.capture3` は stdout/stderr を文字列として一括保持するため、
+  出力が大きいほど Ruby ヒープ使用量が一時的に増える
+- ただし実処理は子プロセス側で実行されるため、計算本体のメモリは原則として別プロセスに分離される
+
+### 7.6 Ruby/C 境界（Zig スキャナー）
+
+- Zig経路では [`NativeScannerZigCore`](../lib/rufio/native_scanner_zig.rb) がハンドルを保持し、
+  `close` で `core_async_destroy` を呼んで明示解放する
+- `scan` 呼び出し側は `ensure` で `close` しており、通常経路でハンドルリークしにくい設計
+
+### 7.7 まとめ
+
+メモリモデルとしては、**描画バッファは安定**している一方で、**プレビューキャッシュ・ジョブ履歴・ジョブログ**は
+セッションが長くなるほど増えうる構造です。長時間運用時のメモリ安定性は、この3点の上限管理の有無に最も左右されます。

data/lib/rufio/terminal_ui.rb

@@ -185,6 +185,10 @@ module Rufio
         STDIN.raw!
       end
 
+      # SGR拡張マウスレポートを有効化（ボタン + ホイール + 任意位置クリック）
+      print "\e[?1003h\e[?1006h"
+      STDOUT.flush
+
       # Windows: IO.select + read_nonblockはコンソールハンドルのESCキーを
       # 検出できない場合がある。バックグラウンドスレッドでSTDINを読み取り
       # Queueに格納することで信頼性のある入力検出を実現する。
@@ -231,6 +235,15 @@ module Rufio
       end
     end
 
+    # エスケープシーケンスの後続バイトを読み取る（Windows/Unix共通ヘルパー）
+    def read_next_input_byte
+      if @windows_input_queue
+        windows_read_next_byte
+      else
+        STDIN.read_nonblock(1) rescue nil
+      end
+    end
+
     def cleanup_terminal
       # rawモードを解除
       if STDIN.tty?
@@ -244,6 +257,10 @@ module Rufio
         @windows_input_queue = nil
       end
 
+      # マウスレポートを無効化
+      print "\e[?1003l\e[?1006l"
+      STDOUT.flush
+
       system('tput rmcup')  # normal screen
       system('tput cnorm')  # cursor normal
       puts ConfigLoader.message('app.terminated')
@@ -461,17 +478,27 @@ module Rufio
 
       # 特殊キーの処理（エスケープシーケンス）（コマンドモード外のみ）
       if input == "\e"
-        next_char = if @windows_input_queue
-          windows_read_next_byte
-        else
-          STDIN.read_nonblock(1) rescue nil
-        end
+        next_char = read_next_input_byte
         if next_char == '['
-          # 矢印キーなどのシーケンス
-          third_char = if @windows_input_queue
-            windows_read_next_byte
-          else
-            STDIN.read_nonblock(1) rescue nil
+          # CSIシーケンス（矢印キー・マウスなど）
+          third_char = read_next_input_byte
+          if third_char == '<'
+            # SGR拡張マウスイベント: \e[<Btn;Col;RowM/m
+            mouse_seq = +""
+            loop do
+              ch = read_next_input_byte
+              break if ch.nil?
+              mouse_seq << ch
+              break if ch == 'M' || ch == 'm'
+            end
+            if (m = mouse_seq.match(/\A(\d+);(\d+);(\d+)([Mm])\z/))
+              btn  = m[1].to_i
+              col  = m[2].to_i
+              row  = m[3].to_i
+              press = m[4] == 'M'
+              handle_mouse_event(btn, col, row, press)
+            end
+            return true
           end
           input = case third_char
           when 'A' then 'k'  # Up arrow
@@ -558,6 +585,95 @@ module Rufio
       end
     end
 
+    # ============================
+    # マウスイベント処理
+    # ============================
+
+    # SGRマウスイベントを処理する
+    # @param btn [Integer]  SGRボタン番号（0=左, 1=中, 2=右, 64=ホイールアップ, 65=ホイールダウン）
+    # @param col [Integer]  クリック列（1-indexed）
+    # @param row [Integer]  クリック行（1-indexed）
+    # @param press [Boolean] true=押下, false=解放
+    def handle_mouse_event(btn, col, row, press)
+      case btn
+      when 0  # 左クリック（押下のみ処理）
+        handle_mouse_left_click(col, row) if press
+      when 64  # ホイールアップ
+        handle_mouse_scroll(:up, col, row)
+      when 65  # ホイールダウン
+        handle_mouse_scroll(:down, col, row)
+      end
+    end
+
+    # マウス左クリックを処理する
+    def handle_mouse_left_click(col, row)
+      left_width = left_panel_col_width
+
+      if col <= left_width
+        # 左パネル（ファイルリスト）クリック
+        handle_mouse_file_click(row)
+      else
+        # 右パネル（プレビュー）クリック — プレビューフォーカスを切り替え
+        if @keybind_handler.preview_focused?
+          @keybind_handler.unfocus_preview_pane
+        else
+          @keybind_handler.focus_preview_pane
+        end
+      end
+    end
+
+    # ファイルリストのクリック行からエントリを選択する（ダブルクリック対応）
+    def handle_mouse_file_click(row)
+      # コンテンツ行はターミナル行2〜(screen_height-1)
+      content_height = @screen_height - 2
+      return unless row >= 2 && row <= @screen_height - 1
+
+      current_idx = @keybind_handler.current_index
+      start_index = [current_idx - content_height / 2, 0].max
+      target_index = start_index + (row - 2)
+
+      entries = @keybind_handler.send(:get_active_entries)
+      return unless target_index >= 0 && target_index < entries.length
+
+      now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      if @last_mouse_click_index == target_index &&
+          @last_mouse_click_time && (now - @last_mouse_click_time) < 0.5
+        # ダブルクリック: Enterキーと同等の動作
+        @keybind_handler.handle_key("\r")
+        @last_mouse_click_index = nil
+        @last_mouse_click_time = nil
+      else
+        # シングルクリック: カーソル移動
+        @keybind_handler.select_index(target_index)
+        @last_mouse_click_index = target_index
+        @last_mouse_click_time = now
+      end
+    end
+
+    # マウスホイールスクロールを処理する
+    def handle_mouse_scroll(direction, col, _row)
+      left_width = left_panel_col_width
+
+      if col > left_width && @keybind_handler.preview_focused?
+        # プレビューペインのスクロール
+        case direction
+        when :up   then @keybind_handler.scroll_preview_up
+        when :down then @keybind_handler.scroll_preview_down
+        end
+      else
+        # ファイルリストのスクロール
+        case direction
+        when :up   then @keybind_handler.handle_key('k')
+        when :down then @keybind_handler.handle_key('j')
+        end
+      end
+    end
+
+    # 左パネルの列幅（1-indexed境界）を返す
+    def left_panel_col_width
+      (@screen_width * @ui_renderer.left_panel_ratio).to_i
+    end
+
     # モード変更を適用
     def apply_mode_change(mode)
       case mode

data/lib/rufio/ui_renderer.rb

@@ -25,7 +25,7 @@ module Rufio
     attr_accessor :keybind_handler, :directory_listing, :file_preview
     attr_accessor :background_executor, :test_mode
     attr_accessor :completion_lamp_message, :completion_lamp_time
-    attr_reader :tab_mode_manager, :highlight_updated
+    attr_reader :tab_mode_manager, :highlight_updated, :left_panel_ratio
 
     def preview_enabled?
       @preview_enabled

data/lib/rufio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rufio
-  VERSION = '0.82.1'
+  VERSION = '0.83.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rufio
 version: !ruby/object:Gem::Version
-  version: 0.82.1
+  version: 0.83.0
 platform: ruby
 authors:
 - masisz
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-07 00:00:00.000000000 Z
+date: 2026-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: io-console
@@ -139,6 +139,7 @@ files:
 - docs/CHANGELOG_v0.8.0.md
 - docs/CHANGELOG_v0.80.0.md
 - docs/CHANGELOG_v0.9.0.md
+- docs/architecture_concurrency_ja_v0.82.1.md
 - examples/bookmarks.yml
 - examples/config.rb
 - examples/script_paths.yml