leerness 1.9.201 → 1.9.203

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # Changelog
 
+## 1.9.203 — 2026-05-22
+
+**📋 자동 라운드 plan 자동 정리 + `leerness resume` 신규 CLI (사용자 명시).**
+
+### 사용자 명시
+> *"자동모드는 백그라운드에 다음 작업이 시작가능한 예상 시간을 설정해서 백그라운드에서 알람 트리거 같은걸 구현하고 일어났을때 해야하는 일을 정리해서 또 진행하고 반복으로 하는건 어떨까"*
+
+### 1. `.harness/auto-resume-plan.json` 자동 저장
+- 라운드 마무리 (release sync-main 시 npm publish 완료 후) **자동 저장**
+- plan 구조:
+  - `savedAt`, `nextRoundVersion`, `expectedFireAt`, `intervalMin`
+  - `focus` (자유 텍스트)
+  - `contextSnapshot` (currentVersion, activeTaskId, activeTaskRequest, memorySurface, r0001Rule)
+  - `nextActions` (1.9.201 next-action-queue snapshot)
+- 함수: `_loadAutoResumePlan` / `_writeAutoResumePlan` / `_buildAutoResumePlan` / `_autoResumePlanPath`
+
+### 2. `leerness resume` 신규 CLI
+일어났을 때 즉시 무엇부터 할지 한눈에:
+```
+$ leerness resume
+# 🔄 leerness resume (1.9.203 자동 라운드 plan 적용)
+  📅 plan 저장: 2026-05-22T00:10:10.797Z  (15분 전)
+  ⏰ 예상 fire: 2026-05-22T00:35:10.797Z  (정시)
+  🎯 focus: 다음 라운드: handoff → next-action take → 사용자 명시 또는 5축 매트릭스 보강
+
+## 다음 라운드: next after 1.9.203
+  현재 버전: 1.9.203
+  활성 task: T-9999 — ...
+  memory: T2/D15/R1/L3
+  룰: 25분 간격 (사용자 명시, R-0001)
+
+## 사전 정리된 next-actions (3건)
+  🛡 lessons.md "X" 관련 ...
+     `leerness lessons --auto --path .`
+  ...
+  → 즉시 task 추가: leerness next-action take
+
+✓ resume 준비 완료 — 권장: leerness handoff . 또는 leerness next-action take
+```
+- `--json` 옵션 (자동화/MCP)
+
+### 3. handoff 자동 plan 알림
+handoff 진입 시 plan 존재 시 자동 노출:
+```
+## 📋 auto-resume-plan 로드 (1.9.203) — 15분 전 저장 (정시)
+  🎯 focus: 다음 라운드: ...
+  📦 다음 버전: next after 1.9.203
+  📥 사전 정리된 actions: 3건 → leerness next-action take
+  → 상세: leerness resume
+```
+끄기: `LEERNESS_NO_RESUME_PLAN=1`
+
+### 4. 자율 모드 cycle 완성
+- 라운드 마무리 → plan 자동 저장 → ScheduleWakeup 25분 → wakeup → handoff plan 자동 로드 → resume / next-action take → 즉시 진입
+
+### 5. 누적 회귀 (1.9.197~202) — 모두 유지
+
+### 6. stress-v148 — 17/17 PASS
+- auto-resume-plan 5 + resume CLI 3 + handoff 통합 + 성능 2 + 누적 회귀 7
+- 성능: --version cold start avg **464 ms** · MCP 54 도구 **449 ms**
+
+### 7. 자동 release 흐름
+- main 자동 push **65 라운드 연속** (1.9.140~203)
+- npm publish 자동 (1.9.178~)
+
+---
+
+## 1.9.202 — 2026-05-22
+
+**🌐 C축 (공식 표준 스킬 자동 활용) 9.0/10 → 9.5/10 보강 — matched skill 설치 상태 표시 + leerness skill install-top.**
+
+자율 모드 132 라운드. 100% 매트릭스 도전 — C축 마지막 0.5 보강 (97 → 97.5).
+
+### 1. install 이력 기록 + 설치 상태 표시
+- `.harness/skill-installed-log.json` (비시크릿, 체크인 가능)
+- 함수: `_loadSkillInstalledLog` / `_appendSkillInstalledLog` / `_isSkillInstalled`
+- handoff matched entry 에 `✓ 설치됨` 또는 `🆕` 태그 자동 표시
+
+### 2. `leerness skill install-top` 신규 CLI
+- handoff 컨텍스트 (in-progress task) 의 keyword 로 official skill 매칭
+- top 1 (이미 설치된 것 자동 skip) 즉시 download + install
+- 설치 후 자동 이력 기록 → 중복 install 방지
+- `--force`: 이미 설치된 것 강제 재설치
+
+### 3. handoff body 통합
+```
+## 🌐 공식 organization 스킬 자동 매칭 (1.9.192/193) — 키워드 "X"
+   ✓ 설치됨 [vercel] skill-A — ...
+   🆕 [anthropic] skill-B — ...
+   → 1개 즉시: leerness skill install-top  (1.9.202)
+   → 전체 설치: leerness skill auto-install --yes
+```
+
+### 4. 누적 회귀 (1.9.196~201) — 모두 유지
+
+### 5. stress-v147 — 15/15 PASS
+- 설치 이력 (6) + 성능 (2) + 누적 회귀 (7)
+- 성능: --version cold start avg **457 ms** · MCP 54 도구 **468 ms**
+
+### 6. 5축 매트릭스
+| 축 | 1.9.201 | 1.9.202 | 상태 |
+|---|---|---|---|
+| C. 공식 표준 스킬 자동 활용 | 9.0 | **9.5** | +0.5 (설치 상태 + install-top) |
+| **종합** | 48.5/50 (97%) | **49/50 (98%)** | **+1%** |
+
+### 7. 자동 release
+- main 자동 push **64 라운드 연속** (1.9.140~202)
+- npm publish 자동 (1.9.178~)
+
+---
+
 ## 1.9.201 — 2026-05-22
 
 **🎯 E축 (게으름 방지) 9.5/10 → 10/10 보강 — next-action queue + leerness next-action take 명령.**

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.201-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v146-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-131-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-63_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-97%2F100_(5축)-brightgreen)]() [![next-action](https://img.shields.io/badge/next--action-1step_자동_task_add-success)]() [![perf](https://img.shields.io/badge/cold_start-436ms-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.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)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.201  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.203  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🎯 next-action 1step · 매트릭스 97/100 · A·D·E 10/10           ║
+  ║  📋 auto-resume-plan + leerness resume · 자율 cycle 완성        ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.201';
+const VERSION = '1.9.203';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -1556,6 +1556,77 @@ async function skillDiscoverCmd(root) {
   log(`💡 설치: leerness skill install <url>`);
 }
 
+// 1.9.202: C축 (공식 표준 스킬 자동 활용) 9.0→9.5 보강 — install 이력 기록 + 설치 상태 표시
+//   1.9.192 official catalog 매칭 시 "이미 설치됨" / "신규" 구분 → 중복 install 방지 + 사용자 인지 도움
+//   파일: .harness/skill-installed-log.json (비시크릿)
+function _skillInstalledLogPath(root) { return path.join(root, '.harness', 'skill-installed-log.json'); }
+function _loadSkillInstalledLog(root) {
+  try {
+    const fp = _skillInstalledLogPath(root);
+    if (!exists(fp)) return { installed: [] };
+    const j = JSON.parse(read(fp));
+    return { installed: Array.isArray(j.installed) ? j.installed : [] };
+  } catch { return { installed: [] }; }
+}
+function _appendSkillInstalledLog(root, entry) {
+  try {
+    const state = _loadSkillInstalledLog(root);
+    const e = { name: entry.name, source: entry.source || entry.preset || '?', url: entry.url || '', at: new Date().toISOString() };
+    // 중복 (같은 name + source) 제거 후 append
+    state.installed = state.installed.filter(x => !(x.name === e.name && x.source === e.source));
+    state.installed.push(e);
+    mkdirp(path.join(root, '.harness'));
+    writeUtf8(_skillInstalledLogPath(root), JSON.stringify({ installed: state.installed }, null, 2));
+    return true;
+  } catch { return false; }
+}
+function _isSkillInstalled(root, entry) {
+  try {
+    const state = _loadSkillInstalledLog(root);
+    const src = entry.source || entry.preset || '?';
+    return state.installed.some(x => x.name === entry.name && x.source === src);
+  } catch { return false; }
+}
+
+// 1.9.202: leerness skill install-top — handoff matched 의 top 1 entry 를 즉시 install
+async function skillInstallTopCmd(root) {
+  root = absRoot(root);
+  // handoff context 의 keyword 추출
+  const rows = readProgressRows(root);
+  const active = rows.find(r => r.status === 'in-progress' || r.status === '[진행]') || rows[rows.length - 1];
+  if (!active || !active.request) { fail('in-progress task 없음 — leerness handoff . 먼저'); return process.exit(1); }
+  const m = _matchOfficialSkillsFromCache(root, active.request, 3);
+  if (m.entries.length === 0) {
+    fail(`매칭된 official skill 없음 (keyword: "${(active.request || '').slice(0, 40)}", cache total: ${m.cacheTotal || 0})`);
+    return process.exit(1);
+  }
+  // 이미 설치된 것 skip
+  const candidates = m.entries.filter(e => !_isSkillInstalled(root, e));
+  if (candidates.length === 0) {
+    log(`✓ 모든 매칭된 skill 이미 설치됨 (1.9.202 log 기준):`);
+    for (const e of m.entries) log(`  • ${e.name} (${e.preset || e.source}) — 이미 설치`);
+    log(`  → leerness skill install-top --force 로 재설치`);
+    return;
+  }
+  const top = has('--force') ? m.entries[0] : candidates[0];
+  log(`# leerness skill install-top (1.9.202 C축 보강)`);
+  log(`  task: ${(active.request || '').slice(0, 80)}`);
+  log(`  매칭: ${m.total}/${m.cacheTotal}건 · top 1 → ${top.name} (${top.preset || top.source})`);
+  log(`  URL: ${top.url || '(none)'}`);
+  log('');
+  if (!top.url) { fail(`top entry url 부재 — install 불가`); return process.exit(1); }
+  try {
+    log(`📥 install 시작...`);
+    await skillInstallCmd(root, top.url);
+    _appendSkillInstalledLog(root, top);
+    log('');
+    log(`✓ 설치 + 이력 기록 완료 (.harness/skill-installed-log.json)`);
+  } catch (e) {
+    fail(`install 실패: ${e.message}`);
+    return process.exit(1);
+  }
+}
+
 // 1.9.182: skill auto-install — 공식 organization catalog 자동 탐색 → skill match → 자동 install.
 //   사용자 명시: "스킬을 사용하거나 적용해두면 좋을 부분들을 알아서 웹에서 공식 조직의 스킬 모음을 탐색해서 다운로드 받아서 사용"
 //   정책: LEERNESS_SKILL_AUTO_INSTALL=1 일 때만 실제 install (보안 opt-in). 미설정 시 dry-run (추천만).
@@ -1662,6 +1733,115 @@ async function skillAutoCacheCmd(root, sub) {
   if (c.expired) log(`  → 갱신: leerness skill auto-cache refresh`);
 }
 
+// 1.9.203: 자동 라운드 plan 정리 — 사용자 명시
+//   "백그라운드에 다음 작업이 시작가능한 예상 시간 + 일어났을때 해야하는 일을 정리"
+//   라운드 마무리 시 .harness/auto-resume-plan.json 자동 저장 → 다음 wakeup 시 즉시 실행 가능
+//   plan 구조: { savedAt, nextRoundVersion, expectedFireAt, focus, contextSnapshot, nextActions }
+function _autoResumePlanPath(root) { return path.join(root, '.harness', 'auto-resume-plan.json'); }
+function _loadAutoResumePlan(root) {
+  try {
+    const fp = _autoResumePlanPath(root);
+    if (!exists(fp)) return null;
+    const j = JSON.parse(read(fp));
+    if (!j.savedAt) return null;
+    const ageMs = Date.now() - new Date(j.savedAt).getTime();
+    const expiredMs = j.expectedFireAt ? Date.now() - new Date(j.expectedFireAt).getTime() : 0;
+    return { ...j, ageMs, ageMin: Math.floor(ageMs / 60000), elapsedFromExpected: Math.floor(expiredMs / 60000) };
+  } catch { return null; }
+}
+function _writeAutoResumePlan(root, plan) {
+  try {
+    mkdirp(path.join(root, '.harness'));
+    const payload = { savedAt: new Date().toISOString(), ...plan };
+    writeUtf8(_autoResumePlanPath(root), JSON.stringify(payload, null, 2));
+    return true;
+  } catch { return false; }
+}
+// 현재 워크스페이스 상태에서 다음 라운드 plan 자동 생성 (현재 task / matrix / handoff gap / next-action queue 결합)
+function _buildAutoResumePlan(root, opts) {
+  opts = opts || {};
+  const intervalMin = opts.intervalMin || 25;  // R-0001 영구 룰
+  const now = Date.now();
+  const expectedFireAt = new Date(now + intervalMin * 60 * 1000).toISOString();
+  // 현재 in-progress task
+  const rows = readProgressRows(root);
+  const active = rows.find(r => r.status === 'in-progress' || r.status === '[진행]');
+  // 현재 VERSION
+  const currentVersion = VERSION;
+  // next-action queue snapshot
+  const queueState = _loadNextActionQueue(root);
+  const queueTop = queueState.queue.length > 0 ? queueState.queue[queueState.queue.length - 1] : null;
+  // memory surface counts
+  const memorySurface = {
+    tasksInProgress: rows.filter(r => r.status === 'in-progress').length,
+    decisions: exists(decisionsPath(root)) ? (read(decisionsPath(root)).match(/^### \d{4}-\d{2}-\d{2}/gm) || []).length : 0,
+    rulesActive: readRules(root).filter(r => r.status === 'active').length,
+    lessons: exists(lessonsPath(root)) ? (read(lessonsPath(root)).match(/^### \d{4}-\d{2}-\d{2}/gm) || []).length : 0
+  };
+  return {
+    nextRoundVersion: opts.nextRoundVersion || `next after ${currentVersion}`,
+    expectedFireAt,
+    intervalMin,
+    focus: opts.focus || (active ? `${active.id} — ${(active.request || '').slice(0, 80)}` : '사용자 명시 대기 또는 5축 매트릭스 보강'),
+    contextSnapshot: {
+      currentVersion,
+      activeTaskId: active ? active.id : null,
+      activeTaskRequest: active ? (active.request || '').slice(0, 200) : null,
+      memorySurface,
+      r0001Rule: '25분 간격 (사용자 명시, R-0001)'
+    },
+    nextActions: (queueState.queue || []).slice(-3).map(a => ({ icon: a.icon, title: a.title, command: a.command || null })),
+    note: opts.note || '다음 wakeup 시 leerness resume 또는 leerness handoff 실행 → plan 자동 적용'
+  };
+}
+
+// 1.9.203: leerness resume 신규 CLI — auto-resume-plan 읽고 즉시 진행할 일 안내
+function resumeCmd(root) {
+  root = absRoot(root);
+  const plan = _loadAutoResumePlan(root);
+  if (!plan) {
+    log(`# leerness resume (1.9.203)`);
+    log(`  (auto-resume-plan 없음 — 첫 라운드)`);
+    log(`  → leerness handoff . 로 시작`);
+    return;
+  }
+  if (has('--json')) { log(JSON.stringify(plan, null, 2)); return; }
+  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 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(`  🎯 focus: ${plan.focus}`);
+  log('');
+  log(grn(`## 다음 라운드: ${plan.nextRoundVersion}`));
+  if (plan.contextSnapshot) {
+    const c = plan.contextSnapshot;
+    log(`  현재 버전: ${c.currentVersion}`);
+    if (c.activeTaskId) log(`  활성 task: ${c.activeTaskId} — ${(c.activeTaskRequest || '').slice(0, 70)}`);
+    const m = c.memorySurface || {};
+    log(`  memory: T${m.tasksInProgress || 0}/D${m.decisions || 0}/R${m.rulesActive || 0}/L${m.lessons || 0}`);
+    log(`  룰: ${c.r0001Rule || '-'}`);
+  }
+  if (plan.nextActions && plan.nextActions.length > 0) {
+    log('');
+    log(grn(`## 사전 정리된 next-actions (${plan.nextActions.length}건)`));
+    for (const a of plan.nextActions) {
+      log(`  ${a.icon || '•'} ${a.title}`);
+      if (a.command) log(dim(`     \`${a.command}\``));
+    }
+    log('');
+    log(dim(`  → 즉시 task 추가: leerness next-action take`));
+  }
+  log('');
+  log(dim(plan.note || ''));
+  log('');
+  log(grn(`✓ resume 준비 완료 — 권장: leerness handoff . 또는 leerness next-action take`));
+}
+
 // 1.9.199: wakeup miss 자동 회복 강화 — last-handoff timestamp 기록 + 25min 기대 interval 정밀 측정
 //   사용자 명시 (1.9.198 후속): "22:01에 라운드에 자동진입되지않았어"
 //   1.9.196 task-log mtime 기반 detector 는 task-log 가 자주 안 업데이트되면 false positive.
@@ -3464,6 +3644,9 @@ function handoff(root) {
   let _priorHandoffGap = { hasLast: false };
   try { _priorHandoffGap = _getLastHandoffGap(root); } catch {}
   try { _recordLastHandoff(root); } catch {}
+  // 1.9.203: auto-resume-plan 자동 로드 (사용자 명시 — 자동 모드 알람 트리거)
+  let _autoResumePlan = null;
+  try { _autoResumePlan = _loadAutoResumePlan(root); } catch {}
   // 1.9.96: --json 옵션 (구조화 출력, MCP 통합 / 외부 AI 친화)
   if (has('--json')) {
     const result = {
@@ -3835,10 +4018,14 @@ function handoff(root) {
                       log(cyan(`## 🌐 공식 organization 스킬 자동 매칭 (1.9.192/193) — 키워드 "${keyword}"`));
                       const ageLabel = veryStale ? yel(`${cacheAge} ⚠ 7일+`) : (ofm.expired ? yel(`${cacheAge} ⚠ 만료`) : `${cacheAge} ✓`);
                       log(dim(`  vercel-labs/anthropics 등 catalog 캐시 ${ageLabel} · ${ofm.total}/${ofm.cacheTotal}건 매칭`));
+                      // 1.9.202: 각 entry 의 설치 상태 표시 (installed/new)
                       for (const e of ofm.entries) {
-                        log(dim(`  • [${e.preset || e.source || '?'}] ${e.name} — ${(e.description || '').slice(0, 70)}`));
+                        const installed = _isSkillInstalled(root, e);
+                        const tag = installed ? '✓ 설치됨' : '🆕';
+                        log(dim(`  ${tag} [${e.preset || e.source || '?'}] ${e.name} — ${(e.description || '').slice(0, 65)}`));
                       }
-                      log(dim(`  → 설치: leerness skill auto-install --yes`));
+                      log(dim(`  → 1개 즉시: leerness skill install-top  (1.9.202)`));
+                      log(dim(`  → 전체 설치: leerness skill auto-install --yes`));
                       if (ofm.expired || veryStale) log(yel(`  → 갱신 권장: leerness skill auto-cache refresh  (1.9.193 ${veryStale ? '7일+ stale' : '24h+ expired'})`));
                       log('');
                     } else if (ofm.cacheTotal === 0) {
@@ -3974,6 +4161,26 @@ function handoff(root) {
       }
     } catch {}
   }
+  // 1.9.203: auto-resume-plan 알림 — 라운드 마무리 시 저장된 plan 자동 노출
+  //   사용자 명시: "백그라운드에 다음 작업이 시작가능한 예상 시간 + 일어났을때 해야하는 일을 정리"
+  if (_autoResumePlan && !has('--quiet') && process.env.LEERNESS_NO_RESUME_PLAN !== '1') {
+    try {
+      const isTty = process.stdout && process.stdout.isTTY;
+      const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+      const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+      const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+      const elapsed = _autoResumePlan.elapsedFromExpected || 0;
+      const status = elapsed > 5 ? yel(`(${elapsed}분 지연)`) : (elapsed > -5 ? '(정시)' : dim(`(${Math.abs(elapsed)}분 일찍)`));
+      log(cy(`## 📋 auto-resume-plan 로드 (1.9.203) — ${_autoResumePlan.ageMin}분 전 저장 ${status}`));
+      log(dim(`  🎯 focus: ${_autoResumePlan.focus || '(none)'}`));
+      log(dim(`  📦 다음 버전: ${_autoResumePlan.nextRoundVersion || '(none)'}`));
+      if (_autoResumePlan.nextActions && _autoResumePlan.nextActions.length > 0) {
+        log(dim(`  📥 사전 정리된 actions: ${_autoResumePlan.nextActions.length}건 → leerness next-action take`));
+      }
+      log(dim(`  → 상세: leerness resume`));
+      log('');
+    } catch {}
+  }
   // 1.9.196/199: ScheduleWakeup miss detector — 자율 모드 사용자 명시 "못일어나는 경우 종종 있음"
   //   1.9.196: task-log mtime 기반 (60min+) — false positive 가능
   //   1.9.199: last-handoff.json 정밀 측정 — R-0001 룰 (25min) 대비 gap 측정
@@ -9055,6 +9262,16 @@ function _publishToNpm(root, opts = {}) {
     if (pubR.status === 0) {
       ok(`npm publish 완료: ${pkgName}@${pkgVersion}`);
       try { _recordRun(root, { kind: 'npm_publish', package: pkgName, version: pkgVersion, dryRun: !!opts.dryRun, ok: true }); } catch {}
+      // 1.9.203: 라운드 마무리 시 다음 라운드 plan 자동 저장
+      try {
+        const plan = _buildAutoResumePlan(root, {
+          nextRoundVersion: `next after ${pkgVersion}`,
+          focus: '다음 라운드: handoff → next-action take → 사용자 명시 또는 5축 매트릭스 보강',
+          intervalMin: 25,
+          note: `다음 wakeup 시: 1) leerness resume . 으로 plan 확인  2) leerness handoff . 실행  3) leerness next-action take 로 즉시 task 진입`
+        });
+        _writeAutoResumePlan(root, plan);
+      } catch {}
     } else {
       const errOut = (pubR.stderr || pubR.stdout || '').slice(-400);
       if (/EPUBLISHCONFLICT|already exists|cannot publish over/i.test(errOut)) {
@@ -14875,6 +15092,8 @@ async function main() {
   if (cmd === 'skill' && args[1] === 'suggest')     return skillSuggestCmd(absRoot(arg('--path', process.cwd())));
   // 1.9.182: leerness skill auto-install — 공식 catalog 자동 탐색 + skill match 매칭 시 자동 install (사용자 명시)
   if (cmd === 'skill' && args[1] === 'auto-install') return await skillAutoInstallCmd(absRoot(arg('--path', process.cwd())));
+  // 1.9.202: leerness skill install-top — handoff matched top 1 즉시 install (C축 9→9.5 보강)
+  if (cmd === 'skill' && args[1] === 'install-top') return await skillInstallTopCmd(absRoot(arg('--path', process.cwd())));
   // 1.9.192: skill auto-cache — 공식 organization catalog 24h 캐시 관리 (C축 보강)
   if (cmd === 'skill' && args[1] === 'auto-cache')   return await skillAutoCacheCmd(absRoot(arg('--path', process.cwd())), args[2] || 'status');
   if (cmd === 'mcp' && args[1] === 'serve')         return mcpServeCmd(absRoot(arg('--path', process.cwd())));
@@ -14888,6 +15107,8 @@ async function main() {
   if (cmd === 'roadmap')                            return roadmapCmd(args[1] || process.cwd());
   // 1.9.201: next-action queue CLI (E축 9.5→10)
   if (cmd === 'next-action')                        return nextActionCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
+  // 1.9.203: leerness resume — auto-resume-plan 읽고 다음 라운드 즉시 안내 (사용자 명시)
+  if (cmd === 'resume')                             return resumeCmd(arg('--path', process.cwd()));
   if (cmd === 'rule' && args[1] === 'add')          return ruleAdd(arg('--path', process.cwd()), args.slice(2).filter(x => !x.startsWith('-')).join(' '));
   if (cmd === 'rule' && args[1] === 'list')         return ruleList(arg('--path', process.cwd()));
   if (cmd === 'rule' && args[1] === 'remove')       return ruleRemove(arg('--path', process.cwd()), args[2]);

package/package.json

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