playground — AGENTS.md

공통 규칙: AGENTS.md | 전체 인덱스: INDEX.md

WHAT

로컬 전체 스택 테스트 환경. 실제 패키지를 npm workspaces symlink로 참조해 구현 전 API 설계 검증 및 구현 후 통합 테스트에 사용한다.

HOW

가장 빠른 시작 (CLI)

주의: CLI는 아직 npm에 배포되지 않았다. tapflow 커맨드를 쓰려면 먼저 빌드해야 한다. 빌드 없이 실행하려면 tsx ../packages/cli/src/index.ts <command> 를 사용한다.

# 빌드 후 사용
pnpm --filter @tapflowio/cli build
tapflow start                           # relay + agent 한 번에 기동
tapflow start --device "iPhone 16"     # 디바이스 지정

# 빌드 없이 소스에서 직접 실행
tsx ../packages/cli/src/index.ts start
tsx ../packages/cli/src/index.ts start --device "iPhone 16"
# 브라우저 → http://localhost:4000

pre-release 검증 (외부 유저 경험과 동일)

dashboard 빌드 후 relay가 단독 서빙 — 실제 설치 사용자가 겪는 흐름을 그대로 재현한다.

pnpm pre-release   # dashboard 빌드 → relay 기동 → localhost:4000

Dev/test 스크립트 (모노레포 루트에서 실행)

dev/test 커맨드는 루트에서 실행한다. 이 패키지의 스크립트는 루트가 호출하는 구현(leaf)이며, 여기서 직접 타이핑하지 않는다. 전체 목록은 루트 CONTRIBUTING.md.

relay API는 4000, dashboard는 3001(Vite dev server).

pnpm dev           # relay + dashboard + ios + android
pnpm dev:lean      # pnpm dev를 Lean mode로 (두 에이전트 모두)
pnpm dev:pool      # relay + ios + mock agents (시뮬레이터 없이 다중 기기)

pnpm dev:relay                          # 릴레이 단독
pnpm dev:ios                            # 첫 번째 booted 시뮬레이터
pnpm dev:ios -- --device "iPhone 16"   # 디바이스 지정
pnpm dev:android
TAPFLOW_TOKEN=<pat> pnpm mcp            # MCP 서버 (빌드 없이 소스에서 직접 실행)

진단 · 초기화

pnpm doctor    # 시스템 상태 점검 (tapflow doctor와 동일)
pnpm reset     # 시뮬레이터 전체 shutdown (tapflow reset과 동일)

환경변수로 포트·릴레이 URL 오버라이드 가능.

PORT=4000 pnpm dev:relay
RELAY_URL=ws://localhost:4000 pnpm dev:ios

HOW NOT

• 이 디렉토리 코드를 패키지 소스로 import하지 않는다 — 단방향 참조.
• playground 코드를 packages/에 복사하지 않는다.
• 실제 디바이스 자격증명·토큰을 스크립트에 하드코딩하지 않는다.