leerness 1.9.84 → 1.9.86

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## 1.9.86 — 2026-05-20
+
+**MCP server 18번째 도구 `leerness_health` 추가** (1.9.85 health 외부 AI 노출).
+
+### Added — MCP 18번째 도구
+- `leerness_health` — 1.9.85 종합 헬스 체크를 외부 AI에 노출.
+  - inputSchema: `{ path: string, strict: boolean }`
+  - 응답: `health --json` 결과 (drift + security + skills + usage + tasks + issues)
+  - 외부 AI가 워크스페이스 상태 한 번에 인지.
+- MCP server 도구 카운트: **17 → 18**.
+
+### Use Case
+- Claude Code / Cursor가 사용자 워크스페이스에서 작업 시작 시 → `leerness_health` 호출 → drift/보안/skill/MCP 상태 즉시 파악 → 적절한 행동 결정.
+- "이 워크스페이스 보안 안전한가?" "어떤 skill 있나?" "MCP 호출 패턴은?" 한 호출로 답변.
+
+### Verified
+- stress-v32 — MCP 18 도구 + health 호출 + JSON 응답 + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 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 목록 조회 노출).

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.84-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.86-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.84   AI Agent Reliability Harness                      ║
+  ║  v1.9.86   AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
@@ -433,6 +433,8 @@ npm test     # = node ./scripts/e2e.js
 
 ## 변경 이력 (최근)
 
+- **1.9.86** — **MCP server 18번째 도구 `leerness_health`** — 1.9.85 health 종합 헬스 체크를 외부 AI에 노출. drift + 보안 + skill + MCP + tasks 한 호출.
+- **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` 동기화 후 재검사. 보안 + 세션 마감 한 번에 자동 회복.

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.84';
+const VERSION = '1.9.86';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -3398,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.84+ 워크플로)')));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.86+ 워크플로)')));
     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 서버 — 17 도구 (skill_list 포함, 1.9.84)'));
+    log('    ' + C.green('npx leerness mcp serve') + C.dim('                              # MCP 서버 — 18 도구 (health 포함, 1.9.86)'));
     log('    ' + C.green('npx leerness agents bench "<task>"') + C.dim('                  # 3 CLI 동시 비교'));
     log('');
   }
@@ -7351,7 +7352,8 @@ function mcpServeCmd(root) {
     { 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_list', description: '1.9.84 — 워크스페이스에 설치된 skill 목록 + 사용 횟수 + 출처 (catalog/user). 외부 AI가 사용 가능한 skill 조회', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
+    { name: 'leerness_skill_list', description: '1.9.84 — 워크스페이스에 설치된 skill 목록 + 사용 횟수 + 출처 (catalog/user). 외부 AI가 사용 가능한 skill 조회', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
+    { name: 'leerness_health', description: '1.9.85/86 — 종합 헬스 체크 (drift + 보안 + skills + MCP + tasks + issues 배열). 외부 AI가 워크스페이스 상태 한 번에 확인', inputSchema: { type: 'object', properties: { path: { type: 'string' }, strict: { type: 'boolean' } } } }
   ];
 
   function send(obj) {
@@ -7400,6 +7402,7 @@ function mcpServeCmd(root) {
           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;
+          case 'leerness_health':          cliArgs = ['health', targetPath, '--json', ...(args.strict ? ['--strict'] : [])]; break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -7581,6 +7584,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);
@@ -7912,6 +8027,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.84",
+  "version": "1.9.86",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",