leerness 1.9.235 → 1.9.237

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # Changelog
 
+## 1.9.237 — 2026-05-24
+
+**🗑 session close --auto-cleanup-branches + handoff body 50+ branches 경고.**
+
+### 1. `session close --auto-cleanup-branches` 옵션 (1.9.224 패턴 확장)
+- 50+ release/* merged branches 시 자동 정리 (keep 10)
+- 안전: 1.9.235 가드 (merged 만, 현재 branch 보호)
+- `--auto-apply-delivered` (1.9.224) 와 동일한 자율 모드 패턴
+
+### 2. handoff body 50+ branches 경고 자동 노출
+- `## 🗑 release/* branches 누적 N개 (50+) (1.9.237)` 본문 섹션 자동
+- 3 가지 정리 옵션 자동 안내:
+  - 수동: `leerness release cleanup --apply --keep 10`
+  - 마감 자동: `session close --auto-cleanup-branches`
+  - drift 자동: `drift check --auto-fix` (1.9.236)
+- AI/사용자 누적 폐기물 가시화
+
+### 3. release cleanup 생태계 완성 (3 라운드 누적)
+| 라운드 | 기능 |
+|---|---|
+| 1.9.235 | CLI 신설 (수동) |
+| 1.9.236 | MCP 66 + drift --auto-fix 통합 |
+| **1.9.237** | **session close 자동 + handoff body 경고** ⭐ |
+
+### 4. 누적 회귀 (1.9.207~236) — 모두 유지
+
+### 5. stress-v182 — 15/15 PASS
+- 1.9.237 (5): VERSION + flag 코드 + session close 안내 + handoff body 경고 + 격리 no-warning
+- 성능 (2): cold_start avg 387ms / handoff 4706ms
+- 누적 회귀 (8): 1.9.207~236
+
+### 6. 자동 release (99 라운드 main-push streak · 60 라운드 npm publish streak 🎉)
+
+🎉 **60 라운드 npm publish streak 달성** + 1 라운드 후 **R100 main-push streak 도달**
+
+---
+
+## 1.9.236 — 2026-05-24
+
+**🔌 MCP 66번째 도구 (release_cleanup) + drift check --auto-fix 통합 (50+ branches 자동 정리).**
+
+### 1. MCP 66번째 도구 — `leerness_release_cleanup`
+- 1.9.235 release cleanup CLI 를 외부 AI 에 노출
+- 인자: `{ path?, apply? (default false), keep? (default 5) }`
+- 응답: `{ apply, keep, total, merged, unmerged, deleteCount, toDelete[], recent[], unmergedSample[] }`
+- MCP 65 → **66** (+1)
+
+### 2. `drift check --auto-fix` release cleanup 통합 (1.9.82/225 패턴 확장)
+- merged `release/*` branches 50개 초과 시 자동 정리
+- 안전: keep 10 (최근 10개 유지), merged 만 삭제 (unmerged 보호)
+- 1.9.82 audit --fix → 1.9.225 delivered → 1.9.236 release cleanup (3 라운드 누적)
+
+### 3. drift 회복 시스템 확장 매트릭스 (4 자동 회복 통합)
+| 라운드 | 신호 | 자동 회복 |
+|---|---|---|
+| 1.9.39 | critical | session close 자동 |
+| 1.9.82 | 보안 | audit --fix |
+| 1.9.225 | delivered | requests 자동 완료 |
+| **1.9.236** | **release-branch** | **release cleanup --keep 10** ⭐ |
+
+### 4. 누적 회귀 (1.9.207~235) — 모두 유지
+
+### 5. stress-v181 — 15/15 PASS
+- 1.9.236 (5): VERSION + MCP 66 등록 + 실 호출 + keep 파라미터 + drift 통합 코드
+- 성능 (2): cold_start avg 389ms / MCP 66 tools/list 363ms
+- 누적 회귀 (8): 1.9.207~235
+
+### 6. 자동 release (98 라운드 main-push streak · 59 라운드 npm publish streak)
+
+🔌 **drift 자동 회복 4 통합** — leerness 가 스스로 누적 폐기물 정리
+
+---
+
 ## 1.9.235 — 2026-05-23
 
 **🗑 leerness release cleanup CLI — local release/* branches 정리 + --keep BUG fix.**

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.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)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.237-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v182-15%2F15-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-66-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-52-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-193-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-99_rounds-success)]() [![npm-streak](https://img.shields.io/badge/🎉_npm--publish-60_streak-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![cleanup](https://img.shields.io/badge/🗑_release--cleanup-3_라운드_완성-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-387ms-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.235  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.237  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🗑 release cleanup · 191 branches 누적 정리 + BUG fix        ║
+  ║  🎉 60 npm publish streak · release cleanup 3 라운드 완성    ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.235';
+const VERSION = '1.9.237';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -6573,6 +6573,25 @@ function handoff(root) {
     }
   } catch {}
 
+  // 1.9.237: handoff 본문 release/* 누적 경고 — 50+ branches merged 시 자동 안내
+  //   1.9.220 비정상종료 release-branch-pending 신호의 본문 보강 (handoff 헤드라인은 ‘🔌 비정상종료’ 만 표시)
+  try {
+    const branchR = cp.spawnSync('git', ['branch', '--merged', 'main', '--list', 'release/*'], { cwd: root, encoding: 'utf8' });
+    if (branchR.status === 0) {
+      const mergedCnt = (branchR.stdout || '').split('\n').filter(l => l.trim() && /release\/\d+\.\d+\.\d+/.test(l)).length;
+      if (mergedCnt > 50) {
+        const isTty = process.stdout && process.stdout.isTTY;
+        const yl5 = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+        const dm5 = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+        log('');
+        log(yl5(`## 🗑 release/* branches 누적 ${mergedCnt}개 (50+) (1.9.237)`));
+        log(dm5(`  → 수동 정리: leerness release cleanup --apply --keep 10`));
+        log(dm5(`  → 마감 시 자동: session close --auto-cleanup-branches`));
+        log(dm5(`  → drift 자동 회복: drift check --auto-fix (1.9.236, 50+ 시)`));
+      }
+    }
+  } catch {}
+
   // 1.9.224: handoff 본문 자동 노출 — delivered 패턴 후보 ≥ 1건 시 (1.9.223 확장)
   //   "Round X.Y.Z — 구현 완료" 패턴이 누적되면 본문 섹션으로 자동 안내 (헤드라인만으로는 놓치기 쉬움)
   // 1.9.225: LEERNESS_AUTO_APPLY_DELIVERED=1 env 활성 시 handoff 첫 호출에서 자동 적용 (자율 모드용 opt-in)
@@ -10507,6 +10526,40 @@ function sessionClose(root, opts = {}) {
           log(grn(`  ✓ 멱등성 검사 통과 — verified ${idemp.summary.verifiedAreas} 영역`));
         }
       } catch {}
+      // 1.9.237: session close --auto-cleanup-branches — 50+ release/* branches 시 자동 정리
+      //   1.9.224 패턴 (--auto-apply-delivered) 확장 — 마감 시 운영 누적 폐기물 자동 정리
+      //   안전: keep 10, merged 만, 현재 branch 보호
+      try {
+        const branchR = cp.spawnSync('git', ['branch', '--merged', 'main', '--list', 'release/*'], { cwd: root, encoding: 'utf8' });
+        if (branchR.status === 0) {
+          const merged = (branchR.stdout || '').split('\n')
+            .map(l => l.replace(/^\*?\s+/, '').trim())
+            .filter(l => l && /^release\/\d+\.\d+\.\d+$/.test(l));
+          if (merged.length > 50) {
+            if (has('--auto-cleanup-branches')) {
+              merged.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 curR = cp.spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: root, encoding: 'utf8' });
+              const cur = (curR.stdout || '').trim();
+              const toDelete = merged.slice(10).filter(b => b !== cur);
+              let okCnt = 0;
+              for (const b of toDelete) {
+                const r = cp.spawnSync('git', ['branch', '-d', b], { cwd: root, encoding: 'utf8' });
+                if (r.status === 0) okCnt++;
+              }
+              log(grn(`  ✓ release 정리 ${okCnt}/${toDelete.length}건 (--auto-cleanup-branches 1.9.237, keep 10)`));
+            } else {
+              log(yel(`  🗑 release/* merged ${merged.length}개 (50+) — cleanup 가능 (1.9.235)`));
+              log(dim(`     → leerness release cleanup --apply --keep 10 (수동)`));
+              log(dim(`     → 또는 session close --auto-cleanup-branches (1.9.237 자동)`));
+            }
+          }
+        }
+      } catch {}
       // 1.9.232: 마감 시 pulse 한 줄 자동 노출 — 다음 라운드 진입 시 즉시 상태 인지
       try {
         const rh = _computeRoundHistory(root);
@@ -13480,6 +13533,42 @@ function driftCheckCmd(root, opts = {}) {
       log(`⚠ delivered auto-apply 오류 (1.9.225): ${e.message}`);
     }
   }
+  // 1.9.236: drift check --auto-fix 에 release cleanup 통합 (1.9.235 회수)
+  //   누적된 50개+ release/* branches → abnormal-shutdown release-branch-pending 신호 가중
+  //   안전: keep 10 (최근 10개 유지), merged 만 삭제 (1.9.235 안전 가드)
+  //   임계: 50개 초과 시만 자동 정리 (소량 누적은 정상 운영)
+  if (autoFix) {
+    try {
+      const branchR = cp.spawnSync('git', ['branch', '--merged', 'main', '--list', 'release/*'], { cwd: root, encoding: 'utf8' });
+      if (branchR.status === 0) {
+        const merged = (branchR.stdout || '').split('\n')
+          .map(l => l.replace(/^\*?\s+/, '').trim())
+          .filter(l => l && /^release\/\d+\.\d+\.\d+$/.test(l));
+        if (merged.length > 50) {
+          log('');
+          log(`🗑 --auto-fix 활성 (1.9.236) — release/* merged ${merged.length}개 (50+) 자동 정리 (keep 10)...`);
+          // 정렬 (semver desc)
+          merged.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 currentBranchR = cp.spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: root, encoding: 'utf8' });
+          const currentBranch = (currentBranchR.stdout || '').trim();
+          const toDelete = merged.slice(10).filter(b => b !== currentBranch);
+          let ok = 0;
+          for (const b of toDelete) {
+            const r = cp.spawnSync('git', ['branch', '-d', b], { cwd: root, encoding: 'utf8' });
+            if (r.status === 0) ok++;
+          }
+          log(`✓ release cleanup 자동 완료 ${ok}/${toDelete.length}건 (keep 10)`);
+        }
+      }
+    } catch (e) {
+      log(`⚠ release cleanup auto-fix 오류 (1.9.236): ${e.message}`);
+    }
+  }
   if (autoFix && level === '🔴 critical' && !hasSecurityFired) {
     log('');
     log(`🔧 --auto-fix 활성 — session close 자동 실행 중...`);
@@ -14468,7 +14557,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_round_history', description: '1.9.226 — 자율 라운드 통계. git tag v1.9.X 기반 누적 라운드 카운트 + 다음 마일스톤 (50/75/100/125/150/175/200/250/300/400/500) + 평균 rounds/day. 응답: { currentVersion, roundCount, baselineVersion, latestTags[], nextMilestone, roundsToNextMilestone, firstTagAt, latestTagAt, daysActive, avgRoundsPerDay }. 외부 AI가 "이 프로젝트는 얼마나 진행됐고 다음 마일스톤까지 몇 라운드 남았나?"를 회수. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_milestones', description: '1.9.229 (1.9.226 확장) — 도달 마일스톤 + 다음 ETA. git tag 순차 분석으로 25/50/75/100/125/150/175/200/250/300/400/500 마일스톤 도달 일자 + 다음 마일스톤 ETA (현재 속도 기준) 계산. 응답: { totalRounds, reached: [{milestone, version, reachedAt, daysFromBaseline}], next: {milestone, roundsRemaining, etaDays, etaDate}, baselineAt, avgRoundsPerDay }. 외부 AI가 "지금까지 어떤 마일스톤을 언제 달성했고 다음 마일스톤 예상 도달일은?"을 회수. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_pulse', description: '1.9.231 — 한 줄 종합 요약 (10 핵심 지표). 응답: { version, roundCount, mcpTools, memorySurface, security, health, driftScore, nextMilestone, etaDays, abnormalShutdown }. 외부 AI가 "leerness 상태 한 눈에 보기"를 가벼운 단일 호출로 회수. handoff 보다 5배 빠름 (drift/health 계산 skip). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
-    { name: 'leerness_commands', description: '1.9.233 — 카테고리화된 전체 CLI 명령 목록 (9 카테고리). 응답: { version, totalCommands, categories: { status, task, memory, audit, workflow, release, skill, bridge, config } }. 외부 AI가 "leerness 가 제공하는 명령이 뭐가 있나"를 직접 회수. 매뉴얼/도움말 동적 생성. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
+    { name: 'leerness_commands', description: '1.9.233 — 카테고리화된 전체 CLI 명령 목록 (9 카테고리). 응답: { version, totalCommands, categories: { status, task, memory, audit, workflow, release, skill, bridge, config } }. 외부 AI가 "leerness 가 제공하는 명령이 뭐가 있나"를 직접 회수. 매뉴얼/도움말 동적 생성. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
+    { name: 'leerness_release_cleanup', description: '1.9.236 (1.9.235 자동 회수) — local release/* branches 정리. main 에 merge된 것만 후보 (unmerged 보호, 현재 branch 보호). 응답: { apply, keep, total, merged, unmerged, deleteCount, toDelete[], recent[], unmergedSample[] }. 외부 AI가 "운영 누적 release branches 정리 가능?"을 회수. 기본 dry-run, apply: true 시에만 실 삭제. 인자: { path?, apply? (default false), keep? (default 5) }', inputSchema: { type: 'object', properties: { path: { type: 'string' }, apply: { type: 'boolean' }, keep: { type: 'number' } } } }
   ];
 
   function send(obj) {
@@ -14645,6 +14735,12 @@ function mcpServeCmd(root) {
             // 1.9.233: 카테고리화된 전체 CLI 명령 목록
             cliArgs = ['commands', '--json'];
             break;
+          case 'leerness_release_cleanup':
+            // 1.9.236 (1.9.235): local release/* branches 정리
+            cliArgs = ['release', 'cleanup', '--json'];
+            if (args.apply === true) cliArgs.push('--apply');
+            if (typeof args.keep === 'number') cliArgs.push('--keep', String(args.keep));
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }

package/package.json

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