leerness 1.9.219 → 1.9.220

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## 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.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)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.219  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.220  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🎉 80 라운드 자율 마일스톤 · 5축 100/100 · MCP 59 · 백로그 0    ║
+  ║  🔌 비정상 종료 → 자율 재개 5신호 자동 감지 (사용자 명시)         ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.220';
 
 // 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 출력
@@ -5694,6 +5869,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 +5914,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 {}
   }
@@ -17197,6 +17379,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.220",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",