leerness 1.9.215 → 1.9.217

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # Changelog
 
+## 1.9.217 — 2026-05-22
+
+**🔚 session close 자동 통합 — 1.9.207/209/212 자동 호출.**
+
+### 1. session close 자동 호출 3종 (마감 시)
+| 영역 | 출처 | 동작 |
+|---|---|---|
+| `userRequestsAudit` | 1.9.207 | open/in-progress 요청 → missing/tracked/stale 분류 |
+| `preWakeAudit` | 1.9.209 | sleep 전 6 영역 audit + .harness/pre-wake-report.json 자동 저장 |
+| `idempotencyAudit` | 1.9.212 | 4영역 멱등성 검사 (rule/task/user-requests/wakeups) |
+
+### 2. JSON 모드 (`--json`) 통합 필드 추가
+- `userRequestsAudit: { total, open, missing, tracked, stale }`
+- `preWakeAudit: { auditedAt, critical, warning, info, needsAttention }`
+- `idempotencyAudit: { violations, high, medium, low, verified, overall }`
+
+### 3. human 출력 자동 섹션
+```
+## 🔚 session close 자동 통합 보고 (1.9.217)
+  ⚠ 미답 사용자 요청 N건 (task-log/plan/decisions 매칭 안 됨)
+  🚨 pre-wake-audit: critical N (다음 깨어남 시 점검 필요)
+  ✓ 멱등성 검사 통과 — verified 4 영역
+```
+
+### 4. opt-out 옵션
+- `--no-pre-wake` — pre-wake audit 스킵
+- 옵션 외 다른 통합은 항상 실행 (가벼움)
+
+### 5. 누적 회귀 (1.9.207~216) — 모두 유지
+
+### 6. stress-v162 — 18/18 PASS
+- 1.9.217 (7): VERSION + JSON 필드 + human 섹션 + 자동 저장 + opt-out + 필드 구조 + clean
+- 성능 (2): cold_start 489ms / MCP 59 도구 785ms
+- 누적 회귀 (9)
+
+### 7. 자동 release (79 라운드 main-push streak · 40 라운드 npm publish streak)
+
+🎉 **session close 강화** — 매 마감 시 운영 안전 자동 점검
+
+---
+
+## 1.9.216 — 2026-05-22
+
+**🔌 MCP 5종 추가 — 1.9.207~213 외부 AI 노출 (54 → 59 도구).**
+
+> 백로그 소진 후 외부 AI 통합 가치 강화 — Claude/Codex/Gemini 등이 신규 7 라운드 기능을 직접 호출 가능
+
+### 1. MCP 신규 5종 (1.9.216 라벨)
+| 도구 | 출처 | 인자 |
+|---|---|---|
+| `leerness_requests_audit` | 1.9.207 | `{ path? }` → missing/tracked/stale 회수 |
+| `leerness_constraints_check` | 1.9.208 | `{ request, path? }` → 플랫폼 alias 매칭 |
+| `leerness_pre_wake_audit` | 1.9.209 | `{ path? }` → 6영역 audit |
+| `leerness_intent_classify` | 1.9.213 | `{ request, path? }` → intent + 도메인 + dry-run 확장 |
+| `leerness_idempotency_audit` | 1.9.212 | `{ path? }` → 4영역 멱등성 검사 |
+
+### 2. 5축 매트릭스 B축 (멀티 Sub-Agent) 가치 강화
+- 외부 AI 가 leerness 의 7 라운드 신규 기능을 MCP 로 직접 호출
+- Claude Desktop / Cursor / Codex CLI 등에서 leerness MCP server 등록 → 즉시 사용 가능
+- "사용자가 했던 요청 중 누락된 게 있나?" "이 기능 구현 전 어떤 API 규정?" "이 요청은 정확히 그것만 / 포괄적?" 등을 외부 AI가 회수
+
+### 3. 누적 회귀 (1.9.207~215) — 모두 유지
+
+### 4. stress-v161 — 19/19 PASS
+- 1.9.216 (8): VERSION + tools/list 59개 + 5종 등록 + 4종 실 호출 검증
+- leerness_intent_classify("맵+캐릭터+게임 기능") → broad/game/8 candidates ✓
+- leerness_constraints_check("Stripe API") → stripe matched ✓
+- leerness_pre_wake_audit → audited 0 ✓
+- leerness_idempotency_audit → clean ✓
+- leerness_requests_audit → total=0 ✓
+- 성능 (2): cold_start 544ms / MCP 59도구 541ms
+- 누적 회귀 (9): 1.9.207~215
+
+### 5. 자동 release (78 라운드 main-push streak · 39 라운드 npm publish streak)
+
+🎉 **MCP 58 도구 마일스톤** (이전 53 → 59, +6 in 1.9.158/159/168/216)
+
+---
+
 ## 1.9.215 — 2026-05-22
 
 **🎯 handoff 헤드라인에 constraints/intent 자동 통합 + AGENTS.md 7 라운드 누적.**

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.215-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v160-17%2F17-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-145-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-77_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![handoff-auto](https://img.shields.io/badge/handoff_헤드라인-15요소-success)]() [![perf](https://img.shields.io/badge/cold_start-677ms-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.217-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v162-18%2F18-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-59-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-147-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-79_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![session-close](https://img.shields.io/badge/session_close-자동_통합_3종-success)]() [![perf](https://img.shields.io/badge/cold_start-489ms-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.215  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.217  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🎯 handoff 헤드라인 constraints/intent 자동 통합 (15요소)         ║
+  ║  🔚 session close 자동 통합 (requests/pre-wake/idempotency)     ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.215';
+const VERSION = '1.9.217';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -9465,7 +9465,98 @@ function sessionClose(root, opts = {}) {
         };
       } catch {}
     } catch {}
+
+    // 1.9.217: session close 자동 통합 — 1.9.207 + 1.9.209 + 1.9.212
+    //   마감 시 미답 요청 / pre-wake audit / 멱등성 검사 자동 실행 + JSON 통합
+    try {
+      // 1.9.207: 미답 사용자 요청 audit
+      const reqAudit = _auditUserRequests(root);
+      jsonResult.userRequestsAudit = {
+        total: reqAudit.total,
+        open: reqAudit.open,
+        missing: reqAudit.missing ? reqAudit.missing.length : 0,
+        tracked: reqAudit.tracked ? reqAudit.tracked.length : 0,
+        stale: reqAudit.stale ? reqAudit.stale.length : 0
+      };
+    } catch {}
+    try {
+      // 1.9.209: pre-wake-audit 자동 실행 + 저장 (sleep 전 자동 점검)
+      if (!opts.noPreWake && !has('--no-pre-wake')) {
+        const audit = _runPreWakeAudit(root);
+        _saveAndAppendPreWakeReport(root, audit);
+        jsonResult.preWakeAudit = {
+          auditedAt: audit.auditedAt,
+          critical: audit.summary.criticalCount,
+          warning: audit.summary.warningCount,
+          info: audit.summary.infoCount,
+          needsAttention: audit.summary.needsAttention
+        };
+      }
+    } catch {}
+    try {
+      // 1.9.212: 멱등성 검사 자동 실행 (rule/task/user-requests/wakeups 4영역)
+      const idemp = _runIdempotencyAudit(root);
+      jsonResult.idempotencyAudit = {
+        violations: idemp.summary.totalViolations,
+        high: idemp.summary.highSeverity,
+        medium: idemp.summary.mediumSeverity,
+        low: idemp.summary.lowSeverity,
+        verified: idemp.summary.verifiedAreas,
+        overall: idemp.summary.overall
+      };
+    } catch {}
+
     process.stdout.write(JSON.stringify(jsonResult, null, 2) + '\n');
+  } else {
+    // 1.9.217: human 출력 모드에서도 통합 보고 노출 (마감 직전)
+    try {
+      const isTty = process.stdout.isTTY;
+      const grn = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+      const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+      const red = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
+      const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+
+      log('');
+      log(`## 🔚 session close 자동 통합 보고 (1.9.217)`);
+      // 1.9.207
+      try {
+        const reqAudit = _auditUserRequests(root);
+        const missCnt = reqAudit.missing ? reqAudit.missing.length : 0;
+        if (missCnt > 0) {
+          log(red(`  ⚠ 미답 사용자 요청 ${missCnt}건 (task-log/plan/decisions 매칭 안 됨)`));
+        } else if (reqAudit.open > 0) {
+          log(grn(`  ✓ 사용자 요청 ${reqAudit.open}건 모두 tracked`));
+        } else {
+          log(dim(`  ℹ 사용자 요청 없음 (UR 백로그 비어있음)`));
+        }
+      } catch {}
+      // 1.9.209
+      try {
+        if (!opts.noPreWake && !has('--no-pre-wake')) {
+          const audit = _runPreWakeAudit(root);
+          _saveAndAppendPreWakeReport(root, audit);
+          const sum = audit.summary;
+          if (sum.criticalCount > 0) {
+            log(red(`  🚨 pre-wake-audit: critical ${sum.criticalCount} (다음 깨어남 시 점검 필요)`));
+          } else if (sum.warningCount > 0) {
+            log(yel(`  ⚠ pre-wake-audit: warning ${sum.warningCount}`));
+          } else {
+            log(grn(`  ✓ pre-wake-audit: clean (sleep 안전)`));
+          }
+        }
+      } catch {}
+      // 1.9.212
+      try {
+        const idemp = _runIdempotencyAudit(root);
+        const v = idemp.summary.totalViolations;
+        if (v > 0) {
+          log(red(`  ⚠ 멱등성 위반 ${v}건 (high: ${idemp.summary.highSeverity})`));
+          log(dim(`     → leerness idempotency audit 으로 상세 확인`));
+        } else {
+          log(grn(`  ✓ 멱등성 검사 통과 — verified ${idemp.summary.verifiedAreas} 영역`));
+        }
+      } catch {}
+    } catch {}
   }
 }
 
@@ -13284,7 +13375,12 @@ function mcpServeCmd(root) {
     { name: 'leerness_web', description: '1.9.168 — Web Bridge (1.9.165 playwright opt-in). sub: check (설치 + permissions.browser 확인) | screenshot (URL → PNG) | extract (URL + CSS selector → DOM 텍스트). 외부 AI가 leerness 의 웹 자동화 능력을 직접 호출. playwright 미설치 시 친절 안내 (graceful). 인자: { sub (required), url?, out?, selector?, path? }', inputSchema: { type: 'object', properties: { sub: { type: 'string', enum: ['check', 'screenshot', 'extract'] }, url: { type: 'string' }, out: { type: 'string' }, selector: { type: 'string' }, path: { type: 'string' } }, required: ['sub'] } },
     { name: 'leerness_pc', description: '1.9.168 — PC Bridge (1.9.166 robotjs/nut-tree opt-in). sub: check (설치 + permissions.mouse/keyboard) | click (x,y) | type (text) | screenshot (out). ⚠ full permissions 권장 (mouse/keyboard 접근). 외부 AI가 데스크탑 자동화 능력을 직접 호출. 인자: { sub (required), x?, y?, text?, out?, path? }', inputSchema: { type: 'object', properties: { sub: { type: 'string', enum: ['check', 'click', 'type', 'screenshot'] }, x: { type: 'number' }, y: { type: 'number' }, text: { type: 'string' }, out: { type: 'string' }, path: { type: 'string' } }, required: ['sub'] } },
     { name: 'leerness_lsp', description: '1.9.168 — LSP Bridge (1.9.167 typescript opt-in + regex fallback). sub: check (설치 여부) | symbols (file → function/class/interface/type/enum 목록) | references (name + in 디렉토리 → 호출 위치). 외부 AI가 코드 인텔리전스를 직접 호출 (의존성 0 fallback 동작). 🎉 MCP 53 도구 마일스톤. 인자: { sub (required), file?, name?, in?, path? }', inputSchema: { type: 'object', properties: { sub: { type: 'string', enum: ['check', 'symbols', 'references'] }, file: { type: 'string' }, name: { type: 'string' }, in: { type: 'string' }, path: { type: 'string' } }, required: ['sub'] } },
-    { name: 'leerness_review_request', description: '1.9.176 — 사용자 요청 사전 검토 (사용자 명시 요청). AI 에이전트가 사용자 요구를 **무조건 구현 전**에 호출. 분석: 1) estimatedType (route 추정), 2) conflicts (lesson 실패/진행중 task), 3) reuseCandidates (skill/reuse-map 매칭), 4) lessonsRecall (과거 결정), 5) planConflicts (진행중 milestone), 6) featureConflicts (feature graph 영역 겹침), 7) recommendedSteps (작업 유형별 3-5 단계), 8) efficiencyHints, 9) proceed (true/false). 사용자 결정 도움. 인자: { request (required), path? }', inputSchema: { type: 'object', properties: { request: { type: 'string' }, path: { type: 'string' } }, required: ['request'] } }
+    { name: 'leerness_review_request', description: '1.9.176 — 사용자 요청 사전 검토 (사용자 명시 요청). AI 에이전트가 사용자 요구를 **무조건 구현 전**에 호출. 분석: 1) estimatedType (route 추정), 2) conflicts (lesson 실패/진행중 task), 3) reuseCandidates (skill/reuse-map 매칭), 4) lessonsRecall (과거 결정), 5) planConflicts (진행중 milestone), 6) featureConflicts (feature graph 영역 겹침), 7) recommendedSteps (작업 유형별 3-5 단계), 8) efficiencyHints, 9) proceed (true/false). 사용자 결정 도움. 인자: { request (required), path? }', inputSchema: { type: 'object', properties: { request: { type: 'string' }, path: { type: 'string' } }, required: ['request'] } },
+    { name: 'leerness_requests_audit', description: '1.9.216 (1.9.207 사용자 명시) — 사용자 명시 요청 누락 확인 절차. .harness/user-requests.json 의 open/in-progress 요청을 task-log/plan/decisions 와 매칭 → missing/tracked/stale 분류. 외부 AI가 "사용자가 했던 요청 중 누락된 게 있나?"를 직접 회수. 응답: { total, open, missing[], tracked[], stale[], completed, dropped }. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
+    { name: 'leerness_constraints_check', description: '1.9.216 (1.9.208 사용자 명시) — 플랫폼/API 제약 사전 체크. 사용자 요청 텍스트에서 플랫폼 alias 매칭 (stripe/openai/anthropic/github/discord/twitter 6종 + 사용자 정의) → 각 플랫폼의 rate-limit / idempotency / auth / cost 제약 노출. 외부 AI가 "이 기능 구현 전 어떤 규정을 봐야 하나?"를 직접 회수. 인자: { request (required), path? }', inputSchema: { type: 'object', properties: { request: { type: 'string' }, path: { type: 'string' } }, required: ['request'] } },
+    { name: 'leerness_pre_wake_audit', description: '1.9.216 (1.9.209 사용자 명시) — sleep 전 sub-agent audit. 6 영역 점검: missing-user-requests / stale-in-progress / drift-handoff-stale / wakeup-missed / next-action-pending / auto-resume-plan. 외부 AI가 "깨어나기 전 점검할 부분"을 회수. 응답: { auditedAt, findings: {critical, warning, info}, summary }. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
+    { name: 'leerness_intent_classify', description: '1.9.216 (1.9.213 사용자 명시) — 사용자 의도 파악 + scope expansion 게이트. 응답: { intent: precise|broad|default, signals, domain, explicitMentions, expansionCandidates, mode: dry-run }. 3원칙 안전: (1) Always-Off Opt-In, (2) Dry-run 기본 (실행 X), (3) 명시 vs 추론 분리 라벨링. 5 도메인 (game/web/api/cli/data). 외부 AI가 "이 요청은 정확히 그것만 / 포괄적 / 기본인가?"를 회수. 인자: { request (required), path? }', inputSchema: { type: 'object', properties: { request: { type: 'string' }, path: { type: 'string' } }, required: ['request'] } },
+    { name: 'leerness_idempotency_audit', description: '1.9.216 (1.9.212 사용자 명시) — 멱등성 위반 탐지. 4영역 점검: rule-duplicate (medium) / task-duplicate-request (medium) / user-request-duplicate (low) / wakeup-duplicate (high). 응답: { violations[], verified[], summary: {totalViolations, high/medium/low, overall} }. 외부 AI가 "워크스페이스에 중복/충돌이 있나?"를 회수. 🎉 MCP 58 도구 마일스톤 (50→58). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
   ];
 
   function send(obj) {
@@ -13416,6 +13512,26 @@ function mcpServeCmd(root) {
             // 1.9.176: 사용자 요청 사전 검토 (사용자 명시 요청)
             cliArgs = ['review-request', String(args.request || ''), '--path', targetPath, '--json'];
             break;
+          case 'leerness_requests_audit':
+            // 1.9.216 (1.9.207): 사용자 요청 누락 확인 절차
+            cliArgs = ['requests', 'audit', '--path', targetPath, '--json'];
+            break;
+          case 'leerness_constraints_check':
+            // 1.9.216 (1.9.208): 플랫폼/API 제약 사전 체크
+            cliArgs = ['constraints', 'check', String(args.request || ''), '--path', targetPath, '--json'];
+            break;
+          case 'leerness_pre_wake_audit':
+            // 1.9.216 (1.9.209): pre-wake sub-agent audit
+            cliArgs = ['pre-wake-audit', '--path', targetPath, '--json'];
+            break;
+          case 'leerness_intent_classify':
+            // 1.9.216 (1.9.213): intent inference + scope expansion (dry-run)
+            cliArgs = ['intent', 'expand', String(args.request || ''), '--path', targetPath, '--json'];
+            break;
+          case 'leerness_idempotency_audit':
+            // 1.9.216 (1.9.212): 멱등성 감사 (rule/task/user-requests/wakeups 4영역)
+            cliArgs = ['idempotency', 'audit', '--path', targetPath, '--json'];
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }

package/package.json

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