[draft] feat: PPR v2 — node specificity (IDF) re-ranking

[TaskerJang]

⚠️ 측정 전 — 박제용 draft (머지 보류)

PPR v1의 faithfulness 하락(97→84%) 부검에서 드러난 metric 노이즈 hub(degree 높은 "매출액 2조…" 류가 PPR 상위 점령 → 곁가지 청크 혼입) 처방.

무엇

node specificity 재랭킹: 엔티티 e 의 spec(e) = log(1 + N/df(e)) (df = e 를 언급한 청크 수, N = 전체 청크 수, IDF 계열). raw PPR 은 그대로 두고(활성화 확산 보존) re-ranking 층으로만 곱한다 — eff(e) = pr(e) · spec(e). top-15 엔티티 선정 + 청크 점수 합산 모두 eff 사용 → generic hub 가 끌어온 곁가지 청크가 밀려난다.

• NODE_SPECIFICITY 플래그로 v1(off)/v2(on) 토글
• _compute_specificity 추가, _load_entity_graph가 spec 동봉 캐시, readout이 eff 기준
• top_entities에 ppr/spec 진단 필드 노출

가설 (측정 대기)

• AC 유지/소폭↑ (곁가지 청크 정리)
• faithfulness 회복 (graph_012류 ungrounded 감소) ← 핵심 기대
• 위험: specific metric 과도 down-weight 시 metric 질문(graph_012류) AC 손실 가능

검증

container mock e2e: hub 엔티티 PPR 0.103→eff 0.098로 억제, specific 0.224→0.492로 상승 (entity 랭킹 역전 확인). 실측은 --tag gpt52_e1_ppr_v2로 v1(gpt52_e1_ppr, 24개 2.25 / faithfulness 84%) 대비 예정.

머지 조건: 측정에서 faithfulness 회복 + AC 비퇴행 확인 시.