leerness 1.9.418 → 1.9.420

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## 1.9.420 — 2026-06-07 — 무거움 점진 해소: reviewRequestCmd → lib/review-request.js 모듈화 (UR-0025/UR-0125)
+
+**🪶 `bin/leerness.js`(21k줄/1.3MB) 무거움 점진 해소 — `review-request` 핸들러(277줄)를 lib/ 로 DI 분리.**
+
+### 배경
+실현가능성 조사(3-에이전트)에서 무거움=MODERATE, 큰 핸들러 점진 추출 권장. 후보별 외부 의존 footprint 측정 결과 **reviewRequestCmd(285줄, 의존 최소)**가 최저 위험 → 첫 추출 대상으로 선정(안정성 우선).
+
+### 변경
+- `lib/review-request.js` 신설(288줄): `reviewRequestCmd(root, request, deps)` — io 프리미티브는 `./io`, `cp`/`path` 빌트인, harness 고유 의존(`has`·`harnessPath`·`_checkRequestConstraints`·`_recordRun`)은 **DI 주입**(기존 doctor/team/migrate/feature 패턴 동일).
+- `bin/leerness.js`: 277줄 함수 → **3줄 thin wrapper** 위임. **21,177 → 20,903줄(−274)**.
+- 동작/출력 **무변경**(텍스트·--json·빈입력 가드 동일).
+
+### 검증 (회귀 0)
+- **selftest 165→166 PASS** (모듈 존재 + DI 위임 + 인라인 제거 + estimatedType/recommendedSteps 동작).
+- **E2E 419→420 PASS**.
+
+### 무거움 진행 (UR-0125, 다음 라운드)
+다음 추출 후보(의존 footprint 순): audit(~9) → driftCheck(~13) → healthCmd(~24) → handoff(1434줄, 최대/최고결합). 라운드마다 1개씩 안전 추출.
+
+## 1.9.419 — 2026-06-07 — 엔트리 파일명 변경: bin/harness.js → bin/leerness.js (네이밍 일관성, UR-0126)
+
+**📛 패키지 엔트리 파일명을 `bin/harness.js` → `bin/leerness.js` 로 변경 — 명령어(`leerness`)와 파일명 일치.**
+
+### 배경
+파일명 `harness.js` 는 초기 잔재로, 명령어/패키지명(`leerness`)과 불일치했습니다. 3-에이전트 실현가능성 조사 결과 **EASY/안전**(명령어는 이미 `leerness`, 내부 참조는 `__filename`/`path.resolve` 기반이라 자동 대응)으로 판정되어 실행.
+
+### 변경
+- `git mv bin/harness.js bin/leerness.js` (히스토리 보존).
+- `package.json`: `bin.leerness` / `main` / npm scripts(test/test:fast/prepack) → `bin/leerness.js`.
+- `scripts/e2e.js`(35건)·`scripts/smoke.js`·`.github/workflows/ci.yml`·`docs/PUBLISH_PRECHECK.md` 경로 참조 갱신.
+- 내부 self-invocation/진단(`harnessPath: __filename`)·selftest(`read(__filename)`)는 런타임 자동 — 무변경.
+- next-action 제안 문자열 1건 `node ./bin/harness.js whats-new` → `leerness whats-new`.
+
+### 사용자 영향
+**없음** — 설치/실행은 `leerness` 명령(불변). 파일을 직접 호출하지 않음. 기존 워크스페이스(.harness)·상태도 불변.
+
+### 검증 (회귀 0)
+- **selftest 164→165 PASS** (신규 구조 가드: bin 파일=leerness.js + package.json bin/main 일치).
+- **E2E 418→419 PASS** (CLI 경로 변경 후 전체 스모크).
+
+### 참고 (조사 결과 — 다음 라운드)
+- harness.js 무거움(21k줄) → UR-0125 점진 모듈화(handoff 등 DI 추출).
+- `.harness`→`.leerness` 폴더명 → UR-0127 **직접 변경 비권장**(기존 .leerness 상태 substrate 충돌) — 상태기판 격리(대안 A) 권장.
+
 ## 1.9.418 — 2026-06-07 — health 보안 정직화 + status "healthy" 의미 명시 (9번째 외부평가 Codex P2, UR-0121 잔여)
 
 **🩺 `health`/`status` 의 "healthy" 가 프로젝트 안전을 뜻하는 듯 오해되던 것(Codex P2) 보강 — 정직성 일관 적용.**

package/README.md

@@ -3,7 +3,7 @@
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.418-green)]() [![tests](https://img.shields.io/badge/e2e-357%2F357-success)]() [![selftest](https://img.shields.io/badge/selftest-164-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-85-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.420-green)]() [![tests](https://img.shields.io/badge/e2e-357%2F357-success)]() [![selftest](https://img.shields.io/badge/selftest-166-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-85-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.418 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.420 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -525,7 +525,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.418는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.9.420는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.418는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<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.9.418)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.420)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -584,6 +584,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.9.418: 2026-06-07
+Last synced by Leerness v1.9.420: 2026-06-07
 <!-- leerness:project-readme:end -->
 

package/bin/{harness.js → leerness.js}

@@ -31,7 +31,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, _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 분리 (MERGE_OVERWRITE_FILES/MINIMAL_SKIP_KEYS 포함)
 
-const VERSION = '1.9.418';
+const VERSION = '1.9.420';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3072,6 +3072,28 @@ function _selfTestCases() {
       return handoffWired && scanJson && encJson && contractExit && behav;
     } },
     { name: '9라운드 (UR-0119/0120): team review(메인 검수) — _composeTeamPlan reviewStep + handoff 검수필요 + team add 와이어 (1.9.414)', run: () => { const m = require('../lib/pure-utils'); const on = m._composeTeamPlan({ id: 't', members: ['a', 'b'], personas: ['security'] }, '점검'); const off = m._composeTeamPlan({ id: 't', members: ['a'], review: false }, '점검'); const planOk = on.review === true && !!on.reviewStep && on.reviewStep.suggestedCommand.includes('verify-claim') && off.review === false && !off.reviewStep; const rem = m._teamHandoffReminders([{ id: 'r', schedule: 'every-session', status: 'active', members: ['a'], review: true }]); const remOk = rem.length === 1 && rem[0].includes('검수필요'); const teamSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'team.js')); const wired = teamSrc.includes("review: !has('--no-review')") && teamSrc.includes('메인 검수 (필수)'); return planOk && remOk && wired; } },
+    { name: '파일명 변경 (UR-0126): bin 파일=leerness.js + package.json bin/main 일치 (1.9.419)', run: () => { const okName = path.basename(__filename) === 'leerness.js'; let pkg; try { pkg = require('../package.json'); } catch { return false; } const okBin = pkg && pkg.bin && pkg.bin.leerness === 'bin/leerness.js' && pkg.main === 'bin/leerness.js'; return okName && okBin; } },
+    { name: 'UR-0025 큰핸들러 모듈화 5번째: reviewRequestCmd → lib/review-request.js + DI 위임 + 동작 (1.9.420)', run: () => {
+      const m = require('../lib/review-request');
+      const expOk = typeof m.reviewRequestCmd === 'function';
+      const src = read(__filename);
+      const delegated = src.includes("require('../lib/review-request')") && src.includes('_reviewRequest.reviewRequestCmd(root, request,');
+      const modSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'review-request.js'));
+      // thin wrapper 는 같은 시그니처를 유지하므로(시그니처 부재로 판정 X), 본문 고유 마커(routeKw)가 lib 로 이동했는지로 검증.
+      const bodyMarker = 'const route' + 'Kw = {';  // split-literal: 자기참조(이 케이스 코드가 src 에 포함) 회피
+      const movedToLib = modSrc.includes("require('./io')") && modSrc.includes('estimatedType') && modSrc.includes('harnessPath') && modSrc.includes(bodyMarker) && !src.includes(bodyMarker);
+      let behavOk = false;
+      const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_rr_'));
+      const _w = process.stdout.write; let out = '';
+      try {
+        fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true });
+        process.stdout.write = s => { out += s; return true; };
+        // harnessPath 를 존재하지 않는 경로로 → 내부 brainstorm spawn 즉시 실패(무부작용). estimatedType/steps 는 spawn 이전 계산이라 검증 가능.
+        m.reviewRequestCmd(tmp, '결제 기능 추가 구현', { has: () => true, harnessPath: path.join(tmp, '__nope.js'), _checkRequestConstraints: () => ({ matched: [], suggestions: [] }), _recordRun: () => {} });
+      } catch {} finally { process.stdout.write = _w; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} }
+      try { const j = JSON.parse(out); behavOk = j.estimatedType === 'feature' && Array.isArray(j.recommendedSteps) && j.recommendedSteps.length === 5; } catch {}
+      return expOk && delegated && movedToLib && behavOk;
+    } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -5709,7 +5731,7 @@ function _suggestNextActions(root, latestRow, keyword) {
   // 6) CHANGELOG / README 버전 일치 확인 (1.9.X bump 후 자주 누락되는 단계)
   try {
     if (/(\d\.\d\.\d+)/.test(taskText) || /(bump|version|release)/i.test(taskText)) {
-      actions.push({ icon: '📝', title: `버전 변동 task — CHANGELOG.md / README.md 갱신 확인`, command: `node ./bin/harness.js whats-new .` });
+      actions.push({ icon: '📝', title: `버전 변동 task — CHANGELOG.md / README.md 갱신 확인`, command: `leerness whats-new .` });
     }
   } catch {}
 
@@ -20417,283 +20439,9 @@ function lspCmd(root, sub, ...args) {
 //
 //   REPL: :review <request> (1.9.175 slash 패턴)
 //   MCP : leerness_review_request (외부 AI 직접 호출)
-function reviewRequestCmd(root, request) {
-  root = absRoot(root || process.cwd());
-  if (!request || !String(request).trim()) {
-    return fail('leerness review-request "<request>" — 사용자 요청 텍스트 필요');
-  }
-  const t0 = Date.now();
-  const text = String(request).trim();
-
-  // 1) 작업 유형 추정 (route 기반 키워드 매핑)
-  const lower = text.toLowerCase();
-  const routeKw = {
-    bugfix:      ['버그', '오류', '에러', '수정', '고쳐', '실패', 'fix', 'bug', 'error'],
-    refactor:    ['리팩토', '재구성', '정리', '개선', 'refactor', 'cleanup'],
-    feature:     ['추가', '구현', '만들', '새', '기능', 'add', 'implement', 'feature', 'create', 'new'],
-    research:    ['조사', '분석', '비교', '검토', '연구', 'research', 'analyze', 'compare', 'investigate'],
-    planning:    ['계획', '설계', '로드맵', 'plan', 'design', 'architecture', 'roadmap'],
-    release:     ['배포', '릴리즈', '버전', 'release', 'deploy', 'publish'],
-    consistency: ['일관성', '통합', '동기화', '맞춰', 'consistency', 'sync', 'align']
-  };
-  let estimatedType = 'feature';  // default
-  let maxScore = 0;
-  for (const [type, kws] of Object.entries(routeKw)) {
-    const score = kws.filter(k => lower.includes(k)).length;
-    if (score > maxScore) { maxScore = score; estimatedType = type; }
-  }
-
-  // 2) 기존 자원 회수 — brainstorm spawn (모든 surface 통합 회수)
-  const conflictHints = [];  // ⚠ 같은 키워드 + 실패/오류 패턴
-  const reuseCandidates = []; // 🔁 기존 skill / reuse-map / decision 후보
-  const lessonsRecall = [];   // 🧠 과거 lesson
-  const planConflicts = [];   // 📋 진행 중 milestone과 충돌 가능
-
-  // brainstorm 호출 (1.9.13~) — JSON 결과 회수
-  try {
-    const r = cp.spawnSync(process.execPath, [__filename, 'brainstorm', text, '--path', root, '--json'], {
-      encoding: 'utf8', timeout: 12000,
-      env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
-    });
-    if (r.stdout) {
-      const j = JSON.parse(r.stdout);
-      const hits = j.hits || {};
-      // decisions — 과거 결정 후보
-      (hits.decisions || []).slice(0, 5).forEach(d => {
-        lessonsRecall.push({ kind: 'decision', title: d.title, line: d.line, preview: (d.preview || '').slice(0, 100) });
-      });
-      // lessons — 과거 교훈 (특히 실패 키워드)
-      (hits.lessons || []).slice(0, 5).forEach(l => {
-        const preview = (l.text || l.preview || '').slice(0, 100);
-        const isFailure = /실패|오류|에러|fail|error|bug|문제|warning/i.test(preview);
-        if (isFailure) {
-          conflictHints.push({ kind: 'lesson-failure', preview, tags: l.tags });
-        } else {
-          lessonsRecall.push({ kind: 'lesson', preview, tags: l.tags });
-        }
-      });
-      // skills — 기존 skill 후보
-      (hits.skills || []).slice(0, 3).forEach(s => {
-        reuseCandidates.push({ kind: 'skill', id: s.id, displayNameKo: s.displayNameKo, capabilities: s.capabilities });
-      });
-      // tasks — 진행 중 task 충돌
-      (hits.tasks || []).slice(0, 3).forEach(tsk => {
-        if (tsk.status && /in-progress|진행/.test(String(tsk.status))) {
-          conflictHints.push({ kind: 'task-in-progress', id: tsk.id, title: tsk.title });
-        }
-      });
-      // plan milestones — 진행 중 milestone
-      (hits.planMilestones || []).slice(0, 3).forEach(m => {
-        if (m.status && /in-progress|진행/.test(String(m.status))) {
-          planConflicts.push({ kind: 'milestone-in-progress', id: m.id, title: m.title });
-        }
-      });
-      // taskLogFails — 과거 같은 키워드 실패 흔적
-      (hits.taskLogFails || []).slice(0, 3).forEach(f => {
-        conflictHints.push({ kind: 'task-log-failure', preview: (f.preview || f.text || '').slice(0, 100) });
-      });
-    }
-  } catch {}
-
-  // 3) reuse-map 매칭 — 기존 capability 등록 후보
-  try {
-    const reusePath = path.join(root, '.harness/reuse-map.md');
-    if (exists(reusePath)) {
-      const reuseLines = read(reusePath).split('\n');
-      const tokens = lower.split(/\s+/).filter(t => t.length >= 3);
-      for (const line of reuseLines) {
-        if (!/^\| /.test(line)) continue;  // 테이블 row만
-        const ll = line.toLowerCase();
-        const matched = tokens.filter(t => ll.includes(t)).length;
-        if (matched > 0) {
-          const cols = line.split('|').map(s => s.trim());
-          if (cols[1]) {
-            reuseCandidates.push({ kind: 'reuse-map', capability: cols[1], where: cols[2] || '', note: cols[3] || '' });
-          }
-        }
-      }
-    }
-  } catch {}
-
-  // 4) feature_graph — 같은 영역 변경 가능성
-  const featureConflicts = [];
-  try {
-    const fgPath = path.join(root, '.harness/feature_graph.md');
-    if (exists(fgPath)) {
-      const fg = read(fgPath);
-      const tokens = lower.split(/\s+/).filter(t => t.length >= 4);
-      // F-XXXX 노드 라인 추출
-      const nodeBlocks = fg.split(/\n### /);
-      for (const blk of nodeBlocks.slice(1)) {
-        const bl = blk.toLowerCase();
-        const matched = tokens.filter(t => bl.includes(t)).length;
-        if (matched > 0) {
-          const titleMatch = blk.match(/^([^\n]+)/);
-          const idMatch = blk.match(/F-\d+/);
-          if (titleMatch && idMatch) {
-            featureConflicts.push({ kind: 'feature', id: idMatch[0], title: titleMatch[1].trim() });
-          }
-        }
-      }
-    }
-  } catch {}
-
-  // 5) 권장 단계 (작업 유형별)
-  const recommendedSteps = {
-    feature: [
-      '1) leerness reuse-check "<기능>" — 외부 OSS 빌드 vs 재사용 판단 (1.9.285)',
-      '2) leerness reuse find "<핵심 capability>" — 내부 중복 구현 사전 차단',
-      '3) leerness plan add "<milestone>" — 진행 추적',
-      '4) leerness contract verify SPEC.md src/<mod>.js — 사양 ↔ 구현 일치 검증',
-      '5) verify-claim --run-tests 로 evidence 의무화'
-    ],
-    bugfix: [
-      '1) leerness brainstorm "<버그 키워드>" — 과거 같은 영역 lesson 회수',
-      '2) leerness verify-claim T-XXX --strict-claims — 낙관적 표시 사전 감지',
-      '3) verify-code --run-tests — 재현 + fix 검증',
-      '4) leerness lesson save "<root cause>" — 같은 실수 재발 차단'
-    ],
-    refactor: [
-      '1) leerness reuse-map — 영향 범위 파악',
-      '2) leerness impact <file> — 강한/약한 참조 분리',
-      '3) leerness contract verify — 외부 인터페이스 보존 확인',
-      '4) verify-code --run-tests + 회귀 테스트'
-    ],
-    research: [
-      '1) leerness brainstorm "<주제>" — 누적 컨텍스트 회수',
-      '2) leerness lessons --query "<주제>" — 과거 같은 영역 결정',
-      '3) leerness review <file> --persona research — 깊이 검토',
-      '4) leerness decision add "<결론>" — 회수 가능하게 영구화'
-    ],
-    planning: [
-      '1) leerness plan add "<milestone>" — 분해 시작',
-      '2) leerness reuse-map — 기존 자원 인벤토리',
-      '3) leerness agents recommend planning — sub-agent 분배',
-      '4) leerness session close — 결정 영구화'
-    ],
-    release: [
-      '1) leerness health — production-ready 확인',
-      '2) leerness audit + verify-code — 보안 + 검수',
-      '3) leerness release bump + note + publish'
-    ],
-    consistency: [
-      '1) leerness audit — design/reuse/handoff 일관성 검사',
-      '2) leerness consistency check — 잠재 일관성 위반',
-      '3) leerness drift check --auto-fix — 자동 회복'
-    ]
-  }[estimatedType] || [];
-
-  // 6) 효율 제안 (적용 가능한 sub-agent + skill)
-  const efficiencyHints = [];
-  if (reuseCandidates.length > 0) {
-    efficiencyHints.push(`🔁 기존 자원 ${reuseCandidates.length}건 발견 — 신규 구현 전 재사용 검토 권장`);
-  }
-  if (conflictHints.length > 0) {
-    efficiencyHints.push(`⚠ 충돌 신호 ${conflictHints.length}건 — 과거 실패 lesson / 진행 중 task 확인 필요`);
-  }
-  if (planConflicts.length > 0) {
-    efficiencyHints.push(`📋 진행 중 milestone ${planConflicts.length}건과 영역 겹침 가능 — plan 정렬 권장`);
-  }
-  if (featureConflicts.length > 0) {
-    efficiencyHints.push(`🕸 Feature Graph ${featureConflicts.length}건 영역 겹침 — 의존성 사전 확인`);
-  }
-  // 다중 에이전트 분배 추천
-  if (estimatedType === 'feature' || estimatedType === 'planning') {
-    efficiencyHints.push(`👥 leerness agents recommend ${estimatedType} — 작업 유형별 sub-agent 매핑 활용 가능`);
-  }
-  if (efficiencyHints.length === 0) {
-    efficiencyHints.push('✨ 충돌 신호 없음 — 즉시 진행 안전');
-  }
-
-  // 6.5) 1.9.208: 플랫폼/API 제약 사전 체크 — 사용자 명시 ("호출속도 초당 5회" 같은 규정 사전 확인)
-  let constraintsCheck = { matched: [], suggestions: [] };
-  try {
-    constraintsCheck = _checkRequestConstraints(root, text);
-    if (constraintsCheck.matched.length > 0) {
-      efficiencyHints.push(`⚠ 플랫폼 제약 ${constraintsCheck.matched.length}건 — leerness constraints check 로 상세 확인`);
-    }
-  } catch {}
-
-  // 7) proceed 권장 (충돌 critical 시 false)
-  const proceed = conflictHints.length < 3 && planConflicts.length === 0;
-
-  const dt = Date.now() - t0;
-  const out = {
-    request: text,
-    estimatedType,
-    conflicts: conflictHints,
-    reuseCandidates,
-    lessonsRecall,
-    planConflicts,
-    featureConflicts,
-    recommendedSteps,
-    efficiencyHints,
-    platformConstraints: constraintsCheck.matched,
-    constraintSuggestions: constraintsCheck.suggestions,
-    proceed,
-    proceedReason: proceed ? '안전 — 충돌 신호 < 3 + plan 충돌 0' : '⚠ 충돌 critical — 사용자 확인 후 진행',
-    durationMs: dt
-  };
-
-  try { _recordRun(root, { kind: 'review_request', estimatedType, conflicts: conflictHints.length, reuse: reuseCandidates.length, durationMs: dt, ok: true }); } catch {}
-
-  if (has('--json')) {
-    log(JSON.stringify(out, null, 2));
-    return;
-  }
-
-  log(`# leerness review-request (1.9.176 사전 검토)`);
-  log(`요청: "${text.slice(0, 200)}${text.length > 200 ? '…' : ''}"`);
-  log(`추정 작업 유형: ${estimatedType}`);
-  log('');
-  if (conflictHints.length) {
-    log(`## ⚠ 충돌 신호 (${conflictHints.length})`);
-    conflictHints.slice(0, 5).forEach(c => log(`  - [${c.kind}] ${c.title || c.id || ''} ${c.preview || ''}`.trim()));
-    log('');
-  }
-  if (reuseCandidates.length) {
-    log(`## 🔁 재사용 후보 (${reuseCandidates.length}) — 신규 구현 전 검토`);
-    reuseCandidates.slice(0, 5).forEach(r => {
-      if (r.kind === 'skill') log(`  - [skill] ${r.id}${r.displayNameKo ? ' · ' + r.displayNameKo : ''}`);
-      else if (r.kind === 'reuse-map') log(`  - [reuse] ${r.capability} @ ${r.where}`);
-    });
-    log('');
-  }
-  if (lessonsRecall.length) {
-    log(`## 🧠 과거 컨텍스트 (${lessonsRecall.length}) — 관련 결정/교훈`);
-    lessonsRecall.slice(0, 3).forEach(l => log(`  - [${l.kind}] ${l.title || l.preview}`));
-    log('');
-  }
-  if (planConflicts.length || featureConflicts.length) {
-    log(`## 📋 진행 중 영역 (${planConflicts.length + featureConflicts.length})`);
-    planConflicts.forEach(m => log(`  - [milestone] ${m.id}: ${m.title}`));
-    featureConflicts.slice(0, 5).forEach(f => log(`  - [feature] ${f.id}: ${f.title}`));
-    log('');
-  }
-  log(`## 💡 효율 제안`);
-  efficiencyHints.forEach(h => log(`  ${h}`));
-  log('');
-  // 1.9.208: 플랫폼/API 제약 사전 노출 (사용자 명시)
-  if (constraintsCheck.matched.length > 0) {
-    log(`## 🚦 플랫폼/API 제약 사전 체크 (${constraintsCheck.matched.length})`);
-    for (const m of constraintsCheck.matched) {
-      log(`  - 📦 ${m.platform}  (docs: ${m.docs || '-'})`);
-      for (const c of (m.constraints || []).slice(0, 3)) {
-        log(`     • [${c.kind}] ${c.detail}`);
-      }
-    }
-    log(`  → leerness constraints check "${text.slice(0, 40)}…" 로 상세 확인`);
-    log('');
-  }
-  if (recommendedSteps.length) {
-    log(`## 📍 권장 단계 (${estimatedType})`);
-    recommendedSteps.forEach(s => log(`  ${s}`));
-    log('');
-  }
-  log(`## ▶ 진행 권장: ${proceed ? '✓ 진행 안전' : '⚠ 사용자 확인 필요'}`);
-  log(`   사유: ${out.proceedReason}`);
-  log(`   분석 소요: ${dt}ms`);
-}
+const _reviewRequest = require('../lib/review-request');
+// 1.9.420 (UR-0125 큰 핸들러 모듈화 5번째): reviewRequestCmd → lib/review-request.js (DI 위임, thin wrapper)
+function reviewRequestCmd(root, request) { return _reviewRequest.reviewRequestCmd(root, request, { has, harnessPath: __filename, _checkRequestConstraints, _recordRun }); }
 
 // 1.9.164: leerness which — 진단 도구 (구버전 충돌 / npx 캐시 / PATH 충돌 해결)
 //   사용자가 "최신 버전 작동 안 함" 의심 시: 실제 실행 중인 leerness 의 경로 / 버전 / npm 캐시 / PATH 후보 표시.

package/docs/PUBLISH_PRECHECK.md

@@ -1,93 +1,93 @@
-# Publish Pre-check (leerness 1.9.0)
-
-> ⚠ **Owner 권한 필수**: npm `leerness`의 메인테이너는 `gytlrgpfl <gytlrgpfl96@gmail.com>` 입니다. 이 계정으로 로그인되어 있거나 collaborator로 등록되어 있어야 publish가 통과합니다. 권한이 없으면 `E403 Forbidden`이 떨어집니다.
-
-## 1. 메타데이터 보강 (선택)
-
-`package.json`의 다음 필드는 비어 있거나 일반적입니다. 사용자 정보로 채우는 것을 권장합니다.
-
-```json
-{
-  "author": "leerness contributors",
-  "repository": { /* 비어있음 */ },
-  "bugs": { /* 비어있음 */ },
-  "homepage": ""
-}
-```
-
-예:
-
-```json
-"author": "Your Name <you@example.com>",
-"repository": { "type": "git", "url": "git+https://github.com/<user>/leerness.git" },
-"bugs": { "url": "https://github.com/<user>/leerness/issues" },
-"homepage": "https://github.com/<user>/leerness#readme"
-```
-
-publish 필수는 아니지만, npm 페이지 신뢰도와 사용자 경험을 위해 채워두면 좋습니다.
-
-## 2. 권한 확인
-
-```bash
-npm whoami
-# → 응답이 leerness의 owner인지 확인
-npm owner ls leerness
-# → 자신의 계정이 목록에 있는지 확인
-```
-
-권한이 없으면 collaborator 추가를 owner에게 요청해야 합니다.
-
-## 3. 로컬 검증
-
-```bash
-node ./bin/harness.js --version    # → 1.9.0
-npm pack --dry-run                 # 패키지 내용 미리보기
-node ./scripts/e2e.js              # 30+개 시나리오 통과
-```
-
-## 4. 1.8.0 → 1.9.0 자동 업그레이드 시연 (선택)
-
-```bash
-mkdir /tmp/lr-old; cd /tmp/lr-old
-npx -y leerness@1.8.0 init . --language ko --skills recommended
-LEERNESS_OFFLINE=1 npx -y -p /path/to/leerness-1.9.0.tgz leerness update . --yes
-cat .harness/HARNESS_VERSION       # → 1.9.0
-```
-
-## 5. publish dry-run
-
-```bash
-npm publish --dry-run
-# 또는
-npm publish leerness-1.9.0.tgz --dry-run
-```
-
-확인:
-- `package.json#files`와 실제 tarball 내용 일치
-- 총 크기 (≈30~40 kB)
-- bin → harness.js 매핑
-
-## 6. 실 publish
-
-```bash
-npm login                  # 권한 있는 계정으로
-npm publish --access public
-```
-
-## 7. publish 후 검증
-
-```bash
-npm view leerness version          # → 1.9.0
-npx -y leerness@latest --version   # → 1.9.0
-mkdir test-install && cd test-install
-npx -y leerness@latest init . --yes --language ko --skills recommended
-npx -y leerness@latest verify .
-```
-
-## 8. 롤백
-
-24시간 이내라면 `npm unpublish leerness@1.9.0` 가능. 이후엔 1.9.1 패치 또는 deprecate.
-
-```bash
-npm deprecate leerness@1.9.0 "Use 1.9.1+"
-```
+# Publish Pre-check (leerness 1.9.0)
+
+> ⚠ **Owner 권한 필수**: npm `leerness`의 메인테이너는 `gytlrgpfl <gytlrgpfl96@gmail.com>` 입니다. 이 계정으로 로그인되어 있거나 collaborator로 등록되어 있어야 publish가 통과합니다. 권한이 없으면 `E403 Forbidden`이 떨어집니다.
+
+## 1. 메타데이터 보강 (선택)
+
+`package.json`의 다음 필드는 비어 있거나 일반적입니다. 사용자 정보로 채우는 것을 권장합니다.
+
+```json
+{
+  "author": "leerness contributors",
+  "repository": { /* 비어있음 */ },
+  "bugs": { /* 비어있음 */ },
+  "homepage": ""
+}
+```
+
+예:
+
+```json
+"author": "Your Name <you@example.com>",
+"repository": { "type": "git", "url": "git+https://github.com/<user>/leerness.git" },
+"bugs": { "url": "https://github.com/<user>/leerness/issues" },
+"homepage": "https://github.com/<user>/leerness#readme"
+```
+
+publish 필수는 아니지만, npm 페이지 신뢰도와 사용자 경험을 위해 채워두면 좋습니다.
+
+## 2. 권한 확인
+
+```bash
+npm whoami
+# → 응답이 leerness의 owner인지 확인
+npm owner ls leerness
+# → 자신의 계정이 목록에 있는지 확인
+```
+
+권한이 없으면 collaborator 추가를 owner에게 요청해야 합니다.
+
+## 3. 로컬 검증
+
+```bash
+node ./bin/leerness.js --version    # → 1.9.0
+npm pack --dry-run                 # 패키지 내용 미리보기
+node ./scripts/e2e.js              # 30+개 시나리오 통과
+```
+
+## 4. 1.8.0 → 1.9.0 자동 업그레이드 시연 (선택)
+
+```bash
+mkdir /tmp/lr-old; cd /tmp/lr-old
+npx -y leerness@1.8.0 init . --language ko --skills recommended
+LEERNESS_OFFLINE=1 npx -y -p /path/to/leerness-1.9.0.tgz leerness update . --yes
+cat .harness/HARNESS_VERSION       # → 1.9.0
+```
+
+## 5. publish dry-run
+
+```bash
+npm publish --dry-run
+# 또는
+npm publish leerness-1.9.0.tgz --dry-run
+```
+
+확인:
+- `package.json#files`와 실제 tarball 내용 일치
+- 총 크기 (≈30~40 kB)
+- bin → leerness.js 매핑
+
+## 6. 실 publish
+
+```bash
+npm login                  # 권한 있는 계정으로
+npm publish --access public
+```
+
+## 7. publish 후 검증
+
+```bash
+npm view leerness version          # → 1.9.0
+npx -y leerness@latest --version   # → 1.9.0
+mkdir test-install && cd test-install
+npx -y leerness@latest init . --yes --language ko --skills recommended
+npx -y leerness@latest verify .
+```
+
+## 8. 롤백
+
+24시간 이내라면 `npm unpublish leerness@1.9.0` 가능. 이후엔 1.9.1 패치 또는 deprecate.
+
+```bash
+npm deprecate leerness@1.9.0 "Use 1.9.1+"
+```

package/lib/review-request.js

@@ -0,0 +1,288 @@
+// lib/review-request.js — review-request 핸들러 (UR-0125 큰 핸들러 모듈화, 1.9.420)
+//   bin/leerness.js 에서 reviewRequestCmd(277줄) 분리. DI: harness 고유 의존(has · harnessPath · _checkRequestConstraints · _recordRun) 주입.
+//   io 프리미티브는 ./io, cp/path 는 빌트인. 동작/출력 무변경(thin wrapper 위임).
+'use strict';
+const cp = require('child_process');
+const path = require('path');
+const { absRoot, exists, read, log, fail } = require('./io');
+
+function reviewRequestCmd(root, request, deps = {}) {
+  const { has, harnessPath, _checkRequestConstraints, _recordRun } = deps;
+  root = absRoot(root || process.cwd());
+  if (!request || !String(request).trim()) {
+    return fail('leerness review-request "<request>" — 사용자 요청 텍스트 필요');
+  }
+  const t0 = Date.now();
+  const text = String(request).trim();
+
+  // 1) 작업 유형 추정 (route 기반 키워드 매핑)
+  const lower = text.toLowerCase();
+  const routeKw = {
+    bugfix:      ['버그', '오류', '에러', '수정', '고쳐', '실패', 'fix', 'bug', 'error'],
+    refactor:    ['리팩토', '재구성', '정리', '개선', 'refactor', 'cleanup'],
+    feature:     ['추가', '구현', '만들', '새', '기능', 'add', 'implement', 'feature', 'create', 'new'],
+    research:    ['조사', '분석', '비교', '검토', '연구', 'research', 'analyze', 'compare', 'investigate'],
+    planning:    ['계획', '설계', '로드맵', 'plan', 'design', 'architecture', 'roadmap'],
+    release:     ['배포', '릴리즈', '버전', 'release', 'deploy', 'publish'],
+    consistency: ['일관성', '통합', '동기화', '맞춰', 'consistency', 'sync', 'align']
+  };
+  let estimatedType = 'feature';  // default
+  let maxScore = 0;
+  for (const [type, kws] of Object.entries(routeKw)) {
+    const score = kws.filter(k => lower.includes(k)).length;
+    if (score > maxScore) { maxScore = score; estimatedType = type; }
+  }
+
+  // 2) 기존 자원 회수 — brainstorm spawn (모든 surface 통합 회수)
+  const conflictHints = [];  // ⚠ 같은 키워드 + 실패/오류 패턴
+  const reuseCandidates = []; // 🔁 기존 skill / reuse-map / decision 후보
+  const lessonsRecall = [];   // 🧠 과거 lesson
+  const planConflicts = [];   // 📋 진행 중 milestone과 충돌 가능
+
+  // brainstorm 호출 (1.9.13~) — JSON 결과 회수
+  try {
+    const r = cp.spawnSync(process.execPath, [harnessPath, 'brainstorm', text, '--path', root, '--json'], {
+      encoding: 'utf8', timeout: 12000,
+      env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
+    });
+    if (r.stdout) {
+      const j = JSON.parse(r.stdout);
+      const hits = j.hits || {};
+      // decisions — 과거 결정 후보
+      (hits.decisions || []).slice(0, 5).forEach(d => {
+        lessonsRecall.push({ kind: 'decision', title: d.title, line: d.line, preview: (d.preview || '').slice(0, 100) });
+      });
+      // lessons — 과거 교훈 (특히 실패 키워드)
+      (hits.lessons || []).slice(0, 5).forEach(l => {
+        const preview = (l.text || l.preview || '').slice(0, 100);
+        const isFailure = /실패|오류|에러|fail|error|bug|문제|warning/i.test(preview);
+        if (isFailure) {
+          conflictHints.push({ kind: 'lesson-failure', preview, tags: l.tags });
+        } else {
+          lessonsRecall.push({ kind: 'lesson', preview, tags: l.tags });
+        }
+      });
+      // skills — 기존 skill 후보
+      (hits.skills || []).slice(0, 3).forEach(s => {
+        reuseCandidates.push({ kind: 'skill', id: s.id, displayNameKo: s.displayNameKo, capabilities: s.capabilities });
+      });
+      // tasks — 진행 중 task 충돌
+      (hits.tasks || []).slice(0, 3).forEach(tsk => {
+        if (tsk.status && /in-progress|진행/.test(String(tsk.status))) {
+          conflictHints.push({ kind: 'task-in-progress', id: tsk.id, title: tsk.title });
+        }
+      });
+      // plan milestones — 진행 중 milestone
+      (hits.planMilestones || []).slice(0, 3).forEach(m => {
+        if (m.status && /in-progress|진행/.test(String(m.status))) {
+          planConflicts.push({ kind: 'milestone-in-progress', id: m.id, title: m.title });
+        }
+      });
+      // taskLogFails — 과거 같은 키워드 실패 흔적
+      (hits.taskLogFails || []).slice(0, 3).forEach(f => {
+        conflictHints.push({ kind: 'task-log-failure', preview: (f.preview || f.text || '').slice(0, 100) });
+      });
+    }
+  } catch {}
+
+  // 3) reuse-map 매칭 — 기존 capability 등록 후보
+  try {
+    const reusePath = path.join(root, '.harness/reuse-map.md');
+    if (exists(reusePath)) {
+      const reuseLines = read(reusePath).split('\n');
+      const tokens = lower.split(/\s+/).filter(t => t.length >= 3);
+      for (const line of reuseLines) {
+        if (!/^\| /.test(line)) continue;  // 테이블 row만
+        const ll = line.toLowerCase();
+        const matched = tokens.filter(t => ll.includes(t)).length;
+        if (matched > 0) {
+          const cols = line.split('|').map(s => s.trim());
+          if (cols[1]) {
+            reuseCandidates.push({ kind: 'reuse-map', capability: cols[1], where: cols[2] || '', note: cols[3] || '' });
+          }
+        }
+      }
+    }
+  } catch {}
+
+  // 4) feature_graph — 같은 영역 변경 가능성
+  const featureConflicts = [];
+  try {
+    const fgPath = path.join(root, '.harness/feature_graph.md');
+    if (exists(fgPath)) {
+      const fg = read(fgPath);
+      const tokens = lower.split(/\s+/).filter(t => t.length >= 4);
+      // F-XXXX 노드 라인 추출
+      const nodeBlocks = fg.split(/\n### /);
+      for (const blk of nodeBlocks.slice(1)) {
+        const bl = blk.toLowerCase();
+        const matched = tokens.filter(t => bl.includes(t)).length;
+        if (matched > 0) {
+          const titleMatch = blk.match(/^([^\n]+)/);
+          const idMatch = blk.match(/F-\d+/);
+          if (titleMatch && idMatch) {
+            featureConflicts.push({ kind: 'feature', id: idMatch[0], title: titleMatch[1].trim() });
+          }
+        }
+      }
+    }
+  } catch {}
+
+  // 5) 권장 단계 (작업 유형별)
+  const recommendedSteps = {
+    feature: [
+      '1) leerness reuse-check "<기능>" — 외부 OSS 빌드 vs 재사용 판단 (1.9.285)',
+      '2) leerness reuse find "<핵심 capability>" — 내부 중복 구현 사전 차단',
+      '3) leerness plan add "<milestone>" — 진행 추적',
+      '4) leerness contract verify SPEC.md src/<mod>.js — 사양 ↔ 구현 일치 검증',
+      '5) verify-claim --run-tests 로 evidence 의무화'
+    ],
+    bugfix: [
+      '1) leerness brainstorm "<버그 키워드>" — 과거 같은 영역 lesson 회수',
+      '2) leerness verify-claim T-XXX --strict-claims — 낙관적 표시 사전 감지',
+      '3) verify-code --run-tests — 재현 + fix 검증',
+      '4) leerness lesson save "<root cause>" — 같은 실수 재발 차단'
+    ],
+    refactor: [
+      '1) leerness reuse-map — 영향 범위 파악',
+      '2) leerness impact <file> — 강한/약한 참조 분리',
+      '3) leerness contract verify — 외부 인터페이스 보존 확인',
+      '4) verify-code --run-tests + 회귀 테스트'
+    ],
+    research: [
+      '1) leerness brainstorm "<주제>" — 누적 컨텍스트 회수',
+      '2) leerness lessons --query "<주제>" — 과거 같은 영역 결정',
+      '3) leerness review <file> --persona research — 깊이 검토',
+      '4) leerness decision add "<결론>" — 회수 가능하게 영구화'
+    ],
+    planning: [
+      '1) leerness plan add "<milestone>" — 분해 시작',
+      '2) leerness reuse-map — 기존 자원 인벤토리',
+      '3) leerness agents recommend planning — sub-agent 분배',
+      '4) leerness session close — 결정 영구화'
+    ],
+    release: [
+      '1) leerness health — production-ready 확인',
+      '2) leerness audit + verify-code — 보안 + 검수',
+      '3) leerness release bump + note + publish'
+    ],
+    consistency: [
+      '1) leerness audit — design/reuse/handoff 일관성 검사',
+      '2) leerness consistency check — 잠재 일관성 위반',
+      '3) leerness drift check --auto-fix — 자동 회복'
+    ]
+  }[estimatedType] || [];
+
+  // 6) 효율 제안 (적용 가능한 sub-agent + skill)
+  const efficiencyHints = [];
+  if (reuseCandidates.length > 0) {
+    efficiencyHints.push(`🔁 기존 자원 ${reuseCandidates.length}건 발견 — 신규 구현 전 재사용 검토 권장`);
+  }
+  if (conflictHints.length > 0) {
+    efficiencyHints.push(`⚠ 충돌 신호 ${conflictHints.length}건 — 과거 실패 lesson / 진행 중 task 확인 필요`);
+  }
+  if (planConflicts.length > 0) {
+    efficiencyHints.push(`📋 진행 중 milestone ${planConflicts.length}건과 영역 겹침 가능 — plan 정렬 권장`);
+  }
+  if (featureConflicts.length > 0) {
+    efficiencyHints.push(`🕸 Feature Graph ${featureConflicts.length}건 영역 겹침 — 의존성 사전 확인`);
+  }
+  // 다중 에이전트 분배 추천
+  if (estimatedType === 'feature' || estimatedType === 'planning') {
+    efficiencyHints.push(`👥 leerness agents recommend ${estimatedType} — 작업 유형별 sub-agent 매핑 활용 가능`);
+  }
+  if (efficiencyHints.length === 0) {
+    efficiencyHints.push('✨ 충돌 신호 없음 — 즉시 진행 안전');
+  }
+
+  // 6.5) 1.9.208: 플랫폼/API 제약 사전 체크 — 사용자 명시 ("호출속도 초당 5회" 같은 규정 사전 확인)
+  let constraintsCheck = { matched: [], suggestions: [] };
+  try {
+    constraintsCheck = _checkRequestConstraints(root, text);
+    if (constraintsCheck.matched.length > 0) {
+      efficiencyHints.push(`⚠ 플랫폼 제약 ${constraintsCheck.matched.length}건 — leerness constraints check 로 상세 확인`);
+    }
+  } catch {}
+
+  // 7) proceed 권장 (충돌 critical 시 false)
+  const proceed = conflictHints.length < 3 && planConflicts.length === 0;
+
+  const dt = Date.now() - t0;
+  const out = {
+    request: text,
+    estimatedType,
+    conflicts: conflictHints,
+    reuseCandidates,
+    lessonsRecall,
+    planConflicts,
+    featureConflicts,
+    recommendedSteps,
+    efficiencyHints,
+    platformConstraints: constraintsCheck.matched,
+    constraintSuggestions: constraintsCheck.suggestions,
+    proceed,
+    proceedReason: proceed ? '안전 — 충돌 신호 < 3 + plan 충돌 0' : '⚠ 충돌 critical — 사용자 확인 후 진행',
+    durationMs: dt
+  };
+
+  try { _recordRun(root, { kind: 'review_request', estimatedType, conflicts: conflictHints.length, reuse: reuseCandidates.length, durationMs: dt, ok: true }); } catch {}
+
+  if (has('--json')) {
+    log(JSON.stringify(out, null, 2));
+    return;
+  }
+
+  log(`# leerness review-request (1.9.176 사전 검토)`);
+  log(`요청: "${text.slice(0, 200)}${text.length > 200 ? '…' : ''}"`);
+  log(`추정 작업 유형: ${estimatedType}`);
+  log('');
+  if (conflictHints.length) {
+    log(`## ⚠ 충돌 신호 (${conflictHints.length})`);
+    conflictHints.slice(0, 5).forEach(c => log(`  - [${c.kind}] ${c.title || c.id || ''} ${c.preview || ''}`.trim()));
+    log('');
+  }
+  if (reuseCandidates.length) {
+    log(`## 🔁 재사용 후보 (${reuseCandidates.length}) — 신규 구현 전 검토`);
+    reuseCandidates.slice(0, 5).forEach(r => {
+      if (r.kind === 'skill') log(`  - [skill] ${r.id}${r.displayNameKo ? ' · ' + r.displayNameKo : ''}`);
+      else if (r.kind === 'reuse-map') log(`  - [reuse] ${r.capability} @ ${r.where}`);
+    });
+    log('');
+  }
+  if (lessonsRecall.length) {
+    log(`## 🧠 과거 컨텍스트 (${lessonsRecall.length}) — 관련 결정/교훈`);
+    lessonsRecall.slice(0, 3).forEach(l => log(`  - [${l.kind}] ${l.title || l.preview}`));
+    log('');
+  }
+  if (planConflicts.length || featureConflicts.length) {
+    log(`## 📋 진행 중 영역 (${planConflicts.length + featureConflicts.length})`);
+    planConflicts.forEach(m => log(`  - [milestone] ${m.id}: ${m.title}`));
+    featureConflicts.slice(0, 5).forEach(f => log(`  - [feature] ${f.id}: ${f.title}`));
+    log('');
+  }
+  log(`## 💡 효율 제안`);
+  efficiencyHints.forEach(h => log(`  ${h}`));
+  log('');
+  // 1.9.208: 플랫폼/API 제약 사전 노출 (사용자 명시)
+  if (constraintsCheck.matched.length > 0) {
+    log(`## 🚦 플랫폼/API 제약 사전 체크 (${constraintsCheck.matched.length})`);
+    for (const m of constraintsCheck.matched) {
+      log(`  - 📦 ${m.platform}  (docs: ${m.docs || '-'})`);
+      for (const c of (m.constraints || []).slice(0, 3)) {
+        log(`     • [${c.kind}] ${c.detail}`);
+      }
+    }
+    log(`  → leerness constraints check "${text.slice(0, 40)}…" 로 상세 확인`);
+    log('');
+  }
+  if (recommendedSteps.length) {
+    log(`## 📍 권장 단계 (${estimatedType})`);
+    recommendedSteps.forEach(s => log(`  ${s}`));
+    log('');
+  }
+  log(`## ▶ 진행 권장: ${proceed ? '✓ 진행 안전' : '⚠ 사용자 확인 필요'}`);
+  log(`   사유: ${out.proceedReason}`);
+  log(`   분석 소요: ${dt}ms`);
+}
+
+module.exports = { reviewRequestCmd };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.9.418",
+  "version": "1.9.420",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",
@@ -28,13 +28,13 @@
   "license": "MIT",
   "author": "leerness contributors",
   "type": "commonjs",
-  "main": "bin/harness.js",
+  "main": "bin/leerness.js",
   "preferGlobal": true,
   "engines": {
     "node": ">=18"
   },
   "bin": {
-    "leerness": "bin/harness.js"
+    "leerness": "bin/leerness.js"
   },
   "files": [
     "bin",
@@ -47,10 +47,10 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node ./bin/harness.js --version && node ./bin/harness.js selftest && node ./scripts/e2e.js",
-    "test:fast": "node ./bin/harness.js selftest && node ./scripts/smoke.js",
+    "test": "node ./bin/leerness.js --version && node ./bin/leerness.js selftest && node ./scripts/e2e.js",
+    "test:fast": "node ./bin/leerness.js selftest && node ./scripts/smoke.js",
     "test:smoke": "node ./scripts/e2e.js",
-    "prepack": "node ./bin/harness.js readme sync . && node ./bin/harness.js --version"
+    "prepack": "node ./bin/leerness.js readme sync . && node ./bin/leerness.js --version"
   },
   "publishConfig": {
     "access": "public"

package/scripts/e2e.js

@@ -11,7 +11,7 @@ process.env.LEERNESS_OFFLINE = process.env.LEERNESS_OFFLINE || '1';
 // 1.9.284 (UR-0029): e2e 속도 — 기본 roadmap.html(70KB HTML) 자동 생성 OFF (roadmap 전용 테스트 블록만 일시 ON).
 //   대부분의 init/session 테스트는 roadmap 을 검증하지 않으므로 생성 비용 제거 → 5분 내 완료.
 process.env.LEERNESS_NO_AUTO_ROADMAP = '1';
-const CLI = path.resolve(__dirname, '..', 'bin', 'harness.js');
+const CLI = path.resolve(__dirname, '..', 'bin', 'leerness.js');
 const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-e2e-'));
 let failed = 0; let total = 0;
 const _e2eStart = Date.now();  // 1.9.284 (UR-0029): 총 소요시간 투명성
@@ -3081,7 +3081,7 @@ total++;
 {
   let ok = false;
   try {
-    const h = require(path.resolve(__dirname, '..', 'bin', 'harness.js'));
+    const h = require(path.resolve(__dirname, '..', 'bin', 'leerness.js'));
     const q = h._shellQuoteArg('a; rm -rf / && echo $(whoami)');
     const win = process.platform === 'win32';
     // 따옴표로 감싸 메타문자가 단일 리터럴 인자가 됨 (POSIX 단일/Windows 이중)
@@ -3104,7 +3104,7 @@ total++;
       "const survived=process.listeners('warning').includes(L);" +
       "const polluted=(process.env.NODE_OPTIONS||'')!==o;" +
       "process.exit(survived&&!polluted?0:1);";
-    const harnessPath = path.resolve(__dirname, '..', 'bin', 'harness.js');
+    const harnessPath = path.resolve(__dirname, '..', 'bin', 'leerness.js');
     const r = cp.spawnSync(process.execPath, ['-e', probe, harnessPath], { encoding: 'utf8', timeout: 20000 });
     ok = r.status === 0;
   } catch {}
@@ -3118,14 +3118,14 @@ total++;
   let ok = false;
   try {
     const reg = require(path.resolve(__dirname, '..', 'lib', 'agent-registry.js'));
-    const h = require(path.resolve(__dirname, '..', 'bin', 'harness.js'));
+    const h = require(path.resolve(__dirname, '..', 'bin', 'leerness.js'));
     const dataOk = Array.isArray(reg.EXTERNAL_AGENTS) && reg.EXTERNAL_AGENTS.length === 10 &&
       reg.EXTERNAL_AGENTS.every(a => a.id && a.bin && a.envFlag) &&
       reg.AGENT_SLASH_COMMANDS && Object.keys(reg.AGENT_SLASH_COMMANDS).length === 9;
     // harness 가 모듈을 단일출처로 사용 (같은 객체 참조)
     const singleSource = h.AGENT_SLASH_COMMANDS === reg.AGENT_SLASH_COMMANDS;
     // harness.js 소스에 인라인 정의가 더 이상 없음 (모듈로 이동 완료)
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const movedOut = !/const EXTERNAL_AGENTS = \[/.test(harnessSrc) && /require\('\.\.\/lib\/agent-registry'\)/.test(harnessSrc);
     ok = dataOk && singleSource && movedOut;
   } catch {}
@@ -3143,7 +3143,7 @@ total++;
     const structOk = r.status === 0 && j.schemaVersion === 1 && !!j.version && !!j.project && ('currentTask' in j) &&
       j.openRequests && typeof j.openRequests.count === 'number' && Array.isArray(j.recentDecisions) &&
       Array.isArray(j.activeRules) && Array.isArray(j.nextActions) && j.memory && typeof j.memory.rulesActive === 'number';
-    const h = require(path.resolve(__dirname, '..', 'bin', 'harness.js'));
+    const h = require(path.resolve(__dirname, '..', 'bin', 'leerness.js'));
     const mcpOk = h._mcpToolCount && h._mcpToolCount() >= 80;
     ok = structOk && mcpOk;
   } catch {}
@@ -3188,7 +3188,7 @@ total++;
       reg._PROVIDER_MODEL_CATALOG && Object.keys(reg._PROVIDER_MODEL_CATALOG).length === 10 &&
       reg._ROLE_ALIASES && Object.keys(reg._ROLE_ALIASES).length >= 14 &&
       reg._AGENT_ROLE_PROMPTS && reg._AGENT_ROLE_PROMPTS.actor;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const movedOut = !/const ROLE_CATALOG = \{/.test(harnessSrc) && /require\('\.\.\/lib\/role-catalog'\)/.test(harnessSrc);
     // roles 명령이 여전히 동작 (모듈 require 후) — 회귀 방지
     const rr = cp.spawnSync(process.execPath, [CLI, 'roles', 'list', '--path', tmp, '--json'], { cwd: tmp, encoding: 'utf8', timeout: 20000 });
@@ -3210,7 +3210,7 @@ total++;
       reg.ADAPTERS && Object.keys(reg.ADAPTERS).length === 9 &&
       Array.isArray(reg.REUSE_CATEGORIES) && reg.REUSE_CATEGORIES.length === 15 &&
       Array.isArray(reg.REUSE_CHECKLIST) && reg.REUSE_CHECKLIST.length === 6;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const movedOut = !/const CAPABILITY_SURFACE = \{/.test(harnessSrc) && !/const ADAPTERS = \{/.test(harnessSrc) && /require\('\.\.\/lib\/catalogs'\)/.test(harnessSrc);
     // 소비 명령 회귀: capabilities + reuse-check (카탈로그 require 후 동작)
     const cap = cp.spawnSync(process.execPath, [CLI, 'capabilities', '--json'], { cwd: tmp, encoding: 'utf8', timeout: 20000 });
@@ -3253,12 +3253,12 @@ total++;
   try {
     const T = require(path.resolve(__dirname, '..', 'lib', 'mcp-tools.js'));
     const dataOk = Array.isArray(T) && T.length >= 81 && T.every(t => t.name && t.description && t.inputSchema) && T[0].name === 'leerness_handoff';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const movedOut = !/const TOOLS = \[/.test(harnessSrc) && /require\('\.\.\/lib\/mcp-tools'\)/.test(harnessSrc);
     // tools/list(라이브 MCP) == 모듈 length (단일출처 일치)
     const ml = cp.spawnSync(process.execPath, [CLI, 'mcp', 'serve'], { cwd: tmp, encoding: 'utf8', timeout: 15000, input: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/list' }) + '\n' });
     const live = JSON.parse(ml.stdout.split('\n').filter(Boolean)[0]).result.tools.length;
-    const h = require(path.resolve(__dirname, '..', 'bin', 'harness.js'));
+    const h = require(path.resolve(__dirname, '..', 'bin', 'leerness.js'));
     const singleSource = live === T.length && h._mcpToolCount() === T.length;
     ok = dataOk && movedOut && singleSource;
   } catch {}
@@ -3325,7 +3325,7 @@ total++;
 {
   let ok = false;
   try {
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     // (1) 소스: cp.exec 템플릿 제거 + execFile args 배열(view pkg version) + argList 인용
     const srcOk = /'view', pkg, 'version'/.test(harnessSrc) &&  // 1.9.360(CV-2/UR-0077): cmd.exe /d /s /c npm view (args 배열) 형태
       !/cp\.exec\(.npm view \$\{pkg\}/.test(harnessSrc) &&
@@ -3442,7 +3442,7 @@ total++;
       a._evidenceQuality('src/api.js 수정, 12/12 통과 (Exit: 0)').ok === true &&
       a._shellGuardAnalyze('a && b', { shell: 'powershell', psVersion: '5' }).issues.some(i => i.rule === 'ps5-chain') &&
       a._claimFileInGit('src/api.js', new Set(['src/api.js'])) === true;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const movedOut = !/function _evidenceQuality\(evidence\) \{/.test(harnessSrc) && !/function _shellGuardAnalyze\(cmd, ctx\) \{/.test(harnessSrc) && /require\('\.\.\/lib\/analyzers'\)/.test(harnessSrc);
     // 소비 명령 회귀: shell-guard (_shellGuardAnalyze 사용)
     const sg = cp.spawnSync(process.execPath, [CLI, 'shell-guard', 'a && b', '--json'], { cwd: tmp, encoding: 'utf8', timeout: 20000 });
@@ -3787,7 +3787,7 @@ total++;
     const work = m._htmlToText('<p>a <b>b</b></p>') === 'a b'
       && m._extractTitle('<title>T &amp; U</title>') === 'T & U'
       && m._extractLinks('<a href="/x">x</a><a href="https://o.com/y">y</a>', 'https://h.com/').length === 1;  // same-domain only
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const movedOut = !/function _htmlToText\(html\) \{/.test(harnessSrc) && harnessSrc.includes('_htmlToText, _extractTitle, _extractLinks') && /require\('\.\.\/lib\/pure-utils'\)/.test(harnessSrc);  // 1.9.324: import 순서 비의존(이후 import 추가 허용)
     const r = cp.spawnSync(process.execPath, [CLI, 'api-skill'], { encoding: 'utf8', timeout: 15000 });  // 소비 명령 로드
     const cmdOk = /api-skill/.test(r.stdout || '');
@@ -3900,7 +3900,7 @@ total++;
     const fnOk = typeof m._countDatedBlocks === 'function' && typeof m._extractDecisionBlocks === 'function';
     const work = m._countDatedBlocks('```md\n### 2026-01-01 — T\n```\n### 2026-06-05 — R\n') === 1
       && m._extractDecisionBlocks('### 2026-06-05 — A\n- Decision: x\n').length === 1;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     // 1.9.325: import 순서 비의존 — pure-utils 구조분해 블록을 추출해 이름 포함 확인(이후 import 추가 허용)
     const _puImport = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/function _countDatedBlocks\(/.test(harnessSrc) && !/function _compareSemver\(/.test(harnessSrc)
@@ -3928,7 +3928,7 @@ total++;
     const work = m._classifyIntent('정확히 그것만').intent === 'precise'
       && m._classifyIntent('전체 다양한 기능').intent === 'broad'
       && m._classifyIntent('로그인 구현').intent === 'default';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     // import 순서 비의존: pure-utils 구조분해 블록 추출 후 이름 포함 확인
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/function _classifyIntent\(/.test(harnessSrc) && _puImp.includes('_classifyIntent');
@@ -3955,7 +3955,7 @@ total++;
       && m._detectPwshFromEnv({ POWERSHELL_DISTRIBUTION_CHANNEL: 'X' }).version === '7'
       && m._detectPwshFromEnv({}).isPowerShell === false
       && /^['"]/.test(m._shellQuoteArg('a b'));
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
     const movedOut = !/function _sanitizeFences\(/.test(harnessSrc) && !/function _shellQuoteArg\(/.test(harnessSrc) && !/function _detectPwshFromEnv\(/.test(harnessSrc)
       && _puImp.includes('_sanitizeFences') && _puImp.includes('_shellQuoteArg') && _puImp.includes('_detectPwshFromEnv');
@@ -3978,7 +3978,7 @@ total++;
     const work = m._formatLocal('2026-06-05T01:13:00.000Z', { tz: 'Asia/Seoul' }) === '2026-06-05 10:13 KST'  // UTC→KST +9h
       && m._formatLocal('2026-06-05T01:13:00.000Z', { tz: 'Asia/Seoul', dateOnly: true }) === '2026-06-05'
       && m._formatLocal('') === '?' && typeof m._getLocalTz() === 'string';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
     const movedOut = !/function _formatLocal\(/.test(harnessSrc) && !/function _getLocalTz\(/.test(harnessSrc)
       && _puImp.includes('_getLocalTz') && _puImp.includes('_formatLocal');
@@ -3997,7 +3997,7 @@ total++;
     const work = typeof m._truncate === 'function' && typeof m._splitList === 'function'
       && m._truncate('hello world', 8) === 'hello w…' && m._truncate('hi', 8) === 'hi'
       && JSON.stringify(m._splitList('a, b ,c,')) === '["a","b","c"]';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
     const movedOut = !/function _truncate\(/.test(harnessSrc) && !/function _splitList\(/.test(harnessSrc)
       && _puImp.includes('_truncate') && _puImp.includes('_splitList');
@@ -4017,7 +4017,7 @@ total++;
       && m._roadmapMapStatus('REQUESTED') === 'planned' && m._roadmapMapStatus('done') === 'done'
       && m._roadmapParseMilestones('### M-0001. 로그인\nStatus: in-progress\nProgress: 40%')[0].progress === 40
       && m._roadmapParseTokens('| color | #fff |').color === '#fff';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
     const movedOut = !/function _roadmapMapStatus\(/.test(harnessSrc) && !/function _roadmapParseMilestones\(/.test(harnessSrc) && !/function _roadmapParseTokens\(/.test(harnessSrc)
       && _puImp.includes('_roadmapMapStatus') && _puImp.includes('_roadmapParseMilestones') && _puImp.includes('_roadmapParseTokens');
@@ -4035,7 +4035,7 @@ total++;
     const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
     const cfgOk = Array.isArray(m._BRIEF_FIELDS) && m._BRIEF_FIELDS.length === 10 && m._BRIEF_FIELDS[0].key === 'intro';
     const work = m._briefFilled({ intro: 'x', features: ['a'] }) === 2 && m._briefFilled({}) === 0;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
     const movedOut = !/const _BRIEF_FIELDS = \[/.test(harnessSrc) && !/function _briefFilled\(/.test(harnessSrc)
       && _puImp.includes('_BRIEF_FIELDS') && _puImp.includes('_briefFilled');
@@ -4062,7 +4062,7 @@ total++;
     const work = typeof m._briefReadmeBlock === 'function' && typeof m._briefBlueprint === 'function'
       && m._briefReadmeBlock(b).includes(m.BRIEF_START) && /f1/.test(m._briefReadmeBlock(b))
       && /Blueprint/.test(m._briefBlueprint(b, '9.9.9')) && /leerness v9\.9\.9/.test(m._briefBlueprint(b, '9.9.9'));  // VERSION 주입
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
     const movedOut = !/function _briefReadmeBlock\(/.test(harnessSrc) && !/function _briefBlueprint\(/.test(harnessSrc) && !/^const BRIEF_START =/m.test(harnessSrc)
       && _puImp.includes('_briefReadmeBlock') && _puImp.includes('_briefBlueprint') && _puImp.includes('BRIEF_START');
@@ -4088,7 +4088,7 @@ total++;
     const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
     const r = m._parseLessonEntries('### 2026-06-05\n- Lesson: A\n- Tag: t\n\n### 2026-06-04\n- Lesson: B');
     const work = typeof m._parseLessonEntries === 'function' && r.length === 2 && r[0].text === 'A' && r[0].tag === 't' && r[1].tag === null;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
     const movedOut = !/function _parseLessonEntries\(/.test(harnessSrc) && _puImp.includes('_parseLessonEntries');
     // 소비 명령 회귀: lesson save + list --json
@@ -4114,7 +4114,7 @@ total++;
     const catOk = c._DEFAULT_PLATFORM_CONSTRAINTS && Object.keys(c._DEFAULT_PLATFORM_CONSTRAINTS.platforms).length === 6;
     const r = m._matchConstraints(c._DEFAULT_PLATFORM_CONSTRAINTS, 'stripe 결제');
     const work = catOk && r.matched.length === 1 && r.matched[0].platform === 'stripe' && r.totalPlatforms === 6 && m._matchConstraints(null, 'x').matched.length === 0;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     // 1.9.334: catalogs import 블록 추출 후 이름 포함 확인(순서/추가 비의존 — 이후 import 추가 허용)
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];
     const movedOut = !/const _DEFAULT_PLATFORM_CONSTRAINTS = \{/.test(harnessSrc) && harnessSrc.includes('_matchConstraints(_loadPlatformConstraints(root), text)')
@@ -4141,7 +4141,7 @@ total++;
     const catOk = c._DEFAULT_DOMAIN_CATALOG && Object.keys(c._DEFAULT_DOMAIN_CATALOG.domains).length === 5;
     const r = m._matchDomain(c._DEFAULT_DOMAIN_CATALOG, 'unity 게임');
     const work = catOk && typeof m._matchDomain === 'function' && r.domain === 'game' && Array.isArray(r.components) && m._matchDomain(null, 'x').domain === null;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const movedOut = !/const _DEFAULT_DOMAIN_CATALOG = \{/.test(harnessSrc) && harnessSrc.includes('_matchDomain(_loadDomainCatalog(root), text)')
       && _catImp.includes('_DEFAULT_DOMAIN_CATALOG');
@@ -4168,7 +4168,7 @@ total++;
     const langOk = m._detectLspLang('x.py') === 'python' && m._detectLspLang('y.rs') === 'rust' && m._detectLspLang('z.txt') === 'javascript';
     const sy = m._matchLspSymbols(c._LSP_LANG_PATTERNS, 'def foo():\n    pass\nclass Bar:\n    pass', 'python');
     const work = catOk && langOk && typeof m._matchLspSymbols === 'function' && sy.length === 2 && sy[0].name === 'foo' && sy[0].kind === 'function' && sy[1].name === 'Bar' && m._matchLspSymbols(null, 'x', 'javascript').length === 0;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/const _LSP_LANG_PATTERNS = \{/.test(harnessSrc) && !/function _detectLspLang\(/.test(harnessSrc)
@@ -4199,7 +4199,7 @@ total++;
     const work = catOk && typeof m._detectOptimism === 'function' && 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/b').length === 1 && m._verifyUrlClaim({ path: '/a/b' }, 'has /a/b') === true;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/const OPTIMISM_PATTERNS = \[/.test(harnessSrc) && !/function _extractUrlClaims\(/.test(harnessSrc)
@@ -4228,7 +4228,7 @@ total++;
     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 = catOk && typeof m._personaSummaries === 'function' && Array.isArray(sm) && sm.length === 5 && sm[0].id === 'security' && sm[0].body === undefined && m._personaSummaries(null).length === 0;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/const BUILT_IN_PERSONAS = \{/.test(harnessSrc) && _catImp.includes('BUILT_IN_PERSONAS') && _puImp.includes('_personaSummaries');
@@ -4262,7 +4262,7 @@ total++;
       && m._translate(c.STRINGS, 'no.such.key', 'en') === 'no.such.key'
       && m._translate(null, 'x', 'ko') === 'x'
       && m._translate({ k: { ko: '케이' } }, 'k', 'en') === '케이';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     // _t 박막: 인라인 STRINGS 정의 제거 + import + _translate(STRINGS,..) 호출
@@ -4378,7 +4378,7 @@ total++;
     const work = catOk && typeof m._withBuiltinSource === 'function' && Object.keys(out).length === 9
       && Object.values(out).every(v => v._source === 'builtin') && Array.isArray(out.office.capabilities)
       && Object.keys(m._withBuiltinSource(null)).length === 0;
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/const BUILTIN_CATALOG = \{/.test(harnessSrc) && _catImp.includes('BUILTIN_CATALOG') && _puImp.includes('_withBuiltinSource')
@@ -4405,7 +4405,7 @@ total++;
     const mapsOk = c.ROADMAP_STATUS_LABEL && c.ROADMAP_STATUS_COLOR
       && Object.keys(c.ROADMAP_STATUS_LABEL).length === 11 && Object.keys(c.ROADMAP_STATUS_COLOR).length === 11
       && c.ROADMAP_STATUS_LABEL.done === '완료' && c.ROADMAP_STATUS_COLOR.done === '#16a34a' && c.ROADMAP_STATUS_COLOR.skill === '#8b5cf6';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const movedOut = !/const ROADMAP_STATUS_LABEL = \{/.test(harnessSrc) && !/const ROADMAP_STATUS_COLOR = \{/.test(harnessSrc)
       && _catImp.includes('ROADMAP_STATUS_LABEL') && _catImp.includes('ROADMAP_STATUS_COLOR');
@@ -4433,7 +4433,7 @@ total++;
     const hit = (s) => c.SECRET_PATTERNS.some(p => { p.re.lastIndex = 0; return p.re.test(s); });
     const catOk = Array.isArray(c.SECRET_PATTERNS) && c.SECRET_PATTERNS.length === 20
       && hit('AKIA' + 'ABCD1234EFGH5678') && hit('sk-' + 'ant-api03-' + A + '_' + A) && !hit('const u = "john' + '_doe_2024";');
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     // 모듈 레벨 정의 제거(블록 지역 .env 배열은 보존) + import
     const movedOut = !/const SECRET_PATTERNS = \[\r?\n\s*\{ name:/.test(harnessSrc) && _catImp.includes('SECRET_PATTERNS')
@@ -4467,7 +4467,7 @@ total++;
     const catOk = c.SKILL_CATALOG_PRESETS && Object.keys(c.SKILL_CATALOG_PRESETS).length === 2
       && c.SKILL_CATALOG_PRESETS.vercel && c.SKILL_CATALOG_PRESETS.vercel.owner === 'vercel-labs'
       && c.SKILL_CATALOG_PRESETS.anthropic && c.SKILL_CATALOG_PRESETS.anthropic.repo === 'skills';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
     const movedOut = !/const SKILL_CATALOG_PRESETS = \{/.test(harnessSrc) && _catImp.includes('SKILL_CATALOG_PRESETS');
     // 소비 회귀: skill discover 가 preset 목록을 catalog 에서 노출 (네트워크 없이 unknown preset → 사용가능 목록)
@@ -4493,7 +4493,7 @@ total++;
       && m._esc('&<>"\'') === '&amp;&lt;&gt;&quot;&#39;'
       && m._esc('<script>x</script>') === '&lt;script&gt;x&lt;/script&gt;'
       && m._esc(null) === '' && m._esc(undefined) === '' && m._esc(42) === '42';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/function _esc\(/.test(harnessSrc) && _puImp.includes('_esc');
     // 소비 회귀: roadmap.html 이 악성 task 제목을 이스케이프 (인젝션 방지)
@@ -4521,7 +4521,7 @@ total++;
     const pureOk = typeof m._roadmapTokenStyles === 'function' && out.startsWith(':root {')
       && out.includes('--lr-primary: #2563eb') && out.includes('--lr-surface: #fff') && out.includes('--lr-custom: #abc')
       && out.includes('--lr-card-bg') && out.includes('--lr-page-bg') && m._roadmapTokenStyles(null, null).startsWith(':root {');
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/function _roadmapTokenStyles\(/.test(harnessSrc) && _puImp.includes('_roadmapTokenStyles');
     // 소비 회귀: roadmap.html 이 :root CSS 변수 주입
@@ -4548,7 +4548,7 @@ total++;
     const pureOk = typeof m._parseSkillMd === 'function' && r.meta.name === 's1' && r.meta.description === 'd1' && r.body === 'body'
       && m._parseSkillMd('---\nname: b\n---\nx').meta.name === 'b'
       && Object.keys(m._parseSkillMd('plain').meta).length === 0 && m._parseSkillMd(null).body === '';
-    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'leerness.js'), 'utf8');
     const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];
     const movedOut = !/function _parseSkillMd\(/.test(harnessSrc) && _puImp.includes('_parseSkillMd');
     // 소비 회귀: skill install 이 BOM 포함 SKILL.md 를 정상 설치 (frontmatter name 파싱)

package/scripts/smoke.js

@@ -12,7 +12,7 @@ const path = require('path');
 const cp = require('child_process');
 
 process.env.LEERNESS_OFFLINE = process.env.LEERNESS_OFFLINE || '1';
-const CLI = path.resolve(__dirname, '..', 'bin', 'harness.js');
+const CLI = path.resolve(__dirname, '..', 'bin', 'leerness.js');
 const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-smoke-'));
 let failed = 0, total = 0;
 const t0 = Date.now();