[#28] Gemini prediction 요청 안정성과 입력 크기 제한을 구성한다

[opficdev]

🔗 연관된 이슈

• closed Gemini prediction 요청 안정성과 입력 크기 제한을 구성한다 #28

🎯 의도

• Gemini API quota와 일시 실패 상황에서도 Watcher의 deterministic report를 유지하고 AI prediction 실패 범위를 branch 단위로 제한하기 위한 안정성 개선

📝 작업 내용

📌 요약

• AI prediction 호출 대상 축소
• Gemini API 일시 실패 retry 구성
• AI prediction 호출 직렬화와 호출 간격 추가
• AI 응답 contract 강화
• Gemini quota 오류 메시지 요약
• README의 AI prediction 동작 설명 정리

🔍 상세

• AI prediction 대상을 critical possibility로 제한
• confirmed_conflict branch는 AI 호출 없이 deterministic report만 사용하도록 변경
• Gemini 429, 500, 502, 503, 504 응답에 대한 retry 구성
• 선택된 AI prediction을 병렬 호출하지 않고 순차 처리하도록 변경
• 선택된 AI provider 호출 사이에 내부 60초 대기 추가
• AI confidence를 0~100 정수로 검증하도록 변경
• prompt에 deterministic score 보존, 확률 표현 금지, 한국어 응답 요구사항 추가
• Gemini quota 오류를 metric, limit, model, retry after 중심으로 요약
• AI prediction 대상과 skipped 조건에 맞게 README 설명 정리
• 관련 unit test 보강

📸 영상 / 이미지 (Optional)

[gemini-code-assist]

Code Review

이번 풀 리퀘스트는 Gemini API 호출의 안정성을 높이기 위해 예측 대상을 critical 상태 브랜치로 제한하고, 호출 간 60초 대기 및 지수 백오프 재시도 로직을 도입했습니다. 리뷰에서는 두 파일에 중복 정의된 delay 함수의 통합 및 예외 처리 보완, Number.isInteger 검증 시 불필요한 중복 조건 제거, 그리고 confirmed_conflict로 인해 생략된 브랜치의 반환 사유("below_threshold")를 명확하게 개선할 것을 제안했습니다.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.