leerness 1.9.23 → 1.9.24

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 1.9.24 — 2026-05-14
+
+**`leerness deps <capability>` — depends-on 그래프 역방향 추적 + 자동 회귀 sweep**.
+
+오래된 작업 재진행 시 / 핵심 모듈 변경 시 영향받는 모듈을 자동 식별 + 해당 프로젝트의 `npm test`를 일괄 실행.
+
+### Added
+
+- **`leerness deps <capability>`**: 워크스페이스 모든 `reuse-map.md`의 depends-on 엣지를 역방향 추적해 해당 capability를 의존하는 모든 capability와 프로젝트를 식별. 1-hop(직접 의존) + 2-hop(전이 의존) 모두 표시.
+- **`leerness deps <capability> --run-tests`**: 영향받는 N개 프로젝트의 `npm test`를 자동 일괄 실행. 회귀 발견 시 어느 프로젝트인지 즉시 보고 + `exit 1`. CI 통합용 `--json`.
+- 실측: `leerness deps Character --all-apps --run-tests` 실행 시 rpg-core의 `Character` capability에 의존하는 **6 프로젝트(8 capability) 자동 식별 + 6/6 npm test 자동 일괄 실행**.
+
+### Why
+오래된 작업을 재진행하거나 핵심 모듈을 변경할 때, 영향받는 다른 프로젝트를 수동으로 grep하던 패턴을 1 명령으로 자동화. depends-on 그래프(1.9.18부터 수집)가 활용됨.
+
+### Migration
+```bash
+npx leerness@latest update . --yes
+# 사용 예
+leerness deps Character --all-apps --run-tests
+```
+
 ## 1.9.23 — 2026-05-14
 
 **Install 사용성 개선 — `preferGlobal` + `main` 필드 + README 상단 Install 섹션**.

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.23';
+const VERSION = '1.9.24';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -1861,6 +1861,131 @@ async function orchestrateCmd(root, goalParts) {
   log(`📜 누적 기록: .harness/orchestrate-log.md`);
 }
 
+// 1.9.24: leerness deps <capability> — depends-on 그래프 역방향 추적 + 자동 회귀 sweep
+// 사용 예: leerness deps Character
+//   → rpg-core/Character를 의존하는 모든 capability 식별 (rpg-net/Session, rpg-data/* 등)
+//   → 영향받은 프로젝트의 npm test 자동 일괄 실행
+//   → 회귀 발생 시 어느 프로젝트인지 즉시 보고
+function depsImpactCmd(root, targetCapability) {
+  root = absRoot(root || process.cwd());
+  if (!targetCapability) { fail('impact <capability> 필요. 예: leerness impact Character'); return process.exit(1); }
+  const paths = _collectWorkspacePaths(root);
+  if (!paths.length) {
+    // --all-apps 자동
+    process.argv.push('--all-apps');
+  }
+  const allPaths = _collectWorkspacePaths(root);
+  if (!allPaths.length) return fail('워크스페이스 프로젝트 없음. _apps/* 또는 --include 사용.');
+
+  // 1) 모든 reuse-map에서 entries + depends-on 엣지 수집
+  const allEntries = []; // { project, entry }
+  const allEdges = [];    // { fromProject, fromCap, toCap }
+  for (const p of allPaths) {
+    const entries = _readReuseMap(p);
+    for (const e of entries) {
+      allEntries.push({ project: path.basename(p), projectPath: p, entry: e });
+      for (const dep of e.dependsOn) {
+        allEdges.push({ fromProject: path.basename(p), fromCap: e.capability, toCap: dep });
+      }
+    }
+  }
+
+  // 2) targetCapability를 의존하는 capability 식별 (역방향)
+  const target = String(targetCapability);
+  const targetLower = target.toLowerCase();
+  const directImpact = allEdges.filter(e => e.toCap.toLowerCase() === targetLower);
+  const impactedProjects = new Set(directImpact.map(e => e.fromProject));
+
+  // 2단계 전이: 영향받은 capability를 또 의존하는 것들 (2-hop)
+  const transitiveImpact = [];
+  for (const e1 of directImpact) {
+    for (const e2 of allEdges) {
+      if (e2.toCap.toLowerCase() === e1.fromCap.toLowerCase()) {
+        transitiveImpact.push({ via: e1.fromCap, ...e2 });
+        impactedProjects.add(e2.fromProject);
+      }
+    }
+  }
+
+  // target capability 자체가 어디 등록됐는지
+  const definedAt = allEntries.filter(e => e.entry.capability.toLowerCase() === targetLower);
+
+  if (has('--json')) {
+    log(JSON.stringify({
+      target,
+      definedAt: definedAt.map(d => ({ project: d.project, element: d.entry.element })),
+      directImpact,
+      transitiveImpact,
+      impactedProjects: Array.from(impactedProjects)
+    }, null, 2));
+    return;
+  }
+
+  log(`# leerness impact "${target}" (1.9.24)`);
+  log('');
+  log(`## 정의 위치`);
+  if (!definedAt.length) {
+    log(`  ⚠ "${target}" capability가 reuse-map에 등록되지 않음 — 영향 추적 불가`);
+    return process.exit(1);
+  }
+  for (const d of definedAt) log(`  - ${d.project}: ${d.entry.element}`);
+
+  log('');
+  log(`## 직접 의존 (1-hop, ${directImpact.length}건)`);
+  if (!directImpact.length) log(`  (없음) — 단독 capability. 변경 안전.`);
+  for (const e of directImpact) log(`  - ${e.fromProject}/${e.fromCap}`);
+
+  if (transitiveImpact.length) {
+    log('');
+    log(`## 전이 의존 (2-hop, ${transitiveImpact.length}건)`);
+    for (const e of transitiveImpact) log(`  - ${e.fromProject}/${e.fromCap}  (경유: ${e.via})`);
+  }
+
+  log('');
+  log(`## 영향받는 프로젝트 (${impactedProjects.size}개)`);
+  for (const p of impactedProjects) log(`  - ${p}`);
+
+  // 3) --run-tests 옵션이면 영향받은 프로젝트의 npm test 일괄 실행
+  if (has('--run-tests')) {
+    log('');
+    log(`## 🚦 자동 회귀 sweep (--run-tests)`);
+    const results = [];
+    for (const projName of impactedProjects) {
+      const projPath = allPaths.find(p => path.basename(p) === projName);
+      if (!projPath) continue;
+      const pkgPath = path.join(projPath, 'package.json');
+      if (!exists(pkgPath)) { log(`  ⚠ ${projName}: package.json 없음 — skip`); continue; }
+      let pkg = null;
+      try { pkg = JSON.parse(read(pkgPath)); } catch {}
+      if (!pkg?.scripts?.test) { log(`  ⚠ ${projName}: scripts.test 없음 — skip`); continue; }
+      const t0 = Date.now();
+      const r = cp.spawnSync('npm test', [], { cwd: projPath, encoding: 'utf8', shell: true, timeout: 5 * 60 * 1000 });
+      const elapsed = Date.now() - t0;
+      const out = (r.stdout || '') + (r.stderr || '');
+      const m = out.match(/(\d+)\s*\/\s*(\d+)\s*(?:passed|통과|pass|passing)/i);
+      const passed = r.status === 0;
+      results.push({ project: projName, passed, exit: r.status, elapsed, parsed: m ? { num: parseInt(m[1], 10), denom: parseInt(m[2], 10) } : null });
+      const tag = passed ? '✓' : '✗';
+      const ratio = m ? ` (${m[1]}/${m[2]})` : '';
+      log(`  ${tag} ${projName}: exit=${r.status}${ratio}  ${elapsed}ms`);
+    }
+    log('');
+    const pass = results.filter(r => r.passed).length;
+    const fail = results.length - pass;
+    log(`## 종합`);
+    log(`  - 영향받는 프로젝트 ${impactedProjects.size}개 중 ${pass}개 통과, ${fail}개 실패`);
+    if (fail > 0) {
+      log(`  ⚠ ${target} 변경이 ${fail}개 프로젝트에 회귀 발생 가능 — 해당 프로젝트 testing 우선`);
+      return process.exit(1);
+    } else {
+      log(`  ✓ 모든 영향받는 프로젝트 회귀 없음 — ${target} 변경 안전`);
+    }
+  } else {
+    log('');
+    log(`  💡 \`--run-tests\` 옵션으로 영향받는 ${impactedProjects.size}개 프로젝트 npm test 자동 일괄 실행 가능`);
+  }
+}
+
 // 1.9.22 후보 4: llm-bench record + retro 통합
 function llmBenchRecordCmd(root) {
   root = absRoot(root || process.cwd());
@@ -3877,7 +4002,7 @@ 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] [--all-apps] [--include p1,p2] [--since 24h|3d] [--compact] [--json]   # 1.9.17-22 워크스페이스 (--compact: LLM 시스템 프롬프트용 1줄 요약)\n  leerness orchestrate "<목표>" [--agents N] [--model qwen2.5:7b-instruct] [--retry-on-fail K]   # 1.9.22 Ollama opt-in (LEERNESS_OLLAMA_BASE_URL 필요)\n  leerness llm-bench record --score N --model X [--label L] [--tokens T]   # 1.9.22 LLM 벤치 히스토리 누적\n  leerness reuse-map [path] [--all-apps] [--include p1,p2] [--strict-elements] [--json] # 1.9.18 중복/잠재중복/depends-on\n  leerness verify-claim <T-ID> [--path .] [--run-tests] [--json]   # 1.9.18-20 evidence 자동 검증 (1.9.20: scenes/scripts 등 도메인 폴더 + jest/mocha 파싱)\n  leerness verify-code [path] [--build] [--bench]  # 1.9.20 --bench: scripts.bench 추가 실행 + evidence 누적\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
+  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] [--all-apps] [--include p1,p2] [--since 24h|3d] [--compact] [--json]   # 1.9.17-22 워크스페이스 (--compact: LLM 시스템 프롬프트용 1줄 요약)\n  leerness orchestrate "<목표>" [--agents N] [--model qwen2.5:7b-instruct] [--retry-on-fail K]   # 1.9.22 Ollama opt-in (LEERNESS_OLLAMA_BASE_URL 필요)\n  leerness llm-bench record --score N --model X [--label L] [--tokens T]   # 1.9.22 LLM 벤치 히스토리 누적\n  leerness deps <capability> [--run-tests] [--json]   # 1.9.24 depends-on 역방향 추적 + 자동 회귀 sweep\n  leerness reuse-map [path] [--all-apps] [--include p1,p2] [--strict-elements] [--json] # 1.9.18 중복/잠재중복/depends-on\n  leerness verify-claim <T-ID> [--path .] [--run-tests] [--json]   # 1.9.18-20 evidence 자동 검증 (1.9.20: scenes/scripts 등 도메인 폴더 + jest/mocha 파싱)\n  leerness verify-code [path] [--build] [--bench]  # 1.9.20 --bench: scripts.bench 추가 실행 + evidence 누적\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 retro [path] [--days 7] [--all-apps] [--include p1,p2] [--json]  # 회고 (1.9.13~1.9.16)
   leerness insights [path] [--all-apps] [--include p1,p2] [--json]         # 누적 통계 (1.9.13~1.9.16)
   leerness brainstorm "<주제>" [--all-apps] [--include p1,p2] [--json]    # 브레인스토밍 (1.9.13~1.9.16)
@@ -3915,6 +4040,7 @@ async function main() {
   if (cmd === 'verify-claim') return verifyClaimCmd(arg('--path', process.cwd()), args[1]);
   if (cmd === 'orchestrate')  return await orchestrateCmd(arg('--path', process.cwd()), args.slice(1).filter(x => !x.startsWith('-')));
   if (cmd === 'llm-bench' && args[1] === 'record') return llmBenchRecordCmd(arg('--path', process.cwd()));
+  if (cmd === 'deps')         return depsImpactCmd(arg('--path', process.cwd()), args[1]);
   if (cmd === 'session' && args[1] === 'close') { const r = sessionClose(args[2] || process.cwd()); viewworkEmit(args[2] || process.cwd(), { action: 'task', tool: 'session-close', note: 'session close' }); return r; }
   if (cmd === 'viewwork' && args[1] === 'install') return viewworkInstall(args[2] || process.cwd());
   if (cmd === 'viewwork' && args[1] === 'emit')    return viewworkEmit(args[2] || process.cwd(), { action: arg('--action','task'), note: arg('--note',''), agent: arg('--agent','leerness'), tool: arg('--tool','leerness-cli') });

package/package.json

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