---
id: 11-flagship-e2e
epic: walking-skeleton
title: flagship e2e — connect vite-kitchen to selection round-trip
type: user-story
status: todo
feature: web-next
depends-on: [10-web-next-wiring]
blocks: []
created: 2026-07-12T10:24:14Z
---

## Goal

Land the repo's flagship Playwright spec — the M0-recast acceptance: sign in → connect `vite-kitchen` via git URL + PAT → staged progress completes → the editor shows `Button` rendered inside the adapter's iframe → click the button in the iframe → the editor selection overlay appears and the selection state names the component.

## Why

This spec is the epic's definition of done in executable form. It exercises every seam at once — provisioning, clone/install/scan, adapter, realtime progress, and the cross-origin selection round-trip — asserting through the UI and the protocol, never against runner internals, so the runner stays refactorable while the protocol is the contract (PRD Testing decisions).

## Done when

- The Playwright spec (dev-seed + local-process provisioner) covers the full flow from the PRD Success criteria and asserts on iframe content, not a screenshot double.
- The flow completes within the connect-to-rendered-component budget: < 3 min on the warm fixture (PRD budget, spec §16).
- The spec is tagged as the repo's flagship spec and runs green in CI.
- The equivalent flow with the Docker provisioner works on a dev machine per story 06's documented manual check (CI stays on the process provisioner).
- `pnpm typecheck && pnpm lint && pnpm test && pnpm test:e2e && pnpm conformance && pnpm fallow:audit && pnpm coverage:diff` all pass.

## In scope

- The flagship Playwright spec under the existing `pnpm test:e2e` surface, running against dev-seed mode with the process provisioner.
- Any test-only plumbing needed to run the spec in CI (fixture serving, runner spawn) reusing the story 01 helpers.

## Out of scope

- Docker-provisioner automation in CI (manual check only, per PRD Success criteria).
- Additional e2e coverage beyond the flagship flow (later PRDs).

## Tasks

- [ ] Add the flagship Playwright spec (dev-seed + process provisioner): sign in → connect `vite-kitchen` via git URL + PAT → staged progress completes → `Button` rendered inside the adapter iframe (assert on iframe content) → click in the iframe → selection overlay appears and the selection state names the component; completes within the < 3 min warm-fixture budget; tagged as the repo's flagship spec; green in CI.
