From a3082072d72d196fe149e1d457c1e5d3c47d274b Mon Sep 17 00:00:00 2001 From: Hare Date: Mon, 4 May 2026 17:03:51 +0900 Subject: [PATCH] =?UTF-8?q?docs(tickets):=20Compaction=E9=80=B2=E8=A1=8C?= =?UTF-8?q?=E4=B8=AD=E3=81=AE=E3=83=A9=E3=82=A4=E3=83=96=E8=A1=A8=E7=A4=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- TODO.md | 1 + tickets/tui-compact-progress.md | 41 +++++++++++++++++++++++++++++++++ 2 files changed, 42 insertions(+) create mode 100644 tickets/tui-compact-progress.md diff --git a/TODO.md b/TODO.md index dad22c1e..f7c8e155 100644 --- a/TODO.md +++ b/TODO.md @@ -16,6 +16,7 @@ - 巻き戻されたターンの入力テキストを編集領域に復元 → [tickets/tui-empty-turn-restore.md](tickets/tui-empty-turn-restore.md) - セッションコンテキスト長 / ウィンドウ占有率の常時表示 → [tickets/tui-context-usage-indicator.md](tickets/tui-context-usage-indicator.md) - Task ストア状態の表示（入力欄上ミニビュー + サイドペイン） → [tickets/tui-task-display.md](tickets/tui-task-display.md) + - Compaction 進行中のライブ表示 → [tickets/tui-compact-progress.md](tickets/tui-compact-progress.md) - Manifest: Tool Output / File Upload 上限の分離とデフォルト緩和 → [tickets/manifest-output-upload-limits.md](tickets/manifest-output-upload-limits.md) - メモリ機構 - 使用頻度メトリクス + Knowledge 化候補レポート → [tickets/memory-usage-metrics.md](tickets/memory-usage-metrics.md) diff --git a/tickets/tui-compact-progress.md b/tickets/tui-compact-progress.md new file mode 100644 index 00000000..0d4b9786 --- /dev/null +++ b/tickets/tui-compact-progress.md @@ -0,0 +1,41 @@ +# TUI: Compaction 中の進行表示 + +## 背景 + +Pod で compact が走ると `Event::CompactStart` が 1 本流れ、その後 compact worker (要約 / auto-read 判定 / リファレンス選定) が走り終えるまで TUI には何も流れない。完了時に `Event::CompactDone` または `CompactFailed` が来てようやく次の block が積まれる。 + +実時間で数十秒〜分単位かかる区間が完全な無音になり、ユーザーからは「固まった」「Pod が落ちた」と区別がつかない。 + +現状の TUI 表示 (`crates/tui/src/app.rs:651-661`、`crates/tui/src/ui.rs:799-821`) は `CompactStart` / `CompactDone` / `CompactFailed` をそれぞれ独立した append-only な block として積んでいるだけで、進行中であることや経過時間は出ていない。 + +ThinkingBlock は同種の「LLM が応答するまでの待ち時間」を `ThinkingState::Streaming { started_at }` + ライブで `Thinking... (Xs)` 表示で扱っている (`crates/tui/src/block.rs:67-78`)。Compact も同じパターンに揃えたい。 + +## 要件 + +- compact 中であることがライブで分かる。経過秒数を 1 行で表示する (`Compacting... (Xs)` 程度) +- 完了 / 失敗時は進行表示が結果行に **置き換わる**。1 回の compact で block が 2 個積まれるのではなく、Start で積んだものを Done / Failed が更新する +- 完了行は新 session_id の short prefix と所要時間を含む +- 失敗行はエラー文と所要時間を含む +- 進行中のまま `Event::Shutdown` 等で取り残された場合は ThinkingState::Incomplete に相当する終端状態に落とす +- ステータスライン (`draw_status`) はこのチケットでは触らない。block 側のライブ表示のみ + +## 完了条件 + +- compact が走っている間、TUI 末尾に `Compacting... (Xs)` が出て、s が秒単位で進む +- compact 成功で同じ行が `[compact] done (new session XXXXXXXX) (Ys)` 相当に更新される +- compact 失敗で同じ行が `[compact error] ... (Ys)` 相当に更新される +- 1 回の compact イベント列で `Block::Compact` は 1 個しか積まれない (履歴を遡っても重複しない) +- 既存テストが通る + +## 範囲外 + +- 要約 worker の中身 (read_file ループ等) を TUI に流す仕組み +- ステータスラインへの `Compacting…` 表示 +- session_id の TUI 表示全般 (旧 / 新 / 親 / 子セッション系譜の可視化は別チケット) +- compact がそもそも動いているかどうかの設定確認 UI + +## 関連 + +- `docs/compaction.md` — compact のトリガーとイベント並びの全体像 +- `crates/tui/src/block.rs` の `ThinkingBlock` / `ThinkingState` — 同型のライブ進行表示の前例 +- `crates/tui/src/app.rs:714-746` — `last_streaming_thinking_mut` / `mark_orphan_thinking_incomplete` の参考実装