ruvim 0.1.0 → 0.3.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 に未読データが残っていればレンダリングをスキップして追加のキーを読み取り・処理する（ペースト高速化）
+6. `RuVim::Screen` が再描画
 
 ## 起動オプション（CLI, 現状）
 
@@ -189,7 +190,8 @@ RuVim::ExCommandRegistry.instance.register(
 - `-Z`
   - restricted mode（現状）
   - user config / ftplugin を読み込まない
-  - `:ruby` を禁止する
+  - `:ruby` / `:rb` を禁止する
+  - `:!` を禁止する
 - `-n`
   - 現状は no-op（将来の swap / 永続 undo / session 互換の先行予約）
 - `-o[N]`, `-O[N]`, `-p[N]`
@@ -210,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 読み込み前に実行します。
 
@@ -252,6 +265,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `p`, `P`: paste
 - `r<char>`: 1文字置換
 - `c` + motion / `cc`: change（削除して Insert mode）
+- `=` + motion / `==`: auto-indent（Ruby filetype でインデント自動調整。`=j`, `=G` 等）
 - `v`: Visual (characterwise)
 - `V`: Visual (linewise)
 - `Ctrl-v`: Visual (blockwise, 最小)
@@ -262,6 +276,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `N`: 直前検索を逆方向に繰り返し
 - `1..9` + 動作: count（例: `3j`, `2x`）
 - 矢印キー: 移動
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 
 ### Insert mode
 
@@ -272,6 +287,7 @@ RuVim::ExCommandRegistry.instance.register(
 - `Esc`: Normal mode に戻る
 - `Ctrl-c`: Normal mode に戻る（終了しない）
 - 矢印キー: 移動
+- `Ctrl-z`: shell へ suspend（`fg` で復帰）
 
 ### Visual mode（現状）
 
@@ -283,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
 
 - `:` で入る
@@ -296,27 +324,53 @@ 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>`
 - `:ls` / `:buffers`
 - `:bnext` / `:bn`
 - `:bprev` / `:bp`
 - `:buffer <id|name|#>` / `:b <id|name|#>`
+- `:bdelete[!] [id|name|#]` / `:bd[!] [id|name|#]`
 - `:split`
 - `:vsplit`
 - `:tabnew [path]`
 - `:tabnext` / `:tabn`
 - `:tabprev` / `:tabp`
+- `:vimgrep`, `:lvimgrep`
+- `:copen`, `:cclose`, `:cnext` / `:cn`, `:cprev` / `:cp`
+- `:lopen`, `:lclose`, `:lnext` / `:ln`, `:lprev` / `:lp`
+- `:rich [format]`
 
 ## 検索仕様（現状）
 
@@ -341,10 +395,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`（現状仕様）
 
@@ -362,7 +426,15 @@ RuVim::ExCommandRegistry.instance.register(
   - `editor`
   - `buffer`
   - `window`
-- 返り値はステータスラインに表示（`inspect`）
+- `stdout` / `stderr` に出力があれば `[Ruby Output]` 仮想バッファに表示（返り値も表示）
+- 出力がない場合、返り値をステータスラインに表示（`inspect`）
+
+### `:!`（shell 実行, 最小）
+
+- `:!<command>` で shell コマンドを同期実行
+- `stdout` / `stderr` があれば `[Shell Output]` 仮想バッファに表示（終了ステータスを含む）
+- 出力がない場合は `shell exit N` をステータス表示
+- restricted mode（`-Z`）では禁止
 
 ### バッファ管理 Ex コマンド（現状仕様）
 
@@ -373,6 +445,7 @@ RuVim::ExCommandRegistry.instance.register(
   - 数値ID
   - パス名 / basename
   - `#`（alternate buffer）
+- `:bdelete` / `:bd` : バッファ削除（未保存は `!` 必須）
 
 ### alternate buffer（`#`）
 
@@ -380,6 +453,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 エスケープシーケンスによる再描画です。
@@ -387,24 +470,31 @@ ANSI エスケープシーケンスによる再描画です。
 - 代替スクリーン (`?1049h / ?1049l`)
 - カーソル非表示/表示 (`?25l / ?25h`)
 - 行キャッシュによる簡易差分描画（同サイズ時）
-- 最下段: status line
-- Command-line mode 時は最下段を command-line、1つ上を status line
+- フッターは 2 行固定:
+  - 最下段: command line / error message 用
+  - 1つ上: status line
+- Command-line mode 時も status line は維持し、最下段だけを入力行として使う
 - ファイル未指定起動時は 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
@@ -417,6 +507,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 ごとの履歴保持（`:` `/` `?`）
@@ -501,12 +597,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（現状）
 
@@ -573,12 +672,12 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
   - `:set`
   - `:setlocal`
   - `:setglobal`
-- 実装済み option:
-  - `number`（window-local, bool）
-  - `relativenumber`（window-local, bool）
-  - `ignorecase` / `smartcase` / `hlsearch`（global, bool）
-  - `tabstop`（buffer-local, int）
-- `Screen` は `number` / `relativenumber` / `tabstop` を描画に反映する
+- 実装済み option は `RuVim::Editor::OPTION_DEFS` に定義（現状 `49` 個）
+- 代表例:
+  - 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`, `onsavehook`
+- 詳細な一覧・実装状況は `docs/config.md` を参照
 
 ## Filetype / ftplugin（現状の基礎）
 
@@ -591,19 +690,82 @@ 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`
+  - `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）
+- **起動方法**:
+  - `: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,15 +803,15 @@ Vim 完全互換ではなく、まずは扱いやすい粒度を優先した仕
   - `test/dispatcher_test.rb`
   - `test/keymap_manager_test.rb`
 
-## 既知の未実装 / 今後の仕様候補
-
-- Undo / Redo
-- 複数 window split
-- Tabpage
-- レジスタ（yank/delete）
-- 検索 (`/`, `?`)
-- operator-pending（`d` + motion）
-- 差分描画
-- filetype / buffer-local keymap
-- user-defined Ex command DSL（`:command`）
-- `:ruby`（Ruby 式評価）
+## 既知の未実装 / 今後の仕様候補（現状）
+
+- 永続 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` 等）
+- `Ctrl-w` resize / close-others / equalize など window 操作拡張
+- `:set` 高度構文（`+=`, `-=`, `:set all`, 短縮名）
+- tag jump / folds / `:global` / `:normal`
+- LSP / diagnostics / fuzzy finder など中長期機能

data/docs/todo.md

@@ -18,28 +18,144 @@
   - `docs/config.md`
   - `docs/vim_diff.md`
 
-## TODO Vim 互換性の精度向上
+## 直近の優先順（推奨）
+
+1. Vim 互換性の精度向上（word/paste/visual/scroll 細部）
+2. 永続化（`undofile` / session）
+3. option system の残件（P0/P1 の `PARTIAL` を詰める）
+4. P2 option（永続化/外部連携系）
+5. P3 長期機能（LSP / fuzzy finder）
+
+## 次の1週間の実装順（提案・改訂版）
+
+### Day 1: quickfix を「使える入口」までつなぐ
+
+- `[DONE]` `quickfix` / `location list` バッファで `Enter` ジャンプ
+  - qf 行フォーマット -> location 解決
+  - cursor 行の項目へ移動（window 復帰含む）
+- docs 更新
+  - `docs/command.md`, `docs/vim_diff.md`
+
+### Day 2: quickfix 入口コマンド（P0）
+
+- `:grep`, `:lgrep`（外部 grep -> qf/loclist）
+- `:cfile`, `:lfile`（ファイルから qf/loclist 読み込み）
+- `:make` は `makeprg/errorformat` 最小の雛形まで（全部入りは後回し）
+- まずは「動く最小」優先（精度は P2 option 実装と一緒に詰める）
+
+### Day 3: Ex 基盤（range + substitute flags の前段）
+
+- Ex 範囲指定（address / range）の基礎
+  - `.` / `%` / 行番号
+  - `:1,10d`, `:%y`, `:.,$...`
+- `:substitute` の range 連携準備（既存 `:%s` パーサの拡張）
+
+### Day 4: `:substitute` フラグ拡張 + scroll 細部
+
+- `:substitute` フラグ（`i`, `I`, `n`, `e`, `c` の主要）
+- `Ctrl-e` / `Ctrl-y` / `Ctrl-d` / `Ctrl-u` の細部調整
+  - count, 端での挙動, row_offset/cursor_y の整合
+- docs 更新
+  - `docs/command.md`, `docs/binding.md`
+
+### Day 5: paste / visual の互換性詰め
+
+- `p`, `P` のカーソル位置ルール調整（charwise / linewise）
+- Visual mode の端点/inclusive ルール整理
+- Visual block の最小 blockwise paste（`p`）
+- テスト追加（操作シナリオ + snapshot）
+
+### Day 6: word motion 精度 + `iskeyword` 連携の詰め
+
+- `w`, `b`, `e` の境界判定を Vim に寄せる
+- `iskeyword` との整合（word motion / text object / `*`）
+- 日本語/記号混在ケースの回帰テスト追加
+
+### Day 7: 永続化の第一段（undofile 先行）
+
+- `undofile`, `undodir` option 実体化
+- 保存時/終了時の undo dump（最小）
+- ファイル再オープン時の undo restore（path ベース）
+- エラー時の degrade（読めない/壊れた undo file は無視してメッセージ）
+- docs 更新
+  - `docs/config.md`, `docs/spec.md`, `docs/vim_diff.md`
+
+### 次の週に回す候補（この週の続き）
+
+- session file（`-S [session]` placeholder 実体化）
+- `wrap` / `linebreak` / `breakindent` / `showbreak` の整合性
+- `wildmenu` / `completeopt` / `pumheight` の UI コンポーネント寄せ
+- arglist 残件（`:args/:next/:prev` の挙動精度向上）
+
+### この順番の理由（依存）
+
+- `quickfix` は既に内部モデルがあるので、入口（`Enter`, `:grep` 系）を先に作ると体験改善が大きい
+- Ex range と `:substitute` flags は同じパーサ/Dispatcher 周辺を触るので連続でやる方が安全
+- `paste/visual/word motion` は互換性テストをまとめて増やしやすい
+- `undofile` は session より独立度が高く、先に基盤化するとその後の作業でも安全
+
+## TODO Vim 互換性の精度向上（精度・挙動の詰め）
 
 - Vim 互換性の精度向上（word motion / paste / visual 挙動）
   - `w`, `b`, `e` の境界判定を Vim に寄せる
   - `p`, `P` のカーソル位置ルールを調整
   - Visual mode の端点/inclusive ルールを整理
+  - Visual block の blockwise paste / text object
+  - `Ctrl-e` / `Ctrl-y` / `Ctrl-d` / `Ctrl-u` の細部挙動（Vim との差分詰め）
+
+## TODO Vim 差分で実用上効く追加機能（未着手）
+
+### P0: すぐ効く（既存機能の入口/使い勝手を補う）
+
+- quickfix / location list の入口コマンド拡張
+  - `:grep`, `:lgrep`（外部 grep -> qf/loclist）
+  - `:make`（`makeprg` + `errorformat` の最小連携）
+  - `:cfile`, `:lfile`（ファイルから qf/loclist 読み込み）
+- Ex 範囲指定（address / range）の基礎
+  - `:1,10d`, `:%y`, `:.,$s/.../.../` など
+  - まずは行範囲 + 現在行 (`.`) + 全体 (`%`) を優先
+- `:substitute` フラグ拡張（Ruby regex 方針のまま）
+  - `c`, `i`, `I`, `n`, `e` などの主要フラグ
+  - range 指定との組み合わせ
+
+### P1: Vim 運用でよく触る基盤（あると詰まりにくい）
+
+- `Ctrl-w` window 操作の拡張
+  - `Ctrl-w c`（window close）
+  - `Ctrl-w o`（only / 他 window を閉じる）
+  - `Ctrl-w =`（equalize）
+  - resize 系（`+`, `-`, `<`, `>`, `_`, `|` の最小）
+- `:set` 構文の拡張
+  - `+=`, `-=`, `^=`, `&`, `<`
+  - option 名短縮（例: `nu`, `ts`）
+  - `:set all` / もう少し見やすい一覧表示
+- register 拡張（実用寄り）
+  - `"-`（small delete register）
+  - delete/yank の register 更新ルールを Vim に寄せる
+
+### P2: 中長期で効くが依存が広い
+
+- tags / tag jump（最小）
+  - `Ctrl-]`, `Ctrl-t`, `:tag`, `:tselect`
+  - tags file 読み込み + jump stack
+- Ex の追加制御コマンド
+  - `:global` / `:vglobal`
+  - `:normal` / `:normal!`
+- folds（最小）
+  - `za`, `zc`, `zo`
+  - 表示・カーソル移動・検索の整合
 
 ## TODO 永続化
 
 - 永続 undo / セッション
-  - undo history 保存
-  - session file（開いている buffer / cursor 位置）
+  - `undofile` / `undodir` 実体（保存・復元）
+  - session file（開いている buffer / cursor 位置 / tab/window レイアウト）
+  - `-S [session]` の実体化（現在 placeholder）
 
 ## TODO 長期（規模大）
 
 ### P3: 長期（人気はあるが規模大）
 
-- LSP / diagnostics（中長期）
-  - language server 起動管理
-  - diagnostics 表示
-  - definition / references ジャンプ
-
 - LSP diagnostics + jump（最小）
   - 効果: 高
   - コスト: 高
@@ -56,8 +172,65 @@
     - grep/検索基盤
     - preview（任意）
 
-## メモ（方針）
+## TODO option system 拡張（残件のみ）
+
+注記:
+- 実装済みの `number`, `relativenumber`, `ignorecase`, `smartcase`, `hlsearch`, `tabstop`, `filetype` は除外
+- 完了済みの option 実装は `docs/done.md` と `docs/config.md` を参照
+- ここには `PARTIAL` / 未着手のみを残す
+
+### P0: 日常編集の体験差が大きい（残件）
+
+- `[PARTIAL]` `wrap`（長い行を折り返す）
+- `[PARTIAL]` `linebreak`（単語境界寄りで折り返す）
+- `[PARTIAL]` `breakindent`（折り返し行のインデント）
+  - 折り返し時の検索ハイライト/Visual/カーソル表示の整合性
+  - `showbreak` / `breakindent` との組み合わせ挙動
+
+### P1: 使う人が多い / UI と編集体験を整える（残件）
+
+- `[PARTIAL]` `showbreak`（折り返し行の先頭表示）
+- `[PARTIAL]` `signcolumn`（サイン列の表示: `yes` の幅予約のみ）
+- `[PARTIAL]` `matchtime`（`showmatch` のメッセージ表示時間に反映）
+- `[PARTIAL]` `backspace`（Insert mode での BS 挙動: `start/eol` 最小）
+- `[PARTIAL]` `whichwrap`（左右移動が行をまたぐ条件: `h/l` 最小）
+- `[PARTIAL]` `virtualedit`（`onemore`, `all` の最小: 左右移動と描画）
+- `[PARTIAL]` `iskeyword`（単語境界の定義: word motion / 補完 / 一部 textobj）
+- `[PARTIAL]` `completeopt`（補完 UI の挙動: `menu/menuone/noselect` の最小）
+- `[PARTIAL]` `pumheight`（補完候補 UI の高さ: メッセージ表示件数に反映）
+- `[PARTIAL]` `wildmode`（コマンドライン補完の挙動: `list/full/longest` の最小）
+- `[PARTIAL]` `wildmenu`（コマンドライン補完 UI: メッセージ行ベースの簡易表示）
+- `[PARTIAL]` `path`（`gf` の最小パス探索）
+- `[PARTIAL]` `suffixesadd`（`gf` の拡張子補完）
+
+補足（P1 実装の観点）:
+- `PARTIAL` の定義は `docs/config.md` 側で詳細化する
+- `signcolumn` は diagnostics/LSP と一緒に拡張する方が効率がよい
+- `wildmenu` / `completeopt` / `pumheight` は UI コンポーネント化でまとめて詰める
+
+### P2: 実用性は高いが依存が増えやすい / 実装範囲が広い
+
+- `undofile`（永続 undo の ON/OFF）
+- `undodir`（永続 undo の保存先）
+- `updatetime`（アイドル更新間隔。診断/自動処理にも関係）
+- `swapfile`（swap file の ON/OFF）
+- `backup`（バックアップ保存）
+- `writebackup`（書き込み時バックアップ）
+- `autoread`（外部更新の再読込）
+- `[PARTIAL]` `autowrite`（特定コマンド時の自動保存: buffer切替/`:e`/`gf`/`:tabnew` の最小）
+- `confirm`（確認ダイアログ相当の確認フロー）
+- `grepprg`（外部 grep コマンド）
+- `grepformat`（grep 結果のパース形式）
+- `makeprg`（外部 build コマンド）
+- `errorformat`（quickfix のパース形式）
+- `formatoptions`（自動整形/コメント継続の挙動）
+- `textwidth`（自動改行幅）
+- `spell`（スペルチェック ON/OFF）
+- `spelllang`（スペルチェック言語）
+- `[PARTIAL]` `termguicolors`（検索/`cursorline`/`colorcolumn` 背景色の最小 truecolor 対応）
+
+## メモ（実装方針）
 
 - Vim 完全互換の CLI を目指すより、よく使うフラグから互換寄りに実装する
 - Ruby DSL 前提なので、Vim の `-u NONE` / `-U NONE` は RuVim 向けに意味を再定義してよい
-
+- UI/Unicode/折り返し系は `TextMetrics` と `Screen` の責務を増やしすぎないように分割する

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` と `:!` を無効化）
 - `-n`（現状 no-op。将来の swap/永続機能向け互換フラグ）
 - `-o[N]` / `-O[N]` / `-p[N]`（複数ファイルを split / vsplit / tab で開く）
 - `-V[N]` / `--verbose[=N]`（起動/設定/Ex のログを stderr に出す）