leerness 1.9.167 → 1.9.169

package/CHANGELOG.md

@@ -1,5 +1,100 @@
 # Changelog
 
+## 1.9.169 — 2026-05-20
+
+**🔧 Hotfix — `_collectWorkspacePaths()` --include 명시 시 cwd 자동 추가 안 함.**
+
+자율 모드 99 라운드. 1.9.168 release 후 발견된 e2e flake (209/217) 의 영구 해결.
+
+### 문제 진단
+- `cwd: os.tmpdir()` 명령 실행 시 leerness가 cwd의 `.harness` 자동 발견 → 카운트 +1
+- `os.tmpdir()` 에 잔존 `.harness` 디렉토리 존재 시 `--include` 명시했어도 cwd 추가됨
+- 결과: `brainstorm --include p1,p2` 호출 시 "3개 프로젝트" (cwd + p1 + p2) 잘못 카운트
+- 1.9.168 회귀 아님 — 1.9.15 이래 누적된 잠재 버그 (환경 의존 flake)
+- 24,877개 누적 leerness-* 임시 디렉토리 + 잔존 `Temp/.harness` 가 트리거
+
+### Fix — _collectWorkspacePaths() (harness.js, 1.9.15 도입 함수)
+```javascript
+function _collectWorkspacePaths(rootBase) {
+  const set = new Set();
+  const include = arg('--include', null);
+  // 1.9.169 fix: --include 명시 시 cwd 자동 추가 스킵 (explicit-only)
+  if (!include) {
+    if (exists(path.join(rootBase, '.harness'))) set.add(rootBase);
+  }
+  // ... --all-apps 동작 유지
+  if (include) { /* explicit paths only */ }
+  return Array.from(set);
+}
+```
+
+**원칙**: `--include` 가 명시되면 사용자가 의도한 explicit 경로만 사용. `--all-apps` 단독 또는 인자 없는 경우 기존 동작 (cwd 자동 추가) 유지.
+
+### 영향 범위
+- `brainstorm --include`, `insights --include`, `handoff --include`, `reuse-map --include`, `retro --include`
+- 모든 `--include` / 다중 프로젝트 명령 정확한 카운트
+
+### Verified
+- e2e **217/217 ✓** (1.9.168 시점 209/217 → 1.9.169 217/217 회복)
+- stress-v114: 14/14 (hotfix 4 + e2e 회복 3 + 누적 회귀 7)
+- 진단 검증: `os.tmpdir()/.harness` 시뮬 환경에서도 정확 카운트
+- VERSION = 1.9.169 / autonomous-rounds = 99 / main 자동 push 30 라운드 연속
+
+### 다음 라운드 (1.9.170) — 🎉 100 라운드 마일스톤 도달
+
+---
+
+## 1.9.168 — 2026-05-20
+
+**MCP bridge 3종 노출 (web/pc/lsp) — 50 → 53 도구 + 외부 AI 자동화 능력 직결.**
+
+자율 모드 98 라운드. 1.9.165~167 에서 leerness CLI 에 추가한 web/pc/lsp bridge 3종을 MCP 도구로 노출 → 외부 AI (Claude, Codex, Gemini, Copilot)가 leerness 의 웹/PC/LSP 자동화 능력을 **직접 호출** 가능.
+
+### Added — MCP 도구 3종
+| 도구 | 라우팅 | 설명 |
+|---|---|---|
+| `leerness_web` | `web check\|screenshot\|extract` | 1.9.165 playwright bridge MCP 노출 |
+| `leerness_pc` | `pc check\|click\|type\|screenshot` | 1.9.166 robotjs/nut-tree bridge MCP 노출 |
+| `leerness_lsp` | `lsp check\|symbols\|references` | 1.9.167 LSP 어댑터 MCP 노출 (typescript opt-in + regex fallback) |
+
+### 멀티 에이전트 오케스트레이션 강화
+1.9.156 `agents multi --execute` (실제 spawn + multi-signal consensus) 와 결합하면:
+- 외부 AI 1 (Claude) → `leerness_web screenshot` (검수 자료 캡처)
+- 외부 AI 2 (Codex) → `leerness_lsp symbols` (코드 인텔리전스)
+- 외부 AI 3 (Gemini) → `leerness_pc screenshot` (UI 테스트 자동화)
+
+→ **leerness 가 모든 외부 AI의 도구 공급망 역할** (= 진정한 범용 AI 하네스).
+
+### MCP 53 도구 마일스톤
+| 라운드 | 도구 수 | 마일스톤 |
+|---|---|---|
+| 1.9.110 | 30 | Memory CRUD 5종 완성 |
+| 1.9.159 | 50 | Provider Registry CRUD 완성 |
+| **1.9.168** | **53** | **Bridge 3종 외부 노출 (web/pc/lsp)** |
+
+### 사용 예시 (MCP tools/call)
+```json
+{ "name": "leerness_lsp", "arguments": { "sub": "symbols", "file": "src/api.ts" } }
+{ "name": "leerness_web", "arguments": { "sub": "screenshot", "url": "https://example.com", "out": "shot.png" } }
+{ "name": "leerness_pc", "arguments": { "sub": "click", "x": 800, "y": 400 } }
+```
+
+### Verified
+- e2e 217/217 baseline (1.9.167 유지)
+- stress-v113: 17/17 (MCP 등록 4 + tools/call 실 동작 4 + 6능력 매트릭스 2 + 누적 회귀 7)
+- 실측: `leerness_lsp symbols harness.js` (MCP) → 472 symbols
+- VERSION = 1.9.168 / autonomous-rounds = 98 / main 자동 push 29 라운드 연속
+
+### 6능력 매트릭스 (영향 없음, 100 라운드 마일스톤 임박)
+| 영역 | 1.9.167 | **1.9.168** |
+|---|---|---|
+| (5) MCP 도구 | 100% (50+ 50 도구) | **100% (53 도구)** |
+| 종합 | 72% | **72%** (production-ready 유지) |
+
+다음 라운드 (1.9.169~170): 100 라운드 마일스톤 임박 (2 라운드 남음).
+
+---
+
 ## 1.9.167 — 2026-05-20
 
 **LSP 어댑터 MVP — codeIntel 6번째 영역 신설 (typescript opt-in + regex fallback).**

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.167-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v112-23%2F23-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-50-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-97-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-28_rounds-success)]() [![lsp-bridge](https://img.shields.io/badge/lsp_bridge-typescript_opt--in%2Bregex_fallback-success)]() [![pc-bridge](https://img.shields.io/badge/pc_bridge-robotjs%2Fnut--tree_opt--in-success)]() [![web-bridge](https://img.shields.io/badge/playwright_bridge-opt--in_MVP-success)]() [![capability](https://img.shields.io/badge/6_capability-72%25_production--ready-brightgreen)]() [![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.169-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v114-14%2F14-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-53-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-99-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-30_rounds-success)]() [![hotfix](https://img.shields.io/badge/1.9.169-include_explicit--only-success)]() [![mcp-bridge](https://img.shields.io/badge/MCP_bridge-web%2Fpc%2Flsp_노출-success)]() [![lsp-bridge](https://img.shields.io/badge/lsp_bridge-typescript_opt--in%2Bregex_fallback-success)]() [![pc-bridge](https://img.shields.io/badge/pc_bridge-robotjs%2Fnut--tree_opt--in-success)]() [![web-bridge](https://img.shields.io/badge/playwright_bridge-opt--in_MVP-success)]() [![capability](https://img.shields.io/badge/6_capability-72%25_production--ready-brightgreen)]() [![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.167  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.169  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  6 capability 72% production-ready (web/pc/lsp opt-in MVP)   ║
+  ║  hotfix --include explicit-only · 30 라운드 main 자동 push   ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.167';
+const VERSION = '1.9.169';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -6343,9 +6343,16 @@ function _retroOneLine(agg) {
 }
 
 // 1.9.15: --all-apps / --include 경로 모음
+// 1.9.169 fix: --include 명시되면 cwd 자동 추가 안 함 (explicit-only).
+//   기존: cwd/.harness 자동 추가 → 잔존 .harness 시 의도치 않은 카운트 증가 (e2e flake 원인)
+//   변경: --include 시 사용자가 명시한 경로만 사용. --all-apps 단독은 기존 동작 유지.
 function _collectWorkspacePaths(rootBase) {
   const set = new Set();
-  if (exists(path.join(rootBase, '.harness'))) set.add(rootBase);
+  const include = arg('--include', null);
+  // --include 명시 시 cwd 자동 추가 스킵 (explicit-only 보장)
+  if (!include) {
+    if (exists(path.join(rootBase, '.harness'))) set.add(rootBase);
+  }
   if (has('--all-apps')) {
     const baseCandidates = [path.resolve(rootBase, '_apps'), path.resolve(rootBase, '..', '_apps')];
     for (const base of baseCandidates) {
@@ -6360,7 +6367,6 @@ function _collectWorkspacePaths(rootBase) {
       }
     }
   }
-  const include = arg('--include', null);
   if (include) {
     for (const p of String(include).split(',')) {
       const abs = path.resolve(p.trim());
@@ -9850,7 +9856,10 @@ function mcpServeCmd(root) {
     { name: 'leerness_env_detect', description: '1.9.145 — 실행 환경 자동 감지 + 변동 추적 JSON ({ snapshot: { os, hardware, locale, shell, node, tools, scriptDependencies }, diff: { firstCapture, changes, missing }, persisted }). "X은(는) 내부 또는 외부 명령... 아닙니다" 사전 방지: package.json scripts 의존 도구가 PATH에 있는지 검증 + 머신/Node/도구 변경 감지. 절대경로 마스킹 (보안). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_provider_list', description: '1.9.157/158 — Provider Registry 조회 JSON ({ total, builtin, user, providers: [{ id, bin, envFlag, source, desc }] }). 빌트인 5종 (claude/codex/gemini/copilot/ollama) + .harness/providers.json 사용자 정의 통합. 외부 AI가 sub-agent 분배 가능한 provider 전체 회수 (OpenRouter/Bedrock 등 등록되어 있으면 같이 노출). 🎉 MCP 48 도구 마일스톤', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_provider_add', description: '1.9.159 — Provider Registry 에 새 provider 동적 추가. 인자: { id (required), bin?, envFlag?, versionArgs?, desc?, path? }. 외부 AI가 새 CLI 발견 시 자가 확장 (OpenRouter / Bedrock / Groq / Hugging Face 등 등록). 같은 id 두 번 호출 → 갱신. 빌트인 id 호출 → user override. id 는 영문자/숫자/_- 만 허용.', inputSchema: { type: 'object', properties: { id: { type: 'string' }, bin: { type: 'string' }, envFlag: { type: 'string' }, versionArgs: { type: 'string' }, desc: { type: 'string' }, installHint: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } },
-    { name: 'leerness_provider_remove', description: '1.9.159 — Provider Registry 에서 사용자 정의 provider 제거. 인자: { id (required), path? }. 빌트인 5종 id 는 제거 불가 (override 만 제거 가능). 🎉 MCP 50 도구 마일스톤 — Provider Registry CRUD MCP 완성 (list/add/remove)', inputSchema: { type: 'object', properties: { id: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } }
+    { name: 'leerness_provider_remove', description: '1.9.159 — Provider Registry 에서 사용자 정의 provider 제거. 인자: { id (required), path? }. 빌트인 5종 id 는 제거 불가 (override 만 제거 가능). 🎉 MCP 50 도구 마일스톤 — Provider Registry CRUD MCP 완성 (list/add/remove)', inputSchema: { type: 'object', properties: { id: { type: 'string' }, path: { type: 'string' } }, required: ['id'] } },
+    { 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'] } }
   ];
 
   function send(obj) {
@@ -9957,6 +9966,27 @@ function mcpServeCmd(root) {
           case 'leerness_provider_remove':
             cliArgs = ['provider', 'remove', String(args.id || ''), '--path', targetPath];
             break;
+          // 1.9.168: Bridge 3종 MCP 노출 (web/pc/lsp) — 외부 AI 가 직접 호출
+          case 'leerness_web':
+            cliArgs = ['web', String(args.sub || 'check'), '--path', targetPath, '--json'];
+            if (args.url) cliArgs.splice(2, 0, String(args.url));
+            if (args.out) cliArgs.push('--out', String(args.out));
+            if (args.selector) cliArgs.push('--selector', String(args.selector));
+            break;
+          case 'leerness_pc':
+            cliArgs = ['pc', String(args.sub || 'check'), '--path', targetPath, '--json'];
+            if (typeof args.x === 'number' && typeof args.y === 'number') {
+              cliArgs.splice(2, 0, String(args.x), String(args.y));
+            }
+            if (args.text) cliArgs.splice(2, 0, String(args.text));
+            if (args.out) cliArgs.push('--out', String(args.out));
+            break;
+          case 'leerness_lsp':
+            cliArgs = ['lsp', String(args.sub || 'check'), '--path', targetPath, '--json'];
+            if (args.file) cliArgs.splice(2, 0, String(args.file));
+            if (args.name) cliArgs.splice(2, 0, String(args.name));
+            if (args.in) cliArgs.push('--in', String(args.in));
+            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.167",
+  "version": "1.9.169",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",