leerness 1.36.45 → 1.36.47

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.36.47 — 2026-07-16 — anchors 초안 품질 + 재초안 — 실프로젝트 6곳 실적용에서 발견·즉시 교정
+
+사용자 승인 하에 실프로젝트 6곳(hive-analytics/auto-macro/cafe-macro/blog-macro/view-work/AEGIRINE)을 1.36.46 으로 **무유실 마이그레이션**(5표면 카운트 전량 보존, auto-macro 는 1.9.441→46 32버전 점프에 CLAUDE 커스텀 포함 무손실 — 보존 3부작의 실전 입증)하고 anchors 초안을 일괄 적용한 결과, 실데이터에서 초안 품질 결함 2종 발견:
+
+- **어색문**: goal 문형의 조사 병기("…를(을) 동작하는…") + 160자 **구 중간 절단**("주문 목록  를(을)") → 단어/구두점 경계 절단(`…` 표시) + 조사 없는 문형("제품을 동작 상태로 유지·발전시킨다: <설명>")으로 교정.
+- **재초안 불가**: 초안 적용 후엔 "작성됨" 판정이라 품질 개선을 전파할 수 없었음 → **draft 마커가 남아있는 섹션은 재초안 대상**(확정본 = 마커 제거본은 불가침 유지). 실측: 6곳 재적용 — draft 섹션만 갱신(2/2/1/2/1), 사용자 작성 2섹션 + AEGIRINE 완정본 0 접촉, 어색문 잔존 0.
+- (부수: `_mdSectionBody` bin 임포트 누락을 라이브 실행이 즉시 노출 — selftest 는 anchorsCmd 미실행이라 못 잡음. 임포트 추가.)
+- **검증**: selftest 316/316(문형·경계절단·재초안 배선 가드 보강), 실프로젝트 6곳 재적용 실측, exit 전파형 게이트 e2e, 클린룸.
+
+## 1.36.46 — 2026-07-16 — JSON 계약 완결 — persona/review/guide (codex 5차 #10 잔여 소진)
+
+`--json` 을 광고하면서 마크다운/혼합 출력을 내던 마지막 3종 — MCP·자동화 소비자가 파싱 가능한 **단일 JSON 문서**로:
+
+- **`persona show <id> --json`**: `{id, name, description, body}` (종전: 마크다운 방출) + 에러 경로 failJson 구조화.
+- **`review <file> --persona … --json`**: `--emit json` 과 동치화 + **`prompts[]`(실제 리뷰 프롬프트 전문) 포함** — 종전 JSON 은 메타만 있어 소비자가 프롬프트를 재조립해야 했다.
+- **`guide <target> --json`**: 하위 4섹션(impact/reuse/uiConsistency/lessons) 출력을 캡처해 `{target, query, date, sections}` 단일 객체로 집계 (종전: 사람용 헤딩+JSON 파편 혼합).
+- 사람용 출력 3종 모두 무회귀. **이로써 codex 5차 헌트 10건 완전 소진(부분 이연 0).**
+- **검증**: selftest 316/316, 3종 JSON.parse 실측 + 프롬프트 포함 확인, exit 전파형 게이트 e2e, 클린룸.
+
 ## 1.36.45 — 2026-07-16 — `adapter codex --global` — goal 모드까지 닿는 조건부 전역 지침 (사용자 버그 후속 2층)
 
 1.36.43 enforce(커밋 관문)에 이은 **지침층 보완**: codex 는 프로젝트 AGENTS.md 를 안 읽는 모드(goal 모드 — 사용자 실측)에서도 **전역 `~/.codex/AGENTS.md` 는 읽는다**. 여기에 조건부 블록을 설치해 커버.

package/README.md

@@ -121,7 +121,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.36.45 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.36.47 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -175,7 +175,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.36.45는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
+Leerness v1.36.47는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -196,7 +196,7 @@ Leerness v1.36.45는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) 회귀 테스트 갱신 → 4) 전체 e2e 스위트 통과 → 5) npm publish + git tag → 6) main push → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **v1.9.x → 1.36.45 릴리스 태그 이력** (수백 라운드) · _reports/는 비공개 보존.
+현재 누적: **v1.9.x → 1.36.47 릴리스 태그 이력** (수백 라운드) · _reports/는 비공개 보존.
 
 ### 성능 가이드
 
@@ -234,6 +234,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.36.45: 2026-07-16
+Last synced by Leerness v1.36.47: 2026-07-21
 <!-- leerness:project-readme:end -->
 

package/bin/leerness.js

@@ -26,7 +26,7 @@ const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _merg
   _migrationGuideText, _parseContractSpec, _gitignoreMatch,
   _featureGraphTemplate, _parseFeatureGraph, _nextFeatureId, _featureBlock, _featureImpactBfs,
   _parseChangelogBetween, _cellSafe, _cellUnescape, _lineSafe, _parseLimit, _parseAddTitle, _parseImplExports, _taskPositionalPath, _completionClaimAllowed, _minorKey, _shouldPublishNpm,
-  _matchTool, _parsePackageJsonDeps, _parseRequirementsTxt, _buildGlossary, _renderGlossaryMd, _briefUnfilled, _planGoalUnfilled, _draftAnchors, _replaceMdSection } = require('../lib/pure-utils');  // 1.9.318~1.11.4 (UR-0025/.../0007 glossary): 순수 유틸 모듈 분리 · 1.36.36 anchors
+  _matchTool, _parsePackageJsonDeps, _parseRequirementsTxt, _buildGlossary, _renderGlossaryMd, _briefUnfilled, _planGoalUnfilled, _draftAnchors, _replaceMdSection, _mdSectionBody } = require('../lib/pure-utils');  // 1.9.318~1.11.4 (UR-0025/.../0007 glossary): 순수 유틸 모듈 분리 · 1.36.36 anchors
 // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
 const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
@@ -34,7 +34,7 @@ const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE
 const { tokenizeForRank: _tokenizeForRank, expandQuery: _expandQuery, scoreHits: _scoreHits, suggestTerms: _suggestTerms } = require('../lib/search-core');  // 1.36.23: memory search 랭킹 코어(순수·0-deps)
 const { findCorruptedStateJson: _findCorruptedStateJson } = require('../lib/state-integrity');  // 1.36.1 (클린룸 리뷰 FN): .harness/*.json 상태 무결성 (audit/health/check 공유)
 
-const VERSION = '1.36.45';
+const VERSION = '1.36.47';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3202,6 +3202,13 @@ function _selfTestCases() {
       if (typeof p._draftAnchors !== 'function' || typeof p._replaceMdSection !== 'function') return false;
       const d = p._draftAnchors({ pkgDescription: '결제 정산 서비스', readmeText: '# T\n\n웹훅 백엔드.\n', milestones: [{ id: 'M-0001', title: '베타', status: 'planned' }], tasks: [] });
       const draftOk = d.hasSignal && d.purpose.some(l => l.includes('결제 정산 서비스')) && d.goal.some(l => l.includes('M-0001')) && d.purpose[0].includes('draft:');
+      // 1.36.47: 어색 조사 병기 소거 + 장문은 단어 경계 절단(…) — 실적용에서 발견된 품질 결함 회귀 방지
+      const dLong = p._draftAnchors({ pkgDescription: '가나다 라마바사 아자차카 타파하 '.repeat(20) });
+      const phraseOk = !dLong.goal.join('').includes('를(을)') && dLong.goal.some(l => l.includes('…')) && !/[가-힣]{2}…[가-힣]/.test(dLong.goal.join(''));
+      // 재초안: draft 마커 잔존 섹션은 gap 취급 (배선 소스가드)
+      const s47 = read(__filename);
+      const redraftOk = s47.includes("_mdSectionBody(briefTxt, 'Purpose') || '').includes(_draftM)");
+      if (!(phraseOk && redraftOk)) return false;
       // 무신호 시 발명 금지
       const empty = p._draftAnchors({});
       const noInvent = !empty.hasSignal && empty.purpose.length === 0 && empty.goal.length === 0;
@@ -3361,6 +3368,13 @@ function _selfTestCases() {
       const removeOk = /has\('--remove'\)[\s\S]{0,400}codex 전역 leerness 블록 제거/.test(s);
       return wired && conditional && mergeOk && removeOk;
     } },
+    { name: 'JSON 계약 완결 (1.36.46, codex 5차 #10 잔여): persona show/review/guide --json 단일 JSON 문서 (소스가드)', run: () => {
+      const s = read(__filename);
+      const personaOk = s.includes("log(JSON.stringify({ id: p.id, name: p.name, description: p.description, body: p.body }, null, 2)); return;");
+      const reviewOk = s.includes("has('--json') ? 'json' : arg('--emit', 'prompt')") && s.includes('prompts: personas.map(p => ({ personaId: p.id, prompt: _mkPrompt(p) }))');
+      const guideOk = /guideCmd[\s\S]{0,600}if \(has\('--json'\)\) \{[\s\S]{0,900}sections/.test(s) && s.includes('uiConsistency: _cap(() => uiConsistency(root))');
+      return personaOk && reviewOk && guideOk;
+    } },
     { name: 'debug 렌즈 (1.36.27, obra/superpowers systematic-debugging): 자기질문 6문항 ko/en 락스텝 + affects 유효 + route bugfix 힌트 + 파일매핑 미확장 — 행위검사', run: () => {
       const d = LENS_CATALOG.debug;
       if (!d) return false;
@@ -5189,8 +5203,10 @@ function anchorsCmd(root, sub) {
   const briefTxt = exists(bf) ? read(bf) : '';
   const planTxt = exists(pf) ? read(pf) : '';
   const naM = '<!-- leerness:na';
-  const briefGap = !!briefTxt && !briefTxt.includes(naM) && _briefUnfilled(briefTxt);
-  const planGap = !!planTxt && !planTxt.includes(naM) && _planGoalUnfilled(planTxt);
+  // 1.36.47: draft 마커가 남아있는 섹션(미확정 초안)은 재초안 대상 — 초안 품질 개선을 기존 적용본에도 전파 가능.
+  const _draftM = '<!-- draft: leerness anchors';
+  const briefGap = !!briefTxt && !briefTxt.includes(naM) && (_briefUnfilled(briefTxt) || (_mdSectionBody(briefTxt, 'Purpose') || '').includes(_draftM));
+  const planGap = !!planTxt && !planTxt.includes(naM) && (_planGoalUnfilled(planTxt) || (_mdSectionBody(planTxt, 'Goal') || '').includes(_draftM));
   if (!sub || sub === 'status') {
     if (json) { log(JSON.stringify({ briefUnfilled: briefGap, planGoalUnfilled: planGap }, null, 2)); return; }
     log(`# leerness anchors — 정체성앵커 상태`);
@@ -14124,9 +14140,11 @@ function personaCmd(root, sub, idOrName, ...rest) {
     return;
   }
   if (sub === 'show') {
-    if (!idOrName) { fail('persona show <id> 필요'); return process.exit(1); }
+    if (!idOrName) { failJson(has('--json'), 'missing_arg', 'persona show <id> 필요'); return process.exit(1); }
     const p = _resolvePersona(root, idOrName);
-    if (!p) { fail(`페르소나 없음: ${idOrName}`); return process.exit(1); }
+    if (!p) { failJson(has('--json'), 'not_found', `페르소나 없음: ${idOrName}`); return process.exit(1); }
+    // 1.36.46 (codex 5차 #10 잔여): --json 은 단일 JSON 문서 (종전 마크다운 방출)
+    if (has('--json')) { log(JSON.stringify({ id: p.id, name: p.name, description: p.description, body: p.body }, null, 2)); return; }
     log(`# ${p.name} (${p.id})`);
     log(`\n${p.description}\n`);
     log(`---\n${p.body}`);
@@ -14170,13 +14188,16 @@ function reviewCmd(root, target) {
   }
 
   // 출력 형식: emit
-  const emit = arg('--emit', 'prompt'); // prompt | md | json
+  const emit = has('--json') ? 'json' : arg('--emit', 'prompt'); // prompt | md | json  (1.36.46: --json ≡ --emit json)
 
   if (emit === 'json') {
+    // 1.36.46 (codex 5차 #10 잔여): JSON 에 실제 산출물(프롬프트)까지 — 메타만 주던 종전은 소비자가 재조립해야 했다.
+    const _mkPrompt = (p) => [`# Review Prompt — ${p.name} (${p.id})`, `## 대상: ${target} (${fileSize} bytes)`, `## 페르소나 활성화`, p.body, ``, `## 작업`, `아래 코드를 위 페르소나 관점에서 정밀 리뷰하라. 한국어 보고 ~600단어.`, ``, `## 코드`, '```javascript', fileContent, '```'].join('\n');
     log(JSON.stringify({
       file: target,
       filePath, fileSize,
-      personas: personas.map(p => ({ id: p.id, name: p.name }))
+      personas: personas.map(p => ({ id: p.id, name: p.name })),
+      prompts: personas.map(p => ({ personaId: p.id, prompt: _mkPrompt(p) }))
     }, null, 2));
     return;
   }
@@ -16796,6 +16817,23 @@ function graphCmd(root) {
 
 function guideCmd(root, target) {
   root = absRoot(root);
+  // 1.36.46 (codex 5차 #10 잔여): --json 은 하위 4섹션 출력을 캡처해 단일 JSON 으로 집계 (종전: 사람용 헤딩+JSON 파편 혼합).
+  if (has('--json')) {
+    const q0 = target ? path.basename(target, path.extname(target)) : arg('--query', '');
+    const _cap = (fn) => {
+      const _w = process.stdout.write; let out = '';
+      try { process.stdout.write = s => { out += s; return true; }; fn(); } catch (e) { out += `\n(error: ${e.message})`; } finally { process.stdout.write = _w; }
+      return out.trim();
+    };
+    const sections = {
+      impact: target ? _cap(() => impactCmd(root, target)) : null,
+      reuse: q0 ? _cap(() => reuseFind(root, q0)) : null,
+      uiConsistency: _cap(() => uiConsistency(root)),
+      lessons: q0 ? _cap(() => { if (!process.argv.includes('--query')) process.argv.push('--query', q0); lessonsCmd(root); }) : null,
+    };
+    log(JSON.stringify({ target: target || null, query: q0 || null, date: today(), sections }, null, 2));
+    return;
+  }
   log(`# 변경 전 가이드 ${target ? `(target: ${target})` : ''}`);
   log(`Date: ${today()}\n`);
   if (target) {

package/lib/pure-utils.js

@@ -1159,11 +1159,20 @@ function _draftAnchors(sig = {}) {
     if (!t || t.startsWith('#') || t.startsWith('![') || t.startsWith('[!') || t.startsWith('<')) continue;
     readmeLead = t; break;
   }
+  // 1.36.47 (실적용 품질 결함): slice 가 구 중간을 절단해 "…주문 목록  를(을)…" 같은 어색문이 실프로젝트에 박혔다 —
+  //   단어/구두점 경계 절단 + 조사 병기 없는 문형으로.
+  const _cutAt = (s, n) => {
+    s = String(s || '').trim();
+    if (s.length <= n) return s;
+    const head = s.slice(0, n);
+    const brk = Math.max(head.lastIndexOf(' '), head.lastIndexOf(','), head.lastIndexOf('·'), head.lastIndexOf('。'), head.lastIndexOf('.'));
+    return (brk > n * 0.5 ? head.slice(0, brk) : head).replace(/[\s,·]+$/, '') + '…';
+  };
   if (desc) purpose.push(`- ${desc}`);
-  if (readmeLead && readmeLead !== desc) purpose.push(`- ${readmeLead.slice(0, 200)}`);
+  if (readmeLead && readmeLead !== desc) purpose.push(`- ${_cutAt(readmeLead, 200)}`);
   const ms = (sig.milestones || []).filter(m => m && m.title).slice(0, 3);
   const activeTasks = (sig.tasks || []).filter(t => t && /in-progress|planned|requested/.test(String(t.status || ''))).slice(0, 3);
-  if (desc || readmeLead) goal.push(`- ${(desc || readmeLead).slice(0, 160)} 를(을) 동작하는 제품으로 유지·발전시킨다`);
+  if (desc || readmeLead) goal.push(`- 제품을 동작 상태로 유지·발전시킨다: ${_cutAt(desc || readmeLead, 140)}`);
   for (const m of ms) goal.push(`- [${m.id || 'M'}] ${String(m.title).slice(0, 120)}${m.status ? ` (${m.status})` : ''}`);
   if (!goal.length && activeTasks.length) for (const t of activeTasks) goal.push(`- ${t.id}: ${String(t.request || '').slice(0, 100)}`);
   const marker = '<!-- draft: leerness anchors — 실신호 기반 초안. AI/사용자가 검토·수정 후 이 주석을 지우면 확정 -->';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.36.45",
+  "version": "1.36.47",
   "description": "The AI-coding operations layer that makes \"done\" require evidence — persistent memory, evidence-gated completion checks, and clean handoffs for any AI agent (Claude Code, Codex, Cursor). State lives as plain files in your repo. CLI + MCP, 0 runtime dependencies.",
   "keywords": [
     "leerness",