71 lines
3.8 KiB
Markdown
71 lines
3.8 KiB
Markdown
# TUI command mode から任意タイミングで Compact を実行する
|
||
|
||
## 背景
|
||
|
||
Compact は現在、manifest の compaction 設定と token 閾値に基づいて Pod 側で自動実行される。TUI は `CompactStart` / `CompactDone` / `CompactFailed` のイベントを受けて履歴上に表示できるが、ユーザーが TUI から任意のタイミングで Compact を明示実行する導線はない。
|
||
|
||
一方、TUI の入力欄にはすでに以下の sigil がある。
|
||
|
||
- `@`: FileRef / clipboard などの添付
|
||
- `#`: KnowledgeRef
|
||
- `/`: WorkflowRef
|
||
|
||
そのため、Compact のような Pod / TUI の制御操作を `/compact` や `#compact` として扱うと、既存の参照・補完体系と衝突する。通常の user message として LLM に送る入力とも明確に区別する必要がある。
|
||
|
||
## ゴール
|
||
|
||
TUI から、会話本文を送らずに任意タイミングで Compact を発火できるようにする。system command の入口は `tickets/tui-command-mode.md` で実装済みの `:` command mode を使い、本チケットでは `compact` command と Pod 側実行経路に集中する。
|
||
|
||
## 前提
|
||
|
||
`tickets/tui-command-mode.md` で TUI の `:` command mode / command registry / completion が実装済みであること。本チケットはその registry に `compact` command を追加し、Pod 側の manual compact 実行経路へ接続する。
|
||
|
||
## 要件
|
||
|
||
### Compact command
|
||
|
||
Command registry に `compact` command を追加する。
|
||
|
||
- `:` command mode から `compact` を実行できる。
|
||
- `/` と `#` は使わない。
|
||
- `@` FileRef とも衝突しない。
|
||
- 入力された system command は LLM への user message として送られない。
|
||
- command の発火は UI 上で見分けられる。
|
||
- 未知 command や引数不正は、Pod に送らず TUI 側でユーザーに診断を出す。
|
||
|
||
### Manual Compact
|
||
|
||
System command から Compact を明示実行できるようにする。
|
||
|
||
- Idle 中に実行できる
|
||
- Run / Pause / spawn dialog / session picker など、実行できない状態では明確に拒否または無効化する
|
||
- 実行時に通常の user message は追加しない
|
||
- 既存の Compact lifecycle 表示（`CompactStart` / `CompactDone` / `CompactFailed`）と整合する
|
||
- Compact 完了後の session rotation / history restore / status 表示が、auto compact と同じ前提で動く
|
||
- compaction 設定が無い、または compactor model が解決できない場合の診断を TUI に出す
|
||
|
||
### Protocol / Pod 側
|
||
|
||
必要であれば、client → Pod の typed control method を追加する。
|
||
|
||
- `Method::Run` に特殊文字列を流す形にはしない
|
||
- Compact 実行は Pod 側の既存 compact 経路を使い、auto compact と履歴・store・broadcast のセマンティクスを分岐させない
|
||
- concurrent run 中の compact 要求、重複 compact 要求、shutdown 中の要求などの状態遷移を明確に扱う
|
||
|
||
## 完了条件
|
||
|
||
- TUI から任意タイミングで Compact を明示実行できる
|
||
- Compact 発火に使う system command の記法またはモードが、`@` / `#` / `/` と衝突していない
|
||
- system command が LLM への user message として history に混入しない
|
||
- 実行不可状態や失敗時の診断が TUI に表示される
|
||
- auto compact と同じ lifecycle event / history rotation 前提で表示が更新される
|
||
- protocol / Pod / TUI の必要なテストが追加されている
|
||
|
||
## 範囲外
|
||
|
||
- command mode / registry / completion の実装（`tickets/tui-command-mode.md`）
|
||
- Compact の要約品質や prompt の変更
|
||
- compaction 閾値・retained token など manifest 設定の再設計
|
||
- slash command と WorkflowRef の意味論変更
|
||
- system command の豊富なコマンド群追加（本チケットでは Compact を最初の利用者として入口を作る）
|