leerness 1.9.176 → 1.9.178

package/CHANGELOG.md

@@ -1,5 +1,102 @@
 # Changelog
 
+## 1.9.178 — 2026-05-21
+
+**📦 사용자 명시: `release sync-main` 자동 npm publish — .env NPM_TOKEN 사용.**
+
+자율 모드 108 라운드. 사용자 명시: *"NPM 액세스 토큰 .env에 입력해뒀음. 업데이트될 때마다 깃허브처럼 NPM에도 자동 배포"*.
+
+### 통합 흐름
+```bash
+$ leerness release sync-main .
+# leerness release sync-main (1.9.140)
+from: release/1.9.178 → main
+✓ main merged: release/1.9.178
+✓ main pushed → origin/main
+
+📦 npm publish 자동 trigger (1.9.178)
+   leerness@1.9.178
+   npm publish 시도 중...
+✓ npm publish 완료: leerness@1.9.178
+```
+
+→ git push 후 NPM 자동 publish — git 워크플로와 NPM 워크플로 완전 통합.
+
+### 보안 설계 (3중 안전망)
+1. **토큰 환경변수만 사용**: `process.env.LEERNESS_NPM_TOKEN || process.env.NPM_TOKEN` (값 절대 로그 X)
+2. **임시 `.npmrc` 격리**: `mkdtempSync` → `.npmrc` (mode 0o600 소유자만 읽기) → publish → **finally 즉시 삭제**
+3. **`.env` 자동 보호**: 1.9.75+ audit이 `.gitignore`에 `.env` 등록 강제 (시크릿 누락 감지)
+
+### 중복 publish 차단
+- `npm view <pkg>@<version> version` 사전 호출
+- 이미 publish된 버전이면 skip + 알림 (race condition도 후속 처리)
+
+### 친절한 에러 안내
+- `EPUBLISHCONFLICT` → "이미 publish됨 — skip"
+- `EAUTH / 401 / 403` → "토큰 권한 부족 또는 만료 — .env NPM_TOKEN 재발급 필요"
+- `ENEEDAUTH` → "인증 미작동 — 토큰 형식 확인 (npm_xxxxx)"
+- 기타 → 마지막 3줄 stderr 노출
+
+### Opt-out (3가지)
+1. `--no-npm` 플래그
+2. `LEERNESS_NO_NPM_PUBLISH=1` 환경변수
+3. `--dry-run-npm` 플래그 (dry-run mode)
+
+### Observability
+`_recordRun(kind: 'npm_publish')` — 모든 publish 시도 (성공/실패) 자동 기록.
+
+### Verified
+- e2e 217/217 baseline 유지 (LEERNESS_NO_NPM_PUBLISH=1 환경)
+- stress-v123: **22/22** (함수 정의 6 + 중복 차단 4 + release 통합 3 + 친절한 안내 3 + 누적 회귀 6)
+- VERSION = 1.9.178 / autonomous-rounds = 108 / main 자동 push 39 라운드 연속 + **NPM 자동 publish 1 라운드 시작**
+
+---
+
+## 1.9.177 — 2026-05-21
+
+**🔁 `task add` 자동 review-request trigger — 사용자 명시 1.9.176 자동화.**
+
+자율 모드 107 라운드. 1.9.176 (사용자 명시: 무조건 구현 전 사전 검토) 의 자동화 — 사용자/AI가 `task add` 호출 시 review를 직접 실행하지 않아도 자동 trigger.
+
+### 통합 흐름
+```bash
+$ leerness task add "OAuth 로그인 구현해줘"
+✓ task added: T-0001
+
+🔍 review-request (1.9.177 자동): type=feature · ✓ 진행 안전 (705ms)
+   권장 단계:
+     1) leerness reuse find "<핵심 capability>" — 중복 구현 사전 차단
+     2) leerness plan add "<milestone>" — 진행 추적
+     ... +2건 (leerness review-request "OAuth 로그인 구현해줘" 으로 전체 보기)
+   💡 👥 leerness agents recommend feature — 작업 유형별 sub-agent 매핑 활용 가능
+```
+
+→ 사용자/AI가 명시적으로 `:review` 호출 안 해도, `task add` 만으로 자동 사전 검토 완료. **1.9.176 사용자 명시 의도가 default 동작에 통합**.
+
+### Opt-out (3 가지)
+1. CLI 플래그: `leerness task add "..." --no-review`
+2. 환경변수: `LEERNESS_NO_AUTO_REVIEW=1`
+3. 운영 메타: `--status done|dropped|blocked` (이미 종료된 작업은 review 불필요)
+
+### 표시 정책 (간결)
+- 헤더 1줄: `type=X · ⚠ N 충돌 · 🔁 N 재사용 후보 · ✓ 진행 안전 / ⚠ 확인 필요 (ms)`
+- 권장 단계 첫 2건 (나머지는 `leerness review-request` 직접 호출 안내)
+- 효율 제안 1건 (가장 중요한 hint)
+- `proceed=false` 시 ⚠ 사유 노출
+
+### MCP 호환성
+`leerness_task_add` (MCP) 호출 시에도 자동 review 동작 — 외부 AI (Claude/Codex/Gemini)가 task 등록 시 자동으로 사전 검토 결과 받음.
+
+### 성능
+실측: ~1.1초 task add (이전 ~30ms + review 1초 추가). brainstorm/reuse-map 회수 비용 — opt-out 가능.
+
+### Verified
+- e2e 217/217 baseline 유지
+- stress-v122: **18/18** (taskAdd 통합 4 + 실 동작 7 + MCP 호환 1 + 누적 회귀 6)
+- VERSION = 1.9.177 / autonomous-rounds = 107 / main 자동 push 38 라운드 연속
+
+---
+
 ## 1.9.176 — 2026-05-21
 
 **⚠ 사용자 명시: `leerness review-request` — 사용자 요구를 무조건 구현 전 사전 검토.**

package/README.md

@@ -2,7 +2,7 @@
 
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.176-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v121-23%2F23-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-106-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-37_rounds-success)]() [![review-request](https://img.shields.io/badge/review--request-사전_검토_9_신호-success)]() [![repl-slash](https://img.shields.io/badge/REPL_slash-:web%2F:pc%2F:lsp%2F:review-success)]() [![lsp-multi](https://img.shields.io/badge/LSP_다국어-JS%2FPython%2FGo%2FRust%2FJava-success)]() [![capability](https://img.shields.io/badge/6_capability-72%25_production--ready-brightgreen)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.178-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v123-22%2F22-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-108-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-39_rounds-success)]() [![npm-auto](https://img.shields.io/badge/npm_auto--publish-NPM__TOKEN_통합-success)]() [![auto-review](https://img.shields.io/badge/task_add-자동_review_trigger-success)]() [![repl-slash](https://img.shields.io/badge/REPL_slash-:web%2F:pc%2F:lsp%2F:review-success)]() [![capability](https://img.shields.io/badge/6_capability-72%25_production--ready-brightgreen)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.176  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.178  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  ⚠ review-request — 무조건 구현 전 충돌/효율 사전 검토        ║
+  ║  📦 release sync-main 자동 npm publish (NPM_TOKEN .env 통합)  ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

package/bin/harness.js

@@ -6,7 +6,7 @@ const path = require('path');
 const cp = require('child_process');
 const readline = require('readline');
 
-const VERSION = '1.9.176';
+const VERSION = '1.9.178';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -1600,6 +1600,42 @@ function taskAdd(root, text) {
   upsertProgress(root, { id, status: arg('--status','requested'), request: text, evidence: arg('--evidence','user-request'), nextAction: arg('--next','다음 액션 작성') });
   ok(`task added: ${id}`);
   _autoRoadmap(absRoot(root), 'data-change');
+  // 1.9.177: task add 자동 review-request trigger (사용자 명시 1.9.176 자동화).
+  //   사용자가 task 추가 시 자동으로 사전 검토 — 충돌/재사용/효율/권장 단계 결과를 등록 직후 표시.
+  //   opt-out: --no-review 또는 env LEERNESS_NO_AUTO_REVIEW=1, 또는 status=in-progress/done 같은 운영 메타.
+  if (!has('--no-review')
+      && process.env.LEERNESS_NO_AUTO_REVIEW !== '1'
+      && !/^(done|dropped|blocked)$/i.test(arg('--status', 'requested'))
+      && text && text.trim()) {
+    try {
+      const t0 = Date.now();
+      const r = cp.spawnSync(process.execPath, [__filename, 'review-request', text, '--path', absRoot(root), '--json'], {
+        encoding: 'utf8', timeout: 15000,
+        env: { ...process.env, LEERNESS_NO_BANNER: '1', LEERNESS_NO_PROMPT: '1', LEERNESS_NO_DRIFT_CHECK: '1' }
+      });
+      if (r.status === 0 && r.stdout) {
+        const j = JSON.parse(r.stdout);
+        log('');
+        log(`🔍 review-request (1.9.177 자동): type=${j.estimatedType}` +
+            (j.conflicts.length ? ` · ⚠ ${j.conflicts.length} 충돌` : '') +
+            (j.reuseCandidates.length ? ` · 🔁 ${j.reuseCandidates.length} 재사용 후보` : '') +
+            ` · ${j.proceed ? '✓ 진행 안전' : '⚠ 확인 필요'} (${Date.now() - t0}ms)`);
+        // 권장 단계 첫 2건 노출
+        if (j.recommendedSteps && j.recommendedSteps.length) {
+          log('   권장 단계:');
+          j.recommendedSteps.slice(0, 2).forEach(s => log('     ' + s));
+          if (j.recommendedSteps.length > 2) log(`     ... +${j.recommendedSteps.length - 2}건 (leerness review-request "${text.slice(0, 30)}" 으로 전체 보기)`);
+        }
+        // 효율 제안 1건만
+        if (j.efficiencyHints && j.efficiencyHints.length) {
+          log(`   💡 ${j.efficiencyHints[0]}`);
+        }
+        if (!j.proceed) {
+          log(`   ⚠ ${j.proceedReason}`);
+        }
+      }
+    } catch {}  // review 실패는 task add 자체에 영향 X
+  }
 }
 function taskUpdate(root, id) {
   if (!id) return fail('id required (e.g., task update T-0001 --status in-progress)');
@@ -7770,6 +7806,94 @@ function releaseSyncMainCmd(root) {
   else ok(`main pushed → ${remoteName}/main`);
   // 5) return to source branch (release 작업 흐름 보존)
   cp.spawnSync('git', ['checkout', fromBranch], { cwd: root, encoding: 'utf8' });
+
+  // 1.9.178: 자동 npm publish (사용자 명시 — .env NPM_TOKEN 있으면 자동 배포).
+  //   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); }
+  }
+}
+
+// 1.9.178: NPM 자동 배포 (사용자 명시 — release sync-main 후 자동 trigger).
+//   보안:
+//     - NPM_TOKEN 또는 LEERNESS_NPM_TOKEN 환경변수에서만 읽음 (값 절대 로그 X)
+//     - 임시 .npmrc 파일 (mkdtempSync) 생성 → publish → 즉시 삭제 (finally)
+//     - 이미 publish된 버전 자동 detect → skip (중복 publish 차단)
+function _publishToNpm(root, opts = {}) {
+  root = absRoot(root || process.cwd());
+  // .env 자동 로드 (사용자 명시 패턴 — 1.9.153)
+  try { _loadEnvFile(root); } catch {}
+  const token = process.env.LEERNESS_NPM_TOKEN || process.env.NPM_TOKEN;
+  if (!token) {
+    log(`  ⚠ npm 자동 배포 스킵: NPM_TOKEN 미설정 (.env 에 NPM_TOKEN=npm_xxxxx 추가)`);
+    return;
+  }
+  // package.json 확인
+  const pkgPath = path.join(root, 'package.json');
+  if (!exists(pkgPath)) {
+    log(`  ⚠ npm 자동 배포 스킵: package.json 없음 (${rel(root, pkgPath)})`);
+    return;
+  }
+  let pkg;
+  try { pkg = JSON.parse(read(pkgPath)); } catch (e) { warn(`package.json 파싱 실패: ${e.message}`); return; }
+  if (!pkg.name || !pkg.version) {
+    log(`  ⚠ npm 자동 배포 스킵: name/version 누락`);
+    return;
+  }
+  const pkgName = pkg.name;
+  const pkgVersion = pkg.version;
+  log('');
+  log(`📦 npm publish 자동 trigger (1.9.178)`);
+  log(`   ${pkgName}@${pkgVersion}`);
+
+  // 1) 이미 publish된 버전인지 확인 (npm view <pkg>@<version> version)
+  try {
+    const viewR = cp.spawnSync('npm', ['view', `${pkgName}@${pkgVersion}`, 'version'], {
+      cwd: root, encoding: 'utf8', shell: true, timeout: 15000
+    });
+    if (viewR.status === 0 && (viewR.stdout || '').trim() === pkgVersion) {
+      log(`   ✓ 이미 npm registry에 publish됨 — skip`);
+      return;
+    }
+  } catch {}  // 네트워크 실패 시 그냥 publish 시도
+
+  // 2) 임시 .npmrc 생성 (토큰 노출 방지)
+  let tmpDir;
+  try {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-npmrc-'));
+    const tmpNpmrc = path.join(tmpDir, '.npmrc');
+    fs.writeFileSync(tmpNpmrc, `//registry.npmjs.org/:_authToken=${token}\n`, { mode: 0o600 });
+    // 3) npm publish (--userconfig 로 임시 .npmrc 사용, --access public)
+    const args = opts.dryRun ? ['publish', '--userconfig', tmpNpmrc, '--access', 'public', '--dry-run'] :
+                                ['publish', '--userconfig', tmpNpmrc, '--access', 'public'];
+    log(`   ${opts.dryRun ? '(dry-run) ' : ''}npm publish 시도 중...`);
+    const pubR = cp.spawnSync('npm', args, {
+      cwd: root, encoding: 'utf8', shell: true, timeout: 60000,
+      env: { ...process.env, npm_config_loglevel: 'warn' }
+    });
+    if (pubR.status === 0) {
+      ok(`npm publish 완료: ${pkgName}@${pkgVersion}`);
+      try { _recordRun(root, { kind: 'npm_publish', package: pkgName, version: pkgVersion, dryRun: !!opts.dryRun, ok: true }); } catch {}
+    } else {
+      const errOut = (pubR.stderr || pubR.stdout || '').slice(-400);
+      if (/EPUBLISHCONFLICT|already exists|cannot publish over/i.test(errOut)) {
+        log(`   ✓ 이미 publish됨 (race condition) — skip`);
+      } else if (/EAUTH|forbidden|401|403/i.test(errOut)) {
+        warn(`npm publish 실패: 토큰 권한 부족 또는 만료 — .env NPM_TOKEN 재발급 필요`);
+      } else if (/ENEEDAUTH/i.test(errOut)) {
+        warn(`npm publish 실패: 인증 미작동 — 토큰 형식 확인 (npm_xxxxx)`);
+      } else {
+        warn(`npm publish 실패 (exit ${pubR.status}): ${errOut.split('\n').slice(0, 3).join(' ')}`);
+      }
+      try { _recordRun(root, { kind: 'npm_publish', package: pkgName, version: pkgVersion, ok: false, error: errOut.slice(0, 200) }); } catch {}
+    }
+  } finally {
+    // 4) 임시 .npmrc 즉시 삭제 (토큰 잔존 방지)
+    if (tmpDir) {
+      try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch {}
+    }
+  }
 }
 
 // 1.9.40: release pack — 가벼운 통합 명령 (npm pack + self-host migrate + auto task + close + readme sync)

package/package.json

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