leerness 1.9.32 → 1.9.34

package/bin/harness.js

@@ -6,7 +6,7 @@ const path = require('path');
 const cp = require('child_process');
 const readline = require('readline');
 
-const VERSION = '1.9.32';
+const VERSION = '1.9.34';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -363,23 +363,51 @@ async function resolveInstallOptions(root, opts = {}) {
   let lang = explicitLang ? detectLanguageValue(root, explicitLang) : detectLanguageValue(root, 'auto');
   let skills = explicitSkills ? parseSkillsValue(explicitSkills) : [];
   const shouldAsk = !has('--yes') && !opts.nonInteractive && process.stdin.isTTY && process.stdout.isTTY && !opts.migration;
+  // 1.9.34: 인터랙티브 multi-select (방향키 + Space + Enter) — 기존 숫자 선택 폴백 유지
+  // --no-interactive-select 또는 LEERNESS_NO_INTERACTIVE=1 → 구식 숫자 선택
+  const useInteractive = shouldAsk && !has('--no-interactive-select') && process.env.LEERNESS_NO_INTERACTIVE !== '1';
   if (shouldAsk && !explicitLang) {
-    log('\n설치 언어를 선택하세요.');
-    log('1) 자동 감지'); log('2) 한국어'); log('3) English');
-    const a = await ask('선택 [1]: ');
-    lang = a === '2' ? 'ko' : a === '3' ? 'en' : detectLanguageValue(root, 'auto');
+    if (useInteractive) {
+      const langOpt = await _selectOne('설치 언어를 선택하세요', [
+        { label: '자동 감지', description: '디렉토리/파일 분석 (한국어/영어 자동 판별)', id: 'auto' },
+        { label: '한국어', description: '모든 인스트럭션을 한국어로 생성', id: 'ko' },
+        { label: 'English', description: '모든 인스트럭션을 영어로 생성', id: 'en' }
+      ], { defaultIndex: 0 });
+      lang = langOpt && langOpt.id ? detectLanguageValue(root, langOpt.id) : detectLanguageValue(root, 'auto');
+    } else {
+      log('\n설치 언어를 선택하세요.');
+      log('1) 자동 감지'); log('2) 한국어'); log('3) English');
+      const a = await ask('선택 [1]: ');
+      lang = a === '2' ? 'ko' : a === '3' ? 'en' : detectLanguageValue(root, 'auto');
+    }
   }
   if (shouldAsk && !explicitSkills) {
-    log('\n설치할 스킬 라이브러리를 선택하세요.');
-    log('0) 기본 하네스만 설치');
-    log('1) 추천: office, commerce-api, ai-verified-skill-publisher, feature-implementation');
-    log('2) 전체 스킬 설치'); log('3) 직접 입력');
-    skillList();
-    const a = await ask('선택 [1]: ');
-    if (!a || a === '1') skills = parseSkillsValue('recommended');
-    else if (a === '2') skills = parseSkillsValue('all');
-    else if (a === '3') skills = parseSkillsValue(await ask('스킬 ID를 쉼표로 입력: '));
-    else if (a === '0') skills = [];
+    if (useInteractive) {
+      // 카탈로그에서 옵션 생성
+      const cat = Object.entries(skillCatalog).map(([id, meta]) => ({
+        id, label: id, description: (meta.displayNameKo || id).slice(0, 50)
+      }));
+      // 추천 4개의 인덱스 계산
+      const recommended = ['office', 'commerce-api', 'ai-verified-skill-publisher', 'feature-implementation'];
+      const defaults = recommended.map(id => cat.findIndex(c => c.id === id)).filter(i => i >= 0);
+      const picked = await _selectMany(
+        '설치할 스킬 라이브러리 (Space=토글, a=전체, n=해제, Enter=확정)',
+        cat,
+        { defaults }
+      );
+      skills = picked.map(p => p.id);
+    } else {
+      log('\n설치할 스킬 라이브러리를 선택하세요.');
+      log('0) 기본 하네스만 설치');
+      log('1) 추천: office, commerce-api, ai-verified-skill-publisher, feature-implementation');
+      log('2) 전체 스킬 설치'); log('3) 직접 입력');
+      skillList();
+      const a = await ask('선택 [1]: ');
+      if (!a || a === '1') skills = parseSkillsValue('recommended');
+      else if (a === '2') skills = parseSkillsValue('all');
+      else if (a === '3') skills = parseSkillsValue(await ask('스킬 ID를 쉼표로 입력: '));
+      else if (a === '0') skills = [];
+    }
   }
   return { lang, skills };
 }
@@ -388,6 +416,10 @@ async function install(root, opts = {}) {
   root = absRoot(root); mkdirp(root);
   // 1.9.32: init 시 ASCII 배너 + 빠른 시작 가이드 (migrate는 quiet)
   if (!opts.migration && !has('--no-banner')) _banner({ quickStart: !opts.dry });
+  // 1.9.33: npx 캐시로 옛 버전이 실행될 때 경고 (migrate/--no-stale-check 시 스킵)
+  if (!opts.migration && !has('--no-stale-check') && !opts.nonInteractive) {
+    try { await _warnIfStale(root); } catch {}
+  }
   const resolved = await resolveInstallOptions(root, opts);
   const lang = resolved.lang;
   const skills = resolved.skills;
@@ -2320,49 +2352,112 @@ function _checkAgent(agent, opts = {}) {
   };
 }
 
-// 1.9.32: ASCII 배너 — init/version 시 출력
+// 1.9.33: npx 캐시 함정 방지 — install 진입 시 npm latest와 비교, stale이면 경고
+async function _warnIfStale(root, opts = {}) {
+  if (process.env.LEERNESS_NO_STALE_CHECK === '1') return null;
+  const offline = process.env.LEERNESS_OFFLINE === '1';
+  // 24h 캐시: .harness/cache/update-check.json 재사용 — 캐시 fresh면 OFFLINE이어도 비교는 수행
+  try {
+    let latest = null;
+    const cached = readUpdateCache(root);
+    if (cacheFresh(cached, 24) && cached.nextLeerness) {
+      latest = cached.nextLeerness;
+    } else if (!offline) {
+      // 캐시 없음 + 온라인 → npm view 호출 (timeout 8초 — 네트워크 끊겼어도 init 진행 차단 X)
+      latest = await Promise.race([
+        fetchNpmLatest('leerness'),
+        new Promise(resolve => setTimeout(() => resolve(null), 8000))
+      ]);
+      if (latest) {
+        try { writeUpdateCache(root, { nextLeerness: latest, runningCli: VERSION }); } catch {}
+      }
+    }
+    // offline + 캐시 없으면 비교 스킵 (네트워크 차단 환경)
+    if (!latest) return null;
+    if (compareVer(latest, VERSION) > 0) {
+      // 옛 버전이 실행 중. ANSI 노란/빨강.
+      const isTty = process.stdout && process.stdout.isTTY;
+      const C = isTty ? { y: s => `\x1b[33m${s}\x1b[0m`, r: s => `\x1b[31m${s}\x1b[0m`, b: s => `\x1b[1m${s}\x1b[0m`, d: s => `\x1b[2m${s}\x1b[0m` }
+                      : { y: s => s, r: s => s, b: s => s, d: s => s };
+      log('');
+      log(C.y('  ⚠  ') + C.b(C.r(`옛 버전이 실행 중입니다 — v${VERSION} → v${latest} (npm 최신)`)));
+      log('');
+      log(C.d('     npm registry latest: ') + C.b(`v${latest}`));
+      log(C.d('     이 CLI가 실행한 버전: ') + C.b(`v${VERSION}`) + C.d(' (npx 캐시 또는 글로벌 설치 stale)'));
+      log('');
+      log(C.d('     해결 — 둘 중 하나 실행 후 다시 시도:'));
+      log('       ' + C.b('npx --yes clear-npx-cache && npx leerness@latest init .'));
+      log('       ' + C.b('npm i -g leerness@latest  →  leerness init .'));
+      log('');
+      log(C.d('     (이 경고는 LEERNESS_NO_STALE_CHECK=1 또는 --no-stale-check로 끌 수 있습니다)'));
+      log('');
+      return { stale: true, current: VERSION, latest };
+    }
+    return { stale: false, current: VERSION, latest };
+  } catch (e) {
+    // 어떤 이유로든 실패해도 init 진행 차단 X
+    return null;
+  }
+}
+
+// 1.9.32/1.9.34: ASCII 배너 — init/version 시 출력 (그라데이션 다중 색상 강화)
 function _banner(opts = {}) {
   const v = `v${VERSION}`;
-  // 사용자 콘솔이 너무 좁을 때(<70) 또는 LEERNESS_NO_BANNER=1이면 스킵
   const cols = process.stdout && process.stdout.columns ? process.stdout.columns : 80;
   if (process.env.LEERNESS_NO_BANNER === '1') return;
   if (cols < 70) {
     log(`Leerness ${v}  —  한국어 우선 AI 개발 하네스`);
     return;
   }
-  // ANSI 색상 (TTY일 때만)
   const isTty = process.stdout && process.stdout.isTTY;
-  const C = isTty ? {
-    cyan: s => `\x1b[36m${s}\x1b[0m`, dim: s => `\x1b[2m${s}\x1b[0m`,
-    bold: s => `\x1b[1m${s}\x1b[0m`, green: s => `\x1b[32m${s}\x1b[0m`
-  } : { cyan: s => s, dim: s => s, bold: s => s, green: s => s };
-  // 박스 안쪽 너비 60칸 고정 (좌측 2칸 들여쓰기 포함 전체 64칸)
+  // 1.9.34: ANSI 256색 그라데이션 (cyan → magenta) + 굵게
+  // 색상 안전 fallback (Windows 구버전 cmd는 256색 불가 시 그냥 기본색)
+  const mk = (code) => isTty ? `\x1b[38;5;${code}m` : '';
+  const reset = isTty ? '\x1b[0m' : '';
+  const bold = isTty ? '\x1b[1m' : '';
+  // 그라데이션 색상 (cyan/teal/blue/purple/magenta): 6 LEERNESS 라인 × 단색씩
+  const grad = [51, 45, 39, 33, 99, 165]; // cyan → magenta
+  const C = {
+    cyan: s => isTty ? `\x1b[36m${s}\x1b[0m` : s,
+    dim: s => isTty ? `\x1b[2m${s}\x1b[0m` : s,
+    bold: s => isTty ? `\x1b[1m${s}\x1b[0m` : s,
+    green: s => isTty ? `\x1b[32m${s}\x1b[0m` : s,
+    yel: s => isTty ? `\x1b[33m${s}\x1b[0m` : s,
+    mag: s => isTty ? `\x1b[35m${s}\x1b[0m` : s,
+    g: (s, code) => isTty ? `${mk(code)}${bold}${s}${reset}` : s
+  };
+  // 박스 외곽선 + ASCII 본문 그라데이션
+  const asciiLines = [
+    '██╗     ███████╗███████╗██████╗ ███╗   ██╗███████╗███████╗',
+    '██║     ██╔════╝██╔════╝██╔══██╗████╗  ██║██╔════╝██╔════╝',
+    '██║     █████╗  █████╗  ██████╔╝██╔██╗ ██║█████╗  ███████╗',
+    '██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║',
+    '███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║',
+    '╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝'
+  ];
+  const border = C.cyan;
   const lines = [
     '',
-    C.cyan('  ╔══════════════════════════════════════════════════════════════╗'),
-    C.cyan('  ║                                                              ║'),
-    C.cyan('  ║  ') + C.bold('██╗     ███████╗███████╗██████╗ ███╗   ██╗███████╗███████╗') + C.cyan('  ║'),
-    C.cyan('  ║  ') + C.bold('██║     ██╔════╝██╔════╝██╔══██╗████╗  ██║██╔════╝██╔════╝') + C.cyan('  ║'),
-    C.cyan('  ║  ') + C.bold('██║     █████╗  █████╗  ██████╔╝██╔██╗ ██║█████╗  ███████╗') + C.cyan('  ║'),
-    C.cyan('  ║  ') + C.bold('██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║') + C.cyan('  ║'),
-    C.cyan('  ║  ') + C.bold('███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║') + C.cyan('  ║'),
-    C.cyan('  ║  ') + C.bold('╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝') + C.cyan('  ║'),
-    C.cyan('  ║                                                              ║'),
-    // ASCII-only 라인은 정확히 60칸 (좌2 + 본문56 + 우2)
-    C.cyan('  ║  ') + C.green(`${v.padEnd(10)}`) + C.dim('Korean-first AI Development Harness') + C.cyan('              ║'),
-    C.cyan('  ║  ') + C.dim('verify · reuse-map · handoff · agents · orchestrate') + C.cyan('         ║'),
-    C.cyan('  ║                                                              ║'),
-    C.cyan('  ╚══════════════════════════════════════════════════════════════╝'),
-    '  ' + C.dim('한국어 우선 AI 개발 하네스 — verify · reuse-map · handoff · agents'),
-    ''
+    border('  ╔══════════════════════════════════════════════════════════════╗'),
+    border('  ║                                                              ║'),
   ];
+  for (let i = 0; i < asciiLines.length; i++) {
+    lines.push(border('  ║  ') + C.g(asciiLines[i], grad[i]) + border('  ║'));
+  }
+  lines.push(border('  ║                                                              ║'));
+  lines.push(border('  ║  ') + C.green(`${v.padEnd(10)}`) + C.dim('Korean-first AI Development Harness') + border('              ║'));
+  lines.push(border('  ║  ') + C.yel('★ ') + C.dim('verify · reuse-map · handoff · agents · orchestrate') + border('       ║'));
+  lines.push(border('  ║                                                              ║'));
+  lines.push(border('  ╚══════════════════════════════════════════════════════════════╝'));
+  lines.push('  ' + C.dim('한국어 우선 AI 개발 하네스 — ') + C.mag('verify') + C.dim(' · ') + C.mag('reuse-map') + C.dim(' · ') + C.mag('handoff') + C.dim(' · ') + C.mag('agents'));
+  lines.push('');
   for (const ln of lines) log(ln);
   if (opts.quickStart) {
-    log(C.dim('  빠른 시작:'));
-    log(C.dim('    npx leerness@latest init .                          # 신규 프로젝트'));
-    log(C.dim('    npx leerness@latest setup-agents .                  # 외부 AI CLI 설정'));
-    log(C.dim('    npx leerness handoff .                              # 컨텍스트 적재'));
-    log(C.dim('    npx leerness verify-claim T-0001 --run-tests        # 자동 검증'));
+    log(C.bold(C.cyan('  ✨ 빠른 시작')));
+    log('    ' + C.green('npx leerness@latest init .') + C.dim('                          # 신규 프로젝트'));
+    log('    ' + C.green('npx leerness@latest setup-agents .') + C.dim('                  # 외부 AI CLI 설정'));
+    log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 적재'));
+    log('    ' + C.green('npx leerness verify-claim T-0001 --run-tests') + C.dim('        # 자동 검증'));
     log('');
   }
 }
@@ -2390,6 +2485,132 @@ async function _confirm(question, defaultYes = false) {
   return /^(y|yes|예|네|ㅇ|1|true)$/i.test(ans.trim());
 }
 
+// 1.9.34: 방향키 + 스페이스 + Enter 인터랙티브 single-select prompt (raw mode)
+// 비-TTY 또는 LEERNESS_NO_PROMPT=1 → 첫 옵션 반환
+async function _selectOne(question, options, opts = {}) {
+  if (!process.stdin.isTTY || process.env.LEERNESS_NO_PROMPT === '1' || has('--yes') || has('-y')) {
+    return opts.defaultIndex != null ? options[opts.defaultIndex] : options[0];
+  }
+  const stdin = process.stdin;
+  const stdout = process.stdout;
+  const isTty = stdout.isTTY;
+  const C = isTty ? {
+    cyan: s => `\x1b[36m${s}\x1b[0m`, dim: s => `\x1b[2m${s}\x1b[0m`,
+    bold: s => `\x1b[1m${s}\x1b[0m`, green: s => `\x1b[32m${s}\x1b[0m`,
+    inv: s => `\x1b[7m${s}\x1b[0m`, mag: s => `\x1b[35m${s}\x1b[0m`
+  } : { cyan: s => s, dim: s => s, bold: s => s, green: s => s, inv: s => s, mag: s => s };
+  return new Promise(resolve => {
+    let idx = opts.defaultIndex || 0;
+    if (idx < 0 || idx >= options.length) idx = 0;
+    const render = (first) => {
+      if (!first) {
+        // 이전 출력 지우기: options.length + 2줄 (제목 + 안내)
+        stdout.write(`\x1b[${options.length + 2}A`);
+      }
+      stdout.write(`\r${C.bold(question)}\n`);
+      stdout.write(`${C.dim('  ↑↓ 이동, Enter 확정, q 취소')}\n`);
+      for (let i = 0; i < options.length; i++) {
+        const label = typeof options[i] === 'string' ? options[i] : (options[i].label || String(options[i]));
+        const desc = typeof options[i] === 'object' && options[i].description ? C.dim('  — ' + options[i].description) : '';
+        const cursor = i === idx ? C.cyan('❯') : ' ';
+        const text = i === idx ? C.bold(C.green(label)) : label;
+        stdout.write(`\x1b[2K\r  ${cursor} ${text}${desc}\n`);
+      }
+    };
+    render(true);
+    stdin.setRawMode && stdin.setRawMode(true);
+    stdin.resume(); stdin.setEncoding('utf8');
+    const onData = (buf) => {
+      const key = String(buf);
+      // 화살표는 ESC [ A/B
+      if (key === '' || key === 'k') { idx = (idx - 1 + options.length) % options.length; render(false); }
+      else if (key === '' || key === 'j') { idx = (idx + 1) % options.length; render(false); }
+      else if (key === '\r' || key === '\n') {
+        cleanup();
+        stdout.write('\n');
+        resolve(options[idx]);
+      } else if (key === '' || key === 'q' || key === '') {
+        cleanup();
+        stdout.write('\n' + C.dim('  취소됨') + '\n');
+        resolve(opts.defaultIndex != null ? options[opts.defaultIndex] : null);
+      }
+    };
+    const cleanup = () => {
+      stdin.setRawMode && stdin.setRawMode(false);
+      stdin.removeListener('data', onData);
+      stdin.pause();
+    };
+    stdin.on('data', onData);
+  });
+}
+
+// 1.9.34: 방향키 + 스페이스 + Enter 인터랙티브 multi-select prompt (raw mode)
+// 비-TTY/--yes → opts.defaults 또는 빈 배열 반환
+async function _selectMany(question, options, opts = {}) {
+  if (!process.stdin.isTTY || process.env.LEERNESS_NO_PROMPT === '1' || has('--yes') || has('-y')) {
+    return (opts.defaults || []).map(d => typeof d === 'number' ? options[d] : d).filter(Boolean);
+  }
+  const stdin = process.stdin;
+  const stdout = process.stdout;
+  const isTty = stdout.isTTY;
+  const C = isTty ? {
+    cyan: s => `\x1b[36m${s}\x1b[0m`, dim: s => `\x1b[2m${s}\x1b[0m`,
+    bold: s => `\x1b[1m${s}\x1b[0m`, green: s => `\x1b[32m${s}\x1b[0m`,
+    inv: s => `\x1b[7m${s}\x1b[0m`, mag: s => `\x1b[35m${s}\x1b[0m`,
+    yel: s => `\x1b[33m${s}\x1b[0m`
+  } : { cyan: s => s, dim: s => s, bold: s => s, green: s => s, inv: s => s, mag: s => s, yel: s => s };
+  return new Promise(resolve => {
+    let idx = 0;
+    const selected = new Set((opts.defaults || []).map(d => typeof d === 'number' ? d : options.findIndex(o => o === d || (o && o.id === d))).filter(i => i >= 0));
+    const render = (first) => {
+      if (!first) stdout.write(`\x1b[${options.length + 2}A`);
+      stdout.write(`\r${C.bold(question)}\n`);
+      stdout.write(`${C.dim('  ↑↓ 이동, Space 토글, a 전체, n 해제, Enter 확정, q 취소')}\n`);
+      for (let i = 0; i < options.length; i++) {
+        const opt = options[i];
+        const label = typeof opt === 'string' ? opt : (opt.label || String(opt));
+        const desc = typeof opt === 'object' && opt.description ? C.dim(' — ' + opt.description) : '';
+        const mark = selected.has(i) ? C.green('◉') : C.dim('◯');
+        const cursor = i === idx ? C.cyan('❯') : ' ';
+        const text = i === idx ? C.bold(label) : label;
+        stdout.write(`\x1b[2K\r  ${cursor} ${mark} ${text}${desc}\n`);
+      }
+    };
+    render(true);
+    stdin.setRawMode && stdin.setRawMode(true);
+    stdin.resume(); stdin.setEncoding('utf8');
+    const onData = (buf) => {
+      const key = String(buf);
+      if (key === '' || key === 'k') { idx = (idx - 1 + options.length) % options.length; render(false); }
+      else if (key === '' || key === 'j') { idx = (idx + 1) % options.length; render(false); }
+      else if (key === ' ') {
+        if (selected.has(idx)) selected.delete(idx); else selected.add(idx);
+        render(false);
+      } else if (key === 'a' || key === 'A') {
+        for (let i = 0; i < options.length; i++) selected.add(i);
+        render(false);
+      } else if (key === 'n' || key === 'N') {
+        selected.clear();
+        render(false);
+      } else if (key === '\r' || key === '\n') {
+        cleanup();
+        stdout.write('\n');
+        resolve([...selected].sort((a, b) => a - b).map(i => options[i]));
+      } else if (key === '' || key === 'q' || key === '') {
+        cleanup();
+        stdout.write('\n' + C.dim('  취소됨 (기본값 사용)') + '\n');
+        resolve((opts.defaults || []).map(d => typeof d === 'number' ? options[d] : d).filter(Boolean));
+      }
+    };
+    const cleanup = () => {
+      stdin.setRawMode && stdin.setRawMode(false);
+      stdin.removeListener('data', onData);
+      stdin.pause();
+    };
+    stdin.on('data', onData);
+  });
+}
+
 // 1.9.32: .env 파일에 KEY=value 라인 누적/갱신 (이미 키가 있으면 값 교체, 없으면 append)
 function _upsertEnvLine(envPath, key, value) {
   let body = exists(envPath) ? read(envPath) : '';
@@ -2410,7 +2631,8 @@ function _tryInstallAgent(agent) {
   return { ok: false, message: `exit ${r.status}` + (r.error ? ` (${r.error.code || r.error.message})` : '') };
 }
 
-// 1.9.32: setup-agents 워크플로 — init 직후 또는 단독 명령
+// 1.9.32/1.9.34: setup-agents 워크플로 — init 직후 또는 단독 명령
+// 1.9.34: 방향키/스페이스 multi-select 도입 (LEERNESS_NO_INTERACTIVE=1 → 기존 yes/no 폴백)
 async function setupAgentsCmd(root, opts = {}) {
   root = absRoot(root || process.cwd());
   _loadEnvFile(root);
@@ -2418,12 +2640,11 @@ async function setupAgentsCmd(root, opts = {}) {
   const envPath = path.join(root, '.env');
 
   log('');
-  log('# 외부 AI CLI 설정 (1.9.32)');
+  log('# 외부 AI CLI 설정 (1.9.34)');
   log('메인 에이전트가 작업을 분배할 sub-agent 후보를 선택하세요.');
   log('각 CLI는 *환경변수 활성화 + PATH 존재* 둘 다 충족할 때 ready 상태가 됩니다.');
   log('');
 
-  // 비대화형(--yes 또는 비-TTY)이면 모든 CLI를 기존 값 유지 + 안내만
   const interactive = !!process.stdin.isTTY && !has('--yes') && !has('-y') && process.env.LEERNESS_NO_PROMPT !== '1';
   if (!interactive) {
     log('  비대화형 모드 — 환경변수는 변경하지 않습니다. 수동 편집:');
@@ -2432,38 +2653,57 @@ async function setupAgentsCmd(root, opts = {}) {
     return;
   }
 
-  for (const agent of EXTERNAL_AGENTS) {
-    const status = _checkAgent(agent);
-    const isReady = status.installed && status.enabled;
-    log(`---`);
-    log(`▸ ${agent.id} — ${agent.desc}`);
-    log(`  설치 상태: ${status.installed ? '🟢 설치됨 (' + (status.version || '?') + ')' : '⚪ 미설치'}`);
-    log(`  활성 상태: ${status.enabled ? '🟢 ' + agent.envFlag + '=1' : '🟡 ' + agent.envFlag + '=0 또는 미설정'}`);
+  // 1.9.34: multi-select로 활성화할 CLI 일괄 선택
+  const useInteractive = process.env.LEERNESS_NO_INTERACTIVE !== '1';
+  const statuses = EXTERNAL_AGENTS.map(a => ({ agent: a, status: _checkAgent(a) }));
 
-    const wantEnable = await _confirm(`  ${agent.id}를 sub-agent로 활성화하시겠습니까?`, isReady || agent.id === 'claude');
-    if (!wantEnable) {
-      _upsertEnvLine(envPath, agent.envFlag, '0');
-      log(`  ✗ ${agent.envFlag}=0 (비활성)`);
-      continue;
+  let toEnable = new Set();
+  if (useInteractive) {
+    const options = statuses.map(({ agent, status }) => {
+      const inst = status.installed ? '🟢 설치됨' : '⚪ 미설치';
+      const desc = `${inst} · ${agent.desc.slice(0, 50)}`;
+      return { id: agent.id, label: agent.id.padEnd(8), description: desc };
+    });
+    // 기본 선택: 이미 활성화된 것 + claude (기본 활성)
+    const defaults = statuses
+      .map((s, i) => (s.status.enabled || s.agent.id === 'claude') ? i : -1)
+      .filter(i => i >= 0);
+    const picked = await _selectMany(
+      '활성화할 sub-agent CLI를 선택하세요 (Space=토글, a=전체, n=해제, Enter=확정)',
+      options,
+      { defaults }
+    );
+    toEnable = new Set(picked.map(p => p.id));
+  } else {
+    // 폴백: 기존 yes/no
+    for (const { agent, status } of statuses) {
+      const isReady = status.installed && status.enabled;
+      log(`▸ ${agent.id} — ${agent.desc}`);
+      log(`  ${status.installed ? '🟢 설치됨' : '⚪ 미설치'} / ${status.enabled ? '🟢 활성' : '🟡 비활성'}`);
+      const wantEnable = await _confirm(`  ${agent.id}를 sub-agent로 활성화?`, isReady || agent.id === 'claude');
+      if (wantEnable) toEnable.add(agent.id);
     }
-    _upsertEnvLine(envPath, agent.envFlag, '1');
-    log(`  ✓ ${agent.envFlag}=1 (활성)`);
+  }
+
+  // 선택 결과 적용
+  for (const { agent, status } of statuses) {
+    const enable = toEnable.has(agent.id);
+    _upsertEnvLine(envPath, agent.envFlag, enable ? '1' : '0');
+    log(enable ? `  ✓ ${agent.envFlag}=1 (활성)` : `  ✗ ${agent.envFlag}=0 (비활성)`);
 
-    if (!status.installed) {
+    // 활성화했지만 미설치 → 자동 설치 prompt
+    if (enable && !status.installed) {
       log(`  ⚠ ${agent.bin}이(가) 설치되어 있지 않습니다.`);
       log(`     설치 명령: ${agent.installCmd}`);
-      log(`     상세 안내: ${agent.installHint}`);
       const doInstall = await _confirm(`  지금 자동 설치를 시도할까요?`, false);
       if (doInstall) {
         const r = _tryInstallAgent(agent);
         if (r.ok) {
-          log(`  ✓ 설치 성공 — 재확인: ${agent.bin} ${agent.versionArgs.join(' ')}`);
           const after = _checkAgent(agent);
           if (after.installed) log(`  🟢 ${agent.id} 설치 확인 (${after.version || '?'})`);
           else log(`  ⚠ 설치 후에도 PATH에서 찾지 못함 — 새 셸을 열어주세요`);
         } else {
           log(`  ✗ 설치 실패: ${r.message}`);
-          log(`     수동 설치 후 \`leerness agents list\`로 재확인하세요.`);
         }
       } else {
         log(`  → 나중에 직접 설치 후 \`leerness setup-agents\` 재실행 가능`);
@@ -4812,7 +5052,7 @@ function viewworkInstall(root) {
 }
 
 function help() {
-  log(`Leerness v${VERSION}\n\nUsage:\n  leerness init [path] [--language auto|ko|en] [--skills recommended|all|a,b]\n  leerness migrate [path] [--dry-run] [--force]\n  leerness update [path] [--check|--yes|--force|--from <tarball>]\n  leerness auto-update install [path]\n  leerness status [path]\n  leerness verify [path]\n  leerness debug [path]\n  leerness audit [path]\n  leerness check [path]\n  leerness scan secrets [path]\n  leerness encoding check [path]\n  leerness lazy detect [path]\n  leerness memory search "query" [--limit 5]\n  leerness handoff [path] [--all-apps] [--include p1,p2] [--since 24h|3d] [--compact] [--json]   # 1.9.17-22 워크스페이스 (--compact: LLM 시스템 프롬프트용 1줄 요약)\n  leerness orchestrate "<목표>" [--agents N] [--model qwen2.5:7b-instruct] [--retry-on-fail K]   # 1.9.22 Ollama opt-in (LEERNESS_OLLAMA_BASE_URL 필요)\n  leerness llm-bench record --score N --model X [--label L] [--tokens T]   # 1.9.22 LLM 벤치 히스토리 누적\n  leerness deps <capability> [--run-tests] [--json]   # 1.9.24 depends-on 역방향 추적 + 자동 회귀 sweep\n  leerness memory search "키" [--include-code]   # 1.9.25 소스 코드 본문도 검색 (모순 감지 핵심)\n  leerness brainstorm "주제" [--include-code]    # 1.9.25 코드 본문 hits 포함\n  leerness register-pending "<요청>" [--agent X] [--note Y]   # 1.9.25 다중 세션 in-progress 즉시 등록\n  leerness optimism-check <T-ID> [--json]   # 1.9.26/27 낙관적 표시 감지 (1.9.27: 10 카테고리 + URL/메서드 매핑 + 신뢰도 점수)\n  leerness persona list|show <id>|add <id>   # 1.9.29 페르소나 카탈로그 (보안/성능/UX/testing/docs 5종 내장)\n  leerness review <file> --persona <id1,id2,...>   # 1.9.29 도메인 페르소나 리뷰 프롬프트 자동 생성\n  leerness agents list|check|quota          # 1.9.30/31 외부 AI CLI 가용성 + quota 추정 (claude/codex/gemini/copilot)\n  leerness agents dispatch "<task>" --to <id>   # 1.9.30 활성 CLI 대상 실행 명령 생성 (실 호출 X, 사용자 실행)\n  leerness setup-agents [path] [--yes|--no-setup-agents]    # 1.9.32 sub-agent CLI 인터랙티브 설정 (.env + 미설치 자동 설치)\n  leerness verify-claim <T-ID> ... [--strict-claims]   # 1.9.26 verify-claim에 낙관적 표시 자동 검사 통합\n  leerness reuse-map [path] [--all-apps] [--include p1,p2] [--strict-elements] [--json] # 1.9.18 중복/잠재중복/depends-on\n  leerness verify-claim <T-ID> [--path .] [--run-tests] [--json]   # 1.9.18-20 evidence 자동 검증 (1.9.20: scenes/scripts 등 도메인 폴더 + jest/mocha 파싱)\n  leerness verify-code [path] [--build] [--bench]  # 1.9.20 --bench: scripts.bench 추가 실행 + evidence 누적\n  leerness session close [path]\n  leerness viewwork install [path]\n  leerness viewwork emit [path] [--action a] [--note n] [--agent x] [--tool t]\n  leerness route <task-type>\n  leerness self check [path]\n  leerness readme sync [path]\n  leerness consistency check [path]\n  leerness consistency merge-design-guide [path]\n  leerness plan show|init|add|drop|progress|sync [args]\n  leerness task list|add|update|drop|fix-evidence|relink [args]\n  leerness skill list|info <name>\n  leerness skill learn <id> --doc <url> --command "..." --capability "..." [--note ...]\n  leerness skill use <id> [--note ...]\n  leerness skill optimize <id> --before "..." --after "..." [--note ...]\n  leerness skill remove <id>\n  leerness skill consolidate [--threshold 0.3]\n  leerness gate [path]                       # verify+audit+scan+encoding+lazy
+  log(`Leerness v${VERSION}\n\nUsage:\n  leerness init [path] [--language auto|ko|en] [--skills recommended|all|a,b]\n  leerness migrate [path] [--dry-run] [--force]\n  leerness update [path] [--check|--yes|--force|--from <tarball>]\n  leerness auto-update install [path]\n  leerness status [path]\n  leerness verify [path]\n  leerness debug [path]\n  leerness audit [path]\n  leerness check [path]\n  leerness scan secrets [path]\n  leerness encoding check [path]\n  leerness lazy detect [path]\n  leerness memory search "query" [--limit 5]\n  leerness handoff [path] [--all-apps] [--include p1,p2] [--since 24h|3d] [--compact] [--json]   # 1.9.17-22 워크스페이스 (--compact: LLM 시스템 프롬프트용 1줄 요약)\n  leerness orchestrate "<목표>" [--agents N] [--model qwen2.5:7b-instruct] [--retry-on-fail K]   # 1.9.22 Ollama opt-in (LEERNESS_OLLAMA_BASE_URL 필요)\n  leerness llm-bench record --score N --model X [--label L] [--tokens T]   # 1.9.22 LLM 벤치 히스토리 누적\n  leerness deps <capability> [--run-tests] [--json]   # 1.9.24 depends-on 역방향 추적 + 자동 회귀 sweep\n  leerness memory search "키" [--include-code]   # 1.9.25 소스 코드 본문도 검색 (모순 감지 핵심)\n  leerness brainstorm "주제" [--include-code]    # 1.9.25 코드 본문 hits 포함\n  leerness register-pending "<요청>" [--agent X] [--note Y]   # 1.9.25 다중 세션 in-progress 즉시 등록\n  leerness optimism-check <T-ID> [--json]   # 1.9.26/27 낙관적 표시 감지 (1.9.27: 10 카테고리 + URL/메서드 매핑 + 신뢰도 점수)\n  leerness persona list|show <id>|add <id>   # 1.9.29 페르소나 카탈로그 (보안/성능/UX/testing/docs 5종 내장)\n  leerness review <file> --persona <id1,id2,...>   # 1.9.29 도메인 페르소나 리뷰 프롬프트 자동 생성\n  leerness agents list|check|quota          # 1.9.30/31 외부 AI CLI 가용성 + quota 추정 (claude/codex/gemini/copilot)\n  leerness agents dispatch "<task>" --to <id>   # 1.9.30 활성 CLI 대상 실행 명령 생성 (실 호출 X, 사용자 실행)\n  leerness setup-agents [path] [--yes|--no-setup-agents]    # 1.9.32 sub-agent CLI 인터랙티브 설정 (.env + 미설치 자동 설치)\n  leerness init [path] [--no-stale-check]                   # 1.9.33 npx 캐시 함정 — 옛 버전 자동 경고 (끄려면 --no-stale-check)\n  leerness verify-claim <T-ID> ... [--strict-claims]   # 1.9.26 verify-claim에 낙관적 표시 자동 검사 통합\n  leerness reuse-map [path] [--all-apps] [--include p1,p2] [--strict-elements] [--json] # 1.9.18 중복/잠재중복/depends-on\n  leerness verify-claim <T-ID> [--path .] [--run-tests] [--json]   # 1.9.18-20 evidence 자동 검증 (1.9.20: scenes/scripts 등 도메인 폴더 + jest/mocha 파싱)\n  leerness verify-code [path] [--build] [--bench]  # 1.9.20 --bench: scripts.bench 추가 실행 + evidence 누적\n  leerness session close [path]\n  leerness viewwork install [path]\n  leerness viewwork emit [path] [--action a] [--note n] [--agent x] [--tool t]\n  leerness route <task-type>\n  leerness self check [path]\n  leerness readme sync [path]\n  leerness consistency check [path]\n  leerness consistency merge-design-guide [path]\n  leerness plan show|init|add|drop|progress|sync [args]\n  leerness task list|add|update|drop|fix-evidence|relink [args]\n  leerness skill list|info <name>\n  leerness skill learn <id> --doc <url> --command "..." --capability "..." [--note ...]\n  leerness skill use <id> [--note ...]\n  leerness skill optimize <id> --before "..." --after "..." [--note ...]\n  leerness skill remove <id>\n  leerness skill consolidate [--threshold 0.3]\n  leerness gate [path]                       # verify+audit+scan+encoding+lazy
   leerness retro [path] [--days 7] [--all-apps] [--include p1,p2] [--json]  # 회고 (1.9.13~1.9.16)
   leerness insights [path] [--all-apps] [--include p1,p2] [--json]         # 누적 통계 (1.9.13~1.9.16)
   leerness brainstorm "<주제>" [--all-apps] [--include p1,p2] [--json]    # 브레인스토밍 (1.9.13~1.9.16)

package/package.json

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

package/scripts/e2e.js

@@ -898,7 +898,7 @@ total++;
   cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--language', 'ko', '--skills', 'recommended', '--no-setup-agents'], { stdio: 'ignore', timeout: 30000 });
   const r = cp.spawnSync(process.execPath, [CLI, 'setup-agents', tmpC, '--yes'], { encoding: 'utf8', timeout: 15000 });
   const ok = r.status === 0
-    && /외부 AI CLI 설정 \(1\.9\.32\)/.test(r.stdout)
+    && /외부 AI CLI 설정 \(1\.9\.3\d\)/.test(r.stdout)
     && /(비대화형|leerness agents list)/.test(r.stdout);
   console.log(ok ? '✓ B(1.9.32) setup-agents 비대화형: 안내만 출력 (.env 미변경)' : `✗ setup-agents 실패`);
   if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
@@ -931,6 +931,84 @@ total++;
   if (!ok) { failed++; console.log(after); }
 }
 
+// 1.9.33 회귀: npx 캐시 함정 — stale 버전 실행 시 경고
+total++;
+{
+  // 캐시에 미래 버전을 심어 stale 시뮬레이션 → 경고 출력 + init은 계속 진행
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-stale-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--language', 'ko', '--skills', 'recommended', '--no-stale-check'], { stdio: 'ignore', timeout: 30000 });
+  const cacheDir = path.join(tmpC, '.harness', 'cache');
+  fs.mkdirSync(cacheDir, { recursive: true });
+  fs.writeFileSync(path.join(cacheDir, 'update-check.json'), JSON.stringify({ at: Date.now(), nextLeerness: '99.99.99', runningCli: require('../package.json').version }), 'utf8');
+  const r = cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+  const ok = r.status === 0
+    && /옛 버전이 실행 중입니다/.test(r.stdout)
+    && /v99\.99\.99/.test(r.stdout)
+    && /clear-npx-cache/.test(r.stdout)
+    && /Leerness v/.test(r.stdout); // init도 계속 진행
+  console.log(ok ? '✓ B(1.9.33) npx stale 경고: 미래 latest 캐시 시 경고 + init 계속' : `✗ stale 경고 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 800)); }
+}
+
+// 1.9.34 회귀: 인터랙티브 multi-select (방향키/스페이스) — 비-TTY 폴백
+total++;
+{
+  // 비-TTY에서는 _selectOne/_selectMany가 defaults 또는 첫 옵션 반환
+  // → init이 --yes 없이도 비대화형이면 기본 스킬셋(recommended)로 진행
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-multi-'));
+  const r = cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+  // 비-TTY + --yes 시 multi-select prompt 안 띄움 → 통상 init 흐름
+  const ok = r.status === 0
+    && /Leerness v/.test(r.stdout)
+    && /Skills: office/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.34) multi-select 비-TTY 폴백: --yes로 default 사용' : `✗ multi-select 폴백 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
+}
+
+total++;
+{
+  // 1.9.34 배너 256색 그라데이션 — TTY 강제 + --banner
+  // 비-TTY일 때는 ANSI 코드 없이 순수 텍스트만 출력
+  const r = cp.spawnSync(process.execPath, [CLI, '--version', '--banner'], { encoding: 'utf8', timeout: 10000 });
+  const ok = r.status === 0
+    && /███████╗/.test(r.stdout)
+    && /verify · reuse-map/.test(r.stdout)
+    && /한국어 우선 AI 개발 하네스/.test(r.stdout)
+    && /v1\.9\.34/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.34) 배너 색상 + ASCII + 한국어' : `✗ 배너 색상 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
+}
+
+total++;
+{
+  // 1.9.34 LEERNESS_NO_INTERACTIVE=1: 구식 숫자 prompt 사용 (TTY 일 때만 의미 있음; 비-TTY는 어차피 --yes 폴백)
+  // 검증: --no-interactive-select 플래그가 인식되고 에러 안 남
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-noint-'));
+  const r = cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--no-interactive-select', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+  const ok = r.status === 0 && /Leerness v/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.34) --no-interactive-select 플래그 인식' : `✗ --no-interactive-select 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 300)); }
+}
+
+total++;
+{
+  // --no-stale-check / LEERNESS_NO_STALE_CHECK=1: 경고 스킵
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-stale2-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--language', 'ko', '--skills', 'recommended', '--no-stale-check'], { stdio: 'ignore', timeout: 30000 });
+  const cacheDir = path.join(tmpC, '.harness', 'cache');
+  fs.mkdirSync(cacheDir, { recursive: true });
+  fs.writeFileSync(path.join(cacheDir, 'update-check.json'), JSON.stringify({ at: Date.now(), nextLeerness: '99.99.99' }), 'utf8');
+  // --no-stale-check
+  const r1 = cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+  // env flag
+  const r2 = cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000, env: { ...process.env, LEERNESS_NO_STALE_CHECK: '1' } });
+  const ok = r1.status === 0 && r2.status === 0
+    && !/옛 버전이 실행 중입니다/.test(r1.stdout)
+    && !/옛 버전이 실행 중입니다/.test(r2.stdout);
+  console.log(ok ? '✓ B(1.9.33) stale 스킵: --no-stale-check + LEERNESS_NO_STALE_CHECK=1' : `✗ stale skip 실패`);
+  if (!ok) { failed++; console.log(r1.stdout.slice(0, 400)); }
+}
+
 // 1.9.22 회귀: handoff --compact + orchestrate opt-in 정책 + llm-bench record
 total++;
 {