leerness 1.9.274 → 1.9.276

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 1.9.276 — 2026-06-03 — 설치 부담 완화: init --dry-run / --minimal / --no-env (GPT-5.5 2차 리뷰)
+
+**📦 GPT-5.5 2차 외부 평가(7/10)의 핵심 지적 "init이 너무 침투적 + 미리보기 부재"를 직접 해결.**
+
+### 배경
+GPT-5.5 가 1.9.275 를 직접 실행: 기능은 실용적이나 `init` 한 번에 50+ 파일 + `.claude`/`.cursor`/`.github`/`.env`/`README` 까지 건드려 "가볍게 설치"가 아님(#1). `init --dry-run` 부재(#2). `.env` 자동 생성 호불호(#6).
+
+### 구현
+1. **`init --dry-run`** — 생성/수정될 파일 목록 + 요약(생성/머지/보존 카운트) 미리보기 후 **조기 종료, 실제 변경 0**. dry 시 `_warnIfStale` 캐시 기록도 차단(부작용 0 보장). 기존 init 은 `dry:false` 하드코딩이라 미지원이던 것을 수정.
+2. **`init --minimal`** — 코어 워크플로(handoff/verify/audit/session close)가 요구하지 않는 ~25개(에디터 통합 `.cursor`/`.github`, AX 가이드, 템플릿, 스킬, 특화 체크리스트 등) + `roadmap.html` + `.env` + `.claude` SessionStart hook 을 생략. **verify 필수 파일은 전부 보존** → minimal 설치도 verify 통과 (49→31 .harness 파일).
+3. **`init --no-env`** — `.env`/`.env.example` 자동 생성만 생략 (토큰 자동 파일 호불호 대응).
+4. **`MINIMAL_SKIP_KEYS` denylist** — verify required 목록(plan/progress/guideline/protected-files/design-system/anti-lazy/session-handoff/current-state/AGENTS)을 침범하지 않도록 설계.
+5. **README/문서** — 한/영 보안 섹션에 설치 부담 완화 옵션 안내.
+6. **selftest 26→27 + e2e 223→224** — minimal 필터(핵심 보존+비핵심 제외+verify 필수 보존) + dry-run(0파일)/minimal(verify 통과)/no-env(.env 제외) 통합 검증.
+
+### 백로그 (GPT 2차 장기 항목)
+- 위험 명령 별도 패키지 분리(release/pc/web), e2e 5분 내 완료 안정화, bin/harness.js 추가 모듈화(UR-0025 계속), README 첫 화면 단순화.
+
+### 검증
+- **selftest 27/27 PASS** · **E2E 224/224 PASS** (회귀 0). dry-run 실측 0 파일 생성 · minimal verify 통과 확인.
+
+## 1.9.275 — 2026-06-03 — UR-0026: 릴리스 채널 (npm dist-tag 안정/실험)
+
+**🚦 잦은 1.9.x 릴리스에 안정(latest)/실험(next) 채널 + 버전 고정 안내 — 사용자가 안정성을 제어 (GPT-5.5 리뷰).**
+
+### 배경
+GPT-5.5 리뷰: 릴리스가 매우 잦아 사용자가 안정/실험 버전을 구분하기 어려움(UR-0026). npm dist-tag 로 채널을 분리하고, 운영 코드는 버전 고정을 안내.
+
+### 구현
+1. **`_resolveNpmTag(explicit, env)` 순수 함수** — `--npm-tag` / `LEERNESS_NPM_TAG` / 기본 `latest`. 형식 검증(소문자/숫자/-, ≤39자), 잘못된 값은 latest 폴백.
+2. **publish 경로 dist-tag 지원** — `_publishToNpm` + `release publish --npm-publish` 가 `--tag <tag>` 적용. `release sync-main --npm-tag next` 또는 `LEERNESS_NPM_TAG=next` 로 실험 채널 publish 가능 (기본은 latest 안정).
+3. **`leerness release channel [--json]` 신규** — 현재 버전/기본 publish 태그/정책(latest=안정, next=실험) + 버전 고정 안내. 온라인 시 `npm view dist-tags` 회수(offline 시 생략).
+4. **README 릴리스 채널 섹션(한/영)** — `npm i leerness` / `@next` / `@<버전>` 설치 가이드.
+5. **selftest 25→26 + e2e 222→223** — `_resolveNpmTag` 검증 + `release channel` JSON/env 반영.
+
+### 검증
+- **selftest 26/26 PASS** · **E2E 223/223 PASS** (회귀 0). 기본 publish 채널은 latest 유지(기존 동작 불변).
+
 ## 1.9.274 — 2026-06-03 — UR-0025 1단계: bin/harness.js 모듈 분리 시작 (lib/ 순수 유틸 추출)
 
 **🧩 단일 대형 파일(1.2MB) 모듈 분리의 비파괴 1단계 — `lib/` 모듈화 패턴 확립 + 순수 유틸 7종 추출 (GPT-5.5 리뷰).**

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.274-green)]() [![tests](https://img.shields.io/badge/e2e-222%2F222-success)]() [![selftest](https://img.shields.io/badge/selftest-24%2F24-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-75-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-6-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.276-green)]() [![tests](https://img.shields.io/badge/e2e-224%2F224-success)]() [![selftest](https://img.shields.io/badge/selftest-24%2F24-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-75-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-6-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -188,6 +188,25 @@ leerness capabilities          # 권한 표면 + opt-out + 주의 명령 (--json
 - 회사/운영 코드에서는 먼저 한 프로젝트에서 `init` 후 `git diff` 로 검토하고 커밋하세요.
 - 자세히: [SECURITY.md](SECURITY.md)
 
+**설치 부담 완화 옵션 (1.9.276):**
+
+```bash
+leerness init . --dry-run     # 생성/수정될 파일 미리보기 (실제 변경 0)
+leerness init . --minimal     # 핵심 파일만 (에디터 통합/가이드/roadmap/.env 생략)
+leerness init . --no-env      # .env/.env.example 자동 생성만 생략
+```
+
+### 릴리스 채널 (안정 vs 실험)
+
+leerness는 활발히 개발됩니다(잦은 1.9.x). 채널을 골라 안정성을 제어하세요:
+
+```bash
+npm i leerness            # latest (안정) — 일반 사용자 기본
+npm i leerness@next       # next (실험) — 조기 검증용
+npm i leerness@1.9.275    # 버전 고정 — 재현성 (운영 코드 권장)
+leerness release channel  # 현재 채널/정책 확인 (--json)
+```
+
 ---
 
 <a id="english"></a>
@@ -356,6 +375,25 @@ leerness capabilities          # capability surface + opt-out + cautious command
 - For company/production code, trial `init` in one project, review with `git diff`, then commit.
 - Details: [SECURITY.md](SECURITY.md)
 
+**Lighter-install options (1.9.276):**
+
+```bash
+leerness init . --dry-run     # preview files to be created/modified (zero changes)
+leerness init . --minimal     # core files only (skips editor integrations/guides/roadmap/.env)
+leerness init . --no-env      # skip only .env/.env.example auto-creation
+```
+
+### Release channels (stable vs experimental)
+
+leerness is actively developed (frequent 1.9.x). Pick a channel to control stability:
+
+```bash
+npm i leerness            # latest (stable) — default for most users
+npm i leerness@next       # next (experimental) — early validation
+npm i leerness@1.9.275    # pin a version — reproducibility (recommended for prod)
+leerness release channel  # show current channel/policy (--json)
+```
+
 ---
 
 ## 🔧 Environment variables / 환경변수
@@ -402,7 +440,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.274 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.276 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### Core Commands
 
@@ -444,7 +482,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.274는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
+Leerness v1.9.276는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -465,7 +503,7 @@ Leerness v1.9.274는 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.274)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.276)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -503,6 +541,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.274: 2026-06-03
+Last synced by Leerness v1.9.276: 2026-06-03
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -9,7 +9,7 @@ const readline = require('readline');
 // 1.9.274 (UR-0025 1단계): 순수 유틸 함수 모듈 분리 (require-based, 비파괴). selftest 7종이 동작 검증.
 const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp } = require('../lib/pure-utils');
 
-const VERSION = '1.9.274';
+const VERSION = '1.9.276';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -391,10 +391,23 @@ function skillLock(skills) {
   return JSON.stringify(data, null, 2) + '\n';
 }
 
-function coreFiles(root, lang = 'ko', selectedSkills = []) {
+// 1.9.276 (GPT-5.5 2차 리뷰): init --minimal 시 제외하는 키 — 에디터 통합/가이드/템플릿/스킬/특화 체크리스트 등
+//   "코어 워크플로(handoff/verify/audit/session close)"가 요구하지 않는 파일만 제외 (verify 필수 파일은 유지).
+const MINIMAL_SKIP_KEYS = new Set([
+  '.cursor/rules/leerness.mdc', '.github/copilot-instructions.md',
+  '.harness/project-brief.md', '.harness/task-type-map.md', '.harness/architecture.md', '.harness/context-map.md',
+  '.harness/guardrails.md', '.harness/feature-contracts.md', '.harness/feature-graph.md',
+  '.harness/testing-strategy.md', '.harness/review-checklist.md', '.harness/release-checklist.md',
+  '.harness/session-close-policy.md', '.harness/language-policy.md', '.harness/test-evidence-policy.md',
+  '.harness/AX_PLAN_GUIDE.md', '.harness/AX_MIGRATION_GUIDE.md', '.harness/AX_NEW_PROJECT_GUIDE.md', '.harness/AX_SKILL_LIBRARY_GUIDE.md',
+  '.harness/skill-index.md',
+  '.harness/templates/end-of-session-report.md', '.harness/templates/decision.md', '.harness/templates/task-row.md',
+  '.claude/skills/leerness.md'
+]);
+function coreFiles(root, lang = 'ko', selectedSkills = [], opts = {}) {
   const project = detectProjectName(root);
   const skillRows = Object.entries(skillCatalog).map(([k, v]) => `| ${k} | ${v.displayNameKo} | ${v.capabilities.join(', ')} | ${v.lastUpdated} | ${v.verification} |`).join('\n');
-  return {
+  const _files = {
     'AGENTS.md': `${MARK}\n# Leerness Agent Instructions\n\n## ⭐ 매 세션 첫 행동 (1.9.39+)\n**반드시 \`.harness/session-workflow.md\`를 먼저 읽고 6단계 워크플로를 따른다**: 요청분석→계획→분배→sub-agent작업→종합검증→마감. 라운드 길이/복잡도 무관, drift 방지를 위해 모든 작업에 동일 흐름 유지.\n\n## Mandatory read order (session start)\n1. **.harness/session-workflow.md** (1.9.39+ 6단계 워크플로 — 최우선)\n2. .harness/context-routing.md\n3. .harness/session-handoff.md\n4. .harness/current-state.md\n5. .harness/plan.md\n6. .harness/progress-tracker.md\n7. .harness/guideline.md\n8. .harness/protected-files.md\n9. .harness/writeback-policy.md\n10. .harness/anti-lazy-work-policy.md\n11. **.harness/rules.md** (사용자 정의 영구 룰 — 매 세션 반드시 따름)\n\n## Required behavior\n- 작업 시작 시 \`leerness handoff .\`를 실행해 컨텍스트를 적재합니다 (handoff가 active rules를 자동 출력).\n- 작업 분류는 \`leerness route <task-type>\`로 확인합니다 (planning, feature, bugfix, refactor, research, consistency, release, migration, session-start, session-close, harness-maintenance).\n- 보호 파일/관리 섹션을 삭제하지 않습니다. 머지·아카이브·deprecated 표시를 사용합니다.\n- 의미 있는 변경 후 progress-tracker, current-state, task-log, session-handoff를 갱신합니다.\n- 완료 선언 전 \`leerness check .\` 또는 \`leerness lazy detect .\`로 자기검증합니다.\n- 변경 전 secret/encoding 가드: \`leerness scan secrets .\`, \`leerness encoding check .\`.\n- 같은 기능 중복 생성 전 design-system.md, consistency-policy.md, reuse-map.md를 확인합니다.\n- 매 세션 종료 시 \`leerness session close .\`로 9개 카테고리(완료/진행중/미완료/예정/대기/보류/차단/드랍/검증) + **활성 룰 검증 결과**를 보고합니다.\n- 업데이트는 \`leerness update --check\` (감지) → \`leerness update --yes\` (자동 마이그레이션).\n\n## 자연어 회고/통찰/브레인스토밍 (1.9.13)\n사용자가 자연어로 회고/통찰/브레인스토밍을 요청하면 즉시 leerness 명령으로 호출합니다.\n\n| 사용자 발화 (자연어) | 즉시 실행할 명령 |\n|---|---|\n| "회고해줘 / 돌아보자 / 정리해줘" | \`leerness retro\` |\n| "최근 N일 회고" | \`leerness retro --days N\` |\n| "통계 / 누적 지표 / insights" | \`leerness insights\` |\n| "X에 대해 브레인스토밍 / X 관련 자료 / X 시작 전 검토" | \`leerness brainstorm "X"\` |\n\nsession close가 매번 자동으로 한 줄 요약을 출력하고, 5세션마다 자동 깊은 회고를 실행합니다. 사용자가 명시 요청 시 즉시 호출.\n\n## 자연어 룰 처리 (1.9.8)\n사용자가 자연어로 영구 룰을 요청하면 즉시 leerness rule 명령으로 등록합니다.\n\n| 사용자 발화 (자연어) | 즉시 실행할 명령 |\n|---|---|\n| "매 업데이트마다 버전 bump해줘" | \`leerness rule add "버전을 patch로 bump" --trigger every-update\` |\n| "매 커밋마다 패치노트 추가해줘" | \`leerness rule add "패치노트 추가" --trigger every-commit\` |\n| "세션 종료마다 배포해줘" | \`leerness rule add "배포 (release publish)" --trigger session-close\` |\n| "X 룰 중지/그만/끄기" | \`leerness rule pause <ID>\` (해당 룰 ID는 list로 확인) |\n| "X 룰 제거/삭제" | \`leerness rule remove <ID>\` |\n| "모든 룰 중지" | \`leerness rule stop\` |\n| "룰 다시 켜줘" | \`leerness rule resume-all\` 또는 \`leerness rule resume <ID>\` |\n\n룰을 등록한 후 사용자에게 등록 결과(ID + trigger + 설명)를 보고하고, 그 이후 매 세션마다 자동 적용합니다. 사용자가 "중지" 또는 "제거"를 명시적으로 말하기 전까지는 룰을 비활성화하지 않습니다.\n\n## 룰 자동 적용 (1.9.8)\nleerness가 자동 검증 가능한 trigger:\n- **every-update / version bump 키워드 룰**: package.json의 version이 갱신됐는지 검사 (handoff/session close가 baseline 캐시와 비교).\n- **CHANGELOG / 패치노트 키워드 룰**: CHANGELOG.md의 mtime이 갱신됐는지 검사.\n- **test / 테스트 / verify 키워드 룰**: review-evidence.md에 오늘 verify-code 흔적이 있는지 검사.\n- **배포 / publish / push 키워드 룰**: 자동 검증 불가 → 사용자에게 release publish 명령을 안내.\n\n자동 검증 가능한 룰의 실행은 \`leerness release bump\`, \`leerness release note "..."\`, \`leerness release publish\`를 사용해 자동화합니다.\n`,
     'CLAUDE.md': `${MARK}\n# Claude Code Instructions\n\nFollow AGENTS.md. Always run \`leerness handoff .\` at the start and \`leerness session close .\` before ending a session.\n\n**⭐ 매 세션 첫 행동 (1.9.39+)**: \`.harness/session-workflow.md\`의 6단계 워크플로(요청분석→계획→분배→sub-agent→종합검증→마감)를 따라야 함. drift critical 시 \`leerness drift check --auto-fix\`로 자동 회복.\n\nProtected files must not be deleted. Read .harness/anti-lazy-work-policy.md before claiming completion.\n\n## 자연어 영구 룰 (1.9.8)\n사용자가 "매 X마다 Y를 해줘" 같은 자연어 룰을 말하면 즉시 \`leerness rule add "Y" --trigger every-X\`로 등록하세요. 등록된 룰은 매 세션 \`handoff\`가 자동 출력하고, \`session close\`가 자동 검증해 보고합니다. 사용자가 "중지" / "그만" / "끄기"를 명시할 때만 \`rule pause/remove\`를 호출합니다.\n\n자세한 매핑은 AGENTS.md의 "자연어 룰 처리" 표를 참고하세요.\n`,
     '.cursor/rules/leerness.mdc': `${MARK}\n---\nalwaysApply: true\n---\nFollow AGENTS.md and .harness/context-routing.md.\nRun: \`leerness handoff .\` at session start.\nRun: \`leerness session close .\` at session end.\nPreserve Leerness protected files.\n`,
@@ -611,6 +624,9 @@ leerness memory restore <surface> <target>   # archive → active 복귀 (DELETE
     '.claude/commands/update.md': `# /update\n\nleerness 자동 업데이트를 실행합니다 (감지 → 마이그레이션 → 검증).\n\n\`\`\`\n!leerness update --yes\n\`\`\`\n`,
     '.claude/skills/leerness.md': `---\nname: leerness\ndescription: Leerness harness commands - handoff, audit, scan secrets, encoding check, lazy detect, session close, update. Use when the user asks to load project context, verify work quality, scan secrets, check encoding, or end a session.\n---\n\n# leerness skill\n\n## When to use\n- 사용자가 프로젝트 컨텍스트를 로드해달라고 할 때\n- 완료 선언 전 자기 검증을 요청할 때\n- 세션을 종료하거나 인수인계를 요청할 때\n- 시크릿/한글 인코딩 점검을 요청할 때\n- 새 leerness 버전 적용을 요청할 때\n\n## Commands\n\n\`\`\`bash\nleerness handoff .             # 컨텍스트 로드\nleerness check .               # pre-action 체크\nleerness audit .               # 일관성/계획 정렬 감사\nleerness scan secrets .        # 시크릿 패턴 스캔\nleerness encoding check .      # UTF-8/BOM/CRLF\nleerness lazy detect .         # 게으름 평가\nleerness memory search "key"   # 결정/이력 검색\nleerness session close .       # 종료 보고 + handoff 자동 생성\nleerness update --yes          # 자동 업데이트\n\`\`\`\n`,
   };
+  // 1.9.276: minimal 모드 — 코어가 요구하지 않는 파일 제외 (verify 필수 파일은 유지).
+  if (opts.minimal) { for (const k of MINIMAL_SKIP_KEYS) delete _files[k]; }
+  return _files;
 }
 
 function copyRecursiveSafe(src, dst) {
@@ -917,7 +933,8 @@ async function install(root, opts = {}) {
   // 1.9.32: init 시 ASCII 배너 + 빠른 시작 가이드 (migrate는 quiet)
   if (!opts.migration && !has('--no-banner')) _banner({ quickStart: !opts.dry });
   // 1.9.33: npx 캐시로 옛 버전이 실행될 때 경고 (migrate/--no-stale-check 시 스킵)
-  if (!opts.migration && !has('--no-stale-check') && !opts.nonInteractive) {
+  // 1.9.276: dry-run 시 스킵 — 캐시 파일(.harness/cache) 생성 방지 (dry = 부작용 0 보장)
+  if (!opts.migration && !has('--no-stale-check') && !opts.nonInteractive && !opts.dry) {
     try { await _warnIfStale(root); } catch {}
   }
   const resolved = await resolveInstallOptions(root, opts);
@@ -936,7 +953,7 @@ async function install(root, opts = {}) {
   if (resolved.permissionMode) log(`Agent 권한 모드: ${resolved.permissionMode}  (1.9.174 — REPL에서 \`:permissions extended|full\` 로 즉시 변경 가능)`);
   // 1.9.10: 스킬 카탈로그 출처 안내
   // 1.9.184 (사용자 명시): leerness-skillpack 미사용 정책 — 안내 메시지 제거. builtin catalog 만 사용.
-  const files = coreFiles(root, lang, skills);
+  const files = coreFiles(root, lang, skills, { minimal: !!opts.minimal });
   const backup = createBackup(root, opts.force ? 'force' : (opts.migration ? 'migration' : 'init'), files, opts.dry);
   if (opts.dry) {
     log(`Backup target: ${backup.archiveDir}`);
@@ -986,6 +1003,19 @@ async function install(root, opts = {}) {
     process.stdout.write('\r\x1b[K');  // clear progress line
     log(`  \x1b[32m✓\x1b[0m leerness 파일 설치 완료 (${totalFiles}개)`);
   }
+  // 1.9.276 (GPT-5.5 2차 리뷰): dry-run 요약 + 조기 종료 (파일 미생성). 실제 적용 안내.
+  if (opts.dry) {
+    const created = actions.filter(a => a.action === 'create').length;
+    const merged = actions.filter(a => a.action === 'merge/update').length;
+    const preserved = actions.filter(a => a.action === 'preserve').length;
+    log('');
+    log(`# [dry-run] 요약${opts.minimal ? ' (--minimal)' : ''} — 실제 파일은 생성/수정되지 않았습니다`);
+    log(`  생성 ${created} · 머지/갱신 ${merged} · 보존 ${preserved} · 총 ${totalFiles}`);
+    if (!opts.noEnv && !opts.minimal) log(`  + .env/.env.example, .gitignore, roadmap.html, .claude hook (실제 실행 시)`);
+    log(`  → 실제 적용: leerness init ${rel(process.cwd(), root) || '.'}${opts.minimal ? ' --minimal' : ''}${opts.noEnv ? ' --no-env' : ''} --yes`);
+    _cleanupSigint();
+    return;
+  }
   if (!opts.dry) {
     mergeLinesFile(path.join(root, '.gitignore'), [
       // 1.9.153: .env 직접 생성 + 사용자 글로벌 룰 SECRET_PATTERNS 6종 일괄 ignore (audit 통합)
@@ -1021,11 +1051,16 @@ async function install(root, opts = {}) {
       'LEERNESS_NPM_TOKEN=',
       'LEERNESS_GITHUB_TOKEN=',
     ];
-    mergeLinesFile(path.join(root, '.env.example'), envLines);
-    try {
-      mergeEnvFile(path.join(root, '.env'), envLines);
-    } catch (e) {
-      warn(`.env 생성/마이그레이션 실패 (계속 진행): ${e.message}`);
+    // 1.9.276 (GPT-5.5 2차 리뷰): --no-env 또는 --minimal 시 .env/.env.example 자동 생성 건너뜀 (호불호 + 침투성 완화).
+    if (opts.noEnv || opts.minimal) {
+      log(`  ⏭ .env/.env.example 생성 건너뜀 (${opts.minimal ? '--minimal' : '--no-env'}) — 토큰 필요 시 .env.example 참고해 수동 생성`);
+    } else {
+      mergeLinesFile(path.join(root, '.env.example'), envLines);
+      try {
+        mergeEnvFile(path.join(root, '.env'), envLines);
+      } catch (e) {
+        warn(`.env 생성/마이그레이션 실패 (계속 진행): ${e.message}`);
+      }
     }
     // 1.9.187: 비시크릿 LEERNESS_* 설정 → .harness/leerness-config.json (AI 가시성)
     try {
@@ -1116,11 +1151,14 @@ async function install(root, opts = {}) {
         }
       }
     } catch {}
-    if (!has('--no-auto-update')) {
+    // 1.9.276: --minimal 시 .claude SessionStart hook 도 건너뜀 (침투성 완화)
+    if (!has('--no-auto-update') && !opts.minimal) {
       try { autoUpdateInstall(root); } catch (e) { warn('auto-update hook install skipped: ' + (e && e.message)); }
+    } else if (opts.minimal) {
+      log(`  ⏭ .claude SessionStart hook 건너뜀 (--minimal) — 필요 시 leerness auto-update install .`);
     }
-    // 1.9.12: install 직후 첫 roadmap.html 자동 생성
-    if (!has('--no-auto-roadmap')) {
+    // 1.9.12: install 직후 첫 roadmap.html 자동 생성 (1.9.276: --minimal 시 건너뜀 — 침투성/용량 완화)
+    if (!has('--no-auto-roadmap') && !opts.minimal) {
       try { _autoRoadmap(root, 'install'); } catch (e) { warn('auto-roadmap 실패: ' + (e && e.message)); }
     }
     // 1.9.148: 1.9.32 중복 prompt 제거 (사용자 명시 — CLI 에이전트 prompt 중복).
@@ -2912,6 +2950,8 @@ function _selfTestCases() {
     { name: 'ROLE_CATALOG + _normalizeRole: 7종 + 한국어 별칭 (1.9.270)', run: () => { const keys = Object.keys(ROLE_CATALOG); return keys.length === 7 && keys.includes('coder') && keys.includes('reviewer') && _normalizeRole('코딩') === 'coder' && _normalizeRole('검수자') === 'reviewer' && _normalizeRole('지휘관') === 'commander'; } },
     { name: '_pickModel: top/code/fast 등급 선택 (1.9.270)', run: () => { return _pickModel('codex', 'code') === 'gpt-5-codex' && _pickModel('claude', 'top') === 'claude-opus-4-7' && /haiku/.test(_pickModel('claude', 'fast')); } },
     { name: 'CAPABILITY_SURFACE: 6 영역 + risk/optOut + 주의명령 (1.9.272)', run: () => { const ks = Object.keys(CAPABILITY_SURFACE); return ks.length === 6 && ks.includes('automationBridges') && Object.values(CAPABILITY_SURFACE).every(v => ['low','medium','high'].includes(v.risk) && v.optOut && v.desc) && POWERFUL_COMMANDS.length >= 5; } },
+    { 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: '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: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -3569,6 +3609,7 @@ function commandsCmd(root) {
       { cmd: 'agents list|check|quota|dispatch|multi', desc: '외부 AI CLI 오케스트레이션 (dispatch --role 모델 라우팅 1.9.270)' },
       { cmd: 'roles list|set|unset|catalog|suggest|verify', desc: '모델별 역할 부여 (코딩/검수/지휘/디자인/디버그/설계/분배) — 1.9.270' },
       { cmd: 'capabilities [--json]', desc: '권한·보안 표면 공개 (무엇을 하는지 + opt-out + 주의 명령) — 1.9.272' },
+      { cmd: 'release channel [--json]', desc: '릴리스 채널 정책 (latest 안정 / next 실험 / 버전 고정) — 1.9.275' },
       { cmd: 'slash-commands [agent] [--json --record --detect --refresh]', desc: 'CLI 에이전트 슬래시 명령 레지스트리 + --help probe 자동 갱신 (1.9.265~267, UR-0021)' },
       { cmd: 'review-request "<request>"', desc: '사용자 요청 사전 검토 (1.9.176)' },
       { cmd: 'review <file> --persona <ids>', desc: '페르소나 리뷰 (1.9.29)' },
@@ -14164,6 +14205,34 @@ function releaseCleanupCmd(root) {
 //     - NPM_TOKEN 또는 LEERNESS_NPM_TOKEN 환경변수에서만 읽음 (값 절대 로그 X)
 //     - 임시 .npmrc 파일 (mkdtempSync) 생성 → publish → 즉시 삭제 (finally)
 //     - 이미 publish된 버전 자동 detect → skip (중복 publish 차단)
+// 1.9.275 (UR-0026, GPT-5.5 리뷰): npm dist-tag 결정 — latest(안정, 기본) / next(실험). 잘못된 형식은 latest 폴백. 순수 함수.
+function _resolveNpmTag(explicit, env) {
+  env = env || process.env;
+  const raw = String(explicit || env.LEERNESS_NPM_TAG || 'latest').trim().toLowerCase();
+  return /^[a-z][a-z0-9-]{0,38}$/.test(raw) ? raw : 'latest';
+}
+// 1.9.275 (UR-0026): leerness release channel — 안정/실험 채널 정책 + 버전 고정 안내 (npm dist-tag).
+function releaseChannelCmd(root) {
+  root = absRoot(root || process.cwd());
+  const json = has('--json');
+  let v = null; try { v = JSON.parse(read(path.join(root, 'package.json'))).version; } catch {}
+  const tag = _resolveNpmTag(arg('--npm-tag', null));
+  let distTags = null;
+  if (!has('--offline') && process.env.LEERNESS_OFFLINE !== '1') {
+    try { const r = cp.spawnSync('npm', ['view', 'leerness', 'dist-tags', '--json'], { encoding: 'utf8', timeout: 10000, shell: true }); if (r.status === 0 && r.stdout) distTags = JSON.parse(r.stdout); } catch {}
+  }
+  if (json) { log(JSON.stringify({ version: v, defaultPublishTag: tag, distTags, policy: { stable: 'latest', experimental: 'next' } }, null, 2)); return; }
+  log(`# leerness release channel (1.9.275, UR-0026)`);
+  log(`현재 버전: ${v || '?'}  ·  기본 publish 태그: ${tag}`);
+  if (distTags) { log('npm dist-tags:'); for (const [k, val] of Object.entries(distTags)) log(`  ${k}: ${val}`); }
+  log('');
+  log(`## 채널 정책 (안정 vs 실험)`);
+  log(`  • latest (안정) — npm i leerness            ← 일반 사용자 기본`);
+  log(`  • next  (실험)  — npm i leerness@next        ← 조기 검증용`);
+  log(`  • 버전 고정     — npm i leerness@${v || '1.9.275'}   ← 재현성 (권장: 운영 코드)`);
+  log('');
+  log(`  실험 채널 publish: leerness release sync-main --npm-tag next  (또는 LEERNESS_NPM_TAG=next)`);
+}
 function _publishToNpm(root, opts = {}) {
   root = absRoot(root || process.cwd());
   // .env 자동 로드 — root + 상위 3단계까지 탐색 (워크스페이스 root 의 .env 도 인식).
@@ -14221,10 +14290,12 @@ function _publishToNpm(root, opts = {}) {
     // 3) npm publish (--userconfig 로 임시 .npmrc 사용, --access public)
     // 1.9.178+: 2FA OTP 지원 — LEERNESS_NPM_OTP 환경변수 또는 --npm-otp 인자
     const otp = process.env.LEERNESS_NPM_OTP || arg('--npm-otp', null) || opts.otp;
-    const baseArgs = ['publish', '--userconfig', tmpNpmrc, '--access', 'public'];
+    // 1.9.275 (UR-0026): dist-tag — latest(안정)/next(실험). 기본 latest.
+    const npmTag = _resolveNpmTag(opts.tag || arg('--npm-tag', null));
+    const baseArgs = ['publish', '--userconfig', tmpNpmrc, '--access', 'public', '--tag', npmTag];
     if (otp) baseArgs.push(`--otp=${otp}`);
     const args = opts.dryRun ? [...baseArgs, '--dry-run'] : baseArgs;
-    log(`   ${opts.dryRun ? '(dry-run) ' : ''}npm publish 시도 중...`);
+    log(`   ${opts.dryRun ? '(dry-run) ' : ''}npm publish 시도 중... (dist-tag: ${npmTag})`);
     const pubR = cp.spawnSync('npm', args, {
       cwd: root, encoding: 'utf8', shell: true, timeout: 60000,
       env: { ...process.env, npm_config_loglevel: 'warn' }
@@ -14414,7 +14485,9 @@ function releasePublish(root) {
 
   // 6. npm publish (--npm-publish)
   if (has('--npm-publish')) {
-    const args = dryRun ? ['publish', '--dry-run'] : ['publish', '--access', 'public'];
+    // 1.9.275 (UR-0026): dist-tag 지원 (latest/next)
+    const npmTag = _resolveNpmTag(arg('--npm-tag', null));
+    const args = dryRun ? ['publish', '--dry-run', '--tag', npmTag] : ['publish', '--access', 'public', '--tag', npmTag];
     log('npm ' + args.join(' '));
     const r = cp.spawnSync('npm', args, { cwd: root, encoding: 'utf8', shell: true });
     log((r.stdout || '').split('\n').slice(-5).join('\n'));
@@ -20615,7 +20688,8 @@ async function main() {
       }
     } catch {}
   }
-  if (cmd === 'init')      return await install(args[1] || process.cwd(), { force:false, dry:false, migration:false });
+  // 1.9.276 (GPT-5.5 2차 리뷰): init --dry-run(미리보기) / --minimal(핵심 파일만) / --no-env(.env 생략)
+  if (cmd === 'init')      return await install(args[1] || process.cwd(), { force:has('--force'), dry:has('--dry-run'), migration:false, minimal:has('--minimal'), noEnv:has('--no-env') });
   // 1.9.64: install <skill-id-or-url> 별칭 (= skill install). 자주 쓰는 명령 단축형.
   // 단, init이 leerness install . 같은 형태로도 동작하던 옛 호환은 유지 — args[1]이 디렉토리면 init으로 라우팅.
   if (cmd === 'install') {
@@ -20819,6 +20893,8 @@ async function main() {
   if (cmd === 'release' && args[1] === 'sync-main') return releaseSyncMainCmd(args[2] || arg('--path', process.cwd()));
   // 1.9.235: leerness release cleanup — local release/* branches 정리 (merged 만, --apply 시 실 삭제)
   if (cmd === 'release' && args[1] === 'cleanup')   return releaseCleanupCmd((args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd()));
+  // 1.9.275 (UR-0026): leerness release channel — 안정/실험 채널 정책 (npm dist-tag)
+  if (cmd === 'release' && args[1] === 'channel')   return releaseChannelCmd((args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd()));
   // 1.9.141: feature causality graph
   if (cmd === 'feature' && args[1] === 'add')    return featureAddCmd(arg('--path', process.cwd()), args.slice(2).filter(x => !x.startsWith('--')).join(' '));
   if (cmd === 'feature' && args[1] === 'link')   return featureLinkCmd(arg('--path', process.cwd()), args[2]);
@@ -20962,5 +21038,9 @@ module.exports = {
   // 1.9.270: agent roles — 모델별 역할 부여 (사용자 명시) — 단위 테스트
   ROLE_CATALOG, _normalizeRole, _pickModel, _rolesFile, _loadRoles, _saveRoles, _resolveRole, _suggestRoles, rolesCmd, _dispatchCommand,
   // 1.9.272: 권한/보안 표면 공개 (GPT-5.5 리뷰) — 단위 테스트
-  CAPABILITY_SURFACE, POWERFUL_COMMANDS, capabilitiesCmd
+  CAPABILITY_SURFACE, POWERFUL_COMMANDS, capabilitiesCmd,
+  // 1.9.275: 릴리스 채널 (npm dist-tag, GPT-5.5 리뷰) — 단위 테스트
+  _resolveNpmTag, releaseChannelCmd,
+  // 1.9.276: init --minimal 파일 필터 (GPT-5.5 2차 리뷰) — 단위 테스트
+  MINIMAL_SKIP_KEYS, coreFiles
 };

package/package.json

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

package/scripts/e2e.js

@@ -2801,5 +2801,45 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.275 회귀 (UR-0026): release channel — 안정/실험 채널 정책 (npm dist-tag)
+total++;
+{
+  const r = cp.spawnSync(process.execPath, [CLI, 'release', 'channel', tmp, '--json', '--offline'], { encoding: 'utf8', timeout: 15000 });
+  let jsonOk = false;
+  try { const j = JSON.parse(r.stdout); jsonOk = j.defaultPublishTag === 'latest' && j.policy && j.policy.stable === 'latest' && j.policy.experimental === 'next'; } catch {}
+  const r2 = cp.spawnSync(process.execPath, [CLI, 'release', 'channel', tmp, '--json', '--offline'], { encoding: 'utf8', timeout: 15000, env: { ...process.env, LEERNESS_NPM_TAG: 'next' } });
+  let nextOk = false;
+  try { nextOk = JSON.parse(r2.stdout).defaultPublishTag === 'next'; } catch {}
+  const ok = jsonOk && nextOk;
+  console.log(ok ? '✓ B(1.9.275) release channel: latest 기본 + LEERNESS_NPM_TAG=next 반영 + 정책' : `✗ release channel 실패 (json=${jsonOk} next=${nextOk})`);
+  if (!ok) failed++;
+}
+
+// 1.9.276 회귀 (GPT-5.5 2차 리뷰): init --dry-run / --minimal / --no-env
+total++;
+{
+  // --dry-run: 파일 0개 생성 + 요약 출력
+  const dDir = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-dry-'));
+  const rDry = cp.spawnSync(process.execPath, [CLI, 'init', dDir, '--dry-run', '--yes'], { encoding: 'utf8', timeout: 30000 });
+  const dryNoFiles = fs.readdirSync(dDir).length === 0;
+  const drySummary = /\[dry-run\] 요약/.test(rDry.stdout) && !fs.existsSync(path.join(dDir, '.harness'));
+  // --minimal --no-env: 핵심 유지 + 비핵심/.env/.cursor/roadmap 제외
+  const mDir = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-min-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', mDir, '--minimal', '--no-env', '--yes'], { encoding: 'utf8', timeout: 30000 });
+  const fDir = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-full-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', fDir, '--yes'], { encoding: 'utf8', timeout: 30000 });
+  const minCount = fs.existsSync(path.join(mDir, '.harness')) ? fs.readdirSync(path.join(mDir, '.harness')).length : 0;
+  const fullCount = fs.existsSync(path.join(fDir, '.harness')) ? fs.readdirSync(path.join(fDir, '.harness')).length : 0;
+  const minimalOk = minCount > 0 && minCount < fullCount
+    && fs.existsSync(path.join(mDir, '.harness', 'plan.md')) && fs.existsSync(path.join(mDir, 'AGENTS.md'))
+    && !fs.existsSync(path.join(mDir, '.env')) && !fs.existsSync(path.join(mDir, '.cursor')) && !fs.existsSync(path.join(mDir, 'roadmap.html'));
+  // minimal 이어도 verify 통과(필수 파일 보존)
+  const rVerify = cp.spawnSync(process.execPath, [CLI, 'verify', mDir], { encoding: 'utf8', timeout: 20000 });
+  const verifyOk = rVerify.status === 0;
+  const ok = dryNoFiles && drySummary && minimalOk && verifyOk;
+  console.log(ok ? '✓ B(1.9.276) init --dry-run(0파일)/--minimal(축소+verify통과)/--no-env(.env 제외)' : `✗ init 옵션 실패 (dry=${dryNoFiles} drySum=${drySummary} min=${minimalOk}(${minCount}<${fullCount}) verify=${verifyOk})`);
+  if (!ok) { failed++; console.log((rVerify.stdout || '').slice(0, 300)); }
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed`);
 if (failed > 0) process.exit(1);