125 lines
8.5 KiB
Markdown
125 lines
8.5 KiB
Markdown
---
|
|
title: 'TUI Console: 連続した Thinking block を一つの表示グループにまとめる'
|
|
state: 'done'
|
|
created_at: '2026-06-24T11:39:59Z'
|
|
updated_at: '2026-06-24T12:20:08Z'
|
|
assignee: null
|
|
readiness: 'implementation_ready'
|
|
risk_flags: ['tui-rendering', 'reasoning-display', 'block-aggregation', 'text-selection']
|
|
queued_by: 'workspace-panel'
|
|
queued_at: '2026-06-24T12:01:41Z'
|
|
---
|
|
|
|
## User claims / request snapshot
|
|
|
|
- ユーザーは、TUI Console で連続した `Thinking` を `Read` tool 表示のように一つにまとめて表示したいと依頼した。
|
|
- 対象 workspace は `yoi`。
|
|
- Panel handoff の orchestrator Pod は `yoi-orchestrator`。
|
|
|
|
## Confirmed facts / sources
|
|
|
|
- 既存 Ticket 確認では、同じ目的の active duplicate は見当たらなかった。
|
|
- 関連 closed Ticket:
|
|
- `00001KT5D44Z0` — reasoning / thinking persistence を block lifecycle に統一済み。
|
|
- `00001KVMT2J25` — in-flight snapshot が unfinished thinking block を含め、TUI が snapshot から unfinished thinking を seed して live delta 継続できるようにした。
|
|
- `00001KVHX0WBE` — Dashboard / Console / TUI の呼称と module boundary を整理済み。今回の対象は Console / single-Pod chat surface。
|
|
- `00001KTKCK8W8` — chat view の Markdown rendering 改善。今回と同じく表示層の変更であり、history / context 変更は避ける方針が近い。
|
|
- `00001KSVP63K8` は planning の in-flight composer injection で、今回の Thinking 表示集約とは別件。
|
|
- `crates/tui/src/block.rs` では `Block::Thinking(ThinkingBlock)` が独立した history block として存在し、`ThinkingState::{Streaming, Finished, Incomplete}` を持つ。
|
|
- `crates/tui/src/app.rs` では `Event::ThinkingStart` ごとに新しい `Block::Thinking` を push し、`ThinkingDelta` は最後の streaming thinking に追記し、`ThinkingDone` で finished にする。
|
|
- `crates/tui/src/ui.rs` の `compute_history` は block 列を走査し、`Block::ToolCall` だけ `crate::tool::render_tool(...)` に委譲して複数 block 消費を許している。
|
|
- `crates/tui/src/tool.rs` の `Read` renderer は、連続する `Read` tool call block を `render_read_aggregate` でまとめ、1つの header と path list として表示している。
|
|
- `crates/tui/src/ui.rs` の `render_thinking` は現在、各 `ThinkingBlock` を個別に header / body preview / detail として描画している。連続 Thinking をまとめる専用 path は見当たらない。
|
|
|
|
## Unverified hypotheses
|
|
|
|
- 実装は `Read` と同様に `compute_history` 側で連続する `Block::Thinking` をまとめる renderer を導入する形が自然そう。
|
|
- 「連続」は、同じ turn 内で他の block を挟まない `Block::Thinking` の連なりとして扱うのが妥当そう。
|
|
- Normal mode では 1 header + 最新または先頭 preview、Detail mode では各 Thinking body を連結または小見出し付きで読める形にすればよさそう。
|
|
|
|
## Undecided points / open questions
|
|
|
|
- blocking な未決定点はない。
|
|
- 表示文言の細部（例: `Thoughts — 3 blocks` / `Thinking... (3 blocks)` / elapsed 表示の集約方法）は実装者判断でよい。
|
|
- ただし、連続していない Thinking や turn を跨ぐ Thinking までまとめるべきではない、という invariant は維持する。
|
|
|
|
## Background
|
|
|
|
Provider / model によっては 1 turn 内で Thinking / reasoning block が複数連続して発生する。現状の Console 表示では、それぞれが個別の Thinking 表示になり、会話ログが冗長に見える可能性がある。`Read` tool は連続する `Read` call を 1つの表示グループにまとめる既存 UX があるため、Thinking でも同様の表示集約を行う。
|
|
|
|
## Requirements
|
|
|
|
- TUI Console の history rendering で、連続する `Block::Thinking` を一つの logical display group として表示する。
|
|
- 対象は Console / single-Pod chat view の表示層に限定する。
|
|
- `Read` tool の連続 aggregation と同じく、rendering 時に複数 block を消費して一つの表示にまとめられること。
|
|
- 連続していない Thinking、別 turn の Thinking、間に `AssistantText` / `ToolCall` / `User` / `System` などを挟む Thinking はまとめない。
|
|
- `Streaming` / `Finished` / `Incomplete` が混在しても、状態が誤解されない header / body 表示にする。
|
|
- Normal / Detail / Overview mode の既存意味を保つ。
|
|
- Pod history、session log、worker history、prompt context、protocol event model、reasoning persistence は変更しない。
|
|
- In-flight snapshot から復元された unfinished Thinking と live delta continuation の表示が退行しない。
|
|
|
|
## Acceptance criteria
|
|
|
|
- 1 turn 内で `Thinking` block が複数連続する場合、Console history 上では 1つの Thinking group として表示される。
|
|
- 連続 Thinking group は、少なくとも group header と読み取り可能な preview / detail body を持つ。
|
|
- Normal mode で冗長な `Thought` / `Thinking...` header が連続表示されない。
|
|
- Detail mode では、集約された各 Thinking の本文が欠落せず読める。
|
|
- Overview mode でも 1 group として扱われ、行数が不必要に増えない。
|
|
- 間に non-Thinking block がある場合や turn を跨ぐ場合は、別 group として表示される。
|
|
- Text selection / copy の既存方針が壊れない。Thinking は現在 text-like selectable block ではないため、集約後も不用意に selectable transcript text にしない。
|
|
- Read tool aggregation、ToolCall rendering、AssistantText rendering に退行がない。
|
|
- Focused TUI rendering test が追加または更新される。
|
|
|
|
## Binding decisions / invariants
|
|
|
|
- これは TUI Console の表示改善であり、reasoning / thinking の protocol、persistence、provider event semantics の変更ではない。
|
|
- Thinking content を history / context に別形式で保存し直さない。
|
|
- 未完了 Thinking を finalized assistant history と混同しない。
|
|
- `Read` aggregation と同じく render-time aggregation として扱い、source block sequence 自体は保持する。
|
|
- Turn boundary を跨いで group 化しない。
|
|
- Non-Thinking block を跨いで group 化しない。
|
|
- Dashboard / Panel の Ticket rows や web UI は対象外。
|
|
|
|
## Implementation latitude
|
|
|
|
- `compute_history` に `Block::Thinking` の consecutive aggregation path を追加し、`tool::render_tool` と同様に consumed count を返す helper を作ってよい。
|
|
- `render_thinking` を単体 renderer として残しつつ、複数 block 用の `render_thinking_aggregate` を追加してよい。
|
|
- Header 文言、elapsed 表示、複数 state 混在時の summary は実装者判断でよい。ただし streaming / incomplete を隠さない。
|
|
- Detail mode で各 block の境界を薄い separator / index / blank line で示すか、単純連結するかは実装者判断でよい。
|
|
- Existing tests に加えて、synthetic `App { blocks: [...] }` から `compute_history` output を見る focused unit test を追加するのが自然。
|
|
|
|
## Readiness
|
|
|
|
- readiness: implementation_ready
|
|
- risk_flags: [tui-rendering, reasoning-display, block-aggregation, text-selection]
|
|
|
|
## Escalation conditions
|
|
|
|
- protocol / pod / persistence 層の変更が必要だと分かった場合。
|
|
- Thinking を selectable / copyable transcript text として扱う UX 変更が必要になる場合。
|
|
- Provider-specific reasoning metadata の扱いに踏み込む必要が出た場合。
|
|
- Console 以外の Dashboard / web / protocol UI surface まで範囲が広がる場合。
|
|
- 表示集約のために broad TUI rendering rewrite が必要になる場合。
|
|
|
|
## Validation
|
|
|
|
- `cargo test -p tui` または focused `cargo test -p tui thinking` / rendering tests。
|
|
- `cargo fmt --check`。
|
|
- `git diff --check`。
|
|
- 必要に応じて `cargo check -p tui`。
|
|
- 変更範囲が TUI / package integration に広がる場合のみ `nix build .#yoi` を検討。
|
|
|
|
## Related work
|
|
|
|
- Tickets:
|
|
- `00001KT5D44Z0` — Unify reasoning persistence with block lifecycle
|
|
- `00001KVMT2J25` — Pod protocol: in-flight LLM response reconnect snapshot should include unfinished blocks
|
|
- `00001KVHX0WBE` — Dashboard / Console 呼称導入と TUI モジュール境界整理
|
|
- `00001KTKCK8W8` — TUI chat view should render Markdown tables
|
|
- related but not duplicate: `00001KSVP63K8`
|
|
- Files:
|
|
- `crates/tui/src/block.rs`
|
|
- `crates/tui/src/app.rs`
|
|
- `crates/tui/src/ui.rs`
|
|
- `crates/tui/src/tool.rs`
|