leerness 1.9.272 → 1.9.273

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.9.273 — 2026-06-03 — UR-0027: 빠른 테스트 서브셋 (test:fast smoke) — npm test 5분 초과 해소
+
+**⚡ 전체 e2e(220+, 수 분) 외에 핵심-경로만 빠르게 확인하는 `npm run test:fast`(~10초) 추가 (GPT-5.5 리뷰 반영).**
+
+### 배경
+GPT-5.5 외부 리뷰에서 `npm test`(전체 e2e)가 5분 제한 안에 끝나지 않아 외부 환경에서 완료 확인이 어렵다고 지적(UR-0027). 전체 e2e 는 신뢰도(CI/릴리스 게이트)에 필요하므로 유지하되, 개발 중 빠른 피드백용 경량 smoke 를 분리.
+
+### 구현
+1. **`scripts/smoke.js` 신규** — 단일 임시 프로젝트에서 핵심 명령 13종(version/selftest/init/status/verify/handoff/audit/drift/session close/scan secrets/encoding/roles/capabilities)만 빠르게 검증. 실패 시 exit 1. **~10초** (전체 e2e 5분+ 대비).
+2. **`npm run test:fast`** — `selftest + smoke.js`. README 기여 섹션에 안내.
+3. **CI 빠른 잡** — `.github/workflows/ci.yml` 에 `fast`(selftest+smoke, ubuntu/node20) 잡 추가 → PR 즉시 피드백, 전체 e2e 매트릭스는 병행.
+4. **e2e +1 (220→221)** — test:fast 인프라(smoke.js 존재+구문+package script) 회귀 검증.
+
+### 검증
+- **test:fast 13/13 PASS · ~10.7초** · **selftest 25/25** · **E2E 221/221 PASS** (회귀 0).
+
 ## 1.9.272 — 2026-06-03 — 공개 신뢰도·투명성 강화 (GPT-5.5 외부 리뷰 반영)
 
 **🔒 외부 평가(GPT-5.5 직접 실행/검사, 7/10)에서 지적된 공개 패키지 신뢰도·투명성 항목을 반영.**

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.272-green)]() [![tests](https://img.shields.io/badge/e2e-220%2F220-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.273-green)]() [![tests](https://img.shields.io/badge/e2e-221%2F221-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)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -386,6 +386,11 @@ leerness capabilities          # capability surface + opt-out + cautious command
 
 - Issues: https://github.com/gugu9999gu/leerness/issues
 - PRs: e2e 통과 + 한국어 주석 + UTF-8 (no BOM) / pass e2e, Korean comments, UTF-8 without BOM.
+- 테스트 / Tests:
+  ```bash
+  npm run test:fast   # 빠른 핵심-경로 smoke (selftest + 13 체크, ~10초) / fast core-path smoke (~10s)
+  npm test            # 전체 게이트 (selftest + e2e 220+) / full gate
+  ```
 
 ## 📄 License
 
@@ -397,7 +402,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.272 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.273 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### Core Commands
 
@@ -439,7 +444,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.272는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
+Leerness v1.9.273는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -460,7 +465,7 @@ Leerness v1.9.272는 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.272)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.273)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -498,6 +503,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.272: 2026-06-03
+Last synced by Leerness v1.9.273: 2026-06-03
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -7,7 +7,7 @@ const cp = require('child_process');
 const os = require('os');  // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
 const readline = require('readline');
 
-const VERSION = '1.9.272';
+const VERSION = '1.9.273';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.9.272",
+  "version": "1.9.273",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",
@@ -47,6 +47,7 @@
   ],
   "scripts": {
     "test": "node ./bin/harness.js --version && node ./bin/harness.js selftest && node ./scripts/e2e.js",
+    "test:fast": "node ./bin/harness.js selftest && node ./scripts/smoke.js",
     "test:smoke": "node ./scripts/e2e.js",
     "prepack": "node ./bin/harness.js readme sync . && node ./bin/harness.js --version"
   },

package/scripts/e2e.js

@@ -2766,5 +2766,22 @@ total++;
   if (!ok) { failed++; console.log((rJson.stdout || '').slice(0, 300)); }
 }
 
+// 1.9.273 회귀 (UR-0027): 빠른 테스트 인프라 존재 검증 (smoke.js + test:fast script). 실제 smoke 실행은 별도(npm run test:fast).
+total++;
+{
+  const smokePath = path.resolve(__dirname, 'smoke.js');
+  const smokeExists = fs.existsSync(smokePath);
+  // 구문 유효성 (node --check)
+  const syn = smokeExists ? cp.spawnSync(process.execPath, ['--check', smokePath], { encoding: 'utf8', timeout: 15000 }) : { status: 1 };
+  let scriptOk = false;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, '..', 'package.json'), 'utf8'));
+    scriptOk = !!(pkg.scripts && pkg.scripts['test:fast'] && /smoke\.js/.test(pkg.scripts['test:fast']));
+  } catch {}
+  const ok = smokeExists && syn.status === 0 && scriptOk;
+  console.log(ok ? '✓ B(1.9.273) test:fast 인프라: smoke.js 존재 + 구문 + package script' : `✗ test:fast 실패 (exists=${smokeExists} syntax=${syn.status === 0} script=${scriptOk})`);
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed`);
 if (failed > 0) process.exit(1);

package/scripts/smoke.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+'use strict';
+
+// 1.9.273 (UR-0027, GPT-5.5 리뷰): 빠른 핵심-경로 smoke 테스트.
+//   전체 e2e(220 케이스, 수 분)는 CI/릴리스 게이트용. 이 smoke 는 개발 중 빠른 피드백(<30s)용 —
+//   핵심 명령이 정상 동작하는지만 단일 임시 프로젝트에서 빠르게 확인한다.
+//   실패 시 exit 1 (CI 친화). 사용: npm run test:fast  또는  node scripts/smoke.js
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const cp = require('child_process');
+
+process.env.LEERNESS_OFFLINE = process.env.LEERNESS_OFFLINE || '1';
+const CLI = path.resolve(__dirname, '..', 'bin', 'harness.js');
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-smoke-'));
+let failed = 0, total = 0;
+const t0 = Date.now();
+
+// 단일 명령 실행 + assert. check(라벨, args, {expectFail?, match?(stdout)→bool})
+function check(label, args, opts = {}) {
+  total++;
+  const r = cp.spawnSync(process.execPath, [CLI, ...args], { cwd: opts.cwd || tmp, encoding: 'utf8', timeout: 30000 });
+  let ok = (r.status === 0) === !opts.expectFail;
+  if (ok && typeof opts.match === 'function') { try { ok = !!opts.match(r.stdout || '', r.stderr || ''); } catch { ok = false; } }
+  process.stdout.write(`${ok ? '✓' : '✗'} ${label}${opts.expectFail ? ' (expect-fail)' : ''}\n`);
+  if (!ok) { failed++; process.stdout.write((r.stdout || '').slice(0, 300)); process.stderr.write((r.stderr || '').slice(0, 200)); }
+  return { ok, stdout: r.stdout || '', stderr: r.stderr || '', status: r.status };
+}
+
+console.log(`# leerness smoke (test:fast) @ ${tmp}`);
+
+// 1) 코어 무결성
+check('--version', ['--version'], { match: s => /^\d+\.\d+\.\d+/.test(s.trim()) });
+check('selftest (pure 함수 무결성)', ['selftest'], { match: s => /통과/.test(s) });
+
+// 2) 설치 + 필수 파일
+check('init', ['init', tmp, '--yes', '--language', 'ko', '--skills', 'recommended']);
+check('status', ['status', tmp], { match: s => /present|존재|설치/.test(s) || true });
+check('verify (필수 파일)', ['verify', tmp]);
+
+// 3) 세션 워크플로
+check('handoff', ['handoff', tmp]);
+check('audit', ['audit', tmp]);
+check('drift check', ['drift', 'check', tmp], { match: s => /drift/i.test(s) });
+check('session close', ['session', 'close', tmp]);
+
+// 4) 보안·인코딩 가드
+check('scan secrets', ['scan', 'secrets', tmp]);
+check('encoding check', ['encoding', 'check', tmp]);
+
+// 5) 신규 기능 스모크 (역할 1.9.270 / 권한공개 1.9.272)
+check('roles set + list', ['roles', 'set', 'coder', '--provider', 'codex', '--model', 'gpt-5.5', '--path', tmp, '--json'],
+  { match: s => { try { return JSON.parse(s).set === 'coder'; } catch { return false; } } });
+check('capabilities --json', ['capabilities', '--json'],
+  { match: s => { try { const j = JSON.parse(s); return j.surface && Object.keys(j.surface).length === 6; } catch { return false; } } });
+
+const dur = ((Date.now() - t0) / 1000).toFixed(1);
+console.log(`\nSmoke result: ${total - failed}/${total} passed · ${dur}s`);
+if (failed > 0) process.exit(1);