leerness 1.9.422 → 1.9.424

package/bin/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.422';
+const VERSION = '1.9.424';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2965,7 +2965,7 @@ function _selfTestCases() {
     { name: 'UR-0061(외부리뷰 P1): roadmap CSS 값 살균 — :root/</style> breakout 차단', run: () => { const m = require('../lib/pure-utils'); const css = m._roadmapTokenStyles({ 'color.primary': 'red;}' + '</style><script>alert(1)</script>' }, {}); const blocked = !css.includes('<') && !css.includes('>'); const primaryLine = (css.split('\n').find(l => l.includes('--lr-primary')) || ''); const noBreakout = !primaryLine.replace(/;$/, '').includes('}'); const preserved = m._roadmapTokenStyles({ 'color.primary': '#2563eb' }, {}).includes('--lr-primary: #2563eb'); return blocked && noBreakout && preserved; } },
     { name: 'UR-0060(외부리뷰 P1): SECRET_PATTERNS 20종 (unquoted 보강) — GitLab/JWT/DB-URI/SendGrid/AWS-secret/Bearer 보강 + 오탐 가드', run: () => { const c = require('../lib/catalogs'); const hit = s => c.SECRET_PATTERNS.some(p => { p.re.lastIndex = 0; return p.re.test(s); }); const det = hit('glpat-' + 'x'.repeat(20)) && hit('eyJ' + 'x'.repeat(15) + '.eyJ' + 'y'.repeat(15) + '.' + 'z'.repeat(15)) && hit('postgres://u:p@host:5432/db') && hit('SG.' + 'x'.repeat(22) + '.' + 'y'.repeat(43)) && hit('aws_secret_access_key = "' + 'x'.repeat(40) + '"') && hit('Bearer ' + 'x'.repeat(25)); const clean = !hit('const u = "john' + '_doe_2024";') && !hit('https://example.com/path/to/page'); return c.SECRET_PATTERNS.length === 20 && det && clean; } },
     { name: 'UR-0068(외부리뷰 P2): _roadmapParseMilestones 블록 경계 — 다음 milestone status 누출 차단', run: () => { const m = require('../lib/pure-utils'); const r = m._roadmapParseMilestones('### M-0001. A\n\n### M-0002. B\nStatus: done\nProgress: 80%\n'); return r.length === 2 && r[0].status === 'planned' && r[0].progress === 0 && r[1].status === 'done' && r[1].progress === 80; } },
-    { name: 'UR-0066(외부리뷰 P2): shell:true 주입 가드 — agents bench task _shellQuoteArg + fetchNpmLatest cmd.exe args', run: () => { const m = require('../lib/pure-utils'); const src = read(__filename); const benchQuoted = src.includes('const qTask = ' + '_shellQuoteArg(task)'); const npmSafe = /'\/d', '\/s', '\/c', 'npm', 'view'/.test(src); const q = m._shellQuoteArg('a & b'); const safe = (process.platform === 'win32' ? q === '"a & b"' : q === "'a & b'"); return benchQuoted && npmSafe && safe; } },
+    { name: 'UR-0066(외부리뷰 P2): shell:true 주입 가드 — agents bench task _shellQuoteArg + fetchNpmLatest cmd.exe args', run: () => { const m = require('../lib/pure-utils'); const src = read(__filename); const agentsSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'agents.js')); const benchQuoted = agentsSrc.includes('const qTask = ' + '_shellQuoteArg(task)'); const npmSafe = /'\/d', '\/s', '\/c', 'npm', 'view'/.test(src); const q = m._shellQuoteArg('a & b'); const safe = (process.platform === 'win32' ? q === '"a & b"' : q === "'a & b'"); return benchQuoted && npmSafe && safe; } },
     { name: 'UR-0072(외부리뷰 P3): compareVer pre-release + _classifyCJK 한자 kana 귀속', run: () => { const m = require('../lib/pure-utils'); const verOk = m.compareVer('1.9.0-beta', '1.9.0') === -1 && m.compareVer('1.9.0', '1.9.0-beta') === 1 && m.compareVer('1.9.5', '1.9.5') === 0 && m.compareVer('1.9.6', '1.9.5') === 1; const jp = Buffer.from([0xE3, 0x81, 0x82, 0xE6, 0x97, 0xA5, 0xE6, 0x9C, 0xAC]); const cn = Buffer.from([0xE4, 0xB8, 0xAD, 0xE5, 0x9B, 0xBD]); const rj = m._classifyCJK(jp, jp.length); const rc = m._classifyCJK(cn, cn.length); const cjkOk = rj.japanese > rj.chinese && rc.chinese > 0 && rc.japanese === 0; return verOk && cjkOk; } },
     { name: 'UR-0075 Phase A: 마이그레이션 가이드(_migrationGuideText) + migrate --guide 와이어 + init/migrate/update --path', run: () => { const m = require('../lib/pure-utils'); const g = m._migrationGuideText('1.9.355'); const guideOk = typeof g === 'string' && g.includes('마이그레이션 가이드') && g.includes('update --check --path') && g.includes('selftest') && g.includes('canonical JSON') && g.includes('롤백') && g.includes('1.9.355'); const src = read(__filename); const wired = src.includes("has('--guide') || args[1] === " + "'guide'") && src.includes('install(arg(' + "'--path', args[1] || process.cwd())") && src.includes('updateCmd(arg(' + "'--path', args[1] || process.cwd())"); return guideOk && wired; } },
     { name: 'UR-0075 Phase B: migrate audit(dry-run 스키마 drift) 명령 + 와이어', run: () => { const src = read(__filename); return typeof migrateAuditCmd === 'function' && src.includes('migrateAuditCmd(arg(' + "'--path'") && src.includes("args[1] === " + "'audit'"); } },
@@ -3073,6 +3073,36 @@ function _selfTestCases() {
     } },
     { 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 큰핸들러 모듈화 9번째: agentsCmd → lib/agents.js + DI 위임 + rest→array (1.9.424)', run: () => {
+      const m = require('../lib/agents');
+      const expOk = typeof m.agentsCmd === 'function';
+      const src = read(__filename);
+      const delegated = src.includes("require('../lib/agents')") && src.includes('_agents.agentsCmd(root, sub, args,');
+      const modSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'agents.js'));
+      const bodyMarker = 'LEERNESS_NO_' + 'MULTIAGENT_LESSON';  // agents 본문 고유(split-literal 자기참조 회피)
+      const sigTransform = modSrc.includes('function agentsCmd(root, sub, args = [], deps = {})') && modSrc.includes("agentsCmd(root, 'list', [], deps)");
+      const movedToLib = modSrc.includes("require('./io')") && modSrc.includes("require('./agent-registry')") && sigTransform && modSrc.includes(bodyMarker) && !src.includes(bodyMarker);
+      return expOk && delegated && movedToLib;
+    } },
+    { name: 'UR-0025 큰핸들러 모듈화 8번째: healthCmd → lib/health.js + DI 위임 + 동작 (1.9.423)', run: () => {
+      const m = require('../lib/health');
+      const expOk = typeof m.healthCmd === 'function';
+      const src = read(__filename);
+      const delegated = src.includes("require('../lib/health')") && src.includes('_health.healthCmd(root,');
+      const modSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'health.js'));
+      const bodyMarker = 'capability' + 'Matrix';  // health 본문 고유(split-literal 자기참조 회피)
+      const movedToLib = modSrc.includes("require('./io')") && modSrc.includes("require('./pure-utils')") && modSrc.includes(bodyMarker) && !src.includes(bodyMarker);
+      let behavOk = false;
+      const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_health_'));
+      const _w = process.stdout.write; let out = '';
+      try {
+        fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true });
+        process.stdout.write = s => { out += s; return true; };
+        m.healthCmd(tmp, { VERSION, has: f => f === '--json', arg: (k, d) => d, harnessPath: path.join(tmp, '__nope.js'), listAllSkills, planPath, readProgressRows, readRules, envDiff, _collectSecretFindings, _readUsageStats, _loadDecisions, _loadLessons, _loadShellFailures, _readFeatureGraph, _scanShellScriptsEncoding, _shellEnvDrift, _computeMilestones, _computeRecentChanges, _computeRoundHistory, _collectPyFiles, _analyzePyFile, _collectRuntimeEnv, _listAPISkills, _matchAPISkills, _mcpToolCount });
+      } catch (e) { out = 'ERR:' + e.message; } finally { process.stdout.write = _w; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} }
+      try { const j = JSON.parse(out); behavOk = typeof j.healthy === 'boolean' && !!j.checks; } catch {}
+      return expOk && delegated && movedToLib && behavOk;
+    } },
     { name: 'UR-0025 큰핸들러 모듈화 7번째: driftCheckCmd → lib/drift.js + DI 위임 + 재귀/동작 (1.9.422)', run: () => {
       const m = require('../lib/drift');
       const expOk = typeof m.driftCheckCmd === 'function';
@@ -11049,448 +11079,9 @@ function _dispatchCommand(agentId, task, writeMode, model) {
   return `# ${agentId}: 명령 빌더 미정의`;
 }
 
-function agentsCmd(root, sub, ...args) {
-  root = absRoot(root || process.cwd());
-  // .env 자동 로드 (1.9.22)
-  _loadEnvFile(root);
-  _loadEnvFile(path.join(root, '..'));
-
-  if (!sub || sub === 'list') {
-    // 1.9.157: Provider Registry 통합 — 빌트인 5종 + 사용자 정의 provider 포함
-    const providers = _allProviders(root);
-    const userIds = new Set(_readUserProviders(root).map(u => u.id));
-    const checks = providers.map(a => ({ ...(_checkAgent(a)), source: userIds.has(a.id) ? 'user' : 'builtin' }));
-    if (has('--json')) { log(JSON.stringify({ agents: checks }, null, 2)); return; }
-    log(`# 외부 AI CLI 오케스트레이션 (1.9.30)`);
-    log('');
-    log(`| Agent | source | env (${'env=1 활성'}) | 설치 | 버전 | 상태 |`);
-    log(`|---|---|---|---|---|---|`);
-    for (const c of checks) {
-      const envMark = c.enabled ? '✓' : '✗';
-      const instMark = c.installed ? '✓' : '✗';
-      const statusEmoji = c.status === 'ready' ? '🟢 ready' : c.status === 'not-installed' ? '⚪ 미설치' : c.status === 'disabled' ? '🟡 비활성' : '❓';
-      log(`| ${c.id} | ${c.source} | ${envMark} ${c.envFlag} | ${instMark} | ${c.version || '-'} | ${statusEmoji} |`);
-    }
-    const ready = checks.filter(c => c.status === 'ready');
-    log('');
-    log(`## 활성 (${ready.length}/${checks.length}): ${ready.map(c => c.id).join(', ') || '(없음)'}`);
-    if (!ready.length) {
-      log('');
-      log(`💡 활성화 방법:`);
-      log(`  1) CLI 설치 (예: \`npm i -g @openai/codex-cli\`, \`npm i -g @google/antigravity-cli\`)`);
-      log(`  2) .env 또는 환경변수: LEERNESS_ENABLE_CODEX=1, LEERNESS_ENABLE_AGY=1`);
-      log(`  3) \`leerness agents check\`로 재확인`);
-      log(`  💡 1.9.157: 빌트인 외 CLI 추가: \`leerness provider add <id> --bin <cmd>\``);
-    } else {
-      log('');
-      log(`💡 메인 에이전트가 sub-agent 분배 시 위 ${ready.length}개 CLI 활용 가능:`);
-      log(`   \`leerness agents dispatch "<task>" --to <id>\` 로 프롬프트 전달`);
-    }
-    return;
-  }
-
-  if (sub === 'check') {
-    // list의 alias, 단 명시적 재확인 (JSON 출력 기본)
-    // 1.9.157: Provider Registry 통합
-    const providers = _allProviders(root);
-    const userIds = new Set(_readUserProviders(root).map(u => u.id));
-    const checks = providers.map(a => ({ ...(_checkAgent(a)), source: userIds.has(a.id) ? 'user' : 'builtin' }));
-    if (has('--json')) { log(JSON.stringify({ agents: checks, ready: checks.filter(c => c.status === 'ready').map(c => c.id) }, null, 2)); return; }
-    return agentsCmd(root, 'list'); // 비-JSON은 list와 동일
-  }
-
-  // 1.9.152: agents multi — 1.9.151 install 복수 선택된 ready 에이전트들에 일괄 dispatch 명령 생성
-  // 단일 task → 활성 N개 에이전트 동시 dispatch 명령들. 사용자가 한 번에 복사 실행하거나 메인 에이전트가 spawn.
-  if (sub === 'multi') {
-    const task = args.filter(x => !x.startsWith('-')).join(' ').trim() || arg('--task', null);
-    if (!task) { fail('multi "<task>" 또는 --task 필요'); return process.exit(1); }
-    const onlyArg = arg('--only', null);  // 'claude,codex' 처럼 콤마 구분 — 활성 중에서 추가 필터
-    const writeMode = has('--write');
-    const execute = has('--execute');  // 1.9.156: 명령 출력 → 실제 spawn + consensus 합의
-    const checks = EXTERNAL_AGENTS.map(a => ({ def: a, status: _checkAgent(a) }));
-    let ready = checks.filter(x => x.status.status === 'ready');
-    if (onlyArg) {
-      const wanted = new Set(onlyArg.split(/[,\s]+/).filter(Boolean));
-      ready = ready.filter(x => wanted.has(x.def.id));
-    }
-    if (!ready.length) {
-      fail('활성 (ready) 에이전트 없음 — `leerness agents list` 로 확인. 1.9.151 install 흐름에서 복수 선택 후 .env 활성화 필요.');
-      return process.exit(1);
-    }
-    // 1.9.281 (UR-0034): 권한 등급 게이트 — enforce ON 시 shell-write 초과 차단 (기본 OFF, 동작 불변)
-    if (execute) {
-      const pol = _policyEnforce(root, 'agents multi --execute');
-      if (!pol.allowed) { fail(pol.reason); return process.exit(1); }
-      if (pol.advisory) warn(`정책 advisory: 'agents multi --execute' 요구 등급 ${pol.required} > 허용 ${pol.allowedTier} (enforce OFF — 진행). leerness policy 로 등급 확인`);
-    }
-    // 1.9.156: --execute 모드 — 실제 spawn + 결과 수집 + multi-signal consensus
-    if (execute) {
-      return (async () => {
-        const timeout = parseInt(arg('--timeout', '60'), 10) * 1000;
-        if (!has('--json')) {
-          log(`# leerness agents multi --execute (1.9.156) — ${ready.length}개 활성 에이전트 병렬 호출`);
-          log(`task: ${task.slice(0, 120)}${task.length > 120 ? '…' : ''}`);
-          log(`mode: ${writeMode ? '✏ write' : '🔒 read-only'} · timeout=${timeout / 1000}s`);
-          log(`대상: ${ready.map(x => x.def.id).join(', ')}`);
-          log('');
-          log('## 병렬 호출 중...');
-        }
-        const t0 = Date.now();
-        // 병렬 _cliChat 호출 (sandbox 자동: runCommandSafe + env scrub + observability)
-        const results = await Promise.all(ready.map(async ({ def }) => {
-          const start = Date.now();
-          const r = await _cliChat(root, def.id, task, { timeout });
-          return {
-            agent: def.id,
-            elapsed: Date.now() - start,
-            ok: r.ok,
-            response: r.response || '',
-            error: r.error || null,
-            responseTokens: Math.ceil((r.response || '').length / 4)  // 대략 token 추정
-          };
-        }));
-        const totalElapsed = Date.now() - t0;
-        const ok = results.filter(r => r.ok);
-        const failures = results.filter(r => !r.ok);
-        _recordRun(root, { kind: 'agents_multi_execute', count: ready.length, success: ok.length, durationMs: totalElapsed, task: task.slice(0, 200) });
-        // 1.9.155 consensus 로직 재사용 — multi-signal scoring (tokens + overlap + lengthFit)
-        let best = null, scored = [];
-        if (ok.length) {
-          const tokenizer = (s) => new Set(String(s || '').toLowerCase().match(/[\w가-힣]{3,}/g) || []);
-          const wordsOf = ok.map(o => tokenizer(o.response));
-          const maxTokens = Math.max(...ok.map(o => o.responseTokens), 1);
-          const avgLen = ok.reduce((s, o) => s + o.response.length, 0) / ok.length;
-          const stdLen = Math.sqrt(ok.reduce((s, o) => s + (o.response.length - avgLen) ** 2, 0) / ok.length) || 1;
-          scored = ok.map((o, i) => {
-            const tokensNorm = o.responseTokens / maxTokens;
-            const myWords = wordsOf[i];
-            let overlapSum = 0;
-            for (let j = 0; j < wordsOf.length; j++) {
-              if (i === j) continue;
-              let inter = 0;
-              for (const w of myWords) if (wordsOf[j].has(w)) inter++;
-              overlapSum += inter / Math.max(myWords.size, 1);
-            }
-            const overlap = (ok.length > 1) ? overlapSum / (ok.length - 1) : 0;
-            const z = Math.abs((o.response.length - avgLen) / stdLen);
-            const lengthFit = z <= 1.5 ? (1 - z / 1.5) : 0;
-            const score = 0.4 * tokensNorm + 0.4 * overlap + 0.2 * lengthFit;
-            return { ...o, score, tokensNorm, overlap, lengthFit };
-          }).sort((a, b) => b.score - a.score);
-          best = scored[0];
-        }
-        if (has('--json')) {
-          log(JSON.stringify({
-            task, count: ready.length, success: ok.length, totalElapsedMs: totalElapsed,
-            results: scored.length ? scored : results,
-            best: best ? { agent: best.agent, score: best.score, response: best.response } : null,
-            failures
-          }, null, 2));
-          return;
-        }
-        log(`\n## 결과: ${ok.length}/${ready.length} 성공 · 총 ${totalElapsed}ms (병렬)`);
-        for (const r of results) {
-          if (r.ok) log(`  ✓ ${r.agent.padEnd(8)} · ${r.elapsed}ms · ${r.responseTokens} 토큰`);
-          else log(`  ✗ ${r.agent.padEnd(8)} · ${r.elapsed}ms · ${(r.error || '').slice(0, 60)}`);
-        }
-        if (best) {
-          log('');
-          log(`## 🏆 합의 선택 (multi-signal consensus, 1.9.155)`);
-          log(`  best: ${best.agent} · score=${best.score.toFixed(3)} (tokens=${best.tokensNorm.toFixed(2)} · overlap=${best.overlap.toFixed(2)} · lengthFit=${best.lengthFit.toFixed(2)})`);
-          if (scored.length > 1) {
-            log(`  others: ${scored.slice(1, 4).map(s => `${s.agent}=${s.score.toFixed(2)}`).join(', ')}`);
-          }
-          log(`  --- 처음 600자 ---`);
-          log(best.response.slice(0, 600));
-          // task-log 기록
-          try {
-            const tlp = taskLogPath(root);
-            const block = `\n## ${today()} agents multi --execute (1.9.156)\n- task: ${task.slice(0, 200)}\n- agents: ${ready.map(x => x.def.id).join(', ')}\n- success: ${ok.length}/${ready.length}\n- best: ${best.agent} (score=${best.score.toFixed(3)})\n`;
-            append(tlp, block);
-          } catch {}
-          // 1.9.193: B축 (멀티 Sub-Agent 오케스트라) 보강 — consensus 결과를 lessons.md 에 자동 기록
-          //   같은 task 재시도 시 과거 best agent + score 가 handoff lessons auto-recall 에서 매칭
-          //   끄기: LEERNESS_NO_MULTIAGENT_LESSON=1
-          if (process.env.LEERNESS_NO_MULTIAGENT_LESSON !== '1') {
-            try {
-              const lp = lessonsPath(root);
-              const lessonBlock = `\n### ${today()} multi-agent consensus — best=${best.agent} (1.9.193)\n`
-                + `- task: ${task.slice(0, 200)}\n`
-                + `- agents: ${ready.map(x => x.def.id).join(', ')} (${ok.length}/${ready.length} success)\n`
-                + `- best agent: ${best.agent}, score=${best.score.toFixed(3)}\n`
-                + (scored.length > 1 ? `- others: ${scored.slice(1, 4).map(s => `${s.agent}=${s.score.toFixed(2)}`).join(', ')}\n` : '')
-                + `- lesson: 같은 keyword 재발 시 ${best.agent} 우선 시도 (multi-signal consensus 입증)\n`;
-              append(lp, lessonBlock);
-            } catch {}
-          }
-        }
-        if (failures.length && !best) {
-          process.exitCode = 1;
-        }
-      })();
-    }
-    if (has('--json')) {
-      log(JSON.stringify({
-        task, count: ready.length,
-        agents: ready.map(x => ({ id: x.def.id, version: x.status.version })),
-        commands: ready.map(x => _dispatchCommand(x.def.id, task, writeMode)),
-        // 1.9.266 (UR-0021 2단계): 각 에이전트 슬래시 명령 힌트 — sub-agent 가 알맞은 슬래시 사용
-        slashCommands: ready.reduce((acc, x) => { const h = _agentSlashHint(root, x.def.id); if (h) acc[x.def.id] = { invoke: h.invoke, commands: h.commands.map(c => c.cmd) }; return acc; }, {})
-      }, null, 2));
-      return;
-    }
-    log(`# leerness agents multi (1.9.152) — ${ready.length}개 활성 에이전트 일괄 dispatch`);
-    log(`task: ${task.slice(0, 120)}${task.length > 120 ? '…' : ''}`);
-    log(`mode: ${writeMode ? '✏ write (파일 수정 가능)' : '🔒 read-only (분석 전용, 안전)'}`);
-    log(`대상: ${ready.map(x => x.def.id).join(', ')}`);
-    log('');
-    log('## 각 에이전트 실행 명령 (사용자가 병렬 실행 또는 메인 에이전트가 spawn)');
-    log('');
-    for (const { def, status } of ready) {
-      log(`### [${def.id}]  (v${status.version || '?'})`);
-      log('```sh');
-      log(_dispatchCommand(def.id, task, writeMode));
-      log('```');
-      // 1.9.266 (UR-0021 2단계): 에이전트별 슬래시 명령 힌트
-      try {
-        const hint = _agentSlashHint(root, def.id);
-        if (hint && hint.commands.length) log(`  🤖 슬래시: ${hint.commands.slice(0, 8).map(c => c.cmd).join(' ')}${hint.invoke === 'subcommand' ? ' (하위명령)' : ''}`);
-      } catch {}
-      log('');
-    }
-    log('## 정책 (1.9.152 / 1.9.156)');
-    log(`  - 기본 모드: 명령 문자열만 출력 (사용자/메인 에이전트가 명시적으로 실행)`);
-    log(`  - 1.9.156 신규: \`--execute\` 플래그 시 leerness가 직접 ${ready.length}개 sub-agent 병렬 spawn + multi-signal consensus 자동 합의`);
-    log(`     예: leerness agents multi "<task>" --execute  (또는 --execute --json)`);
-    log(`  - 활성 에이전트 변경: \`.env\`에서 LEERNESS_ENABLE_<CLI>=1/0 또는 \`leerness setup-agents\` 재실행`);
-    log(`  - quota 체크: \`leerness agents quota\``);
-    return;
-  }
-  if (sub === 'dispatch') {
-    const task = args.filter(x => !x.startsWith('-')).join(' ').trim() || arg('--task', null);
-    let target = arg('--to', null);
-    if (!task) { fail('dispatch "<task>" 또는 --task 필요'); return process.exit(1); }
-    // 1.9.152: --multi 또는 --to=all 또는 --to 없음 + 활성 ≥2 → multi 모드로 routing
-    if (has('--multi') || target === 'all' || target === '*') {
-      return agentsCmd(root, 'multi', ...args);
-    }
-    // 1.9.270: --role <role> — 설정된 역할 → provider+model 라우팅 (--to 없을 때)
-    const roleArg = arg('--role', null);
-    let roleModel = arg('--model', null);
-    let rolePersona = '';
-    if (roleArg && !target) {
-      const resolved = _resolveRole(root, roleArg);
-      if (!resolved) { fail(`역할 미설정: ${_normalizeRole(roleArg)} — leerness roles set ${_normalizeRole(roleArg)} --provider <id> 또는 roles suggest --apply`); return process.exit(1); }
-      target = resolved.provider;
-      if (!roleModel) roleModel = resolved.model;
-      rolePersona = resolved.persona || '';
-      log(`🎭 역할 ${_normalizeRole(roleArg)} → ${target}${roleModel ? ' / ' + roleModel : ''}`);
-      if (rolePersona) log(`   persona: ${rolePersona}`);
-    }
-    if (!target) { fail('--to <agent_id> 또는 --role <role> 필요 (claude/codex/agy/grok/copilot) — 활성 전체 일괄은 `leerness agents multi`'); return process.exit(1); }
-    const agentDef = EXTERNAL_AGENTS.find(a => a.id === target);
-    if (!agentDef) { fail(`알 수 없는 agent: ${target}`); return process.exit(1); }
-    // 1.9.36: 작업 유형 키워드 분석 → 최적 CLI 추천 (ready 체크 전에 출력 — 비활성이어도 추천)
-    const recommendation = _recommendAgent(task);
-    const recommended = recommendation.target;
-    if (recommended && recommended !== target) {
-      log(`💡 추천: 이 작업은 ${recommended}가 더 적합 (${recommendation.reason})`);
-    }
-    const status = _checkAgent(agentDef);
-    if (status.status !== 'ready') {
-      fail(`${target} 비활성 (${status.status}). 환경변수 ${agentDef.envFlag}=1 + CLI 설치 필요.`);
-      return process.exit(1);
-    }
-    // 1.9.36: --write 시 파일 수정 가능 권장 플래그 자동 첨부, 미명시 시 read-only 안전 모드
-    const writeMode = has('--write');
-    const readOnly = has('--readonly') || !writeMode;
-    // 실제 호출은 안 함 — 프롬프트만 생성 (사용자가 명시적으로 실행)
-    log(`# leerness agents dispatch (1.9.36)`);
-    log(`대상: ${target} (${agentDef.bin})`);
-    log(`상태: 🟢 ready, 버전 ${status.version || '?'}`);
-    log(`모드: ${writeMode ? '✏ write (파일 수정 가능)' : '🔒 read-only (분석 전용, 안전)'}`);
-    log('');
-    log(`## 실행 명령 (사용자가 복사해서 실행)`);
-    if (roleModel) log(`# 🎭 모델: ${roleModel} (역할 기반 라우팅, 1.9.270)`);
-    log('');
-    // 1.9.270: _dispatchCommand 로 통일 (roleModel 주입) — 명령 빌더 단일화
-    log(_dispatchCommand(target, task, writeMode, roleModel));
-    if (target === 'claude' && writeMode) log(`# ⚠ --dangerously-skip-permissions: 도구 권한 자동 승인 (파일 수정 가능)`);
-    if (target === 'codex') { log(`# ℹ codex는 PowerShell 경유 — POSIX /tmp 경로는 C:\\tmp\\로 해석됨`); if (writeMode) log(`# ⚠ --dangerously-bypass-approvals-and-sandbox: sandbox 우회`); }
-    if (target === 'agy' && writeMode) log(`# ⚠ --yolo: 워크스페이스 파일 직접 수정 가능`);
-    if (target === 'grok' && writeMode) log(`# ⚠ grok --yolo: 자동 승인 (배포판에 따라 플래그 상이 가능)`);
-    // 1.9.266 (UR-0021 2단계): 대상 에이전트의 슬래시 명령 힌트 — sub-agent 작업 시 알맞은 슬래시 명령 참조
-    try {
-      const hint = _agentSlashHint(root, target);
-      if (hint && hint.commands.length) {
-        log('');
-        log(`## 🤖 ${target} 슬래시 명령 (1.9.265, UR-0021)`);
-        if (hint.invoke === 'subcommand') log(`  ※ 슬래시가 아닌 하위명령: ${hint.commands.map(c => c.cmd).join(' / ')}`);
-        else log(`  세션 내 사용 가능: ${hint.commands.slice(0, 10).map(c => c.cmd).join('  ')}`);
-        log(`  → 전체/기록: leerness slash-commands ${target} [--record]`);
-      }
-    } catch {}
-    log('');
-    log(`## 정책 (1.9.36)`);
-    log(`  - leerness는 외부 CLI를 자동 호출하지 않음 (사용자 명시적 실행)`);
-    log(`  - 메인 에이전트(Claude)가 위 명령을 보고 sub-agent로 spawn 가능`);
-    log(`  - quota 체크: \`leerness agents quota\` (1.9.31+)`);
-    log(`  - 동시 호출 시: \`leerness agents bench "<task>"\` (1.9.36)`);
-    log('');
-    log(`## 분배 시 안전 규칙 (1.9.35)`);
-    log(`  - sub-agent 프롬프트에 "당신만 수정할 파일 경로"를 명시 (파일 경로 격리)`);
-    log(`  - sub-agent에 "보고 시 \`stat <file>\` 또는 mtime 확인 결과 첨부" 요구 (자기 격리 검증)`);
-    log(`  - 사양 사전 정의 (예: TICK_SPEC.md) → \`leerness contract verify\`로 사후 검증`);
-    log(`  - 같은 파일 동시 쓰기는 last-writer-wins 위험 (1.9.34 검증)`);
-    return;
-  }
-
-  if (sub === 'bench') {
-    // 1.9.36: 같은 prompt를 ready CLI 모두에 동시 호출 + 시간/응답 길이/exit code 비교
-    const task = args.filter(x => !x.startsWith('-')).join(' ').trim() || arg('--task', null);
-    if (!task) { fail('bench "<task>" 필요'); return process.exit(1); }
-    const timeoutS = parseInt(arg('--timeout', '60'), 10);
-    const writeMode = has('--write');
-    const ready = EXTERNAL_AGENTS.map(a => ({ agent: a, status: _checkAgent(a) }))
-                                  .filter(x => x.status.status === 'ready');
-    if (!ready.length) {
-      fail('ready CLI 없음 — leerness setup-agents 또는 .env에 LEERNESS_ENABLE_X=1 설정 필요');
-      return process.exit(1);
-    }
-    log(`# leerness agents bench (1.9.36)`);
-    log(`task: ${task.slice(0, 80)}${task.length > 80 ? '…' : ''}`);
-    log(`참여 CLI: ${ready.map(r => r.agent.id).join(', ')} (${ready.length}개)`);
-    log(`타임아웃: ${timeoutS}s/CLI · 모드: ${writeMode ? 'write' : 'read-only'}`);
-    log('');
-    log('병렬 호출 중... (병렬 fork 후 wait)');
-    log('');
-    const results = [];
-    const promises = ready.map(({ agent, status }) => new Promise((resolve) => {
-      const t0 = Date.now();
-      let cmd, cmdArgs;
-      // 1.9.352 (UR-0066 외부리뷰): shell:true 경로에 raw task 전달 시 셸 메타문자(& | $() 백틱) 주입 위험 → _shellQuoteArg 로 단일 토큰화 (안전 경로 _cliChat 와 일관)
-      const qTask = _shellQuoteArg(task);
-      if (agent.id === 'claude') {
-        cmdArgs = writeMode ? ['--print', '--dangerously-skip-permissions', qTask] : ['--print', qTask];
-        cmd = 'claude';
-      } else if (agent.id === 'codex') {
-        cmdArgs = writeMode
-          ? ['exec', '--skip-git-repo-check', '--dangerously-bypass-approvals-and-sandbox', qTask]
-          : ['exec', '--skip-git-repo-check', qTask];
-        cmd = 'codex';
-      } else if (agent.id === 'agy') {
-        cmdArgs = writeMode ? ['-p', qTask, '--yolo'] : ['-p', qTask];
-        cmd = 'agy';
-      } else if (agent.id === 'copilot') {
-        cmdArgs = ['copilot', 'suggest', qTask];
-        cmd = 'gh';
-      }
-      const r = cp.spawn(cmd, cmdArgs, { shell: true });
-      let stdout = '', stderr = '';
-      r.stdout.on('data', d => { stdout += d; });
-      r.stderr.on('data', d => { stderr += d; });
-      const timer = setTimeout(() => { r.kill(); }, timeoutS * 1000);
-      r.on('close', (code) => {
-        clearTimeout(timer);
-        const elapsed = Date.now() - t0;
-        results.push({
-          id: agent.id, exit: code, elapsed,
-          stdout: stdout.trim().split('\n').slice(-3).join('\n'),
-          stderrLen: stderr.length,
-          ok: code === 0 && stdout.trim().length > 0
-        });
-        resolve();
-      });
-      r.on('error', (err) => {
-        clearTimeout(timer);
-        results.push({ id: agent.id, exit: -1, elapsed: Date.now() - t0, stdout: '', stderrLen: 0, error: err.message, ok: false });
-        resolve();
-      });
-    }));
-    return Promise.all(promises).then(() => {
-      if (has('--json')) { log(JSON.stringify({ task, results }, null, 2)); return; }
-      log(`| CLI | 시간 | exit | 응답 길이 | 마지막 라인 |`);
-      log(`|---|---:|---:|---:|---|`);
-      // sort by elapsed
-      results.sort((a, b) => a.elapsed - b.elapsed);
-      for (const r of results) {
-        const respLen = (r.stdout || '').length;
-        const last = (r.stdout || '').split('\n').pop().slice(0, 50);
-        log(`| ${r.id} | ${r.elapsed}ms | ${r.exit} | ${respLen} | ${last.replace(/\|/g, '\\|')} |`);
-      }
-      log('');
-      const okCount = results.filter(r => r.ok).length;
-      log(`결과: ${okCount}/${results.length} 성공`);
-      const fastest = results.filter(r => r.ok).sort((a, b) => a.elapsed - b.elapsed)[0];
-      if (fastest) log(`🏆 가장 빠름: ${fastest.id} (${fastest.elapsed}ms)`);
-    });
-  }
-
-  if (sub === 'quota') {
-    // 1.9.31: 각 CLI 사용량/쿼터 추정 + provider 대시보드 링크
-    const results = [];
-    for (const agent of EXTERNAL_AGENTS) {
-      const base = _checkAgent(agent);
-      const out = { id: agent.id, bin: agent.bin, status: base.status, quota: null, hint: null, raw: null };
-      if (base.status !== 'ready') {
-        out.hint = base.status === 'not-installed' ? `${agent.bin} CLI 미설치` : base.status === 'disabled' ? `${agent.envFlag}=1 필요` : '알 수 없음';
-        results.push(out); continue;
-      }
-      // CLI별 quota 탐지 시도
-      try {
-        if (agent.id === 'claude') {
-          // claude는 /status 슬래시 (대화형)만 지원. 비대화형 추정 불가.
-          out.quota = 'unknown';
-          out.hint = '대화 내 `/status` 슬래시 또는 https://console.anthropic.com/settings/usage 확인';
-        } else if (agent.id === 'codex') {
-          // codex CLI: codex --help에 usage 명령 있는지 확인
-          const r = cp.spawnSync(agent.bin, ['--help'], { encoding: 'utf8', timeout: 4000, shell: true });
-          const help = (r.stdout || r.stderr || '').toLowerCase();
-          if (help.includes('usage') || help.includes('quota')) {
-            out.quota = 'cli-supported';
-            out.hint = '`codex usage` 또는 `codex quota` 시도 가능';
-          } else {
-            out.quota = 'unknown';
-            out.hint = 'https://platform.openai.com/account/usage 확인';
-          }
-          out.raw = help.slice(0, 200);
-        } else if (agent.id === 'agy') {
-          // agy CLI (Antigravity): 무료 티어는 분당 60req 제한, CLI 자체에선 노출 안 됨
-          out.quota = 'rate-limited';
-          out.hint = '무료 티어: 60 req/min, 1000 req/day · Antigravity 유료 플랜은 https://antigravity.google.com';
-        } else if (agent.id === 'copilot') {
-          // gh copilot은 GitHub Copilot 구독 (월 단위 quota 없음, individual/business 플랜)
-          const r = cp.spawnSync('gh', ['auth', 'status'], { encoding: 'utf8', timeout: 4000, shell: true });
-          const authed = r.status === 0;
-          out.quota = authed ? 'subscription' : 'not-authed';
-          out.hint = authed ? 'Copilot 구독자 무제한 (월 플랜) · https://github.com/settings/copilot' : '`gh auth login` 필요';
-        }
-      } catch (e) {
-        out.quota = 'error';
-        out.hint = e.message;
-      }
-      results.push(out);
-    }
-    if (has('--json')) { log(JSON.stringify({ quota: results }, null, 2)); return; }
-    log(`# 외부 AI CLI quota 추정 (1.9.31)`);
-    log('');
-    log(`| Agent | 상태 | quota | 안내 |`);
-    log(`|---|---|---|---|`);
-    for (const q of results) {
-      const statusEmoji = q.status === 'ready' ? '🟢' : q.status === 'not-installed' ? '⚪' : q.status === 'disabled' ? '🟡' : '❓';
-      log(`| ${q.id} | ${statusEmoji} ${q.status} | ${q.quota || '-'} | ${q.hint || '-'} |`);
-    }
-    log('');
-    log(`## 주의`);
-    log(`  - leerness는 CLI 사용량을 직접 추적하지 않음 (provider 대시보드 참조)`);
-    log(`  - rate-limit/quota는 plan/티어에 따라 달라짐`);
-    log(`  - sub-agent 분배 시 quota 여유 큰 CLI 우선 활용 권장`);
-    return;
-  }
-
-  fail('사용법: leerness agents list|check|quota|dispatch|bench [--write] "<task>" [--to <id>]');
-  return process.exit(1);
-}
+const _agents = require('../lib/agents');
+// 1.9.424 (UR-0025/UR-0125 큰 핸들러 모듈화 9번째): agentsCmd → lib/agents.js (DI 위임, rest→array)
+function agentsCmd(root, sub, ...args) { return _agents.agentsCmd(root, sub, args, { VERSION, has, arg, _agentSlashHint, _allProviders, _checkAgent, _cliChat, _dispatchCommand, _loadEnvFile, _normalizeRole, _policyEnforce, _readUserProviders, _recommendAgent, _recordRun, _resolveRole, _shellQuoteArg, lessonsPath, taskLogPath }); }
 
 function personaCmd(root, sub, idOrName, ...rest) {
   root = absRoot(root || process.cwd());
@@ -18815,340 +18406,9 @@ async function deployAutoCmd(root, service) {
 }
 
 // 1.9.85: leerness health — 종합 헬스 체크 (drift + 보안 + skill + MCP + 누적)
-function healthCmd(root) {
-  root = absRoot(root || process.cwd());
-  const out = { root, generatedAt: new Date().toISOString(), checks: {} };
-  // 1) drift level
-  try {
-    const r = cp.spawnSync(process.execPath, [__filename, 'drift', 'check', root, '--json'],
-      { 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 실패' }; }
-  // 2) 보안 상태 (1.9.418, 9th 외부평가 Codex P2): .env/.gitignore + **실제 하드코딩 시크릿 스캔**.
-  //   기존엔 .env 가 .gitignore 에 있으면 critical:false 라 커밋된 하드코딩 시크릿이 있어도 health 가 healthy:true 였음(false-OK).
-  //   handoff/scan secrets 와 동일하게 _collectSecretFindings 로 커밋 대상 시크릿을 반영(정직성).
-  try {
-    const sec = _collectSecretFindings(root);
-    const committedSecrets = sec.committed.length;
-    const envPath = path.join(root, '.env');
-    const hasDotEnv = exists(envPath);
-    const s = { hasDotEnv, committedSecrets };
-    if (hasDotEnv) {
-      const d = envDiff(root);
-      const giText = exists(path.join(root, '.gitignore')) ? read(path.join(root, '.gitignore')) : '';
-      const giLines = giText.split('\n').map(l => l.trim());
-      const envInGi = giLines.includes('.env') || giLines.includes('/.env');
-      const SECRET_PATTERNS = ['.env', '.env.local', '.env.production', '.env.*.local', '*.pem', 'credentials.json'];
-      s.envInGitignore = envInGi;
-      s.envExampleMissing = d.inEnvOnly;
-      s.gitignoreMissingSecrets = SECRET_PATTERNS.filter(p => !giLines.some(l => l === p || l === '/' + p));
-      s.critical = !envInGi || committedSecrets > 0;
-    } else {
-      s.critical = committedSecrets > 0;
-    }
-    out.checks.security = s;
-  } catch { out.checks.security = { error: '보안 점검 실패' }; }
-  // 3) skill 수 + skill query 누적
-  try {
-    const all = listAllSkills(root);
-    const skillCount = Object.keys(all).length;
-    let queryCount = 0;
-    const histPath = path.join(root, '.harness', 'skill-suggestions.md');
-    if (exists(histPath)) {
-      queryCount = (read(histPath).match(/^## [\d-]+ [\d:]+ — query/gm) || []).length;
-    }
-    out.checks.skills = { installed: skillCount, queryHistoryCount: queryCount };
-  } catch { out.checks.skills = { error: 'skill 점검 실패' }; }
-  // 4) MCP + 명령 호출 누적
-  try {
-    const stats = _readUsageStats(root);
-    const cmdTotal = Object.values(stats.commands || {}).reduce((s, n) => s + n, 0);
-    const mcpTotal = stats.mcp?.tools ? Object.values(stats.mcp.tools).reduce((s, n) => s + n, 0) : 0;
-    out.checks.usage = {
-      commandTotal: cmdTotal,
-      commandKinds: Object.keys(stats.commands || {}).length,
-      mcpTotal,
-      mcpToolKinds: stats.mcp?.tools ? Object.keys(stats.mcp.tools).length : 0,
-      since: stats.since || null
-    };
-  } catch { out.checks.usage = { error: 'usage 점검 실패' }; }
-  // 5) tasks (progress-tracker)
-  try {
-    const rows = readProgressRows(root);
-    const byStatus = {};
-    for (const r of rows) byStatus[r.status] = (byStatus[r.status] || 0) + 1;
-    out.checks.tasks = { total: rows.length, byStatus };
-  } catch { out.checks.tasks = { error: 'tasks 점검 실패' }; }
-  // 1.9.123: memorySurface 통합 (handoff --json 1.9.115 / session close --json 1.9.122 와 동일 패턴)
-  try {
-    const rows = readProgressRows(root);
-    const tasksByStatus = {};
-    for (const s of STATUSES) tasksByStatus[s] = 0;
-    for (const r of rows) tasksByStatus[r.status] = (tasksByStatus[r.status] || 0) + 1;
-    const tasksInProgress = tasksByStatus['in-progress'] || 0;
-    const decisionsCount = _loadDecisions(root).length;  // 1.9.339 (UR-0053): canonical 단일 진실소스
-    const rules = readRules(root);
-    const rulesActive = rules.filter(r => r.status === 'active').length;
-    const planText = exists(planPath(root)) ? read(planPath(root)) : '';
-    const milestones = (planText.match(/^### M-\d{4}\./gm) || []).length;
-    const lessonsCount = _loadLessons(root).length;
-    out.memorySurface = {
-      tasks: { inProgress: tasksInProgress, total: rows.length, byStatus: tasksByStatus },
-      decisions: { count: decisionsCount },
-      rules: { active: rulesActive, total: rules.length },
-      plan: { milestones },
-      lessons: { count: lessonsCount },
-      archive: (() => {
-        // 1.9.130: archive 카운트 통합
-        const a = { decisions: 0, lessons: 0, plan: 0, total: 0 };
-        try {
-          const hdHe = path.join(root, '.harness');
-          for (const [key, file] of [['decisions', 'decisions.archive.md'], ['lessons', 'lessons.archive.md'], ['plan', 'plan.archive.md']]) {
-            const fpHe = path.join(hdHe, file);
-            if (exists(fpHe)) {
-              const entries = _parseArchiveBlocks(read(fpHe));
-              a[key] = entries.length;
-              a.total += entries.length;
-            }
-          }
-        } catch {}
-        return a;
-      })(),
-      summary: `T${tasksInProgress}/D${decisionsCount}/R${rulesActive}/P${milestones}/L${lessonsCount}`,
-    };
-  } catch { out.memorySurface = { error: 'memorySurface 점검 실패' }; }
-  // 1.9.143: health --json featureGraph 통합 (handoff/session close 와 동일 패턴 — JSON 4종 완성)
-  try {
-    const { nodes: fNodesHe } = _readFeatureGraph(root);
-    const edgeCount = fNodesHe.reduce((s, n) => s + (n.dependsOn?.length || 0) + (n.affects?.length || 0) + (n.coChangesWith?.length || 0), 0);
-    const linkedSet = new Set();
-    for (const n of fNodesHe) {
-      for (const x of [...(n.dependsOn||[]), ...(n.affects||[]), ...(n.coChangesWith||[])]) { linkedSet.add(n.id); linkedSet.add(x); }
-    }
-    const isolated = fNodesHe.length ? (fNodesHe.length - linkedSet.size) : 0;
-    out.featureGraph = {
-      total: fNodesHe.length,
-      edges: edgeCount,
-      isolated: Math.max(0, isolated),
-      summary: `F${fNodesHe.length}/E${edgeCount}${isolated > 0 ? `/iso${isolated}` : ''}`
-    };
-  } catch { out.featureGraph = { error: 'featureGraph 점검 실패' }; }
-  // 1.9.228: health --json roundHistory 통합 (handoff/session close 와 동일 — JSON 3 명령 일관성 + 6 통합 필드 완성)
-  try {
-    const rh = _computeRoundHistory(root);
-    out.roundHistory = {
-      roundCount: rh.roundCount,
-      baselineVersion: rh.baselineVersion,
-      nextMilestone: rh.nextMilestone,
-      roundsToNextMilestone: rh.roundsToNextMilestone,
-      daysActive: rh.daysActive,
-      avgRoundsPerDay: rh.avgRoundsPerDay
-    };
-  } catch { out.roundHistory = { error: 'roundHistory 점검 실패' }; }
-  // 1.9.230: health --json milestones 통합 (handoff/session close/health 3 명령 일관성 유지)
-  try {
-    const ms = _computeMilestones(root);
-    out.milestones = {
-      reachedCount: ms.reached.length,
-      reached: ms.reached.map(m => ({ milestone: m.milestone, version: m.version, reachedAt: m.reachedAt })),
-      next: ms.next,
-      avgRoundsPerDay: ms.avgRoundsPerDay
-    };
-  } catch { out.milestones = { error: 'milestones 점검 실패' }; }
-  // 1.9.234: health --json recentChanges 통합 (3 명령 8 필드 일관성)
-  try {
-    out.recentChanges = _computeRecentChanges(root, 5);
-  } catch { out.recentChanges = { error: 'recentChanges 점검 실패' }; }
-  // 1.9.240: health --json pyFiles 통합 (3 명령 9 필드 — UR-0013 2단계)
-  try {
-    const pyFiles = _collectPyFiles(root, 200);
-    const analyses = pyFiles.slice(0, 200).map(f => _analyzePyFile(f)).filter(Boolean);
-    out.pyFiles = {
-      total: pyFiles.length,
-      analyzed: analyses.length,
-      totalLOC: analyses.reduce((s, a) => s + a.loc, 0),
-      totalImports: analyses.reduce((s, a) => s + a.imports, 0),
-      totalFuncs: analyses.reduce((s, a) => s + a.funcs, 0),
-      totalClasses: analyses.reduce((s, a) => s + a.classes, 0)
-    };
-  } catch { out.pyFiles = { error: 'pyFiles 점검 실패' }; }
-  // 1.9.242: health --json envInfo 통합 (3 명령 10 필드 — UR-0014 2단계)
-  try {
-    const runtimeEnv = _collectRuntimeEnv();
-    const encScan = _scanShellScriptsEncoding(root);
-    out.envInfo = {
-      os: runtimeEnv.os.platform,
-      isKoreanWindows: runtimeEnv.locale.isKoreanWindows || false,
-      codepage: runtimeEnv.locale.codepage || null,
-      nodeVersion: runtimeEnv.node.version,
-      shellScriptsScanned: encScan.scanned,
-      encodingRiskCount: encScan.atRisk.length,
-      encodingRiskFiles: encScan.atRisk.slice(0, 5).map(r => r.file),
-      // 1.9.249 (UR-0018): 터미널 출력 인코딩 안전 여부 + 자동 회복 결과
-      terminalEncodingOk: runtimeEnv.locale.codepage === 65001 || !runtimeEnv.locale.isKoreanWindows,
-      autoChcpApplied: process.env._LEERNESS_AUTOCHCP_APPLIED || null,
-      // 1.9.250 (UR-0018 2단계): POSIX (Linux/macOS/WSL) terminal encoding 점검
-      posixEncodingOk: runtimeEnv.locale.posixEncodingOk,
-      isWSL: runtimeEnv.locale.isWSL || false
-    };
-  } catch { out.envInfo = { error: 'envInfo 점검 실패' }; }
-  // 1.9.245: health --json apiSkills 통합 (3 명령 11 필드 — UR-0015)
-  try {
-    const allSkills = _listAPISkills(root);
-    let currentTaskText = '';
-    try {
-      const rows = readProgressRows(root);
-      const ip = rows.find(r => r.status === 'in-progress');
-      if (ip) currentTaskText = (ip.title || '') + ' ' + (ip.notes || '');
-    } catch {}
-    const matched = currentTaskText ? _matchAPISkills(root, currentTaskText) : [];
-    out.apiSkills = {
-      total: allSkills.length,
-      matched: matched.length,
-      matchedIds: matched.slice(0, 5).map(s => s.id),
-      ids: allSkills.slice(0, 10).map(s => s.id)
-    };
-  } catch { out.apiSkills = { error: 'apiSkills 점검 실패' }; }
-  // 1.9.264: shellGuard 통합 (health JSON 12번째 통합 필드 — handoff/session close 와 JSON 3 명령 일관성) — UR-0020
-  try {
-    const sf = _loadShellFailures(root);
-    const drift = _shellEnvDrift(root);
-    out.shellGuard = {
-      failureCount: sf.failures.length,
-      recent: sf.failures.slice(-3).map(f => ({ cmd: (f.cmd || '').slice(0, 50), exitCode: f.exitCode, shell: f.shell, rules: f.issues || [] })),
-      envDriftChanges: drift && drift.changes ? drift.changes.length : 0,
-      envDrift: drift ? drift.changes : null
-    };
-  } catch { out.shellGuard = { error: 'shellGuard 점검 실패' }; }
-  // 1.9.163: 5능력 매트릭스 자동 평가 (1.9.155 sub-agent 점검 → 코드 기반 자동화)
-  //   각 능력을 코드 grep 으로 검출 → 0~100 점수. 사용자가 매 health 호출 시 leerness 자기 평가 확인.
-  try {
-    const harnessSrc = read(__filename);
-    const cap = {};
-    // (1) 웹 자동화 — 1.9.165 playwright bridge 통합 + 실제 playwright 설치 detect
-    const hasWebBridge = /function webCmd\(root, sub/.test(harnessSrc);
-    // 사용자가 playwright 설치했는지 실시간 detect (require try)
-    let playwrightInstalled = false;
-    try { require('playwright'); playwrightInstalled = true; }
-    catch { try { require('playwright-core'); playwrightInstalled = true; } catch {} }
-    if (hasWebBridge && playwrightInstalled) {
-      cap.webAutomation = { score: 90, status: '✓', evidence: 'playwright 설치 + leerness web bridge (1.9.165)' };
-    } else if (hasWebBridge) {
-      cap.webAutomation = { score: 50, status: '⚠', evidence: 'leerness web bridge 있음, playwright 미설치 (npm i -g playwright)' };
-    } else {
-      cap.webAutomation = { score: 5, status: '❌', evidence: 'permissions.browser=toggle만 (실 코드 미구현)' };
-    }
-    // (2) PC 조작 — 1.9.166 robotjs/nut-tree bridge + 실제 설치 detect
-    const hasPCBridge = /function pcCmd\(root, sub/.test(harnessSrc);
-    let pcInstalled = false;
-    try { require('robotjs'); pcInstalled = true; }
-    catch { try { require('@nut-tree/nut-js'); pcInstalled = true; } catch {} }
-    if (hasPCBridge && pcInstalled) {
-      cap.pcAutomation = { score: 90, status: '✓', evidence: 'robotjs/nut-tree 설치 + leerness pc bridge (1.9.166)' };
-    } else if (hasPCBridge) {
-      cap.pcAutomation = { score: 50, status: '⚠', evidence: 'leerness pc bridge 있음, robotjs 미설치 (npm i -g robotjs)' };
-    } else {
-      cap.pcAutomation = { score: 5, status: '❌', evidence: 'permissions.mouse/keyboard=필드만 (실 사용처 0)' };
-    }
-    // (3) 멀티 에이전트 오케스트레이션 — agents multi --execute + consensus 로직?
-    const hasExecute = /const execute = has\('--execute'\)/.test(harnessSrc);
-    const hasConsensus = /multi-signal consensus/.test(harnessSrc);
-    cap.multiAgentOrchestration = (hasExecute && hasConsensus)
-      ? { score: 90, status: '✓', evidence: '실 spawn + multi-signal consensus (1.9.156+1.9.155)' }
-      : { score: 50, status: '⚠', evidence: '명령 출력만 (1.9.152 기본 모드)' };
-    // (4) REPL multi-provider — _agentRepl + _cliChat 5종?
-    const hasRepl = /async function _agentRepl/.test(harnessSrc);
-    const hasCliChat = /async function _cliChat/.test(harnessSrc);
-    cap.replMultiProvider = (hasRepl && hasCliChat)
-      ? { score: 90, status: '✓', evidence: 'ollama/claude/codex/agy/copilot 5종 (1.9.149+1.9.153)' }
-      : { score: 30, status: '⚠', evidence: 'REPL 미완성' };
-    // (5) MCP 도구 — tools array 카운트 (1.9.288: 정확한 도구 정의 패턴 — 자기-매칭 오탐 제거, Codex #5)
-    const toolCount = _mcpToolCount();
-    cap.mcpTools = toolCount >= 50
-      ? { score: 100, status: '✓', evidence: `${toolCount}/50+ 도구 (1.9.159 CRUD 완성)` }
-      : { score: Math.round((toolCount / 50) * 100), status: toolCount > 30 ? '✓' : '⚠', evidence: `${toolCount} 도구` };
-    // (6) 코드 인텔리전스 — 1.9.167 LSP 어댑터 + typescript 설치 detect
-    const hasLspBridge = /function lspCmd\(root, sub/.test(harnessSrc);
-    let tsInstalled = false;
-    try { require('typescript'); tsInstalled = true; } catch {}
-    if (hasLspBridge && tsInstalled) {
-      cap.codeIntel = { score: 90, status: '✓', evidence: 'typescript 설치 + leerness lsp bridge (1.9.167, Compiler API)' };
-    } else if (hasLspBridge) {
-      cap.codeIntel = { score: 50, status: '⚠', evidence: 'leerness lsp bridge 있음, typescript 미설치 (regex fallback 동작, npm i -g typescript)' };
-    } else {
-      cap.codeIntel = { score: 5, status: '❌', evidence: 'LSP 어댑터 미구현 (코드 인텔리전스 없음)' };
-    }
-    const avgScore = Math.round((cap.webAutomation.score + cap.pcAutomation.score + cap.multiAgentOrchestration.score + cap.replMultiProvider.score + cap.mcpTools.score + cap.codeIntel.score) / 6);
-    out.capabilityMatrix = {
-      capabilities: cap,
-      overallScore: avgScore,
-      summary: `웹${cap.webAutomation.score}/PC${cap.pcAutomation.score}/멀티${cap.multiAgentOrchestration.score}/REPL${cap.replMultiProvider.score}/MCP${cap.mcpTools.score}/LSP${cap.codeIntel.score} · 종합 ${avgScore}%`,
-      assessment: avgScore >= 70 ? 'production-ready' : avgScore >= 50 ? 'beta-ready' : 'mvp'
-    };
-  } catch { out.capabilityMatrix = { error: '5능력 매트릭스 평가 실패' }; }
-  // 6) issues 요약 (사용자 글로벌 룰 가시화)
-  const issues = [];
-  if (out.checks.drift?.level && !/healthy/.test(out.checks.drift.level)) issues.push(`drift ${out.checks.drift.level}`);
-  if (out.checks.security?.committedSecrets > 0) issues.push(`🚨 커밋 대상 하드코딩 시크릿 ${out.checks.security.committedSecrets}건 (보안 CRITICAL)`);  // 1.9.418 (9th 외부평가 Codex P2)
-  if (out.checks.security?.hasDotEnv && out.checks.security?.envInGitignore === false) issues.push('🚨 .env가 .gitignore에 누락 (보안 CRITICAL)');
-  if (out.checks.security?.envExampleMissing?.length) issues.push(`.env→.env.example 누락 ${out.checks.security.envExampleMissing.length}건`);
-  if (out.checks.security?.gitignoreMissingSecrets?.length) issues.push(`.gitignore 시크릿 누락 ${out.checks.security.gitignoreMissingSecrets.length}건`);
-  out.issues = issues;
-  out.healthy = issues.length === 0;
-
-  // --strict: issue 있으면 exit 1
-  if (has('--strict') && !out.healthy) process.exitCode = 1;
-
-  if (has('--json')) { log(JSON.stringify(out, null, 2)); return; }
-  log(`# leerness health (1.9.85)`);
-  log(`Date: ${out.generatedAt}`);
-  log(`Status: ${out.healthy ? '✅ healthy' : `⚠ ${issues.length} issues`}`);
-  log('');
-  log(`## drift`);
-  log(`  level: ${out.checks.drift?.level || 'n/a'} (score ${out.checks.drift?.score || 0}, fired ${out.checks.drift?.firedCount || 0})`);
-  log('');
-  log(`## 보안`);
-  if (out.checks.security?.hasDotEnv) {
-    log(`  .env 존재 · .gitignore에 .env 포함: ${out.checks.security.envInGitignore ? '✓' : '✗ CRITICAL'}`);
-    log(`  .env.example 누락 키: ${out.checks.security.envExampleMissing?.length || 0}건`);
-    log(`  .gitignore 시크릿 패턴 누락: ${out.checks.security.gitignoreMissingSecrets?.length || 0}건`);
-  } else {
-    log(`  .env 없음 (검증 불필요)`);
-  }
-  log('');
-  log(`## skills`);
-  log(`  설치: ${out.checks.skills?.installed || 0}개 · skill query 누적: ${out.checks.skills?.queryHistoryCount || 0}회`);
-  log('');
-  log(`## usage`);
-  log(`  명령 호출: ${out.checks.usage?.commandTotal || 0}회 / ${out.checks.usage?.commandKinds || 0}종`);
-  log(`  MCP 호출: ${out.checks.usage?.mcpTotal || 0}회 / ${out.checks.usage?.mcpToolKinds || 0}종 도구`);
-  log(`  since: ${out.checks.usage?.since || 'unknown'}`);
-  log('');
-  log(`## tasks`);
-  const tb = out.checks.tasks?.byStatus || {};
-  log(`  총 ${out.checks.tasks?.total || 0}건: ${Object.entries(tb).map(([s, n]) => `${s}=${n}`).join(', ') || '없음'}`);
-  // 1.9.163: 5능력 매트릭스 — 1.9.155 sub-agent 점검의 코드 기반 자동 평가
-  if (out.capabilityMatrix && !out.capabilityMatrix.error) {
-    log('');
-    log(`## 🧪 6능력 매트릭스 (1.9.167 자동 평가)`);
-    const cm = out.capabilityMatrix;
-    log(`  종합: ${cm.overallScore}% (${cm.assessment})`);
-    log(`  (1) 웹 자동화        ${cm.capabilities.webAutomation.status} ${cm.capabilities.webAutomation.score}%  · ${cm.capabilities.webAutomation.evidence}`);
-    log(`  (2) PC 조작          ${cm.capabilities.pcAutomation.status} ${cm.capabilities.pcAutomation.score}%  · ${cm.capabilities.pcAutomation.evidence}`);
-    log(`  (3) 멀티 오케스트레이션 ${cm.capabilities.multiAgentOrchestration.status} ${cm.capabilities.multiAgentOrchestration.score}%  · ${cm.capabilities.multiAgentOrchestration.evidence}`);
-    log(`  (4) REPL multi-provider ${cm.capabilities.replMultiProvider.status} ${cm.capabilities.replMultiProvider.score}%  · ${cm.capabilities.replMultiProvider.evidence}`);
-    log(`  (5) MCP 도구           ${cm.capabilities.mcpTools.status} ${cm.capabilities.mcpTools.score}%  · ${cm.capabilities.mcpTools.evidence}`);
-    log(`  (6) 코드 인텔리전스    ${cm.capabilities.codeIntel.status} ${cm.capabilities.codeIntel.score}%  · ${cm.capabilities.codeIntel.evidence}`);
-  }
-  if (issues.length) {
-    log('');
-    log(`## ⚠ Issues (${issues.length})`);
-    for (const i of issues) log(`  - ${i}`);
-    log('');
-    log(`💡 자동 회복: leerness drift check --auto-fix · leerness audit --fix`);
-  }
-}
+const _health = require('../lib/health');
+// 1.9.423 (UR-0025/UR-0125 큰 핸들러 모듈화 8번째): healthCmd → lib/health.js (DI 위임, thin wrapper)
+function healthCmd(root) { return _health.healthCmd(root, { VERSION, has, arg, harnessPath: __filename, listAllSkills, planPath, readProgressRows, readRules, envDiff, _collectSecretFindings, _readUsageStats, _loadDecisions, _loadLessons, _loadShellFailures, _readFeatureGraph, _scanShellScriptsEncoding, _shellEnvDrift, _computeMilestones, _computeRecentChanges, _computeRoundHistory, _collectPyFiles, _analyzePyFile, _collectRuntimeEnv, _listAPISkills, _matchAPISkills, _mcpToolCount }); }
 
 function usageStatsCmd(root) {
   root = absRoot(root || process.cwd());