leerness 1.9.151 → 1.9.153

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # Changelog
 
+## 1.9.153 — 2026-05-20
+
+**`.env` 직접 생성/마이그레이션 + REPL 배너 leerness 고유 문구 + multi-provider REPL (사용자 명시 3종).**
+
+자율 모드 83 라운드.
+
+### Added — install 흐름에서 `.env` 직접 생성/마이그레이션 (사용자 명시)
+- 기존 `.env.example` 만 작성 → **이제 `.env` 도 직접 생성** (보안 = 빈 키만)
+- `mergeEnvFile()` — KEY 기준 처리:
+  - 기존 키 (사용자가 채운 값 포함) **절대 덮어쓰지 않음**
+  - 누락된 키만 빈 값으로 추가
+  - 주석/빈 줄은 substring 미포함 시만 append
+- `.gitignore` 에 `.env` 자동 등록 (1.9.71/75 audit 검증과 통합)
+- `.env.example` 은 계속 생성 (참조 템플릿)
+
+### Changed — REPL 배너 leerness 고유 문구 (사용자 명시)
+- 기존: `Hermes / OpenClaw / OpenCode 스타일 + Sandbox`
+- 변경: `검수·기억·샌드박스 통합 자율 AI 에이전트`
+- agent 사용법 (non-TTY) 헤더도 동일 — leerness 자체 정체성 강화
+
+### Added — REPL multi-provider 세션 관리 (사용자 명시)
+- 기존: Ollama 전용 채팅
+- 변경: **ollama / claude / codex / gemini / copilot** 5종 세션 관리
+- `_cliChat(root, provider, prompt, opts)` — 외부 CLI 호출 헬퍼
+  - 각 CLI 별 비-인터랙티브 호출 인자 자동 매핑
+  - `runCommandSafe` 경유 (env scrub + permissions + observability 자동)
+  - 활성 (`_checkAgent` ready) 확인 후 실행 — 비활성 시 friendly 에러
+- REPL 진입 시:
+  - `.env` 자동 로드 (LEERNESS_ENABLE_* 즉시 반영)
+  - 활성 CLI 단일 → 자동 선택 / 복수 → 사용자 번호 선택 / 0개 → Ollama fallback
+- `:provider <p>` 메타 명령으로 세션 중 전환 가능
+- `:role <r>` 와 조합하여 planner=claude / actor=codex 같은 multi-CLI 워크플로 가능
+
+### Security
+- `.env` 가 `.gitignore` 에 등록 (실제 시크릿 누출 방지)
+- `_cliChat` 가 `runCommandSafe` 경유 → env scrub 화이트리스트만 자식 프로세스에 전파
+- `.harness/runs/run-*.jsonl` 에 `kind: 'agent_repl_cli'` 로 모든 외부 CLI 호출 기록
+
+### Verified
+- e2e 217/217 ✓
+- stress-v98: 23/23 (env 생성 7종 + REPL 배너 3종 + multi-provider 6종 + 누적 회귀 7종)
+- VERSION = 1.9.153 / autonomous-rounds = 83
+
+---
+
+## 1.9.152 — 2026-05-20
+
+**`agents multi` — 활성 N개 에이전트 일괄 dispatch + handoff 헤드라인 활성 에이전트 카운트 (1.9.151 복수 선택 후속).**
+
+자율 모드 82 라운드. 1.9.151 install 복수 선택의 자연스러운 후속 — 실제 사용 시점에 선택된 에이전트들을 동시에 활용.
+
+### Added — `leerness agents multi "<task>"` 신규 명령
+- 활성 (ready) 에이전트들에 **일괄 dispatch 명령** 자동 생성 (claude/codex/gemini/copilot/ollama)
+- `--only c1,c2` — 활성 중에서 추가 필터링
+- `--write` — 파일 수정 권한 플래그 (각 CLI 별 적절한 옵션 자동 적용)
+- `--json` — 구조화 출력 (`{ task, count, agents, commands }`)
+- 메인 에이전트가 N개 sub-agent로 spawn 후 결과 합의/투표 → 가장 안정적인 답 선택
+
+### Added — `agents dispatch --multi` / `--to all` alias routing
+- 기존 `dispatch --to <id>` 와 동일한 인터페이스로 multi 모드 진입 가능
+- `--to all` 또는 `--to *` 또는 `--multi` 플래그로 자동 routing
+
+### Added — `_dispatchCommand(agentId, task, writeMode)` 공유 헬퍼
+- single dispatch + multi dispatch 가 동일한 명령 빌더 사용 — 일관성 보장
+- 5종 CLI 모두 지원 (claude/codex/gemini/copilot/ollama)
+
+### Added — handoff 헤드라인 8번째 항목 — 활성 에이전트 카운트
+- `🤖 agents N (claude,codex,...)` — 메인 에이전트가 매 세션 즉시 sub-agent 분배 가능성 인지
+- 활성 0개면 표시 안 함 (노이즈 최소화)
+- 1.9.151 복수 선택 결과가 .env 활성화 → 즉시 헤드라인 반영
+
+### Verified
+- e2e 217/217 ✓
+- stress-v97: 18/18 (agents multi 6종 + handoff 헤드라인 3종 + help/fail-fast 2종 + 누적 회귀 7종)
+- VERSION = 1.9.152 / autonomous-rounds = 82
+
+---
+
 ## 1.9.151 — 2026-05-20
 
 **install 흐름 — CLI 에이전트 복수 선택 + REPL 자동 시작 prompt + viewwork 제거 + help 검증 (사용자 명시 3종).**

package/README.md

@@ -2,7 +2,7 @@
 
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.151-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v96-26%2F26-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-47-blue)]() [![json](https://img.shields.io/badge/--json-20_commands-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-81-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![repl-agent](https://img.shields.io/badge/agent--REPL-multi%5C--select_agents-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![observability](https://img.shields.io/badge/runs--jsonl-traceId%2Fduration%2Fmodel-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.153-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v98-23%2F23-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-47-blue)]() [![json](https://img.shields.io/badge/--json-20_commands-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-83-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![multi-provider-repl](https://img.shields.io/badge/REPL-5_providers_session-success)]() [![env](https://img.shields.io/badge/.env-auto_generate%2Bmigrate-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,7 +12,7 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.151  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.153  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
   ╚══════════════════════════════════════════════════════════════╝
 ```

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.151';
+const VERSION = '1.9.153';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -579,6 +579,31 @@ function mergeLinesFile(p, lines) {
   writeUtf8(p, next);
 }
 
+// 1.9.153: env 파일 전용 key-aware merge — KEY=VALUE 줄을 키 기준 처리 (기존 값 보존, 빈 키만 추가)
+//   사용자가 .env 의 LEERNESS_NPM_TOKEN=abc123 처럼 직접 편집한 값을 절대 덮어쓰지 않음.
+//   주석 / 빈 줄은 substring includes 로 중복 방지 (mergeLinesFile 와 동일).
+function mergeEnvFile(p, lines) {
+  const current = exists(p) ? read(p) : '';
+  const existingKeys = new Set();
+  for (const ln of current.split(/\r?\n/)) {
+    const m = ln.match(/^\s*([A-Z][A-Z0-9_]+)\s*=/);
+    if (m) existingKeys.add(m[1]);
+  }
+  let next = current;
+  for (const line of lines) {
+    const km = line.match(/^\s*([A-Z][A-Z0-9_]+)\s*=/);
+    if (km) {
+      if (existingKeys.has(km[1])) continue;  // 기존 키 값 보존 (덮어쓰기 X)
+      next += (next.endsWith('\n') || !next ? '' : '\n') + line + '\n';
+      existingKeys.add(km[1]);
+    } else {
+      // 주석 또는 빈 줄 — substring 미포함 시만 append
+      if (!next.includes(line)) next += (next.endsWith('\n') || !next ? '' : '\n') + line + '\n';
+    }
+  }
+  writeUtf8(p, next);
+}
+
 function writeMigrationReport(root, backup, actions, opts = {}) {
   const p = path.join(root, '.harness/migration-report.md');
   const rows = actions.map(a => `| ${a.file} | ${a.action} |`).join('\n');
@@ -820,7 +845,10 @@ async function install(root, opts = {}) {
   }
   if (!opts.dry) {
     mergeLinesFile(path.join(root, '.gitignore'), [
-      '.harness/skill-publish.local.json','.harness/**/*.local.json','.env.local',
+      // 1.9.153: .env 직접 생성 + 사용자 글로벌 룰 SECRET_PATTERNS 6종 일괄 ignore (audit 통합)
+      //   audit 가 검사하는 6 패턴: .env / .env.local / .env.production / .env.*.local / *.pem / credentials.json
+      '.env', '.env.local', '.env.production', '.env.*.local', '*.pem', 'credentials.json',
+      '.harness/skill-publish.local.json','.harness/**/*.local.json',
       '.harness/archive/','.harness/migration-report.md','.harness/cache/',
       // 1.9.147: 자동 유지보수 — 자격증명 + incident 페이로드 비공개 (보안)
       '.harness/credentials.local.json','.harness/incidents/',
@@ -836,8 +864,12 @@ async function install(root, opts = {}) {
       return new Set([a]);  // back-compat: 단일 문자열
     })();
     const enable = (cli) => enabledSet.has(cli);
-    mergeLinesFile(path.join(root, '.env.example'), [
-      '# Leerness uses environment variable names only. Do not store real secrets here.',
+    // 1.9.153: .env.example 은 템플릿 (배포 가능, 실제 시크릿 값 없음)
+    //   .env 는 실 사용 파일 — 사용자가 토큰 채워 넣음. 보안 정책: 토큰 값은 절대 자동 채우지 않음 (키만).
+    //   .gitignore 에 .env 가 들어가 있어야 함 (audit 가 자동 검증). mergeLinesFile 은 기존 키 유지 + 신규 추가.
+    const envLines = [
+      '# Leerness — environment variable names only. Do not commit real secrets (this file is in .gitignore).',
+      `# Generated/migrated by leerness v${VERSION} at ${new Date().toISOString().slice(0, 10)}.`,
       'LEERNESS_NPM_TOKEN=','LEERNESS_GITHUB_TOKEN=',
       '# 1.9.22 — orchestrate opt-in. URL이 설정되면 leerness가 Ollama를 사용 가능. 미설정 시 LLM 호출 자동 시작 금지.',
       `LEERNESS_OLLAMA_BASE_URL=${enable('ollama') ? 'http://localhost:11434' : ''}`,
@@ -850,11 +882,22 @@ async function install(root, opts = {}) {
       `LEERNESS_ENABLE_COPILOT=${enable('copilot') ? 1 : 0}`,
       `LEERNESS_ENABLE_OLLAMA=${enable('ollama') ? 1 : 0}`,
       '# 1.9.42 — agentskills.io 공개 표준 스킬 자동 탐색 (opt-in). URL 설정 시 `leerness skill discover` 사용 가능.',
-      '#   예: LEERNESS_SKILL_DISCOVER_URL=https://agentskills.io/llms.txt',
+      '#   예시 URL: https://agentskills.io/llms.txt',
       'LEERNESS_SKILL_DISCOVER_URL=',
       '# (선택) 사용자 요청 분석 시 자동 매칭 스킬 추천. 1=활성, 0/미설정=비활성.',
       'LEERNESS_SKILL_AUTO_DISCOVER=0'
-    ]);
+    ];
+    mergeLinesFile(path.join(root, '.env.example'), envLines);
+    // 1.9.153: .env 직접 생성/마이그레이션 (사용자 명시 요청). 보안 = 빈 값만 — 사용자가 직접 토큰 채움.
+    //   기존 .env 가 있으면 mergeEnvFile 이 KEY 기준 처리:
+    //     - 기존 키 (사용자가 채운 값 포함) 는 절대 덮어쓰지 않음
+    //     - 누락된 키만 빈 값으로 추가
+    //   .env 가 .gitignore 에 등록되어 있는지 audit 가 검증 (1.9.75+).
+    try {
+      mergeEnvFile(path.join(root, '.env'), envLines);
+    } catch (e) {
+      warn(`.env 생성/마이그레이션 실패 (계속 진행): ${e.message}`);
+    }
     // 1.9.146: agent 권한 파일 자동 생성 (사용자 명시 요청 #5)
     if (resolved.permissionMode) {
       try { _writePermissionsPreset(root, resolved.permissionMode); } catch (e) { warn('permissions 생성 실패: ' + e.message); }
@@ -2914,10 +2957,18 @@ function handoff(root) {
         const lessons = exists(lessonsPath(root)) ? (read(lessonsPath(root)).match(/^### \d{4}-\d{2}-\d{2}/gm) || []).length : 0;
         parts.push(`🧠 mem T${inProgressTasks}/D${decisions}/R${rulesActive}/P${planMilestones}/L${lessons}`);
       } catch {}
+      // 8) 1.9.152: 활성 외부 AI CLI 카운트 (1.9.151 복수 선택 결과 반영) — 메인 에이전트가 sub-agent 분배 가능성 즉시 인지
+      try {
+        _loadEnvFile(root);  // .env 자동 로드 (handoff 컨텍스트)
+        const ready = EXTERNAL_AGENTS.map(a => _checkAgent(a)).filter(c => c.status === 'ready');
+        if (ready.length > 0) {
+          parts.push(`🤖 agents ${ready.length} (${ready.map(c => c.id).join(',')})`);
+        }
+      } catch {}
       if (parts.length) {
         const isTty = process.stdout && process.stdout.isTTY;
         const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
-        log(cy(`📊 헤드라인 (1.9.81/93/113): ${parts.join(' · ')}`));
+        log(cy(`📊 헤드라인 (1.9.81/93/113/152): ${parts.join(' · ')}`));
       }
     } catch {}
   }
@@ -5016,6 +5067,17 @@ async function setupAgentsCmd(root, opts = {}) {
   log('   다음: leerness agents list  /  leerness agents quota');
 }
 
+// 1.9.152: 단일 agent dispatch 명령 빌더 — agents dispatch (단일) + agents multi (복수) 가 공유
+function _dispatchCommand(agentId, task, writeMode) {
+  const q = String(task || '').replace(/"/g, '\\"');
+  if (agentId === 'claude') return `claude ${writeMode ? '--print --dangerously-skip-permissions' : '--print'} "${q}"`;
+  if (agentId === 'codex')  return `codex ${writeMode ? 'exec --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox' : 'exec --skip-git-repo-check'} "${q}"`;
+  if (agentId === 'gemini') return `gemini ${writeMode ? '-p --yolo' : '-p'} "${q}"`;
+  if (agentId === 'copilot') return `gh copilot suggest "${q}"`;
+  if (agentId === 'ollama') return `# ollama — leerness agent "${q}" --provider ollama 로 직접 호출 (REPL: leerness agent)`;
+  return `# ${agentId}: 명령 빌더 미정의`;
+}
+
 function agentsCmd(root, sub, ...args) {
   root = absRoot(root || process.cwd());
   // .env 자동 로드 (1.9.22)
@@ -5059,11 +5121,61 @@ function agentsCmd(root, sub, ...args) {
     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 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);
+    }
+    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))
+      }, 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('```');
+      log('');
+    }
+    log('## 정책 (1.9.152)');
+    log(`  - leerness는 외부 CLI를 자동 호출하지 않음 (사용자/메인 에이전트가 명시적으로 실행)`);
+    log(`  - 메인 에이전트(Claude)가 위 ${ready.length}개 명령을 보고 ${ready.length}개 sub-agent로 spawn — 결과 합의/투표로 가장 안정적인 답 선택`);
+    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);
     const target = arg('--to', null);
     if (!task) { fail('dispatch "<task>" 또는 --task 필요'); return process.exit(1); }
-    if (!target) { fail('--to <agent_id> 필요 (claude/codex/gemini/copilot)'); 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);
+    }
+    if (!target) { fail('--to <agent_id> 필요 (claude/codex/gemini/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 체크 전에 출력 — 비활성이어도 추천)
@@ -10004,6 +10116,41 @@ async function _ollamaListModels() {
   });
 }
 
+// 1.9.153: 외부 CLI 채팅 호출 (multi-provider REPL — 사용자 명시 요청)
+//   claude/codex/gemini/copilot 를 child_process 로 호출 후 stdout 캡처.
+//   runCommandSafe 경유 — env scrub + permissions + observability 자동 적용.
+async function _cliChat(root, provider, prompt, opts) {
+  opts = opts || {};
+  const agent = EXTERNAL_AGENTS.find(a => a.id === provider);
+  if (!agent) return { ok: false, error: `unknown provider: ${provider}`, provider };
+  const status = _checkAgent(agent);
+  if (status.status !== 'ready') {
+    return { ok: false, error: `${provider} 비활성 (${status.status}) — .env 에서 ${agent.envFlag}=1 + CLI 설치 필요`, provider };
+  }
+  // CLI 별 비-인터랙티브 호출 인자 매핑 (read-only 모드 — REPL 안에서 파일 수정 X)
+  let cmd, args;
+  if (provider === 'claude')  { cmd = 'claude'; args = ['--print', prompt]; }
+  else if (provider === 'codex')   { cmd = 'codex';  args = ['exec', '--skip-git-repo-check', prompt]; }
+  else if (provider === 'gemini')  { cmd = 'gemini'; args = ['-p', prompt]; }
+  else if (provider === 'copilot') { cmd = 'gh';     args = ['copilot', 'suggest', prompt]; }
+  else return { ok: false, error: `provider ${provider} 미지원`, provider };
+  // runCommandSafe — env scrub + observability 자동
+  const r = runCommandSafe(cmd, args, {
+    cwd: process.cwd(), root,
+    timeout: opts.timeout || 60000,
+    allowOutsideCwd: true,  // CLI 가 cwd 밖에서 실행될 수 있음
+    kind: 'agent_repl_cli', label: `repl-${provider}`
+  });
+  if (r.status === 0) {
+    return { ok: true, response: (r.stdout || '').trim(), provider, model: provider };
+  }
+  return {
+    ok: false,
+    error: `exit=${r.status} ${(r.stderr || r.stdout || '').slice(0, 200)}`,
+    provider
+  };
+}
+
 // 1.9.149: observability lite — 모든 agent 호출의 traceId + duration + exit + failureCause 기록
 function _runsDir(root) { return path.join(absRoot(root), '.harness', 'runs'); }
 function _recordRun(root, entry) {
@@ -10159,8 +10306,10 @@ const _AGENT_ROLE_PROMPTS = {
   reviewer: '역할: reviewer. planner 의 계획 또는 actor 의 결과를 비판적으로 검토. 누락된 검증, 잠재 cascade, 오류 가능성 지적. 동의/수정 결론 명시.',
   actor: '역할: actor. 계획에 따라 정확한 명령/코드만 실행. evidence(파일 경로 + 테스트 결과) 함께 기록. 새 계획 생성 금지.'
 };
-// 1.9.149: REPL 모드 — Hermes/OpenClaw/OpenCode 스타일 자율형 CLI 에이전트
+// 1.9.149+1.9.153: REPL 모드 — leerness 자율 AI 에이전트 (multi-provider 세션)
 async function _agentRepl(root, opts) {
+  // 1.9.153: .env 자동 로드 (REPL 진입 직전) — install 직후 LEERNESS_ENABLE_* 즉시 반영
+  try { _loadEnvFile(root); } catch {}
   const readline = require('readline');
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   const isTty = process.stdout.isTTY;
@@ -10169,9 +10318,28 @@ async function _agentRepl(root, opts) {
     bold: s => `\x1b[1m${s}\x1b[0m`, green: s => `\x1b[32m${s}\x1b[0m`,
     yel: s => `\x1b[33m${s}\x1b[0m`, mag: s => `\x1b[35m${s}\x1b[0m`
   } : { cy:s=>s, dim:s=>s, bold:s=>s, green:s=>s, yel:s=>s, mag:s=>s };
+  // 1.9.153: provider 자동 선택 — opts.provider 명시 안 됨 + 활성 CLI 가 있으면 사용자에게 선택지 표시
+  let initialProvider = opts.provider;
+  if (!initialProvider) {
+    const ready = EXTERNAL_AGENTS.map(a => ({ def: a, status: _checkAgent(a) }))
+                                  .filter(x => x.status.status === 'ready');
+    if (ready.length === 1) {
+      initialProvider = ready[0].def.id;  // 단일 활성 → 자동 선택
+    } else if (ready.length > 1 && isTty) {
+      // 복수 활성 → 사용자에게 선택지 (Ollama 우선이 아닌, 활성된 CLI 중 선택)
+      console.log('');
+      console.log(`  사용 가능한 CLI 에이전트 ${ready.length}개:`);
+      ready.forEach((x, i) => console.log(`    ${i + 1}) ${x.def.id}${x.status.version ? ' (v' + x.status.version + ')' : ''}`));
+      const choice = await new Promise(res => rl.question(`\n  provider 선택 (Enter=1): `, res));
+      const idx = parseInt(choice, 10) - 1;
+      initialProvider = (idx >= 0 && idx < ready.length) ? ready[idx].def.id : ready[0].def.id;
+    } else {
+      initialProvider = 'ollama';  // 활성 0개 → fallback (사용 시 friendly 경고)
+    }
+  }
   // 세션 state
   let state = {
-    provider: opts.provider || 'ollama',
+    provider: initialProvider,
     model: opts.model || process.env.LEERNESS_OLLAMA_MODEL || null,
     role: opts.role || 'actor',
     history: [],   // [{role: 'user'|'assistant', content: ''}]
@@ -10189,8 +10357,8 @@ async function _agentRepl(root, opts) {
   // 환영 메시지 + 모델 선택
   log('');
   log(C.bold(C.cy('  ╔════════════════════════════════════════════════════╗')));
-  log(C.bold(C.cy('  ║  leerness agent — REPL mode (1.9.150)              ║')));
-  log(C.bold(C.cy('  ║  Hermes / OpenClaw / OpenCode 스타일 + Sandbox     ║')));
+  log(C.bold(C.cy('  ║  leerness agent — REPL mode                        ║')));
+  log(C.bold(C.cy('  ║  검수·기억·샌드박스 통합 자율 AI 에이전트             ║')));
   log(C.bold(C.cy('  ╚════════════════════════════════════════════════════╝')));
   log('');
   // Ollama 모델 자동 감지 — model이 명시되지 않았으면 사용자에게 선택지 제공
@@ -10305,11 +10473,15 @@ async function _agentRepl(root, opts) {
       const finalPrompt = `${rolePrompt}\n\nConversation so far:\n${state.history.slice(-6).map(m => `[${m.role}] ${m.content}`).join('\n')}\n\nRespond as ${state.role}:`;
       const t0 = Date.now();
       let result;
+      // 1.9.153: multi-provider REPL — ollama 외 claude/codex/gemini/copilot 도 세션 관리 (사용자 명시)
       if (state.provider === 'ollama') {
-        log(C.dim(`  → ollama (${state.model}) 호출 중...`));
+        log(C.dim(`  → ollama${state.model ? ' (' + state.model + ')' : ''} 호출 중...`));
         result = await _ollamaChat(finalPrompt, state.model);
+      } else if (['claude', 'codex', 'gemini', 'copilot'].includes(state.provider)) {
+        log(C.dim(`  → ${state.provider} CLI 호출 중...`));
+        result = await _cliChat(root, state.provider, finalPrompt, { timeout: 90000 });
       } else {
-        log(C.yel(`  ⚠ ${state.provider} REPL 미지원 — leerness agents dispatch 사용 권장`));
+        log(C.yel(`  ⚠ ${state.provider} provider 미지원 — :provider ollama|claude|codex|gemini|copilot`));
         rl.prompt(); return;
       }
       const dt = Date.now() - t0;
@@ -10346,17 +10518,19 @@ async function agentCmd(root, taskArg) {
       return;
     }
     // non-TTY: 사용법만 출력
-    log('# leerness agent (1.9.146/148/149/150) — Hermes/OpenClaw 스타일 CLI 에이전트 + Sandbox');
+    log('# leerness agent — 검수·기억·샌드박스 통합 자율 AI 에이전트');
     log('');
     log('사용법:');
-    log('  leerness agent                              # 1.9.149 REPL 모드 (모델 선택 + 채팅)');
+    log('  leerness agent                              # REPL 모드 (provider 자동 선택 + 채팅)');
     log('  leerness agent "<task>"                     # 1회 위임 (actor 역할 기본)');
     log('  leerness agent "<task>" --role planner      # 계획만 (1.9.148)');
     log('  leerness agent "<task>" --role reviewer     # 비판적 검토 (1.9.148)');
-    log('  leerness agent --interactive --model qwen2.5-coder  # 명시적 REPL + model 선택');
+    log('  leerness agent --provider claude            # provider 명시 (ollama/claude/codex/gemini/copilot)');
+    log('  leerness agent --interactive --model qwen2.5-coder  # 명시적 REPL + Ollama 모델 선택');
     log('');
     log('REPL 메타 명령: :help / :model / :role / :provider / :history / :save / :quit');
     log('REPL Slash 명령 (1.9.150): :verify / :audit / :handoff / :health  (sandboxed runCommandSafe)');
+    log('REPL Multi-provider (1.9.153): ollama / claude / codex / gemini / copilot — 활성 CLI 자동 감지');
     log('');
     log('현재 활성 provider: ' + (_activeCliAgents().join(', ') || '(없음) — .env에서 LEERNESS_ENABLE_* 활성화'));
     log('권한 모드: ' + (_readPermissions(root).mode || 'basic'));
@@ -11151,7 +11325,7 @@ function reuseAutodetectCmd(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 init [path] [--no-stale-check]                   # 1.9.33 npx 캐시 함정 — 옛 버전 자동 경고 (끄려면 --no-stale-check)\n  leerness contract verify <spec.md> <impl.js> [--json]     # 1.9.35 명세 ↔ 구현 일치 검사 (함수/필드)\n  leerness reuse autodetect [path] [--apply] [--json]       # 1.9.35 src/*.js의 module.exports → reuse-map 후보 등록\n  leerness audit [path] [--fix]                              # 1.9.35 --fix: session-handoff/current-state 자동 갱신\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 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 agents multi "<task>" [--only c1,c2] [--write]   # 1.9.152 활성 N개 에이전트 일괄 dispatch 명령 (복수 선택 후속)\n  leerness agents dispatch "<task>" --multi   # 1.9.152 multi 모드 alias (또는 --to all)\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 contract verify <spec.md> <impl.js> [--json]     # 1.9.35 명세 ↔ 구현 일치 검사 (함수/필드)\n  leerness reuse autodetect [path] [--apply] [--json]       # 1.9.35 src/*.js의 module.exports → reuse-map 후보 등록\n  leerness audit [path] [--fix]                              # 1.9.35 --fix: session-handoff/current-state 자동 갱신\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 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.151",
+  "version": "1.9.153",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",