64 lines
3.6 KiB
Markdown
64 lines
3.6 KiB
Markdown
# 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。
|