ruvim 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c463658b0badbad140842446b82818bb797930372d4ccb8ff5e4275fbe627904
-  data.tar.gz: 92b3c9f004f8b075f603d4b8f2e4c48255ac0ef3eea768dd3e290495ab661033
+  metadata.gz: affafdf81175fc15f4d0f0053982743caa863aa371053095bfdd24160aee857d
+  data.tar.gz: 9abd61f0ba641b3f7dc429c4104f2e5d09243ebeb821baa8ad7521c6b4a3eca7
 SHA512:
-  metadata.gz: 46ec215ad18a1e72a62d54e0a95b24d87b7ee5b9093300a4597c8d96754ef4a1ce30f964101e1f2cd3dda8ecefcc74d7565602bb80f0eba6ce28cd2fb835a9ad
-  data.tar.gz: 49827d053ac4b9c827b0cbe86ebb00ff8a6609af4998ef5060a2407d0022f33b47327c11eaef4efc75aca03e0ddc07660a8bf12214db28e8c98f58c83c705b60
+  metadata.gz: 7a5dc6394f0905831d384fb66d88992d20691b58347a2c1673179f0036585f82aa54c6681f8bb79dd9c0e3ffa77389cb5e7a62d7eec27571be0b7f79529a58fb
+  data.tar.gz: 203a49cce3d46575fa743c5635874af2e320ddd225fe973d74a82851b1bfb6112e379e084e1e8afa262c5eac3d596c5c7b23ad572e77f8bf6ed5d2296e9fe992

data/AGENTS.md

@@ -9,6 +9,7 @@ This project is RuVim, a Vim-like editor written in Ruby. Always run the full te
     * catch up changes
     * move completed tasks to done.md
   * update CLAUDE.md Source Tree section if files were added, removed, or renamed
+    * note that CLAUDE.md is a symbolic link to AGENTS.md. Commit AGENTS.md if modify CLAUDE.md
   * commit it
 * After committing, show the commit message
 
@@ -49,21 +50,32 @@ CLI (exe/ruvim) → CLI.parse() → App.new() → App.run_ui_loop()
 | `lang/base.rb` | Default lang module (no-op fallback for indent/dedent) |
 | `lang/markdown.rb` | Markdown parsing, detection helpers, and syntax highlight colors |
 | `lang/ruby.rb` | Ruby syntax highlighting via Prism lexer; auto-indent calculation |
-| `lang/json.rb` | JSON syntax highlighting via regex |
+| `lang/json.rb` | JSON syntax highlighting via regex; auto-indent |
 | `lang/scheme.rb` | Scheme syntax highlighting via regex |
+| `lang/diff.rb` | Diff syntax highlighting (add/delete/hunk/header colors) |
 | `lang/tsv.rb` | TSV detection and RichView renderer registration |
 | `lang/csv.rb` | CSV detection and RichView renderer registration |
+| `git/blame.rb` | Git blame: parser, runner, command handlers |
+| `git/status.rb` | Git status: runner, filename parser, command handlers |
+| `git/diff.rb` | Git diff: runner, command handlers |
+| `git/log.rb` | Git log: runner, command handlers |
+| `git/branch.rb` | Git branch: listing, checkout, command handlers |
+| `git/commit.rb` | Git commit: message buffer, execute, command handlers |
+| `git/handler.rb` | Git module (repo_root), dispatcher, close, shared helpers |
+| `file_watcher.rb` | File change monitoring (inotify with fiddle fallback to polling) |
 | `clipboard.rb` | System clipboard access (xclip, pbpaste, etc.) |
 | `context.rb` | Command handler context (editor, window, buffer, invocation) |
 | `command_invocation.rb` | Single command invocation (id, argv, count, bang) |
 | `rich_view.rb` | Rich view mode (TSV/CSV/Markdown rendering) |
 | `rich_view/table_renderer.rb` | Table formatting with display-width-aware column alignment |
 | `rich_view/markdown_renderer.rb` | Markdown rendering (headings, inline, tables, code blocks, HR) |
+| `rich_view/json_renderer.rb` | JSON pretty-print into virtual buffer |
+| `rich_view/jsonl_renderer.rb` | JSONL per-line pretty-print into virtual buffer |
 
 ### Tests (test/)
 
-- Unit: `buffer_test`, `window_test`, `editor_test`, `screen_test`, `display_width_test`, `text_metrics_test`, `keymap_manager_test`, `highlighter_test`, `dispatcher_test`, `config_*_test`, `indent_test`
-- Integration: `app_scenario_test`, `app_motion_test`, `app_text_object_test`, `app_register_test`, `app_dot_repeat_test`, `app_completion_test`, `app_unicode_behavior_test`, `render_snapshot_test`, `on_save_hook_test`
+- Unit: `buffer_test`, `window_test`, `editor_test`, `screen_test`, `display_width_test`, `text_metrics_test`, `keymap_manager_test`, `highlighter_test`, `dispatcher_test`, `config_*_test`, `indent_test`, `file_watcher_test`, `clipboard_test`, `command_line_test`
+- Integration: `app_scenario_test`, `app_motion_test`, `app_text_object_test`, `app_register_test`, `app_dot_repeat_test`, `app_completion_test`, `app_unicode_behavior_test`, `render_snapshot_test`, `on_save_hook_test`, `follow_test`, `git_blame_test`
 - Helper: `test_helper.rb` (fresh_editor, Minitest)
 
 ### Docs (docs/)
@@ -74,11 +86,11 @@ CLI (exe/ruvim) → CLI.parse() → App.new() → App.run_ui_loop()
 
 lumitrace is a tool that records runtime values of each Ruby expression.
 When a test fails, read `lumitrace help` first, then use it.
-Basic: `lumitrace -t exec rake test`
+Basic: `lumitrace -j exec rake test`
+This also provides coverage information for the test run.
 
 When fixing bugs, do NOT assume the first fix attempt is correct. After applying a fix, re-read the relevant code paths to verify the fix addresses the actual root cause, not a symptom. If the user says 'it hasn't changed' or equivalent, start fresh analysis from the failing behavior.
 
 ## misc
 
-The user communicates in both English and Japanese. Respond in the same language the user uses. When the user gives feedback like 変わってないですよ ('it hasn't changed'), treat it as a bug report requiring re-analysis.
-
+The user communicates in both English and Japanese. Respond in the same language the user uses. When the user gives feedback like 変わってないですよ ('it hasn't changed'), treat it as a bug report requiring re-analysis.

data/README.md

@@ -2,6 +2,20 @@
 
 Ruby で実装した Vim ライクなターミナルエディタです。
 
+Vim の操作感をベースに、Ruby ならではの、もしくは ko1 が欲しい拡張性と独自機能を加えています。
+
+## Vim にない独自機能
+
+- **Rich View (`gr`)** — TSV / CSV / Markdown をテーブル整形して閲覧。CJK 幅を考慮したカラム揃え
+- **`g/` 検索フィルタ** — 検索にマッチする行だけを集めたバッファを作成。再帰的に絞り込み可能。ログ解析に便利
+- **Follow mode (`-f` / `:follow`)** — `tail -f` 相当のファイル追従。inotify 対応
+- Ruby related:
+  - **Ruby DSL 設定** — `~/.config/ruvim/init.rb` に Ruby で `nmap`, `set`, `command` を記述。Vim script 不要
+  - **Ruby 正規表現** — 検索・置換は Ruby `Regexp`。Ruby ユーザーにそのまま馴染む
+  - **`:ruby` eval** — 実行中に任意の Ruby コードを評価。`ctx.editor` / `ctx.buffer` API でエディタを操作
+
+## 概要
+
 - raw mode + ANSI 描画
 - Normal / Insert / Command-line / Visual
 - Ex コマンド（`:w`, `:q`, `:e`, `:help`, `:set` など）
@@ -132,4 +146,4 @@ lint / format 方針（現状）:
 - Vim 完全互換ではありません
 - 正規表現は Vim regex ではなく Ruby `Regexp` を使います
 - 文字幅 / Unicode は改善済みですが、完全互換ではありません
-- 複数ファイル引数や一部 Vim CLI オプションは未実装です
+- 複数ファイル引数や一部 Vim CLI オプションは未実装です

data/docs/binding.md

@@ -30,6 +30,14 @@
 - `/` : 前方検索入力に入る
 - `?` : 後方検索入力に入る
 - `x` : カーソル位置の文字削除
+- `X` : カーソル前の文字削除
+- `s` : カーソル位置の文字を削除して Insert mode（substitute）
+- `~` : カーソル位置の文字の大文字小文字を切替
+- `J` : 現在行と次の行を結合
+- `D` : カーソルから行末まで削除
+- `C` : カーソルから行末まで変更（削除して Insert mode）
+- `S` : 行全体を変更（削除して Insert mode）
+- `Y` : 行全体をヤンク
 - `dd` : 現在行を削除
 - `d` + motion : operator-pending delete（`dw`, `dj`, `dk`, `d$`, `dh`, `dl`）
 - `diw` / `daw` : 単語 text object delete（簡易）
@@ -68,6 +76,9 @@
 - `Ctrl-d` / `Ctrl-u` : 半ページ下/上へ移動（概ね表示高さの半分）
 - `Ctrl-f` / `Ctrl-b` : 1ページ下/上へ移動（`PageDown` / `PageUp` 相当）
 - `Ctrl-e` / `Ctrl-y` : カーソル位置をなるべく保ったまま画面を1行下/上へスクロール（最小実装）
+- `zt` : カーソル行を画面上端に移動
+- `zz` : カーソル行を画面中央に移動
+- `zb` : カーソル行を画面下端に移動
 - `q{reg}` : macro 記録開始/終了（再度 `q` で停止）
 - `@{reg}` / `@@` : macro 再生 / 直前 macro 再生
 - `n` : 直前検索を次へ
@@ -77,6 +88,11 @@
 - `gf` : カーソル下のファイル名を開く（最小。`path` / `suffixesadd` を参照）
   - `file:line` 形式なら開いた後に `line` 行目へ移動
 - `gr` : Rich mode をトグル（TSV/CSV をテーブル整形表示、同一バッファ上で動作）
+- `g/` : 検索パターンにマッチする行だけを集めたフィルタバッファを作成（再帰フィルタ可、Enter で元行へジャンプ、`:q` で戻る）
+- `Ctrl-g` : Git コマンドモード（`:git ` がプリセットされたコマンドラインに入る）
+  - `blame` → Git blame を開く / `status` → Git status / `diff` → Git diff / `log` → Git log
+  - Blame バッファ内: `p` 親コミットの blame へ遷移 / `P` 前の blame へ戻る / `c` コミット詳細を表示
+- `Ctrl-c` : stdin stream 停止（stdin バッファ表示時）
 - `Esc` : メッセージ/保留入力のクリア
 - `Ctrl-z` : shell へ suspend（`fg` で復帰）
 - `矢印キー` : 移動

data/docs/command.md

@@ -3,6 +3,7 @@
 ## 起動オプション（CLI, 現状）
 
 - `--help`, `--version`
+- `-f`（follow mode: ファイルを開いて末尾から `tail -f` 相当の追従モードで起動）
 - `--clean`
 - `-d`（diff mode placeholder, 未実装メッセージ表示）
 - `-q {errorfile}`（quickfix startup placeholder。現状は未実装メッセージ表示）
@@ -114,8 +115,12 @@
   - current window の location list を開く / 閉じる
 - `:lnext` / `:ln`, `:lprev` / `:lp`
   - location list 項目を前後移動して該当位置へジャンプ
+- `:grep /pattern/ [path...]`
+  - 外部 grep（`grepprg`）を実行して quickfix list を作成
+- `:lgrep /pattern/ [path...]`
+  - 外部 grep（`grepprg`）を実行して location list を作成
 - 現状の制限:
-  - `:grep`, `:make`, `:cfile`, `:lgrep` は未実装
+  - `:make`, `:cfile`, `:lfile` は未実装
   - 一覧バッファ上で `Enter` からのジャンプは未実装
 
 ### `:rich`
@@ -129,6 +134,36 @@
 - 列幅は画面に見えている行だけから計算（大規模ファイルでも高速）
 - `Esc` / `Ctrl-C` で Normal mode に戻る
 
+### `:filter`
+
+- 形式: `:filter [/pattern/]`
+- 現在の検索パターン（引数なし）または指定パターンにマッチする行だけを集めたフィルタバッファを作成
+- フィルタバッファ上で再度 `:filter` や `g/` を使うと再帰的に絞り込める
+- Enter で元バッファの該当行へジャンプ（フィルタバッファは閉じる）
+- `:q` でフィルタバッファを閉じて前のバッファに戻る
+- 元バッファの filetype を引き継ぐ（TSV なら `gr` でテーブル表示可能）
+- Normal mode では `g/` キーバインドで実行可能
+
+### `:follow`
+
+- 形式: `:follow`
+- ファイルの follow mode をトグルする（`tail -f` 相当）
+- follow 中はファイルへの追記がリアルタイムにバッファへ反映される
+- カーソルが最終行にいる場合は末尾を自動追従（auto-scroll）
+- カーソルが途中にある場合はスクロール位置を維持
+- `G` で末尾に移動すれば追従が再開される
+- `:follow` を再度実行すると停止
+- `Ctrl-C`（ノーマルモード）で follow を停止
+- ステータスラインに `[follow]` と表示される（inotify 使用時は `[follow/i]`）
+- ファイルが紐づいていないバッファではエラー
+- 未保存の変更があるバッファでは follow 開始不可
+- follow 中のバッファは変更不可（modifiable が false）
+- ファイルが truncate された場合はメッセージを表示し監視を継続
+- ファイルが削除された場合はメッセージを表示し、再作成を待って監視を再開
+- follow 停止時、バッファ内容はそのまま保持（`:e!` で再読み込み可能）
+- 監視方式: Linux では inotify（fiddle 経由）を優先し、使えない場合は polling にフォールバック
+  - polling は exponential backoff（0.1s → 3s）で CPU 負荷を抑える
+
 ### `:command`
 
 - 形式: `:command Name ex_body`
@@ -247,6 +282,16 @@
 - 各タブに含まれるウィンドウとバッファ名を表示
 - 現在のタブ / ウィンドウは `>` マーカーで示す
 
+### `:d` / `:delete`
+
+- 形式: `:d [count]`, `:{range}d`
+- 行を削除
+
+### `:y` / `:yank`
+
+- 形式: `:y [count]`, `:{range}y`
+- 行をヤンク
+
 ## 内部コマンド（主なもの）
 
 内部コマンドは主に key binding から使われ、`RuVim::CommandRegistry` に登録されます。
@@ -302,6 +347,33 @@
 - `editor.buffer_next`
 - `editor.buffer_prev`
 - `buffer.replace_char`
+- `buffer.substitute_char`
+- `buffer.swapcase_char`
+- `buffer.join_lines`
+- `buffer.indent_lines`
+- `buffer.indent_motion`
+- `buffer.visual_indent`
+- `buffer.visual_select_text_object`
+- `mode.visual_block`
+- `cursor.page_up` / `cursor.page_down`
+- `cursor.page_up.default` / `cursor.page_down.default`
+- `cursor.page_up.half` / `cursor.page_down.half`
+- `cursor.match_bracket`
+- `window.scroll_up` / `window.scroll_down`
+- `window.scroll_up.line` / `window.scroll_down.line`
+- `window.cursor_line_top` / `window.cursor_line_center` / `window.cursor_line_bottom`
+- `window.focus_or_split_left` / `window.focus_or_split_right` / `window.focus_or_split_up` / `window.focus_or_split_down`
+- `normal.register_pending_start`
+- `normal.operator_delete_start` / `normal.operator_yank_start` / `normal.operator_change_start` / `normal.operator_indent_start`
+- `normal.replace_pending_start`
+- `normal.find_char_forward_start` / `normal.find_char_backward_start` / `normal.find_till_forward_start` / `normal.find_till_backward_start`
+- `normal.find_repeat` / `normal.find_repeat_reverse`
+- `normal.change_repeat`
+- `normal.macro_record_toggle` / `normal.macro_play_pending_start`
+- `normal.mark_pending_start`
+- `normal.jump_mark_linewise_pending_start` / `normal.jump_mark_exact_pending_start`
+- `quickfix.next` / `quickfix.prev` / `quickfix.open`
+- `stdin.stream_stop`
 - `ui.clear_message`
 - `rich.toggle`
 
@@ -316,12 +388,14 @@
 - `*` / `#` : カーソル下の単語検索（単語境界）
 - `g*` / `g#` : カーソル下の単語検索（部分一致）
 - `:vimgrep` / `:lvimgrep` : 検索結果を quickfix/location list に積む
+- `:nohlsearch` (`:noh`) : 検索ハイライトを一時的にクリア（次の検索で自動復帰）
 
-### `:%s/.../.../g`（最小実装）
+### `:%s/.../.../[flags]`
 
-- バッファ全体置換
+- バッファ全体置換（レンジ指定対応: `:{range}s/.../.../`）
 - Ruby 正規表現 + Ruby 置換文字列を利用
-- `g` フラグ対応（全置換）
+- 対応フラグ: `g`（全置換）, `i`（大文字小文字無視）, `I`（大文字小文字区別）, `n`（置換せずマッチ数表示）, `e`（エラー抑制）
+- `c`（確認）フラグは未実装
 
 ## Operator-pending（Normal mode）
 

data/docs/config.md

@@ -244,11 +244,11 @@ setglobal "tabstop=8"
   - Tab 入力/削除時の編集幅を指定します。
   - 現状は Insert mode の Tab 入力と、`expandtab` 時の空白 Backspace（最小）で使用します。
 
-- `autoindent` (`bool`, default `false`) [`DONE`]
+- `autoindent` (`bool`, default `true`) [`DONE`]
   - 改行時に前行の先頭インデントを引き継ぎます。
   - Insert mode `Enter`、`o`/`O` に反映されます。
 
-- `smartindent` (`bool`, default `false`) [`PARTIAL`]
+- `smartindent` (`bool`, default `true`) [`PARTIAL`]
   - 簡易な自動インデントを行います。
   - 現状は前行が `{` `[` `(` で終わる場合に `shiftwidth` 分の空白を追加します。
 
@@ -265,6 +265,14 @@ setglobal "tabstop=8"
   - ftplugin 読み込み対象、filetype-local keymap、簡易 syntax highlight の判定に使います。
   - 手動で変更した場合の ftplugin 再適用は現状未対応です。
 
+### Global options（検索・grep）
+
+- `grepprg` (`string`, default `"grep -nH"`) [`DONE`]
+  - `:grep` / `:lgrep` が使用する外部コマンドを指定します。
+
+- `grepformat` (`string`, default `"%f:%l:%m"`) [`DONE`]
+  - `:grep` / `:lgrep` の出力パース書式を指定します。
+
 ## 制限（現状）
 
 - Vim の option 全部は未実装（ごく一部のみ）

data/docs/spec.md

@@ -166,7 +166,7 @@ RuVim::ExCommandRegistry.instance.register(
 2. `RuVim::App` が mode ごとに処理を分岐
 3. Normal mode のキーは `RuVim::KeymapManager` で解決
 4. `RuVim::Dispatcher` が内部コマンド or Ex コマンドを実行
-5. Insert mode でキー処理後、stdin に未読データが残っていればレンダリングをスキップして追加のキーを読み取り・処理する（ペースト高速化）
+5. Insert mode でキー処理後、stdin に未読データが残っていればレンダリングをスキップして追加のキーを読み取り・処理する（ペースト高速化）。このバッチ処理中は autoindent を抑制し、貼り付けテキストが余分にインデントされるのを防ぐ
 6. `RuVim::Screen` が再描画
 
 ## 起動オプション（CLI, 現状）
@@ -265,7 +265,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `p`, `P`: paste
 - `r<char>`: 1文字置換
 - `c` + motion / `cc`: change（削除して Insert mode）
-- `=` + motion / `==`: auto-indent（Ruby filetype でインデント自動調整。`=j`, `=G` 等）
+- `=` + motion / `==`: auto-indent（Ruby / JSON filetype でインデント自動調整。`=j`, `=G` 等）
 - `v`: Visual (characterwise)
 - `V`: Visual (linewise)
 - `Ctrl-v`: Visual (blockwise, 最小)
@@ -370,7 +370,13 @@ RuVim::ExCommandRegistry.instance.register(
 - `:vimgrep`, `:lvimgrep`
 - `:copen`, `:cclose`, `:cnext` / `:cn`, `:cprev` / `:cp`
 - `:lopen`, `:lclose`, `:lnext` / `:ln`, `:lprev` / `:lp`
+- `:grep /pattern/ [path...]`, `:lgrep /pattern/ [path...]`
+- `:filter [/pattern/]` : 検索マッチ行のみのフィルタバッファを作成（`g/` キーバインド）
 - `:rich [format]`
+- `:d [count]` / `:delete`
+- `:y [count]` / `:yank`
+- `:tabs`
+- `:args`, `:next`, `:prev`, `:first`, `:last`
 
 ## 検索仕様（現状）
 
@@ -380,7 +386,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `N` : 直前検索を逆方向に繰り返し
 - `*`, `#` : カーソル下の単語を前/後方検索（単語境界つき）
 - `g*`, `g#` : カーソル下の単語を前/後方検索（部分一致）
-- `:%s/pat/repl/g` : バッファ全体 substitute（最小実装）
+- `:{range}s/pat/repl/[flags]` : substitute（フラグ: `g`, `i`, `I`, `n`, `e` 対応。`c` は未実装）
 
 ### 仕様メモ
 
@@ -706,7 +712,7 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 - 描画時に filetype ごとの regex ベース highlighter を適用
 - 現状の対応 filetype:
   - `ruby`
-  - `json`
+  - `json` / `jsonl`
   - `markdown`（見出し・フェンス・HR・ブロック引用・インライン装飾）
 - 優先度（高 -> 低）:
   - cursor / visual
@@ -723,7 +729,10 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
 - **アーキテクチャ**: filetype ごとにレンダラーを登録できる汎用フレームワーク
   - `RuVim::RichView` モジュール（`lib/ruvim/rich_view.rb`）
   - レンダラー登録: `RichView.register(filetype, renderer)`
-  - レンダラー: `TableRenderer`（TSV/CSV）、`MarkdownRenderer`（Markdown）
+  - レンダラー: `TableRenderer`（TSV/CSV）、`MarkdownRenderer`（Markdown）、`JsonRenderer`（JSON）、`JsonlRenderer`（JSONL）
+  - `JsonRenderer` は仮想バッファ方式: ミニファイ JSON を `JSON.pretty_generate` で整形し、読み取り専用バッファに表示
+  - `JsonlRenderer` は仮想バッファ方式: 各行を個別にパース・整形し、`---` セパレータで区切って読み取り専用バッファに表示。パースエラー行はエラーマーカー付きで表示
+  - 仮想バッファ方式のレンダラーでは `Esc` / `C-c` でバッファを閉じて元に戻れる
 - **起動方法**:
   - `:rich [format]` Ex コマンド（トグル）
   - `gr` Normal mode キーバインド（トグル）
@@ -786,6 +795,9 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
   - `nmap`
   - `imap`
   - `map_global`
+  - `set`
+  - `setlocal`
+  - `setglobal`
   - `command`
   - `ex_command`
   - `ex_command_call`
@@ -795,6 +807,47 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
 - XDG 設定ファイル（`init.rb`）は Ruby として評価されるため、信頼できる内容のみ使用する
 - 直接内部状態に触る代わりに、まずは DSL API を通す設計
 
+## Git 連携
+
+### Git Blame
+
+`<C-g>` で `:git ` プリセットのコマンドラインモードに入る。`:git <subcommand>` で実行。
+
+### GitStatus
+
+`:git status` で `git status` の結果を `kind: :git_status` の読み取り専用バッファで表示。
+
+### GitDiff
+
+`:git diff` で `git diff` の結果を `kind: :git_diff` の読み取り専用バッファで表示（filetype: diff）。追加引数をそのまま渡せる（例: `:git diff --cached`）。差分がない場合はメッセージ表示のみ。Enter で差分行に対応するファイルの該当行にジャンプ。`:git log -p` バッファでも同様に動作する。
+
+### GitLog
+
+`:git log` で `git log` の結果を `kind: :git_log` の読み取り専用バッファで表示。追加引数をそのまま渡せる（例: `:git log -p`）。`-p` 指定時は filetype: diff で syntax highlight が効く。出力はストリーミングで逐次表示（カーソルは先頭行に固定）。バッファを閉じるとプロセスも停止する。
+
+### GitBranch
+
+`:git branch` で `git branch -a` の結果を `kind: :git_branch` の読み取り専用バッファで表示。コミット日時の新しい順にソート。各行にブランチ名、日付、最新コミットのサブジェクトを表示。Enter でカーソル行のブランチをチェックアウト。
+
+### GitCommit
+
+`:git commit` でコミットメッセージ編集バッファ（`kind: :git_commit`）を開く。`#` で始まる行はコメント（git status 情報を表示）。insert モードで開始。`:w` または `:wq` でコミット実行。`:q!` でキャンセル。メッセージが空の場合はコミットを中止。
+
+### GitBlame
+
+- **Blame バッファ**: `kind: :blame`、readonly、modifiable=false
+- 表示形式: `短縮ハッシュ 著者名 日付 コード行`
+- 内部で `git blame --porcelain` を使用して構造化パース
+- ソースファイルのカーソル行位置を引き継ぐ
+
+Blame バッファ内のバッファローカルバインディング:
+
+- `p` (GitBlamePrev): カーソル行のコミット C に対し `git blame C^` の結果に更新。履歴スタックに現在の状態を push
+- `P` (GitBlameBack): 履歴スタックから pop して前の blame 状態に復元
+- `c` (GitBlameCommit): カーソル行のコミットの `git show` 結果を `kind: :git_show` の読み取り専用バッファで表示（filetype: diff）
+
+実装: `lib/ruvim/git/blame.rb`（blame パース・実行）、`lib/ruvim/git/commands.rb`（status/diff/log 実行）、`lib/ruvim/global_commands.rb`（コマンドハンドラ）
+
 ## テスト（現状）
 
 - `Minitest` を利用
@@ -807,10 +860,8 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
 
 - 永続 undo（`undofile` / `undodir` 相当）
 - session 保存/復元（`-S` / `:mksession` 相当の実体）
-- `:grep` / `:make` / `:cfile` / `:lgrep` / `:lfile` など quickfix 入口
-- Ex range/address（`:1,10d`, `:.,$s/.../.../` など）
-- `:substitute` フラグ拡張（`c`, `i`, `I`, `n`, `e` など）
-- arglist（複数ファイル起動 + `:args`, `:next`, `:prev` 等）
+- `:make` / `:cfile` / `:lfile` など quickfix 入口（`:grep` / `:lgrep` は実装済み）
+- `:substitute` の `c`（confirm）フラグ（`g`, `i`, `I`, `n`, `e` は実装済み）
 - `Ctrl-w` resize / close-others / equalize など window 操作拡張
 - `:set` 高度構文（`+=`, `-=`, `:set all`, 短縮名）
 - tag jump / folds / `:global` / `:normal`

data/docs/tutorial.md

@@ -28,6 +28,7 @@ ruvim path/to/file.txt
 - `-R`（readonly で開く。現在バッファの `:w` を拒否）
 - `-M`（modifiable off 相当。編集操作を拒否し、あわせて readonly）
 - `-Z`（restricted mode。config/ftplugin を読まず、`:ruby` と `:!` を無効化）
+- `-f`（follow mode: `tail -f` 相当。ファイルの追記をリアルタイムに追従）
 - `-n`（現状 no-op。将来の swap/永続機能向け互換フラグ）
 - `-o[N]` / `-O[N]` / `-p[N]`（複数ファイルを split / vsplit / tab で開く）
 - `-V[N]` / `--verbose[=N]`（起動/設定/Ex のログを stderr に出す）
@@ -140,11 +141,33 @@ ruvim -p a.rb b.rb
 - `:tabnew [path]`
 - `:tabnext` / `:tabn`
 - `:tabprev` / `:tabp`
+- `:follow`（`tail -f` 相当の追従モードをトグル）
 - `:vimgrep /foo/`
 - `:copen`, `:cnext`, `:cprev`, `:cclose`
 - `:lvimgrep /foo/`
 - `:lopen`, `:lnext`, `:lprev`, `:lclose`
 
+## Follow mode（`tail -f` 相当）
+
+ファイルへの追記をリアルタイムにバッファへ反映する追従モードです。
+
+```bash
+ruvim -f /var/log/syslog        # 起動時から follow mode
+ruvim -f log1.txt log2.txt      # 複数ファイルすべて follow
+```
+
+起動後に切り替えることもできます:
+
+```vim
+:follow          " follow 開始（トグル）
+:follow          " もう一度で停止
+```
+
+- `Ctrl-C`（ノーマルモード）でも停止できます
+- カーソルが最終行（`G`）にいると末尾を自動追従、途中にいればスクロール位置を維持
+- follow 中はバッファ変更不可（停止後に編集可能）
+- ファイルが truncate/削除された場合はメッセージを表示し、監視を継続（削除時は再作成を待機）
+
 ## Undo / Redo
 
 - `u`: 直前の変更を取り消す
@@ -238,6 +261,7 @@ register prefix を付けると register を指定できます。
 - `:set ignorecase` / `:set noignorecase` : 検索の大文字小文字を無視（global）
 - `:set smartcase` / `:set nosmartcase` : `ignorecase` 有効時に大文字を含む検索を大文字小文字区別にする（global）
 - `:set hlsearch` / `:set nohlsearch` : 検索ハイライトの ON/OFF（global）
+- `:nohlsearch` (`:noh`) : 検索ハイライトを一時的にクリア（次の検索で自動復帰）
 - `:set tabstop=4` : tab 幅設定（既定スコープは buffer-local）
 - `:setlocal number` : 現在 window のみ変更
 - `:setglobal tabstop=8` : global 値を変更

data/docs/vim_diff.md

@@ -7,7 +7,7 @@ RuVim は「Vim ライクな Ruby 製ターミナルエディタ」です。Vim
 ### Ruby ネイティブな拡張性
 
 - 設定ファイルは Ruby DSL（`~/.config/ruvim/init.rb`）
-  - `nmap`, `imap`, `map_global`, `command`, `ex_command`, `ex_command_call`
+  - `nmap`, `imap`, `map_global`, `set`, `setlocal`, `setglobal`, `command`, `ex_command`, `ex_command_call`
   - Vim script 不要で Ruby の全機能を利用可能
 - `:ruby` / `:rb` で実行中に Ruby eval が可能（Vim の `:ruby` とは別物）
 - plugin 向け `ctx.editor / ctx.buffer / ctx.window` API
@@ -26,6 +26,13 @@ RuVim は「Vim ライクな Ruby 製ターミナルエディタ」です。Vim
 - TSV / CSV / Markdown をフォーマットして閲覧できる構造化データ表示モード
 - CJK 文字幅を考慮したカラム整列
 
+### Follow mode（`tail -f` 相当）
+
+- `:follow` コマンドまたは `-f` CLI フラグでファイル追従モード
+- Linux では inotify（fiddle 経由）を優先、使えない場合は polling（exponential backoff）にフォールバック
+- ファイルの truncation/deletion を検知してメッセージ表示・自動復帰
+- Vim にはない RuVim 独自機能
+
 ### 検索は Ruby 正規表現
 
 - `/`, `?`, `:s` はすべて Ruby の `Regexp` を使用
@@ -53,10 +60,12 @@ RuVim は「Vim ライクな Ruby 製ターミナルエディタ」です。Vim
 
 ### Ex コマンド
 
-- `:w`, `:q`, `:wq`, `:e`, `:buffer`, `:bnext`, `:bprev`, `:ls`, `:split`, `:vsplit`
+- `:w`, `:q`, `:wq`, `:e`, `:buffer`, `:bnext`, `:bprev`, `:bdelete`, `:ls`, `:split`, `:vsplit`
 - `:qa`, `:qa!`, `:wqa`
-- quickfix / location list: `:vimgrep`, `:lvimgrep`, `:copen`, `:cnext`, `:lopen`, `:lnext`
-- tabpage: `:tabnew`, `:tabnext`, `:tabprev`
+- quickfix / location list: `:vimgrep`, `:lvimgrep`, `:grep`, `:lgrep`, `:copen`, `:cnext`, `:lopen`, `:lnext`
+- tabpage: `:tabnew`, `:tabnext`, `:tabprev`, `:tabs`
+- arglist: `:args`, `:next`, `:prev`, `:first`, `:last`
+- 行操作: `:d` / `:delete`, `:y` / `:yank`
 
 ### option system
 
@@ -65,14 +74,15 @@ RuVim は「Vim ライクな Ruby 製ターミナルエディタ」です。Vim
 - インデント: `shiftwidth`, `softtabstop`, `expandtab`, `autoindent`, `smartindent`, `tabstop`
 - 検索: `ignorecase`, `smartcase`, `hlsearch`, `incsearch`
 - 分割: `splitbelow`, `splitright`
-- その他: `hidden`, `autowrite`, `clipboard`, `timeoutlen`, `ttimeoutlen`, `backspace`, `whichwrap`, `iskeyword`, `filetype`, `path`, `suffixesadd`, `grepprg`, `grepformat`, 補完系（`completeopt`, `pumheight`, `wildmode`, `wildmenu`, `wildignore`, `wildignorecase`）
+- grep: `grepprg`, `grepformat`
+- その他: `hidden`, `autowrite`, `clipboard`, `timeoutlen`, `ttimeoutlen`, `backspace`, `whichwrap`, `iskeyword`, `filetype`, `path`, `suffixesadd`, 補完系（`completeopt`, `pumheight`, `wildmode`, `wildmenu`, `wildignore`, `wildignorecase`）
 
 ### その他
 
 - filetype 検出（拡張子 + shebang）/ ftplugin
 - syntax highlight: Ruby（Prism lexer）, JSON, Markdown, Scheme, TSV/CSV
 - 補完: Ex コマンド名 + 引数補完, Insert mode buffer words（`Ctrl-n` / `Ctrl-p`）
-- CLI: `--help`, `--version`, `--clean`, `-u`, `-R`, `-M`, `-Z`, `-o/-O/-p`, `-c`, `+{cmd}`, `-V`, `--startuptime`, `--cmd`
+- CLI: `--help`, `--version`, `--clean`, `-u`, `-R`, `-M`, `-Z`, `-f`, `-o/-O/-p`, `-c`, `+{cmd}`, `-V`, `--startuptime`, `--cmd`
 
 ## 動作の微細な差分
 
@@ -96,7 +106,7 @@ RuVim は「Vim ライクな Ruby 製ターミナルエディタ」です。Vim
 - folds
 - LSP / diagnostics
 - job / channel / terminal 連携
-- `:grep`, `:make`, `:cfile`, `:lgrep`
-- substitute の高度なフラグ群（現状は `:%s/.../.../g` のみ）
+- `:make`, `:cfile`, `:lfile`（`:grep`, `:lgrep` は実装済み）
+- substitute の `c`（confirm）フラグ（`g`, `i`, `I`, `n`, `e` は実装済み）
 - swap / backup / undofile（永続 undo）
 - `-d`（diff mode）, `-q`（quickfix mode）, `-S`（session）は placeholder のみ