leerness 1.9.370 → 1.9.372

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 1.9.372 — 2026-06-06 — UR-0073 Phase B: team preview — dry-run 실행 계획 미리보기
+
+**🧩 정의된 팀의 작업을 실제 실행 없이 미리보기 — `leerness team preview`.** (UR-0073 Phase B, 안전 게이트: dry-run 전용)
+
+### 구현
+1. **`leerness team preview <id> [--task "..."]`** + `_composeTeamPlan(team, task)`(순수): 팀의 members × personas × task 로 **멤버별 dispatch 명령 문자열**을 생성. `--task` 미지정 시 팀 purpose 를 기본 작업으로.
+2. **dry-run 전용 안전**: 실제 spawn/dispatch/배포 **없음**, 파일 변경 0. 출력은 검토용 제안 명령(`leerness agents dispatch "..." --to <member>`)만. `--json` 은 `{ dryRun:true, task, steps:[{member,personas,dispatchPrompt,suggestedCommand}] }`.
+3. commands/help 에 preview 반영.
+
+### 검증 (회귀 0)
+- **selftest 117→118 PASS** (행위: `_composeTeamPlan` 멤버별 step/persona 주입/purpose 기본값/빈 members + 모듈 reference equality).
+- **E2E 317→318 PASS** (행위: team add→preview `--json`(dryRun true, steps 2, dispatch 명령) + preview 후 teams.json mtime 불변=파일변경 0).
+- 실측: preview 가 dispatch 계획만 출력, 실행/변경 없음.
+
+### UR-0073 로드맵: Phase A(정의) → **B(preview dry-run)** 완료. C(스케줄 트리거)/D(배포 통합)는 향후 opt-in 게이트.
+
+## 1.9.371 — 2026-06-06 — UR-0073 Phase A: 에이전트 팀 정의 레지스트리 (opt-in · 정의 전용)
+
+**🧩 페르소나 기반 에이전트 팀 비전 착수 — `leerness team` 정의 레지스트리.** (UR-0073 Phase A, 안정화 완료 후 opt-in 신규 비전)
+
+### 배경
+사용자 비전(UR-0073): 페르소나 기반 영속 에이전트 팀(리뷰/배포/블로그 팀)이 세션/주기적으로 자동 작업. 방향 설계대로 **코어 안정화 완료 후 opt-in 으로 착수**. Phase A 는 **정의 레지스트리(persistence layer)** 만 — 자동 실행은 향후 단계로 게이트.
+
+### 구현
+1. **`leerness team list|add|show|remove <id>`** + 옵션(`--name --purpose --personas a,b --members claude,codex --schedule manual|every-session|daily|weekly`).
+2. **canonical JSON 패턴**: `teams.json`(주) + `teams.md`(projection, `_renderTeamsMd` 순수 렌더러 → pure-utils). `_loadTeams`/`_saveTeams` I/O.
+3. **안전**: 정의 전용 — **자동 실행 없음**(메타데이터만). id 정규화(영숫자/._-, traversal sanitize). dedup. schedule 화이트리스트.
+4. **표면 정합(CV-7 규율)**: commands ops 카테고리 + help 등재.
+
+### 검증 (회귀 0)
+- **selftest 116→117 PASS** (행위: `_renderTeamsMd` 출력 + `_saveTeams`/`_loadTeams` round-trip + JSON/MD 생성).
+- **E2E 316→317 PASS** (행위: team add→list(--json count/personas/schedule)→canonical JSON+MD 생성→remove→count 0).
+- 실측: add/list/show/remove + teams.json/teams.md 생성 + id sanitize.
+
+### UR-0073 다단계 — Phase A(정의 레지스트리) 완료, 실행/스케줄/배포 단계는 향후 opt-in (open 유지).
+
 ## 1.9.370 — 2026-06-06 — UR-0025 모듈화: archive/skill-catalog 순수 파서 분리
 
 **🧩 순수 파서 2종을 lib/pure-utils 로 분리 — 인라인 ~65줄 제거.**

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.370-green)]() [![tests](https://img.shields.io/badge/e2e-316%2F316-success)]() [![selftest](https://img.shields.io/badge/selftest-116-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-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.372-green)]() [![tests](https://img.shields.io/badge/e2e-318%2F318-success)]() [![selftest](https://img.shields.io/badge/selftest-118-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-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.370 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.372 하네스를 사용합니다. 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.370는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
+Leerness v1.9.372는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.370는 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.370)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.372)** · 매 라운드 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.370: 2026-06-06
+Last synced by Leerness v1.9.372: 2026-06-06
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -7,7 +7,7 @@ const cp = require('child_process');
 const os = require('os');  // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
 const readline = require('readline');
 // 1.9.274 (UR-0025 1단계): 순수 유틸 함수 모듈 분리 (require-based, 비파괴). selftest 7종이 동작 검증.
-const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _parseSkillsValue, _parseArchiveBlocks, _parseSkillCatalog, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
+const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _parseSkillsValue, _parseArchiveBlocks, _parseSkillCatalog, _renderTeamsMd, _composeTeamPlan, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
   PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord,
   _htmlToText, _extractTitle, _extractLinks,
   _countDatedBlocks, _extractDecisionBlocks, _classifyIntent,
@@ -28,7 +28,7 @@ const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInG
 // 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, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344/368/369 (UR-0025): catalog 분리 (MERGE_OVERWRITE_FILES/MINIMAL_SKIP_KEYS 포함)
 
-const VERSION = '1.9.370';
+const VERSION = '1.9.372';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3007,6 +3007,8 @@ function _selfTestCases() {
     { name: 'UR-0025: _mergeReadmeSection/_managedMerge + MERGE_OVERWRITE_FILES 모듈 분리 + 행위 (1.9.368)', run: () => { const m = require('../lib/pure-utils'); const c = require('../lib/catalogs'); if (typeof _mergeReadmeSection !== 'function' || typeof _managedMerge !== 'function') return false; const moved = m._mergeReadmeSection === _mergeReadmeSection && m._managedMerge === _managedMerge && MERGE_OVERWRITE_FILES === c.MERGE_OVERWRITE_FILES; const rd = _mergeReadmeSection('', 'BLOCK', '<s>', '<e>') === '# Project\n\nBLOCK'; const mm = _managedMerge('a.md', 'NEW', 'OLD', '.h', new Set()).includes('migration-preserved'); const ow = _managedMerge('.harness/manifest.json', 'NEW', 'OLD', '.h', c.MERGE_OVERWRITE_FILES) === 'NEW'; const same = _managedMerge('a.md', 'X', 'X', '.h', new Set()) === 'X'; return moved && rd && mm && ow && same; } },
     { name: 'UR-0025: _parseSkillsValue(catalog 주입) + MINIMAL_SKIP_KEYS 모듈 분리 + 행위 (1.9.369)', run: () => { const m = require('../lib/pure-utils'); const c = require('../lib/catalogs'); if (typeof _parseSkillsValue !== 'function') return false; const moved = m._parseSkillsValue === _parseSkillsValue && MINIMAL_SKIP_KEYS === c.MINIMAL_SKIP_KEYS; const cat = { office: {}, foo: {} }; const empty = _parseSkillsValue('', cat).length === 0; const all = _parseSkillsValue('all', cat).length === 2; const rec = _parseSkillsValue('recommended', cat).includes('office'); const csv = JSON.stringify(_parseSkillsValue('office,bar', cat)) === JSON.stringify(['office']); return moved && empty && all && rec && csv && MINIMAL_SKIP_KEYS.has('.claude/skills/leerness.md'); } },
     { name: 'UR-0025: _parseArchiveBlocks/_parseSkillCatalog 순수 파서 모듈 분리 + 행위 (1.9.370)', run: () => { const m = require('../lib/pure-utils'); if (typeof _parseArchiveBlocks !== 'function' || typeof _parseSkillCatalog !== 'function') return false; const moved = m._parseArchiveBlocks === _parseArchiveBlocks && m._parseSkillCatalog === _parseSkillCatalog; const ab = _parseArchiveBlocks('## 제거 2026-01-01 (target: ' + '"T-1")\n### 헤더\n'); const abOk = ab.length === 1 && ab[0].date === '2026-01-01' && ab[0].target === 'T-1' && ab[0].originalHeader === '헤더'; const md = _parseSkillCatalog('- [nm](https://x/SKILL.md) — d', ''); const mdOk = md.length === 1 && md[0].name === 'nm' && md[0].format === 'markdown'; const js = _parseSkillCatalog('{' + '"skills":[{"id":"a","url":"u"}]}', ''); const jsOk = js.length === 1 && js[0].name === 'a' && js[0].format === 'json'; return moved && abOk && mdOk && jsOk; } },
+    { name: 'UR-0073 Phase A: team 정의 레지스트리 (_renderTeamsMd + canonical load/save) 행위 (1.9.371)', run: () => { const m = require('../lib/pure-utils'); if (typeof teamCmd !== 'function' || typeof _renderTeamsMd !== 'function' || m._renderTeamsMd !== _renderTeamsMd) return false; const md = _renderTeamsMd([{ id: 't1', name: 'N', personas: ['security'], members: ['claude'], schedule: 'daily', status: 'active' }]); const mdOk = md.includes('## t1') && md.includes('security') && md.includes('daily') && md.includes('정의 전용'); const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_team_')); let rtOk = false; try { _saveTeams(tmp, [{ id: 'x', name: 'X', personas: [], members: [], schedule: 'manual', status: 'active' }]); const loaded = _loadTeams(tmp); rtOk = loaded.length === 1 && loaded[0].id === 'x' && fs.existsSync(path.join(tmp, '.harness', 'teams.json')) && fs.existsSync(path.join(tmp, '.harness', 'teams.md')); } finally { try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } return mdOk && rtOk; } },
+    { name: 'UR-0073 Phase B: _composeTeamPlan dry-run 실행 계획 (멤버별 dispatch, 실행 없음) 행위 (1.9.372)', run: () => { const m = require('../lib/pure-utils'); if (typeof _composeTeamPlan !== 'function' || m._composeTeamPlan !== _composeTeamPlan) return false; const team = { id: 'rev', name: 'R', purpose: 'PR 리뷰', personas: ['security', 'perf'], members: ['claude', 'codex'], schedule: 'manual' }; const p1 = _composeTeamPlan(team, '점검'); const ok1 = p1.steps.length === 2 && p1.task === '점검' && p1.steps[0].member === 'claude' && p1.steps[0].suggestedCommand.includes('agents dispatch') && p1.steps[0].suggestedCommand.includes('--to claude') && p1.steps[0].dispatchPrompt.includes('security'); const p2 = _composeTeamPlan(team, null); const ok2 = p2.task === 'PR 리뷰'; const p3 = _composeTeamPlan({ id: 'e', personas: [], members: [] }, 'x'); const ok3 = p3.steps.length === 0 && p3.memberCount === 0; return ok1 && ok2 && ok3; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -3643,7 +3645,8 @@ function commandsCmd(root) {
       { cmd: 'webhook serve', desc: '웹훅 수신 서버' },
       { cmd: 'deploy auto', desc: '배포 자동화' },
       { cmd: 'runs list|show', desc: '실행 이력' },
-      { cmd: 'whats-new [path]', desc: '최근 버전 변경 요약' }
+      { cmd: 'whats-new [path]', desc: '최근 버전 변경 요약' },
+      { cmd: 'team list|add|show|remove|preview <id> [--name --purpose --personas --members --schedule --task]', desc: '에이전트 팀 정의 + preview(dry-run 실행계획) — UR-0073 Phase A/B, opt-in · 정의/미리보기 전용' }
     ]
   };
   if (has('--json')) {
@@ -5836,6 +5839,97 @@ function _saveDecisions(root, decisions) {
   writeUtf8(decisionsJsonPath(root), JSON.stringify(arr, null, 2) + '\n');
   writeUtf8(decisionsPath(root), _renderDecisionsMd(arr));
 }
+// 1.9.371 (UR-0073 Phase A): agent team 정의 레지스트리 — canonical JSON(teams.json) 주 + teams.md projection. opt-in · 정의 전용(자동 실행 X).
+const teamsJsonPath = root => path.join(root, '.harness/teams.json');
+const teamsPath = root => path.join(root, '.harness/teams.md');
+function _loadTeams(root) {
+  const jp = teamsJsonPath(root);
+  if (exists(jp)) { try { const arr = JSON.parse(read(jp)); if (Array.isArray(arr)) return arr; } catch {} }
+  return [];
+}
+function _saveTeams(root, teams) {
+  const arr = Array.isArray(teams) ? teams : [];
+  mkdirp(path.dirname(teamsJsonPath(root)));
+  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',
+      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'}`);
+    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;
+  }
+  fail(`알 수 없는 team 하위명령: ${sub} (list|add|show|remove|preview)`);
+}
+
 // 1.9.112: 전용 lessons.md (Memory Write Surface 5번째)
 const lessonsPath = root => path.join(root, '.harness/lessons.md');
 const lessonsJsonPath = root => path.join(root, '.harness/lessons.json');
@@ -21101,7 +21195,7 @@ function help() {
   leerness skill install <SKILL.md|dir|url> · leerness skill discover --preset vercel|anthropic   # 스킬 설치/탐색
   leerness release bump [--patch|--minor|--major]  # package.json 자동 bump (1.9.8)
   leerness release note "<내용>"               # CHANGELOG.md 자동 추가 (1.9.8)
-  leerness release publish [--dry-run] [--pack] [--git-push] [--gh-release] [--gh-pages] [--gh-pages-src file] [--npm-publish] [--auto]  # 통합 배포 (1.9.8 + 1.9.10)\n  leerness impact <target> [--all]           # 변경 전 영향 분석 (기본 strong, --all로 weak 포함)\n  leerness reuse find <query>                # 기존 자원 검색 (재귀 안내)\n  leerness reuse register <name> --where <p> --kind component|hook|util|api [--note ...]\n  leerness ui consistency [path] [--strict] [--fail-on-violation]\n  leerness graph [path] [--out <file>]       # mermaid 의존성 그래프\n  leerness guide [target]                    # impact + reuse + ui consistency 통합 가이드\n  leerness migrate audit|apply|plan [path] [--json] [--yes]   # 크로스버전 마이그레이션 진단/적용(canonical 백필)/플랜(임시폴더 비교) (UR-0075, 1.9.356~358)\n  leerness migrate --guide                    # AI 에이전트용 크로스버전 마이그레이션 가이드 (1.9.355)\n  leerness install-safety [--json]            # 설치 안전 프로필 — 0 런타임 deps / 0 install-script (1.9.359)\n  leerness capabilities [--json]              # 권한·보안 표면 공개 (1.9.272)\n  leerness feature add|link|impact|list|show  # 기능 그래프(feature-graph) 추적\n  leerness permissions list|set               # agent 권한 모드 (1.9.174)\n  leerness creds list|register|check|refresh  # 크리덴셜 메타 추적 (값 미저장)\n  leerness incident list|show|handle · webhook serve · deploy auto · runs list|show   # 운영(ops)\n  leerness whats-new [path]                   # 최근 버전 변경 요약\n  leerness commands [--json]                  # 전체 명령 전수 목록 (누락 없이 이 명령으로 확인)\n`);
+  leerness release publish [--dry-run] [--pack] [--git-push] [--gh-release] [--gh-pages] [--gh-pages-src file] [--npm-publish] [--auto]  # 통합 배포 (1.9.8 + 1.9.10)\n  leerness impact <target> [--all]           # 변경 전 영향 분석 (기본 strong, --all로 weak 포함)\n  leerness reuse find <query>                # 기존 자원 검색 (재귀 안내)\n  leerness reuse register <name> --where <p> --kind component|hook|util|api [--note ...]\n  leerness ui consistency [path] [--strict] [--fail-on-violation]\n  leerness graph [path] [--out <file>]       # mermaid 의존성 그래프\n  leerness guide [target]                    # impact + reuse + ui consistency 통합 가이드\n  leerness migrate audit|apply|plan [path] [--json] [--yes]   # 크로스버전 마이그레이션 진단/적용(canonical 백필)/플랜(임시폴더 비교) (UR-0075, 1.9.356~358)\n  leerness migrate --guide                    # AI 에이전트용 크로스버전 마이그레이션 가이드 (1.9.355)\n  leerness install-safety [--json]            # 설치 안전 프로필 — 0 런타임 deps / 0 install-script (1.9.359)\n  leerness capabilities [--json]              # 권한·보안 표면 공개 (1.9.272)\n  leerness feature add|link|impact|list|show  # 기능 그래프(feature-graph) 추적\n  leerness permissions list|set               # agent 권한 모드 (1.9.174)\n  leerness creds list|register|check|refresh  # 크리덴셜 메타 추적 (값 미저장)\n  leerness incident list|show|handle · webhook serve · deploy auto · runs list|show   # 운영(ops)\n  leerness whats-new [path]                   # 최근 버전 변경 요약\n  leerness team list|add|show|remove|preview <id> [--name --purpose --personas a,b --members claude,codex --schedule every-session --task "..."]   # 에이전트 팀 정의 + preview(dry-run 실행계획) — UR-0073 Phase A/B, opt-in · 정의/미리보기 전용(자동실행 X)\n  leerness commands [--json]                  # 전체 명령 전수 목록 (누락 없이 이 명령으로 확인)\n`);
 }
 
 async function main() {
@@ -21328,6 +21422,7 @@ async function main() {
   // 1.9.278 (UR-0032): leerness state <show|start|record|verify|handoff> — .leerness/ 구조화 상태 substrate
   if (cmd === 'state')                              return stateCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   if (cmd === 'context')                            return contextCmd(_resolveRoot(args[1]), { json: has('--json') });
+  if (cmd === 'team')                               return teamCmd(_resolveRoot(null), args[1], args[2], { json: has('--json') });  // 1.9.371 (UR-0073 Phase A): 에이전트 팀 정의 레지스트리 (opt-in, positional=sub/id, root=--path|cwd)
   if (cmd === 'brief')                              return briefCmd(arg('--path', process.cwd()), args[1]);
   if (cmd === 'about' || cmd === 'identity')        return aboutCmd({ json: has('--json') });
   // 1.9.281 (UR-0034): leerness policy <show|set|check> — 권한 등급 (opt-in enforced)

package/lib/pure-utils.js

@@ -733,11 +733,40 @@ function _parseSkillCatalog(body, sourceUrl) {
   return entries;
 }
 
+// 1.9.371 (UR-0073 Phase A): agent team 정의 → teams.md projection (canonical JSON 주, MD 투영). 순수 렌더러.
+function _renderTeamsMd(teams) {
+  const preamble = '# Agent Teams (UR-0073)\n\n페르소나 기반 에이전트 팀 정의 — **opt-in · 정의 전용(자동 실행 없음)**. `leerness team add|list|show|remove` 로 관리.\n'
+    + '향후 단계에서 스케줄 기반 실행(리뷰/배포/블로그)이 opt-in 으로 추가될 수 있습니다. 현재는 메타데이터만 저장합니다.\n';
+  const body = (teams || []).map(t => {
+    return `\n## ${t.id}${t.name ? ' — ' + t.name : ''}\n`
+      + `- Purpose: ${t.purpose || ''}\n`
+      + `- Personas: ${(t.personas || []).join(', ')}\n`
+      + `- Members: ${(t.members || []).join(', ')}\n`
+      + `- Schedule: ${t.schedule || 'manual'}\n`
+      + `- Status: ${t.status || 'active'}\n`;
+  }).join('');
+  return preamble + body;
+}
+
+// 1.9.372 (UR-0073 Phase B): team 실행 계획 컴포저 (순수, dry-run 미리보기). 실제 실행/spawn 없음 — 멤버별 dispatch 명령 문자열만 생성.
+function _composeTeamPlan(team, task) {
+  const t = team || {};
+  const effTask = (task && task !== true) ? String(task) : (t.purpose || '(작업 미지정)');
+  const personas = Array.isArray(t.personas) ? t.personas : [];
+  const members = Array.isArray(t.members) ? t.members : [];
+  const personaTag = personas.length ? ` [페르소나: ${personas.join(', ')}]` : '';
+  const steps = members.map(m => {
+    const prompt = `${effTask}${personaTag}`;
+    return { member: m, personas, dispatchPrompt: prompt, suggestedCommand: `leerness agents dispatch "${prompt}" --to ${m}` };
+  });
+  return { teamId: t.id || null, name: t.name || '', task: effTask, schedule: t.schedule || 'manual', memberCount: members.length, steps };
+}
+
 module.exports = {
   _isSecretKey, compareVer, parseHarnessVersion,
   _isPlaceholderSecret, _looksSecretLike,
   _mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _parseSkillsValue,
-  _parseArchiveBlocks, _parseSkillCatalog,
+  _parseArchiveBlocks, _parseSkillCatalog, _renderTeamsMd, _composeTeamPlan,
   _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
   // 1.9.283 (UR-0025 2단계)
   PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord,

package/package.json

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

package/scripts/e2e.js

@@ -5086,5 +5086,52 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.371 회귀 (UR-0073 Phase A): team 정의 레지스트리 — add/list/remove + canonical JSON/MD (opt-in · 정의 전용)
+total++;
+{
+  let ok = false;
+  try {
+    const d = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-team-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', 'ko'], { encoding: 'utf8', timeout: 30000 });
+    cp.spawnSync(process.execPath, [CLI, 'team', 'add', 'rev', '--name', 'Review', '--personas', 'security,perf', '--members', 'claude,codex', '--schedule', 'every-session', '--path', d], { encoding: 'utf8', timeout: 15000 });
+    const lj = cp.spawnSync(process.execPath, [CLI, 'team', 'list', '--path', d, '--json'], { encoding: 'utf8', timeout: 15000 });
+    let addOk = false;
+    try { const j = JSON.parse(lj.stdout); addOk = j.count === 1 && j.teams[0].id === 'rev' && j.teams[0].personas.length === 2 && j.teams[0].schedule === 'every-session'; } catch {}
+    const jsonExists = fs.existsSync(path.join(d, '.harness', 'teams.json'));
+    const mdExists = fs.existsSync(path.join(d, '.harness', 'teams.md'));
+    cp.spawnSync(process.execPath, [CLI, 'team', 'remove', 'rev', '--path', d], { encoding: 'utf8', timeout: 15000 });
+    const lj2 = cp.spawnSync(process.execPath, [CLI, 'team', 'list', '--path', d, '--json'], { encoding: 'utf8', timeout: 15000 });
+    let removeOk = false;
+    try { removeOk = JSON.parse(lj2.stdout).count === 0; } catch {}
+    fs.rmSync(d, { recursive: true, force: true });
+    ok = addOk && jsonExists && mdExists && removeOk;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.371) UR-0073 Phase A: team 정의 레지스트리 (add/list/remove + canonical JSON/MD, opt-in 정의전용)' : '✗ team 레지스트리 실패');
+  if (!ok) failed++;
+}
+
+// 1.9.372 회귀 (UR-0073 Phase B): team preview — dry-run 실행 계획 미리보기 (멤버별 dispatch 명령, 실제 실행/파일변경 없음)
+total++;
+{
+  let ok = false;
+  try {
+    const d = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-tprev-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', 'ko'], { encoding: 'utf8', timeout: 30000 });
+    cp.spawnSync(process.execPath, [CLI, 'team', 'add', 'rev', '--purpose', 'PR 리뷰', '--personas', 'security', '--members', 'claude,codex', '--path', d], { encoding: 'utf8', timeout: 15000 });
+    const pj = cp.spawnSync(process.execPath, [CLI, 'team', 'preview', 'rev', '--task', '점검', '--path', d, '--json'], { encoding: 'utf8', timeout: 15000 });
+    let planOk = false;
+    try { const j = JSON.parse(pj.stdout); planOk = j.dryRun === true && j.task === '점검' && j.steps.length === 2 && j.steps[0].suggestedCommand.includes('agents dispatch') && j.steps[0].suggestedCommand.includes('--to claude') && j.steps[0].dispatchPrompt.includes('security'); } catch {}
+    // dry-run: preview 가 어떤 파일도 변경하지 않음 (teams.json mtime 불변)
+    const tj = path.join(d, '.harness', 'teams.json');
+    const before = fs.statSync(tj).mtimeMs;
+    cp.spawnSync(process.execPath, [CLI, 'team', 'preview', 'rev', '--path', d], { encoding: 'utf8', timeout: 15000 });
+    const after = fs.statSync(tj).mtimeMs;
+    fs.rmSync(d, { recursive: true, force: true });
+    ok = planOk && before === after;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.372) UR-0073 Phase B: team preview dry-run 실행계획 (멤버별 dispatch, 파일변경 0)' : '✗ team preview 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);