leerness 1.9.307 → 1.9.308

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.9.308 — 2026-06-04 — UR-0055 (2단계 완료): 개발 방향 이력 + context/MCP 청사진 통합
+
+**📘 프로젝트 청사진 기능 완성 — 개발 방향 변경/확대 이력 누적 + 에이전트가 청사진을 1콜로 회수(context/MCP). 사용자 요청 "개발 방향이 변경/확대될 때 업데이트" 완전 충족.**
+
+### 구현 (UR-0055 2단계)
+1. **`leerness brief update --direction "..."`** — 개발 방향 변경/확대를 날짜별 이력으로 누적(`## Direction History` append-only). README `**최근 개발 방향 변경**`(최근 3건) + blueprint export `개발 방향 이력` 섹션에 반영 → 프로젝트 진화 추적.
+2. **context 청사진 통합** — `contextCmd` 가 `_loadBrief` 단일출처로 intent + brief 요약(intro/features/최근방향) 노출. 에이전트가 작업 시작 시 프로젝트 정체성을 1콜로 파악.
+3. **MCP `leerness_brief` (83번째 도구, read-only)** — `{ path?, export? }` → 구조화 청사진(show) 또는 복사용 blueprint(export). 외부 에이전트가 "이 프로젝트가 무엇이고 어디로 가는가" 회수.
+4. selftest 55→56 · e2e 252→253.
+
+### 검증
+- **selftest 56/56 PASS** · **E2E 253/253 PASS** (회귀 0).
+- 실측: `brief update --direction` ×2 → Direction History 2건 누적 + README 최근방향 + export 이력 · `context --json` brief.latestDirection 노출 · MCP leerness_brief 가 directionHistory/features 반환.
+
+### 🎉 UR-0055 완료 (사용자 명시 — 프로젝트 청사진)
+- 1단계(1.9.307): brief set/show/export + README 개요 섹션
+- 2단계(1.9.308): update --direction 이력 + context/MCP 통합
+- 결과: 프로젝트 개요/소개/목적/기능을 README 에 유지·업데이트 + 복사하면 신규 프로젝트를 기초부터 재시작할 수 있는 blueprint.
+
 ## 1.9.307 — 2026-06-04 — UR-0055 (1단계): 프로젝트 청사진 brief (README 개요 + 복사용 blueprint)
 
 **📘 사용자 명시 — 프로젝트 개요/소개/목적/기능을 README 에 작성·유지하고, 그 내용만 복사하면 신규 프로젝트를 기초부터 재시작할 수 있는 자기완결 청사진(blueprint) 생성. 기존 `.harness/project-brief.md` 비파괴 확장.**

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.307-green)]() [![tests](https://img.shields.io/badge/e2e-252%2F252-success)]() [![selftest](https://img.shields.io/badge/selftest-55-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-82-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.308-green)]() [![tests](https://img.shields.io/badge/e2e-253%2F253-success)]() [![selftest](https://img.shields.io/badge/selftest-56-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.307 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.308 하네스를 사용합니다. 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.307는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **82개 도구**를 노출:
+Leerness v1.9.308는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -538,7 +538,7 @@ Leerness v1.9.307는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 // • Workflow: session_close / agents_list / task_export / env_check / usage_stats / reuse_map / whats_new
 
 // MCP server 실행: leerness mcp serve
-// tools/list 응답: 82 도구
+// tools/list 응답: 83 도구
 ```
 
 ### Autonomous mode (자율 모드)
@@ -546,7 +546,7 @@ Leerness v1.9.307는 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.307)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.308)** · 매 라운드 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.307: 2026-06-04
+Last synced by Leerness v1.9.308: 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.307';
+const VERSION = '1.9.308';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3079,6 +3079,7 @@ function _selfTestCases() {
     { name: 'honesty-check: AI 인식론적 정직성 3차원 + MCP/CLI/strict 통합 (사용자명시 1.9.305)', run: () => { const h = _epistemicHonestyCheck; const d1 = h('이 기능은 항상 정상 동작합니다').findings.some(f => f.dim === 'pretend-knowledge'); const d2 = h('아마 될 것 같습니다. 구현 완료했습니다').findings.some(f => f.dim === 'premature-judgment'); const d3 = h('이 API 의 rate limit 은 초당 5회입니다').findings.some(f => f.dim === 'no-info-gathering'); const clean = h('src/api.js 수정, 12/12 통과 (Exit: 0)').ok === true; const src = read(__filename); const wired = require('../lib/mcp-tools').some(t => t.name === 'leerness_honesty_check') && /if \(cmd === 'honesty-check'\)/.test(src) && /honestyFindings = _epistemicHonestyCheck/.test(src); return d1 && d2 && d3 && clean && wired; } },
     { name: 'exit code 일관성: fail()→exitCode 1 + unknown 명령 안내 (UR-0045 설치리뷰 1.9.306)', run: () => { const src = read(__filename); return /function fail\(s\) \{ log\('✗ ' \+ s\); process\.exitCode = 1; \}/.test(src) && /알 수 없는 명령: \$\{cmd\}/.test(src) && /if \(cmd === 'help' \|\| cmd === 'commands'/.test(src); } },
     { name: 'brief: 프로젝트 청사진 set/show/export + README 개요 섹션 (UR-0055 사용자명시 1.9.307)', run: () => { const src = read(__filename); const fnOk = typeof briefCmd === 'function' && typeof _loadBrief === 'function' && typeof _briefBlueprint === 'function' && _BRIEF_FIELDS.length === 10; const b = { project: 'X', intro: 'i', purpose: 'p', problem: '', features: ['f1', 'f2'], stack: ['s'], architecture: '', users: [], success: [], nonGoals: [], currentState: '' }; const bp = _briefBlueprint('.', b); const bpOk = /Blueprint/.test(bp) && /소개 \(Intro\)/.test(bp) && /f1/.test(bp) && /신규 프로젝트 시작 가이드/.test(bp); const rb = _briefReadmeBlock(b); const rbOk = rb.includes(BRIEF_START) && rb.includes(BRIEF_END) && /프로젝트 개요/.test(rb) && /\*\*목적\*\*/.test(rb); return fnOk && bpOk && rbOk && /if \(cmd === 'brief'\)/.test(src); } },
+    { 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: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -16931,6 +16932,9 @@ function mcpServeCmd(root) {
           case 'leerness_honesty_check':
             cliArgs = ['honesty-check', ...(args.text ? ['--text', String(args.text)] : [String(args.taskId || '')]), '--path', targetPath, '--json'];
             break;
+          case 'leerness_brief':
+            cliArgs = ['brief', args.export === true ? 'export' : 'show', '--path', targetPath, ...(args.export === true ? [] : ['--json'])];
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -18240,7 +18244,7 @@ const _BRIEF_FIELDS = [
 ];
 function _briefPath(root) { return path.join(absRoot(root), '.harness', 'project-brief.md'); }
 function _loadBrief(root) {
-  const brief = { project: detectProjectName(absRoot(root)) };
+  const brief = { project: detectProjectName(absRoot(root)), directionHistory: [] };
   for (const f of _BRIEF_FIELDS) brief[f.key] = f.multi ? [] : '';
   const p = _briefPath(root);
   if (!exists(p)) return brief;
@@ -18249,6 +18253,7 @@ function _loadBrief(root) {
     if (!m) continue;
     const head = m[1].trim(), body = m[2].trim();
     if (head === 'Project') { brief.project = (body.replace(/^[-*]\s*/, '').split('\n')[0] || '').trim() || brief.project; continue; }
+    if (head === 'Direction History') { brief.directionHistory = body.split('\n').map(l => l.replace(/^[-*]\s*/, '').trim()).filter(l => l && l !== '-'); continue; }
     const f = _BRIEF_FIELDS.find(x => x.h === head);
     if (!f) continue;
     if (f.multi) brief[f.key] = body.split('\n').map(l => l.replace(/^[-*]\s*/, '').trim()).filter(l => l && l !== '-' && !/업데이트하세요/.test(l));
@@ -18264,6 +18269,8 @@ function _saveBrief(root, brief) {
     if (f.multi) body += (v && v.length ? v.map(x => `- ${x}`).join('\n') : '-') + '\n';
     else body += (v ? v : '- 이 항목을 실제 내용으로 업데이트하세요.') + '\n';
   }
+  // 1.9.308 (UR-0055 2단계): 개발 방향 변경/확대 이력 (append-only, 날짜별)
+  if (brief.directionHistory && brief.directionHistory.length) body += `\n## Direction History\n` + brief.directionHistory.map(x => `- ${x}`).join('\n') + '\n';
   writeUtf8(_briefPath(root), fm('project-brief', ['프로젝트 목적 확인', '신규 기능 판단', '계획 수립'], ['프로젝트 목적 변경', '사용자/범위 변경'], body));
 }
 function _briefFilled(brief) { return _BRIEF_FIELDS.filter(f => (f.multi ? (brief[f.key] && brief[f.key].length) : brief[f.key])).length; }
@@ -18274,6 +18281,7 @@ function _briefReadmeBlock(brief) {
   if (brief.problem) L.push(`**해결 문제**: ${brief.problem}`, '');
   if (brief.features && brief.features.length) { L.push('**핵심 기능**'); brief.features.forEach(x => L.push(`- ${x}`)); L.push(''); }
   if (brief.stack && brief.stack.length) L.push(`**기술 스택**: ${brief.stack.join(', ')}`, '');
+  if (brief.directionHistory && brief.directionHistory.length) { L.push('**최근 개발 방향 변경**'); brief.directionHistory.slice(-3).forEach(x => L.push(`- ${x}`)); L.push(''); }
   if (_briefFilled(brief) === 0) L.push('_아직 개요 미입력 — `leerness brief set --intro "..." --purpose "..."` 로 작성._', '');
   L.push('<sub>이 섹션은 `leerness brief` 로 관리됩니다. 전체 청사진(복사용): `leerness brief export`.</sub>', BRIEF_END);
   return L.join('\n');
@@ -18298,6 +18306,7 @@ function _briefBlueprint(root, brief) {
   sec('아키텍처 (Architecture)', brief.architecture); sec('사용자 (Users)', brief.users, true);
   sec('성공 기준 (Success Criteria)', brief.success, true); sec('비목표 (Non-Goals)', brief.nonGoals, true);
   sec('현재 상태 (Current State)', brief.currentState);
+  sec('개발 방향 이력 (Direction History)', brief.directionHistory, true);
   L.push('---', '## 신규 프로젝트 시작 가이드', '', '1. 위 소개·목적·기능·아키텍처·스택을 신규 레포의 계획으로 복사.', '2. `leerness init .` 후 이 파일을 `.harness/project-brief.md` 로 복사하거나 `leerness brief set` 으로 재입력.', '3. Features 를 `leerness plan add` / `leerness task add` 로 분해.', '');
   return L.join('\n');
 }
@@ -18334,7 +18343,18 @@ function briefCmd(root, sub) {
     log(bp);
     return;
   }
-  fail(`brief: 알 수 없는 sub: ${sub} (set | show | export)`);
+  if (sub === 'update') {
+    // 1.9.308 (UR-0055 2단계): 개발 방향 변경/확대 이력 추가 (날짜별 append).
+    const dir = arg('--direction', null);
+    if (dir == null) { fail('brief update --direction "<개발 방향 변경/확대 내용>" 필요'); return; }
+    const brief = _loadBrief(root);
+    brief.directionHistory = [...(brief.directionHistory || []), `${today()}: ${dir}`];
+    _saveBrief(root, brief);
+    _syncBriefReadme(root, brief);
+    ok(`방향 이력 추가 (총 ${brief.directionHistory.length}건) → project-brief.md Direction History`);
+    return;
+  }
+  fail(`brief: 알 수 없는 sub: ${sub} (set | show | export | update)`);
 }
 function contextCmd(root, opts = {}) {
   root = absRoot(root);
@@ -18364,17 +18384,14 @@ function contextCmd(root, opts = {}) {
     rulesActive: activeRules.length,
     lessons: exists(lessonsPath(root)) ? (read(lessonsPath(root)).match(/^### \d{4}-\d{2}-\d{2}/gm) || []).length : 0
   };
-  // 프로젝트 의도 (best-effort) — .harness/project-brief.md 의 ## Purpose 첫 줄
-  let intent = null;
-  const briefPath = path.join(root, '.harness', 'project-brief.md');
-  if (exists(briefPath)) {
-    const m = read(briefPath).match(/##\s*Purpose\s*\n+\s*[-*]?\s*([^\n#].*)/);
-    if (m && !/업데이트하세요/.test(m[1])) intent = m[1].trim().slice(0, 200);
-  }
+  // 프로젝트 청사진 (1.9.308 UR-0055 2단계): brief 에서 의도/개요/방향이력 회수 (단일 출처)
+  const brief = _loadBrief(root);
+  const intent = (brief.purpose || brief.intro || '').slice(0, 200) || null;
   const ctx = {
     schemaVersion: 1,
     version: VERSION,
-    project: { root, intent },
+    project: { root, name: brief.project, intent },
+    brief: { intro: brief.intro || null, purpose: brief.purpose || null, features: brief.features || [], stack: brief.stack || [], latestDirection: (brief.directionHistory || []).slice(-1)[0] || null, filled: _briefFilled(brief) },
     currentTask: active ? { id: active.id, request: (active.request || '').slice(0, 200), status: active.status, nextAction: (active.nextAction || '').slice(0, 160) || null } : null,
     openRequests: { count: openReqs.length, items: openReqs.slice(0, 5).map(r => ({ id: r.id, text: (r.text || '').slice(0, 120) })) },
     recentDecisions,
@@ -18389,6 +18406,7 @@ function contextCmd(root, opts = {}) {
   const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
   log(cy(`# leerness context (1.9.292) — 에이전트 온보딩 컨텍스트 (v${VERSION})`));
   if (intent) log(`  🎯 의도: ${intent}`);
+  if (ctx.brief.intro || ctx.brief.features.length) log(dm(`  📘 청사진: ${ctx.brief.intro || ''}${ctx.brief.features.length ? ` · 기능 ${ctx.brief.features.length}` : ''}${ctx.brief.latestDirection ? ` · 최근방향 ${ctx.brief.latestDirection.slice(0, 50)}` : ''} (leerness brief show)`));
   log('');
   if (ctx.currentTask) {
     log(gr(`▶ 현재 작업: ${ctx.currentTask.id} — ${ctx.currentTask.request}`));

package/lib/mcp-tools.js

@@ -86,5 +86,6 @@ module.exports = [
   { name: 'leerness_state_handoff', requiredTier: 'safe-write', description: '1.9.279 (UR-0031) — create_handoff / make_handoff. 현재 run 을 마감하고 다음 에이전트용 .leerness/handoff/latest.{md,json} 작성 (Claude→Goose→Codex 인수인계 표준). 인자: { path?, summary (required) }. 응답: { handoff, run }.', inputSchema: { type: 'object', properties: { path: { type: 'string' }, summary: { type: 'string' } }, required: ['summary'] } },
   { name: 'leerness_get_project_context', requiredTier: 'read-only', description: '1.9.292 (UR-0031) — get_project_context. 외부 에이전트가 작업 시작 전 단 1콜로 "지금 무엇을 알아야 하는가"를 파악하는 집약 컨텍스트. 여러 소스(현재 작업/미답 사용자 요청/최근 결정/활성 룰/next-actions/memory surface/프로젝트 의도)를 한 번에 구조화 회수. read-only. 인자: { path? }. 응답: { version, project, currentTask, openRequests, recentDecisions, activeRules, nextActions, memory }.', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
   { name: 'leerness_about', requiredTier: 'read-only', description: '1.9.296 (UR-0030) — leerness 정체성/포지셔닝 회수. leerness 가 무엇인가: "AI 에이전트 운영 레이어"(실행기 아님) — 기억·정책·인수인계·검증·감사 5계층. read-only. 어떤 에이전트든 "이 도구가 무엇이고 무엇을 보완하는가"를 1콜로 파악. 응답: { identity, isNot, tagline, layers[], complements, entryPoints, surface }.', inputSchema: { type: 'object', properties: {} } },
-  { name: 'leerness_honesty_check', requiredTier: 'read-only', description: '1.9.305 (사용자 명시) — AI 인식론적 정직성 점검. 주장/evidence 텍스트가 (1) 모르는 걸 아는 척(근거 없는 단정), (2) 검증 없는 섣부른 판단(추정+완료 결론), (3) 외부 정보 미수집(API/버전/스펙 언급+수집흔적 없음) 중 무엇에 해당하는지 휴리스틱 탐지. read-only. 에이전트가 자기 주장을 단언 전 self-check. 인자: { path?, taskId?, text? }. 응답: { ok, findings[], dimensions[], highCount }.', inputSchema: { type: 'object', properties: { path: { type: 'string' }, taskId: { type: 'string' }, text: { type: 'string' } } } }
+  { name: 'leerness_honesty_check', requiredTier: 'read-only', description: '1.9.305 (사용자 명시) — AI 인식론적 정직성 점검. 주장/evidence 텍스트가 (1) 모르는 걸 아는 척(근거 없는 단정), (2) 검증 없는 섣부른 판단(추정+완료 결론), (3) 외부 정보 미수집(API/버전/스펙 언급+수집흔적 없음) 중 무엇에 해당하는지 휴리스틱 탐지. read-only. 에이전트가 자기 주장을 단언 전 self-check. 인자: { path?, taskId?, text? }. 응답: { ok, findings[], dimensions[], highCount }.', inputSchema: { type: 'object', properties: { path: { type: 'string' }, taskId: { type: 'string' }, text: { type: 'string' } } } },
+  { name: 'leerness_brief', requiredTier: 'read-only', description: '1.9.308 (UR-0055) — 프로젝트 청사진 회수. 프로젝트 개요/소개/목적/기능/스택/아키텍처/성공기준/방향이력을 구조화 반환(show) 또는 복사용 blueprint 텍스트(export=true). read-only. 외부 에이전트가 "이 프로젝트가 무엇이고 어디로 가는가"를 1콜로 파악하거나, 신규 프로젝트 계획으로 복사. 인자: { path?, export? }. 응답(show): { project, intro, purpose, features[], stack[], directionHistory[], ... }.', inputSchema: { type: 'object', properties: { path: { type: 'string' }, export: { type: 'boolean' } } } }
 ];

package/package.json

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

package/scripts/e2e.js

@@ -3530,5 +3530,37 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.308 회귀 (UR-0055 2단계): brief update --direction 이력 + context 통합 + MCP leerness_brief
+total++;
+{
+  let ok = false;
+  try {
+    const b2 = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-brief2-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', b2, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+    const run = (...a) => cp.spawnSync(process.execPath, [CLI, ...a], { cwd: b2, encoding: 'utf8', timeout: 20000 });
+    run('brief', 'set', '--path', b2, '--intro', '앱', '--features', 'CRUD');
+    run('brief', 'update', '--path', b2, '--direction', 'AI 자동분류 확대');
+    run('brief', 'update', '--path', b2, '--direction', '모바일 지원 추가');
+    const md = fs.readFileSync(path.join(b2, '.harness', 'project-brief.md'), 'utf8');
+    const histOk = /## Direction History/.test(md) && /AI 자동분류 확대/.test(md) && /모바일 지원 추가/.test(md);  // 이력 누적
+    const readme = fs.readFileSync(path.join(b2, 'README.md'), 'utf8');
+    const readmeOk = /최근 개발 방향 변경/.test(readme) && /모바일 지원 추가/.test(readme);
+    const exp = run('brief', 'export', '--path', b2);
+    const expOk = /개발 방향 이력/.test(exp.stdout) && /AI 자동분류 확대/.test(exp.stdout);
+    // context --path 가 brief 노출
+    const ctx = run('context', '--path', b2, '--json');
+    const cj = JSON.parse(ctx.stdout);
+    const ctxOk = cj.brief && cj.brief.intro === '앱' && cj.brief.features.includes('CRUD') && /모바일 지원/.test(cj.brief.latestDirection || '');
+    // MCP leerness_brief
+    const ml = cp.spawnSync(process.execPath, [CLI, 'mcp', 'serve'], { cwd: b2, encoding: 'utf8', timeout: 15000, input: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'leerness_brief', arguments: { path: b2 } } }) + '\n' });
+    let mcpOk = false;
+    try { const r = JSON.parse(ml.stdout.split('\n').filter(Boolean)[0]); const t = JSON.parse(r.result.content[0].text); mcpOk = t.directionHistory.length === 2 && t.features.includes('CRUD'); } catch {}
+    ok = histOk && readmeOk && expOk && ctxOk && mcpOk;
+    fs.rmSync(b2, { recursive: true, force: true });
+  } catch {}
+  console.log(ok ? '✓ B(1.9.308) brief 2단계: update --direction 이력누적 + context 통합 + MCP leerness_brief (UR-0055)' : '✗ brief 2단계 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);