leerness 1.9.423 → 1.9.425

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.423';
+const VERSION = '1.9.425';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2929,7 +2929,7 @@ function _selfTestCases() {
     { name: 'MCP notification 준수: id없는 요청 무응답 가드 + ping {} (UR-0049 설치리뷰 1.9.313)', run: () => { const src = read(__filename); const guard = src.includes("const isNotification = !('id' in req)") && src.includes("req.method.startsWith('notifications/')") && src.includes('if (isNotification) return;'); const ping = src.includes("req.method === 'ping'") && /ping[\s\S]{0,140}result: \{\} \}/.test(src); return guard && ping; } },
     { 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: 'drift 마커 버그: session-handoff 프론트매터는 ^--- 일 때만 + drift 최신 Last generated (1.9.316)', run: () => { const src = read(__filename); const scSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'session-close.js')); const writeFix = scSrc.includes('if (/^---\\r?\\n/.test(cur))') && scSrc.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: 'MCP ToolRegistry 일치성: 모든 도구 def 가 dispatch case 보유 + 고아 case 0 + requiredTier 완비 (UR-0044 1.9.319)', run: () => { const tools = require('../lib/mcp-tools'); const src = read(__filename); const missing = tools.filter(t => !src.includes("case '" + t.name + "':")); const cases = [...src.matchAll(/case '(leerness_[a-z_]+)':/g)].map(m => m[1]); const defNames = new Set(tools.map(t => t.name)); const orphans = [...new Set(cases)].filter(c => !defNames.has(c)); const tierOk = tools.every(t => typeof t.requiredTier === 'string' && PERMISSION_TIERS.includes(t.requiredTier)); return tools.length >= 83 && missing.length === 0 && orphans.length === 0 && tierOk; } },
@@ -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,27 @@ 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 큰핸들러 모듈화 10번째: sessionClose → lib/session-close.js + DI 위임 (1.9.425)', run: () => {
+      const m = require('../lib/session-close');
+      const expOk = typeof m.sessionClose === 'function';
+      const src = read(__filename);
+      const delegated = src.includes("require('../lib/session-close')") && src.includes('_sessionClose.sessionClose(root, opts,');
+      const modSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'session-close.js'));
+      const bodyMarker = 'recommended' + 'Direction';  // session-close 본문 고유(split-literal 자기참조 회피)
+      const movedToLib = modSrc.includes("require('./io')") && modSrc.includes("require('./pure-utils')") && modSrc.includes('STATUSES, MARK') && modSrc.includes(bodyMarker) && !src.includes(bodyMarker);
+      return expOk && delegated && movedToLib;
+    } },
+    { 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';
@@ -11068,448 +11089,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());
@@ -11671,605 +11253,9 @@ function llmBenchRecordCmd(root) {
   ok(`기록됨: ${histFile}`);
 }
 
-function sessionClose(root, opts = {}) {
-  root = absRoot(root);
-  // 1.9.103: --json 모드 — stdout 억제 후 구조화 출력
-  const jsonMode = !!opts.json || has('--json');
-  const _origWrite = process.stdout.write.bind(process.stdout);
-  if (jsonMode) process.stdout.write = () => true;
-  const jsonResult = { version: VERSION, root, closedAt: now() };
-  try {
-  const rows = readProgressRows(root);
-  const buckets = {};
-  for (const s of STATUSES) buckets[s] = [];
-  for (const r of rows) (buckets[r.status] || (buckets[r.status] = [])).push(r);
-  // 1.9.103: JSON 결과 누적
-  jsonResult.taskCounts = {};
-  for (const s of STATUSES) jsonResult.taskCounts[s] = (buckets[s] || []).length;
-  jsonResult.recommendedDirection = (buckets['in-progress'][0]?.request) || (buckets['planned'][0]?.request) || (buckets['requested'][0]?.request) || null;
-  jsonResult.nextExactStep = (buckets['in-progress'][0]?.nextAction) || (buckets['planned'][0]?.nextAction) || (buckets['requested'][0]?.nextAction) || null;
-
-  function rowsToList(arr) {
-    if (!arr || !arr.length) return '- 없음';
-    return arr.map(r => `- ${r.id} ${r.request} → next: ${r.nextAction}`).join('\n');
-  }
-
-  // 1.9.287 (Codex 리뷰 수렴): evidence 임베딩 시 코드펜스(```) 가 session-handoff.md 마크다운을 깨뜨리는 품질 버그 수정.
-  const evidenceSummary = _sanitizeFences(exists(evidencePath(root)) ? (read(evidencePath(root)).split('\n').slice(-30).join('\n')) : '(no review-evidence.md)');
-  const block = [
-    `# Session Handoff`,
-    ``,
-    `Last generated: ${now()}`,
-    ``,
-    `## Completed`,
-    rowsToList(buckets['done']),
-    ``,
-    `## In Progress`,
-    rowsToList(buckets['in-progress']),
-    ``,
-    `## Incomplete / Waiting / On Hold / Blocked`,
-    rowsToList([...(buckets['incomplete']||[]), ...(buckets['waiting']||[]), ...(buckets['on-hold']||[]), ...(buckets['blocked']||[])]),
-    ``,
-    `## Dropped`,
-    rowsToList(buckets['dropped']),
-    ``,
-    `## Verification`,
-    '```',
-    evidenceSummary.trim() || '(empty)',
-    '```',
-    ``,
-    `## Recommended Direction`,
-    `- ${(buckets['in-progress'][0]?.request) || (buckets['planned'][0]?.request) || (buckets['requested'][0]?.request) || '다음 우선순위를 사용자와 정합니다.'}`,
-    ``,
-    `## Next Exact Step`,
-    `- ${(buckets['in-progress'][0]?.nextAction) || (buckets['planned'][0]?.nextAction) || (buckets['requested'][0]?.nextAction) || '없음'}`,
-    ``
-  ].join('\n');
-  const cur = exists(handoffPath(root)) ? read(handoffPath(root)) : '';
-  // 1.9.316 (drift 마커 버그): 프론트매터는 파일이 '---' 로 시작할 때만 추출.
-  //   이전: 본문의 '---'(수평선/구분자)을 프론트매터 종료로 오인 → 구 블록(구 'Last generated')을 보존 →
-  //   session-handoff.md 에 'Last generated' 중복 누적 → drift 가 첫(=구) 매치를 읽어 'session close 누락' 영구 오발화.
-  let frontmatter = '';
-  if (/^---\r?\n/.test(cur)) {
-    const fmEnd = cur.indexOf('\n---\n', 4);
-    if (fmEnd > 0) frontmatter = cur.slice(0, fmEnd + 5) + MARK + '\n';
-  }
-  writeUtf8(handoffPath(root), frontmatter + block);
-
-  if (exists(currentStatePath(root))) {
-    let cs = read(currentStatePath(root));
-    cs = cs.replace(/Updated: \d{4}-\d{2}-\d{2}/, `Updated: ${today()}`);
-    cs = cs.replace(/## Now\n[\s\S]*?(?=\n## Next)/, `## Now\n- ${(buckets['in-progress'][0]?.request) || '대기 중'}\n`);
-    cs = cs.replace(/## Next\n[\s\S]*?(?=\n## Blockers)/, `## Next\n- ${(buckets['planned'][0]?.request) || (buckets['requested'][0]?.request) || '계획된 작업 없음'}\n`);
-    cs = cs.replace(/## Blockers\n[\s\S]*$/, `## Blockers\n${(buckets['blocked']||[]).map(b=>`- ${b.id} ${b.request}`).join('\n') || '-'}\n`);
-    writeUtf8(currentStatePath(root), cs);
-  }
-
-  append(taskLogPath(root), `\n## ${today()} session-close\n- Generated session-handoff.md and refreshed current-state.md.\n`);
-
-  log('# Session Close');
-  log('## Task Lists');
-  for (const s of STATUSES) {
-    log(`\n### ${s}`);
-    log(rowsToList(buckets[s]));
-  }
-  // 1.9.8: 룰 검증 자동 수행 + 보고
-  const ruleResults = verifyRules(root);
-  jsonResult.rules = ruleResults.map(r => ({ id: r.id, trigger: r.trigger, verified: r.verified, note: r.note }));
-  log('\n## ⚡ User Rules verification');
-  if (!ruleResults.length) log('- 활성 룰 없음');
-  else {
-    log('| ID | Trigger | Rule | Verified | Note |');
-    log('|---|---|---|---|---|');
-    const ic = { pass: '✓ pass', pending: '⓿ pending', manual: 'ⓘ manual', baseline: '○ baseline' };
-    for (const r of ruleResults) log(`| ${r.id} | ${r.trigger} | ${r.rule.slice(0, 40)} | ${ic[r.verified] || '?'} | ${r.note} |`);
-  }
-  log('\n## Required final response sections');
-  log('- 완료 작업\n- 진행 중 작업\n- 미완료/예정/대기/보류/차단/드랍 작업\n- 검증 결과\n- 추천 방향\n- 다음 정확한 작업\n- ⚡ 활성 룰별 검증 결과');
-  ok(`session-handoff.md and current-state.md updated`);
-  // 1.9.12: session close 끝에 roadmap.html 자동 갱신
-  _autoRoadmap(root, 'session-close');
-  // 1.9.57: --suggest 옵션 — 마감 시 skill suggest + drift check + lessons 통합 보고
-  // 1.9.59: default 활성 — --no-suggest로 명시 비활성 가능
-  const suggestEnabled = (has('--suggest') || (!has('--no-suggest') && process.env.LEERNESS_NO_SUGGEST !== '1'));
-  if (suggestEnabled) {
-    const isTty = process.stdout && process.stdout.isTTY;
-    const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
-    const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
-    log('');
-    log(cy('## 💡 다음 라운드 추천 (1.9.57 --suggest)'));
-    // 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_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 자동 학습):'));
-        for (const c of j.candidates.slice(0, 3)) log(`    • ${c.keyword} (${c.count}회 등장, 출처: ${c.source})`);
-        jsonResult.skillCandidates = j.candidates.slice(0, 5);
-      }
-    } catch {}
-    // 2) drift check
-    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());
-      if (j.level) {
-        log(dim(`  🩺 drift 상태: ${j.level} ${j.score}/200`));
-        if (j.fired && j.fired.length) log(dim(`    🔥 ${j.fired.length}건 임계 초과 — \`leerness drift check\` 상세`));
-        jsonResult.drift = { level: j.level, score: j.score, fired: (j.fired || []).map(f => ({ label: f.label, weight: f.weight })) };
-      }
-    } catch {}
-    // 3) usage stats top
-    try {
-      const stats = _readUsageStats(root);
-      const entries = Object.entries(stats.commands || {}).sort((a, b) => b[1] - a[1]).slice(0, 3);
-      if (entries.length) {
-        log(dim(`  📊 가장 많이 쓴 명령: ${entries.map(([c, n]) => `${c}(${n})`).join(', ')}`));
-        jsonResult.topCommands = entries.map(([command, count]) => ({ command, count }));
-      }
-      // 1.9.74: MCP tools/call 통계 + rare 도구 노출
-      if (stats.mcp && stats.mcp.tools) {
-        const mcpEntries = Object.entries(stats.mcp.tools).sort((a, b) => b[1] - a[1]);
-        if (mcpEntries.length) {
-          const mcpTotal = mcpEntries.reduce((s, [, n]) => s + n, 0);
-          log(dim(`  🔌 MCP 호출 (1.9.74): 총 ${mcpTotal}회, top: ${mcpEntries.slice(0, 3).map(([t, n]) => `${t}(${n})`).join(', ')}`));
-          const threshold = Math.max(1, Math.floor(mcpTotal * 0.05));
-          const rare = mcpEntries.filter(([, n]) => n <= threshold).map(([t]) => t);
-          if (rare.length && mcpTotal >= 5) log(dim(`    💡 드물게 호출된 MCP: ${rare.slice(0, 4).join(', ')}`));
-          jsonResult.mcpStats = { total: mcpTotal, top: mcpEntries.slice(0, 5).map(([tool, count]) => ({ tool, count })), rare: rare.slice(0, 10) };
-        }
-      }
-    } catch {}
-    // 1.9.74: skill match query top (skill-suggestions.md 누적)
-    try {
-      const histPath = path.join(root, '.harness', 'skill-suggestions.md');
-      if (exists(histPath)) {
-        const histTxt = read(histPath);
-        const queries = [];
-        for (const block of histTxt.split(/\n(?=## )/)) {
-          const h = block.match(/^## ([\d-]+ [\d:]+) — query "([^"]+)"/);
-          if (h) queries.push(h[2]);
-        }
-        if (queries.length) {
-          // 같은 query 개수 카운트
-          const counts = {};
-          for (const q of queries) counts[q] = (counts[q] || 0) + 1;
-          const topQueries = Object.entries(counts).sort((a, b) => b[1] - a[1]).slice(0, 3);
-          log(dim(`  📒 skill match query 누적 (1.9.74): 총 ${queries.length}회 / 종류 ${Object.keys(counts).length}개`));
-          for (const [q, n] of topQueries) log(dim(`    • "${q.slice(0, 50)}"${n > 1 ? ` (${n}회)` : ''}`));
-        }
-      }
-    } catch {}
-    log('');
-  }
-  // 1.9.13: 세션 카운터 + 자동 한 줄 요약 + 5세션마다 깊은 회고
-  try {
-    const sc = readSessionCounter(root);
-    sc.count = (sc.count || 0) + 1;
-    sc.lastCloseAt = now();
-    writeSessionCounter(root, sc);
-    const agg = _retroAggregate(root);
-    log(`\n## 📈 진행 요약 (session #${sc.count})`);
-    log(`  ${_retroOneLine(agg)}`);
-    // 1.9.132: archive 활동 1줄 요약 — 마감 시점에 DELETE 활동 가시화 (handoff 7번째 회수와 symmetric)
-    try {
-      const hdSC = path.join(root, '.harness');
-      const arc = { d: 0, l: 0, p: 0, total: 0 };
-      for (const [k, f] of [['d', 'decisions.archive.md'], ['l', 'lessons.archive.md'], ['p', 'plan.archive.md']]) {
-        const fp = path.join(hdSC, f);
-        if (exists(fp)) {
-          const entries = _parseArchiveBlocks(read(fp));
-          arc[k] = entries.length;
-          arc.total += entries.length;
-        }
-      }
-      if (arc.total > 0) {
-        log(`  🗑  archive 누적: D${arc.d}/L${arc.l}/P${arc.p} (${arc.total}건) — 복원 후보: leerness memory archive list`);
-      }
-    } catch {}
-    if (sc.count % 5 === 0) {
-      log(`\n## 🔄 ${sc.count}세션 마일스톤 — 자동 회고 (5세션마다)`);
-      retroCmd(root);
-      sc.lastDeepRetroAt = now();
-      writeSessionCounter(root, sc);
-    } else {
-      const left = 5 - (sc.count % 5);
-      log(`  💡 ${left}세션 후 자동 깊은 회고 — \`leerness retro\`로 즉시 실행 가능`);
-    }
-    // 1.9.16: 워크스페이스 안내 (다른 leerness 프로젝트가 있으면)
-    try {
-      const wsCands = [path.resolve(root, '_apps'), path.resolve(root, '..', '_apps')];
-      let wsCount = 0;
-      for (const base of wsCands) {
-        if (!exists(base)) continue;
-        try { if (!fs.statSync(base).isDirectory()) continue; } catch { continue; }
-        for (const e of fs.readdirSync(base)) {
-          try {
-            const p = path.join(base, e);
-            if (fs.statSync(p).isDirectory() && exists(path.join(p, '.harness')) && p !== root) wsCount++;
-          } catch {}
-        }
-      }
-      if (wsCount > 0) log(`  🌐 워크스페이스에 ${wsCount}개 다른 leerness 프로젝트 — \`leerness retro --all-apps\`로 통합 회고`);
-      jsonResult.workspacePeers = wsCount;
-    } catch {}
-  } catch (e) {
-    warn('retro 요약 실패: ' + (e && e.message ? e.message : e));
-    jsonResult.retroSummaryError = e && e.message ? e.message : String(e);
-  }
-  } finally {
-    // 1.9.103: stdout 복원
-    if (jsonMode) process.stdout.write = _origWrite;
-  }
-  // 1.9.103: JSON 모드 — 구조화 출력
-  if (jsonMode) {
-    try {
-      const sc = readSessionCounter(root);
-      jsonResult.sessionNumber = sc.count;
-    } catch {}
-    // 1.9.122: memorySurface 통합 (handoff --json 1.9.115 와 동일 패턴)
-    try {
-      const rows0 = readProgressRows(root);
-      const tasksByStatus0 = {};
-      for (const s of STATUSES) tasksByStatus0[s] = 0;
-      for (const r of rows0) tasksByStatus0[r.status] = (tasksByStatus0[r.status] || 0) + 1;
-      const tasksInProgress0 = tasksByStatus0['in-progress'] || 0;
-      const decisionsCount0 = _loadDecisions(root).length;  // 1.9.339 (UR-0053): canonical 단일 진실소스
-      const rules0 = readRules(root);
-      const rulesActive0 = rules0.filter(r => r.status === 'active').length;
-      const planText0 = exists(planPath(root)) ? read(planPath(root)) : '';
-      const milestones0 = (planText0.match(/^### M-\d{4}\./gm) || []).length;
-      const lessonsCount0 = _loadLessons(root).length;
-      // 1.9.130: archive 카운트 통합
-      const archiveCountsS = { decisions: 0, lessons: 0, plan: 0, total: 0 };
-      try {
-        const hdS = path.join(root, '.harness');
-        for (const [key, file] of [['decisions', 'decisions.archive.md'], ['lessons', 'lessons.archive.md'], ['plan', 'plan.archive.md']]) {
-          const fpS = path.join(hdS, file);
-          if (exists(fpS)) {
-            const entries = _parseArchiveBlocks(read(fpS));
-            archiveCountsS[key] = entries.length;
-            archiveCountsS.total += entries.length;
-          }
-        }
-      } catch {}
-      jsonResult.memorySurface = {
-        tasks: { inProgress: tasksInProgress0, total: rows0.length, byStatus: tasksByStatus0 },
-        decisions: { count: decisionsCount0 },
-        rules: { active: rulesActive0, total: rules0.length },
-        plan: { milestones: milestones0 },
-        lessons: { count: lessonsCount0 },
-        archive: archiveCountsS,  // 1.9.130
-        summary: `T${tasksInProgress0}/D${decisionsCount0}/R${rulesActive0}/P${milestones0}/L${lessonsCount0}`,
-      };
-      // 1.9.142: featureCounts 통합 — session close JSON에 Feature Graph 통계
-      try {
-        const { nodes: fNodesC } = _readFeatureGraph(root);
-        const edgeCount = fNodesC.reduce((s, n) => s + (n.dependsOn?.length || 0) + (n.affects?.length || 0) + (n.coChangesWith?.length || 0), 0);
-        const linkedIds = new Set();
-        for (const n of fNodesC) {
-          for (const x of [...(n.dependsOn||[]), ...(n.affects||[]), ...(n.coChangesWith||[])]) { linkedIds.add(n.id); linkedIds.add(x); }
-        }
-        const isolated = fNodesC.length ? (fNodesC.length - linkedIds.size) : 0;
-        jsonResult.featureGraph = {
-          total: fNodesC.length,
-          edges: edgeCount,
-          isolated: Math.max(0, isolated),
-          summary: `F${fNodesC.length}/E${edgeCount}${isolated > 0 ? `/iso${isolated}` : ''}`
-        };
-      } catch {}
-    } catch {}
-
-    // 1.9.217: session close 자동 통합 — 1.9.207 + 1.9.209 + 1.9.212
-    //   마감 시 미답 요청 / pre-wake audit / 멱등성 검사 자동 실행 + JSON 통합
-    try {
-      // 1.9.207: 미답 사용자 요청 audit
-      const reqAudit = _auditUserRequests(root);
-      jsonResult.userRequestsAudit = {
-        total: reqAudit.total,
-        open: reqAudit.open,
-        missing: reqAudit.missing ? reqAudit.missing.length : 0,
-        tracked: reqAudit.tracked ? reqAudit.tracked.length : 0,
-        stale: reqAudit.stale ? reqAudit.stale.length : 0
-      };
-      // 1.9.223: delivered 패턴 자동 감지 통합
-      try {
-        const delivered = _detectDeliveredRequests(root);
-        jsonResult.deliveredRequests = {
-          candidates: delivered.candidates.length,
-          currentVersion: delivered.currentVersion,
-          autoCompleteAvailable: delivered.candidates.length > 0
-        };
-      } catch {}
-      // 1.9.227: roundHistory 통합 (session close JSON 6번째 통합 필드)
-      try {
-        const rh = _computeRoundHistory(root);
-        jsonResult.roundHistory = {
-          roundCount: rh.roundCount,
-          baselineVersion: rh.baselineVersion,
-          nextMilestone: rh.nextMilestone,
-          roundsToNextMilestone: rh.roundsToNextMilestone,
-          daysActive: rh.daysActive,
-          avgRoundsPerDay: rh.avgRoundsPerDay
-        };
-      } catch {}
-      // 1.9.230: milestones 통합 (session close JSON 7번째 통합 필드)
-      try {
-        const ms = _computeMilestones(root);
-        jsonResult.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 {}
-      // 1.9.234: recentChanges 통합 (session close JSON 8번째 통합 필드) — 최근 5 라운드 변경
-      try {
-        jsonResult.recentChanges = _computeRecentChanges(root, 5);
-      } catch {}
-      // 1.9.240: pyFiles 통합 (session close JSON 9번째 통합 필드) — UR-0013 2단계
-      try {
-        const pyFiles = _collectPyFiles(root, 200);
-        const analyses = pyFiles.slice(0, 200).map(f => _analyzePyFile(f)).filter(Boolean);
-        jsonResult.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 {}
-      // 1.9.242: envInfo 통합 (session close JSON 10번째 통합 필드) — UR-0014 2단계
-      try {
-        const runtimeEnv = _collectRuntimeEnv();
-        const encScan = _scanShellScriptsEncoding(root);
-        jsonResult.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 {}
-      // 1.9.245: apiSkills 통합 (session close JSON 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) : [];
-        jsonResult.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 {}
-      // 1.9.264: shellGuard 통합 (session close JSON 12번째 통합 필드) — UR-0020 셸 실패 메모리 + 환경 변동
-      try {
-        const sf = _loadShellFailures(root);
-        const drift = _shellEnvDrift(root);
-        jsonResult.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 {}
-    } catch {}
-    try {
-      // 1.9.209: pre-wake-audit 자동 실행 + 저장 (sleep 전 자동 점검)
-      if (!opts.noPreWake && !has('--no-pre-wake')) {
-        const audit = _runPreWakeAudit(root);
-        _saveAndAppendPreWakeReport(root, audit);
-        jsonResult.preWakeAudit = {
-          auditedAt: audit.auditedAt,
-          critical: audit.summary.criticalCount,
-          warning: audit.summary.warningCount,
-          info: audit.summary.infoCount,
-          needsAttention: audit.summary.needsAttention
-        };
-      }
-    } catch {}
-    try {
-      // 1.9.212: 멱등성 검사 자동 실행 (rule/task/user-requests/wakeups 4영역)
-      const idemp = _runIdempotencyAudit(root);
-      jsonResult.idempotencyAudit = {
-        violations: idemp.summary.totalViolations,
-        high: idemp.summary.highSeverity,
-        medium: idemp.summary.mediumSeverity,
-        low: idemp.summary.lowSeverity,
-        verified: idemp.summary.verifiedAreas,
-        overall: idemp.summary.overall
-      };
-    } catch {}
-    try {
-      // 1.9.221: abnormalShutdown 자동 감지 (1.9.220 통합) — session close 시 다음 재개 가이드 회수
-      const ad = _detectAbnormalShutdown(root);
-      jsonResult.abnormalShutdown = {
-        detected: ad.abnormalShutdown,
-        severity: ad.severity,
-        signalCount: ad.signals.length,
-        signals: ad.signals.map(s => ({ kind: s.kind, severity: s.severity, detail: s.detail })),
-        resumeGuide: ad.resumeGuide
-      };
-    } catch {}
-
-    process.stdout.write(JSON.stringify(jsonResult, null, 2) + '\n');
-  } else {
-    // 1.9.217: human 출력 모드에서도 통합 보고 노출 (마감 직전)
-    try {
-      const isTty = process.stdout.isTTY;
-      const grn = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
-      const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
-      const red = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
-      const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
-
-      log('');
-      log(`## 🔚 session close 자동 통합 보고 (1.9.217)`);
-      // 1.9.207 + 1.9.223 (delivered 패턴 자동 권장) + 1.9.224 (--auto-apply-delivered 옵션)
-      try {
-        const reqAudit = _auditUserRequests(root);
-        const missCnt = reqAudit.missing ? reqAudit.missing.length : 0;
-        let delivered = { candidates: [] };
-        try { delivered = _detectDeliveredRequests(root); } catch {}
-        if (delivered.candidates && delivered.candidates.length > 0) {
-          if (has('--auto-apply-delivered')) {
-            // 1.9.224: 자동 정리 (마감 시 호출 — 안전: 패턴 매칭 + 버전 가드)
-            let ok = 0;
-            for (const c of delivered.candidates) {
-              const u = _updateUserRequest(root, c.id, { status: 'completed', autoCompletedAt: new Date().toISOString(), autoCompleteReason: 'session-close-auto-apply-1.9.224' });
-              if (u) ok++;
-            }
-            log(grn(`  ✓ delivered 패턴 ${ok}건 자동 완료 (--auto-apply-delivered 1.9.224)`));
-          } else {
-            log(yel(`  📥 delivered 패턴 ${delivered.candidates.length}건 (1.9.223) — 자동 완료 가능`));
-            log(dim(`     → leerness requests auto-complete --apply (수동) 또는 session close --auto-apply-delivered (1.9.224)`));
-          }
-        } else if (missCnt > 0) {
-          log(red(`  ⚠ 미답 사용자 요청 ${missCnt}건 (task-log/plan/decisions 매칭 안 됨)`));
-        } else if (reqAudit.open > 0) {
-          log(grn(`  ✓ 사용자 요청 ${reqAudit.open}건 모두 tracked`));
-        } else {
-          log(dim(`  ℹ 사용자 요청 없음 (UR 백로그 비어있음)`));
-        }
-      } catch {}
-      // 1.9.209
-      try {
-        if (!opts.noPreWake && !has('--no-pre-wake')) {
-          const audit = _runPreWakeAudit(root);
-          _saveAndAppendPreWakeReport(root, audit);
-          const sum = audit.summary;
-          if (sum.criticalCount > 0) {
-            log(red(`  🚨 pre-wake-audit: critical ${sum.criticalCount} (다음 깨어남 시 점검 필요)`));
-          } else if (sum.warningCount > 0) {
-            log(yel(`  ⚠ pre-wake-audit: warning ${sum.warningCount}`));
-          } else {
-            log(grn(`  ✓ pre-wake-audit: clean (sleep 안전)`));
-          }
-        }
-      } catch {}
-      // 1.9.212
-      try {
-        const idemp = _runIdempotencyAudit(root);
-        const v = idemp.summary.totalViolations;
-        if (v > 0) {
-          log(red(`  ⚠ 멱등성 위반 ${v}건 (high: ${idemp.summary.highSeverity})`));
-          log(dim(`     → leerness idempotency audit 으로 상세 확인`));
-        } else {
-          log(grn(`  ✓ 멱등성 검사 통과 — verified ${idemp.summary.verifiedAreas} 영역`));
-        }
-      } catch {}
-      // 1.9.264: 셸 실패 메모리 + 환경 변동 요약 (UR-0020) — 마감 시 이번 세션 셸 실패를 회고에 노출
-      try {
-        const sf = _loadShellFailures(root);
-        const drift = _shellEnvDrift(root);
-        const driftN = drift && drift.changes ? drift.changes.length : 0;
-        if (sf.failures.length > 0 || driftN > 0) {
-          if (driftN > 0) log(yel(`  ⚠ 환경 버전 변동 ${driftN}건 — 다음 세션 셸 실패 기록 재검토 권장`));
-          if (sf.failures.length > 0) {
-            log(yel(`  🐚 셸 실패 누적 ${sf.failures.length}건 — 다음 handoff 가 자동 노출`));
-            log(dim(`     → 명령 실행 전 점검: leerness shell-guard "<command>"`));
-          }
-        } else {
-          log(grn(`  ✓ 셸 실패 기록 없음 (터미널 호환성 양호)`));
-        }
-      } catch {}
-      // 1.9.237: session close --auto-cleanup-branches — 50+ release/* branches 시 자동 정리
-      //   1.9.224 패턴 (--auto-apply-delivered) 확장 — 마감 시 운영 누적 폐기물 자동 정리
-      //   안전: keep 10, merged 만, 현재 branch 보호
-      try {
-        const branchR = cp.spawnSync('git', ['branch', '--merged', 'main', '--list', 'release/*'], { cwd: root, encoding: 'utf8' });
-        if (branchR.status === 0) {
-          const merged = (branchR.stdout || '').split('\n')
-            .map(l => l.replace(/^\*?\s+/, '').trim())
-            .filter(l => l && /^release\/\d+\.\d+\.\d+$/.test(l));
-          if (merged.length > 50) {
-            if (has('--auto-cleanup-branches')) {
-              merged.sort((a, b) => {
-                const va = a.replace('release/', '').split('.').map(n => parseInt(n, 10) || 0);
-                const vb = b.replace('release/', '').split('.').map(n => parseInt(n, 10) || 0);
-                for (let i = 0; i < 3; i++) if (va[i] !== vb[i]) return vb[i] - va[i];
-                return 0;
-              });
-              const curR = cp.spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: root, encoding: 'utf8' });
-              const cur = (curR.stdout || '').trim();
-              const toDelete = merged.slice(10).filter(b => b !== cur);
-              let okCnt = 0;
-              for (const b of toDelete) {
-                const r = cp.spawnSync('git', ['branch', '-d', b], { cwd: root, encoding: 'utf8' });
-                if (r.status === 0) okCnt++;
-              }
-              log(grn(`  ✓ release 정리 ${okCnt}/${toDelete.length}건 (--auto-cleanup-branches 1.9.237, keep 10)`));
-            } else {
-              log(yel(`  🗑 release/* merged ${merged.length}개 (50+) — cleanup 가능 (1.9.235)`));
-              log(dim(`     → leerness release cleanup --apply --keep 10 (수동)`));
-              log(dim(`     → 또는 session close --auto-cleanup-branches (1.9.237 자동)`));
-            }
-          }
-        }
-      } catch {}
-      // 1.9.243: session close --auto-fix-encoding — 셸 스크립트 인코딩 위험 자동 회복 (UR-0014 3단계)
-      //   1.9.224 (--auto-apply-delivered) / 1.9.237 (--auto-cleanup-branches) 패턴 확장
-      //   마감 시 한국어/일본어/중국어 PowerShell 인코딩 위험 자동 BOM 추가
-      try {
-        const encScan = _scanShellScriptsEncoding(root);
-        if (encScan.atRisk && encScan.atRisk.length > 0) {
-          if (has('--auto-fix-encoding')) {
-            let ok = 0;
-            for (const r of encScan.atRisk) {
-              try {
-                const fullPath = path.join(root, r.file);
-                const orig = fs.readFileSync(fullPath);
-                const bom = Buffer.from([0xEF, 0xBB, 0xBF]);
-                const fixed = Buffer.concat([bom, orig]);
-                fs.writeFileSync(fullPath, fixed);
-                ok++;
-              } catch {}
-            }
-            log(grn(`  ✓ 인코딩 위험 ${ok}/${encScan.atRisk.length}건 UTF-8 BOM 자동 추가 (--auto-fix-encoding 1.9.243)`));
-          } else {
-            log(yel(`  ⚠ 셸 스크립트 인코딩 위험 ${encScan.atRisk.length}건 (1.9.241) — 자동 회복 가능`));
-            log(dim(`     → leerness env encoding --apply (수동) 또는 session close --auto-fix-encoding (1.9.243 자동)`));
-          }
-        }
-      } catch {}
-      // 1.9.232: 마감 시 pulse 한 줄 자동 노출 — 다음 라운드 진입 시 즉시 상태 인지
-      try {
-        const rh = _computeRoundHistory(root);
-        const ms = _computeMilestones(root);
-        const rows = readProgressRows(root);
-        const tIn = rows.filter(r => r.status === 'in-progress').length;
-        const dCnt = _loadDecisions(root).length;  // 1.9.339 (UR-0053): canonical 단일 진실소스
-        const rActive = readRules(root).filter(r => r.status === 'active').length;
-        const planText = exists(planPath(root)) ? read(planPath(root)) : '';
-        const pCnt = (planText.match(/^### M-\d{4}\./gm) || []).length;
-        const lCnt = _loadLessons(root).length;
-        const mem = `T${tIn}/D${dCnt}/R${rActive}/P${pCnt}/L${lCnt}`;
-        let pulseLine = `📍 v${VERSION} · 🔄 R${rh.roundCount} · 🧠 ${mem}`;
-        if (ms.next) {
-          const eta = ms.next.etaDays != null ? ` (${ms.next.etaDays}d)` : '';
-          pulseLine += ` · 🎯 R${ms.next.milestone}${eta}`;
-        }
-        log('');
-        log(`  ${pulseLine}  ${dim('— leerness pulse (1.9.232)')}`);
-      } catch {}
-    } catch {}
-  }
-}
+const _sessionClose = require('../lib/session-close');
+// 1.9.425 (UR-0025/UR-0125 큰 핸들러 모듈화 10번째): sessionClose → lib/session-close.js (DI 위임)
+function sessionClose(root, opts = {}) { return _sessionClose.sessionClose(root, opts, { VERSION, STATUSES, MARK, has, arg, harnessPath: __filename, readProgressRows, evidencePath, handoffPath, currentStatePath, taskLogPath, verifyRules, _autoRoadmap, _readUsageStats, readSessionCounter, writeSessionCounter, _retroAggregate, _retroOneLine, retroCmd, _loadDecisions, readRules, planPath, _loadLessons, _readFeatureGraph, _auditUserRequests, _detectDeliveredRequests, _computeRoundHistory, _computeMilestones, _computeRecentChanges, _collectPyFiles, _analyzePyFile, _collectRuntimeEnv, _scanShellScriptsEncoding, _listAPISkills, _matchAPISkills, _loadShellFailures, _shellEnvDrift, _runPreWakeAudit, _saveAndAppendPreWakeReport, _runIdempotencyAudit, _detectAbnormalShutdown, _updateUserRequest }); }
 
 function readmeCmd(root) { syncReadme(absRoot(root)); }
 function consistencyCheck(root) {