leerness 1.9.361 → 1.9.363

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 1.9.363 — 2026-06-06 — 안정화④ 외부리뷰 CV-7: commands/help 표면 drift 해소 (UR-0082)
+
+**🛠 외부 멀티모델 리뷰 안정화 시리즈 4탄 — `--help`/`commands` 에서 누락됐던 명령군 전수 등재.**
+
+### 배경 — 외부 리뷰 CV-7 (Codex+Opus)
+`install-safety`(1.9.359) + 8개 명령군(feature/creds/incident/webhook/deploy/runs/permissions/whats-new) + 이번 세션 신규 `migrate audit|apply|plan` 이 `--help`/`commands` 에 노출 안 됨(문서-동작 drift). phantom(문서O구현X) 명령은 0(양호).
+
+### 구현
+1. **`commands` 카탈로그 확장** (60→77 명령): `config` 에 migrate 서브커맨드+가이드, doctor/selftest/install-safety/env/shell-guard/path-setup 추가. 신규 **`ops` 카테고리**(feature/permissions/capabilities/creds/incident/webhook/deploy/runs/whats-new). 카테고리 9→10, 푸터 카테고리 수 동적화.
+2. **`help()` 보강**: 누락 명령군 블록 추가 + "`commands` 로 전수 확인" 안내.
+3. **표면 drift 가드**: selftest(commandsCmd+help 본문에 누락 명령군 존재 단언) + e2e(`commands --json` 전수 등재 + total>=70) — 재발 차단.
+
+### 검증 (회귀 0)
+- **selftest 109→110 PASS** · **E2E 308→309 PASS**.
+- 실측: `commands --json` total 77 / 10 카테고리 / 누락 명령 10종 전부 등재. `--help` 에도 반영.
+
+## 1.9.362 — 2026-06-06 — 안정화③ 외부리뷰 CV-4: archive retention (무한 누적 차단, UR-0079)
+
+**🛠 외부 멀티모델 리뷰 안정화 시리즈 3탄 — init/migrate 재실행 시 archive 무한 누적 차단.**
+
+### 배경 — 외부 리뷰 CV-4 (Opus P1 / Sonnet P3)
+init/migrate 가 변경 유무와 무관하게 매 실행마다 전체 archive 스냅샷을 생성하나 retention 이 없어 무한 누적(Opus: 5회 재실행 → `.harness` 1.7M 중 1.5M 이 중복 archive). createBackup(709)이 prune 없이 copy 만.
+
+### 구현
+1. **`_pruneArchives(root, keep)`**(신규): `.harness/archive/leerness-*` 디렉토리를 **mtime 기준** 정렬해 최신 `keep` 개만 유지, 오래된 스냅샷 prune. (이름의 버전 문자열은 zero-pad 안 돼 사전순 부정확 → mtime 사용.)
+2. **createBackup 통합**: 새 스냅샷 기록 후 `_pruneArchives(root, keep)` 호출. `keep` = `--keep N`(기본 10). init/migrate/update 전부 자동 bounded.
+
+### 검증 (회귀 0)
+- **selftest 108→109 PASS** (행위: 임시 archive 5개 생성 → `_pruneArchives(root,2)` → pruned 3 / 남은 2 단언). **E2E 307→308 PASS** (행위: `init --keep 2` + `migrate --keep 2` x3 = 4 스냅샷 → archive 2개 상한).
+- 실측: `--keep 2` 로 init+migrate x3 후 archive 정확히 2개.
+
 ## 1.9.361 — 2026-06-06 — 안정화② 외부리뷰 CV-1 --path 라우팅 통일 + CV-3 audit 가드 (UR-0076/0078)
 
 **🛠 외부 멀티모델 리뷰 안정화 시리즈 2탄 — 3개 모델 합의 #1 finding(--path 불일치) + audit 오판 수정.**

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

package/bin/harness.js

@@ -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, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344 (UR-0025): SKILL_CATALOG_PRESETS 분리
 
-const VERSION = '1.9.361';
+const VERSION = '1.9.363';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -706,6 +706,19 @@ function migrationCandidates(root, files) {
   return all.filter(f => exists(path.join(root, f)));
 }
 
+// 외부리뷰 CV-4/UR-0079: archive 무한 누적 방지 — 최신 keep 개만 유지, 오래된 스냅샷 prune (mtime 기준).
+//   init/migrate 재실행마다 전체 archive copy 가 쌓이던 것(Opus: 5회→1.5M 중복) 을 bounded 로.
+function _pruneArchives(root, keep = 10) {
+  const adir = path.join(root, '.harness', 'archive');
+  let names;
+  try { names = fs.readdirSync(adir, { withFileTypes: true }).filter(e => e.isDirectory() && /^leerness-/.test(e.name)).map(e => e.name); } catch { return 0; }
+  if (names.length <= keep) return 0;
+  const withTime = names.map(name => { let t = 0; try { t = fs.statSync(path.join(adir, name)).mtimeMs; } catch {} return { name, t }; });
+  withTime.sort((a, b) => b.t - a.t);  // 최신 우선 (이름의 버전 문자열은 zero-pad 안 돼 사전순 부정확 → mtime 사용)
+  let pruned = 0;
+  for (const e of withTime.slice(keep)) { try { fs.rmSync(path.join(adir, e.name), { recursive: true, force: true }); pruned++; } catch {} }
+  return pruned;
+}
 function createBackup(root, reason, files, dry = false) {
   const stamp = new Date().toISOString().replace(/[:.]/g, '-');
   const ar = path.join(root, '.harness/archive', `leerness-${VERSION}-${stamp}`);
@@ -719,7 +732,10 @@ function createBackup(root, reason, files, dry = false) {
     policy: 'backup-before-write; preserve-by-default; merge-managed-files; merge-env-and-gitignore',
     candidates
   }, null, 2) + '\n');
-  return { archiveDir: ar, candidates };
+  // CV-4/UR-0079: 새 스냅샷 기록 후 retention 적용 (기본 10, --keep N 조정) — 무한 누적 차단.
+  const keep = Math.max(1, parseInt(arg('--keep', '10'), 10) || 10);
+  const pruned = _pruneArchives(root, keep);
+  return { archiveDir: ar, candidates, pruned };
 }
 
 // 1.9.1 P2: 데이터/인덱스 파일은 preserved 블록 없이 overwrite (누적 방지).
@@ -3079,6 +3095,8 @@ function _selfTestCases() {
     { name: 'UR-0074: install-safety(0 런타임 deps · 0 install-script) 사실 가드', run: () => { if (typeof installSafetyCmd !== 'function') return false; let pkg = {}; try { pkg = JSON.parse(read(path.join(__dirname, '..', 'package.json'))); } catch { return false; } const deps = Object.keys(pkg.dependencies || {}).length; const hooks = ['preinstall','install','postinstall'].filter(h => (pkg.scripts||{})[h]).length; return deps === 0 && hooks === 0; } },
     { name: 'CV-2/UR-0077: fetchNpmLatest 신형 Node win EINVAL 회피 (cmd.exe + try/catch + windowsHide)', run: () => { if (typeof fetchNpmLatest !== 'function') return false; const src = read(__filename); const i = src.indexOf('function fetchNpmLatest'); if (i < 0) return false; const body = src.slice(i, i + 1600); return body.includes('cmd.exe') && /try \{/.test(body) && body.includes('windowsHide'); } },
     { name: 'CV-1/UR-0076: arg() --path=값 파싱 + _resolveRoot(--path>positional>cwd) 행위', run: () => { if (typeof _resolveRoot !== 'function') return false; const save = process.argv; try { process.argv = ['node', 'h', 'context', '--path=/tmp/eqform']; const eq = arg('--path', null) === '/tmp/eqform'; process.argv = ['node', 'h', 'context', 'X', '--path', '/tmp/flag']; const flagWins = _resolveRoot('X') === '/tmp/flag'; process.argv = ['node', 'h', 'context', '/tmp/pos']; const posWins = _resolveRoot('/tmp/pos') === '/tmp/pos'; process.argv = ['node', 'h', 'context']; const cwdFb = _resolveRoot(undefined) === process.cwd(); return eq && flagWins && posWins && cwdFb; } finally { process.argv = save; } } },
+    { name: 'CV-4/UR-0079: _pruneArchives archive retention (최신 keep 유지, 오래된 prune) 행위', run: () => { if (typeof _pruneArchives !== 'function') return false; const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_prune_')); try { const adir = path.join(tmp, '.harness', 'archive'); fs.mkdirSync(adir, { recursive: true }); for (let i = 0; i < 5; i++) fs.mkdirSync(path.join(adir, 'leerness-1.9.' + i + '-stamp')); const pruned = _pruneArchives(tmp, 2); const left = fs.readdirSync(adir).filter(n => /^leerness-/.test(n)).length; return pruned === 3 && left === 2; } finally { try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } } },
+    { name: 'CV-7/UR-0082: commands 카탈로그 + help 에 누락 명령군 등재 (표면 drift 가드)', run: () => { const src = read(__filename); const ci = src.indexOf('function commandsCmd'); const hi = src.indexOf('function help('); if (ci < 0 || hi < 0) return false; const cbody = src.slice(ci, ci + 8000); const hbody = src.slice(hi, hi + 7000); const must = ['install-safety', 'feature add', 'creds list', 'incident list', 'webhook serve', 'deploy auto', 'runs list', 'permissions list', 'whats-new', 'migrate audit']; return must.every(c => cbody.includes(c)) && hbody.includes('install-safety') && hbody.includes('feature add'); } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -3696,7 +3714,26 @@ function commandsCmd(root) {
       { cmd: 'intent classify|expand|domains "<request>"', desc: '의도 파악 + scope (1.9.213)' },
       { cmd: 'constraints list|check|add', desc: '플랫폼/API 제약 (1.9.208)' },
       { cmd: 'provider list|add|remove|sync', desc: 'Provider Registry (1.9.157~160)' },
-      { cmd: 'commands [--json]', desc: '전체 명령 카테고리 목록 (1.9.233)' }
+      { cmd: 'commands [--json]', desc: '전체 명령 카테고리 목록 (1.9.233)' },
+      { cmd: 'migrate audit|apply|plan [path] [--json] [--yes]', desc: '크로스버전 마이그레이션 진단/적용/플랜 (UR-0075, 1.9.356~358)' },
+      { cmd: 'migrate --guide', desc: 'AI 에이전트용 크로스버전 마이그레이션 가이드 (1.9.355)' },
+      { cmd: 'doctor [--json]', desc: '설치/환경 진단 (1.9.315)' },
+      { cmd: 'selftest [--json]', desc: '코어 함수 무결성 자가 검증 (1.9.258)' },
+      { cmd: 'install-safety [--json]', desc: '설치 안전 프로필 — 0 deps/0 install-script (1.9.359)' },
+      { cmd: 'env check|sync|detect [path]', desc: '셸/인코딩 환경 진단 (1.9.241)' },
+      { cmd: 'shell-guard "<command>"', desc: '셸 호환성 정적 분석 (1.9.260)' },
+      { cmd: 'path-setup [--apply]', desc: 'CLI PATH 자동 등록 (1.9.254)' }
+    ],
+    ops: [
+      { cmd: 'feature add|link|impact|list|show', desc: '기능 그래프(feature-graph) 추적' },
+      { cmd: 'permissions list|set', desc: 'agent 권한 모드 (1.9.174)' },
+      { cmd: 'capabilities [--json]', desc: '권한·보안 표면 공개 (1.9.272)' },
+      { cmd: 'creds list|register|check|refresh', desc: '크리덴셜 메타 추적 (값 미저장)' },
+      { cmd: 'incident list|show|handle', desc: '인시던트 관리' },
+      { cmd: 'webhook serve', desc: '웹훅 수신 서버' },
+      { cmd: 'deploy auto', desc: '배포 자동화' },
+      { cmd: 'runs list|show', desc: '실행 이력' },
+      { cmd: 'whats-new [path]', desc: '최근 버전 변경 요약' }
     ]
   };
   if (has('--json')) {
@@ -3713,7 +3750,7 @@ function commandsCmd(root) {
     });
     log('');
   }
-  log(dm(`  → 총 ${Object.values(cats).reduce((s, a) => s + a.length, 0)} 명령 (9 카테고리)`));
+  log(dm(`  → 총 ${Object.values(cats).reduce((s, a) => s + a.length, 0)} 명령 (${Object.keys(cats).length} 카테고리)`));
   log(dm(`  → MCP 도구: ${_mcpToolCount()} (외부 AI 노출)`));  // 1.9.315 (UR-0054): 하드코딩 65 → 동적
   log(dm(`  → 빠른 시작: leerness pulse | handoff | health`));
 }
@@ -21132,7 +21169,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 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`);
 }
 
 async function main() {

package/package.json

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

package/scripts/e2e.js

@@ -4925,5 +4925,37 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.362 회귀 (외부리뷰 CV-4/UR-0079): archive retention — init/migrate 반복해도 --keep 상한 유지 (무한 누적 차단)
+total++;
+{
+  let ok = false;
+  try {
+    const d = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-arch-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', 'ko', '--keep', '2'], { encoding: 'utf8', timeout: 30000 });
+    for (let i = 0; i < 3; i++) cp.spawnSync(process.execPath, [CLI, 'migrate', d, '--keep', '2'], { encoding: 'utf8', timeout: 30000 });
+    const adir = path.join(d, '.harness', 'archive');
+    const cnt = fs.readdirSync(adir).filter(n => /^leerness-/.test(n)).length;
+    fs.rmSync(d, { recursive: true, force: true });
+    ok = cnt === 2;  // init + migrate x3 = 4 스냅샷 → --keep 2 로 prune → 2
+  } catch {}
+  console.log(ok ? '✓ B(1.9.362) CV-4: archive retention (--keep 상한, 무한 누적 차단) (UR-0079)' : '✗ archive retention 실패');
+  if (!ok) failed++;
+}
+
+// 1.9.363 회귀 (외부리뷰 CV-7/UR-0082): commands 카탈로그가 누락 명령군(8그룹+install-safety+migrate sub) 전수 등재
+total++;
+{
+  let ok = false;
+  try {
+    const r = cp.spawnSync(process.execPath, [CLI, 'commands', '--json'], { encoding: 'utf8', timeout: 15000 });
+    const j = JSON.parse(r.stdout);
+    const flat = JSON.stringify(j.categories);
+    const must = ['install-safety', 'feature add', 'creds list', 'incident list', 'webhook serve', 'deploy auto', 'runs list', 'permissions list', 'whats-new', 'migrate audit'];
+    ok = must.every(c => flat.includes(c)) && j.totalCommands >= 70;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.363) CV-7: commands 카탈로그 누락 명령군 전수 등재 (8그룹+install-safety+migrate sub) (UR-0082)' : '✗ commands 카탈로그 drift');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);