leerness 1.9.202 → 1.9.203

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # 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.**

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.202-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v147-15%2F15-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-132-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-64_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![skill-install-top](https://img.shields.io/badge/skill-install--top_즉시-success)]() [![perf](https://img.shields.io/badge/cold_start-457ms-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.202  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.203  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🌐 skill install-top + 설치 상태 · 매트릭스 98/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.202';
+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 처리).
@@ -1733,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.
@@ -3535,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 = {
@@ -4049,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 측정
@@ -9130,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)) {
@@ -14965,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.202",
+  "version": "1.9.203",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",