leerness 1.9.326 → 1.9.328

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 1.9.328 — 2026-06-05 — UR-0025(증분): 문자열 유틸(_truncate/_splitList) 분리
+
+**🧩 순수 문자열 유틸 2종을 lib/pure-utils 로 이전.** (UR-0025 micro-증분 계속)
+
+### 구현 (UR-0025)
+1. **`_truncate`**(말줄임표 절단) + **`_splitList`**(콤마 리스트 분할, trim+filter) → `lib/pure-utils.js`. harness 인라인 제거 → require.
+2. selftest 75→76 · e2e 272→273.
+
+### 검증
+- **selftest 76/76 PASS** · **E2E 273/273 PASS** (회귀 0).
+- 실측: `_truncate('hello world',8)`→`hello w…`·`_truncate('hi',8)`→`hi` · `_splitList('a, b ,c,')`→`["a","b","c"]`.
+
+## 1.9.327 — 2026-06-05 — UR-0025(증분): TZ/날짜 포맷 유틸 분리
+
+**🧩 순수 TZ/날짜 포맷 함수(`_getLocalTz`/`_formatLocal`)를 lib/pure-utils 로 이전.** (UR-0025 micro-증분 계속)
+
+### 구현 (UR-0025)
+1. **`_getLocalTz`**(env LEERNESS_TZ / 시스템 tz / Asia/Seoul fallback) + **`_formatLocal`**(ISO UTC → local 표시, 예 "2026-06-05 10:13 KST") → `lib/pure-utils.js`. harness 인라인 제거 → require.
+2. selftest 74→75 · e2e 271→272.
+
+### 검증
+- **selftest 75/75 PASS** · **E2E 272/272 PASS** (회귀 0, import-블록 견고 패턴).
+- 실측: `_formatLocal('…01:13Z', {tz:'Asia/Seoul'})`→`2026-06-05 10:13 KST`(UTC+9) · dateOnly→`2026-06-05` · 빈값→`?`.
+
 ## 1.9.326 — 2026-06-05 — UR-0025(증분): 순수 문자열/셸/env 유틸 3종 분리
 
 **🧩 순수 유틸 3종(`_sanitizeFences`/`_shellQuoteArg`/`_detectPwshFromEnv`)을 lib/pure-utils 로 이전.** (사용자 선택: UR-0025 micro-증분 계속)

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.326-green)]() [![tests](https://img.shields.io/badge/e2e-271%2F271-success)]() [![selftest](https://img.shields.io/badge/selftest-74-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-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.328-green)]() [![tests](https://img.shields.io/badge/e2e-273%2F273-success)]() [![selftest](https://img.shields.io/badge/selftest-76-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-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.326 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.328 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -525,7 +525,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.326는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
+Leerness v1.9.328는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.326는 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.326)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.328)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -584,6 +584,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.326: 2026-06-05
+Last synced by Leerness v1.9.328: 2026-06-05
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -11,13 +11,14 @@ const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel,
   PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord,
   _htmlToText, _extractTitle, _extractLinks,
   _countDatedBlocks, _extractDecisionBlocks, _classifyIntent,
-  _sanitizeFences, _shellQuoteArg, _detectPwshFromEnv } = require('../lib/pure-utils');  // 1.9.318~326 (UR-0025): 순수 HTML/메모리/intent/문자열·셸·env 분리
+  _sanitizeFences, _shellQuoteArg, _detectPwshFromEnv,
+  _getLocalTz, _formatLocal, _truncate, _splitList } = require('../lib/pure-utils');  // 1.9.318~328 (UR-0025): 순수 HTML/메모리/intent/문자열·셸·env/날짜 분리
 // 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 } = require('../lib/catalogs');
 
-const VERSION = '1.9.326';
+const VERSION = '1.9.328';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -222,40 +223,7 @@ function _withLock(targetPath, fn, opts = {}) {
 function rel(root, p) { return path.relative(root, p).replace(/\\/g, '/') || '.'; }
 function today() { return new Date().toISOString().slice(0, 10); }
 function now() { return new Date().toISOString(); }
-// 1.9.204: timezone 보강 (사용자 명시)
-//   ISO UTC timestamp 저장은 유지 (이식성/일관성) → display 시 사용자 local time 변환
-//   환경변수: LEERNESS_TZ (default = 시스템 timezone, fallback: 'Asia/Seoul')
-function _getLocalTz() {
-  if (process.env.LEERNESS_TZ) return process.env.LEERNESS_TZ;
-  try {
-    const sys = Intl.DateTimeFormat().resolvedOptions().timeZone;
-    if (sys && sys !== 'UTC') return sys;
-  } catch {}
-  return 'Asia/Seoul';
-}
-// ISO timestamp → local time 표시 (예: "2026-05-22 10:13 KST")
-function _formatLocal(iso, opts) {
-  if (!iso) return '?';
-  opts = opts || {};
-  const tz = opts.tz || _getLocalTz();
-  try {
-    const d = typeof iso === 'string' ? new Date(iso) : iso;
-    if (isNaN(d.getTime())) return String(iso);
-    const fmt = new Intl.DateTimeFormat('en-CA', {
-      timeZone: tz,
-      year: 'numeric', month: '2-digit', day: '2-digit',
-      hour: '2-digit', minute: '2-digit',
-      hour12: false
-    });
-    const parts = fmt.formatToParts(d);
-    const get = (t) => (parts.find(p => p.type === t) || {}).value || '';
-    const date = `${get('year')}-${get('month')}-${get('day')}`;
-    const time = `${get('hour')}:${get('minute')}`;
-    // tz 약어 (KST/JST/UTC 등) — 간단 추출
-    const tzShort = tz === 'Asia/Seoul' ? 'KST' : tz === 'Asia/Tokyo' ? 'JST' : tz === 'UTC' ? 'UTC' : tz.split('/').pop().slice(0, 3);
-    return opts.dateOnly ? date : `${date} ${time} ${tzShort}`;
-  } catch { return String(iso); }
-}
+// 1.9.327 (UR-0025): _getLocalTz / _formatLocal → lib/pure-utils.js 로 이동 (순수 TZ/날짜 포맷, require 사용).
 // 자동 모드 활성 여부 (R-XXXX every-round 룰 존재 시 true)
 function _isAutoLoopActive(root) {
   try {
@@ -3100,6 +3068,8 @@ function _selfTestCases() {
     { name: 'lib/pure-utils: 메모리 MD 파서 분리(_countDatedBlocks/_extractDecisionBlocks) + _compareSemver 중복제거 (UR-0025 1.9.324)', run: () => { const m = require('../lib/pure-utils'); const fnOk = typeof m._countDatedBlocks === 'function' && typeof m._extractDecisionBlocks === 'function'; const work = m._countDatedBlocks('```md\n### 2026-01-01 — T\n```\n### 2026-06-05 — R\n') === 1 && m._extractDecisionBlocks('### 2026-06-05 — A\n- Decision: x\n').length === 1; const src = read(__filename); const moved = m._countDatedBlocks === _countDatedBlocks && m._extractDecisionBlocks === _extractDecisionBlocks && !/^function _countDatedBlocks\(/m.test(src) && !/^function _compareSemver\(/m.test(src); return fnOk && work && moved; } },
     { name: 'lib/pure-utils: _classifyIntent 분리 (precise/broad/default 분류) + 인라인 제거 (UR-0025 1.9.325)', run: () => { const m = require('../lib/pure-utils'); const fnOk = typeof m._classifyIntent === 'function'; const work = m._classifyIntent('정확히 그것만').intent === 'precise' && m._classifyIntent('전체 다양한 기능').intent === 'broad' && m._classifyIntent('로그인 구현').intent === 'default'; const moved = m._classifyIntent === _classifyIntent && !/^function _classifyIntent\(/m.test(read(__filename)); return fnOk && work && moved; } },
     { name: 'lib/pure-utils: 문자열/셸/env 유틸 분리(_sanitizeFences/_shellQuoteArg/_detectPwshFromEnv) (UR-0025 1.9.326)', run: () => { const m = require('../lib/pure-utils'); const fnOk = typeof m._sanitizeFences === 'function' && typeof m._shellQuoteArg === 'function' && typeof m._detectPwshFromEnv === 'function'; const work = m._sanitizeFences('a```b') === "a'''b" && m._detectPwshFromEnv({ POWERSHELL_DISTRIBUTION_CHANNEL: 'X' }).version === '7' && /^['"]/.test(m._shellQuoteArg('a b')); const src = read(__filename); const moved = m._sanitizeFences === _sanitizeFences && !/^function _sanitizeFences\(/m.test(src) && !/^function _shellQuoteArg\(/m.test(src) && !/^function _detectPwshFromEnv\(/m.test(src); return fnOk && work && moved; } },
+    { name: 'lib/pure-utils: TZ/날짜 포맷 분리(_getLocalTz/_formatLocal) + 인라인 제거 (UR-0025 1.9.327)', run: () => { const m = require('../lib/pure-utils'); const fnOk = typeof m._getLocalTz === 'function' && typeof m._formatLocal === 'function'; const work = m._formatLocal('2026-06-05T01:13:00.000Z', { tz: 'Asia/Seoul' }) === '2026-06-05 10:13 KST' && m._formatLocal('2026-06-05T01:13:00.000Z', { tz: 'Asia/Seoul', dateOnly: true }) === '2026-06-05' && m._formatLocal('') === '?'; const src = read(__filename); const moved = m._formatLocal === _formatLocal && !/^function _formatLocal\(/m.test(src) && !/^function _getLocalTz\(/m.test(src); return fnOk && work && moved; } },
+    { name: 'lib/pure-utils: 문자열 유틸 분리(_truncate/_splitList) + 인라인 제거 (UR-0025 1.9.328)', run: () => { const m = require('../lib/pure-utils'); const work = m._truncate('hello world', 8) === 'hello w…' && m._truncate('hi', 8) === 'hi' && JSON.stringify(m._splitList('a, b ,c,')) === '["a","b","c"]'; const src = read(__filename); const moved = m._truncate === _truncate && m._splitList === _splitList && !/^function _truncate\(/m.test(src) && !/^function _splitList\(/m.test(src); return work && moved; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -13586,7 +13556,7 @@ const ROADMAP_STATUS_COLOR = { done: '#16a34a', 'in-progress': '#2563eb', 'on-ho
 const ROADMAP_NODE_W = 220, ROADMAP_NODE_H = 72, ROADMAP_COL_GAP = 70, ROADMAP_ROW_GAP = 14;
 
 function _esc(s) { return String(s == null ? '' : s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;'); }
-function _truncate(s, n) { s = String(s || ''); return s.length > n ? s.slice(0, n - 1) + '…' : s; }
+// 1.9.328 (UR-0025): _truncate → lib/pure-utils.js 로 이동 (순수 문자열 절단, require 사용).
 
 function _roadmapMapStatus(s) {
   s = String(s || '').toLowerCase();
@@ -18214,7 +18184,7 @@ function _updateRun(root, id, mutator) {
     return rec;
   });
 }
-function _splitList(v) { return String(v || '').split(',').map(s => s.trim()).filter(Boolean); }
+// 1.9.328 (UR-0025): _splitList → lib/pure-utils.js 로 이동 (순수 콤마 리스트 분할, require 사용).
 
 // leerness state <show|start|record|verify|handoff>
 // 1.9.292 (UR-0031): get_project_context — 외부 에이전트 온보딩용 단일 집약 컨텍스트.

package/lib/pure-utils.js

@@ -253,6 +253,41 @@ function _detectPwshFromEnv(e) {
   return { isPowerShell: false, version: null, edition: null };
 }
 
+// 1.9.327 (UR-0025): 순수 TZ/날짜 포맷 — ISO UTC 저장 유지, 표시 시 local 변환 (env LEERNESS_TZ / 시스템 tz / Asia/Seoul fallback).
+function _getLocalTz() {
+  if (process.env.LEERNESS_TZ) return process.env.LEERNESS_TZ;
+  try {
+    const sys = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    if (sys && sys !== 'UTC') return sys;
+  } catch {}
+  return 'Asia/Seoul';
+}
+function _formatLocal(iso, opts) {
+  if (!iso) return '?';
+  opts = opts || {};
+  const tz = opts.tz || _getLocalTz();
+  try {
+    const d = typeof iso === 'string' ? new Date(iso) : iso;
+    if (isNaN(d.getTime())) return String(iso);
+    const fmt = new Intl.DateTimeFormat('en-CA', {
+      timeZone: tz,
+      year: 'numeric', month: '2-digit', day: '2-digit',
+      hour: '2-digit', minute: '2-digit',
+      hour12: false
+    });
+    const parts = fmt.formatToParts(d);
+    const get = (t) => (parts.find(p => p.type === t) || {}).value || '';
+    const date = `${get('year')}-${get('month')}-${get('day')}`;
+    const time = `${get('hour')}:${get('minute')}`;
+    const tzShort = tz === 'Asia/Seoul' ? 'KST' : tz === 'Asia/Tokyo' ? 'JST' : tz === 'UTC' ? 'UTC' : tz.split('/').pop().slice(0, 3);
+    return opts.dateOnly ? date : `${date} ${time} ${tzShort}`;
+  } catch { return String(iso); }
+}
+
+// 1.9.328 (UR-0025): 순수 문자열 유틸 — 절단(말줄임표) / 콤마 리스트 분할.
+function _truncate(s, n) { s = String(s || ''); return s.length > n ? s.slice(0, n - 1) + '…' : s; }
+function _splitList(v) { return String(v || '').split(',').map(s => s.trim()).filter(Boolean); }
+
 module.exports = {
   _isSecretKey, compareVer, parseHarnessVersion,
   _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
@@ -265,5 +300,9 @@ module.exports = {
   // 1.9.325 (UR-0025): 순수 intent 분류
   _classifyIntent,
   // 1.9.326 (UR-0025): 순수 문자열/셸/env 유틸
-  _sanitizeFences, _shellQuoteArg, _detectPwshFromEnv
+  _sanitizeFences, _shellQuoteArg, _detectPwshFromEnv,
+  // 1.9.327 (UR-0025): 순수 TZ/날짜 포맷
+  _getLocalTz, _formatLocal,
+  // 1.9.328 (UR-0025): 순수 문자열 유틸
+  _truncate, _splitList
 };

package/package.json

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

package/scripts/e2e.js

@@ -3971,5 +3971,44 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.327 회귀 (UR-0025 모듈화): TZ/날짜 포맷 2종 lib/pure-utils 분리 + harness 인라인 제거
+total++;
+{
+  let ok = false;
+  try {
+    const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
+    const fnOk = typeof m._getLocalTz === 'function' && typeof m._formatLocal === 'function';
+    const work = m._formatLocal('2026-06-05T01:13:00.000Z', { tz: 'Asia/Seoul' }) === '2026-06-05 10:13 KST'  // UTC→KST +9h
+      && m._formatLocal('2026-06-05T01:13:00.000Z', { tz: 'Asia/Seoul', dateOnly: true }) === '2026-06-05'
+      && m._formatLocal('') === '?' && typeof m._getLocalTz() === 'string';
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
+    const movedOut = !/function _formatLocal\(/.test(harnessSrc) && !/function _getLocalTz\(/.test(harnessSrc)
+      && _puImp.includes('_getLocalTz') && _puImp.includes('_formatLocal');
+    ok = fnOk && work && movedOut;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.327) lib/pure-utils TZ/날짜 포맷 분리: 모듈 단일출처 + 인라인 제거 (UR-0025)' : '✗ TZ/날짜 포맷 분리 실패');
+  if (!ok) failed++;
+}
+
+// 1.9.328 회귀 (UR-0025 모듈화): 순수 문자열 유틸 2종(_truncate/_splitList) lib/pure-utils 분리 + harness 인라인 제거
+total++;
+{
+  let ok = false;
+  try {
+    const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
+    const work = typeof m._truncate === 'function' && typeof m._splitList === 'function'
+      && m._truncate('hello world', 8) === 'hello w…' && m._truncate('hi', 8) === 'hi'
+      && JSON.stringify(m._splitList('a, b ,c,')) === '["a","b","c"]';
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const _puImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/pure-utils'\)/) || [''])[0];  // import 순서 비의존
+    const movedOut = !/function _truncate\(/.test(harnessSrc) && !/function _splitList\(/.test(harnessSrc)
+      && _puImp.includes('_truncate') && _puImp.includes('_splitList');
+    ok = work && movedOut;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.328) lib/pure-utils 문자열 유틸 분리: 모듈 단일출처 + 인라인 제거 (UR-0025)' : '✗ 문자열 유틸 분리 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);