leerness 1.9.141 → 1.9.143

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 1.9.143 — 2026-05-20
+
+**JSON 4종 featureGraph 통합 완성 + drift check feature 신호** — 1.9.142 session close --json 패턴을 handoff/health에 확장.
+
+### Added — handoff --json featureGraph 통합
+- `result.featureGraph = { total, edges, isolated, summary: "F<n>/E<n>[/iso<n>]" }`
+- 외부 AI가 handoff 한 번에 컨텍스트 + memory surface + featureGraph 동시 회수
+
+### Added — health --json featureGraph 통합
+- `out.featureGraph = { total, edges, isolated, summary }`
+- JSON 4종 (handoff/memory status/session close/health) featureGraph 일관성 완성 (memorySurface 1.9.123 패턴과 동형)
+
+### Added — drift check feature graph 신호 (6번째 신호)
+- 노드 ≥ 3개 + edges == 0 → weight 25
+- 노드 ≥ 3개 + isolated 비율 ≥ 50% → weight 15
+- `drift check --json` `fired` 배열에 노출
+- 사용자 cascade 방지 의지 + 실제 사용 사이 gap 자동 감지
+
+### Validation
+- stress-v88: PASS (handoff/health featureGraph + drift 신호 + 누적 회귀)
+- e2e: 219/219 PASS
+
+## 1.9.142 — 2026-05-20
+
+**Feature Graph 통합 라운드** — 1.9.141 인과관계 시스템을 audit / MCP CRUD / session close 에 통합.
+
+### Added — MCP feature CRUD 완성
+- `leerness_feature_add` (MCP 45) — 외부 AI가 코드 작성 중 feature 등록
+- `leerness_feature_link` (MCP 46) — 의존/영향/공변경 엣지 추가
+- 이제 외부 AI (Claude Code/Cursor 등) 가 leerness 워크플로 밖에서도 인과관계를 직접 갱신
+- 인자: `title/dependsOn/affects/coChangesWith/files/path`
+
+### Added — audit Feature Graph 무결성 검증 (kind 13종으로 확장)
+- `feature_graph_orphan` — 다른 노드가 참조하는데 정의 없는 ID (예: F-0001 → F-0099 missing)
+- `feature_graph_cycle` — affects/depends-on 그래프 순환 감지 (DFS 3-color)
+- 둘 다 warning (--strict 시 failures 승격)
+- `--no-feature-check` 옵션으로 끄기
+- `audit --json` findings 에 `count/orphans[]/cycles[]` 상세 포함
+
+### Added — session close --json featureGraph 통합
+- `{ total, edges, isolated, summary: "F<n>/E<n>[/iso<n>]" }` 추가
+- 마감 시 Feature Graph 통계 자동 보고
+
+### Validation
+- stress-v87: PASS (MCP feature_add/link + audit orphan/cycle + session close featureGraph + 누적 회귀)
+- e2e: 219/219 PASS
+- MCP tools: **46** (+2 from 44)
+
 ## 1.9.141 — 2026-05-20
 
 **ASCII 배너 모션 + Feature Causality Graph (인과관계 추적) — 사용자 요청 2종.**

package/README.md

@@ -2,7 +2,7 @@
 
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.141-green)]() [![tests](https://img.shields.io/badge/e2e-219%2F219-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-44-blue)]() [![json](https://img.shields.io/badge/--json-20_commands-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-71-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![feature-graph](https://img.shields.io/badge/feature--causality--graph-1.9.141-success)]() [![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.143-green)]() [![tests](https://img.shields.io/badge/e2e-219%2F219-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-46-blue)]() [![json](https://img.shields.io/badge/--json-20_commands-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-73-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-auto-success)]() [![feature-graph-json](https://img.shields.io/badge/feature--graph--JSON--4cmds-complete-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,7 +12,7 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.141  AI Agent Reliability Harness                      ║
+  ║  v1.9.143  AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```

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.141';
+const VERSION = '1.9.143';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -2320,6 +2320,62 @@ function audit(root, opts = {}) {
       }
     } catch {}
   }
+  // 1.9.142: Feature Graph 무결성 검증 — orphan/cycle 자동 감지 (--no-feature-check로 끄기)
+  if (!has('--no-feature-check')) {
+    try {
+      const { nodes: fNodes } = _readFeatureGraph(root);
+      if (fNodes.length > 0) {
+        const ids = new Set(fNodes.map(n => n.id));
+        // (1) orphan: 다른 노드가 참조하는데 정의가 없는 ID
+        const orphans = [];
+        for (const n of fNodes) {
+          for (const ref of [...(n.dependsOn || []), ...(n.affects || []), ...(n.coChangesWith || [])]) {
+            if (!ids.has(ref)) orphans.push({ from: n.id, missingRef: ref });
+          }
+        }
+        if (orphans.length) {
+          warnings++;
+          warn(`Feature Graph: orphan 참조 ${orphans.length}건 — ${orphans.slice(0, 3).map(o => `${o.from}→${o.missingRef}`).join(', ')}${orphans.length > 3 ? ' …' : ''}`);
+          _finding('feature_graph_orphan', 'warn', 'Feature Graph 에 정의되지 않은 ID 참조', { count: orphans.length, orphans: orphans.slice(0, 10) });
+          log(`    → 수정: leerness feature add 또는 link 제거`);
+        }
+        // (2) cycle: affects 그래프에서 순환 의존성 감지 (DFS)
+        const cycles = [];
+        const WHITE = 0, GRAY = 1, BLACK = 2;
+        const color = new Map();
+        for (const n of fNodes) color.set(n.id, WHITE);
+        const byId = new Map(fNodes.map(n => [n.id, n]));
+        const dfs = (nodeId, path) => {
+          color.set(nodeId, GRAY);
+          const node = byId.get(nodeId);
+          if (!node) { color.set(nodeId, BLACK); return; }
+          for (const next of [...(node.affects || []), ...(node.dependsOn || [])]) {
+            if (!byId.has(next)) continue;
+            const c = color.get(next);
+            if (c === GRAY) {
+              // 순환 발견 — path 에 next 까지 자르기
+              const idx = path.indexOf(next);
+              const cyc = idx >= 0 ? path.slice(idx).concat([next]) : [...path, next];
+              if (!cycles.some(existing => existing.join() === cyc.join())) cycles.push(cyc);
+            } else if (c === WHITE) {
+              dfs(next, [...path, next]);
+            }
+          }
+          color.set(nodeId, BLACK);
+        };
+        for (const n of fNodes) if (color.get(n.id) === WHITE) dfs(n.id, [n.id]);
+        if (cycles.length) {
+          warnings++;
+          warn(`Feature Graph: 순환 의존 ${cycles.length}건 — ${cycles[0].join(' → ')}${cycles.length > 1 ? ` (외 ${cycles.length-1}건)` : ''}`);
+          _finding('feature_graph_cycle', 'warn', 'Feature Graph 에 순환 의존', { count: cycles.length, cycles: cycles.slice(0, 5) });
+          log(`    → 수정: feature link 재구성 (affects/depends-on 방향 정리)`);
+        }
+        if (!orphans.length && !cycles.length) {
+          ok(`Feature Graph OK (${fNodes.length} 노드, orphan/cycle 없음, 1.9.142)`);
+        }
+      }
+    } catch {}
+  }
   // 1.9.63: --strict — warnings ≥ threshold 시 failures로 승격 (CI 친화)
   if (has('--strict')) {
     const threshold = parseInt(arg('--threshold', '1'), 10);
@@ -2692,6 +2748,22 @@ function handoff(root) {
         archive: archiveCountsH,  // 1.9.130
         summary: `T${tasksInProgress}/D${decisionsCount}/R${rulesActive}/P${milestones}/L${lessonsCount}`,
       };
+      // 1.9.143: handoff --json featureGraph 통합 (session close 1.9.142 와 동일 패턴)
+      try {
+        const { nodes: fNodesH } = _readFeatureGraph(root);
+        const edgeCount = fNodesH.reduce((s, n) => s + (n.dependsOn?.length || 0) + (n.affects?.length || 0) + (n.coChangesWith?.length || 0), 0);
+        const linkedSet = new Set();
+        for (const n of fNodesH) {
+          for (const x of [...(n.dependsOn||[]), ...(n.affects||[]), ...(n.coChangesWith||[])]) { linkedSet.add(n.id); linkedSet.add(x); }
+        }
+        const isolated = fNodesH.length ? (fNodesH.length - linkedSet.size) : 0;
+        result.featureGraph = {
+          total: fNodesH.length,
+          edges: edgeCount,
+          isolated: Math.max(0, isolated),
+          summary: `F${fNodesH.length}/E${edgeCount}${isolated > 0 ? `/iso${isolated}` : ''}`
+        };
+      } catch {}
     } catch {}
     log(JSON.stringify(result, null, 2));
     return;
@@ -4526,7 +4598,7 @@ function _banner(opts = {}) {
     for (const ln of lines) log(ln);
   }
   if (opts.quickStart) {
-    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.141+ ASCII 배너 wave 모션 + Feature Causality Graph — 71 라운드 자율 누적)')));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.143+ JSON 4종 featureGraph 통합 완성 + drift 신호 — 73 라운드 자율 누적)')));
     log('    ' + C.green('npx leerness@latest init .') + C.dim('                          # 신규 프로젝트 + 외부 AI CLI 설정'));
     log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 + lessons + 매칭 skill + history hit + brainstorm hits + 헤드라인'));
     log('    ' + C.green('npx leerness handoff . --quiet') + C.dim('                      # 자동화/CI 모드 (1.9.99) — 자동 회수 라인 비활성'));
@@ -5486,6 +5558,22 @@ function sessionClose(root, opts = {}) {
         archive: archiveCountsS,  // 1.9.130
         summary: `T${tasksInProgress0}/D${decisionsCount0}/R${rulesActive0}/P${milestones0}/L${lessonsCount0}`,
       };
+      // 1.9.142: featureCounts 통합 — session close JSON에 Feature Graph 통계
+      try {
+        const { nodes: fNodesC } = _readFeatureGraph(root);
+        const edgeCount = fNodesC.reduce((s, n) => s + (n.dependsOn?.length || 0) + (n.affects?.length || 0) + (n.coChangesWith?.length || 0), 0);
+        const linkedIds = new Set();
+        for (const n of fNodesC) {
+          for (const x of [...(n.dependsOn||[]), ...(n.affects||[]), ...(n.coChangesWith||[])]) { linkedIds.add(n.id); linkedIds.add(x); }
+        }
+        const isolated = fNodesC.length ? (fNodesC.length - linkedIds.size) : 0;
+        jsonResult.featureGraph = {
+          total: fNodesC.length,
+          edges: edgeCount,
+          isolated: Math.max(0, isolated),
+          summary: `F${fNodesC.length}/E${edgeCount}${isolated > 0 ? `/iso${isolated}` : ''}`
+        };
+      } catch {}
     } catch {}
     process.stdout.write(JSON.stringify(jsonResult, null, 2) + '\n');
   }
@@ -8128,6 +8216,24 @@ function driftCheckCmd(root, opts = {}) {
       }
     }
   } catch {}
+  // 1.9.143: Feature Graph 미사용 신호 — 노드는 있는데 edges 비율 낮으면 인과관계 정리 미진
+  try {
+    const { nodes: fGraphNodes } = _readFeatureGraph(root);
+    if (fGraphNodes.length >= 3) {
+      const edgeCount = fGraphNodes.reduce((s, n) => s + (n.dependsOn?.length || 0) + (n.affects?.length || 0) + (n.coChangesWith?.length || 0), 0);
+      const linkedSet = new Set();
+      for (const n of fGraphNodes) {
+        for (const x of [...(n.dependsOn||[]), ...(n.affects||[]), ...(n.coChangesWith||[])]) { linkedSet.add(n.id); linkedSet.add(x); }
+      }
+      const isolatedCount = Math.max(0, fGraphNodes.length - linkedSet.size);
+      const isolatedRatio = isolatedCount / fGraphNodes.length;
+      if (edgeCount === 0 || isolatedRatio >= 0.5) {
+        const fgScore = edgeCount === 0 ? 25 : 15;
+        totalScore += fgScore;
+        fired.push({ file: '.harness/feature-graph.md', ageDays: null, threshold: 0, weight: fgScore, label: `Feature Graph 미정리 (1.9.143): ${fGraphNodes.length} 노드, edges=${edgeCount}, isolated=${isolatedCount}` });
+      }
+    }
+  } catch {}
   // 신규 _apps/* 에서 task 0건도 신호로
   const appsDir = path.join(root, '_apps');
   let appsZeroTask = [];
@@ -9151,7 +9257,9 @@ function mcpServeCmd(root) {
     { name: 'leerness_task_list', description: '1.9.134 — progress-tracker.md 전체 task 조회 JSON ({ total, tasks: [{ id, status, request, evidence, nextAction, updated }] }). --status 필터 지원 (planned|in-progress|done 등). 외부 AI가 task 상태 회수', inputSchema: { type: 'object', properties: { path: { type: 'string' }, status: { type: 'string' } } } },
     { name: 'leerness_rule_remove', description: '1.9.135 — rules.md 에서 특정 rule 제거 (id: R-XXXX). 제거된 rule 은 .harness/rules.archive.md 에 자동 보존 (복구 가능). Rule surface CRUD MCP 완성 (add/list/remove)', inputSchema: { type: 'object', properties: { id: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } },
     { name: 'leerness_feature_impact', description: '1.9.141 — Feature Causality Graph 인과관계 영향 추적 JSON ({ feature, total, impacted: [{ id, title, depth, via, files, errorModes }] }). 신규 기능 추가/형식 변경 전 호출: id 변경으로 영향받는 다른 feature를 transitive (affects + co-changes + reverse depends-on) 으로 회수. 1+1=20 cascade 방지', inputSchema: { type: 'object', properties: { id: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } },
-    { name: 'leerness_feature_list', description: '1.9.141 — 전체 Feature Graph 노드 + 엣지 JSON. 외부 AI가 시스템 내 기능 의존성을 한 번에 회수', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
+    { name: 'leerness_feature_list', description: '1.9.141 — 전체 Feature Graph 노드 + 엣지 JSON. 외부 AI가 시스템 내 기능 의존성을 한 번에 회수', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
+    { name: 'leerness_feature_add', description: '1.9.142 — Feature Graph 에 새 노드 추가 (외부 AI가 코드 작성 중 직접 feature 등록). 인자: { title (required), dependsOn?, affects?, coChangesWith?, files?, path? }. 자동 F-XXXX ID 부여. CRUD 완성에 기여', inputSchema: { type: 'object', properties: { title: { type: 'string' }, dependsOn: { type: 'string' }, affects: { type: 'string' }, coChangesWith: { type: 'string' }, files: { type: 'string' }, path: { type: 'string' } }, required: ['title'] } },
+    { name: 'leerness_feature_link', description: '1.9.142 — 기존 feature 노드에 의존/영향/공변경 엣지 추가. 인자: { id (required, F-XXXX), dependsOn?, affects?, coChangesWith?, path? }. 외부 AI가 코드 변경 도중 발견한 인과관계를 즉시 그래프에 반영', inputSchema: { type: 'object', properties: { id: { type: 'string' }, dependsOn: { type: 'string' }, affects: { type: 'string' }, coChangesWith: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } }
   ];
 
   function send(obj) {
@@ -9228,6 +9336,20 @@ function mcpServeCmd(root) {
           // 1.9.141: Feature Causality Graph
           case 'leerness_feature_impact':  cliArgs = ['feature', 'impact', String(args.id || ''), '--path', targetPath, '--json']; break;
           case 'leerness_feature_list':    cliArgs = ['feature', 'list', '--path', targetPath, '--json']; break;
+          // 1.9.142: Feature Graph WRITE CRUD
+          case 'leerness_feature_add':
+            cliArgs = ['feature', 'add', String(args.title || ''), '--path', targetPath];
+            if (args.dependsOn) cliArgs.push('--depends-on', String(args.dependsOn));
+            if (args.affects) cliArgs.push('--affects', String(args.affects));
+            if (args.coChangesWith) cliArgs.push('--co-changes-with', String(args.coChangesWith));
+            if (args.files) cliArgs.push('--files', String(args.files));
+            break;
+          case 'leerness_feature_link':
+            cliArgs = ['feature', 'link', String(args.id || ''), '--path', targetPath];
+            if (args.dependsOn) cliArgs.push('--depends-on', String(args.dependsOn));
+            if (args.affects) cliArgs.push('--affects', String(args.affects));
+            if (args.coChangesWith) cliArgs.push('--co-changes-with', String(args.coChangesWith));
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -9512,6 +9634,22 @@ function healthCmd(root) {
       summary: `T${tasksInProgress}/D${decisionsCount}/R${rulesActive}/P${milestones}/L${lessonsCount}`,
     };
   } catch { out.memorySurface = { error: 'memorySurface 점검 실패' }; }
+  // 1.9.143: health --json featureGraph 통합 (handoff/session close 와 동일 패턴 — JSON 4종 완성)
+  try {
+    const { nodes: fNodesHe } = _readFeatureGraph(root);
+    const edgeCount = fNodesHe.reduce((s, n) => s + (n.dependsOn?.length || 0) + (n.affects?.length || 0) + (n.coChangesWith?.length || 0), 0);
+    const linkedSet = new Set();
+    for (const n of fNodesHe) {
+      for (const x of [...(n.dependsOn||[]), ...(n.affects||[]), ...(n.coChangesWith||[])]) { linkedSet.add(n.id); linkedSet.add(x); }
+    }
+    const isolated = fNodesHe.length ? (fNodesHe.length - linkedSet.size) : 0;
+    out.featureGraph = {
+      total: fNodesHe.length,
+      edges: edgeCount,
+      isolated: Math.max(0, isolated),
+      summary: `F${fNodesHe.length}/E${edgeCount}${isolated > 0 ? `/iso${isolated}` : ''}`
+    };
+  } catch { out.featureGraph = { error: 'featureGraph 점검 실패' }; }
   // 6) issues 요약 (사용자 글로벌 룰 가시화)
   const issues = [];
   if (out.checks.drift?.level && !/healthy/.test(out.checks.drift.level)) issues.push(`drift ${out.checks.drift.level}`);

package/package.json

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