vhk: Skill for Codex

auto-merge — 제한된 자동 머지

가동: 전용 Codex 세션에서 $auto-merge를 명시적으로 호출한다. 호출 1회는 열린 PR을 한 번만 훑고 종료한다. 헌법 관계: 머지까지만 자동. npm publish는 사람 2FA(가드 #119), main 직접 push 금지 그대로.

0. 하드 스톱 (매 주기 첫 단계, 예외 없음)

• 저장소 루트에서 .vhk/HARD_STOP 존재 여부를 읽기 전용으로 확인한다.
• 존재 → 즉시 전체 중단, 사유 보고. 우회·삭제 금지.
• 원래 checkout은 상태 확인 외에 이동하거나 수정하지 않는다. G4에서만 정확한 PR head를 detached 임시 worktree로 분리한다.

1. 대상 수집

gh pr list --state open --base main --label auto-merge --limit 1000 --json number,title,headRefName,headRefOid,baseRefName,additions,deletions
gh repo view --json nameWithOwner

• auto-merge 라벨 없는 PR은 절대 건드리지 않는다 (조회도 라벨 필터로만).
• 전체 대상 목록을 수집한 다음 주기당 최대 3개 제한을 적용한다. 각 PR의 headRefOid는 이번 주기의 검토·머지 기준으로 유지한다.
• 0건이면 "대상 없음" 한 줄 보고 후 주기 종료.

2. PR별 게이트 (순서대로, 하나라도 탈락 시 스킵)

게이트	판정	탈락 시
G1. CI	gh pr checks <n> 전부 pass. pending 있으면 "대기" — 실패 아님, 다음 주기 재검	스킵
G2. diff 상한	additions+deletions ≤ 500줄. 초과 = 사람 검토 필요	스킵 + 보고에 "사람 호출" 표기
G3. CodeRabbit 해소	아래 GraphQL로 미해결 리뷰 스레드 0개 확인	스킵
G4. 적대적 최종 리뷰	아래 §3	스킵 + 사유 보고

G3 쿼리 — nameWithOwner를 owner/name으로 나누고 GraphQL 변수로 전달한다. 저장소 좌표를 파일에 하드코딩하지 않는다. 현재 셸의 따옴표 규칙만 사용하고 서로 다른 셸 문법을 섞지 않는다.

query($owner:String!, $name:String!, $number:Int!, $endCursor:String) {
  repository(owner:$owner, name:$name) {
    pullRequest(number:$number) {
      reviewThreads(first:100, after:$endCursor) {
        nodes { isResolved }
        pageInfo { hasNextPage endCursor }
      }
    }
  }
}

hasNextPage가 false가 될 때까지 endCursor를 다음 요청에 넘긴다. 어느 페이지든 isResolved: false가 하나라도 있으면 탈락한다. 조회 실패나 페이지 누락은 통과가 아니라 스킵이다.

3. 적대적 최종 리뷰 (G4)

원래 checkout에서 base와 PR head를 갱신한 뒤, PR head를 detached 임시 worktree로 분리해 독립 리뷰를 실행한다. <temporary-path>는 이번 실행만을 위한 새 경로여야 한다.

git update-ref -d refs/vhk-auto-merge/pr-<n>
git fetch origin main "pull/<n>/head:refs/vhk-auto-merge/pr-<n>"
git rev-parse refs/vhk-auto-merge/pr-<n>

git rev-parse 결과가 수집 시 저장한 <headRefOid>와 같은 경우에만 아래 단계로 진행한다.