leerness 1.9.57 → 1.9.59

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # 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` + 설치 가이드 갱신**.

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.57-green)]() [![tests](https://img.shields.io/badge/e2e-210%2F210-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.57   AI Agent Reliability Harness                      ║
+  ║  v1.9.59   AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
@@ -433,6 +433,8 @@ 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 차단).

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.57';
+const VERSION = '1.9.59';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -278,9 +278,10 @@ leerness review <file> --persona security,performance,ux
 
 ## Step 6. 세션 마감 + 인계 + 다음 라운드 추천
 \`\`\`bash
-leerness session close . --suggest   # 1.9.57+ — 마감 + 다음 라운드 추천 통합
-# 단독으로도 가능:
-leerness session close .             # handoff/current-state/task-log 자동 갱신
+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               # 누락 메타 자동 보강
@@ -1720,16 +1721,26 @@ 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 검색
+          // 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('## ') && new RegExp(escapeRegex(keyword), 'i').test(block) && /✗|fail|롤백|버그|incomplete/i.test(block)) {
+            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;
@@ -3096,7 +3107,7 @@ function _banner(opts = {}) {
     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 . --suggest') + C.dim('              # 마감 + 다음 라운드 추천'));
+    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 도구 노출'));
@@ -3849,7 +3860,9 @@ function sessionClose(root) {
   // 1.9.12: session close 끝에 roadmap.html 자동 갱신
   _autoRoadmap(root, 'session-close');
   // 1.9.57: --suggest 옵션 — 마감 시 skill suggest + drift check + lessons 통합 보고
-  if (has('--suggest')) {
+  // 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;

package/package.json

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

package/scripts/e2e.js

@@ -950,6 +950,44 @@ 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++;
 {