leerness 1.9.220 → 1.9.222

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # Changelog
 
+## 1.9.222 — 2026-05-22
+
+**🛡 session-resume --auto-fix 안전 회복 + handoff 본문 비정상 종료 자동 노출.**
+
+### 1. `leerness session-resume --auto-fix` — 안전한 자동 회복
+- 1.9.220 detect / 1.9.221 MCP / 1.9.222 **auto-fix**
+- `wakeup-missed` 신호 감지 시 → 30분+ 지난 pending wakeup 자동 `superseded`
+- `state.supersededReason: 'auto-fix-1.9.222-abnormal-shutdown'`
+- 사용자/AI가 수동 정리할 필요 없이 다음 wakeup이 정상 동작
+- `--auto-fix` 옵션이 없으면 기존 동작 그대로 (감지만, 변경 X)
+
+### 2. handoff 본문 자동 노출 — 비정상 종료 섹션
+- 1.9.220 헤드라인 (`🔌 비정상종료 <severity>`) + 1.9.222 **본문**
+- `severity: high` → `## 🚨 비정상 종료 감지 (1.9.220, severity: high)` 본문 섹션 자동
+- `severity: medium` → `## ⚠ 비정상 종료 감지` 본문 섹션 자동
+- 본문 출력 위치: pre-wake-audit 섹션 다음, 활성 룰 이전
+- top 3 신호 + 재개 가이드 + auto-fix 가이드 한 번에 노출
+
+### 3. CLAUDE.md / AGENTS.md 1.9.214~221 운영 강화 8 라운드 통합
+- drift 차단을 위한 `## 운영 강화 8 라운드 (1.9.214~221)` 섹션 누적
+- 9 라운드 (drift 차단 / handoff 헤드라인 / MCP 5종 / session close / handoff JSON 4 통합 / 80 라운드 / 비정상 종료 / MCP 60 / auto-fix) 모두 단일 시야 노출
+
+### 4. 누적 회귀 (1.9.207~221) — 모두 유지
+
+### 5. stress-v167 — 14/14 PASS
+- 1.9.222 (6): VERSION + auto-fix (격리) + auto-fix 미지정 시 동작 + handoff 본문 노출 + handoff 정상 시 미노출 + CLAUDE 8 라운드 섹션
+- 성능 (2): cold_start avg 408ms / MCP 60 도구 413ms
+- 누적 회귀 (6): 1.9.207~221
+
+### 6. 자동 release (84 라운드 main-push streak · 45 라운드 npm publish streak)
+
+🛡 **비정상 종료 시스템 완성**: 1.9.220 detect → 1.9.221 MCP → 1.9.222 **auto-fix** + **본문 자동 노출** (3 라운드 누적)
+
+---
+
+## 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.222-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v167-14%2F14-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-60_🎉-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-152-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-84_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![auto-fix](https://img.shields.io/badge/🛡_session--resume-auto--fix-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-408ms-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.222  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🔌 비정상 종료 → 자율 재개 5신호 자동 감지 (사용자 명시)         ║
+  ║  🛡 session-resume --auto-fix · handoff 본문 비정상 종료 자동      ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.222';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -3055,6 +3055,7 @@ function requestsCmd(root, sub, ...rest) {
 }
 
 // 1.9.220: leerness session-resume — 비정상 종료 감지 + 자율 재개 가이드 (사용자 명시)
+// 1.9.222: --auto-fix 옵션 추가 — 안전한 자동 회복 (wakeup supersede)
 function sessionResumeCmd(root) {
   root = absRoot(root);
   const isTty = process.stdout && process.stdout.isTTY;
@@ -3065,6 +3066,45 @@ function sessionResumeCmd(root) {
   const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
 
   const result = _detectAbnormalShutdown(root);
+
+  // 1.9.222: --auto-fix — 안전한 신호별 자동 회복
+  const autoFix = has('--auto-fix');
+  if (autoFix && result.abnormalShutdown) {
+    result.autoFixed = [];
+    // 1) wakeup-missed → 오래된 pending wakeup supersede (안전: 단순 상태 변경)
+    if (result.signals.some(s => s.kind === 'wakeup-missed')) {
+      try {
+        const state = _loadActiveWakeups(root);
+        let fixed = 0;
+        state.wakeups = state.wakeups.map(w => {
+          if (w.status === 'pending') {
+            const expectedMs = new Date(w.expectedFireAt).getTime();
+            const deltaMin = Math.floor((Date.now() - expectedMs) / 60000);
+            if (deltaMin > 30) {
+              w.status = 'superseded';
+              w.supersededReason = 'auto-fix-1.9.222-abnormal-shutdown';
+              w.supersededAt = new Date().toISOString();
+              fixed++;
+            }
+          }
+          return w;
+        });
+        if (fixed > 0) {
+          _writeActiveWakeups(root, state.wakeups);
+          result.autoFixed.push({ kind: 'wakeup-missed', action: 'superseded', count: fixed });
+        }
+      } catch {}
+    }
+    // 2) auto-resume-plan-unused → 60min+ 미사용은 안내만 (자동 삭제 X, 사용자가 검토해야 함)
+    if (result.signals.some(s => s.kind === 'auto-resume-plan-unused')) {
+      result.autoFixed.push({ kind: 'auto-resume-plan-unused', action: 'guidance-only', detail: 'leerness resume 으로 적용 검토' });
+    }
+    // 3) in-progress-stale → drop 결정은 사용자 영역 (자동 X)
+    if (result.signals.some(s => s.kind === 'in-progress-stale')) {
+      result.autoFixed.push({ kind: 'in-progress-stale', action: 'guidance-only', detail: 'leerness task list --status in-progress 후 사용자 결정 필요' });
+    }
+  }
+
   if (has('--json')) { log(JSON.stringify(result, null, 2)); return; }
   log(cyan(`# leerness session-resume (1.9.220) — 비정상 종료 감지 + 자율 재개`));
   log(`  detected at: ${result.detectedAt}`);
@@ -3093,6 +3133,18 @@ function sessionResumeCmd(root) {
   for (const g of result.resumeGuide) {
     log(`  ${g}`);
   }
+  // 1.9.222: --auto-fix 결과 노출
+  if (result.autoFixed && result.autoFixed.length > 0) {
+    log('');
+    log(grn(`## 🔧 auto-fix 결과 (${result.autoFixed.length})`));
+    for (const af of result.autoFixed) {
+      const icon = af.action === 'superseded' ? '✓' : 'ℹ';
+      log(`  ${icon} [${af.kind}] ${af.action}${af.count ? ` (count: ${af.count})` : ''}`);
+      if (af.detail) log(dim(`     ${af.detail}`));
+    }
+  } else if (autoFix) {
+    log(dim(`  (auto-fix 적용 대상 없음)`));
+  }
 }
 
 // 1.9.208: leerness constraints <list|check|add> — 플랫폼/API 제약 사전 체크 CLI (사용자 명시)
@@ -5697,6 +5749,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;
   }
@@ -5945,6 +6008,30 @@ function handoff(root) {
       }
     }
   } catch {}
+
+  // 1.9.222: 비정상 종료 감지 본문 자동 노출 (handoff 직후 — 가장 먼저 봐야 함)
+  //   high/medium severity 시 즉시 노출, low/none 은 무시
+  try {
+    const ad = _detectAbnormalShutdown(root);
+    if (ad.abnormalShutdown && (ad.severity === 'high' || ad.severity === 'medium')) {
+      const isTty = process.stdout && process.stdout.isTTY;
+      const cy3 = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+      const rd3 = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
+      const yl3 = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+      const dm3 = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+      log('');
+      const sevIcon = ad.severity === 'high' ? '🚨' : '⚠';
+      const sevColor = ad.severity === 'high' ? rd3 : yl3;
+      log(sevColor(`## ${sevIcon} 비정상 종료 감지 (1.9.220, severity: ${ad.severity})`));
+      ad.signals.slice(0, 3).forEach(s => {
+        const ic = s.severity === 'high' ? '🚨' : (s.severity === 'medium' ? '⚠' : 'ℹ');
+        log(`  ${ic} [${s.kind}] ${s.detail}`);
+      });
+      log(dm3(`  → 재개 가이드: leerness session-resume`));
+      log(dm3(`  → 자동 회복: leerness session-resume --auto-fix (1.9.222)`));
+    }
+  } catch {}
+
   // 1.9.8: active rules 자동 노출 (매 세션 시작 시 AI에게 보임)
   const activeRules = readRules(root).filter(r => r.status === 'active');
   if (activeRules.length) {
@@ -9723,6 +9810,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 +13696,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 +13849,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.222",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",