[#49] merge risk report를 branch 조합 중심으로 구성한다

[opficdev]

🔗 연관된 이슈

• closed merge risk report를 branch 조합 중심으로 구성한다 #49

🎯 의도

branch별 score와 status 중심의 기존 report를 branch 조합 중심 report로 전환

확정 충돌과 잠재 위험, AI 해결안, branch별 영향도, 제외·오류 정보를 한 흐름에서 확인 가능한 구조 제공

📝 작업 내용

📌 요약

• branch 조합 중심 report 모델과 Markdown formatter 구성
• branch 선택부터 조합 생성, merge 분석, conflict graph, AI 분석, report 전송까지 workflow 연결
• 기존 branch 단위 분석·AI·report 경로 제거
• reusable workflow, README, consumer 예제와 저장소 작업 규칙의 계약 정리

🔍 상세

• 활성 기간, 발견 branch 수, 감시 branch 수, 비교 조합 수, clean 조합 수를 포함한 Summary 구성
• Confirmed Conflicts, Potential Risks, Branch Impact, Excluded Branches, Merge Errors section 구성
• 위험 조합별 branch, commit OID, conflict type, 관련 file, reason 표시
• AI Analysis, Recommended Resolution, Suggested Patch와 예방 조치 표시
• 반대 방향 중복과 자기 조합을 제거하고 같은 branch 조합을 한 번만 표시
• clean 조합은 상세 항목 없이 Summary 개수로만 집계
• stale_branch, branch_limit 제외 항목과 merge 분석 오류의 별도 표시
• AI provider 또는 응답 검증 실패를 조합 단위로 격리하고 deterministic graph 결과 유지
• AI 대상 조합이 없을 때 AI client 생성과 provider 호출 차단
• base_branch와 선택된 active branch를 하나의 비교 집합으로 구성하고 중복 없는 전체 조합 생성
• critical_file_patterns workflow input과 WATCHER_CRITICAL_FILE_PATTERNS 실행 계약 제거
• branch 단위 score·prompt·validator·report 모듈과 관련 테스트 제거 및 branch 조합 기준 테스트로 교체
• debug artifact의 branch 조합 계약과 raw source·patch·provider 오류 비기록 유지
• README, consumer workflow 예제, .agents, .codex/agents 문서를 현재 구현 기준으로 정리

📸 영상 / 이미지 (Optional)

• 없음

[gemini-code-assist]

Code Review

본 풀 리퀘스트는 개별 브랜치 위험도 점수화 방식에서 브랜치 쌍(Pair) 조합 분석 및 병합 위험 분석 방식으로 시스템을 개편함. 결정론적 충돌 그래프와 브랜치 쌍 단위의 AI 예측 기능(predictionPairRunner 등)을 도입하고, 기존의 점수화 로직 및 관련 파일들을 제거함. 이에 맞춰 README, 에이전트 역할 정의, 워크플로우 문서 및 테스트 코드를 전반적으로 수정함. 리뷰어 피드백은 존재하지 않으며, 변경 사항이 아키텍처 규칙에 부합하여 추가적인 피드백은 없음.

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.