leerness 1.9.241 → 1.9.242

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 1.9.242 — 2026-05-26
+
+**🌐 UR-0014 2단계: env encoding --apply (BOM 자동 추가) + JSON 10 필드 envInfo + drift --auto-fix 통합.**
+
+### 사용자 명시 (UR-0014) — 2단계 자동 회복
+
+1.9.241 에서 감지만 제공했던 위험을 1.9.242 가 **실제 자동 수정**으로 확장:
+
+### 1. `leerness env encoding --apply` 자동 BOM 추가
+- `.ps1` / `.bat` / `.cmd` / `.sh` 의 위험 파일에 UTF-8 BOM (`EF BB BF`) 자동 prepend
+- `--auto-fix-bom` 별칭 동일 동작
+- 기본 dry-run 유지 (--apply 명시 시에만 변경) — 안전 원칙
+- 적용 결과 `result.applied` 배열로 노출 (file/action: utf8-bom-added | failed)
+
+### 2. handoff/session close/health --json **10 필드** envInfo 통합
+- JSON 통합 매트릭스 9 → **10 필드** 진화 (3 명령 × 10 = 30 통합 포인트)
+- `envInfo`: os / isKoreanWindows / codepage / nodeVersion / shellScriptsScanned / encodingRiskCount / encodingRiskFiles[0..5]
+- 외부 AI 가 환경 컨텍스트 + 인코딩 위험을 단일 호출에서 회수
+
+### 3. drift check --auto-fix env encoding BOM 통합
+- 1.9.82 보안 회복 + 1.9.225 delivered + 1.9.236 release cleanup 자동 회복 패턴 확장
+- `drift check --auto-fix` 시 셸 스크립트 위험 자동 BOM 추가
+- log: `🌐 --auto-fix 활성 (1.9.242) — 셸 스크립트 인코딩 위험 N건 BOM 자동 추가 중...`
+
+### 4. 누적 회귀 (1.9.207~241) — 모두 유지
+- MCP 69 도구 유지 (1.9.242 는 신규 CLI 옵션 + 통합, 도구 증가 X)
+- handoff JSON: userRequestsAudit + preWakeAudit + idempotencyAudit + abnormalShutdown + deliveredRequests + roundHistory + milestones + recentChanges + pyFiles + **envInfo** (10)
+
+### 5. stress-v187 — **22/22 PASS · 100%**
+- 1.9.242 (8): VERSION + env --apply (격리) + --auto-fix-bom 별칭 + handoff/session close/health 10필드 envInfo + drift --auto-fix BOM 통합 + envInfo 스키마
+- 성능 (2): cold_start avg 371ms · env --apply 372ms
+- 누적 회귀 (12): 1.9.207~241
+
+### 6. 자동 release (104 라운드 main-push streak · 65 라운드 npm publish streak)
+
+🌐 **UR-0014 완전 자동화** — 감지 (1.9.241) → 자동 수정 (1.9.242)
+
+---
+
 ## 1.9.241 — 2026-05-24
 
 **🌐 leerness env + 한국어 PowerShell 인코딩 위험 사전 감지 (사용자 명시 UR-0014).**

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.241-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v186-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-69-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-56-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-197-blueviolet)]() [![main-push](https://img.shields.io/badge/🎉_main--push_streak-103_rounds-success)]() [![npm-streak](https://img.shields.io/badge/🎉_npm--publish-64_streak-success)]() [![encoding](https://img.shields.io/badge/🌐_env_encoding-한국어_PS_위험_감지-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-598ms-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.242-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v187-22%2F22-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-69-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-56-brightgreen)]() [![json-fields](https://img.shields.io/badge/JSON_통합-10_필드-blueviolet)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-198-blueviolet)]() [![main-push](https://img.shields.io/badge/🎉_main--push_streak-104_rounds-success)]() [![npm-streak](https://img.shields.io/badge/🎉_npm--publish-65_streak-success)]() [![encoding](https://img.shields.io/badge/🌐_env_encoding-BOM_자동추가-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-371ms-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.241  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.242  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🌐 env encoding 위험 사전 감지 (사용자 명시 UR-0014)         ║
+  ║  🌐 env encoding --apply BOM 자동 추가 (UR-0014 2단계)        ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

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.241';
+const VERSION = '1.9.242';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -2491,8 +2491,25 @@ function envCmd(root, sub) {
   const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
   if (sub === 'encoding-check') {
     const result = _scanShellScriptsEncoding(root);
+    // 1.9.242: --apply 옵션 — 위험 파일에 UTF-8 BOM 자동 추가 (사용자 명시 UR-0014 2단계)
+    const apply = has('--apply') || has('--auto-fix-bom');
+    if (apply) result.applied = [];
+    if (apply && result.atRisk.length > 0) {
+      for (const r of result.atRisk) {
+        try {
+          const fullPath = path.join(root, r.file);
+          const orig = fs.readFileSync(fullPath);
+          const bom = Buffer.from([0xEF, 0xBB, 0xBF]);
+          const fixed = Buffer.concat([bom, orig]);
+          fs.writeFileSync(fullPath, fixed);
+          result.applied.push({ file: r.file, action: 'utf8-bom-added' });
+        } catch (e) {
+          result.applied.push({ file: r.file, action: 'failed', error: e.message });
+        }
+      }
+    }
     if (has('--json')) { log(JSON.stringify(result, null, 2)); return; }
-    log(cy(`# leerness env encoding-check (1.9.241, UR-0014) — 셸 스크립트 인코딩 위험 감지`));
+    log(cy(`# leerness env encoding-check (1.9.241/242, UR-0014) — 셸 스크립트 인코딩 위험 감지`));
     log('');
     log(`  스캔: ${gr(String(result.scanned))} 파일 (.ps1/.bat/.cmd/.sh)`);
     if (result.atRisk.length === 0) {
@@ -2504,7 +2521,14 @@ function envCmd(root, sub) {
         log(dm(`         ${r.risk}`));
       });
       log('');
-      result.notes.forEach(n => log(yl(`  💡 ${n}`)));
+      if (apply) {
+        const okCnt = (result.applied || []).filter(a => a.action === 'utf8-bom-added').length;
+        const failCnt = (result.applied || []).filter(a => a.action === 'failed').length;
+        log(gr(`  ✓ UTF-8 BOM 추가 ${okCnt}건${failCnt > 0 ? ` (실패 ${failCnt}건)` : ''} (1.9.242 --apply)`));
+      } else {
+        result.notes.forEach(n => log(yl(`  💡 ${n}`)));
+        log(dm(`  → 자동 수정: leerness env encoding --apply (BOM 자동 추가)`));
+      }
     }
     return;
   }
@@ -6554,6 +6578,20 @@ function handoff(root) {
           totalClasses: analyses.reduce((s, a) => s + a.classes, 0)
         };
       } catch {}
+      // 1.9.242: envInfo 통합 (handoff JSON 10번째 통합 필드) — 환경 + 인코딩 위험 (UR-0014 2단계)
+      try {
+        const runtimeEnv = _collectRuntimeEnv();
+        const encScan = _scanShellScriptsEncoding(root);
+        result.envInfo = {
+          os: runtimeEnv.os.platform,
+          isKoreanWindows: runtimeEnv.locale.isKoreanWindows || false,
+          codepage: runtimeEnv.locale.codepage || null,
+          nodeVersion: runtimeEnv.node.version,
+          shellScriptsScanned: encScan.scanned,
+          encodingRiskCount: encScan.atRisk.length,
+          encodingRiskFiles: encScan.atRisk.slice(0, 5).map(r => r.file)
+        };
+      } catch {}
     } catch {}
     try {
       const pwState = _loadPreWakeReport(root);
@@ -10777,6 +10815,20 @@ function sessionClose(root, opts = {}) {
           totalClasses: analyses.reduce((s, a) => s + a.classes, 0)
         };
       } catch {}
+      // 1.9.242: envInfo 통합 (session close JSON 10번째 통합 필드) — UR-0014 2단계
+      try {
+        const runtimeEnv = _collectRuntimeEnv();
+        const encScan = _scanShellScriptsEncoding(root);
+        jsonResult.envInfo = {
+          os: runtimeEnv.os.platform,
+          isKoreanWindows: runtimeEnv.locale.isKoreanWindows || false,
+          codepage: runtimeEnv.locale.codepage || null,
+          nodeVersion: runtimeEnv.node.version,
+          shellScriptsScanned: encScan.scanned,
+          encodingRiskCount: encScan.atRisk.length,
+          encodingRiskFiles: encScan.atRisk.slice(0, 5).map(r => r.file)
+        };
+      } catch {}
     } catch {}
     try {
       // 1.9.209: pre-wake-audit 자동 실행 + 저장 (sleep 전 자동 점검)
@@ -13868,6 +13920,31 @@ function driftCheckCmd(root, opts = {}) {
       log(`⚠ auto-fix 보안 회복 오류: ${e.message}`);
     }
   }
+  // 1.9.242: drift check --auto-fix 에 env encoding BOM 자동 추가 통합 (사용자 명시 UR-0014 2단계)
+  //   1.9.82 패턴 확장 — drift 회복 시 셸 스크립트 인코딩 위험도 자동 해결
+  if (autoFix) {
+    try {
+      const encScan = _scanShellScriptsEncoding(root);
+      if (encScan.atRisk && encScan.atRisk.length > 0) {
+        log('');
+        log(`🌐 --auto-fix 활성 (1.9.242) — 셸 스크립트 인코딩 위험 ${encScan.atRisk.length}건 BOM 자동 추가 중...`);
+        let ok = 0;
+        for (const r of encScan.atRisk) {
+          try {
+            const fullPath = path.join(root, r.file);
+            const orig = fs.readFileSync(fullPath);
+            const bom = Buffer.from([0xEF, 0xBB, 0xBF]);
+            const fixed = Buffer.concat([bom, orig]);
+            fs.writeFileSync(fullPath, fixed);
+            ok++;
+          } catch {}
+        }
+        log(`✓ UTF-8 BOM 추가 ${ok}/${encScan.atRisk.length}건 (1.9.242 UR-0014)`);
+      }
+    } catch (e) {
+      log(`⚠ env encoding auto-fix 오류 (1.9.242): ${e.message}`);
+    }
+  }
   // 1.9.225: drift check --auto-fix 에 delivered 패턴 자동 적용 통합 (1.9.223/224 시스템 회수)
   //   사용자 요청에 "구현 완료" 패턴이 누적되면 가짜 미답 신호가 drift score 를 가중시킬 수 있음 → 자동 정리.
   //   1.9.82 audit --fix 패턴과 동일: --auto-fix 시 즉시 적용, 적용 후 재검사.
@@ -17348,6 +17425,20 @@ function healthCmd(root) {
       totalClasses: analyses.reduce((s, a) => s + a.classes, 0)
     };
   } catch { out.pyFiles = { error: 'pyFiles 점검 실패' }; }
+  // 1.9.242: health --json envInfo 통합 (3 명령 10 필드 — UR-0014 2단계)
+  try {
+    const runtimeEnv = _collectRuntimeEnv();
+    const encScan = _scanShellScriptsEncoding(root);
+    out.envInfo = {
+      os: runtimeEnv.os.platform,
+      isKoreanWindows: runtimeEnv.locale.isKoreanWindows || false,
+      codepage: runtimeEnv.locale.codepage || null,
+      nodeVersion: runtimeEnv.node.version,
+      shellScriptsScanned: encScan.scanned,
+      encodingRiskCount: encScan.atRisk.length,
+      encodingRiskFiles: encScan.atRisk.slice(0, 5).map(r => r.file)
+    };
+  } catch { out.envInfo = { error: 'envInfo 점검 실패' }; }
   // 1.9.163: 5능력 매트릭스 자동 평가 (1.9.155 sub-agent 점검 → 코드 기반 자동화)
   //   각 능력을 코드 grep 으로 검출 → 0~100 점수. 사용자가 매 health 호출 시 leerness 자기 평가 확인.
   try {

package/package.json

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