leerness 1.9.0 → 1.9.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.9.1 — 2026-05-08
+
+1.9.0을 실 프로젝트(memo-cli)에서 운영하며 발견한 **5개 메타 감사 사항**을 패치합니다.
+
+### Fixed
+
+- **P1**: `autoUpdateInstall`이 legacy `leerness-plus update --check` SessionStart hook을 자동 정리. fork 시절 잔재로 인해 매 세션 npm 호출이 2회 발생하던 문제 해소.
+- **P2**: `managedMerge`에 `MERGE_OVERWRITE_FILES` 화이트리스트 추가 (`skill-index.md`, `manifest.json`, `skills-lock.json`, `HARNESS_VERSION`, `LANGUAGE`, `context-routing.md`). 다단계 migrate를 거쳐도 표/메타데이터가 누적되지 않음.
+- **P4**: `audit`이 `<!-- leerness:na <reason> -->` 마커를 인식. CLI 패키지 등 디자인 토큰/재사용 맵이 NA인 프로젝트에서 영구 경고가 사라짐.
+- **P6**: `lazy detect`의 evidence 정규식을 `/^plan:M-\d{4}\s*$/`로 좁힘. `plan:M-XXXX` 단독은 부족 판정, `tests:32/32 (plan:M-0002)`처럼 검증 키워드 동반 시 통과.
+- **P7**: `install`이 끝날 때 디폴트 `M-0001`이 plan에 있는데 progress에 row가 없으면 `T-XXXX` 자동 생성. audit "milestones without progress entry: M-0001" 경고가 init 직후 사라짐.
+
+### Added
+
+- `leerness skill list [path]` 출력에 **설치됨** 컬럼 추가 (root가 인자/현재 디렉토리에 있을 때).
+
+### Migration
+
+기존 1.9.0 설치본은 `npx leerness@latest update . --yes`로 즉시 자동 마이그레이션됩니다.
+
 ## 1.9.0 — 2026-05-08
 
 이번 minor 릴리스는 1.8.0의 6개 결함을 수정하고, 자동 감지·자동 업데이트·핸드오프 자동 작성·게으름/시크릿/인코딩 자동 가드를 흡수한 큰 강화입니다. 기존 `npx leerness init` 흐름은 그대로 유지됩니다.

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.0';
+const VERSION = '1.9.1';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -236,10 +236,20 @@ function createBackup(root, reason, files, dry = false) {
   return { archiveDir: ar, candidates };
 }
 
+// 1.9.1 P2: 데이터/인덱스 파일은 preserved 블록 없이 overwrite (누적 방지).
+const MERGE_OVERWRITE_FILES = new Set([
+  '.harness/skill-index.md',
+  '.harness/manifest.json',
+  '.harness/skills-lock.json',
+  '.harness/HARNESS_VERSION',
+  '.harness/LANGUAGE',
+  '.harness/context-routing.md'
+]);
 function managedMerge(file, next, previous, archiveDir) {
   if (!previous || previous.trim() === next.trim()) return next;
   const tag = '<!-- leerness:migration-preserved -->';
   if (previous.includes(tag)) return next;
+  if (MERGE_OVERWRITE_FILES.has(file.replace(/\\/g, '/'))) return next;
   return next.trimEnd() + `\n\n---\n${tag}\n## Preserved previous content\n\nPrevious content was backed up before migration. Archive reference:\n\n\`${archiveDir ? path.relative(process.cwd(), archiveDir).replace(/\\/g, '/') : '.harness/archive'}\`\n\n<details>\n<summary>Previous ${file}</summary>\n\n\`\`\`md\n${previous.replace(/```/g, '\\`\\`\\`')}\n\`\`\`\n\n</details>\n`;
 }
 
@@ -366,6 +376,18 @@ async function install(root, opts = {}) {
     syncReadme(root);
     installSkills(root, skills);
     writeMigrationReport(root, backup, actions);
+    // 1.9.1 P7: 디폴트 M-0001이 plan에 있고 progress에 row가 없으면 자동 추가
+    try {
+      const planText = exists(planPath(root)) ? read(planPath(root)) : '';
+      if (/### M-0001\./.test(planText)) {
+        const rows = readProgressRows(root);
+        const linked = rows.some(r => /M-0001/.test(r.evidence));
+        if (!linked) {
+          const tid = nextId(root, 'T');
+          upsertProgress(root, { id: tid, status: 'planned', request: '프로젝트 계획 정리', evidence: 'init default plan:M-0001', nextAction: 'project-brief.md를 실제 목적으로 업데이트' });
+        }
+      }
+    } catch {}
     if (!has('--no-auto-update')) {
       try { autoUpdateInstall(root); } catch (e) { warn('auto-update hook install skipped: ' + (e && e.message)); }
     }
@@ -382,10 +404,25 @@ function addSkill(root, name, silent = false) {
   if (!silent) ok(`skill installed: ${name}`);
 }
 
-function skillList() {
-  log('| ID | 한글명 | 가능한 작업 | 최종 업데이트 | 검증 |');
-  log('|---|---|---|---|---|');
-  for (const [k, v] of Object.entries(skillCatalog)) log(`| ${k} | ${v.displayNameKo} | ${v.capabilities.join('<br>')} | ${v.lastUpdated} | ${v.verification} |`);
+function skillList(root) {
+  // 1.9.1: 설치 여부 컬럼 추가 (root가 없으면 생략)
+  let installed = new Set();
+  if (root) {
+    const skillsDir = path.join(absRoot(root), '.harness/skills');
+    if (exists(skillsDir)) {
+      try { for (const e of fs.readdirSync(skillsDir)) installed.add(e); } catch {}
+    }
+  }
+  const showInstalled = root && installed.size >= 0;
+  if (showInstalled) {
+    log('| ID | 한글명 | 가능한 작업 | 최종 업데이트 | 검증 | 설치됨 |');
+    log('|---|---|---|---|---|---|');
+    for (const [k, v] of Object.entries(skillCatalog)) log(`| ${k} | ${v.displayNameKo} | ${v.capabilities.join('<br>')} | ${v.lastUpdated} | ${v.verification} | ${installed.has(k) ? '✓' : '·'} |`);
+  } else {
+    log('| ID | 한글명 | 가능한 작업 | 최종 업데이트 | 검증 |');
+    log('|---|---|---|---|---|');
+    for (const [k, v] of Object.entries(skillCatalog)) log(`| ${k} | ${v.displayNameKo} | ${v.capabilities.join('<br>')} | ${v.lastUpdated} | ${v.verification} |`);
+  }
 }
 function skillInfo(name) {
   const v = skillCatalog[name];
@@ -556,12 +593,16 @@ function audit(root) {
   const dups = designCands.filter(f => exists(path.join(root,f)));
   if (dups.length) { warnings++; warn(`design guide duplicates outside canonical: ${dups.join(', ')} (run: leerness consistency merge-design-guide)`); }
   else ok('no duplicate design guide candidates');
+  // 1.9.1 P4: <!-- leerness:na --> 마커가 있는 파일은 placeholder 경고 스킵.
+  const naMarker = '<!-- leerness:na';
   const ds = exists(path.join(root,'.harness/design-system.md')) ? read(path.join(root,'.harness/design-system.md')) : '';
-  if (!/\| color\.primary \|/.test(ds) || /\(실제 값으로 업데이트\)/.test(ds)) { warnings++; warn('design-system.md tokens not customized'); }
+  if (ds.includes(naMarker)) ok('design-system.md marked NA (skipped)');
+  else if (!/\| color\.primary \|/.test(ds) || /\(실제 값으로 업데이트\)/.test(ds)) { warnings++; warn('design-system.md tokens not customized'); }
   else ok('design-system tokens populated');
   const reuse = exists(path.join(root,'.harness/reuse-map.md')) ? read(path.join(root,'.harness/reuse-map.md')) : '';
   const reuseLines = reuse.split('\n').filter(l => l.startsWith('|') && !/Capability|---/.test(l)).length;
-  if (reuseLines === 0) { warnings++; warn('reuse-map.md is empty (consider populating known reusable elements)'); }
+  if (reuse.includes(naMarker)) ok('reuse-map.md marked NA (skipped)');
+  else if (reuseLines === 0) { warnings++; warn('reuse-map.md is empty (consider populating known reusable elements)'); }
   else ok(`reuse-map.md has ${reuseLines} entries`);
   const planText = exists(planPath(root)) ? read(planPath(root)) : '';
   const milestoneIds = Array.from(planText.matchAll(/^### (M-\d{4})\./gm)).map(m => m[1]);
@@ -679,7 +720,9 @@ function lazyDetect(root) {
   root = absRoot(root);
   let issues = 0;
   const rows = readProgressRows(root);
-  for (const r of rows) if (r.status === 'done' && (!r.evidence || /^(\s*|user-request|-)$/.test(r.evidence) || /^plan:/.test(r.evidence))) {
+  // 1.9.1 P6: evidence가 단독 plan:M-XXXX 한 줄일 때만 검증 부족 처리.
+  // "tests:32/32 (plan:M-0002)" 같이 검증 키워드를 같이 적은 경우는 통과.
+  for (const r of rows) if (r.status === 'done' && (!r.evidence || /^(\s*|user-request|-)$/.test(r.evidence) || /^plan:M-\d{4}\s*$/.test(r.evidence))) {
     issues++; warn(`done row without verifiable evidence: ${r.id} (${r.request})`);
   }
   if (rows.length === 0) { issues++; warn('progress-tracker is empty (no tasks tracked)'); }
@@ -978,7 +1021,12 @@ function autoUpdateInstall(root) {
   let settings = {};
   if (exists(settingsFile)) { try { settings = JSON.parse(read(settingsFile)); } catch {} }
   settings.hooks = settings.hooks || {};
-  if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
+  // 1.9.1 P1: legacy 'leerness-plus update' hook 자동 제거 (이전 fork 시절 잔재).
+  let removedLegacy = 0;
+  settings.hooks.SessionStart = (settings.hooks.SessionStart || []).filter(h => {
+    if (h && h.command && /\bleerness-plus update\b/.test(h.command)) { removedLegacy++; return false; }
+    return true;
+  });
   if (!settings.hooks.SessionStart.some(h => h.command && h.command.includes('leerness update'))) {
     settings.hooks.SessionStart.push({ matcher: '*', command: 'leerness update --check' });
   }
@@ -986,6 +1034,7 @@ function autoUpdateInstall(root) {
   writeUtf8(path.join(root, '.claude/commands/update.md'),
     `# /update\n\nleerness 자동 업데이트 (감지 → 마이그레이션 → 검증).\n\n\`\`\`\n!leerness update --yes\n\`\`\`\n\n체크만:\n\n\`\`\`\n!leerness update --check\n\`\`\`\n`);
   ok('auto-update SessionStart hook installed (.claude/settings.local.json)');
+  if (removedLegacy) ok(`legacy hook 제거: ${removedLegacy}건 (leerness-plus → leerness 통합)`);
   ok('/update slash command added');
 }
 
@@ -1063,7 +1112,7 @@ async function main() {
   if (cmd === 'readme' && args[1] === 'sync')  return readmeCmd(args[2] || process.cwd());
   if (cmd === 'consistency' && args[1] === 'check')              return consistencyCheck(args[2] || process.cwd());
   if (cmd === 'consistency' && args[1] === 'merge-design-guide') return mergeDesign(args[2] || process.cwd());
-  if (cmd === 'skill' && args[1] === 'list') return skillList();
+  if (cmd === 'skill' && args[1] === 'list') return skillList(args[2] || arg('--path', null));
   if (cmd === 'skill' && args[1] === 'info') return skillInfo(args[2]);
   if (cmd === 'skill' && args[1] === 'add')  return addSkill(absRoot(arg('--path', process.cwd())), args[2]);
   if (cmd === 'plan') {

package/package.json

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

package/scripts/e2e.js

@@ -77,6 +77,72 @@ total++;
   } else { failed++; console.log('✗ .claude/settings.local.json missing'); }
 }
 
+// 1.9.1 P6 회귀: evidence가 plan:M-XXXX + 검증 키워드면 lazy detect가 통과해야 한다.
+total++;
+{
+  const trackerPath = path.join(tmp, '.harness/progress-tracker.md');
+  let cur = fs.readFileSync(trackerPath, 'utf8');
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | tests:32/32 (plan:M-0002) | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath, cur, 'utf8');
+  const r = cp.spawnSync(process.execPath, [CLI, 'lazy', 'detect', tmp], { encoding: 'utf8' });
+  const ok = r.status === 0;
+  console.log(ok ? '✓ B(P6) lazy detect: plan:M-XXXX + 검증 키워드 → pass' : `✗ B(P6) FAIL exit=${r.status}\n${r.stdout}`);
+  if (!ok) failed++;
+}
+// 1.9.1 P6 negative: plan:M-XXXX 단독은 여전히 경고
+total++;
+{
+  const trackerPath = path.join(tmp, '.harness/progress-tracker.md');
+  let cur = fs.readFileSync(trackerPath, 'utf8');
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | plan:M-0002 | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath, cur, 'utf8');
+  const r = cp.spawnSync(process.execPath, [CLI, 'lazy', 'detect', tmp], { encoding: 'utf8' });
+  const ok = r.status === 1 && /done row without verifiable evidence/.test(r.stdout);
+  console.log(ok ? '✓ B(P6 neg) lazy detect: plan:M-XXXX 단독 → warn 유지' : `✗ B(P6 neg) FAIL exit=${r.status}`);
+  if (!ok) failed++;
+  // restore
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | tests:32/32 (plan:M-0002) | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath, cur, 'utf8');
+}
+
+// 1.9.1 P1 회귀: legacy leerness-plus hook이 있으면 auto-update install이 정리해야 한다.
+total++;
+{
+  const settingsFile = path.join(tmp, '.claude/settings.local.json');
+  const s = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
+  s.hooks.SessionStart = [{ matcher: '*', command: 'leerness-plus update --check' }];
+  fs.writeFileSync(settingsFile, JSON.stringify(s, null, 2));
+  cp.spawnSync(process.execPath, [CLI, 'auto-update', 'install', tmp], { encoding: 'utf8' });
+  const after = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
+  const hasLegacy = (after.hooks?.SessionStart || []).some(h => /leerness-plus update/.test(h.command || ''));
+  const hasNew = (after.hooks?.SessionStart || []).some(h => /\bleerness update\b/.test(h.command || ''));
+  const ok = !hasLegacy && hasNew;
+  console.log(ok ? '✓ B(P1) legacy leerness-plus hook 자동 제거' : '✗ B(P1) legacy hook 남음');
+  if (!ok) failed++;
+}
+
+// 1.9.1 P4 회귀: NA 마커가 있으면 audit이 placeholder 경고를 스킵.
+total++;
+{
+  const ds = path.join(tmp, '.harness/design-system.md');
+  fs.appendFileSync(ds, '\n<!-- leerness:na CLI 프로젝트라 디자인 토큰 없음 -->\n');
+  const r = cp.spawnSync(process.execPath, [CLI, 'audit', tmp], { encoding: 'utf8' });
+  const ok = !/design-system\.md tokens not customized/.test(r.stdout) && /marked NA/.test(r.stdout);
+  console.log(ok ? '✓ B(P4) NA 마커 인식: design-system 경고 스킵' : '✗ B(P4) NA 마커 미작동');
+  if (!ok) failed++;
+}
+
+// 1.9.1 P7 회귀: init 직후 progress에 M-0001 연결 row가 자동으로 있다.
+total++;
+{
+  const tmp2 = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-e2e-p7-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmp2, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8' });
+  const tracker = fs.readFileSync(path.join(tmp2, '.harness/progress-tracker.md'), 'utf8');
+  const ok = /M-0001/.test(tracker);
+  console.log(ok ? '✓ B(P7) init: M-0001 → progress row 자동 생성' : '✗ B(P7) progress에 M-0001 row 없음');
+  if (!ok) failed++;
+}
+
 run('viewwork install',    ['viewwork', 'install', tmp]);
 run('viewwork emit',       ['viewwork', 'emit', tmp, '--action', 'note', '--note', 'e2e ping']);
 run('route planning',      ['route', 'planning']);