leerness 1.9.290 → 1.9.291

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.9.291 — 2026-06-03 — UR-0025 (2단계): 외부 에이전트 레지스트리 → lib/agent-registry.js 모듈 분리
+
+**🧩 GPT-5.5 + Codex 두 리뷰가 공통 지적한 #1 유지보수 이슈(단일 1.2MB 파일)를 비파괴 모듈 분리로 점진 해소. 1.9.274의 lib/pure-utils.js 패턴 계승.**
+
+### 배경
+`bin/harness.js` 단일 대형 파일은 외부 리뷰 2건(GPT-5.5·Codex)이 모두 지적한 유지보수/리뷰가능성 이슈. 1.9.274(UR-0025 1단계)에서 순수 함수 14종을 `lib/pure-utils.js`로 분리했고, 이번 2단계는 **순수 데이터 카탈로그**를 별도 모듈로 분리.
+
+### 구현 (UR-0025 2단계)
+1. **`lib/agent-registry.js` 신설** — `EXTERNAL_AGENTS`(10종 CLI: claude/codex/agy/grok/opencode/qwen/aider/goose/copilot/ollama) + `AGENT_SLASH_COMMANDS`(9종 슬래시/하위명령 레지스트리) 데이터 이동(140줄).
+2. **비파괴 require-based 분리** — harness.js 는 `require('../lib/agent-registry')` 구조분해로 동일 바인딩 사용. 런타임 변형 0 검증(사용자 override 는 `_loadAgentSlashCommands` 가 별도 객체에 병합, base 불변).
+3. **harness.js 21663→21525줄** (138줄 감소). `package.json` files 에 이미 `lib` 포함 → npm 배포 자동 반영.
+4. selftest 38→39 (`m.EXTERNAL_AGENTS === EXTERNAL_AGENTS` 단일출처 동일참조 + 인라인 정의 제거 검증) · e2e 235→236 (모듈 standalone require + harness 단일출처 + 인라인 제거 실측).
+
+### 검증
+- **selftest 39/39 PASS** · **E2E 236/236 PASS** (회귀 0).
+- 기존 카탈로그 selftest(EXTERNAL_AGENTS 10종 / AGENT_SLASH_COMMANDS 5종 / _agentSlashHint)가 추출 정합성 즉시 검증.
+- 남은 UR-0025 후속: ROLE_CATALOG/CAPABILITY_SURFACE/ADAPTERS/REUSE 등 잔여 카탈로그 점진 분리(다음 라운드 후보).
+
 ## 1.9.290 — 2026-06-03 — UR-0037 (Codex #4): require 시 top-level side effect 격리 — Codex 5건 완전 수렴 🎉
 
 **🧩 `require('leerness/bin/harness.js')` 가 호스트 프로세스를 오염시키던 마지막 갭 수정 (Codex gpt-5.5 #4). 이로써 Codex 코드 리뷰 5건 전부 수렴 완료.**

package/README.md

@@ -3,7 +3,7 @@
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.290-green)]() [![tests](https://img.shields.io/badge/e2e-235%2F235-success)]() [![selftest](https://img.shields.io/badge/selftest-38-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-79-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![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.291-green)]() [![tests](https://img.shields.io/badge/e2e-236%2F236-success)]() [![selftest](https://img.shields.io/badge/selftest-39-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-79-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.290 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.291 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### Core Commands
 
@@ -513,7 +513,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.290는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **79개 도구**를 노출:
+Leerness v1.9.291는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **79개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -534,7 +534,7 @@ Leerness v1.9.290는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.9.290)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.291)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -572,6 +572,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.9.290: 2026-06-03
+Last synced by Leerness v1.9.291: 2026-06-03
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -10,7 +10,7 @@ const readline = require('readline');
 const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
   PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord } = require('../lib/pure-utils');
 
-const VERSION = '1.9.290';
+const VERSION = '1.9.291';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2997,6 +2997,7 @@ function _selfTestCases() {
     { name: '_newRunRecord: GPT-5.5 권고 스키마 14필드 + 기본값 (1.9.278)', run: () => { const r = _newRunRecord({ run_id: 'run-0001', goal: 'g', started_at: '2026-06-03T00:00:00Z' }); return r.schemaVersion === 1 && r.run_id === 'run-0001' && r.started_at === '2026-06-03T00:00:00Z' && Array.isArray(r.files_changed) && Array.isArray(r.commands_run) && Array.isArray(r.tests_run) && Array.isArray(r.decisions) && r.verification_result === null && r.status === 'in-progress' && 'handoff_summary' in r && 'model_name' in r && 'task_id' in r; } },
     { name: 'coreFiles --minimal: 핵심 유지 + 비핵심 제외 + verify 필수 보존 (1.9.276)', run: () => { const full = coreFiles('.', 'ko', []); const min = coreFiles('.', 'ko', [], { minimal: true }); const keep = ['.harness/plan.md','.harness/progress-tracker.md','.harness/session-handoff.md','AGENTS.md','CLAUDE.md','.harness/consistency-policy.md','.harness/reuse-map.md','.harness/encoding-policy.md','.harness/secret-policy.md']; const drop = ['.cursor/rules/leerness.mdc','.harness/skill-index.md','.harness/architecture.md']; const verifyReq = ['.harness/design-system.md','.harness/protected-files.md','.harness/current-state.md']; if (!verifyReq.every(k => min[k])) return false; return Object.keys(min).length < Object.keys(full).length && keep.every(k => min[k]) && drop.every(k => !min[k]); } },
     { name: '_cliBootstrap: CLI 부작용 require.main 가드 격리 (Codex #4 UR-0037 1.9.290)', run: () => { if (typeof _cliBootstrap !== 'function' || typeof _ensureStdoutEncoding !== 'function') return false; const src = read(__filename); const guarded = /if \(require\.main === module\) _cliBootstrap\(\);/.test(src); const inFn = /function _cliBootstrap\(\)\s*\{[\s\S]*?removeAllListeners\('warning'\)[\s\S]*?NODE_OPTIONS[\s\S]*?_ensureStdoutEncoding\(\);[\s\S]*?\n\}/.test(src); const noTopIife = !/\}\)\(\);\s*\n\n\/\/ 1\.9\.184/.test(src); return guarded && inFn && noTopIife; } },
+    { name: 'lib/agent-registry: EXTERNAL_AGENTS/AGENT_SLASH_COMMANDS 모듈 단일출처 분리 (UR-0025 1.9.291)', run: () => { const m = require('../lib/agent-registry'); return m.EXTERNAL_AGENTS === EXTERNAL_AGENTS && m.AGENT_SLASH_COMMANDS === AGENT_SLASH_COMMANDS && m.EXTERNAL_AGENTS.length === 10 && Object.keys(m.AGENT_SLASH_COMMANDS).length === 9 && !/const EXTERNAL_AGENTS = \[/.test(read(__filename)); } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -10193,146 +10194,8 @@ function _resolvePersona(root, id) {
   return null;
 }
 
-// 1.9.30: 외부 AI CLI 오케스트레이션 — claude/codex/agy/copilot 가용성 + 활성화 체크
-// 사용자 정책: 환경변수로 활성화 명시 + 실제 PATH 존재 확인 + 메인이 sub-agent 분배 시 참조
-// 1.9.32: installCmd 추가 — setup-agents 시 자동 설치 시도 가능
-const EXTERNAL_AGENTS = [
-  { id: 'claude',  bin: 'claude',  envFlag: 'LEERNESS_ENABLE_CLAUDE',  versionArgs: ['--version'], desc: 'Anthropic Claude Code CLI',
-    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' },
-  // 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)' },
-  // 1.9.268: grok 정식 provider 승격 (1.9.266 후속 task) — 기존 슬래시 레지스트리(grok)만 보유하던 상태에서 EXTERNAL_AGENTS 로 편입.
-  //   → provider cycle / setup-agents / dispatch / slash-commands --refresh probe 가 grok 도 자동 처리.
-  { id: 'grok',    bin: 'grok',    envFlag: 'LEERNESS_ENABLE_GROK',    versionArgs: ['--version'], desc: 'xAI Grok CLI (커뮤니티 grok-cli, /model grok-beta 등)',
-    installCmd: 'npm i -g @vibe-kit/grok-cli', installHint: 'https://github.com/superagent-ai/grok-cli (xAI API 키 필요 — /login 또는 GROK_API_KEY)' },
-  // 1.9.277 (사용자 명시): 신규 CLI 에이전트 4종 — opencode/qwen/aider/goose. 활성 시 sub-agent dispatch/roles 라우팅 대상.
-  { id: 'opencode', bin: 'opencode', envFlag: 'LEERNESS_ENABLE_OPENCODE', versionArgs: ['--version'], desc: 'opencode — 오픈소스 터미널 AI 코딩 에이전트 (provider-agnostic)',
-    installCmd: 'npm i -g opencode-ai', installHint: 'https://opencode.ai (또는 curl -fsSL https://opencode.ai/install | bash)' },
-  { id: 'qwen',    bin: 'qwen',    envFlag: 'LEERNESS_ENABLE_QWEN',    versionArgs: ['--version'], desc: 'Qwen Code CLI (Alibaba qwen3-coder 등)',
-    installCmd: 'npm i -g @qwen-code/qwen-code', installHint: 'https://github.com/QwenLM/qwen-code (DASHSCOPE/OpenAI 호환 키)' },
-  { id: 'aider',   bin: 'aider',   envFlag: 'LEERNESS_ENABLE_AIDER',   versionArgs: ['--version'], desc: 'Aider — git-aware 페어 프로그래밍 CLI (--model 임의 지정)',
-    installCmd: 'python -m pip install aider-install && aider-install', installHint: 'https://aider.chat (pip install aider-chat · API 키 env)' },
-  { id: 'goose',   bin: 'goose',   envFlag: 'LEERNESS_ENABLE_GOOSE',   versionArgs: ['--version'], desc: 'Goose — Block 오픈소스 범용 로컬 AI 에이전트 (MCP 확장)',
-    installCmd: 'curl -fsSL https://github.com/block/goose/releases/latest/download/download_cli.sh | bash', installHint: 'https://block.github.io/goose (goose configure 로 provider/model 설정)' },
-  { 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
-  { id: 'ollama',  bin: 'ollama',  envFlag: 'LEERNESS_ENABLE_OLLAMA',  versionArgs: ['--version'], desc: 'Ollama 로컬 LLM (http://localhost:11434, llama3/qwen 등)',
-    installCmd: 'curl -fsSL https://ollama.com/install.sh | sh (또는 https://ollama.com/download)', installHint: 'ollama serve 실행 + ollama pull <model>' }
-];
-
-// 1.9.265 (사용자 명시 UR-0021): CLI AI 에이전트별 슬래시 명령어 레지스트리.
-//   목적: 각 CLI (claude/codex/agy/grok/copilot) 의 슬래시 명령어를 큐레이션·기록하고, 서브에이전트 dispatch 시 알맞게 참조.
-//   "항상 최신화" 3중 경로: (1) 빌트인은 leerness 릴리스마다 갱신(asOf), (2) 사용자 .harness/agent-slash-commands.json override 병합,
-//   (3) [1.9.267 완료] `slash-commands --refresh` — 설치된 CLI 의 `--help` probe 로 자동 갱신(best-effort, 검출 0건이면 큐레이션 유지). 0-dep·offline-first.
-//   주의: 외부 CLI 의 슬래시 명령은 버전마다 변동 → asOf 표기 + 사용자 override 우선. type='subcommand' 는 슬래시가 아닌 하위명령(예: gh copilot).
-const AGENT_SLASH_COMMANDS = {
-  claude: {
-    label: 'Anthropic Claude Code', asOf: '1.9.265', invoke: 'slash',
-    commands: [
-      { cmd: '/help', desc: '명령 목록' },
-      { cmd: '/clear', desc: '대화 컨텍스트 초기화' },
-      { cmd: '/compact', desc: '대화 압축 (컨텍스트 절약)' },
-      { cmd: '/init', desc: 'CLAUDE.md 생성/갱신' },
-      { cmd: '/model', desc: '모델 전환' },
-      { cmd: '/review', desc: 'PR/변경 리뷰' },
-      { cmd: '/agents', desc: '서브에이전트 관리' },
-      { cmd: '/mcp', desc: 'MCP 서버 상태/관리' },
-      { cmd: '/memory', desc: '메모리 파일 편집' },
-      { cmd: '/permissions', desc: '권한 설정' },
-      { cmd: '/cost', desc: '토큰 비용 표시' },
-      { cmd: '/resume', desc: '이전 세션 재개' },
-      { cmd: '/config', desc: '설정' }
-    ]
-  },
-  codex: {
-    label: 'OpenAI Codex CLI', asOf: '1.9.265', invoke: 'slash',
-    commands: [
-      { cmd: '/init', desc: '프로젝트 컨텍스트 초기화' },
-      { cmd: '/compact', desc: '대화 압축' },
-      { cmd: '/diff', desc: '작업 트리 diff 표시' },
-      { cmd: '/mention', desc: '파일 멘션/첨부' },
-      { cmd: '/status', desc: '세션 상태/사용량' },
-      { cmd: '/model', desc: '모델 전환' },
-      { cmd: '/approvals', desc: '승인 모드 변경 (sandbox)' },
-      { cmd: '/new', desc: '새 대화 시작' },
-      { cmd: '/clear', desc: '컨텍스트 초기화' },
-      { cmd: '/quit', desc: '종료' }
-    ]
-  },
-  agy: {
-    label: 'Google Antigravity CLI', asOf: '1.9.265', invoke: 'slash',
-    note: '큐레이션(best-effort) — agy CLI 는 신규 도구라 슬래시 명령이 변동 가능. --refresh(2단계) 또는 사용자 override 권장.',
-    commands: [
-      { cmd: '/help', desc: '명령 목록' },
-      { cmd: '/init', desc: '워크스페이스 초기화' },
-      { cmd: '/model', desc: '모델 전환' },
-      { cmd: '/new', desc: '새 세션' },
-      { cmd: '/clear', desc: '컨텍스트 초기화' },
-      { cmd: '/status', desc: '상태 표시' }
-    ]
-  },
-  grok: {
-    label: 'xAI Grok CLI', asOf: '1.9.268', invoke: 'slash',
-    note: '1.9.268 정식 provider 승격 — slash-commands --refresh 로 자동 probe 가능. 커뮤니티 Grok CLI(@vibe-kit/grok-cli) 기준 큐레이션, 배포판마다 차이 가능.',
-    commands: [
-      { cmd: '/help', desc: '명령 목록' },
-      { cmd: '/clear', desc: '대화 초기화' },
-      { cmd: '/model', desc: '모델 전환 (grok-beta 등)' },
-      { cmd: '/new', desc: '새 대화' },
-      { cmd: '/login', desc: 'xAI API 키 로그인' },
-      { cmd: '/exit', desc: '종료' }
-    ]
-  },
-  copilot: {
-    label: 'GitHub Copilot CLI (gh copilot)', asOf: '1.9.265', invoke: 'subcommand',
-    note: '슬래시가 아닌 gh 하위명령. 호출 형식: gh copilot <sub> "<질의>".',
-    commands: [
-      { cmd: 'suggest', desc: '명령/코드 제안 (gh copilot suggest "...")' },
-      { cmd: 'explain', desc: '명령 설명 (gh copilot explain "...")' },
-      { cmd: 'config', desc: 'gh copilot 설정' }
-    ]
-  },
-  // 1.9.277: 신규 4종 슬래시/세션 명령 (best-effort 큐레이션 — 배포판마다 차이 가능, 사용자 override 권장)
-  opencode: {
-    label: 'opencode', asOf: '1.9.277', invoke: 'slash',
-    note: 'TUI 세션 슬래시 — 배포판마다 차이 가능.',
-    commands: [
-      { cmd: '/help', desc: '명령 목록' }, { cmd: '/new', desc: '새 세션' }, { cmd: '/models', desc: '모델 선택' },
-      { cmd: '/init', desc: '프로젝트 컨텍스트' }, { cmd: '/undo', desc: '되돌리기' }, { cmd: '/share', desc: '세션 공유' }, { cmd: '/exit', desc: '종료' }
-    ]
-  },
-  qwen: {
-    label: 'Qwen Code CLI', asOf: '1.9.277', invoke: 'slash',
-    note: 'Gemini CLI 계열 슬래시(qwen-code) 기준 큐레이션.',
-    commands: [
-      { cmd: '/help', desc: '명령 목록' }, { cmd: '/clear', desc: '컨텍스트 초기화' }, { cmd: '/memory', desc: '메모리 관리' },
-      { cmd: '/tools', desc: '도구 목록' }, { cmd: '/model', desc: '모델 전환' }, { cmd: '/quit', desc: '종료' }
-    ]
-  },
-  aider: {
-    label: 'Aider', asOf: '1.9.277', invoke: 'slash',
-    note: 'aider 세션 내 슬래시 명령 (in-chat commands).',
-    commands: [
-      { cmd: '/add', desc: '파일 컨텍스트 추가' }, { cmd: '/drop', desc: '파일 제거' }, { cmd: '/ask', desc: '코드 수정 없이 질문' },
-      { cmd: '/run', desc: '셸 명령 실행' }, { cmd: '/test', desc: '테스트 실행' }, { cmd: '/diff', desc: '변경 diff' },
-      { cmd: '/commit', desc: '커밋' }, { cmd: '/undo', desc: '마지막 커밋 취소' }, { cmd: '/help', desc: '도움말' }
-    ]
-  },
-  goose: {
-    label: 'Goose (Block)', asOf: '1.9.277', invoke: 'slash',
-    note: 'goose 세션 내 명령 (배포판마다 차이 가능).',
-    commands: [
-      { cmd: '/?', desc: '도움말' }, { cmd: '/mode', desc: '모드 전환(auto/approve/chat)' }, { cmd: '/extension', desc: 'MCP 확장 관리' },
-      { cmd: '/builtin', desc: '빌트인 확장' }, { cmd: '/exit', desc: '종료' }
-    ]
-  }
-};
+// 1.9.291 (UR-0025 2단계): 외부 에이전트 레지스트리(EXTERNAL_AGENTS + AGENT_SLASH_COMMANDS) 데이터 모듈 분리 (비파괴, require-based). selftest 3종 검증.
+const { EXTERNAL_AGENTS, AGENT_SLASH_COMMANDS } = require('../lib/agent-registry');
 function _agentSlashFile(root) { return path.join(absRoot(root), '.harness', 'agent-slash-commands.json'); }
 // 사용자 override 병합 — .harness/agent-slash-commands.json 에 동일 agent id 가 있으면 commands 를 교체(최신화).
 //   파일 형식: { schemaVersion:1, agents: { <id>: { label?, asOf?, invoke?, note?, commands:[{cmd,desc}] } } }

package/lib/agent-registry.js

@@ -0,0 +1,147 @@
+// lib/agent-registry.js — 외부 AI CLI 에이전트 레지스트리 (순수 데이터, 부작용 0)
+// 1.9.291 (UR-0025 2단계): bin/harness.js 단일 대형 파일에서 비파괴 분리. selftest(EXTERNAL_AGENTS 10종 / AGENT_SLASH_COMMANDS 5종)가 동작 검증.
+// 런타임 변형 없음 — 사용자 override 는 _loadAgentSlashCommands 가 별도 객체에 병합(base 불변).
+'use strict';
+
+// 1.9.30: 외부 AI CLI 오케스트레이션 — claude/codex/agy/copilot 가용성 + 활성화 체크
+// 사용자 정책: 환경변수로 활성화 명시 + 실제 PATH 존재 확인 + 메인이 sub-agent 분배 시 참조
+// 1.9.32: installCmd 추가 — setup-agents 시 자동 설치 시도 가능
+const EXTERNAL_AGENTS = [
+  { id: 'claude',  bin: 'claude',  envFlag: 'LEERNESS_ENABLE_CLAUDE',  versionArgs: ['--version'], desc: 'Anthropic Claude Code CLI',
+    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' },
+  // 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)' },
+  // 1.9.268: grok 정식 provider 승격 (1.9.266 후속 task) — 기존 슬래시 레지스트리(grok)만 보유하던 상태에서 EXTERNAL_AGENTS 로 편입.
+  //   → provider cycle / setup-agents / dispatch / slash-commands --refresh probe 가 grok 도 자동 처리.
+  { id: 'grok',    bin: 'grok',    envFlag: 'LEERNESS_ENABLE_GROK',    versionArgs: ['--version'], desc: 'xAI Grok CLI (커뮤니티 grok-cli, /model grok-beta 등)',
+    installCmd: 'npm i -g @vibe-kit/grok-cli', installHint: 'https://github.com/superagent-ai/grok-cli (xAI API 키 필요 — /login 또는 GROK_API_KEY)' },
+  // 1.9.277 (사용자 명시): 신규 CLI 에이전트 4종 — opencode/qwen/aider/goose. 활성 시 sub-agent dispatch/roles 라우팅 대상.
+  { id: 'opencode', bin: 'opencode', envFlag: 'LEERNESS_ENABLE_OPENCODE', versionArgs: ['--version'], desc: 'opencode — 오픈소스 터미널 AI 코딩 에이전트 (provider-agnostic)',
+    installCmd: 'npm i -g opencode-ai', installHint: 'https://opencode.ai (또는 curl -fsSL https://opencode.ai/install | bash)' },
+  { id: 'qwen',    bin: 'qwen',    envFlag: 'LEERNESS_ENABLE_QWEN',    versionArgs: ['--version'], desc: 'Qwen Code CLI (Alibaba qwen3-coder 등)',
+    installCmd: 'npm i -g @qwen-code/qwen-code', installHint: 'https://github.com/QwenLM/qwen-code (DASHSCOPE/OpenAI 호환 키)' },
+  { id: 'aider',   bin: 'aider',   envFlag: 'LEERNESS_ENABLE_AIDER',   versionArgs: ['--version'], desc: 'Aider — git-aware 페어 프로그래밍 CLI (--model 임의 지정)',
+    installCmd: 'python -m pip install aider-install && aider-install', installHint: 'https://aider.chat (pip install aider-chat · API 키 env)' },
+  { id: 'goose',   bin: 'goose',   envFlag: 'LEERNESS_ENABLE_GOOSE',   versionArgs: ['--version'], desc: 'Goose — Block 오픈소스 범용 로컬 AI 에이전트 (MCP 확장)',
+    installCmd: 'curl -fsSL https://github.com/block/goose/releases/latest/download/download_cli.sh | bash', installHint: 'https://block.github.io/goose (goose configure 로 provider/model 설정)' },
+  { 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
+  { id: 'ollama',  bin: 'ollama',  envFlag: 'LEERNESS_ENABLE_OLLAMA',  versionArgs: ['--version'], desc: 'Ollama 로컬 LLM (http://localhost:11434, llama3/qwen 등)',
+    installCmd: 'curl -fsSL https://ollama.com/install.sh | sh (또는 https://ollama.com/download)', installHint: 'ollama serve 실행 + ollama pull <model>' }
+];
+
+// 1.9.265 (사용자 명시 UR-0021): CLI AI 에이전트별 슬래시 명령어 레지스트리.
+//   목적: 각 CLI (claude/codex/agy/grok/copilot) 의 슬래시 명령어를 큐레이션·기록하고, 서브에이전트 dispatch 시 알맞게 참조.
+//   "항상 최신화" 3중 경로: (1) 빌트인은 leerness 릴리스마다 갱신(asOf), (2) 사용자 .harness/agent-slash-commands.json override 병합,
+//   (3) [1.9.267 완료] `slash-commands --refresh` — 설치된 CLI 의 `--help` probe 로 자동 갱신(best-effort, 검출 0건이면 큐레이션 유지). 0-dep·offline-first.
+//   주의: 외부 CLI 의 슬래시 명령은 버전마다 변동 → asOf 표기 + 사용자 override 우선. type='subcommand' 는 슬래시가 아닌 하위명령(예: gh copilot).
+const AGENT_SLASH_COMMANDS = {
+  claude: {
+    label: 'Anthropic Claude Code', asOf: '1.9.265', invoke: 'slash',
+    commands: [
+      { cmd: '/help', desc: '명령 목록' },
+      { cmd: '/clear', desc: '대화 컨텍스트 초기화' },
+      { cmd: '/compact', desc: '대화 압축 (컨텍스트 절약)' },
+      { cmd: '/init', desc: 'CLAUDE.md 생성/갱신' },
+      { cmd: '/model', desc: '모델 전환' },
+      { cmd: '/review', desc: 'PR/변경 리뷰' },
+      { cmd: '/agents', desc: '서브에이전트 관리' },
+      { cmd: '/mcp', desc: 'MCP 서버 상태/관리' },
+      { cmd: '/memory', desc: '메모리 파일 편집' },
+      { cmd: '/permissions', desc: '권한 설정' },
+      { cmd: '/cost', desc: '토큰 비용 표시' },
+      { cmd: '/resume', desc: '이전 세션 재개' },
+      { cmd: '/config', desc: '설정' }
+    ]
+  },
+  codex: {
+    label: 'OpenAI Codex CLI', asOf: '1.9.265', invoke: 'slash',
+    commands: [
+      { cmd: '/init', desc: '프로젝트 컨텍스트 초기화' },
+      { cmd: '/compact', desc: '대화 압축' },
+      { cmd: '/diff', desc: '작업 트리 diff 표시' },
+      { cmd: '/mention', desc: '파일 멘션/첨부' },
+      { cmd: '/status', desc: '세션 상태/사용량' },
+      { cmd: '/model', desc: '모델 전환' },
+      { cmd: '/approvals', desc: '승인 모드 변경 (sandbox)' },
+      { cmd: '/new', desc: '새 대화 시작' },
+      { cmd: '/clear', desc: '컨텍스트 초기화' },
+      { cmd: '/quit', desc: '종료' }
+    ]
+  },
+  agy: {
+    label: 'Google Antigravity CLI', asOf: '1.9.265', invoke: 'slash',
+    note: '큐레이션(best-effort) — agy CLI 는 신규 도구라 슬래시 명령이 변동 가능. --refresh(2단계) 또는 사용자 override 권장.',
+    commands: [
+      { cmd: '/help', desc: '명령 목록' },
+      { cmd: '/init', desc: '워크스페이스 초기화' },
+      { cmd: '/model', desc: '모델 전환' },
+      { cmd: '/new', desc: '새 세션' },
+      { cmd: '/clear', desc: '컨텍스트 초기화' },
+      { cmd: '/status', desc: '상태 표시' }
+    ]
+  },
+  grok: {
+    label: 'xAI Grok CLI', asOf: '1.9.268', invoke: 'slash',
+    note: '1.9.268 정식 provider 승격 — slash-commands --refresh 로 자동 probe 가능. 커뮤니티 Grok CLI(@vibe-kit/grok-cli) 기준 큐레이션, 배포판마다 차이 가능.',
+    commands: [
+      { cmd: '/help', desc: '명령 목록' },
+      { cmd: '/clear', desc: '대화 초기화' },
+      { cmd: '/model', desc: '모델 전환 (grok-beta 등)' },
+      { cmd: '/new', desc: '새 대화' },
+      { cmd: '/login', desc: 'xAI API 키 로그인' },
+      { cmd: '/exit', desc: '종료' }
+    ]
+  },
+  copilot: {
+    label: 'GitHub Copilot CLI (gh copilot)', asOf: '1.9.265', invoke: 'subcommand',
+    note: '슬래시가 아닌 gh 하위명령. 호출 형식: gh copilot <sub> "<질의>".',
+    commands: [
+      { cmd: 'suggest', desc: '명령/코드 제안 (gh copilot suggest "...")' },
+      { cmd: 'explain', desc: '명령 설명 (gh copilot explain "...")' },
+      { cmd: 'config', desc: 'gh copilot 설정' }
+    ]
+  },
+  // 1.9.277: 신규 4종 슬래시/세션 명령 (best-effort 큐레이션 — 배포판마다 차이 가능, 사용자 override 권장)
+  opencode: {
+    label: 'opencode', asOf: '1.9.277', invoke: 'slash',
+    note: 'TUI 세션 슬래시 — 배포판마다 차이 가능.',
+    commands: [
+      { cmd: '/help', desc: '명령 목록' }, { cmd: '/new', desc: '새 세션' }, { cmd: '/models', desc: '모델 선택' },
+      { cmd: '/init', desc: '프로젝트 컨텍스트' }, { cmd: '/undo', desc: '되돌리기' }, { cmd: '/share', desc: '세션 공유' }, { cmd: '/exit', desc: '종료' }
+    ]
+  },
+  qwen: {
+    label: 'Qwen Code CLI', asOf: '1.9.277', invoke: 'slash',
+    note: 'Gemini CLI 계열 슬래시(qwen-code) 기준 큐레이션.',
+    commands: [
+      { cmd: '/help', desc: '명령 목록' }, { cmd: '/clear', desc: '컨텍스트 초기화' }, { cmd: '/memory', desc: '메모리 관리' },
+      { cmd: '/tools', desc: '도구 목록' }, { cmd: '/model', desc: '모델 전환' }, { cmd: '/quit', desc: '종료' }
+    ]
+  },
+  aider: {
+    label: 'Aider', asOf: '1.9.277', invoke: 'slash',
+    note: 'aider 세션 내 슬래시 명령 (in-chat commands).',
+    commands: [
+      { cmd: '/add', desc: '파일 컨텍스트 추가' }, { cmd: '/drop', desc: '파일 제거' }, { cmd: '/ask', desc: '코드 수정 없이 질문' },
+      { cmd: '/run', desc: '셸 명령 실행' }, { cmd: '/test', desc: '테스트 실행' }, { cmd: '/diff', desc: '변경 diff' },
+      { cmd: '/commit', desc: '커밋' }, { cmd: '/undo', desc: '마지막 커밋 취소' }, { cmd: '/help', desc: '도움말' }
+    ]
+  },
+  goose: {
+    label: 'Goose (Block)', asOf: '1.9.277', invoke: 'slash',
+    note: 'goose 세션 내 명령 (배포판마다 차이 가능).',
+    commands: [
+      { cmd: '/?', desc: '도움말' }, { cmd: '/mode', desc: '모드 전환(auto/approve/chat)' }, { cmd: '/extension', desc: 'MCP 확장 관리' },
+      { cmd: '/builtin', desc: '빌트인 확장' }, { cmd: '/exit', desc: '종료' }
+    ]
+  }
+};
+
+module.exports = { EXTERNAL_AGENTS, AGENT_SLASH_COMMANDS };

package/package.json

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

package/scripts/e2e.js

@@ -3115,5 +3115,26 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.291 회귀 (UR-0025 2단계): lib/agent-registry.js 모듈 분리 — 단일출처 + 부작용 0
+total++;
+{
+  let ok = false;
+  try {
+    const reg = require(path.resolve(__dirname, '..', 'lib', 'agent-registry.js'));
+    const h = require(path.resolve(__dirname, '..', 'bin', 'harness.js'));
+    const dataOk = Array.isArray(reg.EXTERNAL_AGENTS) && reg.EXTERNAL_AGENTS.length === 10 &&
+      reg.EXTERNAL_AGENTS.every(a => a.id && a.bin && a.envFlag) &&
+      reg.AGENT_SLASH_COMMANDS && Object.keys(reg.AGENT_SLASH_COMMANDS).length === 9;
+    // harness 가 모듈을 단일출처로 사용 (같은 객체 참조)
+    const singleSource = h.AGENT_SLASH_COMMANDS === reg.AGENT_SLASH_COMMANDS;
+    // harness.js 소스에 인라인 정의가 더 이상 없음 (모듈로 이동 완료)
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const movedOut = !/const EXTERNAL_AGENTS = \[/.test(harnessSrc) && /require\('\.\.\/lib\/agent-registry'\)/.test(harnessSrc);
+    ok = dataOk && singleSource && movedOut;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.291) lib/agent-registry 모듈 분리: 단일출처 + 인라인 제거 (UR-0025)' : '✗ agent-registry 모듈 분리 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);