---
model: openai/gpt-5.6-sol
service: opencode
session: unavailable
timestamp: 2026-08-31T00:57:12Z
git_ref: 09ddcf50
scope: tests
substantive: true
raw_file: 20260831T005712Z_09ddcf50_prompt_io.raw.md
---

## Prompt

Deeply evaluate Piker's lacking suites and build a comprehensive plan for
non-mocked, human-driven E2E coverage, beginning with the pytest-qt plan on
`chart_local_gapper`. Work in `/open-wkt`, build the first feasible GUI test
slice, add minimal adjacent CLI and Qt guide docs, keep the `/run-tests`
reference current, and stop before the stated Eastern deadline.

## Response summary

Audits the existing suite and human-facing surfaces, creates a risk-ranked
cross-interface E2E plan, activates pytest-qt, migrates the real-Qt gap suite
to pytest-qt widget ownership, and records verified commands and minimal user
guides. Full `MainWindow` E2E remains deferred behind safe shutdown, guest
outcome, symbol-session ownership, and deterministic provider seams.

## Files changed

- `pyproject.toml`, `uv.lock`, `pytest.ini` - activate pytest-qt config.
- `tests/conftest.py` - establish the Qt process and settings contract.
- `tests/test_gap_overlays.py` - migrate real widgets to `qtbot` ownership.
- `piker/cli/README.rst` - add the minimal command-line guide.
- `piker/ui/README.rst` - add the minimal chart UI guide.
- `plans/opencode/human-facing-e2e-coverage.md` - persist the suite plan.
- `.claude/skills/run-tests/test-harness-reference.md` - record verified
  test commands and boundaries.

## Human edits

The human requires isolated worktree execution, adjacent guide-style docs,
continuous `/run-tests` reference maintenance, non-mocked Qt interactions,
and a hard time cutoff. These constraints materially determine the patch
scope and defer unsafe full-window work.