leerness 1.9.55 → 1.9.59

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## 1.9.59 — 2026-05-19
+
+**`session close --suggest` default 활성 — 라운드 마감 잊을 단계 없음**.
+
+### Changed (호환성 보장)
+- **`leerness session close`** — 1.9.57 `--suggest`를 **default 활성**으로 승격:
+  - 라운드 마감 시 자동으로 skill suggest + drift check + usage stats 통합 보고
+  - 사용자가 잊지 않도록 default 동작
+- **새 옵션 `--no-suggest`** — 이전 동작으로 복귀
+- **새 env `LEERNESS_NO_SUGGEST=1`** — CI/자동화 환경에서 suggest 강제 비활성
+- `--suggest` 명시 호출도 그대로 동작 (호환성)
+
+### 설치 가이드 갱신
+- banner quickStart에서 `--suggest` 명시 제거 (이제 default라 불필요)
+- `.harness/session-workflow.md` Step 6 갱신 — `--no-suggest`로 비활성 가능 명시
+
+## 1.9.58 — 2026-05-19
+
+**handoff lessons fuzzy 매칭 (어간 변형 + decisions.md 매칭)**.
+
+### Added
+- **fuzzy 매칭** — `escapeRegex(keyword.slice(0, max(4, len*0.7)))` 으로 부분 매칭:
+  - webhook ↔ webhooks ↔ webhook-payload ↔ webhooked 모두 매칭
+  - 한국어 어미 변화도 부분 매칭 (예: "결제" ↔ "결제처리" ↔ "결제검증")
+- **decisions.md 매칭 추가** — 이전엔 review-evidence.md만 → 이제 decisions.md의 *실패/롤백/취소/회귀* 결정도 자동 회수
+
+### 검증 (stress-v8)
+- X1-X4 (fuzzy 매칭: 어간/복합어/decisions/false positive 차단) 4/4 PASS
+- Y1-Y4 (session close default suggest + 옵션 호환) 4/4 PASS
+- Z1-Z4 (1.9.43~57 누적 회귀) 4/4 PASS
+- **stress-v8: 12/12 PASS**, e2e: **213/213 PASS**
+
+## 1.9.57 — 2026-05-19
+
+**`session close --suggest` + 설치 가이드 갱신**.
+
+### Added
+- **`leerness session close --suggest`** — 라운드 마감 통합 보고:
+  - skill suggest 후보 (Hermes-style 자동 학습) 상위 3
+  - drift check 상태 + 임계 초과 신호
+  - usage stats 가장 많이 쓴 명령 Top 3
+
+### 설치 가이드 갱신
+- **`_banner` quickStart 재구성** — 1.9.57+ 워크플로 강조:
+  - `npx leerness handoff .` (lessons 자동 재상기 포함)
+  - `npx leerness session close . --suggest` (마감 + 다음 라운드)
+  - `npx leerness mcp serve` (메인 에이전트용 12 도구)
+- **`.harness/session-workflow.md`** Step 6 갱신 — `--suggest`/1.9.56 lessons 자동 재상기 안내
+
+## 1.9.56 — 2026-05-19
+
+**`handoff`에 `lessons --auto` 자동 통합 — 매 세션 시작 시 과거 실패 자동 재상기**.
+
+### Added
+- **handoff 자동 lessons 재상기**:
+  - 가장 최근 in-progress/planned task의 `request`에서 키워드 자동 추출
+  - 그 키워드로 review-evidence.md의 과거 실패 매칭
+  - **🧠 과거 lessons 자동 재상기** 블록 출력 (관련 실패 ≥1건 시)
+  - 끄려면: `--no-lessons` 또는 `LEERNESS_NO_LESSONS=1`
+- 매칭 실패 시 블록 자동 숨김 (false positive 차단)
+
+### 검증 (stress-v7)
+- T1-T3 (handoff 자동 lessons) 3/3 PASS
+- U1-U3 (session close --suggest) 3/3 PASS
+- V1-V2 (설치 가이드 갱신 — banner + session-workflow.md) 2/2 PASS
+- W1-W4 (1.9.43~55 누적 회귀) 4/4 PASS
+- **stress-v7: 12/12 PASS**, e2e: **210/210 PASS**
+
 ## 1.9.55 — 2026-05-19
 
 **MCP server 12 도구 — `leerness_skill_suggest` + `leerness_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.55-green)]() [![tests](https://img.shields.io/badge/e2e-208%2F208-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.59-green)]() [![tests](https://img.shields.io/badge/e2e-213%2F213-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,7 +12,7 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.55   AI Agent Reliability Harness                      ║
+  ║  v1.9.59   AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
@@ -433,6 +433,10 @@ npm test     # = node ./scripts/e2e.js
 
 ## 변경 이력 (최근)
 
+- **1.9.59** — `session close` **--suggest default 활성** (잊을 단계 없음, `--no-suggest`로 비활성 가능) · 설치 가이드 갱신.
+- **1.9.58** — handoff lessons **fuzzy 매칭** (어간 변형, 복합어, decisions.md 매칭 추가).
+- **1.9.57** — `session close --suggest` (마감 시 skill suggest + drift + 명령 통계 통합 보고) · install banner quickStart + session-workflow.md 갱신 (1.9.56/57 흐름 자동 안내).
+- **1.9.56** — `handoff`에 lessons 자동 재상기 통합 (현재 in-progress task 키워드 매칭 → 과거 실패 자동 표시).
 - **1.9.55** — MCP server에 `leerness_skill_suggest` + `leerness_lessons` 추가 (10 → 12 도구) · lessons --auto의 stopword 확장 (false positive 차단).
 - **1.9.54** — `leerness lessons --auto` — 최근 in-progress task에서 키워드 자동 추출 → 과거 lessons 자동 매칭·재상기.
 - **1.9.53** — `leerness skill suggest` — task-log / progress-tracker / usage-stats에서 반복 패턴 **자동 감지 → 새 skill 후보 제안** (Hermes-style 자동 학습의 leerness 버전).

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.55';
+const VERSION = '1.9.59';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -276,14 +276,19 @@ leerness review <file> --persona security,performance,ux
 - 메인이 직접 통합 시나리오 작성 + 실행 (independent 검증).
 - Sub-agent 검수 vs 메인 검수 결과 *교차 일치* 확인.
 
-## Step 6. 세션 마감 + 인계
+## Step 6. 세션 마감 + 인계 + 다음 라운드 추천
 \`\`\`bash
-leerness session close .       # handoff/current-state/task-log 자동 갱신
-leerness audit . --fix         # 누락 메타 자동 보강
-leerness usage stats .         # 이번 세션 명령 카운트 확인
+leerness session close .             # 1.9.59+ — --suggest default 활성 (마감 + 다음 라운드 자동)
+leerness session close . --no-suggest  # suggest 비활성 (이전 동작)
+
+# 분리 호출도 가능:
+leerness skill suggest .             # 1.9.53 — 반복 패턴 → 새 skill 후보
+leerness drift check .               # 4 신호 + 4 레벨 점검
+leerness audit . --fix               # 누락 메타 자동 보강
 \`\`\`
 - session close가 누락되면 다음 세션 시작 시 drift critical 발생.
 - 자동 회복 옵션: \`drift check --auto-fix\` (critical 시 session close 자동 실행).
+- 1.9.56+ handoff가 매 세션 시작 시 **과거 lessons 자동 재상기** (현재 task 키워드 기준).
 
 ---
 
@@ -1699,6 +1704,60 @@ function handoff(root) {
     const cs = read(currentStatePath(root)).replace(/Updated: \d{4}-\d{2}-\d{2}/, `Updated: ${today()}`);
     writeUtf8(currentStatePath(root), cs);
   }
+  // 1.9.56: handoff에 lessons --auto 자동 통합 — 현재 in-progress task와 관련된 과거 실수/결정 자동 재상기
+  // 매 세션 시작 시 AI가 과거에 같은 키워드로 실패한 사례를 잊지 않도록.
+  // 끄려면: --no-lessons 또는 LEERNESS_NO_LESSONS=1
+  if (!has('--no-lessons') && !has('--compact') && process.env.LEERNESS_NO_LESSONS !== '1') {
+    try {
+      const lrows = readProgressRows(root);
+      const latestRow = lrows.filter(r => r.status === 'in-progress' || r.status === 'planned').pop() || lrows[lrows.length - 1];
+      if (latestRow && latestRow.request) {
+        const stopwords = new Set([
+          '이런','저런','하다','하고','있는','하지','에서',
+          '작업','구현','추가','진행','수정','변경','검토','확인',
+          '프로젝트','관리','기능','시스템','코드','파일','버전','정리','계획',
+          'next','action','task','todo','work'
+        ]);
+        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)) : '';
+          // 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 });
+            }
+          }
+          // 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 });
+            }
+          }
+          if (matches.length) {
+            const isTty = process.stdout && process.stdout.isTTY;
+            const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+            const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+            log('');
+            log(yel(`## 🧠 과거 lessons 자동 재상기 (1.9.56) — 키워드 "${keyword}"`));
+            log(dim(`  현재 task와 관련된 과거 실패/롤백 ${matches.length}건 — 같은 실수 반복 방지`));
+            for (const m of matches.slice(0, 3)) {
+              log(dim(`  • [${m.source}] ${m.title}`));
+            }
+            log(dim(`  → 전체: leerness lessons --auto --path .`));
+            log('');
+          }
+        }
+      }
+    } catch {}
+  }
   // 1.9.41: 최근 migrate 차분 알림 — migration-report.md가 24h 내면 "AI must re-read" 블록 자동 표시
   // 같은 채팅 세션의 AI 청크가 이전 버전 마인드셋이어도 새 도구를 즉시 인지하도록.
   if (!has('--no-workflow-guide') && !has('--compact')) {
@@ -3044,11 +3103,15 @@ function _banner(opts = {}) {
   lines.push('');
   for (const ln of lines) log(ln);
   if (opts.quickStart) {
-    log(C.bold(C.cyan('  ✨ 빠른 시작')));
-    log('    ' + C.green('npx leerness@latest init .') + C.dim('                          # 신규 프로젝트'));
-    log('    ' + C.green('npx leerness@latest setup-agents .') + C.dim('                  # 외부 AI CLI 설정'));
-    log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 적재'));
-    log('    ' + C.green('npx leerness verify-claim T-0001 --run-tests') + C.dim('        # 자동 검증'));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.57+ 워크플로)')));
+    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 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 agents bench "<task>"') + C.dim('                  # 3 CLI 동시 비교'));
     log('');
   }
 }
@@ -3796,6 +3859,45 @@ function sessionClose(root) {
   ok(`session-handoff.md and current-state.md updated`);
   // 1.9.12: session close 끝에 roadmap.html 자동 갱신
   _autoRoadmap(root, 'session-close');
+  // 1.9.57: --suggest 옵션 — 마감 시 skill suggest + drift check + lessons 통합 보고
+  // 1.9.59: default 활성 — --no-suggest로 명시 비활성 가능
+  const suggestEnabled = (has('--suggest') || (!has('--no-suggest') && process.env.LEERNESS_NO_SUGGEST !== '1'));
+  if (suggestEnabled) {
+    const isTty = process.stdout && process.stdout.isTTY;
+    const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+    const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+    log('');
+    log(cy('## 💡 다음 라운드 추천 (1.9.57 --suggest)'));
+    // 1) skill suggest
+    try {
+      const r = cp.spawnSync(process.execPath, [__filename, 'skill', 'suggest', '--path', root, '--min', '3', '--json'],
+        { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' } });
+      const j = JSON.parse(r.stdout);
+      if (j.candidates && j.candidates.length) {
+        log(dim('  📌 신규 skill 후보 (Hermes-style 자동 학습):'));
+        for (const c of j.candidates.slice(0, 3)) log(`    • ${c.keyword} (${c.count}회 등장, 출처: ${c.source})`);
+      }
+    } catch {}
+    // 2) drift check
+    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());
+      if (j.level) {
+        log(dim(`  🩺 drift 상태: ${j.level} ${j.score}/200`));
+        if (j.fired && j.fired.length) log(dim(`    🔥 ${j.fired.length}건 임계 초과 — \`leerness drift check\` 상세`));
+      }
+    } catch {}
+    // 3) usage stats top
+    try {
+      const stats = _readUsageStats(root);
+      const entries = Object.entries(stats.commands || {}).sort((a, b) => b[1] - a[1]).slice(0, 3);
+      if (entries.length) {
+        log(dim(`  📊 가장 많이 쓴 명령: ${entries.map(([c, n]) => `${c}(${n})`).join(', ')}`));
+      }
+    } catch {}
+    log('');
+  }
   // 1.9.13: 세션 카운터 + 자동 한 줄 요약 + 5세션마다 깊은 회고
   try {
     const sc = readSessionCounter(root);

package/package.json

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

package/scripts/e2e.js

@@ -950,6 +950,70 @@ total++;
   if (!ok) { failed++; console.log(r.stdout.slice(0, 800)); }
 }
 
+// 1.9.58/59 회귀
+total++;
+{
+  // fuzzy 매칭 — 어간 변형 (webhook ↔ webhooks)
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-fz-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  fs.writeFileSync(path.join(tmpC, '.harness', 'review-evidence.md'),
+    '## 2026-04\nNote: ✗ webhooks payload 실패\n', 'utf8');
+  cp.spawnSync(process.execPath, [CLI, 'task', 'add', 'webhook 작업', '--status', 'in-progress', '--path', tmpC], { stdio: 'ignore', timeout: 10000 });
+  const r = cp.spawnSync(process.execPath, [CLI, 'handoff', tmpC, '--no-drift-check', '--no-workflow-guide'], { encoding: 'utf8', timeout: 15000 });
+  const ok = /lessons 자동 재상기.*webhook/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.58) lessons fuzzy: webhook ↔ webhooks 어간 변형 매칭' : `✗ fuzzy 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(-500)); }
+}
+
+total++;
+{
+  // session close default suggest
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-sd-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  const r = cp.spawnSync(process.execPath, [CLI, 'session', 'close', tmpC], { encoding: 'utf8', timeout: 30000 });
+  // 1.9.59: default activated → "다음 라운드 추천" 자동 표시
+  const ok = /다음 라운드 추천|drift 상태/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.59) session close: --suggest default 활성' : `✗ default suggest 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(-500)); }
+}
+
+total++;
+{
+  // --no-suggest 비활성 (이전 동작 보존)
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-ns-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  const r = cp.spawnSync(process.execPath, [CLI, 'session', 'close', tmpC, '--no-suggest'], { encoding: 'utf8', timeout: 30000 });
+  const ok = r.status === 0 && !/다음 라운드 추천/.test(r.stdout) && /진행 요약/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.59) --no-suggest: suggest 비활성 (이전 동작)' : `✗ --no-suggest 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(-300)); }
+}
+
+// 1.9.56/57 회귀
+total++;
+{
+  // handoff 자동 lessons 재상기
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-ha-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  fs.writeFileSync(path.join(tmpC, '.harness', 'review-evidence.md'),
+    '## 2026-04-01\nNote: ✗ webhook 처리 실패\n', 'utf8');
+  cp.spawnSync(process.execPath, [CLI, 'task', 'add', 'webhook 처리 개선', '--status', 'in-progress', '--path', tmpC], { stdio: 'ignore', timeout: 10000 });
+  const r = cp.spawnSync(process.execPath, [CLI, 'handoff', tmpC, '--no-drift-check', '--no-workflow-guide'], { encoding: 'utf8', timeout: 15000 });
+  const ok = /lessons 자동 재상기.*webhook|🧠.*webhook/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.56) handoff: lessons 자동 재상기 (현재 task 키워드 매칭)' : `✗ handoff lessons 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(-500)); }
+}
+
+total++;
+{
+  // session close --suggest
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-sc-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  const r = cp.spawnSync(process.execPath, [CLI, 'session', 'close', tmpC, '--suggest'], { encoding: 'utf8', timeout: 30000 });
+  const ok = /다음 라운드 추천|drift 상태/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.57) session close --suggest: drift + skill suggest 통합' : `✗ --suggest 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(-500)); }
+}
+
 // 1.9.54/55 회귀
 total++;
 {