ruvim 0.2.0 → 0.4.0

data/docs/spec.md

@@ -89,10 +89,10 @@ RuVim は Vim と同様に、用途ごとに座標系を分けています。
 エディタ全体の実行状態です。
 
 - buffers / windows 管理
-- window order / split layout（`single` / `horizontal` / `vertical`）
-- tabpages 管理（タブごとに window set / current window / layout を保持）
+- layout tree（ネストしたウィンドウ分割をツリーで管理）
+- tabpages 管理（タブごとに layout tree / current window を保持）
 - current window の管理
-- mode 管理（`:normal`, `:insert`, `:command_line`）
+- mode 管理（`:normal`, `:insert`, `:command_line`, `:rich`）
 - ステータスメッセージ
 - コマンドライン状態
 
@@ -166,7 +166,8 @@ RuVim::ExCommandRegistry.instance.register(
 2. `RuVim::App` が mode ごとに処理を分岐
 3. Normal mode のキーは `RuVim::KeymapManager` で解決
 4. `RuVim::Dispatcher` が内部コマンド or Ex コマンドを実行
-5. `RuVim::Screen` が再描画
+5. Insert mode でキー処理後、stdin に未読データが残っていればレンダリングをスキップして追加のキーを読み取り・処理する（ペースト高速化）。このバッチ処理中は autoindent を抑制し、貼り付けテキストが余分にインデントされるのを防ぐ
+6. `RuVim::Screen` が再描画
 
 ## 起動オプション（CLI, 現状）
 
@@ -211,6 +212,17 @@ RuVim::ExCommandRegistry.instance.register(
 - `+{cmd}`, `+{line}`, `+`
   - 起動後の Ex 実行 / 行ジャンプ / 最終行ジャンプ
 
+補足（現状実装）:
+
+- `stdin` が non-TTY で、起動引数ファイルがない場合は `stdin` を follow stream として開く
+  - バッファ名は `[stdin]`
+  - status line に `[stdin/live]`, `[stdin/closed]`, `[stdin/error]` を表示
+  - Normal mode の `Ctrl-c` はデフォルトバインドで `stdin` stream stop（上流 PID へ直接 signal は送らない）
+- `Ctrl-z` は全モード共通で suspend
+  - suspend 前に terminal を cooked + main screen に戻す
+  - `SIGTSTP` を自身に送って停止
+  - `fg` 復帰後に raw + alt screen を再有効化して再描画
+
 起動時コマンド（`-c`, `+...`）は、初期 buffer / file open / intro screen 構築の後に実行します。
 `--cmd` はそれより前で、user config 読み込み前に実行します。
 
@@ -253,6 +265,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `p`, `P`: paste
 - `r<char>`: 1文字置換
 - `c` + motion / `cc`: change（削除して Insert mode）
+- `=` + motion / `==`: auto-indent（Ruby / JSON filetype でインデント自動調整。`=j`, `=G` 等）
 - `v`: Visual (characterwise)
 - `V`: Visual (linewise)
 - `Ctrl-v`: Visual (blockwise, 最小)
@@ -263,6 +276,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `N`: 直前検索を逆方向に繰り返し
 - `1..9` + 動作: count（例: `3j`, `2x`）
 - 矢印キー: 移動
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 
 ### Insert mode
 
@@ -273,6 +287,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `Esc`: Normal mode に戻る
 - `Ctrl-c`: Normal mode に戻る（終了しない）
 - 矢印キー: 移動
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 
 ### Visual mode（現状）
 
@@ -284,8 +299,20 @@ RuVim::ExCommandRegistry.instance.register(
 - `d`: 選択範囲を delete
 - `i`/`a` + object: text object を選択（`iw`, `aw`, `ip`, `ap`, `i"`, `a"`, ``i` ``, ``a` ``, `i)`, `a)`, `i]`, `a]`, `i}`, `a}`）
 - `Esc` / `Ctrl-c`: Normal mode に戻る
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 - blockwise の text object 選択 / paste の Vim 互換挙動は未対応
 
+### Rich mode
+
+- `:rich [format]` / `gr` で入る（トグル）
+- 同一バッファ上で動作（仮想バッファを作らない）
+- Normal mode とほぼ同じキーバインドが使える（移動・検索・yank 等）
+- バッファを変更する操作（insert/delete/change/paste/replace）はブロック
+- `Esc` / `Ctrl-C` で Normal mode に戻る
+- ステータスラインに `-- RICH --` を表示
+- 描画時に表示行をテーブル整形（`TableRenderer` を利用）
+- wrap は強制 OFF
+
 ### Command-line mode
 
 - `:` で入る
@@ -297,16 +324,36 @@ RuVim::ExCommandRegistry.instance.register(
 - `Tab` (`Ctrl-i`) で Ex 補完
   - コマンド名
   - 一部引数（path / buffer / option）
+- `Ctrl-z` で shell へ suspend（`fg` で復帰）
+
+### Hit-enter prompt（複数行メッセージ表示）
+
+`:ls` や `:set`（引数なし）など、複数行にわたる出力を行うコマンドの結果を表示するモード。
+
+- 画面下部にメッセージ行をオーバーレイ描画
+- 最下行に「Press ENTER or type command to continue」を反転表示
+- ステータスラインは非表示（Vim と同様）
+- 対象コマンド: `:ls` / `:buffers`, `:args`, `:set`（引数なし）, `:command`（引数なし）
+- 1行以下の出力時は通常の `echo` を使用
+
+#### キー操作
+
+- `Enter` / `Space` / `Escape` / `Ctrl-C` / その他のキー → dismiss（通常モードに戻る）
+- `:` → dismiss して Command-line mode に入る
+- `/` / `?` → dismiss して検索 Command-line mode に入る
 
 ## Ex コマンド仕様（現状 builtin）
 
 - `:w [path]` / `:write [path]`
 - `:q[!]` / `:quit[!]`
+- `:qa[!]` / `:qall[!]`
 - `:wq[!] [path]`
+- `:wqa[!]` / `:wqall[!]` / `:xa[!]` / `:xall[!]`
 - `:e <path>` / `:edit <path>`
 - `:e[!] [path]` / `:edit[!] [path]`
 - `:help [topic]`
 - `:commands`
+- `:bindings [mode]`
 - `:command[!] <Name> <ex-body>`
 - `:ruby <code>` / `:rb <code>`
 - `:!<command>`
@@ -323,6 +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`
 
 ## 検索仕様（現状）
 
@@ -332,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` は未実装）
 
 ### 仕様メモ
 
@@ -347,10 +401,20 @@ RuVim::ExCommandRegistry.instance.register(
 - `:q` は未保存変更があると拒否
 - `:q` は Vim 寄りに、複数 window 時は current window を閉じる（window が1つで tab が複数なら current tab を閉じる）
 - `:q!` は強制的に window / tab / app を閉じる
+- `:qa` は全ウィンドウ/タブを無視して一括終了（未保存バッファがあると拒否、`:qa!` で強制）
+- `:wqa` は全バッファを保存して一括終了
 - `:e` は未保存変更があると拒否（`!` で破棄可）
 - `:e!`（引数なし）は現在ファイルの再読込（undo/redo クリア）
 - `:buffer!`, `:bnext!`, `:bprev!` は未保存変更があっても切替
 - `:w!` は現状 `:w` と同等に受理（権限昇格などは未実装）
+- `:bindings` は current buffer 文脈の有効 key binding を layer 別（`buffer`, `filetype`, `app`）に一覧表示
+  - 任意で mode filter を受ける（例 `:bindings normal`）
+- 大きいファイルを開くときは、閾値以上で段階読み込みになる場合がある
+  - status line に `[load/live]`（失敗時 `[load/error]`）
+  - デフォルト実装は先頭 `8MB` を先に表示し、残りをバックグラウンド読み込み後に反映
+  - 環境変数:
+    - `RUVIM_ASYNC_FILE_THRESHOLD_BYTES`
+    - `RUVIM_ASYNC_FILE_PREFIX_BYTES`
 
 ### `:command`（現状仕様）
 
@@ -395,6 +459,16 @@ RuVim::ExCommandRegistry.instance.register(
 - バッファ切替時に直前バッファを更新
 - `:buffer #` で切替可能
 
+### arglist（引数リスト）
+
+- `Editor#arglist` と `Editor#arglist_index` を保持
+- 起動時に複数ファイル引数があるとarglistが初期化される
+- 複数ファイル起動時、レイアウトオプション未指定でも全ファイルをバッファとして読み込む（`:ls` に表示される）
+- `:args` : arglistを表示（現在の引数は `[filename]` で表示）
+- `:next` / `:prev` : arglist内を移動
+- `:first` / `:last` : arglistの最初/最後に移動
+- arglist移動時にalternate bufferも更新される
+
 ## 画面描画仕様（現状）
 
 ANSI エスケープシーケンスによる再描画です。
@@ -409,19 +483,24 @@ ANSI エスケープシーケンスによる再描画です。
 - ファイル未指定起動時は Vim 風 intro screen を表示（RuVim では intro 用の read-only 特殊バッファ）
 - カーソル位置の文字を反転表示（見やすさ向上）
 
-### split UI（現状）
+### split UI
 
 - `:split` / `:vsplit` で複数 window を作成
-- レイアウトは簡易タイル（等分割）
-  - `horizontal`: 上下分割
-  - `vertical`: 左右分割
-- nested split / Vim の厳密な window tree は未実装
+- レイアウトはツリー構造（ネストした分割に対応）
+  - `hsplit`: 上下分割
+  - `vsplit`: 左右分割
+  - 例: vsplit 後に右ウィンドウを split すると、右カラムだけが上下分割される
+- 同方向の分割は親ノードにマージ（hsplit の中で hsplit しても 1 レベルに統合）
+- `close_window` でツリーを簡略化（子が 1 個になった分割ノードは子に置き換え）
+- `focus_window_direction` は正規化座標空間で最近接ウィンドウを選択
 - 各 window は cursor / scroll を独立して保持
 
 ### Tabpage（現状）
 
 - `:tabnew [path]` で新しいタブを作成
 - `:tabnext`, `:tabprev` で移動
+- `:tabs` で全タブ一覧を表示（各タブのウィンドウとバッファ名）
+- ステータスラインに `tab:n/m` を表示（タブが2つ以上のとき）
 - 各タブは以下を独立に保持
   - window list（表示中 window 群）
   - current window
@@ -434,6 +513,12 @@ ANSI エスケープシーケンスによる再描画です。
 - 入力待機は `stdin + resize通知` を `IO.select` で待つ
 - 描画ごとに `winsize` を再取得して viewport を再計算
 
+### suspend / resume（現状）
+
+- `Ctrl-z` 入力は app レベルで処理し、モードに関係なく suspend する
+- suspend 時は terminal を cooked + main screen に戻してから `SIGTSTP` を送る
+- `fg` 復帰時は alt screen を再有効化し、`Screen` キャッシュを破棄して全面再描画する
+
 ### Command-line 改善（現状）
 
 - prefix ごとの履歴保持（`:` `/` `?`）
@@ -518,12 +603,15 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 - `diw`, `daw` : text object word（簡易）
 - `di"`, `da"`, `di)`, `da)` : delimiter text object（簡易・同一行中心）
 
-設計上は operator-pending 状態機械を導入しており、`d/y/c` を同じ流れで扱います。
+設計上は operator-pending 状態機械を導入しており、`d/y/c/=` を同じ流れで扱います。
 
 補足:
 
 - 現状 `y` operator も実装済み（`yy`, `yw`）
 - 現状 `c` operator も実装済み（`cw`, `cc`, `c$`, `ciw`, `caw` など）
+- 現状 `=` operator も実装済み（`==`, `=j`, `=k`, `=G`, `=gg`、Visual `=`）
+  - Ruby filetype の場合にネスト構造に基づく自動インデントを適用
+  - 他の filetype はフォールバック（現在のインデント維持）
 
 ### text object（現状）
 
@@ -594,7 +682,7 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 - 代表例:
   - window-local: `number`, `relativenumber`, `wrap`, `linebreak`, `breakindent`, `cursorline`, `scrolloff`, `sidescrolloff`
   - global: `ignorecase`, `smartcase`, `hlsearch`, `incsearch`, `splitbelow`, `splitright`, `hidden`, `clipboard`, `timeoutlen`
-  - buffer-local: `tabstop`, `expandtab`, `shiftwidth`, `softtabstop`, `autoindent`, `smartindent`, `filetype`
+  - buffer-local: `tabstop`, `expandtab`, `shiftwidth`, `softtabstop`, `autoindent`, `smartindent`, `filetype`, `onsavehook`
 - 詳細な一覧・実装状況は `docs/config.md` を参照
 
 ## Filetype / ftplugin（現状の基礎）
@@ -608,19 +696,85 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
   - `setlocal` / `setglobal` / `set`（DSL）で option 変更可
 - 同一 buffer の同一 filetype ftplugin は一度だけ読み込む
 
+## Lang モジュール on_save フック
+
+- Lang モジュールに `on_save(ctx, path)` ライフサイクルフックを定義
+- `:w` でファイル保存後、`onsavehook` オプションが有効（デフォルト `true`）なら `buffer.lang_module.on_save(ctx, target)` を呼び出す
+- `Lang::Base.on_save` はデフォルトで何もしない（no-op）
+- `Lang::Ruby.on_save` は `ruby -wc` で構文チェックを実行し、エラー/警告を quickfix list に展開する
+  - エラー出力を `filename:line:` 形式でパースし quickfix items に変換
+  - 複数エラー時はヒント `(]q to see next, N total)` を表示
+  - 正常時は quickfix list を空にクリアする
+- `:set noonsavehook` で無効化可能
+
 ## シンタックスハイライト（最小）
 
 - 描画時に filetype ごとの regex ベース highlighter を適用
 - 現状の対応 filetype:
   - `ruby`
-  - `json`
+  - `json` / `jsonl`
+  - `markdown`（見出し・フェンス・HR・ブロック引用・インライン装飾）
 - 優先度（高 -> 低）:
   - cursor / visual
   - search highlight
   - syntax highlight
-- 実装は `lib/ruvim/highlighter.rb`
+- 実装は `lib/ruvim/highlighter.rb`（ディスパッチャ）+ `lib/ruvim/lang/markdown.rb`（言語固有ロジック）
 - Vim の syntax / treesitter 相当の互換性はない（最小実装）
 
+## Rich mode（構造化データ表示）
+
+構造化データ（TSV/CSV）や Markdown を見やすく整形して表示するモードです。
+Visual mode と同様に Normal mode の上に乗るモードとして設計されています。
+
+- **アーキテクチャ**: filetype ごとにレンダラーを登録できる汎用フレームワーク
+  - `RuVim::RichView` モジュール（`lib/ruvim/rich_view.rb`）
+  - レンダラー登録: `RichView.register(filetype, renderer)`
+  - レンダラー: `TableRenderer`（TSV/CSV）、`MarkdownRenderer`（Markdown）、`JsonRenderer`（JSON）、`JsonlRenderer`（JSONL）
+  - `JsonRenderer` は仮想バッファ方式: ミニファイ JSON を `JSON.pretty_generate` で整形し、読み取り専用バッファに表示
+  - `JsonlRenderer` は仮想バッファ方式: 各行を個別にパース・整形し、`---` セパレータで区切って読み取り専用バッファに表示。パースエラー行はエラーマーカー付きで表示
+  - 仮想バッファ方式のレンダラーでは `Esc` / `C-c` でバッファを閉じて元に戻れる
+- **起動方法**:
+  - `:rich [format]` Ex コマンド（トグル）
+  - `gr` Normal mode キーバインド（トグル）
+- **モード仕様**:
+  - 同一バッファ上で動作（仮想バッファを作成しない）
+  - `Editor#rich_state` に format/delimiter を保持
+  - Normal mode とほぼ同じキーバインドが使える（移動・検索・yank 等）
+  - バッファを変更する操作（insert/delete/change/paste/replace）はブロック
+  - `Esc` / `Ctrl-C` で Normal mode に戻る
+  - ステータスラインに `-- RICH --` を表示
+  - wrap は強制 OFF
+- **レンダリング**:
+  - `Screen` の `plain_window_render_rows` で `editor.rich_mode?` を判定
+  - Rich mode の場合、表示行だけを `RichView.render_visible_lines` で整形
+  - バッファ内容は変更せず、描画パイプラインでの変換のみ
+  - `render_rich_view_line_sc` は ANSI エスケープシーケンスを幅ゼロとして扱い、横スクロール時もスタイルを正しく維持
+- **横スクロール**:
+  - 表示カラム（display column）ベースでスクロール量を管理（`@rich_col_offset_sc`）
+  - `renderer.cursor_display_col` で raw バッファの `cursor_x` を整形後の表示カラムに変換し、スクロールオフセットを決定
+  - `render_rich_view_line_sc` で各行を同じ表示カラム数だけスキップして描画（CJK/ASCII 混在でも列揃えが保たれる）
+  - ワイド文字がビューポート左端をまたぐ場合はスペースで置換（部分表示は不可）
+  - カーソルの画面位置も整形後の表示カラム座標で計算
+- **テーブルレンダラー仕様**:
+  - 区切り表示: ` | `（スペース+パイプ+スペース）
+  - 列幅は画面に見えている行だけから計算（大規模ファイルでも高速）
+  - CJK 文字の表示幅を `DisplayWidth.display_width` で正確に計算
+  - CSV は最小限の quoted field パース対応
+  - 列が1つしかない場合は元の行をそのまま返す
+- **Markdown レンダラー仕様**:
+  - インラインマーカー（`#`, `**`, `*`, `` ` `` 等）は残し、ANSI スタイルを重ねる
+  - 見出し H1-H6: レベル別 bold + 色
+  - インライン装飾: `**bold**`, `*italic*`, `` `code` ``, `[text](url)`, チェックボックス
+  - コードブロック: `` ``` ``/`~~~` フェンスで状態追跡、内容を暖色表示
+  - コードフェンス状態は `pre_context_lines` で表示領域前の行から引き継ぎ
+  - テーブル: `|...|` パターンを検出し、列幅揃え + box-drawing 罫線（`│`, `─`, `┼`, `├`, `┤`）
+  - HR: `---`/`***`/`___` を `─` 線に置換
+  - ブロック引用: `>` で始まる行を cyan 表示
+  - テーブル行のカーソルマッピングはパディング後の位置を計算
+- **filetype 検出**:
+  - `.tsv` → `tsv`, `.csv` → `csv`, `.md` → `markdown`
+  - `:rich`（引数なし）は filetype から判定、不明なら内容を見て自動推測
+
 ## シングルトン方針
 
 グローバルに共有して良い「定義系」だけシングルトンにしています。
@@ -641,6 +795,9 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
   - `nmap`
   - `imap`
   - `map_global`
+  - `set`
+  - `setlocal`
+  - `setglobal`
   - `command`
   - `ex_command`
   - `ex_command_call`
@@ -650,6 +807,47 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 - 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` を利用
@@ -662,10 +860,8 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 
 - 永続 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

@@ -85,7 +85,7 @@
 - session file（`-S [session]` placeholder 実体化）
 - `wrap` / `linebreak` / `breakindent` / `showbreak` の整合性
 - `wildmenu` / `completeopt` / `pumheight` の UI コンポーネント寄せ
-- arglist（複数ファイル通常起動 + `:args/:next/:prev`）
+- arglist 残件（`:args/:next/:prev` の挙動精度向上）
 
 ### この順番の理由（依存）
 
@@ -120,10 +120,6 @@
 
 ### P1: Vim 運用でよく触る基盤（あると詰まりにくい）
 
-- arglist（複数ファイル通常起動 + 操作）
-  - 複数ファイル引数（通常起動）
-  - `:args`, `:next`, `:prev`, `:first`, `:last`
-  - `alternate buffer (#)` との整合
 - `Ctrl-w` window 操作の拡張
   - `Ctrl-w c`（window close）
   - `Ctrl-w o`（only / 他 window を閉じる）

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 値を変更