Huny's Dev Blog
huny.dev

GitHub Event Streams 프리뷰: PR 폴링을 줄이되 상태 재조회는 남겨두기

SSE 기반 PR 알림의 재전송 없음, 중복·역순과 체크 스위트 경계를 이해하고 에이전트의 상태 판정·재연결을 설계한다.

Hun Jang
Hun Jang Nov 18, 2026

PR 피드백을 기다리는 에이전트는 변화가 없을 때도 API를 반복 조회하기 쉽다. GitHub Event Streams는 이 대기 비용을 줄이는 새 선택지다. 다만 이벤트를 받았다는 사실과 PR의 현재 상태를 안다는 것은 다르다.

변화를 알리는 신호와 현재 상태 기록의 차이를 표현한 생성형 개념 이미지다. 실제 GitHub 화면이 아니다.

무엇이 공개됐나

GitHub는 November 17, 2026 Event Streams 프리뷰를 발표했다. PR을 구독하고 연결을 유지하면 리뷰, 새 커밋, 병합 충돌, 종료·병합, 체크 스위트 변화 등의 알림을 받을 수 있다. 공개 웹훅 수신 서버 없이 개발자 컴퓨터에서 사용할 수 있다는 점이 핵심이다.

모든 요금제에 제공되는 프리뷰지만 대기 명단 승인이 필요하다. “모든 요금제”와 “지금 모든 계정에서 사용 가능”은 같은 말이 아니다. 공식 발표

SSE는 변경 알림이지 재생 가능한 기록이 아니다

공식 문서 기준 전송 방식은 SSE이며 현재 PR과 GitHub.com을 지원한다. GHE.com은 아직 대상이 아니다. 한 구독은 PR 하나를 다루고 24시간 뒤 만료된다.

가장 중요한 제한은 재전송이 없다는 점이다. 연결 전·단절 중 이벤트는 놓칠 수 있고, 중복이나 순서가 뒤바뀐 이벤트도 올 수 있다. 구독 후 상태를 한 번 조회하고, 이벤트 수신 시에도 제공된 api_url로 최신 상태를 확인해야 한다.

체크 스위트 이벤트에는 data.conclusion이 포함된다. 그래도 체크 스위트 하나의 성공을 “PR 전체 검사 성공”으로 해석하면 안 된다. 전체 검사 완료 이벤트는 없으며 PR 대화 탭의 일반 댓글도 현재 알림 대상이 아니다. 사용 문서

수신과 행동 사이에 상태 판정을 둔다

아래는 이 글에서 제안하는 처리 구조다. 실제 SDK나 API 호출 코드가 아닌 의사코드이며 실행 결과도 아니다.

예를 들어 체크 성공 알림 직후 새 커밋이 올라왔을 수 있다. 이전 커밋의 성공으로 현재 코드를 승인하지 않으려면 작업 대상의 head SHA와 검사 결과가 일치하는지 확인하는 별도 판정이 필요하다.

또한 중복 알림을 제거하는 것과 업무를 중복 수행하지 않는 것은 별개다. 리뷰에 답글을 작성하거나 작업을 실행하는 에이전트라면 “어떤 상태에 대해 어떤 행동을 완료했는가”를 남겨야 한다. 이는 구현 설계 제안이다.

종료·재연결도 정상 경로로 취급한다

공식 종료 이벤트 github.stream.end는 outcome을 기준으로 처리한다. reconnect면 지연을 분산해 재연결하고, subscription_ended면 만료·접근 권한을 점검한다. 구독을 삭제해도 열린 연결은 자동으로 닫히지 않으므로 연결부터 종료한다.

계정에 기능이 열리지 않은 403 응답을 반복 재시도로 해결하려 해서는 안 된다. 프리뷰에는 API·이벤트·한도 변경 가능성도 있다. 연결 처리와 제한

도입 검증에서는 다음 실패 상황을 일부러 나눠 보는 편이 좋다.

  • 연결을 끊은 동안 PR을 변경한 뒤 재연결해 현재 상태가 복구되는가.
  • 같은 알림을 두 번 넣어도 답글이나 작업이 중복되지 않는가.
  • 이전 커밋의 검사 성공이 최신 커밋의 승인 근거로 섞이지 않는가.
  • 지원하지 않는 일반 댓글까지 감시한다고 잘못 보고하지 않는가.

이 테스트 목록은 권장 검증안이다. 실제 구독 생성, 대기 명단 신청, 인증정보 생성이나 이벤트 수신 실험은 수행하지 않았다.

Event Streams의 가치는 상태 조회를 완전히 없애는 데 있지 않다. 변화가 없는 동안의 반복 조회를 줄이고, 필요한 순간에 정확한 상태를 다시 읽도록 만드는 데 있다. November 18, 2026 공식 문서 확인 기준이다.

추천 글