leerness 1.9.246 → 1.9.248

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # Changelog
 
+## 1.9.248 — 2026-05-26 — UR-0017 Gemini CLI 제거 + Antigravity CLI (agy) 도입
+
+**🔄 사용자 명시 (UR-0017): Gemini CLI 제거 + Antigravity (agy) CLI 전체 교체.**
+
+### 변경 범위 (65 occurrences case-insensitive)
+- **EXTERNAL_AGENTS**: `gemini` → `agy` (bin/envFlag/install 안내 모두 교체)
+- **_PROVIDER_CYCLE_ORDER**: `['ollama', 'claude', 'codex', 'agy', 'copilot']` (Tab cycle)
+- **_PROVIDER_MODEL_CATALOG.agy**: `antigravity-pro/flash/experimental` 모델 (1M+ context)
+- **환경변수**: `LEERNESS_ENABLE_GEMINI` → `LEERNESS_ENABLE_AGY`
+- **CLI bin**: `gemini -p` → `agy -p` (1-shot + REPL stream + dispatch)
+- **agents dispatch --write**: `gemini --yolo` → `agy --yolo`
+- **setup-agents UI**: "Gemini (gemini CLI)" → "Antigravity (agy CLI)"
+- **handoff body sub-agent display** (1.9.246 status bar): allAgents = ['claude', 'codex', 'agy', 'copilot']
+- **MCP description**: agents_list / provider_list 등 5종 → agy 명시
+- **REPL :provider validation**: validProviders = ['ollama', 'claude', 'codex', 'agy', 'copilot']
+- **.harness/leerness-config.json**: LEERNESS_ENABLE_AGY 기본값 "0"
+- **scripts/e2e.js**: 회귀 테스트 — agents quota/dispatch/list/register-pending 모두 agy
+- **install hint**: `npm i -g @google/antigravity-cli` (https://antigravity.google.com)
+
+### 영향 받지 않은 영역
+- 1.9.247 multi-provider fallback (agy 도 자동 fallback 대상)
+- 1.9.246 status bar (agy 5종 한 줄 표시)
+- handoff JSON 11 필드 (apiSkills/envInfo 등) 유지
+
+### stress-v193 — **23/23 PASS · 100%**
+- 1.9.248 (12): VERSION + EXTERNAL_AGENTS 교체 + 모델 catalog + Tab cycle + setup-agents UI + handoff status bar + dispatch + quota + list + config.json + validation + nonsecret keys
+- 성능 (1): cold start avg 419ms
+- 누적 회귀 (10): 1.9.207~247
+
+### 자동 release (110 main-push streak · 71 npm publish streak · R204)
+
+🔄 **Gemini CLI 단계적 제거 → Antigravity (agy) 전환** — 사용자 환경 변화 즉시 반영
+
+---
+
+## 1.9.247 — 2026-05-26 — UR-0016 2단계 + UR-0015 2단계
+
+**🔁 REPL multi-provider auto-fallback + 📚 api-skill audit 통합.**
+
+### 1. UR-0016 2단계 — REPL multi-provider auto-fallback
+사용자 보고 (1.9.246 스크린샷): `codex CLI 응답 실패 (exit=null)` → 멀티 provider auto-fallback 검토.
+
+**구현:**
+- `state.autoFallback` 필드 추가 (default OFF — opt-in)
+- 활성화: `:fallback on` (REPL slash) 또는 `LEERNESS_REPL_AUTO_FALLBACK=1` env
+- transient 실패 (`exit=null|timeout`) 감지 시 next ready agent 로 자동 전환 + 재시도 1회
+- 응답 헤더: `↪ auto-fallback (1.9.247): codex 실패 → claude 자동 전환 + 재시도 중...`
+- 성공 시 `✓ fallback 성공 [claude/...]`, 실패 시 친절한 진단 + 수동 :provider 안내
+
+### 2. UR-0015 2단계 — api-skill audit 통합
+사용자 명시 (UR-0015): *"AI가 정리해둔 파일이 참조되는지 확인"*
+
+**구현:**
+- `audit` 명령에 새 finding 추가: `api_skill_missing`
+- 현재 in-progress task 의 request/nextAction/evidence 에 API 키워드 (`API|endpoint|REST|GraphQL|OAuth|webhook|http[s]?://`) 감지
+- 매칭되는 api-skill 0건 → `warn` + `leerness api-skill add <url> --direction "..."` 안내
+- 매칭 1+건 → `✓ API skill 매칭 OK (현재 task → N건)` 로그
+- non-API task 는 영향 없음
+
+### 3. 누적 회귀 (1.9.207~246) — 모두 유지
+- REPL UX status bar (1.9.246) · api-skill cache (1.9.245) · _lastCycleLines HOTFIX (1.9.244)
+- CJK 분류 (1.9.243) · env encoding --apply (1.9.242) · 모두 유지
+- handoff JSON 11 필드 · MCP 70 도구 · agents dispatch 거부 회귀 (1.9.246 flake 방지) 검증
+
+### 4. stress-v192 — **20/20 PASS · 100%**
+- 1.9.247 (8): VERSION + autoFallback state + :fallback slash + 재시도 로직 + audit api_skill_missing + 실제 동작 (3 시나리오)
+- 성능 (1): cold start avg 588ms
+- 누적 회귀 (11): 1.9.207~246 + 보안 + e2e flake 방지
+
+### 5. 자동 release (109 main-push streak · 70 npm publish streak · R203)
+
+🔁 **사용자 실 환경 대응 보강** — 1.9.246 보고된 codex CLI exit=null 케이스 자동 회복 + 후속 API task UR-0015 자동 참조 확인.
+
+---
+
 ## 1.9.246 — 2026-05-26 — UR-0016 REPL UX/UI 개선
 
 **🎯 사용자 명시 (UR-0016): REPL agent 채팅 입력칸 옆 컨텍스트 게이지 + 서브 에이전트 가시화 + 정상 완료 초록색 강조.**

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.246-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v191-23%2F23-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-70-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-57-brightgreen)]() [![json-fields](https://img.shields.io/badge/JSON_통합-11_필드-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous_R-202-blueviolet)]() [![main-push](https://img.shields.io/badge/🎉_main--push_streak-108_rounds-success)]() [![npm-streak](https://img.shields.io/badge/🎉_npm--publish-69_streak-success)]() [![repl-ux](https://img.shields.io/badge/🎯_REPL_UX-status_bar-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-378ms-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.248-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v193-23%2F23-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-70-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-57-brightgreen)]() [![json-fields](https://img.shields.io/badge/JSON_통합-11_필드-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous_R-204-blueviolet)]() [![main-push](https://img.shields.io/badge/🎉_main--push_streak-110_rounds-success)]() [![npm-streak](https://img.shields.io/badge/🎉_npm--publish-71_streak-success)]() [![agy](https://img.shields.io/badge/🔄_Gemini→Antigravity-agy_CLI-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-419ms-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.246  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.248  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🎯 REPL UX (UR-0016) — 컨텍스트 게이지 + 에이전트 + 초록색 ✓ ║
+  ║  🔄 Gemini CLI 제거 → Antigravity (agy) CLI 도입 (UR-0017)    ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

package/bin/harness.js

@@ -7,7 +7,7 @@ const cp = require('child_process');
 const os = require('os');  // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
 const readline = require('readline');
 
-const VERSION = '1.9.246';
+const VERSION = '1.9.248';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -410,7 +410,7 @@ leerness agents dispatch "<task>" --to <id>   # 작업 유형 추천 자동
 - 작업 유형별 최적 sub-agent:
   - 텍스트/번역/분석 → claude (1.7× 빠름)
   - 깊은 코드 추론 → codex (가장 상세)
-  - 파일 직접 수정 → gemini --yolo (정확)
+  - 파일 직접 수정 → agy --yolo (정확, Antigravity CLI 1.9.248)
   - 보안 리뷰 → \`leerness review --persona security\`
 - **충돌 방지 규칙 (필수)**:
   - 각 sub-agent에 *자신만 수정할 파일 경로* 명시
@@ -798,20 +798,20 @@ async function resolveInstallOptions(root, opts = {}) {
       const picked = await _selectMany(_t('install.agents.title', _agLang), [
         { label: 'Claude (ANTHROPIC_API_KEY 또는 claude CLI)', description: '추론력 최고 — 코드 작성/리뷰 기본', id: 'claude' },
         { label: 'Codex (OpenAI codex CLI)', description: 'OpenAI 코드 모델', id: 'codex' },
-        { label: 'Gemini (gemini CLI)', description: 'Google 멀티모달 모델', id: 'gemini' },
+        { label: 'Antigravity (agy CLI)', description: 'Google Antigravity 멀티모달 에이전트 (1.9.248~)', id: 'agy' },
         { label: 'Copilot (gh extension)', description: 'GitHub Copilot CLI', id: 'copilot' },
         { label: 'Ollama (로컬 LLM — llama3/qwen 등)', description: 'http://localhost:11434 — 무료/오프라인', id: 'ollama' }
       ], { defaults: [] });
       agentsOptIn = picked.length ? picked.map(p => p.id) : 'none';
     } else {
       log('\nCLI 에이전트 활성화 (복수 선택 — 콤마로 구분, opt-in):');
-      log('  1) claude  2) codex  3) gemini  4) copilot  5) ollama  (예: 1,5 또는 all 또는 none)');
+      log('  1) claude  2) codex  3) agy (Antigravity)  4) copilot  5) ollama  (예: 1,5 또는 all 또는 none)');
       const a = (await ask('선택 [none]: ')).trim().toLowerCase();
-      if (a === 'all') agentsOptIn = ['claude', 'codex', 'gemini', 'copilot', 'ollama'];
+      if (a === 'all') agentsOptIn = ['claude', 'codex', 'agy', 'copilot', 'ollama'];
       else if (!a || a === 'none' || a === '0') agentsOptIn = 'none';
       else {
-        const map = { '1': 'claude', '2': 'codex', '3': 'gemini', '4': 'copilot', '5': 'ollama' };
-        const picks = a.split(/[,\s]+/).map(t => map[t] || (['claude','codex','gemini','copilot','ollama'].includes(t) ? t : null)).filter(Boolean);
+        const map = { '1': 'claude', '2': 'codex', '3': 'agy', '4': 'copilot', '5': 'ollama' };
+        const picks = a.split(/[,\s]+/).map(t => map[t] || (['claude','codex','agy','copilot','ollama'].includes(t) ? t : null)).filter(Boolean);
         agentsOptIn = picks.length ? picks : 'none';
       }
     }
@@ -951,7 +951,7 @@ async function install(root, opts = {}) {
     const a = resolved.agentsOptIn || 'none';
     const enabledSet = (() => {
       if (Array.isArray(a)) return new Set(a);
-      if (a === 'all') return new Set(['claude', 'codex', 'gemini', 'copilot', 'ollama']);
+      if (a === 'all') return new Set(['claude', 'codex', 'agy', 'copilot', 'ollama']);
       if (a === 'none' || !a) return new Set();
       return new Set([a]);  // back-compat: 단일 문자열
     })();
@@ -983,7 +983,7 @@ async function install(root, opts = {}) {
         LEERNESS_OLLAMA_MODEL: '',
         LEERNESS_ENABLE_CLAUDE: enable('claude') ? '1' : '0',
         LEERNESS_ENABLE_CODEX: enable('codex') ? '1' : '0',
-        LEERNESS_ENABLE_GEMINI: enable('gemini') ? '1' : '0',
+        LEERNESS_ENABLE_AGY: enable('agy') ? '1' : '0',
         LEERNESS_ENABLE_COPILOT: enable('copilot') ? '1' : '0',
         LEERNESS_ENABLE_OLLAMA: enable('ollama') ? '1' : '0',
         LEERNESS_SKILL_DISCOVER_URL: '',
@@ -6491,6 +6491,35 @@ function audit(root, opts = {}) {
       }
     } catch {}
   }
+  // 1.9.247 (UR-0015 2단계): api-skill 참조 audit — API 관련 task 인데 .harness/api-skills/ 미참조 시 경고
+  //   사용자 명시 (UR-0015): "AI가 정리해둔 파일이 참조되는지 확인"
+  //   현재 in-progress task 의 request/nextAction 에 API 키워드 (URL, "API", "endpoint", "REST", "GraphQL", "OAuth", "webhook") 있는데
+  //   _matchAPISkills() 결과가 0 이면 → 경고 + leerness api-skill add <url> 안내
+  try {
+    const rows = readProgressRows(root);
+    const ip = rows.find(r => r.status === 'in-progress');
+    if (ip) {
+      const taskText = (ip.request || '') + ' ' + (ip.nextAction || '') + ' ' + (ip.evidence || '');
+      const apiKeywords = /\bAPI\b|endpoint|REST|GraphQL|OAuth|webhook|https?:\/\/[^\s]+/i;
+      if (apiKeywords.test(taskText)) {
+        const matched = _matchAPISkills(root, taskText);
+        const allSkills = _listAPISkills(root);
+        if (matched.length === 0) {
+          warnings++;
+          warn(`API 관련 task 감지 (현재: "${(ip.request || '').slice(0, 60)}") — .harness/api-skills/ 매칭 0건 (저장 ${allSkills.length})`);
+          warn(`  → leerness api-skill add <url> --direction "구현 방향" 으로 정리 권장 (1.9.245 UR-0015 / 1.9.247 audit)`);
+          _finding('api_skill_missing', 'warn', 'API 관련 task 인데 .harness/api-skills/ 매칭 없음', {
+            taskRequest: (ip.request || '').slice(0, 100),
+            apiSkillsTotal: allSkills.length,
+            matched: 0,
+            hint: 'leerness api-skill add <url> --direction "..."'
+          });
+        } else {
+          ok(`API skill 매칭 OK (현재 task → ${matched.length}건 매칭 in .harness/api-skills/, 1.9.247 UR-0015 2단계)`);
+        }
+      }
+    }
+  } catch {}
   // 1.9.63: --strict — warnings ≥ threshold 시 failures로 승격 (CI 친화)
   if (has('--strict')) {
     const threshold = parseInt(arg('--threshold', '1'), 10);
@@ -8779,7 +8808,7 @@ const _LEERNESS_NONSECRET_KEYS = new Set([
   'LEERNESS_OLLAMA_MODEL',       // 모델 이름 — 비밀 X
   'LEERNESS_ENABLE_CLAUDE',      // 활성화 플래그
   'LEERNESS_ENABLE_CODEX',
-  'LEERNESS_ENABLE_GEMINI',
+  'LEERNESS_ENABLE_AGY',
   'LEERNESS_ENABLE_COPILOT',
   'LEERNESS_ENABLE_OLLAMA',
   'LEERNESS_SKILL_DISCOVER_URL', // 공개 URL
@@ -9423,7 +9452,7 @@ function _resolvePersona(root, id) {
   return null;
 }
 
-// 1.9.30: 외부 AI CLI 오케스트레이션 — claude/codex/gemini/copilot 가용성 + 활성화 체크
+// 1.9.30: 외부 AI CLI 오케스트레이션 — claude/codex/agy/copilot 가용성 + 활성화 체크
 // 사용자 정책: 환경변수로 활성화 명시 + 실제 PATH 존재 확인 + 메인이 sub-agent 분배 시 참조
 // 1.9.32: installCmd 추가 — setup-agents 시 자동 설치 시도 가능
 const EXTERNAL_AGENTS = [
@@ -9431,8 +9460,11 @@ const EXTERNAL_AGENTS = [
     installCmd: 'npm i -g @anthropic-ai/claude-code', installHint: 'https://docs.anthropic.com/en/docs/claude-code/setup' },
   { id: 'codex',   bin: 'codex',   envFlag: 'LEERNESS_ENABLE_CODEX',   versionArgs: ['--version'], desc: 'OpenAI Codex CLI (격리 sandbox)',
     installCmd: 'npm i -g @openai/codex', installHint: 'https://github.com/openai/codex' },
-  { id: 'gemini',  bin: 'gemini',  envFlag: 'LEERNESS_ENABLE_GEMINI',  versionArgs: ['--version'], desc: 'Google Gemini CLI (--yolo 모드 워크스페이스 직접 수정 가능)',
-    installCmd: 'npm i -g @google/gemini-cli', installHint: 'https://github.com/google-gemini/gemini-cli' },
+  // 1.9.248 (사용자 명시 UR-0017): Gemini CLI 제거 + Antigravity CLI (agy 명령어) 교체
+  //   Google Antigravity 는 IDE 기반 멀티 모달 에이전트 도구. agy CLI 는 워크스페이스 직접 수정 가능 모드 지원.
+  //   기존 LEERNESS_ENABLE_AGY 환경변수는 LEERNESS_ENABLE_AGY 로 교체. provider id 도 'agy' 로 통일.
+  { id: 'agy',     bin: 'agy',     envFlag: 'LEERNESS_ENABLE_AGY',     versionArgs: ['--version'], desc: 'Google Antigravity CLI (멀티모달 에이전트, --yolo 워크스페이스 수정 가능)',
+    installCmd: 'npm i -g @google/antigravity-cli', installHint: 'https://antigravity.google.com (Antigravity IDE/CLI)' },
   { id: 'copilot', bin: 'gh',      envFlag: 'LEERNESS_ENABLE_COPILOT', versionArgs: ['copilot', '--version'], desc: 'GitHub Copilot CLI (gh copilot)',
     installCmd: 'gh extension install github/gh-copilot', installHint: 'https://github.com/github/gh-copilot (gh CLI 선행 설치 필요)' },
   // 1.9.146: Ollama 추가 (사용자 명시 요청 #3) — 로컬 LLM, HTTP API 11434
@@ -9639,7 +9671,7 @@ function providerCmd(root, sub, ...args) {
   // 1.9.195: provider probe — A축 (범용 AI 하네스) 보강. 사용자 의도: "범용 AI 하네스 ... 최고의 도구"
   //   시스템에 사용 가능한 provider 자동 감지 (PATH 명령 + 로컬 endpoint + API 키 환경변수)
   //   감지 대상:
-  //     - CLI: claude / codex / gemini / copilot / ollama (PATH check)
+  //     - CLI: claude / codex / agy / copilot / ollama (PATH check)
   //     - Local endpoint: Ollama (11434) / LM Studio (1234) / llama.cpp server (8080)
   //     - Cloud API key: OPENROUTER_API_KEY / GROQ_API_KEY / TOGETHER_API_KEY / ANTHROPIC_API_KEY / OPENAI_API_KEY
   //   결과 → table + LEERNESS_ENABLE_* 설정 권장
@@ -9692,7 +9724,7 @@ async function _probeProviderEndpoints(root, timeoutMs) {
   const cliTargets = [
     { id: 'claude', bin: 'claude' },
     { id: 'codex', bin: 'codex' },
-    { id: 'gemini', bin: 'gemini' },
+    { id: 'agy', bin: 'agy' },
     { id: 'copilot', bin: 'copilot' },
     { id: 'ollama', bin: 'ollama' }
   ];
@@ -9801,7 +9833,7 @@ function _recommendAgent(task) {
   // 파일 작성·수정·생성
   if (hasAny(['create', 'write', 'generate', 'patch', 'fix', 'implement', 'edit',
               '구현', '생성', '작성', '수정', '추가'])) {
-    return { target: 'gemini', reason: '워크스페이스 직접 수정은 gemini --yolo가 정확' };
+    return { target: 'agy', reason: '워크스페이스 직접 수정은 agy --yolo (Antigravity) 가 정확' };
   }
   return { target: null, reason: '' };
 }
@@ -10317,7 +10349,7 @@ 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 === 'agy') return `agy ${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}: 명령 빌더 미정의`;
@@ -10351,8 +10383,8 @@ function agentsCmd(root, sub, ...args) {
     if (!ready.length) {
       log('');
       log(`💡 활성화 방법:`);
-      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(`  1) CLI 설치 (예: \`npm i -g @openai/codex-cli\`, \`npm i -g @google/antigravity-cli\`)`);
+      log(`  2) .env 또는 환경변수: LEERNESS_ENABLE_CODEX=1, LEERNESS_ENABLE_AGY=1`);
       log(`  3) \`leerness agents check\`로 재확인`);
       log(`  💡 1.9.157: 빌트인 외 CLI 추가: \`leerness provider add <id> --bin <cmd>\``);
     } else {
@@ -10535,7 +10567,7 @@ function agentsCmd(root, sub, ...args) {
     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); }
+    if (!target) { fail('--to <agent_id> 필요 (claude/codex/agy/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 체크 전에 출력 — 비활성이어도 추천)
@@ -10570,9 +10602,9 @@ function agentsCmd(root, sub, ...args) {
       log(`codex ${flags} "${q}"`);
       log(`# ℹ codex는 PowerShell 경유 — POSIX /tmp 경로는 C:\\tmp\\로 해석됨`);
       if (writeMode) log(`# ⚠ --dangerously-bypass-approvals-and-sandbox: sandbox 우회`);
-    } else if (target === 'gemini') {
+    } else if (target === 'agy') {
       const flags = writeMode ? '-p --yolo' : '-p';
-      log(`gemini ${flags} "${q}"`);
+      log(`agy ${flags} "${q}"`);
       if (writeMode) log(`# ⚠ --yolo: 워크스페이스 파일 직접 수정 가능`);
     } else if (target === 'copilot') {
       log(`gh copilot suggest "${q}"`);
@@ -10623,9 +10655,9 @@ function agentsCmd(root, sub, ...args) {
           ? ['exec', '--skip-git-repo-check', '--dangerously-bypass-approvals-and-sandbox', task]
           : ['exec', '--skip-git-repo-check', task];
         cmd = 'codex';
-      } else if (agent.id === 'gemini') {
+      } else if (agent.id === 'agy') {
         cmdArgs = writeMode ? ['-p', task, '--yolo'] : ['-p', task];
-        cmd = 'gemini';
+        cmd = 'agy';
       } else if (agent.id === 'copilot') {
         cmdArgs = ['copilot', 'suggest', task];
         cmd = 'gh';
@@ -10699,10 +10731,10 @@ function agentsCmd(root, sub, ...args) {
             out.hint = 'https://platform.openai.com/account/usage 확인';
           }
           out.raw = help.slice(0, 200);
-        } else if (agent.id === 'gemini') {
-          // gemini CLI: 무료 티어는 분당 60req 제한, CLI 자체에선 노출 안 됨
+        } else if (agent.id === 'agy') {
+          // agy CLI (Antigravity): 무료 티어는 분당 60req 제한, CLI 자체에선 노출 안 됨
           out.quota = 'rate-limited';
-          out.hint = '무료 티어: 60 req/min, 1000 req/day · 유료는 https://ai.google.dev/gemini-api/docs/rate-limits';
+          out.hint = '무료 티어: 60 req/min, 1000 req/day · Antigravity 유료 플랜은 https://antigravity.google.com';
         } else if (agent.id === 'copilot') {
           // gh copilot은 GitHub Copilot 구독 (월 단위 quota 없음, individual/business 플랜)
           const r = cp.spawnSync('gh', ['auth', 'status'], { encoding: 'utf8', timeout: 4000, shell: true });
@@ -10844,13 +10876,13 @@ function reviewCmd(root, target) {
 }
 
 // 1.9.25: register-pending — sub-agent/외부 모델이 작업 시작 즉시 progress-tracker에 in-progress 등록
-// 사용 예: leerness register-pending "<요청 내용>" --agent gemini
+// 사용 예: leerness register-pending "<요청 내용>" --agent agy
 //   → 다음 T-ID 자동 할당, status=in-progress, evidence="(pending) by <agent>"
 //   → 다른 세션이 즉시 발견 가능 (모순 감지)
 function registerPendingCmd(root, requestParts) {
   root = absRoot(root || process.cwd());
   const request = (requestParts || []).join(' ').trim();
-  if (!request) { fail('register-pending "<요청>" 필요. 예: leerness register-pending "toJson 함수 추가" --agent gemini'); return process.exit(1); }
+  if (!request) { fail('register-pending "<요청>" 필요. 예: leerness register-pending "toJson 함수 추가" --agent agy'); return process.exit(1); }
   const agent = arg('--agent', 'unknown');
   const note = arg('--note', '');
 
@@ -14923,7 +14955,7 @@ async function _benchmarkMeasure(root, task) {
     let cmd, cliArgs;
     if (agent.id === 'claude') { cmd = 'claude'; cliArgs = ['--print', task]; }
     else if (agent.id === 'codex') { cmd = 'codex'; cliArgs = ['exec', '--skip-git-repo-check', task]; }
-    else if (agent.id === 'gemini') { cmd = 'gemini'; cliArgs = ['-p', task]; }
+    else if (agent.id === 'agy') { cmd = 'agy'; cliArgs = ['-p', task]; }
     else continue;
     const t0 = Date.now();
     // 1.9.150: runCommandSafe — agent CLI bench sandbox (env scrub + observability)
@@ -15399,7 +15431,7 @@ function mcpServeCmd(root) {
     { name: 'leerness_audit', description: '1.9.102 — 워크스페이스 일관성 감사 JSON (warnings/failures/fixed/healthy + findings[]. kind 11종: design_dup/design_system_default/reuse_map_empty/milestone_unlinked/handoff_not_generated/current_state_stale/readme_version_mismatch/npm_cve/gitignore_missing_secrets/env_keys_missing/strict_promoted)', inputSchema: { type: 'object', properties: { path: { type: 'string' }, fix: { type: 'boolean' }, strict: { type: 'boolean' } } } },
     { name: 'leerness_verify_claim', description: 'AI 거짓 완료 자동 검증 (evidence 파일 + 실 테스트 실행)', inputSchema: { type: 'object', properties: { taskId: { type: 'string' }, path: { type: 'string' }, runTests: { type: 'boolean' }, strictClaims: { type: 'boolean' } }, required: ['taskId'] } },
     { name: 'leerness_contract_verify', description: '명세 ↔ 구현 함수/필드 일치 자동 검사', inputSchema: { type: 'object', properties: { spec: { type: 'string' }, impl: { type: 'string' } }, required: ['spec', 'impl'] } },
-    { name: 'leerness_agents_list', description: '외부 AI CLI 가용성 표 (claude/codex/gemini/copilot 상태 + 환경변수 활성화 여부)', inputSchema: { type: 'object', properties: {} } },
+    { name: 'leerness_agents_list', description: '외부 AI CLI 가용성 표 (claude/codex/agy/copilot 상태 + 환경변수 활성화 여부)', inputSchema: { type: 'object', properties: {} } },
     { name: 'leerness_reuse_map', description: '워크스페이스 중복 함수/capability 자동 감지 (--all-apps + fuzzy 매칭)', inputSchema: { type: 'object', properties: { path: { type: 'string' }, allApps: { type: 'boolean' }, strictElements: { type: 'boolean' } } } },
     { name: 'leerness_whats_new', description: 'CHANGELOG 차분 자동 추출 (from → to 사이 신규 명령/플래그/파일)', inputSchema: { type: 'object', properties: { from: { type: 'string' }, to: { type: 'string' } } } },
     { name: 'leerness_usage_stats', description: 'leerness 명령별 누적 호출 통계 + drift 통계', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
@@ -15441,7 +15473,7 @@ function mcpServeCmd(root) {
     { 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_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' } } } },
+    { name: 'leerness_provider_list', description: '1.9.157/158 — Provider Registry 조회 JSON ({ total, builtin, user, providers: [{ id, bin, envFlag, source, desc }] }). 빌트인 5종 (claude/codex/agy/copilot/ollama) + .harness/providers.json 사용자 정의 통합. 외부 AI가 sub-agent 분배 가능한 provider 전체 회수 (OpenRouter/Bedrock 등 등록되어 있으면 같이 노출). 🎉 MCP 48 도구 마일스톤', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_provider_add', description: '1.9.159 — Provider Registry 에 새 provider 동적 추가. 인자: { id (required), bin?, envFlag?, versionArgs?, desc?, path? }. 외부 AI가 새 CLI 발견 시 자가 확장 (OpenRouter / Bedrock / Groq / Hugging Face 등 등록). 같은 id 두 번 호출 → 갱신. 빌트인 id 호출 → user override. id 는 영문자/숫자/_- 만 허용.', inputSchema: { type: 'object', properties: { id: { type: 'string' }, bin: { type: 'string' }, envFlag: { type: 'string' }, versionArgs: { type: 'string' }, desc: { type: 'string' }, installHint: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } },
     { name: 'leerness_provider_remove', description: '1.9.159 — Provider Registry 에서 사용자 정의 provider 제거. 인자: { id (required), path? }. 빌트인 5종 id 는 제거 불가 (override 만 제거 가능). 🎉 MCP 50 도구 마일스톤 — Provider Registry CRUD MCP 완성 (list/add/remove)', inputSchema: { type: 'object', properties: { id: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } },
     { name: 'leerness_web', description: '1.9.168 — Web Bridge (1.9.165 playwright opt-in). sub: check (설치 + permissions.browser 확인) | screenshot (URL → PNG) | extract (URL + CSS selector → DOM 텍스트). 외부 AI가 leerness 의 웹 자동화 능력을 직접 호출. playwright 미설치 시 친절 안내 (graceful). 인자: { sub (required), url?, out?, selector?, path? }', inputSchema: { type: 'object', properties: { sub: { type: 'string', enum: ['check', 'screenshot', 'extract'] }, url: { type: 'string' }, out: { type: 'string' }, selector: { type: 'string' }, path: { type: 'string' } }, required: ['sub'] } },
@@ -16134,13 +16166,13 @@ function permissionCheck(root, action, target) {
 }
 
 // ===== 1.9.146: leerness agent — OpenClaw/Hermes 스타일 오픈소스 CLI 에이전트 모드 (사용자 명시 요청 #4) =====
-// MVP: handoff 컨텍스트 자동 로드 → 활성 CLI (claude/codex/gemini/ollama) 1개에 작업 위임.
+// MVP: handoff 컨텍스트 자동 로드 → 활성 CLI (claude/codex/agy/ollama) 1개에 작업 위임.
 // 권한은 .harness/agent-permissions.json 기준. 실제 LLM 호출은 외부 CLI 또는 Ollama HTTP API.
 function _activeCliAgents() {
   const out = [];
   if (process.env.LEERNESS_ENABLE_CLAUDE === '1') out.push('claude');
   if (process.env.LEERNESS_ENABLE_CODEX === '1') out.push('codex');
-  if (process.env.LEERNESS_ENABLE_GEMINI === '1') out.push('gemini');
+  if (process.env.LEERNESS_ENABLE_AGY === '1') out.push('agy');
   if (process.env.LEERNESS_ENABLE_COPILOT === '1') out.push('copilot');
   if (process.env.LEERNESS_ENABLE_OLLAMA === '1') out.push('ollama');
   return out;
@@ -16196,7 +16228,7 @@ async function _ollamaListModels() {
 }
 
 // 1.9.153: 외부 CLI 채팅 호출 (multi-provider REPL — 사용자 명시 요청)
-//   claude/codex/gemini/copilot 를 child_process 로 호출 후 stdout 캡처.
+//   claude/codex/agy/copilot 를 child_process 로 호출 후 stdout 캡처.
 //   runCommandSafe 경유 — env scrub + permissions + observability 자동 적용.
 async function _cliChat(root, provider, prompt, opts) {
   opts = opts || {};
@@ -16211,7 +16243,7 @@ async function _cliChat(root, provider, prompt, opts) {
   let cmd, args, stdinInput = null;
   if (provider === 'claude')  { cmd = 'claude'; args = ['--print']; stdinInput = prompt; }
   else if (provider === 'codex')   { cmd = 'codex';  args = ['exec', '--skip-git-repo-check', '-']; stdinInput = prompt; }
-  else if (provider === 'gemini')  { cmd = 'gemini'; args = ['-p', prompt]; }  // gemini 는 인자 only
+  else if (provider === 'agy')  { cmd = 'agy'; args = ['-p', prompt]; }  // agy (Antigravity) 는 인자 only
   else if (provider === 'copilot') { cmd = 'gh';     args = ['copilot', 'suggest', prompt]; }
   else return { ok: false, error: `provider ${provider} 미지원`, provider };
   // runCommandSafe — env scrub + observability 자동
@@ -16267,7 +16299,7 @@ async function _cliChatStream(root, provider, promptText, opts) {
     args = ['exec', '--skip-git-repo-check', '-'];  // - = stdin from claude/codex convention
     useStdinForPrompt = true;
   }
-  else if (provider === 'gemini')  { cmd = 'gemini'; args = ['-p', promptText]; }  // gemini -p 는 인자 모드만 지원
+  else if (provider === 'agy')  { cmd = 'agy'; args = ['-p', promptText]; }  // agy -p 는 인자 모드만 지원
   else if (provider === 'copilot') { cmd = 'gh';     args = ['copilot', 'suggest', promptText]; }
   else return { ok: false, error: `provider ${provider} 미지원`, provider };
   const t0 = Date.now();
@@ -16603,10 +16635,10 @@ const _PROVIDER_MODEL_CATALOG = {
     { id: 'gpt-5-codex', note: '코드 특화 (Codex)' },
     { id: 'o4-mini', note: '빠른 reasoning' }
   ],
-  gemini: [
-    { id: 'gemini-2.5-pro', note: 'Google 최고급 (1M+ context)' },
-    { id: 'gemini-2.5-flash', note: '빠른 응답' },
-    { id: 'gemini-3.0-pro', note: '실험적 (사용 가능 시)' }
+  agy: [
+    { id: 'antigravity-pro', note: 'Antigravity 최고급 (1M+ context)' },
+    { id: 'antigravity-flash', note: '빠른 응답' },
+    { id: 'antigravity-experimental', note: '실험적 (사용 가능 시)' }
   ],
   copilot: [
     { id: 'default', note: 'gh copilot 기본 (모델 선택 불가)' }
@@ -16620,7 +16652,7 @@ const _PROVIDER_MODEL_CATALOG = {
 };
 
 // 1.9.170: provider cycle 순서 (Tab) — 빌트인 5종. user provider는 동적으로 뒤에 추가.
-const _PROVIDER_CYCLE_ORDER = ['ollama', 'claude', 'codex', 'gemini', 'copilot'];
+const _PROVIDER_CYCLE_ORDER = ['ollama', 'claude', 'codex', 'agy', 'copilot'];
 
 // 1.9.148: planner/reviewer/actor 역할 시스템 프롬프트 (Gemini 권고 — 자기-승인 편향 방지)
 const _AGENT_ROLE_PROMPTS = {
@@ -16679,7 +16711,9 @@ async function _agentRepl(root, opts) {
     startedAt: new Date().toISOString(),
     sessionId: 'sess-' + new Date().toISOString().replace(/[:.]/g, '-'),
     // 1.9.170: 실시간 스트리밍 모드 (사용자 명시 — 추론중/diff/thinking 실시간 표시)
-    streamMode: opts.stream !== false  // default ON (env 로 끄려면 LEERNESS_REPL_STREAM=0)
+    streamMode: opts.stream !== false,  // default ON (env 로 끄려면 LEERNESS_REPL_STREAM=0)
+    // 1.9.247 (UR-0016 2단계): multi-provider auto-fallback — default OFF (opt-in)
+    autoFallback: opts.autoFallback === true || process.env.LEERNESS_REPL_AUTO_FALLBACK === '1'
   };
   if (process.env.LEERNESS_REPL_STREAM === '0') state.streamMode = false;
   const sessionPath = () => path.join(absRoot(root), '.harness', 'agent-sessions', `${state.sessionId}.jsonl`);
@@ -16798,7 +16832,7 @@ async function _agentRepl(root, opts) {
   // prompt 에 세부 모델 표시 (사용자 명시): agent[claude · claude-opus-4-7 / actor / ▶]>
   const prompt = () => {
     if (!isTty) return 'agent> ';
-    const modelShort = (state.model || '').replace(/^(claude|gpt|gemini)-/, '').slice(0, 18);
+    const modelShort = (state.model || '').replace(/^(claude|gpt|gemini|antigravity)-/, '').slice(0, 18);
     const modelTag = modelShort ? C.dim(' · ') + C.mag(modelShort) : '';
     return C.cy(`agent[${state.provider}${modelTag}${C.cy('/' + state.role)}${state.streamMode ? C.cy('/▶') : ''}${C.cy(']>')} `);
   };
@@ -16818,7 +16852,7 @@ async function _agentRepl(root, opts) {
       if (m.includes('gpt-4')) return 128000;
       return 128000;
     }
-    if (provider === 'gemini') return 1000000;       // 2M까지 가능하지만 보수적으로 1M
+    if (provider === 'agy') return 1000000;       // 2M까지 가능하지만 보수적으로 1M
     if (provider === 'copilot') return 64000;
     if (provider === 'ollama') return 8000;          // 모델별 다르나 default 8k
     return 100000;
@@ -16851,7 +16885,7 @@ async function _agentRepl(root, opts) {
           .map(a => ({ id: a.id, st: _checkAgent(a).status }))
           .filter(x => x.st === 'ready');
       } catch {}
-      const allAgents = ['claude', 'codex', 'gemini', 'copilot'];
+      const allAgents = ['claude', 'codex', 'agy', 'copilot'];
       const subBar = allAgents.map(id => {
         if (id === state.provider) return C.bold(C.green(`*${id}`));
         const isReady = ready.find(r => r.id === id);
@@ -16994,7 +17028,7 @@ async function _agentRepl(root, opts) {
         ['/quit', 'REPL 종료 (세션 자동 저장)'],
         ['/clear', '대화 히스토리 초기화'],
         ['/status', '현재 provider / model / role / perms 상태'],
-        ['/provider <id>', 'provider 전환 (ollama, claude, codex, gemini, copilot)'],
+        ['/provider <id>', 'provider 전환 (ollama, claude, codex, agy, copilot)'],
         ['/model <id>', '현재 provider의 모델 전환'],
         ['/role <id>', '역할 전환 (actor / planner / reviewer)'],
         ['/stream on|off', '실시간 스트리밍 토글 (default ON)']
@@ -17046,7 +17080,7 @@ async function _agentRepl(root, opts) {
       log('    :model <name>         — 모델 변경 (1.9.155 모든 provider 지원, 예: :model claude-opus-4-7)');
       log('    :models               — provider 별 모델 목록 (ollama 실시간 / 그 외 추천 카탈로그)');
       log('    :role <r>             — 역할 변경 (planner / reviewer / actor)');
-      log('    :provider <p>         — provider 변경 (ollama / claude / codex / gemini / copilot — ready 검증)');
+      log('    :provider <p>         — provider 변경 (ollama / claude / codex / agy / copilot — ready 검증)');
       log('    :stream on|off        — 🆕 1.9.170 실시간 스트리밍 토글 (추론중/diff/thinking 실시간 표시)');
       log('    :status               — 현재 세션 상태 자세히 (1.9.155)');
       log('    :clear                — 화면 클리어 + history 유지');
@@ -17057,7 +17091,7 @@ async function _agentRepl(root, opts) {
       log('    :perm [mode]          — :permissions 단축 alias');
       log('    :quit / :exit / :q    — 종료 (자동 저장)');
       log(C.bold('\n  🆕 1.9.170 키보드 단축키:'));
-      log('    Tab                   — 다음 provider 로 cycle (ollama → claude → codex → gemini → copilot)');
+      log('    Tab                   — 다음 provider 로 cycle (ollama → claude → codex → agy → copilot)');
       log('    Shift+Tab             — 현재 provider 의 다음 model 로 cycle (catalog 기준)');
       log(C.bold('\n  Slash 명령 (1.9.150) — leerness 내부 명령 직접 호출:'));
       log('    :verify               — leerness verify-code (테스트/타입/린트 자동 검수)');
@@ -17124,7 +17158,7 @@ async function _agentRepl(root, opts) {
     }
     if (op === 'provider') {
       const newProv = rest[0] || state.provider;
-      const validProviders = ['ollama', 'claude', 'codex', 'gemini', 'copilot'];
+      const validProviders = ['ollama', 'claude', 'codex', 'agy', 'copilot'];
       if (!validProviders.includes(newProv)) {
         log(C.yel(`  ⚠ provider 는 ${validProviders.join(' / ')} (받음: ${newProv})`));
         return false;
@@ -17167,6 +17201,20 @@ async function _agentRepl(root, opts) {
       rl.setPrompt(prompt());
       return false;
     }
+    // 1.9.247 (UR-0016 2단계): :fallback on|off — provider 실패 시 다음 ready agent 자동 전환 (opt-in)
+    if (op === 'fallback') {
+      const v = (rest[0] || '').toLowerCase();
+      if (v === 'on' || v === '1' || v === 'true') {
+        state.autoFallback = true;
+        log(C.green('  ↪ auto-fallback: ON (1.9.247) — 현재 provider transient 실패 (timeout/exit=null) 시 다음 ready agent 자동 전환 + 재시도'));
+      } else if (v === 'off' || v === '0' || v === 'false') {
+        state.autoFallback = false;
+        log(C.dim('  ↪ auto-fallback: OFF — 실패 시 사용자가 직접 :provider 전환'));
+      } else {
+        log(C.dim(`  현재 auto-fallback: ${state.autoFallback ? 'ON ↪' : 'OFF'}  — 사용: :fallback on|off`));
+      }
+      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') {
@@ -17347,12 +17395,12 @@ 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 도 세션 관리 (사용자 명시)
+      // 1.9.153: multi-provider REPL — ollama 외 claude/codex/agy/copilot 도 세션 관리 (사용자 명시)
       // 1.9.170: streamMode === true 이면 _cliChatStream 사용 (사용자 명시 — 추론중/diff 실시간 표시)
       if (state.provider === 'ollama') {
         log(C.dim(`  → ollama${state.model ? ' (' + state.model + ')' : ''} 호출 중...`));
         result = await _ollamaChat(finalPrompt, state.model);
-      } else if (['claude', 'codex', 'gemini', 'copilot'].includes(state.provider)) {
+      } else if (['claude', 'codex', 'agy', 'copilot'].includes(state.provider)) {
         if (state.streamMode) {
           log(C.dim(`  → ${state.provider} CLI stream 호출 중...  (Ctrl+C 로 중단)`));
           result = await _cliChatStream(root, state.provider, finalPrompt, { timeout: 120000 });
@@ -17361,7 +17409,7 @@ async function _agentRepl(root, opts) {
           result = await _cliChat(root, state.provider, finalPrompt, { timeout: 90000 });
         }
       } else {
-        log(C.yel(`  ⚠ ${state.provider} provider 미지원 — :provider ollama|claude|codex|gemini|copilot`));
+        log(C.yel(`  ⚠ ${state.provider} provider 미지원 — :provider ollama|claude|codex|agy|copilot`));
         promptWithStatus(); return;
       }
       const dt = Date.now() - t0;
@@ -17370,7 +17418,7 @@ async function _agentRepl(root, opts) {
         state.history.push({ role: 'assistant', content: result.response });
         // 1.9.170: stream 모드에서는 이미 실시간으로 출력됐으므로 헤더만 표시 (응답 중복 방지)
         // 1.9.246: 정상 완료 작업은 초록색 ✓ 강조 (사용자 명시 UR-0016)
-        if (state.streamMode && ['claude', 'codex', 'gemini', 'copilot'].includes(state.provider)) {
+        if (state.streamMode && ['claude', 'codex', 'agy', 'copilot'].includes(state.provider)) {
           log(C.green(`  ✓ [assistant: ${state.provider}/${state.model || 'default'}, role=${state.role}, ${dt}ms · ${result.response.length}자]`));
         } else {
           log('');
@@ -17387,12 +17435,53 @@ async function _agentRepl(root, opts) {
         // 실패 원인 분류
         if (/exit=null/.test(errMsg) || /timeout/i.test(errMsg)) {
           log(C.dim(`     ↳ 가능 원인: (1) ${state.provider} CLI 응답 시간 초과 (모델 로딩/큰 응답 대기 중)`));
-          log(C.dim(`                  (2) network/auth 문제 (특히 codex/gemini 는 인터넷 + 토큰 필요)`));
-          log(C.dim(`     ↳ 직접 검증: ${state.provider} --print "ping" ${state.provider === 'gemini' ? '--yolo' : ''}`));
+          log(C.dim(`                  (2) network/auth 문제 (특히 codex/agy 는 인터넷 + 토큰 필요)`));
+          log(C.dim(`     ↳ 직접 검증: ${state.provider} --print "ping" ${state.provider === 'agy' ? '--yolo' : ''}`));
         } else if (/exit=1/.test(errMsg) || /unauth/i.test(errMsg) || /login/i.test(errMsg)) {
           log(C.dim(`     ↳ 가능 원인: 인증 누락 (login 필요)`));
           log(C.dim(`     ↳ 해결: ${state.provider} login ${state.provider === 'copilot' ? '(gh auth login)' : ''}`));
         }
+        // 1.9.247 (UR-0016 2단계): 자동 fallback — 사용자 명시 (`:fallback on` 또는 LEERNESS_REPL_AUTO_FALLBACK=1) 시
+        //   현재 provider 가 transient 실패 (timeout/exit=null/network) 시 다음 ready agent 로 자동 전환 + 1회 재시도.
+        //   사용자 명시 (이전 codex CLI exit=null 보고): "멀티 provider auto-fallback 도 검토".
+        const isTransient = /exit=null|timeout/i.test(errMsg);
+        if (state.autoFallback && isTransient) {
+          try {
+            const others = EXTERNAL_AGENTS.filter(a => a.id !== state.provider)
+                                           .map(a => ({ def: a, status: _checkAgent(a) }))
+                                           .filter(x => x.status.status === 'ready');
+            if (others.length > 0) {
+              const next = others[0].def.id;
+              log(C.green(`  ↪ auto-fallback (1.9.247): ${state.provider} 실패 → ${next} 자동 전환 + 재시도 중...`));
+              state.provider = next;
+              state.model = null;
+              const cat = _PROVIDER_MODEL_CATALOG[state.provider];
+              if (cat && cat.length) state.model = cat[0].id;
+              rl.setPrompt(prompt());
+              const t1 = Date.now();
+              let retry;
+              if (state.streamMode) retry = await _cliChatStream(root, state.provider, finalPrompt, { timeout: 120000 });
+              else retry = await _cliChat(root, state.provider, finalPrompt, { timeout: 90000 });
+              const dt1 = Date.now() - t1;
+              _recordRun(root, { kind: 'agent_repl_turn_fallback', provider: state.provider, model: state.model, role: state.role, durationMs: dt1, ok: retry.ok, error: retry.error, promptChars: finalPrompt.length, responseChars: (retry.response || '').length });
+              if (retry.ok) {
+                state.history.push({ role: 'assistant', content: retry.response });
+                log(C.green(`  ✓ fallback 성공 [${state.provider}/${state.model || 'default'}, ${dt1}ms · ${retry.response.length}자]`));
+                if (!state.streamMode) log(retry.response);
+                _printInputDivider();
+                if (state.history.length % 6 === 0) saveSession();
+                promptWithStatus();
+                return;
+              } else {
+                log(C.yel(`  ⚠ fallback 도 실패 (${next}): ${retry.error || 'unknown'}`));
+              }
+            } else {
+              log(C.dim(`     (auto-fallback: 다른 ready provider 없음)`));
+            }
+          } catch (e) {
+            log(C.dim(`     (auto-fallback 오류: ${e.message})`));
+          }
+        }
         // 전환 가능 provider 안내
         try {
           const others = EXTERNAL_AGENTS.filter(a => a.id !== state.provider)
@@ -17400,8 +17489,9 @@ async function _agentRepl(root, opts) {
                                          .filter(x => x.status.status === 'ready');
           if (others.length) {
             log(C.dim(`     💡 즉시 전환: ${others.map(x => `:provider ${x.def.id}`).join(' · ')}  또는 Tab 키`));
+            if (!state.autoFallback) log(C.dim(`     💡 다음 실패 시 자동 전환: \`:fallback on\` (1.9.247 UR-0016 2단계)`));
           } else {
-            log(C.dim(`     💡 다른 provider 활성화: .env 에서 LEERNESS_ENABLE_<CLAUDE|CODEX|GEMINI|COPILOT>=1`));
+            log(C.dim(`     💡 다른 provider 활성화: .env 에서 LEERNESS_ENABLE_<CLAUDE|CODEX|AGY|COPILOT>=1`));
           }
         } catch {}
       }
@@ -17434,12 +17524,12 @@ async function agentCmd(root, taskArg) {
     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 --provider claude            # provider 명시 (ollama/claude/codex/gemini/copilot)');
+    log('  leerness agent --provider claude            # provider 명시 (ollama/claude/codex/agy/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('REPL Multi-provider (1.9.153): ollama / claude / codex / agy / copilot — 활성 CLI 자동 감지');
     log('');
     log('현재 활성 provider: ' + (_activeCliAgents().join(', ') || '(없음) — .env에서 LEERNESS_ENABLE_* 활성화'));
     log('권한 모드: ' + (_readPermissions(root).mode || 'basic'));
@@ -17470,17 +17560,17 @@ async function agentCmd(root, taskArg) {
   // 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 재사용)
+  // 1.9.154: 1-shot 모드도 multi-provider — Ollama 외 claude/codex/agy/copilot 직접 호출 (1.9.153 _cliChat 재사용)
   let r;
   if (provider === 'ollama') {
     log('\n[ollama 호출 중...]');
     r = await _ollamaChat(finalPrompt);
-  } else if (['claude', 'codex', 'gemini', 'copilot'].includes(provider)) {
+  } else if (['claude', 'codex', 'agy', '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)`);
+    fail(`알 수 없는 provider: ${provider} (ollama/claude/codex/agy/copilot)`);
     process.exitCode = 1;
     return;
   }
@@ -18049,7 +18139,7 @@ function healthCmd(root) {
     const hasRepl = /async function _agentRepl/.test(harnessSrc);
     const hasCliChat = /async function _cliChat/.test(harnessSrc);
     cap.replMultiProvider = (hasRepl && hasCliChat)
-      ? { score: 90, status: '✓', evidence: 'ollama/claude/codex/gemini/copilot 5종 (1.9.149+1.9.153)' }
+      ? { score: 90, status: '✓', evidence: 'ollama/claude/codex/agy/copilot 5종 (1.9.149+1.9.153)' }
       : { score: 30, status: '⚠', evidence: 'REPL 미완성' };
     // (5) MCP 도구 — tools array 카운트
     const toolsMatch = harnessSrc.match(/{ name: 'leerness_/g);
@@ -19258,7 +19348,7 @@ function whichCmd() {
 }
 
 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 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 which [--json]                                   # 1.9.164 진단: 현재 실행 경로/버전 + npm 캐시 + PATH 후보 (구버전 충돌 해결)\n  leerness web check|screenshot|extract <url> [--out file.png] [--selector "css"]  # 1.9.165 playwright bridge (opt-in: npm i -g playwright + permissions.browser)\n  leerness pc check|click|type|screenshot [--x N --y N] [--text "s"] [--out f.png]  # 1.9.166 robotjs/nut-tree bridge (opt-in: npm i -g robotjs + permissions.mouse/keyboard, ⚠ full 모드 권장)\n  leerness lsp check|symbols|references <file/name> [--in dir] [--json]  # 1.9.167 LSP 어댑터 MVP (typescript opt-in + regex fallback, 코드 인텔리전스)\n  leerness review-request "<request>" [--json]  # 1.9.176 사용자 요청 사전 검토 (충돌/재사용/효율/권장 단계 — 사용자 명시)\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/agy/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 which [--json]                                   # 1.9.164 진단: 현재 실행 경로/버전 + npm 캐시 + PATH 후보 (구버전 충돌 해결)\n  leerness web check|screenshot|extract <url> [--out file.png] [--selector "css"]  # 1.9.165 playwright bridge (opt-in: npm i -g playwright + permissions.browser)\n  leerness pc check|click|type|screenshot [--x N --y N] [--text "s"] [--out f.png]  # 1.9.166 robotjs/nut-tree bridge (opt-in: npm i -g robotjs + permissions.mouse/keyboard, ⚠ full 모드 권장)\n  leerness lsp check|symbols|references <file/name> [--in dir] [--json]  # 1.9.167 LSP 어댑터 MVP (typescript opt-in + regex fallback, 코드 인텔리전스)\n  leerness review-request "<request>" [--json]  # 1.9.176 사용자 요청 사전 검토 (충돌/재사용/효율/권장 단계 — 사용자 명시)\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.246",
+  "version": "1.9.248",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",

package/scripts/e2e.js

@@ -605,11 +605,11 @@ total++;
   // register-pending
   const tmpR = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-regp-'));
   cp.spawnSync(process.execPath, [CLI, 'init', tmpR, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
-  const r = cp.spawnSync(process.execPath, [CLI, 'register-pending', 'JSON export 기능', '--agent', 'gemini', '--path', tmpR], { encoding: 'utf8', timeout: 10000 });
-  const okReg = r.status === 0 && /등록됨 \(in-progress\) by gemini/.test(r.stdout);
+  const r = cp.spawnSync(process.execPath, [CLI, 'register-pending', 'JSON export 기능', '--agent', 'agy', '--path', tmpR], { encoding: 'utf8', timeout: 10000 });
+  const okReg = r.status === 0 && /등록됨 \(in-progress\) by agy/.test(r.stdout);
   // 즉시 progress-tracker에서 검색 가능
   const r2 = cp.spawnSync(process.execPath, [CLI, 'memory', 'search', 'JSON export', '--path', tmpR], { encoding: 'utf8', timeout: 10000 });
-  const okSearch = /in-progress/.test(r2.stdout) && /pending.*gemini/.test(r2.stdout);
+  const okSearch = /in-progress/.test(r2.stdout) && /pending.*agy/.test(r2.stdout);
   const ok = okReg && okSearch;
   console.log(ok ? '✓ B(1.9.25) register-pending: 즉시 등록 + 검색 가능' : `✗ register-pending 실패 (reg=${okReg} search=${okSearch})`);
   if (!ok) { failed++; console.log(r.stdout.slice(0, 400)); }
@@ -797,23 +797,23 @@ total++;
 total++;
 {
   // agents list — claude가 환경변수 + PATH 둘 다 충족 시 ready
-  const env1 = { ...process.env, LEERNESS_ENABLE_CLAUDE: '1', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_GEMINI: '0', LEERNESS_ENABLE_COPILOT: '0' };
+  const env1 = { ...process.env, LEERNESS_ENABLE_CLAUDE: '1', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_AGY: '0', LEERNESS_ENABLE_COPILOT: '0' };
   const r1 = cp.spawnSync(process.execPath, [CLI, 'agents', 'list'], { encoding: 'utf8', timeout: 15000, env: env1 });
   const okList = r1.status === 0
     && /외부 AI CLI 오케스트레이션 \(1\.9\.30\)/.test(r1.stdout)
     && /\| claude \|/.test(r1.stdout)
     && /\| codex \|/.test(r1.stdout)
-    && /\| gemini \|/.test(r1.stdout)
+    && /\| agy \|/.test(r1.stdout)
     && /\| copilot \|/.test(r1.stdout);
   // env 모두 0 → 비활성
   // 1.9.146: Ollama 추가 → 5 CLI
-  const env2 = { ...process.env, LEERNESS_ENABLE_CLAUDE: '0', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_GEMINI: '0', LEERNESS_ENABLE_COPILOT: '0', LEERNESS_ENABLE_OLLAMA: '0' };
+  const env2 = { ...process.env, LEERNESS_ENABLE_CLAUDE: '0', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_AGY: '0', LEERNESS_ENABLE_COPILOT: '0', LEERNESS_ENABLE_OLLAMA: '0' };
   const r2 = cp.spawnSync(process.execPath, [CLI, 'agents', 'list', '--json'], { encoding: 'utf8', timeout: 15000, env: env2 });
   let parsed = null;
   try { parsed = JSON.parse(r2.stdout); } catch {}
   const okJson = parsed && Array.isArray(parsed.agents) && parsed.agents.length === 5 && parsed.agents.every(a => a.status !== 'ready');
   const ok = okList && okJson;
-  console.log(ok ? '✓ B(1.9.30+1.9.146) agents list: 5 CLI 정의 (claude/codex/gemini/copilot/ollama)' : `✗ agents list 실패 (list=${okList} json=${okJson})`);
+  console.log(ok ? '✓ B(1.9.30+1.9.146) agents list: 5 CLI 정의 (claude/codex/agy/copilot/ollama)' : `✗ agents list 실패 (list=${okList} json=${okJson})`);
   if (!ok) { failed++; console.log(r1.stdout.slice(0, 500)); }
 }
 
@@ -838,13 +838,13 @@ total++;
 total++;
 {
   // agents quota — env=0 시 모두 disabled/not-installed, 안내 메시지 포함
-  const env = { ...process.env, LEERNESS_ENABLE_CLAUDE: '0', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_GEMINI: '0', LEERNESS_ENABLE_COPILOT: '0' };
+  const env = { ...process.env, LEERNESS_ENABLE_CLAUDE: '0', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_AGY: '0', LEERNESS_ENABLE_COPILOT: '0' };
   const r = cp.spawnSync(process.execPath, [CLI, 'agents', 'quota'], { encoding: 'utf8', timeout: 15000, env });
   const okText = r.status === 0
     && /외부 AI CLI quota 추정 \(1\.9\.31\)/.test(r.stdout)
     && /\| claude \|/.test(r.stdout)
     && /\| codex \|/.test(r.stdout)
-    && /\| gemini \|/.test(r.stdout)
+    && /\| agy \|/.test(r.stdout)
     && /\| copilot \|/.test(r.stdout)
     && /provider 대시보드 참조/.test(r.stdout);
   // JSON 출력
@@ -1752,13 +1752,13 @@ total++;
 // 1.9.36 회귀: dispatch 권장 플래그 + bench + 작업 유형 추천
 total++;
 {
-  // dispatch --write 시 gemini --yolo 자동 추가
-  const env = { ...process.env, LEERNESS_ENABLE_GEMINI: '1' };
-  const r = cp.spawnSync(process.execPath, [CLI, 'agents', 'dispatch', '코드 분석해서 요약', '--to', 'gemini', '--write'], { encoding: 'utf8', timeout: 15000, env });
-  // gemini가 ready면 명령 출력에 --yolo 포함, 비-ready면 거부 — 둘 다 OK
+  // dispatch --write 시 agy --yolo 자동 추가
+  const env = { ...process.env, LEERNESS_ENABLE_AGY: '1' };
+  const r = cp.spawnSync(process.execPath, [CLI, 'agents', 'dispatch', '코드 분석해서 요약', '--to', 'agy', '--write'], { encoding: 'utf8', timeout: 15000, env });
+  // agy가 ready면 명령 출력에 --yolo 포함, 비-ready면 거부 — 둘 다 OK
   const ok = (r.status === 0 && /--yolo/.test(r.stdout) && /write \(파일 수정 가능\)/.test(r.stdout))
           || (r.status !== 0 && /비활성|disabled|not-installed/.test(r.stdout));
-  console.log(ok ? '✓ B(1.9.36) dispatch --write: gemini --yolo 자동 첨부 또는 비활성 거부' : `✗ dispatch --write 실패`);
+  console.log(ok ? '✓ B(1.9.36) dispatch --write: agy --yolo 자동 첨부 또는 비활성 거부' : `✗ dispatch --write 실패`);
   if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
 }
 
@@ -1777,8 +1777,8 @@ total++;
 total++;
 {
   // 작업 유형 추천 — 비활성 CLI에도 추천 메시지 우선 출력
-  const env = { ...process.env, LEERNESS_ENABLE_GEMINI: '0', LEERNESS_ENABLE_CLAUDE: '0' };
-  const r = cp.spawnSync(process.execPath, [CLI, 'agents', 'dispatch', '번역해줘 한국어를 영어로', '--to', 'gemini'], { encoding: 'utf8', timeout: 15000, env });
+  const env = { ...process.env, LEERNESS_ENABLE_AGY: '0', LEERNESS_ENABLE_CLAUDE: '0' };
+  const r = cp.spawnSync(process.execPath, [CLI, 'agents', 'dispatch', '번역해줘 한국어를 영어로', '--to', 'agy'], { encoding: 'utf8', timeout: 15000, env });
   // 번역 → claude 추천. ready 체크 전에 추천 출력 → stdout에 "추천...claude" 포함
   const ok = /추천.*claude/.test(r.stdout);
   console.log(ok ? '✓ B(1.9.36) 작업 유형 추천: 번역→claude 추천 (비활성이어도 출력)' : `✗ 추천 실패`);
@@ -1788,7 +1788,7 @@ total++;
 total++;
 {
   // bench 명령: ready CLI 없을 때 거부
-  const env = { ...process.env, LEERNESS_ENABLE_CLAUDE: '0', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_GEMINI: '0', LEERNESS_ENABLE_COPILOT: '0' };
+  const env = { ...process.env, LEERNESS_ENABLE_CLAUDE: '0', LEERNESS_ENABLE_CODEX: '0', LEERNESS_ENABLE_AGY: '0', LEERNESS_ENABLE_COPILOT: '0' };
   const r = cp.spawnSync(process.execPath, [CLI, 'agents', 'bench', 'test'], { encoding: 'utf8', timeout: 15000, env });
   const ok = r.status !== 0 && /ready CLI 없음/.test(r.stdout);
   console.log(ok ? '✓ B(1.9.36) agents bench: ready 없을 때 거부' : `✗ bench 거부 실패`);