leerness 1.9.127 → 1.9.129

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 1.9.129 — 2026-05-20
+
+**handoff 7번째 자동 회수 — 🗑 최근 24h archive 알림** — DELETE 5종 archive 활동을 매 세션 시작 시 자동 노출.
+
+### Added — handoff archive 알림
+- handoff 출력에 archive 활동 라인 추가:
+  ```
+  🗑 최근 24h archive (1.9.129): D2/L1/P0 (3건 archived) — 복원 후보
+    → 회수: leerness memory archive list --json
+    → 복원: leerness memory restore <surface> <target>
+  ```
+- 3 archive 파일 (`decisions.archive.md`, `lessons.archive.md`, `plan.archive.md`) 의 mtime 24h 내 + entry date 24h 내만 카운트
+- `--no-mem-delta` / `--compact` / `--quiet` / `LEERNESS_NO_MEM_DELTA=1` 로 끄기
+
+### 7개 handoff 자동 회수
+| # | 라운드 | 자동 회수 |
+|---|---|---|
+| 1 | (기존) | lessons matching |
+| 2 | 1.9.45 | skill match 추천 |
+| 3 | 1.9.69 | history hit |
+| 4 | 1.9.88 | brainstorm hits |
+| 5 | 1.9.81 | 통합 헤드라인 |
+| 6 | 1.9.121 | 🆕 24h 메모리 변동 |
+| **7** | **1.9.129** | **🗑 24h archive 알림** |
+
+### 사용 시나리오
+세션 시작 시 handoff:
+```
+🆕 최근 24h 메모리 변동 (1.9.121): task +3 · decision +1 · plan: 변경됨
+🗑 최근 24h archive (1.9.129): D1/L0/P1 (2건 archived) — 복원 후보
+  → 회수: leerness memory archive list --json
+  → 복원: leerness memory restore <surface> <target>
+```
+AI 가 즉시 "어제 PostgreSQL 결정 취소했었네 — 다시 검토해야 할까?" 판단 가능.
+
+## 1.9.128 — 2026-05-20
+
+**`leerness memory restore` CLI + MCP 40번째 도구 `leerness_memory_restore`** 🎉 **MCP 40 도구 마일스톤** — DELETE→RESTORE cycle 완성.
+
+### Added — `leerness memory restore <surface> <target>` CLI
+- surface: `decisions` | `lessons` | `plan`
+- target: date YYYY-MM-DD 또는 substring 매칭
+- archive 의 매칭 블록을 active 파일 끝에 복귀
+- archive 에서 제거 (또는 다 비면 헤더만 남김)
+- 여러 매칭 동시 복원 가능
+- Invalid surface / 미매칭 → fail
+
+### Added — MCP 40번째 도구 `leerness_memory_restore` 🎉
+- 외부 AI 가 직접 archive 복원
+- 인자: `{ surface (required), target (required), path? }`
+
+### DELETE → RESTORE cycle 완성
+1. `decision drop "PostgreSQL"` → 제거 + archive
+2. `memory archive list --surface decisions` → 후보 회수
+3. `memory restore decisions "PostgreSQL"` → 복원
+
+### 사용 시나리오
+사용자: "어제 잘못 취소한 PostgreSQL 결정 다시 살려줘"
+→ 외부 AI: `leerness_memory_restore({ surface: "decisions", target: "PostgreSQL" })` — archive에서 active로 복귀
+
+### MCP 도구 누계: 40 🎉 (1.9.127: 39 + leerness_memory_restore — MCP 40 마일스톤)
+
 ## 1.9.127 — 2026-05-20
 
 **`leerness memory archive list` CLI + MCP 39번째 도구 `leerness_memory_archive_list`** — DELETE 5종 archive 통합 조회 (decisions/lessons/plan).

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.127-green)]() [![tests](https://img.shields.io/badge/e2e-219%2F219-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-39-blue)]() [![json](https://img.shields.io/badge/--json-19_commands-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-57-blueviolet)]() [![memory-delete](https://img.shields.io/badge/Memory--DELETE-5--complete-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.129-green)]() [![tests](https://img.shields.io/badge/e2e-219%2F219-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-40_🎉-blue)]() [![json](https://img.shields.io/badge/--json-19_commands-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-59-blueviolet)]() [![handoff](https://img.shields.io/badge/handoff--auto--recovery-7-blueviolet)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,7 +12,7 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.127  AI Agent Reliability Harness                      ║
+  ║  v1.9.129  AI Agent Reliability Harness                      ║
   ║  verify · remember · orchestrate · audit · prevent drift     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```

package/bin/harness.js

@@ -6,7 +6,7 @@ const path = require('path');
 const cp = require('child_process');
 const readline = require('readline');
 
-const VERSION = '1.9.127';
+const VERSION = '1.9.129';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -328,6 +328,8 @@ leerness audit . --fix               # 누락 메타 자동 보강
 - 1.9.125+ \`leerness decision drop <target>\` + MCP **37 도구** (\`leerness_decision_drop\`) — 잘못 저장한 결정 제거 (archive 보존).
 - 1.9.126+ \`leerness plan remove <M-XXXX|title>\` + MCP **38 도구** (\`leerness_plan_remove\`) — milestone 영구 제거 (archive 보존). **Memory Surface DELETE 5종 완전 완성** 🎉.
 - 1.9.127+ \`leerness memory archive list [--surface decisions|lessons|plan] [--json]\` + MCP **39 도구** (\`leerness_memory_archive_list\`) — DELETE 5종 archive 통합 조회 (복원 후보 회수).
+- 1.9.128+ \`leerness memory restore <surface> <target>\` + MCP **40 도구 🎉** (\`leerness_memory_restore\`) — archive → active 복귀 (DELETE→RESTORE cycle 완성). **MCP 40 도구 마일스톤**.
+- 1.9.129+ handoff **7번째 자동 회수** — \`🗑 최근 24h archive\` (D/L/P 카운트 + 복원 후보 안내). DELETE 활동 자동 인지.
 
 ---
 
@@ -1530,6 +1532,64 @@ function memoryArchiveListCmd(root, opts = {}) {
   log(`\n📊 Total archived: ${totals.all} entries (D${totals.decisions}/L${totals.lessons}/P${totals.plan})`);
 }
 
+// 1.9.128: memory restore — archive 의 블록을 active 파일로 복귀 (DELETE→RESTORE cycle 완성)
+//   surface: decisions|lessons|plan
+//   target: date (YYYY-MM-DD) 또는 target substring 매칭
+//   매칭 archive 블록을 active 파일 끝에 추가 + archive 에서 제거
+function memoryRestoreCmd(root, surface, target) {
+  root = absRoot(root);
+  if (!surface || !['decisions', 'lessons', 'plan'].includes(surface)) {
+    return fail('memory restore <decisions|lessons|plan> <target> 필요 (target: date YYYY-MM-DD 또는 substring)');
+  }
+  if (!target) return fail('memory restore <surface> <target> — target 누락');
+  const hd = path.join(root, '.harness');
+  const archivePath = path.join(hd, `${surface}.archive.md`);
+  if (!exists(archivePath)) return fail(`${surface}.archive.md 없음 — 복원할 항목 없음`);
+  const text = read(archivePath);
+  // archive 헤더 (# X archive) 와 본문 분리
+  const headerMatch = text.match(/^(# [^\n]*\n+)([\s\S]*)$/);
+  const archiveHeader = headerMatch ? headerMatch[1] : '';
+  const body = headerMatch ? headerMatch[2] : text;
+  // body 를 "## 제거 " 단위로 split
+  const blocks = body.split(/\n(?=## 제거 )/);
+  const kept = [];
+  const restoredBlocks = [];
+  for (const b of blocks) {
+    if (!b.trim()) continue;
+    const m = b.match(/^## 제거 (\d{4}-\d{2}-\d{2})\s*\(target:\s*"([^"]*)"\)/);
+    if (!m) { kept.push(b); continue; }
+    const date = m[1];
+    const blockTarget = m[2];
+    const isDateTarget = date === target;
+    const isSubstring = blockTarget.includes(target);
+    if (isDateTarget || isSubstring) {
+      // archive 블록에서 원래 active 블록만 추출 (## 제거 ... 한 줄 + 다음 line부터)
+      const content = b.replace(/^## 제거 [^\n]*\n+/, '');
+      if (content.trim()) restoredBlocks.push(content.trim());
+    } else {
+      kept.push(b);
+    }
+  }
+  if (restoredBlocks.length === 0) return fail(`매칭 archive entry 없음: surface=${surface}, target="${target}"`);
+  // active 파일 경로
+  const activePath = surface === 'decisions' ? decisionsPath(root)
+                    : surface === 'lessons'   ? lessonsPath(root)
+                    : planPath(root);
+  // active 파일에 복귀 (헤더 보존)
+  for (const blk of restoredBlocks) {
+    append(activePath, '\n' + blk + '\n');
+  }
+  // archive 재작성 — 모두 제거되면 파일 비움 (헤더만 남김 또는 삭제)
+  if (kept.length === 0) {
+    // archive 헤더만 남겨도 의미 있음 — 향후 다시 사용 가능
+    writeUtf8(archivePath, archiveHeader);
+  } else {
+    writeUtf8(archivePath, archiveHeader + kept.join('\n'));
+  }
+  ok(`${surface} restored: ${restoredBlocks.length}건 (archive에서 active로 복귀)`);
+  _autoRoadmap(absRoot(root), 'data-change');
+}
+
 // 1.9.117: lesson list — lessons.md 의 모든 항목 조회 + --tag 필터 + --json
 function lessonListCmd(root, opts = {}) {
   root = absRoot(root);
@@ -2732,6 +2792,48 @@ function handoff(root) {
       }
     } catch {}
   }
+  // 1.9.129: handoff 7번째 자동 회수 — 🗑 최근 24h archive 알림
+  //   DELETE 5종 archive 파일 (.harness/decisions.archive.md, lessons.archive.md, plan.archive.md)
+  //   에 최근 24h 내 추가된 entry 카운트를 노출. AI가 잘못 제거한 항목을 즉시 인지 + restore 후보 회수.
+  //   `leerness memory archive list` / `leerness memory restore <surface> <target>` 안내 포함.
+  if (!has('--no-mem-delta') && !has('--compact') && !has('--quiet') && process.env.LEERNESS_NO_MEM_DELTA !== '1') {
+    try {
+      const isTtyArc = process.stdout && process.stdout.isTTY;
+      const arcCy = s => isTtyArc ? `\x1b[36m${s}\x1b[0m` : s;
+      const arcDim = s => isTtyArc ? `\x1b[2m${s}\x1b[0m` : s;
+      const hd = path.join(root, '.harness');
+      const cutoffArchive = Date.now() - 24 * 60 * 60 * 1000;
+      const today = new Date().toISOString().slice(0, 10);
+      const yest = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
+      const surfaces = [
+        { key: 'D', label: 'decisions', file: 'decisions.archive.md' },
+        { key: 'L', label: 'lessons',   file: 'lessons.archive.md' },
+        { key: 'P', label: 'plan',      file: 'plan.archive.md' }
+      ];
+      const archiveDeltas = [];
+      let totalRecent = 0;
+      for (const s of surfaces) {
+        const fp = path.join(hd, s.file);
+        if (!exists(fp)) continue;
+        try {
+          const stat = fs.statSync(fp);
+          if (stat.mtimeMs < cutoffArchive) continue; // 파일 자체가 24h 외면 skip
+          const entries = _parseArchiveBlocks(read(fp));
+          const recent = entries.filter(e => e.date === today || e.date === yest).length;
+          if (recent > 0) {
+            archiveDeltas.push(`${s.key}${recent}`);
+            totalRecent += recent;
+          }
+        } catch {}
+      }
+      if (totalRecent > 0) {
+        log(arcCy(`🗑  최근 24h archive (1.9.129): ${archiveDeltas.join('/')} (${totalRecent}건 archived) — 복원 후보`));
+        log(arcDim(`  → 회수: leerness memory archive list --json`));
+        log(arcDim(`  → 복원: leerness memory restore <surface> <target>`));
+        log('');
+      }
+    } catch {}
+  }
   // 1.9.76: handoff 보안 상태 요약 — .env vs .env.example + .gitignore 시크릿 패턴 1줄 요약
   // 매 세션 시작 시 AI가 보안 위험을 즉시 인지. --no-security-summary 또는 --compact로 끄기
   if (!has('--no-security-summary') && !has('--compact') && !has('--quiet')) {
@@ -4136,7 +4238,7 @@ function _banner(opts = {}) {
   lines.push('');
   for (const ln of lines) log(ln);
   if (opts.quickStart) {
-    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.127+ memory archive list — 57 라운드 자율 누적)')));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.129+ handoff 7 자동 회수 🗑 archive 알림 — 59 라운드 자율 누적)')));
     log('    ' + C.green('npx leerness@latest init .') + C.dim('                          # 신규 프로젝트 + 외부 AI CLI 설정'));
     log('    ' + C.green('npx leerness handoff .') + C.dim('                              # 컨텍스트 + lessons + 매칭 skill + history hit + brainstorm hits + 헤드라인'));
     log('    ' + C.green('npx leerness handoff . --quiet') + C.dim('                      # 자동화/CI 모드 (1.9.99) — 자동 회수 라인 비활성'));
@@ -4152,9 +4254,9 @@ function _banner(opts = {}) {
     log('    ' + C.green('npx leerness session close .') + C.dim('                        # 마감 + 다음 라운드 추천 (default)'));
     log('');
     log(C.bold(C.cyan('  🤖 메인 에이전트 (Claude/Cursor/Copilot)용')));
-    log('    ' + C.green('npx leerness mcp serve') + C.dim('                              # MCP 서버 — 39 도구 (memory_archive_list 추가, 1.9.127)'));
-    log('    ' + C.green('npx leerness plan remove <M-XXXX|title>') + C.dim('             # milestone 영구 제거 (archive 보존, 1.9.126) — Memory DELETE 5종 완성'));
+    log('    ' + C.green('npx leerness mcp serve') + C.dim('                              # MCP 서버 — 40 도구 🎉 (memory_restore 추가, 1.9.128)'));
     log('    ' + C.green('npx leerness memory archive list --json') + C.dim('              # DELETE 5종 archive 통합 조회 (1.9.127) — D/L/P entries + 복원 후보'));
+    log('    ' + C.green('npx leerness memory restore <surface> <target>') + C.dim('       # archive → active 복원 (1.9.128) — DELETE→RESTORE cycle'));
     log('    ' + C.green('npx leerness lesson save "<text>" --tag "..."') + C.dim('       # lessons.md 직접 write (1.9.112 — handoff 자동 회수와 통합)'));
     log('    ' + C.green('npx leerness memory status . --json') + C.dim('                  # Memory Surface 5종 통합 상태 JSON (1.9.114)'));
     log('    ' + C.green('npx leerness decision add "<title>" --reason "..."') + C.dim('   # 설계 결정 영구화 (1.9.108) — handoff lessons 자동 회수와 통합'));
@@ -8337,7 +8439,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_lesson_drop', description: '1.9.124 — lessons.md 에서 특정 lesson 제거 (target: date YYYY-MM-DD 또는 text substring). 잘못 저장한 lesson 제거. 제거된 블록은 .harness/lessons.archive.md 에 자동 보존 (복구 가능)', inputSchema: { type: 'object', properties: { target: { type: 'string' }, path: { type: 'string' } }, required: ['target'] } },
     { name: 'leerness_decision_drop', description: '1.9.125 — decisions.md 에서 특정 결정 제거 (target: date YYYY-MM-DD 또는 title substring). 제거된 블록은 .harness/decisions.archive.md 에 자동 보존', inputSchema: { type: 'object', properties: { target: { type: 'string' }, path: { type: 'string' } }, required: ['target'] } },
     { name: 'leerness_plan_remove', description: '1.9.126 — plan.md 에서 특정 milestone 블록 (### M-XXXX) 제거 (target: M-XXXX 또는 title substring). 제거된 블록은 .harness/plan.archive.md 에 자동 보존. Memory Surface DELETE 5종 완전 완성', inputSchema: { type: 'object', properties: { target: { type: 'string' }, path: { type: 'string' } }, required: ['target'] } },
-    { name: 'leerness_memory_archive_list', description: '1.9.127 — DELETE 5종 archive 파일 통합 조회 JSON ({ decisions: [], lessons: [], plan: [], totals: { decisions, lessons, plan, all } }). 외부 AI가 과거에 제거된 항목을 회수/복원 후보로 참조. --surface 필터: decisions|lessons|plan', inputSchema: { type: 'object', properties: { surface: { type: 'string' }, path: { type: 'string' } } } }
+    { name: 'leerness_memory_archive_list', description: '1.9.127 — DELETE 5종 archive 파일 통합 조회 JSON ({ decisions: [], lessons: [], plan: [], totals: { decisions, lessons, plan, all } }). 외부 AI가 과거에 제거된 항목을 회수/복원 후보로 참조. --surface 필터: decisions|lessons|plan', inputSchema: { type: 'object', properties: { surface: { type: 'string' }, path: { type: 'string' } } } },
+    { name: 'leerness_memory_restore', description: '1.9.128 — archive 의 항목을 active 파일로 복귀 (DELETE→RESTORE cycle). surface: decisions|lessons|plan. target: date YYYY-MM-DD 또는 target substring 매칭. 복원된 블록은 archive 에서 제거됨. 🎉 MCP 40 도구 마일스톤', inputSchema: { type: 'object', properties: { surface: { type: 'string', enum: ['decisions', 'lessons', 'plan'] }, target: { type: 'string' }, path: { type: 'string' } }, required: ['surface', 'target'] } }
   ];
 
   function send(obj) {
@@ -8408,6 +8511,7 @@ function mcpServeCmd(root) {
           case 'leerness_decision_drop':   cliArgs = ['decision', 'drop', String(args.target || ''), '--path', targetPath]; break;
           case 'leerness_plan_remove':     cliArgs = ['plan', 'remove', String(args.target || ''), '--path', targetPath]; break;
           case 'leerness_memory_archive_list': cliArgs = ['memory', 'archive', 'list', '--path', targetPath, '--json', ...(args.surface ? ['--surface', args.surface] : [])]; break;
+          case 'leerness_memory_restore':  cliArgs = ['memory', 'restore', String(args.surface || ''), String(args.target || ''), '--path', targetPath]; break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -9151,6 +9255,11 @@ async function main() {
     const root = absRoot(arg('--path', args[3] && !args[3].startsWith('-') ? args[3] : process.cwd()));
     return memoryArchiveListCmd(root, { json: has('--json') });
   }
+  // 1.9.128: memory restore — archive 블록을 active 파일로 복귀 (DELETE→RESTORE cycle)
+  if (cmd === 'memory' && args[1] === 'restore') {
+    const root = absRoot(arg('--path', process.cwd()));
+    return memoryRestoreCmd(root, args[2], args[3]);
+  }
   // 1.9.112: lesson save — lessons.md에 새 lesson 추가
   // 1.9.117: lesson list — lessons.md 조회 + --tag 필터 + --json
   if (cmd === 'lesson') {

package/package.json

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