ruvim 0.3.0 → 0.6.0

data/benchmark/file_load.rb

@@ -0,0 +1,140 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Benchmark file loading hotspots
+#
+# Usage: ruby benchmark/file_load.rb [path]
+#   Default: huge_file in project root
+
+require "benchmark"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ruvim/buffer"
+require "ruvim/lang/registry"
+require "ruvim/lang/base"
+
+FILE = ARGV[0] || File.expand_path("../huge_file", __dir__)
+unless File.exist?(FILE)
+  abort "File not found: #{FILE}\nUsage: ruby benchmark/file_load.rb [path]"
+end
+
+size_mb = File.size(FILE) / 1024.0 / 1024.0
+puts "File Load Benchmark"
+puts "=" * 60
+puts "Ruby: #{RUBY_VERSION}"
+puts "File: #{FILE}"
+puts "Size: %.1f MB" % size_mb
+puts
+
+# ---------------------------------------------------------------------------
+# 1. Raw IO read
+# ---------------------------------------------------------------------------
+puts "--- 1. Raw file read ---"
+Benchmark.bm(25) do |x|
+  x.report("File.binread") do
+    data = File.binread(FILE)
+    data.size  # force read
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 2. decode_text (encoding detection)
+# ---------------------------------------------------------------------------
+puts "--- 2. decode_text ---"
+raw = File.binread(FILE)
+Benchmark.bm(25) do |x|
+  x.report("decode_text") do
+    RuVim::Buffer.decode_text(raw)
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 3. split_lines (String#split)
+# ---------------------------------------------------------------------------
+puts "--- 3. split_lines ---"
+decoded = RuVim::Buffer.decode_text(raw)
+Benchmark.bm(25) do |x|
+  x.report("split(\"\\n\", -1)") do
+    decoded.split("\n", -1)
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 4. Full Buffer.from_file
+# ---------------------------------------------------------------------------
+puts "--- 4. Full Buffer.from_file ---"
+Benchmark.bm(25) do |x|
+  x.report("Buffer.from_file") do
+    RuVim::Buffer.from_file(id: 1, path: FILE)
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 5. Chunked read (simulating Stream::FileLoad)
+# ---------------------------------------------------------------------------
+puts "--- 5. Chunked read (4MB flush, simulating async load) ---"
+CHUNK = 1 * 1024 * 1024
+FLUSH = 4 * 1024 * 1024
+Benchmark.bm(25) do |x|
+  x.report("chunked read+split") do
+    io = File.open(FILE, "rb")
+    lines = [""]
+    pending = "".b
+    begin
+      loop do
+        chunk = io.readpartial(CHUNK)
+        pending << chunk
+        next if pending.bytesize < FLUSH
+
+        last_nl = pending.rindex("\n".b)
+        if last_nl
+          send_bytes = pending[0..last_nl]
+          pending = pending[(last_nl + 1)..] || "".b
+        else
+          send_bytes = pending
+          pending = "".b
+        end
+        decoded = RuVim::Buffer.decode_text(send_bytes)
+        parts = decoded.split("\n", -1)
+        head = parts.shift || ""
+        lines[-1] = lines[-1] + head unless head.empty?
+        lines.concat(parts) unless parts.empty?
+      end
+    rescue EOFError
+      unless pending.empty?
+        decoded = RuVim::Buffer.decode_text(pending)
+        parts = decoded.split("\n", -1)
+        head = parts.shift || ""
+        lines[-1] = lines[-1] + head unless head.empty?
+        lines.concat(parts) unless parts.empty?
+      end
+    ensure
+      io.close
+    end
+    puts "    lines loaded: #{lines.size}"
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 6. Memory profile
+# ---------------------------------------------------------------------------
+puts "--- 6. Memory usage ---"
+GC.start
+before = GC.stat[:malloc_increase_bytes_limit]
+mem_before = `ps -o rss= -p #{$$}`.strip.to_i
+buf = RuVim::Buffer.from_file(id: 2, path: FILE)
+GC.start
+mem_after = `ps -o rss= -p #{$$}`.strip.to_i
+puts "  Lines: #{buf.line_count}"
+puts "  RSS before: #{mem_before / 1024} MB"
+puts "  RSS after:  #{mem_after / 1024} MB"
+puts "  RSS delta:  #{(mem_after - mem_before) / 1024} MB"
+
+puts
+puts "=" * 60
+puts "Done."

data/benchmark/hotspots.rb

@@ -0,0 +1,178 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Benchmark for C-extension candidate hotspots in RuVim
+#
+# Usage: ruby benchmark/hotspots.rb
+
+require "benchmark"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ruvim/display_width"
+require "ruvim/text_metrics"
+require "ruvim/highlighter"
+require "ruvim/lang/registry"
+require "ruvim/lang/base"
+require "ruvim/lang/ruby"
+require "ruvim/lang/c"
+require "ruvim/lang/markdown"
+require "ruvim/lang/json"
+require "ruvim/lang/javascript"
+
+# ---------------------------------------------------------------------------
+# Test data
+# ---------------------------------------------------------------------------
+ASCII_LINE   = '  def foo(bar, baz) = bar + baz # comment with some padding text here!!!' * 2
+CJK_LINE     = "日本語テキスト　漢字カタカナ　テスト用の行　全角文字を含む行" * 2
+MIXED_LINE   = "Hello 世界! def foo(x) = x + 1  # コメント 🚀 emoji test"
+EMOJI_LINE   = "🎉🔥💡🚀✨🎊🌟💎🏆🎯" * 5
+TAB_LINE     = "\t\tif (x > 0) {\n\t\t\treturn x;\n\t\t}"
+
+RUBY_LINE    = '  def initialize(name, value: nil) # keyword args'
+C_LINE       = '  int *ptr = malloc(sizeof(struct node)); /* alloc */'
+MD_LINE      = '## Heading with **bold** and `code` and [link](url)'
+JSON_LINE    = '  {"key": "value", "number": 42, "bool": true, "null": null}'
+JS_LINE      = '  const fn = async (x) => { return await fetch(url); };'
+
+LINES_80COL  = [ASCII_LINE, CJK_LINE, MIXED_LINE, RUBY_LINE, C_LINE].freeze
+SCREEN_WIDTH = 120
+SCREEN_ROWS  = 50
+
+N_ITER = 10_000
+N_RENDER = 2_000
+
+puts "RuVim Hotspot Benchmark"
+puts "=" * 60
+puts "Ruby: #{RUBY_VERSION} (#{RUBY_PLATFORM})"
+puts "Iterations: #{N_ITER} (width), #{N_RENDER} (render)"
+puts
+
+# ---------------------------------------------------------------------------
+# 1. DisplayWidth.cell_width — per-character width lookup
+# ---------------------------------------------------------------------------
+puts "--- 1. DisplayWidth.cell_width ---"
+chars = {
+  "ASCII 'A'"   => "A",
+  "CJK '漢'"    => "漢",
+  "Emoji '🚀'"  => "🚀",
+  "Combining"   => "\u0301",   # combining acute
+  "Tab"         => "\t",
+}
+Benchmark.bm(20) do |x|
+  chars.each do |label, ch|
+    x.report(label) { N_ITER.times { RuVim::DisplayWidth.cell_width(ch) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 2. DisplayWidth.display_width — whole-line width
+# ---------------------------------------------------------------------------
+puts "--- 2. DisplayWidth.display_width ---"
+lines = {
+  "ASCII (140c)"  => ASCII_LINE,
+  "CJK (56c)"     => CJK_LINE,
+  "Mixed"         => MIXED_LINE,
+  "Emoji (50c)"   => EMOJI_LINE,
+  "Tabs"          => TAB_LINE,
+}
+Benchmark.bm(20) do |x|
+  lines.each do |label, line|
+    x.report(label) { N_ITER.times { RuVim::DisplayWidth.display_width(line) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 3. TextMetrics.clip_cells_for_width — cell array construction
+# ---------------------------------------------------------------------------
+puts "--- 3. TextMetrics.clip_cells_for_width ---"
+Benchmark.bm(20) do |x|
+  lines.each do |label, line|
+    x.report(label) { N_RENDER.times { RuVim::TextMetrics.clip_cells_for_width(line, SCREEN_WIDTH) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 4. TextMetrics.char_index_for_screen_col — cursor positioning
+# ---------------------------------------------------------------------------
+puts "--- 4. TextMetrics.char_index_for_screen_col ---"
+Benchmark.bm(20) do |x|
+  lines.each do |label, line|
+    target = RuVim::DisplayWidth.display_width(line) / 2
+    x.report(label) { N_ITER.times { RuVim::TextMetrics.char_index_for_screen_col(line, target) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 5. Highlighter.color_columns — syntax highlighting
+# ---------------------------------------------------------------------------
+puts "--- 5. Highlighter.color_columns ---"
+highlight_cases = {
+  "Ruby"       => ["ruby", RUBY_LINE],
+  "C"          => ["c", C_LINE],
+  "Markdown"   => ["markdown", MD_LINE],
+  "JSON"       => ["json", JSON_LINE],
+  "JavaScript" => ["javascript", JS_LINE],
+}
+Benchmark.bm(20) do |x|
+  highlight_cases.each do |label, (ft, line)|
+    x.report(label) { N_RENDER.times { RuVim::Highlighter.color_columns(ft, line) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 6. Simulated full-screen render pass (clip + highlight per line)
+# ---------------------------------------------------------------------------
+puts "--- 6. Simulated screen render (#{SCREEN_ROWS} lines × #{SCREEN_WIDTH} cols) ---"
+screen_lines = Array.new(SCREEN_ROWS) { |i| LINES_80COL[i % LINES_80COL.size] }
+Benchmark.bm(20) do |x|
+  x.report("clip_cells only") do
+    N_RENDER.times do
+      screen_lines.each { |line| RuVim::TextMetrics.clip_cells_for_width(line, SCREEN_WIDTH) }
+    end
+  end
+  x.report("highlight only") do
+    N_RENDER.times do
+      screen_lines.each_with_index do |line, i|
+        ft = %w[ruby c markdown json javascript][i % 5]
+        RuVim::Highlighter.color_columns(ft, line)
+      end
+    end
+  end
+  x.report("clip + highlight") do
+    N_RENDER.times do
+      screen_lines.each_with_index do |line, i|
+        ft = %w[ruby c markdown json javascript][i % 5]
+        RuVim::TextMetrics.clip_cells_for_width(line, SCREEN_WIDTH)
+        RuVim::Highlighter.color_columns(ft, line)
+      end
+    end
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# 7. DisplayWidth.expand_tabs
+# ---------------------------------------------------------------------------
+puts "--- 7. DisplayWidth.expand_tabs ---"
+tab_lines = {
+  "2 tabs"   => "\t\tcode here",
+  "mixed"    => "abc\tdef\tghi\tjkl",
+  "heavy"    => "\t" * 20 + "end",
+}
+Benchmark.bm(20) do |x|
+  tab_lines.each do |label, line|
+    x.report(label) { N_ITER.times { RuVim::DisplayWidth.expand_tabs(line) } }
+  end
+end
+puts
+
+# ---------------------------------------------------------------------------
+# Summary
+# ---------------------------------------------------------------------------
+puts "=" * 60
+puts "Done. Compare user+sys times to identify C-extension priorities."

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,12 @@
 - `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 / `branch` → ブランチ一覧
+  - Blame バッファ内: `p` 親コミットの blame へ遷移 / `P` 前の blame へ戻る / `c` コミット詳細を表示
+  - Branch バッファ内: `Enter` で `:git checkout <branch>` をコマンドラインにプリセット（即時実行ではなく確認ステップあり）
+- `Ctrl-c` : stdin stream 停止（stdin バッファ表示時）
 - `Esc` : メッセージ/保留入力のクリア
 - `Ctrl-z` : shell へ suspend（`fg` で復帰）
 - `矢印キー` : 移動
@@ -132,7 +149,7 @@
 - `Backspace` : 1文字削除
 - `Up` / `Down` : 履歴移動
 - `Left` / `Right` : カーソル移動
-- `Tab` (`Ctrl-i`) : Ex 補完（`:` prefix 時、コマンド名/一部引数の文脈対応）
+- `Tab` (`Ctrl-i`) : Ex 補完（`:` prefix 時、コマンド名/一部引数の文脈対応。`:git`/`:gh` サブコマンドも補完可能）
 - `Esc` : キャンセル
 - `Ctrl-c` : キャンセル
 - `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。現状は未実装メッセージ表示）
@@ -70,7 +71,7 @@
 - 未保存変更がある場合は `!` なしで拒否
 - `:e!` は未保存変更を破棄して開き直す（undo/redo もクリア）
 - 大きいファイル（閾値以上）は段階読み込みになる場合がある
-  - 読み込み中は status line に `[load/live]`
+  - 読み込み中は statusline に `[load/live]`
   - デフォルトでは先頭 `8MB` を先に表示して、残りを後から追加
   - 閾値: `RUVIM_ASYNC_FILE_THRESHOLD_BYTES`
   - 先読みサイズ: `RUVIM_ASYNC_FILE_PREFIX_BYTES`
@@ -114,9 +115,49 @@
   - current window の location list を開く / 閉じる
 - `:lnext` / `:ln`, `:lprev` / `:lp`
   - location list 項目を前後移動して該当位置へジャンプ
+- `:grep pattern [path...]`
+  - 外部 grep（`grepprg`）を実行して quickfix list を作成
+  - シェル経由ではなく argv 配列で安全に実行（シェルインジェクション対策済み）
+  - ワイルドカード（`*.txt` 等）は Ruby の `Dir.glob` で展開
+  - `-Z`（restricted mode）では無効
+- `:lgrep pattern [path...]`
+  - 外部 grep（`grepprg`）を実行して location list を作成
+  - `:grep` と同じセキュリティ仕様
+- 一覧バッファ上で `Enter` : 選択項目へジャンプ（一覧ウィンドウから元の編集ウィンドウへ戻る）
 - 現状の制限:
-  - `:grep`, `:make`, `:cfile`, `:lgrep` は未実装
-  - 一覧バッファ上で `Enter` からのジャンプは未実装
+  - `:make`, `:cfile`, `:lfile` は未実装
+
+### `:git`
+
+- 形式: `:git <subcommand> [args...]`
+- Git 操作の統合インターフェース
+- `-Z`（restricted mode）では無効
+- サブコマンド:
+  - `blame` : 現在ファイルの git blame を表示（read-only バッファ）
+    - blame バッファ内: `p` 親コミットの blame / `P` 前の blame へ戻る / `c` コミット詳細
+  - `status` : git status を表示
+  - `diff` : git diff を表示
+  - `log` : git log を表示
+  - `branch` : ブランチ一覧を表示
+    - branch バッファ内: `Enter` で `:git checkout <branch>` をコマンドラインにプリセット（確認ステップあり）
+  - `checkout <branch>` : 指定ブランチへチェックアウト
+  - `commit` : コミットメッセージ入力バッファを開く
+  - `grep <pattern> [args...]` : git grep -n を実行、結果バッファで Enter ジャンプ
+  - その他の未知サブコマンド: `:!` と同様に alternate screen でシェル実行（例: `:git stash`, `:git rebase -i`）
+- Git バッファは `Esc` / `Ctrl-c` で閉じる
+- Tab 補完: `git help -a` の出力から全サブコマンドを補完候補として提示（セッション内キャッシュ）
+
+### `:gh`
+
+- 形式: `:gh <subcommand> [args...]`
+- GitHub 連携の統合インターフェース
+- `-Z`（restricted mode）では無効
+- サブコマンド:
+  - `link` : 現在ファイル/選択範囲の GitHub URL を生成してクリップボードにコピー
+  - `browse` : 現在ファイルの GitHub URL をブラウザで開く
+  - `pr` : 現在ブランチの PR ページをブラウザで開く
+  - その他の未知サブコマンド: `:!` と同様に alternate screen でシェル実行（例: `:gh issue list`）
+- Tab 補完: `gh help` の出力からサブコマンドを補完候補として提示（セッション内キャッシュ）
 
 ### `:rich`
 
@@ -129,6 +170,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 を停止
+- statusline に `[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`
@@ -144,14 +215,50 @@
 - `stdout` / `stderr` に出力があった場合は `[Ruby Output]` 仮想バッファに表示（返り値も末尾に表示）
 - 利用可能: `ctx`, `editor`, `buffer`, `window`
 
-### `:!`（shell 実行, 最小）
+### `:r` / `:read`（ファイル・コマンド出力の挿入）
+
+- 形式: `:r <file>` または `:r !<command>`
+- ファイルの内容またはシェルコマンドの stdout をカーソル行の下に挿入します
+- 行番号指定可: `:3r file.txt`（3行目の下に挿入）
+- `:r !command` で stderr が出た場合、最初の行をエラーメッセージとして表示します
+
+### `:w !`（バッファ内容をコマンドへパイプ）
+
+- 形式: `:w !<command>` または `:'<,'>w !<command>`
+- バッファ（または範囲指定された行）の内容をシェルコマンドの stdin に渡します
+- 例: `:w !wc -l`（行数カウント）、`:'<,'>w !sort`（選択範囲をソート）
+
+### `:!`（shell 実行）
 
 - 形式: `:!<command>`
-- shell コマンドを同期実行します
-- `stdout` / `stderr` に出力があった場合は `[Shell Output]` 仮想バッファに表示（終了ステータスも表示）
-- 出力がない場合は `shell exit N` をステータス表示
+- alternate screen を一時的に抜けて main screen 上で shell コマンドを同期実行します（Vim 互換）
+- 実行後 "Press ENTER or type command to continue" を表示し、入力待ち後にエディタに復帰
+- 完了後は `shell exit N` をステータス表示
 - `-Z`（restricted mode）では無効
 
+### `:run`（コマンド実行＋結果バッファ）
+
+- 形式: `:run [command]`
+- シェルコマンドを実行し、出力を `[Shell Output]` バッファにストリーム表示（PTY 経由でリアルタイム）
+- `[Shell Output]` バッファは read-only で、最大1つ（再利用される）
+- stdout / stderr はマージされて表示
+- コマンド中の `%` は現在のファイル名に展開される
+- コマンド文字列はシェル引用符を保持（raw 解析）
+- 変更のあるバッファは実行前に自動保存される
+- 引数なしの場合:
+  - そのバッファで直前に実行したコマンドがあればそれを再実行
+  - なければ `runprg` オプションの値を使用
+- バッファごとに実行履歴（直前のコマンド）を保持
+- 実行中のコマンドはステータスラインに表示（`[run] command`、完了後は `[run/exit N] command`）
+- `Ctrl-C` で実行中のプロセスを停止
+- `runprg` オプション: ファイルタイプごとのデフォルト実行コマンド
+  - Ruby: `ruby -w %`
+  - Python: `python3 %`
+  - C: `gcc -Wall -o /tmp/a.out % && /tmp/a.out`
+  - C++: `g++ -Wall -o /tmp/a.out % && /tmp/a.out`
+  - Scheme: `gosh %`
+  - JavaScript: `node %`
+
 ### `:ls` / `:buffers`
 
 - 形式: `:ls`
@@ -247,6 +354,16 @@
 - 各タブに含まれるウィンドウとバッファ名を表示
 - 現在のタブ / ウィンドウは `>` マーカーで示す
 
+### `:d` / `:delete`
+
+- 形式: `:d [count]`, `:{range}d`
+- 行を削除
+
+### `:y` / `:yank`
+
+- 形式: `:y [count]`, `:{range}y`
+- 行をヤンク
+
 ## 内部コマンド（主なもの）
 
 内部コマンドは主に key binding から使われ、`RuVim::CommandRegistry` に登録されます。
@@ -302,6 +419,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 +460,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/done.md

@@ -47,6 +47,7 @@
 - `docs/plugin.md`（拡張 / plugin 的な書き方）
 - block-based keymap DSL（`nmap/imap/map_global ... do |ctx, ...| end`）
 - plugin 向け `ctx.editor / ctx.buffer / ctx.window` API リファレンス（未確定 API 注記つき）
+- `:run` コマンド（PTY ストリーミング、`runprg` オプション、バッファごと実行履歴、`%` ファイル名展開、auto-save、Ctrl-C 停止、status line にコマンド表示）
 
 ## Rich mode / 構造化データ表示
 
@@ -77,6 +78,7 @@
 - PageUp / PageDown 対応
 - `:q` の window/tab/app クローズ挙動を Vim 寄りに調整
 - hit-enter prompt（複数行メッセージ表示: `:ls`, `:args`, `:set`, `:command`）
+- カーソル形状制御（DECSCUSR: Normal では非表示+セル反転、Insert ではバーカーソル）
 
 ## Unicode / 日本語 / 表示幅 / 座標系
 
@@ -99,7 +101,11 @@
 - CI / 開発体験（GitHub Actions, `rake docs:check`, `rake ci`）
 - シンタックスハイライト（最小）
 - Markdown シンタックスハイライト（`Lang::Markdown` に抽出、通常モード + Rich mode で共有）
+- C 言語モード（`Lang::C`）: シンタックスハイライト・スマートインデント・保存時 gcc チェック
+- C++ 言語モード（`Lang::Cpp`）: C の全機能 + C++ 固有キーワード・アクセス指定子インデント・保存時 g++ チェック
 - 補完基盤（Ex 補完 / Insert mode 補完）
+- git/gh サブコマンドの Tab 補完（`git help -a` / `gh help` から動的取得、セッション内キャッシュ）
+- 未知の `:git` / `:gh` サブコマンドのシェルフォールバック実行
 
 ## CLI オプション（Vim 風・実装済み / placeholder 含む）
 
@@ -124,6 +130,23 @@
 - `-q {errorfile}`（quickfix 読み込み起動）
 - `-S [session]`（session 読み込み）
 
+## セキュリティ修正
+
+- `:grep` / `:lgrep` のシェルインジェクション対策（argv 配列実行 + `Dir.glob` 展開）
+- Rich view レンダリング時のターミナルエスケープインジェクション対策（制御文字の無害化）
+- Restricted mode (`-Z`) の網羅強化（`:grep`, `:lgrep`, `:git`, `:gh` を無効化）
+- Git branch checkout の安全化（Enter で即時実行せずコマンドラインにプリセットして確認ステップを挟む）
+- 非同期ファイルローダーの OOM 対策（`bulk_once` モード廃止、チャンク読み込み）
+- 特殊ファイル（FIFO/デバイス/ソケット）の読み込み拒否（`Buffer.ensure_regular_file!` で統一ガード）
+
+## Stream クラス階層化 / StreamMixer リネーム
+
+- `@loading_state` を Stream に統合し、非同期ファイルロード状態を `Stream::FileLoad` で管理
+- Stream を基底クラス + 5 サブクラス（`Stdin`, `Run`, `Follow`, `FileLoad`, `Git`）に分離
+- fire-on-new パターン: `new` 時点でスレッド/ウォッチャーを即時起動
+- `stop_handler` をコンストラクタで渡す（`attr_reader`）
+- `StreamHandler` を `StreamMixer` にリネーム（責務を明確化: イベントキューの合流・分配）
+
 ## ドキュメント整理 / 仕様整備
 
 - `docs/spec.md`, `docs/tutorial.md`, `docs/binding.md`, `docs/command.md`, `docs/config.md`, `docs/vim_diff.md` の継続更新