claude-code-kr 0.2.2 → 0.3.1

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
 

package/lib/locales/ko.json

@@ -0,0 +1,147 @@
+{
+  "title:\"Bypass Permissions\",shortTitle:\"Bypass\"": "title:\"확인 생략\",shortTitle:\"생략\"",
+  "title:\"Accept edits\",shortTitle:\"Accept\"": "title:\"수정 허용\",shortTitle:\"허용\"",
+  "title:\"Don't Ask\",shortTitle:\"DontAsk\"": "title:\"묻지 않기\",shortTitle:\"자동\"",
+  "title:\"Auto mode\",shortTitle:\"Auto\"": "title:\"자동 모드\",shortTitle:\"자동\"",
+  "label:\"accept edits on\"": "label:\"수정 허용 모드\"",
+  "label:\"auto mode on\"": "label:\"자동 모드\"",
+  "\"Do you want to proceed?\"": "\"실행할까요?\"",
+  "\"Yes, and don't ask again for \"": "\"네, 다시 묻지 않기: \"",
+  "\"Yes, and don't ask again for\"": "\"네, 다시 묻지 않기:\"",
+  "\" commands in\"": "\" 명령어\"",
+  "\"commands in \"": "\"명령어 \"",
+  "label:\"Yes, and bypass permissions\"": "label:\"네, 확인 생략\"",
+  "label:\"Yes, and use auto mode\"": "label:\"네, 자동 모드 사용\"",
+  "label:\"Yes, auto-accept edits\"": "label:\"네, 수정 자동 허용\"",
+  "label:\"Yes, enable auto mode\"": "label:\"네, 자동 모드 활성화\"",
+  "label:\"Yes, enter plan mode\"": "label:\"네, 계획 모드 진입\"",
+  "label:\"Yes, and make it my default mode\"": "label:\"네, 기본 모드로 설정\"",
+  "label:\"Yes, for this session\"": "label:\"네, 이 세션에서\"",
+  "label:\"Yes, delete\"": "label:\"네, 삭제\"",
+  "label:\"Yes\",value:\"yes\"": "label:\"네\",value:\"yes\"",
+  "label:\"No, cancel\"": "label:\"아니요, 취소\"",
+  "label:\"No, exit\"": "label:\"아니요, 종료\"",
+  "label:\"No, exit Claude Code\"": "label:\"아니요, Claude Code 종료\"",
+  "label:\"Not now\"": "label:\"나중에\"",
+  "label:\"No, not now\"": "label:\"아니요, 나중에\"",
+  "label:\"No\",value:\"no\"": "label:\"아니요\",value:\"no\"",
+  "\"tell Claude what to do next\"": "\"다음에 할 일을 알려주세요\"",
+  "\"tell Claude what to do differently\"": "\"다르게 할 일을 알려주세요\"",
+  "\"What would you like to do?\"": "\"무엇을 할까요?\"",
+  "\"Yes, allow all edits during this session\"": "\"네, 이 세션에서 모든 수정 허용\"",
+  "\"Approved Plan\"": "\"계획 승인됨\"",
+  "\"Approved Plan (edited by user)\"": "\"계획 승인됨 (사용자 수정)\"",
+  "description:\"expand history\"": "description:\"기록 펼치기\"",
+  "description:\"expand\"": "description:\"펼치기\"",
+  "action:\"cycle\"": "action:\"전환하기\"",
+  "action:\"expand\"": "action:\"펼쳐보기\"",
+  "action:\"cancel\"": "action:\"취소\"",
+  "action:\"amend\"": "action:\"수정\"",
+  "action:\"confirm\"": "action:\"확인\"",
+  "action:\"select\"": "action:\"선택\"",
+  "action:\"navigate\"": "action:\"이동\"",
+  "action:\"continue\"": "action:\"계속\"",
+  "action:\"close\"": "action:\"닫기\"",
+  "action:\"go back\"": "action:\"뒤로\"",
+  "action:\"toggle\"": "action:\"전환\"",
+  "action:\"stop\"": "action:\"중지\"",
+  "action:\"skip\"": "action:\"건너뛰기\"",
+  "action:\"copy\"": "action:\"복사\"",
+  "\"Compound commands with cd and git require approval to prevent bare repository attacks\"": "\"cd+git 복합 명령어는 보안을 위해 승인이 필요합니다\"",
+  "\"Compound commands with cd and git require permission checks for enhanced security\"": "\"cd+git 복합 명령어는 보안 강화를 위해 권한 확인이 필요합니다\"",
+  "\"Space, Enter, or Escape to dismiss\"": "\"Space·Enter·Esc로 닫기\"",
+  "\" to cycle permission modes. Each mode c\"": "\" 권한 모드 전환\"",
+  "\"Showing detailed transcript · \"": "\"상세 기록 표시 중 · \"",
+  "\" to toggle\"": "\"으로 전환\"",
+  "\"collapse\":\"show all\"": "\"접기\":\"모두 보기\"",
+  "\" · n/N to navigate\"": "\" · n/N 탐색\"",
+  "scroll · home/end top/bottom": "스크롤 · home/end 처음/끝",
+  "\" tokens\"": "\" 토큰\"",
+  "\"Reading Plan\"": "\"계획 읽는 중\"",
+  "\"Running command\"": "\"명령어 실행 중\"",
+  " · /effort`": " · /노력`",
+  "\"! for bash mode\"": "\"! bash 모드\"",
+  "\"/ for commands\"": "\"/ 커맨드\"",
+  "\"@ for file paths\"": "\"@ 파일 경로\"",
+  "\"& for background\"": "\"& 백그라운드\"",
+  "\"/btw for side question\"": "\"/근데 사이드 질문\"",
+  "\"double tap esc to clear input\"": "\"esc 두 번 입력 지우기\"",
+  "\" for verbose output\"": "\" 자세히 보기\"",
+  "\" to paste images\"": "\" 이미지 붙여넣기\"",
+  "\" to switch model\"": "\" 모델 전환\"",
+  "\" for newline\"": "\" 줄바꿈\"",
+  "\" to customize\"": "\" 단축키 설정\"",
+  "\"For more help:\"": "\"도움말:\"",
+  "\"Interrupted \"": "\"중단됨 \"",
+  "\"· What should Claude do instead?\"": "\"· 대신 무엇을 할까요?\"",
+  "Claude Code has switched from npm to native installer. Run `claude install` or see https://docs.anthropic.com/en/docs/claude-code/getting-started for more options.": "Claude Code가 npm에서 네이티브 설치로 전환되었습니다. `claude install`을 실행하거나 https://docs.anthropic.com/en/docs/claude-code/getting-started 을 참고하세요.",
+  "\"Welcome back!\"": "\"다시 오셨네요!\"",
+  "\"Welcome to Claude Code\"": "\"Claude Code에 오신 것을 환영합니다\"",
+  "\"No recent activity\"": "\"최근 활동 없음\"",
+  "\"No conversations found to resume.\"": "\"이어서 할 대화가 없습니다.\"",
+  "\"Resuming session…\"": "\"세션 이어서 하는 중…\"",
+  "\"Compacting conversation…\"": "\"대화 압축 중…\"",
+  "\"Compacting conversation\"": "\"대화 압축 중\"",
+  "\"Conversation compacted\"": "\"대화 압축 완료\"",
+  "\" says: \"": "\": \"",
+  "\"Advisor unavailable (\"": "\"조언자 사용 불가 (\"",
+  "title:\"Accessing workspace:\"": "title:\"작업 폴더 접근:\"",
+  "\"Quick safety check: Is this a project you created or one you trust? (Like your own code, a well-known open source project, or work from your team). If not, take a moment to review what\"": "\"안전 확인: 직접 만들었거나 신뢰할 수 있는 프로젝트인가요? (본인 코드, 유명 오픈소스, 팀 프로젝트 등). 아니라면 이 폴더의 내용을 먼저 확인하세요\"",
+  "\"s in this folder first.\"": "\"\"",
+  "\"ll be able to read, edit, and execute files here.\"": "\"이 폴더의 파일을 읽고, 수정하고, 실행할 수 있습니다.\"",
+  "\"Security guide\"": "\"보안 가이드\"",
+  "label:\"Yes, I trust this folder\"": "label:\"네, 이 폴더를 신뢰합니다\"",
+  "label:\"Yes, I trust these settings\"": "label:\"네, 이 설정을 신뢰합니다\"",
+  "\"Tips for getting started\"": "\"시작 가이드\"",
+  "\"Recent activity\"": "\"최근 활동\"",
+  "\"Run /init to create a CLAUDE.md file with instructions for Claude\"": "\"/init으로 Claude 지시사항 CLAUDE.md 파일 만들기\"",
+  "\"Answering…\"": "\"답변 중…\"",
+  "\"Initializing…\"": "\"초기화 중…\"",
+  "\"Shortcuts\"": "\"단축키\"",
+  "progressMessage:\"creating commit\"": "progressMessage:\"커밋 생성 중\"",
+  "progressMessage:\"creating commit and PR\"": "progressMessage:\"커밋 및 PR 생성 중\"",
+  "progressMessage:\"reviewing pull request\"": "progressMessage:\"풀 리퀘스트 리뷰 중\"",
+  "progressMessage:\"analyzing your sessions\"": "progressMessage:\"세션 분석 중\"",
+  "\"Baked\",\"Brewed\",\"Churned\",\"Cogitated\",\"Cooked\",\"Crunched\",\"Sautéed\",\"Worked\"": "\"처리 완료\",\"처리 완료\",\"처리 완료\",\"처리 완료\",\"처리 완료\",\"처리 완료\",\"처리 완료\",\"처리 완료\"",
+  "\"Start with small features or bug fixes, tell Claude to propose a plan, and verify its suggested edits\"": "\"작은 기능이나 버그 수정부터 시작하고, Claude에게 계획을 제안하게 한 뒤 수정 사항을 확인하세요\"",
+  "\"Use /config to change your default permission mode (including Plan Mode)\"": "\"/config로 기본 권한 모드를 변경할 수 있습니다 (계획 모드 포함)\"",
+  "\"Use git worktrees to run multiple Claude sessions in parallel.\"": "\"git worktree로 여러 Claude 세션을 병렬 실행할 수 있습니다.\"",
+  "\"Running multiple Claude sessions? Use /color and /rename to tell them apart at a glance.\"": "\"여러 Claude 세션 실행 중? /color와 /rename으로 구분하세요.\"",
+  "\"Use /memory to view and manage Claude memory\"": "\"/memory로 Claude 메모리를 관리하세요\"",
+  "\"Use /theme to change the color theme\"": "\"/theme으로 색상 테마를 변경하세요\"",
+  "\"Try setting environment variable COLORTERM=truecolor for richer colors\"": "\"환경변수 COLORTERM=truecolor를 설정하면 더 풍부한 색상을 사용할 수 있습니다\"",
+  "\"Use /statusline to set up a custom status line that will display beneath the input box\"": "\"/statusline으로 입력창 아래에 커스텀 상태줄을 설정하세요\"",
+  "\"Hit Enter to queue up additional messages while Claude is working.\"": "\"Claude 작업 중 Enter를 눌러 추가 메시지를 대기열에 넣으세요.\"",
+  "\"Send messages to Claude while it works to steer Claude in real-time\"": "\"Claude 작업 중 메시지를 보내 실시간으로 방향을 조정하세요\"",
+  "\"Ask Claude to create a todo list when working on complex tasks to track progress and remain on track\"": "\"복잡한 작업 시 Claude에게 할 일 목록을 만들게 하면 진행 상황을 추적할 수 있습니다\"",
+  "\"Connect Claude to your IDE · /ide\"": "\"Claude를 IDE에 연결하세요 · /ide\"",
+  "\"Run /install-github-app to tag @claude right from your Github issues and PRs\"": "\"/install-github-app으로 GitHub 이슈와 PR에서 @claude를 태그하세요\"",
+  "\"Run /install-slack-app to use Claude in Slack\"": "\"/install-slack-app으로 Slack에서 Claude를 사용하세요\"",
+  "\"Use /permissions to pre-approve and pre-deny bash, edit, and MCP tools\"": "\"/permissions로 bash, edit, MCP 도구를 미리 허용/거부하세요\"",
+  "\"Did you know you can drag and drop image files into your terminal?\"": "\"터미널에 이미지 파일을 드래그 앤 드롭할 수 있습니다\"",
+  "\"Paste images into Claude Code using control+v (not cmd+v!)\"": "\"control+v로 Claude Code에 이미지를 붙여넣으세요 (cmd+v 아님!)\"",
+  "\"Double-tap esc to rewind the conversation to a previous point in time\"": "\"esc 두 번 눌러 대화를 이전 시점으로 되돌리세요\"",
+  "\"Double-tap esc to rewind the code and/or conversation to a previous point in time\"": "\"esc 두 번 눌러 코드와 대화를 이전 시점으로 되돌리세요\"",
+  "\"Run claude --continue or claude --resume to resume a conversation\"": "\"claude --continue 또는 --resume으로 대화를 이어서 하세요\"",
+  "\"Name your conversations with /rename to find them easily in /resume later\"": "\"/rename으로 대화 이름을 지정하면 /resume에서 쉽게 찾을 수 있습니다\"",
+  "\"Create skills by adding .md files to .claude/skills/ in your project or ~/.claude/skills/ for skills that work in any project\"": "\".claude/skills/에 .md 파일을 추가해 스킬을 만드세요. ~/.claude/skills/는 모든 프로젝트에서 사용 가능\"",
+  "\"Use /agents to optimize specific tasks. Eg. Software Architect, Code Writer, Code Reviewer\"": "\"/agents로 특정 작업을 최적화하세요. 예: Software Architect, Code Writer, Code Reviewer\"",
+  "\"Use --agent <agent_name> to directly start a conversation with a subagent\"": "\"--agent <에이전트명>으로 서브에이전트와 직접 대화를 시작하세요\"",
+  "\"Run Claude Code locally or remotely using the Claude desktop app: clau.de/desktop\"": "\"Claude 데스크톱 앱으로 로컬/원격에서 실행하세요: clau.de/desktop\"",
+  "\"Run tasks in the cloud while you keep coding locally · clau.de/web\"": "\"로컬에서 코딩하면서 클라우드에서 작업 실행 · clau.de/web\"",
+  "\"/mobile to use Claude Code from the Claude app on your phone\"": "\"/mobile로 휴대폰 Claude 앱에서 Claude Code 사용\"",
+  "\"Use /feedback to help us improve!\"": "\"/feedback으로 개선에 도움을 주세요!\"",
+  "\"chat:imagePaste\",\"Chat\",\"ctrl+v\")} to paste images from your clipboard": "\"chat:imagePaste\",\"Chat\",\"ctrl+v\")}로 클립보드 이미지를 붙여넣으세요",
+  "Use Plan Mode to prepare for a complex request before making changes. Press ${": "복잡한 요청 전 계획 모드로 준비하세요. ${",
+  "\"chat:cycleMode\",\"Chat\",\"shift+tab\")} twice to enable.": "\"chat:cycleMode\",\"Chat\",\"shift+tab\")}를 두 번 눌러 활성화하세요.",
+  "\"chat:cycleMode\",\"Chat\",\"shift+tab\")} to cycle between default mode, auto-accept edit mode, and plan mode": "\"chat:cycleMode\",\"Chat\",\"shift+tab\")}로 기본 모드, 수정 허용, 계획 모드를 전환하세요",
+  "\"chat:cycleMode\",\"Chat\",\"shift+tab\")} twice to activate Plan Mode and plan with Claude Opus.": "\"chat:cycleMode\",\"Chat\",\"shift+tab\")}를 두 번 눌러 계획 모드를 활성화하세요.",
+  "Your default model setting is Opus Plan Mode. Press ${": "기본 모델이 Opus 계획 모드입니다. ${",
+  "Continue your session in Claude Code Desktop with ${": "Claude Code Desktop에서 세션 이어가기: ${",
+  "\"Run /terminal-setup to enable convenient terminal integration like Option + Enter for new line and more\"": "\"/terminal-setup으로 Option+Enter 줄바꿈 등 터미널 연동을 설정하세요\"",
+  "\"Run /terminal-setup to enable convenient terminal integration like Shift + Enter for new line and more\"": "\"/terminal-setup으로 Shift+Enter 줄바꿈 등 터미널 연동을 설정하세요\"",
+  "\"Press Option+Enter to send a multi-line message\"": "\"Option+Enter로 여러 줄 메시지를 보내세요\"",
+  "\"Press Shift+Enter to send a multi-line message\"": "\"Shift+Enter로 여러 줄 메시지를 보내세요\"",
+  "\"Run /terminal-setup to enable Option+Enter for new lines\"": "\"/terminal-setup으로 Option+Enter 줄바꿈을 설정하세요\"",
+  "\"Run /terminal-setup to enable Shift+Enter for new lines\"": "\"/terminal-setup으로 Shift+Enter 줄바꿈을 설정하세요\""
+}

package/lib/patcher.js

@@ -2,12 +2,15 @@ const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 const mappings = require('./mappings');
-const stablePatches = require('./patches/stable');
+const koCatalog = require('./locales/ko.json');
 const fragilePatches = require('./patches/fragile');
 const structuralPatches = require('./patches/structural');
 const { TESTED_CC_VERSION } = require('./patches/fragile');
 const pkg = require('../package.json');
 
+// 카탈로그를 [old, new] 배열로 변환 (runtime 변환, 0ms)
+const stablePatches = Object.entries(koCatalog);
+
 function findCliJs() {
   try {
     const bin = execSync('which claude', { encoding: 'utf8' }).trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kr",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Claude Code 한글 패치 CLI — /btw → /근데, /help → /도움, /compact → /압축",
   "main": "./index.js",
   "bin": {
@@ -9,13 +9,17 @@
   },
   "scripts": {
     "postinstall": "node ./scripts/postinstall.js",
-    "preuninstall": "node ./scripts/preuninstall.js"
+    "preuninstall": "node ./scripts/preuninstall.js",
+    "test": "node test/patcher.test.js",
+    "extract": "node scripts/extract.js --write",
+    "find": "node scripts/extract.js"
   },
   "files": [
     "bin/",
     "lib/",
     "scripts/",
-    "index.js"
+    "index.js",
+    "!lib/locales/candidates.txt"
   ],
   "keywords": [
     "claude-code",
@@ -40,5 +44,8 @@
   "homepage": "https://github.com/shallwefootball/cc-kr#readme",
   "engines": {
     "node": ">=18"
+  },
+  "devDependencies": {
+    "@babel/parser": "^7.29.2"
   }
 }

package/scripts/extract.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+
+// cli.js AST를 파싱해서 사용자 대상 영어 문자열 후보를 추출.
+// 이미 번역된 것은 제외. 결과는 stdout 또는 candidates.txt로.
+//
+// 사용법:
+//   node scripts/extract.js              # 후보 목록을 stdout에
+//   node scripts/extract.js --write      # locales/candidates.txt 에 저장
+
+const fs = require('fs');
+const path = require('path');
+const parser = require('@babel/parser');
+const { findCliJs } = require('../lib/patcher');
+const catalog = require('../lib/locales/ko.json');
+
+const cliJs = findCliJs();
+if (!cliJs) {
+  console.error('Claude Code가 설치되어 있지 않습니다.');
+  process.exit(1);
+}
+
+const bakPath = cliJs + '.bak';
+const sourcePath = fs.existsSync(bakPath) ? bakPath : cliJs;
+console.error(`파싱 중: ${sourcePath}`);
+
+const source = fs.readFileSync(sourcePath, 'utf8');
+const start = Date.now();
+const ast = parser.parse(source, {
+  errorRecovery: true,
+  sourceType: 'unambiguous',
+  plugins: ['jsx'],
+});
+console.error(`파싱 완료: ${Date.now() - start}ms`);
+
+// 이미 카탈로그에 있는 문자열 (quoted 형태와 raw 형태 둘 다)
+const known = new Set();
+for (const key of Object.keys(catalog)) {
+  // "..." 형태면 raw 추출
+  const m = key.match(/^"(.*)"$/);
+  if (m) known.add(m[1]);
+  else known.add(key);
+}
+
+// 휴리스틱: 사용자 대상 영어 문자열
+const MIN_LENGTH = 5;
+const MAX_LENGTH = 500;
+const ENGLISH_PATTERN = /^[\x20-\x7E]+$/;
+
+// 사용자 대상 property key (여기 나오는 문자열은 높은 확률로 UI)
+const UI_PROPS = new Set([
+  'label', 'title', 'description', 'message', 'placeholder',
+  'hint', 'tooltip', 'text', 'displayText', 'shortTitle',
+  'whenToUse', 'confirmLabel', 'cancelLabel', 'errorMessage',
+  'subtitle', 'summary', 'body', 'content',
+]);
+
+// 2단어 이상이거나, 구두점이 있거나, 특수 패턴
+function looksLikeSentence(str) {
+  const trimmed = str.trim();
+  if (trimmed.length === 0) return false;
+  // 양쪽 공백 문자열 (형식용)
+  if (str !== trimmed && !trimmed.includes(' ')) return false;
+  // 최소 2단어 OR 구두점 (?, ., !)
+  const wordCount = trimmed.split(/\s+/).length;
+  const hasPunct = /[.?!]/.test(trimmed);
+  if (wordCount < 2 && !hasPunct) return false;
+  return true;
+}
+
+function isLikelyCode(str) {
+  // JS 코드 조각
+  if (/[\[\]{}()]|=>|\$\{|&&|\|\||===|!==/.test(str)) return true;
+  // URL / 경로
+  if (/https?:\/\/|^[./~]|\\\\/.test(str)) return true;
+  // 개행/탭 escape
+  if (/\\n|\\t|\\r/.test(str)) return true;
+  // 카멜케이스/스네이크 식별자
+  if (/^[a-z][a-zA-Z0-9_]*$/.test(str)) return true;
+  // 이벤트 ID 형식 (chat:cycleMode 등)
+  if (/^[a-z]+:[a-zA-Z]+$/.test(str)) return true;
+  return false;
+}
+
+// 번들된 라이브러리 에러/설명 문자열 (CC가 아닌 dep)
+function isLibraryNoise(str) {
+  // validation 에러 (joi/zod/jwt 등)
+  if (/\bmust be (a |an |the )?(valid |string|boolean|number|array|object|integer|positive)/.test(str)) return true;
+  if (/\bshould be (a |an )?(number|string|valid)/.test(str)) return true;
+  // AWS/SDK 설명
+  if (/SDK for |Client for (Node\.js|Browser)| client library/.test(str)) return true;
+  // 일반 에러/스택트레이스
+  if (/^Error: |^TypeError:|^RangeError:|^SyntaxError:/.test(str)) return true;
+  if (/<tool_use_error>/.test(str)) return true;
+  // 파서/라이브러리 내부
+  if (/unexpected (token|end|character)|parsing error|invalid (character|escape)/i.test(str)) return true;
+  // HTTP/네트워킹 라이브러리
+  if (/\b(getaddrinfo|ECONNREFUSED|ENOTFOUND|ETIMEDOUT)\b/.test(str)) return true;
+  return false;
+}
+
+function isUserFacing(str, fromUIProp = false) {
+  if (str.length < MIN_LENGTH || str.length > MAX_LENGTH) return false;
+  if (!ENGLISH_PATTERN.test(str)) return false;
+  if (known.has(str)) return false;
+  if (isLikelyCode(str)) return false;
+  if (isLibraryNoise(str)) return false;
+  // UI property의 value는 조금 더 관대 (단일 단어도 허용)
+  if (fromUIProp) {
+    if (str.length < 2) return false;
+    return true;
+  }
+  return looksLikeSentence(str);
+}
+
+const candidates = new Set();
+const uiPropCandidates = new Set();
+let totalLiterals = 0;
+
+function walk(node, parent, parentKey) {
+  if (!node || typeof node !== 'object') return;
+
+  if (node.type === 'StringLiteral' && typeof node.value === 'string') {
+    totalLiterals++;
+    // UI property의 값인지 체크
+    const isUiValue = parent?.type === 'ObjectProperty'
+      && parent.value === node
+      && parent.key?.type === 'Identifier'
+      && UI_PROPS.has(parent.key.name);
+    if (isUiValue) {
+      if (isUserFacing(node.value, true)) uiPropCandidates.add(node.value);
+    } else {
+      if (isUserFacing(node.value, false)) candidates.add(node.value);
+    }
+  }
+  if (node.type === 'TemplateElement' && node.value?.raw) {
+    totalLiterals++;
+    if (isUserFacing(node.value.raw, false)) candidates.add(node.value.raw);
+  }
+
+  for (const key in node) {
+    if (key === 'loc' || key === 'range' || key === 'start' || key === 'end') continue;
+    const val = node[key];
+    if (Array.isArray(val)) {
+      for (const item of val) walk(item, node, key);
+    } else if (val && typeof val === 'object') {
+      walk(val, node, key);
+    }
+  }
+}
+
+// find 모드: 특정 문자열 검색
+const findArg = process.argv.slice(2).find(a => !a.startsWith('-'));
+if (findArg) {
+  const matches = [];
+  function findWalk(node, parent, parentKey) {
+    if (!node || typeof node !== 'object') return;
+    if (node.type === 'StringLiteral' && typeof node.value === 'string' && node.value.includes(findArg)) {
+      matches.push({
+        value: node.value,
+        parentType: parent?.type,
+        parentKey: parent?.key?.name || parentKey,
+        line: node.loc?.start?.line,
+      });
+    }
+    for (const key in node) {
+      if (key === 'loc' || key === 'range') continue;
+      const val = node[key];
+      if (Array.isArray(val)) for (const item of val) findWalk(item, node, key);
+      else if (val && typeof val === 'object') findWalk(val, node, key);
+    }
+  }
+  findWalk(ast.program || ast, null, null);
+  console.error(`"${findArg}" 매칭: ${matches.length}개\n`);
+  for (const m of matches.slice(0, 20)) {
+    const known_mark = known.has(m.value) ? ' ✓' : '';
+    console.log(`${m.parentKey || '?'}: ${JSON.stringify(m.value)}${known_mark}`);
+  }
+  if (matches.length > 20) console.error(`... +${matches.length - 20}개 더`);
+  process.exit(0);
+}
+
+walk(ast.program || ast, null, null);
+console.error(`총 문자열 리터럴: ${totalLiterals}`);
+console.error(`UI property 값: ${uiPropCandidates.size}`);
+console.error(`일반 후보 (문장): ${candidates.size}`);
+
+// UI property 후보가 우선 (정확도 높음), 그 다음 일반
+const ui = [...uiPropCandidates].sort();
+const general = [...candidates].sort();
+
+const output = [
+  '# UI property (label/title/description 등)',
+  ...ui,
+  '',
+  '# 일반 후보 (멀티워드 / 구두점 있는 문장)',
+  ...general,
+].join('\n');
+
+if (process.argv.includes('--write')) {
+  const outPath = path.join(__dirname, '..', 'lib', 'locales', 'candidates.txt');
+  fs.writeFileSync(outPath, output + '\n');
+  console.error(`저장됨: ${outPath}`);
+} else {
+  console.log(output);
+}

package/lib/patches/stable.js

@@ -1,178 +0,0 @@
-// ──────────────────────────────────────────────────────────
-// stable — 정적 문자열만 사용. CC 업데이트에도 안정적.
-//   순수 "quoted string" 또는 property:"value" 패턴.
-//   minify된 변수명에 의존하지 않음.
-// ──────────────────────────────────────────────────────────
-module.exports = [
-  // 권한 모드 title/shortTitle
-  ['title:"Bypass Permissions",shortTitle:"Bypass"', 'title:"확인 생략",shortTitle:"생략"'],
-  ['title:"Accept edits",shortTitle:"Accept"', 'title:"수정 허용",shortTitle:"허용"'],
-  ['title:"Don\'t Ask",shortTitle:"DontAsk"', 'title:"묻지 않기",shortTitle:"자동"'],
-  ['title:"Auto mode",shortTitle:"Auto"', 'title:"자동 모드",shortTitle:"자동"'],
-  // 권한 모드 label
-  ['label:"accept edits on"', 'label:"수정 허용 모드"'],
-  ['label:"auto mode on"', 'label:"자동 모드"'],
-  // 권한 대화상자
-  ['"Do you want to proceed?"', '"실행할까요?"'],
-  ['"Yes, and don\'t ask again for "', '"네, 다시 묻지 않기: "'],
-  ['"Yes, and don\'t ask again for"', '"네, 다시 묻지 않기:"'],
-  ['" commands in"', '" 명령어"'],
-  ['"commands in "', '"명령어 "'],
-  ['label:"Yes, and bypass permissions"', 'label:"네, 확인 생략"'],
-  ['label:"Yes, and use auto mode"', 'label:"네, 자동 모드 사용"'],
-  ['label:"Yes, auto-accept edits"', 'label:"네, 수정 자동 허용"'],
-  ['label:"Yes, enable auto mode"', 'label:"네, 자동 모드 활성화"'],
-  ['label:"Yes, enter plan mode"', 'label:"네, 계획 모드 진입"'],
-  ['label:"Yes, and make it my default mode"', 'label:"네, 기본 모드로 설정"'],
-  ['label:"Yes, for this session"', 'label:"네, 이 세션에서"'],
-  ['label:"Yes, delete"', 'label:"네, 삭제"'],
-  ['label:"Yes",value:"yes"', 'label:"네",value:"yes"'],
-  ['label:"No, cancel"', 'label:"아니요, 취소"'],
-  ['label:"No, exit"', 'label:"아니요, 종료"'],
-  ['label:"No, exit Claude Code"', 'label:"아니요, Claude Code 종료"'],
-  ['label:"Not now"', 'label:"나중에"'],
-  ['label:"No, not now"', 'label:"아니요, 나중에"'],
-  ['label:"No",value:"no"', 'label:"아니요",value:"no"'],
-  ['"tell Claude what to do next"', '"다음에 할 일을 알려주세요"'],
-  ['"tell Claude what to do differently"', '"다르게 할 일을 알려주세요"'],
-  ['"What would you like to do?"', '"무엇을 할까요?"'],
-  ['"Yes, allow all edits during this session"', '"네, 이 세션에서 모든 수정 허용"'],
-  ['"Approved Plan"', '"계획 승인됨"'],
-  ['"Approved Plan (edited by user)"', '"계획 승인됨 (사용자 수정)"'],
-  // UI 힌트 — action/description 속성값
-  ['description:"expand history"', 'description:"기록 펼치기"'],
-  ['description:"expand"', 'description:"펼치기"'],
-  ['action:"cycle"', 'action:"전환하기"'],
-  ['action:"expand"', 'action:"펼쳐보기"'],
-  ['action:"cancel"', 'action:"취소"'],
-  ['action:"amend"', 'action:"수정"'],
-  ['action:"confirm"', 'action:"확인"'],
-  ['action:"select"', 'action:"선택"'],
-  ['action:"navigate"', 'action:"이동"'],
-  ['action:"continue"', 'action:"계속"'],
-  ['action:"close"', 'action:"닫기"'],
-  ['action:"go back"', 'action:"뒤로"'],
-  ['action:"toggle"', 'action:"전환"'],
-  ['action:"stop"', 'action:"중지"'],
-  ['action:"skip"', 'action:"건너뛰기"'],
-  ['action:"copy"', 'action:"복사"'],
-  // 안내 메시지
-  ['"Compound commands with cd and git require approval to prevent bare repository attacks"', '"cd+git 복합 명령어는 보안을 위해 승인이 필요합니다"'],
-  ['"Compound commands with cd and git require permission checks for enhanced security"', '"cd+git 복합 명령어는 보안 강화를 위해 권한 확인이 필요합니다"'],
-  ['"Space, Enter, or Escape to dismiss"', '"Space·Enter·Esc로 닫기"'],
-  ['" to cycle permission modes. Each mode c"', '" 권한 모드 전환"'],
-  // 트랜스크립트 모드 footer
-  ['"Showing detailed transcript · "', '"상세 기록 표시 중 · "'],
-  ['" to toggle"', '"으로 전환"'],
-  ['"collapse":"show all"', '"접기":"모두 보기"'],
-  ['" · n/N to navigate"', '" · n/N 탐색"'],
-  ['scroll · home/end top/bottom', '스크롤 · home/end 처음/끝'],
-  // tokens (전역)
-  ['" tokens"', '" 토큰"'],
-  // 도구 표시 — 정적 문자열
-  ['"Reading Plan"', '"계획 읽는 중"'],
-  ['"Running command"', '"명령어 실행 중"'],
-  // 검색/읽기/목록 동사 (정적 문자열 값)
-  // "Searching for":"searching for" / "Searched for":"searched for"
-  // → fragile.js 에서 regex로 처리 (z6/X6/... 변수 독립)
-  // 상태바
-  [' · /effort`', ' · /노력`'],
-  // 도움말 화면
-  ['"! for bash mode"', '"! bash 모드"'],
-  ['"/ for commands"', '"/ 커맨드"'],
-  ['"@ for file paths"', '"@ 파일 경로"'],
-  ['"& for background"', '"& 백그라운드"'],
-  ['"/btw for side question"', '"/근데 사이드 질문"'],
-  ['"double tap esc to clear input"', '"esc 두 번 입력 지우기"'],
-  ['" for verbose output"', '" 자세히 보기"'],
-  ['" to paste images"', '" 이미지 붙여넣기"'],
-  ['" to switch model"', '" 모델 전환"'],
-  ['" for newline"', '" 줄바꿈"'],
-  ['" to customize"', '" 단축키 설정"'],
-  ['"For more help:"', '"도움말:"'],
-  // 중단 메시지
-  ['"Interrupted "', '"중단됨 "'],
-  ['"· What should Claude do instead?"', '"· 대신 무엇을 할까요?"'],
-  // 시스템 메시지
-  ['Claude Code has switched from npm to native installer. Run `claude install` or see https://docs.anthropic.com/en/docs/claude-code/getting-started for more options.', 'Claude Code가 npm에서 네이티브 설치로 전환되었습니다. `claude install`을 실행하거나 https://docs.anthropic.com/en/docs/claude-code/getting-started 을 참고하세요.'],
-  // 환영/세션
-  ['"Welcome back!"', '"다시 오셨네요!"'],
-  ['"Welcome to Claude Code"', '"Claude Code에 오신 것을 환영합니다"'],
-  ['"No recent activity"', '"최근 활동 없음"'],
-  ['"No conversations found to resume."', '"이어서 할 대화가 없습니다."'],
-  ['"Resuming session…"', '"세션 이어서 하는 중…"'],
-  // 압축
-  ['"Compacting conversation…"', '"대화 압축 중…"'],
-  ['"Compacting conversation"', '"대화 압축 중"'],
-  ['"Conversation compacted"', '"대화 압축 완료"'],
-  // hook
-  ['" says: "', '": "'],
-  ['"Advisor unavailable ("', '"조언자 사용 불가 ("'],
-  // 작업 폴더 신뢰 대화상자
-  ['title:"Accessing workspace:"', 'title:"작업 폴더 접근:"'],
-  ['"Quick safety check: Is this a project you created or one you trust? (Like your own code, a well-known open source project, or work from your team). If not, take a moment to review what"', '"안전 확인: 직접 만들었거나 신뢰할 수 있는 프로젝트인가요? (본인 코드, 유명 오픈소스, 팀 프로젝트 등). 아니라면 이 폴더의 내용을 먼저 확인하세요"'],
-  ['"s in this folder first."', '""'],
-  ['"ll be able to read, edit, and execute files here."', '"이 폴더의 파일을 읽고, 수정하고, 실행할 수 있습니다."'],
-  ['"Security guide"', '"보안 가이드"'],
-  ['label:"Yes, I trust this folder"', 'label:"네, 이 폴더를 신뢰합니다"'],
-  ['label:"Yes, I trust these settings"', 'label:"네, 이 설정을 신뢰합니다"'],
-  // 시작 화면
-  ['"Tips for getting started"', '"시작 가이드"'],
-  ['"Recent activity"', '"최근 활동"'],
-  ['"Run /init to create a CLAUDE.md file with instructions for Claude"', '"/init으로 Claude 지시사항 CLAUDE.md 파일 만들기"'],
-  // 상태 표시
-  ['"Answering…"', '"답변 중…"'],
-  ['"Initializing…"', '"초기화 중…"'],
-  ['"Shortcuts"', '"단축키"'],
-  // progressMessage
-  ['progressMessage:"creating commit"', 'progressMessage:"커밋 생성 중"'],
-  ['progressMessage:"creating commit and PR"', 'progressMessage:"커밋 및 PR 생성 중"'],
-  ['progressMessage:"reviewing pull request"', 'progressMessage:"풀 리퀘스트 리뷰 중"'],
-  ['progressMessage:"analyzing your sessions"', 'progressMessage:"세션 분석 중"'],
-  // 턴 완료 동사
-  ['"Baked","Brewed","Churned","Cogitated","Cooked","Crunched","Sautéed","Worked"', '"처리 완료","처리 완료","처리 완료","처리 완료","처리 완료","처리 완료","처리 완료","처리 완료"'],
-  // 팁 메시지 — 정적 문자열
-  ['"Start with small features or bug fixes, tell Claude to propose a plan, and verify its suggested edits"', '"작은 기능이나 버그 수정부터 시작하고, Claude에게 계획을 제안하게 한 뒤 수정 사항을 확인하세요"'],
-  ['"Use /config to change your default permission mode (including Plan Mode)"', '"/config로 기본 권한 모드를 변경할 수 있습니다 (계획 모드 포함)"'],
-  ['"Use git worktrees to run multiple Claude sessions in parallel."', '"git worktree로 여러 Claude 세션을 병렬 실행할 수 있습니다."'],
-  ['"Running multiple Claude sessions? Use /color and /rename to tell them apart at a glance."', '"여러 Claude 세션 실행 중? /color와 /rename으로 구분하세요."'],
-  ['"Use /memory to view and manage Claude memory"', '"/memory로 Claude 메모리를 관리하세요"'],
-  ['"Use /theme to change the color theme"', '"/theme으로 색상 테마를 변경하세요"'],
-  ['"Try setting environment variable COLORTERM=truecolor for richer colors"', '"환경변수 COLORTERM=truecolor를 설정하면 더 풍부한 색상을 사용할 수 있습니다"'],
-  ['"Use /statusline to set up a custom status line that will display beneath the input box"', '"/statusline으로 입력창 아래에 커스텀 상태줄을 설정하세요"'],
-  ['"Hit Enter to queue up additional messages while Claude is working."', '"Claude 작업 중 Enter를 눌러 추가 메시지를 대기열에 넣으세요."'],
-  ['"Send messages to Claude while it works to steer Claude in real-time"', '"Claude 작업 중 메시지를 보내 실시간으로 방향을 조정하세요"'],
-  ['"Ask Claude to create a todo list when working on complex tasks to track progress and remain on track"', '"복잡한 작업 시 Claude에게 할 일 목록을 만들게 하면 진행 상황을 추적할 수 있습니다"'],
-  ['"Connect Claude to your IDE · /ide"', '"Claude를 IDE에 연결하세요 · /ide"'],
-  ['"Run /install-github-app to tag @claude right from your Github issues and PRs"', '"/install-github-app으로 GitHub 이슈와 PR에서 @claude를 태그하세요"'],
-  ['"Run /install-slack-app to use Claude in Slack"', '"/install-slack-app으로 Slack에서 Claude를 사용하세요"'],
-  ['"Use /permissions to pre-approve and pre-deny bash, edit, and MCP tools"', '"/permissions로 bash, edit, MCP 도구를 미리 허용/거부하세요"'],
-  ['"Did you know you can drag and drop image files into your terminal?"', '"터미널에 이미지 파일을 드래그 앤 드롭할 수 있습니다"'],
-  ['"Paste images into Claude Code using control+v (not cmd+v!)"', '"control+v로 Claude Code에 이미지를 붙여넣으세요 (cmd+v 아님!)"'],
-  ['"Double-tap esc to rewind the conversation to a previous point in time"', '"esc 두 번 눌러 대화를 이전 시점으로 되돌리세요"'],
-  ['"Double-tap esc to rewind the code and/or conversation to a previous point in time"', '"esc 두 번 눌러 코드와 대화를 이전 시점으로 되돌리세요"'],
-  ['"Run claude --continue or claude --resume to resume a conversation"', '"claude --continue 또는 --resume으로 대화를 이어서 하세요"'],
-  ['"Name your conversations with /rename to find them easily in /resume later"', '"/rename으로 대화 이름을 지정하면 /resume에서 쉽게 찾을 수 있습니다"'],
-  ['"Create skills by adding .md files to .claude/skills/ in your project or ~/.claude/skills/ for skills that work in any project"', '".claude/skills/에 .md 파일을 추가해 스킬을 만드세요. ~/.claude/skills/는 모든 프로젝트에서 사용 가능"'],
-  ['"Use /agents to optimize specific tasks. Eg. Software Architect, Code Writer, Code Reviewer"', '"/agents로 특정 작업을 최적화하세요. 예: Software Architect, Code Writer, Code Reviewer"'],
-  ['"Use --agent <agent_name> to directly start a conversation with a subagent"', '"--agent <에이전트명>으로 서브에이전트와 직접 대화를 시작하세요"'],
-  ['"Run Claude Code locally or remotely using the Claude desktop app: clau.de/desktop"', '"Claude 데스크톱 앱으로 로컬/원격에서 실행하세요: clau.de/desktop"'],
-  ['"Run tasks in the cloud while you keep coding locally · clau.de/web"', '"로컬에서 코딩하면서 클라우드에서 작업 실행 · clau.de/web"'],
-  ['"/mobile to use Claude Code from the Claude app on your phone"', '"/mobile로 휴대폰 Claude 앱에서 Claude Code 사용"'],
-  ['"Use /feedback to help us improve!"', '"/feedback으로 개선에 도움을 주세요!"'],
-  // 동적 팁 — 정적 부분만 (파라미터 문자열은 안정적)
-  ['"chat:imagePaste","Chat","ctrl+v")} to paste images from your clipboard', '"chat:imagePaste","Chat","ctrl+v")}로 클립보드 이미지를 붙여넣으세요'],
-  ['Use Plan Mode to prepare for a complex request before making changes. Press ${', '복잡한 요청 전 계획 모드로 준비하세요. ${'],
-  ['"chat:cycleMode","Chat","shift+tab")} twice to enable.', '"chat:cycleMode","Chat","shift+tab")}를 두 번 눌러 활성화하세요.'],
-  ['"chat:cycleMode","Chat","shift+tab")} to cycle between default mode, auto-accept edit mode, and plan mode', '"chat:cycleMode","Chat","shift+tab")}로 기본 모드, 수정 허용, 계획 모드를 전환하세요'],
-  ['"chat:cycleMode","Chat","shift+tab")} twice to activate Plan Mode and plan with Claude Opus.', '"chat:cycleMode","Chat","shift+tab")}를 두 번 눌러 계획 모드를 활성화하세요.'],
-  ['Your default model setting is Opus Plan Mode. Press ${', '기본 모델이 Opus 계획 모드입니다. ${'],
-  ['Continue your session in Claude Code Desktop with ${', 'Claude Code Desktop에서 세션 이어가기: ${'],
-  // 동적 팁 — 조건분기 (ternary) 정적 문자열
-  ['"Run /terminal-setup to enable convenient terminal integration like Option + Enter for new line and more"', '"/terminal-setup으로 Option+Enter 줄바꿈 등 터미널 연동을 설정하세요"'],
-  ['"Run /terminal-setup to enable convenient terminal integration like Shift + Enter for new line and more"', '"/terminal-setup으로 Shift+Enter 줄바꿈 등 터미널 연동을 설정하세요"'],
-  ['"Press Option+Enter to send a multi-line message"', '"Option+Enter로 여러 줄 메시지를 보내세요"'],
-  ['"Press Shift+Enter to send a multi-line message"', '"Shift+Enter로 여러 줄 메시지를 보내세요"'],
-  ['"Run /terminal-setup to enable Option+Enter for new lines"', '"/terminal-setup으로 Option+Enter 줄바꿈을 설정하세요"'],
-  ['"Run /terminal-setup to enable Shift+Enter for new lines"', '"/terminal-setup으로 Shift+Enter 줄바꿈을 설정하세요"'],
-];