leerness 1.9.228 → 1.9.230

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # Changelog
 
+## 1.9.230 — 2026-05-23
+
+**📊 handoff/session close/health --json milestones 통합 (7 필드 완성) + 헤드라인 ETA 임박 표시.**
+
+### 1. handoff/session close/health --json 7번째 통합 필드 `milestones`
+- 1.9.229 milestones 데이터를 JSON 3 명령 모두에 통합
+- 동일 형식: `{ reachedCount, reached: [{milestone, version, reachedAt}], next, avgRoundsPerDay }`
+- 1.9.218 (4 필드) → 1.9.223 (5) → 1.9.227 (6) → 1.9.230 (**7 필드**)
+
+### 2. 3 명령 milestones 동일 형식 일관성
+- handoff/session close/health 모두 동일한 `milestones` 객체 반환
+- 외부 자동화/CI 가 어느 명령으로 조회해도 동일 결과
+- 일관성 매트릭스: 3 명령 × 7 필드 = **21 통합 포인트**
+
+### 3. handoff 헤드라인 임박 ETA 표시 (1.9.230)
+- 다음 마일스톤이 **10R 이내** + ETA가 **7일 이내** 일 때만 별도 노출
+- `🎯 R200 ETA 2026-05-24` 형식 (현재는 14R 남아 보호 가드 발동 X)
+- 마일스톤 임박 시 자동 강조 (스팸 방지: 조건 충족 시만)
+
+### 4. 누적 회귀 (1.9.207~229) — 모두 유지
+
+### 5. stress-v175 — 17/17 PASS
+- 1.9.230 (7): VERSION + handoff/session close/health JSON + 3 명령 일관성 + 7 필드 검증 + 헤드라인 ETA
+- 성능 (2): cold_start avg 439ms / handoff --json (7 필드) 1019ms
+- 누적 회귀 (8): 1.9.207~229
+
+### 6. 자동 release (92 라운드 main-push streak · 53 라운드 npm publish streak)
+
+📊 **JSON 통합 매트릭스 7 필드 완성** — 외부 자동화가 leerness 상태를 7 차원 동기 회수 (3 명령 일관성)
+
+---
+
+## 1.9.229 — 2026-05-23
+
+**🎯 leerness milestones CLI + MCP 63번째 도구 (도달 마일스톤 + ETA 예측).**
+
+### 1. `leerness milestones` 새 명령
+- git tag 순차 분석으로 25/50/75/100/125/150/175/200/250/300/400/500 마일스톤 도달 시점 회수
+- 각 마일스톤별: `{milestone, version, reachedAt, daysFromBaseline}`
+- 다음 마일스톤 ETA 계산 (현재 속도 기준): `{milestone, roundsRemaining, etaDays, etaDate}`
+- `--json` 옵션
+- 1.9.226 round-history 확장 (간단 통계 → 도달 이력 + ETA)
+
+### 2. MCP 63번째 도구 — `leerness_milestones`
+- 외부 AI가 "프로젝트 마일스톤 진척도 + 다음 달성 예상일" 직접 회수
+- MCP 62 → 63 (+1)
+
+### 3. 실 측정 — leerness 자체 마일스톤 이력 (7개 달성)
+- R25 → v1.9.68 (2026-05-19, +11d)
+- R50 → v1.9.93 (2026-05-20, +11d)
+- R75 → v1.9.118 (2026-05-20, +11d)
+- R100 → v1.9.143 (2026-05-20, +11d)
+- R125 → v1.9.168 (2026-05-20, +12d)
+- R150 → v1.9.193 (2026-05-21, +12d)
+- R175 → v1.9.218 (2026-05-22, +14d)
+- **다음: R200** — 2026-05-24 ETA (15 라운드 남음, ~2일 후)
+
+### 4. 누적 회귀 (1.9.207~228) — 모두 유지
+
+### 5. stress-v174 — 17/17 PASS
+- 1.9.229 (7): VERSION + CLI + reached 형태 + next ETA + git fallback + MCP 63 + 실 호출
+- 성능 (2): cold_start avg 442ms / milestones 717ms
+- 누적 회귀 (8): 1.9.207~228
+
+### 6. 자동 release (91 라운드 main-push streak · 52 라운드 npm publish streak)
+
+🎯 **자율 모드 진척도 시각화 완성** — 도달 이력 + 예측 ETA 모두 가시화
+
+---
+
 ## 1.9.228 — 2026-05-23
 
 **📊 health --json roundHistory 통합 (JSON 3 명령 일관성) + session-workflow.md drift 차단 + 헤드라인 label 갱신.**

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.228-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v173-15%2F15-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-62-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-184-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-90_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![json-3cmd](https://img.shields.io/badge/📊_JSON_3_명령_일관성-handoff%2Bclose%2Bhealth-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-414ms-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.230-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v175-17%2F17-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-63-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-186-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-92_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![json-7fields](https://img.shields.io/badge/📊_JSON_통합_필드-7%2F7-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-439ms-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.228  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.230  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  📊 health --json roundHistory + 3 명령 일관성 완성             ║
+  ║  📊 JSON 3 명령 × 7 필드 = 21 통합 포인트                     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.228';
+const VERSION = '1.9.230';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -2105,6 +2105,97 @@ function _computeRoundHistory(root) {
   return result;
 }
 
+// 1.9.229: milestones — 도달한 마일스톤 일자 + 다음 마일스톤 예상 시점 (1.9.226 round-history 확장)
+//   git tag 순차 분석 → 50/75/100/... 도달 시점의 tag 와 일자 회수
+//   응답: { reached: [{milestone, version, reachedAt, daysFromBaseline}], next: {milestone, roundsRemaining, eta}, totalRounds, avgRoundsPerDay }
+function _computeMilestones(root) {
+  const result = {
+    totalRounds: 0,
+    reached: [],
+    next: null,
+    avgRoundsPerDay: 0,
+    baselineAt: null
+  };
+  try {
+    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.totalRounds = tags.length;
+    result.baselineAt = tags[0].date;
+    const milestones = [25, 50, 75, 100, 125, 150, 175, 200, 250, 300, 400, 500];
+    const baselineTime = new Date(tags[0].date).getTime();
+    // 1-indexed: tags[0] is round 1
+    for (const m of milestones) {
+      if (m <= tags.length) {
+        const t = tags[m - 1];
+        const reachedTime = new Date(t.date).getTime();
+        const daysFromBaseline = Math.floor((reachedTime - baselineTime) / 86400000);
+        result.reached.push({
+          milestone: m,
+          version: t.version,
+          reachedAt: t.date.split(' ')[0],
+          daysFromBaseline
+        });
+      }
+    }
+    // 다음 마일스톤 + 평균 속도로 ETA 계산
+    const lastTime = new Date(tags[tags.length - 1].date).getTime();
+    const days = Math.max(1, Math.floor((lastTime - baselineTime) / 86400000));
+    const avgPerDay = (tags.length / days);
+    result.avgRoundsPerDay = Math.round(avgPerDay * 100) / 100;
+    const nextM = milestones.find(m => m > tags.length);
+    if (nextM != null) {
+      const roundsRemaining = nextM - tags.length;
+      const etaDays = avgPerDay > 0 ? Math.ceil(roundsRemaining / avgPerDay) : null;
+      const etaDate = etaDays != null ? new Date(Date.now() + etaDays * 86400000).toISOString().split('T')[0] : null;
+      result.next = { milestone: nextM, roundsRemaining, etaDays, etaDate };
+    }
+  } catch {}
+  return result;
+}
+
+function milestonesCmd(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 = _computeMilestones(root);
+  if (has('--json')) { log(JSON.stringify(data, null, 2)); return; }
+  log(cy(`# leerness milestones (1.9.229) — 도달 마일스톤 + 다음 ETA`));
+  log('');
+  log(`  📦 총 라운드: ${gr(String(data.totalRounds))}`);
+  if (data.baselineAt) log(`  📍 baseline: ${(data.baselineAt || '').split(' ')[0]}`);
+  if (data.avgRoundsPerDay) log(`  📊 평균: ${gr(data.avgRoundsPerDay + ' rounds/day')}`);
+  log('');
+  if (data.reached.length === 0) {
+    log(dm(`  (도달 마일스톤 없음 — 첫 R25 마일스톤 진행 중)`));
+  } else {
+    log(`  도달 마일스톤 ${data.reached.length}개:`);
+    for (const m of data.reached) {
+      log(`    ✓ R${m.milestone} ${gr(`(v${m.version}, ${m.reachedAt}, +${m.daysFromBaseline}d)`)}`);
+    }
+  }
+  log('');
+  if (data.next) {
+    log(yl(`  🎯 다음 마일스톤: R${data.next.milestone}`));
+    log(`    • ${data.next.roundsRemaining} 라운드 남음`);
+    if (data.next.etaDays != null) {
+      log(`    • ETA: ${data.next.etaDate} (~${data.next.etaDays}일 후, 현재 속도 기준)`);
+    }
+  } else {
+    log(gr(`  🎉 모든 마일스톤 달성 (500+)`));
+  }
+}
+
 function roundHistoryCmd(root) {
   root = absRoot(root);
   const isTty = process.stdout && process.stdout.isTTY;
@@ -5915,6 +6006,16 @@ function handoff(root) {
           avgRoundsPerDay: rh.avgRoundsPerDay
         };
       } catch {}
+      // 1.9.230: milestones 통합 (handoff JSON 7번째 통합 필드) — 도달 마일스톤 + ETA
+      try {
+        const ms = _computeMilestones(root);
+        result.milestones = {
+          reachedCount: ms.reached.length,
+          reached: ms.reached.map(m => ({ milestone: m.milestone, version: m.version, reachedAt: m.reachedAt })),
+          next: ms.next,
+          avgRoundsPerDay: ms.avgRoundsPerDay
+        };
+      } catch {}
     } catch {}
     try {
       const pwState = _loadPreWakeReport(root);
@@ -6078,6 +6179,7 @@ function handoff(root) {
         }
       } catch {}
       // 17) 1.9.226: round-history 헤드라인 — 자율 라운드 카운터 + 다음 마일스톤 (5 라운드 이상 시만 표시)
+      // 1.9.230: 다음 마일스톤 ETA (10R 이내 + ETA 7일 이내일 때 강조)
       try {
         const rh = _computeRoundHistory(root);
         if (rh.roundCount >= 5) {
@@ -6086,6 +6188,13 @@ function handoff(root) {
             label += ` → R${rh.nextMilestone} (${rh.roundsToNextMilestone}R 남음)`;
           }
           parts.push(label);
+          // 1.9.230: 임박 마일스톤 ETA 별도 노출 (다음 마일스톤이 매우 가까울 때만)
+          try {
+            const ms = _computeMilestones(root);
+            if (ms.next && ms.next.roundsRemaining <= 10 && ms.next.etaDays != null && ms.next.etaDays <= 7) {
+              parts.push(`🎯 R${ms.next.milestone} ETA ${ms.next.etaDate}`);
+            }
+          } catch {}
         }
       } catch {}
       // 12) 1.9.204: 자동 모드 활성 표시 (사용자 명시) — R-0001 every-round 룰 활성 시 헤드라인 노출
@@ -10052,6 +10161,16 @@ function sessionClose(root, opts = {}) {
           avgRoundsPerDay: rh.avgRoundsPerDay
         };
       } catch {}
+      // 1.9.230: milestones 통합 (session close JSON 7번째 통합 필드)
+      try {
+        const ms = _computeMilestones(root);
+        jsonResult.milestones = {
+          reachedCount: ms.reached.length,
+          reached: ms.reached.map(m => ({ milestone: m.milestone, version: m.version, reachedAt: m.reachedAt })),
+          next: ms.next,
+          avgRoundsPerDay: ms.avgRoundsPerDay
+        };
+      } catch {}
     } catch {}
     try {
       // 1.9.209: pre-wake-audit 자동 실행 + 저장 (sleep 전 자동 점검)
@@ -14003,7 +14122,8 @@ function mcpServeCmd(root) {
     { 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_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_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' } } } }
   ];
 
   function send(obj) {
@@ -14168,6 +14288,10 @@ function mcpServeCmd(root) {
             // 1.9.226: 자율 라운드 통계 + 다음 마일스톤
             cliArgs = ['round-history', '--path', targetPath, '--json'];
             break;
+          case 'leerness_milestones':
+            // 1.9.229: 도달 마일스톤 + 다음 ETA
+            cliArgs = ['milestones', '--path', targetPath, '--json'];
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -16378,6 +16502,16 @@ function healthCmd(root) {
       avgRoundsPerDay: rh.avgRoundsPerDay
     };
   } catch { out.roundHistory = { error: 'roundHistory 점검 실패' }; }
+  // 1.9.230: health --json milestones 통합 (handoff/session close/health 3 명령 일관성 유지)
+  try {
+    const ms = _computeMilestones(root);
+    out.milestones = {
+      reachedCount: ms.reached.length,
+      reached: ms.reached.map(m => ({ milestone: m.milestone, version: m.version, reachedAt: m.reachedAt })),
+      next: ms.next,
+      avgRoundsPerDay: ms.avgRoundsPerDay
+    };
+  } catch { out.milestones = { error: 'milestones 점검 실패' }; }
   // 1.9.163: 5능력 매트릭스 자동 평가 (1.9.155 sub-agent 점검 → 코드 기반 자동화)
   //   각 능력을 코드 grep 으로 검출 → 0~100 점수. 사용자가 매 health 호출 시 leerness 자기 평가 확인.
   try {
@@ -17813,6 +17947,8 @@ async function main() {
   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.229: leerness milestones — 도달 마일스톤 + 다음 ETA (1.9.226 확장)
+  if (cmd === 'milestones')                         return milestonesCmd(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.228",
+  "version": "1.9.230",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",