leerness 1.9.220 → 1.9.221

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # 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
 
 **🔌 비정상 종료 후 자율 재개 시스템 (사용자 명시).**

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.220-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v165-18%2F18-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-59-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-150-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-82_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![resilience](https://img.shields.io/badge/session_resume-5신호_자동감지-success)]() [![perf](https://img.shields.io/badge/cold_start-461ms-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.220  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.221  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🔌 비정상 종료 → 자율 재개 5신호 자동 감지 (사용자 명시)         ║
+  ║  🎉 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.220';
+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 처리).
@@ -5697,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;
   }
@@ -9723,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 {
@@ -13598,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) {
@@ -13750,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}` } });
         }

package/package.json

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