feat(agent): Librarian atlas 도구 추가 (atlas_upsert / get_neighborhood)

[hagyutae]

배경

A 는 graph db 에 직접 연결 X — L 통해 접근 (proposal §2.5 의 원칙 유지). M3 에서는 L 이 graph 도구 미보유였는데, 본 이슈에서 graph 도구를 L 에 추가해 A 가 사용할 수 있게 함.

스코프

L 의 추가 도구 (M3 의 도구 위에 누적)

도구	시그니처	용도
atlas_upsert_design(nodes, edges)	A 의 부분 그래프 (status: designed) → graph db	컨펌된 설계 merge
graph_get_neighborhood(node_id, depth=2)	영향 범위 노드/엣지	A 가 기존 그래프 영향 분석
graph_traverse_by_query(cypher)	escape hatch	A 의 복잡 쿼리
graph_get_node(id)	단건 조회	sync / 비교

• 모두 Atlas MCP 의 thin wrapper. 비즈니스 검증 (status 전이 정책 등) 만 L 이 추가.
• status: designed 만 본 이슈 범위. status: implemented 전이는 M5+ (Eng diff 색인 시점) 에서 추가.

L 그래프 갱신 (LangGraph)

• 기존 ReAct 그래프에 위 graph 도구 추가
• Doc Store / Atlas MCP 양쪽 클라이언트 보유

비-스코프

• Diff 색인 / get_task_context (M5+)
• status: implemented 전이 (M5+)
• 자연어 질의 → graph 쿼리 자동 변환 (M5+)

검증

• 각 도구 단위 테스트 (모킹된 Atlas MCP)
• A 가 L 에게 SendMessage 로 graph 도구 호출 시 정상 응답
• status: designed 노드 upsert 후 get_neighborhood 로 정상 조회