test

name

test

description

Use when verifying the naverworks codebase — runs unit, integration, and e2e test layers with go test, go vet, and build smoke check. Triggers on "테스트", "test", "/test". Covers test pyramid (unit/integration/e2e) with real functionality verification. For local binaries, use build. For releasing, use deploy. For managing existing releases, use release. For version inspection or tag creation, use version.

naverworks 테스트

이 스킬은 AI 에이전트가 직접 실행한다. 모든 명령을 순서대로 실행하고 결과를 보고한다.

입출력 계약

입력

입력	필수 여부	형식	설명
scope	선택	enum: all(기본), unit, integration, e2e, coverage	실행할 테스트 범위

출력

필드	설명
mod_status	go mod tidy 및 go.mod/go.sum 변경 여부
vet_status	go vet ./... 결과
layer_results	Unit/Integration/E2E 각 레이어의 PASS/FAIL과 실패 테스트 상세
build_status	스모크 빌드 및 version 명령 실행 결과

성공 기준

• 지정된 모든 레이어에서 테스트가 PASS한다.
• go vet이 이상 없다.
• 스모크 빌드가 성공하고 naverworks version이 정상 출력된다.

실행 규칙

1. 모든 명령을 직접 Bash로 실행한다.
2. 각 단계의 결과를 ✓/✗ 형식으로 보고한다.
3. 실패한 테스트가 있으면 실패 내용을 상세히 보고한다.
4. 사용자 입력 없이 자동 실행한다.

Test Pyramid Strategy

각 레이어의 전략만 간략히 기술한다. 실제 실행 명령은 Run by Layer 섹션이 단일 source of truth다.

Layer 1: Unit Tests

• Target: 순수 함수, 데이터 모델, 유틸리티 (internal/output, internal/auth/jwt, internal/config, internal/auth/token, cmd/task_cmd, cmd/smoke_test.go 내 헬퍼/파서)
• Isolation: 파일시스템은 t.TempDir(), HTTP 없음
• Speed: <1초, 매 커밋마다 실행

Layer 2: Integration Tests

• Target: 모듈 경계 — HTTP 클라이언트, OAuth 흐름, API 서비스 엔드포인트 (internal/api/client, internal/auth/oauth, internal/api/* 서비스별 100+ 테이블 기반 케이스)
• Isolation: httptest.NewServer로 로컬 HTTP 서버, 실제 외부 API 호출 없음
• Speed: 1~3초, PR 전/CI 전 실행

Layer 3: E2E Tests

• Target: CLI 명령 워크플로우 (cmd/smoke_test의 46개 CLI 워크플로우), 보안 검증 (cmd/e2e_security의 atomic write, 동시성, 응답 크기 제한, SHA 핀닝), .github/workflows/*.yml SHA 핀닝 검증
• Entry Points: naverworks version/help, bot send, config get/set, auth status, calendar 명령
• Isolation: setupTestEnv로 HOME/환경변수 격리, httptest로 API 모킹
• Speed: 수초~수십초, 릴리스 전 또는 보안 변경 후 실행

Procedure

Run All Tests (피라미드 순서)

1. Phase 1: 모듈 정합성

   go mod tidy
   

   git diff --exit-code go.mod go.sum
   

   → 변경이 있으면 ✗ 보고하고 이후 단계는 계속 진행 (중단하지 않음)

2. Phase 2: 정적 분석

   go vet ./...
   

   → 실패 시 실패 패키지와 대표 오류를 보고하고 이후 단계는 계속 진행

3. Phase 3: Unit

   • Run by Layer의 Unit only 명령을 그대로 실행 → 실패 시 FAIL 패키지와 테스트 함수명 보고

4. Phase 4: Integration

   • Run by Layer의 Integration only 명령을 그대로 실행 → 실패 시 FAIL 패키지와 테스트 함수명 보고

5. Phase 5: E2E

   • Run by Layer의 E2E only 명령을 그대로 실행 → 실패 시 FAIL 패키지와 테스트 함수명 보고

6. Phase 6: 빌드 확인

   go build -o /tmp/naverworks-test .
   

   /tmp/naverworks-test version
   

   rm -f /tmp/naverworks-test
   

Run by Layer

• Unit only (각 명령 개별 실행 후 결과를 모두 보고):

  1. go test ./internal/output/... ./internal/config/... -v -count=1
  2. go test ./internal/auth/... -run "Test(BuildJWT|CheckKey|Token|ProfileToken|WriteSecure|SaveSecure)" -v -count=1
  3. go test ./cmd/... -run "Test(BuildTask|ResolveUserID|RequireTitleBodyPost|ParseOptionalJSONData|ResolveBotID|ResolveOrCreateProfile)" -v -count=1

• Integration only (각 명령 개별 실행 후 결과를 모두 보고):

  1. go test ./internal/api/... -v -count=1
  2. go test ./internal/auth/... -run "Test(BuildAuthorizationURL|ExchangeCode|RefreshToken|RevokeToken|FindAvailableListener|HasScope|GenerateState|RequestToken)" -v -count=1

• E2E only:

  1. go test ./cmd/... -run "Test(Smoke|E2E)" -v -count=1

Run with Coverage

go test ./... -cover -coverprofile=coverage.out

go tool cover -func=coverage.out

보고

성공 시:

테스트 결과:

✓ go mod tidy — 완료
✓ git diff go.mod go.sum — 변경 없음
✓ go vet — 이상 없음
✓ Unit — N 패키지 PASS
✓ Integration — N 패키지 PASS
✓ E2E — N 패키지 PASS
✓ go build — 빌드 성공

실패 시:

✗ Integration — 1/4 패키지 FAIL
  FAIL github.com/physics91/naverworks-cli/internal/api
    TestClient_401_Retry: expected 200, got 401

다음 단계: 실패한 테스트를 수정하세요.

Test Environment Setup

• 외부 의존성: 없음 (Docker Compose 불필요)
• 환경 격리: t.TempDir() + t.Setenv() (NW_* 변수 클리어)
• 테스트 헬퍼:
  • cmd/smoke_test.go: setupTestEnv(), writeTestConfig(), runCLI(), captureStdout()
  • internal/auth/jwt_test.go: generateTestKey()

What to Test vs What to Mock

Layer	Real	Mocked
Unit	함수 로직, 파일 I/O (TempDir)	HTTP, 외부 서비스, 시간
Integration	HTTP 클라이언트 + httptest 서버	실제 NAVER WORKS API
E2E	CLI 실행, Cobra 명령 라우팅, 보안 검증	API 서버 (httptest)

Best Practices

• 테스트는 -count=1로 캐시를 끄고 실행한다
• 파일시스템 의존 테스트는 t.TempDir와 t.Setenv로 격리한다
• 네트워크 의존 테스트는 실제 외부 호출 대신 httptest.NewServer를 사용한다
• 테이블 기반 테스트(table-driven tests)로 엔드포인트 검증을 구조화한다

Caveats

• CI에서 -race 플래그 미사용
• t.Parallel() 미사용 (순차 실행)
• cmd/ 커버리지 12.9%로 낮음
• Docker Compose 없음 (순수 Go 프로젝트라 불필요)
• e2e_security_test.go는 //go:build !windows 태그 — Windows에서 일부 건너뜀