leerness 1.9.65 → 1.9.67

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 1.9.67 — 2026-05-19
+
+**handoff 자동 skill 추천 default ON + lessons 인덱스에 task-log 통합**.
+
+### Added — handoff 자동 skill match (default ON)
+- 매 `leerness handoff` 시 **현재 in-progress task와 매칭되는 설치된 skill을 자동 추천** (점수 + skill id + description 미리보기).
+- 1.9.45의 `LEERNESS_SKILL_AUTO_DISCOVER=1` opt-in 환경변수 의존성 제거 → default 활성.
+- 끄기: `--no-skill-suggest` 또는 `LEERNESS_NO_SKILL_SUGGEST=1`.
+- 매칭 알고리즘: `_jaccard(task.request_tokens, skill.name+description_tokens)`, top 3.
+- 매칭 점수 0이면 출력 안 함 (잡음 최소화).
+
+### Improved — lessons 인덱스 확장
+- `_loadLessonsIndex`에 **task-log.md 실패 라인** 추가 (mtime 기반 invalidation).
+- `_lidx.taskLogFails: [{title, block}]` 새 필드.
+- handoff lessons 자동 재상기에서 task-log fuzzy 매칭도 가능.
+- `leerness lessons` 명령도 같은 인덱스 사용 (split 1회).
+
+### Updated
+- `_banner` quickStart: "13 도구 노출 (task_export 포함)" + "매칭 skill 자동 추천" 안내.
+- `.harness/session-workflow.md` 템플릿: 1.9.67 라인 추가.
+
+### Verified
+- stress-v13 (1.9.67 검증) — handoff skill match default + --no-skill-suggest + lessons task-log fuzzy.
+- e2e 회귀: 219/219 PASS 유지.
+
+---
+
+## 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 인덱스 캐시**.

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.65-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.67-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.65   AI Agent Reliability Harness                      ║
+  ║  v1.9.67   AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
@@ -433,6 +433,8 @@ npm test     # = node ./scripts/e2e.js
 
 ## 변경 이력 (최근)
 
+- **1.9.67** — **handoff 자동 skill 추천 default ON** (jaccard 매칭) + lessons 인덱스에 task-log.md 실패 라인 통합 (회수 범위 확장).
+- **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 승격).

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.65';
+const VERSION = '1.9.67';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -289,6 +289,8 @@ leerness audit . --fix               # 누락 메타 자동 보강
 - session close가 누락되면 다음 세션 시작 시 drift critical 발생.
 - 자동 회복 옵션: \`drift check --auto-fix\` (critical 시 session close 자동 실행).
 - 1.9.56+ handoff가 매 세션 시작 시 **과거 lessons 자동 재상기** (현재 task 키워드 기준).
+- 1.9.67+ handoff가 현재 task와 매칭되는 **설치된 skill을 자동 추천** (jaccard 기반, default ON, \`--no-skill-suggest\`로 끄기).
+- 1.9.67+ lessons 인덱스에 \`task-log.md\` 실패 라인까지 포함 → 회수 범위 확장.
 
 ---
 
@@ -715,13 +717,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 +762,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 +853,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 });
@@ -1775,6 +1804,12 @@ function handoff(root) {
               matches.push({ source: 'decisions.md', title: d.title, block: d.block });
             }
           }
+          // 1.9.67: task-log.md 실패 라인도 fuzzy 매칭 (회수 범위 확장)
+          for (const t of (idx.taskLogFails || [])) {
+            if (fuzzyRe.test(t.block)) {
+              matches.push({ source: 'task-log.md', title: t.title, block: t.block });
+            }
+          }
           if (matches.length) {
             const isTty = process.stdout && process.stdout.isTTY;
             const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
@@ -1788,6 +1823,30 @@ function handoff(root) {
             log(dim(`  → 전체: leerness lessons --auto --path .`));
             log('');
           }
+          // 1.9.67: 현재 task와 관련된 skill 자동 추천 (default ON, 1.9.45 opt-in → default)
+          // 끄려면: --no-skill-suggest 또는 LEERNESS_NO_SKILL_SUGGEST=1
+          if (!has('--no-skill-suggest') && process.env.LEERNESS_NO_SKILL_SUGGEST !== '1') {
+            try {
+              const installed = _readInstalledSkills(root);
+              if (installed.length) {
+                const qTokens = _tokenize(String(latestRow.request));
+                const ranked = installed.map(s => ({
+                  ...s, score: _jaccard(qTokens, _tokenize(s.name + ' ' + s.description))
+                })).filter(s => s.score > 0).sort((a, b) => b.score - a.score).slice(0, 3);
+                if (ranked.length) {
+                  const isTty = process.stdout && process.stdout.isTTY;
+                  const grn = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+                  const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+                  log(grn(`## 🎯 현재 task와 매칭되는 skill 자동 추천 (1.9.67) — 키워드 "${keyword}"`));
+                  for (const r of ranked) {
+                    log(dim(`  • [${r.score.toFixed(2)}] ${r.id} — ${(r.description || '').slice(0, 60)}`));
+                  }
+                  log(dim(`  → 전체: leerness skill match "${String(latestRow.request).slice(0, 60)}"`));
+                  log('');
+                }
+              }
+            } catch {}
+          }
         }
       }
     } catch {}
@@ -3137,14 +3196,14 @@ function _banner(opts = {}) {
   lines.push('');
   for (const ln of lines) log(ln);
   if (opts.quickStart) {
-    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.57+ 워크플로)')));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.67+ 워크플로)')));
     log('    ' + C.green('npx leerness@latest init .') + C.dim('                          # 신규 프로젝트 + 외부 AI CLI 설정'));
-    log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 적재 + 과거 lessons 자동 재상기'));
+    log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 + lessons 재상기 + 매칭 skill 자동 추천'));
     log('    ' + C.green('npx leerness verify-claim T-0001 --run-tests') + C.dim('        # AI 거짓 완료 자동 검증'));
     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 서버 — 12 도구 노출'));
+    log('    ' + C.green('npx leerness mcp serve') + C.dim('                              # MCP 서버 — 13 도구 노출 (task_export 포함)'));
     log('    ' + C.green('npx leerness agents bench "<task>"') + C.dim('                  # 3 CLI 동시 비교'));
     log('');
   }
@@ -5518,10 +5577,9 @@ function lessonsCmd(root) {
     }
     log(`# Lessons --auto (1.9.54): 추출 키워드 "${query}"`);
   }
-  // 1.9.65: 인덱스 캐시 활용 (decisions/evidence split 1회만)
+  // 1.9.65/67: 인덱스 캐시 활용 (decisions/evidence/task-log split 1회만)
   const _lidx = _loadLessonsIndex(root);
   const decisions = exists(decisionsPath(root)) ? read(decisionsPath(root)) : '';
-  const tlog = exists(taskLogPath(root)) ? read(taskLogPath(root)) : '';
   const handoff = exists(handoffPath(root)) ? read(handoffPath(root)) : '';
   const lessons = [];
   // decisions: ### 블록 전체 (1.9.14: 코드블록/Template 제외)
@@ -5536,11 +5594,9 @@ function lessonsCmd(root) {
       lessons.push({ source: 'review-evidence.md', title: e.title, block: e.block });
     }
   }
-  // task-log: 실패 키워드 라인
-  for (const line of tlog.split('\n')) {
-    if (line.length > 4 && /✗|\bfail|롤백|재발|incomplete|버그/i.test(line)) {
-      lessons.push({ source: 'task-log.md', title: line.replace(/^[-*]\s*/, '').slice(0, 80), block: line });
-    }
+  // task-log: 실패 키워드 라인 (1.9.67: 인덱스 재활용)
+  for (const t of (_lidx.taskLogFails || [])) {
+    lessons.push({ source: 'task-log.md', title: t.title, block: t.block });
   }
   // handoff: 미완료/블로커 항목
   if (handoff) {
@@ -6135,16 +6191,19 @@ function driftCheckCmd(root, opts = {}) {
 }
 
 // 1.9.65: lessons blocks 인덱스 — evidence/decisions 파일 read + split을 1회로
-// key: root → { evidenceMtime, decisionsMtime, evidence: [{title, block}], decisions: [{title, block}] }
+// 1.9.67: task-log.md 실패 라인도 인덱스에 포함 (mtime 기반 invalidation)
+// key: root → { evidenceMtime, decisionsMtime, taskLogMtime, evidence/decisions/taskLogFails: [{title, block}] }
 const _LESSONS_INDEX_CACHE = new Map();
 function _loadLessonsIndex(root) {
   const ep = evidencePath(root);
   const dp = decisionsPath(root);
+  const tp = taskLogPath(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 tm = exists(tp) ? (() => { try { return fs.statSync(tp).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;
+  if (cached && cached.evidenceMtime === em && cached.decisionsMtime === dm && cached.taskLogMtime === tm) return cached;
   const evidence = [];
   if (em) {
     const txt = read(ep);
@@ -6163,7 +6222,17 @@ function _loadLessonsIndex(root) {
       if (t) decisions.push({ title: t[1].trim(), block });
     }
   }
-  const idx = { evidenceMtime: em, decisionsMtime: dm, evidence, decisions };
+  // 1.9.67: task-log.md 라인 중 실패/롤백 표지가 있는 라인만 인덱스
+  const taskLogFails = [];
+  if (tm) {
+    const txt = read(tp);
+    for (const line of txt.split('\n')) {
+      if (line.length > 4 && /✗|\bfail|롤백|재발|incomplete|버그/i.test(line)) {
+        taskLogFails.push({ title: line.replace(/^[-*]\s*/, '').slice(0, 100), block: line });
+      }
+    }
+  }
+  const idx = { evidenceMtime: em, decisionsMtime: dm, taskLogMtime: tm, evidence, decisions, taskLogFails };
   _LESSONS_INDEX_CACHE.set(cacheKey, idx);
   return idx;
 }
@@ -6815,7 +6884,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) {
@@ -6857,6 +6927,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.65",
+  "version": "1.9.67",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",