leerness 1.9.155 → 1.9.157

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # Changelog
 
+## 1.9.157 — 2026-05-20
+
+**Provider Registry CLI MVP — 사용자 정의 provider 동적 추가 (점검 보고서 권고 #3 — Provider Registry MCP의 CLI 단계).**
+
+자율 모드 87 라운드. 1.9.155 점검 보고서가 발견한 "모델/프로바이더 폭 5종 vs 200+" gap 보강의 첫 단계.
+
+### Added — `leerness provider list|add|remove` 신규 명령
+- 빌트인 5종 (claude/codex/gemini/copilot/ollama) + **사용자 정의 provider 동적 추가**
+- `.harness/providers.json` — 사용자 정의 저장 (schemaVersion 1)
+- `_allProviders(root)` — 빌트인 + 사용자 정의 merge
+  - 같은 id 의 user override 적용 → 빌트인 설정 변경 가능
+  - 빌트인에 없는 user-only provider 추가
+
+### CLI
+```bash
+leerness provider list                       # 빌트인 + 사용자 정의 통합 표시
+leerness provider list --json                # 구조화 출력 (total/builtin/user/providers)
+leerness provider add openrouter --bin openrouter-cli --desc "OpenRouter aggregator"
+leerness provider add bedrock --bin aws-bedrock-cli --env-flag LEERNESS_ENABLE_BEDROCK
+leerness provider remove openrouter          # 사용자 정의만 제거 가능 (빌트인 거부)
+```
+
+### Changed — `agents list/check` Provider Registry 통합
+- 표 출력에 `source` 컬럼 추가 (builtin / user / user(override))
+- JSON 응답에 `source` 필드 추가
+- 활성 없을 때 "1.9.157: 빌트인 외 CLI 추가" hint 표시
+- 헤더 `(1.9.30)` 유지 — 기존 e2e regex 호환
+
+### Use Cases
+- **OpenRouter 200+ 모델 흡수**: `provider add openrouter --bin openrouter-cli` 후 `LEERNESS_ENABLE_OPENROUTER=1` 설정
+- **AWS Bedrock 통합**: `provider add bedrock --bin aws-bedrock-cli`
+- **Groq / Hugging Face / 자체 LLM CLI**: 모두 동일 패턴
+- **자동 발견**: 1.9.158 에서 OpenRouter llms.txt 자동 동기화 예정
+
+### Verified — 5능력 매트릭스 갱신
+| 영역 | 1.9.156 | 1.9.157 |
+|---|---|---|
+| Provider 폭 | 5종 고정 | **무제한 (동적 등록)** |
+| 종합 완성도 | 60% | **62%** |
+
+### Pending — 보고서 권고 남은 후보
+- **1.9.158** — `leerness provider sync` (OpenRouter llms.txt 자동 동기화) + MCP `leerness_provider_list` (48번째 도구)
+- **1.9.159** — LSP 어댑터 MVP (TypeScript LSP)
+- **1.9.160** — playwright/computer-use bridge (`permissions.browser/mouse` 실 동작)
+
+### Verified
+- e2e 217/217 ✓
+- stress-v102: 19/19 (Provider Registry 함수 3종 + list 2종 + add/remove 6종 + agents 통합 2종 + 누적 회귀 6종)
+- VERSION = 1.9.157 / autonomous-rounds = 87
+
+---
+
+## 1.9.156 — 2026-05-20
+
+**`agents multi --execute` 실제 spawn + consensus 통합 (1.9.155 점검 보고서 발견 gap #1 보강).**
+
+자율 모드 86 라운드. 5능력 점검 보고서가 발견한 **"agents multi가 명령 문자열만 출력 — 실제 spawn 안 함"** 문제를 직접 해결.
+
+### Added — `leerness agents multi "<task>" --execute`
+- 기존 (1.9.152): 활성 N개 에이전트에 dispatch 명령 **문자열만 출력** — 사용자가 실행
+- 신규 (1.9.156): `--execute` 플래그 시 **leerness가 직접 N개 sub-agent 병렬 spawn**
+  - `Promise.all` 로 `_cliChat(provider)` 동시 호출 — 진짜 N-way 분배
+  - 각 호출은 1.9.150 `runCommandSafe` 경유 → cwd jail + env scrub + 자동 observability
+  - `--timeout <s>` 옵션 (기본 60s) — 무한 대기 방지
+- 결과 수집 후 **1.9.155 multi-signal consensus** 자동 적용:
+  - `score = 0.4*tokensNorm + 0.4*overlap + 0.2*lengthFit`
+  - best 1위 + others 2-4위 점수 표시 (투명성)
+- `--json` 출력: `{ task, count, success, totalElapsedMs, results, best, failures }`
+- `_recordRun` 통합 — kind `agents_multi_execute` + task-log 자동 기록
+- 활성 0개 또는 onlyArg 매칭 0개 → 즉시 fail (실 호출 시도 X)
+
+### Verification — 5능력 점검 매트릭스 갱신
+| 영역 | 1.9.155 | 1.9.156 |
+|---|---|---|
+| 멀티 에이전트 오케스트레이션 | 70% (명령 출력만) | **90%** (실 spawn + consensus 합의) |
+| 종합 완성도 | 55% | **60%** |
+
+이제 leerness 가 "지시 생성기" 가 아닌 **"실 실행 오케스트레이터"** — Hermes Agent / OpenClaw 같은 도구와의 격차가 크게 줄어듦.
+
+### Pending — 보고서 권고 다음 3 후보
+1. **1.9.157** — LSP 어댑터 MVP (TypeScript LSP 먼저)
+2. **1.9.158** — Provider Registry MCP 도구 (OpenRouter/Bedrock 100+ 모델 흡수)
+3. **1.9.159** — playwright/computer-use bridge (`permissions.browser/mouse` 실 동작 — opt-in)
+
+### Verified
+- e2e 217/217 ✓
+- stress-v101: 18/18 (--execute 7종 + CLI 동작 3종 + 누적 회귀 8종)
+- VERSION = 1.9.156 / autonomous-rounds = 86
+
+---
+
 ## 1.9.155 — 2026-05-20
 
 **REPL UX 대폭 개선 + provider 모델 카탈로그 + orchestrate consensus 강화 + 5능력 점검 보고서 (사용자 명시).**

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.155-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v100-18%2F18-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-47-blue)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-85-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![multi-provider](https://img.shields.io/badge/REPL-5_providers%2Bmodel_catalog-success)]() [![consensus](https://img.shields.io/badge/orchestrate-multi--signal_consensus-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.157-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v102-19%2F19-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-47-blue)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-87-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![provider-registry](https://img.shields.io/badge/provider_registry-dynamic_add-success)]() [![multi-execute](https://img.shields.io/badge/agents_multi-real_spawn%2Bconsensus-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.155  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.157  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.155';
+const VERSION = '1.9.157';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -4584,6 +4584,119 @@ const EXTERNAL_AGENTS = [
     installCmd: 'curl -fsSL https://ollama.com/install.sh | sh (또는 https://ollama.com/download)', installHint: 'ollama serve 실행 + ollama pull <model>' }
 ];
 
+// 1.9.157: Provider Registry — 사용자 정의 provider 동적 추가 (.harness/providers.json)
+//   빌트인 5종 (EXTERNAL_AGENTS) + 사용자 정의를 merge. OpenRouter / Bedrock / Groq 등 새 CLI 즉시 흡수 가능.
+//   파일 형식: { "schemaVersion": 1, "providers": [{ id, bin, envFlag, versionArgs, desc, installHint }] }
+function _providersFile(root) { return path.join(absRoot(root), '.harness', 'providers.json'); }
+function _readUserProviders(root) {
+  const p = _providersFile(root);
+  if (!exists(p)) return [];
+  try {
+    const j = JSON.parse(read(p));
+    return Array.isArray(j.providers) ? j.providers : [];
+  } catch { return []; }
+}
+function _writeUserProviders(root, providers) {
+  const p = _providersFile(root);
+  mkdirp(path.dirname(p));
+  writeUtf8(p, JSON.stringify({ schemaVersion: 1, providers }, null, 2) + '\n');
+}
+// 빌트인 + 사용자 정의 merge — 같은 id 가 있으면 user 가 빌트인 override
+function _allProviders(root) {
+  try {
+    const userList = _readUserProviders(root);
+    const builtinIds = new Set(EXTERNAL_AGENTS.map(a => a.id));
+    const userOverrides = new Map();
+    for (const u of userList) {
+      if (!u || !u.id) continue;
+      // 정상화 — 누락 필드는 빌트인에서 fallback
+      userOverrides.set(u.id, {
+        id: u.id,
+        bin: u.bin || u.id,
+        envFlag: u.envFlag || `LEERNESS_ENABLE_${String(u.id).toUpperCase()}`,
+        versionArgs: Array.isArray(u.versionArgs) ? u.versionArgs : ['--version'],
+        desc: u.desc || `(user) ${u.id}`,
+        installHint: u.installHint || '',
+        installCmd: u.installCmd || ''
+      });
+    }
+    // 빌트인 먼저, user override 적용
+    const merged = EXTERNAL_AGENTS.map(a => userOverrides.has(a.id) ? userOverrides.get(a.id) : a);
+    // 빌트인에 없는 user-only 추가
+    for (const u of userOverrides.values()) {
+      if (!builtinIds.has(u.id)) merged.push(u);
+    }
+    return merged;
+  } catch { return EXTERNAL_AGENTS.slice(); }
+}
+function providerCmd(root, sub, ...args) {
+  root = absRoot(root || process.cwd());
+  _loadEnvFile(root);
+  if (!sub || sub === 'list') {
+    const all = _allProviders(root);
+    const userList = _readUserProviders(root);
+    const userIds = new Set(userList.map(u => u.id));
+    if (has('--json')) {
+      log(JSON.stringify({
+        total: all.length,
+        builtin: EXTERNAL_AGENTS.length,
+        user: userList.length,
+        providers: all.map(p => ({ id: p.id, bin: p.bin, envFlag: p.envFlag, source: userIds.has(p.id) ? 'user' : 'builtin', desc: p.desc }))
+      }, null, 2));
+      return;
+    }
+    log(`# leerness provider list (1.9.157)`);
+    log(`총 ${all.length}개 (빌트인 ${EXTERNAL_AGENTS.length} + 사용자 ${userList.length})`);
+    log('');
+    log(`| id | source | bin | envFlag |`);
+    log(`|---|---|---|---|`);
+    for (const p of all) {
+      const src = userIds.has(p.id) ? (EXTERNAL_AGENTS.some(b => b.id === p.id) ? 'user(override)' : 'user') : 'builtin';
+      log(`| ${p.id} | ${src} | ${p.bin} | ${p.envFlag} |`);
+    }
+    if (!userList.length) {
+      log('');
+      log(`💡 사용자 정의 provider 추가: leerness provider add <id> --bin <cmd> [--env-flag F] [--version-args ARGS] [--desc D]`);
+    }
+    return;
+  }
+  if (sub === 'add') {
+    const id = (args[0] || arg('--id', '')).trim();
+    if (!id) return fail('provider add <id> 필요 (예: openrouter)');
+    if (!/^[a-z][a-z0-9_-]*$/i.test(id)) return fail(`잘못된 id: ${id} (영문자/숫자/_- 만 허용)`);
+    const bin = arg('--bin', id);
+    const envFlag = arg('--env-flag', `LEERNESS_ENABLE_${id.toUpperCase()}`);
+    const versionArgs = (arg('--version-args', '--version') || '--version').split(/\s+/).filter(Boolean);
+    const desc = arg('--desc', `(user) ${id}`);
+    const installHint = arg('--install-hint', '');
+    const userList = _readUserProviders(root);
+    // 중복 id 처리: 빌트인 override 또는 user 갱신
+    const existingIdx = userList.findIndex(u => u.id === id);
+    const entry = { id, bin, envFlag, versionArgs, desc, installHint };
+    if (existingIdx >= 0) userList[existingIdx] = entry;
+    else userList.push(entry);
+    _writeUserProviders(root, userList);
+    ok(`provider 등록: ${id} (bin=${bin}, envFlag=${envFlag})`);
+    log(`   → 활성화: .env에 ${envFlag}=1 설정 후 \`leerness agents list\` 로 확인`);
+    return;
+  }
+  if (sub === 'remove') {
+    const id = (args[0] || arg('--id', '')).trim();
+    if (!id) return fail('provider remove <id> 필요');
+    if (EXTERNAL_AGENTS.some(b => b.id === id) && !_readUserProviders(root).some(u => u.id === id)) {
+      return fail(`${id} 는 빌트인 — 제거 불가 (override 만 제거 가능)`);
+    }
+    const userList = _readUserProviders(root);
+    const before = userList.length;
+    const filtered = userList.filter(u => u.id !== id);
+    if (filtered.length === before) return fail(`사용자 정의 provider ${id} 없음`);
+    _writeUserProviders(root, filtered);
+    ok(`provider 제거: ${id}`);
+    return;
+  }
+  fail(`알 수 없는 sub: ${sub} (list / add / remove)`);
+}
+
 // 1.9.36: 작업 키워드 분석으로 최적 CLI 추천
 // \b는 ASCII word boundary만 인식 → 한글 키워드는 단순 substring 검사 사용.
 function _recommendAgent(task) {
@@ -5119,17 +5232,20 @@ function agentsCmd(root, sub, ...args) {
   _loadEnvFile(path.join(root, '..'));
 
   if (!sub || sub === 'list') {
-    const checks = EXTERNAL_AGENTS.map(a => _checkAgent(a));
+    // 1.9.157: Provider Registry 통합 — 빌트인 5종 + 사용자 정의 provider 포함
+    const providers = _allProviders(root);
+    const userIds = new Set(_readUserProviders(root).map(u => u.id));
+    const checks = providers.map(a => ({ ...(_checkAgent(a)), source: userIds.has(a.id) ? 'user' : 'builtin' }));
     if (has('--json')) { log(JSON.stringify({ agents: checks }, null, 2)); return; }
     log(`# 외부 AI CLI 오케스트레이션 (1.9.30)`);
     log('');
-    log(`| Agent | env (${'env=1 활성'}) | 설치 | 버전 | 상태 |`);
-    log(`|---|---|---|---|---|`);
+    log(`| Agent | source | env (${'env=1 활성'}) | 설치 | 버전 | 상태 |`);
+    log(`|---|---|---|---|---|---|`);
     for (const c of checks) {
       const envMark = c.enabled ? '✓' : '✗';
       const instMark = c.installed ? '✓' : '✗';
       const statusEmoji = c.status === 'ready' ? '🟢 ready' : c.status === 'not-installed' ? '⚪ 미설치' : c.status === 'disabled' ? '🟡 비활성' : '❓';
-      log(`| ${c.id} | ${envMark} ${c.envFlag} | ${instMark} | ${c.version || '-'} | ${statusEmoji} |`);
+      log(`| ${c.id} | ${c.source} | ${envMark} ${c.envFlag} | ${instMark} | ${c.version || '-'} | ${statusEmoji} |`);
     }
     const ready = checks.filter(c => c.status === 'ready');
     log('');
@@ -5140,6 +5256,7 @@ function agentsCmd(root, sub, ...args) {
       log(`  1) CLI 설치 (예: \`npm i -g @openai/codex-cli\`, \`npm i -g @google/gemini-cli\`)`);
       log(`  2) .env 또는 환경변수: LEERNESS_ENABLE_CODEX=1, LEERNESS_ENABLE_GEMINI=1`);
       log(`  3) \`leerness agents check\`로 재확인`);
+      log(`  💡 1.9.157: 빌트인 외 CLI 추가: \`leerness provider add <id> --bin <cmd>\``);
     } else {
       log('');
       log(`💡 메인 에이전트가 sub-agent 분배 시 위 ${ready.length}개 CLI 활용 가능:`);
@@ -5150,7 +5267,10 @@ function agentsCmd(root, sub, ...args) {
 
   if (sub === 'check') {
     // list의 alias, 단 명시적 재확인 (JSON 출력 기본)
-    const checks = EXTERNAL_AGENTS.map(a => _checkAgent(a));
+    // 1.9.157: Provider Registry 통합
+    const providers = _allProviders(root);
+    const userIds = new Set(_readUserProviders(root).map(u => u.id));
+    const checks = providers.map(a => ({ ...(_checkAgent(a)), source: userIds.has(a.id) ? 'user' : 'builtin' }));
     if (has('--json')) { log(JSON.stringify({ agents: checks, ready: checks.filter(c => c.status === 'ready').map(c => c.id) }, null, 2)); return; }
     return agentsCmd(root, 'list'); // 비-JSON은 list와 동일
   }
@@ -5162,6 +5282,7 @@ function agentsCmd(root, sub, ...args) {
     if (!task) { fail('multi "<task>" 또는 --task 필요'); return process.exit(1); }
     const onlyArg = arg('--only', null);  // 'claude,codex' 처럼 콤마 구분 — 활성 중에서 추가 필터
     const writeMode = has('--write');
+    const execute = has('--execute');  // 1.9.156: 명령 출력 → 실제 spawn + consensus 합의
     const checks = EXTERNAL_AGENTS.map(a => ({ def: a, status: _checkAgent(a) }));
     let ready = checks.filter(x => x.status.status === 'ready');
     if (onlyArg) {
@@ -5172,6 +5293,97 @@ function agentsCmd(root, sub, ...args) {
       fail('활성 (ready) 에이전트 없음 — `leerness agents list` 로 확인. 1.9.151 install 흐름에서 복수 선택 후 .env 활성화 필요.');
       return process.exit(1);
     }
+    // 1.9.156: --execute 모드 — 실제 spawn + 결과 수집 + multi-signal consensus
+    if (execute) {
+      return (async () => {
+        const timeout = parseInt(arg('--timeout', '60'), 10) * 1000;
+        if (!has('--json')) {
+          log(`# leerness agents multi --execute (1.9.156) — ${ready.length}개 활성 에이전트 병렬 호출`);
+          log(`task: ${task.slice(0, 120)}${task.length > 120 ? '…' : ''}`);
+          log(`mode: ${writeMode ? '✏ write' : '🔒 read-only'} · timeout=${timeout / 1000}s`);
+          log(`대상: ${ready.map(x => x.def.id).join(', ')}`);
+          log('');
+          log('## 병렬 호출 중...');
+        }
+        const t0 = Date.now();
+        // 병렬 _cliChat 호출 (sandbox 자동: runCommandSafe + env scrub + observability)
+        const results = await Promise.all(ready.map(async ({ def }) => {
+          const start = Date.now();
+          const r = await _cliChat(root, def.id, task, { timeout });
+          return {
+            agent: def.id,
+            elapsed: Date.now() - start,
+            ok: r.ok,
+            response: r.response || '',
+            error: r.error || null,
+            responseTokens: Math.ceil((r.response || '').length / 4)  // 대략 token 추정
+          };
+        }));
+        const totalElapsed = Date.now() - t0;
+        const ok = results.filter(r => r.ok);
+        const failures = results.filter(r => !r.ok);
+        _recordRun(root, { kind: 'agents_multi_execute', count: ready.length, success: ok.length, durationMs: totalElapsed, task: task.slice(0, 200) });
+        // 1.9.155 consensus 로직 재사용 — multi-signal scoring (tokens + overlap + lengthFit)
+        let best = null, scored = [];
+        if (ok.length) {
+          const tokenizer = (s) => new Set(String(s || '').toLowerCase().match(/[\w가-힣]{3,}/g) || []);
+          const wordsOf = ok.map(o => tokenizer(o.response));
+          const maxTokens = Math.max(...ok.map(o => o.responseTokens), 1);
+          const avgLen = ok.reduce((s, o) => s + o.response.length, 0) / ok.length;
+          const stdLen = Math.sqrt(ok.reduce((s, o) => s + (o.response.length - avgLen) ** 2, 0) / ok.length) || 1;
+          scored = ok.map((o, i) => {
+            const tokensNorm = o.responseTokens / maxTokens;
+            const myWords = wordsOf[i];
+            let overlapSum = 0;
+            for (let j = 0; j < wordsOf.length; j++) {
+              if (i === j) continue;
+              let inter = 0;
+              for (const w of myWords) if (wordsOf[j].has(w)) inter++;
+              overlapSum += inter / Math.max(myWords.size, 1);
+            }
+            const overlap = (ok.length > 1) ? overlapSum / (ok.length - 1) : 0;
+            const z = Math.abs((o.response.length - avgLen) / stdLen);
+            const lengthFit = z <= 1.5 ? (1 - z / 1.5) : 0;
+            const score = 0.4 * tokensNorm + 0.4 * overlap + 0.2 * lengthFit;
+            return { ...o, score, tokensNorm, overlap, lengthFit };
+          }).sort((a, b) => b.score - a.score);
+          best = scored[0];
+        }
+        if (has('--json')) {
+          log(JSON.stringify({
+            task, count: ready.length, success: ok.length, totalElapsedMs: totalElapsed,
+            results: scored.length ? scored : results,
+            best: best ? { agent: best.agent, score: best.score, response: best.response } : null,
+            failures
+          }, null, 2));
+          return;
+        }
+        log(`\n## 결과: ${ok.length}/${ready.length} 성공 · 총 ${totalElapsed}ms (병렬)`);
+        for (const r of results) {
+          if (r.ok) log(`  ✓ ${r.agent.padEnd(8)} · ${r.elapsed}ms · ${r.responseTokens} 토큰`);
+          else log(`  ✗ ${r.agent.padEnd(8)} · ${r.elapsed}ms · ${(r.error || '').slice(0, 60)}`);
+        }
+        if (best) {
+          log('');
+          log(`## 🏆 합의 선택 (multi-signal consensus, 1.9.155)`);
+          log(`  best: ${best.agent} · score=${best.score.toFixed(3)} (tokens=${best.tokensNorm.toFixed(2)} · overlap=${best.overlap.toFixed(2)} · lengthFit=${best.lengthFit.toFixed(2)})`);
+          if (scored.length > 1) {
+            log(`  others: ${scored.slice(1, 4).map(s => `${s.agent}=${s.score.toFixed(2)}`).join(', ')}`);
+          }
+          log(`  --- 처음 600자 ---`);
+          log(best.response.slice(0, 600));
+          // task-log 기록
+          try {
+            const tlp = taskLogPath(root);
+            const block = `\n## ${today()} agents multi --execute (1.9.156)\n- task: ${task.slice(0, 200)}\n- agents: ${ready.map(x => x.def.id).join(', ')}\n- success: ${ok.length}/${ready.length}\n- best: ${best.agent} (score=${best.score.toFixed(3)})\n`;
+            append(tlp, block);
+          } catch {}
+        }
+        if (failures.length && !best) {
+          process.exitCode = 1;
+        }
+      })();
+    }
     if (has('--json')) {
       log(JSON.stringify({
         task, count: ready.length,
@@ -5194,9 +5406,10 @@ function agentsCmd(root, sub, ...args) {
       log('```');
       log('');
     }
-    log('## 정책 (1.9.152)');
-    log(`  - leerness는 외부 CLI를 자동 호출하지 않음 (사용자/메인 에이전트가 명시적으로 실행)`);
-    log(`  - 메인 에이전트(Claude)가 위 ${ready.length}개 명령을 보고 ${ready.length}개 sub-agent로 spawn — 결과 합의/투표로 가장 안정적인 답 선택`);
+    log('## 정책 (1.9.152 / 1.9.156)');
+    log(`  - 기본 모드: 명령 문자열만 출력 (사용자/메인 에이전트가 명시적으로 실행)`);
+    log(`  - 1.9.156 신규: \`--execute\` 플래그 시 leerness가 직접 ${ready.length}개 sub-agent 병렬 spawn + multi-signal consensus 자동 합의`);
+    log(`     예: leerness agents multi "<task>" --execute  (또는 --execute --json)`);
     log(`  - 활성 에이전트 변경: \`.env\`에서 LEERNESS_ENABLE_<CLI>=1/0 또는 \`leerness setup-agents\` 재실행`);
     log(`  - quota 체크: \`leerness agents quota\``);
     return;
@@ -11479,7 +11692,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 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
+  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] [--execute] [--timeout 60]   # 1.9.152/156 활성 N개 일괄 dispatch (--execute: 실 spawn + consensus)\n  leerness provider list|add|remove [args]   # 1.9.157 Provider Registry — 사용자 정의 CLI provider 동적 추가 (OpenRouter/Bedrock 흡수)\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)
@@ -11551,6 +11764,8 @@ async function main() {
   if (cmd === 'persona') return personaCmd(arg('--path', process.cwd()), args[1], args[2]);
   if (cmd === 'review') return reviewCmd(arg('--path', process.cwd()), args[1]);
   if (cmd === 'agents') return agentsCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
+  // 1.9.157: Provider Registry — 사용자 정의 provider 동적 추가
+  if (cmd === 'provider') return providerCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   if (cmd === 'contract' && args[1] === 'verify') return contractVerifyCmd(args[2], args[3]);
   if (cmd === 'drift' && (args[1] === 'check' || !args[1])) return driftCheckCmd(args[2] || arg('--path', process.cwd()));
   if (cmd === 'usage' && (args[1] === 'stats' || !args[1])) return usageStatsCmd(args[2] || arg('--path', process.cwd()));

package/package.json

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