leerness 1.9.233 → 1.9.235

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 1.9.235 — 2026-05-23
+
+**🗑 leerness release cleanup CLI — local release/* branches 정리 + --keep BUG fix.**
+
+### 1. `leerness release cleanup` 새 명령
+- local `release/*` branches 중 main 에 merge된 것 자동 정리
+- 기본 dry-run (목록만), `--apply` 명시 시 실 삭제
+- `--keep N` (default 5) — 최근 N개 유지
+- 안전 가드: merged 만 삭제, unmerged 보호, 현재 branch 보호
+- `--json` 옵션
+
+### 2. 실 측정 — leerness 자체 누적 191개
+- merged: 191개 / unmerged: 0개
+- keep 5 → 삭제 후보 186개 (1.9.6~229)
+- 유지: 1.9.234, 1.9.233, 1.9.232, 1.9.231, 1.9.230 (top 5 최신)
+- handoff abnormal-shutdown `release-branch-pending` 신호 가중치 해소 가능
+
+### 3. 🐛 `--keep` 플래그 nonFlagArgs 등록 (BUG fix)
+- 기존: `--keep 10`의 `10`이 non-flag arg 로 잘못 분류 → root 인자 됨
+- 1.9.235 fix: `withValue.Set` 에 `--keep` 추가 → 정상 인식
+
+### 4. 누적 회귀 (1.9.207~234) — 모두 유지
+
+### 5. stress-v180 — 16/16 PASS
+- 1.9.235 (7): VERSION + dry-run + --keep + 정렬 + 안전 가드 + git fallback + human 출력
+- 성능 (2): cold_start avg 353ms / release cleanup 701ms
+- 누적 회귀 (7): 1.9.207~234
+
+### 6. 자동 release (97 라운드 main-push streak · 58 라운드 npm publish streak)
+
+🗑 **운영 누적 정리 시스템** — 191 branches 누적 → 5개 유지 가능 (handoff 신호 해소)
+
+---
+
+## 1.9.234 — 2026-05-23
+
+**📜 handoff/session close/health --json recentChanges 통합 (8 필드 완성) — 외부 AI 최근 5 라운드 즉시 인지.**
+
+### 1. handoff/session close/health --json 8번째 통합 필드 `recentChanges`
+- git tag 기반 최근 5 라운드의 핵심 변경 자동 회수
+- 형식: `[{ version, date, subject }]` (가장 최근부터)
+- AI 가 "최근 무엇이 바뀌었나?"를 단일 호출로 인지 → 컨텍스트 절약
+- 1.9.218 (4 필드) → 1.9.223 (5) → 1.9.227 (6) → 1.9.230 (7) → 1.9.234 (**8 필드**)
+
+### 2. 3 명령 일관성 매트릭스 — 3 × 8 = 24 통합 포인트
+- handoff/session close/health 동일 형식 + 동일 결과
+- 외부 자동화/CI 어느 명령으로 조회해도 동일 응답
+
+### 3. AI 인지 비용 절감
+- 기존: AI 가 CHANGELOG.md 읽기 → 토큰 다량 소비
+- 1.9.234: handoff --json 한 번에 최근 5 라운드 자동 회수 → ~500 토큰 절약
+
+### 4. 누적 회귀 (1.9.207~233) — 모두 유지
+
+### 5. stress-v179 — 17/17 PASS
+- 1.9.234 (7): VERSION + handoff/session close/health JSON + 3 명령 일관성 + 8 필드 검증 + 형태 검증
+- 성능 (2): cold_start avg 376ms / handoff --json (8 필드) 1109ms
+- 누적 회귀 (8): 1.9.207~233
+
+### 6. 자동 release (96 라운드 main-push streak · 57 라운드 npm publish streak)
+
+📜 **JSON 통합 매트릭스 8 필드 완성** — 외부 AI 가 leerness 상태 + 최근 변경 모두 한 번에 회수
+
+---
+
 ## 1.9.233 — 2026-05-23
 
 **📚 leerness commands 새 명령 (9 카테고리 51 CLI) + MCP 65번째 도구.**

package/README.md

@@ -2,7 +2,7 @@
 
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.233-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v178-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-65-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-51-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-189-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-95_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![commands](https://img.shields.io/badge/📚_commands-9_카테고리_51_명령-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-413ms-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.235-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v180-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-65-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-52-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-191-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-97_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![cleanup](https://img.shields.io/badge/🗑_release-cleanup_CLI-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-353ms-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.233  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.235  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  📚 leerness commands · 9 카테고리 · 51 CLI · MCP 65          ║
+  ║  🗑 release cleanup · 191 branches 누적 정리 + BUG fix        ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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');
 
-const VERSION = '1.9.233';
+const VERSION = '1.9.235';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -180,7 +180,7 @@ function arg(name, def = null) { const i = process.argv.indexOf(name); return i
 function has(name) { return process.argv.includes(name); }
 function nonFlagArgs() {
   const out = [];
-  const withValue = new Set(['--language','--skills','--path','--status','--progress','--goal','--reason','--next','--target','--token-env','--package','--out','--from','--repo','--id','--note','--evidence','--query','--limit','--action','--agent','--tool','--doc','--command','--capability','--before','--after','--display','--threshold','--trigger','--check','--set','--min-score','--include','--days','--gh-pages-src','--roadmap','--since','--agents','--model','--timeout','--retry-on-fail','--label','--score','--tokens','--alternatives','--impact','--tag','--surface','--depends-on','--affects','--co-changes-with','--files','--branch','--remote','--task-add','--next-action','--role','--provider','--env-var','--deploy','--token-lifetime-hours','--port','--secret']);
+  const withValue = new Set(['--language','--skills','--path','--status','--progress','--goal','--reason','--next','--target','--token-env','--package','--out','--from','--repo','--id','--note','--evidence','--query','--limit','--action','--agent','--tool','--doc','--command','--capability','--before','--after','--display','--threshold','--trigger','--check','--set','--min-score','--include','--days','--gh-pages-src','--roadmap','--since','--agents','--model','--timeout','--retry-on-fail','--label','--score','--tokens','--alternatives','--impact','--tag','--surface','--depends-on','--affects','--co-changes-with','--files','--branch','--remote','--task-add','--next-action','--role','--provider','--env-var','--deploy','--token-lifetime-hours','--port','--secret','--keep']);
   const a = process.argv.slice(2);
   for (let i = 0; i < a.length; i++) {
     const x = a[i];
@@ -2196,6 +2196,36 @@ function milestonesCmd(root) {
   }
 }
 
+// 1.9.234: recentChanges — 최근 N 라운드의 핵심 변경 요약 (git tag commit subject)
+//   응답: [{ version, date, subject }] (가장 최근부터)
+function _computeRecentChanges(root, limit = 5) {
+  const items = [];
+  try {
+    const r = cp.spawnSync('git', ['log', '--tags', '--simplify-by-decoration', '--pretty=format:%H|%D|%ad|%s', '--date=short', '-n', String(limit * 3)], {
+      cwd: root, encoding: 'utf8', timeout: 5000
+    });
+    if (r.status !== 0 || !r.stdout) return items;
+    const lines = r.stdout.split('\n').filter(l => l.trim());
+    for (const line of lines) {
+      const idx1 = line.indexOf('|');
+      if (idx1 < 0) continue;
+      const idx2 = line.indexOf('|', idx1 + 1);
+      const idx3 = line.indexOf('|', idx2 + 1);
+      if (idx2 < 0 || idx3 < 0) continue;
+      const refs = line.slice(idx1 + 1, idx2);
+      const date = line.slice(idx2 + 1, idx3);
+      const subject = line.slice(idx3 + 1);
+      const m = refs.match(/tag: v(\d+\.\d+\.\d+)/);
+      if (!m) continue;
+      const version = m[1];
+      const cleanSubject = subject.replace(/^\d+\.\d+\.\d+\s*[—-]\s*/, '').trim();
+      items.push({ version, date, subject: cleanSubject.slice(0, 100) });
+      if (items.length >= limit) break;
+    }
+  } catch {}
+  return items;
+}
+
 // 1.9.231: leerness pulse — 한 줄 종합 요약 (10 핵심 지표)
 //   handoff 헤드라인의 축약 버전 — 사용자가 빠르게 상태 파악
 //   응답 (--json): { version, roundCount, mcpTools, memorySurface, security, health, driftScore, nextMilestone, etaDays, abnormal }
@@ -6206,6 +6236,10 @@ function handoff(root) {
           avgRoundsPerDay: ms.avgRoundsPerDay
         };
       } catch {}
+      // 1.9.234: recentChanges 통합 (handoff JSON 8번째 통합 필드) — 최근 5 라운드 변경 요약
+      try {
+        result.recentChanges = _computeRecentChanges(root, 5);
+      } catch {}
     } catch {}
     try {
       const pwState = _loadPreWakeReport(root);
@@ -10365,6 +10399,10 @@ function sessionClose(root, opts = {}) {
           avgRoundsPerDay: ms.avgRoundsPerDay
         };
       } catch {}
+      // 1.9.234: recentChanges 통합 (session close JSON 8번째 통합 필드) — 최근 5 라운드 변경
+      try {
+        jsonResult.recentChanges = _computeRecentChanges(root, 5);
+      } catch {}
     } catch {}
     try {
       // 1.9.209: pre-wake-audit 자동 실행 + 저장 (sleep 전 자동 점검)
@@ -12118,6 +12156,95 @@ function releaseSyncMainCmd(root) {
   }
 }
 
+// 1.9.235: leerness release cleanup — local release/* branches 정리 (main 에 merge된 것)
+//   문제: 매 라운드 release/X.Y.Z 가 누적 → handoff abnormal-shutdown release-branch-pending 신호 가중
+//   기본: dry-run (삭제 후보 표시) · --apply 명시 시 실 삭제 · --keep N (최근 N개 유지, default 5)
+//   안전: main 에 merge되지 않은 branch 는 절대 삭제 X · 현재 branch 도 보호
+function releaseCleanupCmd(root) {
+  root = absRoot(root || process.cwd());
+  const isTty = process.stdout && process.stdout.isTTY;
+  const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+  const gr = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+  const yl = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+  const rd = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
+  const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+  const apply = has('--apply');
+  const keep = parseInt(arg('--keep', '5'), 10) || 5;
+  // 1) git 저장소 확인
+  const headR = cp.spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: root, encoding: 'utf8' });
+  if (headR.status !== 0) {
+    log(rd('# leerness release cleanup (1.9.235) — git 저장소 아님'));
+    return;
+  }
+  const currentBranch = (headR.stdout || '').trim();
+  // 2) local release/* branches + merged 상태 회수
+  const branchR = cp.spawnSync('git', ['branch', '--merged', 'main', '--list', 'release/*'], { cwd: root, encoding: 'utf8' });
+  const mergedBranches = (branchR.stdout || '').split('\n')
+    .map(l => l.replace(/^\*?\s+/, '').trim())
+    .filter(l => l && /^release\/\d+\.\d+\.\d+$/.test(l));
+  // 3) 모든 release/* 도 회수 (unmerged 분석용)
+  const allR = cp.spawnSync('git', ['branch', '--list', 'release/*'], { cwd: root, encoding: 'utf8' });
+  const allBranches = (allR.stdout || '').split('\n')
+    .map(l => l.replace(/^\*?\s+/, '').trim())
+    .filter(l => l && /^release\/\d+\.\d+\.\d+$/.test(l));
+  const unmergedBranches = allBranches.filter(b => !mergedBranches.includes(b));
+  // 4) 정렬 (semver desc) + keep N + 현재 branch 제외
+  mergedBranches.sort((a, b) => {
+    const va = a.replace('release/', '').split('.').map(n => parseInt(n, 10) || 0);
+    const vb = b.replace('release/', '').split('.').map(n => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++) if (va[i] !== vb[i]) return vb[i] - va[i];
+    return 0;
+  });
+  const recent = mergedBranches.slice(0, keep);
+  const toDelete = mergedBranches.slice(keep).filter(b => b !== currentBranch);
+  // 5) JSON
+  if (has('--json')) {
+    log(JSON.stringify({
+      apply, keep, total: allBranches.length, merged: mergedBranches.length,
+      unmerged: unmergedBranches.length, deleteCount: toDelete.length,
+      toDelete, recent: recent.slice(0, keep), unmergedSample: unmergedBranches.slice(0, 5)
+    }, null, 2));
+    return;
+  }
+  // 6) Human 출력
+  log(cy(`# leerness release cleanup (1.9.235) — local release/* branches 정리`));
+  log('');
+  log(`  📊 총 ${allBranches.length}개 · merged ${mergedBranches.length}개 · unmerged ${unmergedBranches.length}개`);
+  log(`  📍 현재 branch: ${currentBranch}${currentBranch.startsWith('release/') ? yl(' (보호)') : ''}`);
+  log(`  🛡 keep 최근 ${keep}개 유지`);
+  log('');
+  if (toDelete.length === 0) {
+    log(gr(`  ✓ 정리 대상 없음 (merged ${mergedBranches.length} ≤ keep ${keep})`));
+    if (unmergedBranches.length > 0) {
+      log('');
+      log(yl(`  ⚠ unmerged ${unmergedBranches.length}개 — sync-main 미진행. 정리 대상 아님:`));
+      unmergedBranches.slice(0, 5).forEach(b => log(`    • ${b}`));
+      if (unmergedBranches.length > 5) log(dm(`    ... +${unmergedBranches.length - 5}개`));
+    }
+    return;
+  }
+  log(yl(`  🗑 삭제 후보 ${toDelete.length}개 (merged + keep 범위 외):`));
+  toDelete.slice(0, 10).forEach(b => log(`    • ${b}`));
+  if (toDelete.length > 10) log(dm(`    ... +${toDelete.length - 10}개`));
+  log('');
+  log(`  📍 유지 ${recent.length}개:`);
+  recent.slice(0, 5).forEach(b => log(`    ✓ ${b}`));
+  if (recent.length > 5) log(dm(`    ... +${recent.length - 5}개`));
+  log('');
+  if (apply) {
+    let ok = 0, fail = 0;
+    for (const b of toDelete) {
+      const r = cp.spawnSync('git', ['branch', '-d', b], { cwd: root, encoding: 'utf8' });
+      if (r.status === 0) ok++;
+      else fail++;
+    }
+    log(gr(`  ✓ 삭제 완료: ${ok}/${toDelete.length}건`) + (fail > 0 ? rd(` · 실패 ${fail}`) : ''));
+  } else {
+    log(dm(`  → 적용: leerness release cleanup --apply (안전: merged만 삭제, 현재 branch 보호)`));
+    log(dm(`  → --keep N: 최근 N개 유지 (default 5)`));
+  }
+}
+
 // 1.9.178: NPM 자동 배포 (사용자 명시 — release sync-main 후 자동 trigger).
 //   보안:
 //     - NPM_TOKEN 또는 LEERNESS_NPM_TOKEN 환경변수에서만 읽음 (값 절대 로그 X)
@@ -16738,6 +16865,10 @@ function healthCmd(root) {
       avgRoundsPerDay: ms.avgRoundsPerDay
     };
   } catch { out.milestones = { error: 'milestones 점검 실패' }; }
+  // 1.9.234: health --json recentChanges 통합 (3 명령 8 필드 일관성)
+  try {
+    out.recentChanges = _computeRecentChanges(root, 5);
+  } catch { out.recentChanges = { error: 'recentChanges 점검 실패' }; }
   // 1.9.163: 5능력 매트릭스 자동 평가 (1.9.155 sub-agent 점검 → 코드 기반 자동화)
   //   각 능력을 코드 grep 으로 검출 → 0~100 점수. 사용자가 매 health 호출 시 leerness 자기 평가 확인.
   try {
@@ -18206,6 +18337,8 @@ async function main() {
   if (cmd === 'release' && args[1] === 'publish')   return releasePublish(args[2] || arg('--path', process.cwd()));
   if (cmd === 'release' && args[1] === 'pack')      return await releasePackCmd(args[2] || arg('--path', process.cwd()));
   if (cmd === 'release' && args[1] === 'sync-main') return releaseSyncMainCmd(args[2] || arg('--path', process.cwd()));
+  // 1.9.235: leerness release cleanup — local release/* branches 정리 (merged 만, --apply 시 실 삭제)
+  if (cmd === 'release' && args[1] === 'cleanup')   return releaseCleanupCmd((args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd()));
   // 1.9.141: feature causality graph
   if (cmd === 'feature' && args[1] === 'add')    return featureAddCmd(arg('--path', process.cwd()), args.slice(2).filter(x => !x.startsWith('--')).join(' '));
   if (cmd === 'feature' && args[1] === 'link')   return featureLinkCmd(arg('--path', process.cwd()), args[2]);

package/package.json

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