leerness 1.9.225 → 1.9.227

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # Changelog
 
+## 1.9.227 — 2026-05-23
+
+**📊 handoff/session close --json roundHistory 통합 (6 필드 완성) + CLAUDE/AGENTS drift 차단.**
+
+### 1. handoff --json 6번째 통합 필드 `roundHistory`
+- `{ roundCount, baselineVersion, nextMilestone, roundsToNextMilestone, daysActive, avgRoundsPerDay }`
+- 외부 CI/모니터링이 라운드 진행도 + 다음 마일스톤 직접 회수
+- 1.9.218 (4 필드) → 1.9.223 (5 필드) → 1.9.227 (**6 필드 완성**)
+
+### 2. session close --json 6번째 통합 필드 `roundHistory`
+- 마감 시 진행도 통계 동기 노출
+- handoff/session close JSON 동일 패턴 유지
+
+### 3. CLAUDE.md / AGENTS.md drift 차단 갱신
+- 1.9.222~227 6 라운드 누적 통합 (이전 갱신: 1.9.214)
+- 신규 섹션: "사용자 요청 자동 완료 시스템 (1.9.223~225)" + "라운드 진행도 가시화 (1.9.226~227)"
+- 새 메타파일 (last update: 1.9.214 → 1.9.227, 6 라운드 누적)
+
+### 4. 6 통합 필드 매트릭스 완성 (handoff/session close --json 일관성)
+- userRequestsAudit (1.9.207/218)
+- preWakeAudit (1.9.209/218)
+- idempotencyAudit (1.9.212/218)
+- abnormalShutdown (1.9.220/221)
+- deliveredRequests (1.9.223)
+- **roundHistory** (1.9.226/227) ⭐
+
+### 5. 누적 회귀 (1.9.207~226) — 모두 유지
+
+### 6. stress-v172 — 17/17 PASS
+- 1.9.227 (7): VERSION + handoff JSON + session close JSON + 6 필드 검증 (handoff) + 6 필드 검증 (session close) + CLAUDE 누적 + AGENTS 누적
+- 성능 (2): cold_start avg 400ms / handoff --json 641ms
+- 누적 회귀 (8): 1.9.207~226
+
+### 7. 자동 release (89 라운드 main-push streak · 50 라운드 npm publish streak 🎉)
+
+📊 **JSON 통합 매트릭스 완성** — 외부 자동화/CI 가 leerness 상태 6 차원 동기 회수
+
+🎉 **50 라운드 npm publish streak 달성**
+
+---
+
+## 1.9.226 — 2026-05-23
+
+**🔄 round-history CLI + handoff 헤드라인 라운드 카운터 + MCP 62번째 도구.**
+
+### 1. `leerness round-history` 새 명령 — 자율 라운드 통계
+- git tag `v1.9.X` 기반 누적 라운드 카운트 (graceful fallback: git 없으면 0)
+- 응답: `{ currentVersion, roundCount, baselineVersion, latestTags[], nextMilestone, roundsToNextMilestone, firstTagAt, latestTagAt, daysActive, avgRoundsPerDay }`
+- 마일스톤 자동 감지: 50/75/100/125/150/175/200/250/300/400/500
+- `--json` 옵션 (외부 자동화)
+
+### 2. handoff 헤드라인 17번째 요소
+- 5 라운드 이상 누적 시 `🔄 R<N>` 자동 노출
+- 다음 마일스톤이 20 라운드 이내일 때: `🔄 R182 → R200 (18R 남음)` 강조
+- 자율 모드 진행도 한눈에
+
+### 3. MCP 62번째 도구 — `leerness_round_history`
+- 외부 AI가 "이 프로젝트는 얼마나 진행됐고 다음 마일스톤까지 몇 라운드 남았나?"를 회수
+- MCP 61 → 62 (+1)
+
+### 4. 실 측정 (leerness 자체 프로젝트)
+- 누적 라운드: **182R** (baseline v1.9.6 → v1.9.225)
+- 활동 기간: 14일 / 평균 **13 rounds/day**
+- 다음 마일스톤: **R200 (18 라운드 남음)**
+
+### 5. 누적 회귀 (1.9.207~225) — 모두 유지
+
+### 6. stress-v171 — 16/16 PASS
+- 1.9.226 (7): VERSION + round-history CLI + --json + git 없는 fallback + handoff 헤드라인 + MCP 62 등록 + MCP 실 호출
+- 성능 (2): cold_start avg 336ms / round-history 535ms
+- 누적 회귀 (7): 1.9.207~225
+
+### 7. 자동 release (88 라운드 main-push streak · 49 라운드 npm publish streak)
+
+🔄 **자율 라운드 진행도 가시화** — handoff 한 줄에서 마일스톤 예측 가능
+
+---
+
 ## 1.9.225 — 2026-05-22
 
 **🔧 drift check --auto-fix delivered 통합 + LEERNESS_AUTO_APPLY_DELIVERED env opt-in.**

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.225-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v170-14%2F14-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-61-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-155-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-87_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![drift-fix](https://img.shields.io/badge/🔧_drift--auto--fix-delivered_통합-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-367ms-success)]() [![install](https://img.shields.io/badge/npm_i_leerness-즉시_사용_가능-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-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.227-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v172-17%2F17-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-62-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-183-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-89_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![json-fields](https://img.shields.io/badge/📊_JSON_통합_필드-6%2F6-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-400ms-success)]() [![install](https://img.shields.io/badge/npm_i_leerness-즉시_사용_가능-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.225  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.227  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🔧 drift --auto-fix delivered + AUTO_APPLY env opt-in      ║
+  ║  📊 handoff/session close --json 6 통합 필드 완성              ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.225';
+const VERSION = '1.9.227';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -2054,6 +2054,84 @@ function _compareSemver(a, b) {
   return 0;
 }
 
+// 1.9.226: round-history — git tag v1.9.X 기반 자율 라운드 통계 + 다음 마일스톤
+//   git이 없거나 tag가 없으면 graceful fallback (current version + 0 history)
+//   응답: { currentVersion, roundCount, baselineVersion, latestTags[], nextMilestone, roundsToNextMilestone, firstTagAt, latestTagAt, daysActive, avgRoundsPerDay }
+function _computeRoundHistory(root) {
+  const result = {
+    currentVersion: VERSION,
+    roundCount: 0,
+    baselineVersion: null,
+    latestTags: [],
+    nextMilestone: null,
+    roundsToNextMilestone: null,
+    firstTagAt: null,
+    latestTagAt: null,
+    daysActive: 0,
+    avgRoundsPerDay: 0
+  };
+  try {
+    // git tag --list 'v1.9.*' --sort=creatordate (시간순)
+    const r = cp.spawnSync('git', ['tag', '--list', 'v1.9.*', '--sort=creatordate', '--format=%(refname:short)|%(creatordate:iso8601)'], {
+      cwd: root, encoding: 'utf8', timeout: 5000
+    });
+    if (r.status !== 0 || !r.stdout) return result;
+    const lines = r.stdout.split('\n').filter(l => l.trim() && /^v\d+\.\d+\.\d+\|/.test(l));
+    if (lines.length === 0) return result;
+    const tags = lines.map(l => {
+      const [name, date] = l.split('|');
+      return { name: name.trim(), version: name.replace(/^v/, '').trim(), date: date.trim() };
+    });
+    result.roundCount = tags.length;
+    result.baselineVersion = tags[0].version;
+    result.firstTagAt = tags[0].date;
+    result.latestTagAt = tags[tags.length - 1].date;
+    // 최근 10개
+    result.latestTags = tags.slice(-10).reverse().map(t => ({ version: t.version, date: t.date.split('T')[0] }));
+    // 다음 마일스톤 (50/100/150/200/300/...)
+    const milestones = [50, 75, 100, 125, 150, 175, 200, 250, 300, 400, 500];
+    const next = milestones.find(m => m > result.roundCount);
+    if (next != null) {
+      result.nextMilestone = next;
+      result.roundsToNextMilestone = next - result.roundCount;
+    }
+    // 일일 평균
+    const first = new Date(result.firstTagAt).getTime();
+    const last = new Date(result.latestTagAt).getTime();
+    const days = Math.max(1, Math.floor((last - first) / 86400000));
+    result.daysActive = days;
+    result.avgRoundsPerDay = Math.round((result.roundCount / days) * 100) / 100;
+  } catch {}
+  return result;
+}
+
+function roundHistoryCmd(root) {
+  root = absRoot(root);
+  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 dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+  const data = _computeRoundHistory(root);
+  if (has('--json')) { log(JSON.stringify(data, null, 2)); return; }
+  log(cy(`# leerness round-history (1.9.226) — 자율 라운드 통계`));
+  log('');
+  log(`  📦 현재 버전: ${gr(data.currentVersion)}`);
+  log(`  🔄 누적 라운드: ${gr(String(data.roundCount))}`);
+  if (data.baselineVersion) log(`  📍 baseline: v${data.baselineVersion} (${(data.firstTagAt || '').split('T')[0]})`);
+  if (data.latestTagAt) log(`  ⏰ 최근 tag: ${(data.latestTagAt || '').split('T')[0]}`);
+  if (data.daysActive > 0) log(`  📊 활동: ${data.daysActive}일 / 평균 ${gr(data.avgRoundsPerDay + ' rounds/day')}`);
+  log('');
+  if (data.nextMilestone != null) {
+    log(yl(`  🎯 다음 마일스톤: R${data.nextMilestone} (${data.roundsToNextMilestone} 라운드 남음)`));
+  } else {
+    log(gr(`  🎉 모든 마일스톤 달성 (500+)`));
+  }
+  log('');
+  log(`  최근 10 tags:`);
+  data.latestTags.forEach(t => log(`    • v${t.version} (${t.date})`));
+}
+
 // 1.9.208: 플랫폼/API 제약 사전 체크 (사용자 명시)
 //   "사용자의 명령을 받으면, 고려해야하는 부분을 먼저 확인하고 진행하게 하면 어떨지"
 //   "특정 플랫폼의 API ... 호출속도가 초당 5회 이하로만 해야한다는 규정을 먼저 확인"
@@ -5825,6 +5903,18 @@ function handoff(root) {
           ids: delivered.candidates.map(c => c.id)
         };
       } catch {}
+      // 1.9.227: roundHistory 통합 (handoff JSON 6번째 통합 필드) — 자율 진행도 외부 회수
+      try {
+        const rh = _computeRoundHistory(root);
+        result.roundHistory = {
+          roundCount: rh.roundCount,
+          baselineVersion: rh.baselineVersion,
+          nextMilestone: rh.nextMilestone,
+          roundsToNextMilestone: rh.roundsToNextMilestone,
+          daysActive: rh.daysActive,
+          avgRoundsPerDay: rh.avgRoundsPerDay
+        };
+      } catch {}
     } catch {}
     try {
       const pwState = _loadPreWakeReport(root);
@@ -5987,6 +6077,17 @@ function handoff(root) {
           parts.push(`🌐 official ${m.total}/${m.cacheTotal} (${ageStr}${status})`);
         }
       } catch {}
+      // 17) 1.9.226: round-history 헤드라인 — 자율 라운드 카운터 + 다음 마일스톤 (5 라운드 이상 시만 표시)
+      try {
+        const rh = _computeRoundHistory(root);
+        if (rh.roundCount >= 5) {
+          let label = `🔄 R${rh.roundCount}`;
+          if (rh.nextMilestone != null && rh.roundsToNextMilestone <= 20) {
+            label += ` → R${rh.nextMilestone} (${rh.roundsToNextMilestone}R 남음)`;
+          }
+          parts.push(label);
+        }
+      } catch {}
       // 12) 1.9.204: 자동 모드 활성 표시 (사용자 명시) — R-0001 every-round 룰 활성 시 헤드라인 노출
       try {
         const autoRule = _getAutoLoopRule(root);
@@ -9939,6 +10040,18 @@ function sessionClose(root, opts = {}) {
           autoCompleteAvailable: delivered.candidates.length > 0
         };
       } catch {}
+      // 1.9.227: roundHistory 통합 (session close JSON 6번째 통합 필드)
+      try {
+        const rh = _computeRoundHistory(root);
+        jsonResult.roundHistory = {
+          roundCount: rh.roundCount,
+          baselineVersion: rh.baselineVersion,
+          nextMilestone: rh.nextMilestone,
+          roundsToNextMilestone: rh.roundsToNextMilestone,
+          daysActive: rh.daysActive,
+          avgRoundsPerDay: rh.avgRoundsPerDay
+        };
+      } catch {}
     } catch {}
     try {
       // 1.9.209: pre-wake-audit 자동 실행 + 저장 (sleep 전 자동 점검)
@@ -13889,7 +14002,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_intent_classify', description: '1.9.216 (1.9.213 사용자 명시) — 사용자 의도 파악 + scope expansion 게이트. 응답: { intent: precise|broad|default, signals, domain, explicitMentions, expansionCandidates, mode: dry-run }. 3원칙 안전: (1) Always-Off Opt-In, (2) Dry-run 기본 (실행 X), (3) 명시 vs 추론 분리 라벨링. 5 도메인 (game/web/api/cli/data). 외부 AI가 "이 요청은 정확히 그것만 / 포괄적 / 기본인가?"를 회수. 인자: { request (required), path? }', inputSchema: { type: 'object', properties: { request: { type: 'string' }, path: { type: 'string' } }, required: ['request'] } },
     { name: 'leerness_idempotency_audit', description: '1.9.216 (1.9.212 사용자 명시) — 멱등성 위반 탐지. 4영역 점검: rule-duplicate (medium) / task-duplicate-request (medium) / user-request-duplicate (low) / wakeup-duplicate (high). 응답: { violations[], verified[], summary: {totalViolations, high/medium/low, overall} }. 외부 AI가 "워크스페이스에 중복/충돌이 있나?"를 회수. 🎉 MCP 58 도구 마일스톤 (50→58). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_session_resume', description: '1.9.221 (1.9.220 사용자 명시) — 비정상 종료 감지 + 자율 재개. 5신호 분석: last-handoff-stale / wakeup-missed / in-progress-stale / auto-resume-plan-unused / release-branch-pending. 응답: { abnormalShutdown, severity (none/low/medium/high), signals[], resumeGuide[] }. 외부 AI가 "절전/시스템종료/세션종료 후 leerness 상태가 정상인가? 어떻게 재개?"를 회수. 🎉 MCP 60 도구 마일스톤 (53→60, +7 in 1.9.168/216/221). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
-    { name: 'leerness_requests_auto_complete', description: '1.9.224 (1.9.223 자동 회수) — delivered 패턴 자동 감지 + 자동 완료. "Round X.Y.Z — 구현 완료" / "implemented" / "delivered" 패턴이 있는 open 요청 중 현재 버전 이하인 것을 후보로 분류. 응답: { total, candidates: [{id, text, claimedVersion, currentVersion, deliveredKeyword, recordedAt}], currentVersion, applied (apply=true 시), completedIds[] }. 외부 AI가 "운영 누적된 가짜 미답 신호 정리 가능한가?"를 회수. 기본 dry-run, apply: true 명시 시에만 실 적용. 인자: { path?, apply? (default false) }', inputSchema: { type: 'object', properties: { path: { type: 'string' }, apply: { type: 'boolean' } } } }
+    { name: 'leerness_requests_auto_complete', description: '1.9.224 (1.9.223 자동 회수) — delivered 패턴 자동 감지 + 자동 완료. "Round X.Y.Z — 구현 완료" / "implemented" / "delivered" 패턴이 있는 open 요청 중 현재 버전 이하인 것을 후보로 분류. 응답: { total, candidates: [{id, text, claimedVersion, currentVersion, deliveredKeyword, recordedAt}], currentVersion, applied (apply=true 시), completedIds[] }. 외부 AI가 "운영 누적된 가짜 미답 신호 정리 가능한가?"를 회수. 기본 dry-run, apply: true 명시 시에만 실 적용. 인자: { path?, apply? (default false) }', inputSchema: { type: 'object', properties: { path: { type: 'string' }, apply: { type: 'boolean' } } } },
+    { 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' } } } }
   ];
 
   function send(obj) {
@@ -14050,6 +14164,10 @@ function mcpServeCmd(root) {
             cliArgs = ['requests', 'auto-complete', '--path', targetPath, '--json'];
             if (args.apply === true) cliArgs.push('--apply');
             break;
+          case 'leerness_round_history':
+            // 1.9.226: 자율 라운드 통계 + 다음 마일스톤
+            cliArgs = ['round-history', '--path', targetPath, '--json'];
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -17681,6 +17799,8 @@ async function main() {
   if (cmd === 'requests')                           return requestsCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   // 1.9.220: leerness session-resume — 비정상 종료 감지 + 자율 재개 가이드 (사용자 명시)
   if (cmd === 'session-resume')                     return sessionResumeCmd(arg('--path', process.cwd()));
+  // 1.9.226: leerness round-history — 자율 라운드 통계 + 다음 마일스톤
+  if (cmd === 'round-history')                      return roundHistoryCmd(arg('--path', process.cwd()));
   // 1.9.208: leerness constraints <list|check|add> — 플랫폼/API 제약 사전 체크 (사용자 명시)
   if (cmd === 'constraints')                        return constraintsCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   // 1.9.209: leerness pre-wake-audit — sleep 전 sub-agent audit (사용자 명시)

package/package.json

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