환경 2(AITC Sandbox PWA) fidelity acceptance — 실기기 WebKit 거동 1건 관측

[DaveDev42]

기획 정본: meta/four-environments-fidelity.md (umbrella) §1.1·§1.2 환경 2 (AITC Sandbox App / PWA).

M-track: M1 (fidelity 트랙 — 환경 2 = 실기기 WebKit 엔진 fidelity 겹) · Station: 3-debug · Blocker: none (폰 필요하나 토스 dogfood deploy·relay 불필요 — BLOCK-phone보다 낮은 마찰)

배경

환경 모델이 3종→4겹으로 확장되면서 **환경 2(AITC Sandbox App / PWA)**가 fidelity 사다리의 독립 겹으로 명시됐다 — 환경 1(로컬 브라우저)이 구조적으로 못 하는 실기기 Safari/WebKit 엔진·실 터치/뷰포트를 토스 검수·WebView 없이 채운다.

인프라는 GREEN이다: launcher PWA(e2e/fixture/launcher/), devtools.aitc.dev/launcher/ 배포(.github/workflows/deploy-fixture.yml), e2e/launcher.test.ts(5개 테스트), e2e/fixture/vite.config.ts MPA 엔트리, cloudflared 터널(AIT_TUNNEL=1 pnpm dev:phone), agent-plugin /ait setup-phone-preview 진입점.

하지만 fidelity 겹으로서의 acceptance가 없다 — "메인테이너가 dev 앱을 AITC Sandbox PWA로 실기기에 올려, 환경 1(브라우저)에서 안 보이던 WebKit 엔진 거동을 실제로 관측했다"는 검증이 한 번도 기록되지 않았다. 인프라가 도는 것과, 그 겹이 디버깅에 쓸모 있는 fidelity를 실제로 제공한다는 것은 다르다(#233이 환경 3 relay 루프에 대해 묻는 것과 같은 질문을, 환경 2 PWA 겹에 대해 묻는다).

목표

/ait setup-phone-preview → pnpm dev:phone(터널+QR) → 폰 PWA 설치 → dev 앱 로드 → 환경 1에서 못 보던 실기기 WebKit 거동 1건을 관측하는 루프를 메인테이너가 완주.

환경 1 대비 환경 2가 메우는 fidelity 후보(관측 대상 예):

• CSS env(safe-area-inset-*) 실값 — 데스크톱 브라우저는 0, 실기기 Safari는 노치/홈 인디케이터 반영.
• 실 터치 이벤트·제스처(touchstart/touchmove, 100vh 동적 뷰포트 — iOS Safari 주소창 collapse).
• 실 DPR·뷰포트 width(데스크톱 시뮬과 어긋나는 지점).
• WebKit 한정 렌더 quirk(스크롤 바운스, -webkit- 동작).

Acceptance

• 메인테이너가 /ait setup-phone-preview 안내만으로 폰 PWA에 dev 앱을 올려 실기기 Safari/WebKit에서 띄움. 근거: transcript.
• 환경 1(데스크톱 브라우저)과 환경 2(실기기 PWA)에서 같은 dev 앱의 거동이 갈리는 지점 1건 이상을 관측·기록(예: safe-area inset, 동적 뷰포트, 터치). 이게 환경 2가 fidelity 사다리에 존재하는 이유의 실증.
• 같은 루프 2회차에 1회차 대비 추가 수동 우회 없음(반복 가능성).

경계 (out of scope)

• ❌ 토스 WebView·SDK 네이티브 브리지 거동 — 그건 환경 3·4(intoss-private/live relay) 몫. 환경 2는 순수 PWA라 SDK는 여전히 mock이다.
• ❌ CDP relay attach — 환경 2는 MCP relay 대상이 아니다(환경 3·4가 relay). 환경 2의 관측은 브라우저 기본 DevTools(데스크톱 Safari로 실기기 inspect) 또는 화면 관찰.
• ❌ dogfood→QR→relay 디버깅 루프 운영화 (메인테이너 반복 실행 가능 수준) #233(환경 3 relay 루프 운영화), safe-area 실측: Runtime.evaluate + measure_safe_area MCP 툴 + provenance 필드 #198/landscape safe-area 좌우 대칭 실측 + landscapeSide 정리 #232(safe-area relay 실측)와 별개 트랙 — 환경 2는 그 선행이 아니다(토스 deploy 불필요라 독립 진행 가능).

[DaveDev42]

재오픈 — close 정정.

이 이슈는 본문에서 스스로 "fidelity 겹으로서의 acceptance가 없다 — 메인테이너가 실기기에 올려 환경 1에서 못 보던 WebKit 거동을 실제로 관측했다는 검증이 한 번도 기록되지 않았다"고 요구하며 만들어졌다. 그런데 코멘트 0개 + acceptance 체크리스트(docs/env2-pwa-acceptance.md Re-run 체크리스트 6칸) 전부 빈 박스 [ ]인 채 COMPLETED로 닫혀 있었다.

닫힌 것은 관측이 아니라 관측 절차 문서 작성이었다. 인프라(launcher PWA·터널·tunnel:{cdp:true}·start_debug({mode:'relay-sandbox'}))와 절차 문서는 GREEN이지만, 실기기 WebKit 거동 1건 관측은 0건이다. 이 이슈의 원래 acceptance가 충족되지 않았으므로 재오픈하고, 실기기 관측이 실제로 기록(체크리스트 6칸 채움)될 때까지 In Progress로 둔다.

폰 세션 순서: 환경 2(relay-sandbox)를 환경 3(relay-staging)보다 먼저 실행한다 — 토스 앱·검수 불필요라 마찰이 낮고, CDP relay 경로의 절반을 더 싼 환경에서 먼저 검증한다.

진입은 환경 3과 다르다(zero-discovery 메모):

• 전제: unplugin tunnel:{cdp:true}가 Chii relay를 띄우고 그 공개 base URL을 AIT_RELAY_BASE_URL로 노출 (bootExternalRelayFamily).
• attach는 scheme_url(intoss-private deploymentId)이 아니라 AIT_TUNNEL_BASE_URL 사용.
• relay-sandbox는 dual-connection 데몬에서 런타임 swap이 거부됨(외부-PWA origin이 relay-staging/relay-live와 다른 물리 슬롯). 외부 relay family로 부팅해야 함.

관측 대상: env(safe-area-inset-top/bottom)이 환경 1(데스크톱)에선 0px, 환경 2(실기기 PWA standalone)에선 양수 — 값이 0px이 아니면 환경 1이 구조적으로 못 보는 fidelity를 환경 2가 실제로 제공함이 입증된다.