leerness 1.9.126 → 1.9.128

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 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).
+
+### Added — `leerness memory archive list` CLI
+- DELETE 5종 archive 파일 (`.harness/decisions.archive.md`, `lessons.archive.md`, `plan.archive.md`) 통합 조회
+- 각 archive entry 파싱: `{ date, target, originalHeader }`
+- `--surface decisions|lessons|plan` 필터 지원
+- `--json` 옵션 — totals + 각 surface 별 entries
+- archive 파일 없으면 안내 메시지
+
+### Added — MCP 39번째 도구 `leerness_memory_archive_list`
+- 외부 AI 가 과거에 제거된 항목 회수 — 복원 후보 참조 / 의사결정 변경 흐름 추적.
+- 인자: `{ surface?, path? }` (surface optional)
+
+### 사용 시나리오
+1. **복원 후보 회수**: "이전에 PostgreSQL 채택 결정 취소했었지? 어떤 게 있었나"
+   → 외부 AI: `leerness_memory_archive_list({ surface: "decisions" })` — 모든 제거된 결정 회수
+2. **의사결정 변경 패턴 분석**: 자주 변경되는 surface 의 빈도 추적
+3. **복구**: archive entry 참조 후 다시 `decision add` 로 재등록
+
+### MCP 도구 누계: 39 (1.9.126: 38 + leerness_memory_archive_list)
+
 ## 1.9.126 — 2026-05-20
 
 **`leerness plan remove <target>` CLI + MCP 38번째 도구 `leerness_plan_remove`** — milestone 블록 영구 제거 (archive 자동 보존). **Memory Surface DELETE 5종 완전 완성** 🎉

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.126-green)]() [![tests](https://img.shields.io/badge/e2e-219%2F219-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-38-blue)]() [![json](https://img.shields.io/badge/--json-18_commands-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-56-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.128-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-58-blueviolet)]() [![cycle](https://img.shields.io/badge/DELETE--RESTORE-complete-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,7 +12,7 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.126  AI Agent Reliability Harness                      ║
+  ║  v1.9.128  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.126';
+const VERSION = '1.9.128';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -113,7 +113,7 @@ function arg(name, def = null) { const i = process.argv.indexOf(name); return i
 function has(name) { return process.argv.includes(name); }
 function nonFlagArgs() {
   const out = [];
-  const withValue = new Set(['--language','--skills','--path','--status','--progress','--goal','--reason','--next','--target','--token-env','--package','--out','--from','--repo','--id','--note','--evidence','--query','--limit','--action','--agent','--tool','--doc','--command','--capability','--before','--after','--display','--threshold','--trigger','--check','--set','--min-score','--include','--days','--gh-pages-src','--roadmap','--since','--agents','--model','--timeout','--retry-on-fail','--label','--score','--tokens','--alternatives','--impact','--tag']);
+  const withValue = new Set(['--language','--skills','--path','--status','--progress','--goal','--reason','--next','--target','--token-env','--package','--out','--from','--repo','--id','--note','--evidence','--query','--limit','--action','--agent','--tool','--doc','--command','--capability','--before','--after','--display','--threshold','--trigger','--check','--set','--min-score','--include','--days','--gh-pages-src','--roadmap','--since','--agents','--model','--timeout','--retry-on-fail','--label','--score','--tokens','--alternatives','--impact','--tag','--surface']);
   const a = process.argv.slice(2);
   for (let i = 0; i < a.length; i++) {
     const x = a[i];
@@ -327,6 +327,8 @@ leerness audit . --fix               # 누락 메타 자동 보강
 - 1.9.124+ \`leerness lesson drop <target>\` + MCP **36 도구** (\`leerness_lesson_drop\`) — 잘못 저장한 lesson 제거 (archive 자동 보존).
 - 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 도구 마일스톤**.
 
 ---
 
@@ -1450,6 +1452,143 @@ function memoryStatusCmd(root, opts = {}) {
   log(`\n📊 Summary: ${payload.summary}`);
 }
 
+// 1.9.127: memory archive list — DELETE 5종 archive 파일 통합 조회
+//   .harness/decisions.archive.md / lessons.archive.md / plan.archive.md 의 "## 제거 YYYY-MM-DD" 블록 파싱
+//   --surface decisions|lessons|plan 필터, --json 옵션
+function _parseArchiveBlocks(text) {
+  // archive 형식: "## 제거 YYYY-MM-DD (target: \"...\")\n<원래 블록>"
+  // 첫 번째 "## 제거" 이전의 헤더(# Plan archive 등)는 skip
+  const entries = [];
+  if (!text) return entries;
+  const blocks = text.split(/\n(?=## 제거 )/);
+  for (const b of blocks) {
+    const m = b.match(/^## 제거 (\d{4}-\d{2}-\d{2})\s*\(target:\s*"([^"]*)"\)/);
+    if (!m) continue;
+    const date = m[1];
+    const target = m[2];
+    // 원래 헤더 추출 (### …)
+    const headerMatch = b.match(/^### (.+)$/m);
+    const originalHeader = headerMatch ? headerMatch[1].trim() : null;
+    entries.push({ date, target, originalHeader });
+  }
+  return entries;
+}
+function memoryArchiveListCmd(root, opts = {}) {
+  root = absRoot(root);
+  const jsonMode = !!opts.json || has('--json');
+  const surfaceFilter = arg('--surface', '');
+  const hd = path.join(root, '.harness');
+  const archives = {
+    decisions: { path: path.join(hd, 'decisions.archive.md'), entries: [] },
+    lessons:   { path: path.join(hd, 'lessons.archive.md'),   entries: [] },
+    plan:      { path: path.join(hd, 'plan.archive.md'),      entries: [] }
+  };
+  for (const k of Object.keys(archives)) {
+    if (surfaceFilter && surfaceFilter !== k) continue;
+    const a = archives[k];
+    if (exists(a.path)) a.entries = _parseArchiveBlocks(read(a.path));
+  }
+  const totals = {
+    decisions: archives.decisions.entries.length,
+    lessons:   archives.lessons.entries.length,
+    plan:      archives.plan.entries.length
+  };
+  totals.all = totals.decisions + totals.lessons + totals.plan;
+  if (jsonMode) {
+    const payload = {
+      version: VERSION, root,
+      decisions: archives.decisions.entries,
+      lessons:   archives.lessons.entries,
+      plan:      archives.plan.entries,
+      totals
+    };
+    process.stdout.write(JSON.stringify(payload, null, 2) + '\n');
+    return;
+  }
+  log('# 🗑 Memory Archive List (1.9.127)\n');
+  if (totals.all === 0) {
+    log('(archive 파일 없음 — 아직 제거된 항목 없음)');
+    return;
+  }
+  if ((!surfaceFilter || surfaceFilter === 'decisions') && archives.decisions.entries.length) {
+    log(`🧠 Decisions archive: ${archives.decisions.entries.length} entries`);
+    for (const e of archives.decisions.entries) {
+      log(`   - ${e.date} — target: "${e.target}"${e.originalHeader ? ' — ' + e.originalHeader : ''}`);
+    }
+  }
+  if ((!surfaceFilter || surfaceFilter === 'lessons') && archives.lessons.entries.length) {
+    log(`💡 Lessons archive: ${archives.lessons.entries.length} entries`);
+    for (const e of archives.lessons.entries) {
+      log(`   - ${e.date} — target: "${e.target}"${e.originalHeader ? ' — ' + e.originalHeader : ''}`);
+    }
+  }
+  if ((!surfaceFilter || surfaceFilter === 'plan') && archives.plan.entries.length) {
+    log(`🗺  Plan archive: ${archives.plan.entries.length} entries`);
+    for (const e of archives.plan.entries) {
+      log(`   - ${e.date} — target: "${e.target}"${e.originalHeader ? ' — ' + e.originalHeader : ''}`);
+    }
+  }
+  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);
@@ -4056,7 +4195,7 @@ function _banner(opts = {}) {
   lines.push('');
   for (const ln of lines) log(ln);
   if (opts.quickStart) {
-    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.126+ Memory Surface DELETE 5종 완성 — 56 라운드 자율 누적)')));
+    log(C.bold(C.cyan('  ✨ 빠른 시작 (1.9.128+ MCP 40 도구 🎉 DELETE→RESTORE cycle — 58 라운드 자율 누적)')));
     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) — 자동 회수 라인 비활성'));
@@ -4072,8 +4211,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 서버 — 38 도구 (plan_remove 추가, 1.9.126)'));
-    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 자동 회수와 통합'));
@@ -8255,7 +8395,9 @@ function mcpServeCmd(root) {
     { name: 'leerness_plan_list', description: '1.9.119 — plan.md 의 모든 milestone (M-XXXX) 조회 JSON ({ id, title, status, progress, tasks: [{ done, text }] }[]). 외부 AI가 영구화된 계획 + 진행률 + tasks checkbox 전체 회수', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { 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_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_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) {
@@ -8325,6 +8467,8 @@ function mcpServeCmd(root) {
           case 'leerness_lesson_drop':     cliArgs = ['lesson', 'drop', String(args.target || ''), '--path', targetPath]; break;
           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}` } });
         }
@@ -9063,6 +9207,16 @@ async function main() {
     const root = absRoot(arg('--path', args[2] && !args[2].startsWith('-') ? args[2] : process.cwd()));
     return memoryStatusCmd(root, { json: has('--json') });
   }
+  // 1.9.127: memory archive list — DELETE 5종 archive 통합 조회
+  if (cmd === 'memory' && args[1] === 'archive' && args[2] === 'list') {
+    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.126",
+  "version": "1.9.128",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",