chore: complete tui-command-mode ticket

This commit is contained in:
Keisuke Hirata 2026-05-24 08:39:25 +09:00
parent 8daa0f1a01
commit ebff9a0293
No known key found for this signature in database
2 changed files with 0 additions and 64 deletions

View File

@ -11,7 +11,6 @@
- ストリーム途中失敗時の継続 → [tickets/llm-worker-stream-continuation.md](tickets/llm-worker-stream-continuation.md)
- E2E テストハーネス(`tests/e2e/`、opt-in → [tickets/e2e-harness.md](tickets/e2e-harness.md)
- TUI 拡充
- TUI command mode / registry / completion → [tickets/tui-command-mode.md](tickets/tui-command-mode.md)
- command modeから任意タイミングで Compact を発火 → [tickets/tui-system-command-compact.md](tickets/tui-system-command-compact.md)
- navigation mode / block focus の設計 → [tickets/tui-navigation-mode-design.md](tickets/tui-navigation-mode-design.md)
- spawned child Pod の一覧と一時 attach → [tickets/tui-spawned-pod-panel.md](tickets/tui-spawned-pod-panel.md)

View File

@ -1,63 +0,0 @@
# TUI: command mode / command registry / completion
## 背景
TUI には通常の user message 入力に加えて、Compact、rollback、queue 操作、Pod attach/restore など、LLM に送らない制御操作が増えつつある。既存の入力欄には `@` FileRef、`#` KnowledgeRef、`/` WorkflowRef があり、system command を `/compact` 等に寄せると既存の参照・補完体系と衝突する。
また、制御操作を Ctrl/Alt shortcut だけで増やしていくと発見性が低く、keybinding が破綻しやすい。通常入力を守りつつ、system 操作の正規導線として `:` command mode を用意する。
本チケットは command mode の土台のみを実装する。Compact 実行など具体的な system command は後続 ticket で扱う。
## 方針
- `:` で command mode に入る。
- command mode 中は input area を command input として扱い、通常 user message と明確に分離する。
- `Esc` で command mode を抜け、通常 composer に戻る。
- `Enter` で command registry に dispatch する。
- 未知 command / 引数不正は Pod に送らず TUI 側で診断する。
- command mode の command は LLM への user message として history に混入しない。
- 既存の `@` / `#` / `/` 補完や typed segment は通常 composer 側の機能として維持する。
## 要件
- TUI に mode state を追加する。
- 少なくとも `Composer``Command` を区別する。
- status / actionbar 等で現在 command mode であることが分かる。
- `:` key で command mode に入る。
- 通常 composer に `:` を入力したい場合の escape / literal 入力方針は実装時に決める。
- 最小実装では、空 composer または通常 mode で `:` を押した時に command mode へ入る等、誤爆しにくい条件にしてよい。
- command mode の入力編集を実装する。
- text insert / backspace / cursor movement / clear / Esc / Enter。
- 通常 composer の buffer を破壊しない。
- command registry を追加する。
- command name、aliases、usage、description、argument parser、実行可否判定、executor を登録できる構造にする。
- 最初は built-in の no-op / help / unknown 診断だけでもよい。
- 後続 `tui-system-command-compact``compact` command を追加できる形にする。
- completion / suggestion を実装する。
- prefix に応じた command 候補を actionbar / popup / input 下部などに表示する。
- Tab で候補補完するか、候補表示だけにするかは実装時に決める。既存 completion との衝突を避ける。
- tests を追加する。
- `:` で command mode に入り、Esc で戻る。
- command 入力が通常 composer を壊さない。
- unknown command が user message として送信されない。
- registry から候補が出る。
- command mode 中の Enter が `Method::Run` を送らない。
## 完了条件
- TUI に command mode があり、通常 composer と視覚的・状態的に区別できる。
- command registry があり、後続 ticket で `compact` などを追加できる。
- command completion / suggestion が最低限機能する。
- command mode の入力は LLM user message として送信されない。
- 既存の composer 入力、`@` / `#` / `/` 補完、Run 中 queue、rollback restore を壊さない。
- `cargo fmt --check`
- `cargo check --workspace`
- `cargo test -p tui`
## 範囲外
- `compact` command の実行。
- manual rollback command の実行。
- Pod attach/restore command の実行。
- navigation mode / block focus。
- Vim 互換の本格 command line。