leerness 1.9.393 → 1.9.395

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 1.9.395 — 2026-06-06 — 행위검증 회귀가드: audit FP/FN + canonical 파이프 round-trip (UR-0096)
+
+**🛡 광범위 행위검증으로 실 버그 탐색 — 신규 버그 0(성숙·견고 확인) + 가드 없던 2영역에 net-new 회귀 가드 추가.**
+
+### 배경 (whats-new 버그 발견의 후속 — 행위검증 확대)
+1.9.393 의 whats-new 버그가 행위검증의 실익을 보여줘, audit/version/canonical 핵심 로직을 구성된 시나리오로 광범위 검증:
+- audit README배지 mismatch / current-state stale (FP/FN) · compareVer(multi-digit 6종) · parseHarnessVersion(계약) · decisions/lessons round-trip(파이프/em-dash/콜론) — **모두 정상, 신규 버그 0**.
+
+### 구현 (정직: no-op/가짜수정 안 만듦 — 미가드 영역 보강만)
+- **e2e B(1.9.395)**: audit `readme_version_mismatch`(불일치 감지 + 일치 시 FP 0) + `current_state_stale`(2020 감지 + 오늘 FP 0) — 종전 전용 e2e 가드 부재였던 검증.
+- **selftest**: decisions/lessons canonical round-trip 엣지문자(파이프 `|`=테이블 구분자/em-dash/콜론) 무손상 + idempotent — 데이터 손상 회귀 가드.
+
+### 검증 (회귀 0)
+- **selftest 140→141 PASS** · **E2E 333→334 PASS**.
+- compareVer 17곳 기존 가드 + 신규 2가드 = audit/canonical 커버리지 보강.
+
+## 1.9.394 — 2026-06-06 — UR-0025: whatsNewCmd → lib/diagnostics.js (whats-new 완결) + 파서 형제버그 감사
+
+**🧩 whats-new 핸들러를 lib/diagnostics.js 로 분리 — whats-new 서브시스템 완전 모듈화. + /m `$` 절단 버그 클래스 전수 감사(클린).**
+
+### 배경
+1.9.393 에서 whats-new 파서(`_parseChangelogBetween`)를 pure-utils 로 빼고 버그 2건을 고쳤다. 후속으로 (1) **같은 부류의 형제 버그 감사** + (2) whatsNewCmd 핸들러 자체 분리로 서브시스템을 완결.
+
+### 구현
+1. **파서 형제버그 감사**: `|$)` lookahead + `/m` 조합으로 줄끝 절단되는 정규식을 전수 검색. 다른 5개(`Tasks:` 섹션 / `## Incomplete` / env-family / secret value / lang) 는 모두 `/m` 미사용이거나 `$`=문자열끝으로 **올바름** → 형제 버그 없음(no-op 릴리스 안 만듦).
+2. **whatsNewCmd → lib/diagnostics.js**: introspection 핸들러(~58줄) 이전. require: `./io`(absRoot/exists/read/log/fail) · `./pure-utils`(parseHarnessVersion/_parseChangelogBetween) · node path. DI: VERSION/arg/has. CHANGELOG 경로 fallback `lib/../CHANGELOG.md`(= pkg 루트, bin/ 과 동일).
+3. harness thin wrapper. dispatch·동작·출력·exit code 무변경.
+
+### 검증 (회귀 0)
+- **selftest 139→140 PASS** (lib/diagnostics whatsNewCmd export + 위임 와이어 + lib 본문 이동 + behavioral: tmp CHANGELOG `--from 1.9.49 --to 1.9.50 --json` → 1 version).
+- **E2E 333 유지 PASS** (whats-new B(1.9.393) + 회귀). 락 flake 시 재실행.
+- 실측: whats-new --from 1.9.388 --json(5 versions) · 사람용 · --from 누락 exit1 보존.
+
 ## 1.9.393 — 2026-06-06 — whats-new 파서 BUG-fix + _parseChangelogBetween → pure-utils (UR-0025/UR-0094)
 
 **🐞 `whats-new` 가 현재 CHANGELOG 형식(`## X — DATE — title`)에서 0건 반환하던 버그 수정 + 파서를 lib/pure-utils.js 로 추출.**

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.393-green)]() [![tests](https://img.shields.io/badge/e2e-333%2F333-success)]() [![selftest](https://img.shields.io/badge/selftest-139-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-85-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.395-green)]() [![tests](https://img.shields.io/badge/e2e-334%2F334-success)]() [![selftest](https://img.shields.io/badge/selftest-141-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-85-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.393 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.395 하네스를 사용합니다. 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.393는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.9.395는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.393는 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.393)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.395)** · 매 라운드 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.393: 2026-06-06
+Last synced by Leerness v1.9.395: 2026-06-06
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -31,7 +31,7 @@ const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInG
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS, BUILTIN_CATALOG, ROADMAP_STATUS_LABEL, ROADMAP_STATUS_COLOR, SECRET_PATTERNS, MERGE_OVERWRITE_FILES, MINIMAL_SKIP_KEYS, REQUIRED_WORKSPACE_FILES, KEYWORD_STOPWORDS, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344/368/369 (UR-0025): catalog 분리 (MERGE_OVERWRITE_FILES/MINIMAL_SKIP_KEYS 포함)
 
-const VERSION = '1.9.393';
+const VERSION = '1.9.395';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2998,6 +2998,8 @@ function _selfTestCases() {
     { name: 'UR-0025 큰핸들러 모듈화: feature add/link/impact/list/show → lib/feature.js + DI + _featureImpactBfs pure 공유 (1.9.391)', run: () => { const m = require('../lib/feature'); const p = require('../lib/pure-utils'); const expOk = ['featureAddCmd', 'featureLinkCmd', 'featureImpactCmd', 'featureListCmd', 'featureShowCmd'].every(k => typeof m[k] === 'function'); const bfsRefOk = p._featureImpactBfs === _featureImpactBfs; const nodes = [{ id: 'F-0001', title: 'A', affects: ['F-0002'], dependsOn: [], coChangesWith: [] }, { id: 'F-0002', title: 'B', affects: [], dependsOn: [], coChangesWith: [] }]; const r = p._featureImpactBfs(nodes, 'F-0001'); const bfsWork = r.length === 1 && r[0].id === 'F-0002' && r[0].via === 'affects'; const src = read(__filename); const delegated = src.includes("require('../lib/feature')") && src.includes('_feature.featureImpactCmd(root, fromId, _featureDeps())'); const featSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'feature.js')); const movedToLib = featSrc.includes("require('./pure-utils')") && featSrc.includes('feature added:'); let behavOk = false; const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_ft_')); const save = process.argv; const _w = process.stdout.write; let out = ''; try { fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true }); process.argv = ['node', 'h', 'feature', 'list', '--json']; process.stdout.write = s => { out += s; return true; }; featureListCmd(tmp); } catch {} finally { process.stdout.write = _w; process.argv = save; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } try { const j = JSON.parse(out); behavOk = j.total === 0 && Array.isArray(j.features); } catch {} return expOk && bfsRefOk && bfsWork && delegated && movedToLib && behavOk; } },
     { name: 'UR-0025 큰핸들러 모듈화: doctor/which → lib/diagnostics.js + DI 위임 + 동작 (1.9.392)', run: () => { const m = require('../lib/diagnostics'); const expOk = typeof m.doctorCmd === 'function' && typeof m.whichCmd === 'function'; const src = read(__filename); const delegated = src.includes("require('../lib/diagnostics')") && src.includes('_diag.doctorCmd(opts,') && src.includes('_diag.whichCmd('); const diagSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'diagnostics.js')); const movedToLib = diagSrc.includes('leerness doctor') && diagSrc.includes('_selfTestCases'); let behavOk = false; const _w = process.stdout.write; const savedExit = process.exitCode; try { process.stdout.write = () => true; const rep = m.doctorCmd({ json: true }, { VERSION, _selfTestCases: () => [], _detectShellCtx: () => ({ shell: 'test', psVersion: null }), _mcpToolCount: () => 7, has: () => true, harnessPath: 'h.js' }); behavOk = !!rep && rep.version === VERSION && rep.selftest.total === 0 && rep.healthy === true && rep.mcpTools === 7; } catch {} finally { process.stdout.write = _w; process.exitCode = savedExit; } return expOk && delegated && movedToLib && behavOk; } },
     { name: 'UR-0025/whats-new BUG-fix: _parseChangelogBetween pure 추출 + "## X — DATE — title" 헤더 파싱 (1.9.393)', run: () => { const m = require('../lib/pure-utils'); if (m._parseChangelogBetween !== _parseChangelogBetween) return false; const cl = '## 1.9.393 — 2026-06-06 — Title\n- `leerness foo`\n- `--flagx`\n- `.harness/x.md`\n\n## 1.9.392 — 2026-06-05 — Y\n- y\n\n## 1.9.391 — 2026-06-04 — Z\n- z\n'; const r = m._parseChangelogBetween(cl, '1.9.391', '1.9.393'); const rangeOk = r.length === 2 && r[0].version === '1.9.393' && r[1].version === '1.9.392'; const extractOk = r[0].newCommands.includes('foo') && r[0].newFlags.includes('--flagx') && r[0].newFiles.includes('.harness/x.md'); const titlelessOk = m._parseChangelogBetween('## 1.9.50\n- a\n## 1.9.49\n- b\n', '1.9.49', '1.9.50').length === 1; const src = read(__filename); const moved = src.includes("require('../lib/pure-utils')") && !/function _parseChangelogBetween\(changelogText/.test(src); return rangeOk && extractOk && titlelessOk && moved; } },
+    { name: 'UR-0025 whats-new 완결: whatsNewCmd → lib/diagnostics.js + DI 위임 + 동작 (1.9.394)', run: () => { const m = require('../lib/diagnostics'); const expOk = typeof m.whatsNewCmd === 'function'; const src = read(__filename); const delegated = src.includes('_diag.whatsNewCmd(root,'); const diagSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'diagnostics.js')); const movedToLib = diagSrc.includes('leerness whats-new') && diagSrc.includes('_parseChangelogBetween'); let behavOk = false; const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_wn_')); const save = process.argv; const _w = process.stdout.write; let out = ''; try { fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true }); fs.writeFileSync(path.join(tmp, 'CHANGELOG.md'), '## 1.9.50 — 2026-06-06 — A\n- `leerness x`\n\n## 1.9.49 — 2026-06-05 — B\n- old\n'); process.argv = ['node', 'h', 'whats-new', tmp, '--from', '1.9.49', '--to', '1.9.50', '--json']; process.stdout.write = s => { out += s; return true; }; whatsNewCmd(tmp); } catch {} finally { process.stdout.write = _w; process.argv = save; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } try { const j = JSON.parse(out); behavOk = j.from === '1.9.49' && j.to === '1.9.50' && Array.isArray(j.versions) && j.versions.length === 1 && j.versions[0].version === '1.9.50'; } catch {} return expOk && delegated && movedToLib && behavOk; } },
+    { name: '회귀가드: decisions/lessons canonical round-trip 엣지문자(pipe/dash/colon) 무손상 + idempotent (1.9.395)', run: () => { const m = require('../lib/pure-utils'); const d = [{ date: '2026-06-06', title: 'A | pipe', decision: 'use X | Y', reason: 'r—dash', alternatives: 'alt: colon', impact: 'i' }]; const dback = m._decisionsFromMd(m._renderDecisionsMd(d)); const dOk = dback.length === 1 && dback[0].title === 'A | pipe' && dback[0].decision === 'use X | Y' && dback[0].reason === 'r—dash'; const dIdem = JSON.stringify(dback) === JSON.stringify(m._decisionsFromMd(m._renderDecisionsMd(dback))); const l = [{ date: '2026-06-06', text: 'lesson | with — chars: ok', tag: 't' }]; const lback = m._parseLessonEntries(m._renderLessonsMd(l)); const lOk = lback.length === 1 && lback[0].text === 'lesson | with — chars: ok'; const lIdem = JSON.stringify(lback) === JSON.stringify(m._parseLessonEntries(m._renderLessonsMd(lback))); return dOk && dIdem && lOk && lIdem; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -16416,64 +16418,8 @@ function mcpServeCmd(root) {
   process.on('SIGTERM', () => process.exit(0));
 }
 
-function whatsNewCmd(root) {
-  root = absRoot(root || process.cwd());
-  const fromV = arg('--from', null) || (function () {
-    const hv = path.join(root, '.harness', 'HARNESS_VERSION');
-    if (exists(hv)) { try { return parseHarnessVersion(read(hv)).base || parseHarnessVersion(read(hv)).plus; } catch { return null; } }
-    return null;
-  })();
-  const toV = arg('--to', null) || VERSION;
-  if (!fromV) {
-    fail('현재 버전을 파악할 수 없습니다. --from <version> 명시');
-    return process.exit(1);
-  }
-  // CHANGELOG.md — 우선 root, 없으면 leerness-pkg 자체
-  let changelogPath = path.join(root, 'CHANGELOG.md');
-  if (!exists(changelogPath)) changelogPath = path.join(__dirname, '..', 'CHANGELOG.md');
-  if (!exists(changelogPath)) {
-    fail('CHANGELOG.md 없음');
-    return process.exit(1);
-  }
-  const diff = _parseChangelogBetween(read(changelogPath), fromV, toV);
-  if (has('--json')) { log(JSON.stringify({ from: fromV, to: toV, versions: diff }, null, 2)); return; }
-  if (!diff.length) {
-    log(`# leerness whats-new (1.9.41)`);
-    log(`현재 ${fromV} ↔ 대상 ${toV}: 새 항목 없음 (또는 CHANGELOG에 기록 안 됨)`);
-    return;
-  }
-  log(`# leerness whats-new (1.9.41)`);
-  log(`현재 워크스페이스 버전: ${fromV} → 대상: ${toV}`);
-  log(`범위: ${diff.length}개 버전 (${diff[0].version} → ${diff[diff.length - 1].version})`);
-  log('');
-  // AI 가독 요약 — 각 버전당 한 줄 + 신규 명령/플래그/파일
-  log(`## 🆕 신규 명령·플래그·파일 (AI 에이전트는 다음 명령을 우선 시도)`);
-  const allCommands = new Set();
-  const allFlags = new Set();
-  const allFiles = new Set();
-  for (const v of diff) {
-    v.newCommands.forEach(c => allCommands.add(c));
-    v.newFlags.forEach(f => allFlags.add(f));
-    v.newFiles.forEach(f => allFiles.add(f));
-  }
-  if (allCommands.size) log(`  📌 신규 명령: ${[...allCommands].join(', ')}`);
-  if (allFlags.size)    log(`  🚩 신규 플래그: ${[...allFlags].join(', ')}`);
-  if (allFiles.size)    log(`  📄 신규 파일: ${[...allFiles].join(', ')}`);
-  log('');
-  log(`## 📜 버전별 헤드라인`);
-  for (const v of diff) {
-    // body 첫 줄(또는 strong header) 추출
-    const firstLine = (v.body.match(/^\*\*([^*]+)\*\*/) || [])[1]
-                   || (v.body.split('\n').find(l => l.trim() && !l.startsWith('##')) || '').trim().slice(0, 120);
-    log(`  • ${v.version}${v.date ? ` (${v.date})` : ''} — ${firstLine || '(no headline)'}`);
-  }
-  log('');
-  log(`## 💡 권장 행동`);
-  log(`  1. 위 신규 명령들을 시도해 보세요 (예: \`leerness <명령> --help\`)`);
-  log(`  2. 신규 파일들을 읽어 보세요 (예: \`cat .harness/session-workflow.md\`)`);
-  log(`  3. AGENTS.md/CLAUDE.md 재독 — migrate가 인스트럭션을 업데이트했을 수 있음`);
-  log(`  4. 상세: \`cat CHANGELOG.md\` 또는 \`leerness whats-new --json\``);
-}
+// 1.9.394 (UR-0025): whatsNewCmd 를 lib/diagnostics.js 로 분리 (whats-new 서브시스템 완결 — 파서는 1.9.393 에 pure-utils 로). deps 위임.
+function whatsNewCmd(root) { return _diag.whatsNewCmd(root, { VERSION, arg, has }); }
 
 // 1.9.71: .env / .env.example 자동 동기화 — 누락 키 감지 + (옵션) 자동 추가
 // 보안 정책: .env의 실제 값은 절대 옮기지 않음. .env.example엔 키만 (빈 값).

package/lib/diagnostics.js

@@ -5,7 +5,9 @@
 //     _selfTestCases 의 각 case.run 클로저는 harness 스코프를 유지하므로 함수 참조 주입만으로 정상 동작.
 'use strict';
 const cp = require('child_process');
-const { log } = require('./io');
+const path = require('path');
+const { log, fail, absRoot, exists, read } = require('./io');
+const { parseHarnessVersion, _parseChangelogBetween } = require('./pure-utils');
 
 function doctorCmd(opts = {}, deps = {}) {
   const { VERSION, _selfTestCases, _detectShellCtx, _mcpToolCount, has, harnessPath } = deps;
@@ -126,4 +128,66 @@ function whichCmd(deps = {}) {
   log(`  3) npm cache clean --force                     # npx 캐시 강제 비우기 (의심 시)`);
 }
 
-module.exports = { doctorCmd, whichCmd };
+// 1.9.394 (UR-0025): whats-new — 현재 워크스페이스 버전 → 도구 버전 CHANGELOG 차분(신규 명령/플래그/파일 요약). introspection 핸들러.
+//   순수 파서 _parseChangelogBetween(pure-utils) 사용. deps: VERSION/arg/has. CHANGELOG 경로는 root 우선, 없으면 pkg 자체(lib/../).
+function whatsNewCmd(root, deps = {}) {
+  const { VERSION, arg, has } = deps;
+  root = absRoot(root || process.cwd());
+  const fromV = arg('--from', null) || (function () {
+    const hv = path.join(root, '.harness', 'HARNESS_VERSION');
+    if (exists(hv)) { try { return parseHarnessVersion(read(hv)).base || parseHarnessVersion(read(hv)).plus; } catch { return null; } }
+    return null;
+  })();
+  const toV = arg('--to', null) || VERSION;
+  if (!fromV) {
+    fail('현재 버전을 파악할 수 없습니다. --from <version> 명시');
+    return process.exit(1);
+  }
+  // CHANGELOG.md — 우선 root, 없으면 leerness-pkg 자체 (lib/../CHANGELOG.md = pkg 루트)
+  let changelogPath = path.join(root, 'CHANGELOG.md');
+  if (!exists(changelogPath)) changelogPath = path.join(__dirname, '..', 'CHANGELOG.md');
+  if (!exists(changelogPath)) {
+    fail('CHANGELOG.md 없음');
+    return process.exit(1);
+  }
+  const diff = _parseChangelogBetween(read(changelogPath), fromV, toV);
+  if (has('--json')) { log(JSON.stringify({ from: fromV, to: toV, versions: diff }, null, 2)); return; }
+  if (!diff.length) {
+    log(`# leerness whats-new (1.9.41)`);
+    log(`현재 ${fromV} ↔ 대상 ${toV}: 새 항목 없음 (또는 CHANGELOG에 기록 안 됨)`);
+    return;
+  }
+  log(`# leerness whats-new (1.9.41)`);
+  log(`현재 워크스페이스 버전: ${fromV} → 대상: ${toV}`);
+  log(`범위: ${diff.length}개 버전 (${diff[0].version} → ${diff[diff.length - 1].version})`);
+  log('');
+  // AI 가독 요약 — 각 버전당 한 줄 + 신규 명령/플래그/파일
+  log(`## 🆕 신규 명령·플래그·파일 (AI 에이전트는 다음 명령을 우선 시도)`);
+  const allCommands = new Set();
+  const allFlags = new Set();
+  const allFiles = new Set();
+  for (const v of diff) {
+    v.newCommands.forEach(c => allCommands.add(c));
+    v.newFlags.forEach(f => allFlags.add(f));
+    v.newFiles.forEach(f => allFiles.add(f));
+  }
+  if (allCommands.size) log(`  📌 신규 명령: ${[...allCommands].join(', ')}`);
+  if (allFlags.size)    log(`  🚩 신규 플래그: ${[...allFlags].join(', ')}`);
+  if (allFiles.size)    log(`  📄 신규 파일: ${[...allFiles].join(', ')}`);
+  log('');
+  log(`## 📜 버전별 헤드라인`);
+  for (const v of diff) {
+    // body 첫 줄(또는 strong header) 추출
+    const firstLine = (v.body.match(/^\*\*([^*]+)\*\*/) || [])[1]
+                   || (v.body.split('\n').find(l => l.trim() && !l.startsWith('##')) || '').trim().slice(0, 120);
+    log(`  • ${v.version}${v.date ? ` (${v.date})` : ''} — ${firstLine || '(no headline)'}`);
+  }
+  log('');
+  log(`## 💡 권장 행동`);
+  log(`  1. 위 신규 명령들을 시도해 보세요 (예: \`leerness <명령> --help\`)`);
+  log(`  2. 신규 파일들을 읽어 보세요 (예: \`cat .harness/session-workflow.md\`)`);
+  log(`  3. AGENTS.md/CLAUDE.md 재독 — migrate가 인스트럭션을 업데이트했을 수 있음`);
+  log(`  4. 상세: \`cat CHANGELOG.md\` 또는 \`leerness whats-new --json\``);
+}
+
+module.exports = { doctorCmd, whichCmd, whatsNewCmd };

package/package.json

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

package/scripts/e2e.js

@@ -5468,5 +5468,35 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.395 회귀가드 (행위검증): audit README 배지 mismatch + current-state stale 의 FP/FN — 종전 전용 e2e 가드 부재
+total++;
+{
+  let ok = false;
+  try {
+    const d = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-auditchk-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', 'ko'], { encoding: 'utf8', timeout: 30000 });
+    const kinds = (root) => { const r = cp.spawnSync(process.execPath, [CLI, 'audit', root, '--json', '--no-npm-audit'], { encoding: 'utf8', timeout: 20000 }); try { return (JSON.parse(r.stdout).findings || []).map(f => f.kind); } catch { return null; } };
+    const readme = path.join(d, 'README.md'), pkg = path.join(d, 'package.json'), csp = path.join(d, '.harness', 'current-state.md');
+    // ① README 배지(1.0.0) ≠ package.json(2.0.0) → readme_version_mismatch
+    fs.writeFileSync(readme, '# T\n![v](https://img.shields.io/badge/version-1.0.0-green)\n');
+    fs.writeFileSync(pkg, '{"name":"t","version":"2.0.0"}\n');
+    const mismatchOk = (kinds(d) || []).includes('readme_version_mismatch');
+    // ② 배지 일치(2.0.0) → mismatch 없어야 (FP 0)
+    fs.writeFileSync(readme, '# T\n![v](https://img.shields.io/badge/version-2.0.0-green)\n');
+    const matchOk = !(kinds(d) || ['x']).includes('readme_version_mismatch');
+    // ③ current-state 오래됨(2020) → current_state_stale
+    fs.writeFileSync(csp, '# CS\nUpdated: 2020-01-01\n');
+    const staleOk = (kinds(d) || []).includes('current_state_stale');
+    // ④ current-state 오늘 → stale 없어야 (FP 0)
+    const today = new Date().toISOString().slice(0, 10);
+    fs.writeFileSync(csp, '# CS\nUpdated: ' + today + '\n');
+    const freshOk = !(kinds(d) || ['x']).includes('current_state_stale');
+    fs.rmSync(d, { recursive: true, force: true });
+    ok = mismatchOk && matchOk && staleOk && freshOk;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.395) 회귀가드: audit README배지 mismatch + current-state stale FP/FN (행위검증)' : '✗ audit 체크 FP/FN 가드 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);