Files
pi-extensions/.pi/skills/tui-replay/SKILL.md
T

31 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: tui-replay
description: Drive a background pi TUI session (pty) through the ai-bash-judge permission replay cohort — start interactive pi with bg_start, send prompts/confirmations with bg_send, pair permission-review log rows by requestId, analyze fixed time windows. Use when asked to test/replay/validate the ai-bash-judge pipe, collect shadow cohort rows, or run the 30-command TUI test flow in this repo.
---
# TUI replay for ai-bash-judge
The authoritative protocol lives in this repo:
**`docs/testing/tui-replay.md`** — read it fully before operating. It
defines preconditions (cwd, chain config, timeout cohort), the
bg_start/bg_send control protocol (text and `<Enter>` are separate
sends; `y`×2 approve, `r`×2 + reason + `<Enter>` deny), the
per-command wait/blind-deny ordering, the round procedure with
`--after/--before` windows, the 30-command scenario matrix, pass
criteria (pipe health, not verdict agreement), and the known-pitfalls
list (sandbox EBUSY stubs, `jj squash` editor hang, agent-layer
rewrites, session-rule pollution).
Summary of the loop:
1. Precondition check: TUI cwd = repo root (project override wires the
judge chain); judge config timeout cohort set.
2. `date -u` round start → fresh TUI via `bg_start` (pty=true) →
commands one prompt at a time → answer dialogs per doc §3
(destructive scenarios: blind deny **before** reading the judge row).
3. Quit → `date -u` round end → analyzer CLI on the fixed window →
archive report under `docs/testing/rounds/`.
4. Gate = join completeness + analyzer-clean + no unexpected infra
failures + no evidence leaks (doc §7).