leerness 1.28.0 → 1.29.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 1.29.0 — 2026-06-16 — 🛡️ [안정화/Stable] drift auto-fix·진단 명령 영어화 안정 minor
+
+**🛡️ 안정화(Stable) minor — drift 완전 영어화(버그수정 포함) + 진단 3종 영어화를 npm 공개.** 직전 minor(1.28.0) 이후 누적된 패치 2건(1.28.1 + 1.28.2)을 검증·통합해 배포. R-0011 정책의 20번째 stable minor. 한국어 우선 기본은 그대로.
+
+### 이번 minor 통합 (1.28.1~1.28.2)
+- **🐛+🌐 drift --auto-fix 영어화 + 보안신호 판정 버그수정 (1.28.1)**: 1.27.2 가 보안 신호 라벨을 언어화하며 내부 `hasSecurityFired` 가 한국어 라벨 정규식에 결합돼 `--language en` 에서 보안 auto-fix 가 미발동하던 잠복 버그를 언어-안정 필드(`f.file`)로 수정. drift `--auto-fix` 진행 로그 ~21줄 영어화 → `drift check` 완전 영어(출력 + auto-fix).
+- **🌐 진단 모듈 영어화 (1.28.2)**: `doctor`(설치/환경)·`which`(버전 충돌·npx 캐시)·`whats-new`(CHANGELOG 차분) 3종을 영어 opt-in. 기존 위임 가드 보존.
+- **한국어 우선 기본 보존**: 영어는 명시 opt-in. 한국어 출력/내부 호출 무영향(e2e 무회귀).
+
+### 잔여 (UR-0010 백로그)
+- capabilities/commands/constraints/install-safety 영어화 · init en seed 템플릿 i18n.
+
+### 검증 (회귀 0)
+- **selftest 250/250** · **E2E 368/368** (i18n 행위가드 lens/health/drift/doctor en/ko) · 게시본 클린룸 재실증.
+- minor(1.29.0) — npm 배포(R-0011 stable) + annotated tag(Stable) + GitHub release(latest).
+
+## 1.28.2 — 2026-06-16 — CLI 영어화 Phase 10c: 진단 모듈(doctor/which/whats-new) 완전 영어화 (UR-0010)
+
+**🌐 설치/버전 진단 3종을 영어로.** 문제 해결 시 자주 쓰는 진단 명령 `doctor`(설치/환경)·`which`(버전 충돌·npx 캐시)·`whats-new`(버전 변경 요약)를 한 모듈(lib/diagnostics.js)에서 완전 영어화.
+
+### 변경 (UR-0010 Phase 10c)
+- **lib/diagnostics.js 3 명령 영어화 (DI uiLang)**: doctor(설치/환경 진단·설치 경로·MCP 도구·selftest 통과/실패·셸·정상/문제), which(현재 실행·버전·npm 환경·글로벌 설치·PATH 후보·진단·강제 최신 방법), whats-new(버전 파악 실패/CHANGELOG 없음 에러·신규 명령·플래그·파일·버전별 헤드라인·권장 행동). `t(ko,en)`, ko 인자 verbatim.
+- **3 DI 호출에 uiLang 주입**: doctorCmd/whichCmd(`_uiLang(arg('--path', cwd))`) + whatsNewCmd(`_uiLang(root)`). 기존 1.9.392/1.9.394 위임 가드 문자열 보존(selftest 무회귀).
+- **한국어 기본 유지**: 영어는 명시 opt-in. ko/내부 호출 무영향.
+
+### 잔여 (UR-0010 백로그)
+- capabilities/commands/constraints/install-safety 영어화 · init en seed 템플릿 i18n.
+
+### 검증 (회귀 0)
+- **selftest 249→250** (진단 영어/한국어 보존 + uiLang 주입 소스가드) · 행위(doctor/which/whats-new `--language en` 한글 0 [Node 탐지] / ko 보존) · **E2E 368/368** (i18n 행위가드에 doctor en/ko 추가).
+- patch(1.28.2) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
+## 1.28.1 — 2026-06-16 — Phase 10b: drift --auto-fix 로그 영어화 + 보안신호 판정 버그 수정 (UR-0010)
+
+**🐛+🌐 drift 를 완전 영어로 + 직전 라운드가 심은 버그 수정.** `drift check --auto-fix` 진행 로그를 영어화하면서, 1.27.2 가 보안 신호 라벨을 언어화하며 함께 심은 **내부 판정 버그**를 발견·수정.
+
+### 변경
+- **🐛 hasSecurityFired 언어-결합 버그 수정**: 1.27.2 에서 보안 신호 `label` 을 `t(ko,en)` 로 언어화했는데, 내부 `hasSecurityFired` 가 한국어 라벨 정규식(`/보안 위험 \(1\.9\.78\)/`)으로 매칭하고 있어 **`drift check --auto-fix --language en` 에서 보안 auto-fix 가 발동하지 않던** 잠복 버그. 언어-안정 필드(`f.file === '.env / .gitignore'`)로 매칭 변경 → en/ko 모두 정상 발동. (번역된 라벨에 내부 로직이 결합되면 안 된다는 교훈 — [[lesson-adversarial-harden-heuristic]] 의 'valueGroup' 류와 동일.)
+- **🌐 drift --auto-fix 로그 영어화 (~21줄)**: 보안/인코딩/delivered/idempotency/release-cleanup/session-close 자동회복 진행 로그를 `t(ko,en)`. 이로써 `drift check` 가 **완전히** 영어 지원(출력 + auto-fix).
+- **한국어 기본 유지**: 영어는 명시 opt-in. ko 로그/내부 호출 무영향.
+
+### 검증 (회귀 0)
+- **selftest 248→249** (afLog 영어/한국어 + 버그수정 소스가드) · 행위(보안 auto-fix en/ko 모두 발동 + en 로그 한글 0 [Node 탐지] + ko 보존) · **E2E 368/368**.
+- patch(1.28.1) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
 ## 1.28.0 — 2026-06-15 — 🛡️ [안정화/Stable] 정직성 후속 + drift 영어화 안정 minor
 
 **🛡️ 안정화(Stable) minor — 13번째 외부리뷰 정직성 수정 + drift 진단 영어화를 npm 공개.** 직전 minor(1.27.0) 이후 누적된 패치 2건(1.27.1 + 1.27.2)을 검증·통합해 배포. R-0011 정책의 19번째 stable minor. 한국어 우선 기본은 그대로.

package/README.md

@@ -104,7 +104,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.28.0 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.29.0 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -158,7 +158,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.28.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.29.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -179,7 +179,7 @@ Leerness v1.28.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.28.0)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.29.0)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -217,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.28.0: 2026-06-16
+Last synced by Leerness v1.29.0: 2026-06-16
 <!-- 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.28.0';
+const VERSION = '1.29.0';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3836,6 +3836,21 @@ function _selfTestCases() {
       const koPreserved = dr.includes('| 신호 | age | 임계 | 가중치 | 발화 |') && dr.includes('session close 누락') && dr.includes('권장 조치');  // ko 인자 보존(e2e ko/내부호출)
       return injected && en && koPreserved;
     } },
+    { name: 'Phase 10b (1.28.1): drift --auto-fix 로그 영어화 + hasSecurityFired 언어안정 매칭 (소스 가드)', run: () => {
+      const dr = read(path.join(path.dirname(__filename), '..', 'lib', 'drift.js'));
+      const bugFix = dr.includes("f.file === '.env / .gitignore'");  // 보안 신호 판정을 언어-안정 file 필드로(라벨 regex 결합 제거)
+      const afLogEn = dr.includes('recovering security signal: running audit --fix') && dr.includes('re-checking...') && dr.includes('auto-fix error:');
+      const afLogKo = dr.includes('보안 신호 회복: audit --fix 자동 실행 중') && dr.includes('재검사 중...');  // ko 인자 보존
+      return bugFix && afLogEn && afLogKo;
+    } },
+    { name: 'Phase 10c (1.28.2): 진단 모듈(doctor/which/whats-new) 영어/한국어 보존 + uiLang 주입 (소스 가드)', run: () => {
+      const bin = read(__filename);
+      const dg = read(path.join(path.dirname(__filename), '..', 'lib', 'diagnostics.js'));
+      const injected = bin.includes("uiLang: _uiLang(arg('--path', process.cwd())), _selfTestCases") && bin.includes('_diag.whatsNewCmd(root, { VERSION, uiLang: _uiLang(root)');
+      const en = dg.includes('install/environment diagnosis') && dg.includes('## npm environment') && dg.includes('per-version headlines') && dg.includes('how to force the latest');
+      const koPreserved = dg.includes('설치/환경 진단') && dg.includes('## npm 환경') && dg.includes('버전별 헤드라인');  // ko 인자 보존(내부호출/e2e)
+      return injected && en && koPreserved;
+    } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -16115,7 +16130,7 @@ function mcpServeCmd(root) {
 }
 
 // 1.9.394 (UR-0025): whatsNewCmd 를 lib/diagnostics.js 로 분리 (whats-new 서브시스템 완결 — 파서는 1.9.393 에 pure-utils 로). deps 위임.
-function whatsNewCmd(root) { return _diag.whatsNewCmd(root, { VERSION, arg, has }); }
+function whatsNewCmd(root) { return _diag.whatsNewCmd(root, { VERSION, uiLang: _uiLang(root), arg, has }); }
 
 // 1.9.71: .env / .env.example 자동 동기화 — 누락 키 감지 + (옵션) 자동 추가
 // 보안 정책: .env의 실제 값은 절대 옮기지 않음. .env.example엔 키만 (빈 값).
@@ -19734,8 +19749,8 @@ function reviewRequestCmd(root, request) { return _reviewRequest.reviewRequestCm
 // 1.9.392 (UR-0025 큰 핸들러 모듈화 4번째): doctor/which 진단 핸들러를 lib/diagnostics.js 로 분리.
 //   harness 는 deps(VERSION · _selfTestCases · _detectShellCtx · _mcpToolCount · has · harnessPath)를 구성해 위임(thin wrapper). 호출부/동작 무변경.
 const _diag = require('../lib/diagnostics');
-function doctorCmd(opts = {}) { return _diag.doctorCmd(opts, { VERSION, _selfTestCases, _detectShellCtx, _mcpToolCount, has, harnessPath: __filename }); }
-function whichCmd() { return _diag.whichCmd({ VERSION, has, harnessPath: __filename }); }
+function doctorCmd(opts = {}) { return _diag.doctorCmd(opts, { VERSION, uiLang: _uiLang(arg('--path', process.cwd())), _selfTestCases, _detectShellCtx, _mcpToolCount, has, harnessPath: __filename }); }
+function whichCmd() { return _diag.whichCmd({ VERSION, uiLang: _uiLang(arg('--path', process.cwd())), has, harnessPath: __filename }); }
 
 // 1.23.1 (UR-0010 Phase 6): 영어 큐레이트 도움말 — 한국어 help 의 줄별 번역이 아니라, 카테고리별로 정리한 별도 영어판.
 //   레거시 버전태그(1.9.x) 군더더기를 빼고 영어 사용자가 읽기 쉽게. 전체 전수 목록은 `leerness commands`.

package/lib/diagnostics.js

@@ -10,7 +10,8 @@ const { log, fail, absRoot, exists, read } = require('./io');
 const { parseHarnessVersion, _parseChangelogBetween } = require('./pure-utils');
 
 function doctorCmd(opts = {}, deps = {}) {
-  const { VERSION, _selfTestCases, _detectShellCtx, _mcpToolCount, has, harnessPath } = deps;
+  const { VERSION, uiLang, _selfTestCases, _detectShellCtx, _mcpToolCount, has, harnessPath } = deps;
+  const t = (ko, en) => (uiLang === 'en' ? en : ko);  // 1.28.2 (UR-0010 Phase 10c)
   const json = opts.json || has('--json');
   // 1) 코어 무결성: selftest 케이스 인라인 실행
   let pass = 0; const failNames = [];
@@ -35,23 +36,24 @@ function doctorCmd(opts = {}, deps = {}) {
   if (json) { process.stdout.write(JSON.stringify(report, null, 2) + '\n'); if (!report.healthy) process.exitCode = 1; return report; }
   const isTty = process.stdout && process.stdout.isTTY;
   const gr = s => isTty ? `\x1b[32m${s}\x1b[0m` : s, rd = s => isTty ? `\x1b[31m${s}\x1b[0m` : s, cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s, dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
-  log(cy(`# leerness doctor — 설치/환경 진단`));
+  log(cy(t(`# leerness doctor — 설치/환경 진단`, `# leerness doctor — install/environment diagnosis`)));
   log('');
   log(`  ${gr('✓')} version ${VERSION} · node ${process.version} · ${process.platform}/${process.arch}`);
-  log(`  ${gr('✓')} 설치 경로: ${dm(harnessPath)}`);
-  log(`  ${gr('✓')} MCP 도구: ${mcpCount}`);
+  log(`  ${gr('✓')} ${t('설치 경로', 'install path')}: ${dm(harnessPath)}`);
+  log(`  ${gr('✓')} ${t('MCP 도구', 'MCP tools')}: ${mcpCount}`);
   // 1.13.1 (15th 블라인드 리뷰 P3, Sonnet): pass 수에 '실패' 가 붙어 "209/210 실패"(=209건 실패로 오독)되던 문구 → "통과 N/M (K건 실패)" 로 명확화.
-  log(`  ${report.selftest.ok ? gr('✓') : rd('✗')} selftest: ${pass}/${total} 통과${report.selftest.ok ? '' : ` (${total - pass}건 실패)`}`);
+  log(`  ${report.selftest.ok ? gr('✓') : rd('✗')} selftest: ${pass}/${total} ${t('통과', 'passed')}${report.selftest.ok ? '' : t(` (${total - pass}건 실패)`, ` (${total - pass} failed)`)}`);
   if (!report.selftest.ok) report.selftest.failed.slice(0, 5).forEach(n => log(rd(`     ✗ ${n}`)));
-  log(`  ${gr('✓')} 셸: ${shell || 'unknown'}${psVersion && shell === 'powershell' ? ` (PowerShell ${psVersion})` : ''}`);
+  log(`  ${gr('✓')} ${t('셸', 'shell')}: ${shell || 'unknown'}${psVersion && shell === 'powershell' ? ` (PowerShell ${psVersion})` : ''}`);
   log('');
-  log(report.healthy ? gr('  ✓ leerness 설치 정상') : rd('  ✗ 문제 감지 — 재설치: npm i -g leerness@latest · 진단: leerness which'));
+  log(report.healthy ? gr(t('  ✓ leerness 설치 정상', '  ✓ leerness install OK')) : rd(t('  ✗ 문제 감지 — 재설치: npm i -g leerness@latest · 진단: leerness which', '  ✗ problem detected — reinstall: npm i -g leerness@latest · diagnose: leerness which')));
   if (!report.healthy) process.exitCode = 1;
   return report;
 }
 
 function whichCmd(deps = {}) {
-  const { VERSION, has, harnessPath } = deps;
+  const { VERSION, uiLang, has, harnessPath } = deps;
+  const t = (ko, en) => (uiLang === 'en' ? en : ko);  // 1.28.2 (UR-0010 Phase 10c)
   const out = {
     version: VERSION,
     runningFrom: harnessPath,
@@ -91,48 +93,49 @@ function whichCmd(deps = {}) {
   // 진단: 글로벌 설치된 leerness 와 현재 실행 버전이 다르면 경고
   out.diagnostics = [];
   if (out.npm.globalInstalled && out.npm.globalInstalled !== VERSION) {
-    out.diagnostics.push(`⚠ 글로벌 설치 ${out.npm.globalInstalled} ≠ 현재 실행 ${VERSION} — npx 캐시 또는 PATH 충돌 의심`);
-    out.diagnostics.push(`  → 강제 최신: npm i -g leerness@latest  /  또는 npx --yes leerness@latest <command>`);
+    out.diagnostics.push(t(`⚠ 글로벌 설치 ${out.npm.globalInstalled} ≠ 현재 실행 ${VERSION} — npx 캐시 또는 PATH 충돌 의심`, `⚠ global install ${out.npm.globalInstalled} ≠ running ${VERSION} — suspect npx cache or PATH conflict`));
+    out.diagnostics.push(t(`  → 강제 최신: npm i -g leerness@latest  /  또는 npx --yes leerness@latest <command>`, `  → force latest: npm i -g leerness@latest  /  or npx --yes leerness@latest <command>`));
   }
   if (out.pathCandidates.length > 1) {
-    out.diagnostics.push(`⚠ PATH 에 leerness 가 ${out.pathCandidates.length}개 — 우선순위 충돌 가능`);
-    out.diagnostics.push(`  → 명시적 경로 사용: ${out.runningFrom}`);
+    out.diagnostics.push(t(`⚠ PATH 에 leerness 가 ${out.pathCandidates.length}개 — 우선순위 충돌 가능`, `⚠ leerness appears ${out.pathCandidates.length}× on PATH — possible precedence conflict`));
+    out.diagnostics.push(t(`  → 명시적 경로 사용: ${out.runningFrom}`, `  → use the explicit path: ${out.runningFrom}`));
   }
   if (has('--json')) { log(JSON.stringify(out, null, 2)); return; }
   log(`# leerness which (1.9.164)`);
-  log(`현재 실행: ${out.runningFrom}`);
-  log(`버전:      v${out.version}`);
+  log(`${t('현재 실행', 'running from')}: ${out.runningFrom}`);
+  log(`${t('버전', 'version')}:      v${out.version}`);
   log(`Node:      ${out.nodeVersion} (${out.platform}/${out.arch})`);
   log('');
-  log(`## npm 환경`);
+  log(t(`## npm 환경`, `## npm environment`));
   if (out.npm.globalRoot) log(`  npm root -g: ${out.npm.globalRoot}`);
-  if (out.npm.cacheDir)   log(`  npm cache:   ${out.npm.cacheDir}  (npx 옛 버전이 여기 캐싱 — 의심 시 \`npm cache clean --force\`)`);
-  if (out.npm.globalInstalled) log(`  글로벌 설치: leerness@${out.npm.globalInstalled}`);
-  else log(`  글로벌 설치: (없음 — npx 또는 로컬 경로만 사용 중)`);
+  if (out.npm.cacheDir)   log(t(`  npm cache:   ${out.npm.cacheDir}  (npx 옛 버전이 여기 캐싱 — 의심 시 \`npm cache clean --force\`)`, `  npm cache:   ${out.npm.cacheDir}  (npx caches old versions here — if suspect: \`npm cache clean --force\`)`));
+  if (out.npm.globalInstalled) log(t(`  글로벌 설치: leerness@${out.npm.globalInstalled}`, `  global install: leerness@${out.npm.globalInstalled}`));
+  else log(t(`  글로벌 설치: (없음 — npx 또는 로컬 경로만 사용 중)`, `  global install: (none — using npx or a local path only)`));
   if (out.pathCandidates.length) {
     log('');
-    log(`## PATH 후보 (${out.pathCandidates.length}개)`);
+    log(t(`## PATH 후보 (${out.pathCandidates.length}개)`, `## PATH candidates (${out.pathCandidates.length})`));
     for (const p of out.pathCandidates) log(`  - ${p}`);
   }
   if (out.diagnostics.length) {
     log('');
-    log(`## ⚠ 진단`);
+    log(t(`## ⚠ 진단`, `## ⚠ diagnostics`));
     for (const d of out.diagnostics) log(`  ${d}`);
   } else {
     log('');
-    log(`✓ 충돌 없음 (현재 실행 버전 = 글로벌 설치 버전)`);
+    log(t(`✓ 충돌 없음 (현재 실행 버전 = 글로벌 설치 버전)`, `✓ no conflict (running version = global install version)`));
   }
   log('');
-  log(`💡 강제 최신 실행 방법:`);
-  log(`  1) npx --yes leerness@latest <command>        # npx 캐시 무시하고 최신 다운로드`);
-  log(`  2) npm i -g leerness@latest                    # 글로벌 설치 갱신`);
-  log(`  3) npm cache clean --force                     # npx 캐시 강제 비우기 (의심 시)`);
+  log(t(`💡 강제 최신 실행 방법:`, `💡 how to force the latest:`));
+  log(t(`  1) npx --yes leerness@latest <command>        # npx 캐시 무시하고 최신 다운로드`, `  1) npx --yes leerness@latest <command>        # bypass npx cache, download latest`));
+  log(t(`  2) npm i -g leerness@latest                    # 글로벌 설치 갱신`, `  2) npm i -g leerness@latest                    # update the global install`));
+  log(t(`  3) npm cache clean --force                     # npx 캐시 강제 비우기 (의심 시)`, `  3) npm cache clean --force                     # force-clear the npx cache (if suspect)`));
 }
 
 // 1.9.394 (UR-0025): whats-new — 현재 워크스페이스 버전 → 도구 버전 CHANGELOG 차분(신규 명령/플래그/파일 요약). introspection 핸들러.
 //   순수 파서 _parseChangelogBetween(pure-utils) 사용. deps: VERSION/arg/has. CHANGELOG 경로는 root 우선, 없으면 pkg 자체(lib/../).
 function whatsNewCmd(root, deps = {}) {
-  const { VERSION, arg, has } = deps;
+  const { VERSION, uiLang, arg, has } = deps;
+  const t = (ko, en) => (uiLang === 'en' ? en : ko);  // 1.28.2 (UR-0010 Phase 10c)
   root = absRoot(root || process.cwd());
   const fromV = arg('--from', null) || (function () {
     const hv = path.join(root, '.harness', 'HARNESS_VERSION');
@@ -141,29 +144,29 @@ function whatsNewCmd(root, deps = {}) {
   })();
   const toV = arg('--to', null) || VERSION;
   if (!fromV) {
-    fail('현재 버전을 파악할 수 없습니다. --from <version> 명시');
+    fail(t('현재 버전을 파악할 수 없습니다. --from <version> 명시', 'cannot determine current version. specify --from <version>'));
     return process.exit(1);
   }
   // CHANGELOG.md — 우선 root, 없으면 leerness-pkg 자체 (lib/../CHANGELOG.md = pkg 루트)
   let changelogPath = path.join(root, 'CHANGELOG.md');
   if (!exists(changelogPath)) changelogPath = path.join(__dirname, '..', 'CHANGELOG.md');
   if (!exists(changelogPath)) {
-    fail('CHANGELOG.md 없음');
+    fail(t('CHANGELOG.md 없음', 'CHANGELOG.md not found'));
     return process.exit(1);
   }
   const diff = _parseChangelogBetween(read(changelogPath), fromV, toV);
   if (has('--json')) { log(JSON.stringify({ from: fromV, to: toV, versions: diff }, null, 2)); return; }
   if (!diff.length) {
     log(`# leerness whats-new (1.9.41)`);
-    log(`현재 ${fromV} ↔ 대상 ${toV}: 새 항목 없음 (또는 CHANGELOG에 기록 안 됨)`);
+    log(t(`현재 ${fromV} ↔ 대상 ${toV}: 새 항목 없음 (또는 CHANGELOG에 기록 안 됨)`, `current ${fromV} ↔ target ${toV}: no new entries (or not recorded in CHANGELOG)`));
     return;
   }
   log(`# leerness whats-new (1.9.41)`);
-  log(`현재 워크스페이스 버전: ${fromV} → 대상: ${toV}`);
-  log(`범위: ${diff.length}개 버전 (${diff[0].version} → ${diff[diff.length - 1].version})`);
+  log(t(`현재 워크스페이스 버전: ${fromV} → 대상: ${toV}`, `current workspace version: ${fromV} → target: ${toV}`));
+  log(t(`범위: ${diff.length}개 버전 (${diff[0].version} → ${diff[diff.length - 1].version})`, `range: ${diff.length} version(s) (${diff[0].version} → ${diff[diff.length - 1].version})`));
   log('');
   // AI 가독 요약 — 각 버전당 한 줄 + 신규 명령/플래그/파일
-  log(`## 🆕 신규 명령·플래그·파일 (AI 에이전트는 다음 명령을 우선 시도)`);
+  log(t(`## 🆕 신규 명령·플래그·파일 (AI 에이전트는 다음 명령을 우선 시도)`, `## 🆕 new commands·flags·files (AI agents: try these first)`));
   const allCommands = new Set();
   const allFlags = new Set();
   const allFiles = new Set();
@@ -172,11 +175,11 @@ function whatsNewCmd(root, deps = {}) {
     v.newFlags.forEach(f => allFlags.add(f));
     v.newFiles.forEach(f => allFiles.add(f));
   }
-  if (allCommands.size) log(`  📌 신규 명령: ${[...allCommands].join(', ')}`);
-  if (allFlags.size)    log(`  🚩 신규 플래그: ${[...allFlags].join(', ')}`);
-  if (allFiles.size)    log(`  📄 신규 파일: ${[...allFiles].join(', ')}`);
+  if (allCommands.size) log(t(`  📌 신규 명령: ${[...allCommands].join(', ')}`, `  📌 new commands: ${[...allCommands].join(', ')}`));
+  if (allFlags.size)    log(t(`  🚩 신규 플래그: ${[...allFlags].join(', ')}`, `  🚩 new flags: ${[...allFlags].join(', ')}`));
+  if (allFiles.size)    log(t(`  📄 신규 파일: ${[...allFiles].join(', ')}`, `  📄 new files: ${[...allFiles].join(', ')}`));
   log('');
-  log(`## 📜 버전별 헤드라인`);
+  log(t(`## 📜 버전별 헤드라인`, `## 📜 per-version headlines`));
   for (const v of diff) {
     // body 첫 줄(또는 strong header) 추출
     const firstLine = (v.body.match(/^\*\*([^*]+)\*\*/) || [])[1]
@@ -184,11 +187,11 @@ function whatsNewCmd(root, deps = {}) {
     log(`  • ${v.version}${v.date ? ` (${v.date})` : ''} — ${firstLine || '(no headline)'}`);
   }
   log('');
-  log(`## 💡 권장 행동`);
-  log(`  1. 위 신규 명령들을 시도해 보세요 (예: \`leerness <명령> --help\`)`);
-  log(`  2. 신규 파일들을 읽어 보세요 (예: \`cat .harness/session-workflow.md\`)`);
-  log(`  3. AGENTS.md/CLAUDE.md 재독 — migrate가 인스트럭션을 업데이트했을 수 있음`);
-  log(`  4. 상세: \`cat CHANGELOG.md\` 또는 \`leerness whats-new --json\``);
+  log(t(`## 💡 권장 행동`, `## 💡 recommended actions`));
+  log(t(`  1. 위 신규 명령들을 시도해 보세요 (예: \`leerness <명령> --help\`)`, `  1. Try the new commands above (e.g. \`leerness <command> --help\`)`));
+  log(t(`  2. 신규 파일들을 읽어 보세요 (예: \`cat .harness/session-workflow.md\`)`, `  2. Read the new files (e.g. \`cat .harness/session-workflow.md\`)`));
+  log(t(`  3. AGENTS.md/CLAUDE.md 재독 — migrate가 인스트럭션을 업데이트했을 수 있음`, `  3. Re-read AGENTS.md/CLAUDE.md — migrate may have updated the instructions`));
+  log(t(`  4. 상세: \`cat CHANGELOG.md\` 또는 \`leerness whats-new --json\``, `  4. Details: \`cat CHANGELOG.md\` or \`leerness whats-new --json\``));
 }
 
 module.exports = { doctorCmd, whichCmd, whatsNewCmd };

package/lib/drift.js

@@ -168,24 +168,25 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
   //   재귀(_noAutoFix)는 auto-fix 블록을 건너뛰고 마지막 JSON(아래 has('--json') 블록)만 출력 → afLog 로 첫 패스 진행로그만 무음화.
   const afLog = has('--json') ? () => {} : log;
   // 1.9.82: 보안 신호가 fired에 있으면 우선 audit --fix 호출
-  const hasSecurityFired = fired.some(f => /보안 위험 \(1\.9\.78\)/.test(f.label));
+  // 1.28.1 (Phase 10b): 보안 신호 판정을 *언어-안정* 한 file 필드로 — 1.27.2 에서 label 을 언어화하면서 한국어 라벨 regex 매칭이 --language en 에서 깨지던 버그 수정(보안 auto-fix 미발동 방지).
+  const hasSecurityFired = fired.some(f => f.file === '.env / .gitignore');
   if (autoFix && hasSecurityFired) {
     afLog('');
-    afLog(`🔒 --auto-fix 활성 (1.9.82) — 보안 신호 회복: audit --fix 자동 실행 중...`);
+    afLog(t(`🔒 --auto-fix 활성 (1.9.82) — 보안 신호 회복: audit --fix 자동 실행 중...`, `🔒 --auto-fix on — recovering security signal: running audit --fix...`));
     try {
       const r = cp.spawnSync(process.execPath, [harnessPath, 'audit', root, '--fix'],
         { encoding: 'utf8', timeout: 30000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
       if (r.status === 0) {
-        afLog(`✓ audit --fix 완료 — .gitignore + .env.example 동기화`);
+        afLog(t(`✓ audit --fix 완료 — .gitignore + .env.example 동기화`, `✓ audit --fix done — .gitignore + .env.example synced`));
         // 재검사 (보안 신호 회복 확인)
         afLog('');
-        afLog(`재검사 중...`);
+        afLog(t(`재검사 중...`, `re-checking...`));
         return driftCheckCmd(root, { ...opts, _noAutoFix: true }, deps); // 재귀 1회 (auto-fix 없이, 1.9.432 depth 가드)
       } else {
-        afLog(`⚠ audit --fix 실패 (exit ${r.status}) — 수동 \`leerness audit --fix\` 권장`);
+        afLog(t(`⚠ audit --fix 실패 (exit ${r.status}) — 수동 \`leerness audit --fix\` 권장`, `⚠ audit --fix failed (exit ${r.status}) — run \`leerness audit --fix\` manually`));
       }
     } catch (e) {
-      afLog(`⚠ auto-fix 보안 회복 오류: ${e.message}`);
+      afLog(t(`⚠ auto-fix 보안 회복 오류: ${e.message}`, `⚠ auto-fix security recovery error: ${e.message}`));
     }
   }
   // 1.9.242: drift check --auto-fix 에 env encoding BOM 자동 추가 통합 (사용자 명시 UR-0014 2단계)
@@ -195,7 +196,7 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
       const encScan = _scanShellScriptsEncoding(root);
       if (encScan.atRisk && encScan.atRisk.length > 0) {
         afLog('');
-        afLog(`🌐 --auto-fix 활성 (1.9.242) — 셸 스크립트 인코딩 위험 ${encScan.atRisk.length}건 BOM 자동 추가 중...`);
+        afLog(t(`🌐 --auto-fix 활성 (1.9.242) — 셸 스크립트 인코딩 위험 ${encScan.atRisk.length}건 BOM 자동 추가 중...`, `🌐 --auto-fix on — adding UTF-8 BOM to ${encScan.atRisk.length} at-risk shell script(s)...`));
         let ok = 0;
         for (const r of encScan.atRisk) {
           try {
@@ -207,10 +208,10 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
             ok++;
           } catch {}
         }
-        afLog(`✓ UTF-8 BOM 추가 ${ok}/${encScan.atRisk.length}건 (1.9.242 UR-0014)`);
+        afLog(t(`✓ UTF-8 BOM 추가 ${ok}/${encScan.atRisk.length}건 (1.9.242 UR-0014)`, `✓ added UTF-8 BOM ${ok}/${encScan.atRisk.length}`));
       }
     } catch (e) {
-      afLog(`⚠ env encoding auto-fix 오류 (1.9.242): ${e.message}`);
+      afLog(t(`⚠ env encoding auto-fix 오류 (1.9.242): ${e.message}`, `⚠ env encoding auto-fix error: ${e.message}`));
     }
   }
   // 1.9.225: drift check --auto-fix 에 delivered 패턴 자동 적용 통합 (1.9.223/224 시스템 회수)
@@ -221,16 +222,16 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
       const delivered = _detectDeliveredRequests(root);
       if (delivered.candidates && delivered.candidates.length > 0) {
         afLog('');
-        afLog(`📥 --auto-fix 활성 (1.9.225) — delivered 패턴 ${delivered.candidates.length}건 자동 완료 중...`);
+        afLog(t(`📥 --auto-fix 활성 (1.9.225) — delivered 패턴 ${delivered.candidates.length}건 자동 완료 중...`, `📥 --auto-fix on — auto-completing ${delivered.candidates.length} delivered pattern(s)...`));
         let ok = 0;
         for (const c of delivered.candidates) {
           const u = _updateUserRequest(root, c.id, { status: 'completed', autoCompletedAt: new Date().toISOString(), autoCompleteReason: 'drift-auto-fix-1.9.225' });
           if (u) ok++;
         }
-        afLog(`✓ delivered 자동 완료 ${ok}/${delivered.candidates.length}건`);
+        afLog(t(`✓ delivered 자동 완료 ${ok}/${delivered.candidates.length}건`, `✓ delivered auto-completed ${ok}/${delivered.candidates.length}`));
       }
     } catch (e) {
-      afLog(`⚠ delivered auto-apply 오류 (1.9.225): ${e.message}`);
+      afLog(t(`⚠ delivered auto-apply 오류 (1.9.225): ${e.message}`, `⚠ delivered auto-apply error: ${e.message}`));
     }
   }
   // 1.9.293: drift check --auto-fix 에 idempotency task/user-request 중복 자동 정리 통합
@@ -241,10 +242,10 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
       const totalFixed = idemFixes.reduce((n, f) => n + (f.removedExact || 0) + (f.droppedSameText || 0) + (f.count || 0), 0);
       if (totalFixed > 0) {
         afLog('');
-        afLog(`🔁 --auto-fix 활성 (1.9.293) — idempotency 중복 ${totalFixed}건 자동 정리 (task/user-request dedup)`);
+        afLog(t(`🔁 --auto-fix 활성 (1.9.293) — idempotency 중복 ${totalFixed}건 자동 정리 (task/user-request dedup)`, `🔁 --auto-fix on — deduped ${totalFixed} idempotency duplicate(s) (task/user-request)`));
       }
     } catch (e) {
-      afLog(`⚠ idempotency auto-fix 오류 (1.9.293): ${e.message}`);
+      afLog(t(`⚠ idempotency auto-fix 오류 (1.9.293): ${e.message}`, `⚠ idempotency auto-fix error: ${e.message}`));
     }
   }
   // 1.9.236: drift check --auto-fix 에 release cleanup 통합 (1.9.235 회수)
@@ -260,7 +261,7 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
           .filter(l => l && /^release\/\d+\.\d+\.\d+$/.test(l));
         if (merged.length > 50) {
           afLog('');
-          afLog(`🗑 --auto-fix 활성 (1.9.236) — release/* merged ${merged.length}개 (50+) 자동 정리 (keep 10)...`);
+          afLog(t(`🗑 --auto-fix 활성 (1.9.236) — release/* merged ${merged.length}개 (50+) 자동 정리 (keep 10)...`, `🗑 --auto-fix on — cleaning up ${merged.length} merged release/* branches (50+, keep 10)...`));
           // 정렬 (semver desc)
           merged.sort((a, b) => {
             const va = a.replace('release/', '').split('.').map(n => parseInt(n, 10) || 0);
@@ -276,20 +277,20 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
             const r = cp.spawnSync('git', ['branch', '-d', b], { cwd: root, encoding: 'utf8' });
             if (r.status === 0) ok++;
           }
-          afLog(`✓ release cleanup 자동 완료 ${ok}/${toDelete.length}건 (keep 10)`);
+          afLog(t(`✓ release cleanup 자동 완료 ${ok}/${toDelete.length}건 (keep 10)`, `✓ release cleanup done ${ok}/${toDelete.length} (keep 10)`));
         }
       }
     } catch (e) {
-      afLog(`⚠ release cleanup auto-fix 오류 (1.9.236): ${e.message}`);
+      afLog(t(`⚠ release cleanup auto-fix 오류 (1.9.236): ${e.message}`, `⚠ release cleanup auto-fix error: ${e.message}`));
     }
   }
   if (autoFix && level === '🔴 critical' && !hasSecurityFired) {
     afLog('');
-    afLog(`🔧 --auto-fix 활성 — session close 자동 실행 중...`);
+    afLog(t(`🔧 --auto-fix 활성 — session close 자동 실행 중...`, `🔧 --auto-fix on — running session close...`));
     try {
       const r = cp.spawnSync(process.execPath, [harnessPath, 'session', 'close', root], { encoding: 'utf8', timeout: 60000, env: { ...process.env, LEERNESS_INTERNAL: '1' } });
       if (r.status === 0) {
-        afLog(`✓ session close 자동 완료`);
+        afLog(t(`✓ session close 자동 완료`, `✓ session close done`));
         // autoResolved 카운트
         const stats = _readUsageStats(root);
         stats.drift = stats.drift || {};
@@ -299,13 +300,13 @@ function driftCheckCmd(root, opts = {}, deps = {}) {
         writeUtf8(p, JSON.stringify(stats, null, 2) + '\n');
         // 재검사
         afLog('');
-        afLog(`재검사 중...`);
+        afLog(t(`재검사 중...`, `re-checking...`));
         return driftCheckCmd(root, { ...opts, _noAutoFix: true }, deps); // 재귀 1회 (auto-fix 없이, 1.9.432 depth 가드)
       } else {
-        afLog(`⚠ session close 실패 (exit ${r.status}) — 수동 실행 필요`);
+        afLog(t(`⚠ session close 실패 (exit ${r.status}) — 수동 실행 필요`, `⚠ session close failed (exit ${r.status}) — run manually`));
       }
     } catch (e) {
-      afLog(`⚠ auto-fix 오류: ${e.message}`);
+      afLog(t(`⚠ auto-fix 오류: ${e.message}`, `⚠ auto-fix error: ${e.message}`));
     }
   }
   if (has('--json')) {

package/package.json

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

package/scripts/e2e.js

@@ -6234,10 +6234,14 @@ total++;
     const drEn = out(cp.spawnSync(process.execPath, [CLI, 'drift', 'check', d, '--language', 'en'], { encoding: 'utf8', timeout: 20000 }));
     const drKo = out(cp.spawnSync(process.execPath, [CLI, 'drift', 'check', d], { encoding: 'utf8', timeout: 20000 }));
     const driftOk = /signal \| age \| threshold/.test(drEn) && !H.test(drEn) && /신호 \| age \| 임계/.test(drKo);
+    // ⑦ (1.28.2 Phase 10c) doctor: en 영어(한글 0) + ko 기본 한글 보존
+    const docEn = out(cp.spawnSync(process.execPath, [CLI, 'doctor', '--language', 'en'], { encoding: 'utf8', timeout: 20000, cwd: d }));
+    const docKo = out(cp.spawnSync(process.execPath, [CLI, 'doctor'], { encoding: 'utf8', timeout: 20000, cwd: d }));
+    const doctorOk = /install\/environment diagnosis/.test(docEn) && !H.test(docEn) && /설치\/환경 진단/.test(docKo);
     fs.rmSync(d, { recursive: true, force: true });
-    ok = lensKoOk && lensEnOk && noLeak && stOk && healthOk && driftOk;
+    ok = lensKoOk && lensEnOk && noLeak && stOk && healthOk && driftOk && doctorOk;
   } catch {}
-  console.log(ok ? '✓ B(1.25.1/1.25.2/1.27.2) i18n 행위: --language en 런타임 영어(lens/health/drift) + ko 기본 보존 + --language positional 무누출 + status 에러 en/ko (UR-0010)' : '✗ i18n 행위 회귀 가드 실패');
+  console.log(ok ? '✓ B(1.25.1/1.25.2/1.27.2/1.28.2) i18n 행위: --language en 런타임 영어(lens/health/drift/doctor) + ko 기본 보존 + --language positional 무누출 + status 에러 en/ko (UR-0010)' : '✗ i18n 행위 회귀 가드 실패');
   if (!ok) failed++;
 }