yoi/.yoi/tickets/00001KSKBP9YG/thread.md

Migrated

Migrated from tickets/e2e-harness.md. No legacy review file was present at migration time.

---

Decision

E2E scope refinement: TUI/Panel PTY 自動化もこの Ticket の範囲に含める。

背景:

• Panel mouse selection / Panel Quit latency の直近不具合では、focused unit test と code-path review だけで done 判定し、実端末経路の positive validation / measured validation が不足していた。
• 既存本文の「TUI バイナリを PTY で叩く方針は採らない」は、blind な固定入力スクリプトや GUI 代替としての ad hoc 操作を避ける意図として扱い、TUI/Panel の実プロセス・実端末入力を検証する automated PTY harness は本 Ticket に含める。
• Pod protocol/subprocess E2E と TUI/Panel PTY E2E は harness の部品は違うが、どちらも「実プロセスを spawn して user-visible boundary を検証する」ため、別 umbrella に分けず、この E2E harness Ticket の phase として扱う。

方針:

• 固定 sleep + 固定 input だけの PTY script は採用しない。Harness は UI からの structured feedback を待ってから入力を送る。
• TUI/Panel には test-only / opt-in の observability route を追加する。これは UI action を bypass する command channel ではなく、状態観測・同期・失敗診断のための read-only probe とする。
• 実際の keyboard / mouse / Ctrl+C 入力は PTY 経由で送る。Probe は first_draw、panel_snapshot_ready、rows_rendered、selection_changed、actionbar_changed、background_task_started/finished/aborted、quit_requested、terminal_cleanup_started/finished、exit などの structured event を JSONL 等で吐く。
• Mouse E2E は rows_rendered の row key と screen rect を待ち、SGR mouse sequence を PTY に送って、selection_changed と screen/actionbar/detail の変化を確認する。
• Quit latency E2E は panel_ready / background work pending などの barrier event を待ってから Ctrl+C / Ctrl+D を送り、quit_requested -> exit の elapsed を測る。非本質 background work が abort/drop され、terminal cleanup が行われることも event で確認する。
• Screen output は vt100/vte 等の terminal parser で secondary oracle / artifact として保存する。主要同期は structured event に寄せる。
• Test probe は --tui-test-events <path> 等の明示的な hidden/dev/test flag か e2e feature 配下の構成で有効化し、通常実行・model context・Ticket authority・Pod protocol には影響させない。
• Failure artifact として event JSONL、input log、screen dump、stdout/stderr、runtime/data/workspace tmpdir の relevant tree、timing summary を保存する。

受け入れ条件の追加案:

• cargo test -p e2e --features e2e（または同等の opt-in command）で実 yoi panel を PTY 上で起動し、structured probe feedback を待ってから入力する harness が動く。
• Panel row click E2E: rendered row rect を使って SGR mouse click を送り、selected row が変わることを assertion する。
• Panel quit latency E2E: ready/pending background work barrier 後に Quit 入力を送り、exit latency が閾値内で、nonessential background work が quit を block しないことを assertion する。
• Fixed sleep だけに依存する test は不可。ready/barrier event が来なければ screen dump と event log を artifact として失敗する。
• Probe は read-only observability であり、input/action path を bypass しないことを reviewer が確認する。

---