leerness 1.9.152 → 1.9.154

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+## 1.9.154 — 2026-05-20
+
+**agent 1-shot multi-provider + REPL `:provider` 활성 검증 (1.9.153 후속, 일관성 강화).**
+
+자율 모드 84 라운드.
+
+### Added — `leerness agent "<task>" --provider <p>` 1-shot multi-provider
+- 기존: 1-shot 모드는 Ollama 만 호출, 다른 CLI 는 `agents dispatch` 안내만
+- 변경: **claude / codex / gemini / copilot 도 직접 호출** (1.9.153 `_cliChat` 재사용)
+- `_recordRun` observability — provider/model 필드 동적 (`agent_one_shot` kind)
+- task-log 기록도 provider 동적 (`leerness agent (claude:claude, role=actor)` 형식)
+- 실패 시 provider 별 friendly 안내 (Ollama: BASE_URL 확인 / 외부 CLI: `LEERNESS_ENABLE_<X>=1` + 설치)
+
+### Added — REPL `:provider <p>` 전환 시 활성 사전 검증
+- validProviders 화이트리스트 5종 — 알 수 없는 provider 거부
+- **비활성 (`ready` 아님) provider 전환 시 즉시 거부** — 실제 호출 시 실패 방지
+- `_checkAgent` 결과로 status/installed/enabled 종합 판정
+- Ollama 는 `LEERNESS_OLLAMA_BASE_URL` 미설정 시 친절한 안내 (블록 아님 — fallback URL 시도)
+- 전환 성공 시 `rl.setPrompt(prompt())` 으로 프롬프트 즉시 갱신
+
+### Verified — setup-agents `_selectMany` 일관성 (회귀 방지)
+- 1.9.34 이래 setup-agents 이미 `_selectMany` 사용 중 — 1.9.151 install 흐름과 일관
+- stress-v99 회귀 테스트 추가 (사용자 명시 요청 일관성 보장)
+
+### Verified
+- e2e 217/217 ✓
+- stress-v99: 18/18 (1-shot multi-provider 6종 + REPL :provider 검증 4종 + setup-agents 1종 + 누적 회귀 7종)
+- VERSION = 1.9.154 / autonomous-rounds = 84
+
+---
+
+## 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 복수 선택 후속).**

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.152-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v97-18%2F18-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-82-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![agents-multi](https://img.shields.io/badge/agents_multi-N_parallel_dispatch-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-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.154-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v99-18%2F18-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-84-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![multi-provider](https://img.shields.io/badge/agent-5_provider_1shot%2BREPL-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.152  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.154  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.152';
+const VERSION = '1.9.154';
 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); }
@@ -10073,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) {
@@ -10228,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;
@@ -10238,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: ''}]
@@ -10258,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이 명시되지 않았으면 사용자에게 선택지 제공
@@ -10326,7 +10425,36 @@ async function _agentRepl(root, opts) {
       if (!['planner', 'reviewer', 'actor'].includes(r)) { log(C.yel(`  ⚠ role 은 planner/reviewer/actor`)); return false; }
       state.role = r; rl.setPrompt(prompt()); log(C.green(`  role = ${r}`)); return false;
     }
-    if (op === 'provider') { state.provider = rest[0] || state.provider; log(C.green(`  provider = ${state.provider}`)); return false; }
+    if (op === 'provider') {
+      const newProv = rest[0] || state.provider;
+      const validProviders = ['ollama', 'claude', 'codex', 'gemini', 'copilot'];
+      if (!validProviders.includes(newProv)) {
+        log(C.yel(`  ⚠ provider 는 ${validProviders.join(' / ')} (받음: ${newProv})`));
+        return false;
+      }
+      // 1.9.154: provider 전환 시 활성 ready 사전 검증 — 비활성/미설치이면 친절한 안내 후 거부 (실제 호출 시 실패 방지)
+      if (newProv === 'ollama') {
+        // Ollama 는 HTTP 기반 — 단순히 LEERNESS_OLLAMA_BASE_URL 확인
+        const url = process.env.LEERNESS_OLLAMA_BASE_URL || '';
+        if (!url) {
+          log(C.yel(`  ⚠ ollama base URL 미설정 (LEERNESS_OLLAMA_BASE_URL) — 기본 http://localhost:11434 시도`));
+        }
+      } else {
+        const agent = EXTERNAL_AGENTS.find(a => a.id === newProv);
+        if (agent) {
+          const st = _checkAgent(agent);
+          if (st.status !== 'ready') {
+            log(C.yel(`  ⚠ ${newProv} 비활성 (${st.status}) — .env 에서 LEERNESS_ENABLE_${newProv.toUpperCase()}=1 + CLI 설치 필요`));
+            log(C.dim(`     (leerness agents list 로 상태 확인)  — provider 전환 취소`));
+            return false;
+          }
+        }
+      }
+      state.provider = newProv;
+      rl.setPrompt(prompt());
+      log(C.green(`  provider = ${state.provider}`));
+      return false;
+    }
     if (op === 'clear') { process.stdout.write('\x1b[2J\x1b[H'); return false; }
     if (op === 'reset') { state.history = []; log(C.dim('  history 초기화됨')); return false; }
     if (op === 'history') {
@@ -10374,11 +10502,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;
@@ -10415,17 +10547,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'));
@@ -10453,32 +10587,39 @@ async function agentCmd(root, taskArg) {
   } catch {}
   if (dryRun) { log('\n(dry-run) LLM 호출 스킵 — provider/권한/컨텍스트만 출력'); return; }
   if (!provider) { fail('활성 provider 없음 — .env 에서 LEERNESS_ENABLE_OLLAMA=1 또는 LEERNESS_ENABLE_CLAUDE=1 활성화'); process.exitCode = 1; return; }
-  // MVP: Ollama 지원 (로컬). 다른 CLI 는 사용자가 직접 호출 (leerness agents dispatch 이미 존재).
+  // 1.9.148: role prompt 자동 prepend (모든 provider 공통)
+  const finalPrompt = `${rolePrompt}\n\nTask: ${task}`;
+  const t0 = Date.now();
+  // 1.9.154: 1-shot 모드도 multi-provider — Ollama 외 claude/codex/gemini/copilot 직접 호출 (1.9.153 _cliChat 재사용)
+  let r;
   if (provider === 'ollama') {
     log('\n[ollama 호출 중...]');
-    // 1.9.148: role prompt 자동 prepend
-    const finalPrompt = `${rolePrompt}\n\nTask: ${task}`;
-    const t0 = Date.now();
-    const r = await _ollamaChat(finalPrompt);
-    const dt = Date.now() - t0;
-    // 1.9.149: observability 기록
-    _recordRun(root, { kind: 'agent_one_shot', provider: 'ollama', model: r.model, role, durationMs: dt, ok: r.ok, error: r.error, task: task.slice(0, 200), responseChars: (r.response || '').length });
-    if (r.ok) {
-      log('\n[response (model=' + r.model + ', role=' + role + ', ' + dt + 'ms)]\n' + r.response);
-      try {
-        const tlp = taskLogPath(root);
-        const block = `\n## ${today()} leerness agent (ollama:${r.model}, role=${role})\n- task: ${task.slice(0, 200)}\n- response (preview): ${r.response.slice(0, 240).replace(/\n+/g, ' ')}\n`;
-        append(tlp, block);
-      } catch {}
-    } else {
-      fail(`ollama 호출 실패: ${r.error || 'unknown'}`);
-      log(`  → ollama serve 실행 + LEERNESS_OLLAMA_BASE_URL 확인`);
-      process.exitCode = 1;
-    }
+    r = await _ollamaChat(finalPrompt);
+  } else if (['claude', 'codex', 'gemini', 'copilot'].includes(provider)) {
+    log(`\n[${provider} CLI 호출 중...]`);
+    r = await _cliChat(root, provider, finalPrompt, { timeout: 90000 });
+    if (r.ok && !r.model) r.model = provider;  // _cliChat 결과 보강
+  } else {
+    fail(`알 수 없는 provider: ${provider} (ollama/claude/codex/gemini/copilot)`);
+    process.exitCode = 1;
     return;
   }
-  // 그 외 provider: 사용자에게 직접 dispatch 안내
-  log(`\n💡 ${provider} provider 는 \`leerness agents dispatch "<task>" --to ${provider}\` 또는 외부 CLI 직접 호출 권장`);
+  const dt = Date.now() - t0;
+  // 1.9.149: observability 기록
+  _recordRun(root, { kind: 'agent_one_shot', provider, model: r.model || provider, role, durationMs: dt, ok: r.ok, error: r.error, task: task.slice(0, 200), responseChars: (r.response || '').length });
+  if (r.ok) {
+    log(`\n[response (provider=${provider}, model=${r.model || provider}, role=${role}, ${dt}ms)]\n${r.response}`);
+    try {
+      const tlp = taskLogPath(root);
+      const block = `\n## ${today()} leerness agent (${provider}:${r.model || provider}, role=${role})\n- task: ${task.slice(0, 200)}\n- response (preview): ${(r.response || '').slice(0, 240).replace(/\n+/g, ' ')}\n`;
+      append(tlp, block);
+    } catch {}
+  } else {
+    fail(`${provider} 호출 실패: ${r.error || 'unknown'}`);
+    if (provider === 'ollama') log(`  → ollama serve 실행 + LEERNESS_OLLAMA_BASE_URL 확인`);
+    else log(`  → .env 에서 LEERNESS_ENABLE_${provider.toUpperCase()}=1 + CLI 설치 확인 (leerness agents list)`);
+    process.exitCode = 1;
+  }
 }
 
 // ===== 1.9.147: 자동 유지보수 시스템 (사용자 명시 요청) =====

package/package.json

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