21 lines
910 B
Markdown
21 lines
910 B
Markdown
# Failure Recovery
|
|
|
|
Use this file when runs are flaky, stalled, or inconsistent.
|
|
|
|
## Common Failures and Fixes
|
|
- Text not found: re-run `screenshot`, wait for stability, then re-check expected text.
|
|
- Target not visible: use `press` navigation keys (for example `PageDown`, arrows), then re-snapshot.
|
|
- Wait timeout: increase `--timeout`, use `wait --stable`, then re-snapshot.
|
|
- No active session: `sessions` to list; re-run `run` if needed.
|
|
- Daemon not running: `daemon start`.
|
|
- Version mismatch: `daemon restart`.
|
|
- Unresponsive session: `kill --yes`, then re-run.
|
|
- Layout missing/overflow: `resize --cols --rows`, re-snapshot.
|
|
|
|
## Retry Budget
|
|
- Allow 3-5 retries for transient UI changes.
|
|
- If still failing, stop and ask the user for guidance or updated expectations.
|
|
|
|
## Escalation
|
|
- Last resort: `daemon stop --force --yes` then `daemon start`.
|
|
- Warn that `daemon restart` terminates all sessions.
|