peach-e2e-setup — E2E 테스트 환경 설정

페르소나

전제조건

• 대상 프로젝트 루트에서 실행 (peach-harness 자체가 아닌 대상 프로젝트)
• macOS 환경 (Chrome Beta 경로가 macOS 기준)

Workflow

Step 1: npm 글로벌 도구 설치 체크

# agent-browser (탐색/검증/확인용 기본 도구)
command -v agent-browser && echo "✅ agent-browser 설치됨" || echo "❌ agent-browser 미설치"

# playwright-cli (시나리오 실행 + iframe fallback용)
command -v playwright-cli && echo "✅ playwright-cli 설치됨" || echo "❌ playwright-cli 미설치"

# playwright-core (CDP 연결 라이브러리)
node -e "require('playwright-core')" 2>/dev/null && echo "✅ playwright-core 설치됨" || echo "❌ playwright-core 미설치"

• agent-browser

  :

  npm install -g agent-browser

• playwright-cli

  :

  npm install -g @playwright/cli

• playwright-core

  :

  npm install -g playwright-core

Step 2: Chrome Beta 설치 여부 확인

ls -d "/Applications/Google Chrome Beta.app" 2>/dev/null && echo "✅ Chrome Beta 설치됨" || echo "❌ Chrome Beta 미설치"

• 설치 URL: https://www.google.com/chrome/beta/
• 기본 Chrome과 동시 실행 가능, E2E 전용으로 분리 사용

Step 3: 프로젝트 루트에 e2e/ 폴더 생성

mkdir -p e2e/lib

Step 4: 인프라 코드 복사

references/

e2e/

e2e.sh

e2e/e2e.sh

pwc.sh

e2e/pwc.sh

connect.js

e2e/lib/connect.js

selector.js

e2e/lib/selector.js

gmail-메일목록.js

e2e/시나리오/gmail-메일목록.js

Step 5: 시나리오 폴더 생성 + 테스트 시나리오 배포

# 시나리오 폴더가 없을 때만 생성. 있으면 절대 건드리지 않음.
if [ ! -d "e2e/시나리오" ]; then
  mkdir -p "e2e/시나리오"
  echo "✅ e2e/시나리오/ 폴더 생성됨"
else
  echo "✅ e2e/시나리오/ 폴더 이미 존재 (건드리지 않음)"
fi

• references/gmail-메일목록.js

  →

  e2e/시나리오/gmail-메일목록.js

• 없으면 무조건 복사 (최초 설치)
• 있으면 내용 비교 후 다를 때만 사용자에게 업데이트 여부 질문

1. 파일이 없으면 → 무조건 복사, 질문 없음
2. 파일이 있으면 → references 내용과 비교
   • 동일하면 → "최신 상태" 메시지 출력 후 스킵
   • 다르면 → 변경 요약을 보여주고 "업데이트하시겠습니까? (y/N)" 질문
     • y → 덮어씀
     • N (기본) → 스킵

파일 없음          → 복사 (질문 없음)
파일 있음 + 동일   → "✅ gmail-메일목록.js 최신 상태"
파일 있음 + 다름   → diff 요약 출력 → "업데이트하시겠습니까? (y/N)"
                      y → 덮어씀 / N → 스킵

Step 6: 실행 권한 부여

chmod +x e2e/e2e.sh e2e/pwc.sh

Step 7: 완료 메시지

✅ E2E 환경 설정 완료

배포된 인프라 코드:
  e2e/e2e.sh        — E2E 통합 CLI
  e2e/pwc.sh        — playwright-cli CDP 래퍼
  e2e/lib/connect.js — Chrome CDP 연결 모듈
  e2e/lib/selector.js — 탭/시나리오 선택기

다음 단계:
  1. cd e2e && ./e2e.sh setup    — 환경 자동 체크 + 설정
  2. cd e2e && ./e2e.sh chrome   — Chrome Beta CDP 모드 실행
  3. 브라우저에서 Google 로그인
  4. cd e2e && ./e2e.sh run 시나리오/gmail-메일목록.js  — 테스트 시나리오 실행

주의사항

• 시나리오 폴더 보호:

  e2e/시나리오/

  폴더가 이미 존재하면 절대 덮어쓰거나 삭제하지 않는다
• 인프라 파일은 항상 덮어씀:

  e2e.sh

  ,

  pwc.sh

  ,

  connect.js

  ,

  selector.js

  는 references의 최신 버전으로 항상 교체
• 글로벌 도구 자동 설치 금지: 사용자에게 명령어를 안내하고 확인을 받은 후 진행
• 시나리오 실행은 반드시

  ./e2e.sh run

  :

  node 시나리오.js

  직접 실행 시

  playwright-core

  를 못 찾음.

  e2e.sh

  가

  NODE_PATH

  에 전역 npm 모듈 경로를 설정해야 정상 동작

완료 조건 체크리스트

• npm 글로벌 도구 3개 설치 상태 확인됨 (agent-browser, playwright-cli, playwright-core)
• Chrome Beta 설치 상태 확인됨
• e2e/ 폴더 구조 생성됨
• 인프라 코드 4개 복사됨 (e2e.sh, pwc.sh, connect.js, selector.js)
• e2e/시나리오/ 폴더 생성됨 (기존 존재 시 미변경)
• 테스트 시나리오 gmail-메일목록.js 배포됨 (없으면 복사, 있고 다르면 사용자 확인 후 업데이트)
• e2e.sh, pwc.sh 실행 권한 부여됨
• 완료 메시지 출력됨