[#35] AI 디버깅을 위한 consumer workflow artifact를 구성한다

[opficdev]

🔗 연관된 이슈

• closed AI 디버깅을 위한 consumer workflow artifact를 구성한다 #35

🎯 의도

AI prediction이 실패하거나 기대와 다른 판단을 만들었을 때 consumer repository의 GitHub Actions run에서 원인 추적용 artifact를 확인할 수 있도록 구성

📝 작업 내용

📌 요약

• debug artifact writer와 AI prediction debug observer 추가
• merge risk 실행 중 branch selection, deterministic evidence, AI prompt/response/result, final report 기록
• reusable workflow에 upload_debug_artifact opt-in input과 actions/upload-artifact@v4 업로드 step 추가
• README와 consumer workflow 예시에 debug artifact 사용법 및 포함 파일 설명 추가
• artifact 생성, 비활성 기본값, secret/raw content 미포함 검증 테스트 추가

🔍 상세

• WATCHER_DEBUG_ARTIFACT_DIR가 설정된 경우에만 debug artifact 파일 생성
• run.json, branch-selection.json, deterministic-evidence.json, ai-target-selection.json, ai-prompt.json, ai-response.json, ai-error.json, ai-result.json, report.md 기록
• upload_debug_artifact 기본값은 false로 유지하여 일반 실행에서는 artifact 업로드 비활성
• artifact는 Watcher repository가 아니라 reusable workflow를 호출한 consumer repository의 Actions run에 watcher-debug 이름으로 업로드
• GITHUB_TOKEN, WATCHER_GITHUB_TOKEN, OPENAI_API_KEY, DISCORD_WEBHOOK_URL, raw file content, raw diff 전문 미기록
• branch 제외 사유를 artifact에 남기기 위해 branch selection 결과에 excluded branch metadata 추가

📸 영상 / 이미지 (Optional)

[gemini-code-assist]

Code Review

This pull request introduces a debug artifact feature to help trace AI predictions and branch selection reasons during workflow execution. It adds options to upload debug artifacts, refactors branch selection to track exclusion reasons, and implements a debug observer pattern in the AI prediction runner. The feedback suggests wrapping debug artifact I/O operations and debug observer callbacks in try-catch blocks to ensure that any failures in these auxiliary diagnostic tools do not disrupt the main workflow execution.

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.