feat: AI Runtime HTTP 연결과 장애 격리 구현

[hywznn]

연결 이슈

Refs #8

왜 필요한가요?

기존 구현은 Server가 AI Runtime에 보낼 수 있는 비식별 계약과 응답 검증까지만 제공했습니다.
실제 배포 환경에서 fowoco/ai를 안전하게 호출하려면 서비스 간 인증, 제한시간, 장애 격리,
응답 크기 제한과 안정적인 실패 분류가 추가로 필요합니다.

현재 fowoco/ai에는 /internal/v1/analyses 원본 계약이 아직 release되지 않았으므로,
통합 기능은 기본 비활성화하고 설정을 명시적으로 켠 환경에서만 호출하도록 했습니다.

무엇이 바뀌나요?

• Provider 중립적인 AiRuntimeClient 뒤에 RemoteAiRuntimeClient를 추가했습니다.
• ADR-0002에 맞춰 Authorization: Bearer <service-credential>, X-Request-Id, 선택적 W3C
  traceparent를 전달합니다.
• 요청의 deadlineMs와 Server 상한 중 더 짧은 전체 deadline을 적용합니다.
• fail-fast 동시 호출 제한(bulkhead)과 연속 장애 circuit breaker를 적용합니다.
• 응답을 모두 메모리에 쌓기 전에 크기 제한을 적용하고, camelCase 전용 strict JSON mapper로
  알 수 없는 필드를 거부합니다.
• HTTP·timeout·parsing·인증·rate limit 오류를 안전한 AiRuntimeFailureCode로 분류합니다.
• 자동 HTTP retry는 하지 않습니다. 재시도는 #24가 새 AiAttempt를 기록한 뒤 명시적으로
  수행해야 합니다.
• 미설정 환경에서는 DisabledAiRuntimeClient가 RUNTIME_DISABLED로 안전하게 실패합니다.

설정

• 기본값: AI_RUNTIME_ENABLED=false
• 통합 환경: AI_RUNTIME_ENDPOINT, AI_RUNTIME_SERVICE_CREDENTIAL을 배포 Secret으로 주입
• 세부 timeout, 응답 크기, 동시 호출 수, circuit breaker 설정을 .env.example에 문서화

검증

• ./gradlew test --tests 'com.fowoco.server.aiintegration.*'
• ./gradlew test
• WireMock으로 인증·추적 헤더, camelCase body, strict JSON, 1회 호출, timeout,
  oversized response, bulkhead, circuit breaker를 검증했습니다.

이번 PR에 포함하지 않은 것

• fowoco/ai의 /internal/v1/analyses OpenAPI·JSON Schema 원본 release
• [AI Run] 비동기 실행 상태·재시도·멱등성 구현 #24 AiRun/AiAttempt 영속화와 명시적 재시도 orchestration
• 모델 Provider SDK, Prompt, Agent Pipeline, Task 자동 생성

리뷰 포인트

1. AiRuntimeFailureCode 분류가 #24에서 저장할 진단값으로 충분한지
2. 기본 비활성화와 환경 Secret 주입 방식이 데모 배포 환경에 맞는지
3. timeout·bulkhead·circuit breaker 기본값이 현재 예상 트래픽에 적절한지
4. camelCase 계약을 fowoco/ai 원본 계약으로 확정해도 되는지

[krestar]

408 타임아웃이 INVALID_REQUEST_CONTRACT로 처리되는걸로 보이는데, 문제 없을 것 같으면 나머지 리뷰 포인트 2~4번은 적절해보여서 PR 내용 괜찮아 보입니다

[krestar]

408도 따로 처리 안해도 괜찮으려나요