Files
pi-gui/docs/quick-pane-v1-test-plan.md
T

2.3 KiB

Quick Pane v1 Test Plan and QA Checklist

Automated coverage

Settings

  • Valid defaults load when no Quick Pane configuration exists.
  • Valid configuration round-trips through native storage.
  • Invalid workspace, model, prompt, time, and tool values show field errors and retain prior saved state.
  • Quick model picker affects quick request only; follow-up model remains configured default.

Runtime guardrails

  • Quick runtime receives immutable advisory read-only/no-subagent prompt text plus supplemental prompt.
  • Mutation, subagent, multi-step, and likely-over-budget requests are instructed to preflight-escalate.
  • Runtime applies best-effort configured 60-second/6-tool caps from observed events and exposes reason.
  • Partial result survives a cap; pane transcript is removed and runtime cleanup requested after pane close.
  • Tests/documentation state current limitations: Pi RPC cannot trusted-enforce prompt policy or guarantee memory-only temporary sessions.

UI and bridge

  • Quick Pane opens/focuses through dedicated native command without changing normal --new or --toggle behavior.
  • Workspace and quick-model picker values reach runtime creation.
  • Permission and clarification extension requests render inline and send correct response payloads.
  • Retry, model change, and normal-session actions appear for startup/model/crash errors.
  • Handoff creates normal session with original request, escalation note, workspace, and follow-up model.

Manual smoke checklist

  1. Configure default workspace, models, prompt, and 60-second/6-tool limits.
  2. Add desktop/WM hotkey using Settings launch command.
  3. From no running GUI process, invoke hotkey and verify Quick Pane opens/focuses.
  4. Submit short answer-only request; verify result within 60 seconds.
  5. Submit read-only inspection request; answer any external-read permission prompt inline.
  6. Submit mutation or multi-step request; verify reason and Continue in full session.
  7. Continue; verify normal session receives handoff and follow-up model.
  8. Close Quick Pane; reopen and verify quick transcript is absent.
  9. Select unavailable model or induce startup failure; verify inline recovery options.

Exit criteria

All targeted automated tests pass. Manual cold-launch/hotkey smoke completes. No regressions in normal sessions, --toggle, or --new behavior.