108 lines
6.5 KiB
Markdown
108 lines
6.5 KiB
Markdown
---
|
|
title: 'Dashboard reload と初期表示で row を自動選択しない'
|
|
state: 'closed'
|
|
created_at: '2026-06-23T06:44:20Z'
|
|
updated_at: '2026-06-23T07:24:20Z'
|
|
assignee: null
|
|
readiness: 'implementation_ready'
|
|
risk_flags: ['tui-ux', 'panel-selection', 'reload-state']
|
|
queued_by: 'workspace-panel'
|
|
queued_at: '2026-06-23T06:47:17Z'
|
|
---
|
|
|
|
## User claims / request snapshot
|
|
|
|
- Dashboard で `Esc` を押して row selection を消しても、reload によって頻繁に選択が戻る。
|
|
- そのため、実使用上は「何も選択していない状態」で composer を global / 新規 Intake として使うのが難しい。
|
|
- reload で勝手に row selection しないようにしたい。
|
|
- 追加合意: 初回 `yoi panel` 起動時から未選択にする。
|
|
|
|
## Confirmed facts / sources
|
|
|
|
- `crates/tui/src/dashboard/mod.rs`
|
|
- Dashboard は `selected_row: Option<PanelRowKey>` を持ち、`None` の未選択状態が実装上存在する。
|
|
- `Esc` 経路で `clear_panel_selection()` が呼ばれ、selection を消せる。
|
|
- reload / snapshot 更新後の selection visibility 補正により、visible row があると selection が戻る可能性がある。
|
|
- `crates/tui/src/dashboard/tests.rs`
|
|
- `Esc` が row selection を clear する既存テストがある。
|
|
- 関連 Ticket:
|
|
- `00001KTNS1AA8` closed: Panel composer / no-selection / `Esc` semantics の過去文脈。
|
|
- `00001KTFMMZP0` closed: background reload と selection/composer preservation の過去文脈。
|
|
|
|
## Unverified hypotheses
|
|
|
|
- 現行の reload 完了時の `ensure_selection_visible()` 系処理が、明示的な no-selection と「まだ selection がない初期/補正状態」を区別していない可能性が高い。
|
|
- 初期表示時の自動選択も同じ selection visibility 補正または初期化経路に由来している可能性がある。
|
|
|
|
## Undecided points / open questions
|
|
|
|
- なし。初回表示から未選択にする方針で合意済み。
|
|
|
|
## Background
|
|
|
|
Dashboard composer は row selection と composer target の組み合わせで挙動が変わる。`TicketIntake` target で Ticket row が選択されていると、入力が既存 Ticket の詳細化 / planning return として扱われる経路がある。一方、ユーザーが global / 新規 Intake として入力したい場合は row selection がない状態を維持できる必要がある。
|
|
|
|
現状は `Esc` で selection を消せても、background reload 等で選択が戻るため、ユーザーが意図した no-selection 状態を維持しづらい。
|
|
|
|
## Requirements
|
|
|
|
- 初回 `yoi panel` 表示時は、Ticket row / Pod row を自動選択しない。
|
|
- ユーザーが `Esc` で row selection を clear した後、reload / background reload / snapshot 更新が完了しても `selected_row = None` を維持する。
|
|
- reload によって既存の明示選択がまだ visible な場合は、その selection を維持してよい。
|
|
- reload によって選択中 row が消えた場合は安全に未選択へ落とす。
|
|
- Up/Down、mouse click、その他既存の明示的な row selection 操作では従来どおり selection を作れる。
|
|
- 未選択状態で `TicketIntake` target に非空 composer 入力して Enter した場合、既存 Ticket refinement ではなく global / 新規 Intake launch として扱われる。
|
|
|
|
## Acceptance criteria
|
|
|
|
- 初回 `yoi panel` 起動後、visible row があっても row selection はない。
|
|
- `Esc` で selection を clear した後、panel reload completion を挟んでも selection は復活しない。
|
|
- 未選択状態で `TicketIntake` target に composer 入力して Enter すると、新規/global Intake handoff になり、既存 Ticket の詳細化 handoff にならない。
|
|
- keyboard navigation または mouse click により、ユーザーは明示的に row を再選択できる。
|
|
- 既存の selected-row action、queue/close/open 操作、Ticket workflow state semantics は変えない。
|
|
- focused tests で少なくとも以下を確認する:
|
|
- initial Dashboard state has no selected row when rows exist;
|
|
- `Esc` clear -> reload completion -> still no selected row;
|
|
- no-selection + `TicketIntake` composer submit routes to global/new Intake rather than selected Ticket refinement.
|
|
|
|
## Binding decisions / invariants
|
|
|
|
- no-selection は first-class UX state として扱う。
|
|
- reload は、ユーザーが明示的に作った no-selection state を勝手に解除しない。
|
|
- 初回表示でも自動選択しない。
|
|
- composer draft は reload / selection clear によって失わない。
|
|
- Ticket state transition / lifecycle authority は変更しない。
|
|
- row click は selection のみを変更し、click だけで action dispatch しない既存方針を維持する。
|
|
|
|
## Implementation latitude
|
|
|
|
- 実装は `selected_row: Option<PanelRowKey>` に加えて「明示 no-selection」フラグを持つ、または selection visibility 補正の呼び出し条件を整理するなど、局所的に選んでよい。
|
|
- 初期表示・reload 完了・row 消失・navigation 開始の各経路で、selection を作る責務を明示的 user action に寄せられればよい。
|
|
- UI 表示文言の小変更は許容するが、この Ticket の主目的は selection semantics の修正であり、広い Dashboard layout redesign は含めない。
|
|
|
|
## Readiness
|
|
|
|
- readiness: implementation_ready
|
|
- risk_flags: [tui-ux, panel-selection, reload-state]
|
|
|
|
## Escalation conditions
|
|
|
|
- 初回未選択にすると keyboard-only navigation や blank Enter action の既存 contract が大きく変わることが判明した場合。
|
|
- selection visibility 補正が reload 以外の重要な safety/correctness を担っており、単純に止めると stale selection や action 誤爆が起きる場合。
|
|
- focused tests では確認できず、実端末 `yoi panel` / PTY 経路での挙動確認が必要になった場合。
|
|
|
|
## Validation
|
|
|
|
- `cargo test -q -p tui workspace_panel`
|
|
- 必要に応じて Dashboard 関連の focused test 名指定。
|
|
- 変更範囲に応じて `cargo fmt --check`、`git diff --check`、`cargo check -q`。
|
|
- terminal delivery / timing に依存する挙動が疑わしい場合は、既存の Panel PTY/E2E 系テストまたは実 `yoi panel` で確認する。
|
|
|
|
## Related work
|
|
|
|
- `00001KTNS1AA8` — Panel composer / no-selection / `Esc` semantics の関連 closed Ticket。
|
|
- `00001KTFMMZP0` — Dashboard background reload / selection preservation の関連 closed Ticket。
|
|
- `crates/tui/src/dashboard/mod.rs`
|
|
- `crates/tui/src/dashboard/tests.rs`
|
|
- `crates/tui/src/dashboard/render.rs`
|