leerness 1.20.0 → 1.22.0

package/CHANGELOG.md

@@ -1,5 +1,107 @@
 # Changelog
 
+## 1.22.0 — 2026-06-15 — 🛡️ [안정화/Stable] 확장된 영어 지원(헤드라인 + verify-claim) 안정 minor
+
+**🛡️ 안정화(Stable) minor — 영어 CLI 커버리지를 핵심 검증 흐름까지 확장해 npm 공개.** 직전 minor(1.21.0) 이후 누적된 패치 2건(1.21.1~1.21.2)을 검증·통합해 배포. R-0011 정책의 13번째 stable minor. 영어 opt-in 표면이 첫 화면(1.21.0)에서 **handoff 헤드라인 + verify-claim 플래그십**까지 확장 — 한국어 우선 기본은 그대로.
+
+### 이번 minor 통합 (1.21.1~1.21.2)
+- **🌐 handoff 헤드라인 항목 라벨 영어화 (Phase 2)**: 매 세션 가장 많이 보는 출력 — `--language en` 시 `📊 Headline: drift healthy · security OK · N skills · health · mem …` 완전 영어. 보안/시크릿/미답요청/비정상종료/플랫폼제약 등 전 항목.
+- **🌐 verify-claim 출력 영어화 (Phase 3, 플래그십)**: 완료 검증 시 보는 핵심 출력 ~30 문자열 영어화 — File check / Test count / Summary / implementation substance / test-impl link / git diff cross-check / optimism+honesty / final verdict.
+- **한국어 우선 기본 보존**: 영어는 명시 opt-in(`--language en`/`LEERNESS_LANG=en`/en init 프로젝트). 플래그 없으면 한국어 — e2e 무회귀로 검증.
+
+### 잔여 (UR-0010 Phase 4+, 백로그)
+- session close 마감 보고(~117 문자열) + help + status — 단계적 확대.
+
+### 검증 (회귀 0)
+- **selftest 236→238** · **E2E 365/365** · en/ko 헤드라인·verify-claim 행위 + 게시본 재실증.
+
+### 안정화 표시 (R-0006)
+CHANGELOG [안정화/Stable] · git tag (Stable) · GitHub release (`--latest`) · npm dist-tag `stable` 시도.
+
+## 1.21.2 — 2026-06-15 — CLI 영어화 Phase 3: verify-claim(플래그십) 출력 영어화 (UR-0010)
+
+**🌐 플래그십 명령 출력을 영어로.** 사용자가 "완료됐나?"를 확인할 때 보는 `verify-claim` 의 human 출력 전체를 영어 opt-in 으로 — 온보딩 다음으로 영향 큰 표면. 한국어 기본 유지(영어 명시 opt-in).
+
+### 변경 (UR-0010 Phase 3)
+- **verify-claim 출력 영어화**: human 렌더(–json 제외) 시작에서 `_uiLang(root)` 1회 해석 후 전 출력을 `t(ko,en)` 분기 — `📂 파일 검증`→`File check`, `🧪 테스트 카운트`→`Test count`, `🚦 실행`→`run`, `종합`→`Summary`, `파일 모두 존재`→`all files exist`, `구현 실체`→`implementation substance`, `테스트-구현 연결`→`test-impl link`, `git diff 교차검증`→`git diff cross-check`, `낙관적 표시+정직성`→`optimism+honesty`, evidence 완전성/외과적 변경/한계/최종 판정까지 ~30 문자열. 품질 렌즈 advisory 헤더도 영어.
+- **한국어 기본 무회귀**: e2e 는 `--language` 없이 실행되며 init 이 이 환경에서 manifest.language=`ko` 로 저장(검증함) → verify-claim 기본 출력 한국어 유지. ko 원문은 `t()` 의 ko 인자로 소스에 보존.
+
+### 잔여 (UR-0010 Phase 4+, 백로그)
+- session close 마감 보고 + help + status + 그 외 명령 본문 영어화 — 단계적 확대.
+
+### 검증 (회귀 0)
+- **selftest 237→238** (verify-claim t() 경유 + 한국어 보존 소스가드) · 행위(en: `## Summary / all files exist / evidence claim matches`, ko 기본: `## 종합 / 파일 모두 존재`) · **E2E 365/365**.
+- patch(1.21.2) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
+## 1.21.1 — 2026-06-15 — CLI 영어화 Phase 2: handoff 헤드라인 항목 라벨 영어화 (UR-0010)
+
+**🌐 매 세션 가장 많이 보는 출력(handoff 헤드라인)을 영어로 완성.** Phase 1(배너 + 헤드라인 프리픽스)에 이어, 헤드라인의 **항목 라벨 전체**를 영어 opt-in 으로. 비한국어 사용자가 세션마다 보던 한국어 토막들(보안 OK·미답 요청·비정상종료·플랫폼 제약 등)이 사라짐.
+
+### 변경 (UR-0010 Phase 2)
+- **handoff 헤드라인 항목 라벨 영어화**: 블록 1회 `_uiLang(root)` 해석 후 각 항목을 `t(ko,en)` 분기 — `🔒 보안 OK`→`security OK`, `🚨 시크릿 N건`→`N secret(s)`, `🚨 .env 미무시`→`.env not ignored`, `🔌 MCP N회`→`MCP Nx`, `📒 skill query N회`, `🪄 slash 24h N회`, `📥 미답 요청 N건`→`N unanswered request(s)`, `📥 요청 N (tracked)`, `📥 자동완료가능 N건`→`N auto-completable`, `🔌 비정상종료`→`abnormal-exit`, `🚦 N 플랫폼 제약`→`N platform constraint(s)`, `R N남음`→`N left`. **한국어 기본 유지**(영어 opt-in).
+- 행위 확인: en → `📊 Headline: drift healthy · 🔒 security OK · 📚 N skills · ⚕ health: ✓ · 🧠 mem …` 완전 영어 / 플래그 없음 → `📊 헤드라인`(한국어).
+
+### 잔여 (UR-0010 Phase 3+, 백로그)
+- session close 마감 보고 + verify-claim 출력 + help + status 등 명령 본문 영어화 — 단계적 확대.
+
+### 검증 (회귀 0)
+- **selftest 236→237** (헤드라인 t() 경유 소스가드) · 행위(en 헤드라인 완전 영어 + ko 기본) · **E2E 365/365**.
+- patch(1.21.1) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
+## 1.21.0 — 2026-06-15 — 🛡️ [안정화/Stable] 영어 온보딩 첫걸음 + 검증 강화 안정 minor
+
+**🛡️ 안정화(Stable) minor — 비한국어 사용자에게 영어 온보딩을 실제로 전달.** 직전 minor(1.20.0) 이후 누적된 패치 2건(1.20.1~1.20.2)을 검증·통합해 npm 공개. R-0011 정책의 12번째 stable minor. 핵심: **영어 첫 화면(opt-in)** 이 npm 사용자에게 닿고, 검증 플래그십의 정적 우회가 닫힘.
+
+### 이번 minor 통합 (1.20.1~1.20.2)
+- **🌐 CLI 영어화 Phase 1 (UR-0010, 사용자 지정 방향)**: 영어 README 정문 ↔ 한국어 CLI 불일치(외부평가 #1 병목) 해소 시작. `--language en` / `LEERNESS_LANG=en` / en 으로 init 된 프로젝트에서 **init 시작하기 배너 전체 + handoff 헤드라인 라벨**이 영어로. 한국어 우선 정체성은 **기본값 유지**(영어는 명시 opt-in, system locale 미사용). 순수 `_uiLang`/`_tx`.
+- **🛡️ 장식 no-op 정적 우회 차단 (검증)**: `"use strict"; module.exports={}` · `{}; //c` · `void 0;` · `;;;;` · `0;` 같은 "실로직 0" 파일이 정적 verify-claim 을 통과하던 우회를 차감식 residue 검사로 폐쇄(FP 0).
+- **📄 README 플래그십 데모 정합**: task-id(T-0002) + "실파일 쓰면 같은 명령 통과" 정정 — 신규 유저 복붙이 실제로 동작. lens 헤더 동적 버전.
+- **🔬 신뢰 투명성/렌즈 완전판** (1.19.x 누적 — 1.20.0 에 포함됨, 본 minor 는 1.20.x 패치 묶음).
+
+### 잔여 (UR-0010 Phase 2+, 백로그)
+- handoff 헤드라인 **항목 라벨**(drift·보안·skills·health·mem 등 ~20종) + session close·verify-claim·help·status 출력 영어화 — 단계적 확대.
+
+### 검증 (회귀 0)
+- **selftest 235→236** · **E2E 365/365** · 영어 배너/헤드라인 행위 + no-op 우회 차단 + 게시본 재실증.
+
+### 안정화 표시 (R-0006)
+CHANGELOG [안정화/Stable] · git tag (Stable) · GitHub release (`--latest`) · npm dist-tag `stable` 시도.
+
+## 1.20.2 — 2026-06-15 — CLI 영어화 Phase 1: 첫 화면(init 배너·handoff 헤드라인) 영어 opt-in (UR-0010)
+
+**🌐 "어떤 언어, 어떤 AI 에이전트로 작업하든"의 실질 첫걸음.** 외부평가가 꼽은 단일 최대 병목 — 영어 README 정문 ↔ 한국어 CLI 불일치 — 를 단계적으로 해소 시작. 한국어 우선 정체성은 기본값으로 유지하고, **영어는 명시 opt-in**.
+
+### 변경 (UR-0010 Phase 1)
+- **UI 언어 해석 `_uiLang(root)`**: 우선순위 `--language` 플래그 > `LEERNESS_LANG` env > `.harness/manifest.json` 의 language(init 선택) > **`ko`(기본)**. system locale 은 의도적으로 미사용(영어 OS 한국 사용자 놀람 방지) — 영어는 항상 명시 opt-in.
+- **init 시작하기 배너 영어화**: `--language en`(또는 LEERNESS_LANG=en, 또는 en 으로 init 된 프로젝트)에서 "Get started (3 steps)" + 메모리/인과/보안/MCP/release 섹션 전체 영어로. 비한국어 신규 유저의 첫 화면이 더 이상 한국어 벽이 아님.
+- **handoff 헤드라인 라벨 영어화**: `📊 헤드라인 (버전태그…)` → 영어 시 `📊 Headline`(버전태그 노이즈 제거).
+- 순수 함수 `_uiLang`/`_tx` 분리(단위 테스트). **한국어 기본 회귀 0**(플래그/env/manifest 없으면 그대로 한국어).
+
+### 잔여 (UR-0010 Phase 2+, 백로그)
+- handoff 헤드라인 **항목 라벨**(보안 OK·skills·health…) 영어화, 그 외 명령(session close·verify-claim 출력·help·status 등) 영어화 — 단계적 확대. Phase 1 은 첫인상 표면(배너+헤드라인 프리픽스)에 한정.
+
+### 검증 (회귀 0)
+- **selftest 235→236** (`_uiLang` 해석 4종 + `_tx` + 첫화면 분기 소스가드) · 행위: `--language en` → 영어 배너/헤드라인, 플래그 없음 → 한국어 유지 · **E2E 365/365**.
+- patch(1.20.2) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
+## 1.20.1 — 2026-06-15 — 1.20.0 외부평가 채택: 장식 no-op 우회 차단 + README 데모 정합
+
+**🔎 게시본 1.20.0 신규 멀티모델 클린룸 평가(5축) 채택 — 맹신 X로 재현된 것만.** 검증(8)·정직성/보안(9)·품질렌즈(8)는 GPT-5.5 대비 뚜렷이 상승했고, 평가가 찾은 재현 가능한 P2 두 가지(검증 정적모드 우회 + README 데모 부정확)를 닫음.
+
+### 변경 (1.20.0 외부평가 재현 채택)
+- **🛡️ 장식된 no-op 정적 우회 차단 (검증, P2)**: 빈껍데기 검출이 순수 빈-export 형태만 잡던 것 — `"use strict"; module.exports={}`·`{}; // comment`·`module.exports={}; void 0;`·`;;;;`·`0;` 같은 "실로직 0" 파일이 정적 `verify-claim`을 exit 0 통과하던 우회 폐쇄. `_vcImplIsEmpty` 에 **차감식(residue) 검사** 추가 — 디렉티브 프롤로그 + 빈 export + no-op 리터럴/문을 제거하고 의미 토큰이 하나도 안 남으면 스텁. FP 0(실코드·`require` 재노출·이름붙은 export·`module.exports=0` 같은 의도적 값은 통과). `let x=1` 류 무의미 선언은 식별자가 남아 통과 — AST 토큰화 필요(백로그).
+- **📄 README 플래그십 데모 정합 (온보딩, P2)**: ① task-id 수정 — init 이 T-0001(계획 task)을 차지하므로 `task add` 는 T-0002 생성, 데모를 실제 흐름(출력된 id 사용)으로. ② "실파일+실테스트 쓰면 같은 명령 통과" 정정 — evidence 의 테스트 개수 주장은 실측과 대조되므로(거짓이면 거부) 정직한 evidence + `--run-tests --test-cmd` 안내로 교체. 신규 유저 복붙이 실제로 동작.
+- **🔖 lens 헤더 버전 정합 (P3)**: 하드코딩 `(1.18.3)` → 동적 `(v${VERSION})`.
+
+### 백로그 등록 (평가 추천 우선순위, 이번 라운드 미포함)
+- **UR-0010 (최우선)**: CLI UX 영어화 — `--language en` 이 템플릿 파일만 바꾸고 CLI 자체 출력(init 배너·handoff 헤드라인·help)은 한국어 유지. 영어 README 정문 ↔ 한국어 CLI 불일치가 비한국어 시장의 단일 최대 병목(거대 작업, UR-0042 잔여 통합).
+- **UR-0011**: 표면 core-vs-extended 티어링 — 84커맨드+85툴 평면 노출, banner/about/commands/help 의 "start here" 4종 불일치 → 핵심8 표준화 + `--help` 정리.
+- **UR-0012**: secret scan AWS AKIA 키 ID + 추가 prefix 커버리지.
+
+### 검증 (회귀 0)
+- **selftest 235** (no-op 우회 6종 차단 + FP 가드 3종 행위) · 5종 우회 재현 차단·FP 0 확인 · README 데모 재현(task-id·count 정합) · **E2E 365/365**.
+- patch(1.20.1) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
 ## 1.20.0 — 2026-06-15 — 🛡️ [안정화/Stable] 품질 렌즈 완전판 + 신뢰 투명성 안정 minor
 
 **🛡️ 안정화(Stable) minor — "AI가 스스로 질문하고 행동하도록" 완성.** 직전 minor(1.19.0) 이후 누적된 패치 3건(1.19.1~1.19.3)을 검증·통합해 npm 공개. R-0011 정책의 11번째 stable minor. 핵심 테마: **사용자 자기질문 품질 렌즈를 정적 명령에서 완전한 워크플로 기능으로** + 신뢰 투명성(클린룸 평가 공개).

package/README.md

@@ -28,12 +28,14 @@ npx leerness handoff .         # everything your AI should know right now, in on
 Your project now has agent-independent memory. To see the flagship feature — catching a false "done" claim:
 
 ```bash
-npx leerness task add "Implement payment API"
-npx leerness task update T-0001 --status done --evidence "payment.js done, 5 tests passed"
-npx leerness verify-claim T-0001   # exit 1 — payment.js does not exist, no tests ran. Claim rejected.
+npx leerness task add "Implement payment API"   # prints the new id, e.g. T-0002 — use it below
+npx leerness task update T-0002 --status done --evidence "payment.js implemented + tested"
+npx leerness verify-claim T-0002   # exit 1 — payment.js does not exist. Claim rejected.
 ```
 
-Write the real file with a real test and the same command passes. That is the whole idea: **"done" must match reality.**
+Now actually write `payment.js`, then run the **same** `verify-claim T-0002` → it exits 0. That is the whole idea: **"done" must match reality.**
+
+> Tip: if your evidence claims a specific test count (e.g. "5 tests passed"), leerness measures the real count and rejects a mismatch — so claim only what's true, or add `--run-tests --test-cmd "<your test cmd>"` to verify by running them.
 
 > Want a smaller footprint? `leerness init . --minimal` installs only the core memory + verification files instead of the full set.
 
@@ -102,7 +104,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.20.0 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.22.0 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -156,7 +158,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.20.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.22.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -177,7 +179,7 @@ Leerness v1.20.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.20.0)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.22.0)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -215,6 +217,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.20.0: 2026-06-15
+Last synced by Leerness v1.22.0: 2026-06-15
 <!-- leerness:project-readme:end -->
 

package/bin/leerness.js

@@ -32,7 +32,7 @@ const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInG
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _TOOL_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS, BUILTIN_CATALOG, ROADMAP_STATUS_LABEL, ROADMAP_STATUS_COLOR, SECRET_PATTERNS, MERGE_OVERWRITE_FILES, MINIMAL_SKIP_KEYS, REQUIRED_WORKSPACE_FILES, KEYWORD_STOPWORDS, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344/368/369 (UR-0025): catalog 분리 · 1.11.4 (UR-0007): _TOOL_CATALOG
 
-const VERSION = '1.20.0';
+const VERSION = '1.22.0';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -252,6 +252,22 @@ function detectLanguageValue(root, value = 'auto') {
   // ③ en 폴백
   return 'en';
 }
+// 1.20.2 (UR-0010 CLI 영어화 Phase 1): UI 출력 언어 해석 — 한국어 우선 기본, 영어 opt-in.
+//   우선순위: --language 플래그 > LEERNESS_LANG env > .harness/manifest.json 의 language(init 선택) > 'ko'.
+//   (system locale 은 의도적으로 미사용 — 영어 OS 한국 사용자 놀람 방지. 영어는 명시 opt-in.)
+function _uiLang(root) {
+  try {
+    const flag = String(arg('--language', '') || '').toLowerCase();
+    if (flag === 'en' || flag === 'ko') return flag;
+    const env = String(process.env.LEERNESS_LANG || '').toLowerCase();
+    if (env === 'en' || env === 'ko') return env;
+    const mf = path.join(absRoot(root || process.cwd()), '.harness', 'manifest.json');
+    if (exists(mf)) { const l = String((JSON.parse(read(mf)) || {}).language || '').toLowerCase(); if (l === 'en' || l === 'ko') return l; }
+  } catch {}
+  return 'ko';
+}
+// ko/en 쌍에서 해석된 UI 언어로 선택 (Phase 1: 첫 화면 한정 사용).
+function _tx(lang, ko, en) { return lang === 'en' ? en : ko; }
 function fm(role, readWhen, updateWhen, body) {
   return `---\nleernessRole: ${role}\nreadWhen:\n${readWhen.map(x => '  - ' + x).join('\n')}\nupdateWhen:\n${updateWhen.map(x => '  - ' + x).join('\n')}\ndoNotStore:\n  - 실제 토큰\n  - 비밀번호\n  - 운영 쿠키\n  - 민감한 개인정보 원문\n---\n${MARK}\n${body}`;
 }
@@ -3594,7 +3610,7 @@ function _selfTestCases() {
       const src = read(__filename);
       const authPass = src.includes('userAuthorized: true, timeout: 5 * 60 * 1000, kind: ' + "'verify_claim_test'");
       const skipOnBlock = src.includes('if (r.blocked) {') && src.includes('테스트 명령 차단') && src.includes('불일치 판정 아님');
-      const label = src.includes('`  - ${runResult.cmd ' + "|| 'npm test'} 실행:");  // P3: 하드코딩된 npm test 라벨 제거
+      const label = src.includes('`  - ${runResult.cmd ' + "|| 'npm test'} ${t('실행', 'run')}:");  // P3: 하드코딩 제거 + 1.21.2 영어화 t()
       return authPass && skipOnBlock && label;
     } },
     { name: '재실증 P2 (1.18.1): task update id 뒤 non-path positional(status) 거부 + path-like 허용 (소스 가드)', run: () => {
@@ -3624,7 +3640,18 @@ function _selfTestCases() {
         && E('module.exports = Object.freeze({ a: 1 });\n') === false
         && E('module.exports = class { run(){ return 1; } };\n') === false
         && E('module.exports = (a,b) => a+b;\n') === false;
-      return base && bypass && real;
+      // 1.20.1 (1.20.0 외부평가 재현): 장식된 no-op 우회(true 여야 함) — 디렉티브 프롤로그 + no-op 문
+      const noop = E('"use strict";\nmodule.exports = {};\n') === true
+        && E('{}; // c\n') === true
+        && E('module.exports = {};\nvoid 0;\n') === true
+        && E(';;;;\n') === true
+        && E('0;\n') === true
+        && E("'use strict';\nexports.default = {};\n") === true;
+      // 1.20.1 FP 가드(false 여야 함): 단일 의미 토큰만 있어도 통과
+      const noopFP = E('"use strict";\nfunction f(){ return 1; }\nmodule.exports = { f };\n') === false
+        && E('module.exports = 0;\n') === false                 // 0 을 export 하는 의도적 값 — 스텁 아님
+        && E('module.exports = require("./x"); void 0;\n') === false;
+      return base && bypass && real && noop && noopFP;
     } },
     { name: '위장 스텁 차단 (1.18.2): stub 루프 _vcImplIsEmpty 사용 + 메시지 + FILE_EXTS java/php 정합 (소스 가드)', run: () => {
       const src = read(__filename);
@@ -3691,6 +3718,37 @@ function _selfTestCases() {
       const d = read(dp);
       return /AI clean-room evaluations/i.test(d) && /heuristic, not semantic/i.test(d) && /npm i leerness@/.test(d);
     } },
+    { name: 'CLI 영어화 Phase 1 (1.20.2, UR-0010): _uiLang 해석(flag>env>manifest>ko) + 첫화면 _t 적용 (행위+소스)', run: () => {
+      const save = process.argv; const saveEnv = process.env.LEERNESS_LANG;
+      try {
+        // 기본 ko (한국어 우선 정체성 보존)
+        process.argv = ['node', 'h', 'handoff']; delete process.env.LEERNESS_LANG;
+        if (_uiLang('/no/such/dir') !== 'ko') return false;
+        // --language en 플래그 → en
+        process.argv = ['node', 'h', 'handoff', '--language', 'en'];
+        if (_uiLang('/no/such/dir') !== 'en') return false;
+        // LEERNESS_LANG env → en (플래그 없을 때)
+        process.argv = ['node', 'h', 'handoff']; process.env.LEERNESS_LANG = 'en';
+        if (_uiLang('/no/such/dir') !== 'en') return false;
+        // _tx 선택
+        if (_tx('en', '가', 'A') !== 'A' || _tx('ko', '가', 'A') !== '가') return false;
+      } finally { process.argv = save; if (saveEnv === undefined) delete process.env.LEERNESS_LANG; else process.env.LEERNESS_LANG = saveEnv; }
+      // 첫화면(배너/헤드라인)이 언어 분기 사용
+      const src = read(__filename);
+      return src.includes("const L = _uiLang(arg('--path', process.cwd()));") && src.includes("_uiLang(root) === 'en' ? '📊 Headline'");
+    } },
+    { name: 'CLI 영어화 Phase 2 (1.21.1, UR-0010): handoff 헤드라인 항목 라벨 t() 경유 (소스 가드)', run: () => {
+      const src = read(__filename);
+      return src.includes('const _L = _uiLang(root); const t = (ko, en) => (_L === ' + "'en' ? en : ko);")
+        && src.includes("security OK") && src.includes("unanswered request(s)") && src.includes("abnormal-exit") && src.includes("platform constraint(s)");
+    } },
+    { name: 'CLI 영어화 Phase 3 (1.21.2, UR-0010): verify-claim 출력 t() 경유 + 한국어 기본 보존 (소스 가드)', run: () => {
+      const src = read(__filename);
+      const en = src.includes('## File check') && src.includes('## Test count') && src.includes('## Summary')
+        && src.includes('implementation substance (done default)') && src.includes('evidence claim matches actual files');
+      const koPreserved = src.includes('## 종합') && src.includes('구현 실체 (done 기본)');  // ko 원문이 t() ko 인자로 남아 e2e(ko) 무회귀
+      return en && koPreserved;
+    } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -4326,7 +4384,7 @@ function lensCmd(domain, opts = {}) {
   const picked = domain ? { [domain]: catalog[domain] } : catalog;
   if (jsonMode) { log(JSON.stringify({ ok: true, lenses: picked }, null, 2)); return; }
   const hasCustom = Object.values(catalog).some(l => l && (l._custom || l._customAdded));
-  log(`# leerness lens — 분야별 자기질문 품질 렌즈 (1.18.3)${hasCustom ? ' + 프로젝트 커스텀(.harness/quality-lenses.json)' : ''}`);
+  log(`# leerness lens — 분야별 자기질문 품질 렌즈 (v${VERSION})${hasCustom ? ' + 프로젝트 커스텀(.harness/quality-lenses.json)' : ''}`);
   log(`완료 선언 전 해당 분야 질문에 스스로 답해보세요. "그렇다(통과)"라고 답할 수 없으면 아직 완료가 아닙니다.`);
   for (const [key, l] of Object.entries(picked)) {
     log('');
@@ -8232,6 +8290,8 @@ function handoff(root) {
   if (!has('--no-headline') && !has('--compact') && !has('--quiet')) {
     try {
       const parts = [];
+      // 1.20.3 (UR-0010 Phase 2): 헤드라인 항목 라벨 UI 언어 적용 (영어 opt-in, 한국어 기본). 블록 1회 해석.
+      const _L = _uiLang(root); const t = (ko, en) => (_L === 'en' ? en : ko);
       // 1) drift level (가벼운 check)
       try {
         const r = cp.spawnSync(process.execPath, [__filename, 'drift', 'check', root, '--json'],
@@ -8245,15 +8305,15 @@ function handoff(root) {
       try {
         const sec = _collectSecretFindings(root);
         if (sec.committed.length) {
-          parts.push(`🚨 시크릿 ${sec.committed.length}건`);
+          parts.push(t(`🚨 시크릿 ${sec.committed.length}건`, `🚨 ${sec.committed.length} secret(s)`));
         } else {
           const envPath = path.join(root, '.env');
           if (exists(envPath)) {
             const giText = exists(path.join(root, '.gitignore')) ? read(path.join(root, '.gitignore')) : '';
             const giLines = giText.split('\n').map(l => l.trim());
-            parts.push((giLines.includes('.env') || giLines.includes('/.env')) ? '🔒 보안 OK' : '🚨 .env 미무시');
+            parts.push((giLines.includes('.env') || giLines.includes('/.env')) ? t('🔒 보안 OK', '🔒 security OK') : t('🚨 .env 미무시', '🚨 .env not ignored'));
           } else {
-            parts.push('🔒 보안 OK');
+            parts.push(t('🔒 보안 OK', '🔒 security OK'));
           }
         }
       } catch {}
@@ -8261,7 +8321,7 @@ function handoff(root) {
       try {
         const stats = _readUsageStats(root);
         const mcpTotal = stats.mcp?.tools ? Object.values(stats.mcp.tools).reduce((s, n) => s + n, 0) : 0;
-        if (mcpTotal > 0) parts.push(`🔌 MCP ${mcpTotal}회`);
+        if (mcpTotal > 0) parts.push(`🔌 MCP ${mcpTotal}${t('회', 'x')}`);
       } catch {}
       // 4) skill match history 누적
       try {
@@ -8269,7 +8329,7 @@ function handoff(root) {
         if (exists(histPath)) {
           const txt = read(histPath);
           const cnt = (txt.match(/^## [\d-]+ [\d:]+ — query/gm) || []).length;
-          if (cnt > 0) parts.push(`📒 skill query ${cnt}회`);
+          if (cnt > 0) parts.push(`📒 skill query ${cnt}${t('회', 'x')}`);
         }
       } catch {}
       // 5) 설치된 skill 수
@@ -8330,7 +8390,7 @@ function handoff(root) {
               }
             } catch {}
           }
-          if (slashCount > 0) parts.push(`🪄 slash 24h ${slashCount}회`);
+          if (slashCount > 0) parts.push(`🪄 slash 24h ${slashCount}${t('회', 'x')}`);
         }
       } catch {}
       // 10) 1.9.192: 공식 organization skill catalog 캐시 매칭 (C축 보강 — 사용자 명시)
@@ -8358,7 +8418,7 @@ function handoff(root) {
         if (rh.roundCount >= 5) {
           let label = `🔄 R${rh.roundCount}`;
           if (rh.nextMilestone != null && rh.roundsToNextMilestone <= 20) {
-            label += ` → R${rh.nextMilestone} (${rh.roundsToNextMilestone}R 남음)`;
+            label += ` → R${rh.nextMilestone} (${rh.roundsToNextMilestone}R ${t('남음', 'left')})`;
           }
           parts.push(label);
           // 1.9.230: 임박 마일스톤 ETA 별도 노출 (다음 마일스톤이 매우 가까울 때만)
@@ -8403,11 +8463,11 @@ function handoff(root) {
         let detected = { candidates: [] };
         try { detected = _detectDeliveredRequests(root); } catch {}
         if (detected.candidates && detected.candidates.length > 0) {
-          parts.push(`📥 자동완료가능 ${detected.candidates.length}건 (1.9.223)`);
+          parts.push(t(`📥 자동완료가능 ${detected.candidates.length}건 (1.9.223)`, `📥 ${detected.candidates.length} auto-completable`));
         } else if (audit.missing && audit.missing.length > 0) {
-          parts.push(`📥 미답 요청 ${audit.missing.length}건`);
+          parts.push(t(`📥 미답 요청 ${audit.missing.length}건`, `📥 ${audit.missing.length} unanswered request(s)`));
         } else if (audit.open > 0) {
-          parts.push(`📥 요청 ${audit.open} (tracked)`);
+          parts.push(t(`📥 요청 ${audit.open} (tracked)`, `📥 ${audit.open} request(s) (tracked)`));
         }
       } catch {}
       // 14) 1.9.209: pre-wake-audit 최근 보고서 (사용자 명시) — 깨어남 직후 자동 노출
@@ -8426,7 +8486,7 @@ function handoff(root) {
       try {
         const ad = _detectAbnormalShutdown(root);
         if (ad.abnormalShutdown) {
-          parts.push(`🔌 비정상종료 ${ad.severity} (${ad.signals.length}신호)`);
+          parts.push(t(`🔌 비정상종료 ${ad.severity} (${ad.signals.length}신호)`, `🔌 abnormal-exit ${ad.severity} (${ad.signals.length} signals)`));
         }
       } catch {}
       // 15) 1.9.215: 현재 활성 task에서 constraints/intent 자동 분석 (1.9.208/213 통합)
@@ -8446,7 +8506,7 @@ function handoff(root) {
               try {
                 const cc = _checkRequestConstraints(root, req);
                 if (cc.matched && cc.matched.length > 0) {
-                  parts.push(`🚦 ${cc.matched.length} 플랫폼 제약`);
+                  parts.push(t(`🚦 ${cc.matched.length} 플랫폼 제약`, `🚦 ${cc.matched.length} platform constraint(s)`));
                 }
               } catch {}
               // 1.9.213 intent classify
@@ -8467,7 +8527,9 @@ function handoff(root) {
       if (parts.length) {
         const isTty = process.stdout && process.stdout.isTTY;
         const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
-        log(cy(`📊 헤드라인 (1.9.81/93/113/152/162/192/197/204/207/209/215/220/223/226): ${parts.join(' · ')}`));
+        // 1.20.2 (UR-0010 Phase 1): 헤드라인 라벨 UI 언어 적용 (영어 시 버전태그 노이즈 제거; 항목 라벨 영어화는 Phase 2).
+        const _hl = _uiLang(root) === 'en' ? '📊 Headline' : '📊 헤드라인 (1.9.81/93/113/152/162/192/197/204/207/209/215/220/223/226)';
+        log(cy(`${_hl}: ${parts.join(' · ')}`));
       }
     } catch {}
   }
@@ -9892,7 +9954,19 @@ function _vcImplIsEmpty(body) {
   }).filter(Boolean);
   if (codeLines.length === 0) return true;                                  // ① 코드 0줄
   const joined = codeLines.join(' ').replace(/\s+/g, ' ').trim();
-  return _VC_EMPTY_SHELL_RE.test(joined);                                   // ② 빈 export 껍데기뿐
+  if (_VC_EMPTY_SHELL_RE.test(joined)) return true;                         // ② 빈 export 껍데기뿐
+  // ③ 1.20.1 (1.20.0 외부평가 재현): 장식된 no-op 우회 — 디렉티브 프롤로그 + 빈 export + no-op 문만 남으면 스텁.
+  //    "use strict"; module.exports={} · {};//c · module.exports={};void 0; · ;;;; · 0; (정적모드 우회) 폐쇄. FP 0: 실코드는 식별자/키워드가 남음.
+  //    (let x=1 같은 무의미 선언은 식별자가 남아 통과 — AST 토큰 카운트 필요, 백로그.)
+  const residue = joined
+    .replace(/^\s*(['"])use strict\1\s*;?/i, '')                             // 디렉티브 프롤로그
+    .replace(/(?:module\.)?exports(?:\.[A-Za-z0-9_$]+)?\s*=\s*(?:\{\s*\}|\[\s*\])\s*;?/g, '')  // 빈 export
+    .replace(/export\s+default\s*(?:\{\s*\}|\[\s*\])\s*;?/g, '')
+    .replace(/export\s*\{\s*\}\s*;?/g, '')
+    .replace(/\bvoid\s+0\b/g, '')                                            // void 0
+    .replace(/\b(?:null|undefined|false|true|0)\b/g, '')                     // 단독 no-op 리터럴
+    .replace(/[\s;{}()[\],.]/g, '');                                         // 공백/구두점
+  return residue === '';                                                     // 의미 토큰이 하나도 안 남으면 스텁
 }
 
 function verifyClaimCmd(root, taskId) {
@@ -10135,39 +10209,41 @@ function verifyClaimCmd(root, taskId) {
     return;
   }
 
+  // 1.21.2 (UR-0010 Phase 3): verify-claim 출력 UI 언어 적용 (영어 opt-in, 한국어 기본). human 렌더 한정(--json 은 위에서 return).
+  const _L = _uiLang(root); const t = (ko, en) => (_L === 'en' ? en : ko);
   log(`# verify-claim ${taskId} (${path.basename(root)})`);
   log(`Request: ${row.request}`);
   log(`Status: ${row.status}  ·  Updated: ${row.updated}`);
   log(`Evidence: ${evidence.slice(0, 200)}${evidence.length > 200 ? '…' : ''}`);
   log('');
-  log(`## 📂 파일 검증 (${files.length}건 주장)`);
-  if (!files.length) log('  (evidence에서 파일 경로를 추출하지 못함)');
+  log(t(`## 📂 파일 검증 (${files.length}건 주장)`, `## 📂 File check (${files.length} claimed)`));
+  if (!files.length) log(t('  (evidence에서 파일 경로를 추출하지 못함)', '  (no file paths extracted from evidence)'));
   else {
-    for (const c of fileChecks) log(`  ${c.exists ? '✓' : '✗'} ${c.file}${c.exists ? '' : '  ← 누락'}`);
+    for (const c of fileChecks) log(`  ${c.exists ? '✓' : '✗'} ${c.file}${c.exists ? '' : t('  ← 누락', '  ← missing')}`);
   }
   log('');
-  log(`## 🧪 테스트 카운트`);
-  if (declaredPass) log(`  주장 (pass): ${declaredPass.num}/${declaredPass.denom}`);
-  if (declaredTestCount) log(`  주장 (개수): ${declaredTestCount}개`);
-  if (actualTestCount != null) log(`  실측: ${actualTestCount}개 테스트 호출 (${_vcTests.length ? '주장된 테스트 파일' : '관례 탐색: 루트/tests·test_*.py·*.test.*'})`);
-  else log(`  실측: 테스트 파일 못 찾음 — 카운트 검증 미수행 (pass 아님)`);
+  log(t(`## 🧪 테스트 카운트`, `## 🧪 Test count`));
+  if (declaredPass) log(t(`  주장 (pass): ${declaredPass.num}/${declaredPass.denom}`, `  claimed (pass): ${declaredPass.num}/${declaredPass.denom}`));
+  if (declaredTestCount) log(t(`  주장 (개수): ${declaredTestCount}개`, `  claimed (count): ${declaredTestCount}`));
+  if (actualTestCount != null) log(t(`  실측: ${actualTestCount}개 테스트 호출 (${_vcTests.length ? '주장된 테스트 파일' : '관례 탐색: 루트/tests·test_*.py·*.test.*'})`, `  measured: ${actualTestCount} test call(s) (${_vcTests.length ? 'claimed test files' : 'convention scan: root/tests·test_*.py·*.test.*'})`));
+  else log(t(`  실측: 테스트 파일 못 찾음 — 카운트 검증 미수행 (pass 아님)`, `  measured: no test file found — count not verified (not a pass)`));
 
   // 1.9.19: --run-tests 결과
   let runTestsOk = true;
   let declaredPassMatchesActual = true;
   if (runResult) {
     log('');
-    log(`## 🚦 ${runResult.cmd || '테스트'} 실행 (--run-tests)`);
+    log(`## 🚦 ${runResult.cmd || t('테스트', 'test')} ${t('실행', 'run')} (--run-tests)`);
     if (runResult.skipped) {
       log(`  ⚠ skipped: ${runResult.reason}`);
     } else {
       log(`  exit: ${runResult.exitCode}`);
-      if (runResult.parsed) log(`  실행 결과: ${runResult.parsed.num}/${runResult.parsed.denom} ${runResult.parsed.num === runResult.parsed.denom ? 'passed' : 'partial'}`);
-      else log(`  (pass/fail 비율을 stdout에서 파싱 못함)`);
+      if (runResult.parsed) log(t(`  실행 결과: ${runResult.parsed.num}/${runResult.parsed.denom} ${runResult.parsed.num === runResult.parsed.denom ? 'passed' : 'partial'}`, `  result: ${runResult.parsed.num}/${runResult.parsed.denom} ${runResult.parsed.num === runResult.parsed.denom ? 'passed' : 'partial'}`));
+      else log(t(`  (pass/fail 비율을 stdout에서 파싱 못함)`, `  (could not parse pass/fail ratio from stdout)`));
       runTestsOk = runResult.allPassed;
       if (declaredPass && runResult.parsed) {
         declaredPassMatchesActual = (runResult.parsed.num === declaredPass.num && runResult.parsed.denom === declaredPass.denom);
-        log(`  주장 vs 실행: ${declaredPassMatchesActual ? '✓ 일치' : `⚠ 불일치 (주장 ${declaredPass.num}/${declaredPass.denom} ≠ 실행 ${runResult.parsed.num}/${runResult.parsed.denom})`}`);
+        log(t(`  주장 vs 실행: ${declaredPassMatchesActual ? '✓ 일치' : `⚠ 불일치 (주장 ${declaredPass.num}/${declaredPass.denom} ≠ 실행 ${runResult.parsed.num}/${runResult.parsed.denom})`}`, `  claimed vs run: ${declaredPassMatchesActual ? '✓ match' : `⚠ mismatch (claimed ${declaredPass.num}/${declaredPass.denom} ≠ run ${runResult.parsed.num}/${runResult.parsed.denom})`}`));
       }
     }
   }
@@ -10177,76 +10253,76 @@ function verifyClaimCmd(root, taskId) {
   log('');
   const allFilesOk = filesAllExist;
   const testOk = declaredTestCount == null || actualTestCount == null || actualTestCount >= declaredTestCount;
-  log(`## 종합`);
-  log(`  - 파일 모두 존재: ${allFilesOk ? '✓ pass' : '✗ FAIL (일부 누락)'}`);
+  log(t(`## 종합`, `## Summary`));
+  log(`  - ${t('파일 모두 존재', 'all files exist')}: ${allFilesOk ? '✓ pass' : t('✗ FAIL (일부 누락)', '✗ FAIL (some missing)')}`);
   // 1.17.4 (UR-0047): 측정 불가는 '통과' 가 아니라 '검증 미수행' — 이전엔 실측 0 인데 ✓ pass(실측≥주장) 모순 표기.
-  log(`  - 테스트 카운트: ${declaredTestCount == null ? '⊘ (주장 없음)' : !testMeasured ? `⊘ 측정 불가 — 주장 ${declaredTestCount}개 검증 미수행 (pass 아님)` : testOk ? '✓ pass (실측 ≥ 주장)' : '⚠ 주장보다 적음'}`);
+  log(`  - ${t('테스트 카운트', 'test count')}: ${declaredTestCount == null ? t('⊘ (주장 없음)', '⊘ (none claimed)') : !testMeasured ? t(`⊘ 측정 불가 — 주장 ${declaredTestCount}개 검증 미수행 (pass 아님)`, `⊘ not measurable — claimed ${declaredTestCount} not verified (not a pass)`) : testOk ? t('✓ pass (실측 ≥ 주장)', '✓ pass (measured ≥ claimed)') : t('⚠ 주장보다 적음', '⚠ fewer than claimed')}`);
   if (runResult && !runResult.skipped) {
-    log(`  - ${runResult.cmd || 'npm test'} 실행: ${runTestsOk ? '✓ all passed' : '✗ FAIL'}`);
-    if (declaredPass) log(`  - 주장과 실행 결과 일치: ${declaredPassMatchesActual ? '✓ pass' : '⚠ 다름'}`);
+    log(`  - ${runResult.cmd || 'npm test'} ${t('실행', 'run')}: ${runTestsOk ? '✓ all passed' : '✗ FAIL'}`);
+    if (declaredPass) log(`  - ${t('주장과 실행 결과 일치', 'claimed matches run')}: ${declaredPassMatchesActual ? '✓ pass' : t('⚠ 다름', '⚠ differs')}`);
   }
   // 1.11.2 (UR-0175): optimism+정직성 — done 주장은 기본 게이팅(claimsChecked). 완화: --lenient.
   if (claimsChecked) {
-    if (strictOk) log(`  - 낙관적 표시 + 정직성 (done 기본): ✓ pass (의심 없음)`);
+    if (strictOk) log(t(`  - 낙관적 표시 + 정직성 (done 기본): ✓ pass (의심 없음)`, `  - optimism + honesty (done default): ✓ pass (no suspicion)`));
     else {
-      log(`  - 낙관적 표시 + 정직성 (done 기본 — 완화: --lenient): ⚠ FAIL (낙관 ${optimismSuspects.length} · 정직성 ${honestyFindings.length})`);
-      for (const s of optimismSuspects) log(`    · [${s.kind}] ${s.label}: evidence에 주장 있는데 코드에 호출 흔적 없음`);
-      for (const f of honestyFindings) log(`    · [정직성:${f.dim}] ${f.label}: ${f.detail}`);
+      log(t(`  - 낙관적 표시 + 정직성 (done 기본 — 완화: --lenient): ⚠ FAIL (낙관 ${optimismSuspects.length} · 정직성 ${honestyFindings.length})`, `  - optimism + honesty (done default — relax: --lenient): ⚠ FAIL (optimism ${optimismSuspects.length} · honesty ${honestyFindings.length})`));
+      for (const s of optimismSuspects) log(t(`    · [${s.kind}] ${s.label}: evidence에 주장 있는데 코드에 호출 흔적 없음`, `    · [${s.kind}] ${s.label}: claimed in evidence but no call trace in code`));
+      for (const f of honestyFindings) log(`    · [${t('정직성', 'honesty')}:${f.dim}] ${f.label}: ${f.detail}`);
     }
   }
   // 1.9.302 (UR-0042) + 1.11.2 (UR-0175): git diff 시맨틱 교차검증 — 주장 파일이 실제 git 변경에 있는가. gitClaimOk/gitStrongMismatch 는 상단 공유(done 기본 게이팅, --lenient 완화).
   if (gitChanged === null) {
-    log(`  - git diff 교차검증: ⊘ skip (git repo 아님 — 검증 불가)`);
+    log(`  - ${t('git diff 교차검증', 'git diff cross-check')}: ${t('⊘ skip (git repo 아님 — 검증 불가)', '⊘ skip (not a git repo — cannot verify)')}`);
   } else if (!gitApplicable) {
-    log(`  - git diff 교차검증: ⊘ skip (working tree 변경 0 또는 주장 파일 0 — 이미 커밋됐거나 해당 없음)`);
+    log(`  - ${t('git diff 교차검증', 'git diff cross-check')}: ${t('⊘ skip (working tree 변경 0 또는 주장 파일 0 — 이미 커밋됐거나 해당 없음)', '⊘ skip (no working-tree changes or no claimed files — already committed or N/A)')}`);
   } else {
-    log(`  - git diff 교차검증: ${gitStrongMismatch ? '⚠ 불일치' : '✓'} 주장 ${files.length}개 중 실제 변경 ${claimedInGit.length}개${claimedNotInGit.length ? ` · git 변경에 없음: ${claimedNotInGit.slice(0, 5).join(', ')}` : ''}`);
-    if (gitStrongMismatch) log(`    · 주장한 파일이 working tree/직전커밋 변경에 전무 — 변경이 더 오래전 커밋이거나, 실제로 변경 안 됐을 수 있음(허위완료 의심)${has('--strict-claims') ? ' → FAIL' : ' (advisory — 커밋 후 검증 시 정상일 수 있음)'}`);
+    log(`  - ${t('git diff 교차검증', 'git diff cross-check')}: ${gitStrongMismatch ? t('⚠ 불일치', '⚠ mismatch') : '✓'} ${t(`주장 ${files.length}개 중 실제 변경 ${claimedInGit.length}개`, `${claimedInGit.length} of ${files.length} claimed actually changed`)}${claimedNotInGit.length ? t(` · git 변경에 없음: ${claimedNotInGit.slice(0, 5).join(', ')}`, ` · not in git changes: ${claimedNotInGit.slice(0, 5).join(', ')}`) : ''}`);
+    if (gitStrongMismatch) log(`    · ${t('주장한 파일이 working tree/직전커밋 변경에 전무 — 변경이 더 오래전 커밋이거나, 실제로 변경 안 됐을 수 있음(허위완료 의심)', 'claimed files are absent from working-tree/last-commit changes — changed in an older commit, or not actually changed (false-done suspected)')}${has('--strict-claims') ? ' → FAIL' : t(' (advisory — 커밋 후 검증 시 정상일 수 있음)', ' (advisory — may be normal when verifying after commit)')}`);
     // 1.13.2 (Karpathy 가이드라인 3 "외과적 변경", UR-0030): scope-creep 표면화 — git 변경됐으나 evidence/주장에 없는 파일.
-    if (changedNotClaimed.length) log(`    · 🔬 외과적 변경 점검: git 에 변경됐으나 evidence/주장에 없는 파일 ${changedNotClaimed.length}건: ${changedNotClaimed.slice(0, 5).join(', ')}${changedNotClaimed.length > 5 ? ' …' : ''} — 요청 범위 밖 변경(scope creep)인지 확인 (advisory)`);
+    if (changedNotClaimed.length) log(`    · ${t(`🔬 외과적 변경 점검: git 에 변경됐으나 evidence/주장에 없는 파일 ${changedNotClaimed.length}건: ${changedNotClaimed.slice(0, 5).join(', ')}${changedNotClaimed.length > 5 ? ' …' : ''} — 요청 범위 밖 변경(scope creep)인지 확인 (advisory)`, `🔬 surgical-change check: ${changedNotClaimed.length} file(s) changed in git but not in evidence/claim: ${changedNotClaimed.slice(0, 5).join(', ')}${changedNotClaimed.length > 5 ? ' …' : ''} — check for scope creep (advisory)`)}`);
   }
   // 1.9.309 (UR-0048): done 주장 evidence 완전성 — 기본 강제(상단 pre-compute). --lenient 로 opt-out.
   if (mustHaveEvidence) {
-    log(`  - evidence 완전성 (done 기본 강제): ${evidenceQualityOk ? '✓ pass (파일+테스트 근거 있음)' : `✗ FAIL (누락: ${evq.missing.join(', ')})`}`);
-    if (!evidenceQualityOk) log(`    · done 주장은 수정 파일 경로 + 테스트명/개수 가 evidence 에 있어야 함 (테스트 통과만으로는 불충분). 완화: --lenient`);
+    log(`  - ${t('evidence 완전성 (done 기본 강제)', 'evidence completeness (done default)')}: ${evidenceQualityOk ? t('✓ pass (파일+테스트 근거 있음)', '✓ pass (file + test evidence present)') : `✗ FAIL ${t(`(누락: ${evq.missing.join(', ')})`, `(missing: ${evq.missing.join(', ')})`)}`}`);
+    if (!evidenceQualityOk) log(`    · ${t('done 주장은 수정 파일 경로 + 테스트명/개수 가 evidence 에 있어야 함 (테스트 통과만으로는 불충분). 완화: --lenient', 'a done claim needs changed-file paths + test name/count in evidence (passing tests alone is insufficient). relax: --lenient')}`);
   }
   // 1.17.3 (UR-0046): 구현 실체(스텁) + 테스트-구현 연결 — Attack C(주석뿐 구현+assert(true)) 차단.
   if (stubFiles.length) {
-    log(`  - 구현 실체 (done 기본): ✗ FAIL — 주장된 구현 파일이 주석/빈껍데기뿐: ${stubFiles.slice(0, 5).join(', ')} (비주석 코드 0줄 또는 빈 export 껍데기)`);
+    log(`  - ${t('구현 실체 (done 기본)', 'implementation substance (done default)')}: ${t(`✗ FAIL — 주장된 구현 파일이 주석/빈껍데기뿐: ${stubFiles.slice(0, 5).join(', ')} (비주석 코드 0줄 또는 빈 export 껍데기)`, `✗ FAIL — claimed impl files are comments/empty shells only: ${stubFiles.slice(0, 5).join(', ')} (0 non-comment code lines or empty export shell)`)}`);
   } else if (claimsChecked && _vcImpl.length) {
-    log(`  - 구현 실체 (done 기본): ✓ pass (주장 구현 파일에 실코드 존재)`);
+    log(`  - ${t('구현 실체 (done 기본)', 'implementation substance (done default)')}: ${t('✓ pass (주장 구현 파일에 실코드 존재)', '✓ pass (real code present in claimed impl files)')}`);
   }
   if (testLinkOk === false) {
-    log(`  - 테스트-구현 연결: ⚠ 주장된 테스트(${_vcTests.slice(0, 3).join(', ')})가 구현 파일을 참조하지 않음 — 빈 테스트(assert(true)) 의심${has('--strict-claims') ? ' → FAIL' : ' (advisory — --strict-claims 시 FAIL)'}`);
+    log(`  - ${t('테스트-구현 연결', 'test-impl link')}: ${t(`⚠ 주장된 테스트(${_vcTests.slice(0, 3).join(', ')})가 구현 파일을 참조하지 않음 — 빈 테스트(assert(true)) 의심`, `⚠ claimed test(s) (${_vcTests.slice(0, 3).join(', ')}) do not reference the impl file — empty test (assert(true)) suspected`)}${has('--strict-claims') ? ' → FAIL' : t(' (advisory — --strict-claims 시 FAIL)', ' (advisory — FAIL under --strict-claims)')}`);
   } else if (testLinkOk === true && claimsChecked) {
-    log(`  - 테스트-구현 연결: ✓ pass (테스트가 구현을 참조)`);
+    log(`  - ${t('테스트-구현 연결', 'test-impl link')}: ${t('✓ pass (테스트가 구현을 참조)', '✓ pass (test references the impl)')}`);
   }
   const overallFail = !allFilesOk || !testOk || (runResult && !runResult.skipped && !runTestsOk) || (claimsChecked && !strictOk) || !evidenceQualityOk || !gitClaimOk || (claimsChecked && stubFiles.length > 0) || (has('--strict-claims') && testLinkOk === false);
   // 1.9.287: 정직한 한계 고지 — 테스트 통과 ≠ 의미적 구현 정확성
   if (claimsChecked || mustHaveEvidence) {
     log('');
-    log(`  ℹ 한계: 테스트 통과는 "의미적 구현 정확성"을 보장하지 않음 — evidence 가 해당 주장(수정 파일/테스트)을 직접 링크해야 신뢰도↑.`);
+    log(t(`  ℹ 한계: 테스트 통과는 "의미적 구현 정확성"을 보장하지 않음 — evidence 가 해당 주장(수정 파일/테스트)을 직접 링크해야 신뢰도↑.`, `  ℹ Limit: passing tests do not guarantee "semantic correctness" — evidence should directly link the claimed files/tests for higher confidence.`));
     // 1.19.2 (UR-0003 렌즈 완전판 v2): 완료-검증 순간에 분야별 자기질문 advisory — 주장 파일 확장자 기반(결정적).
     //   기계검증(파일/테스트/스텁)을 통과해도 "사람이 보기에 좋은가"는 별개 → AI 가 스스로 답하도록 권장(advisory, 게이트 아님).
     const _lensDoms = _lensDomainsForFiles(files);
     if (_lensDoms.length) {
       const _lensCat = _effectiveLensCatalog(root);  // 1.19.3: 프로젝트 커스텀 질문도 포함
       log('');
-      log(`  🧭 품질 렌즈 (완료 선언 전 자문 — advisory, 게이트 아님):`);
+      log(t(`  🧭 품질 렌즈 (완료 선언 전 자문 — advisory, 게이트 아님):`, `  🧭 Quality lens (self-ask before declaring done — advisory, not a gate):`));
       for (const d of _lensDoms) {
         const l = _lensCat[d];
         if (l) log(`     · ${d}(${l.title}): ${l.questions[0]}`);
       }
-      log(`     → 전체 질문: leerness lens ${_lensDoms[0]}`);
+      log(`     ${t('→ 전체 질문', '→ full questions')}: leerness lens ${_lensDoms[0]}`);
     }
   }
   if (overallFail) {
     log('');
-    log(`  ⚠ evidence 주장과 실제가 일치하지 않음 — task 상태 재검토 권장`);
+    log(t(`  ⚠ evidence 주장과 실제가 일치하지 않음 — task 상태 재검토 권장`, `  ⚠ evidence claim does not match reality — review the task status`));
     return process.exit(1);
   }
   log('');
-  log(`  ✓ evidence 주장이 실제 파일·테스트${runResult && !runResult.skipped ? '·실행 결과' : ''}와 일치`);
+  log(t(`  ✓ evidence 주장이 실제 파일·테스트${runResult && !runResult.skipped ? '·실행 결과' : ''}와 일치`, `  ✓ evidence claim matches actual files·tests${runResult && !runResult.skipped ? '·run results' : ''}`));
 }
 
 // 1.9.22: orchestrate — Ollama 로컬 LLM으로 best-of-N 멀티 에이전트 시뮬
@@ -11611,43 +11687,46 @@ function _banner(opts = {}) {
       cprint('    ' + C.green(padded) + C.dim('# ' + desc));
     };
 
+    // 1.20.2 (UR-0010 Phase 1): 첫 화면 배너 — UI 언어(한국어 우선, 영어 opt-in) 적용.
+    const L = _uiLang(arg('--path', process.cwd()));
+    const t = (ko, en) => (L === 'en' ? en : ko);
     cprint('');
-    cprint(C.bold(C.cyan('  ✨ 시작하기 (3단계면 끝)')));
-    cmd('npx leerness init .',         '1️⃣  하네스 설치 + AI 도구 자동 연결');
-    cmd('npx leerness handoff .',      '2️⃣  세션 시작 — 컨텍스트·기억·feature impact 자동 회수');
-    cmd('npx leerness session close .', '3️⃣  세션 종료 — 마감 통계 + 다음 라운드 추천');
-
-    section('🧠 메모리 5종 CRUD (1.9.142 — cascade 방지)');
-    cmd('leerness task add "<제목>"',         'progress-tracker 등록');
-    cmd('leerness decision add "<제목>" --reason "..."', '되돌리기 어려운 결정 영구화');
-    cmd('leerness lesson save "<교훈>" --tag "..."',     '재발견 가능한 통찰 저장');
-    cmd('leerness plan add "<milestone>"',     '계획 단계 등록');
-    cmd('leerness rule add "<룰>" --trigger every-X',    '자연어 영구 룰');
-    cmd('leerness feature add "<기능>" --files "..."',   'Feature Graph 노드 (1.9.141)');
-
-    section('🔗 인과관계 + 영향 추적 (1.9.141~143)');
-    cmd('leerness feature impact <F-XXXX>',  '코드 변경 전 영향받는 feature 자동 회수');
-    cmd('leerness feature list --json',      '전체 그래프 + 엣지');
-    cmd('leerness audit . --json',           'orphan/cycle 무결성 검증');
-
-    section('🛡 보안·드리프트·게으름 가드');
-    cmd('leerness drift check . --auto-fix', 'drift + 보안 자동 회복');
-    cmd('leerness lazy detect . --json',     '거짓 완료/no test run 감지');
-    cmd('leerness env sync .',               '.env ↔ .env.example 동기화');
-    cmd('leerness health . --json',          '종합 헬스 (drift+보안+skill+feature)');
-
-    section(`🤖 외부 AI 통합 (MCP ${_mcpToolCount()} 도구)`);  // 1.9.315 (UR-0054): 하드코딩 46 → 동적
+    cprint(C.bold(C.cyan(t('  ✨ 시작하기 (3단계면 끝)', '  ✨ Get started (3 steps)'))));
+    cmd('npx leerness init .',         t('1️⃣  하네스 설치 + AI 도구 자동 연결', '1️⃣  install the harness + auto-wire AI tools'));
+    cmd('npx leerness handoff .',      t('2️⃣  세션 시작 — 컨텍스트·기억·feature impact 자동 회수', '2️⃣  start a session — context, memory, feature impact in one call'));
+    cmd('npx leerness session close .', t('3️⃣  세션 종료 — 마감 통계 + 다음 라운드 추천', '3️⃣  end a session — closing stats + next-round suggestion'));
+
+    section(t('🧠 메모리 5종 CRUD (1.9.142 — cascade 방지)', '🧠 Memory (5 surfaces)'));
+    cmd('leerness task add "<title>"',         t('progress-tracker 등록', 'add a task to progress-tracker'));
+    cmd('leerness decision add "<title>" --reason "..."', t('되돌리기 어려운 결정 영구화', 'persist a hard-to-reverse decision'));
+    cmd('leerness lesson save "<lesson>" --tag "..."',     t('재발견 가능한 통찰 저장', 'save a rediscoverable insight'));
+    cmd('leerness plan add "<milestone>"',     t('계획 단계 등록', 'add a plan milestone'));
+    cmd('leerness rule add "<rule>" --trigger every-X',    t('자연어 영구 룰', 'natural-language standing rule'));
+    cmd('leerness feature add "<feature>" --files "..."',   t('Feature Graph 노드 (1.9.141)', 'Feature Graph node'));
+
+    section(t('🔗 인과관계 + 영향 추적 (1.9.141~143)', '🔗 Causality + impact tracking'));
+    cmd('leerness feature impact <F-XXXX>',  t('코드 변경 전 영향받는 feature 자동 회수', 'which features a code change affects'));
+    cmd('leerness feature list --json',      t('전체 그래프 + 엣지', 'full graph + edges'));
+    cmd('leerness audit . --json',           t('orphan/cycle 무결성 검증', 'orphan/cycle integrity check'));
+
+    section(t('🛡 보안·드리프트·게으름 가드', '🛡 Security · drift · laziness guards'));
+    cmd('leerness drift check . --auto-fix', t('drift + 보안 자동 회복', 'drift + security auto-heal'));
+    cmd('leerness lazy detect . --json',     t('거짓 완료/no test run 감지', 'detect false-done / no-test-run'));
+    cmd('leerness env sync .',               t('.env ↔ .env.example 동기화', 'sync .env <-> .env.example'));
+    cmd('leerness health . --json',          t('종합 헬스 (drift+보안+skill+feature)', 'overall health (drift+security+skill+feature)'));
+
+    section(t(`🤖 외부 AI 통합 (MCP ${_mcpToolCount()} 도구)`, `🤖 External AI integration (MCP, ${_mcpToolCount()} tools)`));  // 1.9.315 (UR-0054): 하드코딩 46 → 동적
     cmd('npx leerness mcp serve',                 'stdio JSON-RPC server');
-    cmd('leerness memory status . --json',        '5 surface + featureGraph 한 호출');
-    cmd('leerness memory archive list --query "kw"', 'DELETE 5종 archive 검색');
-    cmd('leerness memory restore <surface> <target>', 'archive → active 복원');
+    cmd('leerness memory status . --json',        t('5 surface + featureGraph 한 호출', '5 surfaces + featureGraph in one call'));
+    cmd('leerness memory archive list --query "kw"', t('DELETE 5종 archive 검색', 'search the archive of deleted items'));
+    cmd('leerness memory restore <surface> <target>', t('archive → active 복원', 'restore archive -> active'));
 
-    section('🚀 Release 자동화');
-    cmd('leerness release pack --close --auto-main-push', '한 줄 release (1.9.140 main push 통합)');
-    cmd('leerness release sync-main .',          'release branch → main 자동 fast-forward');
+    section(t('🚀 Release 자동화', '🚀 Release automation'));
+    cmd('leerness release pack --close --auto-main-push', t('한 줄 release (1.9.140 main push 통합)', 'one-line release (with main push)'));
+    cmd('leerness release sync-main .',          t('release branch → main 자동 fast-forward', 'release branch -> main fast-forward'));
 
     cprint('');
-    cprint(C.dim('  📚 자세히: `leerness --help` · 자율 모드: `<<autonomous-loop-dynamic>>` 신호로 진행'));
+    cprint(C.dim(t('  📚 자세히: `leerness --help` · 자율 모드: `<<autonomous-loop-dynamic>>` 신호로 진행', '  📚 More: `leerness --help`')));
     cprint('');
   }
 }
@@ -20022,7 +20101,7 @@ module.exports = {
   // 1.9.289: shell-safe 인용 (Codex #3) — 단위 테스트
   _shellQuoteArg,
   // 1.18.1: 명령 실행 권한 결정 (재실증 신규 P1: --test-cmd 비-JS 인터프리터 거짓차단) — 단위 테스트
-  _isCommandPermitted, RUN_CORE_ALLOW,
+  _isCommandPermitted, RUN_CORE_ALLOW, _uiLang, _tx,
   // 1.18.2: verify-claim 위장 스텁(빈 export 껍데기) 판정 — 단위 테스트
   _vcImplIsEmpty, _VC_EMPTY_SHELL_RE,
   // 1.18.3 (UR-0003): 분야별 자기질문 품질 렌즈 — 단위 테스트. 1.19.2: 파일→도메인 매핑(완료-검증 advisory)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",