Gemini를 기본 AI provider로 연결한다

[opficdev]

목표

Gemini API를 Watcher의 기본 AI provider로 연결함.

배경

Watcher의 AI prediction core는 provider-independent interface까지 구성되어 있음.
실제 운영 기본값은 OpenAI가 아니라 Gemini API를 사용하도록 정리함.
Gemini는 API key 기반으로 연결하고 Watcher는 deterministic evidence를 Gemini에 전달해 prediction과 recommended actions를 받는 구조로 구성함.

작업 범위

• Gemini prediction client 구현
• GEMINI_API_KEY 기반 secret 계약 구성
• 기본 Gemini model 상수 구성
• Gemini 응답 JSON parsing과 기존 AI prediction schema validation 연결
• Gemini 호출 실패를 branch 단위 failed result로 유지
• 기존 provider-independent AiPredictionClient interface 유지
• OpenAI 전제 문구를 Gemini 기준으로 정리
• README와 AGENTS의 secret/provider 문구 정리

제외 범위

• OpenAI provider 구현
• OAuth 기반 AI 계정 로그인
• CLI 사용 경로 구성
• deterministic possibility score rule 변경
• Discord report 전송 구현
• reusable workflow 구현

완료 조건

• Watcher 기본 AI provider가 Gemini 기준으로 설명됨
• GEMINI_API_KEY가 기본 AI secret으로 문서화됨
• Gemini client가 기존 AiPredictionClient interface를 구현함
• Gemini 응답이 기존 validateAiPredictionResponse를 통과해야만 predicted result가 됨
• Gemini 호출 실패나 schema 실패가 deterministic possibility 결과를 깨뜨리지 않음
• OpenAI 전제가 코드와 문서의 기본 경로에 남지 않음

검증

• Gemini client 단위 테스트
• Gemini response parsing 테스트
• Gemini API key 누락 테스트
• Gemini 호출 실패 fallback 테스트
• npm run build
• npm test