leerness 1.9.282 → 1.9.283

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.9.283 — 2026-06-03 — UR-0025 2단계: 순수 함수 추가 모듈 분리 (lib/pure-utils 7→14종)
+
+**🧩 GPT-5.5 "1.2MB 단일 파일" 지적의 점진적·비파괴 모듈화 계속 — 최근 추가한 순수 로직을 lib/ 로 추출.**
+
+### 구현
+1. **`lib/pure-utils.js` 7 → 14 export** — 권한 등급(`PERMISSION_TIERS`/`_tierRank`/`_requiredTier`/`_policyAllows`) + dist-tag(`_resolveNpmTag`) + run 스키마(`_newRunRecord`) + mcp.json(`_mcpJsonContent`) 추가 이동. 모두 harness 내부 상태 의존 0(순수).
+2. **harness.js require 재연결** — 상단 destructure 확장 + 인라인 정의 7개 제거(`module.exports` 재노출 유지). 동작 동일.
+3. e2e lib 테스트 7 → 14종 export + 동작 검증. selftest 31/31 그대로(이미 해당 함수 커버).
+
+### 검증
+- **selftest 31/31 PASS** · **E2E 229/229 PASS** (회귀 0) · `npm pack` tarball lib 포함 · require 무결성(14종 함수 + PERMISSION_TIERS) 확인.
+
 ## 1.9.282 — 2026-06-03 — UR-0035: AGENTS.md(정적) vs leerness(동적) 포지셔닝 — 범용 하네스 전략 완성
 
 **🧭 GPT-5.5 마지막 전략 항목 — leerness 는 AGENTS.md 를 대체하지 않고 보완. 정적 지침 vs 동적 상태 역할 경계 명시.**

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.282-green)]() [![tests](https://img.shields.io/badge/e2e-229%2F229-success)]() [![selftest](https://img.shields.io/badge/selftest-24%2F24-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-80-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.283-green)]() [![tests](https://img.shields.io/badge/e2e-229%2F229-success)]() [![selftest](https://img.shields.io/badge/selftest-24%2F24-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-80-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.282 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.283 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### Core Commands
 
@@ -513,7 +513,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.282는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
+Leerness v1.9.283는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -534,7 +534,7 @@ Leerness v1.9.282는 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.282)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.283)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -572,6 +572,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.9.282: 2026-06-03
+Last synced by Leerness v1.9.283: 2026-06-03
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -7,9 +7,10 @@ const cp = require('child_process');
 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종이 동작 검증.
-const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp } = require('../lib/pure-utils');
+const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
+  PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord } = require('../lib/pure-utils');
 
-const VERSION = '1.9.282';
+const VERSION = '1.9.283';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -14279,12 +14280,7 @@ 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';
-}
+// _resolveNpmTag → lib/pure-utils.js 로 이동 (1.9.283 UR-0025 2단계)
 // 1.9.275 (UR-0026): leerness release channel — 안정/실험 채널 정책 + 버전 고정 안내 (npm dist-tag).
 function releaseChannelCmd(root) {
   root = absRoot(root || process.cwd());
@@ -18068,21 +18064,7 @@ function capabilitiesCmd(root, opts = {}) {
 // ===== 1.9.281 (UR-0034, GPT-5.5 범용 하네스): 권한 등급(permission tiers) =====
 //   capabilities(1.9.272 공개)를 enforced 등급으로 확장. 기본 OFF(opt-in) — enforce 켤 때만 차단.
 //   등급 오름차순(왼→오 위험↑). 허용 등급 이하의 명령만 통과. 기본 허용 'project-write'(파일 작업까지, 셸/git/publish 차단).
-const PERMISSION_TIERS = ['read-only', 'safe-write', 'project-write', 'shell-read', 'shell-write', 'git-write', 'network', 'publish'];
-function _tierRank(t) { const i = PERMISSION_TIERS.indexOf(String(t || '')); return i < 0 ? PERMISSION_TIERS.length : i; }
-// 명령/capability → 요구 등급 (순수 함수, selftest)
-function _requiredTier(cmd) {
-  const c = String(cmd || '').toLowerCase();
-  if (/release\s+publish|npm\s+publish|\bpublish\b/.test(c)) return 'publish';
-  if (/\bweb\b/.test(c)) return 'network';
-  if (/git\s+push|sync-main/.test(c)) return 'git-write';
-  if (/multi\s+--execute|dispatch\s+--write|--yolo|\bpc\b/.test(c)) return 'shell-write';
-  if (/agents\s+(list|quota|bench)|--run-tests/.test(c)) return 'shell-read';
-  if (/\binit\b|\badapter\b|update\s+--yes|\bmigrate\b/.test(c)) return 'project-write';
-  if (/state\s+(start|record|verify|handoff)|decision|lesson|plan\s+add|task\s+add|rule\s+add/.test(c)) return 'safe-write';
-  return 'read-only';
-}
-function _policyAllows(allowedTier, requiredTier) { return _tierRank(requiredTier) <= _tierRank(allowedTier); }
+// PERMISSION_TIERS / _tierRank / _requiredTier / _policyAllows → lib/pure-utils.js 로 이동 (1.9.283 UR-0025 2단계)
 function _policyFile(root) { return path.join(_leernessStateDir(root), 'policy.json'); }
 function _loadPolicy(root) {
   const f = _policyFile(root);
@@ -18148,28 +18130,7 @@ function policyCmd(root, sub, ...args) {
 //   Claude Code 가 한 작업을 Goose/Codex 가 JSON 으로 정확히 이어받음. 비파괴 (신규 .leerness/ 디렉토리).
 //   향후 UR-0031(MCP verb)/UR-0033(adapter) 가 이 스키마를 공통 호출 표면으로 사용.
 function _leernessStateDir(root) { return path.join(absRoot(root), '.leerness'); }
-// 순수 함수: run 레코드 빌더 (모든 필드 기본값 — GPT-5.5 권고 스키마). startedAt 주입 가능(selftest).
-function _newRunRecord(opts = {}) {
-  return {
-    schemaVersion: 1,
-    run_id: opts.run_id || null,
-    task_id: opts.task_id || null,
-    agent_name: opts.agent_name || null,
-    model_name: opts.model_name || null,
-    started_at: opts.started_at || new Date().toISOString(),
-    ended_at: opts.ended_at || null,
-    goal: opts.goal || '',
-    files_read: Array.isArray(opts.files_read) ? opts.files_read : [],
-    files_changed: Array.isArray(opts.files_changed) ? opts.files_changed : [],
-    commands_run: Array.isArray(opts.commands_run) ? opts.commands_run : [],
-    tests_run: Array.isArray(opts.tests_run) ? opts.tests_run : [],
-    errors: Array.isArray(opts.errors) ? opts.errors : [],
-    decisions: Array.isArray(opts.decisions) ? opts.decisions : [],
-    verification_result: opts.verification_result || null,  // 'pass' | 'fail' | null
-    handoff_summary: opts.handoff_summary || null,
-    status: opts.status || 'in-progress'                    // in-progress | verified | handed-off
-  };
-}
+// _newRunRecord → lib/pure-utils.js 로 이동 (1.9.283 UR-0025 2단계)
 function _loadLeernessState(root) {
   const f = path.join(_leernessStateDir(root), 'state.json');
   if (!exists(f)) return { schemaVersion: 1, project: detectProjectName(root), currentRunId: null, runCounter: 0, updatedAt: null };
@@ -18296,9 +18257,7 @@ const ADAPTERS = {
   aider:    { label: 'Aider', keys: ['AGENTS.md'], mcp: false },
   qwen:     { label: 'Qwen Code', keys: ['AGENTS.md'], mcp: false }
 };
-function _mcpJsonContent() {
-  return JSON.stringify({ mcpServers: { leerness: { command: 'npx', args: ['leerness', 'mcp', 'serve'] } } }, null, 2) + '\n';
-}
+// _mcpJsonContent → lib/pure-utils.js 로 이동 (1.9.283 UR-0025 2단계)
 // .mcp.json 병합 — 기존 mcpServers 보존하고 leerness 항목만 추가/갱신.
 function _mergeMcpJson(root) {
   const f = path.join(absRoot(root), '.mcp.json');

package/lib/pure-utils.js

@@ -103,7 +103,61 @@ function _parseSlashFromHelp(text, invoke = 'slash') {
   return out;
 }
 
+// 1.9.283 (UR-0025 2단계): 권한 등급(permission tiers) 순수 로직 — capabilities/policy 공유.
+const PERMISSION_TIERS = ['read-only', 'safe-write', 'project-write', 'shell-read', 'shell-write', 'git-write', 'network', 'publish'];
+function _tierRank(t) { const i = PERMISSION_TIERS.indexOf(String(t || '')); return i < 0 ? PERMISSION_TIERS.length : i; }
+// 명령/capability → 요구 등급 (순수 매핑)
+function _requiredTier(cmd) {
+  const c = String(cmd || '').toLowerCase();
+  if (/release\s+publish|npm\s+publish|\bpublish\b/.test(c)) return 'publish';
+  if (/\bweb\b/.test(c)) return 'network';
+  if (/git\s+push|sync-main/.test(c)) return 'git-write';
+  if (/multi\s+--execute|dispatch\s+--write|--yolo|\bpc\b/.test(c)) return 'shell-write';
+  if (/agents\s+(list|quota|bench)|--run-tests/.test(c)) return 'shell-read';
+  if (/\binit\b|\badapter\b|update\s+--yes|\bmigrate\b/.test(c)) return 'project-write';
+  if (/state\s+(start|record|verify|handoff)|decision|lesson|plan\s+add|task\s+add|rule\s+add/.test(c)) return 'safe-write';
+  return 'read-only';
+}
+function _policyAllows(allowedTier, requiredTier) { return _tierRank(requiredTier) <= _tierRank(allowedTier); }
+
+// 1.9.283: npm dist-tag 결정 (UR-0026) — 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.283: .mcp.json 내용 (UR-0033) — leerness MCP 서버 등록.
+function _mcpJsonContent() {
+  return JSON.stringify({ mcpServers: { leerness: { command: 'npx', args: ['leerness', 'mcp', 'serve'] } } }, null, 2) + '\n';
+}
+
+// 1.9.283: run 레코드 빌더 (UR-0032) — GPT-5.5 권고 14필드. startedAt 주입 가능(테스트).
+function _newRunRecord(opts = {}) {
+  return {
+    schemaVersion: 1,
+    run_id: opts.run_id || null,
+    task_id: opts.task_id || null,
+    agent_name: opts.agent_name || null,
+    model_name: opts.model_name || null,
+    started_at: opts.started_at || new Date().toISOString(),
+    ended_at: opts.ended_at || null,
+    goal: opts.goal || '',
+    files_read: Array.isArray(opts.files_read) ? opts.files_read : [],
+    files_changed: Array.isArray(opts.files_changed) ? opts.files_changed : [],
+    commands_run: Array.isArray(opts.commands_run) ? opts.commands_run : [],
+    tests_run: Array.isArray(opts.tests_run) ? opts.tests_run : [],
+    errors: Array.isArray(opts.errors) ? opts.errors : [],
+    decisions: Array.isArray(opts.decisions) ? opts.decisions : [],
+    verification_result: opts.verification_result || null,
+    handoff_summary: opts.handoff_summary || null,
+    status: opts.status || 'in-progress'
+  };
+}
+
 module.exports = {
   _isSecretKey, compareVer, parseHarnessVersion,
-  _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp
+  _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
+  // 1.9.283 (UR-0025 2단계)
+  PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord
 };

package/package.json

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

package/scripts/e2e.js

@@ -2793,13 +2793,19 @@ total++;
   let exportsOk = false;
   try {
     const m = require(libPath);
-    exportsOk = ['_isSecretKey','compareVer','parseHarnessVersion','_classifyCJK','_riskLabel','_detectSystemLang','_parseSlashFromHelp']
-      .every(n => typeof m[n] === 'function') && m.compareVer('1.9.1','1.9.0') === 1 && m._detectSystemLang({ LANG: 'ko_KR.UTF-8' }) === 'ko';
+    // 1.9.283: 1단계 7종 + 2단계 7종(권한등급/dist-tag/run스키마/mcp.json)
+    exportsOk = ['_isSecretKey','compareVer','parseHarnessVersion','_classifyCJK','_riskLabel','_detectSystemLang','_parseSlashFromHelp',
+      '_tierRank','_requiredTier','_policyAllows','_resolveNpmTag','_mcpJsonContent','_newRunRecord']
+      .every(n => typeof m[n] === 'function')
+      && m.compareVer('1.9.1','1.9.0') === 1 && m._detectSystemLang({ LANG: 'ko_KR.UTF-8' }) === 'ko'
+      && Array.isArray(m.PERMISSION_TIERS) && m.PERMISSION_TIERS.length === 8
+      && m._requiredTier('release publish') === 'publish' && m._resolveNpmTag(null, {}) === 'latest'
+      && m._newRunRecord({ run_id: 'r1' }).schemaVersion === 1;
   } catch {}
   let filesOk = false;
   try { const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, '..', 'package.json'), 'utf8')); filesOk = Array.isArray(pkg.files) && pkg.files.includes('lib'); } catch {}
   const ok = libExists && exportsOk && filesOk;
-  console.log(ok ? '✓ B(1.9.274) lib 모듈 분리: pure-utils 7종 export + 동작 + files 포함' : `✗ lib 분리 실패 (exists=${libExists} exports=${exportsOk} files=${filesOk})`);
+  console.log(ok ? '✓ B(1.9.274/283) lib 모듈 분리: pure-utils 14종 export + 동작 + files 포함' : `✗ lib 분리 실패 (exists=${libExists} exports=${exportsOk} files=${filesOk})`);
   if (!ok) failed++;
 }