qa-verify

qa-verify — 릴리즈 QA 감사 하네스 (GitHub)

릴리즈의 GitHub QA 이슈 목록 ↔ fix 커밋을 대조해, 수정 누락(NO_FIX)·불완전(INCOMPLETE)·증상 불일치(MISMATCH)를 빌드 배포 전에 검출하는 read-only 감사 하네스입니다. 릴리즈/빌드를 올리기 직전에 돌리는 것이 자연스러운 사용 시점입니다.

역할 경계: 이 하네스는 "각 이슈의 수정이 존재하고, 보고된 증상을 해결하는가"(이슈-수정 대응 여부)만 본다.

• diff 안의 새 버그/품질 문제 탐색은 하지 않는다 → /code-review 의 영역.
• 같은 패턴의 전파 탐색은 하지 않는다 → /find-similar-bugs 의 영역. INCOMPLETE 이슈가 나오면 보고서에서 /find-similar-bugs #NNNN 실행을 권고만 한다 (자동 연쇄 실행 금지).

호출: /qa-verify [버전]

• 예: /qa-verify v1.2.0
• 버전은 GitHub milestone 으로 매핑한다. 생략 시 현재 체크아웃된 git 태그/브랜치명에서 추출 → 그것도 모호하면 열린 milestone 목록을 보여주고 사용자에게 확인.

GitHub 매핑 규약 (ComposeSample 기준)

• 버전 = milestone. QA 이슈 = 해당 milestone + qa(없으면 bug) 라벨이 붙은 이슈.
• 커밋 매핑 기준 ref = main. ComposeSample 은 release 브랜치 없이 main 에 직접 커밋·푸시하므로 release 브랜치를 찾지 않는다.
• 인증은 gh CLI 가 담당한다(토큰을 직접 다루지 않음). milestone/label 운영을 하지 않는 저장소라면 이 하네스는 감사할 이슈가 없어 빈 보고서를 낸다.

---

오케스트레이터 절차 (메인 루프가 따른다)

1. 버전 결정

$ARGUMENTS 의 버전(milestone 명) → 없으면 git describe --tags --abbrev=0 또는 git branch --show-current 에서 추출 → 그것도 모호하면 gh api repos/{owner}/{repo}/milestones --jq '.[].title' 로 열린 milestone 을 보여주고 사용자에게 확인.

2. QA 이슈 수집 (인라인)

• 인증: gh auth status 로 로그인 상태를 확인한다. 인증돼 있지 않으면 즉시 중단하고 gh auth login 안내 (이슈 목록 없이는 진행 불가). gh CLI 가 없으면 설치 안내 후 중단.
• 조회 (읽기 전용 — 이슈 생성/수정/코멘트/라벨 변경 등 쓰기 호출 절대 금지):

  gh issue list --milestone "{version}" --label "qa" --state all \
    --json number,title,body,labels,state --limit 100
  

  qa 라벨 결과가 0건이면 라벨을 bug 로, 그래도 0건이면 라벨 없이 milestone 만으로 재시도하고 그 사실을 사용자에게 알린다. 100건 초과 시 gh 페이지네이션을 위해 --limit 을 올려 전부 수집한다.
• 보안: 토큰 등 자격증명을 출력/로그/보고서에 노출하지 않는다 (gh 가 인증을 관리하므로 토큰을 직접 다루지 않지만, 혹시 노출되는 값이 있으면 마스킹).

3. 이슈↔커밋 매핑 (인라인)

이슈마다 git log --grep "#NNNN" --pretty="%H %s" origin/main (origin/main 이 없으면 현재 브랜치) 로 fix 커밋을 수집한다. (GitHub 의 squash-merge 메시지·일반 커밋 메시지의 #NNNN 참조를 잡는다.)

• 커밋 0건 이슈 → NO_FIX 로 즉시 분류 (에이전트 불필요 — 인라인 처리).
• 커밋이 있는 이슈만 Workflow 로 넘긴다: items = [{ issue:{number,title,body,labels,state}, commits:[{hash,subject}] }]