leerness 1.9.424 → 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.424';
+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; } },
@@ -3073,6 +3073,16 @@ 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';
@@ -11243,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) {