leerness 1.9.5 → 1.9.7

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 1.9.7 — 2026-05-08
+
+코드 검증 자동 실행 + 과거 결정/실수 자동 회수 + TODO 자동 추적의 3종 자동화.
+
+### Added — A. `leerness verify-code [path] [--build]`
+
+`package.json#scripts`에서 `test` / `lint` / `typecheck` (또는 `tsc`) / (선택) `build`를 자동 감지해 차례로 실행. 결과는 모두 `review-evidence.md`에 자동 누적 (`Command/Tasks/exit/duration/tail`). 실패 시 `process.exit(1)` + progress의 in-progress row를 `incomplete`로 표시 권장 안내.
+
+- `tsconfig.json`이 있고 `typecheck` script가 없으면 `npx tsc --noEmit` 자동 호출.
+- 5분 timeout 내장 (장기 실행 방지).
+
+### Added — B. `leerness lessons [--query <키>] [--limit N]`
+
+`decisions.md`의 모든 `### 블록`, `review-evidence.md`의 실패 표지(`✗ / fail / 롤백 / incomplete / bug / 버그 / warning`) 블록, `task-log.md`의 실패 키워드 라인, `session-handoff.md`의 Incomplete 섹션을 통합 추출. `--query`로 키워드 필터.
+
+- `leerness guide [target]`이 자동으로 lessons 섹션을 추가 (target 이름을 query로 사용).
+
+### Added — C. `lazy detect --auto-track` + `.harness/known-todos.json`
+
+새 TODO/FIXME/XXX의 `(file, line, text)` 위치 캡처. `known-todos.json`에 acknowledged 기록을 비교해 매번 같은 false positive를 줄이고, 새로 발견된 것만 노출. `--auto-track`으로 `progress-tracker.md`에 `T-XXXX requested`로 자동 등록 + known-todos.json에도 자동 추가.
+
+### Migration
+
+기존 1.9.x 사용자는 `npx leerness@latest update . --yes`로 즉시 자동 마이그레이션됩니다.
+
+## 1.9.6 — 2026-05-08
+
+1.9.5 후 발견된 한 가지 한계 (옛 link 손실 자동 복구 부재)를 패치.
+
+### Added
+
+- **`leerness task relink [--apply] [--min-score 0.2]`** — `plan.md`의 milestone 텍스트와 `progress-tracker.md`의 task `request` 텍스트를 jaccard 토큰 유사도로 비교해 미연결 milestone을 가장 비슷한 row와 자동 매칭. default는 제안만 출력 (사용자가 명령 복사해 실행), `--apply`로 자동 적용. `--min-score`로 임계 조정 (기본 0.2).
+- **`audit`이 미연결 milestone 발견 시 `leerness task relink` 안내 자동 출력**.
+
+### Migration
+
+기존 1.9.x 사용자는 `npx leerness@latest update . --yes`로 즉시 자동 마이그레이션됩니다.
+
 ## 1.9.5 — 2026-05-08
 
 1.9.4 운영 중 발견된 한계 2건 + 추가 디버그 사항을 패치합니다.

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.5';
+const VERSION = '1.9.7';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -679,6 +679,67 @@ function taskDrop(root, id) {
   ok(`task dropped: ${id}`);
 }
 
+// 1.9.6: 옛 link 손실 row를 plan.md milestone과 자동 매칭 제안/복구.
+function _tokenizeForSim(s) {
+  // unicode letter/number만 보존 — \W는 ASCII 기준이라 한글이 분리되는 버그 회피
+  return new Set(
+    String(s || '').toLowerCase()
+      .split(/\s+/)
+      .map(t => t.replace(/[^\p{L}\p{N}_]+/gu, ''))
+      .filter(t => t.length >= 2)
+  );
+}
+function _jaccard(a, b) {
+  const inter = new Set([...a].filter(x => b.has(x))).size;
+  const uni = new Set([...a, ...b]).size;
+  return uni ? inter / uni : 0;
+}
+
+function taskRelink(root) {
+  root = absRoot(root);
+  const planText = exists(planPath(root)) ? read(planPath(root)) : '';
+  const milestones = [...planText.matchAll(/^### (M-\d{4})\.\s*(.+?)$/gm)]
+    .map(m => ({ id: m[1], text: m[2].trim() }));
+  const rows = readProgressRows(root);
+  const linkedM = new Set(rows.map(r => (r.evidence.match(/M-\d{4}/) || [])[0]).filter(Boolean));
+  const orphanM = milestones.filter(m => !linkedM.has(m.id));
+  if (!orphanM.length) return ok('미연결 milestone 없음');
+
+  const apply = has('--apply');
+  const minScore = parseFloat(arg('--min-score', '0.2'));
+  log(`# task relink — 미연결 milestone ${orphanM.length}개${apply ? ' (--apply: 자동 적용)' : ' (제안만, --apply로 적용)'}`);
+  const suggestions = [];
+  for (const m of orphanM) {
+    const milestoneTokens = _tokenizeForSim(m.text);
+    const candidates = rows
+      .map(r => ({ r, score: _jaccard(milestoneTokens, _tokenizeForSim(r.request)) }))
+      .filter(x => x.score >= minScore)
+      .sort((a, b) => b.score - a.score);
+    log(`\n${m.id}: ${m.text}`);
+    if (!candidates.length) {
+      log(`  ⓘ 매칭 후보 없음 (score ≥ ${minScore})`);
+      log(`  → 새 task: leerness task add "${m.text}" --status planned --evidence "plan:${m.id}"`);
+      continue;
+    }
+    const best = candidates[0];
+    const newEv = best.r.evidence.includes(`plan:${m.id}`) ? best.r.evidence : `${best.r.evidence} (plan:${m.id})`;
+    log(`  ✓ 최선 후보: ${best.r.id} (score ${best.score.toFixed(2)}) — ${best.r.request}`);
+    log(`    현재 evidence: "${best.r.evidence}"`);
+    log(`    제안 evidence: "${newEv}"`);
+    log(`    수동: leerness task update ${best.r.id} --evidence "${newEv}"`);
+    if (candidates.length > 1) {
+      const next = candidates.slice(1, 3).map(c => `${c.r.id}(${c.score.toFixed(2)})`).join(', ');
+      log(`    다른 후보: ${next}`);
+    }
+    suggestions.push({ id: best.r.id, evidence: newEv });
+  }
+  if (apply && suggestions.length) {
+    for (const s of suggestions) upsertProgress(root, { id: s.id, evidence: s.evidence });
+    log('');
+    ok(`${suggestions.length}개 row 자동 relink 완료`);
+  }
+}
+
 // 1.9.4 D: evidence가 placeholder인 done row를 일괄 점검.
 function taskFixEvidence(root) {
   root = absRoot(root);
@@ -786,9 +847,17 @@ function audit(root) {
   const planText = exists(planPath(root)) ? read(planPath(root)) : '';
   const milestoneIds = Array.from(planText.matchAll(/^### (M-\d{4})\./gm)).map(m => m[1]);
   const rows = readProgressRows(root);
-  const linkedMs = new Set(rows.map(r => (r.evidence.match(/M-\d{4}/) || [])[0]).filter(Boolean));
+  // 1.9.6 수정: 한 row에 여러 plan:M-XXXX 링크가 있어도 모두 인식 (matchAll로 전부 추출)
+  const linkedMs = new Set(
+    rows.flatMap(r => Array.from(String(r.evidence || '').matchAll(/M-\d{4}/g), m => m[0]))
+  );
   const missingFromProgress = milestoneIds.filter(m => !linkedMs.has(m));
-  if (missingFromProgress.length) { warnings++; warn(`milestones without progress entry: ${missingFromProgress.join(', ')}`); }
+  if (missingFromProgress.length) {
+    warnings++;
+    warn(`milestones without progress entry: ${missingFromProgress.join(', ')}`);
+    log(`    → 자동 매칭 제안: leerness task relink`);
+    log(`    → 자동 적용:     leerness task relink --apply`);
+  }
   else if (milestoneIds.length) ok('all milestones linked in progress-tracker');
   const handoff = exists(handoffPath(root)) ? read(handoffPath(root)) : '';
   if (handoff.includes('Last generated: (자동)')) { warnings++; warn('session-handoff.md never auto-generated (run: leerness session close .)'); }
@@ -934,7 +1003,13 @@ function lazyDetect(root) {
     const bq = (pre.match(/(?<!\\)`/g) || []).length;
     return (sq % 2 === 1) || (dq % 2 === 1) || (bq % 2 === 1);
   }
+  // 1.9.7 C: TODO 자동 추적 강화 — 위치+텍스트 캡처, known-todos 비교, --auto-track 등록
+  const knownPath = path.join(root, '.harness/known-todos.json');
+  let knownList = [];
+  if (exists(knownPath)) { try { knownList = JSON.parse(read(knownPath)); } catch {} }
+  const knownSet = new Set(knownList.map(k => `${k.file}:${k.line}:${k.text}`));
   let todoCount = 0;
+  const newTodos = [];
   const cliSelf = path.resolve(__filename);
   for (const file of walk(root)) {
     const ext = path.extname(file).toLowerCase();
@@ -945,17 +1020,39 @@ function lazyDetect(root) {
     let text; try { text = read(file); } catch { continue; }
     const lines = text.split('\n');
     const tre = /\bTODO\b|\bFIXME\b|\bXXX\b/g;
-    for (const line of lines) {
+    for (let i = 0; i < lines.length; i++) {
       tre.lastIndex = 0;
       let m;
-      while ((m = tre.exec(line))) {
-        if (!isInsideQuote(line, m.index)) todoCount++;
+      while ((m = tre.exec(lines[i]))) {
+        if (isInsideQuote(lines[i], m.index)) continue;
+        todoCount++;
+        const txt = lines[i].trim().slice(0, 120);
+        const fileRel = rel(root, file);
+        const key = `${fileRel}:${i + 1}:${txt}`;
+        if (!knownSet.has(key)) newTodos.push({ file: fileRel, line: i + 1, text: txt });
       }
     }
   }
   if (todoCount > 0) {
     const hasTodoTask = rows.some(r => /TODO|FIXME|XXX/.test(r.request) || /TODO|FIXME|XXX/i.test(r.evidence));
-    if (!hasTodoTask) { issues++; warn(`code has ${todoCount} TODO/FIXME/XXX but no progress-tracker entry tracks them`); }
+    if (!hasTodoTask) {
+      issues++;
+      warn(`code has ${todoCount} TODO/FIXME/XXX (new: ${newTodos.length}) but no progress-tracker entry tracks them`);
+      // 새 TODO 처음 5개 표시
+      newTodos.slice(0, 5).forEach(t => log(`    ${t.file}:${t.line}  ${t.text}`));
+      if (has('--auto-track') && newTodos.length) {
+        for (const t of newTodos) {
+          const id = nextId(root, 'T');
+          upsertProgress(root, { id, status: 'requested', request: `TODO ${t.file}:${t.line}`, evidence: 'auto-tracked', nextAction: t.text.slice(0, 80) });
+        }
+        // known-todos에 추가 — 다음 detect에서 재카운트 안 하도록
+        const merged = [...knownList, ...newTodos.map(t => ({ ...t, ackAt: now() }))];
+        writeUtf8(knownPath, JSON.stringify(merged, null, 2) + '\n');
+        ok(`${newTodos.length}개 TODO를 progress-tracker에 자동 등록 + known-todos.json 갱신`);
+      } else if (newTodos.length) {
+        log(`    💡 자동 등록: leerness lazy detect --auto-track`);
+      }
+    }
   }
   const blockers = rows.filter(r => r.status === 'blocked');
   for (const b of blockers) if (b.nextAction === '없음' || /다음 액션 작성/.test(b.nextAction)) { issues++; warn(`blocker without nextAction: ${b.id}`); }
@@ -1137,6 +1234,114 @@ function gate(root) {
   else ok('all gates passed');
 }
 
+// ===== 1.9.7 A: verify-code — npm scripts 자동 감지 + evidence 자동 기록 =====
+function verifyCodeCmd(root) {
+  root = absRoot(root);
+  const pkgFile = path.join(root, 'package.json');
+  if (!exists(pkgFile)) return fail('package.json 없음 — Node 프로젝트 위치에서 실행하세요.');
+  let pkg;
+  try { pkg = JSON.parse(read(pkgFile)); } catch (e) { return fail('package.json 파싱 실패: ' + e.message); }
+  const scripts = pkg.scripts || {};
+  const tasks = [];
+  if (scripts.test) tasks.push({ name: 'test', cmd: 'npm test' });
+  else if (scripts['test:smoke']) tasks.push({ name: 'test', cmd: 'npm run test:smoke' });
+  if (scripts.lint) tasks.push({ name: 'lint', cmd: 'npm run lint' });
+  if (scripts.typecheck) tasks.push({ name: 'typecheck', cmd: 'npm run typecheck' });
+  else if (scripts.tsc) tasks.push({ name: 'typecheck', cmd: 'npm run tsc' });
+  else if (exists(path.join(root, 'tsconfig.json'))) tasks.push({ name: 'typecheck', cmd: 'npx --yes tsc --noEmit', optional: true });
+  if (has('--build') && scripts.build) tasks.push({ name: 'build', cmd: 'npm run build' });
+  if (!tasks.length) {
+    warn('실행할 검증 task 없음 (package.json#scripts에 test/lint/typecheck 추가하세요)');
+    return;
+  }
+  log(`# verify-code (${tasks.length}개)`);
+  let failedCnt = 0;
+  const results = [];
+  for (const t of tasks) {
+    log(`\n## ${t.name}: ${t.cmd}`);
+    const start = Date.now();
+    const r = cp.spawnSync(t.cmd, [], { cwd: root, encoding: 'utf8', shell: true, timeout: 5 * 60 * 1000 });
+    const dur = Date.now() - start;
+    if (r.status === 0) ok(`${t.name} passed (${dur}ms)`);
+    else if (t.optional && r.status === 127) warn(`${t.name} 스킵 (${t.cmd} 없음)`);
+    else { fail(`${t.name} failed (exit ${r.status}, ${dur}ms)`); failedCnt++; }
+    const tail = (r.stdout || '').split('\n').slice(-8).join('\n').slice(0, 400);
+    results.push({ name: t.name, cmd: t.cmd, exit: r.status, durMs: dur, tail });
+  }
+  const evBlock = [
+    ``,
+    `## ${now().slice(0, 16)} verify-code (자동)`,
+    `Command: leerness verify-code`,
+    `Tasks: ${tasks.map(t => t.name).join(', ')}`,
+    ...results.map(r => `- ${r.name}: exit=${r.exit} (${r.durMs}ms) — \`${r.cmd}\``),
+    `Tail:`,
+    '```',
+    results.map(r => `[${r.name}]\n${r.tail}`).join('\n---\n').slice(0, 1500),
+    '```'
+  ].join('\n');
+  append(evidencePath(root), evBlock + '\n');
+  ok(`evidence 기록: .harness/review-evidence.md`);
+  if (failedCnt) { process.exitCode = 1; warn(`${failedCnt}개 task 실패 — progress의 해당 row를 incomplete로 표시하세요.`); }
+}
+
+// ===== 1.9.7 B: lessons — 과거 결정/실수 자동 회수 =====
+function lessonsCmd(root) {
+  root = absRoot(root);
+  const query = arg('--query', null);
+  const limit = parseInt(arg('--limit', '10'), 10);
+  const decisions = exists(decisionsPath(root)) ? read(decisionsPath(root)) : '';
+  const evidence = exists(evidencePath(root)) ? read(evidencePath(root)) : '';
+  const tlog = exists(taskLogPath(root)) ? read(taskLogPath(root)) : '';
+  const handoff = exists(handoffPath(root)) ? read(handoffPath(root)) : '';
+  const lessons = [];
+  // decisions: ### 블록 전체
+  for (const block of decisions.split(/\n(?=### )/)) {
+    if (!block.startsWith('### ')) continue;
+    const m = block.match(/^### (.+)$/m);
+    if (!m) continue;
+    lessons.push({ source: 'decisions.md', title: m[1].trim(), block });
+  }
+  // evidence: ## 블록 중 실패/롤백/버그 표지가 있는 것
+  for (const block of evidence.split(/\n(?=## )/)) {
+    if (!block.startsWith('## ')) continue;
+    if (/✗|\bfail(ed)?\b|롤백|재발|incomplete|\bbug\b|버그|warning/i.test(block)) {
+      const m = block.match(/^## (.+)$/m);
+      if (m) lessons.push({ source: 'review-evidence.md', title: m[1].trim(), block });
+    }
+  }
+  // task-log: 실패 키워드 라인
+  for (const line of tlog.split('\n')) {
+    if (line.length > 4 && /✗|\bfail|롤백|재발|incomplete|버그/i.test(line)) {
+      lessons.push({ source: 'task-log.md', title: line.replace(/^[-*]\s*/, '').slice(0, 80), block: line });
+    }
+  }
+  // handoff: 미완료/블로커 항목
+  if (handoff) {
+    const incompleteSec = handoff.match(/## Incomplete[\s\S]*?(?=\n## |$)/);
+    if (incompleteSec && incompleteSec[0].split('\n').slice(1).some(l => /^- (?!없음)/.test(l))) {
+      lessons.push({ source: 'session-handoff.md', title: 'Incomplete / Blocked from last session', block: incompleteSec[0] });
+    }
+  }
+  let filtered = lessons;
+  if (query) {
+    const q = new RegExp(escapeRegex(query), 'i');
+    filtered = lessons.filter(l => q.test(l.title) || q.test(l.block));
+  }
+  log(`# Lessons${query ? ` — query="${query}"` : ''}`);
+  if (!filtered.length) {
+    if (query) ok(`"${query}" 관련 과거 lessons 없음`);
+    else ok('과거 lessons 없음 (decisions/evidence가 비어있거나 실패 표지 없음)');
+    return;
+  }
+  log(`총 ${filtered.length}건 발견:`);
+  for (const l of filtered.slice(0, limit)) {
+    log(`\n[${l.source}] ${l.title}`);
+    const preview = l.block.replace(/\n+/g, ' ').replace(/\s{2,}/g, ' ').slice(0, 240);
+    log(`  ${preview}${l.block.length > 240 ? '…' : ''}`);
+  }
+  if (filtered.length > limit) log(`\n💡 ${filtered.length - limit}개 더 있음 — --limit ${filtered.length}`);
+}
+
 // ===== 1.9.3: Causal / reuse / consistency =====
 const CODE_EXT = new Set(['.js','.ts','.jsx','.tsx','.mjs','.cjs','.css','.scss','.sass','.less','.html','.htm','.vue','.svelte','.md','.json','.py','.rb','.go','.rs','.java','.kt','.swift','.cs','.php']);
 function* walkCode(root, base = root, depth = 0, extras = null) {
@@ -1363,6 +1568,13 @@ function guideCmd(root, target) {
   log('');
   log('## 3. UI consistency — 디자인 토큰 일치');
   uiConsistency(root);
+  log('');
+  log('## 4. Lessons — 과거 결정/실수 회수 (1.9.7)');
+  if (q) {
+    // lessonsCmd가 arg('--query')를 읽으므로 임시로 push
+    if (!process.argv.includes('--query')) { process.argv.push('--query', q); }
+    lessonsCmd(root);
+  } else log('(target/--query 없음 — lessons 검색 스킵)');
   log('\n💡 다음 단계: 위 결과를 바탕으로 작업 계획을 plan/progress에 기록 후 진행하세요.');
 }
 
@@ -1539,7 +1751,10 @@ function viewworkInstall(root) {
 }
 
 function help() {
-  log(`Leerness v${VERSION}\n\nUsage:\n  leerness init [path] [--language auto|ko|en] [--skills recommended|all|a,b]\n  leerness migrate [path] [--dry-run] [--force]\n  leerness update [path] [--check|--yes|--force|--from <tarball>]\n  leerness auto-update install [path]\n  leerness status [path]\n  leerness verify [path]\n  leerness debug [path]\n  leerness audit [path]\n  leerness check [path]\n  leerness scan secrets [path]\n  leerness encoding check [path]\n  leerness lazy detect [path]\n  leerness memory search "query" [--limit 5]\n  leerness handoff [path]\n  leerness session close [path]\n  leerness viewwork install [path]\n  leerness viewwork emit [path] [--action a] [--note n] [--agent x] [--tool t]\n  leerness route <task-type>\n  leerness self check [path]\n  leerness readme sync [path]\n  leerness consistency check [path]\n  leerness consistency merge-design-guide [path]\n  leerness plan show|init|add|drop|progress|sync [args]\n  leerness task list|add|update|drop|fix-evidence [args]\n  leerness skill list|info <name>\n  leerness skill learn <id> --doc <url> --command "..." --capability "..." [--note ...]\n  leerness skill use <id> [--note ...]\n  leerness skill optimize <id> --before "..." --after "..." [--note ...]\n  leerness skill remove <id>\n  leerness skill consolidate [--threshold 0.3]\n  leerness gate [path]                       # verify+audit+scan+encoding+lazy\n  leerness impact <target> [--all]           # 변경 전 영향 분석 (기본 strong, --all로 weak 포함)\n  leerness reuse find <query>                # 기존 자원 검색 (재귀 안내)\n  leerness reuse register <name> --where <p> --kind component|hook|util|api [--note ...]\n  leerness ui consistency [path] [--strict] [--fail-on-violation]\n  leerness graph [path] [--out <file>]       # mermaid 의존성 그래프\n  leerness guide [target]                    # impact + reuse + ui consistency 통합 가이드\n`);
+  log(`Leerness v${VERSION}\n\nUsage:\n  leerness init [path] [--language auto|ko|en] [--skills recommended|all|a,b]\n  leerness migrate [path] [--dry-run] [--force]\n  leerness update [path] [--check|--yes|--force|--from <tarball>]\n  leerness auto-update install [path]\n  leerness status [path]\n  leerness verify [path]\n  leerness debug [path]\n  leerness audit [path]\n  leerness check [path]\n  leerness scan secrets [path]\n  leerness encoding check [path]\n  leerness lazy detect [path]\n  leerness memory search "query" [--limit 5]\n  leerness handoff [path]\n  leerness session close [path]\n  leerness viewwork install [path]\n  leerness viewwork emit [path] [--action a] [--note n] [--agent x] [--tool t]\n  leerness route <task-type>\n  leerness self check [path]\n  leerness readme sync [path]\n  leerness consistency check [path]\n  leerness consistency merge-design-guide [path]\n  leerness plan show|init|add|drop|progress|sync [args]\n  leerness task list|add|update|drop|fix-evidence|relink [args]\n  leerness skill list|info <name>\n  leerness skill learn <id> --doc <url> --command "..." --capability "..." [--note ...]\n  leerness skill use <id> [--note ...]\n  leerness skill optimize <id> --before "..." --after "..." [--note ...]\n  leerness skill remove <id>\n  leerness skill consolidate [--threshold 0.3]\n  leerness gate [path]                       # verify+audit+scan+encoding+lazy
+  leerness verify-code [path] [--build]      # npm test/lint/typecheck 자동 실행 + evidence 자동 기록 (1.9.7)
+  leerness lessons [--query <키>] [--limit N]  # 과거 결정/실수 자동 회수 (1.9.7)
+  leerness lazy detect [path] [--auto-track] # --auto-track으로 새 TODO를 progress에 자동 등록 (1.9.7)\n  leerness impact <target> [--all]           # 변경 전 영향 분석 (기본 strong, --all로 weak 포함)\n  leerness reuse find <query>                # 기존 자원 검색 (재귀 안내)\n  leerness reuse register <name> --where <p> --kind component|hook|util|api [--note ...]\n  leerness ui consistency [path] [--strict] [--fail-on-violation]\n  leerness graph [path] [--out <file>]       # mermaid 의존성 그래프\n  leerness guide [target]                    # impact + reuse + ui consistency 통합 가이드\n`);
 }
 
 async function main() {
@@ -1578,6 +1793,8 @@ async function main() {
   if (cmd === 'skill' && args[1] === 'remove')      return skillRemove(absRoot(arg('--path', process.cwd())), args[2]);
   if (cmd === 'skill' && args[1] === 'consolidate') return skillConsolidate(absRoot(arg('--path', process.cwd())));
   if (cmd === 'gate')                               return gate(args[1] || process.cwd());
+  if (cmd === 'verify-code')                        return verifyCodeCmd(args[1] || process.cwd());
+  if (cmd === 'lessons')                            return lessonsCmd(arg('--path', process.cwd()));
   if (cmd === 'impact')                             return impactCmd(arg('--path', process.cwd()), args[1]);
   if (cmd === 'reuse' && args[1] === 'find')        return reuseFind(arg('--path', process.cwd()), args.slice(2).filter(x => !x.startsWith('-')).join(' '));
   if (cmd === 'reuse' && args[1] === 'register')    return reuseRegister(arg('--path', process.cwd()), args[2]);
@@ -1603,6 +1820,7 @@ async function main() {
     if (sub==='update') return taskUpdate(root, args[2]);
     if (sub==='drop')   return taskDrop(root, args[2]);
     if (sub==='fix-evidence') return taskFixEvidence(root);
+    if (sub==='relink')       return taskRelink(root);
   }
   return help();
 }

package/package.json

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

package/scripts/e2e.js

@@ -235,6 +235,135 @@ total++;
   if (!(strongOK && weakHint)) failed++;
 }
 
+// 1.9.7 A: verify-code — 가짜 package.json + 통과 시나리오
+total++;
+{
+  const tmpV = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-vc-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpV, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore' });
+  fs.writeFileSync(path.join(tmpV, 'package.json'), JSON.stringify({ name: 't', version: '0.0.1', scripts: { test: 'node -e "console.log(\\"OK\\");process.exit(0)"' } }));
+  const r = cp.spawnSync(process.execPath, [CLI, 'verify-code', tmpV], { encoding: 'utf8' });
+  const ev = fs.readFileSync(path.join(tmpV, '.harness/review-evidence.md'), 'utf8');
+  const ok = r.status === 0 && /test passed/.test(r.stdout) && /verify-code \(자동\)/.test(ev);
+  console.log(ok ? '✓ B(1.9.7-A) verify-code: 통과 + evidence 자동 기록' : `✗ A 실패\n${r.stdout}`);
+  if (!ok) failed++;
+}
+
+// 1.9.7 A: verify-code — 실패 시나리오
+total++;
+{
+  const tmpV2 = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-vc2-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpV2, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore' });
+  fs.writeFileSync(path.join(tmpV2, 'package.json'), JSON.stringify({ name: 't', version: '0.0.1', scripts: { test: 'node -e "process.exit(2)"' } }));
+  const r = cp.spawnSync(process.execPath, [CLI, 'verify-code', tmpV2], { encoding: 'utf8' });
+  const ok = r.status === 1 && /test failed/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.7-A) verify-code: 실패 시 exit=1' : `✗ A2 실패 status=${r.status}`);
+  if (!ok) failed++;
+}
+
+// 1.9.7 B: lessons — decisions/evidence에 시드 후 query로 회수
+total++;
+{
+  fs.appendFileSync(path.join(tmp, '.harness/decisions.md'), `\n### 2026-05-08 — Decision: 캐시 차등 TTL 도입\n- Reason: 단일 5분 TTL이 daily 데이터에 비효율\n- Impact: open-meteo 응답 캐시 적중률 ↑\n`);
+  fs.appendFileSync(path.join(tmp, '.harness/review-evidence.md'), `\n## 2026-05-08 e2e\n✗ 캐시 키 불안정 — 좌표 정규화 부재 (롤백 후 fix)\n`);
+  const r = cp.spawnSync(process.execPath, [CLI, 'lessons', '--query', '캐시', '--path', tmp], { encoding: 'utf8' });
+  const ok = r.status === 0 && /Lessons.*query="캐시"/.test(r.stdout) && /decisions\.md/.test(r.stdout) && /review-evidence\.md/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.7-B) lessons: decisions+evidence 회수' : `✗ B 실패\n${r.stdout}`);
+  if (!ok) failed++;
+}
+
+// 1.9.7 B: guide가 lessons를 자동 통합
+total++;
+{
+  const r = cp.spawnSync(process.execPath, [CLI, 'guide', 'src/components/Card.html', '--path', tmp], { encoding: 'utf8' });
+  const ok = r.status === 0 && /## 4\. Lessons/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.7-B) guide: lessons 섹션 자동 추가' : '✗ B guide 통합 실패');
+  if (!ok) failed++;
+}
+
+// 1.9.7 C: lazy detect --auto-track
+total++;
+{
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-c-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore' });
+  // 의도된 진짜 TODO (주석)
+  fs.mkdirSync(path.join(tmpC, 'src'), { recursive: true });
+  fs.writeFileSync(path.join(tmpC, 'src/a.js'), `// TODO: 추적해야 할 미완료 작업\nfunction foo() {}\n`);
+  // review-evidence에 npm test 키워드 추가 (lazy detect의 다른 신호 우회)
+  fs.appendFileSync(path.join(tmpC, '.harness/review-evidence.md'), '\n## seed\nCommand: npm test\n');
+  // session close로 handoff 채우기
+  cp.spawnSync(process.execPath, [CLI, 'session', 'close', tmpC], { stdio: 'ignore' });
+  // --auto-track 실행
+  const r = cp.spawnSync(process.execPath, [CLI, 'lazy', 'detect', tmpC, '--auto-track'], { encoding: 'utf8' });
+  const tracker = fs.readFileSync(path.join(tmpC, '.harness/progress-tracker.md'), 'utf8');
+  const known = fs.existsSync(path.join(tmpC, '.harness/known-todos.json')) ? JSON.parse(fs.readFileSync(path.join(tmpC, '.harness/known-todos.json'), 'utf8')) : [];
+  const ok = /TODO src\/a\.js:1/.test(tracker) && /auto-tracked/.test(tracker) && known.length === 1;
+  console.log(ok ? '✓ B(1.9.7-C) lazy detect --auto-track: 자동 등록 + known-todos.json' : `✗ C 실패\nTracker:\n${tracker.split('\n').filter(l=>l.startsWith('| T-')).slice(-3).join('\n')}\nKnown: ${JSON.stringify(known)}`);
+  if (!ok) failed++;
+}
+
+// 1.9.7 C: 같은 TODO 재실행 시 known-todos가 적용되어 newTodos 0
+total++;
+{
+  // 위 시나리오 이어서 — known-todos가 있으므로 새 TODO=0이어야 함
+  // 별도 새 tmp로 재현 (tmpC는 위에서 자동 등록됐으니 same dir에서 다시 호출)
+  // 위 tmpC는 already auto-tracked
+  const tmpC2 = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-c2-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC2, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore' });
+  fs.mkdirSync(path.join(tmpC2, 'src'), { recursive: true });
+  fs.writeFileSync(path.join(tmpC2, 'src/a.js'), `// TODO: 추적된 항목\n`);
+  // known-todos.json에 미리 등록
+  fs.writeFileSync(path.join(tmpC2, '.harness/known-todos.json'), JSON.stringify([{ file: 'src/a.js', line: 1, text: '// TODO: 추적된 항목', ackAt: '2026-05-08T00:00:00Z' }]));
+  fs.appendFileSync(path.join(tmpC2, '.harness/review-evidence.md'), '\n## seed\nCommand: npm test\n');
+  cp.spawnSync(process.execPath, [CLI, 'session', 'close', tmpC2], { stdio: 'ignore' });
+  const r = cp.spawnSync(process.execPath, [CLI, 'lazy', 'detect', tmpC2], { encoding: 'utf8' });
+  // newTodos가 0이므로 "new: 0" 또는 TODO 카운트가 1이지만 progress 추적에 자동 등록 안 됨
+  // 핵심: TODO 1개 잡혀도 known이라 새 항목 노출 X
+  const ok = /new: 0\b/.test(r.stdout) || !/💡 자동 등록/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.7-C) known-todos: 재카운트 회피' : `✗ C2 실패\n${r.stdout}`);
+  if (!ok) failed++;
+}
+
+// 1.9.6 회귀: task relink — 인위적 link 손실 → 자동 매칭 제안 + --apply 자동 복구
+total++;
+{
+  // plan.md에 새 milestone 추가, progress엔 link 없는 비슷한 row 추가
+  const planPath_ = path.join(tmp, '.harness/plan.md');
+  fs.appendFileSync(planPath_,
+    `\n### M-9001. 캐시 헬퍼 모듈\nStatus: planned\nProgress: 0%\n\nTasks:\n- [ ] 캐시 helper\n` +
+    `\n### M-9002. 인증 헬퍼 모듈\nStatus: planned\nProgress: 0%\n\nTasks:\n- [ ] 인증 helper\n`);
+  // progress에 link 없는 비슷한 row 2개 추가
+  const trackerPath_ = path.join(tmp, '.harness/progress-tracker.md');
+  fs.appendFileSync(trackerPath_,
+    `| T-9001 | done | 캐시 helper 구현 | tests:5/5 (link lost) | 다음 단계 | 2026-05-08 |\n` +
+    `| T-9002 | done | 인증 helper 구현 | tests:8/8 (link lost) | 다음 단계 | 2026-05-08 |\n`);
+
+  // 제안 모드
+  const r1 = cp.spawnSync(process.execPath, [CLI, 'task', 'relink', '--path', tmp], { encoding: 'utf8' });
+  const okSuggest = r1.status === 0 && /M-9001/.test(r1.stdout) && /M-9002/.test(r1.stdout) && /최선 후보/.test(r1.stdout);
+  console.log(okSuggest ? '✓ B(1.9.6) task relink 제안: 2개 매칭 발견' : `✗ B(1.9.6) 제안 실패\n${r1.stdout}`);
+  if (!okSuggest) failed++;
+}
+total++;
+{
+  // --apply
+  const r2 = cp.spawnSync(process.execPath, [CLI, 'task', 'relink', '--apply', '--path', tmp], { encoding: 'utf8' });
+  const tracker = fs.readFileSync(path.join(tmp, '.harness/progress-tracker.md'), 'utf8');
+  const okApply = r2.status === 0 && /M-9001/.test(tracker) && /M-9002/.test(tracker);
+  console.log(okApply ? '✓ B(1.9.6) task relink --apply: 자동 복구' : '✗ B(1.9.6) --apply 실패');
+  if (!okApply) failed++;
+}
+total++;
+{
+  // audit이 task relink 안내를 출력하는지 (이번엔 link 복구 후라 미연결 milestone 없을 것)
+  // 일부러 새 milestone 추가 후 audit
+  fs.appendFileSync(path.join(tmp, '.harness/plan.md'),
+    `\n### M-9999. 매칭 후보 없는 milestone\nStatus: planned\n\nTasks:\n- [ ] x\n`);
+  const r3 = cp.spawnSync(process.execPath, [CLI, 'audit', tmp], { encoding: 'utf8' });
+  const ok = /milestones without progress entry/.test(r3.stdout) && /M-9999/.test(r3.stdout) && /leerness task relink/.test(r3.stdout);
+  console.log(ok ? '✓ B(1.9.6) audit이 task relink 안내 출력' : `✗ B(1.9.6) audit 안내 누락\n${r3.stdout}`);
+  if (!ok) failed++;
+}
+
 // 1.9.5 G 회귀: impact medium 카테고리 — 동적 path 패턴
 total++;
 {