leerness 1.9.310 → 1.9.311

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.9.311 — 2026-06-04 — UR-0047: init 가드 (설치리뷰 3중수렴 high)
+
+**🛡 미초기화 디렉토리에서 write 명령이 부분 `.harness`(progress-tracker·cache·runs)만 생성해 "반쪽 설치" 상태를 만들던 결함 수정.**
+
+### 배경 (설치리뷰)
+실측: 깨끗한(미초기화) 폴더에서 `leerness task add` 가 곧바로 `.harness/{cache,progress-tracker.md,runs}` 를 생성 — `init` 없이 banner/handoff/doctor 가 혼란스러운 반쪽 상태로 동작. "write 진입점이 init 여부를 확인하지 않는다"(Codex#2·Sonnet#2·Opus#2 공통).
+
+### 구현 (UR-0047)
+1. **`_isInitialized(root)` — 워크스페이스-인식 판별**: 활성 워크스페이스(`.harness` 기본 / 마이그레이션 시 `.leerness`)의 강마커(`HARNESS_VERSION`/`guideline.md`) 또는 루트 `AGENTS.md` 중 하나라도 있으면 초기화로 간주(fail-open, 레거시·마이그레이션 호환).
+2. **`_requireInit(root, cmd)` 가드**를 `.harness` write 7종 진입점에 적용 — **task add / task update / plan add / decision add / rule add / lesson save / brief set**. 미초기화 시 `fail`(exit 1) + `leerness init .` 안내, **`--force` 우회**.
+3. **state(`.leerness` substrate)는 가드 제외** — start→record→verify→handoff 는 standalone 설계라 `.harness` init 과 무관(회귀 방지).
+4. selftest 58→59 · e2e 255→256.
+
+### 검증
+- **selftest 59/59 PASS** · **E2E 256/256 PASS** (회귀 0).
+- 실측: 미초기화 `task add` → exit 1 + `.harness` 미생성 · 7종 write 모두 차단 · `task add --force` → 0(우회) · init 후 7종 모두 → 0 · 레거시(HARNESS_VERSION 없이 AGENTS.md만) → 통과 · `state start`(미초기화) → 0(`.leerness` 만 생성).
+- 범위: `.harness` 메모리/계획 write 진입점. read/show/list·state·init·migrate 는 비대상.
+
 ## 1.9.310 — 2026-06-04 — UR-0046: CLI/MCP 입력 스키마 검증 (설치리뷰 3중수렴 high)
 
 **🛡 무효한 task status / rule trigger 가 그대로 등록돼 상태·정책 신뢰성을 훼손하던 결함 수정 — 세 모델(Codex#2·Sonnet#2) 공통 지적.**

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.310-green)]() [![tests](https://img.shields.io/badge/e2e-255%2F255-success)]() [![selftest](https://img.shields.io/badge/selftest-58-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.311-green)]() [![tests](https://img.shields.io/badge/e2e-256%2F256-success)]() [![selftest](https://img.shields.io/badge/selftest-59-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.310 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.311 하네스를 사용합니다. 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.310는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
+Leerness v1.9.311는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.310는 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.310)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.311)** · 매 라운드 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.310: 2026-06-04
+Last synced by Leerness v1.9.311: 2026-06-04
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -14,7 +14,7 @@ const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInG
 // 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.310';
+const VERSION = '1.9.311';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3082,6 +3082,7 @@ function _selfTestCases() {
     { name: 'brief 2단계: update --direction 이력 + MCP leerness_brief + context 통합 (UR-0055 1.9.308)', run: () => { const src = read(__filename); const b = { project: 'X', intro: '', purpose: '', problem: '', features: [], stack: [], architecture: '', users: [], success: [], nonGoals: [], currentState: '', directionHistory: ['2026-06-04: 확대'] }; const bpOk = /개발 방향 이력/.test(_briefBlueprint('.', b)) && /최근 개발 방향 변경/.test(_briefReadmeBlock(b)); const histWired = /sub === 'update'/.test(src) && /brief\.directionHistory \|\| \[\]\), `\$\{today\(\)\}/.test(src); const mcpOk = require('../lib/mcp-tools').some(t => t.name === 'leerness_brief'); const ctxOk = /brief: \{ intro:/.test(src); return bpOk && histWired && mcpOk && ctxOk; } },
     { name: 'verify-claim: done 주장 evidence 기본강제 + --lenient + MCP/json 도달 (UR-0048 설치리뷰 critical 1.9.309)', run: () => { const src = read(__filename); const def = /const mustHaveEvidence = !has\('--lenient'\) && \(isDoneClaim \|\| has\('--require-evidence'\)\)/.test(src); const threshold = /has\('--require-evidence'\) \? evq\.ok : \(evq\.hasFile \|\| evq\.hasTest \|\| evq\.hasLog\)/.test(src); const jsonWired = /evidenceComplete:/.test(src) && /!evidenceQualityOk\) return process\.exit\(1\)/.test(src); const mcpLenient = !!require('../lib/mcp-tools').find(t => t.name === 'leerness_verify_claim').inputSchema.properties.lenient; return def && threshold && jsonWired && mcpLenient; } },
     { name: '입력 스키마 검증: task status/rule trigger 무효값 거부 + every-round 보존 (UR-0046 설치리뷰 1.9.310)', run: () => { const src = read(__filename); const sets = TASK_STATUSES.has('done') && TASK_STATUSES.has('in-progress') && !TASK_STATUSES.has('nonsense') && RULE_TRIGGERS.has('every-round') && RULE_TRIGGERS.has('every-update') && !RULE_TRIGGERS.has('not-a-trigger'); const helper = typeof _validateChoice === 'function' && _validateChoice('done', TASK_STATUSES, 'x') === true; const wired = /_validateChoice\(arg\('--status', null\), TASK_STATUSES/.test(src) && /_validateChoice\(trigger, RULE_TRIGGERS/.test(src); return sets && helper && wired; } },
+    { name: 'init 가드: 미초기화 write 차단 + 다중마커 판별 + --force 우회 (UR-0047 설치리뷰 1.9.311)', run: () => { const src = read(__filename); const fnOk = typeof _isInitialized === 'function' && typeof _requireInit === 'function'; const liveOk = _isInitialized('.') === true; const emptyOk = _isInitialized(path.join(os.tmpdir(), '__leerness_noinit_marker__')) === false; const wired = ["task add", "task update", "plan add", "decision add", "rule add", "lesson save", "brief set"].every(l => src.includes(`_requireInit(root, '${l}')`)) && !src.includes("_requireInit(root, 'state " + "start')"); const force = /if \(_isInitialized\(root\) \|\| has\('--force'\)\) return true/.test(src); return fnOk && liveOk && emptyOk && wired && force; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -6192,6 +6193,7 @@ function planListCmd(root, opts = {}) {
 }
 
 function planAdd(root, text) {
+  if (!_requireInit(root, 'plan add')) return;  // 1.9.311 (UR-0047): init 가드
   if (!_validateChoice(arg('--status', null), TASK_STATUSES, 'plan status')) { process.exitCode = 1; return; }  // 1.9.310 (UR-0046)
   const status = arg('--status','planned'), progress = arg('--progress','0'), nextAction = arg('--next', '다음 액션 작성');
   // 1.9.303 (UR-0043): M-id append + T-id upsert 를 하나의 락으로 — 동시 plan add ID 충돌 방지.
@@ -6307,7 +6309,27 @@ function _validateChoice(value, validSet, label) {
   fail(`무효한 ${label}: "${value}" — 유효값: ${[...validSet].join(', ')} (커스텀 허용: --force)`);
   return false;
 }
+// 1.9.311 (UR-0047, 설치리뷰 3중수렴): init 가드 — 미초기화 디렉토리에서 write 차단.
+//   이전: 미초기화 폴더에서 task/plan/decision/rule/lesson add·brief set·state start 가
+//   부분 .harness(progress-tracker/cache/runs)만 생성 → init 없는 반쪽 상태로 banner/handoff/doctor 혼란.
+//   판별: 워크스페이스 강마커(HARNESS_VERSION/guideline.md) 또는 AGENTS.md 중 하나라도 있으면 초기화로 간주(레거시/마이그레이션 호환, fail-open).
+//   주의: state(.leerness substrate)는 standalone 설계라 가드 대상 아님 — .harness write 진입점만 가드.
+function _isInitialized(root) {
+  root = absRoot(root);
+  const ws = _workspaceDirAbs(root);  // .harness(기본) 또는 마이그레이션된 .leerness
+  return exists(path.join(ws, 'HARNESS_VERSION'))
+      || exists(path.join(ws, 'guideline.md'))
+      || exists(path.join(root, 'AGENTS.md'));
+}
+function _requireInit(root, cmdLabel) {
+  if (_isInitialized(root) || has('--force')) return true;
+  fail(`미초기화 디렉토리 — '${cmdLabel || 'write'}' 전에 먼저 'leerness init .' 실행 (강제: --force).`);
+  log(`   워크스페이스 마커(HARNESS_VERSION/AGENTS.md) 없음 — write 가 반쪽 상태를 만들지 않도록 차단했습니다.`);
+  return false;
+}
 function taskAdd(root, text) {
+  // 1.9.311 (UR-0047): init 가드 — 미초기화 디렉토리 write 차단 (--force 우회)
+  if (!_requireInit(root, 'task add')) return;
   // 1.9.310 (UR-0046): --status 스키마 검증 (무효값 거부, --force 우회)
   if (!_validateChoice(arg('--status', null), TASK_STATUSES, 'task status')) { process.exitCode = 1; return; }
   // 1.9.212: 멱등성 — 같은 request 텍스트 + 활성 상태 (requested/in-progress) 이미 존재 시 skip (사용자 명시)
@@ -6380,6 +6402,7 @@ function taskAdd(root, text) {
   }
 }
 function taskUpdate(root, id) {
+  if (!_requireInit(root, 'task update')) return;  // 1.9.311 (UR-0047): init 가드
   if (!id) return fail('id required (e.g., task update T-0001 --status in-progress)');
   if (!_validateChoice(arg('--status', null), TASK_STATUSES, 'task status')) { process.exitCode = 1; return; }  // 1.9.310 (UR-0046)
   const rows = readProgressRows(root);
@@ -6716,6 +6739,7 @@ function lessonDropCmd(root, target) {
 // 1.9.112: lesson save — .harness/lessons.md에 새 lesson 추가 (Memory Write Surface 5번째)
 function lessonSave(root, text) {
   root = absRoot(root);
+  if (!_requireInit(root, 'lesson save')) return;  // 1.9.311 (UR-0047): init 가드
   if (!text) return fail('lesson text required. 예: leerness lesson save "JWT는 refresh token도 짧게 (15분 권장)"');
   const lp = lessonsPath(root);
   const tag = arg('--tag', '');
@@ -6842,6 +6866,7 @@ function decisionDropCmd(root, target) {
 // 1.9.108: decision add — decisions.md에 새 설계 결정 추가 (외부 AI/MCP 통합 메모리 영구화)
 function decisionAdd(root, title) {
   root = absRoot(root);
+  if (!_requireInit(root, 'decision add')) return;  // 1.9.311 (UR-0047): init 가드
   if (!title) return fail('decision title required. 예: leerness decision add "PostgreSQL 채택" --reason "..." ');
   const dp = decisionsPath(root);
   const reason = arg('--reason', '');
@@ -13989,6 +14014,7 @@ function nextRuleId(root) {
 
 function ruleAdd(root, description) {
   root = absRoot(root);
+  if (!_requireInit(root, 'rule add')) return;  // 1.9.311 (UR-0047): init 가드
   if (!description) return fail('rule description required (e.g., rule add "매 업데이트마다 버전 bump" --trigger every-update)');
   if (!exists(rulesPath(root))) writeRules(root, []);
   const trigger = arg('--trigger', 'every-session');
@@ -18337,6 +18363,7 @@ function briefCmd(root, sub) {
   const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s, gr = s => isTty ? `\x1b[32m${s}\x1b[0m` : s, dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
   sub = sub || 'show';
   if (sub === 'set') {
+    if (!_requireInit(root, 'brief set')) return;  // 1.9.311 (UR-0047): init 가드
     const brief = _loadBrief(root);
     let changed = 0;
     const proj = arg('--project', null); if (proj != null) { brief.project = proj; changed++; }
@@ -18449,6 +18476,7 @@ function stateCmd(root, sub, ...args) {
   sub = sub || 'show';
 
   if (sub === 'start') {
+    // 1.9.311 (UR-0047): state 는 .leerness substrate(standalone) — .harness init 가드 미적용 (회귀 방지)
     const goal = (args.find(a => a && !a.startsWith('-')) || arg('--goal', '')).trim();
     const state = _loadLeernessState(root);
     state.runCounter = (state.runCounter || 0) + 1;

package/package.json

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

package/scripts/e2e.js

@@ -3609,5 +3609,35 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.311 회귀 (UR-0047 설치리뷰): init 가드 — 미초기화 디렉토리 write 차단, .harness 미생성, --force 우회, init 후 정상
+total++;
+{
+  let ok = false;
+  try {
+    // dir1: 미초기화 7개 write 차단(exit 1) + .harness 미생성 + --force 우회
+    const ig = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-initguard-'));
+    const st = (...a) => cp.spawnSync(process.execPath, [CLI, ...a, '--path', ig], { cwd: ig, encoding: 'utf8', timeout: 20000 }).status;
+    const blocked = st('task', 'add', 't') === 1
+      && st('task', 'update', 'T-0001', '--status', 'done') === 1
+      && st('rule', 'add', 'r', '--trigger', 'every-update') === 1
+      && st('decision', 'add', 'd') === 1
+      && st('plan', 'add', 'p') === 1
+      && st('lesson', 'save', 'l') === 1
+      && st('brief', 'set', '--intro', 'x') === 1;
+    const stateOk = st('state', 'start', 'g') === 0;              // state 는 .leerness substrate(standalone) → 가드 미적용(0)
+    const noHarness = !fs.existsSync(path.join(ig, '.harness'));   // .harness write 차단 시 부분 .harness 미생성
+    const forced = st('task', 'add', 'tf', '--force') === 0;       // --force 우회
+    fs.rmSync(ig, { recursive: true, force: true });
+    // dir2: init 후 정상 write
+    const ig2 = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-initguard2-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', ig2, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+    const afterInit = cp.spawnSync(process.execPath, [CLI, 'task', 'add', 'ti', '--path', ig2], { cwd: ig2, encoding: 'utf8', timeout: 20000 }).status === 0;
+    fs.rmSync(ig2, { recursive: true, force: true });
+    ok = blocked && stateOk && noHarness && forced && afterInit;
+  } catch {}
+  console.log(ok ? '✓ B(1.9.311) init 가드: 미초기화 .harness write 7종 차단 + state(.leerness) 예외 + --force 우회 + init 후 정상 (UR-0047)' : '✗ init 가드 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);