leerness 1.9.67 → 1.9.69

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## 1.9.69 — 2026-05-19
+
+**handoff에 skill-suggestions.md rolling history hit 노출 (1.9.67 + 1.9.68 결합)**.
+
+### Added — handoff history hit
+- 매 `leerness handoff`마다 현재 task 키워드와 매칭되는 **이전 세션의 `skill match` 결과**를 함께 노출.
+- 매칭: 현재 키워드 (≥4자, 7할 길이)의 fuzzy regex로 `skill-suggestions.md`의 query 헤더 검색.
+- 표시: 최근 2건 + 각 블록의 top 2 매치 라인.
+- AI 에이전트는 **이전 세션과 같은 결정을 일관되게 유지** 가능.
+- 끄기: 같은 `--no-skill-suggest` / `LEERNESS_NO_SKILL_SUGGEST=1`.
+
+### Internal
+- `_loadSkillHistory(root)` + `_SKILL_HISTORY_CACHE` — mtime 기반 메모리 캐시 (1.9.65/66/67 캐시 패밀리 연속).
+- 같은 프로세스에서 `_lidx` / `_SKILLS_LIST_CACHE` / `_USAGE_CACHE`와 함께 lifetime 공유.
+
+### Verified
+- stress-v15 — history hit 노출 + 비매칭 시 출력 안 함 + mtime invalidation + 누적 회귀.
+- e2e 회귀: 219/219 PASS 유지.
+
+---
+
+## 1.9.68 — 2026-05-19
+
+**`skill match` rolling history 자동 누적 + 종합 회귀**.
+
+### Added — skill match rolling history (default ON)
+- `leerness skill match <query>` 호출 시 결과를 `.harness/skill-suggestions.md`에 append 누적.
+- frontmatter: `leernessRole: skill-suggestions`, `readWhen: ['skill 결정 전', '세션 시작']`.
+- 형식:
+  ```
+  ## YYYY-MM-DD HH:MM:SS — query "<keyword>"
+  - Algorithm: jaccard|embedding
+  - Top N matches:
+    - [점수] skill-id — description
+  ```
+- AI 에이전트가 같은 키워드를 반복 검색하지 않고 이력 참조 가능.
+- 끄기: `--no-save` 또는 `LEERNESS_NO_SKILL_HISTORY=1`.
+
+### Updated
+- `_banner` quickStart: 1.9.68 안내 라인 추가.
+
+### Verified — 종합 회귀 + 성능 측정
+- stress-v14 (1.9.68 + 1.9.43~67 누적 회귀 + 성능 벤치마크) — 모든 시나리오 PASS.
+- 이전 중요 기능 12종 정상 동작 검증:
+  - MCP 13 도구 / drift check / benchmark scenario / skill suggest / lessons --auto
+  - session close --suggest default / audit --strict / install 별칭 / task export
+  - handoff 자동 skill 추천 (1.9.67) / listAllSkills 캐시 (1.9.66) / usage-stats 캐시 (1.9.65)
+- 성능 (warm-up 적용): status / handoff / drift / audit / skill list / skill match.
+- e2e 회귀: 219/219 PASS 유지.
+
+---
+
 ## 1.9.67 — 2026-05-19
 
 **handoff 자동 skill 추천 default ON + lessons 인덱스에 task-log 통합**.

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.67-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.69-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.67   AI Agent Reliability Harness                      ║
+  ║  v1.9.69   AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
@@ -433,6 +433,8 @@ npm test     # = node ./scripts/e2e.js
 
 ## 변경 이력 (최근)
 
+- **1.9.69** — **handoff에 skill-suggestions.md history hit 노출** (fuzzy 매칭, 최근 2건 + top 2 매치). AI가 이전 세션 결정을 일관 유지. mtime 기반 캐시 (1.9.65/66/67 캐시 패밀리 연속).
+- **1.9.68** — **`skill match` 결과 → `.harness/skill-suggestions.md` rolling history 자동 누적** (AI가 다음 세션에 이전 추천 참조 가능). `--no-save` / `LEERNESS_NO_SKILL_HISTORY=1`로 끄기.
 - **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).

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.67';
+const VERSION = '1.9.69';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -1844,6 +1844,26 @@ function handoff(root) {
                   log(dim(`  → 전체: leerness skill match "${String(latestRow.request).slice(0, 60)}"`));
                   log('');
                 }
+                // 1.9.69: skill-suggestions.md rolling history hit — 이전 세션 매칭 결과 노출
+                const hist = _loadSkillHistory(root);
+                if (hist.blocks.length) {
+                  const histRe = new RegExp(escapeRegex(keyword.slice(0, Math.max(4, Math.floor(keyword.length * 0.7)))), 'i');
+                  const hits = hist.blocks.filter(b => histRe.test(b.query)).slice(0, 2);
+                  if (hits.length) {
+                    const isTty = process.stdout && process.stdout.isTTY;
+                    const blu = s => isTty ? `\x1b[34m${s}\x1b[0m` : s;
+                    const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+                    log(blu(`## 📒 이전 skill match 이력 (1.9.69) — 키워드 "${keyword}" 관련`));
+                    for (const h of hits) {
+                      // 블록에서 첫 1~2개 match 줄만 추출
+                      const matchLines = (h.block.match(/^\s*-\s*\[[\d.]+\][^\n]+/gm) || []).slice(0, 2);
+                      log(dim(`  [${h.at}] query "${h.query}"`));
+                      for (const ml of matchLines) log(dim(`  ${ml.trim()}`));
+                    }
+                    log(dim(`  → 전체 이력: cat .harness/skill-suggestions.md`));
+                    log('');
+                  }
+                }
               }
             } catch {}
           }
@@ -3196,9 +3216,10 @@ function _banner(opts = {}) {
   lines.push('');
   for (const ln of lines) log(ln);
   if (opts.quickStart) {
-    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.67+ 워크플로)')));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.69+ 워크플로)')));
     log('    ' + C.green('npx leerness@latest init .') + C.dim('                          # 신규 프로젝트 + 외부 AI CLI 설정'));
-    log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 + lessons 재상기 + 매칭 skill 자동 추천'));
+    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 session close .') + C.dim('                        # 마감 + 다음 라운드 추천 (default)'));
     log('');
@@ -6190,6 +6211,33 @@ function driftCheckCmd(root, opts = {}) {
   if (level === '🔴 critical') process.exitCode = 1;
 }
 
+// 1.9.69: skill-suggestions.md rolling history 인덱스 — mtime 기반 캐시
+// handoff에서 같은 키워드 과거 추천 결과를 즉시 노출 (재매칭 불필요)
+const _SKILL_HISTORY_CACHE = new Map();
+function _loadSkillHistory(root) {
+  const p = path.join(absRoot(root), '.harness', 'skill-suggestions.md');
+  if (!exists(p)) return { mtime: 0, blocks: [] };
+  let mtime = 0;
+  try { mtime = fs.statSync(p).mtimeMs; } catch {}
+  const key = absRoot(root);
+  const cached = _SKILL_HISTORY_CACHE.get(key);
+  if (cached && cached.mtime === mtime) return cached;
+  const txt = read(p);
+  const blocks = [];
+  for (const block of txt.split(/\n(?=## )/)) {
+    if (!block.startsWith('## ')) continue;
+    // 헤더에서 timestamp + query 추출
+    const h = block.match(/^## ([\d-]+ [\d:]+) — query "([^"]+)"/m);
+    if (!h) continue;
+    blocks.push({ at: h[1], query: h[2], block });
+  }
+  // 최신순 (마지막에 append되므로 reverse)
+  blocks.reverse();
+  const idx = { mtime, blocks };
+  _SKILL_HISTORY_CACHE.set(key, idx);
+  return idx;
+}
+
 // 1.9.65: lessons blocks 인덱스 — evidence/decisions 파일 read + split을 1회로
 // 1.9.67: task-log.md 실패 라인도 인덱스에 포함 (mtime 기반 invalidation)
 // key: root → { evidenceMtime, decisionsMtime, taskLogMtime, evidence/decisions/taskLogFails: [{title, block}] }
@@ -6820,6 +6868,13 @@ async function skillMatchCmd(root, query) {
     })).sort((a, b) => b.score - a.score);
   }
   const top = ranked.filter(r => r.score > 0).slice(0, 5);
+  // 1.9.68: rolling history 자동 누적 (.harness/skill-suggestions.md) — default ON
+  // 끄기: --no-save 또는 LEERNESS_NO_SKILL_HISTORY=1
+  if (!has('--no-save') && process.env.LEERNESS_NO_SKILL_HISTORY !== '1') {
+    try {
+      _appendSkillSuggestion(root, { query, useEmbedding, top });
+    } catch {}
+  }
   if (has('--json')) {
     log(JSON.stringify({ query, total: skills.length, matched: top.length, top: top.map(({ dir, ...rest }) => rest) }, null, 2));
     return;
@@ -6839,6 +6894,32 @@ async function skillMatchCmd(root, query) {
   }
   log('');
   log(`💡 사용: \`cat ${rel(root, top[0].dir)}/SKILL.md\` 또는 메인 에이전트가 이 skill 본문을 참고`);
+  log(`📒 자동 누적: .harness/skill-suggestions.md (--no-save로 끄기)`);
+}
+
+// 1.9.68: skill match rolling history append (.harness/skill-suggestions.md)
+// AI가 다음 세션에 이전 추천을 참조 가능 — readWhen: '세션 시작', 'skill 결정 전'
+function _appendSkillSuggestion(root, { query, useEmbedding, top }) {
+  const p = path.join(absRoot(root), '.harness', 'skill-suggestions.md');
+  if (!exists(p)) {
+    // 신규 파일 — frontmatter + 안내
+    const fm = `---\nleernessRole: skill-suggestions\nreadWhen:\n  - skill 결정 전\n  - 세션 시작\nupdateWhen:\n  - leerness skill match 호출 시 자동 누적 (1.9.68)\ndoNotStore:\n  - 실제 토큰\n  - 비밀번호\n  - 운영 쿠키\n  - 민감한 개인정보 원문\n---\n<!-- leerness:managed -->\n# Skill Suggestions (Rolling History)\n\n매 \`leerness skill match\` 호출이 여기 누적됩니다. AI 에이전트는 다음 세션에 같은 키워드를 다시 검색하지 말고 이력을 먼저 참조하세요.\n\n`;
+    mkdirp(path.dirname(p));
+    writeUtf8(p, fm);
+  }
+  const algo = useEmbedding ? 'embedding' : 'jaccard';
+  const ts = new Date().toISOString();
+  let block = `\n## ${ts.slice(0, 19).replace('T', ' ')} — query "${(query || '').slice(0, 80)}"\n`;
+  block += `- Algorithm: ${algo}\n`;
+  if (!top.length) {
+    block += `- Matched: 0 — 다른 키워드 또는 \`leerness skill discover\` 권장\n`;
+  } else {
+    block += `- Top ${top.length} matches:\n`;
+    for (const r of top) {
+      block += `  - [${r.score.toFixed(2)}] ${r.id} — ${(r.description || '').slice(0, 80)}\n`;
+    }
+  }
+  append(p, block);
 }
 
 // 1.9.43: skill export-all — 모든 자체 skill을 agentskills.io 표준 SKILL.md로 일괄 export

package/package.json

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