leerness 1.9.4 → 1.9.5

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.9.5 — 2026-05-08
+
+1.9.4 운영 중 발견된 한계 2건 + 추가 디버그 사항을 패치합니다.
+
+### Fixed
+
+- **F. `task fix-evidence --set` link 보존**: 기존 evidence의 `plan:M-XXXX` 링크를 새 텍스트에 자동으로 `(plan:M-XXXX)` 형태로 부착. `--no-preserve-link`로 끌 수 있음. 이전엔 링크가 사라져 audit이 milestone 미연결로 잡았음.
+- **G. `impact` 동적 참조 (medium)**: `path.join`, `path.resolve`, `readFile`, `writeFile`, `fs.*`, `new URL` 등이 base 파일명을 인자로 받는 패턴을 별도 카테고리(medium)로 분리. default 출력에 strong + medium 모두 표시. site-cli의 `build.js`처럼 동적으로 컴포넌트를 읽는 빌더가 더 이상 weak로만 잡히지 않음.
+
+### Migration
+
+기존 1.9.x 사용자는 `npx leerness@latest update . --yes`로 즉시 자동 마이그레이션됩니다.
+
 ## 1.9.4 — 2026-05-08
 
 1.9.3 운영 중 발견된 5개 한계점을 모두 패치합니다.

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.4';
+const VERSION = '1.9.5';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -694,8 +694,21 @@ function taskFixEvidence(root) {
   if (!candidates.length) return ok('갱신 후보 없음 (모든 done row가 검증 키워드 보유)');
   const setAll = arg('--set', null);
   if (setAll) {
-    for (const r of candidates) upsertProgress(root, { id: r.id, evidence: setAll });
-    ok(`${candidates.length}개 row의 evidence를 일괄 갱신`);
+    // 1.9.5 F: 기존 evidence의 plan:M-XXXX 링크를 새 텍스트에 자동 보존 (--no-preserve-link로 끄기)
+    const preserveLink = !has('--no-preserve-link');
+    let preserved = 0;
+    for (const r of candidates) {
+      let newEv = setAll;
+      if (preserveLink) {
+        const m = (r.evidence || '').match(/plan:M-\d{4}/);
+        if (m && !newEv.includes(m[0])) {
+          newEv = `${setAll} (${m[0]})`;
+          preserved++;
+        }
+      }
+      upsertProgress(root, { id: r.id, evidence: newEv });
+    }
+    ok(`${candidates.length}개 row의 evidence를 일괄 갱신${preserveLink ? ` (link 보존: ${preserved}건)` : ''}`);
     return;
   }
   log(`# task fix-evidence — ${candidates.length}개 후보`);
@@ -1146,43 +1159,58 @@ function impactCmd(root, target) {
   const base = path.basename(target);
   const noext = path.basename(target, path.extname(target));
   const targetRel = rel(root, abs);
-  // 1.9.4 A: strong (import-style, 확신도 높음) vs weak (단순 식별자, 가능성 있음) 구분.
+  const eb = escapeRegex(base);
+  // 1.9.5 G: strong (정적 import) / medium (동적 path 함수) / weak (식별자 등장) 3단계.
   const strongRe = new RegExp(
     `(?:` +
-    `import\\s+[^;\\n]*?from\\s+['"][^'"]*${escapeRegex(base)}` +
-    `|require\\(\\s*['"][^'"]*${escapeRegex(base)}` +
-    `|@import\\s+['"][^'"]*${escapeRegex(base)}` +
-    `|href=["'][^"']*${escapeRegex(base)}` +
-    `|src=["'][^"']*${escapeRegex(base)}` +
-    `|url\\(\\s*['"]?[^'")]*${escapeRegex(base)}` +
-    `|include\\(\\s*['"][^'"]*${escapeRegex(base)}` +
+    `import\\s+[^;\\n]*?from\\s+['"][^'"]*${eb}` +
+    `|require\\(\\s*['"][^'"]*${eb}` +
+    `|@import\\s+['"][^'"]*${eb}` +
+    `|href=["'][^"']*${eb}` +
+    `|src=["'][^"']*${eb}` +
+    `|url\\(\\s*['"]?[^'")]*${eb}` +
+    `|include\\(\\s*['"][^'"]*${eb}` +
+    `)`
+  );
+  // 동적 path 조합 / 파일 시스템 호출과 함께 base 파일명이 등장하는 경우.
+  const mediumRe = new RegExp(
+    `(?:` +
+    `path\\.(?:join|resolve|relative|parse|format|normalize)\\s*\\([^)]*['"][^'"]*${eb}[^'"]*['"]` +
+    `|(?:readFile|writeFile|stat|access|open|createReadStream|createWriteStream|readFileSync|writeFileSync|statSync|accessSync|openSync)\\s*\\([^)]*['"][^'"]*${eb}[^'"]*['"]` +
+    `|fs\\.[a-zA-Z]+\\s*\\([^)]*['"][^'"]*${eb}[^'"]*['"]` +
+    `|new\\s+URL\\s*\\([^)]*['"][^'"]*${eb}[^'"]*['"]` +
     `)`
   );
-  // word boundary 강화: cards 안의 card는 매치 안 함.
   const weakRe = new RegExp(`(?<![A-Za-z0-9_])${escapeRegex(noext)}(?![A-Za-z0-9_])`);
-  const high = []; const low = [];
+  const high = []; const medium = []; const low = [];
   for (const f of walkCode(root)) {
     if (path.resolve(f) === path.resolve(abs)) continue;
     let text; try { text = read(f); } catch { continue; }
     if (strongRe.test(text)) high.push(rel(root, f));
+    else if (mediumRe.test(text)) medium.push(rel(root, f));
     else if (weakRe.test(text)) low.push(rel(root, f));
   }
   log(`# impact: ${targetRel}`);
   const showAll = has('--all');
-  if (high.length === 0 && (low.length === 0 || !showAll)) ok('영향 범위 없음 (강한 참조 없음)');
+  const totalEffective = high.length + medium.length;
+  if (totalEffective === 0 && (low.length === 0 || !showAll)) ok('영향 범위 없음 (강한/중간 참조 없음)');
   else {
     if (high.length) {
       log(`강한 참조 ${high.length}개 (import/require/href/src/@import/url/include):`);
       high.forEach(d => log('  - ' + d));
     } else log('강한 참조: 없음');
+    if (medium.length) {
+      log(`\n중간 참조 ${medium.length}개 (path.join/readFile/fs 등 동적 path):`);
+      medium.forEach(d => log('  ~ ' + d));
+    }
     if (showAll && low.length) {
-      log(`\n약한 참조 ${low.length}개 (식별자 등장 — false positive 가능, 확인 필요):`);
+      log(`\n약한 참조 ${low.length}개 (식별자 등장 — false positive 가능):`);
       low.forEach(d => log('  · ' + d));
     } else if (low.length && !showAll) {
-      log(`\n💡 약한 참조 ${low.length}개 (--all 로 표시, 정확도는 떨어짐)`);
+      log(`\n💡 약한 참조 ${low.length}개 (--all 로 표시)`);
     }
   }
-  return { target: targetRel, high, low };
+  return { target: targetRel, high, medium, low };
 }
 
 function reuseMapPath(root) { return path.join(root, '.harness/reuse-map.md'); }

package/package.json

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

package/scripts/e2e.js

@@ -229,14 +229,26 @@ total++;
   // home.html에 "Card"라는 식별자가 plain text로 들어가도록 (false positive 시드)
   fs.appendFileSync(path.join(tmp, 'src/pages/home.html'), '\n<!-- 카드 콘텐츠는 Cards 배열로 -->\n');
   const r = cp.spawnSync(process.execPath, [CLI, 'impact', 'src/components/Card.html', '--path', tmp], { encoding: 'utf8' });
-  // strong만 잡혀야 하므로 home.html이 강한 참조에 들어가야 함 (이미 <include src=Card.html>)
-  // weak에는 about/contact가 들어갈 수 있지만 기본 출력은 strong만
   const strongOK = /강한 참조 \d+개/.test(r.stdout);
   const weakHint = /약한 참조|영향 범위 없음/.test(r.stdout);
   console.log(strongOK && weakHint ? '✓ B(A) impact: strong/weak 구분 출력' : '✗ B(A) impact 구분 실패');
   if (!(strongOK && weakHint)) failed++;
 }
 
+// 1.9.5 G 회귀: impact medium 카테고리 — 동적 path 패턴
+total++;
+{
+  // builder.js에서 path.join + readFileSync + Card.html을 동적 사용
+  fs.writeFileSync(path.join(tmp, 'src/builder.js'),
+    `const fs = require('fs'); const path = require('path');\n` +
+    `const tpl = fs.readFileSync(path.join(__dirname, 'components', 'Card.html'), 'utf8');\n` +
+    `module.exports = { tpl };\n`);
+  const r = cp.spawnSync(process.execPath, [CLI, 'impact', 'src/components/Card.html', '--path', tmp], { encoding: 'utf8' });
+  const ok = /중간 참조 \d+개/.test(r.stdout) && /src\/builder\.js/.test(r.stdout);
+  console.log(ok ? '✓ B(G) impact medium: builder.js (path.join + readFileSync) 검출' : `✗ B(G) medium 검출 실패\n${r.stdout}`);
+  if (!ok) failed++;
+}
+
 // 1.9.4 회귀: --fail-on-violation cross-platform 종료
 total++;
 {
@@ -281,13 +293,43 @@ total++;
 // 1.9.4 회귀: --set 일괄 갱신
 total++;
 {
+  // T-0001 evidence를 plan:M-0002 링크 포함한 placeholder로 (1.9.5 link 보존 검증용 시드)
+  const trackerPath2 = path.join(tmp, '.harness/progress-tracker.md');
+  let cur = fs.readFileSync(trackerPath2, 'utf8');
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | plan:M-0002 | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath2, cur);
   const r = cp.spawnSync(process.execPath, [CLI, 'task', 'fix-evidence', '--set', 'npm test 통과 (e2e)', '--path', tmp], { encoding: 'utf8' });
-  const tracker = fs.readFileSync(path.join(tmp, '.harness/progress-tracker.md'), 'utf8');
+  const tracker = fs.readFileSync(trackerPath2, 'utf8');
   const ok = r.status === 0 && /npm test 통과 \(e2e\)/.test(tracker);
   console.log(ok ? '✓ B(D2) task fix-evidence --set: 일괄 갱신' : '✗ B(D2) 일괄 갱신 실패');
   if (!ok) failed++;
 }
 
+// 1.9.5 F 회귀: --set 시 plan:M-XXXX 링크 자동 보존
+total++;
+{
+  const tracker = fs.readFileSync(path.join(tmp, '.harness/progress-tracker.md'), 'utf8');
+  const ok = /npm test 통과 \(e2e\) \(plan:M-0002\)/.test(tracker);
+  console.log(ok ? '✓ B(F) fix-evidence --set: link 자동 보존' : `✗ B(F) link 손실\n${tracker}`);
+  if (!ok) failed++;
+}
+
+// 1.9.5 F neg: --no-preserve-link
+total++;
+{
+  // T-0002 같은 row를 placeholder로 시드
+  const trackerPath3 = path.join(tmp, '.harness/progress-tracker.md');
+  let cur = fs.readFileSync(trackerPath3, 'utf8');
+  // T-0001을 다시 plan:M-0099로 교체
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | plan:M-0099 | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath3, cur);
+  cp.spawnSync(process.execPath, [CLI, 'task', 'fix-evidence', '--set', 'npm test only', '--no-preserve-link', '--path', tmp], { encoding: 'utf8' });
+  const tracker = fs.readFileSync(trackerPath3, 'utf8');
+  const ok = /\| T-0001 \| done \| mile A \| npm test only \|/.test(tracker) && !/M-0099/.test(tracker);
+  console.log(ok ? '✓ B(F neg) fix-evidence --no-preserve-link: 링크 제거' : `✗ B(F neg) 동작 이상`);
+  if (!ok) failed++;
+}
+
 // 1.9.4 회귀: .leerness-skip-dirs 적용
 total++;
 {