leerness 1.9.64 → 1.9.66

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 1.9.66 — 2026-05-19
+
+**성능 최적화 2차 + MCP 13번째 도구**.
+
+### Performance
+- **`listAllSkills` 메모리 캐시 (`_SKILLS_LIST_CACHE`)** — userSkillsDir mtime 기반 캐시. `skill list/info/match/discover/suggest` 가 같은 인덱스 공유.
+- `saveUserSkill`/`skillRemove`에서 캐시 invalidate — skill 추가/제거 즉시 반영.
+
+### MCP server — 13번째 도구
+- **`leerness_task_export`** — 1.9.60 TodoWrite 호환 JSON을 외부 에이전트(Claude Code, Cursor 등)에 노출. `to: <path>` 또는 stdout JSON 모두 지원.
+- MCP server 도구 카운트: 12 → **13**.
+
+### Verified
+- stress-v12 (1.9.66 검증) — listAllSkills 캐시 정합성 + MCP 13 도구 + warm-up 1회 시나리오 보강.
+- e2e 회귀: 219/219 PASS 유지.
+
+---
+
+## 1.9.65 — 2026-05-19
+
+**성능 최적화 1차 — usage-stats 메모리 캐시 + lessons 인덱스 캐시**.
+
+### Performance
+- **usage-stats 메모리 캐시 (`_USAGE_CACHE`)** — 같은 프로세스 lifetime 동안 `.harness/cache/usage-stats.json`을 mtime 기반으로 한 번만 파싱. `_readUsageStats()` 다중 호출 시 디스크 I/O 절감.
+- **lessons 인덱스 캐시 (`_LESSONS_INDEX_CACHE`)** — `review-evidence.md` + `decisions.md`를 mtime 기반으로 1회 read+split, 블록 인덱스를 메모리에 보관.
+  - handoff의 lessons 자동 재상기: 키워드별 fuzzy 매칭이 split 재실행 없이 인덱스 순회로 동작.
+  - `leerness lessons` 명령도 같은 인덱스 재활용.
+- 벤치마크 워크스페이스 크기 비례 비용 → 사실상 O(1) (인덱스 hit 시).
+- API 호환성 유지 — 캐시는 mtime invalidation이라 외부에서 파일을 수정해도 자동 재로드.
+
+### Verified
+- stress-v11 (1.9.64 baseline ↔ 1.9.65 optimized 정량 비교) — 13/14 PASS, 캐시 정합성 3/3 PASS.
+- 성능: handoff -37% / drift -19% / audit -29% / skill list -17% / 100-task handoff -42% / 50-evidence handoff 1048ms.
+- status 클린 환경 측정: median 623ms (v10 1195ms 대비 -48% 개선).
+- e2e 회귀: 219/219 PASS 유지.
+
+---
+
 ## 1.9.64 — 2026-05-19
 
 **`leerness install <skill>` 별칭 + 성능 벤치마크 1차 실측**.

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.64-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.66-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.64   AI Agent Reliability Harness                      ║
+  ║  v1.9.66   AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
@@ -433,6 +433,8 @@ npm test     # = node ./scripts/e2e.js
 
 ## 변경 이력 (최근)
 
+- **1.9.66** — **성능 최적화 2차 + MCP 13번째 도구**. `listAllSkills` 메모리 캐시 (skill list/info/match/discover/suggest 공유) + MCP `leerness_task_export` 추가 (TodoWrite 양방향 sync 외부 노출).
+- **1.9.65** — **성능 최적화 1차** — usage-stats 메모리 캐시 + lessons 인덱스 캐시 (mtime invalidation). handoff -37% · drift -19% · audit -29% · skill list -17% · 100-task handoff -42% · status -48% (vs 1.9.64).
 - **1.9.64** — `leerness install <SKILL.md>` 별칭 (skill install 단축) · **성능 벤치마크 1차 실측** (status/handoff/drift/audit/skill list 평균 1.2~1.5초).
 - **1.9.63** — `leerness audit --strict [--threshold N]` — CI 친화 옵션 (warnings → failures 승격).
 - **1.9.62** — `leerness audit` npm CVE 자동 감지 (npm audit --json 통합, OFFLINE/no-npm-audit 스킵).

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.64';
+const VERSION = '1.9.66';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -715,13 +715,34 @@ function loadUserSkill(root, id) {
 function saveUserSkill(root, id, data) {
   const dir = path.join(userSkillsDir(root), id); mkdirp(dir);
   writeUtf8(path.join(dir, 'skill.json'), JSON.stringify(data, null, 2) + '\n');
+  // 1.9.66: 캐시 invalidate (skill 추가/변경 즉시 반영)
+  try { _SKILLS_LIST_CACHE.delete(absRoot(root)); } catch {}
   // README mirror
   const usage = data.usage || { count: 0 };
   const readme = `# ${data.displayNameKo || id}\n\n## Capabilities\n${(data.capabilities || []).map(c => '- ' + c).join('\n') || '-'}\n\n## Sources\n${(data.sources || []).map(s => `- ${s.url || s}`).join('\n') || '-'}\n\n## Patterns (성공 명령/접근)\n${(data.patterns || []).map(p => `- \`${p.command}\` — ${p.note || ''}`).join('\n') || '-'}\n\n## Optimization history\n${(data.optimizations || []).map(o => `- ${o.at}: ${o.note || ''}${o.before||o.after?` (${o.before||'?'} → ${o.after||'?'})`:''}`).join('\n') || '-'}\n\n## Usage\n${usage.count || 0}회 사용 / 마지막: ${usage.lastUsed || '-'}\n${usage.lastNote ? '\n마지막 노트: ' + usage.lastNote : ''}\n`;
   writeUtf8(path.join(dir, 'README.md'), readme);
 }
 
+// 1.9.66: listAllSkills 메모리 캐시 — skill list/info/match/discover/suggest 가 공유
+// key: root → { mtime(skillsDir), out }
+const _SKILLS_LIST_CACHE = new Map();
 function listAllSkills(root) {
+  // 캐시 hit 확인: userSkillsDir mtime 동일 시 재구성 skip
+  if (root) {
+    try {
+      const dir = userSkillsDir(root);
+      const dirMtime = exists(dir) ? fs.statSync(dir).mtimeMs : 0;
+      const key = absRoot(root);
+      const cached = _SKILLS_LIST_CACHE.get(key);
+      if (cached && cached.dirMtime === dirMtime) return cached.out;
+      const out = _buildAllSkills(root);
+      _SKILLS_LIST_CACHE.set(key, { dirMtime, out });
+      return out;
+    } catch { return _buildAllSkills(root); }
+  }
+  return _buildAllSkills(root);
+}
+function _buildAllSkills(root) {
   const out = {};
   // 1.9.10: skillCatalog의 _source('skillpack' 또는 'builtin')를 보존
   for (const [k, v] of Object.entries(skillCatalog)) out[k] = { ...v, _source: v._source || 'builtin' };
@@ -739,6 +760,10 @@ function listAllSkills(root) {
   }
   return out;
 }
+// 1.9.66: skill 추가/제거 시 캐시 invalidate (외부 helper)
+function _invalidateSkillsCache(root) {
+  try { _SKILLS_LIST_CACHE.delete(absRoot(root)); } catch {}
+}
 
 function skillList(root) {
   const all = listAllSkills(root);
@@ -826,6 +851,8 @@ function skillRemove(root, id) {
   if (!id) return fail('id required');
   const dir = path.join(userSkillsDir(root), id);
   if (!exists(dir)) return fail(`skill folder not found: ${id}`);
+  // 1.9.66: 캐시 invalidate
+  try { _SKILLS_LIST_CACHE.delete(absRoot(root)); } catch {}
   if (skillCatalog[id]) {
     // catalog 스킬은 로컬 메타만 제거 (카탈로그는 패키지 내장이라 영구 제거 불가)
     fs.rmSync(dir, { recursive: true, force: true });
@@ -1757,24 +1784,22 @@ function handoff(root) {
         const tokens = String(latestRow.request).toLowerCase().match(/[\w가-힣]{4,}/g) || [];
         const keyword = tokens.filter(t => !stopwords.has(t)).sort((a, b) => b.length - a.length)[0];
         if (keyword) {
-          // lessons 검색 — 1.9.58: fuzzy 매칭 (substring + 어간 변형)
-          const decisions = exists(decisionsPath(root)) ? read(decisionsPath(root)) : '';
-          const evidence = exists(evidencePath(root)) ? read(evidencePath(root)) : '';
+          // 1.9.65: lessons blocks 인덱스 메모리 캐시 — mtime 기반 invalidation
+          // 같은 프로세스가 여러 번 handoff를 호출해도 split/regex 비용 1회만
+          const idx = _loadLessonsIndex(root);
           // fuzzy: keyword 또는 keyword 부분 (4자+) 일치
           // 예: "webhook" 매칭 시 "webhook-payload", "webhooks", "webhooked" 모두 매칭
           const fuzzyRe = new RegExp(escapeRegex(keyword.slice(0, Math.max(4, Math.floor(keyword.length * 0.7)))), 'i');
           const matches = [];
-          for (const block of evidence.split(/\n(?=## )/)) {
-            if (block.startsWith('## ') && fuzzyRe.test(block) && /✗|fail|롤백|버그|incomplete/i.test(block)) {
-              const titleM = block.match(/^## (.+)$/m);
-              if (titleM) matches.push({ source: 'review-evidence.md', title: titleM[1].trim(), block });
+          for (const e of idx.evidence) {
+            if (fuzzyRe.test(e.block) && /✗|fail|롤백|버그|incomplete/i.test(e.block)) {
+              matches.push({ source: 'review-evidence.md', title: e.title, block: e.block });
             }
           }
           // 1.9.58: decisions.md도 fuzzy 매칭 (실패/롤백 관련 결정만)
-          for (const block of decisions.split(/\n(?=### )/)) {
-            if (block.startsWith('### ') && fuzzyRe.test(block) && /롤백|실패|fail|취소|회귀|deprecate/i.test(block)) {
-              const titleM = block.match(/^### (.+)$/m);
-              if (titleM) matches.push({ source: 'decisions.md', title: titleM[1].trim(), block });
+          for (const d of idx.decisions) {
+            if (fuzzyRe.test(d.block) && /롤백|실패|fail|취소|회귀|deprecate/i.test(d.block)) {
+              matches.push({ source: 'decisions.md', title: d.title, block: d.block });
             }
           }
           if (matches.length) {
@@ -5520,8 +5545,9 @@ function lessonsCmd(root) {
     }
     log(`# Lessons --auto (1.9.54): 추출 키워드 "${query}"`);
   }
+  // 1.9.65: 인덱스 캐시 활용 (decisions/evidence split 1회만)
+  const _lidx = _loadLessonsIndex(root);
   const decisions = exists(decisionsPath(root)) ? read(decisionsPath(root)) : '';
-  const evidence = exists(evidencePath(root)) ? read(evidencePath(root)) : '';
   const tlog = exists(taskLogPath(root)) ? read(taskLogPath(root)) : '';
   const handoff = exists(handoffPath(root)) ? read(handoffPath(root)) : '';
   const lessons = [];
@@ -5531,12 +5557,10 @@ function lessonsCmd(root) {
     if (!m) continue;
     lessons.push({ source: 'decisions.md', title: m[1].trim(), block });
   }
-  // evidence: ## 블록 중 실패/롤백/버그 표지가 있는 것
-  for (const block of evidence.split(/\n(?=## )/)) {
-    if (!block.startsWith('## ')) continue;
-    if (/✗|\bfail(ed)?\b|롤백|재발|incomplete|\bbug\b|버그|warning/i.test(block)) {
-      const m = block.match(/^## (.+)$/m);
-      if (m) lessons.push({ source: 'review-evidence.md', title: m[1].trim(), block });
+  // evidence: ## 블록 중 실패/롤백/버그 표지가 있는 것 (1.9.65: 인덱스 재활용)
+  for (const e of _lidx.evidence) {
+    if (/✗|\bfail(ed)?\b|롤백|재발|incomplete|\bbug\b|버그|warning/i.test(e.block)) {
+      lessons.push({ source: 'review-evidence.md', title: e.title, block: e.block });
     }
   }
   // task-log: 실패 키워드 라인
@@ -6137,12 +6161,56 @@ function driftCheckCmd(root, opts = {}) {
   if (level === '🔴 critical') process.exitCode = 1;
 }
 
+// 1.9.65: lessons blocks 인덱스 — evidence/decisions 파일 read + split을 1회로
+// key: root → { evidenceMtime, decisionsMtime, evidence: [{title, block}], decisions: [{title, block}] }
+const _LESSONS_INDEX_CACHE = new Map();
+function _loadLessonsIndex(root) {
+  const ep = evidencePath(root);
+  const dp = decisionsPath(root);
+  const em = exists(ep) ? (() => { try { return fs.statSync(ep).mtimeMs; } catch { return 0; } })() : 0;
+  const dm = exists(dp) ? (() => { try { return fs.statSync(dp).mtimeMs; } catch { return 0; } })() : 0;
+  const cacheKey = absRoot(root);
+  const cached = _LESSONS_INDEX_CACHE.get(cacheKey);
+  if (cached && cached.evidenceMtime === em && cached.decisionsMtime === dm) return cached;
+  const evidence = [];
+  if (em) {
+    const txt = read(ep);
+    for (const block of txt.split(/\n(?=## )/)) {
+      if (!block.startsWith('## ')) continue;
+      const t = block.match(/^## (.+)$/m);
+      if (t) evidence.push({ title: t[1].trim(), block });
+    }
+  }
+  const decisions = [];
+  if (dm) {
+    const txt = read(dp);
+    for (const block of txt.split(/\n(?=### )/)) {
+      if (!block.startsWith('### ')) continue;
+      const t = block.match(/^### (.+)$/m);
+      if (t) decisions.push({ title: t[1].trim(), block });
+    }
+  }
+  const idx = { evidenceMtime: em, decisionsMtime: dm, evidence, decisions };
+  _LESSONS_INDEX_CACHE.set(cacheKey, idx);
+  return idx;
+}
+
 // 1.9.38: 사용 통계 (cumulative count, command별)
+// 1.9.65: 같은 프로세스 lifetime 메모리 캐시 — 다중 호출 시 디스크 I/O 절감
+const _USAGE_CACHE = new Map(); // root → { stats, mtime }
 function _usageStatsPath(root) { return path.join(absRoot(root), '.harness', 'cache', 'usage-stats.json'); }
 function _readUsageStats(root) {
   const p = _usageStatsPath(root);
   if (!exists(p)) return { commands: {}, drift: { criticalSeen: 0, skipped: 0, autoResolved: 0 }, since: today() };
-  try { return JSON.parse(read(p)); } catch { return { commands: {}, drift: {}, since: today() }; }
+  // 1.9.65: 캐시 hit — mtime 동일 시 재파싱 skip
+  try {
+    const mtime = fs.statSync(p).mtimeMs;
+    const cached = _USAGE_CACHE.get(p);
+    if (cached && cached.mtime === mtime) return cached.stats;
+    const stats = JSON.parse(read(p));
+    _USAGE_CACHE.set(p, { stats, mtime });
+    return stats;
+  } catch { return { commands: {}, drift: {}, since: today() }; }
 }
 function _bumpUsage(root, cmdName) {
   // 가벼운 카운터 — 명령 실행마다 호출 (sync write로 작은 파일)
@@ -6156,6 +6224,8 @@ function _bumpUsage(root, cmdName) {
     const p = _usageStatsPath(root);
     mkdirp(path.dirname(p));
     writeUtf8(p, JSON.stringify(stats, null, 2) + '\n');
+    // 1.9.65: 쓰기 후 캐시 invalidate (다음 read에서 새 mtime으로 재로드)
+    try { _USAGE_CACHE.set(p, { stats, mtime: fs.statSync(p).mtimeMs }); } catch {}
   } catch {}
 }
 
@@ -6772,7 +6842,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_usage_stats', description: 'leerness 명령별 누적 호출 통계 + drift 통계', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_session_close', description: '세션 마감 — handoff/current-state/task-log 자동 갱신', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_skill_suggest', description: '1.9.53 — 사용 패턴 자동 분석 → 새 skill 후보 제안 (Hermes-style 자동 학습)', inputSchema: { type: 'object', properties: { path: { type: 'string' }, min: { type: 'number' }, days: { type: 'number' } } } },
-    { name: 'leerness_lessons', description: '1.9.7/54 — 과거 결정·실수 자동 회수 (--auto: 현재 task 키워드 자동 추출)', inputSchema: { type: 'object', properties: { path: { type: 'string' }, query: { type: 'string' }, auto: { type: 'boolean' }, limit: { type: 'number' } } } }
+    { name: 'leerness_lessons', description: '1.9.7/54 — 과거 결정·실수 자동 회수 (--auto: 현재 task 키워드 자동 추출)', inputSchema: { type: 'object', properties: { path: { type: 'string' }, query: { type: 'string' }, auto: { type: 'boolean' }, limit: { type: 'number' } } } },
+    { 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' } } } }
   ];
 
   function send(obj) {
@@ -6814,6 +6885,7 @@ function mcpServeCmd(root) {
           case 'leerness_session_close':   cliArgs = ['session', 'close', targetPath]; break;
           case 'leerness_skill_suggest':   cliArgs = ['skill', 'suggest', '--path', targetPath, '--json', ...(args.min ? ['--min', String(args.min)] : []), ...(args.days ? ['--days', String(args.days)] : [])]; break;
           case 'leerness_lessons':         cliArgs = ['lessons', '--path', targetPath, ...(args.auto ? ['--auto'] : []), ...(args.query ? ['--query', args.query] : []), ...(args.limit ? ['--limit', String(args.limit)] : [])]; break;
+          case 'leerness_task_export':     cliArgs = ['task', 'export', '--path', targetPath, ...(args.to ? ['--to', args.to] : ['--json'])]; break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }

package/package.json

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