leerness 1.9.181 → 1.9.183

package/CHANGELOG.md

@@ -1,5 +1,180 @@
 # Changelog
 
+## 1.9.183 — 2026-05-21
+
+**📦 npm i leerness + 구버전 자동 감지/경고/업데이트 명령어 안내 (사용자 명시 3종).**
+
+자율 모드 113 라운드. 사용자 명시:
+1. *"(vercel/anthropic) 표기는 제거"* → 일반화
+2. *"vercel/anthropic 포함한 다른 공식 스킬도 자동 탐색하는 게 맞는지 확인"* → 검증 통과
+3. *"npm i leerness 사용 가능하게 + 구버전 감지/경고/업데이트 명령어 안내"* → 모든 명령에 stale check 진입
+
+### 1. 표기 일반화
+```diff
+- 🌐 공식 catalog 자동 탐색 (vercel/anthropic) · 자가 성장형
++ 🌐 공식 catalog 자동 탐색 · 자가 성장형 · 구버전 감지/안내
+```
+
+### 2. 다른 공식 catalog 자동 탐색 확인 (live)
+```bash
+$ leerness skill discover --all-presets
+  fetching vercel-labs/agent-skills...
+  ✓ vercel-labs/agent-skills: 8개 skill 발견
+  fetching anthropics/skills...
+  ✓ anthropics/skills: 17개 skill 발견
+전체 25건
+```
+**vercel + anthropic 모두 정상 작동**. 다른 공식 organization은 `--github <owner/repo>` 옵션으로 즉시 추가 가능 (`vercel-labs/agent-skills`, `anthropics/skills` 외에 새 공식 등장 시 preset 등록).
+
+조사 결과 — 1.9.183 시점 표준 SKILL.md 카탈로그를 갖춘 공식 organization:
+- `vercel-labs/agent-skills` (8개) ← preset `vercel`
+- `anthropics/skills` (17개) ← preset `anthropic`
+- `modelcontextprotocol/servers` — SKILL.md 형식 아님 (MCP server 구현 — leerness skill 호환성 X)
+- 기타 — 미발견. 새 공식 등장 시 즉시 preset 등록 가능.
+
+### 3. 구버전 자동 감지 강화 (모든 명령)
+**Before**: init/migrate 시점만 stale check (다른 명령은 skip)
+**After**: 거의 모든 명령 시점에 stale check (init/migrate/mcp/release/version/help 제외 — 출력 민감 명령은 skip)
+
+```js
+// 1.9.183 (사용자 명시): 모든 명령 시점에서 구버전 감지 + 경고 + 업데이트 명령어 안내
+const _staleSkip = new Set(['init', 'migrate', 'usage', 'mcp', 'release', 'session-close', '--version', '--help', 'help', 'update', 'whats-new']);
+if (!_staleSkip.has(cmd) && process.env.LEERNESS_NO_STALE_CHECK !== '1' && !has('--no-stale-check')) {
+  const cached = readUpdateCache(root);
+  if (cacheFresh(cached, 24) && cached.nextLeerness && compareVer(cached.nextLeerness, VERSION) > 0) {
+    process.stderr.write(`  ⚠ leerness v${VERSION} → v${cached.nextLeerness} 사용 가능 · npm i leerness@latest 권장 ...`);
+  }
+}
+```
+
+**실 동작 검증** (캐시 시뮬레이션):
+```
+$ leerness audit .
+  ⚠ leerness v1.9.183 → v1.9.999 사용 가능 · npm i leerness@latest 권장 (LEERNESS_NO_STALE_CHECK=1 로 끄기)
+✓ no duplicate design guide candidates
+[...]
+```
+
+### 4. `npm i leerness` 첫 권장 (글로벌 → 로컬 우선)
+init 시점 stale 메시지도 갱신:
+```
+해결 — 셋 중 하나 실행 후 다시 시도:
+  npm i leerness@latest                  # 프로젝트 로컬 설치 (1.9.183 권장)
+  npm i -g leerness@latest               # 글로벌 설치
+  npx --yes clear-npx-cache && npx leerness@latest init .
+```
+
+### npm registry 상태
+```bash
+$ npm view leerness version
+1.9.182  ← 직전 publish
+$ npm view leerness dist-tags
+{ latest: '1.9.182' }
+```
+이번 라운드 release sync-main 후 `latest: '1.9.183'` 으로 자동 갱신.
+
+### Verified
+- stress-v128: **16/16** (사용자 명시 3 + 구버전 감지 4 + npm 배포 2 + VERSION+누적 7)
+- e2e 217/217 baseline 유지
+- VERSION = 1.9.183 · autonomous-rounds = 113 · main 자동 push 44 라운드 연속
+
+---
+
+## 1.9.182 — 2026-05-21
+
+**🌐 공식 조직 스킬 catalog 자동 탐색 — vercel-labs/agent-skills + anthropics/skills 직접 통합 (사용자 명시).**
+
+자율 모드 112 라운드. 사용자 명시: *"공식 조직의 스킬 모음을 탐색해서 다운로드 받아서 스킬을 사용하는지 확인 (vercel-labs/agent-skills, anthropics/skills) + 지금 설계하는 방향이 올바른지 판단도 너가 해줘"*.
+
+### 핵심 추가
+
+#### 1. `SKILL_CATALOG_PRESETS` — 내장 공식 catalog
+```js
+const SKILL_CATALOG_PRESETS = {
+  'vercel':    { owner: 'vercel-labs', repo: 'agent-skills', branch: 'main', path: 'skills' },
+  'anthropic': { owner: 'anthropics',  repo: 'skills',       branch: 'main', path: 'skills' }
+};
+```
+
+#### 2. `_fetchGitHubSkills(owner, repo, branch, dirPath)` — GitHub Contents API 직접 호출
+- rate limit: 60 req/hr (LEERNESS_GITHUB_TOKEN 시 5000 req/hr)
+- 응답을 표준 entry 형식으로 변환 (name, url, description, source, homepage)
+- raw.githubusercontent.com URL 자동 구성
+
+#### 3. `leerness skill discover` 확장
+```bash
+$ leerness skill discover --preset anthropic
+# leerness skill discover (1.9.182 — GitHub presets)
+targets: anthropics/skills#main:skills
+  fetching anthropics/skills...
+  ✓ anthropics/skills: 17개 skill 발견
+전체 17건 (전체 표시 — 매칭 없음)
+
+| name | source | url |
+|---|---|---|
+| algorithmic-art | github:anthropics/skills | https://raw.githubusercontent.com/anthropics/skills/main/skills/algorithmic-art/SKILL.md |
+| mcp-builder | github:anthropics/skills | https://raw.githubusercontent.com/anthropics/skills/main/skills/mcp-builder/SKILL.md |
+| ...
+```
+
+신규 옵션:
+- `--preset <name>` — 내장 catalog (vercel, anthropic)
+- `--all-presets` — 모든 preset 동시 탐색
+- `--github owner/repo[#branch][:path]` — 직접 GitHub repo 지정
+
+#### 4. `leerness skill auto-install` — 신규 명령 (사용자 명시 핵심)
+```bash
+$ leerness skill auto-install --query "mcp"
+# leerness skill auto-install (1.9.182)
+presets: vercel, anthropic
+query: mcp
+mode: 🟡 dry-run (LEERNESS_SKILL_AUTO_INSTALL=1 또는 --yes 필요)
+  fetching anthropics/skills...
+  ✓ anthropics/skills: 17개 skill
+매칭 1/17건 (query: mcp)
+| mcp-builder | github:anthropics/skills | https://raw.githubusercontent.com/anthropics/skills/main/skills/mcp-builder/SKILL.md |
+
+💡 자동 install 활성화: .env 에 LEERNESS_SKILL_AUTO_INSTALL=1 또는 leerness skill auto-install --yes
+```
+
+- handoff 컨텍스트에서 자동 query 추출 (진행 task 키워드)
+- LEERNESS_SKILL_AUTO_INSTALL=1 시 실제 다운로드 (보안 opt-in)
+- 미설정 시 dry-run (추천만)
+
+#### 5. .env.example 보강
+```
+LEERNESS_SKILL_AUTO_INSTALL=0
+LEERNESS_SKILL_AUTO_PRESETS=vercel,anthropic
+```
+
+### 실 검증 (live GitHub API)
+- **anthropics/skills 17개 skill 자동 발견**:
+  algorithmic-art, brand-guidelines, canvas-design, claude-api, doc-coauthoring, **docx**, frontend-design, internal-comms, **mcp-builder**, **pdf**, **pptx**, skill-creator, slack-gif-creator, theme-factory, web-artifacts-builder, **webapp-testing**, **xlsx**
+- **mcp-builder 실 다운로드 + 설치 성공**:
+  `leerness-stress/.harness/skills/mcp-builder/SKILL.md` 다운로드 검증
+  description: "Guide for creating high-quality MCP (Model Context Protocol) servers..."
+
+### 방향성 평가 보고서 (사용자 명시)
+사용자 요청: *"지금 설계하는 방향이 올바른 방향인지 판단도 너가 해줘"*. 보고서: `_reports/direction-1.9.182.md` (비공개).
+
+**결론**:
+| 평가 항목 | 점수 |
+|---|---|
+| 자율성 (auto loop · review · install) | 8.5/10 |
+| 성장성 (learn · suggest · skill catalog) | 8/10 |
+| 안전성 (sandbox · permissions · env opt-in) | 9/10 |
+| 범용성 (multi-provider · MCP · bridges) | 8/10 |
+| 검증 가능성 (verify-claim · stress · e2e) | 9.5/10 |
+
+**종합**: 86/100. **올바른 방향**. 약점은 *스킬 적용 후 회고 부재 + 외부 스킬 신뢰성 검증* — 1.9.183~190 마일스톤.
+
+### Verified
+- stress-v127: **16/16** (preset 4 + .env 라우팅 2 + 실 GitHub fetch 3 + VERSION+누적 회귀 7)
+- e2e 217/217 baseline 유지
+- VERSION = 1.9.182 · autonomous-rounds = 112 · main 자동 push 43 라운드 연속
+
+---
+
 ## 1.9.181 — 2026-05-21
 
 **🚪 REPL 진입 흐름 정리 — 사용자 명시 4종 + 직접 구동 실 호출 검증.**

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.181-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v126-18%2F18-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-111-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-42_rounds-success)]() [![repl-flow](https://img.shields.io/badge/REPL_진입-provider_자동선택-success)]() [![repl-tested](https://img.shields.io/badge/실호출-claude_검증-success)]() [![npm-auto](https://img.shields.io/badge/npm_auto--publish-NPM__TOKEN_통합-success)]() [![capability](https://img.shields.io/badge/6_capability-72%25_production--ready-brightgreen)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.183-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v128-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-113-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-44_rounds-success)]() [![install](https://img.shields.io/badge/npm_i_leerness-즉시_사용_가능-success)]() [![stale-check](https://img.shields.io/badge/구버전_감지-모든_명령_시점-success)]() [![skill-presets](https://img.shields.io/badge/skill_catalog-공식_2종%2B--github_확장-success)]() [![direction](https://img.shields.io/badge/방향성_평가-86%2F100-brightgreen)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.181  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.183  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🚪 REPL 진입 흐름 정리 (provider 자동 선택 · 실호출 검증)    ║
+  ║  🌐 공식 catalog 자동 탐색 · 자가 성장형 · 구버전 감지/안내   ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.181';
+const VERSION = '1.9.183';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -872,7 +872,11 @@ async function install(root, opts = {}) {
       '#   예시 URL: https://agentskills.io/llms.txt',
       'LEERNESS_SKILL_DISCOVER_URL=',
       '# (선택) 사용자 요청 분석 시 자동 매칭 스킬 추천. 1=활성, 0/미설정=비활성.',
-      'LEERNESS_SKILL_AUTO_DISCOVER=0'
+      'LEERNESS_SKILL_AUTO_DISCOVER=0',
+      '# 1.9.182 — handoff 시 공식 catalog (vercel-labs, anthropics) 자동 탐색 + 매칭 시 자동 install. 1=활성 (opt-in 보안).',
+      'LEERNESS_SKILL_AUTO_INSTALL=0',
+      '# 1.9.182 — handoff 자동 탐색 대상 preset (콤마 구분). 예: vercel,anthropic',
+      'LEERNESS_SKILL_AUTO_PRESETS=vercel,anthropic'
     ];
     mergeLinesFile(path.join(root, '.env.example'), envLines);
     // 1.9.153: .env 직접 생성/마이그레이션 (사용자 명시 요청). 보안 = 빈 값만 — 사용자가 직접 토큰 채움.
@@ -1322,15 +1326,135 @@ function _parseSkillCatalog(body, sourceUrl) {
   return entries;
 }
 
-// skill discover — agentskills.io 또는 사용자 지정 URL의 카탈로그 인덱스에서 매칭 추천
+// 1.9.182: 공식 조직 스킬 catalog presets — 사용자 명시 (vercel-labs, anthropics 같은 1st-party 자동 탐색).
+//   각 entry: GitHub repo의 skills/ 디렉토리에 SKILL.md 들이 있는 표준 구조.
+//   sync: leerness skill discover --preset <name>  ·  --all-presets  ·  --github <owner/repo>[#branch]
+const SKILL_CATALOG_PRESETS = {
+  'vercel':    { owner: 'vercel-labs', repo: 'agent-skills', branch: 'main', path: 'skills',
+                  homepage: 'https://github.com/vercel-labs/agent-skills' },
+  'anthropic': { owner: 'anthropics',  repo: 'skills',       branch: 'main', path: 'skills',
+                  homepage: 'https://github.com/anthropics/skills' }
+};
+
+// 1.9.182: GitHub repo 의 skills/ 디렉토리 자동 탐색.
+//   GitHub Contents API (no auth 60req/hr, .env GITHUB_TOKEN 시 5000req/hr) 사용.
+//   응답을 표준 entry 형식으로 변환: { name, url, description, format: 'github', source }
+async function _fetchGitHubSkills(owner, repo, branch, dirPath) {
+  branch = branch || 'main'; dirPath = dirPath || 'skills';
+  const apiUrl = `https://api.github.com/repos/${owner}/${repo}/contents/${dirPath}?ref=${branch}`;
+  const token = process.env.LEERNESS_GITHUB_TOKEN || process.env.GITHUB_TOKEN || '';
+  const headers = token ? { Authorization: `Bearer ${token}` } : {};
+  // _httpFetch 가 headers를 지원하지 않으면 raw https 사용
+  let body, status;
+  try {
+    const https = require('https');
+    const u = new URL(apiUrl);
+    body = await new Promise((resolve, reject) => {
+      const req = https.get({
+        hostname: u.hostname, path: u.pathname + u.search,
+        headers: { 'User-Agent': `leerness/${VERSION}`, ...headers }
+      }, res => {
+        status = res.statusCode;
+        const chunks = [];
+        res.on('data', c => chunks.push(c));
+        res.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+      });
+      req.on('error', reject);
+      req.setTimeout(10000, () => { req.destroy(new Error('timeout')); });
+    });
+  } catch (e) { return { ok: false, error: e.message, skills: [] }; }
+  if (status !== 200) return { ok: false, error: `HTTP ${status}`, skills: [] };
+  let items; try { items = JSON.parse(body); } catch { return { ok: false, error: 'invalid JSON', skills: [] }; }
+  if (!Array.isArray(items)) return { ok: false, error: 'not array', skills: [] };
+  const skills = items
+    .filter(i => i && i.type === 'dir')
+    .map(i => ({
+      name: i.name,
+      url: `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${i.path}/SKILL.md`,
+      description: '',
+      format: 'github',
+      source: `github:${owner}/${repo}`,
+      homepage: i.html_url
+    }));
+  return { ok: true, skills };
+}
+
+// skill discover — agentskills.io / GitHub repo / 공식 preset 카탈로그 인덱스에서 매칭 추천
 async function skillDiscoverCmd(root) {
-  const url = arg('--source', null) || process.env.LEERNESS_SKILL_DISCOVER_URL || null;
+  // 1.9.182: --preset / --all-presets / --github 추가 (사용자 명시 — vercel-labs/agent-skills, anthropics/skills 등)
+  const preset = arg('--preset', null);
+  const allPresets = has('--all-presets');
+  const github = arg('--github', null);  // 예: vercel-labs/agent-skills 또는 owner/repo#branch:path
   const query = arg('--query', null);
+
+  // preset / --all-presets / --github 처리 — 단일 source URL과 별개 흐름
+  if (preset || allPresets || github) {
+    const targets = [];
+    if (allPresets) for (const k of Object.keys(SKILL_CATALOG_PRESETS)) targets.push({ key: k, ...SKILL_CATALOG_PRESETS[k] });
+    else if (preset) {
+      const p = SKILL_CATALOG_PRESETS[preset];
+      if (!p) { fail(`알 수 없는 preset: ${preset} (사용 가능: ${Object.keys(SKILL_CATALOG_PRESETS).join(', ')})`); return process.exit(1); }
+      targets.push({ key: preset, ...p });
+    }
+    if (github) {
+      // owner/repo 또는 owner/repo#branch 또는 owner/repo#branch:path
+      const m = github.match(/^([^/]+)\/([^#:]+)(?:#([^:]+))?(?::(.+))?$/);
+      if (!m) { fail(`--github 형식 오류 (예: vercel-labs/agent-skills 또는 owner/repo#main:skills)`); return process.exit(1); }
+      targets.push({ key: 'custom', owner: m[1], repo: m[2], branch: m[3] || 'main', path: m[4] || 'skills', homepage: `https://github.com/${m[1]}/${m[2]}` });
+    }
+    log(`# leerness skill discover (1.9.182 — GitHub presets)`);
+    if (query) log(`query: ${query}`);
+    log(`targets: ${targets.map(t => `${t.owner}/${t.repo}#${t.branch}:${t.path}`).join(', ')}`);
+    log('');
+    const allEntries = [];
+    for (const t of targets) {
+      log(`  fetching ${t.owner}/${t.repo}...`);
+      const r = await _fetchGitHubSkills(t.owner, t.repo, t.branch, t.path);
+      if (!r.ok) {
+        log(`  ⚠ ${t.owner}/${t.repo}: ${r.error}`);
+        continue;
+      }
+      log(`  ✓ ${t.owner}/${t.repo}: ${r.skills.length}개 skill 발견`);
+      for (const s of r.skills) allEntries.push(s);
+    }
+    log('');
+    if (has('--json')) { log(JSON.stringify({ presets: targets.map(t => t.key), query, entries: allEntries }, null, 2)); return; }
+    if (!allEntries.length) {
+      log('  (스킬 0건 — preset/path/branch 확인 또는 rate limit 가능)');
+      return;
+    }
+    let matched = allEntries;
+    if (query) {
+      const q = query.toLowerCase();
+      matched = allEntries.filter(e => e.name.toLowerCase().includes(q) || (e.description || '').toLowerCase().includes(q));
+      log(`매칭 ${matched.length}/${allEntries.length}건 (query: ${query})`);
+    } else {
+      log(`전체 ${allEntries.length}건 (전체 표시 — 매칭 없음)`);
+    }
+    log('');
+    log('| name | source | url |');
+    log('|---|---|---|');
+    for (const e of matched.slice(0, 40)) {
+      log(`| ${e.name} | ${e.source} | ${e.url} |`);
+    }
+    log('');
+    log(`💡 설치: leerness skill install <url>  ·  자동 install (env opt-in): LEERNESS_SKILL_AUTO_INSTALL=1`);
+    return;
+  }
+
+  // 기존 단일 URL 흐름 (1.9.42)
+  const url = arg('--source', null) || process.env.LEERNESS_SKILL_DISCOVER_URL || null;
   if (!url) {
     fail([
       'LEERNESS_SKILL_DISCOVER_URL 환경변수 또는 --source URL 필요.',
+      '',
+      '또는 (1.9.182 신규) — 공식 조직 catalog presets:',
+      '  leerness skill discover --preset vercel        # vercel-labs/agent-skills',
+      '  leerness skill discover --preset anthropic     # anthropics/skills',
+      '  leerness skill discover --all-presets          # 모든 preset 동시 탐색',
+      '  leerness skill discover --github owner/repo    # 직접 GitHub repo 지정',
+      '',
       '예: leerness skill discover --source https://agentskills.io/llms.txt',
-      '또는 .env에 LEERNESS_SKILL_DISCOVER_URL=...',
       '',
       '(정책: leerness는 사용자 동의 없이 외부 URL을 fetch하지 않음 — 1.9.42 opt-in)'
     ].join('\n'));
@@ -1372,6 +1496,78 @@ async function skillDiscoverCmd(root) {
   log(`💡 설치: leerness skill install <url>`);
 }
 
+// 1.9.182: skill auto-install — 공식 organization catalog 자동 탐색 → skill match → 자동 install.
+//   사용자 명시: "스킬을 사용하거나 적용해두면 좋을 부분들을 알아서 웹에서 공식 조직의 스킬 모음을 탐색해서 다운로드 받아서 사용"
+//   정책: LEERNESS_SKILL_AUTO_INSTALL=1 일 때만 실제 install (보안 opt-in). 미설정 시 dry-run (추천만).
+async function skillAutoInstallCmd(root) {
+  root = absRoot(root);
+  const presets = (process.env.LEERNESS_SKILL_AUTO_PRESETS || arg('--presets', 'vercel,anthropic') || '').split(',').map(s => s.trim()).filter(Boolean);
+  const autoInstall = process.env.LEERNESS_SKILL_AUTO_INSTALL === '1' || has('--yes');
+  const query = arg('--query', null) || _autoInstallQueryFromHandoff(root);
+  const maxInstall = Number(arg('--max', '3'));
+  log(`# leerness skill auto-install (1.9.182)`);
+  log(`presets: ${presets.join(', ') || '(none)'}`);
+  log(`query: ${query || '(auto — handoff 컨텍스트)'}`);
+  log(`mode: ${autoInstall ? '🟢 자동 install' : '🟡 dry-run (LEERNESS_SKILL_AUTO_INSTALL=1 또는 --yes 필요)'}`);
+  log('');
+  const allEntries = [];
+  for (const key of presets) {
+    const p = SKILL_CATALOG_PRESETS[key];
+    if (!p) { log(`  ⚠ 알 수 없는 preset: ${key}`); continue; }
+    log(`  fetching ${p.owner}/${p.repo}...`);
+    const r = await _fetchGitHubSkills(p.owner, p.repo, p.branch, p.path);
+    if (!r.ok) { log(`  ⚠ ${p.owner}/${p.repo}: ${r.error}`); continue; }
+    log(`  ✓ ${p.owner}/${p.repo}: ${r.skills.length}개 skill`);
+    for (const s of r.skills) allEntries.push(s);
+  }
+  log('');
+  // query 매칭 (substring) — query 없으면 모든 항목
+  let matched = allEntries;
+  if (query) {
+    const q = String(query).toLowerCase();
+    matched = allEntries.filter(e => e.name.toLowerCase().includes(q) || (e.description || '').toLowerCase().includes(q));
+    log(`매칭 ${matched.length}/${allEntries.length}건 (query: ${query})`);
+  } else {
+    log(`전체 ${allEntries.length}건 (모든 항목)`);
+  }
+  if (!matched.length) { log('  (매칭 0건 — query 변경 또는 --presets 추가)'); return; }
+  log('');
+  log('| name | source | url |');
+  log('|---|---|---|');
+  for (const e of matched.slice(0, maxInstall)) {
+    log(`| ${e.name} | ${e.source} | ${e.url} |`);
+  }
+  log('');
+  if (!autoInstall) {
+    log(`💡 자동 install 활성화: .env 에 LEERNESS_SKILL_AUTO_INSTALL=1 또는 \`leerness skill auto-install --yes\``);
+    log(`   현재 ${Math.min(maxInstall, matched.length)}건이 install 대상 (실제 다운로드 X — dry-run)`);
+    return;
+  }
+  log(`📥 자동 install 시작 — 최대 ${maxInstall}건`);
+  let installed = 0, failed = 0;
+  for (const e of matched.slice(0, maxInstall)) {
+    try {
+      await skillInstallCmd(root, e.url);
+      installed++;
+    } catch (err) {
+      log(`  ⚠ ${e.name} install 실패: ${err.message}`);
+      failed++;
+    }
+  }
+  log('');
+  log(`✓ auto-install 완료: ${installed}건 설치 / ${failed}건 실패 / ${matched.length - installed - failed}건 skip`);
+}
+
+// 1.9.182: handoff 컨텍스트 (현재 in-progress task) 에서 자동 query 추출
+function _autoInstallQueryFromHandoff(root) {
+  try {
+    const rows = readProgressRows(root);
+    const active = rows.find(r => r.status === '[진행]' || r.status === '[in-progress]' || r.status === 'in_progress');
+    if (active) return (active.request || '').split(/\s+/).slice(0, 3).join(' ');
+  } catch {}
+  return null;
+}
+
 // skill export <id> — 기존 자체 skill을 agentskills.io 표준 SKILL.md로 export
 function skillExportCmd(root, id) {
   if (!id) { fail('사용법: leerness skill export <id>'); return process.exit(1); }
@@ -4906,9 +5102,10 @@ async function _warnIfStale(root, opts = {}) {
       log(C.d('     npm registry latest: ') + C.b(`v${latest}`));
       log(C.d('     이 CLI가 실행한 버전: ') + C.b(`v${VERSION}`) + C.d(' (npx 캐시 또는 글로벌 설치 stale)'));
       log('');
-      log(C.d('     해결 — 둘 중 하나 실행 후 다시 시도:'));
+      log(C.d('     해결 — 셋 중 하나 실행 후 다시 시도:'));
+      log('       ' + C.b('npm i leerness@latest') + C.d('              # 프로젝트 로컬 설치 (1.9.183 권장)'));
+      log('       ' + C.b('npm i -g leerness@latest') + C.d('           # 글로벌 설치'));
       log('       ' + C.b('npx --yes clear-npx-cache && npx leerness@latest init .'));
-      log('       ' + C.b('npm i -g leerness@latest  →  leerness init .'));
       log('');
       log(C.d('     (이 경고는 LEERNESS_NO_STALE_CHECK=1 또는 --no-stale-check로 끌 수 있습니다)'));
       log('');
@@ -13426,6 +13623,22 @@ async function main() {
       if (exists(path.join(root, '.harness'))) _bumpUsage(root, cmd);
     } catch {}
   }
+  // 1.9.183 (사용자 명시): 모든 명령 시점에서 구버전 감지 + 경고 + 업데이트 명령어 안내.
+  //   init/migrate 는 이미 _warnIfStale 호출하므로 제외. mcp/version/help 등 출력 민감 명령도 제외.
+  //   24h 캐시 (.harness/cache/update-check.json) 활용 — 네트워크 비차단.
+  const _staleSkip = new Set(['init', 'migrate', 'usage', 'mcp', 'release', 'session-close', '--version', '--help', 'help', 'update', 'whats-new']);
+  if (!_staleSkip.has(cmd) && process.env.LEERNESS_NO_STALE_CHECK !== '1' && !has('--no-stale-check')) {
+    try {
+      const root = absRoot(arg('--path', args[1] && !args[1].startsWith('-') ? args[1] : process.cwd()));
+      // 캐시 fresh 시에만 즉시 비교 (네트워크 호출 X — 비차단). offline + cache 없으면 skip.
+      const cached = readUpdateCache(root);
+      if (cacheFresh(cached, 24) && cached.nextLeerness && compareVer(cached.nextLeerness, VERSION) > 0) {
+        const isTty = process.stdout && process.stdout.isTTY;
+        const C = isTty ? { y: s => `\x1b[33m${s}\x1b[0m`, b: s => `\x1b[1m${s}\x1b[0m`, d: s => `\x1b[2m${s}\x1b[0m` } : { y: s => s, b: s => s, d: s => s };
+        process.stderr.write(C.y('  ⚠ ') + C.b(`leerness v${VERSION} → v${cached.nextLeerness} 사용 가능`) + C.d(` · ${C.b('npm i leerness@latest')} 권장 (LEERNESS_NO_STALE_CHECK=1 로 끄기)`) + '\n');
+      }
+    } catch {}
+  }
   if (cmd === 'init')      return await install(args[1] || process.cwd(), { force:false, dry:false, migration:false });
   // 1.9.64: install <skill-id-or-url> 별칭 (= skill install). 자주 쓰는 명령 단축형.
   // 단, init이 leerness install . 같은 형태로도 동작하던 옛 호환은 유지 — args[1]이 디렉토리면 init으로 라우팅.
@@ -13540,6 +13753,8 @@ async function main() {
   if (cmd === 'benchmark')                          return benchmarkCmd(absRoot(args[1] || arg('--path', process.cwd())));
   if (cmd === 'skill' && args[1] === 'publish')     return skillPublishCmd(absRoot(arg('--path', process.cwd())));
   if (cmd === 'skill' && args[1] === 'suggest')     return skillSuggestCmd(absRoot(arg('--path', process.cwd())));
+  // 1.9.182: leerness skill auto-install — 공식 catalog 자동 탐색 + skill match 매칭 시 자동 install (사용자 명시)
+  if (cmd === 'skill' && args[1] === 'auto-install') return await skillAutoInstallCmd(absRoot(arg('--path', process.cwd())));
   if (cmd === 'mcp' && args[1] === 'serve')         return mcpServeCmd(absRoot(arg('--path', process.cwd())));
   if (cmd === 'gate')                               return gate(args[1] || process.cwd());
   if (cmd === 'verify-code')                        return verifyCodeCmd(args[1] || process.cwd());

package/package.json

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