v8gh:login

Verse8 Tracker - GitHub 인증 설정

GitHub CLI 인증 상태를 확인하고, 필요한 권한을 안내합니다.

---

확인 절차 (순서대로 실행)

Step 1: GitHub CLI 인증 확인

gh auth status 를 실행하세요.

• 인증 안 됨 → Step 2A로
• 인증 됨 → Step 2B로

Step 2A: 미인증 — 로그인 안내

아래 메시지를 사용자에게 보여주세요:

GitHub 인증이 필요합니다. 아래 명령어를 터미널에서 실행해주세요:

  ! gh auth login -s project,read:org

선택 옵션:
  - GitHub.com
  - HTTPS
  - Login with a web browser (추천)

완료 후 다시 /v8gh:login 을 실행해주세요.

여기서 중단합니다. Step 3은 다시 호출됐을 때 진행합니다.

Step 2B: 인증 됨 — 스코프 확인

gh auth status 출력에서 Token scopes를 확인하세요. project 스코프가 포함되어 있는지 확인합니다.

• project 스코프 없음 → 아래 안내:

project 권한이 필요합니다. 아래 명령어를 터미널에서 실행해주세요:

  ! gh auth refresh --hostname github.com -s project,read:org

완료 후 다시 /v8gh:login 을 실행해주세요.

여기서 중단합니다.

• project 스코프 있음 → Step 3으로

Step 3: 프로젝트 접근 권한 테스트

실제로 프로젝트 데이터를 조회하여 권한을 검증합니다:

gh api graphql -f query='
  query {
    organization(login: "planetarium") {
      projectV2(number: 140) {
        title
        items(first: 1) {
          totalCount
        }
      }
    }
  }
'

• 성공 → Step 4로
• 실패 (권한 오류) → 아래 안내:

GitHub 인증은 되어있지만 Verse8 Tracker 프로젝트에 접근할 수 없습니다.

가능한 원인:
1. planetarium 조직의 멤버가 아님
2. 프로젝트 접근 권한이 없음

조직 관리자에게 프로젝트 접근 권한을 요청해주세요:
https://github.com/orgs/planetarium/projects/140

Step 4: 모든 확인 완료

조회된 프로젝트 title과 총 아이템 수를 포함해서 안내하세요:

v8gh 인증 확인 완료!

  계정: {username}
  프로젝트: {project title}
  총 아이템: {totalCount}개

/v8gh 명령어를 사용할 수 있습니다.

사용 예시:
  /v8gh 내 이슈 보여줘
  /v8gh 보드 요약해줘
  /v8gh:new 이슈 제목