[#41] 활성 branch를 14일과 최대 30개 기준으로 선별한다

[opficdev]

🔗 연관된 이슈

• closed 활성 branch를 14일과 최대 30개 기준으로 선별한다 #41

🎯 의도

• 오래된 remote branch와 과도한 branch 수를 감시 대상에서 제외하여 불필요한 비교를 줄이기 위한 변경
• branch head commit의 committer date와 단일 실행 시각을 기준으로 일관된 branch 선택 결과를 생성

📝 작업 내용

📌 요약

• 최근 14일 이내 활성 branch 선별 및 최대 30개 제한
• 최근 갱신 순 정렬과 동일 시각 branch 이름 순 정렬
• stale_branch, branch_limit 제외 사유 추가
• branch 선택 경계값·정렬·제한·workflow 연동 테스트 보강
• Spark 에이전트 추론 수준을 xhigh로 상향
• 실제 기능을 수행하는 프로덕션 함수·메서드 역할 주석 추가

🔍 상세

issue #41 구현 (bd66e5b)

• git for-each-ref의 갱신 시각을 authordate에서 committerdate로 변경
• run에서 생성한 단일 generatedAt을 selectWithReasons에 전달
• baseBranch와 defaultBranch를 감시 대상에서 제외
• 실행 시각 기준 14일 경계를 포함한 활성 branch 선별
• 갱신 시각이 없거나 유효하지 않은 branch를 stale_branch로 제외
• 활성 branch를 최근 갱신 순으로 정렬하고 동일 시각이면 branch 이름 오름차순으로 정렬
• 정렬된 활성 branch 중 최근 30개만 선택하고 초과 branch를 branch_limit으로 제외
• 기존 branch selection 결과와 branch-selection.json에 선택 결과 및 제외 사유 유지
• 새로운 workflow input, AI prediction, report 출력 형식 변경 없음

추가 유지보수 변경

• d4c5858: .codex/agents/*.toml에서 gpt-5.3-codex-spark를 사용하는 5개 에이전트의 model_reasoning_effort를 xhigh로 변경
• f98e1cf: 실제 기능을 수행하는 프로덕션 함수·메서드에 역할 주석 31줄 추가
• 추가 유지보수 변경에 따른 Watcher 실행 기능 변경 없음

📸 영상 / 이미지 (Optional)

• 해당 없음

[gemini-code-assist]

Code Review

This pull request implements branch filtering and limiting logic, excluding stale branches older than 14 days and capping active branches at 30, sorted by update time and name. It also updates the git branch retrieval to use committer dates and adds inline documentation. The review feedback suggests replacing non-null assertions with optional chaining in the branch sorting function to ensure runtime safety.

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.