leerness 1.9.203 → 1.9.205

package/CHANGELOG.md

@@ -1,5 +1,87 @@
 # Changelog
 
+## 1.9.205 — 2026-05-22
+
+**⚡ ScheduleWakeup 사용자 요청 우선 갱신 (사용자 명시) — wakeup miss 실측 후속.**
+
+### 사용자 명시 + 보고
+> *"자동모드로 진행할때, 예정된 알람이전에 사용자 요청이 들어오면 백그라운드의 알람을 종료후 다시 갱신하는 방식은 어떤지"*
+> *"ScheduleWakeup 10:51 KST 가 지났어"* — 사용자가 명시 보고한 wakeup miss 사례
+
+### 1. `.harness/active-wakeups.json` 등록 추적
+- release sync-main 마무리 시 다음 wakeup 자동 등록
+- 구조: `{ expectedFireAt, intervalMin, source, status: pending/fired/missed/superseded, registeredAt }`
+- 최근 20개 유지
+- 함수: `_loadActiveWakeups` / `_writeActiveWakeups` / `_recordWakeup` / `_activeWakeupsPath`
+
+### 2. handoff 진입 시 wakeup 상태 분석 (`_analyzeWakeupStatus`)
+| kind | 조건 | 알림 |
+|---|---|---|
+| `early` | delta < -5min (미래) | `## ⚡ 사용자 조기 진입 감지` |
+| `on-time` | -5 ~ +5min | `✓ ScheduleWakeup 정시 진입` |
+| `late` | +5 ~ +30min | (조용히) |
+| `missed` | > +30min | `## ⏰ ScheduleWakeup miss 확정` + status 자동 갱신 |
+
+### 3. 조기 진입 시 자동 갱신 가이드
+사용자가 wakeup 예정 시각 이전 진입 → "라운드 마무리 시 새 wakeup 등록 (이전 자동 superseded)" 안내
+
+### 4. miss 자동 status 갱신
+fire 시간 지남 + 30분 이상 → status `pending` → `missed` 자동 업데이트 → 통계 누적
+
+### 5. 누적 회귀 (1.9.199~204) — 모두 유지
+
+### 6. stress-v150 — 16/16 PASS
+- 등록 추적 (3) + 상태 분석 (2) + 임시 워크스페이스 통합 (2) + 성능 (2) + 누적 (7)
+- 성능: --version cold start avg **464 ms** · MCP 54 도구 **460 ms**
+
+### 7. 자동 release
+- main 자동 push **67 라운드 연속** (1.9.140~205)
+- npm publish 자동 (1.9.178~)
+
+---
+
+## 1.9.204 — 2026-05-22
+
+**⏰ timezone 보강 + 🔄 auto-loop 활성 라벨 (사용자 명시 2종).**
+
+### 사용자 명시
+> 1. *"시간관련 기능 등은 해당 국가의 시간대를 고려해서 작업이 될 수 있는지"*
+> 2. *"자동으로 깨어나서 작업하는 모드도 활성룰에 표시되어야 할 것 같은데, 활성 룰 에 표시되는 기능 점검"*
+
+### 1. timezone 시스템 (Intl.DateTimeFormat 기반, 의존성 0)
+- `_getLocalTz()` — `process.env.LEERNESS_TZ` → 시스템 timezone → `Asia/Seoul` fallback
+- `_formatLocal(iso, opts)` — ISO UTC → 사용자 local time (예: `2026-05-22 10:13 KST`)
+- 단축 라벨: KST / JST / UTC / 자동 추출
+- **저장은 UTC ISO 유지** (이식성/일관성), **display 만 local time 변환**
+
+### 2. resume CLI local time 표시
+```
+$ leerness resume
+  📅 plan 저장: 2026-05-22 09:48 KST  (29분 전)
+  ⏰ 예상 fire: 2026-05-22 10:13 KST  (정시)
+```
+이전: `2026-05-22T00:48:23.298Z` (한국 사용자 +9 머릿속 변환 필요)
+이후: `2026-05-22 09:48 KST` (즉시 인지 가능)
+
+### 3. 자동 모드 활성 라벨 (헤드라인 12번째)
+```
+📊 헤드라인 (1.9.81/93/113/152/162/192/197/204): ... · 🔄 auto-loop 25min · ...
+```
+- `_getAutoLoopRule(root)` — `R-XXXX [every-round]` 활성 룰 자동 감지
+- 룰 텍스트에서 `25분` 또는 `1500초` 패턴 추출 → 분 단위 표시
+
+### 4. 누적 회귀 (1.9.198~203) — 모두 유지
+
+### 5. stress-v149 — 16/16 PASS
+- timezone (3) + resume display (1) + headline label (2) + 실 검증 (1) + 성능 (2) + 누적 (7)
+- 성능: --version cold start avg **471 ms** · MCP 54 도구 **438 ms**
+
+### 6. 자동 release 흐름
+- main 자동 push **66 라운드 연속** (1.9.140~204)
+- npm publish 자동 (1.9.178~)
+
+---
+
 ## 1.9.203 — 2026-05-22
 
 **📋 자동 라운드 plan 자동 정리 + `leerness resume` 신규 CLI (사용자 명시).**

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.203-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v148-17%2F17-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-133-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-65_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![auto-resume](https://img.shields.io/badge/auto--resume--plan-라운드_마무리_자동-success)]() [![perf](https://img.shields.io/badge/cold_start-464ms-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.205-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v150-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-135-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-67_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![wakeup-track](https://img.shields.io/badge/wakeup-early%2Fmissed_감지-success)]() [![perf](https://img.shields.io/badge/cold_start-464ms-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.203  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.205  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  📋 auto-resume-plan + leerness resume · 자율 cycle 완성        ║
+  ║  ⚡ wakeup early/missed 감지 + 자동 갱신 가이드 (사용자 명시)      ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.203';
+const VERSION = '1.9.205';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -130,6 +130,52 @@ function append(p, s) { mkdirp(path.dirname(p)); fs.appendFileSync(p, s, 'utf8')
 function rel(root, p) { return path.relative(root, p).replace(/\\/g, '/') || '.'; }
 function today() { return new Date().toISOString().slice(0, 10); }
 function now() { return new Date().toISOString(); }
+// 1.9.204: timezone 보강 (사용자 명시)
+//   ISO UTC timestamp 저장은 유지 (이식성/일관성) → display 시 사용자 local time 변환
+//   환경변수: LEERNESS_TZ (default = 시스템 timezone, fallback: 'Asia/Seoul')
+function _getLocalTz() {
+  if (process.env.LEERNESS_TZ) return process.env.LEERNESS_TZ;
+  try {
+    const sys = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    if (sys && sys !== 'UTC') return sys;
+  } catch {}
+  return 'Asia/Seoul';
+}
+// ISO timestamp → local time 표시 (예: "2026-05-22 10:13 KST")
+function _formatLocal(iso, opts) {
+  if (!iso) return '?';
+  opts = opts || {};
+  const tz = opts.tz || _getLocalTz();
+  try {
+    const d = typeof iso === 'string' ? new Date(iso) : iso;
+    if (isNaN(d.getTime())) return String(iso);
+    const fmt = new Intl.DateTimeFormat('en-CA', {
+      timeZone: tz,
+      year: 'numeric', month: '2-digit', day: '2-digit',
+      hour: '2-digit', minute: '2-digit',
+      hour12: false
+    });
+    const parts = fmt.formatToParts(d);
+    const get = (t) => (parts.find(p => p.type === t) || {}).value || '';
+    const date = `${get('year')}-${get('month')}-${get('day')}`;
+    const time = `${get('hour')}:${get('minute')}`;
+    // tz 약어 (KST/JST/UTC 등) — 간단 추출
+    const tzShort = tz === 'Asia/Seoul' ? 'KST' : tz === 'Asia/Tokyo' ? 'JST' : tz === 'UTC' ? 'UTC' : tz.split('/').pop().slice(0, 3);
+    return opts.dateOnly ? date : `${date} ${time} ${tzShort}`;
+  } catch { return String(iso); }
+}
+// 자동 모드 활성 여부 (R-XXXX every-round 룰 존재 시 true)
+function _isAutoLoopActive(root) {
+  try {
+    const rules = readRules(root);
+    return rules.some(r => r.status === 'active' && /every-round|every-session/i.test(r.trigger || ''));
+  } catch { return false; }
+}
+function _getAutoLoopRule(root) {
+  try {
+    return readRules(root).find(r => r.status === 'active' && /every-round/i.test(r.trigger || '')) || null;
+  } catch { return null; }
+}
 function arg(name, def = null) { const i = process.argv.indexOf(name); return i >= 0 ? (process.argv[i + 1] || true) : def; }
 function has(name) { return process.argv.includes(name); }
 function nonFlagArgs() {
@@ -1733,6 +1779,60 @@ async function skillAutoCacheCmd(root, sub) {
   if (c.expired) log(`  → 갱신: leerness skill auto-cache refresh`);
 }
 
+// 1.9.205: ScheduleWakeup 등록 추적 (사용자 명시)
+//   "예정된 알람이전에 사용자 요청이 들어오면 백그라운드의 알람을 종료후 다시 갱신"
+//   라운드 마무리 시 등록된 wakeup id/expectedFireAt 을 .harness/active-wakeups.json 에 기록 →
+//   handoff/resume 진입 시 expected fire 가 과거이면 "wakeup miss 또는 사용자 조기 진입" 감지 →
+//   메인 에이전트가 새 wakeup 호출하라는 명확한 안내
+function _activeWakeupsPath(root) { return path.join(root, '.harness', 'active-wakeups.json'); }
+function _loadActiveWakeups(root) {
+  try {
+    const fp = _activeWakeupsPath(root);
+    if (!exists(fp)) return { wakeups: [] };
+    const j = JSON.parse(read(fp));
+    return { wakeups: Array.isArray(j.wakeups) ? j.wakeups : [] };
+  } catch { return { wakeups: [] }; }
+}
+function _writeActiveWakeups(root, wakeups) {
+  try {
+    mkdirp(path.join(root, '.harness'));
+    writeUtf8(_activeWakeupsPath(root), JSON.stringify({ wakeups, updatedAt: new Date().toISOString() }, null, 2));
+    return true;
+  } catch { return false; }
+}
+function _recordWakeup(root, entry) {
+  const state = _loadActiveWakeups(root);
+  // entry: { expectedFireAt, intervalMin, source, status: 'pending'|'fired'|'missed'|'superseded' }
+  const e = { ...entry, registeredAt: new Date().toISOString() };
+  // 같은 expectedFireAt 중복 시 replace
+  state.wakeups = state.wakeups.filter(w => w.expectedFireAt !== e.expectedFireAt);
+  state.wakeups.push(e);
+  // 최근 20개만 유지
+  if (state.wakeups.length > 20) state.wakeups = state.wakeups.slice(-20);
+  _writeActiveWakeups(root, state.wakeups);
+  return e;
+}
+// wakeup miss / 사용자 조기 진입 감지 — 활성 wakeup 중 가장 가까운 미래/과거 fire 분석
+function _analyzeWakeupStatus(root) {
+  const state = _loadActiveWakeups(root);
+  const pending = state.wakeups.filter(w => w.status === 'pending');
+  if (pending.length === 0) return { hasWakeup: false };
+  // 가장 최근 등록된 pending wakeup
+  const latest = pending.sort((a, b) => new Date(b.registeredAt).getTime() - new Date(a.registeredAt).getTime())[0];
+  const now = Date.now();
+  const expectedMs = new Date(latest.expectedFireAt).getTime();
+  const deltaMin = Math.floor((now - expectedMs) / 60000);
+  // deltaMin < 0 → 아직 fire 시간 전 (사용자 조기 진입)
+  // deltaMin >= 0 → fire 시간 지남 (정시 또는 miss)
+  // |deltaMin| < 5 → 정시 부근
+  let kind;
+  if (deltaMin < -5) kind = 'early';        // 사용자 조기 진입
+  else if (deltaMin > 30) kind = 'missed';   // wakeup miss
+  else if (deltaMin > 5) kind = 'late';      // 약간 지연
+  else kind = 'on-time';
+  return { hasWakeup: true, latest, deltaMin, kind, pending: pending.length };
+}
+
 // 1.9.203: 자동 라운드 plan 정리 — 사용자 명시
 //   "백그라운드에 다음 작업이 시작가능한 예상 시간 + 일어났을때 해야하는 일을 정리"
 //   라운드 마무리 시 .harness/auto-resume-plan.json 자동 저장 → 다음 wakeup 시 즉시 실행 가능
@@ -1813,8 +1913,8 @@ function resumeCmd(root) {
   const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
   log(cyan(`# 🔄 leerness resume (1.9.203 자동 라운드 plan 적용)`));
   log('');
-  log(`  📅 plan 저장: ${plan.savedAt}  (${plan.ageMin}분 전)`);
-  log(`  ⏰ 예상 fire: ${plan.expectedFireAt}` + (plan.elapsedFromExpected > 0 ? yel(`  (${plan.elapsedFromExpected}분 지연)`) : ' (정시)'));
+  log(`  📅 plan 저장: ${_formatLocal(plan.savedAt)}  (${plan.ageMin}분 전)`);
+  log(`  ⏰ 예상 fire: ${_formatLocal(plan.expectedFireAt)}` + (plan.elapsedFromExpected > 0 ? yel(`  (${plan.elapsedFromExpected}분 지연)`) : ' (정시)'));
   log(`  🎯 focus: ${plan.focus}`);
   log('');
   log(grn(`## 다음 라운드: ${plan.nextRoundVersion}`));
@@ -3850,6 +3950,23 @@ function handoff(root) {
           parts.push(`🌐 official ${m.total}/${m.cacheTotal} (${ageStr}${status})`);
         }
       } catch {}
+      // 12) 1.9.204: 자동 모드 활성 표시 (사용자 명시) — R-0001 every-round 룰 활성 시 헤드라인 노출
+      try {
+        const autoRule = _getAutoLoopRule(root);
+        if (autoRule) {
+          // 룰 텍스트에서 "25분" 우선, 없으면 "1500초" 패턴 추출 (분 우선순위)
+          const txt = autoRule.rule || '';
+          const minMatch = txt.match(/(\d+)\s*분/);
+          const secMatch = txt.match(/(\d+)\s*초/);
+          let label = '🔄 auto-loop';
+          if (minMatch) {
+            label = `🔄 auto-loop ${minMatch[1]}min`;
+          } else if (secMatch) {
+            label = `🔄 auto-loop ${Math.round(Number(secMatch[1]) / 60)}min`;
+          }
+          parts.push(label);
+        }
+      } catch {}
       // 11) 1.9.197: A축 (범용 AI 하네스) 9.5→10 보강 — provider probe 60분 캐시 자동 노출
       //     사용자 명시: "범용 AI 하네스 ... 최고의 도구" — 매 handoff 시 11 backend ready 상태 즉시 노출
       try {
@@ -3862,7 +3979,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): ${parts.join(' · ')}`));
+        log(cy(`📊 헤드라인 (1.9.81/93/113/152/162/192/197/204): ${parts.join(' · ')}`));
       }
     } catch {}
   }
@@ -4161,6 +4278,40 @@ function handoff(root) {
       }
     } catch {}
   }
+  // 1.9.205: ScheduleWakeup 상태 분석 + 사용자 조기 진입 / miss 감지 (사용자 명시)
+  if (process.env.LEERNESS_NO_WAKEUP_STATUS !== '1' && !has('--quiet')) {
+    try {
+      const wakeup = _analyzeWakeupStatus(root);
+      if (wakeup.hasWakeup) {
+        const isTty = process.stdout && process.stdout.isTTY;
+        const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+        const grn = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+        const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+        const expectedLocal = _formatLocal(wakeup.latest.expectedFireAt);
+        if (wakeup.kind === 'early') {
+          // 사용자 조기 진입 — 기존 wakeup 갱신 권장
+          log(yel(`## ⚡ 사용자 조기 진입 감지 (1.9.205) — 등록된 wakeup ${Math.abs(wakeup.deltaMin)}분 후 fire 예정`));
+          log(dim(`  예정 fire: ${expectedLocal} (${wakeup.latest.source})`));
+          log(dim(`  → 권장: 라운드 마무리 시 새 wakeup 등록 (이전 자동 superseded)`));
+          log('');
+        } else if (wakeup.kind === 'missed') {
+          // wakeup miss — fire 시간 지남
+          log(yel(`## ⏰ ScheduleWakeup miss 확정 (1.9.205) — 예정 fire ${wakeup.deltaMin}분 전`));
+          log(dim(`  예정 fire: ${expectedLocal} (${wakeup.latest.source})`));
+          log(dim(`  → 회복: 라운드 마무리 시 새 wakeup 자동 등록`));
+          // 자동으로 status 를 'missed' 로 업데이트
+          try {
+            const s = _loadActiveWakeups(root);
+            const idx = s.wakeups.findIndex(w => w.expectedFireAt === wakeup.latest.expectedFireAt);
+            if (idx >= 0) { s.wakeups[idx].status = 'missed'; _writeActiveWakeups(root, s.wakeups); }
+          } catch {}
+          log('');
+        } else if (wakeup.kind === 'on-time') {
+          log(grn(`  ✓ ScheduleWakeup 정시 진입 (1.9.205, delta ${wakeup.deltaMin}분)`));
+        }
+      }
+    } catch {}
+  }
   // 1.9.203: auto-resume-plan 알림 — 라운드 마무리 시 저장된 plan 자동 노출
   //   사용자 명시: "백그라운드에 다음 작업이 시작가능한 예상 시간 + 일어났을때 해야하는 일을 정리"
   if (_autoResumePlan && !has('--quiet') && process.env.LEERNESS_NO_RESUME_PLAN !== '1') {
@@ -9271,6 +9422,14 @@ function _publishToNpm(root, opts = {}) {
           note: `다음 wakeup 시: 1) leerness resume . 으로 plan 확인  2) leerness handoff . 실행  3) leerness next-action take 로 즉시 task 진입`
         });
         _writeAutoResumePlan(root, plan);
+        // 1.9.205: 다음 wakeup 등록 추적 (사용자 명시 갱신용)
+        _recordWakeup(root, {
+          expectedFireAt: plan.expectedFireAt,
+          intervalMin: plan.intervalMin || 25,
+          source: 'release-sync-main',
+          status: 'pending',
+          fromVersion: pkgVersion
+        });
       } catch {}
     } else {
       const errOut = (pubR.stderr || pubR.stdout || '').slice(-400);

package/package.json

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