2.3 KiB
2.3 KiB
TUI: Run 中の入力キューイング
背景
Pod は Method::Run を Run 中に受け取ると AlreadyRunning で即座に拒否する設計（1 turn = 1 message）。これはプログラマティックなクライアント（pod_cli、Pod 間通信の sendToPod）にとっては自然な契約だが、TUI で人間が操作している場合、「現ターンが終わるのを待って次を投げる」ためにユーザーが目視で完了を待つ必要があり、テンポが悪い。
「次のターンが終わり次第すぐに投げる」を可能にしたい。
方針
プロトコルには載せず、TUI クライアント側でキューを持つ。
理由：
- キューイングは人間が連続入力する TUI 固有の都合。pod_cli や Pod 間通信は 1 turn = 1 message が自然で、不要な抽象を背負わせない。
- キュー上のメッセージは「まだ送信していないユーザー入力」であり、送信前のキャンセル・編集が自然にできるべき。これは TUI ローカル状態で扱うのが素直。
- Pod controller / protocol への変更が不要。他クライアントへの影響ゼロ。
要件
- Run 中に Enter で送信した入力は TUI 内のキューに積まれる（即座に Pod に送信されない）。
- 現在の Run が
RunEndで終了したら、キュー先頭をMethod::Runとして送信する。 - キューに積まれた状態がユーザーから見える（積まれていることが分かる UI 表現）。
- キュー内のメッセージは送信前にキャンセル・編集できる。
- Pause 中の Resume 入力との関係を整理する（Resume はキューイングではなく即座に発火、で良いはず）。
- キャンセル（
Method::Cancel）が走った場合、キューをどう扱うかを決める（破棄が妥当と思われるが要検討）。
完了条件
- TUI で Run 中に入力を送信すると、現ターン終了直後に自動で次が投げられる。
- 積まれた状態と、送信前のキャンセル・編集ができる。
- pod プロトコルや pod crate に変更が入っていない。
範囲外
- 複数 Pod 間でのキュー共有・転送
- キューの永続化（TUI 再起動をまたぐ保存）
- キュー内メッセージの優先度・並び替え（FIFO で十分）