ruvim 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f942ba8fad5d2732b0369e0f79f0760c326f602bed0d754a578f4ddb28794ba
-  data.tar.gz: 2c82a6317f9e5e34b7319db75ea7bd12b333f6841ce77cd52b5e50edfcbdec22
+  metadata.gz: affafdf81175fc15f4d0f0053982743caa863aa371053095bfdd24160aee857d
+  data.tar.gz: 9abd61f0ba641b3f7dc429c4104f2e5d09243ebeb821baa8ad7521c6b4a3eca7
 SHA512:
-  metadata.gz: 97b81ea7eff50fc175d862265224996b358e61b6d3bd4d5710446bdaa7cae4048352fcf8d41b9c81a31f9d1a2bc7c3602490d9e488f75a536aab29b46571db62
-  data.tar.gz: 38e25791b5f3ff239e9b175b02007e0964b3e3ca423abe3e2665eeec615b0b6aefa5458323c2a7ab79bf55f94220985fc3cf4ffa49c93cdd4f1912ac57d585c6
+  metadata.gz: 7a5dc6394f0905831d384fb66d88992d20691b58347a2c1673179f0036585f82aa54c6681f8bb79dd9c0e3ffa77389cb5e7a62d7eec27571be0b7f79529a58fb
+  data.tar.gz: 203a49cce3d46575fa743c5635874af2e320ddd225fe973d74a82851b1bfb6112e379e084e1e8afa262c5eac3d596c5c7b23ad572e77f8bf6ed5d2296e9fe992

data/.github/workflows/test.yml

@@ -7,9 +7,13 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: ["3.2", "3.3", "3.4", "4.0"]
     steps:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
       - run: bundle exec rake ci

data/AGENTS.md

@@ -0,0 +1,96 @@
+This project is RuVim, a Vim-like editor written in Ruby. Always run the full test suite (`rake test` or equivalent) after making code changes and confirm all tests pass before committing.
+
+* check docs/ to understand the specification
+  * docs/spec.md
+  * docs/todo.md
+* When modifying the source code
+  * write tests first, then implement (test-first)
+  * update docs/
+    * 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
+
+## Source Tree
+
+### Architecture
+
+```
+CLI (exe/ruvim) → CLI.parse() → App.new() → App.run_ui_loop()
+  Input.read_key() → KeymapManager.resolve() → Dispatcher.dispatch()
+  → GlobalCommands.<method>() → Editor state update → Screen.render() → Terminal.write()
+```
+
+### Core (lib/ruvim/)
+
+| File | Description |
+|------|-------------|
+| `app.rb` | Main application loop, input handling, startup |
+| `editor.rb` | Editor state: buffers, windows, options, registers, marks, modes |
+| `buffer.rb` | Text buffer (lines, file I/O, encoding) |
+| `window.rb` | View of a buffer (cursor, scroll, grapheme-aware movement) |
+| `global_commands.rb` | All built-in command implementations (cursor, edit, search, visual, etc.) |
+| `screen.rb` | Rendering: window layout, syntax highlight, line numbers, status line, wrap |
+| `dispatcher.rb` | Routes commands; parses Ex ranges/substitute; shell execution |
+| `keymap_manager.rb` | Key-to-command mapping with layers (filetype > buffer > mode > global) |
+| `input.rb` | Raw keyboard input, ANSI escape sequence parsing |
+| `terminal.rb` | Terminal I/O: raw mode, alternate screen, winsize |
+| `command_line.rb` | Command-line text/cursor state |
+| `command_registry.rb` | Normal/insert mode command registry (singleton) |
+| `ex_command_registry.rb` | Ex command registry (singleton) |
+| `cli.rb` | CLI argument parsing, `--help`, `--version` |
+| `config_loader.rb` | Load `~/.config/ruvim/init.rb` and ftplugin |
+| `config_dsl.rb` | User config DSL: `nmap`, `imap`, `set`, `command`, `colorscheme` |
+| `display_width.rb` | Character display width (CJK, emoji, combining marks) |
+| `text_metrics.rb` | Grapheme-aware text measurement and navigation |
+| `keyword_chars.rb` | Word character definition (iskeyword) |
+| `highlighter.rb` | Syntax highlighting dispatcher (delegates to lang modules) |
+| `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; 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`, `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/)
+
+`spec.md` (feature spec), `command.md`, `binding.md`, `config.md`, `tutorial.md`, `vim_diff.md`, `plugin.md`, `todo.md`, `done.md`
+
+## Debugging (Lumitrace)
+
+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 -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.

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

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

@@ -1,5 +1,7 @@
 # RuVim キーバインディング一覧
 
+実行時の現在有効な binding 一覧は `:bindings` で表示できます（layer: `buffer` / `filetype` / `app`）。
+
 ## Normal mode
 
 - `h` : 左へ移動
@@ -28,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（簡易）
@@ -47,6 +57,7 @@
 - `'{mark}` / `` `{mark} `` : mark へ jump（行頭寄せ / 正確位置）
 - `''` / `` `` `` : jumplist で前の位置へ jump（行頭寄せ / 正確位置）
 - `r<char>` : 1文字置換
+- `=` + motion / `==` : auto-indent（Ruby filetype 対応）
 - `c` + motion / `cc` : change（削除して Insert mode）
 - `ciw` / `caw` : 単語 text object change（簡易）
 - `ci"` / `ca"` : quote text object change（簡易）
@@ -56,6 +67,7 @@
 - `V` : Visual (linewise)
 - `Ctrl-w w` : 次の window へ移動
 - `Ctrl-w h/j/k/l` : window 間移動（split UI）
+- `Shift+矢印キー` : window 間移動 or 分割（1ウィンドウ時は分割、2個以上なら移動）
 - `u` : Undo
 - `Ctrl-r` : Redo
 - `.` : 直前変更の repeat（現状: `x`, `dd`, `d{motion}`, `p/P`, `r<char>`）
@@ -64,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` : 直前検索を次へ
@@ -71,9 +86,20 @@
 - `*` / `#` : カーソル下の単語検索（前/後）
 - `g*` / `g#` : カーソル下の単語を部分一致検索（前/後）
 - `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` で復帰）
 - `矢印キー` : 移動
 - `PageUp` / `PageDown` : 画面単位で移動（概ね表示高さ - 1 行）
+- `Q` : quickfix list を開く（`:copen` 相当）
+- `]q` : 次の quickfix item へジャンプ（`:cnext` 相当）
+- `[q` : 前の quickfix item へジャンプ（`:cprev` 相当）
 - `Enter` : quickfix / location list バッファ上では選択項目へジャンプ（一覧ウィンドウから元の編集ウィンドウへ戻る）
 
 ### count 対応（現状）
@@ -90,6 +116,7 @@
 - `Ctrl-p` : buffer words 補完（前候補）
 - `Esc` : Normal mode に戻る
 - `Ctrl-c` : Normal mode に戻る
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 - `矢印キー` : 移動
 - `PageUp` / `PageDown` : 画面単位で移動
 
@@ -101,8 +128,18 @@
 - `V` : linewise Visual の開始/切替
 - `y` : 選択範囲を yank
 - `d` : 選択範囲を delete
+- `=` : 選択範囲を auto-indent
 - `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` で復帰）
+
+## Rich mode
+
+- Normal mode のキーバインドをほぼそのまま使える（移動・検索・yank 等）
+- バッファを変更する操作（insert/delete/change/paste/replace）はブロック
+- `Esc` : Normal mode に戻る
+- `Ctrl-c` : Normal mode に戻る
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 
 ## Command-line mode
 
@@ -114,6 +151,7 @@
 - `Tab` (`Ctrl-i`) : Ex 補完（`:` prefix 時、コマンド名/一部引数の文脈対応）
 - `Esc` : キャンセル
 - `Ctrl-c` : キャンセル
+- `Ctrl-z` : shell へ suspend（`fg` で復帰）
 
 ### prefix 別の Enter 動作
 
@@ -128,4 +166,5 @@
 - keymap 解決順（現状実装）: `filetype-local -> buffer-local -> mode-local -> global`
 - `~/.config/ruvim/init.rb`（または `$XDG_CONFIG_HOME/ruvim/init.rb`）の `nmap` / `imap` / `map_global` で上書き・追加可能
 - `Ctrl-d/u/f/b/e/y` に加えて、`矢印キー` / `PageUp` / `PageDown` も「既定挙動の前に keymap override を試す」ため `nmap "<PageDown>", ...` のように上書き可能
+- `Ctrl-z` は keymap ではなく app レベルの suspend 処理として扱う（全モード共通）
 - `~/.config/ruvim/ftplugin/<filetype>.rb`（または `$XDG_CONFIG_HOME/ruvim/ftplugin/<filetype>.rb`）では `nmap` / `imap` が filetype-local として登録される

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。現状は未実装メッセージ表示）
@@ -19,6 +20,16 @@
 - `-c {cmd}`
 - `+{cmd}`, `+{line}`, `+`
 
+補足（現状挙動）:
+
+- `cmd | ruvim`
+  - `stdin` を follow stream として開く（`[stdin]` バッファ）
+  - Normal mode の `Ctrl-c` で stream 停止（上流プロセスには直接 `SIGINT` は送らない）
+- `Ctrl-z`
+  - 全モード共通で shell へ suspend（`SIGTSTP`）
+  - suspend 前に terminal を cooked + main screen へ戻す
+  - `fg` 復帰後は alt screen を再有効化し、画面を全面再描画する
+
 ## Ex コマンド（builtin）
 
 ### `:w` / `:write`
@@ -36,11 +47,22 @@
 - 最後の window / tab のとき: エディタ終了
 - 最後の window / tab で未保存変更がある場合、`!` なしでは拒否
 
+### `:qa` / `:qall`
+
+- 形式: `:qa`, `:qa!`
+- 全ウィンドウ/タブを無視して一括終了
+- 未保存変更があるファイルバッファが存在する場合、`!` なしでは拒否
+
 ### `:wq`
 
 - 形式: `:wq`, `:wq!`, `:wq [path]`
 - 保存して `:q` 相当（window / tab / app を閉じる）
 
+### `:wqa` / `:wqall` / `:xa` / `:xall`
+
+- 形式: `:wqa`, `:wqa!`
+- 変更のある全ファイルバッファを保存して一括終了
+
 ### `:e` / `:edit`
 
 - 形式: `:e[!] [path]`
@@ -48,6 +70,11 @@
 - 引数なし: 現在ファイルを再読込
 - 未保存変更がある場合は `!` なしで拒否
 - `:e!` は未保存変更を破棄して開き直す（undo/redo もクリア）
+- 大きいファイル（閾値以上）は段階読み込みになる場合がある
+  - 読み込み中は status line に `[load/live]`
+  - デフォルトでは先頭 `8MB` を先に表示して、残りを後から追加
+  - 閾値: `RUVIM_ASYNC_FILE_THRESHOLD_BYTES`
+  - 先読みサイズ: `RUVIM_ASYNC_FILE_PREFIX_BYTES`
 
 ### `:help`
 
@@ -64,6 +91,16 @@
 - 形式: `:commands`
 - Ex コマンド一覧（alias 含む）を read-only バッファに表示
 
+### `:bindings`
+
+- 形式: `:bindings [mode]`
+- 現在バッファに対して有効な key binding 一覧を read-only バッファに表示
+- layer ごとに表示:
+  - `buffer`
+  - `filetype`
+  - `app`
+- `mode` は任意（例: `normal`, `insert`, `visual_line`, `command_line`。短縮形 `n`, `i`, `v`, `c` なども可）
+
 ### quickfix / location list（最小）
 
 - `:vimgrep /pattern/`
@@ -78,10 +115,55 @@
   - 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`
+
+- 形式: `:rich [format]`
+- Rich mode を開始 / 終了する（トグル）
+- `format` に `tsv` または `csv` を指定可能（省略時は filetype / 内容から自動判定）
+- 同一バッファ上で動作し、描画時にテーブル整形を適用する
+- Rich mode では移動・検索・yank 等は使えるが、バッファ変更操作はブロックされる
+- 区切り文字は ` | `（スペース+パイプ+スペース）
+- 列幅は画面に見えている行だけから計算（大規模ファイルでも高速）
+- `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`
@@ -137,6 +219,34 @@
 - 表示中 window は別バッファへ切り替えられる
 - `!` 対応（未保存変更バッファを破棄）
 
+### `:args`
+
+- 形式: `:args`
+- 引数リスト（arglist）を表示
+- 現在の引数は `[filename]` 形式で表示される
+
+### `:next`
+
+- 形式: `:next`
+- arglist の次の引数ファイルを開く
+- エラー: 最後の引数で実行時
+
+### `:prev`
+
+- 形式: `:prev`
+- arglist の前の引数ファイルを開く
+- エラー: 最初の引数で実行時
+
+### `:first`
+
+- 形式: `:first`
+- arglist の最初の引数ファイルを開く
+
+### `:last`
+
+- 形式: `:last`
+- arglist の最後の引数ファイルを開く
+
 ### `:split`
 
 - 形式: `:split`
@@ -165,6 +275,23 @@
 - 形式: `:tabprev`
 - 前のタブへ移動
 
+### `:tabs`
+
+- 形式: `:tabs`
+- 全タブページの一覧を表示
+- 各タブに含まれるウィンドウとバッファ名を表示
+- 現在のタブ / ウィンドウは `>` マーカーで示す
+
+### `:d` / `:delete`
+
+- 形式: `:d [count]`, `:{range}d`
+- 行を削除
+
+### `:y` / `:yank`
+
+- 形式: `:y [count]`, `:{range}y`
+- 行をヤンク
+
 ## 内部コマンド（主なもの）
 
 内部コマンドは主に key binding から使われ、`RuVim::CommandRegistry` に登録されます。
@@ -220,7 +347,35 @@
 - `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`
 
 ## 検索コマンド（Normal mode）
 
@@ -233,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）
 
@@ -265,6 +422,7 @@
 - `buffer.visual_delete`
 - blockwise は最小実装（矩形選択 + `y/d`）
 - blockwise の text object 選択 / paste の Vim 互換挙動は未対応
+- `Ctrl-z` で shell へ suspend（`fg` で復帰）
 
 ## repeat（Normal mode）
 
@@ -310,6 +468,7 @@
 
 - `Screen` は行キャッシュを使った簡易差分描画を行う
 - `SIGWINCH` + self-pipe + `IO.select` で入力待機中でもリサイズに即追従
+- `Ctrl-z` suspend/`fg` 復帰後は `Screen` キャッシュを破棄し、全面再描画する
 - command-line は履歴と Ex 補完（コマンド名 + 一部引数の文脈補完）を持つ
 - Insert mode は `Ctrl-n` / `Ctrl-p` の buffer words 補完を持つ
 - 文字幅は `DisplayWidth` の近似実装（tab 展開 + 一部全角幅2）

data/docs/config.md

@@ -217,12 +217,12 @@ setglobal "tabstop=8"
 
 - `path` (`string`, default `nil`) [`PARTIAL`]
   - `gf` などのファイル探索ディレクトリを指定します（`,` 区切り）。
-  - 現状は `gf` の最小探索に利用します。
+  - 現状は `gf` の最小探索に利用します（`file:line` の `line` ジャンプにも対応）。
   - `lib/**` のような再帰探索（簡易）に対応します。
 
 - `suffixesadd` (`string`, default `nil`) [`PARTIAL`]
   - `gf` などで補完する拡張子候補を指定します（`,` 区切り）。
-  - 現状は `gf` の最小探索に利用します。
+  - 現状は `gf` の最小探索に利用します（`file:line` の `path` 部分に適用）。
 
 - `textwidth` (`int`, default `0`) [`定義のみ`]
   - 自動改行幅の指定です。
@@ -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/done.md

@@ -30,12 +30,15 @@
 - quickfix / location list（最小）
 - Visual block（`Ctrl-v`、最小）
 - `.` repeat の精度向上（operator + text object + macro 連携）
+- `=` operator（自動インデント: `==`, `=j`, `=k`, `=G`, `=gg`, Visual `=`。Ruby filetype 対応）
 
 ## コマンド / 設計 / 拡張基盤
 
 - `:command`（ユーザー定義 Ex コマンド）
 - `:ruby` / `:rb`
 - バッファ管理コマンド（`:ls`, `:buffers`, `:bnext`, `:bprev`, `:buffer`, `#`）
+- arglist（引数リスト）管理コマンド（`:args`, `:next`, `:prev`, `:first`, `:last`）
+- 複数ファイル起動時に全ファイルをバッファとして読み込む（`:ls` に表示）
 - キーマップのレイヤー化（mode/global/buffer/filetype）
 - option system（global / buffer-local / window-local, `:set` 系）
 - ファイルタイプ検出と ftplugin
@@ -45,6 +48,19 @@
 - block-based keymap DSL（`nmap/imap/map_global ... do |ctx, ...| end`）
 - plugin 向け `ctx.editor / ctx.buffer / ctx.window` API リファレンス（未確定 API 注記つき）
 
+## Rich mode / 構造化データ表示
+
+- Rich View フレームワーク（filetype ごとのレンダラー登録）
+- TSV/CSV テーブルレンダラー（列幅自動計算、CJK 対応、CSV quoted field パース）
+- `:rich [format]` Ex コマンド（トグル）
+- `gr` Normal mode キーバインド（トグル）
+- filetype 検出に `.tsv` / `.csv` 追加
+- Rich View → Rich mode へ変換（仮想バッファ方式から同一バッファ上のモード方式へ）
+- Rich mode の横スクロール修正（`$` で行末に移動した際の縦揃えズレを解消）
+- Markdown Rich mode（見出し・インライン装飾・テーブル罫線・コードブロック・HR・ブロック引用の ANSI レンダリング）
+- `render_rich_view_line_sc` の ANSI エスケープシーケンス対応
+- `ensure_visible_rich` の汎用化（`renderer.cursor_display_col` インターフェース）
+
 ## UI / 画面描画 / 端末挙動
 
 - リサイズ対応（`SIGWINCH` + 即時再描画）
@@ -53,12 +69,14 @@
 - コマンドライン改善（履歴 / 補完 / エラー表示）
 - カーソル位置の強調表示
 - 複数 window / split UI（`:split`, `:vsplit`, window 間移動）
+- ネストしたウィンドウ分割（layout tree: vsplit→split でカラム内だけ上下分割）
 - Tabpage（`:tabnew`, `:tabnext`, `:tabprev`）
 - ヘルプ / コマンド一覧の read-only 仮想バッファ表示
 - intro screen（Vim 風 welcome buffer）
 - エラー表示の改善（最下段・強調表示）
 - PageUp / PageDown 対応
 - `:q` の window/tab/app クローズ挙動を Vim 寄りに調整
+- hit-enter prompt（複数行メッセージ表示: `:ls`, `:args`, `:set`, `:command`）
 
 ## Unicode / 日本語 / 表示幅 / 座標系
 
@@ -69,15 +87,18 @@
 - 表示幅ベース描画の共通化（`TextMetrics` 中心）
 - 日本語/全角を含む操作の整合性確認（`w/b/e`, Visual yank, `p/P`）
 - 描画回帰テストの追加（Unicode / wide char）
+- `truncate` の表示幅計算を文字数ベースから `DisplayWidth` ベースに修正（全角文字を含むエラーメッセージでターミナルがスクロールするバグを修正）
 
 ## 品質 / テスト / CI / パフォーマンス
 
 - テスト追加（Buffer / Dispatcher / Ex parser / KeymapManager）
 - パフォーマンス改善（表示幅ベース水平スクロール / syntax cache）
+- Insert mode ペースト高速化（stdin に pending input がある間はレンダリングをスキップしバッチ処理）
 - rope/piece-table などのバッファ構造検討メモ（`docs/spec.md`）
 - テスト基盤の拡張（結合テスト / snapshot / シナリオ）
 - CI / 開発体験（GitHub Actions, `rake docs:check`, `rake ci`）
 - シンタックスハイライト（最小）
+- Markdown シンタックスハイライト（`Lang::Markdown` に抽出、通常モード + Rich mode で共有）
 - 補完基盤（Ex 補完 / Insert mode 補完）
 
 ## CLI オプション（Vim 風・実装済み / placeholder 含む）