leerness 1.9.204 → 1.9.206

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # Changelog
 
+## 1.9.206 — 2026-05-22
+
+**🌐 i18n MVP + UI/UX 헬퍼 (사용자 명시 2종).**
+
+### 사용자 명시
+> 1. *"설치 가이드에서 언어 선택에 따라 설치 가이드 및 REPL agent 모드 등 설정된 언어로 표시되어야"*
+> 2. *"설치 가이드 및 REPL agent 모드 UI UX를 개선해줘, 모션이나, 텍스트 출력방식 등등"*
+
+### 1. i18n 시스템 MVP (10 핵심 keys)
+- `STRINGS` table (ko/en) — install.lang.* / install.agents.* / repl.welcome.* / common.*
+- `_currentLang(root)` — `LEERNESS_LANG` env → `.harness/LANGUAGE` → 'ko' fallback
+- `_t(key, lang)` — i18n lookup helper
+
+### 2. 영어 선택 시 후속 prompt 자동 영어 표시
+- 언어 선택 자체는 한국어 (사용자가 언어를 모르므로)
+- 'en' 선택 시 `process.env.LEERNESS_LANG = 'en'` 즉시 설정 → agents prompt 등 자동 영어 변환
+
+### 3. UI/UX 헬퍼 (`_typewrite`, `_ui`)
+- `_typewrite(text, delayMs)` — opt-in via `LEERNESS_TYPEWRITER=1` (TTY 만)
+- `_ui.bold/dim/cyan/green/yellow/hr` — 색상 + 구분선 표준화
+- 비-TTY 환경 자동 fallback (plain text)
+
+### 4. 누적 회귀 (1.9.200~205) — 모두 유지
+
+### 5. stress-v151 — 16/16 PASS
+- i18n (3) + UI helpers (1) + install 다국어 적용 (3) + 성능 (2) + 누적 (7)
+- 성능: --version cold start avg **1049 ms** · MCP 54 도구 **768 ms**
+
+### 6. MVP 노트 (확장 가능 설계)
+- 현재: 10 핵심 keys (설치 가이드 + REPL welcome + common)
+- 추후: REPL agent 모드 전체 메뉴 / handoff / resume 등 확장 가능 (점진적)
+
+### 7. 자동 release
+- main 자동 push **68 라운드 연속** (1.9.140~206)
+- npm publish 자동 (1.9.178~)
+
+---
+
+## 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종).**

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.204-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v149-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-134-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-66_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![tz-aware](https://img.shields.io/badge/timezone-KST_local_time-success)]() [![perf](https://img.shields.io/badge/cold_start-471ms-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.206-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v151-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-136-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-68_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![i18n](https://img.shields.io/badge/i18n-ko%2Fen_MVP-success)]() [![perf](https://img.shields.io/badge/cold_start-1049ms-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.204  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.206  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  ⏰ timezone 보강 (KST) · 🔄 auto-loop 25min 헤드라인 라벨       ║
+  ║  🌐 i18n ko/en MVP · _typewrite/_ui UI/UX 헬퍼 (사용자 명시)        ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 
@@ -530,7 +530,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.144 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.206 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### Core Commands
 
@@ -572,7 +572,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.144는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
+Leerness v1.9.206는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -593,7 +593,7 @@ Leerness v1.9.144는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.9.144)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.206)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -631,6 +631,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.9.144: 2026-05-20
+Last synced by Leerness v1.9.206: 2026-05-22
 <!-- leerness:project-readme:end -->
 

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.204';
+const VERSION = '1.9.206';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -766,19 +766,24 @@ async function resolveInstallOptions(root, opts = {}) {
   // --no-interactive-select 또는 LEERNESS_NO_INTERACTIVE=1 → 구식 숫자 선택
   const useInteractive = shouldAsk && !has('--no-interactive-select') && process.env.LEERNESS_NO_INTERACTIVE !== '1';
   if (shouldAsk && !explicitLang) {
+    // 1.9.206: 언어 선택 자체는 항상 ko (사용자가 언어를 모르므로) → 선택 후 후속은 선택된 언어
     if (useInteractive) {
-      const langOpt = await _selectOne('설치 언어를 선택하세요', [
-        { label: '자동 감지', description: '디렉토리/파일 분석 (한국어/영어 자동 판별)', id: 'auto' },
-        { label: '한국어', description: '모든 인스트럭션을 한국어로 생성', id: 'ko' },
-        { label: 'English', description: '모든 인스트럭션을 영어로 생성', id: 'en' }
+      const langOpt = await _selectOne(_t('install.lang.title', 'ko'), [
+        { label: _t('install.lang.auto', 'ko'), description: _t('install.lang.auto.desc', 'ko'), id: 'auto' },
+        { label: _t('install.lang.ko', 'ko'), description: _t('install.lang.ko.desc', 'ko'), id: 'ko' },
+        { label: _t('install.lang.en', 'ko'), description: _t('install.lang.en.desc', 'ko'), id: 'en' }
       ], { defaultIndex: 0 });
       lang = langOpt && langOpt.id ? detectLanguageValue(root, langOpt.id) : detectLanguageValue(root, 'auto');
     } else {
-      log('\n설치 언어를 선택하세요.');
-      log('1) 자동 감지'); log('2) 한국어'); log('3) English');
-      const a = await ask('선택 [1]: ');
+      log('\n' + _t('install.lang.title', 'ko') + '.');
+      log('1) ' + _t('install.lang.auto', 'ko'));
+      log('2) ' + _t('install.lang.ko', 'ko'));
+      log('3) ' + _t('install.lang.en', 'ko'));
+      const a = await ask('Select / 선택 [1]: ');
       lang = a === '2' ? 'ko' : a === '3' ? 'en' : detectLanguageValue(root, 'auto');
     }
+    // 1.9.206: 영어 선택 시 후속 prompt 영어 표시 환경변수 즉시 설정
+    if (lang === 'en') process.env.LEERNESS_LANG = 'en';
   }
   // 1.9.148: 스킬 prompt 제거 (사용자 명시 요청) — leerness가 자동으로 공식 표준 스킬 5종 설치.
   //   필요할 때 사용자가 leerness skill install <id> 로 추가 가능.
@@ -787,8 +792,10 @@ async function resolveInstallOptions(root, opts = {}) {
   //   _selectMany 로 Space 토글, a 전체, n 해제, Enter 확정. 선택된 에이전트들만 .env.example에 LEERNESS_ENABLE_* 활성화.
   let agentsOptIn = null;   // string[] (다중) 또는 'none' (선택 안함)
   if (shouldAsk && !opts._skipAgentsPrompt) {
+    // 1.9.206: 선택된 언어로 prompt 표시
+    const _agLang = lang === 'en' ? 'en' : 'ko';
     if (useInteractive) {
-      const picked = await _selectMany('CLI 에이전트 활성화 (복수 선택, Space 토글) — sub-agent 위임용', [
+      const picked = await _selectMany(_t('install.agents.title', _agLang), [
         { label: 'Claude (ANTHROPIC_API_KEY 또는 claude CLI)', description: '추론력 최고 — 코드 작성/리뷰 기본', id: 'claude' },
         { label: 'Codex (OpenAI codex CLI)', description: 'OpenAI 코드 모델', id: 'codex' },
         { label: 'Gemini (gemini CLI)', description: 'Google 멀티모달 모델', id: 'gemini' },
@@ -1779,6 +1786,138 @@ async function skillAutoCacheCmd(root, sub) {
   if (c.expired) log(`  → 갱신: leerness skill auto-cache refresh`);
 }
 
+// 1.9.206: i18n 시스템 (사용자 명시) — 설치 가이드 / REPL agent 다국어 + UI/UX 개선
+//   사용자 명시: "설치 가이드에서 언어 선택에 따라 설치 가이드 및 REPL agent 모드 등 설정된 언어로 표시"
+//   설계: 핵심 string table (ko/en) + _t(key, lang) helper. 설치 시 선택 언어 → .harness/LANGUAGE 저장.
+//   lang 결정: explicit > .harness/LANGUAGE > LEERNESS_LANG env > 'ko' (default)
+const STRINGS = {
+  // 설치 가이드 prompt
+  'install.lang.title': { ko: '설치 언어를 선택하세요', en: 'Select install language' },
+  'install.lang.auto':  { ko: '자동 감지', en: 'Auto detect' },
+  'install.lang.auto.desc': { ko: '디렉토리/파일 분석 (한국어/영어 자동 판별)', en: 'Analyze dir/files (auto KO/EN)' },
+  'install.lang.ko': { ko: '한국어', en: 'Korean' },
+  'install.lang.ko.desc': { ko: '모든 인스트럭션을 한국어로 생성', en: 'All instructions in Korean' },
+  'install.lang.en': { ko: 'English', en: 'English' },
+  'install.lang.en.desc': { ko: '모든 인스트럭션을 영어로 생성', en: 'All instructions in English' },
+  'install.agents.title': { ko: 'CLI 에이전트 활성화 (복수 선택, Space 토글) — sub-agent 위임용',
+                            en: 'Enable CLI agents (multi-select, Space toggle) — for sub-agent dispatch' },
+  'install.agents.none': { ko: '선택 안함 (나중에 setup-agents)', en: 'None (later setup-agents)' },
+  'install.complete': { ko: '✓ 설치 완료', en: '✓ Install complete' },
+  // REPL agent 모드
+  'repl.welcome.title': { ko: 'leerness REPL agent', en: 'leerness REPL agent' },
+  'repl.welcome.subtitle': { ko: 'Tab provider · Shift+Tab model · :help · /slash', en: 'Tab provider · Shift+Tab model · :help · /slash' },
+  'repl.welcome.start': { ko: '시작하려면 메시지를 입력하세요', en: 'Type a message to start' },
+  // 공통
+  'common.cancel': { ko: '취소됨', en: 'Cancelled' },
+  'common.confirm': { ko: '확인', en: 'Confirm' },
+  'common.ready': { ko: '준비 완료', en: 'Ready' }
+};
+// 현재 사용 언어 결정 (env > config > 'ko')
+function _currentLang(root) {
+  if (process.env.LEERNESS_LANG) return process.env.LEERNESS_LANG === 'en' ? 'en' : 'ko';
+  try {
+    if (root) {
+      const fp = path.join(root, '.harness', 'LANGUAGE');
+      if (exists(fp)) {
+        const v = read(fp).trim().toLowerCase();
+        if (v === 'en' || v === 'english') return 'en';
+        if (v === 'ko' || v === 'korean' || v === 'kr') return 'ko';
+      }
+    }
+  } catch {}
+  return 'ko';  // default
+}
+function _t(key, lang) {
+  const entry = STRINGS[key];
+  if (!entry) return key;  // fallback: 키 자체 반환
+  return entry[lang || 'ko'] || entry.ko || key;
+}
+
+// 1.9.206: UI/UX 개선 — typewriter / fade-in 효과 (opt-in via LEERNESS_TYPEWRITER=1)
+function _typewrite(text, delayMs) {
+  delayMs = delayMs || 15;
+  if (process.env.LEERNESS_TYPEWRITER !== '1' || !process.stdout.isTTY) {
+    process.stdout.write(text);
+    return Promise.resolve();
+  }
+  return new Promise((resolve) => {
+    let i = 0;
+    const step = () => {
+      if (i >= text.length) return resolve();
+      process.stdout.write(text[i++]);
+      setTimeout(step, delayMs);
+    };
+    step();
+  });
+}
+// 색상 helper (TTY 시 ANSI, 비-TTY 시 plain)
+const _ui = {
+  bold: s => process.stdout.isTTY ? `\x1b[1m${s}\x1b[0m` : s,
+  dim: s => process.stdout.isTTY ? `\x1b[2m${s}\x1b[0m` : s,
+  cyan: s => process.stdout.isTTY ? `\x1b[36m${s}\x1b[0m` : s,
+  green: s => process.stdout.isTTY ? `\x1b[32m${s}\x1b[0m` : s,
+  yellow: s => process.stdout.isTTY ? `\x1b[33m${s}\x1b[0m` : s,
+  // 구분선 정렬 (터미널 width 고려)
+  hr: (char) => {
+    const w = process.stdout.columns || 60;
+    return (char || '─').repeat(Math.min(w - 2, 60));
+  }
+};
+
+// 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 시 즉시 실행 가능
@@ -4224,6 +4363,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') {
@@ -9334,6 +9507,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.204",
+  "version": "1.9.206",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",