v0.8.3 — 버전 표기 동기화 + setup 완료 메시지 정리

버전 표기 동기화 + setup 완료 메시지 정리: `SERVER_VERSION` 이 0.0.1 로 고정돼 있던 stale 이슈를 package.json 동적 로드로 해결. setup 완료 메시지에 실제 설치 버전 노출.

Fixed

• `SERVER_VERSION` stale 해소 (src/server.ts) — 이전엔 `"0.0.1"` 하드코딩 → MCP 클라이언트 server info, stdio 서버 startup 로그가 모두 잘못된 버전 표시. 이제 `package.json` 을 런타임에 읽어 자동 동기화 (npm publish 마다 별도 작업 불필요).

Changed

• setup 완료 메시지 단순화 (src/scripts/setup.ts) — 모드별 (로컬/원격) 안내 분기 제거. 대신 `vX.Y.Z 버전으로 설치가 완료되었습니다.` + 재시작 안내 두 줄로. 버전은 `package.json` 동적 로드.

Internal

• `tests/smoke.test.ts` — server version assertion 도 `package.json` 동적 로드로 변경.

전체 변경 이력: CHANGELOG.md

v0.8.2 — setup wizard 입력 검증 강화

setup wizard 입력 검증 강화 + 문구 다듬기: 미감지 클라이언트 선택을 거부해 의미 없는 빈 config 파일 생성을 차단. 배너·운영 모드·완료 메시지 문구를 사용자 관점에서 간결화.

Fixed

• 감지되지 않은 클라이언트 선택 거부 (src/scripts/setup.ts) — 이전엔 범위 (1~5) 만 검증해서 미감지 클라이언트도 선택 가능 → 사용자 PC 에 의미 없는 빈 config 파일 생성됨. 이제 detectedFlags 로 차단, 어느 번호가 미감지인지 명시 + 0 (수동 안내) escape hatch 안내. 클라이언트가 실제 설치되고 한 번이라도 실행되어 config 디렉터리/파일이 만들어진 후에 setup 권장.

Changed

• setup wizard 문구 다듬기:
  • 배너 부제: "법제처 31 + PIPC 인덱스 2 + RAG 3 + 검증 1 = 37개 도구" → "법제처 자료와 개인정보포털 자료의 연계 활용"
  • Step 1 "IP/도메인 등록은 비워두는 것을 권장" 안내 줄 제거
  • Step 2 원격 모드 설명: "즉시 37개 도구 사용 (best-effort, cold start 가능)" → "원격지에서 실행 - 약간 느림"
  • 완료 메시지: "RAG 코퍼스 (2,432 청크) 가 패키지에 번들되어 별도 다운로드 불필요" 줄 제거

전체 변경 이력: CHANGELOG.md

v0.8.1 — HF 코퍼스 v1.2 + setup/uninstall 마법사

HF 코퍼스 v1.2 동기화 + 설치/제거 마법사 도입 + 설치 안내 정비: 분야별 개인정보 보호 안내서가 8개 편 전체 청킹 완료되어 RAG 코퍼스가 2,202 → 2,432 청크로 확장. npx korean-privacy-law-mcp setup 한 줄로 API 키 입력 → 운영 모드 → MCP 클라이언트 설정 자동 등록까지 마치는 인터랙티브 마법사 신설. 짝궁으로 uninstall 도 함께.

Added

• setup 서브커맨드 신설 (src/scripts/setup.ts) — npx korean-privacy-law-mcp setup. 3단계 흐름:

  1. API 키 (필수) — 빈 값이면 빨간 경고 + 재요청
  2. 운영 모드 — 로컬 stdio (권장) / 원격 HF Space, [기본=1] 디폴트
  3. 클라이언트 다중 선택 — Claude Desktop / Cursor / Windsurf / VS Code / Claude Code, 감지된 항목 자동 디폴트, ^\d+\$ + range check, 0 escape hatch

  Claude Desktop 은 anthropics/claude-ai-mcp#211 회피용 mcp-remote 자동 적용.

• uninstall 서브커맨드 신설 (src/scripts/uninstall.ts) — npx korean-privacy-law-mcp uninstall. 검사 → 보고 → 기본 No prompt → 클라이언트 설정 + npx 캐시 정리 + 수동 정리 안내.

• src/index.ts 서브커맨드 라우팅 — setup / uninstall 분기.

Changed

• HF 코퍼스 v1.2 동기화 — 분야별 안내서 246 → 476 청크 (+230, 통계작성 54·공공기관 48·온라인 경품행사 16 신규). 총 코퍼스 2,202 → 2,432 청크.
• data/hf_dataset/CHANGELOG.md 신설 — 데이터셋 자체의 버전 이력 (v1.0 → v1.2) 별도 관리.
• README 설치 섹션 재구성 (alio 형식) — 사전 준비 1·2 + 방법 1 (npx 자동) + 방법 2 (claude.ai 웹) 2가지로 정리. 불안정한 npm install -g 수동 방식 제거.

Internal

• huggingface/ 폴더 GitHub 비노출 (.gitignore).

전체 변경 이력: CHANGELOG.md

v0.8.0 — 최초 공개 release

최초 공개 release: PIPA 도메인 깊이를 차별화 축으로 하는 한국 개인정보보호법 전문 MCP — 법제처 OPEN API 31개 wrapper + PIPC 공식 출처 인덱스 2개 + RAG 코퍼스 3개 + 4계층 환각 검증 1개, 총 37개 도구.

Added

• Layer A — Primitives 31개 (법제처 OPEN API wrapper). 법령 검색·본문·관계·구조·시간축·비교·행정규칙·결정문 (PIPC·헌재·행심)·해석례·영문·용어·약칭. 짧은 법령명 display=100 강제, 영문 법령 XML 강제, PIPC 결정문 <Ppc> case-sensitive, 행정심판례 PrecService root, lsAbrv 24h 캐시 등 API quirk 모두 처리.
• Layer B+ — PIPC 공식 출처 인덱스 2개:
  • get_sectoral_related_laws(sector?) — 「분야별 개인정보 보호 안내서」 (PIPC, 2024.12) 8개 분야 정형 표 lookup
  • get_pipc_curated_corpus(category?) — 개인정보 포털 (privacy.go.kr/contsNo=116·117) 12 법령 + 23 행정규칙
• Layer C — RAG 코퍼스 3개 (총 2,202 청크, Contextual Retrieval 적용):
  • search_privacy_corpus — 가이드 + 사례 통합
  • search_privacy_guides(doc_type?) — PIPC 공식 가이드 4종
  • search_privacy_cases — privacy.go.kr 상담사례 1,745건
• Validator 1개 — verify_pipa_citation(citation, as_of?) 4계층 환각 검증
• HTTP Streamable 진입점 + HF Space 배포 + npx 실행 + 441 테스트

전체 변경 이력: CHANGELOG.md