leerness 1.9.445 → 1.11.0

package/CHANGELOG.md

@@ -1,5 +1,165 @@
 # Changelog
 
+## 1.11.0 — 2026-06-08 — 🛡️ [안정화/Stable] CLI 견고성 + --json 에이전트 계약 안정 minor
+
+**🛡️ 안정화(Stable) minor — 13번째 멀티에이전트 버그헌트로 발견·수정한 patch(1.10.1~1.10.5)를 검증·통합해 npm 에 안정 공개.** R-0011 배포 정책의 2번째 minor 릴리스.
+
+### 이번 minor 에 담긴 개선 (1.10.1~1.10.5, 그동안 GitHub 에만 누적)
+- **시크릿 스캐너 정밀화** (UR-0144): AWS 공식 예제키 `AKIA…EXAMPLE`(접미사) 오탐 차단, 중간 example 실키는 보존(FN 정책 유지).
+- **--json 에이전트 계약 하드닝** (UR-0146/0173/0174): `init --json` 순수 JSON(배너/진행바/대화 메뉴 억제, io quiet 모드) + `scan secrets`/`encoding check`/`lazy detect`/`deps` 잘못된 경로 구조화 에러(`failJson`, exit 1).
+- **정직성·견고성** (UR-0167): `session close <파일>` 가 실패를 성공(exit 0)으로 오판하던 문제 → 구조화 에러 + exit 1.
+- **CLI 인자 견고성** (UR-0169): `arg()` 가 값 없이 끝나면 `true` 누출 / 다음 `--flag` 흡수하던 문제 → def 반환(음수값 보존).
+- **표·출력 안전화** (UR-0170/0168/0171): plan drop 표셀 `_cellSafe`, handoff --json 배너 억제, env encoding-check positional 디렉토리 존중.
+
+### 검증 (회귀 0)
+- **selftest 201 PASS** · **E2E 365/365 PASS** · npm gate=minor_bump(배포) 확인. 13번째 버그헌트 8건 중 7건 수정 + 2건 by-design(UR-0142 intent classify, audit --fix).
+
+### 안정화 표시 (R-0006)
+CHANGELOG [안정화/Stable] · git tag annotation (Stable) · GitHub release (Stable) · npm dist-tag `stable` 시도.
+
+## 1.10.5 — 2026-06-08 — arg() 플래그 흡수 방지 + handoff --json 배너 억제 (13th 버그헌트 잔여, UR-0168/0169)
+
+**🧰 CLI 인자 견고성 + --json 순수성 마무리.**
+
+### 변경
+- **arg() 값 플래그 흡수 방지** (UR-0169, P3): `arg(name)` 가 값 없이 끝나면 boolean `true` 를 누출(`--reason` 가 plan.md 에 'true' 기록)하거나, 다음 토큰이 `--flag` 면 그것을 값으로 흡수(`--target --path` → target='--path')하던 문제 → 다음 토큰이 없거나 `--` 장식 플래그면 `def` 반환. **음수 값(`--x -5` 등 단일 `-`)은 보존**.
+- **handoff --json 미-init 배너 억제** (UR-0168, P2): `handoff --json` 이 미-init 디렉토리에서 사람용 "init 미실행" 경고를 JSON 앞에 출력(비-JSON)하던 문제 → `--json` 시 배너 억제(순수 JSON).
+
+### 검증 (회귀 0)
+- **selftest 199→201** (arg: 흡수방지+음수보존+정상값, handoff 배너 와이어), 행위 재현: `export --target --path` 미흡수, `--reason`(끝) true 누출 없음, `handoff --json` 미-init 순수 JSON.
+- arg() 는 코어 함수 → **E2E 365 전수**가 회귀 안전망. patch(1.10.5, 같은 minor) — R-0011 정책상 npm 미배포. (13th 잔여: UR-0172 시크릿 prefix FP — FN 회귀 위험으로 신중 검토 예정)
+
+## 1.10.4 — 2026-06-08 — 13번째 버그헌트 후속 P2/P3 클러스터 (UR-0167/0170/0171)
+
+**🐛 정직성·견고성: 실패 오판 + 표 손상 + 무시되던 인자 수정.**
+
+### 변경
+- **session close 디렉토리 가드** (UR-0167, P2-정직성): `session close <파일경로>` 가 `mkdir <path>/.harness` 에서 ENOTDIR 크래시 + **exit 0(실패를 성공으로 오판)** 하던 문제 → 경로 없음/디렉토리 아님이면 `failJson(code:'path_not_found')` + exit 1.
+- **plan drop 표셀 안전화** (UR-0170, P3): `plan drop` 의 text/`--reason` 에 든 파이프(`|`)·개행이 plan.md 마크다운 표 칼럼을 깨뜨리던 문제 → `_cellSafe`(task/rule UR-0104 와 동일, round-trip 가능) 적용.
+- **env encoding-check positional 디렉토리** (UR-0171, P3): `env encoding-check <dir>` 가 positional 인자를 무시하고 cwd 를 스캔(→ 잘못된 디렉토리 false 'no risk') 하던 문제 → 형제 `env check/sync/detect` 와 동일하게 positional 존중.
+
+### 검증 (회귀 0)
+- **selftest 198→199**, 행위 재현: session close 파일경로 → exit 1 + JSON, plan drop 파이프 → `\|` escape(round-trip OK), env encoding-check `<dir>` → scanned 정상.
+- patch(1.10.4, 같은 minor) — R-0011 정책상 npm 미배포, GitHub 만 갱신. (13th 잔여: UR-0168 handoff 배너 · UR-0169 arg 값흡수 · UR-0172 시크릿 prefix FP)
+
+## 1.10.3 — 2026-06-08 — --json 순수성 하드닝 (13번째 멀티에이전트 버그헌트, UR-0173/0174)
+
+**🤖 에이전트 계약 강화: `--json` 이 항상 기계 파싱 가능한 출력만 내도록.**
+
+### 변경
+- **init --json TTY 누출 차단** (UR-0173, 1.10.2 회귀): 인터랙티브 터미널에서 `init --json` 이 배너/진행바/언어선택 메뉴를 JSON 앞에 출력하던 문제 → 배너·진행바(`isTty`)에 `!opts.json` 게이트 + `nonInteractive` 적용. 비-TTY(파이프/CI)는 기존에도 정상.
+- **walk 기반 스캐너 --json 경로 오류 구조화** (UR-0174): `scan secrets` / `encoding check` / `lazy detect` 가 없는/파일 경로에서 `walk()` throw → 사람용 `✗ ENOENT/ENOTDIR` 텍스트(비-JSON)를 뱉던 문제 → `status()` 패턴(path 가드 + `failJson(code:'path_not_found')`, exit 1) 통일.
+- **deps --json 인자누락 구조화** (UR-0174): `deps --json` 의 capability 누락이 사람용 텍스트 → `failJson(code:'missing_arg')`.
+
+### 13번째 버그헌트 — 후속 등록 (이번 미수정, 백로그)
+- UR-0167 session close --json 파일경로 exit 0 오판 · UR-0168 handoff --json 미-init 배너 누출 · UR-0169 arg() 값없는 플래그 흡수 · UR-0170 plan drop 파이프 표 깨짐 · UR-0171 env encoding-check positional 무시 · UR-0172 시크릿 prefix+단어 placeholder FP(검토).
+
+### 검증 (회귀 0)
+- **selftest 196→198** (4종 --json 구조화 에러 spawn 검증 + init 게이트 와이어), 행위 재현: 4종 모두 `{ok:false,code}` exit 1, init --json TTY 순수 JSON.
+- patch(1.10.3, 같은 minor) — R-0011 정책상 npm 미배포, GitHub 만 갱신.
+
+## 1.10.2 — 2026-06-08 — init --json 순수 JSON 출력 (12th 외부평가 Codex P3, UR-0146)
+
+**🤖 `init --json` 이 사람용 출력 대신 순수 JSON 요약 1개 — AI 에이전트가 JSON.parse 가능.**
+
+### 변경
+- `leerness init --json` 이 기존엔 `--json` 을 silent ignore 하고 배너+15줄 사람용 로그를 출력 → 이제 **순수 JSON 요약**: `{ ok, action:'init', version, path, harnessFiles, dryRun, minimal }`.
+- io 에 **quiet 모드(`setQuiet`)** 추가 — `log/ok/warn`(사람용)만 묵음, `fail/failJson`(오류)은 항상 노출. init(install) 큰 핸들러 내부 다중 log 게이팅(침투적) 없이 비침투적 묵음.
+- init 디스패치가 `--json` 시 `setQuiet(true)` → install → `finally setQuiet(false)` → JSON 1개 emit (배너/공지 누출 0).
+
+### 검증 (회귀 0)
+- **selftest 195→196** (setQuiet: log/ok 묵음 + fail 노출 + 와이어), 행위 재현: `init --json` → 파싱 가능 JSON, 배너 누출 없음.
+- patch(1.10.2, 같은 minor) — R-0011 정책상 npm 미배포, GitHub 만 갱신.
+
+## 1.10.1 — 2026-06-08 — 시크릿 스캐너 AWS …EXAMPLE 키 오탐 수정 (12th 외부평가 Opus P3, UR-0144)
+
+**🔒 AWS 공식 예제키(AKIA…EXAMPLE) 오탐 차단 — 실키 FN 정책은 보존.**
+
+### 변경
+- `_isPlaceholderSecret`: 값이 **'example' 로 끝나면(접미사)** placeholder 로 판정 — AWS 문서 표준 예제키 `AKIAIOSFODNN7EXAMPLE` 등 오탐(FP) 차단.
+- **중간에 'example' 이 있는 실키**(`sk-EXAMPLEab12…`, `sk-proj-realKEYexample…`)는 접미사가 아니라 미해당 → 실키-FN 정책(UR-0105) 보존. 실키가 'example' 로 끝날 확률 0.
+- 직전 시도(1.9.440)에서 'example' 통째 매칭이 FN 정책과 충돌해 보류했던 것을 접미사 한정으로 정밀 해결.
+
+### 함께 종결 (코드 변경 없음)
+- **UR-0142** intent classify 항상 default → **by-design**: intent classify 는 precise/broad scope 분류이며 default 는 scope 신호 없는 입력의 정상 중립 결과(맹신 X 직접 재현: "정확히"→precise, "전체 다양한"→broad). 리뷰의 task-type 기대는 오해.
+
+### 검증 (회귀 0)
+- **selftest 194→195** (AWS EXAMPLE placeholder + 중간 example 실키 real + 진짜키 탐지), 기존 FN 정책 셀프테스트(UR-0106/0109) 유지.
+- patch(1.10.1, 같은 minor) — R-0011 정책상 npm 미배포, GitHub 만 갱신.
+
+## 1.10.0 — 2026-06-08 — 🛡️ [안정화/Stable] 1.10 안정 minor (배포 정책 첫 minor 릴리스)
+
+**🛡️ 안정화(Stable) minor — patch 누적(1.9.446~449)을 검증·통합해 npm 에 안정 버전으로 공개.** R-0011 배포 정책(patch 는 누적, minor 만 npm 공개)의 첫 minor 릴리스.
+
+### 이번 minor 에 담긴 개선 (1.9.446~449, 그동안 GitHub 에만 누적)
+- **npm 배포 minor-gate** (UR-0160): patch 는 npm 미배포, minor/major 변동 시에만 안정 배포. `release sync-main . --publish-npm` 강제 옵션.
+- **plan progress 읽기전용 요약** (UR-0145): 완료율% + 상태별 + `--json` + 변경의도 인자 경고(silent ignore 제거).
+- **export/prompt = adapter 별칭** (UR-0154, GPT-5.5 §6.6): `export --target claude|cursor|codex|agents-md`.
+- **plan drop 역할 분리** (UR-0143): scope 드랍을 plan.md(Out of Scope)에만 기록, progress-tracker phantom task 제거.
+
+### 직전 안정(1.9.x)부터의 핵심 (참고)
+- evidence-first 완료 게이트 `completion_claim_allowed` (UR-0153, GPT-5.5 §6.3), CI/PR 턴키 `ci init` (UR-0152, §6.7), task/add-family positional path (UR-0141/0151), 시크릿 스캐너 prefix placeholder 가드(12th 리뷰 Opus P2), README ASCII 배너.
+
+### 검증 (회귀 0)
+- **selftest 194 PASS** · **E2E 365/365 PASS** · npm gate=minor_bump(배포) 확인.
+
+### 안정화 표시 (R-0006)
+CHANGELOG [안정화/Stable] · git tag annotation (Stable) · GitHub release (Stable) · npm dist-tag `stable` 시도.
+
+## 1.9.449 — 2026-06-08 — plan drop: progress-tracker T- 행 미생성 (12th 외부평가 Sonnet P3, UR-0143)
+
+**🐛 plan↔progress 역할 분리: scope 드랍이 phantom task 를 만들던 문제.**
+
+### 변경
+- `plan drop` 이 progress-tracker 에 `dropped` 상태의 `T-` task 행을 만들던 동작 제거 — 이제 plan.md `## Out of Scope / Dropped`(D-) 에만 기록. scope 드랍의 단일 출처 = plan.md.
+- 기존엔 scope 드랍 1건이 plan.md D- + progress-tracker T- 양쪽에 생겨 plan↔progress 역할 혼선 + `task list` 노이즈(실제 작업 아닌 phantom T-) 발생.
+
+### 검증 (회귀 0)
+- **selftest 193→194** (planDrop 에 dropped-task upsert 없음 + ok 메시지가 plan.md 가리킴), 행위 재현: plan drop → D-0001 기록 + progress T- 행 미증가.
+- patch(1.9.449, 같은 minor) — R-0011 정책상 npm 미배포, GitHub 만 갱신.
+
+## 1.9.448 — 2026-06-08 — export/prompt = adapter 별칭 (GPT-5.5 전략리뷰 §6.6/7.3, UR-0154)
+
+**🔌 GPT-5.5 권고 표면명 정합: `leerness export/prompt --target <agent>`.**
+
+### 변경
+- 신규 `export --target <agent>` / `prompt --target <agent>` — 기존 `adapter <tool>` 의 별칭(도구별 지침/계약 파일 생성: claude/cursor/codex/copilot/goose). `--target` 플래그 또는 positional 모두 지원, 미지정 시 list.
+- `agents-md`/`agents`/`agent` → `codex`(AGENTS.md 생성) 별칭 매핑 — GPT-5.5 가 권고한 `export --target agents-md` 가 그대로 동작.
+- GPT-5.5 전략리뷰가 권고한 명령 표면명(`export`/`prompt --target`)을 기존 adapter 위에 제공 → 외부 사용자 발견성↑.
+
+### 검증 (회귀 0)
+- **selftest 192→193** (와이어), 행위 재현: `export --target claude`→CLAUDE.md, `export --target agents-md`→AGENTS.md.
+- patch(1.9.448, 같은 minor) — R-0011 정책상 npm 미배포, GitHub 만 갱신.
+
+### 보류 메모
+- UR-0146(init --json 순수화): init=install 큰 핸들러의 다중 log(~15) quiet-mode 게이팅 필요 — P3 대비 침투적이라 quiet-mode 리팩터 라운드로 보류. audit --fix --json 의 fixApplied(=fix모드)/fixed(=카운트)는 의미상 일관(by-design).
+
+## 1.9.447 — 2026-06-08 — plan progress 읽기전용 요약 명확화 (12th 외부평가 Codex P3, UR-0145)
+
+**🐛 명령명-동작 불일치 해소: `plan progress` 가 인자를 silent ignore 하던 문제.**
+
+### 변경
+- `plan progress` 를 읽기 전용 진행 요약으로 명확화 — **완료율%**(done/total) + 상태별 카운트 + 마일스톤 수 출력. `--json` 구조화 지원.
+- `plan progress M-0002 --status … --progress …` 처럼 변경 의도 인자가 오면 **읽기 전용임을 경고**(기존: silent ignore) — 상태/진행 변경은 `task update`/`plan add|drop` 안내.
+- 기존엔 task status 카운트만 출력하며 명령명이 milestone 변경처럼 오인됨.
+
+### 검증 (회귀 0)
+- **selftest 191→192** (richer 출력 + --json + 변경의도 경고 와이어), 행위 재현: 완료율 1/3(33%)·--json(total/done/percent)·M-id+--status 시 경고.
+- patch(1.9.447, 같은 minor) — R-0011 정책상 npm 미배포, GitHub 만 갱신.
+
+## 1.9.446 — 2026-06-08 — npm 배포 minor-gate (R-0011/UR-0160)
+
+**📦 배포 정책 도구화: npm 배포는 minor(x.x) 변동 시에만 — patch(x.x.x) 는 자동 스킵.**
+
+### 변경
+- 순수 `_shouldPublishNpm(current, published, force)` + `_minorKey` (pure-utils): npm latest 와 major.minor 비교 → minor/major ↑ 면 배포, 같은 minor 내 patch 면 스킵. 최초/force 는 배포.
+- `_publishToNpm` 에 minor-gate 추가(1.5단계): `npm view <pkg> version` 으로 latest 확인 후, 같은 minor patch 면 npm publish 스킵(GitHub 커밋·CHANGELOG 는 유지). `release sync-main . --publish-npm` 으로 강제 배포.
+- 사용자 정책(R-0011): 자잘한 patch 는 npm 미배포로 누적, 안정화되면 minor 올려 안정 버전만 npm 노출 → npm latest 안정성 향상.
+
+### 검증 (회귀 0)
+- **selftest 190→191** (순수 7케이스 + 와이어): 1.9.446 vs 1.9.445=스킵(same_minor), 1.10.0=배포(minor_bump), 2.0.0=배포, force/최초=배포.
+- 본 패치(1.9.446)부터 정책 적용 — npm 미배포(같은 minor), GitHub 만 갱신.
+
 ## 1.9.445 — 2026-06-08 — add-family positional path 일관화 (UR-0151, UR-0141 후속)
 
 **🐛 데이터 오염 일관화: `decision/lesson/rule add` 도 positional path 인식 (task 와 동일).**

package/README.md

@@ -168,7 +168,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.445 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.11.0 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -222,7 +222,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.445는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
+Leerness v1.11.0는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **85개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -243,7 +243,7 @@ Leerness v1.9.445는 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.445)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.11.0)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -281,6 +281,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.445: 2026-06-08
+Last synced by Leerness v1.11.0: 2026-06-08
 <!-- leerness:project-readme:end -->
 

package/bin/leerness.js

@@ -4,7 +4,7 @@
 const fs = require('fs');
 const path = require('path');
 const cp = require('child_process');
-const { log, ok, warn, fail, failJson, today, now, absRoot, exists, read, readBuf, mkdirp, writeUtf8, append, rel } = require('../lib/io');  // 1.9.382/383 (UR-0025): 출력/시간/파일 프리미티브 공유 모듈
+const { log, ok, warn, fail, failJson, setQuiet, today, now, absRoot, exists, read, readBuf, mkdirp, writeUtf8, append, rel } = require('../lib/io');  // 1.9.382/383 (UR-0025): 출력/시간/파일 프리미티브 공유 모듈 · 1.10.2 (UR-0146): setQuiet
 const os = require('os');  // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
 const readline = require('readline');
 // 1.9.274 (UR-0025 1단계): 순수 유틸 함수 모듈 분리 (require-based, 비파괴). selftest 7종이 동작 검증.
@@ -25,13 +25,13 @@ const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _merg
   _withBuiltinSource, _esc, _roadmapTokenStyles, _parseSkillMd,
   _migrationGuideText, _parseContractSpec, _gitignoreMatch,
   _featureGraphTemplate, _parseFeatureGraph, _nextFeatureId, _featureBlock, _featureImpactBfs,
-  _parseChangelogBetween, _cellSafe, _cellUnescape, _lineSafe, _parseLimit, _parseAddTitle, _parseImplExports, _taskPositionalPath, _completionClaimAllowed } = require('../lib/pure-utils');  // 1.9.318~443 (UR-0025/0053/0075/0086/0087/0104/0122/0141/0153): 순수 유틸 모듈 분리
+  _parseChangelogBetween, _cellSafe, _cellUnescape, _lineSafe, _parseLimit, _parseAddTitle, _parseImplExports, _taskPositionalPath, _completionClaimAllowed, _minorKey, _shouldPublishNpm } = require('../lib/pure-utils');  // 1.9.318~446 (UR-0025/.../0153/0160): 순수 유틸 모듈 분리
 // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
 const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS, BUILTIN_CATALOG, ROADMAP_STATUS_LABEL, ROADMAP_STATUS_COLOR, SECRET_PATTERNS, MERGE_OVERWRITE_FILES, MINIMAL_SKIP_KEYS, REQUIRED_WORKSPACE_FILES, KEYWORD_STOPWORDS, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344/368/369 (UR-0025): catalog 분리 (MERGE_OVERWRITE_FILES/MINIMAL_SKIP_KEYS 포함)
 
-const VERSION = '1.9.445';
+const VERSION = '1.11.0';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -202,7 +202,11 @@ function _getAutoLoopRule(root) {
 }
 function arg(name, def = null) {
   const i = process.argv.indexOf(name);
-  if (i >= 0) return process.argv[i + 1] || true;
+  if (i >= 0) {
+    // 1.10.5 (13th 버그헌트 P3, UR-0169): 값 없음(끝) 또는 다음 토큰이 --장식플래그면 def 반환 — 기존 `argv[i+1] || true` 는 다음 --flag 를 값으로 흡수하거나 boolean true 를 누출(예: --reason 가 'true' 기록)했음. 음수값(-5 등 단일 -)은 값으로 보존.
+    const next = process.argv[i + 1];
+    return (next != null && !next.startsWith('--')) ? next : def;
+  }
   const eq = process.argv.find(a => a.startsWith(name + '='));  // --name=value 형태 (외부리뷰 CV-1/UR-0076)
   return eq ? eq.slice(name.length + 1) : def;
 }
@@ -930,7 +934,7 @@ async function install(root, opts = {}) {
     }
   } catch {}
   // 1.9.32: init 시 ASCII 배너 + 빠른 시작 가이드 (migrate는 quiet)
-  if (!opts.migration && !has('--no-banner')) _banner({ quickStart: !opts.dry });
+  if (!opts.migration && !has('--no-banner') && !opts.json) _banner({ quickStart: !opts.dry });  // 1.10.3 (UR-0173): --json 시 배너 억제(순수 JSON)
   // 1.9.33: npx 캐시로 옛 버전이 실행될 때 경고 (migrate/--no-stale-check 시 스킵)
   // 1.9.276: dry-run 시 스킵 — 캐시 파일(.harness/cache) 생성 방지 (dry = 부작용 0 보장)
   if (!opts.migration && !has('--no-stale-check') && !opts.nonInteractive && !opts.dry) {
@@ -973,7 +977,7 @@ async function install(root, opts = {}) {
   // 1.9.184 (사용자 명시): 파일 설치 — 생성 목록 나열 X, 로딩바 + 단일 완료 메시지.
   const actions = [];
   const totalFiles = Object.keys(files).length;
-  const isTty = process.stdout.isTTY && !opts.dry;
+  const isTty = process.stdout.isTTY && !opts.dry && !opts.json;  // 1.10.3 (UR-0173): --json 시 진행바/완료메시지 억제(순수 JSON)
   const drawProgress = (done, file) => {
     if (!isTty) return;
     const pct = Math.round(done * 100 / totalFiles);
@@ -3366,6 +3370,105 @@ function _selfTestCases() {
         && m._taskPositionalPath(['rule', 'add', '룰', '--trigger', 'every-update'], 2) === null;
       return rule && lesson && decision && trig;
     } },
+    { name: 'R-0011/UR-0160: npm 배포 minor-gate _shouldPublishNpm + _publishToNpm 와이어 (1.9.446)', run: () => {
+      const m = require('../lib/pure-utils');
+      if (typeof m._shouldPublishNpm !== 'function' || m._shouldPublishNpm !== _shouldPublishNpm) return false;
+      const f = m._shouldPublishNpm;
+      const pure = f('1.9.446', '1.9.445', false).publish === false                 // 같은 minor patch → 미배포
+        && f('1.9.446', '1.9.445', false).reason === 'same_minor'
+        && f('1.10.0', '1.9.445', false).publish === true                            // minor ↑ → 배포
+        && f('1.10.0', '1.9.445', false).reason === 'minor_bump'
+        && f('2.0.0', '1.9.445', false).publish === true                             // major ↑ → 배포
+        && f('1.9.446', '1.9.445', true).publish === true                            // force → 배포
+        && f('1.9.0', null, false).publish === true                                  // 최초 → 배포
+        && m._minorKey('1.9.445') === '1.9' && m._minorKey('1.10.0') === '1.10';
+      const src = read(__filename);
+      const wired = src.includes('const gate = _shouldPublishNpm(pkgVersion, publishedLatest, false);')
+        && src.includes("forcePublish: has('--publish-npm')");
+      return pure && wired;
+    } },
+    { name: '12th 외부평가 Codex P3 (UR-0145): plan progress 읽기전용 요약(완료율%/--json) + 변경의도 인자 경고 (1.9.447)', run: () => {
+      const src = read(__filename);
+      const richer = src.includes('const percent = total ? Math.round((done / total) * 100) : 0;') && src.includes("log(`# plan progress (읽기 전용 요약)`);");
+      const jsonOut = src.includes("log(JSON.stringify({ ok: true, total, done, percent, milestones, counts }, null, 2)); return;");
+      const intentWarn = src.includes('if (opts.updateIntent) warn(') && src.includes("updateIntent: args.slice(2).some(a => /^M-\\d/i.test(a)) || has('--status') || arg('--progress', null) != null");
+      return richer && jsonOut && intentWarn;
+    } },
+    { name: 'GPT-5.5 전략리뷰 §6.6 (UR-0154): export/prompt = adapter 별칭 (--target + agents-md→codex) (1.9.448)', run: () => {
+      const src = read(__filename);
+      const wired = src.includes("if (cmd === 'export' || cmd === 'prompt') {")
+        && src.includes("arg('--target', null)")
+        && src.includes("'agents-md': 'codex'")
+        && src.includes('return adapterCmd(arg(\'--path\', process.cwd()), _xTool);');
+      return wired;
+    } },
+    { name: '12th 외부평가 Sonnet P3 (UR-0143): plan drop 은 plan.md(D-)만 기록, progress-tracker T- 행 미생성 (1.9.449)', run: () => {
+      const src = read(__filename);
+      // planDrop 에서 upsertProgress(dropped task) 제거 + ok 메시지가 plan.md 가리킴
+      const noTaskRow = !/function planDrop[\s\S]*?upsertProgress\(root, \{ id: tid, status: 'dropped'/.test(src);
+      const dropsToPlan = src.includes("ok(`plan dropped: ${id} → .harness/plan.md (Out of Scope / Dropped)`);");
+      return noTaskRow && dropsToPlan;
+    } },
+    { name: '12th 외부평가 Opus P3 (UR-0144): AWS …EXAMPLE 접미사 placeholder + 중간 example 실키 FN 보존 (1.10.1)', run: () => {
+      const m = require('../lib/pure-utils'); const f = m._isPlaceholderSecret;
+      return f('AKIAIOSFODNN7EXAMPLE') === true
+        && f('sk-EXAMPLEab12cd34ef56gh78ij90kl') === false
+        && f('sk-proj-realKEYexample9988776655') === false
+        && f('AKIAJQXMP7RZ2KL9WXYZ') === false
+        && read(path.join(path.dirname(__filename), '..', 'lib', 'pure-utils.js')).includes('if (/example$/.test(v)) return true;');
+    } },
+    { name: '12th 외부평가 Codex P3 (UR-0146): init --json 순수 JSON(quiet 모드) + 오류는 quiet 무시 (1.10.2)', run: () => {
+      const io = require('../lib/io');
+      if (typeof io.setQuiet !== 'function') return false;
+      // quiet 면 log/ok/warn 묵음, fail/failJson 은 노출
+      let out = ''; const _w = process.stdout.write; process.stdout.write = s => { out += s; return true; };
+      let quietLogSuppressed, failShown;
+      try { io.setQuiet(true); io.log('HUMAN'); io.ok('OK'); quietLogSuppressed = !/HUMAN|OK/.test(out); out = ''; io.fail('ERR'); failShown = /ERR/.test(out); }
+      finally { io.setQuiet(false); process.stdout.write = _w; process.exitCode = 0; }
+      const src = read(__filename);
+      const wired = src.includes("setQuiet(true);") && src.includes("action: 'init', version: VERSION, path: _initRoot, harnessFiles");
+      return quietLogSuppressed && failShown && wired;
+    } },
+    { name: '13th 버그헌트 P2 (UR-0174): scan secrets/encoding check/lazy detect/deps --json 잘못된경로 구조화 에러 (1.10.3)', run: () => {
+      const cp = require('child_process'); const osm = require('os');
+      const bad = path.join(osm.tmpdir(), '__leerness_nope_' + process.pid);
+      const isJson = (a) => { const r = cp.spawnSync(process.execPath, [__filename, ...a], { encoding: 'utf8' }); if (r.status !== 1) return false; try { const j = JSON.parse((r.stdout || '').trim()); return j.ok === false && !!j.code; } catch { return false; } };
+      return isJson(['scan', 'secrets', '--path', bad, '--json'])
+        && isJson(['lazy', 'detect', '--path', bad, '--json'])
+        && isJson(['encoding', 'check', '--path', __filename, '--json']);  // 파일 경로(디렉토리 아님)
+    } },
+    { name: '13th 버그헌트 P2 (UR-0173): init --json 배너/진행바/대화 억제 와이어 (1.10.3)', run: () => {
+      const src = read(__filename);
+      return src.includes("!has('--no-banner') && !opts.json")
+        && src.includes('process.stdout.isTTY && !opts.dry && !opts.json')
+        && src.includes('{ ..._initOpts, json: true, nonInteractive: true }');
+    } },
+    { name: '13th 버그헌트 P2/P3 (UR-0167/0170/0171): session close 디렉토리 가드 + plan drop _cellSafe + env encoding-check positional (1.10.4)', run: () => {
+      const scSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'session-close.js'));
+      const sc = scSrc.includes("!fs.statSync(root).isDirectory()") && scSrc.includes("'path_not_found'");
+      const src = read(__filename);
+      const planSafe = src.includes('const safeText = _cellSafe(text); const safeReason = _cellSafe(reason);') && src.includes('| ${id} | ${safeText} | ${safeReason} |');
+      const envPos = src.includes("(args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd()), args[1] === 'summary' ? null : 'encoding-check')");
+      return sc && planSafe && envPos;
+    } },
+    { name: '13th 버그헌트 P3 (UR-0169): arg() 값없음/다음--플래그 흡수 방지 (음수값 보존) (1.10.5)', run: () => {
+      const save = process.argv;
+      try {
+        process.argv = ['node', 'h', '--target', '--path', '/x'];
+        if (arg('--target', null) !== null) return false;           // 다음 --flag 흡수 X → def
+        process.argv = ['node', 'h', '--reason'];
+        if (arg('--reason', 'D') !== 'D') return false;              // 끝(값없음) → def (true 누출 X)
+        process.argv = ['node', 'h', '--x', '-5'];
+        if (arg('--x', null) !== '-5') return false;                 // 음수값(단일 -)은 보존
+        process.argv = ['node', 'h', '--target', 'claude'];
+        if (arg('--target', null) !== 'claude') return false;       // 정상 값
+        return true;
+      } finally { process.argv = save; }
+    } },
+    { name: '13th 버그헌트 P2 (UR-0168): handoff 미-init 배너 --json 억제 와이어 (1.10.5)', run: () => {
+      const src = read(__filename);
+      return src.includes("!has('--no-init-check') && !has('--json')) {");
+    } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -3945,6 +4048,7 @@ function commandsCmd(root) {
       { cmd: 'state show|start|record|verify|handoff', desc: '.leerness/ JSON 상태 substrate (에이전트 간 인수인계 표준) — 1.9.278' },
       { cmd: 'adapter <tool>|list [--dry-run]', desc: '도구별 지침/.mcp.json 선택 생성 (claude/cursor/codex/goose/...) — 1.9.280' },
       { cmd: 'ci init [path] [--force]', desc: 'PR 마다 leerness gate 실행하는 GitHub Actions 워크플로 생성 (.github/workflows/leerness-gate.yml) — 1.9.444' },
+      { cmd: 'export|prompt --target <agent>', desc: 'adapter 별칭 — 도구별 지침/계약 파일 생성 (claude/cursor/codex/agents-md/...) — 1.9.448' },
       { cmd: 'policy show|set|check', desc: '권한 등급 (read-only…publish) — opt-in enforced (위험 명령 차단) — 1.9.281' },
       { cmd: 'reuse-check "<기능>"', desc: '외부 OSS 빌드 vs 재사용 결정 게이트 (오프라인 카테고리+체크리스트) — 1.9.285' },
       { cmd: 'skill impact', desc: '스킬 설치 영향 경량 상관추적 (사용 빈도 ↔ 검증 통과율, advisory) — 1.9.286' },
@@ -6312,24 +6416,37 @@ function planAdd(root, text) {
 function planDrop(root, text) {
   const id = nextId(root, 'D');
   const reason = arg('--reason', '사용자 요청으로 제외');
+  // 1.10.4 (13th 버그헌트 P3, UR-0170): text/reason 의 파이프(|)·개행이 plan.md 마크다운 표 칼럼을 깨뜨림 → _cellSafe 셀 안전화(task/rule UR-0104 와 동일).
+  const safeText = _cellSafe(text); const safeReason = _cellSafe(reason);
   const planFile = planPath(root); let p = exists(planFile) ? read(planFile) : '';
   const droppedHeader = '## Out of Scope / Dropped';
   if (p.includes(droppedHeader)) {
     p = p.replace(droppedHeader + '\n| ID | Item | Reason | Date |\n|---|---|---|---|\n',
-      droppedHeader + '\n| ID | Item | Reason | Date |\n|---|---|---|---|\n' + `| ${id} | ${text} | ${reason} | ${today()} |\n`);
+      droppedHeader + '\n| ID | Item | Reason | Date |\n|---|---|---|---|\n' + `| ${id} | ${safeText} | ${safeReason} | ${today()} |\n`);
     writeUtf8(planFile, p);
   } else {
-    append(planFile, `\n${droppedHeader}\n| ID | Item | Reason | Date |\n|---|---|---|---|\n| ${id} | ${text} | ${reason} | ${today()} |\n`);
+    append(planFile, `\n${droppedHeader}\n| ID | Item | Reason | Date |\n|---|---|---|---|\n| ${id} | ${safeText} | ${safeReason} | ${today()} |\n`);
   }
-  const tid = nextId(root, 'T');
-  upsertProgress(root, { id: tid, status: 'dropped', request: text, evidence: `drop:${reason}`, nextAction: '없음' });
-  ok(`plan dropped: ${id} → progress: ${tid}`);
+  // 1.9.449 (12th 외부평가 Sonnet P3, UR-0143): progress-tracker 에 dropped task(T-) 행 생성 제거 — plan drop 은 plan.md "Out of Scope / Dropped"(D-) 에만 기록.
+  //   기존엔 scope 드랍이 phantom T- task 로도 생겨 plan↔progress 역할 혼선 + task list 노이즈. 드랍 기록의 단일 출처 = plan.md.
+  ok(`plan dropped: ${id} → .harness/plan.md (Out of Scope / Dropped)`);
 }
-function planProgress(root) {
+function planProgress(root, opts = {}) {
+  // 1.9.447 (12th 외부평가 Codex P3, UR-0145): 읽기 전용 진행 요약 — 완료율%+상태별+마일스톤 수. --json 지원.
+  //   기존엔 task status 카운트만 출력하며 명령명이 milestone 변경처럼 오인됨 + M-id/--status/--progress 를 silent ignore → 변경의도 인자 시 경고.
   const rows = readProgressRows(root);
+  const tasks = rows.filter(r => /^T-/.test(r.id));
   const counts = {}; for (const s of STATUSES) counts[s] = 0;
-  for (const r of rows) if (counts[r.status] != null) counts[r.status]++;
-  log(JSON.stringify(counts, null, 2));
+  for (const r of tasks) if (counts[r.status] != null) counts[r.status]++;
+  const total = tasks.length;
+  const done = counts['done'] || 0;
+  const percent = total ? Math.round((done / total) * 100) : 0;
+  const milestones = rows.filter(r => /^M-/.test(r.id)).length;
+  if (opts.json) { log(JSON.stringify({ ok: true, total, done, percent, milestones, counts }, null, 2)); return; }
+  log(`# plan progress (읽기 전용 요약)`);
+  log(`  완료율: ${done}/${total} (${percent}%)${milestones ? ` · 마일스톤 ${milestones}개` : ''}`);
+  for (const s of STATUSES) if (counts[s]) log(`  ${s}: ${counts[s]}`);
+  if (opts.updateIntent) warn('plan progress 는 읽기 전용 요약입니다 — 상태/진행 변경은 task update <T-ID> --status … 또는 plan add|drop 을 사용하세요.');
 }
 // 1.9.126: plan remove — milestone 블록을 plan.md에서 제거 + archive 보존
 //   Memory Surface DELETE 5종 완전 완성 (task drop / decision drop / lesson drop / rule remove / plan remove)
@@ -7209,6 +7326,8 @@ function _collectSecretFindings(root) {
 
 function scanSecrets(root, opts = {}) {
   root = absRoot(root);
+  // 1.10.3 (13th 버그헌트 P2, UR-0174): 없는 경로에서 --json 비-JSON(ENOENT) 차단 → 구조화 에러. 단 파일 경로는 지원(UR-0072: _collectSecretFindings 가 파일 root 단일 스캔) → 존재성만 검사(디렉토리 강제 X).
+  if (!exists(root)) { failJson(has('--json') || opts.json, 'path_not_found', `경로 없음: ${root}`); return; }
   const { committed, ignored } = _collectSecretFindings(root);
   // 1.9.415 (9th 외부평가 Opus/Codex): --json 일관성 — 기존엔 --json 무시하고 사람용 텍스트만 출력하던 FN.
   if (has('--json') || opts.json) {
@@ -7230,6 +7349,8 @@ function scanSecrets(root, opts = {}) {
 
 function encodingCheck(root, opts = {}) {
   root = absRoot(root);
+  // 1.10.3 (13th 버그헌트 P2, UR-0174): 잘못된 경로(없음/파일)에서 walk() throw → --json 비-JSON 차단.
+  if (!exists(root) || !fs.statSync(root).isDirectory()) { failJson(has('--json') || opts.json, 'path_not_found', `경로 없음 또는 디렉토리 아님: ${root}`); return; }
   let warnings = 0; const findings = [];
   for (const file of walk(root)) {
     const ext = path.extname(file).toLowerCase();
@@ -7276,6 +7397,8 @@ function encodingCheck(root, opts = {}) {
 function lazyDetect(root, opts = {}) {
   root = absRoot(root);
   const jsonMode = !!opts.json || has('--json');
+  // 1.10.3 (13th 버그헌트 P2, UR-0174): 잘못된 경로(없음/파일)에서 walk() throw → --json 비-JSON 차단.
+  if (!exists(root) || !fs.statSync(root).isDirectory()) { failJson(jsonMode, 'path_not_found', `경로 없음 또는 디렉토리 아님: ${root}`); return; }
   let issues = 0;
   const findings = []; // 1.9.101: { kind, severity, message, ...details }
   const _warn = (msg, finding) => { if (finding) findings.push(finding); if (!jsonMode) warn(msg); };
@@ -9129,7 +9252,7 @@ function handoffCmd(root) {
   // 1.9.35 개선 #1: .harness 부재 시 즉시 경고 (자동 init 권장)
   // 사용자가 신규 디렉토리에서 handoff 호출 시 sub-agent 작업이 길을 잃지 않도록.
   const absR = absRoot(root || process.cwd());
-  if (!exists(path.join(absR, '.harness')) && !has('--no-init-check')) {
+  if (!exists(path.join(absR, '.harness')) && !has('--no-init-check') && !has('--json')) {  // 1.10.5 (13th 버그헌트 P2, UR-0168): --json 시 사람용 미-init 배너 억제(순수 JSON, 앞부분 비-JSON 누출 차단)
     const isTty = process.stdout && process.stdout.isTTY;
     const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
     const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
@@ -9934,7 +10057,7 @@ async function orchestrateCmd(root, goalParts) {
 //   → 회귀 발생 시 어느 프로젝트인지 즉시 보고
 function depsImpactCmd(root, targetCapability) {
   root = absRoot(root || process.cwd());
-  if (!targetCapability) { fail('impact <capability> 필요. 예: leerness impact Character'); return process.exit(1); }
+  if (!targetCapability) { failJson(has('--json'), 'missing_arg', 'impact <capability> 필요. 예: leerness impact Character'); return; }  // 1.10.3 (UR-0174): --json 구조화 에러
   const paths = _collectWorkspacePaths(root);
   if (!paths.length) {
     // --all-apps 자동
@@ -13028,7 +13151,7 @@ function releaseSyncMainCmd(root) {
   //   opt-out: --no-npm 또는 LEERNESS_NO_NPM_PUBLISH=1
   //   토큰 미설정 시 친절한 안내 후 skip (실패 X).
   if (!has('--no-npm') && process.env.LEERNESS_NO_NPM_PUBLISH !== '1') {
-    try { _publishToNpm(root, { dryRun: has('--dry-run-npm') }); } catch (e) { warn('npm publish 시도 실패 (계속): ' + e.message); }
+    try { _publishToNpm(root, { dryRun: has('--dry-run-npm'), forcePublish: has('--publish-npm') }); } catch (e) { warn('npm publish 시도 실패 (계속): ' + e.message); }  // 1.9.446 (UR-0160): --publish-npm 으로 minor-gate 강제 우회
   }
 }
 
@@ -13197,6 +13320,21 @@ function _publishToNpm(root, opts = {}) {
     }
   } catch {}  // 네트워크 실패 시 그냥 publish 시도
 
+  // 1.5) R-0011/UR-0160: npm 배포는 minor(x.x) 변동 시에만 — 같은 minor 내 patch 는 스킵(GitHub/CHANGELOG 는 유지). --publish-npm 으로 강제.
+  if (!opts.forcePublish) {
+    let publishedLatest = null;
+    try {
+      const latestR = cp.spawnSync('npm', ['view', pkgName, 'version'], { cwd: root, encoding: 'utf8', shell: true, timeout: 15000 });
+      if (latestR.status === 0) publishedLatest = (latestR.stdout || '').trim();
+    } catch {}
+    const gate = _shouldPublishNpm(pkgVersion, publishedLatest, false);
+    if (!gate.publish) {
+      log(`   ⏸ npm 배포 스킵 (R-0011): patch(${pkgVersion}) 는 npm 미배포 — 직전 npm minor(${_minorKey(publishedLatest) || '?'}) 와 동일. minor 올릴 때만 안정 버전으로 배포. (강제: release sync-main . --publish-npm)`);
+      return;
+    }
+    if (gate.reason === 'minor_bump') log(`   ▶ minor 변동(${_minorKey(publishedLatest)} → ${_minorKey(pkgVersion)}) — npm 안정 배포 진행`);
+  }
+
   // 2) 임시 .npmrc 생성 (토큰 노출 방지)
   let tmpDir;
   try {
@@ -18839,7 +18977,20 @@ async function main() {
     } catch {}
   }
   // 1.9.276 (GPT-5.5 2차 리뷰): init --dry-run(미리보기) / --minimal(핵심 파일만) / --no-env(.env 생략)
-  if (cmd === 'init')      return await install(arg('--path', args[1] || process.cwd()), { force:has('--force'), dry:has('--dry-run'), migration:false, minimal:has('--minimal'), noEnv:has('--no-env') });  // 1.9.355 (UR-0075): --path 지원
+  if (cmd === 'init') {
+    const _initRoot = absRoot(arg('--path', args[1] && !args[1].startsWith('-') ? args[1] : process.cwd()));
+    const _initOpts = { force:has('--force'), dry:has('--dry-run'), migration:false, minimal:has('--minimal'), noEnv:has('--no-env') };
+    if (has('--json')) {
+      // 1.10.2 (UR-0146): init --json — 사람용 출력 묵음(setQuiet) + 순수 JSON 요약 1개. 기존엔 --json 을 silent ignore(배너만 출력).
+      // 1.10.3 (UR-0173): json:true → 배너/진행바 억제(TTY 누출 차단), nonInteractive:true → 대화 메뉴 차단(머신 계약).
+      setQuiet(true);
+      try { await install(_initRoot, { ..._initOpts, json: true, nonInteractive: true }); } finally { setQuiet(false); }
+      let harnessFiles = 0; try { harnessFiles = exists(path.join(_initRoot, '.harness')) ? fs.readdirSync(path.join(_initRoot, '.harness')).length : 0; } catch {}
+      log(JSON.stringify({ ok: true, action: 'init', version: VERSION, path: _initRoot, harnessFiles, dryRun: !!_initOpts.dry, minimal: !!_initOpts.minimal }, null, 2));
+      return;
+    }
+    return await install(_initRoot, _initOpts);  // 1.9.355 (UR-0075): --path 지원
+  }
   // 1.9.64: install <skill-id-or-url> 별칭 (= skill install). 자주 쓰는 명령 단축형.
   // 단, init이 leerness install . 같은 형태로도 동작하던 옛 호환은 유지 — args[1]이 디렉토리면 init으로 라우팅.
   if (cmd === 'install') {
@@ -19002,7 +19153,8 @@ async function main() {
   // 1.9.241: leerness env summary|encoding — 환경 종합 + 셸 스크립트 인코딩 위험 (사용자 명시 UR-0014)
   //   기존 env check/sync/detect (1.9.71) 와 충돌하지 않음 — summary/encoding 신규 서브
   if (cmd === 'env' && (args[1] === 'summary' || args[1] === 'encoding' || args[1] === 'encoding-check'))
-    return envCmd(arg('--path', process.cwd()), args[1] === 'summary' ? null : 'encoding-check');
+    // 1.10.4 (13th 버그헌트 P3, UR-0171): positional 디렉토리 인자 존중(형제 env check/sync/detect 와 통일) — 기존엔 무시하고 cwd 스캔 → 잘못된 디렉토리 false 'no risk'.
+    return envCmd((args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd()), args[1] === 'summary' ? null : 'encoding-check');
   // 1.9.254: leerness path-setup [--apply] — CLI PATH 자동 등록 (사용자 명시 UR-0019)
   //   npm global bin 경로 감지 + leerness 가 PATH 에서 찾아지는지 확인 → 미등록 시 플랫폼별 등록
   if (cmd === 'path-setup' || cmd === 'path')        return pathSetupCmd(arg('--path', process.cwd()), { apply: has('--apply'), json: has('--json') });
@@ -19039,6 +19191,13 @@ async function main() {
     const _aRoot = (args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd());
     return adapterCmd(_aRoot, _aTool);
   }
+  // 1.9.448 (GPT-5.5 전략리뷰 §6.6/7.3, UR-0154): export/prompt = adapter 별칭 — GPT-5.5 권고 표면명 정합(도구별 지침/계약 파일 생성).
+  if (cmd === 'export' || cmd === 'prompt') {
+    const _ADAPTER_ALIAS = { 'agents-md': 'codex', 'agents': 'codex', 'agent': 'codex', 'agents.md': 'codex' };
+    let _xTool = arg('--target', null) || (args[1] && !args[1].startsWith('-') ? args[1] : 'list');
+    _xTool = _ADAPTER_ALIAS[String(_xTool).toLowerCase()] || _xTool;
+    return adapterCmd(arg('--path', process.cwd()), _xTool);
+  }
   // 1.9.245: API skill cache — 공식 문서·관련링크 자동 정리 (사용자 명시 UR-0015)
   if (cmd === 'api-skill')                           return apiSkillCmd(arg('--path', process.cwd()), args[1] || 'help');
   // 1.9.208: leerness constraints <list|check|add> — 플랫폼/API 제약 사전 체크 (사용자 명시)
@@ -19095,7 +19254,7 @@ async function main() {
     if (sub==='add')      return planAdd(root, args.slice(2).join(' ') || '새 계획');
     if (sub==='drop')     return planDrop(root, args.slice(2).join(' ') || '드랍 항목');
     if (sub==='remove')   return planRemoveCmd(root, args[2]);
-    if (sub==='progress') return planProgress(root);
+    if (sub==='progress') return planProgress(root, { json: has('--json'), updateIntent: args.slice(2).some(a => /^M-\d/i.test(a)) || has('--status') || arg('--progress', null) != null });  // 1.9.447 (UR-0145): --json + 변경의도 인자 경고
     if (sub==='sync')     return planSync(root);
     // 1.9.119: plan list — 모든 milestone JSON/verbose
     if (sub==='list')     return planListCmd(absRoot(_resolveRoot(args[2])), { json: has('--json') });  // 1.9.412 (UR-0100): positional path 지원

package/lib/io.js

@@ -6,15 +6,19 @@
 const fs = require('fs');
 const path = require('path');
 
-function log(s = '') { console.log(s); }
+// 1.10.2 (UR-0146): quiet 모드 — 사람용 출력(log/ok/warn) 억제. init --json 등에서 큰 핸들러의 다수 log 를 비침투적으로 묵음 → 순수 JSON 1개만 출력.
+//   fail/failJson(오류)은 묵음 대상 아님(에러는 항상 노출). setQuiet 로 토글, 호출부 finally 에서 반드시 복구.
+let _quiet = false;
+function setQuiet(v) { _quiet = !!v; }
+function log(s = '') { if (_quiet) return; console.log(s); }
 function ok(s) { log('✓ ' + s); }
 function warn(s) { log('⚠ ' + s); }
 // fail() 은 오류 신호 → exit code 1 설정 (CI/MCP/에이전트가 실패를 성공으로 오판 방지, UR-0045).
-function fail(s) { log('✗ ' + s); process.exitCode = 1; }
+function fail(s) { console.log('✗ ' + s); process.exitCode = 1; }  // quiet 무시(오류는 항상 노출)
 // 1.9.398 (6번째 외부평가/codex P1-C, UR-0099): --json 모드 에러는 구조화 출력 — AI 에이전트가 에러 경로에서 JSON.parse 실패하지 않도록.
 //   jsonMode 면 {ok:false,error,code} + exit1, 아니면 사람용 fail(). 양쪽 exit code 1 일관.
 function failJson(jsonMode, code, msg) {
-  if (jsonMode) { log(JSON.stringify({ ok: false, error: msg, code }, null, 2)); process.exitCode = 1; }
+  if (jsonMode) { console.log(JSON.stringify({ ok: false, error: msg, code }, null, 2)); process.exitCode = 1; }  // quiet 무시(오류 JSON 항상 노출)
   else fail(msg);
 }
 function today() { return new Date().toISOString().slice(0, 10); }
@@ -48,4 +52,4 @@ function writeUtf8(p, s) {
 function append(p, s) { mkdirp(path.dirname(p)); fs.appendFileSync(p, s, 'utf8'); }
 function rel(root, p) { return path.relative(root, p).replace(/\\/g, '/') || '.'; }
 
-module.exports = { log, ok, warn, fail, failJson, today, now, absRoot, exists, read, readBuf, mkdirp, writeUtf8, append, rel };
+module.exports = { log, ok, warn, fail, failJson, setQuiet, today, now, absRoot, exists, read, readBuf, mkdirp, writeUtf8, append, rel };

package/lib/pure-utils.js

@@ -652,7 +652,9 @@ function _isPlaceholderSecret(value) {
   const hasRealPrefix = /^(?:sk-|sk-proj-|pk_|rk_|akia|ghp_|gho_|ghs_|ghr_|github_pat_|xox[baprs]-|aiza|ya29\.|glpat-|-----begin)/.test(v);
   // 1.9.436 (11th 외부평가 Opus P3): prefix 가 있어도 본문이 동일문자 8+연속(AKIAXXXX…/…00000000…)이면 명백한 더미 → placeholder. 실키는 고엔트로피라 무영향.
   if (/(.)\1{7,}/.test(alnum)) return true;
-  // (12th 외부평가 Opus P3 'AWS …EXAMPLE 키'는 보류 — 'example' 통째 placeholder 화는 기존 FN 정책(sk-EXAMPLE… 실키 유지, UR-0105)과 충돌. UR-0144 로 분리.)
+  // 1.10.1 (12th 외부평가 Opus P3, UR-0144): 'example' 로 끝나면(접미사) placeholder — AWS 공식 예제키 AKIAIOSFODNN7EXAMPLE 등.
+  //   중간에 'example' 이 있는 실키(sk-EXAMPLEab12…, sk-proj-realKEYexample…)는 접미사 아니라 미해당 → 기존 FN 정책(UR-0105) 보존. 실키는 'example' 로 끝날 확률 0.
+  if (/example$/.test(v)) return true;
   // 실키 prefix → 항상 실키(마커 무시). 그 외 마커 단어 있으면 placeholder(고엔트로피여도). prefix 없고 마커 없고 고엔트로피 → 실키.
   if (hasRealPrefix) return false;
   if (hasMarker) return true;
@@ -1025,7 +1027,9 @@ module.exports = {
   // 1.9.442 (12th 외부평가, UR-0141): task 계열 positional path 안전 추출
   _taskPositionalPath,
   // 1.9.443 (GPT-5.5 전략리뷰 §6.3, UR-0153): evidence-first 완료 게이트
-  _completionClaimAllowed
+  _completionClaimAllowed,
+  // 1.9.446 (R-0011/UR-0160): npm 배포 minor-gate
+  _minorKey, _shouldPublishNpm
 };
 
 // 1.9.355 (UR-0075 Phase A): AI 에이전트용 크로스버전 마이그레이션 안전 워크플로 가이드 (순수 텍스트). 임시설치 + --path + 백업 + diff 검증.
@@ -1288,6 +1292,21 @@ function _lineSafe(s) { return String(s == null ? '' : s).replace(/\r\n|\r|\n/g,
 // 1.9.407 (8번째 버그헌트, UR-0111): --limit 안전 파싱 — NaN(예: '--limit abc')/음수/0 은 slice(0,NaN)=[] 로 모든 결과를 조용히 숨김 → 기본값으로 폴백.
 function _parseLimit(raw, def) { const n = parseInt(raw, 10); return (Number.isFinite(n) && n > 0) ? n : def; }
 
+// 1.9.446 (R-0011/UR-0160): npm 배포 minor-gate. current(현재 버전) vs published(npm latest) 의 major.minor 비교.
+//   minor 가 올라갔으면(또는 최초/major↑) publish, 같은 minor 내 patch 면 skip. force 면 무조건 publish.
+function _minorKey(v) { const m = String(v || '').match(/^(\d+)\.(\d+)/); return m ? `${m[1]}.${m[2]}` : null; }
+function _shouldPublishNpm(current, published, force) {
+  if (force) return { publish: true, reason: 'forced' };
+  const cm = String(current || '').match(/^(\d+)\.(\d+)/);
+  if (!cm) return { publish: false, reason: 'invalid_current' };
+  const pm = String(published || '').match(/^(\d+)\.(\d+)/);
+  if (!pm) return { publish: true, reason: 'no_published' };          // 최초 배포
+  const c = [Number(cm[1]), Number(cm[2])], p = [Number(pm[1]), Number(pm[2])];
+  if (c[0] > p[0] || (c[0] === p[0] && c[1] > p[1])) return { publish: true, reason: 'minor_bump' };  // major/minor ↑
+  if (c[0] === p[0] && c[1] === p[1]) return { publish: false, reason: 'same_minor' };                // patch — 미배포
+  return { publish: false, reason: 'not_ahead' };                                                      // 동일/하위
+}
+
 // 1.9.416 (9th 외부평가 Sonnet/Codex, UR-0122): add 류(task/requests/decision) 제목 파싱 단일 출처.
 //   positional 을 join 하되 첫 --flag 또는 경로형 토큰(/x, C:\x, ./x, ../x)에서 멈춤 →
 //   `task add "제목" /some/path` 가 경로를 제목에 흡수하던 오염(decision add 는 이미 차단)을 일관 적용.

package/lib/session-close.js

@@ -13,6 +13,8 @@ const { _sanitizeFences, _parseArchiveBlocks } = require('./pure-utils');
 function sessionClose(root, opts = {}, deps = {}) {
   const { VERSION, STATUSES, MARK, has, arg, harnessPath, readProgressRows, evidencePath, handoffPath, currentStatePath, taskLogPath, verifyRules, _autoRoadmap, _readUsageStats, readSessionCounter, writeSessionCounter, _retroAggregate, _retroOneLine, retroCmd, _loadDecisions, readRules, planPath, _loadLessons, _readFeatureGraph, _auditUserRequests, _detectDeliveredRequests, _computeRoundHistory, _computeMilestones, _computeRecentChanges, _collectPyFiles, _analyzePyFile, _collectRuntimeEnv, _scanShellScriptsEncoding, _listAPISkills, _matchAPISkills, _loadShellFailures, _shellEnvDrift, _runPreWakeAudit, _saveAndAppendPreWakeReport, _runIdempotencyAudit, _detectAbnormalShutdown, _updateUserRequest } = deps;
   root = absRoot(root);
+  // 1.10.4 (13th 버그헌트 P2, UR-0167): 경로 없음/디렉토리 아님 → 구조화 에러 + exit 1. mkdir <path>/.harness ENOTDIR 크래시 & 실패를 성공(exit 0)으로 오판하던 문제 차단.
+  if (!exists(root) || !fs.statSync(root).isDirectory()) { failJson(!!opts.json || has('--json'), 'path_not_found', `경로 없음 또는 디렉토리 아님: ${root}`); return; }
   // 1.9.103: --json 모드 — stdout 억제 후 구조화 출력
   const jsonMode = !!opts.json || has('--json');
   const _origWrite = process.stdout.write.bind(process.stdout);

package/package.json

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

package/scripts/e2e.js

@@ -1457,7 +1457,7 @@ total++;
   const r = cp.spawnSync(process.execPath, [CLI, 'migrate', tmpC, '--yes', '--no-banner', '--no-stale-check'], { encoding: 'utf8', timeout: 60000 });
   const ok = r.status === 0
     && /AI must re-read/.test(r.stdout)
-    && /1\.9\.36 → 1\.9\.\d+/.test(r.stdout)
+    && /1\.9\.36 → \d+\.\d+\.\d+/.test(r.stdout)
     && /신규 명령/.test(r.stdout);
   console.log(ok ? '✓ B(1.9.41) migrate stdout: AI must re-read 차분 자동 출력' : `✗ migrate 차분 출력 실패`);
   if (!ok) { failed++; console.log(r.stdout.slice(-800)); }
@@ -1902,7 +1902,7 @@ total++;
     && /███████╗/.test(r.stdout)
     && /verify · remember/.test(r.stdout)
     && /AI 에이전트 검수.기억.드리프트 방지 하네스/.test(r.stdout)
-    && /v1\.9\.\d+/.test(r.stdout);
+    && /v\d+\.\d+\.\d+/.test(r.stdout);
   console.log(ok ? '✓ B(1.9.34) 배너 색상 + ASCII + 한국어' : `✗ 배너 색상 실패`);
   if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
 }