leerness 1.9.91 → 1.9.126

package/CHANGELOG.md

@@ -1,5 +1,1116 @@
 # Changelog
 
+## 1.9.126 — 2026-05-20
+
+**`leerness plan remove <target>` CLI + MCP 38번째 도구 `leerness_plan_remove`** — milestone 블록 영구 제거 (archive 자동 보존). **Memory Surface DELETE 5종 완전 완성** 🎉
+
+### Added — `leerness plan remove <target>` CLI
+- target: M-XXXX 또는 title substring (예: `plan remove M-0003`, `plan remove "alpha"`)
+- 매칭된 milestone 블록 (`### M-XXXX. 제목 …`) 을 plan.md 에서 영구 제거
+- 제거된 블록은 `.harness/plan.archive.md` 에 자동 보존 (복구 가능)
+- **template 블록 자동 보호** (`### Template`, `### 템플릿` 등은 제거 대상에서 제외)
+- 매칭 없을 시 fail (`매칭 milestone 없음`)
+- 기존 `plan drop` (Out of Scope 표 추가, 소프트 폐기) 와는 별개. `plan remove` 는 하드 제거.
+
+### Added — MCP 38번째 도구 `leerness_plan_remove`
+- 외부 AI 가 잘못 저장한 milestone 제거.
+- 인자: `{ target (required), path? }`
+
+### 사용 시나리오
+사용자: "M-0007 마일스톤 잘못 등록했으니 제거해줘"
+→ 외부 AI: `leerness_plan_remove({ target: "M-0007" })` — plan.md 에서 제거, archive 보존
+
+### Memory Surface DELETE 5종 완전 완성 🎉
+| Surface | DELETE 명령 | 라운드 |
+|---|---|---|
+| tasks (progress-tracker.md) | `task drop` | 1.9.107 |
+| decisions.md | `decision drop` | 1.9.125 |
+| rules.md | `rule remove` | (기존) |
+| **plan.md** | **`plan remove`** | **1.9.126 ✓** |
+| lessons.md | `lesson drop` | 1.9.124 |
+
+전 Surface 가 CREATE/READ/DELETE 대칭 구조 완비.
+
+### MCP 도구 누계: 38 (1.9.125: 37 + leerness_plan_remove)
+
+## 1.9.125 — 2026-05-20
+
+**`leerness decision drop <target>` CLI + MCP 37번째 도구 `leerness_decision_drop`** — 잘못 저장한 결정 제거 (archive 자동 보존).
+
+### Added — `leerness decision drop <target>` CLI
+- target: date `YYYY-MM-DD` 또는 title substring
+- 매칭된 결정 블록을 decisions.md 에서 제거
+- 제거된 블록은 `.harness/decisions.archive.md` 에 자동 보존 (복구 가능)
+- **template 블록 자동 보호** (`### Template` 등은 제거 대상에서 제외)
+- 매칭 없을 시 fail
+
+### Added — MCP 37번째 도구 `leerness_decision_drop`
+- 외부 AI 가 잘못 저장한 결정 제거.
+- 인자: `{ target (required), path? }`
+
+### 사용 시나리오
+사용자: "어제 PostgreSQL 결정 취소하고 MySQL로 다시 검토하자"
+→ 외부 AI: 
+  1. `leerness_decision_drop({ target: "PostgreSQL" })` — 기존 제거 (archive 보존)
+  2. `leerness_decision_add({ title: "MySQL 채택", reason: "...", ... })` — 새 결정 등록
+
+### Memory CRUD 진화 (decisions)
+| Operation | 라운드 |
+|---|---|
+| CREATE (add) | 1.9.108 |
+| READ (list) | 1.9.118 |
+| **DELETE (drop)** | **1.9.125 ✓** |
+
+### Memory Surface Archive 패턴 (2종)
+- `lessons.archive.md` (1.9.124)
+- `decisions.archive.md` (1.9.125)
+
+### MCP 도구 수: 36 → 37개
+
+### Verified
+- stress-v70 — decision drop (date/title) + archive 보존 + template 보호 + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.124 — 2026-05-20
+
+**`leerness lesson drop <target>` CLI + MCP 36번째 도구 `leerness_lesson_drop`** — 잘못 저장한 lesson 제거 (archive 자동 보존).
+
+### Added — `leerness lesson drop <target>` CLI
+- 새 명령: `leerness lesson drop "2026-05-20"` (date 매칭) 또는 `leerness lesson drop "JWT"` (text substring 매칭)
+- 매칭된 lesson 블록을 lessons.md 에서 제거
+- 제거된 블록은 `.harness/lessons.archive.md` 에 자동 보존 (복구 가능)
+- 매칭 없을 시 `fail` (exit 1)
+
+### Added — MCP 36번째 도구 `leerness_lesson_drop`
+- 외부 AI 가 잘못 저장한 lesson 제거.
+- 인자: `{ target (required), path? }`
+- target은 date 또는 text substring 둘 다 매칭 (정확 date 우선)
+
+### 사용 시나리오
+사용자: "어제 잘못 저장한 lesson 지워줘. webhook 관련이었어"
+→ 외부 AI: `leerness_lesson_drop({ target: "webhook" })`
+→ "lesson dropped: 1건 (보존: .harness/lessons.archive.md)"
+
+### Memory CRUD 확장
+| 영역 | CREATE | READ | UPDATE | DELETE |
+|---|---|---|---|---|
+| Tasks | task_add | task_export | task_update | task_drop |
+| Decisions | decision_add | decision_list | — | — |
+| Rules | rule_add | rule_list | (status pause/resume) | rule_remove |
+| Plan | plan_add | plan_list | — | — |
+| **Lessons** | lesson_save | lesson_list | — | **lesson_drop ✓ (1.9.124)** |
+
+### MCP 도구 수: 35 → 36개
+
+### Verified
+- stress-v69 — lesson drop (date/text) + archive 보존 + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.123 — 2026-05-20
+
+**`leerness health --json` 응답에 `memorySurface` 필드 통합** — handoff (1.9.115) / session close (1.9.122) / memory status (1.9.114) 와 일관성 완성.
+
+### Added — `health --json` 새 필드 `memorySurface`
+```json
+{
+  "root": "...",
+  "generatedAt": "...",
+  "checks": { "drift": ..., "security": ..., "skills": ..., "usage": ..., "tasks": ... },
+  "issues": [...],
+  "healthy": true,
+  "memorySurface": {
+    "tasks": { "inProgress": 2, "total": 12, "byStatus": {...} },
+    "decisions": { "count": 4 },
+    "rules": { "active": 2, "total": 2 },
+    "plan": { "milestones": 3 },
+    "lessons": { "count": 7 },
+    "summary": "T2/D4/R2/P3/L7"
+  }
+}
+```
+
+### 1.9.123 — JSON 명령 4종 일관성
+| 명령 | memorySurface 필드 | 라운드 |
+|---|---|---|
+| `handoff --json` | ✓ | 1.9.115 |
+| `memory status --json` | ✓ (상세 + latest) | 1.9.114 |
+| `session close --json` | ✓ | 1.9.122 |
+| **`health --json`** | **✓** | **1.9.123 ✓** |
+
+이제 외부 AI 가 어떤 JSON 명령을 호출해도 동일한 `memorySurface` 구조로 5종 메모리 상태 회수.
+
+### Verified
+- stress-v68 — health --json memorySurface + summary 포맷 + 카운트 + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.122 — 2026-05-20
+
+**`session close --json` 응답에 `memorySurface` 필드 통합** — handoff --json (1.9.115) 패턴을 session close 에도 적용.
+
+### Added — `session close --json` 새 필드 `memorySurface`
+이미 1.9.103 에서 추가된 `session close --json` 응답 구조에 `memorySurface` 통합:
+```json
+{
+  "version": "1.9.122",
+  "closedAt": "...",
+  "sessionNumber": 62,
+  "taskCounts": { ... },
+  "rules": [...],
+  "skillCandidates": [...],
+  "drift": { ... },
+  "topCommands": [...],
+  "mcpStats": { ... },
+  "workspacePeers": 29,
+  "memorySurface": {
+    "tasks": { "inProgress": 2, "total": 12, "byStatus": {...} },
+    "decisions": { "count": 4 },
+    "rules": { "active": 2, "total": 2 },
+    "plan": { "milestones": 3 },
+    "lessons": { "count": 7 },
+    "summary": "T2/D4/R2/P3/L7"
+  }
+}
+```
+
+### 1.9.122 의 가치
+- 외부 AI (Claude Code / Hermes) 가 session 마감 시 단일 `session close --json` 호출로:
+  - 기존: 마감 통계 + drift + skill 후보
+  - **추가: 5종 메모리 영구화 상태 (Memory Write Surface 카운트)**
+- handoff (1.9.115) 와 session close (1.9.122) 모두 동일 `memorySurface` 패턴.
+- MCP `leerness_session_close` 응답도 자동 갱신.
+
+### Verified
+- stress-v67 — session close --json memorySurface 필드 + 카운트 정확성 + summary 포맷 + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.121 — 2026-05-20
+
+**handoff 6번째 자동 회수 라인 — `🆕 최근 24h 메모리 변동`** (5종 surface 24h 내 추가 항목 알림).
+
+### Added — handoff 자동 회수 6단째
+handoff 호출 시 다음 라인 자동 추가 (24h 내 메모리 surface 변경이 있을 때만):
+```
+🆕 최근 24h 메모리 변동 (1.9.121): decision +2 · lesson +1 · rule +1 · plan: 변경됨
+  → 상세: leerness memory status --json
+```
+
+### 조건
+다음 영역의 mtime 이 24h 내 또는 today() 날짜 항목이 있으면 표시:
+- **task** — progress-tracker.md `Updated:` 컬럼 24h 내 row 카운트
+- **decision** — decisions.md `### YYYY-MM-DD` 헤더 중 오늘 날짜
+- **lesson** — lessons.md `### YYYY-MM-DD` 헤더 중 오늘 날짜
+- **plan** — plan.md mtime 24h 내 (변경됨 표시)
+- **rule** — rules.md mtime 24h 내 + `added: today()` rule 카운트
+
+### 끄기
+- `--no-mem-delta`
+- `LEERNESS_NO_MEM_DELTA=1`
+- `--quiet` 또는 `--compact` 모드에서는 자동 비활성
+
+### 1.9.121 의 가치
+- AI 에이전트가 이전 세션 종료 후 어떤 메모리가 추가됐는지 **즉시 인지**.
+- 사용자 워크플로: "어제 등록한 결정과 통찰이 이번 세션 시작 시 보이게" → 자동 달성.
+- 1.9.113 (헤드라인 mem 카운트) 와 보완 — 카운트가 아니라 **delta** 표시.
+
+### handoff 자동 회수 6단 완성
+| # | 라인 | 라운드 |
+|---|---|---|
+| 1 | 🧠 lessons 자동 재상기 | 1.9.56/67 |
+| 2 | 🎯 매칭되는 skill 자동 추천 | 1.9.67 |
+| 3 | 📒 이전 skill match 이력 | 1.9.69 |
+| 4 | 🧩 brainstorm 자동 hits | 1.9.88 |
+| 5 | 📊 통합 헤드라인 (mem T/D/R/P/L) | 1.9.81/93/113 |
+| **6** | **🆕 최근 24h 메모리 변동** | **1.9.121 ✓** |
+
+### Verified
+- stress-v66 — handoff 6단 라인 + delta 카운트 정확성 + --no-mem-delta 비활성 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.120 — 2026-05-20 🏆 50 라운드 자율 모드 마일스톤
+
+**50 라운드 자율 모드 누적 마일스톤 보고서** (`_reports/AUTONOMOUS_ROUNDS_1.9.70-1.9.119.md`) + stress-v65 종합.
+
+### Internal — 비공개 종합 보고서
+- `_reports/AUTONOMOUS_ROUNDS_1.9.70-1.9.119.md` — **50 라운드** 종합 분석 (1.9.70 ~ 1.9.119)
+- MCP 도구 진화 (10 → 35, 25개 추가)
+- **Memory Surface 5종 R/W 완전 대칭** (WRITE 5종 + LIST READ 5종 = 10 surfaces)
+- JSON 옵션 18종 누적
+- 보안 4중 가드 + audit 11 kind
+- 디버그 기록 8건 (1차 실패 → PASS 회복)
+- 성능 측정 (11개 명령 median)
+- 사용자 명시 정책 7개 모두 ✓
+
+### 🏆 마일스톤 진화 요약
+- 1.9.89: 19 라운드 보고서
+- 1.9.97: 27 라운드 보고서
+- 1.9.100: 🏆 30 라운드 + 100번째 패치
+- 1.9.110: 🎉 MCP 30 도구 + Memory WRITE 5종
+- 1.9.111: 41 라운드 보고서
+- 1.9.119: 🎯 Memory READ 5종 완성
+- **1.9.120: 🏆 50 라운드 마일스톤**
+
+### Verified — stress-v65 종합 (1.9.70~119 핵심 기능 회귀)
+- Memory Surface 5종 R/W 모두 PASS
+- MCP 35 도구 노출 ✓
+- handoff 5단 자동 회수 + 헤드라인 ✓
+- 보안 4중 가드 ✓
+- e2e 219/219 PASS
+
+### Badge
+- README `autonomous-rounds-50` (blueviolet 강조)
+
+---
+
+## 1.9.119 — 2026-05-20 🎯 Memory Surface READ 5종 완전 완성
+
+**`leerness plan list [--json]` + MCP 35번째 도구 `leerness_plan_list`** — plan.md milestone 전체 조회 (Status/Progress/Tasks 체크박스 포함).
+
+### Added — `leerness plan list [--json]`
+- 새 CLI: `.harness/plan.md` 의 모든 milestone (M-XXXX) 조회.
+- 출력: `{ id, title, status, progress, tasks: [{ done, text }] }`
+- JSON: `{ version, root, total, milestones[] }`
+- Tasks 체크박스 (`- [ ]` / `- [x]`) 자동 파싱 → 완료/미완료 카운트.
+
+### Added — MCP 35번째 도구 `leerness_plan_list`
+- 외부 AI 가 영구화된 milestone + Tasks 진행 상태 회수.
+- 인자: `{ path? }`
+
+### 🎯 Memory Surface READ 5종 완전 완성
+| 영역 | READ 명령 | 라운드 |
+|---|---|---|
+| Tasks | task export | 1.9.60 |
+| Rules | rule list | 1.9.109 |
+| Lessons | lesson list | 1.9.117 |
+| Decisions | decision list | 1.9.118 |
+| **Plan** | **plan list** | **1.9.119 ✓** |
+
+Memory Surface 5종은 이제 WRITE (1.9.105~112) + LIST READ (1.9.60~119) 패턴 완전 대칭:
+
+| 영역 | WRITE | LIST READ |
+|---|---|---|
+| Tasks | task_add/update/drop (1.9.105~107) | task_export (1.9.60) |
+| Decisions | decision_add (1.9.108) | decision_list (1.9.118) |
+| Rules | rule_add (1.9.109) | rule_list (1.9.109) |
+| Plan | plan_add (1.9.110) | **plan_list (1.9.119)** |
+| Lessons | lesson_save (1.9.112) | lesson_list (1.9.117) |
+
+### MCP 도구 수: 34 → 35개
+### JSON 옵션 누적: 17 → 18종
+
+### Verified
+- stress-v64 — plan list CLI + --json + status/progress/tasks 파싱 + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.118 — 2026-05-20
+
+**`leerness decision list [--json]` 새 명령 + MCP 34번째 도구 `leerness_decision_list`** — decisions.md 전체 조회 + 메타데이터.
+
+### Added — `leerness decision list [--json]`
+- 새 CLI: `.harness/decisions.md` 의 모든 설계 결정 조회.
+- 출력: `{ date, title, decision, reason, alternatives, impact }`
+- JSON: `{ version, root, total, decisions[] }`
+- `_extractDecisionBlocks` 사용 → template/code 블록 자동 제외.
+
+### Added — MCP 34번째 도구 `leerness_decision_list`
+- 외부 AI 가 영구화된 설계 결정 + 메타데이터 (Reason/Alternatives/Impact) 전체 회수.
+- 인자: `{ path? }`
+
+### 사용 시나리오
+사용자: "지금까지 등록된 결정들 알려줘"
+→ 외부 AI: `leerness_decision_list({ path: "." })`
+→ `[{ date, title, reason, alternatives, impact }, ...]` 전체 조회
+
+### Memory Surface READ 확장 (4종 모두 list 명령 존재)
+| 영역 | READ 명령 | 라운드 |
+|---|---|---|
+| Tasks | task export | 1.9.60 |
+| Rules | rule list | 1.9.109 |
+| Lessons | lesson list | 1.9.117 |
+| **Decisions** | **decision list** | **1.9.118 ✓** |
+
+(Plan은 plan progress가 기존 존재 — milestone 진행률 보고)
+
+### MCP 도구 수: 33 → 34개
+### JSON 옵션 누적: 16 → 17종
+
+### Verified
+- stress-v63 — decision list CLI + --json + 메타데이터 + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.117 — 2026-05-20
+
+**`leerness lesson list [--tag] [--json]` 새 명령 + MCP 33번째 도구 `leerness_lesson_list`** — lessons.md 전용 조회 + tag 필터.
+
+### Added — `leerness lesson list [--tag <tag>] [--json]`
+- 새 CLI: `.harness/lessons.md` 의 모든 lesson 조회.
+- 옵션:
+  - `--tag <tag>` — 특정 태그 필터 (lesson save 시 `--tag` 로 저장된 값)
+  - `--json` — 구조화 출력
+- JSON 출력: `{ version, root, total, lessons: [{ date, text, tag }], tag? }`
+
+### Added — MCP 33번째 도구 `leerness_lesson_list`
+- 외부 AI 가 영구화된 lesson 전체 회수.
+- `leerness_lessons` 와 차이:
+  - `lessons`: review-evidence / decisions / task-log / lessons.md 다중 source fuzzy 매칭
+  - `lesson_list`: **lessons.md 전용** (사용자가 명시 save 한 lesson만) + tag 필터
+- 인자: `{ path?, tag? }`
+
+### 사용 시나리오
+사용자: "지금까지 등록된 auth 관련 lesson 알려줘"
+→ 외부 AI: `leerness_lesson_list({ tag: "auth" })`
+→ `{ total: 3, lessons: [{ date, text, tag: "auth" }, ...] }`
+
+### Memory Surface READ 확장
+| 영역 | READ | 라운드 |
+|---|---|---|
+| Tasks | task export | 1.9.60 |
+| Decisions | (lessons fuzzy + memory status 최근) | 기존 |
+| Rules | rule list | 1.9.109 |
+| Plan | (handoff 컨텍스트) | 기존 |
+| **Lessons** | **lesson list** | **1.9.117 ✓** |
+
+### MCP 도구 수: 32 → 33개
+### JSON 옵션 누적: 15 → 16종
+
+### Verified
+- stress-v62 — lesson list CLI + --tag 필터 + --json + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.116 — 2026-05-20
+
+**`leerness brainstorm` 회수 범위에 lessons.md + plan.md milestone 통합** — Memory Write Surface 5종 ↔ brainstorm 완전 통합.
+
+### Added — brainstorm 회수 범위 확장
+- 기존 hits 영역: decisions / skills / tasks / rules / evidence / skillHistory / taskLogFails
+- **추가 hits**: 
+  - `lessonsExplicit` — `.harness/lessons.md` (1.9.112 신규) 의 dated 블록 매칭
+  - `planMilestones` — `.harness/plan.md` 의 `M-XXXX` milestone 매칭
+
+### 변경 적용 위치
+- `_brainstormFor(root, topic)` — 1.9.77 MCP `leerness_brainstorm` + 1.9.88 handoff brainstorm hits 가 사용
+- `brainstormCmd(root, topic)` verbose 출력 — 사용자 직접 호출 시 발견 카운트에 포함
+
+### 1.9.116 의 가치
+- 1.9.112 에서 lessons.md 가 메모리 surface 5번째로 추가됐지만 brainstorm 매칭에는 미반영.
+- 이제 brainstorm 호출 시 lessons.md 의 통찰 + plan.md 의 milestone 도 함께 검색.
+- 외부 AI 가 "JWT" 주제로 brainstorm 호출 → JWT 관련 모든 메모리 surface (decision/lesson/plan/rule/skill/task/history/failure) 자동 회수.
+
+### Performance
+- 새 hits 영역 추가로 brainstorm 평균 5-10ms 증가 (lessons.md, plan.md 추가 read).
+- 캐시 미적용 (단순 텍스트 매칭) — 향후 캐싱 가능.
+
+### Verified
+- stress-v61 — brainstorm --json 에 lessonsExplicit/planMilestones 필드 존재 + 키워드 매칭 정확성 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.115 — 2026-05-20
+
+**`leerness handoff --json` 응답에 `memorySurface` 필드 통합** — 단일 호출로 컨텍스트 + 5종 메모리 상태 동시 회수.
+
+### Added — `handoff --json` 새 필드 `memorySurface`
+출력 구조에 다음 필드 추가:
+```json
+{
+  "date": "...",
+  "project": "...",
+  "version": "1.9.115",
+  "files": { ... },
+  "activeRules": [ ... ],
+  "memorySurface": {
+    "tasks": { "inProgress": 2, "total": 12, "byStatus": {...} },
+    "decisions": { "count": 4 },
+    "rules": { "active": 2, "total": 2 },
+    "plan": { "milestones": 3 },
+    "lessons": { "count": 7 },
+    "summary": "T2/D4/R2/P3/L7"
+  }
+}
+```
+
+### 1.9.115 의 가치
+- 외부 AI(Claude Code / Hermes)가 매 세션 시작 시 단일 `handoff --json` 호출만으로:
+  - 워크스페이스 컨텍스트 (plan / progress / decisions / handoff 등 파일)
+  - active rules
+  - **5종 메모리 영구화 상태 (Memory Write Surface)**
+  를 모두 한 번에 회수.
+- MCP `leerness_handoff` 응답도 자동 갱신 (기존 도구가 --json 사용).
+
+### 1.9.114 와 차이
+- 1.9.114: 별도 `memory status` 명령으로 상세 조회 + 최근 항목까지.
+- **1.9.115**: handoff 응답에 통합 — 별도 호출 없이 동시 수신 (latest 항목은 제외, 카운트만).
+
+### Verified
+- stress-v60 — handoff --json memorySurface 필드 + 카운트 정확성 + summary 포맷 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.114 — 2026-05-20
+
+**`leerness memory status` 새 명령 + MCP 32번째 도구 `leerness_memory_status`** — Memory Write Surface 5종 통합 상세 상태 조회.
+
+### Added — `leerness memory status [--json]`
+- 새 CLI 명령: Memory Write Surface 5종 통합 상태 조회.
+- Verbose 모드:
+  ```
+  # 🧠 Memory Surface Status (1.9.114)
+  📋 Tasks: 2 in-progress / 12 total
+     - 분포: in-progress=2, done=8, ...
+  🧠 Decisions: 4 entries
+     - 최근: 2026-05-20 — PostgreSQL 채택
+  ⚡ Rules: 2 active / 0 paused
+  🗺  Plan: 3 milestones (1 in-progress)
+  💡 Lessons: 7 entries
+     - 최근: webhook 재시도 시 idempotency key 필수
+
+  📊 Summary: T2/D4/R2/P3/L7
+  ```
+- JSON 모드: `{ version, root, tasks, decisions, rules, plan, lessons, summary }` 구조.
+- summary 필드는 handoff 헤드라인 (1.9.113) 과 동일 포맷 `T/D/R/P/L`.
+
+### Added — MCP 32번째 도구 `leerness_memory_status`
+- 외부 AI 가 한 호출로 5종 메모리 영구화 상태 + 카운트 + 최근 항목 회수.
+- 인자: `{ path? }`.
+- 1.9.113 헤드라인 mem 토큰의 상세 버전 — 외부 AI 가 카운트만 아닌 **최근 결정 / 최근 lesson 내용** 까지 직접 받음.
+
+### 사용 시나리오
+사용자: "지금까지 누적된 결정과 lesson 알려줘"
+→ 외부 AI: `leerness_memory_status({ path: "." })`
+→ 외부 AI 가 receivedJSON 으로 응답:
+> "Decisions 4건, 최근: PostgreSQL 채택. Lessons 7건, 최근: webhook 재시도 시 idempotency key 필수."
+
+### MCP 도구 수: 31 → 32개
+### JSON 옵션 누적: 14 → 15종
+
+### Verified
+- stress-v59 — memory status CLI + --json + MCP 응답 + 5종 카운트 정확성 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.113 — 2026-05-20
+
+**handoff 통합 헤드라인에 Memory Write Surface 5종 카운트 추가** — 사용자가 한눈에 5종 메모리 영구화 상태 확인.
+
+### Added — `📊 헤드라인` 의 새 토큰 `🧠 mem T/D/R/P/L`
+handoff 호출 시 통합 헤드라인 끝에 다음 토큰 추가:
+- **T** — tasks in-progress 카운트
+- **D** — decisions 누적 (decisions.md `### YYYY-MM-DD` 헤더 카운트)
+- **R** — rules active 카운트
+- **P** — plan milestones 누적 (`M-XXXX` 카운트)
+- **L** — lessons 누적 (lessons.md `### YYYY-MM-DD` 헤더 카운트)
+
+예: `📊 헤드라인 (1.9.81/93/113): drift healthy (0) · 🔒 보안 OK · 🔌 MCP 5회 · 📒 skill query 3회 · 📚 12 skills · ⚕ health: ✓ · 🧠 mem T2/D3/R1/P5/L7`
+
+### 1.9.113 의 가치
+- 외부 AI 가 매 handoff 호출 시 5종 메모리 surface 의 **영구화 상태**를 한 줄로 인지.
+- "지금까지 등록된 decisions / lessons / plan milestones 가 얼마나 있나?" 를 한눈에.
+- Memory Write Surface 5종 완성 (1.9.112) 의 자연스러운 가시화.
+
+### Performance
+- inline 계산 (자식 spawn 없음) — 헤드라인 latency 영향 무시 가능 (~ +5ms).
+
+### Verified
+- stress-v58 — handoff 헤드라인 mem 토큰 출현 + 5종 카운트 정확성 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.112 — 2026-05-20
+
+**`leerness lesson save` CLI + MCP 31번째 도구 `leerness_lesson_save`** — **Memory Write Surface 5종 완성** (lessons.md 전용 직접 write).
+
+### Added — `leerness lesson save "<text>"` CLI
+- 새 명령: `leerness lesson save "<text>" --tag "..."`
+- `.harness/lessons.md` 에 표준 형식으로 append:
+  ```md
+  ### YYYY-MM-DD
+  - Lesson: <text>
+  - Tag: <tag> (선택)
+  ```
+- lessons.md 가 없으면 자동 생성.
+
+### Added — MCP 31번째 도구 `leerness_lesson_save`
+- 외부 AI 가 세션 중 얻은 통찰을 즉시 영구 기록.
+- 인자: `{ text (required), tag?, path? }`
+- handoff 자동 lessons 회수와 통합 — 추후 동일 키워드 작업 시 자동 재상기.
+
+### Memory Write Surface 5종 완성
+| 영역 | WRITE 라운드 | MCP 도구 |
+|---|---|---|
+| Tasks (CRUD) | 1.9.105~107 | task_add/update/drop |
+| Decisions | 1.9.108 | decision_add |
+| Rules | 1.9.109 | rule_add/list |
+| Plan | 1.9.110 | plan_add |
+| **Lessons** | **1.9.112** | **lesson_save** |
+
+### Internal — `_loadLessonsIndex()` 확장
+- `lessons.md` 도 캐시 인덱스에 포함 → handoff 자동 회수 가 새 lessons 도 즉시 fuzzy 매칭.
+- mtime 기반 캐시 무효화 (다른 파일과 동일 패턴).
+
+### Fixed
+- `nonFlagArgs()` withValue Set 에 `--tag` 추가 — `lesson save` CLI 인자 정확히 파싱.
+
+### MCP 도구 수: 30 → 31개
+
+### Verified
+- stress-v57 — lesson save CLI + lessons.md 갱신 + MCP 31 도구 + handoff lessons 회수 통합 + Memory Write 5종 통합 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.111 — 2026-05-20
+
+**41 라운드 자율 모드 누적 보고서 마무리** (`_reports/AUTONOMOUS_ROUNDS_1.9.70-1.9.110.md`) + stress-v56 종합 회귀.
+
+### Internal — 비공개 종합 보고서
+- `_reports/AUTONOMOUS_ROUNDS_1.9.70-1.9.110.md` — 41 라운드 (1.9.70~1.9.110) 종합 분석
+- MCP 도구 진화 표 (10 → 30, 20개 추가)
+- Memory Write Surface 4종 완성 (tasks CRUD + decisions + rules + plan)
+- JSON 옵션 14종 누적
+- 보안 3중 가드 + audit 11 kind
+- 디버그 기록 7건
+- 성능 측정 (11개 명령 median)
+- 사용자 명시 정책 7개 모두 ✓
+
+### Verified — stress-v56 종합 (1.9.70~110 핵심 기능 회귀)
+- 마일스톤 (1.9.100/110) 핵심 시나리오 모두 PASS
+- Memory Write Surface 4종 통합 사이클 PASS
+- e2e 219/219 PASS
+
+### Badge
+- README 에 `autonomous-rounds-41` 배지 추가
+
+---
+
+## 1.9.110 — 2026-05-20 🎉 **MCP 30 도구 마일스톤**
+
+**MCP 30번째 도구 `leerness_plan_add`** (plan.md milestone + progress-tracker 자동 동기화).
+
+### Added — MCP 30번째 도구 `leerness_plan_add`
+- 외부 AI 가 plan.md 에 새 milestone (`M-XXXX`) 추가.
+- 자동으로 progress-tracker.md 에 동기화된 task (`T-XXXX`) 생성 + `evidence: plan:M-XXXX` 링크.
+- 인자: `{ text (required), status?, progress?, nextAction?, path? }`
+- 기본값: `status=planned`, `progress=0%`, `nextAction="다음 액션 작성"`
+
+### Memory Write Surface 확장 (4종)
+| 영역 | WRITE 라운드 | MCP 도구 |
+|---|---|---|
+| Tasks (CRUD) | 1.9.105~107 | task_add/update/drop |
+| Decisions | 1.9.108 | decision_add |
+| Rules | 1.9.109 | rule_add/list |
+| **Plan** | **1.9.110** | **plan_add** |
+
+### 🎉 MCP 30 도구 마일스톤 (1.9.43 → 1.9.110)
+- **1.9.43**: 10 도구 (기본 MCP 도입)
+- **1.9.94**: 21 도구 (skill_search/info, benchmark 추가)
+- **1.9.107**: 26 도구 (task CRUD 완성)
+- **1.9.110**: **30 도구 마일스톤** 🎉
+
+### Verified
+- stress-v55 — MCP plan_add + plan.md+progress-tracker 자동 동기화 + 30 도구 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.109 — 2026-05-20
+
+**MCP 28+29번째 도구 `leerness_rule_add` / `leerness_rule_list`** + `rule list --json` (자연어 영구 룰 R/W).
+
+### Added — `leerness rule list --json`
+- 출력: `{ version, root, total, rules[] }`
+- 각 rule: `{ id, trigger, rule, status, lastVerified }`
+- CI/외부 AI 통합 친화.
+
+### Added — MCP 28번째 도구 `leerness_rule_add`
+- 외부 AI 가 자연어 영구 룰 (1.9.8) 등록.
+- 인자: `{ description (required), trigger?, path? }`
+- trigger enum: `every-session` / `every-update` / `every-commit` / `session-start` / `session-close` / `pre-publish`
+- 등록된 룰은 매 handoff 자동 출력, session close 자동 검증.
+
+### Added — MCP 29번째 도구 `leerness_rule_list`
+- 외부 AI 가 현재 활성 룰 조회.
+- 사용 시나리오: 사용자가 "현재 활성 룰 알려줘" → 외부 AI 가 자동 회수.
+
+### Memory Write Surface 확장 (3종)
+| 영역 | WRITE 라운드 |
+|---|---|
+| Tasks (CRUD) | 1.9.105~107 |
+| Decisions | 1.9.108 |
+| **Rules** | **1.9.109** |
+
+### MCP 도구 수: 27 → 29개 (2개 추가)
+
+### Verified
+- stress-v54 — rule list --json + MCP rule_add/list + 29 도구 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.108 — 2026-05-20
+
+**`leerness decision add` 새 CLI + MCP 27번째 도구 `leerness_decision_add`** (설계 결정 영구화 — task 다음으로 메모리 write surface 확장 시작).
+
+### Added — `leerness decision add "<title>"` CLI
+- 새 명령: `leerness decision add "<title>" --reason "..." --alternatives "..." --impact "..."`
+- decisions.md 에 표준 형식으로 자동 append:
+  ```md
+  ### YYYY-MM-DD — 결정 제목
+  - Decision: 결정 제목
+  - Reason: ...
+  - Alternatives: ...
+  - Impact: ...
+  ```
+- decisions.md 가 없으면 자동 생성.
+- 1.9.43+ handoff lessons 자동 회수와 통합 — 추후 동일 키워드 작업 시 자동 재상기.
+
+### Added — MCP 27번째 도구 `leerness_decision_add`
+- 외부 AI(Claude Code / Hermes)가 설계 결정을 즉시 기록.
+- 인자: `{ title (required), reason?, alternatives?, impact?, path? }`
+- 사용 시나리오: 사용자와 토론 후 결정 사항을 외부 AI 가 자율 영구화.
+
+### Memory Write Surface 시작
+| 영역 | READ (기존) | WRITE (신규) |
+|---|---|---|
+| **Decisions** | lessons 자동 회수 (1.9.56+) | **`decision_add` (1.9.108)** |
+| **Tasks** | task_export (1.9.60) | task_add/update/drop (1.9.105~107) |
+
+다음 후보: lessons 직접 write, rules add, plan add 등.
+
+### MCP 도구 수: 26 → 27개
+
+### Verified
+- stress-v53 — decision add CLI + decisions.md 실제 갱신 + MCP 응답 + 27 도구 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.107 — 2026-05-20
+
+**MCP 26번째 도구 `leerness_task_drop` — task CRUD 완성** (read/add/update/drop 4종 surface).
+
+### Added — MCP 26번째 도구 `leerness_task_drop`
+- 외부 AI 가 task 를 `dropped` 상태로 폐기 (취소).
+- 인자:
+  - `id` (required) — 폐기할 task ID
+  - `reason` — 폐기 사유 (기본 `사용자 요청으로 제외`)
+  - `path` — 워크스페이스 경로
+
+### MCP task CRUD 완성 (4종 surface)
+| 라운드 | MCP 도구 | CRUD |
+|---|---|---|
+| 1.9.60 | `leerness_task_export` | **R**ead — task → TodoWrite JSON |
+| 1.9.105 | `leerness_task_add` | **C**reate — 새 task 등록 |
+| 1.9.106 | `leerness_task_update` | **U**pdate — 상태/evidence 갱신 |
+| **1.9.107** | **`leerness_task_drop`** | **D**rop — 폐기 |
+
+이제 외부 AI 가 task 전체 라이프사이클을 자율 관리 가능.
+
+### MCP 도구 수: 25 → 26개
+
+### Verified
+- stress-v52 — MCP task_drop + CRUD 사이클 + 26 도구 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.106 — 2026-05-20
+
+**MCP 25번째 도구 `leerness_task_update`** (read+add+update 3종 task 제어 surface 완성).
+
+### Added — MCP 25번째 도구 `leerness_task_update`
+- 외부 AI 가 기존 task 의 상태/evidence/nextAction 을 단계적으로 갱신.
+- 인자:
+  - `id` (required) — 갱신할 task ID (`T-XXXX`)
+  - `status` — 9 status enum
+  - `evidence` — evidence 라인 갱신
+  - `nextAction` — 다음 액션 갱신
+  - `note` — task request 텍스트 자체 변경
+  - `path` — 워크스페이스 경로
+
+### read+add+update 3종 task 제어 surface 완성
+| 라운드 | MCP 도구 | 작업 |
+|---|---|---|
+| 1.9.60 | `leerness_task_export` | READ — task → TodoWrite JSON |
+| 1.9.105 | `leerness_task_add` | ADD — 새 task 등록 |
+| **1.9.106** | **`leerness_task_update`** | **UPDATE — 상태/evidence 갱신** |
+
+외부 AI 가 작업 진행에 따라 task 를 add → update(in-progress) → update(done) 사이클로 자율 관리.
+
+### MCP 도구 수: 24 → 25개
+
+### Verified
+- stress-v51 — MCP task_update + add→update 사이클 + 25 도구 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.105 — 2026-05-20
+
+**MCP 24번째 도구 `leerness_task_add`** (외부 AI 가 task 즉시 등록 — 양방향 제어 완성).
+
+### Added — MCP 24번째 도구 `leerness_task_add`
+- 외부 AI(Claude Code / Hermes)가 progress-tracker.md 에 새 task 즉시 등록.
+- 인자:
+  - `text` (required) — task 설명
+  - `status` — 9 status enum (requested/planned/in-progress/waiting/on-hold/blocked/incomplete/done/dropped). 기본 `requested`
+  - `evidence` — evidence 라인 (기본 `user-request`)
+  - `nextAction` — 다음 액션 (기본 `다음 액션 작성`)
+  - `path` — 워크스페이스 경로 (기본 현재)
+- 응답: 새 task ID (`T-XXXX`) + 성공 메시지
+- 사용 시나리오: 사용자가 자연어로 "X 작업 추가해줘" → 외부 AI 가 즉시 `leerness_task_add` 호출.
+
+### 양방향 제어 완성
+- 1.9.60: `leerness_task_export` — task → TodoWrite (READ)
+- **1.9.105: `leerness_task_add` — TodoWrite → task (WRITE)**
+- 외부 AI 가 task 목록을 read + add 양방향 sync.
+
+### MCP 도구 수: 23 → 24개
+1~10 (기존) + skill_suggest / lessons / task_export / env_check / brainstorm / skill_match / skill_list / health / skill_search / skill_info / benchmark / lazy_detect / retro / **task_add** (1.9.105 신규)
+
+### Verified
+- stress-v50 — MCP task_add 응답 + progress-tracker.md 실제 갱신 + 24 도구 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.104 — 2026-05-20
+
+**MCP 23번째 도구 `leerness_retro`** (4세션 누적 회고 외부 AI 노출).
+
+### Added — MCP 23번째 도구 `leerness_retro`
+- 4세션 누적 회고 보고서 JSON 외부 AI 노출.
+- 인자: `{ path?, days?, allApps? }`
+- 출력 데이터: `statusCounts` / `focusNext` / `skillUsage` / `recentDecisions` / `durations` / `activeRules` / `verifiedRules` / `fixSignals` / `passSignals` / `totalOptimizations`
+- `retro` CLI 명령은 1.9.16부터 `--json` 지원했으나, MCP 노출은 1.9.104에서 추가.
+- 사용 시나리오: 외부 AI가 누적 패턴 학습 / 다음 라운드 우선순위 결정 / 디버그 비중 분석.
+
+### MCP 도구 수: 22 → 23개
+1~10 (기존) + skill_suggest / lessons / task_export / env_check / brainstorm / skill_match / skill_list / health / skill_search / skill_info / benchmark / lazy_detect / **retro** (1.9.104 신규)
+
+### Verified
+- stress-v49 — MCP retro 응답 + 23 도구 노출 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.103 — 2026-05-20
+
+**`leerness session close --json`** (세션 마감 통계 JSON + MCP `leerness_session_close` JSON 자동).
+
+### Added — `leerness session close [path] --json`
+- 출력: `{ version, root, closedAt, sessionNumber, taskCounts, recommendedDirection, nextExactStep, rules[], skillCandidates[], drift, topCommands[], mcpStats, workspacePeers, retroSummaryError? }`
+- `taskCounts`: 9개 status (requested/planned/in-progress/waiting/on-hold/blocked/incomplete/done/dropped) 카운트
+- `rules`: 활성 룰 검증 결과 (id/trigger/verified/note)
+- `skillCandidates`: Hermes-style 자동 학습 (top 5)
+- `drift`: { level, score, fired[] }
+- `topCommands`: 가장 많이 쓴 명령 top 3
+- `mcpStats`: { total, top[], rare[] }
+- `workspacePeers`: 다른 leerness 프로젝트 개수
+- stdout 억제 후 JSON만 (CI/외부 AI 통합 친화)
+
+### Changed — MCP `leerness_session_close`
+- 기본 응답을 **JSON** 으로 변경 (--json 자동 전달).
+- 외부 AI(Claude Code / Hermes)가 마감 시 통계를 파싱 친화적으로 회수.
+
+### JSON 옵션 누적 13종
+`skill list/info/search` · `health` · `lessons` · `handoff` · `env check` · `benchmark` · `drift check` · `lazy detect` · `usage stats` · `audit` · **`session close`** (신규)
+
+### Verified
+- stress-v48 — session close --json 구조 + MCP + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.102 — 2026-05-20
+
+**`leerness audit --json` 구조화 출력** (findings 11종 kind + MCP `leerness_audit` JSON 응답).
+
+### Added — `leerness audit [path] --json`
+- 출력: `{ version, root, warnings, failures, fixed, healthy, fixApplied, strict, strictThreshold, summary, findings[] }`
+- 각 finding: `{ kind, severity, message, ...details }`
+- **finding.kind 11종**:
+  - `design_dup` — design guide 중복 파일 (`docs/designguide.md` 등)
+  - `design_system_default` — design-system.md tokens not customized
+  - `reuse_map_empty` — reuse-map.md 비어있음
+  - `milestone_unlinked` — milestone progress-tracker 미연결
+  - `handoff_not_generated` — session-handoff.md never auto-generated
+  - `current_state_stale` — current-state.md 7일 이상 stale
+  - `readme_version_mismatch` — README 배지 ↔ package.json 불일치
+  - `npm_cve` — npm audit 발견 CVE
+  - `npm_cve_critical` — critical/high CVE 즉시 대응 권장
+  - `gitignore_missing_secrets` — .gitignore에 시크릿 패턴 누락
+  - `env_keys_missing` — .env 키가 .env.example에 누락
+  - `strict_promoted` — --strict로 warnings → failures 승격
+- exit 1 if `failures > 0` (warnings 만으로는 healthy=true 유지)
+- 기존 verbose 출력은 stdout 억제 후 JSON만 출력 (CI 친화)
+
+### Changed — MCP `leerness_audit`
+- 기본 응답을 JSON 으로 변경 (--json 자동 전달).
+- `args.strict: true` 옵션 추가 → `--strict` 전달.
+- 외부 AI(Claude Code / Hermes)가 audit 결과를 파싱 친화적으로 받음.
+
+### JSON 옵션 통합 11종 (1.9.102 까지)
+| 명령 | 라운드 | 핵심 |
+|---|---|---|
+| `skill list --json` | 1.9.84 | items[] |
+| `health --json` | 1.9.85 | checks/issues/healthy |
+| `skill search --json` | 1.9.90 | matches[] |
+| `skill info --json` | 1.9.92 | 개별 skill |
+| `lessons --json` | 1.9.95 | lessons[] |
+| `handoff --json` | 1.9.96 | files{...}/activeRules |
+| `env check --json` | 1.9.71 | inEnvOnly/inExampleOnly |
+| `benchmark --json` | 1.9.46 | 6 차원 점수 |
+| `drift check --json` | (기존) | score/level/fired[] |
+| `lazy detect --json` | 1.9.101 | findings[] 7 kind |
+| `audit --json` | **1.9.102** | **findings[] 11 kind** |
+
+### Verified
+- stress-v47 — audit --json 구조 + 11 kind 검출 + MCP audit + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.101 — 2026-05-20
+
+**`leerness lazy detect --json` + MCP 22번째 도구 `leerness_lazy_detect`** (외부 AI에 거짓 완료/empty handoff/no test run/TODO 미추적 신호 노출).
+
+### Added — `leerness lazy detect [path] --json`
+- 기존 `lazy detect` 명령에 `--json` 옵션 추가.
+- 출력: `{ version, root, issues, healthy, todoCount, newTodoCount, findings[] }`
+- 각 finding: `{ kind, severity, ...details }`
+  - `kind` 종류: `evidence_missing` / `progress_empty` / `handoff_never_generated` / `handoff_empty` / `no_test_run` / `todo_untracked` / `blocker_no_next_action`
+- exit 1 if `issues > 0` (CI 통합 친화적)
+
+### Added — MCP 22번째 도구 `leerness_lazy_detect`
+- 외부 AI가 워크스페이스의 거짓 완료/lazy 신호를 JSON으로 사전 점검.
+- 사용 시나리오: 세션 마감 전 자동 검사, CI 게이트, AI 에이전트의 "정말 끝났는지" self-check.
+- MCP 도구 수: **21 → 22개**.
+
+### Verified
+- stress-v46 — lazy detect --json 구조 + 7종 kind 검출 + MCP 22 도구 + 누적 회귀.
+- e2e 219/219 PASS.
+
+---
+
+## 1.9.100 — 2026-05-20 🏆 마일스톤 (30 라운드 자율 누적 + 100번째 패치)
+
+**1.9.70 ~ 1.9.99 자율 모드 30 라운드 누적 마일스톤** (stress-v45 30/30 PASS · e2e 219/219 PASS).
+
+### Milestone Summary
+- **버전 진화**: 1.9.70 → 1.9.100 (30 라운드, 모두 stress + e2e + GitHub release)
+- **MCP 도구**: 12 → **21개** (env_check / brainstorm / skill_match / skill_list / health / skill_search / skill_info / benchmark 추가)
+- **handoff 자동 회수 5단**: lessons + skill 추천 + history hit + brainstorm hits + 헤드라인
+- **3중 보안 가드**: drift 5번째 신호 (1.9.78) + handoff 요약 (1.9.76) + CRITICAL 자동 회복 (1.9.80)
+- **JSON 옵션 10종**: handoff, lessons, skill list/info/search, health, env check, benchmark, drift check, usage stats
+- **새 명령 3종**: `env check/sync` (1.9.71) · `health` (1.9.85) · `skill search` (1.9.90)
+- **handoff --quiet** (1.9.99) — 자동화/CI 비대화 모드
+
+### Verified — stress-v45 종합 검증 (1.9.70~99 30 라운드)
+- **총 30 / PASS 30 / FAIL 0 · 34015ms** (100% 통과)
+- R70~R99 핵심 기능 시나리오 28개 + MCP 21 도구 + 5종 시크릿 패턴 안전 검증
+- e2e 219/219 PASS 매 라운드 유지
+- 누적 회귀 0건, 신규 회귀 없음
+
+### Internal — 비공개 종합 보고서
+- `_reports/AUTONOMOUS_ROUNDS_1.9.70-1.9.99.md` — 30 라운드 자율 모드 누적 + 마일스톤 마무리
+
+### Stats (30 라운드 누적)
+- stress 시나리오 ~440개 모두 PASS
+- 디버그 기록 6건 (1차 실패 → 진단 → 수정 → PASS)
+- GitHub release/tag 30개 (v1.9.70 ~ v1.9.99 + v1.9.100)
+- 사용자 명시 정책 7개 모두 ✓
+
+### 사용자 명시 정책 준수 (verbatim)
+- ✓ 매 라운드 stress test 필수 검수
+- ✓ 이전 중요 기능 정상 작동 검증 (누적 회귀)
+- ✓ 성능 테스트 병행 (handoff median ~700ms 유지)
+- ✓ GitHub 배포 (https://github.com/gugu9999gu/leerness)
+- ✓ `_reports/` 비공개 (`.gitignore` + `.npmignore`)
+- ✓ 설치 가이드 매 라운드 동기화 (`_banner` quickStart + `session-workflow.md`)
+- ✓ 보안: `.env` 실제 값 절대 미노출, 시크릿 하드코딩 차단
+
+---
+
+## 1.9.99 — 2026-05-20
+
+**`leerness handoff --quiet` 옵션** (자동화/CI 모드용 최소 출력).
+
+### Added
+- `leerness handoff --quiet` — 자동 회수 라인 모두 비활성화:
+  - 헤드라인 (1.9.81/93)
+  - lessons 자동 재상기 (1.9.56)
+  - 매칭 skill 자동 추천 (1.9.67)
+  - skill match 이력 (1.9.69)
+  - brainstorm 자동 hits (1.9.88)
+  - 보안 요약 (1.9.76) / CRITICAL (1.9.80)
+- 기본 컨텍스트 (Session Handoff, Plan, Progress Tracker, Decisions, Task Log)만 출력.
+- CI 통합 / 자동 처리 / 비대화형 환경에 적합.
+
+### Verified
+- stress-v44 — quiet 모드 출력 + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 1.9.98 — 2026-05-20
+
+**`leerness skill publish` 보안 사전 점검 통합** (사용자 글로벌 룰 보안 정책 자동화).
+
+### Added — publish 보안 사전 점검
+- `leerness skill publish` 명령 실행 전 `leerness health` 자동 호출.
+- `issues.length > 0` 시 publish 중단 + exit 1:
+  - 🚨 보안 사전 점검 (1.9.98): N건 issue 발견
+  - 권장: `leerness audit --fix`
+  - 우회: `--force` 또는 `--no-security-check`
+- 통과 시: `✓ 보안 사전 점검 (1.9.98): 통과` 후 정상 publish
+
+### Use Case
+- 사용자가 `.env` 가 `.gitignore` 에 없는 상태에서 skill publish 시도 → 자동 차단.
+- 시크릿 노출 사고 사전 방지.
+- CI 통합 시 더욱 안전.
+
+### Verified
+- stress-v43 — publish 보안 사전 점검 + --force 우회 + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 1.9.97 — 2026-05-20
+
+**자율 모드 27 라운드 종합 보고서 갱신 + 마무리** (1.9.70 ~ 1.9.96).
+
+### Internal — 비공개 종합 보고서
+- `_reports/AUTONOMOUS_ROUNDS_1.9.70-1.9.96.md` 갱신 (이전 1.9.89 보고서 확장)
+- 27 라운드 전체 요약 + 그룹화 (보안 / MCP 21개 / handoff 5단 / JSON 옵션 9종)
+- 성능 측정 (handoff 700ms · health 720ms · audit 350ms · drift 400ms)
+- 디버그 기록 6건
+- 사용자 명시 정책 7개 모두 ✓
+
+### Stats
+- 자율 모드 27 라운드 (1.9.70 ~ 1.9.96)
+- MCP 도구: 12 → 21개
+- 새 명령: env check/sync, health, skill search
+- JSON 옵션: 9종 (handoff, lessons, skill list/info/search, health, env check, benchmark, drift check)
+
+### Verified
+- e2e 219/219 매 라운드 PASS 유지
+
+---
+
+## 1.9.96 — 2026-05-20
+
+**`leerness handoff --json` 옵션 추가** (외부 AI / MCP 통합용).
+
+### Added
+- `leerness handoff --json` — 구조화된 JSON 출력
+  - `{ date, project, version, files: { sessionHandoff, currentState, plan, progressTracker, decisions, taskLog }, activeRules?: [...] }`
+  - 각 file: `{ path, content }` (8000자 초과 시 truncated)
+- 자동 회수 라인 (lessons / skill 추천 / history / brainstorm / 헤드라인)은 일반 모드에서만.
+- 외부 AI(Claude Code, Cursor)가 handoff 데이터를 파싱 친화적으로 받음.
+
+### Verified
+- stress-v42 — handoff --json + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 1.9.95 — 2026-05-20
+
+**`leerness lessons --json` 옵션 + MCP leerness_lessons 자동 JSON 응답**.
+
+### Added
+- `leerness lessons --json` 옵션:
+  - `{ query, total, lessons[]: { source, title, preview, truncated } }`
+- MCP `leerness_lessons` 도구가 자동으로 `--json` 적용 → 구조화 응답.
+- 외부 AI(Claude Code, Cursor)가 lessons 결과를 파싱 친화적으로 받음.
+
+### Verified
+- stress-v41 — lessons --json + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 1.9.94 — 2026-05-20
+
+**MCP server 21번째 도구 `leerness_benchmark`** (1.9.46/51 benchmark 외부 노출).
+
+### Added — MCP 21번째 도구
+- `leerness_benchmark` — 1.9.46 6 차원 점수 + 1.9.51 검수 시나리오 결과를 외부 AI에 노출.
+  - inputSchema: `{ path: string, scenario: string (optional) }`
+  - 응답: benchmark --json 결과
+    - `scenario` 없으면: `{ project, measured, leernessScore, total, compareSimulated }`
+    - `scenario: 'all'` 등: `{ scenarios: [...], detectedCount, total }`
+- benchmark --json 옵션은 이미 존재 (1.9.46/51) — MCP 노출만 추가.
+- MCP server 도구 카운트: **20 → 21**.
+
+### Verified
+- stress-v40 — MCP 21 도구 + benchmark 호출 + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 1.9.93 — 2026-05-20
+
+**handoff 헤드라인에 health 종합 상태 1 토큰 추가** (1.9.81 + 1.9.85 통합).
+
+### Improved — 헤드라인 health 토큰
+- 1.9.81 통합 헤드라인 끝에 `⚕ health: ✓` 또는 `⚕ health: ⚠` 1 토큰 추가.
+- inline 추론 (자식 spawn 없음, 성능 비용 최소):
+  - `.env` 가 `.gitignore` 에 포함되면 ✓
+  - 누락이면 ⚠
+- 헤드라인 라벨도 `(1.9.81/93)` 으로 갱신.
+- 예:
+  ```
+  📊 헤드라인 (1.9.81/93): drift healthy (0) · 📚 9 skills · ⚕ health: ✓
+  📊 헤드라인 (1.9.81/93): drift attention (45) · 🚨 보안 위험 · 📚 9 skills · ⚕ health: ⚠
+  ```
+
+### Use Case
+- AI 에이전트가 handoff 1줄로 워크스페이스 헬스 즉시 인지 (별도 `leerness health` 호출 불필요).
+
+### Verified
+- stress-v39 — health 토큰 노출 + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
+## 1.9.92 — 2026-05-20
+
+**`skill info --json` + MCP 20번째 도구 `leerness_skill_info`**.
+
+### Added
+- `leerness skill info <id> --json` 옵션 신규 추가 (CI 친화 + MCP 통합 기반).
+  - 출력 필드: id / displayNameKo / source / version / lastUpdated / verification / usage / capabilities / sources / patterns / optimizations
+- **MCP 20번째 도구** `leerness_skill_info`:
+  - inputSchema: `{ id: string (required), path: string }`
+  - 외부 AI가 개별 skill의 능력/사용 이력/패턴 정확 파악.
+- MCP server 도구 카운트: **19 → 20**.
+
+### Verified
+- stress-v38 — skill info --json + MCP 20 도구 + 누적 회귀.
+- e2e 219/219 PASS 유지.
+
+---
+
 ## 1.9.91 — 2026-05-20
 
 **MCP server 19번째 도구 `leerness_skill_search`** (1.9.90 외부 AI 노출).