leerness 1.9.244 → 1.9.246

package/CHANGELOG.md

@@ -1,5 +1,110 @@
 # Changelog
 
+## 1.9.246 — 2026-05-26 — UR-0016 REPL UX/UI 개선
+
+**🎯 사용자 명시 (UR-0016): REPL agent 채팅 입력칸 옆 컨텍스트 게이지 + 서브 에이전트 가시화 + 정상 완료 초록색 강조.**
+
+### 사용자 명시 (UR-0016)
+> *"REPL agent 모드의 기능과 UX UI를 개선해줘: 서브 에이전트 활성화 여부, 채팅입력칸 근처에는 컨텍스트 창 게이지 등 표시, 정상완료된 작업은 초록색 등으로 표시. 별도의 신규 프로젝트를 생성하여 직접 REPL agent 모드를 구동하여 유저가 사용하기 쉽게 개선해줘."*
+
+dogfood 검증: `C:\Users\leehy\AppData\Local\Temp\dogfood-1.9.246` 신규 프로젝트에서 `leerness init` + REPL 진입 흐름 직접 검증.
+
+### 1. 컨텍스트 창 게이지 (채팅 입력칸 직전 자동 표시)
+모든 prompt 호출 직전에 status bar 한 줄 자동 출력:
+```
+💬 ctx 12msg ~3.4k/200k ████░░░░░░░░░░ 1.7%  ·  agents: *claude ✓codex ·gemini ·copilot  ·  ▶stream
+```
+- `ctx Nmsg` — 누적 대화 메시지 수
+- `~XXk/YYk` — 추정 토큰 / provider별 컨텍스트 윈도우 (claude 200k, claude-4-7 1M, gpt-5 200k, gpt-4.1 1M, gemini 1M, copilot 64k, ollama 8k)
+- `████░░░░░░░░░░ %` — 14문자 progress bar (50% 이상 cyan, 80% 이상 yellow 경고)
+- 토큰 추정 휴리스틱: `chars / 3.5` (CJK/영문 평균치)
+
+### 2. 서브 에이전트 활성화 가시화 (한 줄 5종 표시)
+- `*claude` — 현재 활성 provider (bold + green)
+- `✓codex` — 설치+인증 완료 ready (green)
+- `·gemini` — 미설치 또는 비활성 (dim)
+- 5종 모두 한 줄에 표시 → 사용자가 즉시 다른 provider 가용성 인지 → Tab 키로 전환
+
+### 3. 정상 완료 작업 초록색 강조 (사용자 명시)
+- assistant 응답 헤더에 `✓` 마커 + `C.green()` 적용
+- stream 모드: `✓ [assistant: claude/sonnet-4-7, role=actor, 1234ms · 567자]` (green)
+- non-stream: `✓ assistant (claude, role=actor, 1234ms)` (green bold)
+- 기존 `[assistant: ...]` (dim) → `✓ [assistant: ...]` (green)
+
+### 4. dogfood 신규 프로젝트 직접 구동 검증
+- 임시 디렉토리에 빈 프로젝트 생성 → `leerness init` 정상 동작 확인
+- `leerness agent --interactive` 진입 흐름 검증 (provider 없음 시 안내 출력)
+- `--version` 등 핵심 명령 동작 확인
+
+### 5. promptWithStatus wrapper 도입
+- `rl.prompt()` 7회 호출처 모두 `promptWithStatus()` 로 통일
+- line handler / cycle / 초기 진입 등 일관된 status bar 노출
+- wrapper 내부 1건만 실제 `rl.prompt()` 호출 (DRY)
+
+### 6. 누적 회귀 (1.9.207~245) — 모두 유지
+- api-skill cache (1.9.245) + CJK 분류 (1.9.243) + env encoding --apply (1.9.242) + 모두 유지
+- handoff JSON 11 필드 · MCP 70 도구 · CJK + py-check + 비정상종료 모두 유지
+
+### 7. stress-v191 — **23/23 PASS · 100%**
+- 1.9.246 (11): VERSION + 4 helper + promptWithStatus + 컨텍스트 bar + sub-agent 가시화 + 초록색 ✓ + dogfood init + 통일성
+- 성능 (1): cold start avg 378ms
+- 누적 회귀 (11): 1.9.207~245
+
+### 8. 자동 release (108 라운드 main-push streak · 69 라운드 npm publish streak · R202)
+
+🎯 **REPL UX 사용자 요구 100% 반영** — 컨텍스트 + 에이전트 + 초록색 강조 통합 status bar.
+
+---
+
+## 1.9.245 — 2026-05-26 — UR-0015 API skill cache
+
+**📚 사용자 명시 (UR-0015): API 문서/관련링크 자동 정리 + AI 자동 참조 시스템.**
+
+### 사용자 명시 (UR-0015)
+> *"API 문서/기능 요청 시 공식 문서·AI 탐색 내용을 스킬처럼 .harness/api-skills/ 에 정리하고 방향 지시도 함께 기록. 이후 같은 API 관련 수정/구현 요청 시 AI 가 정리해둔 파일이 자동 참조. URL 제공 시 본 URL + 관련 링크의 기능까지 참조."*
+
+검증 예시: 쿠팡 상품 생성 API (https://developers.coupangcorp.com/hc/ko/articles/360033877853) — 실 fetch 성공 (title "상품 생성 - Open APIs" + 7 관련 링크 자동 수집).
+
+### 1. `leerness api-skill` CLI 5종
+- `add <url> [--direction "방향"] [--name "..."] [--no-crawl] [--skeleton]` — fetch + same-domain 관련 링크 1단계 crawl (max 10) → `.harness/api-skills/<id>.md`
+- `list [--json]` — 저장된 skill 목록
+- `show <id>` — 특정 skill 본문 출력 (AI 컨텍스트 적재용)
+- `match <query> [--json]` — task 키워드 매칭 (CJK 한글 2자+ / ASCII 3자+ 모두 지원)
+- `drop <id>` — 삭제
+
+### 2. URL Fetch 방식 — 의존성 0 (Node built-in https)
+- Mozilla 호환 User-Agent (Cloudflare/WAF 차단 회피)
+- timeout 10s · max body 1MB · max 5 redirects
+- HTML→text 변환 (script/style 제거, entity decode)
+- same-domain 관련 링크 추출 (max 10, depth=1)
+- 차단 시 (403/401/429) `--skeleton` fallback → 빈 .md 골격 생성
+
+### 3. 자동 참조 — handoff body 자동 노출
+- 현재 in-progress task description 키워드 + skill 매칭 → `## 📚 관련 API skill N건 발견 (참조 권장)`
+- 본 URL + 방향 + 도메인 표시 (top 3)
+- 매칭 0 시: 저장된 skill 수만 hint 표시
+
+### 4. JSON 11번째 통합 필드 `apiSkills` (handoff/session close/health)
+- `{ total, matched, matchedIds, ids }` — 외부 AI 가 단일 호출에서 API skill 컨텍스트 회수
+- JSON 통합 매트릭스 10 → **11 필드** (3 명령 × 11 = 33 통합 포인트)
+
+### 5. MCP **70번째 도구** `leerness_api_skill` 🎉
+- sub: list / show / match / add / drop (외부 AI 가 MCP 호출로 직접 사용)
+
+### 6. 누적 회귀 (1.9.207~244) — 모두 유지
+- REPL HOTFIX (1.9.244) + CJK 분류 (1.9.243) + env encoding --apply (1.9.242) + 모두 유지
+
+### 7. stress-v190 — **26/26 PASS · 100%**
+- 1.9.245 신규 (15): VERSION + helper 함수 + CLI 5종 + 실 fetch + JSON 11 필드 × 3명령 + body 매칭 + skeleton fallback + MCP 70
+- 성능 (1): cold start avg 331ms
+- 누적 회귀 (10): 1.9.207~244
+
+### 8. 자동 release (107 라운드 main-push streak · 68 라운드 npm publish streak)
+
+📚 **API 지식 자동 누적·재사용** — 사용자가 한 번 정리하면 AI가 영구 기억. R201 진입.
+
+---
+
 ## 1.9.244 — 2026-05-26 🎉 R200 + 🚨 HOTFIX
 
 **🚨 HOTFIX: REPL agent ReferenceError `_lastCycleLines` (1.9.189 회귀 버그) + 🎉 R200 마일스톤 도달.**

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.244-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v189-20%2F20-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-69-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-56-brightgreen)]() [![json-fields](https://img.shields.io/badge/JSON_통합-10_필드-blueviolet)]() [![rounds](https://img.shields.io/badge/🎉_R200-마일스톤-success)]() [![main-push](https://img.shields.io/badge/🎉_main--push_streak-106_rounds-success)]() [![npm-streak](https://img.shields.io/badge/🎉_npm--publish-67_streak-success)]() [![hotfix](https://img.shields.io/badge/🚨_HOTFIX-REPL_ReferenceError-red)]() [![perf](https://img.shields.io/badge/cold_start-373ms-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.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)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.244  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.246  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🚨 HOTFIX REPL ReferenceError + 🎉 R200 자율 마일스톤         ║
+  ║  🎯 REPL UX (UR-0016) — 컨텍스트 게이지 + 에이전트 + 초록색 ✓ ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.244';
+const VERSION = '1.9.246';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -2588,6 +2588,338 @@ function envCmd(root, sub) {
   log(dm(`  → JSON 출력: leerness env --json`));
 }
 
+// 1.9.245: API skill cache — 공식 문서 + 관련 링크 자동 정리 (사용자 명시 UR-0015)
+//   .harness/api-skills/<id>.md 에 frontmatter + 본문 저장. handoff 자동 매칭.
+//   Node built-in https (의존성 0), depth=1 same-domain crawl, max 10 links.
+function _apiSkillsDir(root) {
+  return path.join(absRoot(root), '.harness', 'api-skills');
+}
+function _apiSkillId(url, name) {
+  // 도메인 + path slug 로 id 생성. 예: developers.coupangcorp.com/articles/360033877853 → coupang-articles-360033877853
+  try {
+    const u = new URL(url);
+    const host = u.hostname.replace(/^www\./, '').split('.').slice(0, -1).join('-') || u.hostname;
+    const pathSlug = u.pathname.replace(/^\/+|\/+$/g, '').replace(/[^a-z0-9가-힣\-_]+/gi, '-').slice(-50);
+    const base = `${host}-${pathSlug}`.replace(/-+/g, '-').replace(/^-|-$/g, '');
+    return (name ? base + '-' + name.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 30) : base).replace(/-+/g, '-');
+  } catch { return 'api-' + Date.now(); }
+}
+function _fetchUrl(url, opts = {}) {
+  // Node https.get with timeout, follow redirects (max 5), max body 1MB
+  const https = require('https');
+  const http = require('http');
+  const maxRedirects = opts.maxRedirects != null ? opts.maxRedirects : 5;
+  const timeout = opts.timeout || 10000;
+  return new Promise((resolve, reject) => {
+    function go(u, redirects) {
+      let parsed;
+      try { parsed = new URL(u); } catch { return reject(new Error('invalid URL: ' + u)); }
+      if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') return reject(new Error('unsupported protocol: ' + parsed.protocol));
+      const lib = parsed.protocol === 'https:' ? https : http;
+      const req = lib.get({
+        hostname: parsed.hostname, port: parsed.port || (parsed.protocol === 'https:' ? 443 : 80),
+        path: parsed.pathname + parsed.search, timeout,
+        // 1.9.245: 일부 사이트 (Cloudflare/AWS WAF) 가 비-브라우저 UA 차단 → Mozilla 호환 UA 로 호환성 ↑
+        headers: {
+          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 leerness/1.9.245',
+          'Accept': 'text/html,application/xhtml+xml,application/json;q=0.9,*/*;q=0.8',
+          'Accept-Language': 'ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7',
+          'Accept-Encoding': 'identity'
+        }
+      }, res => {
+        // 3xx → follow
+        if ([301, 302, 303, 307, 308].includes(res.statusCode) && res.headers.location && redirects < maxRedirects) {
+          const next = new URL(res.headers.location, u).toString();
+          res.resume(); return go(next, redirects + 1);
+        }
+        let body = ''; let size = 0; const MAX = 1024 * 1024;
+        res.on('data', chunk => { size += chunk.length; if (size > MAX) { res.destroy(); return reject(new Error('body > 1MB')); } body += chunk; });
+        res.on('end', () => resolve({ status: res.statusCode, headers: res.headers, body, finalUrl: u }));
+      });
+      req.on('error', reject);
+      req.on('timeout', () => { req.destroy(); reject(new Error('timeout ' + timeout + 'ms')); });
+    }
+    go(url, 0);
+  });
+}
+function _htmlToText(html) {
+  if (!html) return '';
+  return html
+    .replace(/<script[\s\S]*?<\/script>/gi, '')
+    .replace(/<style[\s\S]*?<\/style>/gi, '')
+    .replace(/<!--[\s\S]*?-->/g, '')
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<\/?(p|div|li|h[1-6]|tr|td|pre)[^>]*>/gi, '\n')
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;/g, "'")
+    .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(parseInt(n, 10)))
+    .replace(/[ \t]+/g, ' ').replace(/\n\s*\n\s*\n+/g, '\n\n').trim();
+}
+function _extractTitle(html) {
+  const m = (html || '').match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+  if (!m) return '';
+  return _htmlToText(m[1]).slice(0, 200);
+}
+function _extractLinks(html, baseUrl, maxLinks) {
+  if (!html) return [];
+  const base = new URL(baseUrl);
+  const found = new Map();
+  const re = /<a\s+[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi;
+  let m;
+  while ((m = re.exec(html)) !== null) {
+    let href = m[1];
+    if (!href || href.startsWith('#') || href.startsWith('javascript:') || href.startsWith('mailto:')) continue;
+    let abs;
+    try { abs = new URL(href, baseUrl).toString(); } catch { continue; }
+    const u = new URL(abs);
+    if (u.hostname !== base.hostname) continue; // same-domain only
+    if (abs === baseUrl) continue;
+    if (found.has(abs)) continue;
+    const text = _htmlToText(m[2]).slice(0, 120);
+    found.set(abs, { url: abs, text });
+    if (found.size >= (maxLinks || 10)) break;
+  }
+  return Array.from(found.values());
+}
+async function _collectAPIDoc(url, opts = {}) {
+  const direction = opts.direction || '';
+  const noCrawl = opts.noCrawl;
+  const r0 = await _fetchUrl(url);
+  if (r0.status >= 400) throw new Error('fetch ' + url + ' → status ' + r0.status);
+  const html = r0.body;
+  const title = _extractTitle(html);
+  const text = _htmlToText(html);
+  const result = { url, title, text: text.slice(0, 8000), related_links: [] };
+  if (!noCrawl) {
+    const links = _extractLinks(html, r0.finalUrl || url, 10);
+    for (const lk of links) {
+      try {
+        const rr = await _fetchUrl(lk.url, { timeout: 8000 });
+        if (rr.status < 400) {
+          const t = _extractTitle(rr.body) || lk.text;
+          const excerpt = _htmlToText(rr.body).slice(0, 400);
+          result.related_links.push({ url: lk.url, title: t.slice(0, 200), excerpt });
+        }
+      } catch {}
+    }
+  }
+  result.direction = direction;
+  result.captured_at = new Date().toISOString();
+  return result;
+}
+function _serializeAPISkill(id, name, urls, direction, doc) {
+  const lines = [];
+  lines.push('---');
+  lines.push(`id: ${id}`);
+  lines.push(`name: ${name}`);
+  lines.push(`urls:`);
+  urls.forEach(u => lines.push(`  - ${u}`));
+  lines.push(`direction: ${JSON.stringify(direction || '')}`);
+  lines.push(`captured_at: ${doc.captured_at}`);
+  if (doc.related_links && doc.related_links.length) {
+    lines.push(`related_links:`);
+    doc.related_links.forEach(rl => lines.push(`  - { url: ${JSON.stringify(rl.url)}, title: ${JSON.stringify(rl.title || '')} }`));
+  }
+  lines.push('---');
+  lines.push('');
+  lines.push(`# ${name}`);
+  lines.push('');
+  if (direction) { lines.push('## 🎯 방향 지시 (사용자 또는 AI)'); lines.push(''); lines.push(direction); lines.push(''); }
+  lines.push('## 📄 본 URL 내용 (정리)');
+  lines.push('');
+  if (doc.title) { lines.push(`**Title:** ${doc.title}`); lines.push(''); }
+  lines.push('```');
+  lines.push(doc.text.slice(0, 6000));
+  lines.push('```');
+  lines.push('');
+  if (doc.related_links && doc.related_links.length) {
+    lines.push('## 🔗 관련 링크 (depth=1, same-domain, max 10)');
+    lines.push('');
+    doc.related_links.forEach(rl => {
+      lines.push(`### ${rl.title || rl.url}`);
+      lines.push(`URL: ${rl.url}`);
+      lines.push('');
+      if (rl.excerpt) { lines.push(rl.excerpt); lines.push(''); }
+    });
+  }
+  return lines.join('\n');
+}
+function _loadAPISkill(root, id) {
+  const fp = path.join(_apiSkillsDir(root), id + '.md');
+  if (!fs.existsSync(fp)) return null;
+  const content = fs.readFileSync(fp, 'utf8');
+  const fm = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!fm) return { id, content, urls: [], name: id };
+  const meta = {};
+  fm[1].split('\n').forEach(l => {
+    const m = l.match(/^(\w+):\s*(.*)$/);
+    if (m) meta[m[1]] = m[2];
+  });
+  const urls = [];
+  const urlMatch = fm[1].match(/urls:\n((?:\s+-\s+.+\n?)+)/);
+  if (urlMatch) urlMatch[1].split('\n').forEach(l => { const u = l.match(/^\s+-\s+(.+)$/); if (u) urls.push(u[1].trim()); });
+  return { id: meta.id || id, name: meta.name || id, urls, direction: (meta.direction || '').replace(/^"|"$/g, ''), captured_at: meta.captured_at, body: fm[2] };
+}
+function _listAPISkills(root) {
+  const dir = _apiSkillsDir(root);
+  if (!fs.existsSync(dir)) return [];
+  return fs.readdirSync(dir).filter(f => f.endsWith('.md')).map(f => f.slice(0, -3))
+    .map(id => _loadAPISkill(root, id)).filter(Boolean);
+}
+function _matchAPISkills(root, query) {
+  if (!query) return [];
+  const q = String(query).toLowerCase();
+  // 1.9.245: CJK 한글/한자 토큰 (2자+) 허용, ASCII 토큰 (3자+)
+  const tokens = q.split(/[\s,.;:/\(\)\[\]\{\}"'`]+/).filter(t => {
+    if (!t) return false;
+    const isCJK = /[　-鿿가-힯]/.test(t);
+    return isCJK ? t.length >= 2 : t.length >= 3;
+  });
+  const skills = _listAPISkills(root);
+  const scored = skills.map(s => {
+    let score = 0;
+    const haystack = (s.name + ' ' + (s.direction || '') + ' ' + s.urls.join(' ') + ' ' + s.body.slice(0, 3000)).toLowerCase();
+    tokens.forEach(t => { if (haystack.includes(t)) score += 1; });
+    return { skill: s, score };
+  }).filter(x => x.score > 0).sort((a, b) => b.score - a.score);
+  return scored.map(x => x.skill);
+}
+async function apiSkillCmd(root, sub) {
+  root = absRoot(root);
+  const isTty = process.stdout && process.stdout.isTTY;
+  const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+  const gr = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+  const yl = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+  const rd = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
+  const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+  const dir = _apiSkillsDir(root);
+  if (sub === 'list') {
+    if (!fs.existsSync(dir)) {
+      if (has('--json')) { log(JSON.stringify({ skills: [] })); return; }
+      log(dm(`(아직 API skill 없음 — leerness api-skill add <url> 으로 생성)`));
+      return;
+    }
+    const skills = _listAPISkills(root);
+    if (has('--json')) {
+      log(JSON.stringify({ skills: skills.map(s => ({ id: s.id, name: s.name, urls: s.urls, captured_at: s.captured_at })) }, null, 2));
+      return;
+    }
+    log(cy(`# leerness api-skill list (1.9.245, UR-0015)`));
+    log('');
+    if (skills.length === 0) { log(dm(`(없음)`)); return; }
+    skills.forEach(s => {
+      log(`  • ${gr(s.id)} — ${s.name}`);
+      if (s.urls && s.urls.length) log(dm(`       ${s.urls[0]}${s.urls.length > 1 ? ` (+${s.urls.length - 1})` : ''}`));
+      if (s.direction) log(dm(`       방향: ${s.direction.slice(0, 80)}`));
+    });
+    return;
+  }
+  // 1.9.245: 위치 인자 robust 추출 — argv 에서 cmd/sub 뒤 첫 non-flag (flag value 도 skip)
+  const _positionalAfterSub = () => {
+    const argv = process.argv.slice(2);  // ['api-skill', sub, ...]
+    let i = 2;  // skip cmd + sub
+    while (i < argv.length) {
+      const a = argv[i];
+      if (a.startsWith('--')) {
+        // --key value 패턴이면 value 도 skip
+        if (i + 1 < argv.length && !argv[i + 1].startsWith('--')) i += 2;
+        else i += 1;
+        continue;
+      }
+      return a;
+    }
+    return null;
+  };
+  if (sub === 'show') {
+    const id = arg('--id') || _positionalAfterSub();
+    if (!id) { log(rd('id 필요: leerness api-skill show <id>')); return; }
+    const s = _loadAPISkill(root, id);
+    if (!s) { log(rd(`api-skill 없음: ${id}`)); return; }
+    if (has('--json')) { log(JSON.stringify(s, null, 2)); return; }
+    log(fs.readFileSync(path.join(dir, id + '.md'), 'utf8'));
+    return;
+  }
+  if (sub === 'match') {
+    const query = arg('--query') || _positionalAfterSub() || '';
+    const matches = _matchAPISkills(root, query);
+    if (has('--json')) {
+      log(JSON.stringify({ query, matches: matches.map(s => ({ id: s.id, name: s.name })) }, null, 2));
+      return;
+    }
+    log(cy(`# leerness api-skill match "${query}" — ${matches.length}건`));
+    matches.forEach(s => log(`  • ${gr(s.id)} — ${s.name}`));
+    if (matches.length === 0) log(dm(`(매칭 없음)`));
+    return;
+  }
+  if (sub === 'drop') {
+    const id = arg('--id') || _positionalAfterSub();
+    if (!id) { log(rd('id 필요: leerness api-skill drop <id>')); return; }
+    const fp = path.join(dir, id + '.md');
+    if (!fs.existsSync(fp)) { log(rd(`없음: ${id}`)); return; }
+    fs.unlinkSync(fp);
+    log(gr(`✓ 삭제: ${id}`));
+    return;
+  }
+  if (sub === 'add') {
+    const url = arg('--url') || _positionalAfterSub();
+    if (!url) { log(rd('URL 필요: leerness api-skill add <url> [--direction "..."]')); return; }
+    const direction = arg('--direction', '');
+    const name = arg('--name', '');
+    const noCrawl = has('--no-crawl');
+    log(cy(`# leerness api-skill add (1.9.245, UR-0015)`));
+    log(`  URL: ${url}`);
+    if (direction) log(`  방향: ${direction}`);
+    log(dm(`  Fetch + crawl (depth=1, same-domain, max 10)...`));
+    try {
+      const doc = await _collectAPIDoc(url, { direction, noCrawl });
+      const skillName = name || doc.title || new URL(url).hostname;
+      const id = _apiSkillId(url, name);
+      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+      const md = _serializeAPISkill(id, skillName, [url], direction, doc);
+      fs.writeFileSync(path.join(dir, id + '.md'), md, 'utf8');
+      log(gr(`✓ 저장: .harness/api-skills/${id}.md`));
+      log(dm(`  title: ${doc.title || '(none)'}`));
+      log(dm(`  related links: ${(doc.related_links || []).length}`));
+      log(dm(`  text size: ${doc.text.length} chars`));
+      if (has('--json')) log(JSON.stringify({ id, name: skillName, url, related_count: (doc.related_links || []).length }, null, 2));
+    } catch (e) {
+      log(rd(`✗ Fetch 실패: ${e.message}`));
+      // 1.9.245: --skeleton fallback — Cloudflare/WAF 차단된 URL 도 빈 .md 골격 생성 → 사용자가 수동 채움
+      if (has('--skeleton') || /403|401|429/.test(e.message)) {
+        const skillName = name || new URL(url).hostname;
+        const id = _apiSkillId(url, name);
+        if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+        const stub = {
+          url, title: skillName, text: `(fetch 실패 — 사용자가 직접 ${url} 에서 내용을 복사해 채워주세요)`,
+          related_links: [], captured_at: new Date().toISOString(), direction
+        };
+        const md = _serializeAPISkill(id, skillName, [url], direction, stub);
+        fs.writeFileSync(path.join(dir, id + '.md'), md, 'utf8');
+        log(yl(`⚠ 빈 골격 생성 (--skeleton fallback): .harness/api-skills/${id}.md`));
+        log(dm(`  → 직접 ${url} 내용을 복사해서 .md 파일에 채워넣어주세요`));
+        log(dm(`  → 이후 leerness handoff 가 매칭 시 참조됩니다`));
+        if (has('--json')) log(JSON.stringify({ id, skeleton: true, url, name: skillName }, null, 2));
+      } else {
+        process.exitCode = 1;
+      }
+    }
+    return;
+  }
+  // help
+  log(cy(`# leerness api-skill (1.9.245, UR-0015) — API 문서·관련링크 자동 정리`));
+  log('');
+  log(`  add <url> [--direction "..."] [--name "..."] [--no-crawl]`);
+  log(`     URL 페치 + same-domain 관련 링크 1단계 crawl (max 10) → .harness/api-skills/<id>.md`);
+  log(`  list [--json]                  → 저장된 api-skill 목록`);
+  log(`  show <id>                      → 특정 skill 본문 출력`);
+  log(`  match <query> [--json]         → task 키워드 매칭`);
+  log(`  drop <id>                      → 삭제`);
+  log('');
+  log(dm(`  저장: .harness/api-skills/<id>.md (frontmatter: id/name/urls/direction/captured_at/related_links)`));
+  log(dm(`  fetch: Node built-in https (의존성 0), max 1MB body, 10s timeout, 5 redirect`));
+  log(dm(`  자동 참조: handoff body 에 매칭 N건 자동 노출 (현재 task 키워드)`));
+}
+
 // 1.9.231: leerness pulse — 한 줄 종합 요약 (10 핵심 지표)
 //   handoff 헤드라인의 축약 버전 — 사용자가 빠르게 상태 파악
 //   응답 (--json): { version, roundCount, mcpTools, memorySurface, security, health, driftScore, nextMilestone, etaDays, abnormal }
@@ -6629,6 +6961,25 @@ function handoff(root) {
           encodingRiskFiles: encScan.atRisk.slice(0, 5).map(r => r.file)
         };
       } catch {}
+      // 1.9.245: apiSkills 통합 (handoff JSON 11번째 통합 필드) — UR-0015 API 문서 캐시
+      //   현재 task 키워드 기반 매칭 + 전체 카운트
+      try {
+        const allSkills = _listAPISkills(root);
+        // 현재 task description 추출 (간단 휴리스틱: progress-tracker in-progress 첫 row)
+        let currentTaskText = '';
+        try {
+          const rows = readProgressRows(root);
+          const ip = rows.find(r => r.status === 'in-progress');
+          if (ip) currentTaskText = (ip.title || '') + ' ' + (ip.notes || '');
+        } catch {}
+        const matched = currentTaskText ? _matchAPISkills(root, currentTaskText) : [];
+        result.apiSkills = {
+          total: allSkills.length,
+          matched: matched.length,
+          matchedIds: matched.slice(0, 5).map(s => s.id),
+          ids: allSkills.slice(0, 10).map(s => s.id)
+        };
+      } catch {}
     } catch {}
     try {
       const pwState = _loadPreWakeReport(root);
@@ -6995,6 +7346,40 @@ function handoff(root) {
     }
   } catch {}
 
+  // 1.9.245: API skill cache 자동 참조 (사용자 명시 UR-0015)
+  //   현재 task 키워드 기반으로 .harness/api-skills/ 매칭 → 사용자가 정리해둔 API 문서 자동 노출
+  try {
+    const allSkills = _listAPISkills(root);
+    if (allSkills.length > 0) {
+      let currentTaskText = '';
+      try {
+        const rows = readProgressRows(root);
+        const ip = rows.find(r => r.status === 'in-progress');
+        if (ip) currentTaskText = (ip.title || '') + ' ' + (ip.notes || '');
+      } catch {}
+      const matched = currentTaskText ? _matchAPISkills(root, currentTaskText) : [];
+      if (matched.length > 0) {
+        const isTty = process.stdout && process.stdout.isTTY;
+        const cy5 = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+        const gr5 = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+        const dm5 = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+        log('');
+        log(cy5(`## 📚 관련 API skill ${matched.length}건 발견 (1.9.245, UR-0015) — 참조 권장`));
+        matched.slice(0, 3).forEach(s => {
+          log(gr5(`  • ${s.id} — ${s.name}`));
+          if (s.urls && s.urls.length) log(dm5(`       ${s.urls[0]}${s.urls.length > 1 ? ` (+${s.urls.length - 1})` : ''}`));
+          if (s.direction) log(dm5(`       방향: ${s.direction.slice(0, 100)}`));
+        });
+        if (matched.length > 3) log(dm5(`  ... +${matched.length - 3}건 더`));
+        log(dm5(`  → 본문: leerness api-skill show <id> | leerness api-skill list`));
+      } else {
+        const isTty = process.stdout && process.stdout.isTTY;
+        const dm5 = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+        log(dm5(`📚 API skill ${allSkills.length}건 저장됨 (현재 task 매칭 0 — leerness api-skill list)`));
+      }
+    }
+  } catch {}
+
   // 1.9.237: handoff 본문 release/* 누적 경고 — 50+ branches merged 시 자동 안내
   //   1.9.220 비정상종료 release-branch-pending 신호의 본문 보강 (handoff 헤드라인은 ‘🔌 비정상종료’ 만 표시)
   try {
@@ -10871,6 +11256,23 @@ function sessionClose(root, opts = {}) {
           encodingRiskFiles: encScan.atRisk.slice(0, 5).map(r => r.file)
         };
       } catch {}
+      // 1.9.245: apiSkills 통합 (session close JSON 11번째 통합 필드) — UR-0015
+      try {
+        const allSkills = _listAPISkills(root);
+        let currentTaskText = '';
+        try {
+          const rows = readProgressRows(root);
+          const ip = rows.find(r => r.status === 'in-progress');
+          if (ip) currentTaskText = (ip.title || '') + ' ' + (ip.notes || '');
+        } catch {}
+        const matched = currentTaskText ? _matchAPISkills(root, currentTaskText) : [];
+        jsonResult.apiSkills = {
+          total: allSkills.length,
+          matched: matched.length,
+          matchedIds: matched.slice(0, 5).map(s => s.id),
+          ids: allSkills.slice(0, 10).map(s => s.id)
+        };
+      } catch {}
     } catch {}
     try {
       // 1.9.209: pre-wake-audit 자동 실행 + 저장 (sleep 전 자동 점검)
@@ -15060,7 +15462,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_release_cleanup', description: '1.9.236 (1.9.235 자동 회수) — local release/* branches 정리. main 에 merge된 것만 후보 (unmerged 보호, 현재 branch 보호). 응답: { apply, keep, total, merged, unmerged, deleteCount, toDelete[], recent[], unmergedSample[] }. 외부 AI가 "운영 누적 release branches 정리 가능?"을 회수. 기본 dry-run, apply: true 시에만 실 삭제. 인자: { path?, apply? (default false), keep? (default 5) }', inputSchema: { type: 'object', properties: { path: { type: 'string' }, apply: { type: 'boolean' }, keep: { type: 'number' } } } },
     { name: 'leerness_py_check', description: '1.9.239 (사용자 명시 UR-0013) — Python 파일 분석. 의존성 0 regex fallback. .md 외 .py 도 leerness 인지. 응답: { totalFiles, totalLOC, totalImports, totalFuncs, totalClasses, totalTodos, biggest: [{ file, loc, funcs, classes }] }. 외부 AI가 "이 프로젝트 Python 표면이 얼마나 되나"를 회수. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_agent_mode', description: '1.9.239 (사용자 명시 UR-0013) — 자율 모드 전용 통합 명령. start: handoff + drift --auto-fix + session-resume --auto-fix (진입). tick: pulse 한 줄 (매 라운드). stop: session close --auto-apply-delivered --auto-cleanup-branches (마감). 외부 AI 가 자율 라운드 진입/매 라운드/마감을 단일 호출로 수행. 인자: { path?, sub (required: "start"|"tick"|"stop"|"help") }', inputSchema: { type: 'object', properties: { path: { type: 'string' }, sub: { type: 'string', enum: ['start', 'tick', 'stop', 'help'] } }, required: ['sub'] } },
-    { name: 'leerness_env_info', description: '1.9.241 (사용자 명시 UR-0014) — 환경 종합 정보 회수. OS / 언어 (LANG, 코드페이지) / 한국어 Windows / 하드웨어 / 터미널 (TTY, PowerShell 버전) / 도구 버전 (git, npm, python). 외부 AI 가 환경 호환성을 미리 인지 → 인코딩 오류 예방. 응답: { os, node, locale, hardware, terminal, tools }. 인자: { path?, encodingCheck? }. encodingCheck: true 시 셸 스크립트 (.ps1/.bat/.cmd/.sh) BOM 없는 비-ASCII 위험 감지', inputSchema: { type: 'object', properties: { path: { type: 'string' }, encodingCheck: { type: 'boolean' } } } }
+    { name: 'leerness_env_info', description: '1.9.241 (사용자 명시 UR-0014) — 환경 종합 정보 회수. OS / 언어 (LANG, 코드페이지) / 한국어 Windows / 하드웨어 / 터미널 (TTY, PowerShell 버전) / 도구 버전 (git, npm, python). 외부 AI 가 환경 호환성을 미리 인지 → 인코딩 오류 예방. 응답: { os, node, locale, hardware, terminal, tools }. 인자: { path?, encodingCheck? }. encodingCheck: true 시 셸 스크립트 (.ps1/.bat/.cmd/.sh) BOM 없는 비-ASCII 위험 감지', inputSchema: { type: 'object', properties: { path: { type: 'string' }, encodingCheck: { type: 'boolean' } } } },
+    { name: 'leerness_api_skill', description: '1.9.245 (사용자 명시 UR-0015) — API 문서·관련링크 자동 캐시. 공식 API 문서 URL을 fetch 하고 1단계 same-domain 관련 링크까지 정리 → .harness/api-skills/<id>.md 저장. 후속 같은 API 관련 작업 시 자동 참조. 응답: list (skills 배열) / show (전체 본문) / match (task 매칭 결과). 인자: { path?, sub ("list"|"show"|"match"|"add"|"drop"), url? (add), id? (show/drop), query? (match), direction? (add: 구현 방향 텍스트) }. 외부 AI가 "이 프로젝트 어떤 API 문서가 정리되어 있나?" / "내 작업과 매칭되는 API skill 있나?" 회수.', inputSchema: { type: 'object', properties: { path: { type: 'string' }, sub: { type: 'string', enum: ['list', 'show', 'match', 'add', 'drop'] }, url: { type: 'string' }, id: { type: 'string' }, query: { type: 'string' }, direction: { type: 'string' } }, required: ['sub'] } }
   ];
 
   function send(obj) {
@@ -15249,6 +15652,14 @@ function mcpServeCmd(root) {
             // 1.9.241 (UR-0014): 환경 종합 + 인코딩 위험 감지
             cliArgs = ['env', args.encodingCheck === true ? 'encoding' : 'summary', '--path', targetPath, '--json'];
             break;
+          case 'leerness_api_skill':
+            // 1.9.245 (UR-0015): API skill cache — list/show/match/add/drop
+            cliArgs = ['api-skill', args.sub || 'list', '--path', targetPath, '--json'];
+            if (args.sub === 'add' && args.url) cliArgs.push('--url', args.url);
+            if (args.sub === 'add' && args.direction) cliArgs.push('--direction', args.direction);
+            if ((args.sub === 'show' || args.sub === 'drop') && args.id) cliArgs.push('--id', args.id);
+            if (args.sub === 'match' && args.query) cliArgs.push('--query', args.query);
+            break;
           case 'leerness_release_cleanup':
             // 1.9.236 (1.9.235): local release/* branches 정리
             cliArgs = ['release', 'cleanup', '--json'];
@@ -16391,6 +16802,74 @@ async function _agentRepl(root, opts) {
     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(']>')} `);
   };
+  // 1.9.246: REPL UX/UI 개선 (사용자 명시 UR-0016) — 컨텍스트 게이지 + 서브 에이전트 가시화 + 정상 작업 강조
+  //   3종 통합 status bar를 채팅 입력칸 직전에 표시.
+  const _maxContextTokens = (provider, model) => {
+    // provider/model 별 컨텍스트 윈도우 (대략값, 사용자 정보 제공용)
+    const m = (model || '').toLowerCase();
+    if (provider === 'claude') {
+      if (m.includes('opus-4-7') || m.includes('sonnet-4-7') || m.includes('4-7')) return 1000000; // 1M extended
+      if (m.includes('opus') || m.includes('sonnet') || m.includes('haiku')) return 200000;
+      return 200000;
+    }
+    if (provider === 'codex' || provider === 'openai') {
+      if (m.includes('gpt-5') || m.includes('5.5')) return 200000;
+      if (m.includes('gpt-4-1') || m.includes('4.1')) return 1000000;
+      if (m.includes('gpt-4')) return 128000;
+      return 128000;
+    }
+    if (provider === 'gemini') return 1000000;       // 2M까지 가능하지만 보수적으로 1M
+    if (provider === 'copilot') return 64000;
+    if (provider === 'ollama') return 8000;          // 모델별 다르나 default 8k
+    return 100000;
+  };
+  const _estimateTokens = (history) => {
+    // 단순 휴리스틱: 영문 4chars=1tok, CJK 2chars=1tok 평균치 → 3.5chars/tok
+    let totalChars = 0;
+    for (const m of (history || [])) totalChars += (m.content || '').length;
+    return Math.round(totalChars / 3.5);
+  };
+  const _renderStatusBar = () => {
+    if (!isTty) return;
+    try {
+      // (1) 컨텍스트 게이지
+      const msgs = (state.history || []).length;
+      const tokens = _estimateTokens(state.history);
+      const maxTok = _maxContextTokens(state.provider, state.model);
+      const ratio = Math.min(1, tokens / maxTok);
+      const pct = Math.round(ratio * 100);
+      const barWidth = 14;
+      const filled = Math.round(ratio * barWidth);
+      const bar = '█'.repeat(filled) + '░'.repeat(barWidth - filled);
+      const barColor = pct >= 80 ? C.yel : (pct >= 50 ? C.cy : C.green);
+      const tokStr = tokens >= 1000 ? `${(tokens / 1000).toFixed(1)}k` : `${tokens}`;
+      const maxStr = maxTok >= 1000 ? `${Math.round(maxTok / 1000)}k` : `${maxTok}`;
+      // (2) 서브 에이전트 활성화 — EXTERNAL_AGENTS 5종 + ollama
+      let ready = [];
+      try {
+        ready = EXTERNAL_AGENTS
+          .map(a => ({ id: a.id, st: _checkAgent(a).status }))
+          .filter(x => x.st === 'ready');
+      } catch {}
+      const allAgents = ['claude', 'codex', 'gemini', 'copilot'];
+      const subBar = allAgents.map(id => {
+        if (id === state.provider) return C.bold(C.green(`*${id}`));
+        const isReady = ready.find(r => r.id === id);
+        return isReady ? C.green(`✓${id}`) : C.dim(`·${id}`);
+      }).join(' ');
+      // (3) 한 줄 출력
+      const line = '  ' + C.dim('💬 ctx ') + C.bold(`${msgs}msg`) + C.dim(` ~${tokStr}/${maxStr} `) + barColor(bar) + C.dim(` ${pct}%`)
+                 + C.dim('  ·  agents: ') + subBar
+                 + C.dim('  ·  ') + (state.streamMode ? C.green('▶stream') : C.dim('□stream'));
+      process.stdout.write(line + '\n');
+    } catch {}
+  };
+  // 1.9.246: rl.prompt() wrapper — status bar 자동 표시 (사용자 명시 UR-0016)
+  const promptWithStatus = (forceRedraw) => {
+    _renderStatusBar();
+    if (forceRedraw === true) rl.prompt(true);
+    else rl.prompt();
+  };
   rl.setPrompt(prompt());
 
   // 1.9.244 HOTFIX: _lastCycleLines 를 outer 스코프로 hoist
@@ -16552,7 +17031,8 @@ async function _agentRepl(root, opts) {
     log(C.dim('  💡 메시지는 직접 입력 · "/" 또는 ":" 접두사로 명령 호출 · Tab=provider · Shift+Tab=model'));
     log('');
   };
-  rl.prompt();
+  // 1.9.246: 첫 prompt 표시 전에도 status bar 노출 (사용자 명시 UR-0016)
+  promptWithStatus();
   const handleMeta = async (cmd) => {
     const [op, ...rest] = cmd.slice(1).split(/\s+/);
     if (op === 'quit' || op === 'exit' || op === 'q') {
@@ -16842,24 +17322,24 @@ async function _agentRepl(root, opts) {
     rl.on('line', async (line) => {
       const input = line.trim();
       _lastCycleLines = 0;  // 1.9.189: 사용자 입력 시 cycle overwrite 추적 reset
-      if (!input) { rl.prompt(); return; }
+      if (!input) { promptWithStatus(); return; }
       // 1.9.189 (사용자 명시): "/" slash 입력만으로 명령 list 표시 (claude code 영감).
       //   "/" 단독 → 명령 list 출력 후 prompt 복귀.
       //   "/help", "/quit" 등 "/" 접두사 → ":" 동등 처리 (alias).
       if (input === '/' || input === '/?') {
         _showSlashCommandList();
-        rl.prompt(); return;
+        promptWithStatus(); return;
       }
       // 1.9.189: "/" 접두사를 ":" 와 동등하게 처리 (사용자 명시 — "/ 가 모든 모델 공통 권한 trigger default")
       if (input.startsWith('/') && !input.startsWith('//')) {
         const shouldQuit = await handleMeta(':' + input.slice(1));
         if (shouldQuit) { resolve(); return; }
-        rl.prompt(); return;
+        promptWithStatus(); return;
       }
       if (input.startsWith(':')) {
         const shouldQuit = await handleMeta(input);
         if (shouldQuit) { resolve(); return; }
-        rl.prompt(); return;
+        promptWithStatus(); return;
       }
       // LLM 호출
       state.history.push({ role: 'user', content: input });
@@ -16882,18 +17362,19 @@ async function _agentRepl(root, opts) {
         }
       } else {
         log(C.yel(`  ⚠ ${state.provider} provider 미지원 — :provider ollama|claude|codex|gemini|copilot`));
-        rl.prompt(); return;
+        promptWithStatus(); return;
       }
       const dt = Date.now() - t0;
       _recordRun(root, { kind: 'agent_repl_turn', provider: state.provider, model: state.model, role: state.role, durationMs: dt, ok: result.ok, error: result.error, promptChars: finalPrompt.length, responseChars: (result.response || '').length });
       if (result.ok) {
         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)) {
-          log(C.dim(`  [assistant: ${state.provider}/${state.model || 'default'}, role=${state.role}, ${dt}ms · ${result.response.length}자]`));
+          log(C.green(`  ✓ [assistant: ${state.provider}/${state.model || 'default'}, role=${state.role}, ${dt}ms · ${result.response.length}자]`));
         } else {
           log('');
-          log(C.bold(`assistant (${state.model || state.provider}, role=${state.role}, ${dt}ms)`));
+          log(C.green(`✓ assistant (${state.model || state.provider}, role=${state.role}, ${dt}ms)`));
           log(result.response);
         }
         // 1.9.188 (사용자 명시): 응답 끝 + 입력 구분선 (입력칸 시각 명확)
@@ -16924,7 +17405,7 @@ async function _agentRepl(root, opts) {
           }
         } catch {}
       }
-      rl.prompt();
+      promptWithStatus();
     });
     rl.on('close', () => { saveSession(); resolve(); });
   });
@@ -17511,6 +17992,23 @@ function healthCmd(root) {
       encodingRiskFiles: encScan.atRisk.slice(0, 5).map(r => r.file)
     };
   } catch { out.envInfo = { error: 'envInfo 점검 실패' }; }
+  // 1.9.245: health --json apiSkills 통합 (3 명령 11 필드 — UR-0015)
+  try {
+    const allSkills = _listAPISkills(root);
+    let currentTaskText = '';
+    try {
+      const rows = readProgressRows(root);
+      const ip = rows.find(r => r.status === 'in-progress');
+      if (ip) currentTaskText = (ip.title || '') + ' ' + (ip.notes || '');
+    } catch {}
+    const matched = currentTaskText ? _matchAPISkills(root, currentTaskText) : [];
+    out.apiSkills = {
+      total: allSkills.length,
+      matched: matched.length,
+      matchedIds: matched.slice(0, 5).map(s => s.id),
+      ids: allSkills.slice(0, 10).map(s => s.id)
+    };
+  } catch { out.apiSkills = { error: 'apiSkills 점검 실패' }; }
   // 1.9.163: 5능력 매트릭스 자동 평가 (1.9.155 sub-agent 점검 → 코드 기반 자동화)
   //   각 능력을 코드 grep 으로 검출 → 0~100 점수. 사용자가 매 health 호출 시 leerness 자기 평가 확인.
   try {
@@ -18960,6 +19458,8 @@ async function main() {
   //   기존 env check/sync/detect (1.9.71) 와 충돌하지 않음 — summary/encoding 신규 서브
   if (cmd === 'env' && (args[1] === 'summary' || args[1] === 'encoding' || args[1] === 'encoding-check'))
     return envCmd(arg('--path', process.cwd()), args[1] === 'summary' ? null : 'encoding-check');
+  // 1.9.245: API skill cache — 공식 문서·관련링크 자동 정리 (사용자 명시 UR-0015)
+  if (cmd === 'api-skill')                           return apiSkillCmd(arg('--path', process.cwd()), args[1] || 'help');
   // 1.9.208: leerness constraints <list|check|add> — 플랫폼/API 제약 사전 체크 (사용자 명시)
   if (cmd === 'constraints')                        return constraintsCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   // 1.9.209: leerness pre-wake-audit — sleep 전 sub-agent audit (사용자 명시)

package/package.json

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