leerness 1.9.331 → 1.9.332

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.9.332 — 2026-06-05 — UR-0025(증분): lessons.md 파서 분리
+
+**🧩 순수 lessons.md 파서(`_parseLessonEntries`)를 lib/pure-utils 로 이전 (인라인 파싱 → 재사용 가능 단일 출처).** (UR-0025 micro-증분 계속)
+
+### 구현 (UR-0025)
+1. **`_parseLessonEntries(text)`** — lessons.md 블록(### 날짜)→엔트리 `{date, text, tag}` 파싱 → `lib/pure-utils.js`. `lessonListCmd` 의 인라인 루프를 헬퍼 호출로 교체(필터는 명령에 유지). decision/roadmap 파서와 동일 패턴.
+2. selftest 79→80 · e2e 276→277.
+
+### 검증
+- **selftest 80/80 PASS** · **E2E 277/277 PASS** (회귀 0).
+- 실측: `_parseLessonEntries` 2엔트리(date/text/tag, 미존재 tag=null) · lesson save+list "total 1, tag lock" 정상.
+
+### 비고 (UR-0025)
+lib/pure-utils 누적 ~38종. 순수 함수/인라인 파서 추출은 사실상 한계 — 남은 harness.js 는 command/fs/state 결합이라 추가 분리는 dependency 주입을 동반(아키텍처). UR-0025 는 실질적으로 안전 추출 범위를 소진했으며, 다음 방향(서브시스템 심층 분리 / UR-0053 / UR-0054 ② / 일단락)은 사용자 결정을 권장.
+
 ## 1.9.331 — 2026-06-05 — UR-0025(서브시스템): brief 빌더 분리 (VERSION 주입)
 
 **🧩 project-brief 텍스트 빌더(`_briefReadmeBlock`/`_briefBlueprint`) + 마커(BRIEF_START/END)를 lib/pure-utils 로 이전 — brief 순수 레이어 완성.** (사용자 선택: UR-0025 서브시스템 추출)

package/README.md

@@ -3,7 +3,7 @@
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.331-green)]() [![tests](https://img.shields.io/badge/e2e-276%2F276-success)]() [![selftest](https://img.shields.io/badge/selftest-79-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![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.332-green)]() [![tests](https://img.shields.io/badge/e2e-277%2F277-success)]() [![selftest](https://img.shields.io/badge/selftest-80-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.331 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.332 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -525,7 +525,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.331는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
+Leerness v1.9.332는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.331는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.9.331)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.332)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -584,6 +584,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.9.331: 2026-06-05
+Last synced by Leerness v1.9.332: 2026-06-05
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -15,13 +15,14 @@ const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel,
   _getLocalTz, _formatLocal, _truncate, _splitList,
   _roadmapMapStatus, _roadmapParseMilestones, _roadmapParseTokens,
   _BRIEF_FIELDS, _briefFilled,
-  BRIEF_START, BRIEF_END, _briefReadmeBlock, _briefBlueprint } = require('../lib/pure-utils');  // 1.9.318~331 (UR-0025): 순수 유틸 모듈 분리
+  BRIEF_START, BRIEF_END, _briefReadmeBlock, _briefBlueprint,
+  _parseLessonEntries } = require('../lib/pure-utils');  // 1.9.318~332 (UR-0025): 순수 유틸 모듈 분리
 // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
 const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST } = require('../lib/catalogs');
 
-const VERSION = '1.9.331';
+const VERSION = '1.9.332';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3075,6 +3076,7 @@ function _selfTestCases() {
     { name: 'lib/pure-utils: roadmap MD 파서 분리(_roadmapMapStatus/Milestones/Tokens) + 인라인 제거 (UR-0025 1.9.329)', run: () => { const m = require('../lib/pure-utils'); const work = m._roadmapMapStatus('REQUESTED') === 'planned' && m._roadmapMapStatus('done') === 'done' && m._roadmapParseMilestones('### M-0001. 로그인\nStatus: in-progress\nProgress: 40%')[0].progress === 40 && m._roadmapParseTokens('| color | #fff |').color === '#fff'; const src = read(__filename); const moved = m._roadmapMapStatus === _roadmapMapStatus && !/^function _roadmapMapStatus\(/m.test(src) && !/^function _roadmapParseMilestones\(/m.test(src) && !/^function _roadmapParseTokens\(/m.test(src); return work && moved; } },
     { name: 'lib/pure-utils: project-brief config 분리(_BRIEF_FIELDS/_briefFilled) + 인라인 제거 (UR-0025 1.9.330)', run: () => { const m = require('../lib/pure-utils'); const cfgOk = Array.isArray(m._BRIEF_FIELDS) && m._BRIEF_FIELDS.length === 10 && m._BRIEF_FIELDS[0].key === 'intro'; const work = m._briefFilled({ intro: 'x', features: ['a'] }) === 2 && m._briefFilled({}) === 0; const src = read(__filename); const moved = m._briefFilled === _briefFilled && m._BRIEF_FIELDS === _BRIEF_FIELDS && !/^const _BRIEF_FIELDS = \[/m.test(src) && !/^function _briefFilled\(/m.test(src); return cfgOk && work && moved; } },
     { name: 'lib/pure-utils: brief 빌더 분리(_briefReadmeBlock/_briefBlueprint + BRIEF 마커, VERSION 주입) (UR-0025 1.9.331)', run: () => { const m = require('../lib/pure-utils'); const fnOk = typeof m._briefReadmeBlock === 'function' && typeof m._briefBlueprint === 'function' && m.BRIEF_START.includes('project-brief:start'); const b = { project: 'X', intro: 'i', features: ['f1'] }; const rb = m._briefReadmeBlock(b); const bp = m._briefBlueprint(b, '9.9.9'); const work = rb.includes(m.BRIEF_START) && rb.includes(m.BRIEF_END) && /f1/.test(rb) && /Blueprint/.test(bp) && /leerness v9\.9\.9/.test(bp); const src = read(__filename); const moved = m._briefBlueprint === _briefBlueprint && m.BRIEF_START === BRIEF_START && !/^function _briefReadmeBlock\(/m.test(src) && !/^function _briefBlueprint\(/m.test(src) && !/^const BRIEF_START =/m.test(src); return fnOk && work && moved; } },
+    { name: 'lib/pure-utils: lessons.md 파서 분리(_parseLessonEntries) + 인라인 제거 (UR-0025 1.9.332)', run: () => { const m = require('../lib/pure-utils'); const r = m._parseLessonEntries('### 2026-06-05\n- Lesson: A\n- Tag: t\n\n### 2026-06-04\n- Lesson: B'); const work = r.length === 2 && r[0].text === 'A' && r[0].tag === 't' && r[1].tag === null && r[0].date === '2026-06-05'; const src = read(__filename); const moved = m._parseLessonEntries === _parseLessonEntries && !/^function _parseLessonEntries\(/m.test(src) && src.includes('for (const lesson of _parseLessonEntries(text))'); return work && moved; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -6603,17 +6605,8 @@ function lessonListCmd(root, opts = {}) {
   }
   const text = read(lp);
   const lessons = [];
-  for (const block of text.split(/\n(?=### )/)) {
-    if (!block.startsWith('### ')) continue;
-    const dateMatch = block.match(/^### (\d{4}-\d{2}-\d{2}[^\n]*)/);
-    const lessonMatch = block.match(/- Lesson:[ \t]*(.+)/);
-    const tagMatch = block.match(/- Tag:[ \t]*(.+)/);
-    if (!lessonMatch) continue;
-    const lesson = {
-      date: dateMatch ? dateMatch[1].trim() : null,
-      text: lessonMatch[1].trim(),
-      tag: tagMatch ? tagMatch[1].trim() : null,
-    };
+  // 1.9.332 (UR-0025): 블록→엔트리 파싱은 순수 _parseLessonEntries (lib/pure-utils), 필터는 명령에 유지.
+  for (const lesson of _parseLessonEntries(text)) {
     if (tagFilter && lesson.tag !== tagFilter) continue;
     // 1.9.139: query 필터 — lesson text 또는 tag 매칭
     if (queryRe && !queryRe.test(lesson.text) && !queryRe.test(lesson.tag || '')) continue;

package/lib/pure-utils.js

@@ -361,6 +361,20 @@ function _briefBlueprint(brief, version) {
   return L.join('\n');
 }
 
+// 1.9.332 (UR-0025): 순수 lessons.md 파서 — 블록(### 날짜)→엔트리 {date, text, tag}. 필터는 호출측.
+function _parseLessonEntries(text) {
+  const out = [];
+  for (const block of String(text || '').split(/\n(?=### )/)) {
+    if (!block.startsWith('### ')) continue;
+    const dateMatch = block.match(/^### (\d{4}-\d{2}-\d{2}[^\n]*)/);
+    const lessonMatch = block.match(/- Lesson:[ \t]*(.+)/);
+    const tagMatch = block.match(/- Tag:[ \t]*(.+)/);
+    if (!lessonMatch) continue;
+    out.push({ date: dateMatch ? dateMatch[1].trim() : null, text: lessonMatch[1].trim(), tag: tagMatch ? tagMatch[1].trim() : null });
+  }
+  return out;
+}
+
 module.exports = {
   _isSecretKey, compareVer, parseHarnessVersion,
   _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
@@ -383,5 +397,7 @@ module.exports = {
   // 1.9.330 (UR-0025): project-brief 필드 config + 채움 카운트
   _BRIEF_FIELDS, _briefFilled,
   // 1.9.331 (UR-0025): project-brief 텍스트 빌더 + 마커
-  BRIEF_START, BRIEF_END, _briefReadmeBlock, _briefBlueprint
+  BRIEF_START, BRIEF_END, _briefReadmeBlock, _briefBlueprint,
+  // 1.9.332 (UR-0025): 순수 lessons.md 파서
+  _parseLessonEntries
 };

package/package.json

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

package/scripts/e2e.js

@@ -4083,5 +4083,29 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.332 회귀 (UR-0025 모듈화): lessons.md 파서(_parseLessonEntries) lib/pure-utils 분리 + lesson list 회귀
+total++;
+{
+  let ok = false;
+  try {
+    const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
+    const r = m._parseLessonEntries('### 2026-06-05\n- Lesson: A\n- Tag: t\n\n### 2026-06-04\n- Lesson: B');
+    const work = typeof m._parseLessonEntries === 'function' && r.length === 2 && r[0].text === 'A' && r[0].tag === 't' && r[1].tag === null;
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
+    const movedOut = !/function _parseLessonEntries\(/.test(harnessSrc) && _puImp.includes('_parseLessonEntries');
+    // 소비 명령 회귀: lesson save + list --json
+    const ld = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-lesson-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', ld, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+    cp.spawnSync(process.execPath, [CLI, 'lesson', 'save', '락 reentrant', '--tag', 'lock', '--path', ld], { encoding: 'utf8', timeout: 20000 });
+    const lr = cp.spawnSync(process.execPath, [CLI, 'lesson', 'list', '--path', ld, '--json'], { encoding: 'utf8', timeout: 20000 });
+    let cmdOk = false; try { const j = JSON.parse(lr.stdout); cmdOk = j.total === 1 && j.lessons[0].tag === 'lock'; } catch {}
+    ok = work && movedOut && cmdOk;
+    fs.rmSync(ld, { recursive: true, force: true });
+  } catch {}
+  console.log(ok ? '✓ B(1.9.332) lib/pure-utils lessons 파서 분리: 모듈 단일출처 + 인라인 제거 + lesson list (UR-0025)' : '✗ lessons 파서 분리 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);