leerness 1.9.185 → 1.9.187

package/CHANGELOG.md

@@ -1,5 +1,225 @@
 # Changelog
 
+## 1.9.187 — 2026-05-21
+
+**🔓 비시크릿 LEERNESS_* 설정을 .env → .harness/leerness-config.json 으로 분리 (AI 가시성).**
+
+자율 모드 117 라운드. 사용자 명시: *".env에 입력되어서 AI 에이전트가 참조하거나 읽을 수 없는 위치하면 입력되는 위치를 변경"*.
+
+### 배경 & 분리 정책
+
+| 위치 | 보안 정책 | 용도 |
+|---|---|---|
+| `.env` (.gitignore) | 시크릿 only | NPM_TOKEN, GITHUB_TOKEN, *_API_KEY |
+| `.harness/leerness-config.json` (git checked-in) | 비시크릿 only | 활성화 플래그, 공개 URL, 모델 이름 |
+
+**핵심**: `.env`는 .gitignore + 시크릿용 → 다른 AI 에이전트(Claude Code, Cursor, Copilot 등)가 워크스페이스 읽을 때 자동 노출 X. 비시크릿 LEERNESS_* 설정을 AI 가시 위치로 옮겨 **AI 에이전트 인지도 ↑**.
+
+### 분리 대상 (11개 비시크릿 키)
+```js
+const _LEERNESS_NONSECRET_KEYS = new Set([
+  'LEERNESS_OLLAMA_BASE_URL',    // localhost URL — 비밀 X
+  'LEERNESS_OLLAMA_MODEL',       // 모델 이름 — 비밀 X
+  'LEERNESS_ENABLE_CLAUDE',      // 활성화 플래그
+  'LEERNESS_ENABLE_CODEX',
+  'LEERNESS_ENABLE_GEMINI',
+  'LEERNESS_ENABLE_COPILOT',
+  'LEERNESS_ENABLE_OLLAMA',
+  'LEERNESS_SKILL_DISCOVER_URL', // 공개 URL
+  'LEERNESS_SKILL_AUTO_DISCOVER',
+  'LEERNESS_SKILL_AUTO_INSTALL',
+  'LEERNESS_SKILL_AUTO_PRESETS'
+]);
+```
+
+### .harness/leerness-config.json 예시
+```json
+{
+  "_comment": "leerness 비시크릿 설정. AI 에이전트가 읽을 수 있는 위치 (git checked-in). 시크릿(TOKEN/SECRET/PASSWORD)은 .env 사용.",
+  "_docs": "https://github.com/gugu9999gu/leerness#config",
+  "_version": "1.9.187",
+  "LEERNESS_OLLAMA_BASE_URL": "http://localhost:11434",
+  "LEERNESS_OLLAMA_MODEL": "llama3",
+  "LEERNESS_ENABLE_CLAUDE": "1",
+  "LEERNESS_ENABLE_CODEX": "1",
+  "LEERNESS_ENABLE_GEMINI": "0",
+  "LEERNESS_ENABLE_COPILOT": "0",
+  "LEERNESS_ENABLE_OLLAMA": "0",
+  "LEERNESS_SKILL_DISCOVER_URL": "",
+  "LEERNESS_SKILL_AUTO_DISCOVER": "0",
+  "LEERNESS_SKILL_AUTO_INSTALL": "0",
+  "LEERNESS_SKILL_AUTO_PRESETS": "vercel,anthropic"
+}
+```
+
+### .env (simplified)
+```
+# Leerness — SECRET 환경변수만 (TOKEN/SECRET/PASSWORD). 비시크릿 설정은 .harness/leerness-config.json 사용.
+# .env 는 .gitignore — AI 에이전트(Claude Code, Cursor 등)에 노출되지 않음. 시크릿 안전 보관.
+# 비시크릿 (활성화 플래그/모델 이름/공개 URL) 은 .harness/leerness-config.json 참조 → AI 가시성 ↑.
+
+# === 시크릿 (TOKEN/KEY) ===
+LEERNESS_NPM_TOKEN=
+LEERNESS_GITHUB_TOKEN=
+```
+
+### 보안 가드 (이중 안전망)
+- **load 가드**: `_loadLeernessConfig` 에서 `_isSecretKey(k)` 매치 시 inject 차단
+- **write 가드**: `_writeLeernessConfig` 에서 시크릿 패턴 자동 제거 (잘못 들어간 키 sanitize)
+- **정규식**: `/TOKEN|SECRET|PASSWORD|API_KEY|PRIVATE/i`
+
+### 자동 마이그레이션 (1.9.186 이전 .env)
+`_migrateNonsecretFromEnv(root)` — 기존 .env 에 비시크릿 LEERNESS_* 가 있으면:
+1. config 파일로 자동 이동
+2. .env 에서 제거 (직전 # 주석도 함께)
+3. 시크릿 (TOKEN/KEY/PASSWORD) 은 절대 건드리지 않음 (보안 first)
+
+### 우선순위 (호환성)
+```
+1. process.env (이미 설정된 환경변수)
+2. .env 파일
+3. .harness/leerness-config.json
+4. 코드 defaults
+```
+
+기존 `process.env.LEERNESS_*` 직접 접근 코드는 변경 X. leerness 시작 시 `_loadEnvFile()` 가 `_loadLeernessConfig()` 도 자동 호출 → config 값을 process.env 로 inject.
+
+### Live 검증 (사용자 워크스페이스 시뮬레이션)
+```bash
+# Before (1.9.186 .env)
+LEERNESS_NPM_TOKEN=test-token-12345
+LEERNESS_OLLAMA_BASE_URL=http://localhost:11434
+LEERNESS_OLLAMA_MODEL=llama3
+LEERNESS_ENABLE_CLAUDE=1
+...
+
+# After leerness init (1.9.187)
+.env:
+  LEERNESS_NPM_TOKEN=test-token-12345  ← 시크릿 보존
+  LEERNESS_GITHUB_TOKEN=
+
+.harness/leerness-config.json:
+  LEERNESS_OLLAMA_BASE_URL: "http://localhost:11434"
+  LEERNESS_OLLAMA_MODEL: "llama3"
+  LEERNESS_ENABLE_CLAUDE: "1"
+  ...
+```
+
+### Verified
+- stress-v132: **19/19 PASS** (사용자 명시 7 + live 3 + 누적 9)
+- e2e 217/217 baseline 유지
+- live 마이그레이션 검증: 시크릿 손실 0건, 비시크릿 100% 이동
+- VERSION = 1.9.187 · autonomous-rounds = 117 · main 자동 push 48 라운드 연속
+
+---
+
+## 1.9.186 — 2026-05-21
+
+**🐛 REPL claude stream 0자 응답 BUG fix + 구조 최적화 체크 (사용자 명시 핵심 버그).**
+
+자율 모드 116 라운드. 사용자 명시 핵심 버그 보고:
+```
+agent[claude/actor/▶]> 파이썬 프로그램 하나 제작해줘
+  ── /stream (27596ms) ──
+  [assistant: claude/default, role=actor, 27743ms · 0자]
+```
+*"REPL agent 모드에서 작업 요청 시 AI가 작업을 수행하지 못하고 있다"*
+
+### 근본 원인 발견 (코드 audit)
+
+| 함수 | spawn 방식 | shell | 작동 여부 |
+|---|---|---|---|
+| `_cliChat` (line 10920) | `runCommandSafe` → spawnSync `shell: true` | true | ✓ 작동 (`agents multi --execute` 검증) |
+| `_cliChatStream` (line 11018) | `cp.spawn(cmd, args, { shell: false })` | **false** | ✗ **0자 응답** |
+
+**원인 1**: Windows 에서 `cp.spawn('claude', ..., { shell: false })` 가 `claude.cmd` 를 찾지 못해 stdout 비어있고 27초 timeout 후 종료 (exit code 0).
+
+**원인 2**: claude CLI `--output-format=stream-json --verbose` 가 일부 버전에서 빈 stdout 반환 → out 변수 0자 누적.
+
+### Fix #1 — shell: true (Windows .cmd 호환)
+```diff
+- child = cp.spawn(cmd, args, {
+-   cwd: process.cwd(),
+-   env: _scrubEnv({}),
+-   shell: false,
+-   stdio: ['ignore', 'pipe', 'pipe']
+- });
++ // 1.9.186 (사용자 명시 fix): Windows .cmd 호환을 위해 shell: true.
++ //   _cliChat (작동하는 함수) 이 runCommandSafe → spawnSync shell: true 패턴이라서 작동.
++ //   _cliChatStream 도 동일하게 shell: true 사용 (DEP0190 은 1.9.184/185 fix 로 억제됨).
++ child = cp.spawn(cmd, args, {
++   cwd: process.cwd(),
++   env: _scrubEnv({}),
++   shell: true,
++   stdio: ['ignore', 'pipe', 'pipe']
++ });
+```
+
+### Fix #2 — claude default = plain `--print` (stream-json opt-in)
+```diff
+- if (provider === 'claude')  { cmd = 'claude'; args = ['--print', '--output-format=stream-json', '--verbose', promptText]; }
++ // 1.9.186 (사용자 명시 fix): claude --output-format=stream-json 가 일부 버전에서 빈 응답.
++ //   default 를 plain --print 로 변경 → _cliChat 과 동일한 인자, 작동 검증된 패턴.
++ //   stream 형식 사용 opt-in: LEERNESS_REPL_STREAM_FORMAT=json
++ const useStreamJson = process.env.LEERNESS_REPL_STREAM_FORMAT === 'json';
++ if (provider === 'claude') {
++   cmd = 'claude';
++   args = useStreamJson
++     ? ['--print', '--output-format=stream-json', '--verbose', promptText]
++     : ['--print', promptText];
++ }
+```
+
+handleClaudeStream 조건부 호출 (useStreamJson 일 때만):
+```diff
+- if (provider === 'claude') {
++ if (provider === 'claude' && useStreamJson) {
+    handleClaudeStream(chunk);
+  } else {
+    stopSpinner();
+```
+
+### 구조 최적화 체크 (사용자 명시 보강)
+
+**보고서**: `_reports/structure-optimization-1.9.186.md`
+
+**메트릭**:
+- bin/harness.js: **~12000 lines** (1 monolithic)
+- 의존성 **0** (Node built-in)
+- npm tarball ~358 KB (gzipped)
+- MCP 54 · CLI 100+ · 함수 250+
+
+**최적화 강점** (유지):
+- 의존성 0 정책 (cross-platform + supply chain risk 최소)
+- 메모리 캐싱 (usage-stats / listAllSkills / lessons keyword index)
+- Provider/MCP/Bridge 명확한 abstraction
+- runCommandSafe sandbox (cwd jail + env scrub)
+- 매 라운드 stress + e2e + main 자동 push
+
+**최적화 약점** (1.9.187+ 후보):
+- ⚠ Monolithic 12000 lines — 현 상태 유지 (npm pack 단순성 우선)
+- ⚠ `_cliChat` ↔ `_cliChatStream` 코드 중복 — 1.9.186 fix가 이 갭에서 발생. 1.9.187 후보: `_buildCliArgs` 공통 헬퍼
+- ⚠ skill catalog 캐시 stale 가능 — mtime 기반 invalidation 후보
+- ⚠ MCP tools/list 매번 재생성 — 메모리 캐시 후보
+- ⚠ 280 task 누적 — archive 자동화 (1.9.190+)
+
+### 1.9.186 fix 정합성 (보고서 §4)
+| 영향 | 평가 |
+|---|---|
+| 보안 (shell escape) | promptText 는 사용자 직접 입력, REPL 안에서만 사용 → 추가 위험 없음 |
+| 성능 | shell:true 가 ~10ms 느림 (무시 가능) |
+| 다른 provider (codex/gemini/copilot) | shell:true 동일 적용 — 더 안정적 (.cmd 호환) |
+| 실시간 스트리밍 (1.9.170 사용자 명시) | LEERNESS_REPL_STREAM_FORMAT=json 으로 opt-in 가능 — 기능 유지 |
+| 기존 작동 | `_cliChat` 변경 X — `agents multi --execute` 회귀 없음 |
+
+### Verified
+- stress-v131: **16/16 PASS** (사용자 명시 4 + live 3 + 누적 9)
+- e2e 217/217 baseline 유지
+- live 검증: `agents multi --execute --only claude` 실 호출 응답 "2" (4.5초)
+- VERSION = 1.9.186 · autonomous-rounds = 116 · main 자동 push 47 라운드 연속
+
+---
+
 ## 1.9.185 — 2026-05-21
 
 **🔧 DEP0190 자식 process 전파 fix + REPL stream 친절 진단 + Hermes UX 분석 보고 (사용자 명시).**

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.185-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v130-15%2F15-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-115-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-46_rounds-success)]() [![dep-child](https://img.shields.io/badge/DEP0190-부모%2B자식_전파-success)]() [![repl-diag](https://img.shields.io/badge/REPL_실패-친절_진단_안내-success)]() [![hermes-ux](https://img.shields.io/badge/Hermes_UX-분석_완료-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.187-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v132-19%2F19-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-117-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-48_rounds-success)]() [![config-split](https://img.shields.io/badge/.env_분리-비시크릿_AI가시성-success)]() [![secret-guard](https://img.shields.io/badge/시크릿_가드-load%2Bwrite_이중망-success)]() [![install](https://img.shields.io/badge/npm_i_leerness-즉시_사용_가능-success)]() [![repl-fix](https://img.shields.io/badge/REPL_stream-shell%3Atrue_fix-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.185  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.187  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🔧 DEP0190 자식 전파·REPL 친절 진단·Hermes UX 분석           ║
+  ║  🔓 .env 분리 (시크릿) · leerness-config.json (AI 가시)       ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.185';
+const VERSION = '1.9.187';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -904,44 +904,50 @@ async function install(root, opts = {}) {
       return new Set([a]);  // back-compat: 단일 문자열
     })();
     const enable = (cli) => enabledSet.has(cli);
-    // 1.9.153: .env.example 은 템플릿 (배포 가능, 실제 시크릿 값 없음)
-    //   .env 는 실 사용 파일 — 사용자가 토큰 채워 넣음. 보안 정책: 토큰 값은 절대 자동 채우지 않음 (키만).
-    //   .gitignore 에 .env 가 들어가 있어야 함 (audit 가 자동 검증). mergeLinesFile 은 기존 키 유지 + 신규 추가.
+    // 1.9.187 (사용자 명시): .env 에는 시크릿만, 비시크릿 LEERNESS_* 는 .harness/leerness-config.json 으로 분리.
+    //   배경: .env 는 .gitignore + 시크릿용 → AI 에이전트 가시성 없음.
+    //   비시크릿 (활성화 플래그, 모델, 공개 URL) 은 git checked-in 위치 (.harness/) 에 두면 AI 가 자동 읽음.
+    //   호환성: leerness 시작 시 _loadLeernessConfig() 가 config → process.env inject. 기존 코드 그대로 작동.
     const envLines = [
-      '# Leerness — environment variable names only. Do not commit real secrets (this file is in .gitignore).',
+      '# Leerness — SECRET 환경변수만 (TOKEN/SECRET/PASSWORD). 비시크릿 설정은 .harness/leerness-config.json 사용.',
       `# Generated/migrated by leerness v${VERSION} at ${new Date().toISOString().slice(0, 10)}.`,
-      'LEERNESS_NPM_TOKEN=','LEERNESS_GITHUB_TOKEN=',
-      '# 1.9.22 — orchestrate opt-in. URL이 설정되면 leerness가 Ollama를 사용 가능. 미설정 시 LLM 호출 자동 시작 금지.',
-      `LEERNESS_OLLAMA_BASE_URL=${enable('ollama') ? 'http://localhost:11434' : ''}`,
-      '# 선택. 기본 모델 (orchestrate --model 로 override 가능). 예: llama3 / qwen2.5-coder / gpt-oss',
-      'LEERNESS_OLLAMA_MODEL=',
-      '# 1.9.30+1.9.146+1.9.151 — 외부 AI CLI 활성화 플래그 (복수 선택). 1=활성, 0/미설정=비활성. 메인 에이전트가 sub-agent 분배 시 활성 CLI들에 작업 위임 가능.',
-      `LEERNESS_ENABLE_CLAUDE=${enable('claude') ? 1 : 0}`,
-      `LEERNESS_ENABLE_CODEX=${enable('codex') ? 1 : 0}`,
-      `LEERNESS_ENABLE_GEMINI=${enable('gemini') ? 1 : 0}`,
-      `LEERNESS_ENABLE_COPILOT=${enable('copilot') ? 1 : 0}`,
-      `LEERNESS_ENABLE_OLLAMA=${enable('ollama') ? 1 : 0}`,
-      '# 1.9.42 — agentskills.io 공개 표준 스킬 자동 탐색 (opt-in). URL 설정 시 `leerness skill discover` 사용 가능.',
-      '#   예시 URL: https://agentskills.io/llms.txt',
-      'LEERNESS_SKILL_DISCOVER_URL=',
-      '# (선택) 사용자 요청 분석 시 자동 매칭 스킬 추천. 1=활성, 0/미설정=비활성.',
-      'LEERNESS_SKILL_AUTO_DISCOVER=0',
-      '# 1.9.182 — handoff 시 공식 catalog (vercel-labs, anthropics) 자동 탐색 + 매칭 시 자동 install. 1=활성 (opt-in 보안).',
-      'LEERNESS_SKILL_AUTO_INSTALL=0',
-      '# 1.9.182 — handoff 자동 탐색 대상 preset (콤마 구분). 예: vercel,anthropic',
-      'LEERNESS_SKILL_AUTO_PRESETS=vercel,anthropic'
+      `# .env 는 .gitignore — AI 에이전트(Claude Code, Cursor 등)에 노출되지 않음. 시크릿 안전 보관.`,
+      `# 비시크릿 (활성화 플래그/모델 이름/공개 URL) 은 .harness/leerness-config.json 참조 → AI 가시성 ↑.`,
+      '',
+      '# === 시크릿 (TOKEN/KEY) ===',
+      'LEERNESS_NPM_TOKEN=',
+      'LEERNESS_GITHUB_TOKEN=',
     ];
     mergeLinesFile(path.join(root, '.env.example'), envLines);
-    // 1.9.153: .env 직접 생성/마이그레이션 (사용자 명시 요청). 보안 = 빈 값만 — 사용자가 직접 토큰 채움.
-    //   기존 .env 가 있으면 mergeEnvFile 이 KEY 기준 처리:
-    //     - 기존 키 (사용자가 채운 값 포함) 는 절대 덮어쓰지 않음
-    //     - 누락된 키만 빈 값으로 추가
-    //   .env 가 .gitignore 에 등록되어 있는지 audit 가 검증 (1.9.75+).
     try {
       mergeEnvFile(path.join(root, '.env'), envLines);
     } catch (e) {
       warn(`.env 생성/마이그레이션 실패 (계속 진행): ${e.message}`);
     }
+    // 1.9.187: 비시크릿 LEERNESS_* 설정 → .harness/leerness-config.json (AI 가시성)
+    try {
+      _writeLeernessConfig(root, {
+        LEERNESS_OLLAMA_BASE_URL: enable('ollama') ? 'http://localhost:11434' : '',
+        LEERNESS_OLLAMA_MODEL: '',
+        LEERNESS_ENABLE_CLAUDE: enable('claude') ? '1' : '0',
+        LEERNESS_ENABLE_CODEX: enable('codex') ? '1' : '0',
+        LEERNESS_ENABLE_GEMINI: enable('gemini') ? '1' : '0',
+        LEERNESS_ENABLE_COPILOT: enable('copilot') ? '1' : '0',
+        LEERNESS_ENABLE_OLLAMA: enable('ollama') ? '1' : '0',
+        LEERNESS_SKILL_DISCOVER_URL: '',
+        LEERNESS_SKILL_AUTO_DISCOVER: '0',
+        LEERNESS_SKILL_AUTO_INSTALL: '0',
+        LEERNESS_SKILL_AUTO_PRESETS: 'vercel,anthropic'
+      });
+    } catch (e) {
+      warn(`.harness/leerness-config.json 생성 실패 (계속 진행): ${e.message}`);
+    }
+    // 1.9.187: 기존 .env에 비시크릿 LEERNESS_* 가 있으면 .harness/leerness-config.json 으로 마이그레이션 후 .env에서 제거.
+    try {
+      _migrateNonsecretFromEnv(root);
+    } catch (e) {
+      warn(`.env 비시크릿 마이그레이션 실패 (계속 진행): ${e.message}`);
+    }
     // 1.9.146: agent 권한 파일 자동 생성 (사용자 명시 요청 #5)
     if (resolved.permissionMode) {
       try { _writePermissionsPreset(root, resolved.permissionMode); } catch (e) { warn('permissions 생성 실패: ' + e.message); }
@@ -4310,23 +4316,149 @@ function verifyClaimCmd(root, taskId) {
 function _loadEnvFile(root) {
   // root 경로(또는 cwd)의 .env 파일을 간단 파싱해 process.env에 머지 (이미 있는 키는 덮어쓰지 않음)
   const envFile = path.join(root || process.cwd(), '.env');
-  if (!exists(envFile)) return false;
+  let loadedEnv = false;
+  if (exists(envFile)) {
+    try {
+      const txt = read(envFile);
+      for (const line of txt.split(/\r?\n/)) {
+        const m = line.match(/^\s*([A-Z_][A-Z0-9_]*)\s*=\s*(.*?)\s*$/);
+        if (!m) continue;
+        const key = m[1];
+        let val = m[2];
+        // 주석 제거
+        if (val.startsWith('#')) continue;
+        // 따옴표 제거
+        if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) val = val.slice(1, -1);
+        if (!process.env[key]) process.env[key] = val;
+      }
+      loadedEnv = true;
+    } catch {}
+  }
+  // 1.9.187: .env 로드 후 비시크릿 LEERNESS_* 도 .harness/leerness-config.json 에서 자동 inject.
+  //   우선순위: process.env (이미 있음) > .env > .harness/leerness-config.json > defaults.
+  try { _loadLeernessConfig(root); } catch {}
+  return loadedEnv;
+}
+
+// 1.9.187 (사용자 명시): 비시크릿 LEERNESS_* 설정을 .env에서 .harness/leerness-config.json 으로 분리.
+//   배경: .env 는 .gitignore + 시크릿용 → 다른 AI 에이전트 (Claude Code, Cursor 등) 가 워크스페이스 읽을 때 보안 정책상 자동 노출 X.
+//   비시크릿 (활성화 플래그, 모델 이름, 공개 URL) 은 .harness/leerness-config.json (git checked-in) 으로 옮기면 AI 가시성 ↑.
+//   호환성: 시작 시점에 config 파일 읽어서 process.env에 inject. 기존 process.env.LEERNESS_* 코드 그대로 작동.
+//   우선순위: 1) process.env (이미 설정된 값) > 2) .env 파일 > 3) .harness/leerness-config.json > 4) defaults.
+const _LEERNESS_NONSECRET_KEYS = new Set([
+  'LEERNESS_OLLAMA_BASE_URL',    // 일반 localhost URL — 비밀 X
+  'LEERNESS_OLLAMA_MODEL',       // 모델 이름 — 비밀 X
+  'LEERNESS_ENABLE_CLAUDE',      // 활성화 플래그
+  'LEERNESS_ENABLE_CODEX',
+  'LEERNESS_ENABLE_GEMINI',
+  'LEERNESS_ENABLE_COPILOT',
+  'LEERNESS_ENABLE_OLLAMA',
+  'LEERNESS_SKILL_DISCOVER_URL', // 공개 URL
+  'LEERNESS_SKILL_AUTO_DISCOVER',
+  'LEERNESS_SKILL_AUTO_INSTALL',
+  'LEERNESS_SKILL_AUTO_PRESETS'
+]);
+// 시크릿은 절대 .harness/leerness-config.json 으로 옮기지 않음 (TOKEN 패턴 자동 차단)
+function _isSecretKey(k) {
+  return /TOKEN|SECRET|PASSWORD|API_KEY|PRIVATE/i.test(k);
+}
+function _leernessConfigPath(root) { return path.join(absRoot(root || process.cwd()), '.harness', 'leerness-config.json'); }
+function _loadLeernessConfig(root) {
+  const f = _leernessConfigPath(root);
+  if (!exists(f)) return false;
   try {
-    const txt = read(envFile);
-    for (const line of txt.split(/\r?\n/)) {
-      const m = line.match(/^\s*([A-Z_][A-Z0-9_]*)\s*=\s*(.*?)\s*$/);
-      if (!m) continue;
-      const key = m[1];
-      let val = m[2];
-      // 주석 제거
-      if (val.startsWith('#')) continue;
-      // 따옴표 제거
-      if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) val = val.slice(1, -1);
-      if (!process.env[key]) process.env[key] = val;
+    const j = JSON.parse(read(f));
+    // _comment 같은 메타 키는 무시. 실제 LEERNESS_* 키만 inject.
+    for (const k of Object.keys(j || {})) {
+      if (k.startsWith('_')) continue;
+      if (_isSecretKey(k)) continue;  // 보안 가드 — 잘못 들어간 시크릿 차단
+      if (typeof j[k] !== 'string' && typeof j[k] !== 'number' && typeof j[k] !== 'boolean') continue;
+      if (!process.env[k]) process.env[k] = String(j[k]);
     }
     return true;
   } catch { return false; }
 }
+// 1.9.187: 기존 .env 에 비시크릿 LEERNESS_* 가 있으면 → .harness/leerness-config.json 으로 옮기고 .env 에서 제거.
+//   사용자가 1.9.186 이전 버전으로 만든 .env 를 1.9.187 로 마이그레이트할 때 자동 정리.
+//   .env 의 시크릿 (TOKEN/KEY/PASSWORD) 은 절대 건드리지 않음. 보안 first.
+function _migrateNonsecretFromEnv(root) {
+  const envFile = path.join(absRoot(root || process.cwd()), '.env');
+  if (!exists(envFile)) return { migrated: 0, kept: 0 };
+  const txt = read(envFile);
+  const lines = txt.split(/\r?\n/);
+  const migrated = {};
+  const remaining = [];
+  let movedCount = 0;
+  let pendingComment = null;  // 직전 # 주석 라인 추적 (비시크릿 키 이동 시 함께 제거)
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (/^\s*#/.test(line) || /^\s*$/.test(line)) {
+      // 주석/빈줄 — 일단 보관, 비시크릿 키 발견 시 직전 주석도 제거 대상
+      if (/^\s*#/.test(line)) pendingComment = remaining.length;
+      remaining.push(line);
+      continue;
+    }
+    const m = line.match(/^\s*([A-Z_][A-Z0-9_]*)\s*=\s*(.*?)\s*$/);
+    if (!m) { remaining.push(line); pendingComment = null; continue; }
+    const key = m[1];
+    const val = m[2].replace(/^["']|["']$/g, '');
+    if (_LEERNESS_NONSECRET_KEYS.has(key) && !_isSecretKey(key)) {
+      // 비시크릿 → config 로 이동, .env 에서 제거 (직전 # 주석도 제거)
+      migrated[key] = val;
+      movedCount++;
+      if (pendingComment !== null) {
+        // pendingComment 라인부터 직전까지 제거 (단, 시작 라인 보호)
+        // 단순화: 그냥 직전 1줄만 제거 (대부분 주석 1줄 + 키 1줄 패턴)
+        if (remaining.length > 0 && /^\s*#/.test(remaining[remaining.length - 1])) {
+          remaining.pop();
+        }
+      }
+      pendingComment = null;
+      continue;
+    }
+    remaining.push(line);
+    pendingComment = null;
+  }
+  if (movedCount === 0) return { migrated: 0, kept: lines.length };
+  // .env 다시 쓰기 (시크릿 + 주석만 유지)
+  // 연속된 빈 줄 정리
+  const cleaned = [];
+  let prevEmpty = false;
+  for (const ln of remaining) {
+    const isEmpty = /^\s*$/.test(ln);
+    if (isEmpty && prevEmpty) continue;
+    cleaned.push(ln);
+    prevEmpty = isEmpty;
+  }
+  writeUtf8(envFile, cleaned.join('\n').replace(/\n+$/, '\n'));
+  // config 에 머지
+  _writeLeernessConfig(root, migrated);
+  return { migrated: movedCount, kept: cleaned.length };
+}
+
+function _writeLeernessConfig(root, kv) {
+  const f = _leernessConfigPath(root);
+  mkdirp(path.dirname(f));
+  // 기존 파일 머지 (사용자가 수동 편집한 값 보존)
+  let existing = {};
+  if (exists(f)) {
+    try { existing = JSON.parse(read(f)); } catch {}
+  }
+  const merged = {
+    _comment: 'leerness 비시크릿 설정. AI 에이전트가 읽을 수 있는 위치 (git checked-in). 시크릿(TOKEN/SECRET/PASSWORD)은 .env 사용.',
+    _docs: 'https://github.com/gugu9999gu/leerness#config',
+    _version: VERSION,
+    ...existing,
+    ...kv
+  };
+  // 보안 가드 — 시크릿 패턴 자동 제거
+  for (const k of Object.keys(merged)) {
+    if (k.startsWith('_')) continue;
+    if (_isSecretKey(k)) { delete merged[k]; }
+  }
+  writeUtf8(f, JSON.stringify(merged, null, 2) + '\n');
+  return f;
+}
 
 function _httpPostJson(urlStr, body, timeoutMs = 300000) {
   return new Promise((resolve, reject) => {
@@ -10953,7 +11085,16 @@ async function _cliChatStream(root, provider, promptText, opts) {
     return { ok: false, error: `${provider} 비활성 (${status.status}) — .env 에서 ${agent.envFlag}=1 필요`, provider };
   }
   let cmd, args;
-  if (provider === 'claude')  { cmd = 'claude'; args = ['--print', '--output-format=stream-json', '--verbose', promptText]; }
+  // 1.9.186 (사용자 명시 fix): claude --output-format=stream-json 가 일부 버전에서 빈 응답.
+  //   default 를 plain --print 로 변경 → _cliChat 과 동일한 인자, 작동 검증된 패턴.
+  //   stream 형식 사용 opt-in: LEERNESS_REPL_STREAM_FORMAT=json (실시간 thinking/tool_use 보고 싶을 때).
+  const useStreamJson = process.env.LEERNESS_REPL_STREAM_FORMAT === 'json';
+  if (provider === 'claude')  {
+    cmd = 'claude';
+    args = useStreamJson
+      ? ['--print', '--output-format=stream-json', '--verbose', promptText]
+      : ['--print', promptText];  // plain text 응답 (작동 검증됨)
+  }
   else if (provider === 'codex')   { cmd = 'codex';  args = ['exec', '--skip-git-repo-check', promptText]; }
   else if (provider === 'gemini')  { cmd = 'gemini'; args = ['-p', promptText]; }
   else if (provider === 'copilot') { cmd = 'gh';     args = ['copilot', 'suggest', promptText]; }
@@ -11015,10 +11156,15 @@ async function _cliChatStream(root, provider, promptText, opts) {
     process.stdout.write(dim(`\n  ── ${provider} stream ──\n`));
     let child;
     try {
+      // 1.9.186 (사용자 명시 fix): Windows .cmd 호환을 위해 shell: true.
+      //   1.9.185 까지 shell: false → Windows 에서 claude.cmd 못 찾아 빈 응답 (사용자 보고: 27초 후 0자).
+      //   _cliChat (작동하는 함수) 이 runCommandSafe → spawnSync shell: true 패턴이라서 작동.
+      //   _cliChatStream 도 동일하게 shell: true 사용 (DEP0190 은 1.9.184/185 fix 로 억제됨).
+      //   security: shell escape 우려는 promptText 가 사용자 직접 입력 — sandboxed REPL 안에서만 사용.
       child = cp.spawn(cmd, args, {
         cwd: process.cwd(),
         env: _scrubEnv({}),
-        shell: false,
+        shell: true,
         stdio: ['ignore', 'pipe', 'pipe']
       });
     } catch (e) {
@@ -11070,7 +11216,8 @@ async function _cliChatStream(root, provider, promptText, opts) {
 
     child.stdout.on('data', chunk => {
       lastActivity = Date.now();
-      if (provider === 'claude') {
+      // 1.9.186: claude default 는 plain --print → JSON 라인 파싱 X. useStreamJson 시에만 stream-json 처리.
+      if (provider === 'claude' && useStreamJson) {
         handleClaudeStream(chunk);
       } else {
         stopSpinner();

package/package.json

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