# Full Flows and Command Sequences

Use this file when you need a complete, end-to-end command sequence.

## Standard CLI Regression Test (human-like flow)
1) Start the app under test:
   - `agent-tui run <your-cli> -- <args>`
2) Capture session id from JSON output (use `--session <id>` for the rest).
3) First snapshot (text or structure):
   - `agent-tui --session <id> screenshot --format json`
4) Act based on the latest screen:
   - `agent-tui --session <id> type "value"`
   - `agent-tui --session <id> press Enter`
5) Wait for expected state:
   - `agent-tui --session <id> wait "Expected text" --assert`
6) Repeat steps 3-5 until the flow finishes.
7) Cleanup:
   - `agent-tui --session <id> kill --yes`

## Form Interaction Flow
1) `agent-tui run <app>`
2) `agent-tui --session <id> screenshot --format json`
3) Focus the input (if needed): `agent-tui --session <id> press Tab`
4) Type value: `agent-tui --session <id> type "my-value"`
5) Submit: `agent-tui --session <id> press Enter`
6) Wait for success: `agent-tui --session <id> wait "Success" --assert`
7) Cleanup: `agent-tui --session <id> kill --yes`

## Dynamic UI / Flaky Rendering Flow
1) Start: `agent-tui run <app>`
2) Stabilize: `agent-tui --session <id> wait --stable`
3) Snapshot: `agent-tui --session <id> screenshot --format json`
4) Act: `agent-tui --session <id> press Enter` or `agent-tui --session <id> type "text"`
5) Re-stabilize: `agent-tui --session <id> wait --stable`
6) Re-snapshot and continue.
7) Cleanup: `agent-tui --session <id> kill --yes`

## Live Preview Flow (optional)
1) Ask user if they want live preview.
2) If yes: `agent-tui live start --open`
3) Run the app: `agent-tui run <app>`
4) Continue normal flow (snapshot/act/wait).
5) Stop standalone preview state when done: `agent-tui live stop`
6) If preview is daemon-backed and the daemon should stop too: `agent-tui daemon stop --yes`
7) Cleanup: `agent-tui kill --yes`

## Debug/Attach Flow (existing session)
1) List sessions: `agent-tui sessions`
2) Switch active session if needed: `agent-tui sessions switch <id>`
3) Attach to active session: `agent-tui sessions attach`
4) Interact/observe, then detach (Ctrl-P Ctrl-B).
5) Cleanup: `agent-tui kill --yes` or `agent-tui sessions cleanup --yes`

## Smoke Test Example (htop)
1) `agent-tui run htop`
2) `agent-tui --session <id> screenshot`
3) Verify UI text (e.g., "F1 Help").
4) Quit: `agent-tui --session <id> press F10`
5) Confirm quit: `agent-tui --session <id> wait "Quit" --gone`
6) Cleanup: `agent-tui --session <id> kill --yes`