leerness 1.9.156 → 1.9.158

package/CHANGELOG.md

@@ -1,5 +1,93 @@
 # Changelog
 
+## 1.9.158 — 2026-05-20
+
+**🎉 MCP 48번째 도구 `leerness_provider_list` — Provider Registry 외부 AI 노출 마일스톤.**
+
+자율 모드 88 라운드. 1.9.157 Provider Registry CLI 의 자연스러운 후속 — MCP 노출.
+
+### Added — MCP `leerness_provider_list` (48번째 도구)
+- 외부 AI (Claude / Codex / Gemini 등) 가 MCP 통해 등록된 provider 전체 회수 가능
+- 응답 JSON: `{ total, builtin, user, providers: [{ id, bin, envFlag, source, desc }] }`
+- 빌트인 5종 (claude/codex/gemini/copilot/ollama) + `.harness/providers.json` 사용자 정의 통합
+- 외부 AI 활용 사례:
+  - 메인 에이전트가 sub-agent 분배 전 사용 가능한 provider 확인
+  - OpenRouter/Bedrock 등 등록되어 있으면 자동 발견
+  - sub-agent 가 "내가 사용 가능한 도구가 무엇인지" 자기-점검
+
+### MCP 도구 카운트 진화
+- 1.9.43 → 1.9.84 (READ 5종 완성): 17 도구
+- 1.9.85 → 1.9.110 (health + Memory CRUD): 30 도구 마일스톤
+- 1.9.112 → 1.9.119 (Memory READ 5종): 35 도구
+- 1.9.128 (DELETE/RESTORE 5종): 40 도구 마일스톤
+- 1.9.142 (Feature Graph): 45 도구
+- 1.9.145 (env detect): 47 도구
+- **1.9.158: 48 도구 🎉**
+
+### Pending — 1.9.158 권고 다음 후보
+- **1.9.159** — `leerness_provider_add` MCP 도구 (49번째) — 외부 AI 가 자가 확장 가능
+- **1.9.160** — `provider sync` (OpenRouter llms.txt 자동 동기화)
+- **1.9.161** — LSP 어댑터 MVP
+
+### Verified
+- e2e 217/217 ✓
+- stress-v103: 12/12 (MCP tools/list 48개 3종 + tools/call 실호출 2종 + 누적 회귀 7종) 🎉 **MCP 48 도구 마일스톤**
+- VERSION = 1.9.158 / autonomous-rounds = 88
+
+---
+
+## 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 보강).**

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.156-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v101-18%2F18-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-47-blue)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-86-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![multi-execute](https://img.shields.io/badge/agents_multi-real_spawn%2Bconsensus-success)]() [![multi-provider](https://img.shields.io/badge/REPL-5_providers%2Bmodel_catalog-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.158-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v103-12%2F12-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-48-blue)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-88-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![provider-registry](https://img.shields.io/badge/provider_registry-CLI%2BMCP-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.156  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.158  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.156';
+const VERSION = '1.9.158';
 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와 동일
   }
@@ -9621,7 +9741,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_feature_list', description: '1.9.141 — 전체 Feature Graph 노드 + 엣지 JSON. 외부 AI가 시스템 내 기능 의존성을 한 번에 회수', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_feature_add', description: '1.9.142 — Feature Graph 에 새 노드 추가 (외부 AI가 코드 작성 중 직접 feature 등록). 인자: { title (required), dependsOn?, affects?, coChangesWith?, files?, path? }. 자동 F-XXXX ID 부여. CRUD 완성에 기여', inputSchema: { type: 'object', properties: { title: { type: 'string' }, dependsOn: { type: 'string' }, affects: { type: 'string' }, coChangesWith: { type: 'string' }, files: { type: 'string' }, path: { type: 'string' } }, required: ['title'] } },
     { name: 'leerness_feature_link', description: '1.9.142 — 기존 feature 노드에 의존/영향/공변경 엣지 추가. 인자: { id (required, F-XXXX), dependsOn?, affects?, coChangesWith?, path? }. 외부 AI가 코드 변경 도중 발견한 인과관계를 즉시 그래프에 반영', inputSchema: { type: 'object', properties: { id: { type: 'string' }, dependsOn: { type: 'string' }, affects: { type: 'string' }, coChangesWith: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } },
-    { name: 'leerness_env_detect', description: '1.9.145 — 실행 환경 자동 감지 + 변동 추적 JSON ({ snapshot: { os, hardware, locale, shell, node, tools, scriptDependencies }, diff: { firstCapture, changes, missing }, persisted }). "X은(는) 내부 또는 외부 명령... 아닙니다" 사전 방지: package.json scripts 의존 도구가 PATH에 있는지 검증 + 머신/Node/도구 변경 감지. 절대경로 마스킹 (보안). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
+    { name: 'leerness_env_detect', description: '1.9.145 — 실행 환경 자동 감지 + 변동 추적 JSON ({ snapshot: { os, hardware, locale, shell, node, tools, scriptDependencies }, diff: { firstCapture, changes, missing }, persisted }). "X은(는) 내부 또는 외부 명령... 아닙니다" 사전 방지: package.json scripts 의존 도구가 PATH에 있는지 검증 + 머신/Node/도구 변경 감지. 절대경로 마스킹 (보안). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
+    { name: 'leerness_provider_list', description: '1.9.157/158 — Provider Registry 조회 JSON ({ total, builtin, user, providers: [{ id, bin, envFlag, source, desc }] }). 빌트인 5종 (claude/codex/gemini/copilot/ollama) + .harness/providers.json 사용자 정의 통합. 외부 AI가 sub-agent 분배 가능한 provider 전체 회수 (OpenRouter/Bedrock 등 등록되어 있으면 같이 노출). 🎉 MCP 48 도구 마일스톤', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
   ];
 
   function send(obj) {
@@ -9714,6 +9835,8 @@ function mcpServeCmd(root) {
             break;
           // 1.9.145: 실행 환경 자동 감지
           case 'leerness_env_detect': cliArgs = ['env', 'detect', targetPath, '--json']; break;
+          // 1.9.158: Provider Registry — 외부 AI 가 등록된 provider 회수
+          case 'leerness_provider_list': cliArgs = ['provider', 'list', '--path', targetPath, '--json']; break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -11572,7 +11695,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] [--execute] [--timeout 60]   # 1.9.152/156 활성 N개 일괄 dispatch (--execute: 실 spawn + consensus)\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)
@@ -11644,6 +11767,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.156",
+  "version": "1.9.158",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",