leerness 1.23.0 → 1.24.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 1.24.0 — 2026-06-15 — 🛡️ [안정화/Stable] help 표면 전체 영어화 안정 minor
+
+**🛡️ 안정화(Stable) minor — `leerness --help` 와 모든 도움말 표면을 영어로 공개.** 직전 minor(1.23.0) 이후 누적된 패치 2건(1.23.1 Phase 6 + 1.23.2 Phase 7)을 검증·통합해 npm 배포. R-0011 정책의 15번째 stable minor. 이제 영어 사용자가 **메인 도움말 → 명령군 그룹 도움말 → 사용법 힌트**까지 막힘없이 읽을 수 있습니다. 한국어 우선 기본은 그대로.
+
+### 이번 minor 통합 (1.23.1~1.23.2)
+- **🌐 메인 help 영어 큐레이트판 (Phase 6)**: `--language en` 시 8개 카테고리(Setup·Diagnostics·Verification·Security·Handoff·Memory·Skills·Agents·Reuse·Release·More)로 정리된 영어 도움말. 레거시 버전태그 군더더기를 빼 영어 사용자가 읽기 쉬움. status 잔여(경로 없음/healthyMeaning) + subcommand_required 에러도 영어화.
+- **🌐 그룹 help + 사용법 힌트 영어화 (Phase 7)**: requests/constraints/wakeup-interval/idempotency/intent 의 bare-command 도움말 + `_GROUP_USAGE` 자리표시자(`<text>`/`<trigger>`/`<key>`/`<name>`, 병렬 영어맵).
+- **한국어 우선 기본 보존**: 영어는 명시 opt-in(`--language en`/`LEERNESS_LANG=en`/en init 프로젝트). 플래그 없으면 한국어 — 한국어 help/맵은 한 글자도 안 바뀜(e2e 무회귀로 검증).
+
+### 잔여 (UR-0010 Phase 8+, 백로그)
+- 메모리 CRUD/진단 명령 본문 출력(task/decision/audit/gate/scan 등 사람용 메시지) + session-handoff.md 본문 — 단계적 확대.
+
+### 검증 (회귀 0)
+- **selftest 242/242** (Phase 6·7 영어/한국어 보존 소스가드 포함) · 행위(en: `SETUP & UPDATE / 5 group headers / <key>`, ko 기본: `Usage: / 한국어 그룹 헤더 / <키>`) · **E2E 365/365**.
+- minor(1.24.0) — npm 배포(R-0011 stable) + annotated tag(Stable) + GitHub release(latest) + 게시본 클린룸 재실증.
+
+## 1.23.2 — 2026-06-15 — CLI 영어화 Phase 7: group help 5종 + _GROUP_USAGE 자리표시자 영어화 (UR-0010)
+
+**🌐 도움말 표면 패밀리 완성.** Phase 6(메인 `--help`)에 이어, 명령군을 하위명령 없이 부를 때 나오는 **그룹 도움말**과 **사용법 힌트의 자리표시자**까지 영어화 — 메인 help + group help + usage hint 가 모두 언어 선택을 따른다.
+
+### 변경 (UR-0010 Phase 7)
+- **group help 5종 영어화**: `requests` / `constraints` / `wakeup-interval` / `idempotency` / `intent` 를 하위명령 없이(또는 `help`) 부를 때의 도움말을 `_t(ko,en)` 분기.
+- **_GROUP_USAGE 자리표시자 영어화**: `<텍스트>`→`<text>`, `<트리거>`→`<trigger>`, `<키>`→`<key>`, `<이름>`→`<name>` — `_GROUP_USAGE_EN` 병렬맵으로(한국어 맵은 한 글자도 안 바꿔 e2e 안전), subcommand_required 에러가 언어별 정확한 사용법 표시.
+- **한국어 기본 유지**: 영어는 명시 opt-in. 플래그 없으면 기존 한국어 그대로(e2e 무회귀).
+
+### 잔여 (UR-0010 Phase 8+, 백로그)
+- 메모리 CRUD/진단 명령 본문 출력(task/decision/audit/gate/scan 등 사람용 메시지) + session-handoff.md 본문 — 단계적 확대.
+
+### 검증 (회귀 0)
+- **selftest 241→242** (group help 5종 영어+한국어 보존, _GROUP_USAGE_EN 존재 + ko 맵 불변 소스가드) · 행위(en: 5종 영어 헤더 + `<key>`/`<text>`, ko 기본: 5종 한국어 헤더 + `<키>`/`<텍스트>`) · **E2E 365/365**.
+- patch(1.23.2) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
+## 1.23.1 — 2026-06-15 — CLI 영어화 Phase 6: help(영어 큐레이트판) + status/subcommand 에러 영어화 (UR-0010)
+
+**🌐 `leerness --help` 와 흔한 에러를 영어로.** 영어 사용자가 가장 먼저 보는 도움말을 — 레거시 버전태그를 줄별로 번역하는 대신 — **카테고리별로 정리한 별도 영어 도움말**로 제공. 한국어 도움말은 그대로 둬서 한국어 기본 경로는 한 글자도 안 바뀜.
+
+### 변경 (UR-0010 Phase 6)
+- **help 영어 큐레이트판 (`_helpEn`)**: `--language en`/`LEERNESS_LANG=en` 시 8개 카테고리(Setup·Diagnostics·Verification·Security·Handoff·Memory·Skills·Agents·Reuse·Release·More)로 정리된 영어 도움말. 전체 전수 목록은 `leerness commands` 안내(드리프트 방지).
+- **status 잔여 영어화**: 경로 없음 에러(`path not found`), `--json` 의 `healthyMeaning`(`install-file presence only …`).
+- **subcommand_required 에러 영어화**: 명령군(rule/skill/feature/memory)을 하위명령 없이 부를 때의 `subcommand required — usage: …`.
+- **한국어 기본 유지**: 영어는 명시 opt-in. 플래그 없으면 기존 한국어 도움말/에러 그대로(e2e 무회귀).
+
+### 잔여 (UR-0010 Phase 7+, 백로그)
+- `_GROUP_USAGE` 내부 자리표시자(`<텍스트>`/`<트리거>`) + 명령별 하위 help 블록(group help) + session-handoff.md 본문 — 단계적 확대.
+
+### 검증 (회귀 0)
+- **selftest 240→241** (help 영어판 존재+핵심 카테고리 포함, ko help 분기 보존, status/subcommand 영어/한국어 소스가드) · 행위(en: `SETUP & UPDATE / path not found / subcommand required`, ko 기본: `Usage: / 경로 없음 / 하위명령 필요`) · **E2E 365/365**.
+- patch(1.23.1) — npm 미배포(R-0011, GitHub/CHANGELOG 누적).
+
 ## 1.23.0 — 2026-06-15 — 🛡️ [안정화/Stable] session close 영어 완전화 안정 minor
 
 **🛡️ 안정화(Stable) minor — 세션 마감 화면 전체를 영어로 공개.** 직전 minor(1.22.0) 이후 누적된 패치 2건(1.22.1 Phase 4 + 1.22.2 Phase 5)을 검증·통합해 npm 배포. R-0011 정책의 14번째 stable minor. 이로써 **핵심 세션 라이프사이클 — 설치(init) → 시작(handoff) → 검증(verify-claim) → 마감(session close) — 전체가 영어 opt-in 으로 일관**됩니다. 한국어 우선 기본은 그대로.

package/README.md

@@ -104,7 +104,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.23.0 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.24.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.23.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.24.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -179,7 +179,7 @@ Leerness v1.23.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.23.0)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.24.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.23.0: 2026-06-15
+Last synced by Leerness v1.24.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.23.0';
+const VERSION = '1.24.0';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3764,6 +3764,24 @@ function _selfTestCases() {
       const noShadow = !sc.includes('.map(([t, n]) =>');  // t 헬퍼 셰도잉 제거 확인
       return en && koPreserved && noShadow;
     } },
+    { name: 'CLI 영어화 Phase 6 (1.23.1, UR-0010): help 영어 큐레이트판 + status/subcommand 영어/한국어 보존 (소스 가드)', run: () => {
+      const bin = read(__filename);
+      // en help 가 존재하고 핵심 명령군을 포함 + ko help 분기 보존
+      const enHelp = bin.includes('function _helpEn()') && bin.includes("if (_uiLang(arg('--path', process.cwd())) === 'en') { _helpEn(); return; }");
+      const enCovers = bin.includes('SETUP & UPDATE') && bin.includes('VERIFICATION (evidence-gated') && bin.includes('Full, exhaustive command list');
+      const koPreserved = bin.includes('Leerness v${VERSION}\\n\\nUsage:');  // 한국어 help 원문 유지
+      const statusEn = bin.includes('path not found: ${root}') && bin.includes('install-file presence only');
+      const subEn = bin.includes('subcommand required — usage: leerness');
+      return enHelp && enCovers && koPreserved && statusEn && subEn;
+    } },
+    { name: 'CLI 영어화 Phase 7 (1.23.2, UR-0010): group help 5종 + _GROUP_USAGE_EN 영어/한국어 보존 (소스 가드)', run: () => {
+      const bin = read(__filename);
+      const en = bin.includes('track missing user requests') && bin.includes('pre-check platform/API constraints') && bin.includes('adaptive wakeup interval') && bin.includes('detect idempotency violations') && bin.includes('infer user intent');
+      const koPreserved = bin.includes('사용자 요청 누락 확인 절차') && bin.includes('플랫폼/API 제약 사전 체크') && bin.includes('멱등성 위반 탐지');  // ko 원문 _t ko 인자로 보존(e2e ko 무회귀)
+      const groupUsageEn = bin.includes('const _GROUP_USAGE_EN = {') && bin.includes('rule add "<text>" --trigger <trigger>') && bin.includes('${_GROUP_USAGE_EN[cmd]}');
+      const koUsagePreserved = bin.includes('rule add "<텍스트>" --trigger <트리거>');  // ko 맵 불변
+      return en && koPreserved && groupUsageEn && koUsagePreserved;
+    } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -5298,14 +5316,15 @@ function requestsCmd(root, sub, ...rest) {
   const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
 
   if (!sub || sub === 'help' || sub === '--help') {
-    log(`# leerness requests (1.9.207) — 사용자 요청 누락 확인 절차`);
+    const _L = _uiLang(root); const _t = (ko, en) => _L === 'en' ? en : ko;  // 1.23.2 (UR-0010 Phase 7)
+    log(_t(`# leerness requests (1.9.207) — 사용자 요청 누락 확인 절차`, `# leerness requests — track missing user requests`));
     log('');
-    log(`  audit            → 누락 후보 + tracked + stale 보고 (--json 가능)`);
-    log(`  add "<text>"     → 사용자 요청 수동 기록`);
-    log(`  list             → 전체 요청 출력 (--json 가능, --status open|completed|dropped)`);
-    log(`  complete <id>    → 요청 완료 표시 (예: UR-0003)`);
-    log(`  drop <id>        → 요청 드롭 표시`);
-    log(`  auto-complete    → "Round X.Y.Z — 구현 완료" 패턴 자동 감지 (default: dry-run, --apply 시 적용) [1.9.223]`);
+    log(_t(`  audit            → 누락 후보 + tracked + stale 보고 (--json 가능)`, `  audit            → report missing candidates + tracked + stale (--json)`));
+    log(_t(`  add "<text>"     → 사용자 요청 수동 기록`, `  add "<text>"     → manually record a user request`));
+    log(_t(`  list             → 전체 요청 출력 (--json 가능, --status open|completed|dropped)`, `  list             → list all requests (--json, --status open|completed|dropped)`));
+    log(_t(`  complete <id>    → 요청 완료 표시 (예: UR-0003)`, `  complete <id>    → mark a request completed (e.g. UR-0003)`));
+    log(_t(`  drop <id>        → 요청 드롭 표시`, `  drop <id>        → mark a request dropped`));
+    log(_t(`  auto-complete    → "Round X.Y.Z — 구현 완료" 패턴 자동 감지 (default: dry-run, --apply 시 적용) [1.9.223]`, `  auto-complete    → auto-detect "Round X.Y.Z delivered" patterns (default: dry-run, --apply to apply)`));
     return;
   }
 
@@ -5551,13 +5570,14 @@ function constraintsCmd(root, sub, ...rest) {
   const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
 
   if (!sub || sub === 'help' || sub === '--help') {
-    log(`# leerness constraints (1.9.208) — 플랫폼/API 제약 사전 체크`);
+    const _L = _uiLang(root); const _t = (ko, en) => _L === 'en' ? en : ko;  // 1.23.2 (UR-0010 Phase 7)
+    log(_t(`# leerness constraints (1.9.208) — 플랫폼/API 제약 사전 체크`, `# leerness constraints — pre-check platform/API constraints`));
     log('');
-    log(`  list                  → 등록된 모든 플랫폼 catalog 출력 (--json 가능)`);
-    log(`  check "<request>"     → 사용자 요청에서 플랫폼 매칭 → 제약 보고 (--json 가능)`);
+    log(_t(`  list                  → 등록된 모든 플랫폼 catalog 출력 (--json 가능)`, `  list                  → list all registered platform catalogs (--json)`));
+    log(_t(`  check "<request>"     → 사용자 요청에서 플랫폼 매칭 → 제약 보고 (--json 가능)`, `  check "<request>"     → match platforms in a request → report constraints (--json)`));
     log(`  add <id> --constraint "kind:detail" --alias name`);
     log('');
-    log(dim(`  예: leerness constraints check "Stripe API 연동 결제 모듈"`));
+    log(dim(_t(`  예: leerness constraints check "Stripe API 연동 결제 모듈"`, `  e.g. leerness constraints check "Stripe API payment integration"`)));
     return;
   }
 
@@ -5737,15 +5757,16 @@ function wakeupIntervalCmd(root, sub, val) {
   const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
 
   if (!sub || sub === 'help' || sub === '--help') {
-    log(`# leerness wakeup-interval (1.9.210) — adaptive wakeup 간격`);
+    const _L = _uiLang(root); const _t = (ko, en) => _L === 'en' ? en : ko;  // 1.23.2 (UR-0010 Phase 7)
+    log(_t(`# leerness wakeup-interval (1.9.210) — adaptive wakeup 간격`, `# leerness wakeup-interval — adaptive wakeup interval`));
     log('');
-    log(`  get              → 현재 권장 interval + stats (--json 가능)`);
-    log(`  set <secs>       → override 설정 (예: leerness wakeup-interval set 900)`);
-    log(`  auto             → override 해제 + 자동 계산 모드`);
-    log(`  history          → 최근 fire 이력 출력`);
-    log(`  record <kind>    → fire 기록 (user-trigger / auto / wakeup-miss)`);
+    log(_t(`  get              → 현재 권장 interval + stats (--json 가능)`, `  get              → current recommended interval + stats (--json)`));
+    log(_t(`  set <secs>       → override 설정 (예: leerness wakeup-interval set 900)`, `  set <secs>       → set an override (e.g. leerness wakeup-interval set 900)`));
+    log(_t(`  auto             → override 해제 + 자동 계산 모드`, `  auto             → clear override + auto-compute mode`));
+    log(_t(`  history          → 최근 fire 이력 출력`, `  history          → recent fire history`));
+    log(_t(`  record <kind>    → fire 기록 (user-trigger / auto / wakeup-miss)`, `  record <kind>    → record a fire (user-trigger / auto / wakeup-miss)`));
     log('');
-    log(dim(`  opt-out: env LEERNESS_FIXED_INTERVAL=1500 (초) 또는 set <secs>`));
+    log(dim(_t(`  opt-out: env LEERNESS_FIXED_INTERVAL=1500 (초) 또는 set <secs>`, `  opt-out: env LEERNESS_FIXED_INTERVAL=1500 (seconds) or set <secs>`)));
     return;
   }
 
@@ -6113,15 +6134,16 @@ function idempotencyCmd(root, sub) {
   const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
 
   if (!sub || sub === 'help' || sub === '--help') {
-    log(`# leerness idempotency (1.9.212) — 멱등성 위반 탐지`);
+    const _L = _uiLang(root); const _t = (ko, en) => _L === 'en' ? en : ko;  // 1.23.2 (UR-0010 Phase 7)
+    log(_t(`# leerness idempotency (1.9.212) — 멱등성 위반 탐지`, `# leerness idempotency — detect idempotency violations`));
     log('');
-    log(`  audit               → 워크스페이스 멱등성 점검 (rules / tasks / user-requests / wakeups)  (--json 가능)`);
-    log(`  audit --auto-fix    → task 완전중복 행 제거 + active 동일텍스트 dropped 처리 + user-request open 중복 정리 (1.9.293)`);
+    log(_t(`  audit               → 워크스페이스 멱등성 점검 (rules / tasks / user-requests / wakeups)  (--json 가능)`, `  audit               → check workspace idempotency (rules / tasks / user-requests / wakeups)  (--json)`));
+    log(_t(`  audit --auto-fix    → task 완전중복 행 제거 + active 동일텍스트 dropped 처리 + user-request open 중복 정리 (1.9.293)`, `  audit --auto-fix    → remove exact-duplicate tasks + mark same-text active as dropped + dedup open user-requests`));
     log('');
-    log(dim(`  dedup 적용 영역: ruleAdd / taskAdd (1.9.212) + _recordUserRequest (1.9.207) + _recordWakeup (1.9.205)`));
-    log(dim(`  --auto-fix 안전: 완전 동일 행만 제거 / 동일텍스트는 status=dropped 로 보존(id 유지) / git 회복 가능 / 멱등`));
-    log(dim(`  자동화: drift check --auto-fix 가 idempotency 중복도 자동 정리 (1.9.293)`));
-    log(dim(`  opt-out: --force 플래그로 dedup 우회 가능`));
+    log(dim(_t(`  dedup 적용 영역: ruleAdd / taskAdd (1.9.212) + _recordUserRequest (1.9.207) + _recordWakeup (1.9.205)`, `  dedup applies to: ruleAdd / taskAdd + _recordUserRequest + _recordWakeup`)));
+    log(dim(_t(`  --auto-fix 안전: 완전 동일 행만 제거 / 동일텍스트는 status=dropped 로 보존(id 유지) / git 회복 가능 / 멱등`, `  --auto-fix safety: removes only exact dupes / same-text kept as status=dropped (id preserved) / git-recoverable / idempotent`)));
+    log(dim(_t(`  자동화: drift check --auto-fix 가 idempotency 중복도 자동 정리 (1.9.293)`, `  automation: drift check --auto-fix also dedups idempotency violations`)));
+    log(dim(_t(`  opt-out: --force 플래그로 dedup 우회 가능`, `  opt-out: pass --force to bypass dedup`)));
     return;
   }
 
@@ -6188,14 +6210,15 @@ function intentCmd(root, sub, ...rest) {
   const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
 
   if (!sub || sub === 'help' || sub === '--help') {
-    log(`# leerness intent (1.9.213) — 사용자 의도 파악 + scope expansion 게이트`);
+    const _L = _uiLang(root); const _t = (ko, en) => _L === 'en' ? en : ko;  // 1.23.2 (UR-0010 Phase 7)
+    log(_t(`# leerness intent (1.9.213) — 사용자 의도 파악 + scope expansion 게이트`, `# leerness intent — infer user intent + scope-expansion gate`));
     log('');
-    log(`  classify "<request>"      → intent 분류 (precise/broad/default) + 신호 (--json 가능)`);
-    log(`  expand "<request>"        → 도메인 탐지 + 확장 후보 dry-run (--json 가능)`);
-    log(`  domains                   → 등록된 도메인 catalog 출력 (game/web/api/cli/data)`);
+    log(_t(`  classify "<request>"      → intent 분류 (precise/broad/default) + 신호 (--json 가능)`, `  classify "<request>"      → classify intent (precise/broad/default) + signals (--json)`));
+    log(_t(`  expand "<request>"        → 도메인 탐지 + 확장 후보 dry-run (--json 가능)`, `  expand "<request>"        → detect domain + expansion candidates (dry-run, --json)`));
+    log(_t(`  domains                   → 등록된 도메인 catalog 출력 (game/web/api/cli/data)`, `  domains                   → list registered domain catalog (game/web/api/cli/data)`));
     log('');
-    log(dim(`  3원칙: (1) Always-Off Opt-In  (2) Dry-run 기본 (실행 X)  (3) 명시 vs 추론 분리 라벨링`));
-    log(dim(`  예: leerness intent expand "맵과 캐릭터 + 기본 게임 기능 만들어줘"`));
+    log(dim(_t(`  3원칙: (1) Always-Off Opt-In  (2) Dry-run 기본 (실행 X)  (3) 명시 vs 추론 분리 라벨링`, `  3 principles: (1) always-off opt-in  (2) dry-run by default (no execution)  (3) explicit vs inferred labeling`)));
+    log(dim(_t(`  예: leerness intent expand "맵과 캐릭터 + 기본 게임 기능 만들어줘"`, `  e.g. leerness intent expand "build a map + characters + basic game features"`)));
     return;
   }
 
@@ -7598,8 +7621,9 @@ function route(name) {
 
 function status(root) {
   root = absRoot(root);
+  const _L = _uiLang(root); const t = (ko, en) => (_L === 'en' ? en : ko);  // 1.23.1 (UR-0010 Phase 6)
   // 1.9.434 (11th 외부평가 Opus P2, UR-0136): 미존재 경로는 healthy 위조 금지 — failJson + exit 1.
-  if (!exists(root)) { failJson(has('--json'), 'path_not_found', `경로 없음: ${root}`); return; }
+  if (!exists(root)) { failJson(has('--json'), 'path_not_found', t(`경로 없음: ${root}`, `path not found: ${root}`)); return; }
   const verF = path.join(root,'.harness/HARNESS_VERSION');
   const ver = exists(verF) ? read(verF).trim() : 'not installed';
   const lang = exists(path.join(root,'.harness/LANGUAGE')) ? read(path.join(root,'.harness/LANGUAGE')).trim() : 'ko';
@@ -7610,7 +7634,7 @@ function status(root) {
   const missing = files.filter(f => !exists(path.join(root,f)));
   // 1.9.384 (5번째 외부평가/UR-0085): --json 일관성 — AI 에이전트용 구조화 출력.
   // 1.9.418 (9th 외부평가 Codex P2): healthy 의 의미를 명시(설치 파일 존재 ≠ 프로젝트 안전). 프로젝트 안전은 gate/scan secrets 사용.
-  if (has('--json')) { log(JSON.stringify({ version: ver, language: lang, minimal: isMinimal, scope: 'install', total: files.length, present: files.length - missing.length, missing, healthy: missing.length === 0, healthyMeaning: '설치 파일 존재 여부(프로젝트 안전 아님 — 보안/품질은 leerness gate / scan secrets 사용)' }, null, 2)); return; }
+  if (has('--json')) { log(JSON.stringify({ version: ver, language: lang, minimal: isMinimal, scope: 'install', total: files.length, present: files.length - missing.length, missing, healthy: missing.length === 0, healthyMeaning: t('설치 파일 존재 여부(프로젝트 안전 아님 — 보안/품질은 leerness gate / scan secrets 사용)', 'install-file presence only (not project safety — use leerness gate / scan secrets for security/quality)') }, null, 2)); return; }
   log(`Leerness: ${ver}${isMinimal ? ' (minimal)' : ''}`);
   log(`Files: ${files.length - missing.length}/${files.length}`);
   if (missing.length) missing.forEach(x => warn('missing: ' + x));
@@ -19604,7 +19628,102 @@ 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 }); }
 
+// 1.23.1 (UR-0010 Phase 6): 영어 큐레이트 도움말 — 한국어 help 의 줄별 번역이 아니라, 카테고리별로 정리한 별도 영어판.
+//   레거시 버전태그(1.9.x) 군더더기를 빼고 영어 사용자가 읽기 쉽게. 전체 전수 목록은 `leerness commands`.
+//   한국어 help() 는 그대로 유지(기본 ko, e2e 무회귀). 영어는 --language en / LEERNESS_LANG=en opt-in.
+function _helpEn() {
+  log(`Leerness v${VERSION}
+
+The AI-coding operations layer that makes "done" require evidence.
+Korean-first by default; this English help shows with --language en or LEERNESS_LANG=en.
+
+Usage: leerness <command> [path] [options]
+
+SETUP & UPDATE
+  init [path] [--language auto|ko|en] [--skills recommended|all|a,b] [--minimal] [--yes]
+                                  Install the .harness/ workspace into your project
+  migrate [path] [--dry-run] [--force]            Non-destructive cross-version migration
+  migrate audit|apply|plan [path] [--json]        Diagnose / backfill / compare migration
+  update [path] [--check|--yes|--force]           Auto-detect version + migrate
+  auto-update install [path]                      Install the auto-update hook
+  path-setup [--apply]                            Register the leerness CLI on PATH
+
+STATUS & DIAGNOSTICS
+  status [path]                   Install status (files present)
+  health [path] | doctor [path]   Install/state diagnostics
+  verify [path]                   Required-file verification
+  which [--json]                  Resolve current binary/version (npm cache conflicts)
+  selftest [--json]               Core-function integrity self-check (CI-friendly)
+  pulse | milestones | round-history [path]       Combined progress metrics
+  whats-new [path]                Recent version changes
+
+VERIFICATION (evidence-gated "done")
+  verify-claim <T-ID> [--run-tests] [--test-cmd "..."] [--json]
+                                  Check evidence vs reality (stub / fake-test / inflated-count detection)
+  contract verify <spec.md> <impl.js> [--json]    Spec <-> implementation match
+  verify-code [path] [--build] [--bench]          Run tests/lint/typecheck, record evidence
+  gate [path]                     One-call CI gate: verify + audit + scan + encoding + lazy
+  lens [code|design|docs|test|security] [--json]  Quality self-question lenses
+
+SECURITY & HYGIENE
+  scan secrets [path]             Committed-secret detection
+  encoding check [path]           UTF-8 / BOM / CP949 / shell-script encoding
+  audit [path] [--fix]            Consistency + plan/progress alignment
+  lazy detect [path] [--auto-track]               Anti-laziness evaluation
+  shell-guard "<command>" [--json]                Shell-compatibility linter (PowerShell 5.1 etc.)
+
+HANDOFF & SESSION
+  handoff [path] [--compact] [--all-apps] [--json]  Session-start context in one call
+  session close [path]            Closing report + auto handoff
+  context [path] [--json]         Agent onboarding context
+  retro | insights [path] [--json]                Retrospective / cumulative stats
+
+MEMORY (canonical JSON + markdown projections)
+  task list|add|update|drop|fix-evidence|relink [args]
+  plan show|init|add|drop|progress|sync [args]
+  decision add "<title>" [--reason ...] | decision list|drop <id>
+  lesson save "<text>" [--tag t] | lesson list|drop <id>
+  rule add "<text>" --trigger every-session|every-commit|... | rule list|pause|resume|remove
+  requests audit|add|list|complete|drop           User-request tracking (UR-XXXX)
+  memory search "query" [--include-code] [--limit N]
+  memory archive list|restore [args]
+  lessons [--query <k>] | brainstorm "<topic>"
+
+SKILLS
+  skill list|info <name>|use <id>|remove <id>
+  skill learn <id> --doc <url> --command "..." --capability "..."
+  skill install <SKILL.md|dir|url> | skill discover --preset vercel|anthropic
+  skill consolidate [--threshold 0.3]
+
+AGENTS & PROVIDERS (opt-in)
+  agents list|check|quota | agents dispatch "<task>" --to <id> | agents multi "<task>"
+  provider list|add|remove [args]
+  setup-agents [path] [--yes]
+  team list|add|show|remove|preview|deploy <id> [...]   (deploy is double-gated)
+
+REUSE & IMPACT
+  reuse autodetect|find|register [args] | reuse-map [path] [--json]
+  impact <target> [--all] | deps <capability> [--run-tests]
+  feature add|link|impact|list|show | graph [path] | guide [target]
+
+RELEASE & OPS
+  release bump|note|publish|channel|cadence [args]
+  capabilities | install-safety [--json] | permissions list|set | creds list|register|check
+  incident list|show|handle | deploy auto | runs list|show | webhook serve
+  roadmap [path] [--out f.html] | roadmap auto on|off|status
+
+MORE
+  commands [--json]               Full, exhaustive command list
+  help | --help | -h              This help
+  --version | -v                  Version only
+
+Docs: https://www.npmjs.com/package/leerness  |  https://leerness.pages.dev
+`);
+}
+
 function help() {
+  // 1.23.1 (UR-0010 Phase 6): 영어 opt-in 시 큐레이트 영어판. 기본(ko) 은 아래 한국어 help 그대로.
+  if (_uiLang(arg('--path', process.cwd())) === 'en') { _helpEn(); return; }
   log(`Leerness v${VERSION}\n\nUsage:\n  leerness init [path] [--language auto|ko|en] [--skills recommended|all|a,b]\n  leerness migrate [path] [--dry-run] [--force]\n  leerness update [path] [--check|--yes|--force|--from <tarball>]\n  leerness auto-update install [path]\n  leerness status [path]\n  leerness verify [path]\n  leerness debug [path]\n  leerness audit [path]\n  leerness check [path]\n  leerness scan secrets [path]\n  leerness encoding check [path]\n  leerness lazy detect [path]\n  leerness memory search "query" [--limit 5]\n  leerness handoff [path] [--all-apps] [--include p1,p2] [--since 24h|3d] [--compact] [--json]   # 1.9.17-22 워크스페이스 (--compact: LLM 시스템 프롬프트용 1줄 요약)\n  leerness orchestrate "<목표>" [--agents N] [--model qwen2.5:7b-instruct] [--retry-on-fail K]   # 1.9.22 Ollama opt-in (LEERNESS_OLLAMA_BASE_URL 필요)\n  leerness llm-bench record --score N --model X [--label L] [--tokens T]   # 1.9.22 LLM 벤치 히스토리 누적\n  leerness deps <capability> [--run-tests] [--json]   # 1.9.24 depends-on 역방향 추적 + 자동 회귀 sweep\n  leerness memory search "키" [--include-code]   # 1.9.25 소스 코드 본문도 검색 (모순 감지 핵심)\n  leerness brainstorm "주제" [--include-code]    # 1.9.25 코드 본문 hits 포함\n  leerness register-pending "<요청>" [--agent X] [--note Y]   # 1.9.25 다중 세션 in-progress 즉시 등록\n  leerness optimism-check <T-ID> [--json]   # 1.9.26/27 낙관적 표시 감지 (1.9.27: 10 카테고리 + URL/메서드 매핑 + 신뢰도 점수)\n  leerness persona list|show <id>|add <id>   # 1.9.29 페르소나 카탈로그 (보안/성능/UX/testing/docs 5종 내장)\n  leerness review <file> --persona <id1,id2,...>   # 1.9.29 도메인 페르소나 리뷰 프롬프트 자동 생성\n  leerness agents list|check|quota          # 1.9.30/31 외부 AI CLI 가용성 + quota 추정 (claude/codex/agy/copilot)\n  leerness agents dispatch "<task>" --to <id>   # 1.9.30 활성 CLI 대상 실행 명령 생성 (실 호출 X, 사용자 실행)\n  leerness agents multi "<task>" [--only c1,c2] [--write] [--execute] [--timeout 60]   # 1.9.152/156 활성 N개 일괄 dispatch (--execute: 실 spawn + consensus)\n  leerness provider list|add|remove [args]   # 1.9.157 Provider Registry — 사용자 정의 CLI provider 동적 추가 (OpenRouter/Bedrock 흡수)\n  leerness agents dispatch "<task>" --multi   # 1.9.152 multi 모드 alias (또는 --to all)\n  leerness setup-agents [path] [--yes|--no-setup-agents]    # 1.9.32 sub-agent CLI 인터랙티브 설정 (.env + 미설치 자동 설치)\n  leerness init [path] [--no-stale-check]                   # 1.9.33 npx 캐시 함정 — 옛 버전 자동 경고 (끄려면 --no-stale-check)\n  leerness which [--json]                                   # 1.9.164 진단: 현재 실행 경로/버전 + npm 캐시 + PATH 후보 (구버전 충돌 해결)\n  leerness selftest [--json]                                # 1.9.258 코어 함수 무결성 자가 검증 (설치 손상/부분설치 감지, CI 친화 exit 1)\n  leerness shell-guard "<command>" [--json]                 # 1.9.260 터미널 명령 셸 호환성 린터 (PowerShell 5.1 && 미지원 등 실행 전 감지, UR-0020)\n  leerness shell-guard --record --cmd "..." --exit N        # 1.9.260 실패한 터미널 명령 기록 → 다음 분석 시 회수\n  leerness path-setup [--apply] [--json]                    # 1.9.254 leerness CLI PATH 자동 등록 (npm global bin 미등록 시)\n  leerness web check|screenshot|extract <url> [--out file.png] [--selector "css"]  # 1.9.165 playwright bridge (opt-in: npm i -g playwright + permissions.browser)\n  leerness pc check|click|type|screenshot [--x N --y N] [--text "s"] [--out f.png]  # 1.9.166 robotjs/nut-tree bridge (opt-in: npm i -g robotjs + permissions.mouse/keyboard, ⚠ full 모드 권장)\n  leerness lsp check|symbols|references <file/name> [--in dir] [--json]  # 1.9.167 LSP 어댑터 MVP (typescript opt-in + regex fallback, 코드 인텔리전스)\n  leerness review-request "<request>" [--json]  # 1.9.176 사용자 요청 사전 검토 (충돌/재사용/효율/권장 단계 — 사용자 명시)\n  leerness contract verify <spec.md> <impl.js> [--json]     # 1.9.35 명세 ↔ 구현 일치 검사 (함수/필드)\n  leerness reuse autodetect [path] [--apply] [--json]       # 1.9.35 src/*.js의 module.exports → reuse-map 후보 등록\n  leerness audit [path] [--fix]                              # 1.9.35 --fix: session-handoff/current-state 자동 갱신\n  leerness verify-claim <T-ID> ... [--strict-claims]   # 1.9.26 verify-claim에 낙관적 표시 자동 검사 통합
   leerness lens [code|design|docs|test|security] [--json]   # 1.18.3 분야별 자기질문 품질 렌즈 + 분야간 인과관계 (완료 선언 전 자가 점검)\n  leerness reuse-map [path] [--all-apps] [--include p1,p2] [--strict-elements] [--json] # 1.9.18 중복/잠재중복/depends-on\n  leerness verify-claim <T-ID> [--path .] [--run-tests] [--json]   # 1.9.18-20 evidence 자동 검증 (1.9.20: scenes/scripts 등 도메인 폴더 + jest/mocha 파싱)\n  leerness verify-code [path] [--build] [--bench]  # 1.9.20 --bench: scripts.bench 추가 실행 + evidence 누적\n  leerness session close [path]\n  leerness route <task-type>\n  leerness self check [path]\n  leerness readme sync [path]\n  leerness consistency check [path]\n  leerness consistency merge-design-guide [path]\n  leerness plan show|init|add|drop|progress|sync [args]\n  leerness task list|add|update|drop|fix-evidence|relink [args]\n  leerness skill list|info <name>\n  leerness skill learn <id> --doc <url> --command "..." --capability "..." [--note ...]\n  leerness skill use <id> [--note ...]\n  leerness skill optimize <id> --before "..." --after "..." [--note ...]\n  leerness skill remove <id>\n  leerness skill consolidate [--threshold 0.3]\n  leerness gate [path]                       # verify+audit+scan+encoding+lazy
   leerness retro [path] [--days 7] [--all-apps] [--include p1,p2] [--json]  # 회고 (1.9.13~1.9.16)
@@ -20054,7 +20173,14 @@ async function main() {
     feature: 'feature add "<이름>" | feature list | feature show <ID> | feature link <A> <B> | feature impact <ID>',
     memory: 'memory search "<키>" [--json] | memory status | memory archive | memory restore',
   };
-  if (_GROUP_USAGE[cmd] && !args[1]) { failJson(has('--json'), 'subcommand_required', `${cmd} 하위명령 필요 — 사용법: leerness ${_GROUP_USAGE[cmd]}`); return; }
+  // 1.23.2 (UR-0010 Phase 7): 영어 자리표시자 병렬맵 — ko 맵은 불변(e2e 안전), en 은 <text>/<trigger>/<key>/<name>.
+  const _GROUP_USAGE_EN = {
+    rule: 'rule add "<text>" --trigger <trigger> | rule list | rule pause/resume/remove <ID> | rule verify',
+    skill: 'skill list | skill add <id> | skill use <id> | skill search "<key>" | skill match "<text>"',
+    feature: 'feature add "<name>" | feature list | feature show <ID> | feature link <A> <B> | feature impact <ID>',
+    memory: 'memory search "<key>" [--json] | memory status | memory archive | memory restore',
+  };
+  if (_GROUP_USAGE[cmd] && !args[1]) { const _gu = _uiLang(arg('--path', process.cwd())) === 'en' ? `${cmd} subcommand required — usage: leerness ${_GROUP_USAGE_EN[cmd]}` : `${cmd} 하위명령 필요 — 사용법: leerness ${_GROUP_USAGE[cmd]}`; failJson(has('--json'), 'subcommand_required', _gu); return; }
   // 1.9.437 (11th 외부평가 Codex P2, UR-0138): --json 모드 unknown command 도 순수 JSON.
   failJson(has('--json'), 'unknown_command', `알 수 없는 명령: ${cmd}  (leerness --help 로 전체 명령 확인)`);
   return;

package/package.json

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