ruvim 0.4.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 状態
 
 ## コマンドモデル
 
@@ -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 に戻す
@@ -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` を使用
 
@@ -371,6 +374,11 @@ RuVim::ExCommandRegistry.instance.register(
 - `: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`
@@ -410,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`（現状仕様）
 
@@ -433,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 コマンド（現状仕様）
@@ -477,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
 
@@ -500,7 +526,7 @@ ANSI エスケープシーケンスによる再描画です。
 - `:tabnew [path]` で新しいタブを作成
 - `:tabnext`, `:tabprev` で移動
 - `:tabs` で全タブ一覧を表示（各タブのウィンドウとバッファ名）
-- ステータスラインに `tab:n/m` を表示（タブが2つ以上のとき）
+- statusline に `tab:n/m` を表示（タブが2つ以上のとき）
 - 各タブは以下を独立に保持
   - window list（表示中 window 群）
   - current window
@@ -711,9 +737,30 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
 
 - 描画時に filetype ごとの regex ベース highlighter を適用
 - 現状の対応 filetype:
-  - `ruby`
-  - `json` / `jsonl`
+  - `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
@@ -742,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` を整形後の表示カラムに変換し、スクロールオフセットを決定
@@ -812,6 +860,7 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
 ### Git Blame
 
 `<C-g>` で `:git ` プリセットのコマンドラインモードに入る。`:git <subcommand>` で実行。
+未知のサブコマンドは `:!` と同様に alternate screen を抜けてシェルで直接実行する（例: `:git stash`）。`:gh` も同様（例: `:gh issue list`）。
 
 ### GitStatus
 
@@ -827,7 +876,11 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
 
 ### GitBranch
 
-`:git branch` で `git branch -a` の結果を `kind: :git_branch` の読み取り専用バッファで表示。コミット日時の新しい順にソート。各行にブランチ名、日付、最新コミットのサブジェクトを表示。Enter でカーソル行のブランチをチェックアウト。
+`: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
 
@@ -836,7 +889,8 @@ Visual mode と同様に Normal mode の上に乗るモードとして設計さ
 ### GitBlame
 
 - **Blame バッファ**: `kind: :blame`、readonly、modifiable=false
-- 表示形式: `短縮ハッシュ 著者名 日付 コード行`
+- 表示形式: ガター（行番号エリア）にメタ情報（短縮ハッシュ・著者名・日付）を暗灰色で表示、本文はコードのみで元ファイルの filetype に基づく syntax highlight が適用される
+- `gutter_labels` オプション: バッファに行ごとのガターラベルを設定する汎用機能。設定されると行番号の代わりにラベルを表示
 - 内部で `git blame --porcelain` を使用して構造化パース
 - ソースファイルのカーソル行位置を引き継ぐ
 
@@ -848,6 +902,38 @@ Blame バッファ内のバッファローカルバインディング:
 
 実装: `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` を利用

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,7 @@ 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 で開く）
@@ -146,6 +146,14 @@ ruvim -p a.rb b.rb
 - `: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` 相当）
 

data/docs/vim_diff.md

@@ -84,6 +84,19 @@ RuVim は「Vim ライクな Ruby 製ターミナルエディタ」です。Vim
 - 補完: Ex コマンド名 + 引数補完, Insert mode buffer words（`Ctrl-n` / `Ctrl-p`）
 - 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 対策）
+
 ## 動作の微細な差分
 
 - undo 粒度は簡略化（Insert mode は「入ってから出るまで」が 1 undo 単位）

data/ext/ruvim/extconf.rb

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