leerness 1.9.336 → 1.9.338

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,37 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.9.338 — 2026-06-05 — UR-0025(심층): i18n STRINGS 서브시스템 분리
4
+
5
+ **🧩 i18n 문자열 서브시스템의 핵심(ko/en catalog + 순수 조회)을 모듈로 분리 — 동형 추출 6번째.** (UR-0025 심층, "UR-0053+UR-0025 둘 다 진행" 중 Round A)
6
+
7
+ ### 배경
8
+ constraints·intent-도메인·LSP·anti-laziness·persona에 이은 동형 추출 6번째. 사용자가 "UR-0053 + UR-0025 심층 둘 다 진행"을 지시 → 원자성·회귀격리를 위해 2 독립 라운드로 분리(Round A=UR-0025 i18n[decisions 무관, 저위험] → Round B=UR-0053 decisions canonical JSON). 17줄 catalog 라 전사 오류 회피용 일회용 마이그레이션 스크립트로 결정적 이동 후 삭제.
9
+
10
+ ### 구현 (UR-0025 심층)
11
+ 1. **`STRINGS`**(i18n ko/en catalog, 17키: install/repl/common) → `lib/catalogs.js`.
12
+ 2. **`_translate(strings, key, lang)`**(순수: catalog 주입, key→lang 값, fallback ko→key) → `lib/pure-utils.js`. harness `_t(key, lang)` = `_translate(STRINGS, key, lang)` 박막(호출처 0변경).
13
+ 3. selftest 85→86 · e2e 282→283.
14
+
15
+ ### 검증
16
+ - **selftest 86/86 PASS** · **E2E 283/283 PASS** (회귀 0).
17
+ - 실측: catalog 17키 · `_translate` ko/en/default·미존재키→키자체·null guard·en누락→ko fallback 정상. (`_t` 는 인터랙티브 install/REPL 전용 getter — 구조+순수동작 검증)
18
+
19
+ ## 1.9.337 — 2026-06-05 — UR-0025(심층): review persona 서브시스템 분리
20
+
21
+ **🧩 코드리뷰 persona 서브시스템의 핵심(5종 페르소나 catalog + 순수 요약 변환)을 모듈로 분리 — 동형 추출 5번째.** (UR-0025 심층)
22
+
23
+ ### 배경
24
+ constraints(1.9.333)·intent-도메인(1.9.334)·LSP(1.9.335)·anti-laziness(1.9.336)에 이은 동형 추출 5번째. 직전 Codex 위임에 이어 이번은 직접 구현(사용자 "일부" 위임 지시 — 1.9.334/336 위임·1.9.335/337 자체의 교대). template literal(백틱) 본문이 긴 catalog 라 전사 오류 회피용 일회용 마이그레이션 스크립트로 결정적 이동 후 삭제.
25
+
26
+ ### 구현 (UR-0025 심층)
27
+ 1. **`BUILT_IN_PERSONAS`**(5종 리뷰 페르소나 catalog: security/performance/ux/testing/docs, 각 id/name/description/body) → `lib/catalogs.js`.
28
+ 2. **`_personaSummaries(catalog)`**(순수: catalog → `[{id,name,description}]` 요약, body 제거) → `lib/pure-utils.js`. `persona list --json` 의 인라인 map 을 헬퍼 호출로 교체. `_resolvePersona`(fs fallback 포함)는 harness 유지하며 import 된 catalog 사용.
29
+ 3. selftest 84→85 · e2e 281→282.
30
+
31
+ ### 검증
32
+ - **selftest 85/85 PASS** · **E2E 282/282 PASS** (회귀 0).
33
+ - 실측: catalog 5종(security.body 문자열) · `_personaSummaries` 5요약(body 제거)·null guard([]) · `persona list --json` builtin 5 · `review <file> --persona security`(harness `_resolvePersona`→imported catalog) "보안 엔지니어" body 정상 출력.
34
+
3
35
  ## 1.9.336 — 2026-06-05 — UR-0025(심층): anti-laziness 서브시스템 분리 (Codex 위임·검증)
4
36
 
5
37
  **🤖 anti-laziness(거짓완료 탐지) 서브시스템의 핵심(claim-vs-code 패턴 catalog + 순수 탐지/신뢰도 로직)을 Codex CLI(gpt-5.5)에 위임 분리하고 하네스가 독립 검증까지 완료.** (사용자 "일부 Codex 위임" 지시 — 1.9.334 위임·1.9.335 자체 구현에 이은 교대)
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
4
4
  > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
5
5
 
6
- [![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.336-green)]() [![tests](https://img.shields.io/badge/e2e-281%2F281-success)]() [![selftest](https://img.shields.io/badge/selftest-84-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
6
+ [![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.338-green)]() [![tests](https://img.shields.io/badge/e2e-283%2F283-success)]() [![selftest](https://img.shields.io/badge/selftest-86-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
7
7
 
8
8
  ```
9
9
  ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
471
471
  <!-- leerness:project-readme:start -->
472
472
  ## Leerness Project Harness
473
473
 
474
- 이 프로젝트는 Leerness v1.9.336 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
474
+ 이 프로젝트는 Leerness v1.9.338 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
475
475
 
476
476
  ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
477
477
 
@@ -525,7 +525,7 @@ leerness memory restore decision <date|title>
525
525
 
526
526
  ### MCP server (외부 AI 통합)
527
527
 
528
- Leerness v1.9.336는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
528
+ Leerness v1.9.338는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
529
529
 
530
530
  ```jsonc
531
531
  // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.336는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
546
546
  `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
547
547
  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) 다음 라운드 예약.
548
548
 
549
- 현재 누적: **70 라운드 (1.9.40 → 1.9.336)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
549
+ 현재 누적: **70 라운드 (1.9.40 → 1.9.338)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
550
550
 
551
551
  ### 성능 가이드 (1.9.140 측정)
552
552
 
@@ -584,6 +584,6 @@ leerness release pack --close --auto-main-push
584
584
  - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
585
585
  - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
586
586
 
587
- Last synced by Leerness v1.9.336: 2026-06-05
587
+ Last synced by Leerness v1.9.338: 2026-06-05
588
588
  <!-- leerness:project-readme:end -->
589
589
 
package/bin/harness.js CHANGED
@@ -18,13 +18,14 @@ const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel,
18
18
  BRIEF_START, BRIEF_END, _briefReadmeBlock, _briefBlueprint,
19
19
  _parseLessonEntries, _matchConstraints, _matchDomain,
20
20
  _detectLspLang, _matchLspSymbols,
21
- _detectOptimism: _puDetectOptimism, _computeConfidence: _puComputeConfidence } = require('../lib/pure-utils'); // 1.9.318~335 (UR-0025): 순수 유틸 모듈 분리
21
+ _detectOptimism: _puDetectOptimism, _computeConfidence: _puComputeConfidence,
22
+ _personaSummaries, _translate } = require('../lib/pure-utils'); // 1.9.318~338 (UR-0025): 순수 유틸 모듈 분리
22
23
  // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
23
24
  const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
24
25
  // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
25
- const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS } = require('../lib/catalogs'); // 1.9.335 (UR-0025): LSP 패턴 catalog 분리
26
+ const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS } = require('../lib/catalogs'); // 1.9.338 (UR-0025): i18n STRINGS catalog 분리
26
27
 
27
- const VERSION = '1.9.336';
28
+ const VERSION = '1.9.338';
28
29
 
29
30
  // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
30
31
  // 이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -1972,29 +1973,7 @@ async function skillAutoCacheCmd(root, sub) {
1972
1973
  // 사용자 명시: "설치 가이드에서 언어 선택에 따라 설치 가이드 및 REPL agent 모드 등 설정된 언어로 표시"
1973
1974
  // 설계: 핵심 string table (ko/en) + _t(key, lang) helper. 설치 시 선택 언어 → .harness/LANGUAGE 저장.
1974
1975
  // lang 결정: explicit > .harness/LANGUAGE > LEERNESS_LANG env > 'ko' (default)
1975
- const STRINGS = {
1976
- // 설치 가이드 prompt
1977
- 'install.lang.title': { ko: '설치 언어를 선택하세요', en: 'Select install language' },
1978
- 'install.lang.auto': { ko: '자동 감지', en: 'Auto detect' },
1979
- 'install.lang.auto.desc': { ko: '디렉토리/파일 + 시스템(OS) 언어 자동 판별 (한국어/영어)', en: 'Auto-detect from dir/files + system (OS) locale (KO/EN)' },
1980
- 'install.lang.sysNotice': { ko: '시스템 언어 감지', en: 'System language detected' },
1981
- 'install.lang.ko': { ko: '한국어', en: 'Korean' },
1982
- 'install.lang.ko.desc': { ko: '모든 인스트럭션을 한국어로 생성', en: 'All instructions in Korean' },
1983
- 'install.lang.en': { ko: 'English', en: 'English' },
1984
- 'install.lang.en.desc': { ko: '모든 인스트럭션을 영어로 생성', en: 'All instructions in English' },
1985
- 'install.agents.title': { ko: 'CLI 에이전트 활성화 (복수 선택, Space 토글) — sub-agent 위임용',
1986
- en: 'Enable CLI agents (multi-select, Space toggle) — for sub-agent dispatch' },
1987
- 'install.agents.none': { ko: '선택 안함 (나중에 setup-agents)', en: 'None (later setup-agents)' },
1988
- 'install.complete': { ko: '✓ 설치 완료', en: '✓ Install complete' },
1989
- // REPL agent 모드
1990
- 'repl.welcome.title': { ko: 'leerness REPL agent', en: 'leerness REPL agent' },
1991
- 'repl.welcome.subtitle': { ko: 'Tab provider · Shift+Tab model · :help · /slash', en: 'Tab provider · Shift+Tab model · :help · /slash' },
1992
- 'repl.welcome.start': { ko: '시작하려면 메시지를 입력하세요', en: 'Type a message to start' },
1993
- // 공통
1994
- 'common.cancel': { ko: '취소됨', en: 'Cancelled' },
1995
- 'common.confirm': { ko: '확인', en: 'Confirm' },
1996
- 'common.ready': { ko: '준비 완료', en: 'Ready' }
1997
- };
1976
+ // 1.9.338 (UR-0025 심층): STRINGS (i18n ko/en catalog) 는 lib/catalogs.js 로 이전 (import). _t 는 _translate(STRINGS,..) 박막.
1998
1977
  // 현재 사용 언어 결정 (env > config > 'ko')
1999
1978
  function _currentLang(root) {
2000
1979
  if (process.env.LEERNESS_LANG) return process.env.LEERNESS_LANG === 'en' ? 'en' : 'ko';
@@ -2010,10 +1989,9 @@ function _currentLang(root) {
2010
1989
  } catch {}
2011
1990
  return 'ko'; // default
2012
1991
  }
1992
+ // 1.9.338 (UR-0025 심층): 순수 _translate(STRINGS, key, lang) (lib/pure-utils) 박막 — STRINGS catalog 주입.
2013
1993
  function _t(key, lang) {
2014
- const entry = STRINGS[key];
2015
- if (!entry) return key; // fallback: 키 자체 반환
2016
- return entry[lang || 'ko'] || entry.ko || key;
1994
+ return _translate(STRINGS, key, lang);
2017
1995
  }
2018
1996
 
2019
1997
  // 1.9.206: UI/UX 개선 — typewriter / fade-in 효과 (opt-in via LEERNESS_TYPEWRITER=1)
@@ -3083,6 +3061,8 @@ function _selfTestCases() {
3083
3061
  { name: 'UR-0025 심층(Codex 위임·검증): intent domain catalog→lib/catalogs + _matchDomain→pure-utils 분리 (1.9.334)', run: () => { const c = require('../lib/catalogs'); const m = require('../lib/pure-utils'); const catOk = c._DEFAULT_DOMAIN_CATALOG && Object.keys(c._DEFAULT_DOMAIN_CATALOG.domains).length === 5 && !!c._DEFAULT_DOMAIN_CATALOG.domains.game; const r = m._matchDomain(c._DEFAULT_DOMAIN_CATALOG, 'unity 게임'); const work = r.domain === 'game' && Array.isArray(r.components) && m._matchDomain(c._DEFAULT_DOMAIN_CATALOG, 'zzz없음').domain === null && m._matchDomain(null, 'x').domain === null; const src = read(__filename); const moved = _DEFAULT_DOMAIN_CATALOG === c._DEFAULT_DOMAIN_CATALOG && _matchDomain === m._matchDomain && !/const _DEFAULT_DOMAIN_CATALOG = \{/.test(src) && src.includes('_matchDomain(_loadDomainCatalog(root), text)'); return catOk && work && moved; } },
3084
3062
  { name: 'UR-0025 심층: LSP catalog→lib/catalogs(_LSP_LANG_PATTERNS) + _detectLspLang/_matchLspSymbols→pure-utils 분리 (1.9.335)', run: () => { const c = require('../lib/catalogs'); const m = require('../lib/pure-utils'); const catOk = c._LSP_LANG_PATTERNS && Object.keys(c._LSP_LANG_PATTERNS).length === 5 && Array.isArray(c._LSP_LANG_PATTERNS.javascript); const langOk = m._detectLspLang('a.py') === 'python' && m._detectLspLang('b.go') === 'go' && m._detectLspLang('c.md') === 'javascript'; const sy = m._matchLspSymbols(c._LSP_LANG_PATTERNS, 'function alpha(){}\nclass Beta{}', 'javascript'); const work = sy.length === 2 && sy[0].name === 'alpha' && sy[0].kind === 'function' && sy[1].kind === 'class' && m._matchLspSymbols(null, 'x', 'javascript').length === 0; const src = read(__filename); const moved = _LSP_LANG_PATTERNS === c._LSP_LANG_PATTERNS && _detectLspLang === m._detectLspLang && _matchLspSymbols === m._matchLspSymbols && !/const _LSP_LANG_PATTERNS = \{/.test(src) && !/function _detectLspLang\(/.test(src); return catOk && langOk && work && moved; } },
3085
3063
  { name: 'UR-0025 심층(Codex 위임·검증): anti-laziness catalog→lib/catalogs(OPTIMISM_PATTERNS) + optimism 순수로직→pure-utils 분리 (1.9.336)', run: () => { const c = require('../lib/catalogs'); const m = require('../lib/pure-utils'); const catOk = Array.isArray(c.OPTIMISM_PATTERNS) && c.OPTIMISM_PATTERNS.length === 10 && c.OPTIMISM_PATTERNS[0].kind === 'API'; const ev = 'API 호출 완료, POST /users'; const sus = m._detectOptimism(c.OPTIMISM_PATTERNS, ev, 'function x(){}'); const conf = m._computeConfidence(c.OPTIMISM_PATTERNS, ev, 'function x(){}'); const work = sus.some(s => s.kind === 'API' && s.severity === 'high') && conf < 0.5 && m._computeConfidence(c.OPTIMISM_PATTERNS, '정리함', 'x') === 1 && m._detectOptimism(null, ev, 'x').length === 0 && m._extractUrlClaims('POST /a').length === 1 && m._verifyUrlClaim({ path: '/a' }, 'has /a') === true; const src = read(__filename); const moved = OPTIMISM_PATTERNS === c.OPTIMISM_PATTERNS && _puDetectOptimism === m._detectOptimism && !/const OPTIMISM_PATTERNS = \[/.test(src) && !/function _extractUrlClaims\(/.test(src); return catOk && work && moved; } },
3064
+ { name: 'UR-0025 심층: persona catalog→lib/catalogs(BUILT_IN_PERSONAS) + _personaSummaries→pure-utils 분리 (1.9.337)', run: () => { const c = require('../lib/catalogs'); const m = require('../lib/pure-utils'); const catOk = c.BUILT_IN_PERSONAS && Object.keys(c.BUILT_IN_PERSONAS).length === 5 && c.BUILT_IN_PERSONAS.security && typeof c.BUILT_IN_PERSONAS.security.body === 'string'; const sm = m._personaSummaries(c.BUILT_IN_PERSONAS); const work = Array.isArray(sm) && sm.length === 5 && sm[0].id === 'security' && sm[0].body === undefined && typeof sm[0].name === 'string' && m._personaSummaries(null).length === 0; const src = read(__filename); const moved = BUILT_IN_PERSONAS === c.BUILT_IN_PERSONAS && _personaSummaries === m._personaSummaries && !/const BUILT_IN_PERSONAS = \{/.test(src); return catOk && work && moved; } },
3065
+ { name: 'UR-0025 심층: i18n STRINGS catalog→lib/catalogs + _translate→pure-utils 분리 (1.9.338)', run: () => { const c = require('../lib/catalogs'); const m = require('../lib/pure-utils'); const catOk = c.STRINGS && typeof c.STRINGS['common.ready'] === 'object' && c.STRINGS['common.ready'].en === 'Ready'; const work = m._translate(c.STRINGS, 'common.ready', 'en') === 'Ready' && m._translate(c.STRINGS, 'common.ready', 'ko') === '준비 완료' && m._translate(c.STRINGS, 'no.such.key', 'en') === 'no.such.key' && m._translate(null, 'x', 'ko') === 'x' && m._translate({ k: { ko: '케이' } }, 'k', 'en') === '케이'; const src = read(__filename); const moved = STRINGS === c.STRINGS && _translate === m._translate && !/const STRINGS = \{/.test(src); return catOk && work && moved; } },
3086
3066
  { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
3087
3067
  ];
3088
3068
  }
@@ -10108,53 +10088,7 @@ function optimismCheckCmd(root, taskId) {
10108
10088
 
10109
10089
  // 1.9.29: 페르소나 시스템 + review 명령
10110
10090
  // 페르소나 부여 sub-agent가 도메인 깊이 3-4배 (1.9.28 라운드 실측). 자동 프롬프트 생성.
10111
- const BUILT_IN_PERSONAS = {
10112
- security: {
10113
- id: 'security',
10114
- name: '보안 엔지니어 (10년차)',
10115
- description: 'OWASP Top 10, CWE, RFC, 한국 개인정보보호법/게임산업법 정통',
10116
- body: `너는 **10년 경력의 시니어 보안 엔지니어**다. OWASP Top 10 2021, CWE, RFC 7235/6454, CORS 보안, secret 관리에 정통하며, 한국 금융사·카카오·네이버 등 대형 IT 기업의 보안 감사 경험이 있다. 코드를 볼 때 **위협 모델링**과 **공격 표면(attack surface)** 을 자동으로 시각화한다.
10117
-
10118
- 검토 영역: 입력 검증 / 인증·인가 / CORS / 시크릿/로그 노출 / DoS / 데이터 노출 / 의존성 attack surface / 한국 시장 특화 (개인정보보호법, 결제 정보)
10119
- 보고에 포함: 위협 모델 / CWE ID 매핑 / 실 공격 시나리오 1건 (HTTP 페이로드) / P0/P1/P2 우선순위 / OWASP Top 10 2021 매핑`
10120
- },
10121
- performance: {
10122
- id: 'performance',
10123
- name: '성능 최적화 전문가 (V8 내부)',
10124
- description: 'V8 엔진 (Ignition/TurboFan, hidden class), Node.js 이벤트 루프, libuv 정통',
10125
- body: `너는 **V8 엔진 내부 (Ignition, TurboFan, hidden class)와 Node.js 이벤트 루프, libuv에 정통한 성능 최적화 전문가**다. Linux perf, node --prof, clinic.js, autocannon, FlameGraph 활용 경험이 풍부하다. 메모리 압박(GC pressure), CPU bound vs I/O bound 구분, hot path 식별이 직관이다.
10126
-
10127
- 검토 영역: Hot path 식별 / hidden class 안정성 / 메모리 할당 패턴 / 정규식 컴파일 / JSON.parse/stringify 비용 / 이벤트 루프 블로킹 / 라우트 매칭 복잡도
10128
- 보고에 포함: 성능 프로필 요약 (RPS/latency 추정) / Hot path Top 5 / 비효율 표 (영향 high/med/low) / 벤치 시나리오 (autocannon 명령) / 권장 우선순위 (당장/부하증가/마이크로)`
10129
- },
10130
- ux: {
10131
- id: 'ux',
10132
- name: '한국어 UX 라이터 + DX 컨설턴트',
10133
- description: '카카오/네이버/토스/라인 마이크로카피, API 디자인 (Stripe/GitHub/Google) 정통',
10134
- body: `너는 **한국 사용자 대상 게임/SaaS 제품의 UX 라이터 + DX(Developer Experience) 컨설턴트**다. 카카오, 네이버, 토스, 라인의 한국어 마이크로카피 가이드라인을 숙지하고 있으며, 클라이언트 개발자의 API 통합 경험을 잘 안다. 에러 메시지, HTTP status, 응답 본문 일관성이 직관이다.
10135
-
10136
- 검토 영역: 한국어 에러 메시지 톤 / HTTP status 적절성 (400/404/422/409) / 응답 본문 일관성 / 한국어/영문 혼재 / 누락 정보 (rate limit, request id, version) / 클라이언트 SDK 친화성
10137
- 보고에 포함: UX/DX 점수 (1-10) / 발견 이슈 표 / Before/After 메시지 5건 / SDK 친화성 점수 (1-5) / 권장 로드맵 (이번 PR / 1주 / 분기)`
10138
- },
10139
- testing: {
10140
- id: 'testing',
10141
- name: '테스트 엔지니어 (TDD + property-based)',
10142
- description: 'TDD, property-based testing (fast-check), AAA 패턴, fuzz, mutation testing 정통',
10143
- body: `너는 **TDD와 property-based testing (fast-check) 에 정통한 테스트 엔지니어**다. AAA 패턴, given/when/then, fuzz testing, mutation testing, contract testing 경험이 있다. 테스트 커버리지보다 **테스트 품질**과 **회귀 방어** 가치를 더 중시한다.
10144
-
10145
- 검토 영역: 테스트 누락 분기 / edge case / mocking 과다 / AAA 패턴 위반 / async 테스트 결함 (race) / property 후보 / 회귀 가능성
10146
- 보고에 포함: 누락 테스트 목록 + 우선순위 / fast-check property 후보 3건 / 기존 테스트 약점 / 권장 회귀 시나리오`
10147
- },
10148
- docs: {
10149
- id: 'docs',
10150
- name: '기술 문서 작성자 (한국어)',
10151
- description: 'README, API 문서, 사용 가이드 작성. Stripe Docs / Google Cloud / 카카오 dev 가이드 정통',
10152
- body: `너는 **한국어 기술 문서 작성에 정통한 테크니컬 라이터**다. Stripe Docs, Google Cloud, AWS, 카카오 개발자 가이드 톤을 잘 안다. README 첫 60초 경험, 점진적 공개 (progressive disclosure), 코드 예시의 즉시 실행 가능성을 중시한다.
10153
-
10154
- 검토 영역: 60초 시작 가능성 / 예시 코드 정확성 / 누락된 사전 요구사항 / 한국어 자연스러움 / 시각적 균형 (이모지/표/코드블록) / 한국어/영문 혼재 / 다음 단계 명시
10155
- 보고에 포함: 사용자 페르소나별 평가 (입문자/실무자/전문가) / 60초 안 첫 결과 가능 여부 / 누락 정보 / 권장 개선 표`
10156
- }
10157
- };
10091
+ // 1.9.337 (UR-0025 심층): BUILT_IN_PERSONAS (5 리뷰 페르소나 catalog) 는 lib/catalogs.js 로 이전 (import).
10158
10092
 
10159
10093
  function _resolvePersona(root, id) {
10160
10094
  // 1) 내장
@@ -11718,7 +11652,7 @@ function personaCmd(root, sub, idOrName, ...rest) {
11718
11652
  const custom = exists(customDir) ? fs.readdirSync(customDir).filter(f => f.endsWith('.md')).map(f => f.replace(/\.md$/, '')) : [];
11719
11653
  if (has('--json')) {
11720
11654
  log(JSON.stringify({
11721
- builtin: Object.values(BUILT_IN_PERSONAS).map(p => ({ id: p.id, name: p.name, description: p.description })),
11655
+ builtin: _personaSummaries(BUILT_IN_PERSONAS),
11722
11656
  custom
11723
11657
  }, null, 2));
11724
11658
  return;
package/lib/catalogs.js CHANGED
@@ -266,4 +266,80 @@ const OPTIMISM_PATTERNS = [
266
266
  label: '클라우드 스토리지' }
267
267
  ];
268
268
 
269
- module.exports = { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS };
269
+
270
+ // 1.9.337 (UR-0025 심층): 리뷰 페르소나 catalog (5종: security/performance/ux/testing/docs) — harness 에서 분리.
271
+ const BUILT_IN_PERSONAS = {
272
+ security: {
273
+ id: 'security',
274
+ name: '보안 엔지니어 (10년차)',
275
+ description: 'OWASP Top 10, CWE, RFC, 한국 개인정보보호법/게임산업법 정통',
276
+ body: `너는 **10년 경력의 시니어 보안 엔지니어**다. OWASP Top 10 2021, CWE, RFC 7235/6454, CORS 보안, secret 관리에 정통하며, 한국 금융사·카카오·네이버 등 대형 IT 기업의 보안 감사 경험이 있다. 코드를 볼 때 **위협 모델링**과 **공격 표면(attack surface)** 을 자동으로 시각화한다.
277
+
278
+ 검토 영역: 입력 검증 / 인증·인가 / CORS / 시크릿/로그 노출 / DoS / 데이터 노출 / 의존성 attack surface / 한국 시장 특화 (개인정보보호법, 결제 정보)
279
+ 보고에 포함: 위협 모델 / CWE ID 매핑 / 실 공격 시나리오 1건 (HTTP 페이로드) / P0/P1/P2 우선순위 / OWASP Top 10 2021 매핑`
280
+ },
281
+ performance: {
282
+ id: 'performance',
283
+ name: '성능 최적화 전문가 (V8 내부)',
284
+ description: 'V8 엔진 (Ignition/TurboFan, hidden class), Node.js 이벤트 루프, libuv 정통',
285
+ body: `너는 **V8 엔진 내부 (Ignition, TurboFan, hidden class)와 Node.js 이벤트 루프, libuv에 정통한 성능 최적화 전문가**다. Linux perf, node --prof, clinic.js, autocannon, FlameGraph 활용 경험이 풍부하다. 메모리 압박(GC pressure), CPU bound vs I/O bound 구분, hot path 식별이 직관이다.
286
+
287
+ 검토 영역: Hot path 식별 / hidden class 안정성 / 메모리 할당 패턴 / 정규식 컴파일 / JSON.parse/stringify 비용 / 이벤트 루프 블로킹 / 라우트 매칭 복잡도
288
+ 보고에 포함: 성능 프로필 요약 (RPS/latency 추정) / Hot path Top 5 / 비효율 표 (영향 high/med/low) / 벤치 시나리오 (autocannon 명령) / 권장 우선순위 (당장/부하증가/마이크로)`
289
+ },
290
+ ux: {
291
+ id: 'ux',
292
+ name: '한국어 UX 라이터 + DX 컨설턴트',
293
+ description: '카카오/네이버/토스/라인 마이크로카피, API 디자인 (Stripe/GitHub/Google) 정통',
294
+ body: `너는 **한국 사용자 대상 게임/SaaS 제품의 UX 라이터 + DX(Developer Experience) 컨설턴트**다. 카카오, 네이버, 토스, 라인의 한국어 마이크로카피 가이드라인을 숙지하고 있으며, 클라이언트 개발자의 API 통합 경험을 잘 안다. 에러 메시지, HTTP status, 응답 본문 일관성이 직관이다.
295
+
296
+ 검토 영역: 한국어 에러 메시지 톤 / HTTP status 적절성 (400/404/422/409) / 응답 본문 일관성 / 한국어/영문 혼재 / 누락 정보 (rate limit, request id, version) / 클라이언트 SDK 친화성
297
+ 보고에 포함: UX/DX 점수 (1-10) / 발견 이슈 표 / Before/After 메시지 5건 / SDK 친화성 점수 (1-5) / 권장 로드맵 (이번 PR / 1주 / 분기)`
298
+ },
299
+ testing: {
300
+ id: 'testing',
301
+ name: '테스트 엔지니어 (TDD + property-based)',
302
+ description: 'TDD, property-based testing (fast-check), AAA 패턴, fuzz, mutation testing 정통',
303
+ body: `너는 **TDD와 property-based testing (fast-check) 에 정통한 테스트 엔지니어**다. AAA 패턴, given/when/then, fuzz testing, mutation testing, contract testing 경험이 있다. 테스트 커버리지보다 **테스트 품질**과 **회귀 방어** 가치를 더 중시한다.
304
+
305
+ 검토 영역: 테스트 누락 분기 / edge case / mocking 과다 / AAA 패턴 위반 / async 테스트 결함 (race) / property 후보 / 회귀 가능성
306
+ 보고에 포함: 누락 테스트 목록 + 우선순위 / fast-check property 후보 3건 / 기존 테스트 약점 / 권장 회귀 시나리오`
307
+ },
308
+ docs: {
309
+ id: 'docs',
310
+ name: '기술 문서 작성자 (한국어)',
311
+ description: 'README, API 문서, 사용 가이드 작성. Stripe Docs / Google Cloud / 카카오 dev 가이드 정통',
312
+ body: `너는 **한국어 기술 문서 작성에 정통한 테크니컬 라이터**다. Stripe Docs, Google Cloud, AWS, 카카오 개발자 가이드 톤을 잘 안다. README 첫 60초 경험, 점진적 공개 (progressive disclosure), 코드 예시의 즉시 실행 가능성을 중시한다.
313
+
314
+ 검토 영역: 60초 시작 가능성 / 예시 코드 정확성 / 누락된 사전 요구사항 / 한국어 자연스러움 / 시각적 균형 (이모지/표/코드블록) / 한국어/영문 혼재 / 다음 단계 명시
315
+ 보고에 포함: 사용자 페르소나별 평가 (입문자/실무자/전문가) / 60초 안 첫 결과 가능 여부 / 누락 정보 / 권장 개선 표`
316
+ }
317
+ };
318
+
319
+
320
+ // 1.9.338 (UR-0025 심층): i18n 문자열 catalog (ko/en) — harness 에서 분리. 조회는 순수 _translate(STRINGS, key, lang).
321
+ const STRINGS = {
322
+ // 설치 가이드 prompt
323
+ 'install.lang.title': { ko: '설치 언어를 선택하세요', en: 'Select install language' },
324
+ 'install.lang.auto': { ko: '자동 감지', en: 'Auto detect' },
325
+ 'install.lang.auto.desc': { ko: '디렉토리/파일 + 시스템(OS) 언어 자동 판별 (한국어/영어)', en: 'Auto-detect from dir/files + system (OS) locale (KO/EN)' },
326
+ 'install.lang.sysNotice': { ko: '시스템 언어 감지', en: 'System language detected' },
327
+ 'install.lang.ko': { ko: '한국어', en: 'Korean' },
328
+ 'install.lang.ko.desc': { ko: '모든 인스트럭션을 한국어로 생성', en: 'All instructions in Korean' },
329
+ 'install.lang.en': { ko: 'English', en: 'English' },
330
+ 'install.lang.en.desc': { ko: '모든 인스트럭션을 영어로 생성', en: 'All instructions in English' },
331
+ 'install.agents.title': { ko: 'CLI 에이전트 활성화 (복수 선택, Space 토글) — sub-agent 위임용',
332
+ en: 'Enable CLI agents (multi-select, Space toggle) — for sub-agent dispatch' },
333
+ 'install.agents.none': { ko: '선택 안함 (나중에 setup-agents)', en: 'None (later setup-agents)' },
334
+ 'install.complete': { ko: '✓ 설치 완료', en: '✓ Install complete' },
335
+ // REPL agent 모드
336
+ 'repl.welcome.title': { ko: 'leerness REPL agent', en: 'leerness REPL agent' },
337
+ 'repl.welcome.subtitle': { ko: 'Tab provider · Shift+Tab model · :help · /slash', en: 'Tab provider · Shift+Tab model · :help · /slash' },
338
+ 'repl.welcome.start': { ko: '시작하려면 메시지를 입력하세요', en: 'Type a message to start' },
339
+ // 공통
340
+ 'common.cancel': { ko: '취소됨', en: 'Cancelled' },
341
+ 'common.confirm': { ko: '확인', en: 'Confirm' },
342
+ 'common.ready': { ko: '준비 완료', en: 'Ready' }
343
+ };
344
+
345
+ module.exports = { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS };
package/lib/pure-utils.js CHANGED
@@ -503,6 +503,18 @@ function _computeConfidence(patterns, evidence, codeText) {
503
503
  return Math.round(confidence * 100) / 100;
504
504
  }
505
505
 
506
+ // 1.9.337 (UR-0025 심층): persona catalog → 요약 목록 (id/name/description) 순수 변환 (list 명령 JSON 경로)
507
+ function _personaSummaries(catalog) {
508
+ return Object.values(catalog || {}).map(p => ({ id: p.id, name: p.name, description: p.description }));
509
+ }
510
+
511
+ // 1.9.338 (UR-0025 심층): i18n 순수 조회 — strings catalog 주입, key → lang 값 (fallback: ko → key 자체)
512
+ function _translate(strings, key, lang) {
513
+ const entry = strings && strings[key];
514
+ if (!entry) return key;
515
+ return entry[lang || 'ko'] || entry.ko || key;
516
+ }
517
+
506
518
  module.exports = {
507
519
  _isSecretKey, compareVer, parseHarnessVersion,
508
520
  _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
@@ -535,5 +547,9 @@ module.exports = {
535
547
  // 1.9.335 (UR-0025 심층): LSP 서브시스템 — 순수 언어감지 + 정규식 심볼 매처
536
548
  _detectLspLang, _matchLspSymbols,
537
549
  // anti-laziness optimism-check 순수 로직
538
- _extractUrlClaims, _verifyUrlClaim, _detectOptimism, _computeConfidence
550
+ _extractUrlClaims, _verifyUrlClaim, _detectOptimism, _computeConfidence,
551
+ // 1.9.337 (UR-0025 심층): persona 요약 목록
552
+ _personaSummaries,
553
+ // 1.9.338 (UR-0025 심층): i18n 순수 조회
554
+ _translate
539
555
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "leerness",
3
- "version": "1.9.336",
3
+ "version": "1.9.338",
4
4
  "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
5
5
  "keywords": [
6
6
  "leerness",
package/scripts/e2e.js CHANGED
@@ -4221,5 +4221,60 @@ total++;
4221
4221
  if (!ok) failed++;
4222
4222
  }
4223
4223
 
4224
+ // 1.9.337 회귀 (UR-0025 심층): persona BUILT_IN_PERSONAS→lib/catalogs + _personaSummaries→pure-utils + persona list/review 회귀
4225
+ total++;
4226
+ {
4227
+ let ok = false;
4228
+ try {
4229
+ const c = require(path.resolve(__dirname, '..', 'lib', 'catalogs.js'));
4230
+ const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
4231
+ const catOk = c.BUILT_IN_PERSONAS && Object.keys(c.BUILT_IN_PERSONAS).length === 5 && c.BUILT_IN_PERSONAS.security && typeof c.BUILT_IN_PERSONAS.security.body === 'string';
4232
+ const sm = m._personaSummaries(c.BUILT_IN_PERSONAS);
4233
+ const work = catOk && typeof m._personaSummaries === 'function' && Array.isArray(sm) && sm.length === 5 && sm[0].id === 'security' && sm[0].body === undefined && m._personaSummaries(null).length === 0;
4234
+ const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
4235
+ const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0]; // import 순서/추가 비의존
4236
+ const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
4237
+ const movedOut = !/const BUILT_IN_PERSONAS = \{/.test(harnessSrc) && _catImp.includes('BUILT_IN_PERSONAS') && _puImp.includes('_personaSummaries');
4238
+ // 소비 명령 회귀: persona list --json (_personaSummaries) + review --persona (_resolvePersona → imported catalog)
4239
+ const pd = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-per-'));
4240
+ cp.spawnSync(process.execPath, [CLI, 'init', pd, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
4241
+ const lr = cp.spawnSync(process.execPath, [CLI, 'persona', 'list', '--path', pd, '--json'], { encoding: 'utf8', timeout: 20000 });
4242
+ let listOk = false;
4243
+ try { const j = JSON.parse(lr.stdout); listOk = Array.isArray(j.builtin) && j.builtin.length === 5 && j.builtin.some(p => p.id === 'security') && j.builtin[0].body === undefined; } catch {}
4244
+ fs.writeFileSync(path.join(pd, 't.js'), 'function q(){ return 1; }\n', 'utf8');
4245
+ const rr = cp.spawnSync(process.execPath, [CLI, 'review', path.join(pd, 't.js'), '--persona', 'security', '--path', pd], { encoding: 'utf8', timeout: 20000 });
4246
+ const reviewOk = /보안 엔지니어/.test(rr.stdout || '');
4247
+ ok = work && movedOut && listOk && reviewOk;
4248
+ fs.rmSync(pd, { recursive: true, force: true });
4249
+ } catch {}
4250
+ console.log(ok ? '✓ B(1.9.337) UR-0025 심층: persona BUILT_IN_PERSONAS/_personaSummaries 분리 + persona list/review 회귀 (UR-0025)' : '✗ persona 서브시스템 분리 실패');
4251
+ if (!ok) failed++;
4252
+ }
4253
+
4254
+ // 1.9.338 회귀 (UR-0025 심층): i18n STRINGS→lib/catalogs + _translate→pure-utils + _t 박막 (인터랙티브 전용 getter라 구조+순수동작 검증)
4255
+ total++;
4256
+ {
4257
+ let ok = false;
4258
+ try {
4259
+ const c = require(path.resolve(__dirname, '..', 'lib', 'catalogs.js'));
4260
+ const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
4261
+ const catOk = c.STRINGS && typeof c.STRINGS['common.ready'] === 'object' && c.STRINGS['common.ready'].en === 'Ready' && c.STRINGS['common.ready'].ko === '준비 완료';
4262
+ const work = catOk && typeof m._translate === 'function'
4263
+ && m._translate(c.STRINGS, 'common.ready', 'en') === 'Ready'
4264
+ && m._translate(c.STRINGS, 'common.ready', 'ko') === '준비 완료'
4265
+ && m._translate(c.STRINGS, 'no.such.key', 'en') === 'no.such.key'
4266
+ && m._translate(null, 'x', 'ko') === 'x'
4267
+ && m._translate({ k: { ko: '케이' } }, 'k', 'en') === '케이';
4268
+ const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
4269
+ const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0]; // import 순서/추가 비의존
4270
+ const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
4271
+ // _t 박막: 인라인 STRINGS 정의 제거 + import + _translate(STRINGS,..) 호출
4272
+ const movedOut = !/const STRINGS = \{/.test(harnessSrc) && _catImp.includes('STRINGS') && _puImp.includes('_translate') && harnessSrc.includes('return _translate(STRINGS, key, lang)');
4273
+ ok = work && movedOut;
4274
+ } catch {}
4275
+ console.log(ok ? '✓ B(1.9.338) UR-0025 심층: i18n STRINGS/_translate 분리 + _t 박막 (UR-0025)' : '✗ i18n 서브시스템 분리 실패');
4276
+ if (!ok) failed++;
4277
+ }
4278
+
4224
4279
  console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
4225
4280
  if (failed > 0) process.exit(1);