leerness 1.9.229 → 1.9.231

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 1.9.231 — 2026-05-23
+
+**📍 leerness pulse 새 명령 (한 줄 종합 요약) + MCP 64번째 도구.**
+
+### 1. `leerness pulse` 새 명령 — 한 줄 종합 요약
+- 10 핵심 지표를 1 line으로: `📍 v1.9.231 · 🔄 R187 · 🔌 MCP 64 · 🧠 T0/D0/R0/P0/L0 · 🎯 R200 (1d) · 🔌 abnormal:medium`
+- `--json` 옵션: `{ version, roundCount, mcpTools, memorySurface, security, health, driftScore, nextMilestone, etaDays, abnormalShutdown }`
+- **handoff 보다 가벼움**: drift/health 계산 skip → 더 빠름
+
+### 2. MCP 64번째 도구 — `leerness_pulse`
+- 외부 AI가 가벼운 단일 호출로 leerness 전체 상태 회수
+- 1.9.230 (62) → 1.9.231 (**64**, +1)
+
+### 3. 실 측정 — leerness 자체 pulse
+- 👁 한눈에 보기: R187 / MCP 64 / R200 ETA 1d / abnormal:medium
+- handoff (~1019ms) → pulse (~945ms) — 더 빠르게 핵심만
+
+### 4. 누적 회귀 (1.9.207~230) — 모두 유지
+
+### 5. stress-v176 — 16/16 PASS
+- 1.9.231 (6): VERSION + CLI 한 줄 + --json + git fallback + MCP 64 + 실 호출
+- 성능 (2): cold_start avg 394ms / pulse 945ms
+- 누적 회귀 (8): 1.9.207~230
+
+### 6. 자동 release (93 라운드 main-push streak · 54 라운드 npm publish streak)
+
+📍 **빠른 상태 확인 명령 신설** — pulse 가 handoff보다 가벼워서 자동화에 최적
+
+---
+
+## 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 예측).**

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.229-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v174-17%2F17-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-63-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-185-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-91_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![milestones](https://img.shields.io/badge/🎯_milestones-R175_→_R200_ETA-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-442ms-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.231-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v176-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-64-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-187-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-93_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![pulse](https://img.shields.io/badge/📍_pulse-한_줄_종합_요약-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-394ms-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.229  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.231  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🎯 milestones CLI · MCP 63 · 도달 이력 + ETA 예측             ║
+  ║  📍 leerness pulse — 한 줄 종합 요약 + MCP 64 도구              ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.229';
+const VERSION = '1.9.231';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -2196,6 +2196,80 @@ function milestonesCmd(root) {
   }
 }
 
+// 1.9.231: leerness pulse — 한 줄 종합 요약 (10 핵심 지표)
+//   handoff 헤드라인의 축약 버전 — 사용자가 빠르게 상태 파악
+//   응답 (--json): { version, roundCount, mcpTools, memorySurface, security, health, driftScore, nextMilestone, etaDays, abnormal }
+function pulseCmd(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 rd = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
+  const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+  const data = {
+    version: VERSION,
+    roundCount: 0,
+    mcpTools: 0,
+    memorySurface: 'T0/D0/R0/P0/L0',
+    security: 'unknown',
+    health: 'unknown',
+    driftScore: null,
+    nextMilestone: null,
+    etaDays: null,
+    abnormalShutdown: 'none'
+  };
+  // 라운드 카운트
+  try { data.roundCount = _computeRoundHistory(root).roundCount; } catch {}
+  // MCP 도구 수 (코드 grep)
+  try {
+    const src = read(__filename);
+    const matches = src.match(/name: 'leerness_[a-z_]+'/g) || [];
+    data.mcpTools = matches.length;
+  } catch {}
+  // Memory Surface (T/D/R/P/L)
+  try {
+    const tasks = (read(progressTrackerPath(root)).split('\n').filter(l => /\|\s*in-progress\s*\|/.test(l)) || []).length;
+    const decisions = ((read(path.join(root, '.harness', 'decisions.md')) || '').match(/^##\s/gm) || []).length;
+    const rules = readRules(root).filter(r => r.status === 'active').length;
+    const milestonesCnt = ((read(path.join(root, '.harness', 'plan.md')) || '').match(/^- M-\d+/gm) || []).length;
+    const lessons = ((read(path.join(root, '.harness', 'lessons.md')) || '').match(/^###\s/gm) || []).length;
+    data.memorySurface = `T${tasks}/D${decisions}/R${rules}/P${milestonesCnt}/L${lessons}`;
+  } catch {}
+  // 마일스톤 + ETA
+  try {
+    const ms = _computeMilestones(root);
+    if (ms.next) {
+      data.nextMilestone = ms.next.milestone;
+      data.etaDays = ms.next.etaDays;
+    }
+  } catch {}
+  // 비정상 종료
+  try {
+    const ad = _detectAbnormalShutdown(root);
+    if (ad.abnormalShutdown) data.abnormalShutdown = ad.severity;
+  } catch {}
+  // drift score (간단 — env 설정 시 skip)
+  if (process.env.LEERNESS_NO_DRIFT_CHECK !== '1') {
+    // 직접 계산 skip — handoff 시 별도 호출이 빠름. pulse 는 가벼움 우선.
+  }
+  if (has('--json')) { log(JSON.stringify(data, null, 2)); return; }
+  // 한 줄 출력
+  let line = `📍 v${data.version} · 🔄 R${data.roundCount} · 🔌 MCP ${data.mcpTools} · 🧠 ${data.memorySurface}`;
+  if (data.nextMilestone) {
+    const eta = data.etaDays != null ? ` (${data.etaDays}d)` : '';
+    line += ` · 🎯 R${data.nextMilestone}${eta}`;
+  }
+  if (data.abnormalShutdown !== 'none') {
+    line += ` · 🔌 abnormal:${data.abnormalShutdown}`;
+  }
+  log(cy(`# leerness pulse (1.9.231) — 한 줄 종합 요약`));
+  log('');
+  log(`  ${line}`);
+  log('');
+  log(dm(`  → 상세: leerness handoff . | health . | round-history | milestones`));
+}
+
 function roundHistoryCmd(root) {
   root = absRoot(root);
   const isTty = process.stdout && process.stdout.isTTY;
@@ -6006,6 +6080,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);
@@ -6169,6 +6253,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) {
@@ -6177,6 +6262,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 룰 활성 시 헤드라인 노출
@@ -10143,6 +10235,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 전 자동 점검)
@@ -14095,7 +14197,8 @@ function mcpServeCmd(root) {
     { 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_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_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' } } } }
   ];
 
   function send(obj) {
@@ -14264,6 +14367,10 @@ function mcpServeCmd(root) {
             // 1.9.229: 도달 마일스톤 + 다음 ETA
             cliArgs = ['milestones', '--path', targetPath, '--json'];
             break;
+          case 'leerness_pulse':
+            // 1.9.231: 한 줄 종합 요약 (10 핵심 지표)
+            cliArgs = ['pulse', '--path', targetPath, '--json'];
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -16474,6 +16581,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 {
@@ -17911,6 +18028,8 @@ async function main() {
   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.231: leerness pulse — 한 줄 종합 요약 (10 핵심 지표)
+  if (cmd === 'pulse')                              return pulseCmd(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.229",
+  "version": "1.9.231",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",