leerness 1.20.0 → 1.21.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # 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.21.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.21.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.21.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.21.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.21.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}`;
 }
@@ -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,25 @@ 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: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -4326,7 +4372,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('');
@@ -8467,7 +8513,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 +9940,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) {
@@ -11611,43 +11671,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 +20085,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.21.0",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",