leerness 1.9.219 → 1.9.221

package/CHANGELOG.md

@@ -1,5 +1,91 @@
 # Changelog
 
+## 1.9.221 — 2026-05-22
+
+**🎉 MCP 60 도구 마일스톤 + abnormalShutdown JSON 통합 (handoff/session close).**
+
+### 1. MCP 60번째 도구 — `leerness_session_resume`
+- 1.9.220 비정상 종료 감지 시스템을 외부 AI에 노출
+- 인자: `{ path? }`
+- 응답: `{ abnormalShutdown, severity, signals[], resumeGuide[] }`
+- 5신호 분석 (last-handoff/wakeup-missed/in-progress-stale/auto-resume-plan/release-branch)
+
+### 2. handoff --json `abnormalShutdown` 필드 추가
+- `{ detected, severity, signalCount, signals[], resumeGuide[] }`
+- 외부 모니터링 도구 / CI 가 비정상 종료 자동 감지
+- 1.9.218 통합 패턴 확장 (handoff JSON 4종 필드 완성: userRequests/preWake/idempotency/abnormalShutdown)
+
+### 3. session close --json 동일 통합
+- 마감 시 다음 라운드 진입 시 재개 가이드 자동 회수
+- CI 마감 후 비정상 종료 detect 가능
+
+### 4. 누적 회귀 (1.9.207~220) — 모두 유지
+
+### 5. stress-v166 — 16/16 PASS
+- 1.9.221 (4): VERSION + MCP 60 + session_resume 등록 + 실 호출 (high severity 응답)
+- abnormalShutdown JSON 통합 (3): handoff/session close + wakeup miss 시나리오
+- 성능 (2): cold_start 374ms / MCP 60 도구 385ms
+- 누적 회귀 (7): 1.9.207~220
+
+### 6. 자동 release (83 라운드 main-push streak · 44 라운드 npm publish streak)
+
+🎉 **MCP 60 도구 도달** (53 → 60, +7: 1.9.168 +3 / 1.9.216 +5 / 1.9.221 +1)
+🎉 **handoff/session close JSON 4 통합 필드 완성** (userRequests/preWake/idempotency/abnormalShutdown)
+
+---
+
+## 1.9.220 — 2026-05-22
+
+**🔌 비정상 종료 후 자율 재개 시스템 (사용자 명시).**
+
+### 사용자 명시
+> *"자율모드일때 절전모드였거나, 시스템종료나 AI에이전트 세션종료등으로 자율개발모드가 비정상적으로 종료되었다가 다시 실행하여 세션을 이어갈때, 감지하고 작업이 중단된지점이나 누락된작업을 감지하고 개발을이어가거나 자율모드를 다시 진행"*
+
+### 1. `_detectAbnormalShutdown(root)` — 5신호 종합 감지
+| # | 신호 | 트리거 | severity |
+|---|---|---|---|
+| 1 | `last-handoff-stale` | gap > 60min (정상 25min 대비) | gap > 240min: high / else medium |
+| 2 | `wakeup-missed` | active-wakeups pending → 30min+ 지남 | gap > 120min: high |
+| 3 | `in-progress-stale` | in-progress task + progress-tracker 24h+ stale | high |
+| 4 | `auto-resume-plan-unused` | auto-resume-plan 60min+ 미사용 | ageMin > 240: medium |
+| 5 | `release-branch-pending` | 2+ release/* branch (sync-main 누락) | low |
+
+### 2. `leerness session-resume` CLI
+- 비정상 종료 감지 + 5신호 분석
+- 자동 재개 가이드 출력 (7단계)
+- `--json` 옵션 (외부 자동화)
+
+### 3. handoff 헤드라인 16번째 요소
+- 비정상 종료 감지 시: `🔌 비정상종료 <severity> (N신호)`
+- 헤드라인 라벨: `1.9.81/93/113/152/162/192/197/204/207/209/215/220`
+
+### 4. 재개 가이드 7단계 (자동 생성)
+신호별 맞춤 가이드:
+1. `leerness handoff .` — 현재 상태 종합
+2. `leerness resume` — auto-resume-plan 적용 (auto-resume-plan-unused 시)
+3. `leerness task list --status in-progress` — stale task 검토 (in-progress-stale 시)
+4. ScheduleWakeup 재등록 (wakeup-missed 시)
+5. `git branch -a` → `leerness release sync-main` (release-branch-pending 시)
+6. `leerness pre-wake-audit` — 누락 작업 / 충돌 점검
+7. `leerness requests audit` — 미답 사용자 요청 확인
+
+### 5. 실 검증 시나리오
+- **정상 워크스페이스** → `abnormalShutdown: false / severity: none`
+- **wakeup 2024분 지남** (시뮬레이션) → `severity: high / wakeup-missed 1신호 + 가이드 4단계 자동 생성`
+
+### 6. 누적 회귀 (1.9.207~219) — 모두 유지
+
+### 7. stress-v165 — 18/18 PASS
+- 1.9.220 (7): VERSION + 5신호 등록 + 정상/비정상 시나리오 + handoff 통합 + CLI 라우팅
+- 성능 (2): cold_start 461ms / MCP 59 도구 424ms
+- 누적 회귀 (9): 1.9.207~219
+
+### 8. 자동 release (82 라운드 main-push streak · 43 라운드 npm publish streak)
+
+🎉 **자율 모드 복원력 강화** — 절전/종료/세션종료 무관, 재시작 시 자동 진단 + 재개 가능
+
+---
+
 ## 1.9.219 — 2026-05-22
 
 **🎉 80 라운드 자율 모드 마일스톤 + session-workflow.md 통합 갱신.**

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.219-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v164-15%2F15-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-59-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-149-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-81_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![milestone](https://img.shields.io/badge/🎉_milestone-80_라운드-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-618ms-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.221-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v166-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-60_🎉-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-151-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-83_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![mcp-60](https://img.shields.io/badge/🎉_MCP-60_도구_마일스톤-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-374ms-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.219  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.221  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🎉 80 라운드 자율 마일스톤 · 5축 100/100 · MCP 59 · 백로그 0    ║
+  ║  🎉 MCP 60 도구 마일스톤 · handoff JSON 4 통합 필드 완성          ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.219';
+const VERSION = '1.9.221';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -2251,6 +2251,140 @@ function _saveAndAppendPreWakeReport(root, audit) {
   return audit;
 }
 
+// 1.9.220: 비정상 종료 감지 + 자율 재개 (사용자 명시)
+//   "절전모드/시스템종료/AI에이전트 세션종료로 비정상 종료된 후 재실행 시 중단지점/누락작업 감지"
+//   5신호 종합 분석:
+//     1) last-handoff gap > 60min (1.9.199, 25min interval 기대 대비 2.4배+)
+//     2) wakeup miss (active-wakeups pending → 30min+ 지남, 1.9.205)
+//     3) in-progress task 24h+ 갱신 없음 (stale, progress-tracker mtime)
+//     4) auto-resume-plan 존재 + ageMin > 60min (1.9.203, 사용 안 됨)
+//     5) release/X.X.X branch 있음 + main 미머지 (release sync-main 누락)
+//   결과: { abnormalShutdown: true/false, signals: [...], severity, resumeGuide }
+function _detectAbnormalShutdown(root) {
+  const result = {
+    detectedAt: new Date().toISOString(),
+    signals: [],
+    severity: 'none',
+    abnormalShutdown: false,
+    resumeGuide: []
+  };
+  const now = Date.now();
+
+  // 1) last-handoff gap > 60min (정상 25min interval 대비)
+  try {
+    const lhFp = path.join(root, '.harness', 'last-handoff.json');
+    if (exists(lhFp)) {
+      const j = JSON.parse(read(lhFp));
+      const last = j.lastAt || (j.history && j.history.length > 0 ? j.history[j.history.length - 1] : null);
+      if (last) {
+        const lastMs = new Date(last).getTime();
+        const gapMin = Math.floor((now - lastMs) / 60000);
+        if (gapMin > 60) {
+          result.signals.push({
+            kind: 'last-handoff-stale',
+            gapMin,
+            detail: `last handoff ${gapMin}분 전 (정상 25min 간격 대비 ${Math.round(gapMin/25)}x 초과) — 절전/종료 의심`,
+            severity: gapMin > 240 ? 'high' : 'medium'
+          });
+        }
+      }
+    }
+  } catch {}
+
+  // 2) wakeup miss (active-wakeups pending → 30min+ 지남)
+  try {
+    const wkStat = _analyzeWakeupStatus(root);
+    if (wkStat.hasWakeup && wkStat.deltaMin > 30 && wkStat.kind === 'missed') {
+      result.signals.push({
+        kind: 'wakeup-missed',
+        gapMin: wkStat.deltaMin,
+        detail: `wakeup ${wkStat.deltaMin}분 지남 (status=pending) — 자동 재개 실패`,
+        severity: wkStat.deltaMin > 120 ? 'high' : 'medium'
+      });
+    }
+  } catch {}
+
+  // 3) in-progress task 24h+ stale (progress-tracker mtime + 활성 task 카운트)
+  try {
+    const ptPath = path.join(root, '.harness', 'progress-tracker.md');
+    if (exists(ptPath)) {
+      const stat = fs.statSync(ptPath);
+      const ageMin = Math.floor((now - stat.mtimeMs) / 60000);
+      const content = read(ptPath);
+      const inProgress = (content.match(/^\|\s*T-\d{4,}\s*\|\s*in-progress\s*\|/gm) || []).length;
+      if (inProgress > 0 && ageMin > 24 * 60) {
+        result.signals.push({
+          kind: 'in-progress-stale',
+          inProgressCount: inProgress,
+          ageMin,
+          detail: `${inProgress}건 in-progress task, progress-tracker ${Math.floor(ageMin/60)}h 갱신 없음`,
+          severity: 'high'
+        });
+      }
+    }
+  } catch {}
+
+  // 4) auto-resume-plan 존재 + ageMin > 60min (사용 안 됨)
+  try {
+    const plan = _loadAutoResumePlan(root);
+    if (plan && plan.ageMin > 60) {
+      result.signals.push({
+        kind: 'auto-resume-plan-unused',
+        ageMin: plan.ageMin,
+        nextRound: plan.nextRoundVersion,
+        detail: `auto-resume-plan ${plan.ageMin}분 전 작성 (${plan.nextRoundVersion}) — 사용 안 됨`,
+        severity: plan.ageMin > 240 ? 'medium' : 'low'
+      });
+    }
+  } catch {}
+
+  // 5) release/X.X.X branch 있음 + main 미머지 (git 상태)
+  try {
+    const r = cp.spawnSync('git', ['branch', '--list', 'release/*'], { cwd: root, encoding: 'utf8', timeout: 3000 });
+    if (r.status === 0) {
+      const branches = (r.stdout || '').split('\n').map(s => s.trim().replace(/^\*?\s*/, '')).filter(b => b.startsWith('release/'));
+      if (branches.length >= 2) {  // 2개 이상이면 누락 가능성
+        result.signals.push({
+          kind: 'release-branch-pending',
+          count: branches.length,
+          recent: branches.slice(-3),
+          detail: `${branches.length}건 release/* branch (sync-main 누락 가능)`,
+          severity: 'low'
+        });
+      }
+    }
+  } catch {}
+
+  // 종합 판단
+  const high = result.signals.filter(s => s.severity === 'high').length;
+  const medium = result.signals.filter(s => s.severity === 'medium').length;
+  if (high > 0) { result.severity = 'high'; result.abnormalShutdown = true; }
+  else if (medium > 0) { result.severity = 'medium'; result.abnormalShutdown = true; }
+  else if (result.signals.length > 0) result.severity = 'low';
+
+  // 재개 가이드
+  if (result.abnormalShutdown) {
+    result.resumeGuide.push('1. leerness handoff . — 현재 상태 종합 확인');
+    if (result.signals.some(s => s.kind === 'auto-resume-plan-unused')) {
+      result.resumeGuide.push('2. leerness resume — 저장된 auto-resume-plan 적용 (1.9.203)');
+    }
+    if (result.signals.some(s => s.kind === 'in-progress-stale')) {
+      result.resumeGuide.push('3. leerness task list --status in-progress — stale task 검토 (drop or 재개)');
+    }
+    if (result.signals.some(s => s.kind === 'wakeup-missed')) {
+      result.resumeGuide.push('4. ScheduleWakeup 재등록 (사용자 트리거 또는 R-0001 룰)');
+    }
+    if (result.signals.some(s => s.kind === 'release-branch-pending')) {
+      result.resumeGuide.push('5. git branch -a로 release/* 확인 + leerness release sync-main 재실행');
+    }
+    result.resumeGuide.push('6. leerness pre-wake-audit — 누락 작업 / 충돌 종합 점검');
+    result.resumeGuide.push('7. leerness requests audit — 미답 사용자 요청 확인');
+  } else {
+    result.resumeGuide.push('정상 운영 중 — 비정상 종료 신호 없음');
+  }
+  return result;
+}
+
 // 1.9.210: adaptive wakeup interval (사용자 명시)
 //   "wakeup 30분등 긴 시간이 필요없다면 간격을 타이트하게 자동으로 조절하도록"
 //   사용자 활동량 기반 권장 interval 계산 → ScheduleWakeup 시 자동 적용 (R-0001 룰 외 동적 보정)
@@ -2920,6 +3054,47 @@ function requestsCmd(root, sub, ...rest) {
   process.exit(1);
 }
 
+// 1.9.220: leerness session-resume — 비정상 종료 감지 + 자율 재개 가이드 (사용자 명시)
+function sessionResumeCmd(root) {
+  root = absRoot(root);
+  const isTty = process.stdout && process.stdout.isTTY;
+  const cyan = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+  const grn = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+  const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+  const red = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
+  const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+
+  const result = _detectAbnormalShutdown(root);
+  if (has('--json')) { log(JSON.stringify(result, null, 2)); return; }
+  log(cyan(`# leerness session-resume (1.9.220) — 비정상 종료 감지 + 자율 재개`));
+  log(`  detected at: ${result.detectedAt}`);
+  log('');
+  if (!result.abnormalShutdown) {
+    log(grn(`  ✓ 비정상 종료 신호 없음 — 정상 운영 중`));
+    if (result.signals.length > 0) {
+      log(dim(`     (low-severity 신호 ${result.signals.length}건 — 무시 가능)`));
+    }
+    log('');
+    log(dim(`  → 평소대로 leerness handoff . 로 시작`));
+    return;
+  }
+  const sevIcon = result.severity === 'high' ? '🚨' : '⚠';
+  const sevColor = result.severity === 'high' ? red : yel;
+  log(sevColor(`  ${sevIcon} 비정상 종료 감지 — severity: ${result.severity} (signals: ${result.signals.length})`));
+  log('');
+  log(`## 감지 신호`);
+  for (const s of result.signals) {
+    const icon = s.severity === 'high' ? '🚨' : (s.severity === 'medium' ? '⚠' : 'ℹ');
+    const c = s.severity === 'high' ? red : (s.severity === 'medium' ? yel : dim);
+    log(c(`  ${icon} [${s.kind}] ${s.detail}`));
+  }
+  log('');
+  log(`## 재개 가이드`);
+  for (const g of result.resumeGuide) {
+    log(`  ${g}`);
+  }
+}
+
 // 1.9.208: leerness constraints <list|check|add> — 플랫폼/API 제약 사전 체크 CLI (사용자 명시)
 //   "특정 플랫폼의 API ... 호출속도가 초당 5회 이하로만 해야한다는 규정을 먼저 확인"
 //   list           → 등록된 모든 플랫폼 catalog 출력
@@ -5522,6 +5697,17 @@ function handoff(root) {
         overall: idemp.summary.overall
       };
     } catch {}
+    // 1.9.221: abnormalShutdown 자동 감지 (1.9.220 통합)
+    try {
+      const ad = _detectAbnormalShutdown(root);
+      result.abnormalShutdown = {
+        detected: ad.abnormalShutdown,
+        severity: ad.severity,
+        signalCount: ad.signals.length,
+        signals: ad.signals.map(s => ({ kind: s.kind, severity: s.severity, detail: s.detail })),
+        resumeGuide: ad.resumeGuide
+      };
+    } catch {}
     log(JSON.stringify(result, null, 2));
     return;
   }
@@ -5694,6 +5880,13 @@ function handoff(root) {
           }
         }
       } catch {}
+      // 16) 1.9.220: 비정상 종료 감지 (사용자 명시) — 깨어남 직후 자동 노출
+      try {
+        const ad = _detectAbnormalShutdown(root);
+        if (ad.abnormalShutdown) {
+          parts.push(`🔌 비정상종료 ${ad.severity} (${ad.signals.length}신호)`);
+        }
+      } catch {}
       // 15) 1.9.215: 현재 활성 task에서 constraints/intent 자동 분석 (1.9.208/213 통합)
       try {
         // progress-tracker.md 의 첫 active task request 추출
@@ -5732,7 +5925,7 @@ function handoff(root) {
       if (parts.length) {
         const isTty = process.stdout && process.stdout.isTTY;
         const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
-        log(cy(`📊 헤드라인 (1.9.81/93/113/152/162/192/197/204/207/209/215): ${parts.join(' · ')}`));
+        log(cy(`📊 헤드라인 (1.9.81/93/113/152/162/192/197/204/207/209/215/220): ${parts.join(' · ')}`));
       }
     } catch {}
   }
@@ -9541,6 +9734,17 @@ function sessionClose(root, opts = {}) {
         overall: idemp.summary.overall
       };
     } catch {}
+    try {
+      // 1.9.221: abnormalShutdown 자동 감지 (1.9.220 통합) — session close 시 다음 재개 가이드 회수
+      const ad = _detectAbnormalShutdown(root);
+      jsonResult.abnormalShutdown = {
+        detected: ad.abnormalShutdown,
+        severity: ad.severity,
+        signalCount: ad.signals.length,
+        signals: ad.signals.map(s => ({ kind: s.kind, severity: s.severity, detail: s.detail })),
+        resumeGuide: ad.resumeGuide
+      };
+    } catch {}
 
     process.stdout.write(JSON.stringify(jsonResult, null, 2) + '\n');
   } else {
@@ -13416,7 +13620,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_constraints_check', description: '1.9.216 (1.9.208 사용자 명시) — 플랫폼/API 제약 사전 체크. 사용자 요청 텍스트에서 플랫폼 alias 매칭 (stripe/openai/anthropic/github/discord/twitter 6종 + 사용자 정의) → 각 플랫폼의 rate-limit / idempotency / auth / cost 제약 노출. 외부 AI가 "이 기능 구현 전 어떤 규정을 봐야 하나?"를 직접 회수. 인자: { request (required), path? }', inputSchema: { type: 'object', properties: { request: { type: 'string' }, path: { type: 'string' } }, required: ['request'] } },
     { name: 'leerness_pre_wake_audit', description: '1.9.216 (1.9.209 사용자 명시) — sleep 전 sub-agent audit. 6 영역 점검: missing-user-requests / stale-in-progress / drift-handoff-stale / wakeup-missed / next-action-pending / auto-resume-plan. 외부 AI가 "깨어나기 전 점검할 부분"을 회수. 응답: { auditedAt, findings: {critical, warning, info}, summary }. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { 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_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' } } } }
   ];
 
   function send(obj) {
@@ -13568,6 +13773,10 @@ function mcpServeCmd(root) {
             // 1.9.216 (1.9.212): 멱등성 감사 (rule/task/user-requests/wakeups 4영역)
             cliArgs = ['idempotency', 'audit', '--path', targetPath, '--json'];
             break;
+          case 'leerness_session_resume':
+            // 1.9.221 (1.9.220): 비정상 종료 감지 + 자율 재개
+            cliArgs = ['session-resume', '--path', targetPath, '--json'];
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -17197,6 +17406,8 @@ async function main() {
   if (cmd === 'resume')                             return resumeCmd(arg('--path', process.cwd()));
   // 1.9.207: leerness requests <audit|add|list|complete|drop> — 사용자 요청 누락 확인 절차 (사용자 명시)
   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.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.219",
+  "version": "1.9.221",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",