헤르메스(Hermes) 명리학 에이전트 — 3대 자료 계통을 근거로 스스로 검증하는 LangGraph 파이프라인 구축기 (큰그림 확정본 v2.0)

from typing import TypedDict, Literal, Optional
from langgraph.graph import StateGraph, END

# 3대 자료 계통 - 절대 혼용 금지
Lineage = Literal["sangni", "gwanbeop", "parkcheonghwa"]

class HermesState(TypedDict):
    # 입력
    saju: dict            # 시주|일주|월주|연주 (오른쪽→왼쪽)
    question: str
    # 라우팅
    lineage: Optional[Lineage]        # N2가 확정
    # 검색 근거 (slide 번호 필수)
    evidence: list[dict]              # [{"source":..., "slide":..., "text":...}]
    # 합성 결과
    draft: Optional[str]
    # 검증
    guardrail_flag: Optional[str]     # 처방형 단정 감지 시 사유
    verified: bool                    # N6 통과 여부
    retry_count: int                  # 3회 실패 시 멈춤 (반성문 원칙 1)

def n2_route_lineage(state: HermesState) -> HermesState:
    """source 메타 필터를 강제로 확정. 미지정이면 중단. (판단층)"""
    q = state["question"]
    if any(k in q for k in ["우주변화", "역법", "황경", "절기 원리"]):
        state["lineage"] = "sangni"          # 상리철학 계통
    elif any(k in q for k in ["직업", "운의 해석", "정진반"]):
        state["lineage"] = "parkcheonghwa"
    else:
        state["lineage"] = "gwanbeop"        # 4관법 기본
    return state

GUARD_BLOCK = ["격국", "용신", "기신", "희신"]
GUARD_ALLOW_CONTEXT = ["희기동소", "격청격탁", "재정립", "비교", "관점"]

def n4_guardrail(state: HermesState) -> HermesState:
    """문맥 기반 차단: 처방형 단정만 차단, 희기동소 등은 허용. (규율층)"""
    draft = state.get("draft", "")
    for term in GUARD_BLOCK:
        # 처방형 단정 패턴: "용신은 OO" / "OO이 용신"
        if f"{term}은" in draft or f"{term}이" in draft:
            if any(ctx in draft for ctx in GUARD_ALLOW_CONTEXT):
                continue                      # 허용 맥락이면 통과
            state["guardrail_flag"] = f"처방형 단정 감지: {term}"
            return state
    state["guardrail_flag"] = None
    return state

def n6_verify(state: HermesState) -> HermesState:
    """fail-closed: 근거(slide) 없으면 답변 차단. (규율층)"""
    if not state["evidence"]:
        state["verified"] = False
    elif not all("slide" in e for e in state["evidence"]):
        state["verified"] = False
    elif state.get("guardrail_flag"):
        state["verified"] = False
    else:
        state["verified"] = True
    return state

def route_after_verify(state: HermesState) -> Literal["retry", "output"]:
    if state["verified"]:
        return "output"
    if state["retry_count"] >= 3:            # 반성문 원칙: 3회 실패 시 멈춤
        return "output"                       # (사용자에게 "근거 부족" 고지 후 종료)
    state["retry_count"] += 1
    return "retry"

# 그래프 조립 (조립층 — 하위 스킬을 호출로만 엮는다)
g = StateGraph(HermesState)
g.add_node("N1_parse",  n1_parse_saju)
g.add_node("N2_route",  n2_route_lineage)
g.add_node("N3_rag",    n3_rag_search)     # 계통별 병렬 검색
g.add_node("N4_guard",  n4_guardrail)
g.add_node("N5_synth",  n5_synthesize)
g.add_node("N6_verify", n6_verify)

g.set_entry_point("N1_parse")
g.add_edge("N1_parse", "N2_route")
g.add_edge("N2_route", "N3_rag")
g.add_edge("N3_rag",   "N5_synth")   # 합성 먼저
g.add_edge("N5_synth", "N4_guard")   # 합성문에 대해 가드레일
g.add_edge("N4_guard", "N6_verify")
g.add_conditional_edges("N6_verify", route_after_verify, {
    "retry":  "N3_rag",   # 재검색 루프
    "output": END,
})
app = g.compile()

-- 상리철학 계통만 조회 (역법·우주변화 분류 반영)
SELECT source, slide, content
FROM gwanbeop_ppt
WHERE source IN ('역법의원리분석', '우주변화의원리', '상리철학_조명언', '상리철학_김동화')
  AND content IS NOT NULL              -- 스텁(빈칸) 배제
  AND char_length(content) > 0
ORDER BY source, slide;

-- 계통별 실제 등재 건수 검증 (문서 아닌 사실 확인)
SELECT
  CASE
    WHEN source LIKE '박청화%' THEN '② 박청화'
    WHEN source IN ('역법의원리분석','우주변화의원리') THEN '③ 상리철학'
    ELSE '① 4관법'
  END AS lineage,
  COUNT(*) AS cnt
FROM gwanbeop_ppt
WHERE content IS NOT NULL AND char_length(content) > 0
GROUP BY 1
ORDER BY 1;

당신은 한바둑 헤르메스 명리학 에이전트의 통변 합성기입니다.

[절대 규칙]
1. 아래 <evidence>에 주어진 근거만 사용한다.
   근거에 없는 내용은 절대 지어내지 않는다.
2. 모든 통변 문장 끝에 근거 slide 번호를 [source:slide] 형식으로 반드시 표기한다.
   근거를 댈 수 없는 문장은 아예 쓰지 않는다.
3. 3대 자료 계통을 섞지 않는다. 이번 질의의 계통은 {lineage} 이다.
   다른 계통의 논리를 끌어오지 않는다.
4. 격국·용신·기신·희신을 처방형으로 단정하지 않는다("용신은 OO입니다" 금지).
   단, 희기동소·격청격탁·재정립·비교 맥락의 언급은 허용한다.
5. 사주 표기는 시주|일주|월주|연주 순서(오른쪽→왼쪽)를 지킨다.
6. 모르면 "근거가 부족하다"고 밝힌다. 아는 척하지 않는다.

[출력 형식]
- 각 문단: 통변 내용 + [source:slide]
- 마지막 줄: 사용한 근거 slide 목록

<saju>{saju}</saju>
<lineage>{lineage}</lineage>
<question>{question}</question>
<evidence>{evidence}</evidence>