Apply Dark Tech Editorial CLI design system

Author: pikker1981

.claude/commands/deploy.md

@@ -0,0 +1,40 @@
+# 커밋 + 푸시 + Fly.io 배포
+
+변경사항을 커밋, 푸시하고 Fly.io에 배포합니다.
+
+## 실행할 작업
+
+### 1단계: 커밋 & 푸시
+1. `git status`로 변경된 파일 확인
+2. `git diff`로 변경 내용 확인
+3. `git log -3 --oneline`로 최근 커밋 스타일 확인
+4. 변경사항 분석 후 적절한 커밋 메시지 작성
+5. `git add`로 변경사항 스테이징 (단, `.claude/memory/` 폴더는 `git reset -- .claude/memory/`로 제외)
+6. `git commit`으로 커밋
+7. `git push`로 원격에 푸시
+
+### 2단계: 빌드 검증
+8. `npm run build`로 빌드 확인 (실패 시 중단)
+
+### 3단계: Fly.io 배포
+9. flyctl로 배포 실행:
+   ```
+   "C:\Users\Chris\AppData\Local\Microsoft\WinGet\Packages\Fly-io.flyctl_Microsoft.Winget.Source_8wekyb3d8bbwe\flyctl.exe" deploy
+   ```
+   - flyctl이 PATH에 없으므로 반드시 위 전체 경로 사용
+   - `fly` 또는 `flyctl` 명령은 실패함 → 전체 경로 필수
+10. 배포 결과 확인 및 요약
+
+## 제외 대상
+- `.claude/memory/` 폴더: 메모리 파일은 로컬 전용 (커밋 금지)
+
+## 커밋 메시지 형식
+- 한글로 작성
+- prefix 사용: feat, fix, refactor, docs, style, chore
+- 예: `feat: 별표 텍스트 추출 기능 추가`
+
+## 배포 환경
+- 플랫폼: Fly.io (앱: korean-law-mcp)
+- 리전: nrt (도쿄)
+- Dockerfile: node:20-alpine, SSE 모드
+- URL: https://korean-law-mcp.fly.dev/

.claude/next-sessions.md

@@ -0,0 +1,55 @@
+# 다음 세션 프롬프트
+
+## 세션 2: 호출 테스트 검증
+
+```
+korean-law-mcp v2.2 업그레이드 세션 2 — 호출 테스트.
+
+커밋 88f94a5에서 65→88개 도구로 확장했어. 신규 23개 도구를 전수 호출 테스트해서 검증해줘.
+
+테스트 대상 (신규 도구):
+1. date-parser: "최근 3년 음주운전 판례" CLI 실행
+2. analyze_document: 샘플 계약서 텍스트로 테스트
+3. chain_document_review: 엔드투엔드
+4. search_treaties / get_treaty_text
+5. get_linked_ordinances / get_linked_ordinance_articles / get_delegated_laws / get_linked_laws_from_ordinance
+6. get_article_detail (조항호목)
+7. compare_admin_rule_old_new
+8. get_law_abbreviations
+9. search_school_rules / get_school_rule_text
+10. search_public_corp_rules / get_public_corp_rule_text
+11. search_public_institution_rules / get_public_institution_rule_text
+12. search_acr_decisions / get_acr_decision_text
+13. search_appeal_review_decisions / get_appeal_review_decision_text
+14. search_acr_special_appeals / get_acr_special_appeal_text
+15. precedents/interpretations 날짜 필터 테스트
+
+방법: MCP 도구 직접 호출 또는 CLI로 테스트. 실패하는 건 즉시 수정.
+끝나면 메모리 저장 + 세션 3 프롬프트 확인 + 커밋/푸시.
+```
+
+## 세션 3: 프로덕션 리뷰 + 배포
+
+```
+korean-law-mcp v2.2 업그레이드 세션 3 — 프로덕션 리뷰 + 배포.
+
+세션 2에서 88개 도구 호출 테스트 완료. 이제 최종 마무리:
+
+1. 코드 품질 리뷰
+   - 보안 (API 키 노출, 입력 검증)
+   - 에러 처리 (엣지 케이스)
+   - 파일 크기 200줄 규칙 준수
+   - risk-rules.ts 543줄 → 분리 필요 여부
+
+2. 문서 업데이트
+   - CLAUDE.md: 88개 도구 반영
+   - README.md / README-KR.md: 신규 도구 카테고리 추가
+   - docs/API.md: 신규 도구 레퍼런스
+
+3. 버전 범프 + 배포
+   - package.json → 2.2.0
+   - npm publish
+   - fly deploy (원격 서버)
+
+끝나면 메모리 저장 + 커밋/푸시.
+```

.claude/plans/web-ui-chatbot.md

@@ -0,0 +1,143 @@
+# 한국 법령 챗봇 웹 UI 개발 계획
+
+## 목표
+
+**MCP 서버는 이미 배포됨** → 웹 UI만 Vercel로 새로 만들기
+
+**사용자**: 와이프 + 지인들 (법령 조회가 필요한 일반인)
+**배포**: Vercel (무료 Hobby 플랜)
+**LLM**: Gemini 2.0 Flash (무료 tier)
+**백엔드**: 기존 korean-law-mcp HTTP 엔드포인트 활용
+
+---
+
+## 사용자별 API 키 처리 방식
+
+### 결정: 사용자가 직접 입력
+
+**흐름:**
+1. 웹 UI 첫 접속 시 법제처 API 키 입력 모달 표시
+2. 사용자가 본인의 API 키 입력 (법제처에서 무료 발급)
+3. API 키는 **브라우저 localStorage**에 저장 (서버 저장 X)
+4. 모든 MCP 요청 시 헤더 또는 파라미터로 API 키 전달
+5. MCP 서버는 요청마다 전달받은 키로 법제처 API 호출
+
+**장점:**
+- 서버에 민감 정보 저장 안 함
+- 사용량 제한 걱정 없음 (각자 본인 할당량 사용)
+- GDPR/개인정보 이슈 없음
+
+**MCP 서버 수정 필요:**
+- 요청 헤더/파라미터에서 `LAW_OC` 키 수신
+- 환경변수 대신 요청별 키 사용
+
+**웹 UI 추가 구현:**
+- API 키 입력 모달 컴포넌트
+- localStorage 저장/로드 로직
+- API 키 발급 안내 링크 (https://www.law.go.kr/DRF/lawService.do)
+
+---
+
+## 전제 조건
+
+- ✅ korean-law-mcp 서버는 이미 배포돼 있음 (HTTP 모드)
+- ✅ MCP 엔드포인트: `https://your-deployed-mcp.com/mcp`
+- ✅ Bearer Token 인증 이미 적용됨
+- ⚠️ **MCP 서버 수정 필요** - 요청별 API 키 처리 추가
+
+---
+
+## 프로젝트 구조
+**새 저장소**: `korean-law-chatbot`
+
+```
+korean-law-chatbot/
+├── app/
+│   ├── api/
+│   │   └── chat/
+│   │       └── route.ts        # Vercel AI SDK 엔드포인트
+│   ├── page.tsx                # 메인 채팅 UI
+│   └── layout.tsx
+├── lib/
+│   ├── mcp-client.ts           # korean-law-mcp HTTP 클라이언트
+│   └── gemini.ts               # Gemini API 설정
+├── components/
+│   ├── chat-interface.tsx      # 카카오톡 스타일 채팅
+│   ├── law-card.tsx            # 법령 조회 결과 카드
+│   └── message-bubble.tsx      # 메시지 말풍선
+└── package.json
+```
+
+## 기술 스택
+- **Frontend**: Next.js 15 App Router + Tailwind CSS
+- **LLM**: Gemini 2.0 Flash (무료 tier, Vercel AI SDK)
+- **MCP 연결**: 기존 korean-law-mcp HTTP 엔드포인트
+- **배포**: Vercel (무료 Hobby 플랜)
+- **디자인**: 카카오톡 스타일 채팅 UI
+
+---
+
+## 구현 단계별 작업
+
+### 1단계: 프로젝트 초기 설정 (1시간)
+```bash
+npx create-next-app@latest korean-law-chatbot --typescript --tailwind --app
+cd korean-law-chatbot
+npm install ai @ai-sdk/google
+```
+
+**package.json 의존성**:
+- `next`: ^15.0.0
+- `react`: ^19.0.0
+- `ai`: ^4.0.0
+- `@ai-sdk/google`: ^1.0.0
+- `tailwindcss`: ^3.4.0
+
+### 2단계: MCP 클라이언트 구현 (2시간)
+**파일**: `lib/mcp-client.ts`
+- MCP HTTP 엔드포인트 연결
+- Bearer Token 인증 헤더
+- 33개 도구 → Vercel AI SDK 형식 변환
+- JSON-RPC 2.0 호출 로직
+
+### 3단계: 채팅 UI 컴포넌트 (3시간)
+**파일**:
+- `app/page.tsx` - 메인 레이아웃
+- `components/chat-interface.tsx` - 메시지 리스트 + 입력창
+- `components/message-bubble.tsx` - 카카오톡 스타일 말풍선
+- `components/example-query.tsx` - 예제 질문 버튼
+
+### 4단계: 법령 카드 렌더링 (1시간)
+**파일**: `components/law-card.tsx`
+- MCP tool 결과를 카드 UI로 표시
+- 법령명, 조문 번호, 시행일, 내용
+- 법제처 외부 링크
+
+### 5단계: 스타일링 (2시간)
+**Tailwind 설정**:
+- 카카오톡 노란색 (#FFE812)
+- 그라데이션 배경
+- 모바일 반응형
+
+### 6단계: Vercel 배포 (1시간)
+1. GitHub Push
+2. Vercel Import
+3. 환경변수 설정
+4. 테스트 및 검증
+
+---
+
+## 예상 소요 시간
+
+**총합**: 약 10시간 (1-2일)
+
+---
+
+## 성공 기준
+
+- [ ] Vercel 배포 성공 (HTTPS 도메인 생성)
+- [ ] Gemini API 연동 정상 동작
+- [ ] MCP 33개 도구 모두 호출 가능
+- [ ] 카카오톡 스타일 UI 구현
+- [ ] 모바일/데스크톱 반응형
+- [ ] 와이프 + 지인 1명 이상 테스트 완료

.claude/settings.local.json

@@ -0,0 +1,25 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run build:*)",
+      "Bash(npx:*)",
+      "Bash(node test-tools.js:*)",
+      "Bash(where:*)",
+      "Bash(korean-law-mcp:*)",
+      "Bash(node -e \"console.log\\(require\\(''c:/github_project/korean-law-mcp/.claude/mcp.json''\\)\\)\")",
+      "Bash(set LAW_OC=ryuseungin:*)",
+      "Bash(node build/index.js:*)",
+      "Bash(ls:*)",
+      "Bash(cat:*)",
+      "Bash(node test-33-tools.js:*)",
+      "Bash(node test-compare.js:*)",
+      "Bash(node test-admin-rule.js:*)",
+      "Bash(node:*)",
+      "Bash(LAW_OC=ryuseungin node:*)",
+      "Bash(git add:*)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat: Add 18 new law API tools \\(v1.5.0\\)\n\n- Constitutional Court decisions \\(헌재결정례\\)\n- Administrative appeals \\(행정심판례\\)\n- English law translation \\(영문법령\\)\n- Legal terminology dictionary \\(법령용어\\)\n- Everyday law guides \\(생활법령정보\\)\n- Committee decisions: FTC, PIPC, NLRC \\(위원회 결정문\\)\n- Historical law retrieval \\(연혁법령\\)\n- Law system tree \\(법령체계도\\)\n\nTotal tools: 51\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\ndocs: Simplify CLAUDE.md \\(230 → 47 lines\\)\n\nApply WHAT/WHY/HOW principle with progressive disclosure.\nRemove duplicated content \\(already in README.md, docs/\\).\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")"
+    ]
+  },
+  "outputStyle": "chris-v3"
+}

.dockerignore

@@ -0,0 +1,12 @@
+node_modules
+build
+dist
+npm-debug.log
+.env
+.env.local
+.git
+.gitignore
+README.md
+.vscode
+.idea
+*.md

.env.example

@@ -0,0 +1,3 @@
+# 법제처 오픈API 인증키 (필수)
+# 발급: https://www.law.go.kr/DRF/lawService.do
+LAW_OC=your-api-key-here

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build

.gitignore

@@ -0,0 +1,8 @@
+node_modules/
+build/
+dist/
+*.log
+.DS_Store
+.env
+.env.local
+test-*.js

.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "korean-law": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["C:\\Users\\Mong NAS\\.openclaw\\workspace\\korean-law-mcp\\build\\index.js"],
+      "env": {
+        "LAW_OC": "ryuseungin"
+      }
+    }
+  }
+}

CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+## [2.2.0] - 2026-04-01
+
+### Added
+- 23개 신규 도구: 조약(2), 법령-자치법규 연계(4), 학칙/공단/공공기관(6), 특별행정심판(4), 감사원(2), 약칭(1), 행정규칙 신구대조(1), 조항호목(1), 문서분석(1), chain_document_review(1)
+- date-parser: 자연어 시간 표현 → YYYYMMDD 변환 (10개 패턴)
+- document-analysis: 8종 문서유형 분류, 17개 리스크규칙, 금액/기간 추출, 조항 충돌 탐지
+- 판례/해석례 날짜 필터 (fromDate/toDate)
+
+### Changed
+- 에러 처리 통일: 40개 도구의 인라인 에러 → formatToolError 전환
+- 중복 XML 파서 6개 → 공용 parseSearchXML 통합
+- cli.ts 분리: cli-format.ts + cli-executor.ts + cli.ts (689줄 → 443+181+227)
+- annex.ts: AnnexItem 타입 정의, any 12회 제거
+
+### Security
+- sse-server.ts: CORS * → CORS_ORIGIN 환경변수 기반
+- sse-server.ts: API 키 쿼리스트링 경로 제거 (헤더만 허용)
+- sse-server.ts: 보안 헤더 추가 (X-Content-Type-Options, X-Frame-Options, Referrer-Policy)
+- sse-server.ts: 세션 ID 로그 마스킹 (첫 8자만 출력)
+
+### Fixed
+- 조약 XML 아이템태그 대소문자 (trty→Trty), 본문 JSON 키 (BothTrtyService)
+- 연계 fetchApi type 기본값 제거 (type=XML 시 500 발생)
+- api-client.ts: type 파라미터 미지정 시 생략
+
+- 총 도구 수: 64 → 87
+
+## [1.9.0] - 2026-03-15
+
+### Fixed
+- HWP 구형 파서: `controls` 내 테이블(표) 추출 지원
+  - `hwp.js`의 `paragraph.controls[].content` 경로에서 테이블 구조(rows/cells) 탐색
+  - 기존에는 `paragraph.content`만 탐색하여 표 형식 HWP 파싱 실패
+
+## [1.8.1] - 2026-03-15
+
+### Changed
+- MCP 도구 스키마 최적화: description 압축 + apiKey 은닉
+
+## [1.8.0] - 2026-03-10
+
+### Added
+- 체인 도구 7개: chain_law_system, chain_action_basis, chain_dispute_prep, chain_amendment_track, chain_ordinance_compare, chain_full_research, chain_procedure_detail
+- get_batch_articles: `laws` 배열 파라미터로 복수 법령 일괄 조회 지원
+- search_ai_law: `lawTypes` 필터로 법령종류별 결과 필터링
+- truncateSections(): 체인 도구 섹션별 응답 크기 최적화
+- truncateResponse summary 모드: 긴 응답 자동 요약
+- unwrapZodEffects: .refine() 스키마의 MCP 호환성 개선
+- 구조화된 에러 포맷: [에러코드] + 도구명 + 제안
+
+### Changed
+- formatToolError: ZodError 자동 감지, 구조화된 출력
+- toMcpInputSchema: ZodEffects unwrap 후 JSON Schema 변환
+- 총 도구 수: 57 → 64