From c1d4d0b65cd0946d56c25520ca099c64d1a72ffa Mon Sep 17 00:00:00 2001 From: Hare Date: Sat, 23 May 2026 07:15:30 +0900 Subject: [PATCH] chore: complete tui-context-usage-indicator ticket --- TODO.md | 1 - tickets/tui-context-usage-indicator.md | 50 -------------------------- 2 files changed, 51 deletions(-) delete mode 100644 tickets/tui-context-usage-indicator.md diff --git a/TODO.md b/TODO.md index a9675b4c..5f8781d4 100644 --- a/TODO.md +++ b/TODO.md @@ -22,7 +22,6 @@ - ユーザーマニフェストのモデル設定 wizard → [tickets/tui-user-model-setup.md](tickets/tui-user-model-setup.md) - spawn 失敗時に Pod の stderr が TUI に表示されない → [tickets/tui-spawn-error-surface.md](tickets/tui-spawn-error-surface.md) - 巻き戻されたターンの入力テキストを編集領域に復元 → [tickets/tui-empty-turn-restore.md](tickets/tui-empty-turn-restore.md) - - セッションコンテキスト長 / ウィンドウ占有率の常時表示 → [tickets/tui-context-usage-indicator.md](tickets/tui-context-usage-indicator.md) - メモリ機構 - Memory extract の input occupancy cap を撤廃 → [tickets/memory-extract-remove-input-cap.md](tickets/memory-extract-remove-input-cap.md) - extract / consolidation 監査ログ → [tickets/memory-audit-log.md](tickets/memory-audit-log.md) diff --git a/tickets/tui-context-usage-indicator.md b/tickets/tui-context-usage-indicator.md deleted file mode 100644 index 8ed37c04..00000000 --- a/tickets/tui-context-usage-indicator.md +++ /dev/null @@ -1,50 +0,0 @@ -# TUI: セッションコンテキスト長 / ウィンドウ占有率の常時表示 - -## 背景 - -TUI の status line は現状、Run 単位の `↑net upload / ↓output` トークンしか出していない（`crates/tui/src/app.rs:55-61`、`crates/tui/src/ui.rs:850-895`）。これは「このターンで実際に課金される転送量」を示すには適切だが、「今このセッションがコンテキストウィンドウのどこにいるか」をユーザーが把握する手段がない。 - -Pod は `Event::Usage` で LLM 1 リクエスト分の `input_tokens`（cache 込みの prompt prefix 占有量）を毎回送ってきており（`crates/protocol/src/lib.rs:301-306`）、最新値がそのまま「現在のセッションコンテキスト長」になる。受信はしているが、TUI は cache 控除して run 集計に積むだけで保持していない。 - -ユーザーは compaction やプロンプト重複の発生を体感するために、コンテキスト消費を常に視認したい。 - -## 方針 - -3 段階の最小拡張で済ませる： - -1. **TUI**: `Event::Usage::input_tokens`（cache 控除しない素の値）の最新値をセッション状態として持ち、status line に常時表示する。`Event::CompactDone` でリセット。 -2. **Protocol**: `Greeting` に `context_window: u64` と `context_tokens: u64` を追加。前者はモデルのウィンドウ上限、後者は attach 時点の `Pod::total_tokens()` 推定値（次の Usage 到着まで TUI に表示できる初期値）。 -3. **Manifest / Pod**: モデルのコンテキストウィンドウは provider catalog のモデルメタに常設の値として持たせ、必要なら manifest 側で override できる経路を 1 つ用意する。配置（catalog エントリの新フィールド or `ModelCapability` 拡張 or `[worker] context_window`）は実装着手時に確定。Greeting 構築時には必ず具体値が入る。 - -`Event::Usage` 自体は既存の wire を踏襲する。新イベントを足さない。 - -## 要件 - -- Run 中・Idle 中・Paused 中いずれでも status line に `ctx: / (%)` を表示する。 -- セッション初期値: `Event::History` の `context_tokens` を採用。最初の `Event::Usage` 受信で上書き。 -- 更新トリガ: - - `Event::Usage::input_tokens` 受信ごとに最新値で上書き（cache 控除しない素の値）。 - - `Event::CompactDone` で 0 にリセット（次の Usage で上書き）。`Event::CompactStart` / `Event::CompactFailed` ではリセットしない。 -- `Event::TurnStart` / `RunEnd` ではリセットしない（run 集計とは別のセッション単位指標）。 -- 既存の run 集計（`request: N | ↑x/↓y | tool: ...`）は残す。`ctx:` は別フィールドとして併置する。 - -## 完了条件 - -- TUI 起動から終了まで、status line にコンテキスト消費とウィンドウ占有率が常時出ている。 -- compact が走った直後、`ctx:` が一旦 0 に戻り、次のリクエストでセッション開始サイズが入る挙動が見える。 -- カタログ未掲載モデルを inline で指定した場合でも、manifest 側 override で値を入れれば同じ表示になる。 - -## 範囲外 - -- 履歴ビュー側でのターンごとコンテキスト推移グラフ。 -- 課金額（USD）換算表示。 -- compact 閾値 / `compact_request_threshold` との対比可視化（threshold バー等）。本チケットは現値の表示までで、警告色の閾値運用は別チケット。 -- pod_cli 等他クライアントの同等表示（TUI 限定）。 - -## 影響範囲 - -- `crates/protocol/src/lib.rs`: `Greeting` に `context_window: u64` / `context_tokens: u64` 追加。 -- `crates/manifest` / `crates/provider/src/catalog.rs`: context window をモデルメタとして宣言する経路。実装着手時に置き場所を確定。 -- `crates/pod/src/controller.rs`: `build_greeting` で window と `total_tokens()` を Greeting に詰める。 -- `crates/tui/src/app.rs`: `App` に `session_context_tokens: u64` と `context_window: u64` を持たせ、`handle_pod_event` で更新。 -- `crates/tui/src/ui.rs`: `draw_status` に `ctx:` フィールドを追加。