leerness 1.9.170 → 1.9.172

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # Changelog
 
+## 1.9.172 — 2026-05-21
+
+**🎨 스트리밍 UX 강화 — spinner + Claude tool_use 가시화 + diff 패턴 자동 색깔 (사용자 명시 강화).**
+
+자율 모드 102 라운드. 1.9.170 사용자 명시 ("터미널 화면 계속 갱신, 추론중/diff/생각하는 과정 실시간 표시") 의 진짜 의도 보강.
+
+### 1. 추론중 Spinner — Visual Feedback
+- `_cliChatStream` 안에 `setInterval(120ms)` spinner — stdout idle 800ms+ 시 깜빡임
+- `⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏` 10 frames + 경과 시간 표시 ("⠙ 추론중... (3s)")
+- `\r\x1b[K` ANSI escape — 현재 라인 클리어 + spinner 갱신
+- `stopSpinner()` — stdout/stderr data 도착 시 즉시 spinner 라인 클리어
+- 옵션: `opts.noSpinner: true` 또는 비-TTY 환경에선 자동 비활성
+
+### 2. Claude tool_use 가시화
+- Claude `--output-format=stream-json` 의 `content_block_start` 이벤트에서 `type='tool_use'` 감지
+- 표시: `🔧 Tool: Read 호출 중...` (cyan 색)
+- AI가 파일 읽기/쓰기/Bash 호출 시 사용자가 즉시 인지
+
+### 3. diff 패턴 자동 색깔 (writeColored)
+```diff
+diff --git a/file.js b/file.js    # yellow (헤더)
+--- a/file.js                       # yellow
++++ b/file.js                       # yellow
+@@ -10,3 +10,3 @@                  # cyan (hunk)
+- old line                          # red
++ new line                          # green
+  context                           # 기본 색
+```
+- 라인 단위 처리 (`lineBuf` 버퍼링)
+- 정규식 매칭: `/^\+(?!\+\+)/` → green, `/^-(?!--)/` → red, `/^@@.*@@/` → cyan
+- `flushLineBuf()` — 종료 시 잔여 라인 출력
+
+### 통합 흐름
+```
+user> 이 함수 리팩토링 + diff 보여줘
+  → claude CLI stream 호출 중...  (Ctrl+C 로 중단)
+  ── claude stream ──
+⠹ 추론중... (2s)                   # 응답 시작 전 spinner
+  [claude-opus-4-7]
+  🔧 Tool: Read 호출 중...          # tool_use 감지
+  
+  분석 결과:
+  
+  diff --git a/utils.js b/utils.js  # yellow
+  @@ -5,3 +5,3 @@                   # cyan
+  - function bad() { return null; } # red
+  + function good() { return {}; }  # green
+  ── /stream (4521ms) ──
+```
+
+### Verified
+- e2e 217/217 baseline 유지
+- stress-v117: **20/20** (spinner 4 + tool_use 2 + diff 4 + ANSI helpers 2 + 통합 2 + 누적 회귀 6)
+- VERSION = 1.9.172 / autonomous-rounds = 102 / main 자동 push 33 라운드 연속
+
+---
+
+## 1.9.171 — 2026-05-21
+
+**AGENTS.md / CLAUDE.md / session-workflow.md 1.9.88~170 누적 갱신 (drift 차단).**
+
+자율 모드 101 라운드. 1.9.87 마지막 metadata 갱신 후 84 라운드 간격 — 다음 세션에서 새 기능 (REPL/Bridge/Tab cycle/53 MCP/6 능력) 인지 못 할 위험 차단.
+
+### Updated
+- **session-workflow.md**: 1.9.140~170 31 라운드 누적 변경사항 추가
+  - release sync-main 자동 (31 라운드 연속 main 자동 push)
+  - Feature Causality Graph (1.9.141~143)
+  - env detect (1.9.145)
+  - CLI 에이전트 모드 + 3-tier 권한 시스템 (1.9.146)
+  - REPL agent + Sandboxing runCommandSafe (1.9.149~150)
+  - REPL UX 강화 (1.9.151~155)
+  - agents multi --execute + consensus (1.9.156)
+  - Provider Registry CRUD CLI + MCP **50 도구 마일스톤** (1.9.157~159)
+  - 90 라운드 마일스톤 (1.9.160)
+  - REPL slash 4종 (1.9.161~162)
+  - 5능력 매트릭스 health 통합 (1.9.163)
+  - leerness which 진단 (1.9.164)
+  - web/pc/lsp bridge 3종 (1.9.165~167)
+  - MCP **53 도구 마일스톤** + Bridge 외부 노출 (1.9.168)
+  - --include explicit-only hotfix (1.9.169)
+  - **100 라운드 + Tab cycle + 실시간 스트리밍** (1.9.170)
+
+- **AGENTS.md**: 
+  - "REPL Agent + Bridge 명령 (1.9.149~170)" 섹션 신설 (자연어 매핑 11종)
+  - "6 능력 매트릭스 (1.9.167+)" 섹션 — overallScore + production-ready/beta-ready/mvp 라벨
+
+- **CLAUDE.md**: 
+  - REPL Agent 100 라운드 자율 마일스톤 섹션 (Tab/Shift+Tab/스트리밍)
+  - Bridge 3종 opt-in 안내
+  - 6 능력 매트릭스 72% production-ready
+
+### 자연어 매핑 신규 추가 (AGENTS.md)
+| 사용자 발화 | 즉시 실행 |
+|---|---|
+| "에이전트 켜줘 / REPL 모드" | `leerness agent .` |
+| "Claude/Codex 대화" | `leerness agent . --provider claude` |
+| "다른 provider / Tab" | REPL에서 `Tab` / `Shift+Tab` |
+| "웹 스크린샷 / URL 캡처" | `leerness web screenshot <url>` |
+| "마우스 클릭 / 자동화" | `leerness pc click <x> <y>` |
+| "함수 찾아줘 / 심볼 추출" | `leerness lsp symbols <file>` |
+| "참조 검색" | `leerness lsp references <name> --in <dir>` |
+| "권한 모드 확인" | `leerness permissions list` |
+| "최신 버전 작동 확인" | `leerness which` |
+
+### Verified
+- e2e 217/217 baseline 유지
+- stress-v116: **20/20** (session-workflow 6 + AGENTS 4 + CLAUDE 3 + 누적 회귀 7)
+- VERSION = 1.9.171 / autonomous-rounds = 101 / main 자동 push 32 라운드 연속
+
+---
+
 ## 1.9.170 — 2026-05-21 — 🎉 100 라운드 자율 마일스톤
 
 **사용자 명시 요청 2종: REPL Tab cycle provider/model + 실시간 스트리밍.**

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.170-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v115-23%2F23-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-53-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-100🎉-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-31_rounds-success)]() [![repl-tab](https://img.shields.io/badge/REPL-Tab_cycle%2B실시간_스트리밍-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)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.172-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v117-20%2F20-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-53-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-102-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-33_rounds-success)]() [![stream-ux](https://img.shields.io/badge/스트리밍-spinner%2Btool__use%2Bdiff_색깔-success)]() [![repl-tab](https://img.shields.io/badge/REPL-Tab_cycle%2B실시간_스트리밍-success)]() [![mcp-bridge](https://img.shields.io/badge/MCP_bridge-web%2Fpc%2Flsp_노출-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.170  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.172  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🎉 100 라운드 자율 마일스톤 · REPL Tab cycle + 실시간 스트림 ║
+  ║  🎨 스트리밍 spinner + tool_use 가시화 + diff 자동 색깔       ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.170';
+const VERSION = '1.9.172';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -10552,6 +10552,7 @@ async function _cliChat(root, provider, prompt, opts) {
 }
 
 // 1.9.170: REPL 실시간 스트리밍 — CLI stdout을 즉시 터미널에 표시 (사용자 명시 요청)
+// 1.9.172: 추론중 spinner + Claude tool_use 가시화 + diff 패턴 자동 색깔 (사용자 명시 강화)
 //   추론중/diff/thinking 과정이 stdout 으로 흐르는 동안 실시간 렌더링.
 //   runCommandSafe 의 배치 결과와 달리 cp.spawn 의 child.stdout 을 직접 pipe.
 //   env scrub + cwd jail 은 동일하게 적용.
@@ -10574,9 +10575,55 @@ async function _cliChatStream(root, provider, promptText, opts) {
     let out = '', err = '';
     let buf = ''; // claude stream-json 라인 버퍼
     let firstChunk = true;
+    let lineBuf = ''; // 1.9.172: diff 패턴 색깔 위한 라인 버퍼
     const isTty = process.stdout.isTTY;
     const dim = isTty ? (s) => `\x1b[2m${s}\x1b[0m` : s => s;
     const cy = isTty ? (s) => `\x1b[36m${s}\x1b[0m` : s => s;
+    const green = isTty ? (s) => `\x1b[32m${s}\x1b[0m` : s => s;
+    const red = isTty ? (s) => `\x1b[31m${s}\x1b[0m` : s => s;
+    const yel = isTty ? (s) => `\x1b[33m${s}\x1b[0m` : s => s;
+
+    // 1.9.172: 추론중 spinner — stdout이 일정 시간 idle 하면 깜빡이는 visual feedback
+    //   AI가 응답 시작하기 전 (preprocessing/thinking) 동안 사용자가 "동작 중" 인지 확인.
+    const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let spinnerIdx = 0;
+    let spinnerActive = false;
+    let lastActivity = Date.now();
+    const spinnerInterval = isTty && !opts.noSpinner ? setInterval(() => {
+      const idle = Date.now() - lastActivity;
+      if (idle > 800) {
+        if (!spinnerActive) { spinnerActive = true; }
+        // 현재 라인을 클리어하고 spinner 표시
+        process.stdout.write(`\r\x1b[K${dim(spinnerFrames[spinnerIdx % spinnerFrames.length] + ' 추론중... (' + Math.floor(idle / 1000) + 's)')}`);
+        spinnerIdx++;
+      }
+    }, 120) : null;
+    const stopSpinner = () => {
+      if (spinnerActive) {
+        process.stdout.write('\r\x1b[K');  // spinner 라인 클리어
+        spinnerActive = false;
+      }
+      lastActivity = Date.now();
+    };
+
+    // 1.9.172: diff 패턴 자동 색깔 — `+ ` / `- ` / `@@` 라인을 green/red/cyan
+    function writeColored(s) {
+      // 라인 단위로 처리 (라인 끝까지 모은 후 색깔 입히기)
+      lineBuf += s;
+      const lines = lineBuf.split('\n');
+      lineBuf = lines.pop() || '';
+      for (const ln of lines) {
+        if (/^\+(?!\+\+)/.test(ln)) process.stdout.write(green(ln) + '\n');
+        else if (/^-(?!--)/.test(ln)) process.stdout.write(red(ln) + '\n');
+        else if (/^@@.*@@/.test(ln)) process.stdout.write(cy(ln) + '\n');
+        else if (/^(diff --git|---|\+\+\+|index )/.test(ln)) process.stdout.write(yel(ln) + '\n');
+        else process.stdout.write(ln + '\n');
+      }
+    }
+    function flushLineBuf() {
+      if (lineBuf) { process.stdout.write(lineBuf); lineBuf = ''; }
+    }
+
     process.stdout.write(dim(`\n  ── ${provider} stream ──\n`));
     let child;
     try {
@@ -10587,6 +10634,7 @@ async function _cliChatStream(root, provider, promptText, opts) {
         stdio: ['ignore', 'pipe', 'pipe']
       });
     } catch (e) {
+      if (spinnerInterval) clearInterval(spinnerInterval);
       return resolve({ ok: false, error: 'spawn 실패: ' + e.message, provider });
     }
     const timer = setTimeout(() => {
@@ -10594,6 +10642,7 @@ async function _cliChatStream(root, provider, promptText, opts) {
     }, opts.timeout || 120000);
 
     // Claude stream-json 모드: 각 라인이 JSON event. type=assistant_message_delta.text 만 출력
+    // 1.9.172: tool_use 가시화 추가 (Read/Write/Bash 호출 시 "🔧 Tool: <name>" 표시)
     function handleClaudeStream(chunk) {
       buf += chunk.toString();
       const lines = buf.split('\n');
@@ -10602,44 +10651,63 @@ async function _cliChatStream(root, provider, promptText, opts) {
         if (!ln.trim()) continue;
         try {
           const ev = JSON.parse(ln);
-          // assistant 메시지 chunk만 표시 (thinking/system 은 dim)
+          // assistant 메시지 chunk
           if (ev.type === 'content_block_delta' && ev.delta?.text) {
-            process.stdout.write(ev.delta.text);
+            stopSpinner();
+            writeColored(ev.delta.text);
             out += ev.delta.text;
           } else if (ev.type === 'message_start' && firstChunk) {
             firstChunk = false;
+            stopSpinner();
             process.stdout.write(dim(`  [${ev.message?.model || provider}] `));
           } else if (ev.type === 'thinking_delta' && ev.delta?.thinking) {
+            stopSpinner();
             process.stdout.write(dim(ev.delta.thinking));
+          } else if (ev.type === 'content_block_start' && ev.content_block?.type === 'tool_use') {
+            // 1.9.172: tool_use 시작 시 "🔧 Tool: Read" 같은 안내
+            stopSpinner();
+            const toolName = ev.content_block.name || 'tool';
+            process.stdout.write(cy(`\n  🔧 Tool: ${toolName} 호출 중...\n`));
+          } else if (ev.type === 'tool_use' || ev.type === 'content_block_stop') {
+            // 도구 완료 시그널 (필요시 활동 표시)
           }
         } catch {
           // JSON 아니면 그대로 출력 (fallback)
-          process.stdout.write(ln + '\n');
+          stopSpinner();
+          writeColored(ln + '\n');
           out += ln + '\n';
         }
       }
     }
 
     child.stdout.on('data', chunk => {
+      lastActivity = Date.now();
       if (provider === 'claude') {
         handleClaudeStream(chunk);
       } else {
+        stopSpinner();
         const s = chunk.toString();
         out += s;
-        process.stdout.write(s);
+        writeColored(s);
       }
     });
     child.stderr.on('data', chunk => {
+      lastActivity = Date.now();
+      stopSpinner();
       const s = chunk.toString();
       err += s;
       // 추론중/진행 메시지는 dim 으로 (실제 에러는 출력 후에 종합)
       process.stdout.write(dim(s));
     });
     child.on('error', e => {
+      if (spinnerInterval) clearInterval(spinnerInterval);
       clearTimeout(timer);
       resolve({ ok: false, error: 'child error: ' + e.message, provider });
     });
     child.on('close', code => {
+      if (spinnerInterval) clearInterval(spinnerInterval);
+      stopSpinner();
+      flushLineBuf();  // 1.9.172: lineBuf 잔여 flush
       clearTimeout(timer);
       const dt = Date.now() - t0;
       process.stdout.write(dim(`\n  ── /stream (${dt}ms) ──\n`));

package/package.json

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