leerness 1.9.288 → 1.9.290

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 1.9.290 — 2026-06-03 — UR-0037 (Codex #4): require 시 top-level side effect 격리 — Codex 5건 완전 수렴 🎉
+
+**🧩 `require('leerness/bin/harness.js')` 가 호스트 프로세스를 오염시키던 마지막 갭 수정 (Codex gpt-5.5 #4). 이로써 Codex 코드 리뷰 5건 전부 수렴 완료.**
+
+### 배경
+1.9.184/249 에서 (1) `process.removeAllListeners('warning')` + warning 핸들러 재등록, (2) `process.env.NODE_OPTIONS += ' --no-deprecation'`, (3) chcp 65001 IIFE 가 **파일 최상단에서 즉시 실행**됐음. CLI 로는 정상이나, leerness 를 라이브러리로 `require()` 하거나 단위 테스트(`require.main` 가드로 노출한 14종 순수 함수)에서 불러오면 호스트 프로세스의 warning 리스너가 통째로 제거되고 NODE_OPTIONS 가 변형됨 → side-effect-free import 원칙 위반.
+
+### 구현 (Codex #4 → 수렴)
+1. **`_cliBootstrap()` 로 CLI 전용 부작용 격리** — warning listener 제거/재등록 + NODE_OPTIONS 변형 + `_ensureStdoutEncoding()` 호출을 한 함수로 묶고, 파일 끝의 기존 `if (require.main === module)` 가드(1.9.255)와 동일하게 **상단에서도 `if (require.main === module) _cliBootstrap();`** 로만 호출.
+2. **`_ensureStdoutEncoding()` IIFE → named 함수** — 즉시실행 제거, `_cliBootstrap` 내부에서만 호출 (chcp/encoding 부작용도 CLI 한정).
+3. selftest 37→38 (소스 가드 정합 + named 함수 존재 검증) · e2e 234→235 (깨끗한 자식에서 require 후 warning listener 보존 + NODE_OPTIONS 미오염 실측).
+
+### 검증
+- **selftest 38/38 PASS** · **E2E 235/235 PASS** (회귀 0).
+- 실측: `node -e "process.on('warning',L); require('harness'); ..."` → listener 보존 `true` · NODE_OPTIONS 오염 `false`. CLI(`selftest`/`--version`)는 부트스트랩 정상 실행.
+- **🎉 Codex gpt-5.5 코드 리뷰 5건(#1 MCP policy / #2 release dry-run / #3 셸 주입 / #4 side effect / #5 도구수) 전부 수렴 완료.**
+
+## 1.9.289 — 2026-06-03 — UR-0036 (Codex #3): REPL agy/copilot 프롬프트 셸 주입 차단
+
+**🔒 REPL 스트리밍에서 agy/copilot 프롬프트가 `shell:true` 인자로 raw 전달돼 셸 분리/주입되던 보안 갭 수정 (Codex gpt-5.5 #3).**
+
+### 배경
+claude/codex 는 1.9.188 에서 프롬프트를 stdin 으로 전달(셸 escape 우회)하나, agy(`-p`)/copilot(`gh copilot suggest`)은 인자 모드만 지원해 `promptText` 를 args 에 raw 로 넣었음. `cp.spawn(cmd, args, {shell:true})` 는 args 를 따옴표 없이 조인하므로 `agy -p hello; rm -rf` 처럼 프롬프트의 `;`/`&&`/`$(...)`/공백이 셸에 해석됨.
+
+### 구현
+1. **`_shellQuoteArg(s)` 순수 헬퍼** — POSIX(sh): single-quote(bulletproof, 내부 `'`→`'\''`). Windows(cmd.exe): double-quote + 내부 `"`→`""` (공백/`&`/`|`/`<`/`>`/`(`/`)`/`;`/`$()` 모두 리터럴화).
+2. **agy/copilot args 안전 인용** — `['-p', _shellQuoteArg(promptText)]` / `['copilot','suggest',_shellQuoteArg(promptText)]`. 프롬프트가 단일 리터럴 인자로 전달.
+3. selftest 36→37 + e2e 233→234.
+
+### 검증
+- **selftest 37/37 PASS** · **E2E 234/234 PASS** (회귀 0) · `a; rm -rf / && echo $(whoami)` → 단일 인용 리터럴 확인 (POSIX/Windows 분기).
+- 남은 백로그: UR-0037(#4) require 시 top-level side effect 격리.
+
 ## 1.9.288 — 2026-06-03 — Codex gpt-5.5 코드 리뷰 수렴: MCP policy enforce + release dry-run + 도구수 정합
 
 **🔒 Codex(gpt-5.5, xhigh)가 실제 코드 라인 근거로 제시한 5건 중 검증된 high/med 3건 수렴 + 나머지 2건 백로그.**

package/README.md

@@ -3,7 +3,7 @@
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.288-green)]() [![tests](https://img.shields.io/badge/e2e-233%2F233-success)]() [![selftest](https://img.shields.io/badge/selftest-36-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-79-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![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.290-green)]() [![tests](https://img.shields.io/badge/e2e-235%2F235-success)]() [![selftest](https://img.shields.io/badge/selftest-38-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-79-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.288 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.290 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### Core Commands
 
@@ -513,7 +513,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.288는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **79개 도구**를 노출:
+Leerness v1.9.290는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **79개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -534,7 +534,7 @@ Leerness v1.9.288는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.9.288)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.290)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -572,6 +572,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.9.288: 2026-06-03
+Last synced by Leerness v1.9.290: 2026-06-03
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -10,33 +10,17 @@ const readline = require('readline');
 const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
   PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord } = require('../lib/pure-utils');
 
-const VERSION = '1.9.288';
-
-// 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
-//   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
-//   인자 escape 가 필요한 위치는 검증된 입력만 spawnSync 에 전달. REPL agent 진입 시 _checkAgent 가 발산하는 노이즈 제거.
-process.removeAllListeners('warning');
-process.on('warning', (w) => {
-  if (w && (w.code === 'DEP0190' || /DEP0190/.test(String(w.message || '')))) return;
-  process.stderr.write(`(node:${process.pid}) ${w.name || 'Warning'}: ${w.message || w}\n`);
-});
-// 1.9.185 (사용자 명시): REPL 진입 후 user input 시점에도 DEP0190 발생 (claude/ollama CLI 가 Node 자식 spawn 시 자식의 노이즈).
-//   부모 핸들러는 자식에 상속 X → NODE_OPTIONS=--no-deprecation 으로 모든 Node child 까지 전파.
-//   process.env 변경은 자식 spawn 시 상속 (이미 시작된 부모에는 영향 X, 부모는 위의 'warning' 핸들러로 처리).
-if (!/--no-deprecation/.test(process.env.NODE_OPTIONS || '')) {
-  process.env.NODE_OPTIONS = ((process.env.NODE_OPTIONS || '') + ' --no-deprecation').trim();
-}
-
-// 1.9.249 (사용자 명시 UR-0018): 터미널 출력 한국어 깨짐 사전 방지
-//   사용자 보고: protected-files.md 같은 한국어 텍스트가 ? / 한자 조각으로 깨짐 (UTF-8 → CP949 오인식)
-//   조치: (1) stdout/stderr UTF-8 명시  (2) Windows + 한국어 OS + 비-65001 코드페이지 시 chcp 65001 자동 시도
-//   안전: 1회만 시도 (LEERNESS_NO_AUTOCHCP=1 로 opt-out), 실패 시 무시
-(function _ensureStdoutEncoding() {
+const VERSION = '1.9.290';
+
+// 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
+//   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
+//   해결: 부작용을 _cliBootstrap() 으로 묶고 파일 끝 require.main 가드에서만 호출. import/단위테스트는 부작용 0.
+// 1.9.249 (UR-0018): 터미널 출력 한국어 깨짐 사전 방지 (stdout UTF-8 + Windows 비-65001 시 chcp 65001 자동, opt-out LEERNESS_NO_AUTOCHCP=1).
+function _ensureStdoutEncoding() {
   try {
     if (process.stdout && process.stdout.setEncoding) process.stdout.setEncoding('utf8');
     if (process.stderr && process.stderr.setEncoding) process.stderr.setEncoding('utf8');
   } catch {}
-  // Windows + 한국어 사용자 환경 (chcp 949 = CP949) → 한국어 콘솔 자동 65001 (UTF-8)
   if (process.platform !== 'win32') return;
   if (process.env.LEERNESS_NO_AUTOCHCP === '1') return;
   if (process.env._LEERNESS_CHCP_DONE === '1') return;  // 자식 spawn 무한 재호출 방지
@@ -47,7 +31,6 @@ if (!/--no-deprecation/.test(process.env.NODE_OPTIONS || '')) {
     const code = m ? parseInt(m[1], 10) : null;
     // 65001 = UTF-8, 949 = CP949 (한국), 932 = CP932 (일본), 936 = CP936 (중국)
     if (code && code !== 65001) {
-      // 자동 chcp 65001 시도 (실패해도 무시 — 출력 방향 X 인 비-TTY 등)
       try {
         cp.spawnSync('chcp.com', ['65001'], { encoding: 'utf8', timeout: 2000, shell: true, stdio: 'ignore' });
         process.env._LEERNESS_AUTOCHCP_APPLIED = String(code);  // 진단용 — handoff body 에서 노출
@@ -55,7 +38,21 @@ if (!/--no-deprecation/.test(process.env.NODE_OPTIONS || '')) {
     }
     process.env._LEERNESS_CHCP_DONE = '1';
   } catch {}
-})();
+}
+// 1.9.184/185: DEP0190 (shell:true) 경고 억제 — cross-platform .cmd resolution 위해 shell:true 의도 사용.
+//   warning listener 제거 + NODE_OPTIONS=--no-deprecation (자식 spawn 까지 전파). CLI 전용 → _cliBootstrap 내부.
+function _cliBootstrap() {
+  process.removeAllListeners('warning');
+  process.on('warning', (w) => {
+    if (w && (w.code === 'DEP0190' || /DEP0190/.test(String(w.message || '')))) return;
+    process.stderr.write(`(node:${process.pid}) ${w.name || 'Warning'}: ${w.message || w}\n`);
+  });
+  if (!/--no-deprecation/.test(process.env.NODE_OPTIONS || '')) {
+    process.env.NODE_OPTIONS = ((process.env.NODE_OPTIONS || '') + ' --no-deprecation').trim();
+  }
+  _ensureStdoutEncoding();
+}
+if (require.main === module) _cliBootstrap();
 
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
@@ -152,6 +149,13 @@ function fail(s) { log('✗ ' + s); }
 // 1.9.287 (Codex 리뷰 수렴): 임베딩 텍스트의 코드펜스(```)를 중립화해 외부 마크다운(session-handoff)이 깨지지 않게.
 //   ``` → ''' (펜스가 아닌 표시), 인라인 백틱은 보존. 순수 함수.
 function _sanitizeFences(s) { return String(s || '').replace(/```+/g, "'''"); }
+// 1.9.289 (Codex gpt-5.5 리뷰 #3 수렴): shell:true spawn 의 인자를 셸-안전하게 인용 — 프롬프트 셸 주입/분리 방지.
+//   POSIX(sh): single-quote (bulletproof). Windows(cmd.exe): double-quote + inner " 이스케이프 (공백/&|<>() 안전).
+function _shellQuoteArg(s) {
+  s = String(s == null ? '' : s);
+  if (process.platform === 'win32') return '"' + s.replace(/"/g, '""') + '"';
+  return "'" + s.replace(/'/g, "'\\''") + "'";
+}
 // 1.9.288 (Codex gpt-5.5 리뷰 #5 수렴): MCP 도구 수 단일 출처 — tools 정의 패턴만 카운트(설명/자기-매칭 오탐 제외).
 //   배지/관리블록/capability 가 모두 이 값을 써서 tools/list 실제 수와 일치.
 function _mcpToolCount() {
@@ -2983,6 +2987,7 @@ function _selfTestCases() {
     { name: '_resolveNpmTag: latest 기본 + next 허용 + 잘못된 형식 폴백 (1.9.275)', run: () => _resolveNpmTag(null, {}) === 'latest' && _resolveNpmTag('next', {}) === 'next' && _resolveNpmTag(null, { LEERNESS_NPM_TAG: 'next' }) === 'next' && _resolveNpmTag('bad tag!', {}) === 'latest' && _resolveNpmTag('Beta', {}) === 'beta' },
     { name: '_sanitizeFences: 코드펜스 중립화 (Codex 수렴 1.9.287)', run: () => { const out = _sanitizeFences('text\n```js\ncode\n```\nmore'); return !/```/.test(out) && /'''/.test(out) && /code/.test(out); } },
     { name: '_mcpToolCount: 실제 도구 정의 수 (자기-매칭 오탐 없음) (Codex #5 1.9.288)', run: () => { const n = _mcpToolCount(); return n >= 75 && n < 200; } },
+    { name: '_shellQuoteArg: 프롬프트 셸 주입 중립화 (Codex #3 1.9.289)', run: () => { const q = _shellQuoteArg('a; rm -rf / && echo x'); if (process.platform === 'win32') return q === '"a; rm -rf / && echo x"' && _shellQuoteArg('a"b') === '"a""b"'; return q === "'a; rm -rf / && echo x'" && _shellQuoteArg("it's") === "'it'\\''s'"; } },
     { name: '_evidenceQuality: 파일+테스트 근거 강제 (Codex 수렴 1.9.287)', run: () => { const good = _evidenceQuality('src/api.js 수정, npm test 12/12 통과 (Exit: 0)'); const weak = _evidenceQuality('테스트 통과함'); const noFile = _evidenceQuality('12 tests passed'); return good.ok === true && good.hasFile && good.hasTest && weak.ok === false && weak.missing.includes('수정 파일 경로') && noFile.ok === false; } },
     { name: '_parseEvidenceStats: review-evidence pass/fail 집계 (1.9.286)', run: () => { const s = _parseEvidenceStats('## 2026-06-03\nCommand: npm test\nExit: 0\n\n## 2026-06-03\nCommand: build\nExit: 1\n\n## 2026-06-03\nverify PASS 통과\n'); return s.entries === 3 && s.pass === 2 && s.fail === 1 && s.rate === 67; } },
     { name: '_reuseDetect: 키워드→OSS 카테고리 + 체크리스트 (1.9.285)', run: () => { const a = _reuseDetect('JWT 인증 구현'); const b = _reuseDetect('날짜 포맷 date'); const c = _reuseDetect('전혀무관한xyzzy'); return a.some(x => x.key === 'auth') && b.some(x => x.key === 'date') && c.length === 0 && REUSE_CHECKLIST.length >= 5 && REUSE_CATEGORIES.length >= 12; } },
@@ -2991,6 +2996,7 @@ function _selfTestCases() {
     { name: 'ADAPTERS + _mcpJsonContent: 도구 매핑 + .mcp.json 등록 (1.9.280)', run: () => { const ids = Object.keys(ADAPTERS); const okMap = ['claude','cursor','codex','goose','opencode'].every(id => ADAPTERS[id] && Array.isArray(ADAPTERS[id].keys) && ADAPTERS[id].keys.length); const m = JSON.parse(_mcpJsonContent()); return ids.length >= 9 && okMap && ADAPTERS.claude.mcp === true && ADAPTERS.copilot.mcp === false && m.mcpServers.leerness.command === 'npx' && m.mcpServers.leerness.args.join(' ') === 'leerness mcp serve'; } },
     { name: '_newRunRecord: GPT-5.5 권고 스키마 14필드 + 기본값 (1.9.278)', run: () => { const r = _newRunRecord({ run_id: 'run-0001', goal: 'g', started_at: '2026-06-03T00:00:00Z' }); return r.schemaVersion === 1 && r.run_id === 'run-0001' && r.started_at === '2026-06-03T00:00:00Z' && Array.isArray(r.files_changed) && Array.isArray(r.commands_run) && Array.isArray(r.tests_run) && Array.isArray(r.decisions) && r.verification_result === null && r.status === 'in-progress' && 'handoff_summary' in r && 'model_name' in r && 'task_id' in r; } },
     { name: 'coreFiles --minimal: 핵심 유지 + 비핵심 제외 + verify 필수 보존 (1.9.276)', run: () => { const full = coreFiles('.', 'ko', []); const min = coreFiles('.', 'ko', [], { minimal: true }); const keep = ['.harness/plan.md','.harness/progress-tracker.md','.harness/session-handoff.md','AGENTS.md','CLAUDE.md','.harness/consistency-policy.md','.harness/reuse-map.md','.harness/encoding-policy.md','.harness/secret-policy.md']; const drop = ['.cursor/rules/leerness.mdc','.harness/skill-index.md','.harness/architecture.md']; const verifyReq = ['.harness/design-system.md','.harness/protected-files.md','.harness/current-state.md']; if (!verifyReq.every(k => min[k])) return false; return Object.keys(min).length < Object.keys(full).length && keep.every(k => min[k]) && drop.every(k => !min[k]); } },
+    { name: '_cliBootstrap: CLI 부작용 require.main 가드 격리 (Codex #4 UR-0037 1.9.290)', run: () => { if (typeof _cliBootstrap !== 'function' || typeof _ensureStdoutEncoding !== 'function') return false; const src = read(__filename); const guarded = /if \(require\.main === module\) _cliBootstrap\(\);/.test(src); const inFn = /function _cliBootstrap\(\)\s*\{[\s\S]*?removeAllListeners\('warning'\)[\s\S]*?NODE_OPTIONS[\s\S]*?_ensureStdoutEncoding\(\);[\s\S]*?\n\}/.test(src); const noTopIife = !/\}\)\(\);\s*\n\n\/\/ 1\.9\.184/.test(src); return guarded && inFn && noTopIife; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -17522,8 +17528,9 @@ async function _cliChatStream(root, provider, promptText, opts) {
     args = ['exec', '--skip-git-repo-check', '-'];  // - = stdin from claude/codex convention
     useStdinForPrompt = true;
   }
-  else if (provider === 'agy')  { cmd = 'agy'; args = ['-p', promptText]; }  // agy -p 는 인자 모드만 지원
-  else if (provider === 'copilot') { cmd = 'gh';     args = ['copilot', 'suggest', promptText]; }
+  // 1.9.289 (Codex #3): agy/copilot 은 인자 모드만 지원 → shell:true 조인 시 프롬프트가 분리/주입될 수 있어 _shellQuoteArg 로 안전 인용.
+  else if (provider === 'agy')  { cmd = 'agy'; args = ['-p', _shellQuoteArg(promptText)]; }  // agy -p 는 인자 모드만 지원
+  else if (provider === 'copilot') { cmd = 'gh';     args = ['copilot', 'suggest', _shellQuoteArg(promptText)]; }
   else return { ok: false, error: `provider ${provider} 미지원`, provider };
   const t0 = Date.now();
   return new Promise(resolve => {
@@ -21649,5 +21656,7 @@ module.exports = {
   // 1.9.287: evidence 완전성 + 코드펜스 sanitize (Codex 리뷰 수렴) — 단위 테스트
   _evidenceQuality, _sanitizeFences,
   // 1.9.288: MCP 도구 수 단일 출처 (Codex #5) — 단위 테스트
-  _mcpToolCount
+  _mcpToolCount,
+  // 1.9.289: shell-safe 인용 (Codex #3) — 단위 테스트
+  _shellQuoteArg
 };

package/package.json

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

package/scripts/e2e.js

@@ -3079,5 +3079,41 @@ total++;
   if (!ok) { failed++; console.log((rRel.stdout || '').slice(0, 300)); }
 }
 
+// 1.9.289 회귀 (Codex #3): _shellQuoteArg — REPL agy/copilot 프롬프트 셸 주입 중립화
+total++;
+{
+  let ok = false;
+  try {
+    const h = require(path.resolve(__dirname, '..', 'bin', 'harness.js'));
+    const q = h._shellQuoteArg('a; rm -rf / && echo $(whoami)');
+    const win = process.platform === 'win32';
+    // 따옴표로 감싸 메타문자가 단일 리터럴 인자가 됨 (POSIX 단일/Windows 이중)
+    const wrapped = win ? (q.startsWith('"') && q.endsWith('"')) : (q.startsWith("'") && q.endsWith("'"));
+    const neutral = win ? !/^[^"]*[;&|][^"]*$/.test(q.slice(1, -1)) || q.includes('"') : true;
+    ok = wrapped && q.includes('rm -rf') && typeof h._shellQuoteArg === 'function';
+  } catch {}
+  console.log(ok ? '✓ B(1.9.289) _shellQuoteArg: 프롬프트 셸 주입 중립화 (agy/copilot args)' : '✗ _shellQuoteArg 실패');
+  if (!ok) failed++;
+}
+
+// 1.9.290 회귀 (Codex #4 UR-0037): require('harness') 가 호스트 프로세스 오염 X (top-level side effect 격리)
+total++;
+{
+  let ok = false;
+  try {
+    // 깨끗한 자식에서: 내 warning listener 등록 → require → 보존 확인 + NODE_OPTIONS 미변경
+    const probe = "const L=()=>{};process.on('warning',L);const o=process.env.NODE_OPTIONS||'';" +
+      "require(process.argv[1]);" +
+      "const survived=process.listeners('warning').includes(L);" +
+      "const polluted=(process.env.NODE_OPTIONS||'')!==o;" +
+      "process.exit(survived&&!polluted?0:1);";
+    const harnessPath = path.resolve(__dirname, '..', 'bin', 'harness.js');
+    const r = cp.spawnSync(process.execPath, ['-e', probe, harnessPath], { encoding: 'utf8', timeout: 20000 });
+    ok = r.status === 0;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.290) require 부작용 격리: warning listener 보존 + NODE_OPTIONS 미오염 (Codex #4)' : '✗ require 부작용 격리 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);