Add interactive OpenCode Runner guide by leoncheng57 · Pull Request #116 · leoncheng57/custom-dca-opencode

leoncheng57 · 2026-08-23T14:45:20Z

Closes #53

Summary

add a fixture-only interactive Runner guide at /guide locally and https://leoncheng.dev/custom-dca-opencode/guides/runner/ on Pages
cover request flow, Plan/Build safety, long transcripts, permissions/questions, review controls, mobile handoff, notifications, sub-agent evidence, exclusions, troubleshooting, and contributor links across 16 stable scenes
provide explicit desktop/mobile simulation controls, semantic hash deep links, keyboard navigation, reduced-motion behavior, and responsive full-page layouts
publish only a guide-specific Vite artifact; the public build contains no BFF, live OpenCode connection, exported conversation, or repository mutation

Pages ownership

This PR is intentionally independent of the open skills/public-site stack in #106 and #113. The trusted main-branch workflow owns only gh-pages:guides/runner/, shares the existing pr-screenshot-publication concurrency group, and preserves pr-screenshots/ plus unrelated Pages paths. The staging seam rejects missing artifacts, symlinks, overlapping paths, and non-checkout destinations.

Fixture and safety boundaries

all names, paths, sessions, URLs, review state, and transcript rows are authored fictional data
the normal /guide route sits outside NotificationCenterProvider; browser coverage asserts that it performs zero /api requests
simulated actions report local guide feedback only and cannot approve commands, answer a live question, merge code, or contact an LLM
caveats remain visible in every scene, including host-native execution, no auto-resume, last-match-wins permissions, provenance-vs-capability, and unknown child outcomes

Verification

npm test (459 passed)
npm run typecheck
npm run build:guide
npm run test:e2e (253 passed, 1 expected screenshot-runner skip)
npm run screenshots:local (9 requested routes validated at desktop and mobile widths)

Visual review

Dark full-page desktop and 390x740 mobile captures were inspected locally through the repository screenshot runner. Inline publication is intentionally omitted on this bootstrap PR: the trusted workflow_run publisher revalidates routes using default-branch code and must not accept the new /guide allowlist before merge. After merge, later PRs can request stable scenes such as /guide#simulation-plan-safety normally.

github-actions · 2026-08-23T14:49:41Z

PR screenshots

No screenshots requested. Add this to the PR description:

```screenshots
/?directory=/tmp/mock-project
full:/sessions/ses_mock_done?directory=/tmp/mock-project


_Captured from the production app against deterministic mock OpenCode fixtures only._

leoncheng57 · 2026-08-23T15:09:31Z

Exhaustive Playwright review gallery

Captured from PR head bd95ce6 with the production build. 40 PNGs, 4.4 MB total. Images are stored on immutable artifact commit 52bf8d6, outside the merge diff.