claude-code-kr 0.2.1 → 0.3.0

package/README.md

@@ -94,15 +94,17 @@ claude-code-kr/
 │   └── cc-kr.js            # CLI 진입점 (cckr 명령어)
 ├── lib/
 │   ├── patcher.js          # 패치 엔진 (string + regex 매칭, 마커 스킵)
-│   ├── mappings.js         # 한글 커맨드 매핑 51개
+│   ├── mappings.js         # 한글 커맨드 매핑 52개
 │   ├── hooks.js            # SessionStart hook 관리
+│   ├── locales/
+│   │   └── ko.json         # 번역 카탈로그 (145개 정적 문자열)
 │   └── patches/
-│       ├── stable.js       # 정적 문자열 교체 (안정)
 │       ├── fragile.js      # regex backreference (변수명 독립)
 │       └── structural.js   # 코드 구조 변경 (tab completion 등)
 ├── scripts/
 │   ├── postinstall.js      # npm install 시 자동 패치
-│   └── preuninstall.js     # npm uninstall 시 자동 복원
+│   ├── preuninstall.js     # npm uninstall 시 자동 복원
+│   └── extract.js          # 번들 AST 파싱 → 번역 후보 추출 (devDep)
 ├── test/
 │   └── patcher.test.js     # 패치 테스트 25개
 ├── index.js                # 모듈 진입점
@@ -118,13 +120,22 @@ claude-code-kr/
 
 ### 패치 구조
 
-`lib/patches/`는 패치를 세 계층으로 관리합니다:
+패치를 세 계층으로 관리합니다:
 
-| 계층 | 안정성 | 매칭 방식 | CC 업데이트 시 |
-|------|--------|----------|----------------|
-| **안정 (stable)** | 높음 | 정적 문자열 (`"Yes"` → `"네"`) | Anthropic이 영어를 바꿀 때만 깨짐 |
-| **가변 (fragile)** | 중간 | **regex backreference** (`/return (\w+)\?\`Reading \$\{\1\}\`/`) | 구조가 크게 바뀔 때만 깨짐 |
-| **구조 (structural)** | 낮음 | 큰 코드 블록 (tab completion, autocomplete) | 함수 구조 변경 시 깨짐 |
+| 계층 | 저장소 | 안정성 | 매칭 방식 | CC 업데이트 시 |
+|------|--------|--------|----------|----------------|
+| **안정 (stable)** | `lib/locales/ko.json` | 높음 | 정적 문자열 (`"Yes"` → `"네"`) | Anthropic이 영어를 바꿀 때만 깨짐 |
+| **가변 (fragile)** | `lib/patches/fragile.js` | 중간 | **regex backreference** (`/return (\w+)\?\`Reading \$\{\1\}\`/`) | 구조가 크게 바뀔 때만 깨짐 |
+| **구조 (structural)** | `lib/patches/structural.js` | 낮음 | 큰 코드 블록 (tab completion, autocomplete) | 함수 구조 변경 시 깨짐 |
+
+**안정 패치는 카탈로그 기반**: `ko.json`에 `{"english": "한글"}` 한 줄만 추가하면 끝. regex 작성 불필요.
+
+```json
+{
+  "\"Do you want to proceed?\"": "\"실행할까요?\"",
+  "label:\"Yes\",value:\"yes\"": "label:\"네\",value:\"yes\""
+}
+```
 
 **가변 패치의 핵심 — regex backreference**:
 
@@ -240,6 +251,33 @@ claude-code-kr/
 - **CC 업데이트 시 가변 패치 깨질 수 있음** — `cckr apply -v`로 확인. 안정 패치는 유지됨.
 - **한글 autocomplete** — IME 조합 중에는 자동완성이 트리거되지 않을 수 있음. 조합 완료 후 동작.
 
+## 번역 추가 워크플로우 (contributor)
+
+새 영어 텍스트를 발견하면:
+
+```bash
+# 1. 번들에서 해당 텍스트 검색 (AST 컨텍스트 포함)
+npm run find "Do you want"
+
+# 출력:
+# right: "Do you want to proceed?" ✓        ← 이미 번역됨
+# arguments: "Do you want to allow this"    ← 미번역
+
+# 2. lib/locales/ko.json 에 번역 추가
+# {
+#   "\"Do you want to allow this\"": "\"이 작업을 허용할까요?\""
+# }
+
+# 3. 적용
+cckr apply --force
+```
+
+전체 후보 추출:
+```bash
+npm run extract
+# → lib/locales/candidates.txt 에 1000+ 후보 저장
+```
+
 ## 원리
 
 Claude Code의 `cli.js` 번들을 문자열 매칭으로 패치합니다:
@@ -252,7 +290,7 @@ Claude Code의 `cli.js` 번들을 문자열 매칭으로 패치합니다:
 {name:"btw", aliases:["근데"], description:"대화 흐름을 끊지 않고 사이드 질문하기"}
 ```
 
-- 테스트 기준: Claude Code v2.1.98
+- 테스트 기준: Claude Code v2.1.98 ~ v2.1.105
 
 ## License