[10.10.9] 배포

[HeeMang-Lee]

New Features

검색 결과를 항상 단일 "results" 배열로 표준화해 일관된 출력 제공
각 결과에서 url/title/description을 우선 추출하고, 비어있으면 내부 JSON 또는 레거시 블록을 해석해 단일 문서로 생성
결과별 단건 문서 생성 흐름으로 불필요한 누적 제거
Bug Fixes

Brave 도구 초기화 오류 감지 시 자동 초기화 후 재시도로 실패 감소
중첩 JSON·비정형 레거시 형식에 대한 재귀적 정규화 강화로 누락·깨짐 개선
빈 항목은 건너뛰어 무의미한 결과 방지

Summary by CodeRabbit

• New Features
  • 검색 결과 정규화 및 레거시 포맷 지원으로 결과 품질 향상(일관된 URL/제목/설명), 중복 감소
  • RAG 문서 생성 로직 개선으로 결과당 1개 문서, 안정적 메타데이터 제공
• Bug Fixes
  • MCP 클라이언트 초기화/도구 탐지 안정화로 간헐적 검색 실패 완화
• Chores
  • Docker 이미지 빌드 단계 간소화, 실행 검증 추가, 정리 최적화
  • 불필요한 MCP 초기화 설정 제거

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

• Dockerfile final 단계 RUN을 간소화하여 Node.js 22 및 Brave MCP 서버 설치, 래퍼 스크립트 생성, 헬스 체크, 정리를 일괄 처리.
• BraveSearchMcpService에 MCP 클라이언트 해상 및 콘텐츠 정규화 파이프라인 추가.
• BraveSearchRagService의 결과 파싱을 다형 입력 대응 로직으로 재구성.
• application.properties에서 초기화 플래그 제거.

Changes

Cohort / File(s)	Change Summary
Docker 이미지 빌드/런타임 준비 cs25-service/Dockerfile	RUN 단계 단일화(set -eux), Node.js 22 설치, @modelcontextprotocol/server-brave-search 글로벌 설치, /usr/local/bin/server-brave-search 래퍼 생성(exec node …), --help 체크 추가, npm/apt 정리 재정비.
MCP 클라이언트 해상 및 결과 정규화 cs25-service/src/main/java/.../BraveSearchMcpService.java	모든 MCP 클라이언트 순회 및 에러 처리 강화, 필요 시 1회 initialize 재시도, Brave 도구 존재 확인 분리. 콘텐츠 정규화 엔진 추가(Array/Object/텍스트·임베디드 JSON/레거시 블록 처리, 재귀 깊이 제한). 로그 절단/카운트 로깅 추가.
RAG 문서 변환 로직 재구성 cs25-service/src/main/java/.../BraveSearchRagService.java	ObjectMapper 도입. 결과당 1문서 생성으로 단순화. url/title/description 직접 추출 → 텍스트 내 JSON 파싱 → 레거시 Title:/URL: 블록 파싱 순의 다단계 처리. 누락 필드는 빈 문자열 메타데이터로 정규화.
애플리케이션 설정 cs25-service/src/main/resources/application.properties	spring.ai.mcp.client.initialized=false 제거.

Sequence Diagram(s)

sequenceDiagram
  participant App as CS25 Service
  participant MCP as MCP Client Registry
  participant Brave as Brave Web Search Tool

  App->>MCP: resolveBraveClient()
  MCP-->>App: error (not initialized)?
  alt Not initialized
    App->>MCP: initialize()
    App->>MCP: resolveBraveClient()
  end
  App->>MCP: hasBraveTool("brave_web_search")?
  MCP-->>App: yes
  App->>Brave: search(query)
  Brave-->>App: raw content (heterogeneous)
  App->>App: normalizeContent() → results[{url,title,description}]
  App-->>App: documents via RAG toDocuments()

Loading

sequenceDiagram
  participant R as RAG Service
  participant N as Normalized JSON (results[])
  R->>N: iterate result
  alt Direct fields present
    R->>R: use url/title/description
  else JSON-like in text
    R->>R: parse inner JSON, fill missing fields
  else Legacy block
    R->>R: parse Title:/URL: lines, body
  end
  R-->>R: build one Document per result (stable metadata)

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• Refactor: Json파싱 표준화로 MCP Servie 리팩토링 #412: BraveSearchMcpService/BraveSearchRagService의 동일 파싱·정규화 경로를 수정.
• [10.10.8] 배포 #410: Dockerfile RUN 통합 및 application.properties 초기화 플래그 제거와 동일 변경.
• [10.10.2 재배포] Dockerfile 누락 설정변경 추가 #397: Dockerfile의 Brave MCP 설치/래퍼 및 BraveSearchMcpService의 클라이언트 해상 로직에 중복된 변경.

Suggested reviewers

• jong-0126
• Ksr-ccb
• Kimyoonbeom
• crocusia

Poem

깡충, 깡충, 로그를 줄였지—휙!
노드는 22, 래퍼는 얇고 즉시 exec!
JSON의 숲에서 길을 고르고,
Title과 URL도 바구니에 쏙.
문서 한 장씩, 정갈히 묶어 볼게요.
오늘도 토끼 DevOps, 귀 팔랑—배포 완료! 🐇🚀

---

📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d71e146 and a34fbb6.

📒 Files selected for processing (4)

• cs25-service/Dockerfile (1 hunks)
• cs25-service/src/main/java/com/example/cs25service/domain/ai/service/BraveSearchMcpService.java (3 hunks)
• cs25-service/src/main/java/com/example/cs25service/domain/ai/service/BraveSearchRagService.java (2 hunks)
• cs25-service/src/main/resources/application.properties (0 hunks)

✨ Finishing Touches

• 📝 Generate Docstrings

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch dev

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

• Visit our Status Page to check the current availability of CodeRabbit.
• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.