leerness 1.9.388 → 1.9.390

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 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 패턴 재사용.**
+
+### 배경 (UR-0025 큰 핸들러 모듈화, 사용자 승인)
+1.9.388 migrate 추출로 DI 패턴(io import + deps 주입)을 확립. 동일 패턴으로 두 번째 응집 핸들러 teamCmd(UR-0073, ~111줄, e2e 5건 보유)를 분리.
+
+### 구현
+1. **lib/team.js 신규**: teamCmd(6 서브명령) 이전.
+   - 직접 require: `./io`(absRoot/log/ok/warn/fail/now) · `./pure-utils`(_composeTeamPlan/_teamDeployGate) · `./analyzers`(_shellGuardAnalyze) · node child_process.
+   - **DI 주입**: VERSION · _loadTeams · _saveTeams · _detectShellCtx · arg · has(argv 파서).
+2. **_loadTeams/_saveTeams 는 harness 유지**: handoff team reminders(_teamHandoffReminders)도 쓰는 공유 함수 → harness 에 두고 주입만. (teamsJsonPath/teamsPath/_renderTeamsMd 도 harness 유지.)
+3. **harness thin wrapper**: deps 구성 후 위임. dispatch · 동작 · 출력 무변경.
+
+### 검증 (회귀 0)
+- **selftest 134→135 PASS** (lib/team export + 위임 와이어 + lib 본문 이동(pure-utils require/_teamDeployGate/하위명령) 교차참조 + behavioral list --json). 기존 1.9.371 케이스(_saveTeams/_loadTeams/_renderTeamsMd harness 유지)도 통과.
+- **E2E 332 유지 PASS** (team B(1.9.371/372/373/376/378) list/add/preview/deploy-gate/MCP 회귀가 CLI→wrapper→lib 경로 검증). 락 flake 시 재실행.
+- 실측: list/add/show/preview/deploy(dry-run·gated 이중게이트) + handoff team reminders(daily 팀 노출) 보존.
+
 ## 1.9.388 — 2026-06-06 — UR-0025 큰 핸들러 모듈화: migrate audit/apply/plan → lib/migrate.js (DI)
 
 **🧩 첫 실제 핸들러 모듈 추출 — migrate 서브시스템(audit/apply/plan)을 lib/migrate.js 로 분리(의존성 주입 ctx). lib/io.js 토대(1.9.382/383)의 첫 활용.**

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.388-green)]() [![tests](https://img.shields.io/badge/e2e-332%2F332-success)]() [![selftest](https://img.shields.io/badge/selftest-134-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.390-green)]() [![tests](https://img.shields.io/badge/e2e-332%2F332-success)]() [![selftest](https://img.shields.io/badge/selftest-136-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.388 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.390 하네스를 사용합니다. 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.388는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.9.390는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.388는 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.388)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.390)** · 매 라운드 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.388: 2026-06-06
+Last synced by Leerness v1.9.390: 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 } = require('../lib/pure-utils');  // 1.9.318~390 (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.388';
+const VERSION = '1.9.390';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2991,6 +2992,8 @@ function _selfTestCases() {
     { name: '5th외부평가/UR-0087: _gitignoreMatch git 일치(.env↛.env.bad) + env-family 스캔 (1.9.386)', run: () => { const m = require('../lib/pure-utils'); if (m._gitignoreMatch !== _gitignoreMatch) return false; const gm = _gitignoreMatch; const semOk = gm('.env', '.env') === true && gm('.env', '.env.bad') === false && gm('.env', '.env.local') === false && gm('.env.*', '.env.bad') === true && gm('.env*', '.env') === true && gm('*.pem', 'k.pem') === true && gm('src/', 'src/a.txt') === true; const src = read(__filename); const envFamilyScan = src.includes('const isEnvFamily =') && src.includes('!SCAN_TEXT_EXT.has(ext) && !isEnvFamily'); const delegated = src.includes('return _gitignoreMatch(gi, fileRel)'); return semOk && envFamilyScan && delegated; } },
     { 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: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -5785,114 +5788,10 @@ function _saveTeams(root, teams) {
   writeUtf8(teamsJsonPath(root), JSON.stringify(arr, null, 2) + '\n');
   writeUtf8(teamsPath(root), _renderTeamsMd(arr));
 }
-function teamCmd(root, sub, id, opts = {}) {
-  root = absRoot(root);
-  const json = opts.json || has('--json');
-  const teams = _loadTeams(root);
-  sub = sub || 'list';
-  if (sub === 'list') {
-    if (json) { log(JSON.stringify({ version: VERSION, root, count: teams.length, teams }, null, 2)); return; }
-    log(`# leerness team (1.9.371, UR-0073 Phase A) — 에이전트 팀 정의 (opt-in · 정의 전용)`);
-    if (!teams.length) { log('  (정의된 팀 없음) — leerness team add <id> --name "..." --purpose "..." --personas a,b --members claude,codex'); return; }
-    for (const t of teams) log(`  • ${t.id}${t.name ? ' — ' + t.name : ''}  [${t.status || 'active'}/${t.schedule || 'manual'}]  personas:${(t.personas || []).join('|') || '-'} members:${(t.members || []).join('|') || '-'}`);
-    log(`\n  ⓘ 정의 전용 — 자동 실행 없음. 실행(리뷰/배포/블로그)은 향후 opt-in 단계.`);
-    return;
-  }
-  if (sub === 'add') {
-    const teamId = String(id || '').toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^[.\-]+|[.\-]+$/g, '');
-    if (!teamId || teamId.includes('..')) { fail(`무효한 team id: "${id}" (영숫자/._- 만)`); return; }
-    if (teams.some(t => t.id === teamId)) { warn(`이미 존재: ${teamId} (제거 후 재정의: leerness team remove ${teamId})`); return; }
-    const splitCsv = v => (v && v !== true) ? String(v).split(',').map(s => s.trim()).filter(Boolean) : [];
-    const sched = arg('--schedule', 'manual');
-    const validSched = new Set(['manual', 'every-session', 'daily', 'weekly']);
-    const team = {
-      id: teamId,
-      name: arg('--name', '') === true ? '' : arg('--name', ''),
-      purpose: arg('--purpose', '') === true ? '' : arg('--purpose', ''),
-      personas: splitCsv(arg('--personas', null)),
-      members: splitCsv(arg('--members', null)),
-      schedule: validSched.has(sched) ? sched : 'manual',
-      deployCommand: arg('--deploy', '') === true ? '' : arg('--deploy', ''),  // 1.9.376 (Phase D): 사용자 설정 배포 명령 (실행은 게이트)
-      status: 'active',
-      createdAt: now()
-    };
-    teams.push(team);
-    _saveTeams(root, teams);
-    ok(`team 정의: ${teamId} (personas:${team.personas.length} members:${team.members.length} schedule:${team.schedule})`);
-    log(`  ⓘ 정의 전용 — 자동 실행 없음. 목록: leerness team list`);
-    return;
-  }
-  if (sub === 'show') {
-    const t = teams.find(x => x.id === id);
-    if (!t) { fail(`team 없음: ${id}`); return; }
-    if (json) { log(JSON.stringify(t, null, 2)); return; }
-    log(`# team ${t.id}`);
-    log(`  name: ${t.name || ''}`);
-    log(`  purpose: ${t.purpose || ''}`);
-    log(`  personas: ${(t.personas || []).join(', ') || '-'}`);
-    log(`  members: ${(t.members || []).join(', ') || '-'}`);
-    log(`  schedule: ${t.schedule || 'manual'}  ·  status: ${t.status || 'active'}`);
-    log(`  deploy: ${t.deployCommand || '-'}`);
-    return;
-  }
-  if (sub === 'remove') {
-    const before = teams.length;
-    const next = teams.filter(x => x.id !== id);
-    if (next.length === before) { warn(`team 없음: ${id}`); return; }
-    _saveTeams(root, next);
-    ok(`team 제거: ${id}`);
-    return;
-  }
-  // 1.9.372 (UR-0073 Phase B): team preview — dry-run 실행 계획 미리보기 (실제 dispatch/spawn/배포 없음).
-  if (sub === 'preview') {
-    const t = teams.find(x => x.id === id);
-    if (!t) { fail(`team 없음: ${id}`); return; }
-    const plan = _composeTeamPlan(t, arg('--task', null));
-    if (json) { log(JSON.stringify({ version: VERSION, dryRun: true, ...plan }, null, 2)); return; }
-    log(`# team preview ${t.id} (1.9.372, UR-0073 Phase B) — dry-run (실제 실행 없음)`);
-    log(`  task: ${plan.task}`);
-    log(`  schedule: ${plan.schedule}  ·  members: ${plan.memberCount}`);
-    if (!plan.steps.length) { warn('members 없음 — leerness team add <id> --members claude,codex 로 지정'); return; }
-    log(`  실행 계획 (미리보기 · 자동 실행 안 함):`);
-    for (const s of plan.steps) {
-      log(`    • ${s.member}${s.personas.length ? ' [' + s.personas.join(',') + ']' : ''}`);
-      log(`        ↳ ${s.suggestedCommand}`);
-    }
-    log(`\n  ⓘ dry-run — 실제 dispatch/배포 없음. 위 명령을 검토 후 직접 실행하거나, 향후 Phase C(스케줄)/D(배포)에서 게이트 적용.`);
-    return;
-  }
-  // 1.9.376 (UR-0073 Phase D): team deploy — 사용자 설정 deployCommand 실행. 안전: dry-run 기본 + --yes + LEERNESS_TEAM_DEPLOY=1 이중 게이트 + shell-guard.
-  if (sub === 'deploy') {
-    const t = teams.find(x => x.id === id);
-    if (!t) { fail(`team 없음: ${id}`); return; }
-    const gate = _teamDeployGate(t, { yes: has('--yes'), envOn: process.env.LEERNESS_TEAM_DEPLOY === '1' });
-    if (json) { log(JSON.stringify({ version: VERSION, teamId: t.id, ...gate }, null, 2)); if (gate.mode !== 'execute') return; }
-    if (gate.mode === 'no-command') { fail(`team '${t.id}' deployCommand 미설정 — leerness team add ${t.id} --deploy "<배포 명령>"`); return; }
-    if (gate.mode === 'dry-run') {
-      log(`# team deploy ${t.id} (1.9.376, UR-0073 Phase D) — dry-run (실행 없음)`);
-      log(`  배포 명령: ${gate.command}`);
-      log(`  ⓘ ${gate.message}`);
-      log(`  실행: LEERNESS_TEAM_DEPLOY=1 leerness team deploy ${t.id} --yes  (셸 호환성 점검 후 실행)`);
-      return;
-    }
-    if (gate.mode === 'gated') { fail(`${gate.message} — dry-run 으로 먼저 검토: leerness team deploy ${t.id}`); return; }
-    // execute: shell-guard 정적 점검(advisory) 후 spawn
-    try {
-      const ctx = _detectShellCtx();
-      const guard = _shellGuardAnalyze ? _shellGuardAnalyze(gate.command, ctx) : null;
-      if (guard && guard.findings && guard.findings.length) {
-        warn(`shell-guard 경고 ${guard.findings.length}건 (배포 명령): ${guard.findings.map(f => f.rule || f.kind || f).join(', ')}`);
-      }
-    } catch {}
-    log(`# team deploy ${t.id} — 실행 (LEERNESS_TEAM_DEPLOY=1 + --yes)`);
-    log(`  $ ${gate.command}`);
-    const r = cp.spawnSync(gate.command, { cwd: root, shell: true, stdio: 'inherit', timeout: 600000 });
-    if (r.status === 0) ok(`team deploy 완료: ${t.id} (exit 0)`);
-    else { fail(`team deploy 실패: ${t.id} (exit ${r.status})`); }
-    return;
-  }
-  fail(`알 수 없는 team 하위명령: ${sub} (list|add|show|remove|preview|deploy)`);
-}
+// 1.9.389 (UR-0025 큰 핸들러 모듈화 2번째): teamCmd 핸들러를 lib/team.js 로 분리.
+//   harness 는 deps(VERSION · 공유 저장 _loadTeams/_saveTeams · _detectShellCtx · argv 파서 arg/has)를 구성해 위임(thin wrapper). 호출부/동작 무변경.
+const _team = require('../lib/team');
+function teamCmd(root, sub, id, opts = {}) { return _team.teamCmd(root, sub, id, opts, { VERSION, _loadTeams, _saveTeams, _detectShellCtx, arg, has }); }
 
 // 1.9.112: 전용 lessons.md (Memory Write Surface 5번째)
 const lessonsPath = root => path.join(root, '.harness/lessons.md');
@@ -14608,61 +14507,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: '' };
@@ -14674,23 +14518,6 @@ 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();

package/lib/pure-utils.js

@@ -929,7 +929,9 @@ 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.355 (UR-0075 Phase A): AI 에이전트용 크로스버전 마이그레이션 안전 워크플로 가이드 (순수 텍스트). 임시설치 + --path + 백업 + diff 검증.
@@ -1016,3 +1018,77 @@ 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`;
+}

package/lib/team.js

@@ -0,0 +1,122 @@
+// lib/team.js — 에이전트 팀 정의 핸들러 (UR-0073: list/add/show/remove/preview/deploy).
+// 1.9.389 (UR-0025 큰 핸들러 모듈화 2번째): bin/harness.js 에서 teamCmd 분리.
+//   - I/O 프리미티브: ./io.  순수 로직: ./pure-utils(_composeTeamPlan/_teamDeployGate).  정적분석: ./analyzers(_shellGuardAnalyze).
+//   - harness 고유 의존(VERSION · 공유 저장 함수 _loadTeams/_saveTeams · _detectShellCtx · argv 파서 arg/has)은 deps 로 주입(DI).
+//   - _loadTeams/_saveTeams 는 handoff(team reminders)도 쓰는 공유 함수라 harness 에 유지하고 주입만 받음.
+'use strict';
+const cp = require('child_process');
+const { absRoot, log, ok, warn, fail, now } = require('./io');
+const { _composeTeamPlan, _teamDeployGate } = require('./pure-utils');
+const { _shellGuardAnalyze } = require('./analyzers');
+
+function teamCmd(root, sub, id, opts = {}, deps = {}) {
+  const { VERSION, _loadTeams, _saveTeams, _detectShellCtx, arg, has } = deps;
+  root = absRoot(root);
+  const json = opts.json || has('--json');
+  const teams = _loadTeams(root);
+  sub = sub || 'list';
+  if (sub === 'list') {
+    if (json) { log(JSON.stringify({ version: VERSION, root, count: teams.length, teams }, null, 2)); return; }
+    log(`# leerness team (1.9.371, UR-0073 Phase A) — 에이전트 팀 정의 (opt-in · 정의 전용)`);
+    if (!teams.length) { log('  (정의된 팀 없음) — leerness team add <id> --name "..." --purpose "..." --personas a,b --members claude,codex'); return; }
+    for (const t of teams) log(`  • ${t.id}${t.name ? ' — ' + t.name : ''}  [${t.status || 'active'}/${t.schedule || 'manual'}]  personas:${(t.personas || []).join('|') || '-'} members:${(t.members || []).join('|') || '-'}`);
+    log(`\n  ⓘ 정의 전용 — 자동 실행 없음. 실행(리뷰/배포/블로그)은 향후 opt-in 단계.`);
+    return;
+  }
+  if (sub === 'add') {
+    const teamId = String(id || '').toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^[.\-]+|[.\-]+$/g, '');
+    if (!teamId || teamId.includes('..')) { fail(`무효한 team id: "${id}" (영숫자/._- 만)`); return; }
+    if (teams.some(t => t.id === teamId)) { warn(`이미 존재: ${teamId} (제거 후 재정의: leerness team remove ${teamId})`); return; }
+    const splitCsv = v => (v && v !== true) ? String(v).split(',').map(s => s.trim()).filter(Boolean) : [];
+    const sched = arg('--schedule', 'manual');
+    const validSched = new Set(['manual', 'every-session', 'daily', 'weekly']);
+    const team = {
+      id: teamId,
+      name: arg('--name', '') === true ? '' : arg('--name', ''),
+      purpose: arg('--purpose', '') === true ? '' : arg('--purpose', ''),
+      personas: splitCsv(arg('--personas', null)),
+      members: splitCsv(arg('--members', null)),
+      schedule: validSched.has(sched) ? sched : 'manual',
+      deployCommand: arg('--deploy', '') === true ? '' : arg('--deploy', ''),  // 1.9.376 (Phase D): 사용자 설정 배포 명령 (실행은 게이트)
+      status: 'active',
+      createdAt: now()
+    };
+    teams.push(team);
+    _saveTeams(root, teams);
+    ok(`team 정의: ${teamId} (personas:${team.personas.length} members:${team.members.length} schedule:${team.schedule})`);
+    log(`  ⓘ 정의 전용 — 자동 실행 없음. 목록: leerness team list`);
+    return;
+  }
+  if (sub === 'show') {
+    const t = teams.find(x => x.id === id);
+    if (!t) { fail(`team 없음: ${id}`); return; }
+    if (json) { log(JSON.stringify(t, null, 2)); return; }
+    log(`# team ${t.id}`);
+    log(`  name: ${t.name || ''}`);
+    log(`  purpose: ${t.purpose || ''}`);
+    log(`  personas: ${(t.personas || []).join(', ') || '-'}`);
+    log(`  members: ${(t.members || []).join(', ') || '-'}`);
+    log(`  schedule: ${t.schedule || 'manual'}  ·  status: ${t.status || 'active'}`);
+    log(`  deploy: ${t.deployCommand || '-'}`);
+    return;
+  }
+  if (sub === 'remove') {
+    const before = teams.length;
+    const next = teams.filter(x => x.id !== id);
+    if (next.length === before) { warn(`team 없음: ${id}`); return; }
+    _saveTeams(root, next);
+    ok(`team 제거: ${id}`);
+    return;
+  }
+  // 1.9.372 (UR-0073 Phase B): team preview — dry-run 실행 계획 미리보기 (실제 dispatch/spawn/배포 없음).
+  if (sub === 'preview') {
+    const t = teams.find(x => x.id === id);
+    if (!t) { fail(`team 없음: ${id}`); return; }
+    const plan = _composeTeamPlan(t, arg('--task', null));
+    if (json) { log(JSON.stringify({ version: VERSION, dryRun: true, ...plan }, null, 2)); return; }
+    log(`# team preview ${t.id} (1.9.372, UR-0073 Phase B) — dry-run (실제 실행 없음)`);
+    log(`  task: ${plan.task}`);
+    log(`  schedule: ${plan.schedule}  ·  members: ${plan.memberCount}`);
+    if (!plan.steps.length) { warn('members 없음 — leerness team add <id> --members claude,codex 로 지정'); return; }
+    log(`  실행 계획 (미리보기 · 자동 실행 안 함):`);
+    for (const s of plan.steps) {
+      log(`    • ${s.member}${s.personas.length ? ' [' + s.personas.join(',') + ']' : ''}`);
+      log(`        ↳ ${s.suggestedCommand}`);
+    }
+    log(`\n  ⓘ dry-run — 실제 dispatch/배포 없음. 위 명령을 검토 후 직접 실행하거나, 향후 Phase C(스케줄)/D(배포)에서 게이트 적용.`);
+    return;
+  }
+  // 1.9.376 (UR-0073 Phase D): team deploy — 사용자 설정 deployCommand 실행. 안전: dry-run 기본 + --yes + LEERNESS_TEAM_DEPLOY=1 이중 게이트 + shell-guard.
+  if (sub === 'deploy') {
+    const t = teams.find(x => x.id === id);
+    if (!t) { fail(`team 없음: ${id}`); return; }
+    const gate = _teamDeployGate(t, { yes: has('--yes'), envOn: process.env.LEERNESS_TEAM_DEPLOY === '1' });
+    if (json) { log(JSON.stringify({ version: VERSION, teamId: t.id, ...gate }, null, 2)); if (gate.mode !== 'execute') return; }
+    if (gate.mode === 'no-command') { fail(`team '${t.id}' deployCommand 미설정 — leerness team add ${t.id} --deploy "<배포 명령>"`); return; }
+    if (gate.mode === 'dry-run') {
+      log(`# team deploy ${t.id} (1.9.376, UR-0073 Phase D) — dry-run (실행 없음)`);
+      log(`  배포 명령: ${gate.command}`);
+      log(`  ⓘ ${gate.message}`);
+      log(`  실행: LEERNESS_TEAM_DEPLOY=1 leerness team deploy ${t.id} --yes  (셸 호환성 점검 후 실행)`);
+      return;
+    }
+    if (gate.mode === 'gated') { fail(`${gate.message} — dry-run 으로 먼저 검토: leerness team deploy ${t.id}`); return; }
+    // execute: shell-guard 정적 점검(advisory) 후 spawn
+    try {
+      const ctx = _detectShellCtx();
+      const guard = _shellGuardAnalyze ? _shellGuardAnalyze(gate.command, ctx) : null;
+      if (guard && guard.findings && guard.findings.length) {
+        warn(`shell-guard 경고 ${guard.findings.length}건 (배포 명령): ${guard.findings.map(f => f.rule || f.kind || f).join(', ')}`);
+      }
+    } catch {}
+    log(`# team deploy ${t.id} — 실행 (LEERNESS_TEAM_DEPLOY=1 + --yes)`);
+    log(`  $ ${gate.command}`);
+    const r = cp.spawnSync(gate.command, { cwd: root, shell: true, stdio: 'inherit', timeout: 600000 });
+    if (r.status === 0) ok(`team deploy 완료: ${t.id} (exit 0)`);
+    else { fail(`team deploy 실패: ${t.id} (exit ${r.status})`); }
+    return;
+  }
+  fail(`알 수 없는 team 하위명령: ${sub} (list|add|show|remove|preview|deploy)`);
+}
+
+module.exports = { teamCmd };

package/package.json

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