ruvim 0.3.0 → 0.6.0

data/docs/spec.md

@@ -93,8 +93,8 @@ RuVim は Vim と同様に、用途ごとに座標系を分けています。
 - tabpages 管理（タブごとに layout tree / current window を保持）
 - current window の管理
 - mode 管理（`:normal`, `:insert`, `:command_line`, `:rich`）
-- ステータスメッセージ
-- コマンドライン状態
+- message line のメッセージ管理
+- command-line 状態
 
 ## コマンドモデル
 
@@ -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, 現状）
@@ -192,6 +192,9 @@ RuVim::ExCommandRegistry.instance.register(
   - user config / ftplugin を読み込まない
   - `:ruby` / `:rb` を禁止する
   - `:!` を禁止する
+  - `:grep` / `:lgrep` を禁止する
+  - `:git` / `:gh` を禁止する
+  - Ruby 構文チェック（`on_save`）を無効化する
 - `-n`
   - 現状は no-op（将来の swap / 永続 undo / session 互換の先行予約）
 - `-o[N]`, `-O[N]`, `-p[N]`
@@ -216,7 +219,7 @@ RuVim::ExCommandRegistry.instance.register(
 
 - `stdin` が non-TTY で、起動引数ファイルがない場合は `stdin` を follow stream として開く
   - バッファ名は `[stdin]`
-  - status line に `[stdin/live]`, `[stdin/closed]`, `[stdin/error]` を表示
+  - statusline に `[stdin]`（完了時 `[stdin/EOF]`、失敗時 `[stdin/error]`）を表示
   - Normal mode の `Ctrl-c` はデフォルトバインドで `stdin` stream stop（上流 PID へ直接 signal は送らない）
 - `Ctrl-z` は全モード共通で suspend
   - suspend 前に terminal を cooked + main screen に戻す
@@ -265,7 +268,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, 最小)
@@ -309,7 +312,7 @@ RuVim::ExCommandRegistry.instance.register(
 - Normal mode とほぼ同じキーバインドが使える（移動・検索・yank 等）
 - バッファを変更する操作（insert/delete/change/paste/replace）はブロック
 - `Esc` / `Ctrl-C` で Normal mode に戻る
-- ステータスラインに `-- RICH --` を表示
+- statusline に `-- RICH --` を表示
 - 描画時に表示行をテーブル整形（`TableRenderer` を利用）
 - wrap は強制 OFF
 
@@ -332,7 +335,7 @@ RuVim::ExCommandRegistry.instance.register(
 
 - 画面下部にメッセージ行をオーバーレイ描画
 - 最下行に「Press ENTER or type command to continue」を反転表示
-- ステータスラインは非表示（Vim と同様）
+- statusline は非表示（Vim と同様）
 - 対象コマンド: `:ls` / `:buffers`, `:args`, `:set`（引数なし）, `:command`（引数なし）
 - 1行以下の出力時は通常の `echo` を使用
 
@@ -370,7 +373,18 @@ RuVim::ExCommandRegistry.instance.register(
 - `:vimgrep`, `:lvimgrep`
 - `:copen`, `:cclose`, `:cnext` / `:cn`, `:cprev` / `:cp`
 - `:lopen`, `:lclose`, `:lnext` / `:ln`, `:lprev` / `:lp`
+- `:grep /pattern/ [path...]`, `:lgrep /pattern/ [path...]`
+  - `grepprg` を argv 配列として実行（シェル経由ではない）
+  - ファイル引数の glob パターンは Ruby 側で展開
+  - restricted mode（`-Z`）では禁止
+- `:git checkout <branch>` でブランチ切り替え
+  - ブランチ一覧（`:git branch`）で Enter を押すとコマンドラインにプリフィル、明示的に Enter で確定
+- `:filter [/pattern/]` : 検索マッチ行のみのフィルタバッファを作成（`g/` キーバインド）
 - `:rich [format]`
+- `:d [count]` / `:delete`
+- `:y [count]` / `:yank`
+- `:tabs`
+- `:args`, `:next`, `:prev`, `:first`, `:last`
 
 ## 検索仕様（現状）
 
@@ -380,7 +394,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` は未実装）
 
 ### 仕様メモ
 
@@ -404,11 +418,12 @@ RuVim::ExCommandRegistry.instance.register(
 - `:bindings` は current buffer 文脈の有効 key binding を layer 別（`buffer`, `filetype`, `app`）に一覧表示
   - 任意で mode filter を受ける（例 `:bindings normal`）
 - 大きいファイルを開くときは、閾値以上で段階読み込みになる場合がある
-  - status line に `[load/live]`（失敗時 `[load/error]`）
-  - デフォルト実装は先頭 `8MB` を先に表示し、残りをバックグラウンド読み込み後に反映
+  - statusline に `[load]`（失敗時 `[load/error]`）
+  - デフォルト実装は先頭 `8MB` を先に表示し、残りをチャンク単位でバックグラウンド読み込み
   - 環境変数:
     - `RUVIM_ASYNC_FILE_THRESHOLD_BYTES`
     - `RUVIM_ASYNC_FILE_PREFIX_BYTES`
+- ファイルを開く際、FIFO・デバイス・ソケット等の特殊ファイルは拒否する（`File.file?` チェック）
 
 ### `:command`（現状仕様）
 
@@ -427,13 +442,26 @@ RuVim::ExCommandRegistry.instance.register(
   - `buffer`
   - `window`
 - `stdout` / `stderr` に出力があれば `[Ruby Output]` 仮想バッファに表示（返り値も表示）
-- 出力がない場合、返り値をステータスラインに表示（`inspect`）
+- 出力がない場合、返り値を message line に表示（`inspect`）
+
+### `:r` / `:read`（ファイル・コマンド出力の挿入）
+
+- `:r <file>` でファイルの内容をカーソル行の下に挿入
+- `:r !<command>` でシェルコマンドの stdout を挿入
+- 行番号指定可: `:3r file.txt`（3行目の下に挿入）
+- stderr が出た場合、最初の行をエラーメッセージとして表示
+
+### `:w !`（バッファ内容をコマンドへパイプ）
+
+- `:w !<command>` でバッファ全体をシェルコマンドの stdin に渡す
+- 範囲指定可: `:'<,'>w !sort`（選択範囲のみ渡す）
 
 ### `:!`（shell 実行, 最小）
 
 - `:!<command>` で shell コマンドを同期実行
-- `stdout` / `stderr` があれば `[Shell Output]` 仮想バッファに表示（終了ステータスを含む）
-- 出力がない場合は `shell exit N` をステータス表示
+- alternate screen を一時的に抜けて main screen 上でコマンドを実行（Vim 互換）
+- 実行後 "Press ENTER or type command to continue" を表示し、入力待ち後にエディタに復帰
+- 完了後は `shell exit N` をステータス表示
 - restricted mode（`-Z`）では禁止
 
 ### バッファ管理 Ex コマンド（現状仕様）
@@ -471,11 +499,15 @@ ANSI エスケープシーケンスによる再描画です。
 - カーソル非表示/表示 (`?25l / ?25h`)
 - 行キャッシュによる簡易差分描画（同サイズ時）
 - フッターは 2 行固定:
-  - 最下段: command line / error message 用
-  - 1つ上: status line
-- Command-line mode 時も status line は維持し、最下段だけを入力行として使う
+  - 最下段: 用途に応じて command-line（`:` `/` `?` 入力時）または message line（メッセージ表示時）として使用。複数行メッセージ時は hit-enter prompt で表示
+  - 1つ上: statusline（モード・ファイル名・カーソル位置）
+- command-line mode 時も statusline は維持し、最下段だけを入力行として使う
 - ファイル未指定起動時は Vim 風 intro screen を表示（RuVim では intro 用の read-only 特殊バッファ）
 - カーソル位置の文字を反転表示（見やすさ向上）
+- カーソル形状の制御（DECSCUSR）
+  - Normal / Visual mode: ターミナルカーソルを非表示にし、セル描画（反転）でカーソルを表現
+  - Insert / Command-line mode: ターミナルのバーカーソル（`\e[6 q`）を表示
+  - UI 開始時に非点滅ブロック（`\e[2 q`）を設定、終了時にデフォルト（`\e[0 q`）に復元
 
 ### split UI
 
@@ -494,7 +526,7 @@ ANSI エスケープシーケンスによる再描画です。
 - `:tabnew [path]` で新しいタブを作成
 - `:tabnext`, `:tabprev` で移動
 - `:tabs` で全タブ一覧を表示（各タブのウィンドウとバッファ名）
-- ステータスラインに `tab:n/m` を表示（タブが2つ以上のとき）
+- statusline に `tab:n/m` を表示（タブが2つ以上のとき）
 - 各タブは以下を独立に保持
   - window list（表示中 window 群）
   - current window
@@ -705,9 +737,30 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 
 - 描画時に filetype ごとの regex ベース highlighter を適用
 - 現状の対応 filetype:
-  - `ruby`
-  - `json`
+  - `ruby`（Prism lexer ベース。スマートインデント・保存時 ruby -wc チェック）
+  - `json` / `jsonl`（キー・値・真偽値・数値。スマートインデント）
   - `markdown`（見出し・フェンス・HR・ブロック引用・インライン装飾）
+  - `scheme`（キーワード・文字列・数値・真偽値・文字リテラル・コメント）
+  - `diff`（追加/削除/ハンク/ヘッダ/メタの行単位カラー）
+  - `c`（キーワード・型名・文字列・数値・コメント・プリプロセッサ・定数マクロ。スマートインデント・保存時 gcc チェック）
+  - `cpp`（C 拡張: `class`, `namespace`, `template`, `auto`, `nullptr` 等。アクセス指定子インデント・保存時 g++ チェック）
+  - `yaml`（キー・文字列・真偽値・アンカー・タグ・ブロックスカラー・コメント。インデント）
+  - `sh`（キーワード・変数・文字列・数値・コメント。インデント）
+  - `python`（キーワード・組み込み関数・デコレータ・文字列・数値・定数・コメント。インデント）
+  - `javascript` / `javascriptreact`（キーワード・テンプレートリテラル・文字列・数値・定数・コメント。インデント）
+  - `typescript` / `typescriptreact`（JS 拡張: `interface`, `type`, `enum`, `readonly` 等。インデント）
+  - `html`（タグ・属性・文字列・エンティティ・DOCTYPE・コメント）
+  - `toml`（テーブルヘッダ・キー・文字列・真偽値・日時・数値・コメント）
+  - `go`（キーワード・型名・文字列・raw 文字列・数値・定数・コメント。インデント）
+  - `rust`（キーワード・ライフタイム・マクロ・属性・文字列・数値・定数・コメント。インデント）
+  - `make`（ターゲット・変数定義・変数参照・ディレクティブ・関数・自動変数・コメント）
+  - `dockerfile`（命令キーワード・フラグ・変数・文字列・コメント）
+  - `sql`（キーワード（大文字小文字不問）・文字列・数値・パラメータ・コメント）
+  - `elixir`（キーワード・アトム・モジュール・属性・シジル・文字列・数値・コメント。インデント）
+  - `perl`（キーワード・スカラー/配列/ハッシュ変数・文字列・数値・POD・コメント。インデント）
+  - `lua`（キーワード・組み込み関数・長文字列・文字列・数値・コメント。インデント）
+  - `ocaml`（キーワード・型変数・モジュール名・文字列・数値・ブロックコメント。インデント）
+  - `erb`（HTML ベース + ERB デリミタ・ERB コメント）
 - 優先度（高 -> 低）:
   - cursor / visual
   - search highlight
@@ -723,7 +776,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 キーバインド（トグル）
@@ -733,13 +789,14 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
   - Normal mode とほぼ同じキーバインドが使える（移動・検索・yank 等）
   - バッファを変更する操作（insert/delete/change/paste/replace）はブロック
   - `Esc` / `Ctrl-C` で Normal mode に戻る
-  - ステータスラインに `-- RICH --` を表示
+  - statusline に `-- RICH --` を表示
   - wrap は強制 OFF
 - **レンダリング**:
   - `Screen` の `plain_window_render_rows` で `editor.rich_mode?` を判定
   - Rich mode の場合、表示行だけを `RichView.render_visible_lines` で整形
   - バッファ内容は変更せず、描画パイプラインでの変換のみ
   - `render_rich_view_line_sc` は ANSI エスケープシーケンスを幅ゼロとして扱い、横スクロール時もスタイルを正しく維持
+  - Rich view に渡す前にバッファ行の制御文字（ESC 含む）をサニタイズし、terminal escape injection を防止
 - **横スクロール**:
   - 表示カラム（display column）ベースでスクロール量を管理（`@rich_col_offset_sc`）
   - `renderer.cursor_display_col` で raw バッファの `cursor_x` を整形後の表示カラムに変換し、スクロールオフセットを決定
@@ -786,6 +843,9 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
   - `nmap`
   - `imap`
   - `map_global`
+  - `set`
+  - `setlocal`
+  - `setglobal`
   - `command`
   - `ex_command`
   - `ex_command_call`
@@ -795,6 +855,85 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
 - XDG 設定ファイル（`init.rb`）は Ruby として評価されるため、信頼できる内容のみ使用する
 - 直接内部状態に触る代わりに、まずは DSL API を通す設計
 
+## Git 連携
+
+### Git Blame
+
+`<C-g>` で `:git ` プリセットのコマンドラインモードに入る。`:git <subcommand>` で実行。
+未知のサブコマンドは `:!` と同様に alternate screen を抜けてシェルで直接実行する（例: `:git stash`）。`:gh` も同様（例: `:gh issue list`）。
+
+### 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 でカーソル行のブランチ名を `:git checkout <branch>` としてコマンドラインにプリフィル（確認ステップあり、即時実行ではない）。
+
+### GitGrep
+
+`:git grep <pattern> [<args>...]` で `git grep -n` を実行し、結果を `kind: :git_grep` の読み取り専用バッファで表示。追加引数をそのまま渡せる（例: `:git grep -i pattern`）。マッチがない場合はメッセージ表示のみ。Enter で該当ファイルの該当行にジャンプ。Esc / Ctrl-C でバッファを閉じる。
+
+### GitCommit
+
+`:git commit` でコミットメッセージ編集バッファ（`kind: :git_commit`）を開く。`#` で始まる行はコメント（git status 情報を表示）。insert モードで開始。`:w` または `:wq` でコミット実行。`:q!` でキャンセル。メッセージが空の場合はコミットを中止。
+
+### GitBlame
+
+- **Blame バッファ**: `kind: :blame`、readonly、modifiable=false
+- 表示形式: ガター（行番号エリア）にメタ情報（短縮ハッシュ・著者名・日付）を暗灰色で表示、本文はコードのみで元ファイルの filetype に基づく syntax highlight が適用される
+- `gutter_labels` オプション: バッファに行ごとのガターラベルを設定する汎用機能。設定されると行番号の代わりにラベルを表示
+- 内部で `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`（コマンドハンドラ）
+
+## GitHub 連携
+
+### gh link
+
+`:gh link` で現在のファイル・カーソル行の GitHub URL を生成し、message line に表示する。同時に OSC 52 エスケープシーケンスでクリップボードにコピーする。
+
+- ビジュアル選択範囲（`:'<,'>gh link`）を指定すると `#L5-L10` 形式の行範囲リンクを生成
+- GitHub リモートを自動検出（全リモートを走査し、`origin` → `upstream` → その他の優先順位）
+- SSH / HTTPS 両対応
+- `:gh link <remote>` でリモート名を明示指定可能
+- 現在のブランチ名を使用
+- ファイルがリモートと異なる場合、URL の後に `(remote may differ)` を注記
+- GitHub リモートが見つからない場合はエラー
+
+### gh browse
+
+`:gh browse` で現在のファイル・カーソル行の GitHub URL をブラウザで開く。
+
+- `:gh link` と同じ URL 解決ロジック（行範囲、リモート自動検出、リモート指定）
+- ブラウザ起動は `Browser` モジュールを使用（macOS: `open`, Linux: `xdg-open`, WSL: `wslview` / PowerShell）
+- 開いた URL を message line に表示
+- ファイルがリモートと異なる場合、`(remote may differ)` を注記
+
+### gh pr
+
+`:gh pr` で現在のブランチの PR ページをブラウザで開く。
+
+- `https://github.com/user/repo/pulls?q=head:<branch>` を生成して開く
+- ファイルパスがなくても動作（カレントディレクトリから git リポジトリを検出）
+
+実装: `lib/ruvim/gh/link.rb`, `lib/ruvim/browser.rb`
+
 ## テスト（現状）
 
 - `Minitest` を利用
@@ -807,10 +946,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/todo.md

@@ -229,6 +229,15 @@
 - `spelllang`（スペルチェック言語）
 - `[PARTIAL]` `termguicolors`（検索/`cursorline`/`colorcolumn` 背景色の最小 truecolor 対応）
 
+## 大きいファイルの非同期ロード
+
+- `-c` で渡したコマンドが非同期ロード中の不完全なバッファに対して実行される
+  - startup actions をロード完了後に遅延実行するコールバックを `finish_async_file_load!` に追加する
+  - ユーザーの対話操作は制限しない（`-c` 起動コマンドのみ遅延）
+- 非同期ロードの性能改善（現状は同期パスの約3倍遅い）
+  - `Array<String>` ベースのバッファ構造が根本原因（split + GC 負荷）
+  - rope / lazy split 等のデータ構造変更が必要（大きな変更）
+
 ## メモ（実装方針）
 
 - Vim 完全互換の CLI を目指すより、よく使うフラグから互換寄りに実装する

data/docs/tutorial.md

@@ -27,7 +27,8 @@ ruvim path/to/file.txt
 - `-S Session.vim`（session startup placeholder。現状は未実装メッセージのみ）
 - `-R`（readonly で開く。現在バッファの `:w` を拒否）
 - `-M`（modifiable off 相当。編集操作を拒否し、あわせて readonly）
-- `-Z`（restricted mode。config/ftplugin を読まず、`:ruby` と `:!` を無効化）
+- `-Z`（restricted mode。config/ftplugin を読まず、`:ruby`、`:!`、`:grep`、`:lgrep`、`:git`、`:gh` を無効化）
+- `-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,10 +141,40 @@ 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`
+- `:grep pattern [files...]`（外部 grep → quickfix）
+- `:lgrep pattern [files...]`（外部 grep → location list）
+- `:git blame` / `:git status` / `:git diff` / `:git log` / `:git branch` / `:git commit` / `:git grep`
+- `:gh link` / `:gh browse` / `:gh pr`
+- `:r file.txt`（ファイルの内容をカーソル行の下に挿入）
+- `:r !ls`（コマンドの出力をカーソル行の下に挿入）
+- `:w !wc -l`（バッファの内容をコマンドの stdin にパイプ）
+- `:!ls`（alternate screen でシェルコマンドを実行）
+
+## 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
 
@@ -238,6 +269,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,28 @@ 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`
+
+## セキュリティ / Restricted mode (`-Z`)
+
+- Vim と同様に `-Z` で restricted mode を有効化
+- RuVim では以下のコマンドが無効化される:
+  - `:!`（シェル実行）
+  - `:ruby` / `:rb`（Ruby eval）
+  - `:grep` / `:lgrep`（外部 grep 実行）
+  - `:git`（Git 操作全般）
+  - `:gh`（GitHub 操作全般）
+- `:grep` / `:lgrep` はシェル経由ではなく argv 配列で安全に実行（シェルインジェクション対策済み）
+- Rich view レンダリング時にバッファ内容の制御文字を無害化（ターミナルエスケープインジェクション対策）
+- 特殊ファイル（FIFO/デバイス/ソケット）の読み込みを拒否（DoS 対策）
 
 ## 動作の微細な差分
 
@@ -96,7 +119,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 のみ

data/ext/ruvim/extconf.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require "mkmf"
+
+create_makefile("ruvim/ruvim_ext")