leerness 1.9.316 → 1.9.318

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 1.9.318 — 2026-06-04 — UR-0025: HTML 파싱 유틸 모듈 분리 + 락 테스트 격리
+
+**🧩 점진적 비파괴 모듈화(UR-0025) 한 단계 + pre-wake-audit critical 조사 결과 정리.**
+
+### pre-wake-audit critical 조사 (요청)
+매 라운드 관찰된 `pre-wake-audit critical 1` 을 조사 → **버그 아님**. `missing-user-requests` 가 미답 백로그 **3건**(UR-0025 모듈화 / UR-0044 ToolRegistry / UR-0053 JSON store)을 **정확히 보고**하는 정상 동작 (drift 마커와 달리 오발화 아님). 클리어하려면 백로그를 진행해야 함 → 가장 안전·확립된 UR-0025 를 진행.
+
+### 구현 (UR-0025)
+1. **순수 HTML 파싱 유틸 3종 → `lib/pure-utils.js` 분리**: `_htmlToText` / `_extractTitle` / `_extractLinks` (api-skill 문서 수집용, fs/네트워크 의존 0, URL·regex 만). harness.js 인라인 정의 제거 → require 로 동일 사용.
+2. **락 테스트 격리(테스트 품질)**: B(1.9.303) 동시 task add 락 테스트가 전체 e2e 부하 + review-request 내부 spawn(~550ms×6) 오버헤드로 **타임아웃 플래키** → `--no-review` 로 동시성만 격리(락 로직은 격리 실행 0.4s/6 보존 검증). 제품 락 로직 변경 없음.
+3. selftest 65→66 · e2e 262→263.
+
+### 검증
+- **selftest 66/66 PASS** · **E2E 263/263 PASS** (회귀 0).
+- 실측: 모듈 `_htmlToText('<p>Hello <b>World</b></p>')` → `Hello World` · `_extractTitle`(엔티티 디코드) · `_extractLinks`(same-domain only) · harness 인라인 제거 확인 · api-skill 명령 정상 로드.
+
+## 1.9.317 — 2026-06-04 — UR-0051: 텔레메트리 분리 (설치리뷰)
+
+**📊 내부 auto-call 이 usage 통계를 오염시켜 거짓 skill 추천을 유발하던 결함 수정.**
+
+### 배경 (설치리뷰)
+"텔레메트리 오염 — 내부 auto-call 이 사용자명령 집계 → 거짓 skill 추천 + task add ~550ms". leerness 가 자기 자신을 spawn 하는 내부 auto-call(`task add` → `review-request`, MCP `callLeerness`, session close/handoff/drift 자동 보조 호출 등 ~20곳)이 dispatch 의 usage 카운터에 **사용자 명령처럼 집계** → `skill suggest`(명령 빈도 기반)가 거짓 후보 추천.
+
+### 구현 (UR-0051)
+1. **`LEERNESS_INTERNAL=1` 마커**: 모든 내부 self-spawn(`cp.spawnSync(process.execPath, [__filename, …])`)의 env 에 마킹 (~20곳). 공통 env 프래그먼트 일괄 적용 + env 없던 3곳(task add/session close 자동) 보강.
+2. **usage 집계 가드**: dispatch 의 `_bumpUsage` 호출 조건에 `process.env.LEERNESS_INTERNAL !== '1'` 추가 — 내부 호출은 집계 제외.
+3. selftest 64→65 · e2e 261→262.
+
+### 검증
+- **selftest 65/65 PASS** · **E2E 262/262 PASS** (회귀 0 — ~20곳 마킹에도 모든 auto-call 정상).
+- 실측: `task add` 1회 → usage `{task:1}` (이전엔 `review-request` 도 집계) · 일반 drift 1→2 집계, **`LEERNESS_INTERNAL=1` drift → 미집계(2 유지)**.
+- 범위: usage(skill 추천) 오염 제거. task add 지연(~550ms, review-request spawn 자체)은 별도 — 후속 캐싱/비동기화 검토 여지.
+
 ## 1.9.316 — 2026-06-04 — 🐛 drift 'session close 누락' 영구 오발화 버그 (자가 발견)
 
 **🔧 session close 직후에도 drift 가 `session close 누락`(13일)을 보고하던 버그 수정 — 4라운드 연속 관찰된 leerness 자체 정확성 결함.**

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.316-green)]() [![tests](https://img.shields.io/badge/e2e-261%2F261-success)]() [![selftest](https://img.shields.io/badge/selftest-64-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)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.318-green)]() [![tests](https://img.shields.io/badge/e2e-263%2F263-success)]() [![selftest](https://img.shields.io/badge/selftest-66-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)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.316 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.318 하네스를 사용합니다. 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.316는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
+Leerness v1.9.318는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.316는 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.316)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.318)** · 매 라운드 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.316: 2026-06-04
+Last synced by Leerness v1.9.318: 2026-06-04
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -8,13 +8,14 @@ const os = require('os');  // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (
 const readline = require('readline');
 // 1.9.274 (UR-0025 1단계): 순수 유틸 함수 모듈 분리 (require-based, 비파괴). selftest 7종이 동작 검증.
 const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
-  PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord } = require('../lib/pure-utils');
+  PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord,
+  _htmlToText, _extractTitle, _extractLinks } = require('../lib/pure-utils');  // 1.9.318 (UR-0025): 순수 HTML 파싱 유틸 분리
 // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
 const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST } = require('../lib/catalogs');
 
-const VERSION = '1.9.316';
+const VERSION = '1.9.318';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2517,7 +2518,7 @@ function agentModeCmd(root, sub) {
   const yl = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
   const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
   function spawnChild(args, opts) {
-    return cp.spawnSync(process.execPath, [__filename, ...args], Object.assign({ encoding: 'utf8', cwd: root, env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1' } }, opts || {}));
+    return cp.spawnSync(process.execPath, [__filename, ...args], Object.assign({ encoding: 'utf8', cwd: root, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1' } }, opts || {}));
   }
   if (!sub || sub === 'help') {
     log(cy(`# leerness agent-mode (1.9.239) — 자율 모드 전용 통합 명령`));
@@ -3115,6 +3116,8 @@ function _selfTestCases() {
     { name: 'PowerShell 감지: pwsh7(channel/Documents\\PowerShell/install) + ps5.1 영구경로 과경고 안함 (UR-0052 설치리뷰 1.9.314)', run: () => { const f = _detectPwshFromEnv; const pwsh7a = f({ POWERSHELL_DISTRIBUTION_CHANNEL: 'MSI:Windows 10' }).version === '7'; const pwsh7b = f({ PSModulePath: 'C:\\Users\\me\\Documents\\PowerShell\\Modules' }).version === '7'; const pwsh7c = f({ PSModulePath: 'C:\\Program Files\\PowerShell\\7\\Modules' }).version === '7'; const noFalsePs5 = f({ PSModulePath: 'C:\\Users\\me\\Documents\\WindowsPowerShell\\Modules' }).isPowerShell === false; const cmdSys = f({ PSModulePath: 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\Modules' }).isPowerShell === false; const empty = f({}).isPowerShell === false; const src = read(__filename); const wired = src.includes('const fromEnv = _detectPwshFromEnv()') && src.includes('const pwshEnv = _detectPwshFromEnv()'); return pwsh7a && pwsh7b && pwsh7c && noFalsePs5 && cmdSys && empty && wired; } },
     { name: 'doc/surface 정합: doctor 명령 + stale MCP 카운트 동적화(commands/banner) (UR-0054 설치리뷰 1.9.315)', run: () => { const src = read(__filename); const doctorOk = typeof doctorCmd === 'function' && /cmd === 'doctor'/.test(src) && /# leerness doctor/.test(src); const dynCount = /MCP 도구: \$\{_mcpToolCount\(\)\}/.test(src) && /외부 AI 통합 \(MCP \$\{_mcpToolCount\(\)\} 도구\)/.test(src); return doctorOk && dynCount; } },
     { name: 'drift 마커 버그: session-handoff 프론트매터는 ^--- 일 때만 + drift 최신 Last generated (1.9.316)', run: () => { const src = read(__filename); const writeFix = src.includes('if (/^---\\r?\\n/.test(cur))') && src.includes('writeUtf8(handoffPath(root), frontmatter + block)'); const readFix = src.includes('matchAll(/Last generated') && src.includes('allGen[allGen.length - 1]'); return writeFix && readFix; } },
+    { name: '텔레메트리 분리: 내부 auto-call(LEERNESS_INTERNAL) usage 집계 제외 + 주요 spawn 마킹 (UR-0051 설치리뷰 1.9.317)', run: () => { const src = read(__filename); const guard = src.includes("process.env.LEERNESS_INTERNAL !== '1'"); const marked = (src.match(/LEERNESS_INTERNAL: '1'/g) || []).length >= 10; const reviewMarked = /'review-request'[\s\S]{0,200}LEERNESS_INTERNAL: '1'/.test(src); return guard && marked && reviewMarked; } },
+    { name: 'lib/pure-utils: HTML 파싱 유틸 3종 모듈 분리 + 동작 + 인라인 제거 (UR-0025 1.9.318)', run: () => { const m = require('../lib/pure-utils'); const fnOk = typeof m._htmlToText === 'function' && typeof m._extractTitle === 'function' && typeof m._extractLinks === 'function'; const work = m._htmlToText('<p>Hello <b>World</b></p>') === 'Hello World' && m._extractTitle('<html><title>My &amp; Page</title></html>') === 'My & Page' && m._extractLinks('<a href="/a">A</a><a href="https://other.com/b">B</a>', 'https://x.com/').length === 1; const moved = m._htmlToText === _htmlToText && !/^function _htmlToText\(html\) \{/m.test(read(__filename)); return fnOk && work && moved; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -3324,45 +3327,7 @@ function _fetchUrl(url, opts = {}) {
     go(url, 0);
   });
 }
-function _htmlToText(html) {
-  if (!html) return '';
-  return html
-    .replace(/<script[\s\S]*?<\/script>/gi, '')
-    .replace(/<style[\s\S]*?<\/style>/gi, '')
-    .replace(/<!--[\s\S]*?-->/g, '')
-    .replace(/<br\s*\/?>/gi, '\n')
-    .replace(/<\/?(p|div|li|h[1-6]|tr|td|pre)[^>]*>/gi, '\n')
-    .replace(/<[^>]+>/g, ' ')
-    .replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;/g, "'")
-    .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(parseInt(n, 10)))
-    .replace(/[ \t]+/g, ' ').replace(/\n\s*\n\s*\n+/g, '\n\n').trim();
-}
-function _extractTitle(html) {
-  const m = (html || '').match(/<title[^>]*>([\s\S]*?)<\/title>/i);
-  if (!m) return '';
-  return _htmlToText(m[1]).slice(0, 200);
-}
-function _extractLinks(html, baseUrl, maxLinks) {
-  if (!html) return [];
-  const base = new URL(baseUrl);
-  const found = new Map();
-  const re = /<a\s+[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi;
-  let m;
-  while ((m = re.exec(html)) !== null) {
-    let href = m[1];
-    if (!href || href.startsWith('#') || href.startsWith('javascript:') || href.startsWith('mailto:')) continue;
-    let abs;
-    try { abs = new URL(href, baseUrl).toString(); } catch { continue; }
-    const u = new URL(abs);
-    if (u.hostname !== base.hostname) continue; // same-domain only
-    if (abs === baseUrl) continue;
-    if (found.has(abs)) continue;
-    const text = _htmlToText(m[2]).slice(0, 120);
-    found.set(abs, { url: abs, text });
-    if (found.size >= (maxLinks || 10)) break;
-  }
-  return Array.from(found.values());
-}
+// 1.9.318 (UR-0025): _htmlToText / _extractTitle / _extractLinks → lib/pure-utils.js 로 이동 (순수 함수, require 로 사용).
 async function _collectAPIDoc(url, opts = {}) {
   const direction = opts.direction || '';
   const noCrawl = opts.noCrawl;
@@ -5890,7 +5855,7 @@ async function nextActionCmd(root, sub, ...rest) {
       state.queue.splice(n, 1);
       _writeNextActionQueue(root, state.queue);
       // leerness task add 호출
-      const taskResult = cp.spawnSync(process.execPath, [__filename, 'task', 'add', taskTitle, '--path', root], { encoding: 'utf8', timeout: 8000 });
+      const taskResult = cp.spawnSync(process.execPath, [__filename, 'task', 'add', taskTitle, '--path', root], { encoding: 'utf8', timeout: 8000, env: { ...process.env, LEERNESS_INTERNAL: '1' } });
       if (taskResult.status === 0) {
         const m = (taskResult.stdout || '').match(/T-\d{4}/);
         log(`  ✓ task 추가: ${m ? m[0] : '?'} — "${taskTitle}"`);
@@ -6411,7 +6376,7 @@ function taskAdd(root, text) {
       const t0 = Date.now();
       const r = cp.spawnSync(process.execPath, [__filename, 'review-request', text, '--path', absRoot(root), '--json'], {
         encoding: 'utf8', timeout: 15000,
-        env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
+        env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
       });
       if (r.status === 0 && r.stdout) {
         const j = JSON.parse(r.stdout);
@@ -7918,7 +7883,7 @@ function handoff(root) {
       // 1) drift level (가벼운 check)
       try {
         const r = cp.spawnSync(process.execPath, [__filename, 'drift', 'check', root, '--json'],
-          { encoding: 'utf8', timeout: 8000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
+          { encoding: 'utf8', timeout: 8000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
         const j = JSON.parse(r.stdout.trim());
         if (j.level) parts.push(`drift ${j.level.replace(/^[^\w]+/, '')} (${j.score})`);
       } catch {}
@@ -8516,7 +8481,7 @@ function handoff(root) {
                 if (!has('--no-brainstorm-hits') && !has('--quiet') && process.env.LEERNESS_NO_BRAINSTORM_HITS !== '1') {
                   try {
                     const r = cp.spawnSync(process.execPath, [__filename, 'brainstorm', keyword, '--path', root, '--json'],
-                      { encoding: 'utf8', timeout: 8000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
+                      { encoding: 'utf8', timeout: 8000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
                     const bj = JSON.parse(r.stdout);
                     const hits = bj.hits || {};
                     const items = [];
@@ -9019,7 +8984,7 @@ function handoff(root) {
             if (process.env.LEERNESS_AUTO_SECURITY_FIX === '1') {
               try {
                 const r = cp.spawnSync(process.execPath, [__filename, 'audit', root, '--fix'],
-                  { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
+                  { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
                 if (r.status === 0) {
                   log(dim(`  ✓ 자동 회복 (LEERNESS_AUTO_SECURITY_FIX=1): audit --fix 완료`));
                 } else {
@@ -9264,7 +9229,7 @@ function handoffCmd(root) {
           if (has('--auto-recover') && sevStale) {
             log(dim(`     🔧 --auto-recover 활성 — session close 자동 실행 중...`));
             try {
-              const r = cp.spawnSync(process.execPath, [__filename, 'session', 'close', absR0], { encoding: 'utf8', timeout: 60000 });
+              const r = cp.spawnSync(process.execPath, [__filename, 'session', 'close', absR0], { encoding: 'utf8', timeout: 60000, env: { ...process.env, LEERNESS_INTERNAL: '1' } });
               if (r.status === 0) {
                 log(dim(`     ✓ session close 자동 완료 (다음 라운드부터 healthy)`));
                 const s2 = _readUsageStats(absR0);
@@ -12302,7 +12267,7 @@ function sessionClose(root, opts = {}) {
     // 1) skill suggest
     try {
       const r = cp.spawnSync(process.execPath, [__filename, 'skill', 'suggest', '--path', root, '--min', '3', '--json'],
-        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
       const j = JSON.parse(r.stdout);
       if (j.candidates && j.candidates.length) {
         log(dim('  📌 신규 skill 후보 (Hermes-style 자동 학습):'));
@@ -12313,7 +12278,7 @@ function sessionClose(root, opts = {}) {
     // 2) drift check
     try {
       const r = cp.spawnSync(process.execPath, [__filename, 'drift', 'check', root, '--json'],
-        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
       const j = JSON.parse(r.stdout.trim());
       if (j.level) {
         log(dim(`  🩺 drift 상태: ${j.level} ${j.score}/200`));
@@ -15740,7 +15705,7 @@ function driftCheckCmd(root, opts = {}) {
     log(`🔒 --auto-fix 활성 (1.9.82) — 보안 신호 회복: audit --fix 자동 실행 중...`);
     try {
       const r = cp.spawnSync(process.execPath, [__filename, 'audit', root, '--fix'],
-        { encoding: 'utf8', timeout: 30000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
+        { encoding: 'utf8', timeout: 30000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
       if (r.status === 0) {
         log(`✓ audit --fix 완료 — .gitignore + .env.example 동기화`);
         // 재검사 (보안 신호 회복 확인)
@@ -15853,7 +15818,7 @@ function driftCheckCmd(root, opts = {}) {
     log('');
     log(`🔧 --auto-fix 활성 — session close 자동 실행 중...`);
     try {
-      const r = cp.spawnSync(process.execPath, [__filename, 'session', 'close', root], { encoding: 'utf8', timeout: 60000 });
+      const r = cp.spawnSync(process.execPath, [__filename, 'session', 'close', root], { encoding: 'utf8', timeout: 60000, env: { ...process.env, LEERNESS_INTERNAL: '1' } });
       if (r.status === 0) {
         log(`✓ session close 자동 완료`);
         // autoResolved 카운트
@@ -16134,7 +16099,7 @@ function skillPublishCmd(root) {
   if (!has('--no-security-check') && !has('--force')) {
     try {
       const r = cp.spawnSync(process.execPath, [__filename, 'health', root, '--json'],
-        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
       const j = JSON.parse(r.stdout.trim());
       if (j.issues && j.issues.length > 0) {
         log(`🚨 보안 사전 점검 (1.9.98): ${j.issues.length}건 issue 발견`);
@@ -16217,11 +16182,11 @@ const BENCHMARK_SCENARIOS = {
     setup: (dir) => {
       // 빈 evidence로 done task 생성
       cp.spawnSync(process.execPath, [__filename, 'task', 'add', '거짓 완료된 작업', '--status', 'done', '--evidence', '', '--path', dir],
-        { encoding: 'utf8', timeout: 10000, env: { ...process.env, LEERNESS_NO_PROMPT: '1' } });
+        { encoding: 'utf8', timeout: 10000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1' } });
     },
     measure: (dir) => {
       const r = cp.spawnSync(process.execPath, [__filename, 'lazy', 'detect', dir],
-        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_DRIFT_CHECK: '1' } });
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
       const detected = /✗ |found.*issue|증거 없는|empty/.test(r.stdout);
       return { detected, exit: r.status, sample: r.stdout.slice(0, 200) };
     }
@@ -16236,7 +16201,7 @@ const BENCHMARK_SCENARIOS = {
     measure: (dir) => {
       const r = cp.spawnSync(process.execPath, [__filename, 'contract', 'verify',
         path.join(dir, 'mismatch-spec.md'), path.join(dir, 'mismatch-impl.js'), '--json'],
-        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_DRIFT_CHECK: '1' } });
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
       let j = null;
       try { j = JSON.parse(r.stdout); } catch {}
       const detected = j && j.missingFunctions && j.missingFunctions.includes('missingFn');
@@ -16256,7 +16221,7 @@ const BENCHMARK_SCENARIOS = {
     },
     measure: (dir) => {
       const r = cp.spawnSync(process.execPath, [__filename, 'drift', 'check', dir, '--json'],
-        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_DRIFT_CHECK: '0' } });
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
       let j = null;
       try { j = JSON.parse(r.stdout.trim()); } catch {}
       const detected = j && (j.level === '🔴 critical' || j.level === '🟠 attention');
@@ -16275,7 +16240,7 @@ const BENCHMARK_SCENARIOS = {
     measure: (dir) => {
       const r = cp.spawnSync(process.execPath, [__filename, 'skill', 'install',
         path.join(dir, 'bom-test.md'), '--path', dir],
-        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1' } });
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1' } });
       const f = path.join(dir, '.harness', 'skills', 'bom-test', 'SKILL.md');
       return { detected: r.status === 0 && exists(f), sample: r.stdout.slice(0, 200) };
     }
@@ -16312,7 +16277,7 @@ async function _benchmarkMeasure(root, task) {
     const t1 = Date.now();
     cp.spawnSync(process.execPath, [__filename, 'audit', root, '--fix'], {
       encoding: 'utf8', timeout: 15000,
-      env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
+      env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
     });
     const verifyTime = Date.now() - t1;
     results.push({
@@ -16782,7 +16747,7 @@ function mcpServeCmd(root) {
     const r = cp.spawnSync(process.execPath, [__filename, ...cliArgs], {
       encoding: 'utf8',
       timeout: 60000,
-      env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_STALE_CHECK: '1', LEERNESS_NO_DRIFT_CHECK: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_WORKFLOW_GUIDE: '1' }
+      env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_STALE_CHECK: '1', LEERNESS_NO_DRIFT_CHECK: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_WORKFLOW_GUIDE: '1' }
     });
     return { ok: r.status === 0, exit: r.status, stdout: r.stdout || '', stderr: r.stderr || '' };
   }
@@ -18917,7 +18882,7 @@ async function _agentRepl(root, opts) {
   try {
     const hf = cp.spawnSync(process.execPath, [__filename, 'handoff', root, '--compact', '--no-drift-check', '--no-headline'], {
       encoding: 'utf8', timeout: 8000,
-      env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1', LEERNESS_NO_LESSONS: '1' }
+      env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1', LEERNESS_NO_LESSONS: '1' }
     });
     if (hf.status === 0 && hf.stdout) {
       const preview = hf.stdout.split('\n').slice(0, 4).map(l => l.replace(/^\s+/, '')).filter(Boolean).slice(0, 3).join(' · ');
@@ -19659,7 +19624,7 @@ async function agentCmd(root, taskArg) {
   log(`permission mode: ${perms.mode || 'basic'}`);
   // handoff 자동 회수 (compact 모드)
   try {
-    const hf = cp.spawnSync(process.execPath, [__filename, 'handoff', root, '--compact', '--no-drift-check'], { encoding: 'utf8', timeout: 10000, env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1' } });
+    const hf = cp.spawnSync(process.execPath, [__filename, 'handoff', root, '--compact', '--no-drift-check'], { encoding: 'utf8', timeout: 10000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1' } });
     if (hf.status === 0 && hf.stdout) {
       const preview = hf.stdout.split('\n').slice(0, 6).join('\n');
       log('\n[handoff context (preview)]\n' + preview);
@@ -19886,7 +19851,7 @@ async function incidentHandleCmd(root, id) {
     const keywords = String(err).toLowerCase().match(/[\w가-힣]{4,}/g) || [];
     if (keywords.length) {
       const r = cp.spawnSync(process.execPath, [__filename, 'lessons', '--path', root, '--query', keywords[0], '--limit', '3'],
-        { encoding: 'utf8', timeout: 8000, env: { ...process.env, LEERNESS_NO_PROMPT: '1' } });
+        { encoding: 'utf8', timeout: 8000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1' } });
       if (r.status === 0 && /총 \d+건 발견/.test(r.stdout)) {
         const block = r.stdout.split('\n').slice(0, 12).join('\n');
         log(`\n📚 관련 lessons:\n${block}`);
@@ -20027,7 +19992,7 @@ function healthCmd(root) {
   // 1) drift level
   try {
     const r = cp.spawnSync(process.execPath, [__filename, 'drift', 'check', root, '--json'],
-      { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
+      { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_INTERNAL: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
     const j = JSON.parse(r.stdout.trim());
     out.checks.drift = { level: j.level, score: j.score, firedCount: (j.fired || []).length };
   } catch { out.checks.drift = { error: 'drift check 실패' }; }
@@ -21152,7 +21117,7 @@ function reviewRequestCmd(root, request) {
   try {
     const r = cp.spawnSync(process.execPath, [__filename, 'brainstorm', text, '--path', root, '--json'], {
       encoding: 'utf8', timeout: 12000,
-      env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
+      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);
@@ -21540,7 +21505,8 @@ async function main() {
   }
   if (has('--help') || has('-h')) return help();
   // 1.9.38 (B): 사용 통계 카운터 — usage stats 명령 자체와 비차단 경로는 제외
-  if (cmd !== 'usage' && cmd !== 'init' && cmd !== 'migrate' && cmd !== '--version' && cmd !== '--help') {
+  // 1.9.317 (UR-0051, 설치리뷰): 내부 auto-call(LEERNESS_INTERNAL=1) 은 usage 집계 제외 — 텔레메트리 오염(거짓 skill 추천) 방지.
+  if (process.env.LEERNESS_INTERNAL !== '1' && cmd !== 'usage' && cmd !== 'init' && cmd !== 'migrate' && cmd !== '--version' && cmd !== '--help') {
     try {
       const root = absRoot(arg('--path', args[1] && !args[1].startsWith('-') ? args[1] : process.cwd()));
       if (exists(path.join(root, '.harness'))) _bumpUsage(root, cmd);

package/lib/pure-utils.js

@@ -155,9 +155,52 @@ function _newRunRecord(opts = {}) {
   };
 }
 
+// 1.9.318 (UR-0025): 순수 HTML 파싱 유틸 (api-skill 문서 수집용) — fs/네트워크 의존 0, URL/regex 만 사용.
+function _htmlToText(html) {
+  if (!html) return '';
+  return html
+    .replace(/<script[\s\S]*?<\/script>/gi, '')
+    .replace(/<style[\s\S]*?<\/style>/gi, '')
+    .replace(/<!--[\s\S]*?-->/g, '')
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<\/?(p|div|li|h[1-6]|tr|td|pre)[^>]*>/gi, '\n')
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;/g, "'")
+    .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(parseInt(n, 10)))
+    .replace(/[ \t]+/g, ' ').replace(/\n\s*\n\s*\n+/g, '\n\n').trim();
+}
+function _extractTitle(html) {
+  const m = (html || '').match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+  if (!m) return '';
+  return _htmlToText(m[1]).slice(0, 200);
+}
+function _extractLinks(html, baseUrl, maxLinks) {
+  if (!html) return [];
+  const base = new URL(baseUrl);
+  const found = new Map();
+  const re = /<a\s+[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi;
+  let m;
+  while ((m = re.exec(html)) !== null) {
+    let href = m[1];
+    if (!href || href.startsWith('#') || href.startsWith('javascript:') || href.startsWith('mailto:')) continue;
+    let abs;
+    try { abs = new URL(href, baseUrl).toString(); } catch { continue; }
+    const u = new URL(abs);
+    if (u.hostname !== base.hostname) continue; // same-domain only
+    if (abs === baseUrl) continue;
+    if (found.has(abs)) continue;
+    const text = _htmlToText(m[2]).slice(0, 120);
+    found.set(abs, { url: abs, text });
+    if (found.size >= (maxLinks || 10)) break;
+  }
+  return Array.from(found.values());
+}
+
 module.exports = {
   _isSecretKey, compareVer, parseHarnessVersion,
   _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
   // 1.9.283 (UR-0025 2단계)
-  PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord
+  PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord,
+  // 1.9.318 (UR-0025): 순수 HTML 파싱 유틸
+  _htmlToText, _extractTitle, _extractLinks
 };

package/package.json

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

package/scripts/e2e.js

@@ -3411,7 +3411,8 @@ total++;
     cp.spawnSync(process.execPath, [CLI, 'init', lDir, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
     const N = 6;
     const procs = [];
-    for (let i = 0; i < N; i++) procs.push(cp.spawn(process.execPath, [CLI, 'task', 'add', 'LOCKTEST-' + i, '--path', lDir], { stdio: 'ignore' }));
+    // 1.9.318: --no-review 로 review-request 내부 spawn(~550ms×N) 제외 — 락(동시성) 자체만 격리 검증 (전체 e2e 부하 시 타임아웃 플래키 방지)
+    for (let i = 0; i < N; i++) procs.push(cp.spawn(process.execPath, [CLI, 'task', 'add', 'LOCKTEST-' + i, '--path', lDir, '--no-review'], { stdio: 'ignore' }));
     const ptPath = path.join(lDir, '.harness', 'progress-tracker.md');
     // 자식들이 OS 프로세스로 독립 진행 → 부모는 파일을 sync 폴링(원자쓰기라 부분읽기 없음)
     const start = Date.now(); let found = 0;
@@ -3752,5 +3753,51 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.317 회귀 (UR-0051 설치리뷰): 텔레메트리 분리 — 내부 auto-call(LEERNESS_INTERNAL)이 usage 집계 오염 안 함
+total++;
+{
+  let ok = false;
+  try {
+    const td = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-telem-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', td, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+    const usagePath = path.join(td, '.harness', 'cache', 'usage-stats.json');
+    const cmds = () => { try { return JSON.parse(fs.readFileSync(usagePath, 'utf8')).commands || {}; } catch { return {}; } };
+    // task add → 내부 review-request auto-call 이 usage 오염 안 함 (task 만 집계, review-request 없음)
+    cp.spawnSync(process.execPath, [CLI, 'task', 'add', '텔레메트리 테스트', '--path', td], { encoding: 'utf8', timeout: 20000 });
+    const afterTask = cmds();
+    const noPollution = afterTask.task >= 1 && !afterTask['review-request'];
+    // LEERNESS_INTERNAL=1 호출은 미집계 (일반 호출은 집계)
+    cp.spawnSync(process.execPath, [CLI, 'drift', 'check', '--path', td], { encoding: 'utf8', timeout: 20000 });
+    const d1 = cmds().drift || 0;
+    cp.spawnSync(process.execPath, [CLI, 'drift', 'check', '--path', td], { encoding: 'utf8', timeout: 20000, env: { ...process.env, LEERNESS_INTERNAL: '1' } });
+    const d2 = cmds().drift || 0;
+    const internalSkip = d1 >= 1 && d2 === d1;   // 일반=증가, INTERNAL=증가없음
+    ok = noPollution && internalSkip;
+    fs.rmSync(td, { recursive: true, force: true });
+  } catch {}
+  console.log(ok ? '✓ B(1.9.317) 텔레메트리 분리: task add review-request 오염 없음 + LEERNESS_INTERNAL 미집계 (UR-0051)' : '✗ 텔레메트리 분리 실패');
+  if (!ok) failed++;
+}
+
+// 1.9.318 회귀 (UR-0025 모듈화): HTML 파싱 유틸 3종 lib/pure-utils 분리 + harness 인라인 제거 + 동작 보존 + 소비명령 로드
+total++;
+{
+  let ok = false;
+  try {
+    const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
+    const fnOk = typeof m._htmlToText === 'function' && typeof m._extractTitle === 'function' && typeof m._extractLinks === 'function';
+    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 movedOut = !/function _htmlToText\(html\) \{/.test(harnessSrc) && /_htmlToText, _extractTitle, _extractLinks \} = require\('\.\.\/lib\/pure-utils'\)/.test(harnessSrc);
+    const r = cp.spawnSync(process.execPath, [CLI, 'api-skill'], { encoding: 'utf8', timeout: 15000 });  // 소비 명령 로드
+    const cmdOk = /api-skill/.test(r.stdout || '');
+    ok = fnOk && work && movedOut && cmdOk;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.318) lib/pure-utils HTML 유틸 분리: 모듈 단일출처 + 인라인 제거 + api-skill 로드 (UR-0025)' : '✗ HTML 유틸 분리 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);