leerness 1.9.83 → 1.9.85

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 1.9.85 — 2026-05-20
+
+**`leerness health` 새 명령** — 종합 헬스 체크 (drift + 보안 + skill + MCP + 누적 통계).
+
+### Added — `leerness health [<path>]`
+- 종합 진단 한 번에:
+  - `drift`: level + score + fired 개수
+  - `보안`: .env 존재 / .gitignore에 .env 포함 / .env.example 누락 키 / .gitignore 시크릿 패턴 누락
+  - `skills`: 설치 수 / skill query 누적 (rolling history)
+  - `usage`: 명령 호출 총수 + 종류 / MCP 호출 총수 + 종류 / since
+  - `tasks`: progress-tracker 총수 + 상태별 카운트
+- **`issues`** 배열에 발견된 모든 문제 자동 집계.
+- `--json`: 구조화된 JSON 출력 (CI 친화).
+- `--strict`: issue ≥ 1 시 exit 1.
+
+### Use Case
+- 사용자: `leerness health .` 한 줄로 워크스페이스 전체 상태 즉시 확인.
+- CI 통합: `leerness health . --strict` 로 보안/drift 문제 자동 감지.
+- 1.9.78 drift + 1.9.75/76/80 보안 + 1.9.70 MCP 통계 + 1.9.79 skill suggest의 모든 신호를 한 곳에 집계.
+
+### Verified
+- stress-v31 — health 출력 / --json / --strict / 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 1.9.84 — 2026-05-20
+
+**MCP server 17번째 도구 `leerness_skill_list` 추가** (외부 AI에 skill 목록 조회 노출).
+
+### Added — MCP 17번째 도구
+- `leerness_skill_list` — 워크스페이스에 설치된 skill 목록 조회.
+  - inputSchema: `{ path: string }`
+  - 응답: `skill list --json` 결과 (skillpack 출처 + items 배열: id/displayNameKo/source/capabilities/usageCount/lastUsed/lastUpdated)
+  - 외부 AI가 사용 가능한 skill을 즉시 인지하여 적절한 능력 활용.
+- `skill list --json` 옵션 신규 추가 (CI 친화).
+- MCP server 도구 카운트: **16 → 17**.
+
+### Use Case
+- Claude Code / Cursor 가 작업 시작 시 → `leerness_skill_list` 호출 → 사용 가능한 skill 카탈로그 파악 → 적절한 능력 활용.
+- skill_match와 결합: "이 task에 매칭되는 skill (skill_match) + 전체 skill 카탈로그 (skill_list)" 양방향 활용.
+
+### Verified
+- stress-v30 — MCP 17 도구 + skill_list 호출 + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
 ## 1.9.83 — 2026-05-20
 
 **MCP server 16번째 도구 `leerness_skill_match` 추가** (1.9.45/50/68 skill match 외부 노출).

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.83-green)]() [![tests](https://img.shields.io/badge/e2e-219%2F219-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.85-green)]() [![tests](https://img.shields.io/badge/e2e-219%2F219-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,7 +12,7 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.83   AI Agent Reliability Harness                      ║
+  ║  v1.9.85   AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
@@ -433,6 +433,8 @@ npm test     # = node ./scripts/e2e.js
 
 ## 변경 이력 (최근)
 
+- **1.9.85** — **`leerness health` 새 명령** — drift + 보안 + skill + MCP + 누적 통계 종합 헬스 체크. `--json` / `--strict` 옵션.
+- **1.9.84** — **MCP server 17번째 도구 `leerness_skill_list`** — 외부 AI에 skill 카탈로그 (id/이름/출처/능력/사용 횟수) 조회 노출. `skill list --json` 옵션도 함께 추가.
 - **1.9.83** — **MCP server 16번째 도구 `leerness_skill_match`** — 1.9.45/50/68 skill match를 외부 AI에 노출. rolling history 자동 누적.
 - **1.9.82** — **`drift check --auto-fix` 보안 회복 통합** — 1.9.78 보안 신호 발견 시 `audit --fix` 자동 실행 → `.gitignore` + `.env.example` 동기화 후 재검사. 보안 + 세션 마감 한 번에 자동 회복.
 - **1.9.81** — **`handoff` 통합 헤드라인** — drift level + 보안 상태 + MCP 활동 + skill query + 설치 skill 수를 한 줄로 압축. AI가 세션 시작 즉시 워크스페이스 상태 인지.

package/bin/harness.js

@@ -6,7 +6,7 @@ const path = require('path');
 const cp = require('child_process');
 const readline = require('readline');
 
-const VERSION = '1.9.83';
+const VERSION = '1.9.85';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -769,6 +769,20 @@ function _invalidateSkillsCache(root) {
 
 function skillList(root) {
   const all = listAllSkills(root);
+  // 1.9.84: --json 옵션 (MCP 통합용)
+  if (has('--json')) {
+    const items = Object.entries(all).map(([id, v]) => ({
+      id,
+      displayNameKo: v.displayNameKo || id,
+      source: v._source,
+      capabilities: v.capabilities || [],
+      usageCount: v.usage?.count || 0,
+      lastUsed: v.usage?.lastUsed || null,
+      lastUpdated: v.lastUpdated || null
+    }));
+    log(JSON.stringify({ skillpack: SKILLPACK_SOURCE, total: items.length, items }, null, 2));
+    return;
+  }
   if (SKILLPACK_SOURCE !== 'builtin') log(`# skillpack 출처: ${SKILLPACK_SOURCE}${SKILLPACK_META ? ` (${SKILLPACK_META.name} v${SKILLPACK_META.version})` : ''}`);
   else log('# skillpack 미설치 — builtin fallback 사용 (leerness 본 패키지 내장 카탈로그)');
   log('| ID | 한글명 | 출처 | 능력(요약) | 사용횟수 | 최종 |');
@@ -3384,16 +3398,17 @@ function _banner(opts = {}) {
   lines.push('');
   for (const ln of lines) log(ln);
   if (opts.quickStart) {
-    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.83+ 워크플로)')));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.85+ 워크플로)')));
     log('    ' + C.green('npx leerness@latest init .') + C.dim('                          # 신규 프로젝트 + 외부 AI CLI 설정'));
     log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 + lessons + 매칭 skill + 이전 history hit (1.9.69)'));
     log('    ' + C.green('npx leerness skill match "<query>"') + C.dim('                  # 매칭 skill + rolling history 자동 누적 (1.9.68)'));
     log('    ' + C.green('npx leerness verify-claim T-0001 --run-tests') + C.dim('        # AI 거짓 완료 자동 검증'));
     log('    ' + C.green('npx leerness env check .') + C.dim('                             # .env ↔ .env.example 동기화 검사 (1.9.71)'));
+    log('    ' + C.green('npx leerness health .') + C.dim('                                # 종합 헬스 체크 — drift + 보안 + skill + MCP (1.9.85)'));
     log('    ' + C.green('npx leerness session close .') + C.dim('                        # 마감 + 다음 라운드 추천 (default)'));
     log('');
     log(C.bold(C.cyan('  🤖 메인 에이전트 (Claude/Cursor/Copilot)용')));
-    log('    ' + C.green('npx leerness mcp serve') + C.dim('                              # MCP 서버 — 16 도구 (skill_match 포함, 1.9.83)'));
+    log('    ' + C.green('npx leerness mcp serve') + C.dim('                              # MCP 서버 — 17 도구 (skill_list 포함, 1.9.84)'));
     log('    ' + C.green('npx leerness agents bench "<task>"') + C.dim('                  # 3 CLI 동시 비교'));
     log('');
   }
@@ -7336,7 +7351,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_task_export', description: '1.9.60/66 — leerness task → Claude Code TodoWrite 호환 JSON (외부 AI 양방향 sync)', inputSchema: { type: 'object', properties: { path: { type: 'string' }, to: { type: 'string' } } } },
     { name: 'leerness_env_check', description: '1.9.71/73 — .env vs .env.example 동기화 검사 (보안: 키만, 값 미노출). exit 1 if 누락 키 있음', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_brainstorm', description: '1.9.16/72/77 — 누적 컨텍스트(decisions+skills+tasks+rules+evidence+lessons+skillHistory+taskLogFails) 자원 회수. 외부 AI가 새 작업 시작 전 호출', inputSchema: { type: 'object', properties: { topic: { type: 'string' }, path: { type: 'string' }, allApps: { type: 'boolean' } }, required: ['topic'] } },
-    { name: 'leerness_skill_match', description: '1.9.45/50/83 — 사용자 task 키워드에 매칭되는 설치된 skill 추천 (jaccard 또는 embedding). 1.9.68 rolling history 자동 누적', inputSchema: { type: 'object', properties: { query: { type: 'string' }, path: { type: 'string' }, useEmbedding: { type: 'boolean' } }, required: ['query'] } }
+    { name: 'leerness_skill_match', description: '1.9.45/50/83 — 사용자 task 키워드에 매칭되는 설치된 skill 추천 (jaccard 또는 embedding). 1.9.68 rolling history 자동 누적', inputSchema: { type: 'object', properties: { query: { type: 'string' }, path: { type: 'string' }, useEmbedding: { type: 'boolean' } }, required: ['query'] } },
+    { name: 'leerness_skill_list', description: '1.9.84 — 워크스페이스에 설치된 skill 목록 + 사용 횟수 + 출처 (catalog/user). 외부 AI가 사용 가능한 skill 조회', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
   ];
 
   function send(obj) {
@@ -7384,6 +7400,7 @@ function mcpServeCmd(root) {
           case 'leerness_env_check':       cliArgs = ['env', 'check', targetPath, '--json']; break;
           case 'leerness_brainstorm':      cliArgs = ['brainstorm', args.topic || '', '--path', targetPath, '--json', ...(args.allApps ? ['--all-apps'] : [])]; break;
           case 'leerness_skill_match':     cliArgs = ['skill', 'match', args.query || '', '--path', targetPath, '--json', ...(args.useEmbedding ? ['--embedding'] : [])]; break;
+          case 'leerness_skill_list':      cliArgs = ['skill', 'list', targetPath, '--json']; break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -7565,6 +7582,118 @@ function envSyncCmd(root) {
   for (const k of d.inEnvOnly) log(`  + ${k}=`);
 }
 
+// 1.9.85: leerness health — 종합 헬스 체크 (drift + 보안 + skill + MCP + 누적)
+function healthCmd(root) {
+  root = absRoot(root || process.cwd());
+  const out = { root, generatedAt: new Date().toISOString(), checks: {} };
+  // 1) drift level
+  try {
+    const r = cp.spawnSync(process.execPath, [__filename, 'drift', 'check', root, '--json'],
+      { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '0' } });
+    const j = JSON.parse(r.stdout.trim());
+    out.checks.drift = { level: j.level, score: j.score, firedCount: (j.fired || []).length };
+  } catch { out.checks.drift = { error: 'drift check 실패' }; }
+  // 2) 보안 상태 (env + .gitignore)
+  try {
+    const envPath = path.join(root, '.env');
+    if (exists(envPath)) {
+      const d = envDiff(root);
+      const giText = exists(path.join(root, '.gitignore')) ? read(path.join(root, '.gitignore')) : '';
+      const giLines = giText.split('\n').map(l => l.trim());
+      const envInGi = giLines.includes('.env') || giLines.includes('/.env');
+      const SECRET_PATTERNS = ['.env', '.env.local', '.env.production', '.env.*.local', '*.pem', 'credentials.json'];
+      const missingSecrets = SECRET_PATTERNS.filter(p => !giLines.some(l => l === p || l === '/' + p));
+      out.checks.security = {
+        hasDotEnv: true,
+        envInGitignore: envInGi,
+        envExampleMissing: d.inEnvOnly,
+        gitignoreMissingSecrets: missingSecrets,
+        critical: !envInGi
+      };
+    } else {
+      out.checks.security = { hasDotEnv: false, ok: true };
+    }
+  } catch { out.checks.security = { error: '보안 점검 실패' }; }
+  // 3) skill 수 + skill query 누적
+  try {
+    const all = listAllSkills(root);
+    const skillCount = Object.keys(all).length;
+    let queryCount = 0;
+    const histPath = path.join(root, '.harness', 'skill-suggestions.md');
+    if (exists(histPath)) {
+      queryCount = (read(histPath).match(/^## [\d-]+ [\d:]+ — query/gm) || []).length;
+    }
+    out.checks.skills = { installed: skillCount, queryHistoryCount: queryCount };
+  } catch { out.checks.skills = { error: 'skill 점검 실패' }; }
+  // 4) MCP + 명령 호출 누적
+  try {
+    const stats = _readUsageStats(root);
+    const cmdTotal = Object.values(stats.commands || {}).reduce((s, n) => s + n, 0);
+    const mcpTotal = stats.mcp?.tools ? Object.values(stats.mcp.tools).reduce((s, n) => s + n, 0) : 0;
+    out.checks.usage = {
+      commandTotal: cmdTotal,
+      commandKinds: Object.keys(stats.commands || {}).length,
+      mcpTotal,
+      mcpToolKinds: stats.mcp?.tools ? Object.keys(stats.mcp.tools).length : 0,
+      since: stats.since || null
+    };
+  } catch { out.checks.usage = { error: 'usage 점검 실패' }; }
+  // 5) tasks (progress-tracker)
+  try {
+    const rows = readProgressRows(root);
+    const byStatus = {};
+    for (const r of rows) byStatus[r.status] = (byStatus[r.status] || 0) + 1;
+    out.checks.tasks = { total: rows.length, byStatus };
+  } catch { out.checks.tasks = { error: 'tasks 점검 실패' }; }
+  // 6) issues 요약 (사용자 글로벌 룰 가시화)
+  const issues = [];
+  if (out.checks.drift?.level && !/healthy/.test(out.checks.drift.level)) issues.push(`drift ${out.checks.drift.level}`);
+  if (out.checks.security?.critical) issues.push('🚨 .env가 .gitignore에 누락 (보안 CRITICAL)');
+  if (out.checks.security?.envExampleMissing?.length) issues.push(`.env→.env.example 누락 ${out.checks.security.envExampleMissing.length}건`);
+  if (out.checks.security?.gitignoreMissingSecrets?.length) issues.push(`.gitignore 시크릿 누락 ${out.checks.security.gitignoreMissingSecrets.length}건`);
+  out.issues = issues;
+  out.healthy = issues.length === 0;
+
+  // --strict: issue 있으면 exit 1
+  if (has('--strict') && !out.healthy) process.exitCode = 1;
+
+  if (has('--json')) { log(JSON.stringify(out, null, 2)); return; }
+  log(`# leerness health (1.9.85)`);
+  log(`Date: ${out.generatedAt}`);
+  log(`Status: ${out.healthy ? '✅ healthy' : `⚠ ${issues.length} issues`}`);
+  log('');
+  log(`## drift`);
+  log(`  level: ${out.checks.drift?.level || 'n/a'} (score ${out.checks.drift?.score || 0}, fired ${out.checks.drift?.firedCount || 0})`);
+  log('');
+  log(`## 보안`);
+  if (out.checks.security?.hasDotEnv) {
+    log(`  .env 존재 · .gitignore에 .env 포함: ${out.checks.security.envInGitignore ? '✓' : '✗ CRITICAL'}`);
+    log(`  .env.example 누락 키: ${out.checks.security.envExampleMissing?.length || 0}건`);
+    log(`  .gitignore 시크릿 패턴 누락: ${out.checks.security.gitignoreMissingSecrets?.length || 0}건`);
+  } else {
+    log(`  .env 없음 (검증 불필요)`);
+  }
+  log('');
+  log(`## skills`);
+  log(`  설치: ${out.checks.skills?.installed || 0}개 · skill query 누적: ${out.checks.skills?.queryHistoryCount || 0}회`);
+  log('');
+  log(`## usage`);
+  log(`  명령 호출: ${out.checks.usage?.commandTotal || 0}회 / ${out.checks.usage?.commandKinds || 0}종`);
+  log(`  MCP 호출: ${out.checks.usage?.mcpTotal || 0}회 / ${out.checks.usage?.mcpToolKinds || 0}종 도구`);
+  log(`  since: ${out.checks.usage?.since || 'unknown'}`);
+  log('');
+  log(`## tasks`);
+  const tb = out.checks.tasks?.byStatus || {};
+  log(`  총 ${out.checks.tasks?.total || 0}건: ${Object.entries(tb).map(([s, n]) => `${s}=${n}`).join(', ') || '없음'}`);
+  if (issues.length) {
+    log('');
+    log(`## ⚠ Issues (${issues.length})`);
+    for (const i of issues) log(`  - ${i}`);
+    log('');
+    log(`💡 자동 회복: leerness drift check --auto-fix · leerness audit --fix`);
+  }
+}
+
 function usageStatsCmd(root) {
   root = absRoot(root || process.cwd());
   const stats = _readUsageStats(root);
@@ -7896,6 +8025,8 @@ async function main() {
   // 1.9.71: leerness env check / sync — .env vs .env.example 자동 동기화
   if (cmd === 'env' && args[1] === 'check') return envCheckCmd(args[2] || arg('--path', process.cwd()));
   if (cmd === 'env' && args[1] === 'sync')  return envSyncCmd(args[2] || arg('--path', process.cwd()));
+  // 1.9.85: leerness health — 종합 헬스 체크
+  if (cmd === 'health') return healthCmd(args[1] || arg('--path', process.cwd()));
   if (cmd === 'whats-new') return whatsNewCmd(args[1] || arg('--path', process.cwd()));
   if (cmd === 'reuse' && args[1] === 'autodetect') return reuseAutodetectCmd(args[2] || arg('--path', process.cwd()));
   if (cmd === 'setup-agents' || cmd === 'setup' && args[1] === 'agents') return await setupAgentsCmd(args[1] && args[1] !== 'agents' ? args[1] : (args[2] || process.cwd()));

package/package.json

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