korean-law

v3.5.4 — 실사용 피드백 반영: NOT_FOUND 명시 시그널 전면 도입

사용자 피드백: "실사용하면 자꾸 답변 못 찾고 AI가 지맘대로 답변함. 못 찾으면 리턴값을 명확하게."

근본 원인: 일부 도구가 조회 실패 시 isError 플래그를 세팅하지 않거나 "없습니다"만 반환 → LLM이 실패 감지 못하고 창작 답변 생성.

• [NOT_FOUND] / [HALLUCINATION_DETECTED] 머신 파싱 마커 전면 도입 — 모든 실패 응답에 기계적으로 감지 가능한 프리픽스 + "⚠️ LLM은 추측/생성 금지" 경고문 표준화
• verify_citations — failCount > 0일 때 isError: true 설정. 환각 검출됐는데 "검증 성공"으로 오인되던 심각한 버그 수정
• annex.ts / law-text.ts / article-detail.ts 등 10+개 파일 — isError: true 누락 수정
• 체인 도구 부분 실패 투명화 — chains.ts의 silent-drop 패턴 제거. 실패한 섹션도 [NOT_FOUND / FAILED] 마커와 사유를 명시 노출 (80자 → 200자 확장)
• 신규 헬퍼 notFoundResponse(message, suggestions?)로 일관성 확보

v3.5.3 — verify_citations 실증 검증 후 3개 치명 버그 수정

실제 법제처 API로 5건 테스트 → false negative 3건 발견 → 근본 원인 수정:

• "민법" → "난민법" 부분매칭 오매칭 — 기존 chains.ts의 findLaws/scoreLawRelevance가 이미 해결해둔 로직인데 verify_citations가 재사용하지 않고 자체 로직으로 중복 구현했던 것. 공용 모듈 lib/law-search.ts로 추출하여 양쪽 재사용 (중복 제거)
• 원숫자(①②③…) 항번호 파싱 실패 — 법제처 API가 항번호를 "① " 형태로 리턴하는데 기존 parseInt(raw.replace(/[^\d]/g, ""))가 유니코드 원숫자를 제거해 NaN. 근로기준법 제60조 제1항이 실존함에도 "최대 제0항" 오판정 → lib/article-parser.ts에 parseHangNumber() 원숫자 매핑 유틸 추가
• 짧은 법령명 검색 누락 — 법제처 lawSearch API가 display=20에서 "상법"을 결과 34번째로 리턴. apiClient.searchLaw에 display 파라미터 추가, verify_citations는 searchDisplay=100으로 호출

검증 후 5/5 정확 판정 (위 예시 결과가 그 출력).

v3.5.2 — kordoc 2.3.0 → 2.4.0 업데이트 (별표/서식 파싱 엔진)

v3.5.1 — lite/full 프로필 체계 제거 (V3_EXPOSED 16개 고정 노출 도입 후 실질 미사용). tool-profiles.ts에서 LITE_TOOLS/parseProfile/filterToolsByProfile 제거, 헬스 엔드포인트 거짓 profiles 필드 → 정확한 tools: { exposed: 16, total: 92 } 로 교체. Breaking change 아님 (?profile=lite도 이미 무시되던 값)

v3.5.0 — Killer feature: verify_citations 인용 검증 + Critical 핫픽스 + 보안 강화

• verify_citations 신규 — LLM 환각 방지. 사용자 텍스트에서 조문 인용 정규식 추출 + 직전 30자 lookback으로 법령명 역추적 + 법제처 DB 병렬 교차검증. 결과: ✓(실존) / ✗(없음, 존재 범위 제시) / ⚠(법령명 불명확)
• Critical 핫픽스 — v3.4.0 full 파라미터가 12개 도메인(tax_tribunal, customs, ftc, pipc, nlrc, acr, treaty, interpretation 등)에서 스키마에 필드가 없어 묵묵히 무시되던 문제 수정. unified-decisions.ts가 하위 핸들러 응답을 받은 뒤 compactLongSections() 후처리로 계단식 축약 일괄 적용
• 보안 High 2건 — fetch-with-retry.ts 타임아웃/네트워크 에러에 API 키 포함 URL이 로그로 유출되던 문제 → maskSensitiveUrl()로 OC=*** 마스킹. trust proxy true → TRUST_PROXY 환경변수(기본 1), X-Forwarded-For 스푸핑 rate limit 우회 차단
• 품질 3건 — decision-compact.ts 날짜 정규식 경계 가드, TAIL 경계 ". " 오탐 제거, stripRepeatedSummary 종료점 정확 탐지
• UX — 체인 8개 description 구체화(LLM이 체인 선택 가능), 검색 결과 "💡 다음: get_law_text(...)" 힌트, search_law 약칭/오타 확장 자동 재시도, query-router 패턴 5개 추가, discover_tools 별칭 매칭 27개