leerness 1.9.389 → 1.9.391

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 1.9.391 — 2026-06-06 — UR-0025 큰 핸들러 모듈화 3번째: feature → lib/feature.js (DI)
+
+**🧩 세 번째 핸들러 모듈 — feature add/link/impact/list/show 를 lib/feature.js 로 분리. 1.9.390 순수 코어 토대 위에 완성.**
+
+### 배경 (UR-0025, 사용자 승인 모듈화)
+migrate(1.9.388)/team(1.9.389) 에 이어 세 번째. 1.9.390 에서 feature-graph 순수 코어를 pure-utils 로 뺀 덕에 이제 핸들러를 깨끗이 분리 가능.
+
+### 구현
+1. **lib/feature.js 신규**: 5 핸들러(add/link/impact/list/show) 이전.
+   - 직접 require: `./io`(absRoot/log/ok/warn/fail) · `./pure-utils`(_nextFeatureId/_featureImpactBfs).
+   - **DI 주입**: _ensureFeatureGraph · _readFeatureGraph · _writeFeatureGraph(feature-graph I/O 헬퍼) · arg · has.
+2. **_featureImpactBfs → pure-utils**: 영향 BFS(affects/co-changes transitive + depends-on 역방향)는 순수 + handoff(8613)/audit(19302)도 공유 → pure-utils 로 이동, harness+lib 양쪽 import.
+3. **I/O 헬퍼는 harness 유지**: _readFeatureGraph(7+곳 공유) 등은 그대로, deps 로 주입.
+4. **harness thin wrapper**: _featureDeps() 구성 후 5 wrapper 위임. dispatch·MCP·동작·출력 무변경.
+
+### 검증 (회귀 0)
+- **selftest 136→137 PASS** (lib/feature 5 exports + _featureImpactBfs reference-equality + BFS 동작 + 위임 와이어 + lib 본문 이동 교차참조 + behavioral list --json).
+- **E2E 332 유지 PASS** (feature add/link/impact/list/show + 공유 _featureImpactBfs(handoff/audit) 회귀). 락 flake 시 재실행.
+- 실측: add(depends-on)·link(affects)·impact(transitive)·list·show(--json)·에러(BADID exit1)·handoff(공유 BFS) 보존.
+
+## 1.9.390 — 2026-06-06 — UR-0025 모듈화: feature-graph 순수 코어 → pure-utils (feature 핸들러 분리 토대)
+
+**🧩 feature-graph 의 순수 로직(템플릿/파서/ID/블록 렌더)을 lib/pure-utils.js 로 분리 — 가장 많이 공유되는 서브시스템의 핵심을 단일출처·테스트 가능화.**
+
+### 배경 (UR-0025, 사용자 승인 모듈화)
+migrate(1.9.388)/team(1.9.389) 핸들러를 lib 모듈로 뺐다. feature 서브시스템도 후보지만, `_readFeatureGraph` 가 audit/health/handoff 등 **7+곳에서 공유**돼 핸들러를 통째로 옮기기 전에 순수 코어부터 분리하는 게 안전(lib/io.js 토대를 먼저 만든 것과 동일 순서).
+
+### 구현
+1. **pure-utils 로 순수 4종 이전**: `_featureGraphTemplate`(템플릿) · `_parseFeatureGraph`(MD→nodes) · `_nextFeatureId`(다음 F-id) · `_featureBlock`(node→MD). 모두 I/O 없음.
+2. **I/O 헬퍼는 harness 유지**: `_readFeatureGraph`(7+곳 공유) · `_writeFeatureGraph` · `_ensureFeatureGraph` · `featureGraphPath` — 이제 pure-utils 의 순수 함수를 import 해 사용.
+3. harness 인라인 정의 제거 + import. 호출부·동작·출력 무변경.
+
+### 검증 (회귀 0)
+- **selftest 135→136 PASS** (reference-equality 4종 + 템플릿/파서/nextId 동작 + `_featureBlock`→`_parseFeatureGraph` round-trip + 인라인 제거 확인).
+- **E2E 332 유지 PASS** (feature add/link/impact/list/show + 공유 _readFeatureGraph(audit/health/handoff) 회귀). 락 flake 시 재실행.
+- 실측: add(F-0001/F-0002)·link(affects)·impact(transitive)·list(--json)·health(featureGraph) 보존.
+
 ## 1.9.389 — 2026-06-06 — UR-0025 큰 핸들러 모듈화 2번째: teamCmd → lib/team.js (DI)
 
 **🧩 두 번째 핸들러 모듈 추출 — team 서브시스템(list/add/show/remove/preview/deploy)을 lib/team.js 로 분리. migrate(1.9.388)에서 확립한 DI 패턴 재사용.**

package/README.md

@@ -3,7 +3,7 @@
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.389-green)]() [![tests](https://img.shields.io/badge/e2e-332%2F332-success)]() [![selftest](https://img.shields.io/badge/selftest-135-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-85-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![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.391-green)]() [![tests](https://img.shields.io/badge/e2e-332%2F332-success)]() [![selftest](https://img.shields.io/badge/selftest-137-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-85-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.389 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.391 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -525,7 +525,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.389는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.9.391는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.389는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.9.389)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.391)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -584,6 +584,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.9.389: 2026-06-06
+Last synced by Leerness v1.9.391: 2026-06-06
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -23,13 +23,14 @@ const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _merg
   _personaSummaries, _translate,
   _decisionsFromMd, _renderDecisionsMd, _renderLessonsMd,
   _withBuiltinSource, _esc, _roadmapTokenStyles, _parseSkillMd,
-  _migrationGuideText, _parseContractSpec, _gitignoreMatch } = require('../lib/pure-utils');  // 1.9.318~386 (UR-0025/0053/0075/0086/0087): 순수 유틸 모듈 분리
+  _migrationGuideText, _parseContractSpec, _gitignoreMatch,
+  _featureGraphTemplate, _parseFeatureGraph, _nextFeatureId, _featureBlock, _featureImpactBfs } = require('../lib/pure-utils');  // 1.9.318~391 (UR-0025/0053/0075/0086/0087): 순수 유틸 모듈 분리
 // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
 const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS, BUILTIN_CATALOG, ROADMAP_STATUS_LABEL, ROADMAP_STATUS_COLOR, SECRET_PATTERNS, MERGE_OVERWRITE_FILES, MINIMAL_SKIP_KEYS, REQUIRED_WORKSPACE_FILES, KEYWORD_STOPWORDS, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344/368/369 (UR-0025): catalog 분리 (MERGE_OVERWRITE_FILES/MINIMAL_SKIP_KEYS 포함)
 
-const VERSION = '1.9.389';
+const VERSION = '1.9.391';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2992,6 +2993,8 @@ function _selfTestCases() {
     { name: 'UR-0088 5th외부평가 일관성: incident/runs list 빈 케이스 --json 구조화 (1.9.387)', run: () => { if (typeof incidentListCmd !== 'function' || typeof runsListCmd !== 'function') return false; const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_lj_')); const save = process.argv; const _w = process.stdout.write; let io = '', ro = ''; try { fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true }); process.argv = ['node', 'h', 'incident', 'list', '--json']; process.stdout.write = s => { io += s; return true; }; incidentListCmd(tmp); process.stdout.write = _w; process.argv = ['node', 'h', 'runs', 'list', '--json']; process.stdout.write = s => { ro += s; return true; }; runsListCmd(tmp); } catch {} finally { process.stdout.write = _w; process.argv = save; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } let ij, rj; try { ij = JSON.parse(io); rj = JSON.parse(ro); } catch {} return !!ij && ij.total === 0 && Array.isArray(ij.items) && !!rj && rj.total === 0 && Array.isArray(rj.items); } },
     { name: 'UR-0025 큰핸들러 모듈화: migrate audit/apply/plan → lib/migrate.js + DI 위임 + 동작 (1.9.388)', run: () => { const m = require('../lib/migrate'); const expOk = typeof m.migrateAuditCmd === 'function' && typeof m.migrateApplyCmd === 'function' && typeof m.migratePlanCmd === 'function'; const src = read(__filename); const delegated = src.includes("require('../lib/migrate')") && src.includes('_migrate.migrateAuditCmd(root, opts, _migrateDeps())') && src.includes('_migrate.migratePlanCmd(root, opts, _migrateDeps())'); const movedToLib = read(path.join(path.dirname(__filename), '..', 'lib', 'migrate.js')).includes('leerness-plan-'); let behavOk = false; const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_mig_')); const save = process.argv; const _w = process.stdout.write; let out = ''; try { fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true }); fs.writeFileSync(path.join(tmp, '.harness', 'HARNESS_VERSION'), VERSION); process.argv = ['node', 'h', 'migrate', 'audit', tmp, '--json']; process.stdout.write = s => { out += s; return true; }; migrateAuditCmd(tmp, { json: true }); } catch {} finally { process.stdout.write = _w; process.argv = save; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } try { const j = JSON.parse(out); behavOk = j.version === VERSION && typeof j.willChange === 'number' && Array.isArray(j.findings); } catch {} return expOk && delegated && movedToLib && behavOk; } },
     { name: 'UR-0025 큰핸들러 모듈화: teamCmd → lib/team.js + DI 위임 + 동작 (1.9.389)', run: () => { const m = require('../lib/team'); const expOk = typeof m.teamCmd === 'function'; const src = read(__filename); const delegated = src.includes("require('../lib/team')") && src.includes('_team.teamCmd(root, sub, id, opts,'); const teamSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'team.js')); const movedToLib = teamSrc.includes("require('./pure-utils')") && teamSrc.includes('_teamDeployGate') && teamSrc.includes('알 수 없는 team 하위명령'); let behavOk = false; const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_tm_')); const save = process.argv; const _w = process.stdout.write; let out = ''; try { fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true }); process.argv = ['node', 'h', 'team', 'list', '--json']; process.stdout.write = s => { out += s; return true; }; teamCmd(tmp, 'list', undefined, { json: true }); } catch {} finally { process.stdout.write = _w; process.argv = save; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } try { const j = JSON.parse(out); behavOk = j.version === VERSION && j.count === 0 && Array.isArray(j.teams); } catch {} return expOk && delegated && movedToLib && behavOk; } },
+    { name: 'UR-0025: feature-graph 순수 코어(_featureGraphTemplate/_parseFeatureGraph/_nextFeatureId/_featureBlock) → pure-utils + round-trip (1.9.390)', run: () => { const m = require('../lib/pure-utils'); const refOk = m._parseFeatureGraph === _parseFeatureGraph && m._featureGraphTemplate === _featureGraphTemplate && m._nextFeatureId === _nextFeatureId && m._featureBlock === _featureBlock; const tmpl = m._featureGraphTemplate(); const tmplOk = tmpl.includes('Feature Graph') && tmpl.includes('## Nodes'); const nodes = m._parseFeatureGraph('## F-0001 Auth\n- depends-on: F-0002\n- affects: F-0003\n- files: a.js\n'); const parseOk = nodes.length === 1 && nodes[0].id === 'F-0001' && nodes[0].title === 'Auth' && nodes[0].dependsOn[0] === 'F-0002' && nodes[0].affects[0] === 'F-0003' && nodes[0].files[0] === 'a.js'; const idOk = m._nextFeatureId(nodes) === 'F-0002'; const rt = m._parseFeatureGraph(m._featureBlock(nodes[0])); const rtOk = rt.length === 1 && rt[0].id === 'F-0001' && rt[0].dependsOn[0] === 'F-0002'; const src = read(__filename); const moved = src.includes("require('../lib/pure-utils')") && !/^function _parseFeatureGraph\(text\) \{/m.test(src) && !/^function _featureBlock\(node\) \{/m.test(src); return refOk && tmplOk && parseOk && idOk && rtOk && moved; } },
+    { name: 'UR-0025 큰핸들러 모듈화: feature add/link/impact/list/show → lib/feature.js + DI + _featureImpactBfs pure 공유 (1.9.391)', run: () => { const m = require('../lib/feature'); const p = require('../lib/pure-utils'); const expOk = ['featureAddCmd', 'featureLinkCmd', 'featureImpactCmd', 'featureListCmd', 'featureShowCmd'].every(k => typeof m[k] === 'function'); const bfsRefOk = p._featureImpactBfs === _featureImpactBfs; const nodes = [{ id: 'F-0001', title: 'A', affects: ['F-0002'], dependsOn: [], coChangesWith: [] }, { id: 'F-0002', title: 'B', affects: [], dependsOn: [], coChangesWith: [] }]; const r = p._featureImpactBfs(nodes, 'F-0001'); const bfsWork = r.length === 1 && r[0].id === 'F-0002' && r[0].via === 'affects'; const src = read(__filename); const delegated = src.includes("require('../lib/feature')") && src.includes('_feature.featureImpactCmd(root, fromId, _featureDeps())'); const featSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'feature.js')); const movedToLib = featSrc.includes("require('./pure-utils')") && featSrc.includes('feature added:'); let behavOk = false; const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_ft_')); const save = process.argv; const _w = process.stdout.write; let out = ''; try { fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true }); process.argv = ['node', 'h', 'feature', 'list', '--json']; process.stdout.write = s => { out += s; return true; }; featureListCmd(tmp); } catch {} finally { process.stdout.write = _w; process.argv = save; try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } try { const j = JSON.parse(out); behavOk = j.total === 0 && Array.isArray(j.features); } catch {} return expOk && bfsRefOk && bfsWork && delegated && movedToLib && behavOk; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -14505,61 +14508,6 @@ function lessonsCmd(root) {
 //   - tests: tests/foo.test.ts
 //   - notes: 자유 메모
 function featureGraphPath(root) { return path.join(absRoot(root), '.harness', 'feature-graph.md'); }
-function _featureGraphTemplate() {
-  return `# Feature Graph (1.9.141)\n\n` +
-    `> **목적**: 각 기능의 인과관계를 정확히 정리해서 코드 작성 전 영향 범위를 자동 추적.\n` +
-    `> 신규 기능 추가, 데이터 형식 변경, 외부 API 매칭 작업 전 \`leerness feature impact <id>\`로 확인.\n` +
-    `> handoff가 현재 task 키워드로 자동 매칭해서 영향받는 feature 목록을 회수.\n\n` +
-    `## How to use\n\n` +
-    `\`\`\`bash\n` +
-    `leerness feature add "User Auth"                           # F-0001 자동 부여\n` +
-    `leerness feature link F-0002 --depends-on F-0001           # 의존 관계\n` +
-    `leerness feature link F-0001 --affects F-0002,F-0005        # 영향 관계 (다수)\n` +
-    `leerness feature link F-0001 --co-changes-with F-0011       # 함께 변해야 하는 기능\n` +
-    `leerness feature impact F-0001                              # 영향받는 전체 (transitive)\n` +
-    `leerness feature list --json                                # 그래프 JSON\n` +
-    `leerness feature show F-0001                                # 단일 상세\n` +
-    `\`\`\`\n\n` +
-    `## Nodes\n\n`;
-}
-function _parseFeatureGraph(text) {
-  if (!text) return [];
-  const nodes = [];
-  const re = /^## (F-\d{4})\s+(.+?)\s*$/gm;
-  const positions = [];
-  let m;
-  while ((m = re.exec(text)) !== null) positions.push({ id: m[1], title: m[2], start: m.index });
-  for (let i = 0; i < positions.length; i++) {
-    const start = positions[i].start;
-    const end = i + 1 < positions.length ? positions[i + 1].start : text.length;
-    const block = text.slice(start, end);
-    const parseField = (key) => {
-      // 1.9.141 fix: \s 은 \n 도 포함하므로 [ \t]* 로 newline 비포함 horizontal whitespace 만 매칭
-      const r = new RegExp(`^- ${key}:[ \\t]*(.*?)$`, 'mi');
-      const mm = block.match(r);
-      return mm ? mm[1].trim() : '';
-    };
-    const parseList = (key) => {
-      const v = parseField(key);
-      if (!v) return [];
-      return v.split(/[,\s]+/).map(s => s.trim()).filter(Boolean);
-    };
-    nodes.push({
-      id: positions[i].id,
-      title: positions[i].title,
-      dependsOn: parseList('depends-on'),
-      affects: parseList('affects'),
-      coChangesWith: parseList('co-changes-with'),
-      files: parseList('files'),
-      input: parseField('input'),
-      output: parseField('output'),
-      errorModes: parseList('error-modes'),
-      tests: parseList('tests'),
-      notes: parseField('notes')
-    });
-  }
-  return nodes;
-}
 function _readFeatureGraph(root) {
   const p = featureGraphPath(root);
   if (!exists(p)) return { nodes: [], text: '' };
@@ -14571,157 +14519,21 @@ function _ensureFeatureGraph(root) {
   if (!exists(p)) writeUtf8(p, _featureGraphTemplate());
   return p;
 }
-function _nextFeatureId(nodes) {
-  const used = new Set(nodes.map(n => parseInt(n.id.slice(2), 10)));
-  let n = 1; while (used.has(n)) n++;
-  return 'F-' + String(n).padStart(4, '0');
-}
-function _featureBlock(node) {
-  return `## ${node.id} ${node.title}\n` +
-    `- depends-on: ${(node.dependsOn || []).join(', ')}\n` +
-    `- affects: ${(node.affects || []).join(', ')}\n` +
-    `- co-changes-with: ${(node.coChangesWith || []).join(', ')}\n` +
-    `- files: ${(node.files || []).join(', ')}\n` +
-    `- input: ${node.input || ''}\n` +
-    `- output: ${node.output || ''}\n` +
-    `- error-modes: ${(node.errorModes || []).join(', ')}\n` +
-    `- tests: ${(node.tests || []).join(', ')}\n` +
-    `- notes: ${node.notes || ''}\n\n`;
-}
 function _writeFeatureGraph(root, nodes) {
   const p = _ensureFeatureGraph(root);
   const header = _featureGraphTemplate();
   const body = nodes.map(_featureBlock).join('');
   writeUtf8(p, header + body);
 }
-function featureAddCmd(root, title) {
-  root = absRoot(root);
-  if (!title) return fail('feature add: title 필요 — leerness feature add "<title>"');
-  _ensureFeatureGraph(root);
-  const { nodes } = _readFeatureGraph(root);
-  if (nodes.some(n => n.title.toLowerCase() === title.toLowerCase())) {
-    return warn(`이미 존재: "${title}"`);
-  }
-  const id = _nextFeatureId(nodes);
-  const node = {
-    id, title,
-    dependsOn: [], affects: [], coChangesWith: [],
-    files: [], input: '', output: '', errorModes: [], tests: [], notes: ''
-  };
-  // 옵션 인자 — 한 번에 의존/영향 등록 가능
-  const depends = arg('--depends-on', '');
-  const affects = arg('--affects', '');
-  const coChanges = arg('--co-changes-with', '');
-  const files = arg('--files', '');
-  if (depends) node.dependsOn = depends.split(/[,\s]+/).filter(Boolean);
-  if (affects) node.affects = affects.split(/[,\s]+/).filter(Boolean);
-  if (coChanges) node.coChangesWith = coChanges.split(/[,\s]+/).filter(Boolean);
-  if (files) node.files = files.split(/[,\s]+/).filter(Boolean);
-  nodes.push(node);
-  _writeFeatureGraph(root, nodes);
-  ok(`feature added: ${id} · ${title}`);
-}
-function featureLinkCmd(root, fromId) {
-  root = absRoot(root);
-  if (!fromId || !/^F-\d{4}$/.test(fromId)) return fail('feature link: 첫 인자는 F-XXXX 형식 ID');
-  const { nodes } = _readFeatureGraph(root);
-  const node = nodes.find(n => n.id === fromId);
-  if (!node) return fail(`feature ${fromId} 없음 — feature add 먼저`);
-  const dep = arg('--depends-on', '');
-  const aff = arg('--affects', '');
-  const co = arg('--co-changes-with', '');
-  let changes = 0;
-  if (dep) { const ids = dep.split(/[,\s]+/).filter(Boolean); for (const id of ids) if (!node.dependsOn.includes(id)) { node.dependsOn.push(id); changes++; } }
-  if (aff) { const ids = aff.split(/[,\s]+/).filter(Boolean); for (const id of ids) if (!node.affects.includes(id)) { node.affects.push(id); changes++; } }
-  if (co)  { const ids =  co.split(/[,\s]+/).filter(Boolean); for (const id of ids) if (!node.coChangesWith.includes(id)) { node.coChangesWith.push(id); changes++; } }
-  if (!changes) return warn('변경 없음 — --depends-on / --affects / --co-changes-with 중 하나 이상 지정');
-  _writeFeatureGraph(root, nodes);
-  ok(`feature ${fromId} 링크 ${changes}건 추가`);
-}
-function _featureImpactBfs(nodes, startId) {
-  // affects + co-changes-with 양방향 transitive closure
-  const byId = new Map(nodes.map(n => [n.id, n]));
-  const visited = new Set();
-  const queue = [{ id: startId, depth: 0, via: 'self' }];
-  const result = [];
-  while (queue.length) {
-    const cur = queue.shift();
-    if (visited.has(cur.id)) continue;
-    visited.add(cur.id);
-    const node = byId.get(cur.id);
-    if (!node) continue;
-    if (cur.depth > 0) result.push({ id: cur.id, title: node.title, depth: cur.depth, via: cur.via, files: node.files, errorModes: node.errorModes });
-    for (const next of node.affects || []) queue.push({ id: next, depth: cur.depth + 1, via: 'affects' });
-    for (const next of node.coChangesWith || []) queue.push({ id: next, depth: cur.depth + 1, via: 'co-changes-with' });
-  }
-  // 역방향: 이 feature에 depends-on 하는 노드도 영향받음
-  for (const n of nodes) {
-    if (visited.has(n.id)) continue;
-    if ((n.dependsOn || []).includes(startId)) {
-      result.push({ id: n.id, title: n.title, depth: 1, via: 'depends-on(reverse)', files: n.files, errorModes: n.errorModes });
-      visited.add(n.id);
-    }
-  }
-  return result;
-}
-function featureImpactCmd(root, fromId) {
-  root = absRoot(root);
-  if (!fromId || !/^F-\d{4}$/.test(fromId)) return fail('feature impact: F-XXXX ID 필요');
-  const { nodes } = _readFeatureGraph(root);
-  const node = nodes.find(n => n.id === fromId);
-  if (!node) return fail(`feature ${fromId} 없음`);
-  const impacted = _featureImpactBfs(nodes, fromId);
-  if (has('--json')) {
-    log(JSON.stringify({ feature: { id: node.id, title: node.title }, total: impacted.length, impacted }, null, 2));
-    return;
-  }
-  log(`# Feature Impact: ${node.id} · ${node.title}`);
-  if (!impacted.length) { ok('영향받는 다른 feature 없음 (또는 link 미설정)'); return; }
-  log(`\n총 ${impacted.length} feature에 영향:\n`);
-  for (const it of impacted) {
-    log(`  ${it.id} · ${it.title}  [depth=${it.depth}, via=${it.via}]`);
-    if (it.files && it.files.length) log(`    files: ${it.files.join(', ')}`);
-    if (it.errorModes && it.errorModes.length) log(`    error-modes: ${it.errorModes.join(', ')}`);
-  }
-  log(`\n💡 코드 변경 전 위 ${impacted.length}개 feature의 테스트/계약 확인 권장`);
-}
-function featureListCmd(root) {
-  root = absRoot(root);
-  const { nodes } = _readFeatureGraph(root);
-  if (has('--json')) {
-    log(JSON.stringify({ total: nodes.length, features: nodes }, null, 2));
-    return;
-  }
-  log(`# Features (${nodes.length}개)`);
-  if (!nodes.length) {
-    log('  (없음) — leerness feature add "<title>"');
-    return;
-  }
-  for (const n of nodes) {
-    log(`  ${n.id} · ${n.title}`);
-    if (n.dependsOn.length) log(`    ↓ depends-on: ${n.dependsOn.join(', ')}`);
-    if (n.affects.length) log(`    → affects: ${n.affects.join(', ')}`);
-    if (n.coChangesWith.length) log(`    ↔ co-changes-with: ${n.coChangesWith.join(', ')}`);
-  }
-}
-function featureShowCmd(root, fromId) {
-  root = absRoot(root);
-  if (!fromId || !/^F-\d{4}$/.test(fromId)) return fail('feature show: F-XXXX ID 필요');
-  const { nodes } = _readFeatureGraph(root);
-  const node = nodes.find(n => n.id === fromId);
-  if (!node) return fail(`feature ${fromId} 없음`);
-  if (has('--json')) { log(JSON.stringify(node, null, 2)); return; }
-  log(`# ${node.id} · ${node.title}`);
-  log(`  depends-on:      ${node.dependsOn.join(', ') || '(없음)'}`);
-  log(`  affects:         ${node.affects.join(', ') || '(없음)'}`);
-  log(`  co-changes-with: ${node.coChangesWith.join(', ') || '(없음)'}`);
-  log(`  files:           ${node.files.join(', ') || '(없음)'}`);
-  log(`  input:           ${node.input || '(없음)'}`);
-  log(`  output:          ${node.output || '(없음)'}`);
-  log(`  error-modes:     ${node.errorModes.join(', ') || '(없음)'}`);
-  log(`  tests:           ${node.tests.join(', ') || '(없음)'}`);
-  log(`  notes:           ${node.notes || '(없음)'}`);
-}
+// 1.9.391 (UR-0025 큰 핸들러 모듈화 3번째): feature add/link/impact/list/show 핸들러를 lib/feature.js 로 분리.
+//   _featureImpactBfs 는 pure-utils 로 이동(handoff/audit 공유). feature-graph I/O 헬퍼(_readFeatureGraph 등)는 공유라 harness 유지+주입.
+const _feature = require('../lib/feature');
+function _featureDeps() { return { _ensureFeatureGraph, _readFeatureGraph, _writeFeatureGraph, arg, has }; }
+function featureAddCmd(root, title) { return _feature.featureAddCmd(root, title, _featureDeps()); }
+function featureLinkCmd(root, fromId) { return _feature.featureLinkCmd(root, fromId, _featureDeps()); }
+function featureImpactCmd(root, fromId) { return _feature.featureImpactCmd(root, fromId, _featureDeps()); }
+function featureListCmd(root) { return _feature.featureListCmd(root, _featureDeps()); }
+function featureShowCmd(root, fromId) { return _feature.featureShowCmd(root, fromId, _featureDeps()); }
 
 // ===== 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']);

package/lib/feature.js

@@ -0,0 +1,118 @@
+// lib/feature.js — feature-graph 핸들러 (add/link/impact/list/show).
+// 1.9.391 (UR-0025 큰 핸들러 모듈화 3번째): bin/harness.js 에서 feature 핸들러 분리.
+//   - I/O 프리미티브: ./io.  순수 로직: ./pure-utils(_nextFeatureId/_featureImpactBfs).
+//   - feature-graph I/O 헬퍼(_readFeatureGraph/_writeFeatureGraph/_ensureFeatureGraph)는 audit/health/handoff 등도 쓰는
+//     공유 함수라 harness 에 유지하고 deps 로 주입(DI). argv 파서 arg/has 도 주입.
+'use strict';
+const { absRoot, log, ok, warn, fail } = require('./io');
+const { _nextFeatureId, _featureImpactBfs } = require('./pure-utils');
+
+function featureAddCmd(root, title, deps = {}) {
+  const { _ensureFeatureGraph, _readFeatureGraph, _writeFeatureGraph, arg } = deps;
+  root = absRoot(root);
+  if (!title) return fail('feature add: title 필요 — leerness feature add "<title>"');
+  _ensureFeatureGraph(root);
+  const { nodes } = _readFeatureGraph(root);
+  if (nodes.some(n => n.title.toLowerCase() === title.toLowerCase())) {
+    return warn(`이미 존재: "${title}"`);
+  }
+  const id = _nextFeatureId(nodes);
+  const node = {
+    id, title,
+    dependsOn: [], affects: [], coChangesWith: [],
+    files: [], input: '', output: '', errorModes: [], tests: [], notes: ''
+  };
+  // 옵션 인자 — 한 번에 의존/영향 등록 가능
+  const depends = arg('--depends-on', '');
+  const affects = arg('--affects', '');
+  const coChanges = arg('--co-changes-with', '');
+  const files = arg('--files', '');
+  if (depends) node.dependsOn = depends.split(/[,\s]+/).filter(Boolean);
+  if (affects) node.affects = affects.split(/[,\s]+/).filter(Boolean);
+  if (coChanges) node.coChangesWith = coChanges.split(/[,\s]+/).filter(Boolean);
+  if (files) node.files = files.split(/[,\s]+/).filter(Boolean);
+  nodes.push(node);
+  _writeFeatureGraph(root, nodes);
+  ok(`feature added: ${id} · ${title}`);
+}
+function featureLinkCmd(root, fromId, deps = {}) {
+  const { _readFeatureGraph, _writeFeatureGraph, arg } = deps;
+  root = absRoot(root);
+  if (!fromId || !/^F-\d{4}$/.test(fromId)) return fail('feature link: 첫 인자는 F-XXXX 형식 ID');
+  const { nodes } = _readFeatureGraph(root);
+  const node = nodes.find(n => n.id === fromId);
+  if (!node) return fail(`feature ${fromId} 없음 — feature add 먼저`);
+  const dep = arg('--depends-on', '');
+  const aff = arg('--affects', '');
+  const co = arg('--co-changes-with', '');
+  let changes = 0;
+  if (dep) { const ids = dep.split(/[,\s]+/).filter(Boolean); for (const id of ids) if (!node.dependsOn.includes(id)) { node.dependsOn.push(id); changes++; } }
+  if (aff) { const ids = aff.split(/[,\s]+/).filter(Boolean); for (const id of ids) if (!node.affects.includes(id)) { node.affects.push(id); changes++; } }
+  if (co)  { const ids =  co.split(/[,\s]+/).filter(Boolean); for (const id of ids) if (!node.coChangesWith.includes(id)) { node.coChangesWith.push(id); changes++; } }
+  if (!changes) return warn('변경 없음 — --depends-on / --affects / --co-changes-with 중 하나 이상 지정');
+  _writeFeatureGraph(root, nodes);
+  ok(`feature ${fromId} 링크 ${changes}건 추가`);
+}
+function featureImpactCmd(root, fromId, deps = {}) {
+  const { _readFeatureGraph, has } = deps;
+  root = absRoot(root);
+  if (!fromId || !/^F-\d{4}$/.test(fromId)) return fail('feature impact: F-XXXX ID 필요');
+  const { nodes } = _readFeatureGraph(root);
+  const node = nodes.find(n => n.id === fromId);
+  if (!node) return fail(`feature ${fromId} 없음`);
+  const impacted = _featureImpactBfs(nodes, fromId);
+  if (has('--json')) {
+    log(JSON.stringify({ feature: { id: node.id, title: node.title }, total: impacted.length, impacted }, null, 2));
+    return;
+  }
+  log(`# Feature Impact: ${node.id} · ${node.title}`);
+  if (!impacted.length) { ok('영향받는 다른 feature 없음 (또는 link 미설정)'); return; }
+  log(`\n총 ${impacted.length} feature에 영향:\n`);
+  for (const it of impacted) {
+    log(`  ${it.id} · ${it.title}  [depth=${it.depth}, via=${it.via}]`);
+    if (it.files && it.files.length) log(`    files: ${it.files.join(', ')}`);
+    if (it.errorModes && it.errorModes.length) log(`    error-modes: ${it.errorModes.join(', ')}`);
+  }
+  log(`\n💡 코드 변경 전 위 ${impacted.length}개 feature의 테스트/계약 확인 권장`);
+}
+function featureListCmd(root, deps = {}) {
+  const { _readFeatureGraph, has } = deps;
+  root = absRoot(root);
+  const { nodes } = _readFeatureGraph(root);
+  if (has('--json')) {
+    log(JSON.stringify({ total: nodes.length, features: nodes }, null, 2));
+    return;
+  }
+  log(`# Features (${nodes.length}개)`);
+  if (!nodes.length) {
+    log('  (없음) — leerness feature add "<title>"');
+    return;
+  }
+  for (const n of nodes) {
+    log(`  ${n.id} · ${n.title}`);
+    if (n.dependsOn.length) log(`    ↓ depends-on: ${n.dependsOn.join(', ')}`);
+    if (n.affects.length) log(`    → affects: ${n.affects.join(', ')}`);
+    if (n.coChangesWith.length) log(`    ↔ co-changes-with: ${n.coChangesWith.join(', ')}`);
+  }
+}
+function featureShowCmd(root, fromId, deps = {}) {
+  const { _readFeatureGraph, has } = deps;
+  root = absRoot(root);
+  if (!fromId || !/^F-\d{4}$/.test(fromId)) return fail('feature show: F-XXXX ID 필요');
+  const { nodes } = _readFeatureGraph(root);
+  const node = nodes.find(n => n.id === fromId);
+  if (!node) return fail(`feature ${fromId} 없음`);
+  if (has('--json')) { log(JSON.stringify(node, null, 2)); return; }
+  log(`# ${node.id} · ${node.title}`);
+  log(`  depends-on:      ${node.dependsOn.join(', ') || '(없음)'}`);
+  log(`  affects:         ${node.affects.join(', ') || '(없음)'}`);
+  log(`  co-changes-with: ${node.coChangesWith.join(', ') || '(없음)'}`);
+  log(`  files:           ${node.files.join(', ') || '(없음)'}`);
+  log(`  input:           ${node.input || '(없음)'}`);
+  log(`  output:          ${node.output || '(없음)'}`);
+  log(`  error-modes:     ${node.errorModes.join(', ') || '(없음)'}`);
+  log(`  tests:           ${node.tests.join(', ') || '(없음)'}`);
+  log(`  notes:           ${node.notes || '(없음)'}`);
+}
+
+module.exports = { featureAddCmd, featureLinkCmd, featureImpactCmd, featureListCmd, featureShowCmd };

package/lib/pure-utils.js

@@ -929,7 +929,11 @@ module.exports = {
   // 1.9.385 (UR-0086, 5th외부평가): contract spec 순수 파서 (markdown bullet 함수 선언 감지)
   _parseContractSpec,
   // 1.9.386 (UR-0087, 5th외부평가): 간이 .gitignore 매칭 + glob (bare .env → .env.* 과잉보호 제거)
-  _gitignoreMatch, _globToRe
+  _gitignoreMatch, _globToRe,
+  // 1.9.390 (UR-0025): feature-graph 순수 코어 (템플릿/파서/ID/블록)
+  _featureGraphTemplate, _parseFeatureGraph, _nextFeatureId, _featureBlock,
+  // 1.9.391 (UR-0025): feature 영향 BFS (순수, 공유)
+  _featureImpactBfs
 };
 
 // 1.9.355 (UR-0075 Phase A): AI 에이전트용 크로스버전 마이그레이션 안전 워크플로 가이드 (순수 텍스트). 임시설치 + --path + 백업 + diff 검증.
@@ -1016,3 +1020,103 @@ function _gitignoreMatch(giText, fileRel) {
   }
   return false;
 }
+
+// 1.9.390 (UR-0025): feature-graph 순수 코어 — 템플릿/파서/ID/블록 렌더 (I/O 없음). harness 의 _readFeatureGraph/_writeFeatureGraph 가 사용.
+function _featureGraphTemplate() {
+  return `# Feature Graph (1.9.141)\n\n` +
+    `> **목적**: 각 기능의 인과관계를 정확히 정리해서 코드 작성 전 영향 범위를 자동 추적.\n` +
+    `> 신규 기능 추가, 데이터 형식 변경, 외부 API 매칭 작업 전 \`leerness feature impact <id>\`로 확인.\n` +
+    `> handoff가 현재 task 키워드로 자동 매칭해서 영향받는 feature 목록을 회수.\n\n` +
+    `## How to use\n\n` +
+    `\`\`\`bash\n` +
+    `leerness feature add "User Auth"                           # F-0001 자동 부여\n` +
+    `leerness feature link F-0002 --depends-on F-0001           # 의존 관계\n` +
+    `leerness feature link F-0001 --affects F-0002,F-0005        # 영향 관계 (다수)\n` +
+    `leerness feature link F-0001 --co-changes-with F-0011       # 함께 변해야 하는 기능\n` +
+    `leerness feature impact F-0001                              # 영향받는 전체 (transitive)\n` +
+    `leerness feature list --json                                # 그래프 JSON\n` +
+    `leerness feature show F-0001                                # 단일 상세\n` +
+    `\`\`\`\n\n` +
+    `## Nodes\n\n`;
+}
+function _parseFeatureGraph(text) {
+  if (!text) return [];
+  const nodes = [];
+  const re = /^## (F-\d{4})\s+(.+?)\s*$/gm;
+  const positions = [];
+  let m;
+  while ((m = re.exec(text)) !== null) positions.push({ id: m[1], title: m[2], start: m.index });
+  for (let i = 0; i < positions.length; i++) {
+    const start = positions[i].start;
+    const end = i + 1 < positions.length ? positions[i + 1].start : text.length;
+    const block = text.slice(start, end);
+    const parseField = (key) => {
+      // 1.9.141 fix: \s 은 \n 도 포함하므로 [ \t]* 로 newline 비포함 horizontal whitespace 만 매칭
+      const r = new RegExp(`^- ${key}:[ \\t]*(.*?)$`, 'mi');
+      const mm = block.match(r);
+      return mm ? mm[1].trim() : '';
+    };
+    const parseList = (key) => {
+      const v = parseField(key);
+      if (!v) return [];
+      return v.split(/[,\s]+/).map(s => s.trim()).filter(Boolean);
+    };
+    nodes.push({
+      id: positions[i].id,
+      title: positions[i].title,
+      dependsOn: parseList('depends-on'),
+      affects: parseList('affects'),
+      coChangesWith: parseList('co-changes-with'),
+      files: parseList('files'),
+      input: parseField('input'),
+      output: parseField('output'),
+      errorModes: parseList('error-modes'),
+      tests: parseList('tests'),
+      notes: parseField('notes')
+    });
+  }
+  return nodes;
+}
+function _nextFeatureId(nodes) {
+  const used = new Set(nodes.map(n => parseInt(n.id.slice(2), 10)));
+  let n = 1; while (used.has(n)) n++;
+  return 'F-' + String(n).padStart(4, '0');
+}
+function _featureBlock(node) {
+  return `## ${node.id} ${node.title}\n` +
+    `- depends-on: ${(node.dependsOn || []).join(', ')}\n` +
+    `- affects: ${(node.affects || []).join(', ')}\n` +
+    `- co-changes-with: ${(node.coChangesWith || []).join(', ')}\n` +
+    `- files: ${(node.files || []).join(', ')}\n` +
+    `- input: ${node.input || ''}\n` +
+    `- output: ${node.output || ''}\n` +
+    `- error-modes: ${(node.errorModes || []).join(', ')}\n` +
+    `- tests: ${(node.tests || []).join(', ')}\n` +
+    `- notes: ${node.notes || ''}\n\n`;
+}
+// 1.9.391 (UR-0025): feature 영향 BFS — affects + co-changes-with transitive + depends-on 역방향. 순수(nodes,startId→result). harness(handoff/audit)+lib/feature 공유.
+function _featureImpactBfs(nodes, startId) {
+  const byId = new Map(nodes.map(n => [n.id, n]));
+  const visited = new Set();
+  const queue = [{ id: startId, depth: 0, via: 'self' }];
+  const result = [];
+  while (queue.length) {
+    const cur = queue.shift();
+    if (visited.has(cur.id)) continue;
+    visited.add(cur.id);
+    const node = byId.get(cur.id);
+    if (!node) continue;
+    if (cur.depth > 0) result.push({ id: cur.id, title: node.title, depth: cur.depth, via: cur.via, files: node.files, errorModes: node.errorModes });
+    for (const next of node.affects || []) queue.push({ id: next, depth: cur.depth + 1, via: 'affects' });
+    for (const next of node.coChangesWith || []) queue.push({ id: next, depth: cur.depth + 1, via: 'co-changes-with' });
+  }
+  // 역방향: 이 feature에 depends-on 하는 노드도 영향받음
+  for (const n of nodes) {
+    if (visited.has(n.id)) continue;
+    if ((n.dependsOn || []).includes(startId)) {
+      result.push({ id: n.id, title: n.title, depth: 1, via: 'depends-on(reverse)', files: n.files, errorModes: n.errorModes });
+      visited.add(n.id);
+    }
+  }
+  return result;
+}

package/package.json

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