@verdict-npm/cli

Vera Explore CLI — AI QA from your terminal. v0.2.0

터미널에서 Vera 탐색 세션을 실행하는 CLI. Frontier BFS 크롤(Coverage 페이지 × Depth 링크 깊이)로 사이트를 돌며 버그를 찾는다.

npm install -g @verdict-npm/cli

모드

| 모드 | 조건 | 대상 | |------|------|------| | Cloud | API 키 설정 시 | verdict-app.net /api/v1/* — 계정 크레딧 차감 (1 step = 1 cr) | | Local | API 키 없음 | 로컬 vera-engine (VERA_API_URL, 기본 http://localhost:8000) |

# API 키 발급: verdict-app.net → Settings → API Keys
verdict config set api-key vrd_xxxxxxxx
verdict config show

환경변수 우선: VERDICT_API_KEY, VERDICT_BASE_URL, VERA_API_URL (설정 파일: ~/.verdict/config.json)

명령어

verdict explore <url>                                  # 자동 탐색 (플랜 기본 scope)
verdict explore <url> --pages 5 --depth 2              # Coverage 5페이지, Depth 2
verdict explore <url> --goal "결제 플로우 테스트"        # 목표 지정
verdict explore <url> --preset korea-default           # 거버넌스 프리셋
verdict explore <url> --standard owasp-top10 --standard pipa
verdict explore <url> --fail-on critical               # CI/CD: 해당 심각도 이상 버그 발견 시 exit 1
verdict explore <url> --output results.json            # 결과 JSON 저장
verdict sessions                                       # 최근 세션 목록
verdict balance                                        # 크레딧 잔액 (cloud)
verdict standards list                                 # 표준 목록

explore 옵션

• -p, --pages <n> — Coverage: 테스트할 페이지 수 (플랜 상한: free 15 / starter 30 / pro 60)
• -d, --depth <n> — Depth: 시작 URL에서 링크 깊이 (free 3 / starter 5 / pro 7)
• --steps-per-page <n> — 페이지당 에이전트 스텝 예산 (기본 10)
• -g, --goal <text> — 탐색 목표
• --preset <name> — korea-default | security | accessibility | privacy | startup-saas | full
• --standard <id> — 거버넌스 표준 ID (반복 지정 가능)
• --fail-on <severity> — 해당 심각도 이상 버그 발견 시 exit 1
• --output <path> — 결과 JSON 저장 경로
• 인증: --session <path> (storage_state) | --email/--password | --token | --cookie
• --no-judge / --no-verify / --no-plan — 파이프라인 단계 생략

소요시간: 페이지당 약 2–4분. 비용: 1 step = 1 credit (+verification 시 확정 버그당 +20cr, 최대 3).

CI 예시 (GitHub Actions)

- name: Vera QA gate
  run: |
    npm install -g @verdict-npm/cli
    verdict explore $STAGING_URL --pages 5 --depth 2 --fail-on critical
  env:
    VERDICT_API_KEY: ${{ secrets.VERDICT_API_KEY }}

파이프라인 상세: docs/02_product/spec/vera_pipeline_flow.md