leerness 1.36.110 → 1.36.112

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -122,7 +122,7 @@ MIT
122
122
  <!-- leerness:project-readme:start -->
123
123
  ## Leerness Project Harness
124
124
 
125
- 이 프로젝트는 Leerness v1.36.110 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
125
+ 이 프로젝트는 Leerness v1.36.112 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
126
126
 
127
127
  ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
128
128
 
@@ -176,7 +176,7 @@ leerness memory restore decision <date|title>
176
176
 
177
177
  ### MCP server (외부 AI 통합)
178
178
 
179
- Leerness v1.36.110는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **89개 도구**를 노출:
179
+ Leerness v1.36.112는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **89개 도구**를 노출:
180
180
 
181
181
  ```jsonc
182
182
  // 카테고리별
@@ -197,7 +197,7 @@ Leerness v1.36.110는 stdio JSON-RPC MCP server를 내장합니다 — Claude Co
197
197
  `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
198
198
  1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) 회귀 테스트 갱신 → 4) 전체 e2e 스위트 통과 → 5) npm publish + git tag → 6) main push → 7) session close → 8) 다음 라운드 예약.
199
199
 
200
- 현재 누적: **v1.9.x → 1.36.110 릴리스 태그 이력** (수백 라운드) · _reports/는 비공개 보존.
200
+ 현재 누적: **v1.9.x → 1.36.112 릴리스 태그 이력** (수백 라운드) · _reports/는 비공개 보존.
201
201
 
202
202
  ### 성능 가이드
203
203
 
@@ -235,5 +235,5 @@ leerness release pack --close --auto-main-push
235
235
  - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
236
236
  - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
237
237
 
238
- Last synced by Leerness v1.36.110: 2026-08-10
238
+ Last synced by Leerness v1.36.112: 2026-08-11
239
239
  <!-- leerness:project-readme:end -->
package/bin/leerness.js CHANGED
@@ -34,7 +34,7 @@ const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE
34
34
  const { tokenizeForRank: _tokenizeForRank, expandQuery: _expandQuery, scoreHits: _scoreHits, suggestTerms: _suggestTerms } = require('../lib/search-core'); // 1.36.23: memory search 랭킹 코어(순수·0-deps)
35
35
  const { findCorruptedStateJson: _findCorruptedStateJson } = require('../lib/state-integrity'); // 1.36.1 (클린룸 리뷰 FN): .harness/*.json 상태 무결성 (audit/health/check 공유)
36
36
 
37
- const VERSION = '1.36.110';
37
+ const VERSION = '1.36.112';
38
38
 
39
39
  // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
40
40
  // 이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -660,10 +660,13 @@ function _readManifestChecked(root) {
660
660
  const mf = path.join(absRoot(root || process.cwd()), '.harness', 'manifest.json');
661
661
  if (!exists(mf)) return { path: mf, exists: false, corrupt: false, data: {} };
662
662
  let raw = null;
663
- try { raw = read(mf); } catch { return { path: mf, exists: true, corrupt: true, reason: '읽기 실패', data: {} }; }
663
+ // 1.36.112: `reason` 한국어 문장뿐이라, 이걸 끼워 넣는 영어 문장이 한국어를 새게 한다
664
+ // (영어 손상 경고 안에 `읽기 실패` 가 그대로 박혔다 — 이 저장소가 래칫으로 세는 바로 그 결함이다).
665
+ // 기존 소비자(`corruptReason`)를 위해 `reason` 은 그대로 두고, 표시 쪽이 언어를 고르도록 **안정 코드**를 함께 싣는다.
666
+ try { raw = read(mf); } catch { return { path: mf, exists: true, corrupt: true, reason: '읽기 실패', code: 'read_failed', data: {} }; }
664
667
  let j = null;
665
- try { j = JSON.parse(raw); } catch { return { path: mf, exists: true, corrupt: true, reason: 'JSON 파싱 실패', data: {} }; }
666
- if (!j || typeof j !== 'object' || Array.isArray(j)) return { path: mf, exists: true, corrupt: true, reason: '최상위가 객체가 아님', data: {} };
668
+ try { j = JSON.parse(raw); } catch { return { path: mf, exists: true, corrupt: true, reason: 'JSON 파싱 실패', code: 'json_parse_failed', data: {} }; }
669
+ if (!j || typeof j !== 'object' || Array.isArray(j)) return { path: mf, exists: true, corrupt: true, reason: '최상위가 객체가 아님', code: 'not_an_object', data: {} };
667
670
  return { path: mf, exists: true, corrupt: false, data: j };
668
671
  }
669
672
  function _projectMode(root) {
@@ -6430,7 +6433,7 @@ function _selfTestCases() {
6430
6433
  return clar && shape && noDbUrl && reqOk && guards && uiOk && _p0013LibraryOk() && _p0088CurrentStatePreserved()
6431
6434
  && _p0101SurfaceOk() && _p0101SkillIdOk() && _p0101PathStrictOk() && _p0102HonestyOk()
6432
6435
  && _p0103FlagsOk() && _p0103JsonOk() && _p0103RootOk() && _p0104UsageOk()
6433
- && _p0014SecretBaselineOk() && _p0104ReminderOk() && _p0015ModeOk() && _p0097AsyncLockOk() && _p0109ClaimGateOk() && _p0110HonestyOk();
6436
+ && _p0014SecretBaselineOk() && _p0104ReminderOk() && _p0015ModeOk() && _p0097AsyncLockOk() && _p0109ClaimGateOk() && _p0110HonestyOk() && _p0112CarryOk();
6434
6437
  } },
6435
6438
  { name: '시크릿 스캐너 F-06 (1.36.56, 외부감사): 무명 확장자 소형 텍스트 스캔(이진 NUL 제외) + 같은 토큰 중복 보고 dedupe — 행위검사', run: () => {
6436
6439
  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_sc56_'));
@@ -8164,6 +8167,51 @@ function _p0110HonestyOk() {
8164
8167
  return symmetric && neverBlocks && highSymmetric && futureScopeAllowed && noFalseBlock && optIn;
8165
8168
  } catch { return false; }
8166
8169
  }
8170
+ // 1.36.112: 이월 블록의 **경계 판정**. 쓰는 쪽(_managedMerge)과 읽는 쪽(_splitPreserved)이 같은 상수를 봐야 한다 —
8171
+ // 어긋나면 `context budget` 이 이월분을 0 으로 보고하고, 두 번(1.36.95 · 1.36.105) 미뤄진 부채가 다시 안 보이게 된다.
8172
+ // 양방향으로 단언한다: 있는 경계를 찾는지, 그리고 **없는 경계를 만들지 않는지**. 후자가 더 위험하다 —
8173
+ // 사용자 산문을 이월분으로 오인하면 "지침의 100% 가 이월" 이라는 거짓 보고가 나온다.
8174
+ function _p0112CarryOk() {
8175
+ try {
8176
+ const p = require('../lib/pure-utils');
8177
+ const base = '# T\n\n- managed line\n';
8178
+ const merged = p._managedMerge('AGENTS.md', base, base + '\n- CUSTOM-CARRY-A\n- CUSTOM-CARRY-B\n', '.harness/archive', new Set(), {});
8179
+ const s = p._splitPreserved(merged);
8180
+ // ① 무손실 — 관리분 + 이월분이 원문과 **바이트 동일**. 한쪽이라도 흘리면 계량이 조용히 틀린다.
8181
+ const lossless = (s.managed + s.preserved) === merged;
8182
+ // ② 경계가 옳은 쪽에 있다
8183
+ const placed = s.preserved.includes('CUSTOM-CARRY-A') && !s.managed.includes('CUSTOM-CARRY-A')
8184
+ && s.managed.includes('- managed line') && s.preserved.includes(p.PRESERVED_TAG);
8185
+ // ③ 경계가 없으면 만들지 않는다
8186
+ const noop = (() => { const n = p._splitPreserved(base); return n.preserved === '' && n.managed === base && n.at === -1; })();
8187
+ // ④ 태그가 지워진 구형 설치본은 제목으로 가르되, **생성 안내문이 뒤따를 때만** 인정한다.
8188
+ const legacy = (() => {
8189
+ const r = p._splitPreserved(base + '\n---\n## Preserved previous content\n\n> 이전 버전에서 이어진 내용. 전체 원본 백업: `.harness/archive`\n\n- OLD-LINE\n');
8190
+ return r.preserved.includes('OLD-LINE') && !r.managed.includes('OLD-LINE');
8191
+ })();
8192
+ // ④-b 같은 제목이어도 안내문이 없으면 경계가 아니다 — 사용자가 쓴 동명 섹션을 통째로 삼키지 않기 위해서다.
8193
+ // 편향은 **과소 보고** 쪽에 둔다: 못 세는 것보다, 사용자 산문을 "옮기세요" 라고 권하는 쪽이 나쁘다.
8194
+ const legacyNeedsNote = p._splitPreserved(base + '\n---\n## Preserved previous content\n\n- 사용자가 직접 쓴 항목\n').preserved === '';
8195
+ // ⑤ 본문에 그 낱말이 **문장으로** 나오는 것만으로는 가르지 않는다(제목 줄 전체를 앵커로 쓰는 이유)
8196
+ const inline = (() => {
8197
+ const r = p._splitPreserved('# T\n\nWe keep Preserved previous content in the wiki, not here.\n');
8198
+ return r.preserved === '' && r.at === -1;
8199
+ })();
8200
+ // ⑤-b 태그가 **문장 안에 인용**된 경우도 경계가 아니다 — 생성기는 태그를 자기 줄에 쓰고 바로 다음 줄에 제목을 쓴다.
8201
+ // (leerness 자신을 설명하는 문서가 이 마커를 인용하면, 그 뒤 전부가 '이월분' 이 되던 형태다.)
8202
+ const quoted = p._splitPreserved(`# T\n\n우리는 이 마커를 씁니다: \`${p.PRESERVED_TAG}\`\n\n- 실제 지침\n`).preserved === '';
8203
+ // ⑥ 빈/비문자열 입력에서 죽지 않는다
8204
+ const edge = p._splitPreserved('').preserved === '' && p._splitPreserved(null).managed === ''
8205
+ && p._splitPreserved(undefined).at === -1;
8206
+ // ⑦ 병적 입력에서 선형이어야 한다. 초안은 접두 **전체**를 정규식으로 훑어 개행 40만 개 입력이 **52,790ms** 였다
8207
+ // (5만 642ms → 40만 52,790ms, 명백한 2차식). 꼬리만 보도록 고친 뒤 0.2ms. 넉넉히 1.5초로 건다.
8208
+ const perf = (() => {
8209
+ const big = '\n'.repeat(400000) + p.PRESERVED_TAG + '\n## Preserved previous content\n';
8210
+ const t0 = Date.now(); p._splitPreserved(big); return (Date.now() - t0) < 1500;
8211
+ })();
8212
+ return lossless && placed && noop && legacy && legacyNeedsNote && inline && quoted && edge && perf;
8213
+ } catch { return false; }
8214
+ }
8167
8215
  function _p0109ClaimGateOk() {
8168
8216
  try {
8169
8217
  const an = require('../lib/analyzers');
@@ -8854,141 +8902,160 @@ function commandsCmd(root) {
8854
8902
  const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
8855
8903
  const cats = {
8856
8904
  status: [
8857
- { cmd: 'handoff [path] [--json] [--pulse] [--compact] [--quiet]', desc: '세션 시작 컨텍스트 + 7 통합 필드' },
8858
- { cmd: 'health [path] [--json] [--strict]', desc: '종합 헬스 + drift/security/skill/memory/featureGraph/roundHistory/milestones' },
8859
- { cmd: 'pulse [path] [--json]', desc: '한 줄 종합 요약 (1.9.231)' },
8860
- { cmd: 'round-history [path] [--json]', desc: 'git tag 기반 자율 라운드 통계 (1.9.226)' },
8861
- { cmd: 'milestones [path] [--json]', desc: '도달 마일스톤 + 다음 ETA (1.9.229)' },
8862
- { cmd: 'session-resume [path] [--auto-fix] [--json]', desc: '비정상 종료 감지 + 자율 재개 (1.9.220/222)' },
8863
- { cmd: 'which', desc: '활성 provider + 경로 진단' },
8864
- { cmd: 'memory status [path] [--json]', desc: 'T/D/R/P/L Memory Surface (1.9.114)' }
8905
+ { cmd: 'handoff [path] [--json] [--pulse] [--compact] [--quiet]', desc: '세션 시작 컨텍스트 + 7 통합 필드', descEn: 'session-start context + 7 integrated fields' },
8906
+ { cmd: 'health [path] [--json] [--strict]', desc: '종합 헬스 + drift/security/skill/memory/featureGraph/roundHistory/milestones', descEn: 'overall health + drift/security/skill/memory/featureGraph/roundHistory/milestones' },
8907
+ { cmd: 'pulse [path] [--json]', desc: '한 줄 종합 요약 (1.9.231)', descEn: 'one-line overall summary (1.9.231)' },
8908
+ { cmd: 'round-history [path] [--json]', desc: 'git tag 기반 자율 라운드 통계 (1.9.226)', descEn: 'autonomous round stats from git tags (1.9.226)' },
8909
+ { cmd: 'milestones [path] [--json]', desc: '도달 마일스톤 + 다음 ETA (1.9.229)', descEn: 'reached milestones + next ETA (1.9.229)' },
8910
+ { cmd: 'session-resume [path] [--auto-fix] [--json]', desc: '비정상 종료 감지 + 자율 재개 (1.9.220/222)', descEn: 'detect abnormal shutdown + autonomous resume (1.9.220/222)' },
8911
+ { cmd: 'which', desc: '활성 provider + 경로 진단', descEn: 'active provider + path diagnosis' },
8912
+ { cmd: 'memory status [path] [--json]', desc: 'T/D/R/P/L Memory Surface (1.9.114)', descEn: 'T/D/R/P/L memory surface (1.9.114)' }
8865
8913
  ],
8866
8914
  task: [
8867
- { cmd: 'task add "<request>"', desc: 'task 추가 (자동 dedup 1.9.212, review trigger 1.9.177)' },
8868
- { cmd: 'task update <id> --status <S>', desc: 'task 상태 갱신' },
8869
- { cmd: 'task drop <id>', desc: 'task 드롭' },
8870
- { cmd: 'task export --to <path>', desc: 'TodoWrite JSON 형식 export (1.9.60)' },
8871
- { cmd: 'next-action take|list [--json]', desc: 'next-action queue (1.9.201)' }
8915
+ { cmd: 'task add "<request>"', desc: 'task 추가 (자동 dedup 1.9.212, review trigger 1.9.177)', descEn: 'add a task (auto-dedup 1.9.212, review trigger 1.9.177)' },
8916
+ { cmd: 'task update <id> --status <S>', desc: 'task 상태 갱신', descEn: 'update task status' },
8917
+ { cmd: 'task drop <id>', desc: 'task 드롭', descEn: 'drop a task' },
8918
+ { cmd: 'task export --to <path>', desc: 'TodoWrite JSON 형식 export (1.9.60)', descEn: 'export in TodoWrite JSON format (1.9.60)' },
8919
+ { cmd: 'next-action take|list [--json]', desc: 'next-action queue (1.9.201)', descEn: 'next-action queue (1.9.201)' }
8872
8920
  ],
8873
8921
  memory: [
8874
- { cmd: 'decision add|list|drop <id>', desc: 'decisions.md CRUD (1.9.108/118/125)' },
8875
- { cmd: 'rule add|list|pause|resume|remove', desc: 'rules.md CRUD (1.9.8/109)' },
8876
- { cmd: 'plan add|list <M-id>', desc: 'plan.md milestone CRUD (1.9.110/119)' },
8877
- { cmd: 'lesson save|list|drop', desc: 'lessons.md CRUD (1.9.112/117/124)' }
8922
+ { cmd: 'decision add|list|drop <id>', desc: 'decisions.md CRUD (1.9.108/118/125)', descEn: 'decisions.md CRUD (1.9.108/118/125)' },
8923
+ { cmd: 'rule add|list|pause|resume|remove', desc: 'rules.md CRUD (1.9.8/109)', descEn: 'rules.md CRUD (1.9.8/109)' },
8924
+ { cmd: 'plan add|list <M-id>', desc: 'plan.md milestone CRUD (1.9.110/119)', descEn: 'plan.md milestone CRUD (1.9.110/119)' },
8925
+ { cmd: 'lesson save|list|drop', desc: 'lessons.md CRUD (1.9.112/117/124)', descEn: 'lessons.md CRUD (1.9.112/117/124)' }
8878
8926
  ],
8879
8927
  audit: [
8880
- { cmd: 'audit [path] [--fix] [--strict] [--json]', desc: '메타 + 보안 + npm CVE 통합 감사' },
8881
- { cmd: 'drift check [path] [--auto-fix] [--json]', desc: 'drift 신호 + 자동 회복 (1.9.37/82/225)' },
8882
- { cmd: 'scan secrets [path]', desc: '시크릿 탐지' },
8883
- { cmd: 'encoding check [path]', desc: '인코딩 검증' },
8884
- { cmd: 'lazy detect [path] [--json]', desc: '게으른 작업 감지 (1.9.101)' },
8885
- { cmd: 'verify-claim <T-ID|--all> [--run-tests] [--test-cmd "<명령>"] [--strict-claims] [--require-evidence]', desc: '주장 검증 (1.9.18~26) — --all: 모든 done 주장 일괄 검증(CI·스케일, 1.33.2) · --require-evidence: done 주장에 파일+테스트 근거 강제 (1.9.287) · --test-cmd: 비-JS 테스트 명령 (1.17.2)' },
8886
- { cmd: `lens [${_lensDomainList()}] [--json]`, desc: '분야별 자기질문 품질 렌즈 + 분야간 인과관계 (1.18.3 · database/contract/recovery/observability 는 심화, axes 는 8축 경량 점검)' },
8928
+ { cmd: 'audit [path] [--fix] [--strict] [--json]', desc: '메타 + 보안 + npm CVE 통합 감사', descEn: 'combined meta + security + npm CVE audit' },
8929
+ { cmd: 'drift check [path] [--auto-fix] [--json]', desc: 'drift 신호 + 자동 회복 (1.9.37/82/225)', descEn: 'drift signals + auto-recovery (1.9.37/82/225)' },
8930
+ { cmd: 'scan secrets [path]', desc: '시크릿 탐지', descEn: 'secret detection' },
8931
+ { cmd: 'encoding check [path]', desc: '인코딩 검증', descEn: 'encoding verification' },
8932
+ { cmd: 'lazy detect [path] [--json]', desc: '게으른 작업 감지 (1.9.101)', descEn: 'detect lazy/incomplete work (1.9.101)' },
8933
+ { cmd: 'verify-claim <T-ID|--all> [--run-tests] [--test-cmd "<명령>"] [--strict-claims] [--require-evidence]', cmdEn: 'verify-claim <T-ID|--all> [--run-tests] [--test-cmd "<command>"] [--strict-claims] [--require-evidence]', desc: '주장 검증 (1.9.18~26) — --all: 모든 done 주장 일괄 검증(CI·스케일, 1.33.2) · --require-evidence: done 주장에 파일+테스트 근거 강제 (1.9.287) · --test-cmd: 비-JS 테스트 명령 (1.17.2)', descEn: 'verify a claim (1.9.18~26) — --all: verify every done claim at once (CI/scale, 1.33.2) · --require-evidence: require file + test evidence on done claims (1.9.287) · --test-cmd: non-JS test command (1.17.2)' },
8934
+ { cmd: `lens [${_lensDomainList()}] [--json]`, desc: '분야별 자기질문 품질 렌즈 + 분야간 인과관계 (1.18.3 · database/contract/recovery/observability 는 심화, axes 는 8축 경량 점검)', descEn: 'per-domain self-question quality lenses + cross-domain causality (1.18.3 · database/contract/recovery/observability are deep dives, axes is a light 8-axis check)' },
8887
8935
  // 1.36.101 (명령 표면 감사): 1.36.98 에서 디스패처에만 붙이고 commands/--help 에 등재하지 않아 '있는데 안 보이는' 명령이었다.
8888
- { cmd: 'library [show|page] [path] [--json] [--ai]', desc: '재사용 인벤토리 — 컴포넌트·디자인 토큰을 저장소에서 추출. page: 오프라인 단일 HTML · --ai: 에이전트용 압축 JSON (1.36.98 P-0013)' },
8889
- { cmd: 'optimism-check <T-ID>', desc: '낙관적 API 감지 (1.9.26)' },
8890
- { cmd: 'requests audit|list|complete|drop|auto-complete', desc: '사용자 요청 추적 (1.9.207/223)' },
8891
- { cmd: 'pre-wake-audit [path] [--last]', desc: 'sleep 전 점검 (1.9.209)' },
8892
- { cmd: 'idempotency audit', desc: '멱등성 위반 탐지 (1.9.212)' }
8936
+ { cmd: 'library [show|page] [path] [--json] [--ai]', desc: '재사용 인벤토리 — 컴포넌트·디자인 토큰을 저장소에서 추출. page: 오프라인 단일 HTML · --ai: 에이전트용 압축 JSON (1.36.98 P-0013)', descEn: 'reuse inventory — extracts components and design tokens from the repo. page: offline single HTML · --ai: compact JSON for agents (1.36.98 P-0013)' },
8937
+ { cmd: 'optimism-check <T-ID>', desc: '낙관적 API 감지 (1.9.26)', descEn: 'detect optimistic API claims (1.9.26)' },
8938
+ { cmd: 'requests audit|list|complete|drop|auto-complete', desc: '사용자 요청 추적 (1.9.207/223)', descEn: 'track user requests (1.9.207/223)' },
8939
+ { cmd: 'pre-wake-audit [path] [--last]', desc: 'sleep 전 점검 (1.9.209)', descEn: 'pre-sleep checks (1.9.209)' },
8940
+ { cmd: 'idempotency audit', desc: '멱등성 위반 탐지 (1.9.212)', descEn: 'detect idempotency violations (1.9.212)' }
8893
8941
  ],
8894
8942
  workflow: [
8895
- { cmd: 'session close [path] [--json] [--auto-apply-delivered]', desc: '세션 마감 + 9 카테고리 + 자동 통합' },
8896
- { cmd: 'resume [path]', desc: 'auto-resume-plan 적용 (1.9.203)' },
8897
- { cmd: 'route <task-type>', desc: '작업 유형 분류 (11종)' },
8898
- { cmd: 'agents list|check|quota|dispatch|multi|recommend', desc: '외부 AI CLI 오케스트레이션 (dispatch --role 모델 라우팅 1.9.270)' },
8899
- { cmd: 'roles list|set|unset|catalog|suggest|verify', desc: '모델별 역할 부여 (코딩/검수/지휘/디자인/디버그/설계/분배) — 1.9.270' },
8900
- { cmd: 'capabilities [--json]', desc: '권한·보안 표면 공개 (무엇을 하는지 + opt-out + 주의 명령) — 1.9.272' },
8901
- { cmd: 'state show|start|record|verify|handoff', desc: '.leerness/ JSON 상태 substrate (에이전트 간 인수인계 표준) — 1.9.278' },
8902
- { cmd: 'adapter <tool>|list [--dry-run]', desc: '도구별 지침/.mcp.json 선택 생성 (claude/cursor/codex/goose/...) — 1.9.280' },
8903
- { cmd: 'ci init [path] [--force]', desc: 'PR 마다 leerness gate 실행하는 GitHub Actions 워크플로 생성 (.github/workflows/leerness-gate.yml) — 1.9.444' },
8904
- { cmd: 'export|prompt --target <agent>', desc: 'adapter 별칭 — 도구별 지침/계약 파일 생성 (claude/cursor/codex/agents-md/...) — 1.9.448' },
8905
- { cmd: 'glossary [build|show] [--lang ko|en|both] [--json]', desc: '의존성 용어집 — package.json/requirements 라이브러리를 비개발자용 한 줄 설명으로 (.harness/glossary.md) — 1.11.4' },
8906
- { cmd: 'policy show|set|check', desc: '권한 등급 (read-only…publish) — opt-in enforced (위험 명령 차단) — 1.9.281' },
8907
- { cmd: 'reuse-check "<기능>"', desc: '외부 OSS 빌드 vs 재사용 결정 게이트 (오프라인 카테고리+체크리스트) — 1.9.285' },
8908
- { cmd: 'skill impact', desc: '스킬 설치 영향 경량 상관추적 (사용 빈도 ↔ 검증 통과율, advisory) — 1.9.286' },
8909
- { cmd: 'release channel [--json]', desc: '릴리스 채널 정책 (latest 안정 / next 실험 / 버전 고정) — 1.9.275' },
8910
- { cmd: 'slash-commands [agent] [--json --record --detect --refresh]', desc: 'CLI 에이전트 슬래시 명령 레지스트리 + --help probe 자동 갱신 (1.9.265~267, UR-0021)' },
8911
- { cmd: 'review-request "<request>"', desc: '사용자 요청 사전 검토 (1.9.176)' },
8912
- { cmd: 'clarify "<사용자 요청>" [--json]', desc: '요청 모호성 신호 감지 → 사용자에게 물을 질문 생성 (추측 구현 방지) — 1.36.51 UR-0061' },
8913
- { cmd: 'tech [--json]', desc: '기술 프로필 — 개발 언어·연결 서비스 자동 감지 + 마이그레이션/언어전환 이력, 그래프 🛠 탭 표시 — 1.36.53 UR-0062' },
8914
- { cmd: 'integrity check [--repair] [--json]', desc: 'managed 정책-문서 12종 무결성(부재/H1 상실/절단) 점검 — --repair: archive 대피 후 템플릿 재생성 — 1.36.57 감사 F-04' },
8915
- { cmd: 'referee add|verify|list|show|drop', desc: '검증기 캘리브레이션 — 신뢰 전에 탐지력 증명(known-good 통과 + 망가뜨린 known-bad 를 기대 사유로 거부). verify-claim --referee / gate 게이팅 — 1.36.80 P-0001' },
8916
- { cmd: 'preview add|list|show|approve|revise|mockup|verify', desc: '신규 기능 미리보기 승인 워크플로 — approve 전 코드 작성 금지 계약. mockup <P-ID> [--target <파일>] [--force]: 프로젝트의 실제 토큰·컴포넌트·대상 화면 클래스를 심은 시안 · approve 시 그 시안이 계약으로 고정됨 · verify <P-ID> --files a,b: 구현이 계약을 지켰는지 존재 대조(시각적 일치는 보증하지 않음) — 1.36.51 UR-0061 · 1.36.75 UR-0066 · 1.36.99/1.36.100 P-0012' },
8917
- { cmd: 'dashboard [path] [--port N] [--timeout SEC] [--json]', desc: '.harness 읽기 전용 대시보드 — 토글·task·마일스톤·미리보기·라우팅기록·bugfix probe 를 localhost 에서 열람. 설정 변경·게이트 판정은 하지 않는다(CLI 가 판정). --json 은 서버 없이 같은 스냅샷 출력. 정적 단일파일 뷰(leerness.html)는 leerness graph --html 로 그대로 — 1.36.90 P-0006' },
8918
- { cmd: 'agents route "<작업>" [--tier tiny|normal|high-risk] [--confirm --approved-by "<승인자>"] [--log]', desc: '작업 난이도 판정(결정적 규칙) → 추상 역할(architect/commander/coder/reviewer) 배치 제안. 모델명 하드코딩 없이 `roles set` 매핑을 쓰고, 실행은 명시 확인 필요. 토글 기본 OFF: leerness toggle set difficulty-routing on — 1.36.89 P-0007' },
8919
- { cmd: 'bugfix start|receipt|drop|list', desc: 'bugfix 완료 영수증 — 수정 전 재현 probe 를 등록(2회 연속 실패해야 등록)하고, done 전이에서 통과 + 근본원인/형제범위 영수증을 요구. 토글 기본 OFF: leerness toggle set bugfix-receipt on — 1.36.87 P-0005' },
8920
- { cmd: 'review <file> --persona <ids>', desc: '페르소나 리뷰 (1.9.29)' },
8921
- { cmd: 'brainstorm "<topic>" [--include-code]', desc: '워크스페이스 회수 + 코드 grep' }
8943
+ { cmd: 'session close [path] [--json] [--auto-apply-delivered]', desc: '세션 마감 + 9 카테고리 + 자동 통합', descEn: 'close the session + 9 categories + auto integration' },
8944
+ { cmd: 'resume [path]', desc: 'auto-resume-plan 적용 (1.9.203)', descEn: 'apply the auto-resume plan (1.9.203)' },
8945
+ { cmd: 'route <task-type>', desc: '작업 유형 분류 (11종)', descEn: 'classify the task type (11 kinds)' },
8946
+ { cmd: 'agents list|check|quota|dispatch|multi|recommend', desc: '외부 AI CLI 오케스트레이션 (dispatch --role 모델 라우팅 1.9.270)', descEn: 'orchestrate external AI CLIs (dispatch --role model routing 1.9.270)' },
8947
+ { cmd: 'roles list|set|unset|catalog|suggest|verify', desc: '모델별 역할 부여 (코딩/검수/지휘/디자인/디버그/설계/분배) — 1.9.270', descEn: 'assign roles per model (coding/review/command/design/debug/architecture/dispatch) — 1.9.270' },
8948
+ { cmd: 'capabilities [--json]', desc: '권한·보안 표면 공개 (무엇을 하는지 + opt-out + 주의 명령) — 1.9.272', descEn: 'disclose the permission/security surface (what it does + opt-outs + commands to watch) — 1.9.272' },
8949
+ { cmd: 'state show|start|record|verify|handoff', desc: '.leerness/ JSON 상태 substrate (에이전트 간 인수인계 표준) — 1.9.278', descEn: '.leerness/ JSON state substrate (cross-agent handoff standard) — 1.9.278' },
8950
+ { cmd: 'adapter <tool>|list [--dry-run]', desc: '도구별 지침/.mcp.json 선택 생성 (claude/cursor/codex/goose/...) — 1.9.280', descEn: 'generate per-tool instructions/.mcp.json selectively (claude/cursor/codex/goose/...) — 1.9.280' },
8951
+ { cmd: 'ci init [path] [--force]', desc: 'PR 마다 leerness gate 실행하는 GitHub Actions 워크플로 생성 (.github/workflows/leerness-gate.yml) — 1.9.444', descEn: 'create a GitHub Actions workflow that runs leerness gate on every PR (.github/workflows/leerness-gate.yml) — 1.9.444' },
8952
+ { cmd: 'export|prompt --target <agent>', desc: 'adapter 별칭 — 도구별 지침/계약 파일 생성 (claude/cursor/codex/agents-md/...) — 1.9.448', descEn: 'adapter alias — generate per-tool instruction/contract files (claude/cursor/codex/agents-md/...) — 1.9.448' },
8953
+ { cmd: 'glossary [build|show] [--lang ko|en|both] [--json]', desc: '의존성 용어집 — package.json/requirements 라이브러리를 비개발자용 한 줄 설명으로 (.harness/glossary.md) — 1.11.4', descEn: 'dependency glossary — one-line plain-language descriptions of package.json/requirements libraries (.harness/glossary.md) — 1.11.4' },
8954
+ { cmd: 'policy show|set|check', desc: '권한 등급 (read-only…publish) — opt-in enforced (위험 명령 차단) — 1.9.281', descEn: 'permission tiers (read-only…publish) — opt-in enforcement (blocks risky commands) — 1.9.281' },
8955
+ { cmd: 'reuse-check "<기능>"', cmdEn: 'reuse-check "<capability>"', desc: '외부 OSS 빌드 vs 재사용 결정 게이트 (오프라인 카테고리+체크리스트) — 1.9.285', descEn: 'build-vs-reuse decision gate for external OSS (offline categories + checklist) — 1.9.285' },
8956
+ { cmd: 'skill impact', desc: '스킬 설치 영향 경량 상관추적 (사용 빈도 ↔ 검증 통과율, advisory) — 1.9.286', descEn: 'lightweight correlation of skill installs (usage frequency vs verification pass rate, advisory) — 1.9.286' },
8957
+ { cmd: 'release channel [--json]', desc: '릴리스 채널 정책 (latest 안정 / next 실험 / 버전 고정) — 1.9.275', descEn: 'release channel policy (latest stable / next experimental / pinned) — 1.9.275' },
8958
+ { cmd: 'slash-commands [agent] [--json --record --detect --refresh]', desc: 'CLI 에이전트 슬래시 명령 레지스트리 + --help probe 자동 갱신 (1.9.265~267, UR-0021)', descEn: 'slash-command registry for CLI agents + auto refresh via --help probe (1.9.265~267, UR-0021)' },
8959
+ { cmd: 'review-request "<request>"', desc: '사용자 요청 사전 검토 (1.9.176)', descEn: 'pre-review a user request (1.9.176)' },
8960
+ { cmd: 'clarify "<사용자 요청>" [--json]', cmdEn: 'clarify "<user request>" [--json]', desc: '요청 모호성 신호 감지 → 사용자에게 물을 질문 생성 (추측 구현 방지) — 1.36.51 UR-0061', descEn: 'detect ambiguity signals in a request → generate questions to ask the user (prevents guess-implementation) — 1.36.51 UR-0061' },
8961
+ { cmd: 'tech [--json]', desc: '기술 프로필 — 개발 언어·연결 서비스 자동 감지 + 마이그레이션/언어전환 이력, 그래프 🛠 탭 표시 — 1.36.53 UR-0062', descEn: 'tech profile — auto-detect languages and connected services + migration/language-switch history, shown on the graph 🛠 tab — 1.36.53 UR-0062' },
8962
+ { cmd: 'integrity check [--repair] [--json]', desc: 'managed 정책-문서 12종 무결성(부재/H1 상실/절단) 점검 — --repair: archive 대피 후 템플릿 재생성 — 1.36.57 감사 F-04', descEn: 'integrity check for the 12 managed policy documents (missing/lost H1/truncated) — --repair: archive the old copy then regenerate from template — 1.36.57 audit F-04' },
8963
+ { cmd: 'referee add|verify|list|show|drop', desc: '검증기 캘리브레이션 — 신뢰 전에 탐지력 증명(known-good 통과 + 망가뜨린 known-bad 를 기대 사유로 거부). verify-claim --referee / gate 게이팅 — 1.36.80 P-0001', descEn: 'verifier calibration — prove detection power before trusting it (passes known-good, rejects a broken known-bad for the expected reason). Gates verify-claim --referee / gate — 1.36.80 P-0001' },
8964
+ { cmd: 'preview add|list|show|approve|revise|mockup|verify', desc: '신규 기능 미리보기 승인 워크플로 — approve 전 코드 작성 금지 계약. mockup <P-ID> [--target <파일>] [--force]: 프로젝트의 실제 토큰·컴포넌트·대상 화면 클래스를 심은 시안 · approve 시 그 시안이 계약으로 고정됨 · verify <P-ID> --files a,b: 구현이 계약을 지켰는지 존재 대조(시각적 일치는 보증하지 않음) — 1.36.51 UR-0061 · 1.36.75 UR-0066 · 1.36.99/1.36.100 P-0012', descEn: 'preview-approval workflow for new features — contract: no code before approve. mockup <P-ID> [--target <file>] [--force]: a draft seeded with the project\'s real tokens/components/target-screen classes · approve freezes that draft as the contract · verify <P-ID> --files a,b: existence check that the implementation kept the contract (visual match is NOT guaranteed) — 1.36.51 UR-0061 · 1.36.75 UR-0066 · 1.36.99/1.36.100 P-0012' },
8965
+ { cmd: 'dashboard [path] [--port N] [--timeout SEC] [--json]', desc: '.harness 읽기 전용 대시보드 — 토글·task·마일스톤·미리보기·라우팅기록·bugfix probe 를 localhost 에서 열람. 설정 변경·게이트 판정은 하지 않는다(CLI 가 판정). --json 은 서버 없이 같은 스냅샷 출력. 정적 단일파일 뷰(leerness.html)는 leerness graph --html 로 그대로 — 1.36.90 P-0006', descEn: 'read-only .harness dashboard — browse toggles/tasks/milestones/previews/routing history/bugfix probes on localhost. It never changes settings or makes gate verdicts (the CLI does). --json prints the same snapshot without a server. The static single-file view (leerness.html) is still leerness graph --html — 1.36.90 P-0006' },
8966
+ { cmd: 'agents route "<작업>" [--tier tiny|normal|high-risk] [--confirm --approved-by "<승인자>"] [--log]', cmdEn: 'agents route "<task>" [--tier tiny|normal|high-risk] [--confirm --approved-by "<approver>"] [--log]', desc: '작업 난이도 판정(결정적 규칙) → 추상 역할(architect/commander/coder/reviewer) 배치 제안. 모델명 하드코딩 없이 `roles set` 매핑을 쓰고, 실행은 명시 확인 필요. 토글 기본 OFF: leerness toggle set difficulty-routing on — 1.36.89 P-0007', descEn: 'judge task difficulty (deterministic rules) → propose an abstract-role assignment (architect/commander/coder/reviewer). Uses your `roles set` mapping instead of hardcoded model names, and execution needs explicit confirmation. Toggle is OFF by default: leerness toggle set difficulty-routing on — 1.36.89 P-0007' },
8967
+ { cmd: 'bugfix start|receipt|drop|list', desc: 'bugfix 완료 영수증 — 수정 전 재현 probe 를 등록(2회 연속 실패해야 등록)하고, done 전이에서 통과 + 근본원인/형제범위 영수증을 요구. 토글 기본 OFF: leerness toggle set bugfix-receipt on — 1.36.87 P-0005', descEn: 'bugfix completion receipt — register a reproduction probe before the fix (it must fail twice in a row to register), then require it to pass at the done transition plus a root-cause/sibling-scope receipt. Toggle is OFF by default: leerness toggle set bugfix-receipt on — 1.36.87 P-0005' },
8968
+ { cmd: 'review <file> --persona <ids>', desc: '페르소나 리뷰 (1.9.29)', descEn: 'persona-based review (1.9.29)' },
8969
+ { cmd: 'brainstorm "<topic>" [--include-code]', desc: '워크스페이스 회수 + 코드 grep', descEn: 'recall from the workspace + grep the code' }
8922
8970
  ],
8923
8971
  release: [
8924
- { cmd: 'release sync-main [path]', desc: 'main merge + push + 자동 npm publish (1.9.140/178)' },
8925
- { cmd: 'release pack', desc: 'tarball 생성' },
8926
- { cmd: 'release publish', desc: 'GitHub release 발행' },
8927
- { cmd: 'release channel [path] [--json]', desc: '릴리스 채널 정책 (stable/next/고정) — 1.9.275' },
8928
- { cmd: 'release cadence [path] [--json]', desc: '릴리스 빈도 진단 + 권장 (외부리뷰 케이던스 가시화) — UR-0074, 1.9.374' }
8972
+ { cmd: 'release sync-main [path]', desc: 'main merge + push + 자동 npm publish (1.9.140/178)', descEn: 'merge to main + push + auto npm publish (1.9.140/178)' },
8973
+ { cmd: 'release pack', desc: 'tarball 생성', descEn: 'build the tarball' },
8974
+ { cmd: 'release publish', desc: 'GitHub release 발행', descEn: 'publish a GitHub release' },
8975
+ { cmd: 'release channel [path] [--json]', desc: '릴리스 채널 정책 (stable/next/고정) — 1.9.275', descEn: 'release channel policy (stable/next/pinned) — 1.9.275' },
8976
+ { cmd: 'release cadence [path] [--json]', desc: '릴리스 빈도 진단 + 권장 (외부리뷰 케이던스 가시화) — UR-0074, 1.9.374', descEn: 'release cadence diagnosis + recommendation — UR-0074, 1.9.374' }
8929
8977
  ],
8930
8978
  skill: [
8931
- { cmd: 'skill list|info|learn|use|optimize|match|suggest', desc: 'skill 카탈로그 CRUD' },
8932
- { cmd: 'skill install|install-top|publish|search|discover', desc: 'skill 배포 + 검색' }
8979
+ { cmd: 'skill list|info|learn|use|optimize|match|suggest', desc: 'skill 카탈로그 CRUD', descEn: 'skill catalog CRUD' },
8980
+ { cmd: 'skill install|install-top|publish|search|discover', desc: 'skill 배포 + 검색', descEn: 'skill distribution + search' }
8933
8981
  ],
8934
8982
  bridge: [
8935
- { cmd: 'web check|screenshot|extract <url>', desc: 'playwright bridge (opt-in, 1.9.165)' },
8936
- { cmd: 'pc check|click|type|screenshot', desc: 'robotjs/nut-tree bridge (opt-in, 1.9.166)' },
8937
- { cmd: 'lsp check|symbols|references', desc: 'LSP 어댑터 (1.9.167)' }
8983
+ { cmd: 'web check|screenshot|extract <url>', desc: 'playwright bridge (opt-in, 1.9.165)', descEn: 'playwright bridge (opt-in, 1.9.165)' },
8984
+ { cmd: 'pc check|click|type|screenshot', desc: 'robotjs/nut-tree bridge (opt-in, 1.9.166)', descEn: 'robotjs/nut-tree bridge (opt-in, 1.9.166)' },
8985
+ { cmd: 'lsp check|symbols|references', desc: 'LSP 어댑터 (1.9.167)', descEn: 'LSP adapter (1.9.167)' }
8938
8986
  ],
8939
8987
  config: [
8940
- { cmd: 'init [path]', desc: '워크스페이스 초기화' },
8941
- { cmd: 'migrate [path] [--dry-run]', desc: '업데이트 마이그레이션' },
8942
- { cmd: 'update [--check|--yes|--force]', desc: '자가 업데이트' },
8943
- { cmd: 'wakeup-interval get|set|auto|history|record', desc: 'adaptive wakeup (1.9.210)' },
8944
- { cmd: 'workspace-dir get|guide', desc: '워크스페이스 디렉토리 (1.9.211)' },
8945
- { cmd: 'parent detect|adopt [--select <kinds>] [--apply]', desc: '상위 leerness 부모 탐지 + 자산 게이트형 adopt (1.30.2~3)' },
8946
- { cmd: 'intent classify|expand|domains "<request>"', desc: '의도 파악 + scope (1.9.213)' },
8947
- { cmd: 'constraints list|check|add', desc: '플랫폼/API 제약 (1.9.208)' },
8948
- { cmd: 'provider list|add|remove|sync', desc: 'Provider Registry (1.9.157~160)' },
8949
- { cmd: 'commands [--json]', desc: '전체 명령 카테고리 목록 (1.9.233)' },
8950
- { cmd: 'migrate audit|apply|plan [path] [--json] [--yes]', desc: '크로스버전 마이그레이션 진단/적용/플랜 (UR-0075, 1.9.356~358)' },
8951
- { cmd: 'migrate --guide', desc: 'AI 에이전트용 크로스버전 마이그레이션 가이드 (1.9.355)' },
8952
- { cmd: 'doctor [--json]', desc: '설치/환경 진단 (1.9.315)' },
8953
- { cmd: 'selftest [--json]', desc: '코어 함수 무결성 자가 검증 (1.9.258)' },
8988
+ { cmd: 'init [path]', desc: '워크스페이스 초기화', descEn: 'initialize the workspace' },
8989
+ { cmd: 'migrate [path] [--dry-run]', desc: '업데이트 마이그레이션', descEn: 'update migration' },
8990
+ { cmd: 'update [--check|--yes|--force]', desc: '자가 업데이트', descEn: 'self-update' },
8991
+ { cmd: 'wakeup-interval get|set|auto|history|record', desc: 'adaptive wakeup (1.9.210)', descEn: 'adaptive wakeup interval (1.9.210)' },
8992
+ { cmd: 'workspace-dir get|guide', desc: '워크스페이스 디렉토리 (1.9.211)', descEn: 'workspace directory (1.9.211)' },
8993
+ { cmd: 'parent detect|adopt [--select <kinds>] [--apply]', desc: '상위 leerness 부모 탐지 + 자산 게이트형 adopt (1.30.2~3)', descEn: 'detect a parent leerness above + gated asset adoption (1.30.2~3)' },
8994
+ { cmd: 'intent classify|expand|domains "<request>"', desc: '의도 파악 + scope (1.9.213)', descEn: 'infer intent + scope (1.9.213)' },
8995
+ { cmd: 'constraints list|check|add', desc: '플랫폼/API 제약 (1.9.208)', descEn: 'platform/API constraints (1.9.208)' },
8996
+ { cmd: 'provider list|add|remove|sync', desc: 'Provider Registry (1.9.157~160)', descEn: 'provider registry (1.9.157~160)' },
8997
+ { cmd: 'commands [--json]', desc: '전체 명령 카테고리 목록 (1.9.233)', descEn: 'full command catalog by category (1.9.233)' },
8998
+ { cmd: 'migrate audit|apply|plan [path] [--json] [--yes]', desc: '크로스버전 마이그레이션 진단/적용/플랜 (UR-0075, 1.9.356~358)', descEn: 'cross-version migration diagnose/apply/plan (UR-0075, 1.9.356~358)' },
8999
+ { cmd: 'migrate --guide', desc: 'AI 에이전트용 크로스버전 마이그레이션 가이드 (1.9.355)', descEn: 'cross-version migration guide for AI agents (1.9.355)' },
9000
+ { cmd: 'doctor [--json]', desc: '설치/환경 진단 (1.9.315)', descEn: 'install/environment diagnosis (1.9.315)' },
9001
+ { cmd: 'selftest [--json]', desc: '코어 함수 무결성 자가 검증 (1.9.258)', descEn: 'self-verify core function integrity (1.9.258)' },
8954
9002
  // 1.36.101 (명령 표면 감사): 둘 다 실행되고 문서에도 있는데 이 목록에만 없었다 — '있는데 안 보이는 명령'.
8955
- { cmd: 'gate [path]', desc: 'CI 한 번 호출 게이트 — verify + audit + scan + encoding + lazy' },
8956
- { cmd: 'toggle get|set|list <기능> [on|off]', desc: '기능 토글 (gate/lens/auto-graph/delegation-brief) — leerness.html ⚙ 탭과 연동 (1.36.30)' },
8957
- { cmd: 'install-safety [--json]', desc: '설치 안전 프로필 — 0 deps/0 install-script (1.9.359)' },
8958
- { cmd: 'env check|sync|detect [path]', desc: '셸/인코딩 환경 진단 (1.9.241)' },
8959
- { cmd: 'shell-guard "<command>"', desc: '셸 호환성 정적 분석 (1.9.260)' },
8960
- { cmd: 'path-setup [--apply]', desc: 'CLI PATH 자동 등록 (1.9.254)' }
9003
+ { cmd: 'gate [path]', desc: 'CI 한 번 호출 게이트 — verify + audit + scan + encoding + lazy', descEn: 'single-call CI gate — verify + audit + scan + encoding + lazy' },
9004
+ { cmd: 'toggle get|set|list <기능> [on|off]', cmdEn: 'toggle get|set|list <feature> [on|off]', desc: '기능 토글 (gate/lens/auto-graph/delegation-brief) — leerness.html ⚙ 탭과 연동 (1.36.30)', descEn: 'feature toggles (gate/lens/auto-graph/delegation-brief) — synced with the leerness.html ⚙ tab (1.36.30)' },
9005
+ { cmd: 'install-safety [--json]', desc: '설치 안전 프로필 — 0 deps/0 install-script (1.9.359)', descEn: 'install safety profile — 0 deps / 0 install scripts (1.9.359)' },
9006
+ { cmd: 'env check|sync|detect [path]', desc: '셸/인코딩 환경 진단 (1.9.241)', descEn: 'shell/encoding environment diagnosis (1.9.241)' },
9007
+ { cmd: 'shell-guard "<command>"', desc: '셸 호환성 정적 분석 (1.9.260)', descEn: 'static shell-compatibility analysis (1.9.260)' },
9008
+ { cmd: 'path-setup [--apply]', desc: 'CLI PATH 자동 등록 (1.9.254)', descEn: 'register the CLI on PATH automatically (1.9.254)' }
8961
9009
  ],
8962
9010
  ops: [
8963
- { cmd: 'feature add|link|impact|list|show', desc: '기능 그래프(feature-graph) 추적' },
8964
- { cmd: 'permissions list|set', desc: 'agent 권한 모드 (1.9.174)' },
8965
- { cmd: 'capabilities [--json]', desc: '권한·보안 표면 공개 (1.9.272)' },
8966
- { cmd: 'creds list|register|check|refresh', desc: '크리덴셜 메타 추적 (값 미저장)' },
8967
- { cmd: 'incident list|show|handle', desc: '인시던트 관리' },
8968
- { cmd: 'webhook serve', desc: '웹훅 수신 서버' },
8969
- { cmd: 'deploy auto', desc: '배포 자동화' },
8970
- { cmd: 'runs list|show', desc: '실행 이력' },
8971
- { cmd: 'whats-new [path]', desc: '최근 버전 변경 요약' },
8972
- { cmd: 'team list|add|show|remove|preview|deploy <id> [--name --purpose --personas --members --schedule --task --deploy --yes]', desc: '에이전트 팀 정의 + preview(dry-run) + deploy(2중 게이트) — UR-0073 A~D, opt-in · 배포는 --yes+LEERNESS_TEAM_DEPLOY=1' }
9011
+ { cmd: 'feature add|link|impact|list|show', desc: '기능 그래프(feature-graph) 추적', descEn: 'feature-graph tracking' },
9012
+ { cmd: 'permissions list|set', desc: 'agent 권한 모드 (1.9.174)', descEn: 'agent permission mode (1.9.174)' },
9013
+ { cmd: 'capabilities [--json]', desc: '권한·보안 표면 공개 (1.9.272)', descEn: 'disclose the permission/security surface (1.9.272)' },
9014
+ { cmd: 'creds list|register|check|refresh', desc: '크리덴셜 메타 추적 (값 미저장)', descEn: 'credential metadata tracking (values never stored)' },
9015
+ { cmd: 'incident list|show|handle', desc: '인시던트 관리', descEn: 'incident management' },
9016
+ { cmd: 'webhook serve', desc: '웹훅 수신 서버', descEn: 'webhook receiver server' },
9017
+ { cmd: 'deploy auto', desc: '배포 자동화', descEn: 'deployment automation' },
9018
+ { cmd: 'runs list|show', desc: '실행 이력', descEn: 'run history' },
9019
+ { cmd: 'whats-new [path]', desc: '최근 버전 변경 요약', descEn: 'summary of recent version changes' },
9020
+ { cmd: 'team list|add|show|remove|preview|deploy <id> [--name --purpose --personas --members --schedule --task --deploy --yes]', desc: '에이전트 팀 정의 + preview(dry-run) + deploy(2중 게이트) — UR-0073 A~D, opt-in · 배포는 --yes+LEERNESS_TEAM_DEPLOY=1', descEn: 'define agent teams + preview (dry-run) + deploy (double gate) — UR-0073 A~D, opt-in · deploy needs --yes + LEERNESS_TEAM_DEPLOY=1' }
8973
9021
  ]
8974
9022
  };
9023
+ // 1.36.111 (T-0092): 영어 모드에서 이 명령이 **출력 218줄 중 105줄**을 한국어로 냈다 — 단일 최대 누출원이었다.
9024
+ // leerness 는 한국어 우선 도구가 아니다. 카탈로그에 descEn 을 두고 여기서 고른다(없으면 desc 로 폴백 —
9025
+ // 새 항목이 번역 없이 들어와도 목록에서 사라지지 않게. 누락은 e2e 래칫이 잡는다).
9026
+ // ⚠ 선언은 `--json` 조기 반환 **앞**에 있어야 한다 — 뒤에 두면 JSON 경로에서 TDZ 로 죽는다(작성 중 실측).
9027
+ const _cL = _uiLang(root) === 'en';
9028
+ const ct = (ko, en) => (_cL ? en : ko);
9029
+ // 1.36.111 (codex 검수 P1, 재현됨): 카탈로그를 그대로 직렬화하면 `descEn`/`cmdEn` 이 payload 에 실려
9030
+ // **70.5% 커진다**(12,786 → 21,795 B · ~3,875 → ~6,605 tok, 실측). 이 payload 는 MCP 로 에이전트에 나가므로
9031
+ // 그대로 컨텍스트 비용이다. 항목 스키마는 종전과 같은 `{cmd, desc}` 로 유지하고 **값만** 언어에 맞춘다.
9032
+ // 검수의 "기계 계약을 암묵적으로 로케일에 흔들지 마라" 지적은 타당하다 — 그래서 흔들리는 사실을
9033
+ // `lang` 필드로 **명시**한다. 소비자는 어느 언어의 payload 인지 알 수 있고, 크기는 늘지 않는다.
8975
9034
  if (has('--json')) {
8976
- log(JSON.stringify({ version: VERSION, totalCommands: Object.values(cats).reduce((s, a) => s + a.length, 0), categories: cats }, null, 2));
9035
+ const _lang = _cL ? 'en' : 'ko';
9036
+ const _localized = Object.fromEntries(Object.entries(cats).map(([k, list]) => [k, list.map(c => ({
9037
+ cmd: _cL ? (c.cmdEn || c.cmd) : c.cmd,
9038
+ desc: _cL ? (c.descEn || c.desc) : c.desc,
9039
+ }))]));
9040
+ log(JSON.stringify({ version: VERSION, lang: _lang, totalCommands: Object.values(cats).reduce((s, a) => s + a.length, 0), categories: _localized }, null, 2));
8977
9041
  return;
8978
9042
  }
8979
- log(cy(`# leerness commands (1.9.233) — 전체 CLI 명령 카테고리 목록`));
9043
+ log(cy(ct(`# leerness commands (1.9.233) — 전체 CLI 명령 카테고리 목록`, `# leerness commands (1.9.233) — full CLI command catalog by category`)));
8980
9044
  log('');
8981
9045
  for (const [catName, list] of Object.entries(cats)) {
8982
- log(gr(`## ${catName} (${list.length}개)`));
9046
+ // 단위 표기도 언어별로 — 여기서 `개` 를 통째로 뺐다가 한국어 출력이 바뀌는 회귀를 냈다(직전 커밋과 바이트 비교로 잡음).
9047
+ log(gr(ct(`## ${catName} (${list.length}개)`, `## ${catName} (${list.length})`)));
8983
9048
  list.forEach(c => {
8984
- log(` • ${c.cmd}`);
8985
- log(dm(` ${c.desc}`));
9049
+ // 자리표시자도 표면이다 — `<명령>`·`<기능>` 같은 한국어 placeholder 가 영어 사용법에 남으면 그대로 누출이다.
9050
+ log(`${_cL ? (c.cmdEn || c.cmd) : c.cmd}`);
9051
+ log(dm(` ${_cL ? (c.descEn || c.desc) : c.desc}`));
8986
9052
  });
8987
9053
  log('');
8988
9054
  }
8989
- log(dm(` → ${Object.values(cats).reduce((s, a) => s + a.length, 0)} 명령 (${Object.keys(cats).length} 카테고리)`));
8990
- log(dm(` → MCP 도구: ${_mcpToolCount()} (외부 AI 노출)`)); // 1.9.315 (UR-0054): 하드코딩 65 → 동적
8991
- log(dm(` → 빠른 시작: leerness pulse | handoff | health`));
9055
+ const _tot = Object.values(cats).reduce((s, a) => s + a.length, 0);
9056
+ log(dm(ct(` → ${_tot} 명령 (${Object.keys(cats).length} 카테고리)`, ` ${_tot} commands in ${Object.keys(cats).length} categories`)));
9057
+ log(dm(ct(` → MCP 도구: ${_mcpToolCount()} (외부 AI 노출)`, ` → MCP tools: ${_mcpToolCount()} (exposed to external AI)`))); // 1.9.315 (UR-0054): 하드코딩 65 → 동적
9058
+ log(dm(ct(` → 빠른 시작: leerness pulse | handoff | health`, ` → quick start: leerness pulse | handoff | health`)));
8992
9059
  }
8993
9060
 
8994
9061
  // 1.9.374 (UR-0074): release cadence — 릴리스 빈도 진단 + 권장 (외부리뷰 반복 지적 "릴리스 케이던스 과다" 가시화). git tag 재사용, 읽기 전용.
@@ -26168,25 +26235,88 @@ async function main() {
26168
26235
  const _cy = s => _tty2 ? `\x1b[36m${s}\x1b[0m` : s, _dm = s => _tty2 ? `\x1b[2m${s}\x1b[0m` : s;
26169
26236
  const _bRoot = absRoot(arg('--path', null) || _taskPositionalPath(args, 2) || process.cwd());
26170
26237
  const _bj = has('--json');
26171
- if (!exists(path.join(_bRoot, '.harness'))) { failJson(_bj, 'harness_missing', `leerness 미설치: ${_bRoot} 먼저 leerness init`); return; }
26238
+ // 1.36.112 (T-0100 일부 상환): 명령은 i18n 래칫의 측정 대상이다. 여기에 한국어 줄을 더하면 부채가 는다 —
26239
+ // 손대는 표면은 영어화까지 하고 간다(leerness 는 한국어 우선 도구가 아니다). 아래 `_bt` 로 고른다.
26240
+ const _bEn = _uiLang(_bRoot) === 'en';
26241
+ const _bt = (ko, en) => (_bEn ? en : ko);
26242
+ if (!exists(path.join(_bRoot, '.harness'))) { failJson(_bj, 'harness_missing', _bt(`leerness 미설치: ${_bRoot} — 먼저 leerness init`, `leerness not installed: ${_bRoot} — run leerness init first`)); return; }
26172
26243
  const _tok = (s) => Math.round(String(s || '').length / 3.2); // 한글 혼합 대략치 — 절대값이 아니라 추세/비교용
26173
26244
  const parts = [];
26245
+ // 1.36.112: 지침 파일을 **관리분 / 이월분**으로 갈라 잰다.
26246
+ // 종전엔 `AGENTS.md 4,248 tok` 처럼 덩어리로만 보여, 그 안의 몇 %가 마이그레이션이 실어 나른
26247
+ // 과거 내용인지 알 수 없었다. 실측(이 저장소)에서 지침 파일의 **78.0%(6,048 tok)** 가 이월분이고,
26248
+ // 그건 등급을 minimal 로 낮춰도 **그대로 남는다**(33,928 → 7,242 tok 로 줄지만 그중 83% 가 이월분).
26249
+ // 즉 예산 초과의 주원인이 첫 번째 권고로는 해결되지 않는데 출력이 그 사실을 숨기고 있었다.
26250
+ // 여기서는 재기만 한다 — 이월분 삭제는 1.36.95/1.36.105 가 안전을 증명 못 해 뺀 그대로 두고,
26251
+ // 그 판단(false-DROP 이 버그)은 유효하다. 다만 **비용을 모르면 우선순위를 못 정한다**.
26252
+ const { _splitPreserved } = require('../lib/pure-utils');
26253
+ let carriedTok = 0, carriedB = 0;
26254
+ const _carryFiles = [];
26174
26255
  for (const f of ['AGENTS.md', 'CLAUDE.md']) {
26175
26256
  const p = path.join(_bRoot, f);
26176
- parts.push({ what: f, bytes: exists(p) ? fs.statSync(p).size : 0, tokens: exists(p) ? _tok(read(p)) : 0 });
26257
+ if (!exists(p)) { parts.push({ key: f, what: f, bytes: 0, tokens: 0, carriedTokens: 0 }); continue; }
26258
+ const txt = read(p);
26259
+ const sp = _splitPreserved(txt);
26260
+ const cT = sp.preserved ? _tok(sp.preserved) : 0;
26261
+ carriedTok += cT; carriedB += sp.preserved ? Buffer.byteLength(sp.preserved) : 0;
26262
+ if (cT) _carryFiles.push({ file: f, preserved: sp.preserved });
26263
+ parts.push({ key: f, what: f, bytes: fs.statSync(p).size, tokens: _tok(txt), carriedTokens: cT });
26264
+ }
26265
+ // 이월 안내는 "전체 원본 백업: `<경로>`" 라고 **약속**한다. "옮겨도 안전하다" 는 권고는 그 약속 위에 서 있으므로
26266
+ // 권고하기 전에 백업이 실재하는지 확인한다(설치본 표본 22건 중 4건은 .harness/archive 없이 복사된 사본이었다).
26267
+ // 판정은 **이월분을 가진 파일 전부**에 대해 한다. 종전엔 첫 파일(AGENTS.md)만 보고 그 결과를 두 파일에
26268
+ // 적용해, AGENTS 만 백업된 상태에서 "원본은 이미 보관돼 있습니다" 라고 말했다(검수 재현). 하나라도 없으면 false.
26269
+ let _archive = null;
26270
+ if (_carryFiles.length) {
26271
+ let allOk = true, shown = null;
26272
+ for (const c of _carryFiles) {
26273
+ try {
26274
+ const m = /(?:전체 원본 백업|Full original backup):\s*`([^`]+)`/.exec(c.preserved);
26275
+ if (!m) { allOk = false; continue; }
26276
+ const rel = m[1].trim();
26277
+ if (!shown) shown = rel;
26278
+ const abs = path.resolve(_bRoot, rel);
26279
+ // 안내 문구는 **프로젝트 파일에서 온 입력**이다. `../` 탈출이나 절대경로로 프로젝트 밖을 가리키면
26280
+ // 남의 디렉토리 구조를 백업으로 인정하게 된다(검수 재현: `../outside` → exists:true). 루트 안으로 가둔다.
26281
+ if (abs !== _bRoot && !abs.startsWith(_bRoot + path.sep)) { allOk = false; continue; }
26282
+ // 안내는 두 형식으로 존재한다 — 스냅샷 경로(`.harness/archive/leerness-1.36.100-…`)와
26283
+ // 아카이브 루트(`.harness/archive`, archiveRel 미주입 시의 폴백). 한쪽만 상정하면 백업이
26284
+ // 멀쩡한 프로젝트에 "백업이 없습니다" 라고 말한다(작성 중 실제로 냈다 — 오경보는 이 경고를 못 믿게 만든다).
26285
+ let found = exists(path.join(abs, 'files', c.file));
26286
+ if (!found && exists(abs)) {
26287
+ // 항목 수가 병적으로 많은 디렉토리에서 비용이 터지지 않게 상한을 둔다(정상 아카이브는 마이그레이션당 1개).
26288
+ try { found = fs.readdirSync(abs).slice(0, 500).some(d => exists(path.join(abs, d, 'files', c.file))); } catch {}
26289
+ }
26290
+ if (!found) allOk = false;
26291
+ } catch { allOk = false; }
26292
+ }
26293
+ if (shown) _archive = { path: shown, exists: allOk, files: _carryFiles.length };
26177
26294
  }
26178
26295
  // 1.36.105 (codex 검수 HIGH#7): AGENTS.md 가 "읽어라" 고 지목하는 .harness 문서를 빼고 재면 예산이 거짓이 된다
26179
26296
  // (검수 재현: session-workflow.md 에 100,000자를 넣어도 ok:true). 지목된 문서를 합산에 넣는다.
26297
+ // 1.36.112 (독립 검수, 실제 설치본에서 조건 확인): 지목은 **파일 전체**에서 세야 맞다(이월 블록 안의
26298
+ // 언급도 AI 는 그대로 읽는다). 그러나 등급 절감으로 칠 수 있는 것은 **관리분 안의 지목뿐**이다 —
26299
+ // 이월 블록은 등급을 낮춰도 그대로 남으므로 거기서 나온 지목은 사라지지 않는다.
26300
+ // 구분하지 않으면 "등급을 낮추면 N tok 이 빠진다" 가 최악의 경우 전부 허수가 된다(_bench/v19-demo 가 그 형태다:
26301
+ // 옛 템플릿의 문서 목록 전체가 이월 블록 안에 들어가 있다). 두 집합을 따로 센다.
26302
+ let _refManagedTok = 0;
26180
26303
  try {
26181
26304
  const agp = path.join(_bRoot, 'AGENTS.md');
26182
- const refs = exists(agp) ? [...new Set((read(agp).match(/\.harness\/[A-Za-z0-9._-]+\.md/g) || []))] : [];
26305
+ const _agTxt = exists(agp) ? read(agp) : '';
26306
+ const _REF_RE = /\.harness\/[A-Za-z0-9._-]+\.md/g;
26307
+ const refs = [...new Set(_agTxt.match(_REF_RE) || [])];
26308
+ const _managedRefs = new Set(_splitPreserved(_agTxt).managed.match(_REF_RE) || []);
26183
26309
  let rb = 0, rt = 0, rn = 0;
26184
26310
  for (const r of refs) {
26185
26311
  const p = path.join(_bRoot, r.replace(/\//g, path.sep));
26186
26312
  if (!exists(p)) continue;
26187
- rn++; rb += fs.statSync(p).size; rt += _tok(read(p));
26313
+ const t = _tok(read(p));
26314
+ rn++; rb += fs.statSync(p).size; rt += t;
26315
+ if (_managedRefs.has(r)) _refManagedTok += t; // 등급을 낮추면 실제로 빠지는 몫만 따로 센다
26188
26316
  }
26189
- if (rn) parts.push({ what: `AGENTS.md 지목하는 문서 ${rn}종`, bytes: rb, tokens: rt });
26317
+ // `what` 사람용 라벨이라 로케일에 따라 흔들린다 기계가 그걸 파싱하지 않도록 안정 키를 함께 싣는다
26318
+ // (1.36.111 에서 배운 것: 값을 로케일화할 거면 의존을 **명시**하고, 기계 계약은 흔들리지 않는 축을 준다).
26319
+ if (rn) parts.push({ key: 'referencedDocs', what: _bt(`AGENTS.md 가 지목하는 문서 ${rn}종`, `${rn} docs referenced by AGENTS.md`), bytes: rb, tokens: rt, count: rn });
26190
26320
  } catch {}
26191
26321
  // spawnChild 는 자기 스코프의 root 를 cwd 로 쓰므로 여기서는 직접 부른다(측정 대상이 빈 문자열이 되면 예산이 무의미해진다).
26192
26322
  let ho = '';
@@ -26199,8 +26329,8 @@ async function main() {
26199
26329
  });
26200
26330
  ho = (r && r.stdout) || '';
26201
26331
  } catch {}
26202
- if (!ho) { log(_dm(' ⚠ handoff 출력을 측정하지 못했습니다 — 합계는 지침 파일만 반영합니다')); }
26203
- parts.push({ what: 'handoff 출력', bytes: Buffer.byteLength(ho), tokens: _tok(ho) });
26332
+ if (!ho) { log(_dm(_bt(' ⚠ handoff 출력을 측정하지 못했습니다 — 합계는 지침 파일만 반영합니다', ' ⚠ could not measure handoff output — the total covers instruction files only'))); }
26333
+ parts.push({ key: 'handoff', what: _bt('handoff 출력', 'handoff output'), bytes: Buffer.byteLength(ho), tokens: _tok(ho) });
26204
26334
  const total = parts.reduce((s, p) => s + p.tokens, 0);
26205
26335
  const mode = _projectMode(_bRoot);
26206
26336
  // 예산은 **실측에서** 정한다. 지목 문서(11종 4,133 tok)를 합산에 넣자 신규 standard 설치가 6,933 tok 이 됐다 —
@@ -26214,20 +26344,81 @@ async function main() {
26214
26344
  // 등급을 파생시키는 표면은 손상 상태를 함께 실어야 한다 — 안 그러면 "예산 이내" 라는 판정이
26215
26345
  // 실은 읽지 못한 등급의 기본값 위에서 나온 것이 된다. 술어를 공유하지 않으면 표면마다 진실이 갈린다.
26216
26346
  const _bChk = _readManifestChecked(_bRoot);
26217
- if (_bj) { log(JSON.stringify({ ok: !over && !_bChk.corrupt, root: _bRoot, mode, budget, total, over, corrupt: !!_bChk.corrupt, corruptReason: _bChk.reason || null, parts }, null, 2)); if (over || _bChk.corrupt) process.exitCode = 1; return; }
26347
+ // 등급을 낮추면 사라지는 것과 남는 것을 **각각** 센다. minimal 지목 문서를 아예 싣지 않지만(→0),
26348
+ // 이월분은 지침 파일 안에 있어 등급과 무관하게 남는다. 실측: 33,879 → 7,165 tok 인데 그 7,165 의 84% 가 이월분이다.
26349
+ const _refPart = parts.find(p => p.key === 'referencedDocs');
26350
+ // 등급 절감 = 지목 문서(minimal 은 아예 안 싣는다 → 0) + **관리분 템플릿 축소분**.
26351
+ // 종전엔 지목 문서만 셌고, 검수가 그게 실제 절감을 크게 밑돈다는 것을 재현했다(실제 6,600 vs 4,133).
26352
+ // 그 과소평가는 정렬을 뒤집을 수 있다 — 이월분이 두 값 **사이**에 있으면 순서가 틀린다.
26353
+ // 템플릿 축소분은 minimal 템플릿을 실제로 생성해 정확히 잰다. handoff 감소분은 여기서 못 재므로
26354
+ // 포함하지 않는다 → 이 값은 여전히 **하한**이고, 출력도 "최소" 라고 말한다.
26355
+ // ⚠ 축소분은 **템플릿끼리** 비교해야 한다. 처음엔 `관리분 − 최소템플릿` 으로 쟀는데, 관리 영역에 사용자가
26356
+ // 덧붙인 줄은 등급을 바꿔도 **삭제되지 않고 이월 블록으로 옮겨간다**(managedMerge 의 계약이 그렇다).
26357
+ // 그걸 절감으로 세면 "낮추면 N tok 빠진다" 가 다시 허수를 포함한다 — 현재 등급의 템플릿과 최소 템플릿만 견준다.
26358
+ let _tplShrink = 0;
26359
+ if (mode !== 'minimal') {
26360
+ try {
26361
+ const _l = _uiLang(_bRoot);
26362
+ const _now = coreFiles(_bRoot, _l, [], { mode });
26363
+ const _min = coreFiles(_bRoot, _l, [], { mode: 'minimal' });
26364
+ for (const f of ['AGENTS.md', 'CLAUDE.md']) {
26365
+ if (!_now[f] || !_min[f]) continue;
26366
+ const d = _tok(_now[f]) - _tok(_min[f]);
26367
+ if (d > 0) _tplShrink += d;
26368
+ }
26369
+ } catch {}
26370
+ }
26371
+ // 지목 문서 중 **관리분에서 나온 것만** 절감으로 친다(이월 블록의 지목은 등급을 낮춰도 남는다).
26372
+ const _modeSaves = (mode !== 'minimal') ? (_refManagedTok + _tplShrink) : 0;
26373
+ if (_bj) {
26374
+ log(JSON.stringify({
26375
+ ok: !over && !_bChk.corrupt, root: _bRoot, lang: _bEn ? 'en' : 'ko', mode, budget, total, over,
26376
+ corrupt: !!_bChk.corrupt, corruptReason: _bChk.reason || null,
26377
+ // 1.36.112: 이월분은 등급으로 못 줄이는 **바닥값**이다 — 기계도 그걸 알아야 우선순위를 정한다.
26378
+ carried: { tokens: carriedTok, bytes: carriedB, pctOfTotal: total ? Math.round(carriedTok / total * 100) : 0, survivesModeChange: true, archive: _archive },
26379
+ // 하한임을 이름으로 못박는다 — handoff 감소분은 여기서 재지 않는다(정확한 값인 척하지 않는다).
26380
+ modeSavesAtLeast: _modeSaves,
26381
+ parts
26382
+ }, null, 2));
26383
+ if (over || _bChk.corrupt) process.exitCode = 1; return;
26384
+ }
26218
26385
  log(_cy(`# leerness context budget — mode ${mode}`));
26219
- if (_bChk.corrupt) log(` ⚠ manifest.json 손상(${_bChk.reason}) 등급은 **저장값이 아니라 기본값**입니다: ${_bChk.path}`);
26220
- for (const p of parts) log(` ${String(p.tokens).padStart(6)} tok ${String(p.bytes).padStart(7)} B ${p.what}`);
26221
- log(` ${String(total).padStart(6)} tok 합계 · 예산 ${budget} tok`);
26386
+ // 사유까지 언어를 맞춘다영어 문장에 한국어 사유를 끼워 넣으면 그 줄은 여전히 누출이다.
26387
+ const _reasonEn = { read_failed: 'unreadable', json_parse_failed: 'invalid JSON', not_an_object: 'top level is not an object' }[_bChk.code] || 'unknown';
26388
+ if (_bChk.corrupt) log(_bt(` ⚠ manifest.json 손상(${_bChk.reason}) 등급은 **저장값이 아니라 기본값**입니다: ${_bChk.path}`,
26389
+ ` ⚠ manifest.json corrupt (${_reasonEn}) — the mode above is the **default, not the stored value**: ${_bChk.path}`));
26390
+ for (const p of parts) {
26391
+ const cp2 = p.carriedTokens ? _dm(_bt(` · 이월 ${p.carriedTokens} tok (${Math.round(p.carriedTokens / (p.tokens || 1) * 100)}%)`,
26392
+ ` · carried-over ${p.carriedTokens} tok (${Math.round(p.carriedTokens / (p.tokens || 1) * 100)}%)`)) : '';
26393
+ log(` ${String(p.tokens).padStart(6)} tok ${String(p.bytes).padStart(7)} B ${p.what}${cp2}`);
26394
+ }
26395
+ log(` ${String(total).padStart(6)} tok ` + _bt(`합계 · 예산 ${budget} tok`, `total · budget ${budget} tok`));
26222
26396
  log('');
26223
26397
  if (over) {
26224
- fail(`세션 적재가 예산을 넘습니다 (${total} > ${budget})`);
26225
- log(_dm(` → 등급을 낮추거나: leerness mode set minimal`));
26226
- log(_dm(` → 이월 이력을 줄이거나: AGENTS.md/CLAUDE.md "Preserved previous content" archive 옮기세요`));
26398
+ fail(_bt(`세션 적재가 예산을 넘습니다 (${total} > ${budget})`, `session load exceeds the budget (${total} > ${budget})`));
26399
+ // 종전엔 권고 2줄이 **고정 순서**였고 절감액이 없었다. 등급을 낮춰도 예산을 지키는 프로젝트에서
26400
+ // 첫 권고를 따르는 것은 헛수고인데 출력이 사실을 말하지 않았다 실측 절감액 순으로 낸다.
26401
+ const rem = [];
26402
+ if (_modeSaves) rem.push({ save: _modeSaves, line: _bt(
26403
+ `등급을 낮추면 최소 ${_modeSaves} tok 이 빠집니다 (지목 문서 ${_refManagedTok} + 템플릿 축소 ${_tplShrink}, handoff 감소분 제외): leerness mode set minimal`,
26404
+ `lowering the mode drops at least ${_modeSaves} tok (referenced docs ${_refManagedTok} + template shrink ${_tplShrink}; handoff reduction not counted): leerness mode set minimal`) });
26405
+ if (carriedTok) {
26406
+ const where = _archive ? (_archive.exists
26407
+ ? _bt(` — 원본은 ${_archive.path} 에 이미 보관돼 있습니다`, ` — the original is already archived at ${_archive.path}`)
26408
+ : _bt(` — ⚠ 안내가 가리키는 백업(${_archive.path})이 없습니다. 옮기기 전에 직접 복사해 두세요`, ` — ⚠ the referenced backup (${_archive.path}) is missing. Copy it yourself before moving anything`))
26409
+ : '';
26410
+ rem.push({ save: carriedTok, line: _bt(
26411
+ `이월분 ${carriedTok} tok (합계의 ${Math.round(carriedTok / total * 100)}%) 은 **등급을 낮춰도 남습니다** — AGENTS.md/CLAUDE.md 의 "Preserved previous content" 를 옮기세요${where}`,
26412
+ `carried-over content is ${carriedTok} tok (${Math.round(carriedTok / total * 100)}% of the total) and **survives a mode change** — move the "Preserved previous content" section out of AGENTS.md/CLAUDE.md${where}`) });
26413
+ }
26414
+ rem.sort((a, b) => b.save - a.save);
26415
+ for (const r of rem) log(_dm(` → ${r.line}`));
26416
+ if (!rem.length) log(_dm(_bt(` → 지침 파일과 handoff 출력을 줄이세요`, ` → trim the instruction files and handoff output`)));
26227
26417
  } else {
26228
- ok(`예산 이내 (${total}/${budget} tok)`);
26418
+ ok(_bt(`예산 이내 (${total}/${budget} tok)`, `within budget (${total}/${budget} tok)`));
26229
26419
  }
26230
- log(_dm(' ⓘ 토큰은 길이 기반 추정치입니다 — 절대값이 아니라 추세/비교용으로 쓰세요.'));
26420
+ log(_dm(_bt(' ⓘ 토큰은 길이 기반 추정치입니다 — 절대값이 아니라 추세/비교용으로 쓰세요.',
26421
+ ' ⓘ Token counts are length-based estimates — use them for trends and comparisons, not as absolute values.')));
26231
26422
  return;
26232
26423
  }
26233
26424
  if (cmd === 'init') {
package/lib/pure-utils.js CHANGED
@@ -946,9 +946,13 @@ function _mergeReadmeSection(existing, block, START, END) {
946
946
  }
947
947
  // 1.9.368 (UR-0025): 관리 파일 마이그레이션 머지 순수 코어 — 이전 내용을 migration-preserved 블록으로 보존(데이터/인덱스 파일은 overwrite).
948
948
  // archiveRel(사전 계산된 표시 경로) + overwriteSet 을 인자로 주입 → path/process/상수 비결합(순수).
949
+ // 1.36.112: 이월 블록의 경계는 **쓰는 쪽과 읽는 쪽이 같은 상수**를 봐야 한다.
950
+ // 종전엔 이 태그가 _managedMerge 안의 지역 변수라 밖에서 재구현할 수밖에 없었고,
951
+ // 그 재구현이 1.36.88→90 에서 판정 불일치를 되살린 것과 같은 형태다(술어를 공유하지 않으면 표면마다 진실이 갈린다).
952
+ const PRESERVED_TAG = '<!-- leerness:migration-preserved -->';
949
953
  function _managedMerge(file, next, previous, archiveRel, overwriteSet, opts = {}) {
950
954
  if (!previous || previous.trim() === next.trim()) return next;
951
- const tag = '<!-- leerness:migration-preserved -->';
955
+ const tag = PRESERVED_TAG;
952
956
  if (overwriteSet && overwriteSet.has(String(file).replace(/\\/g, '/'))) return next;
953
957
  // 1.36.60 (F-05 2회차, 검수 High): 언어 전환 시 구 언어 canonical 템플릿(altTemplate)의 라인도 차감 —
954
958
  // 종전엔 KO→EN 재init 에서 KO 템플릿 전체가 "커스텀"으로 오인돼 Preserved 에 통째 이월됐다.
@@ -1011,6 +1015,43 @@ function _managedMerge(file, next, previous, archiveRel, overwriteSet, opts = {}
1011
1015
  return next.trimEnd() + `\n\n---\n${tag}\n## Preserved previous content\n\n${note}\n\n` + custom.join('\n') + '\n';
1012
1016
  }
1013
1017
 
1018
+ // 1.36.112: 위가 쓴 이월 블록을 **되읽는** 짝. `context budget` 이 지침 파일을 관리분/이월분으로 가르는 데 쓴다.
1019
+ // 왜 필요한가: 이월분은 1.36.95·1.36.105 에서 두 번 "provenance 라운드로 미룬다" 며 남겨졌는데,
1020
+ // 그동안 **비용을 한 번도 재지 않았다**. 이 함수로 잰 실측(설치본 45개)에서 12개가 이월분을 갖고 합계 10,895 tok,
1021
+ // 최악(이 저장소)은 지침 파일의 78.0%(6,048 tok)이고, minimal 등급으로 낮춰도 적재 7,242 tok 중 83% 가 그것이다.
1022
+ // 여기서 하는 일은 **재는 것뿐**이다 — 지우지 않는다. 삭제를 막은 두 번의 판단(false-DROP 이 버그)은 그대로 유효하다.
1023
+ const _TAG_ESC = PRESERVED_TAG.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
1024
+ // 경계는 **생성기가 쓰는 opener 전체**로만 확정한다. 태그 하나 또는 제목 하나로 정하면 두 가지를 오인한다
1025
+ // (검수 재현): (a) 사용자가 직접 쓴 `## Preserved previous content` 섹션 51B, (b) 문서에 인용된 태그 60B.
1026
+ // 그 뒤 전부가 '이월분' 으로 계상되고, 도구는 사용자에게 **자기 산문을 옮기라고** 권하게 된다.
1027
+ // 그래서 편향을 **과소 보고** 쪽에 둔다 — 못 세는 것보다 잘못 권하는 쪽이 나쁘다.
1028
+ const _OPENER_RE = new RegExp(`^[ \\t]*${_TAG_ESC}[ \\t\\r]*$\\r?\\n^#{1,3}[ \\t]*Preserved previous content[ \\t\\r]*$`, 'm');
1029
+ const _HEAD_RE = /^#{1,3}[ \t]*Preserved previous content[ \t\r]*$/gm;
1030
+ // 태그가 없는 구형 설치본은 제목 **뒤에 생성 안내문이 따라올 때만** 인정한다(제목만으로는 사용자 섹션과 구분 불가).
1031
+ const _NOTE_RE = /전체 원본 백업|Full original backup|Previous content was backed up|이전 버전에서 이어진|Custom user\/project content carried over/;
1032
+ function _splitPreserved(text) {
1033
+ const s = String(text == null ? '' : text);
1034
+ let at = -1;
1035
+ const m1 = _OPENER_RE.exec(s);
1036
+ if (m1) at = m1.index;
1037
+ if (at < 0) {
1038
+ _HEAD_RE.lastIndex = 0;
1039
+ let h;
1040
+ while ((h = _HEAD_RE.exec(s))) {
1041
+ if (_NOTE_RE.test(s.slice(h.index, h.index + 800))) { at = h.index; break; }
1042
+ }
1043
+ }
1044
+ if (at < 0) return { managed: s, preserved: '', at: -1 };
1045
+ // 앞의 `---` 구분선도 생성물이라 이월분에 포함시킨다(관리분에 남기면 관리분이 그만큼 부풀어 보인다).
1046
+ // ⚠ 여기서 접두 **전체**를 정규식으로 훑으면 개행만 긴 입력에서 2차식이 된다 —
1047
+ // 검수 재현에서 개행 40만 개 입력이 52.8초였다(5만 0.6s → 40만 52.8s). 꼬리 64자만 본다.
1048
+ const before = s.slice(0, at);
1049
+ const tail = before.slice(-64);
1050
+ const hr = /(?:\r?\n)*---[ \t]*(?:\r?\n)+$/.exec(tail);
1051
+ const start = hr ? at - (tail.length - hr.index) : at;
1052
+ return { managed: s.slice(0, start), preserved: s.slice(start), at: start };
1053
+ }
1054
+
1014
1055
  // 1.9.369 (UR-0025): --skills 값 파싱 순수 코어 — catalog 주입(harness skillCatalog 비결합). all/recommended/csv 처리 + catalog 필터.
1015
1056
  function _parseSkillsValue(v, catalog) {
1016
1057
  if (!v || v === true) return [];
@@ -1440,7 +1481,7 @@ module.exports = { _decisionBlocksWithOffset, _blocksWithOffset, _lineOfOffset,
1440
1481
  _matchTool, _parsePackageJsonDeps, _parseRequirementsTxt, _buildGlossary, _renderGlossaryMd, GLOSSARY_START, GLOSSARY_END,
1441
1482
  _isSecretKey, redactSecrets, hasCredentialMarker, compareVer, parseHarnessVersion,
1442
1483
  _isPlaceholderSecret, _looksSecretLike,
1443
- _mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _parseSkillsValue,
1484
+ _mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _splitPreserved, PRESERVED_TAG, _parseSkillsValue,
1444
1485
  _parseArchiveBlocks, _parseSkillCatalog, _renderTeamsMd, _composeTeamPlan, _teamHandoffReminders, _cadenceAssessment, _teamDeployGate, _renderWorkspaceReferenceGuide, _memorySurface, _renderPulseLine,
1445
1486
  _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
1446
1487
  // 1.9.283 (UR-0025 2단계)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "leerness",
3
- "version": "1.36.110",
3
+ "version": "1.36.112",
4
4
  "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.",
5
5
  "keywords": [
6
6
  "leerness",
package/scripts/e2e.js CHANGED
@@ -10529,6 +10529,315 @@ total++;
10529
10529
  if (!ok) failed++;
10530
10530
  }
10531
10531
 
10532
+ // ── 1.36.111 블록 O (T-0092): 영어 모드에서 한국어가 새는 양을 **래칫**으로 고정한다.
10533
+ // leerness 는 한국어 우선 도구가 아니다(포지셔닝). 영어 사용자가 한국어 UI 를 보는 것은 결함이다.
10534
+ // 기준선 실측: 43개 명령 중 31개가 새고 누출 234줄. 이번 라운드에 `commands` 카탈로그를 이중언어화해
10535
+ // 234 → 134 로 줄였다. 나머지는 **부채**이고, 이 가드는 그 부채가 **늘지 못하게** 한다.
10536
+ // ⚠ baseline 은 목표가 아니라 측정값이다. 줄이는 방향으로만 갱신한다(갚은 뒤에는 반드시 조인다).
10537
+ {
10538
+ total++;
10539
+ let ok = false; const dbg = {};
10540
+ const sb = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-i18n111-'));
10541
+ try {
10542
+ const ENV = Object.assign({}, process.env, { TMPDIR: sb, TEMP: sb, TMP: sb, LEERNESS_LANG: 'en' });
10543
+ const d = path.join(sb, 'proj');
10544
+ fs.mkdirSync(d, { recursive: true });
10545
+ fs.writeFileSync(path.join(d, 'package.json'), '{"name":"proj","version":"0.1.0"}');
10546
+ cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', 'en'], { cwd: d, encoding: 'utf8', timeout: 300000, env: ENV });
10547
+ const R = (a) => cp.spawnSync(process.execPath, [CLI, ...a, '--path', d], { cwd: d, encoding: 'utf8', timeout: 300000, env: ENV });
10548
+ // 상태를 조금 만든다 — 빈 프로젝트는 출력이 짧아 누출을 과소평가한다. 입력은 전부 영어.
10549
+ R(['task', 'add', 'Implement the parser']);
10550
+ R(['decision', 'add', 'Use JSON storage', '--why', 'simplest']);
10551
+ R(['plan', 'add', 'Ship v1']);
10552
+ const HANGUL = /[가-힣ㄱ-ㆎ]/;
10553
+ // 측정 대상은 **도구가 말하는 표면**이다. 사용자 데이터(프로젝트명·과거 기록)는 한국어여도 정상이므로
10554
+ // 여기서는 영어 입력만 넣은 새 프로젝트를 쓴다 — 나오는 한글은 전부 도구의 것이다.
10555
+ // codex 검수 P2(재현됨): 목록이 좁으면 누출이 **목록 밖으로 옮겨가** 래칫을 빠져나간다.
10556
+ // 커버리지를 넓히고, 아래에서 목록 크기 자체도 단언한다(누가 케이스를 지워 통과시키지 못하게).
10557
+ const CMDS = [['commands'], ['status'], ['health'], ['pulse'], ['check'], ['mode'], ['toggle', 'list'],
10558
+ ['task', 'list'], ['decision', 'list'], ['plan', 'list'], ['lesson', 'list'], ['rule', 'list'],
10559
+ ['lens'], ['route', 'feature'], ['milestones'], ['round-history'], ['memory', 'status'],
10560
+ ['reuse-map'], ['preview', 'list'], ['feature', 'list'], ['requests', 'list'], ['roles', 'list'],
10561
+ ['permissions', 'list'], ['insights'], ['agents', 'list'], ['constraints', 'list'],
10562
+ ['provider', 'list'], ['skill', 'list'], ['next-action', 'list'], ['session-resume'],
10563
+ ['idempotency', 'audit'], ['context', 'budget'], ['drift', 'check'], ['verify'],
10564
+ ['encoding', 'check'], ['scan', 'secrets'], ['which'], ['glossary'], ['release', 'cadence']];
10565
+ let leaky = 0, produced = 0; const worst = [], silent = [];
10566
+ for (const a of CMDS) {
10567
+ const r = R(a);
10568
+ const out = String(r.stdout || '') + String(r.stderr || '');
10569
+ // codex 검수 P2(재현됨): 명령이 죽으면 출력이 없어 "누출 0" 이 되고, 그게 곧 통과였다 —
10570
+ // **깨진 명령이 래칫을 낮춰 주는** 형태다. 실패도 무출력도 그 자체로 실패로 본다.
10571
+ if (r.status === 0 && out.trim()) produced++; else silent.push(a.join(' ') + '(exit=' + r.status + ')');
10572
+ const n = out.split('\n').filter(l => HANGUL.test(l)).length;
10573
+ leaky += n;
10574
+ if (n) worst.push(a.join(' ') + ':' + n);
10575
+ }
10576
+ dbg.leaky = leaky; dbg.produced = produced; dbg.worst = worst.slice(0, 8); dbg.silent = silent;
10577
+ // 계측 판별력 — **모든** 프로브가 성공하고 출력을 내야 한다. 한 건이라도 조용하면 판정 불가다.
10578
+ dbg.probeAlive = silent.length === 0 && produced === CMDS.length;
10579
+ dbg.coverage = CMDS.length >= 39; // 케이스를 지워 통과시키는 우회 차단(줄이려면 근거를 적고 이 수도 함께 낮춰라)
10580
+ // 래칫: 지금 측정된 부채보다 **늘면 실패**. 줄어드는 것은 언제나 통과.
10581
+ // 1.36.111 실측. 처음엔 21개 명령만 재서 46 이었는데, 검수 지적으로 커버리지를 39개로 넓히자 **111** 이 드러났다 —
10582
+ // 좁은 목록의 기준선은 실제 부채보다 낙관적이었다. 줄인 만큼만 낮춘다(느슨하게 두면 그 안에서 조용히 썩는다).
10583
+ // 1.36.112: 106 으로 조인다. `context budget` 을 손대는 김에 영어화해 5줄을 갚았다(111 → 106, 실측).
10584
+ // 갚은 만큼만 낮춘다 — 여유를 남기면 그 안에서 조용히 썩는다(1.36.82 의 자기참조 가드에서 겪은 형태).
10585
+ const BASELINE = 106;
10586
+ dbg.baseline = BASELINE;
10587
+ dbg.withinRatchet = leaky <= BASELINE;
10588
+ // 이번 라운드가 고친 표면은 **0 이어야** 한다 — 래칫과 별개로 회귀를 직접 막는다.
10589
+ const cmdOut = String(R(['commands']).stdout || '');
10590
+ dbg.commandsClean = cmdOut.split('\n').filter(l => HANGUL.test(l)).length === 0;
10591
+ // 한국어 사용자가 보던 것은 **바뀌면 안 된다**. 영어화하면서 `개` 단위를 양쪽에서 없애는 회귀를 냈고
10592
+ // 직전 커밋과의 바이트 비교가 잡았다. 여기서는 한국어 출력이 여전히 한국어 관례를 지키는지 단언한다.
10593
+ const koEnv = Object.assign({}, ENV, { LEERNESS_LANG: 'ko' });
10594
+ const koOut = String(cp.spawnSync(process.execPath, [CLI, 'commands', '--path', d], { cwd: d, encoding: 'utf8', timeout: 300000, env: koEnv }).stdout || '');
10595
+ dbg.koIntact = /## status \(\d+개\)/.test(koOut) && /총 \d+ 명령/.test(koOut) && HANGUL.test(koOut);
10596
+ // --json 은 기계 계약이다 — 기존 키(cmd/desc)가 살아 있고 카테고리 수가 그대로여야 한다(추가 키는 하위호환).
10597
+ let cj = null;
10598
+ try { cj = JSON.parse(String(R(['commands', '--json']).stdout || '')); } catch {}
10599
+ dbg.jsonContract = !!cj && typeof cj.totalCommands === 'number' && cj.totalCommands > 50
10600
+ && Object.values(cj.categories).every(list => list.every(e => typeof e.cmd === 'string' && typeof e.desc === 'string'
10601
+ && e.descEn === undefined && e.cmdEn === undefined)) // 내부 번역 키가 payload 로 새면 70% 부풀었다(검수 P1 실측)
10602
+ && cj.lang === 'en'; // 로케일 의존을 **명시**한다 — 암묵적으로 흔들리지 않는다
10603
+ ok = dbg.probeAlive && dbg.coverage && dbg.withinRatchet && dbg.commandsClean && dbg.koIntact && dbg.jsonContract;
10604
+ } catch (e) { dbg.err = String(e && e.message).slice(0, 200); } finally { try { fs.rmSync(sb, { recursive: true, force: true }); } catch {} }
10605
+ console.log(ok ? `✓ O(1.36.111/T-0092) 영어 누출 ${dbg.leaky}줄 ≤ 래칫 ${dbg.baseline} · commands 표면 0 · 한국어 출력 불변 · --json 계약 유지 · 계측 살아있음`
10606
+ : '✗ 1.36.111 i18n 래칫 위반 ' + JSON.stringify(dbg));
10607
+ if (!ok) failed++;
10608
+ }
10609
+
10610
+ // ── 1.36.112 블록 P: 이월분(Preserved previous content) 비용을 `context budget` 이 **분해해 보인다**.
10611
+ // 왜: 1.36.95 와 1.36.105 가 각각 "기존 설치본 정리는 provenance 라운드로", "오래된 이월을 줄이는 일은
10612
+ // 별도 라운드로" 미뤘다. 두 판단(삭제는 안전을 증명 못 한다 · false-DROP 이 버그)은 지금도 유효하다.
10613
+ // 미룬 두 번이 건너뛴 것은 **비용 측정**이다 — 설치본 45개 중 12개가 이월분을 갖고 합계 10,895 tok,
10614
+ // 최악(이 저장소)은 지침 파일의 78.0%(6,048 tok)이고, minimal 로 낮춰도 적재 7,242 tok 중 83% 가 그것이다.
10615
+ // (이 수치는 **출하되는 `_splitPreserved` 로** 다시 잰 값이다 — 분해기를 엄격하게 고친 뒤 재측정했다.)
10616
+ // 이 가드는 "재서 보인다" 만 지킨다. 지우는 동작은 여전히 없고, 그게 없다는 것도 아래에서 단언한다.
10617
+ {
10618
+ total++;
10619
+ let ok = false; const dbg = {};
10620
+ const sb = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-carry112-'));
10621
+ const ENV = Object.assign({}, process.env, { TMPDIR: sb, TEMP: sb, TMP: sb });
10622
+ try {
10623
+ const mk = (name, lang) => {
10624
+ const d = path.join(sb, name); fs.mkdirSync(d, { recursive: true });
10625
+ fs.writeFileSync(path.join(d, 'package.json'), '{"name":"proj","version":"0.1.0"}');
10626
+ cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', lang || 'ko'], { cwd: d, encoding: 'utf8', timeout: 300000, env: ENV });
10627
+ return d;
10628
+ };
10629
+ const R = (d, a, env) => cp.spawnSync(process.execPath, [CLI, ...a, '--path', d], { cwd: d, encoding: 'utf8', timeout: 300000, env: env || ENV });
10630
+ const J = (d, a, env) => { try { return JSON.parse(String((R(d, a.concat(['--json']), env)).stdout || '').trim()); } catch { return null; } };
10631
+
10632
+ // 대조군 ①: 이월분이 **없는** 프로젝트는 0 이어야 한다. 없는 부채를 보고하면 이 지표 자체를 못 믿는다.
10633
+ const clean = mk('clean');
10634
+ const cleanB = J(clean, ['context', 'budget']);
10635
+ dbg.cleanZero = !!cleanB && cleanB.carried && cleanB.carried.tokens === 0
10636
+ && cleanB.parts.every(p => !p.carriedTokens)
10637
+ && !/이월|carried-over/.test(String(R(clean, ['context', 'budget']).stdout || ''));
10638
+
10639
+ // 측정 대상 블록은 **실제 writer 로** 만든다. 손으로 흉내 내면 형식이 갈릴 때 가드가 조용히 죽는다.
10640
+ const PU = require(path.resolve(path.dirname(CLI), '..', 'lib', 'pure-utils'));
10641
+ const carried = mk('carried');
10642
+ const agp = path.join(carried, 'AGENTS.md');
10643
+ const base = fs.readFileSync(agp, 'utf8');
10644
+ const legacy = Array.from({ length: 150 }, (_, i) => `- LEGACY-CARRY-${i} 과거 릴리스 이력 항목 (1.9.${100 + i})`).join('\n');
10645
+ const merged = PU._managedMerge('AGENTS.md', base, base + '\n' + legacy + '\n', '.harness/archive', new Set(), {});
10646
+ dbg.writerMadeBlock = merged.includes(PU.PRESERVED_TAG) && merged.includes('LEGACY-CARRY-149');
10647
+ fs.writeFileSync(agp, merged);
10648
+
10649
+ // ② 분해기는 writer 가 쓴 것을 **한 바이트도 잃지 않고** 가른다 (관리분 + 이월분 === 원문)
10650
+ const sp = PU._splitPreserved(merged);
10651
+ dbg.roundTrip = (sp.managed + sp.preserved) === merged && sp.preserved.includes('LEGACY-CARRY-0')
10652
+ && !sp.managed.includes('LEGACY-CARRY-0') && sp.preserved.startsWith('\n');
10653
+ // 이월 블록이 없는 입력은 통째로 관리분이다(경계 없는 곳에 경계를 만들지 않는다)
10654
+ const spNone = PU._splitPreserved(base);
10655
+ dbg.splitNoop = spNone.preserved === '' && spNone.managed === base && spNone.at === -1;
10656
+
10657
+ // ③ 실제로 센다 — 파일 라인과 carried 합계 양쪽에서
10658
+ const cb = J(carried, ['context', 'budget']);
10659
+ const agPart = cb && cb.parts.find(p => p.key === 'AGENTS.md');
10660
+ dbg.counts = !!cb && cb.carried.tokens > 500 && !!agPart && agPart.carriedTokens > 500
10661
+ && cb.carried.tokens === agPart.carriedTokens && cb.carried.pctOfTotal > 0;
10662
+
10663
+ // ④ **이 라운드의 핵심 주장**: 이월분은 등급을 낮춰도 남는다. 주장을 출력만 하지 말고 측정으로 확인한다.
10664
+ R(carried, ['mode', 'set', 'minimal']);
10665
+ const mb = J(carried, ['context', 'budget']);
10666
+ dbg.survivesMode = !!mb && mb.mode === 'minimal' && mb.total < cb.total
10667
+ && mb.carried.tokens === cb.carried.tokens && mb.carried.tokens > 0
10668
+ && mb.carried.pctOfTotal > cb.carried.pctOfTotal; // 총량이 줄어 이월분의 **비중은 오히려 커진다**
10669
+ R(carried, ['mode', 'set', 'standard']);
10670
+
10671
+ // ⑤ 백업 존재 판정은 **양방향**으로 움직여야 한다. 한 방향만 보면 상수를 반환해도 통과한다.
10672
+ // (작성 중 실제로 오경보를 냈다 — 안내가 아카이브 '루트' 를 가리키는 형식을 상정하지 않아서였다.)
10673
+ const arch = path.join(carried, '.harness', 'archive', 'leerness-1.0.0-x', 'files');
10674
+ fs.mkdirSync(arch, { recursive: true }); fs.writeFileSync(path.join(arch, 'AGENTS.md'), base);
10675
+ const withArch = J(carried, ['context', 'budget']);
10676
+ fs.rmSync(path.join(carried, '.harness', 'archive'), { recursive: true, force: true });
10677
+ const noArch = J(carried, ['context', 'budget']);
10678
+ dbg.archiveBothWays = !!withArch && !!noArch
10679
+ && withArch.carried.archive && withArch.carried.archive.exists === true
10680
+ && noArch.carried.archive && noArch.carried.archive.exists === false;
10681
+
10682
+ // ⑥ 권고는 **실측 절감액 순**이다. 순서는 권고가 **둘 다 있을 때만** 판별되므로 양방향 픽스처를 쓴다.
10683
+ // 1차 작성 때 minimal 케이스만 뒀다가 "고정 순서로 되돌림" 변이가 살아남았다 — 권고가 하나뿐이면
10684
+ // 어떤 정렬을 써도 결과가 같다(정렬을 주장해 놓고 정렬을 시험하지 않은 공허한 커버리지).
10685
+ // ⑥-a 등급 절감 > 이월분 → 등급 권고가 먼저 (뒤집기 변이를 잡는다)
10686
+ // ⑥-b 이월분 > 등급 절감 → 이월분 권고가 먼저 (정렬 제거 변이를 잡는다 — 삽입 순서가 곧 옛 고정 순서다)
10687
+ const remLines = (d) => String(R(d, ['context', 'budget']).stdout || '').split('\n').filter(l => /^\s*→ /.test(l));
10688
+ fs.appendFileSync(path.join(carried, 'CLAUDE.md'), '\n' + 'x'.repeat(20000) + '\n'); // 관리분만 키운다(이월분 불변)
10689
+ const aStd = J(carried, ['context', 'budget']);
10690
+ const aRef = aStd && aStd.parts.find(p => p.key === 'referencedDocs');
10691
+ const aLines = remLines(carried);
10692
+ dbg.remedyOrderModeFirst = !!aStd && aStd.over === true && !!aRef
10693
+ && aRef.tokens > aStd.carried.tokens // 판별 조건이 실제로 성립했는지 **먼저** 단언
10694
+ && aLines.length === 2 && /mode set minimal/.test(aLines[0]) && /이월분/.test(aLines[1]);
10695
+
10696
+ const big = mk('big');
10697
+ const bagp = path.join(big, 'AGENTS.md');
10698
+ const bbase = fs.readFileSync(bagp, 'utf8');
10699
+ const huge = Array.from({ length: 1200 }, (_, i) => `- LEGACY-BIG-${i} 과거 릴리스 이력 항목 (1.9.${i})`).join('\n');
10700
+ fs.writeFileSync(bagp, PU._managedMerge('AGENTS.md', bbase, bbase + '\n' + huge + '\n', '.harness/archive', new Set(), {}));
10701
+ const bStd = J(big, ['context', 'budget']);
10702
+ const bRef = bStd && bStd.parts.find(p => p.key === 'referencedDocs');
10703
+ const bLines = remLines(big);
10704
+ dbg.remedyOrderCarriedFirst = !!bStd && bStd.over === true && !!bRef
10705
+ && bStd.carried.tokens > bRef.tokens
10706
+ && bLines.length === 2 && /이월분/.test(bLines[0]) && /mode set minimal/.test(bLines[1]);
10707
+
10708
+ // minimal 에서는 등급 권고의 절감이 0 이므로 이월분 권고만 남아야 한다
10709
+ // (종전엔 순서가 고정이라, 등급을 낮춰도 예산을 못 지키는 프로젝트에 헛수고를 먼저 권했다).
10710
+ R(carried, ['mode', 'set', 'minimal']);
10711
+ const minOut = String(R(carried, ['context', 'budget']).stdout || '');
10712
+ const lines = minOut.split('\n').filter(l => /^\s*→ /.test(l));
10713
+ dbg.remedyOrder = lines.length === 1 && /이월분/.test(lines[0]) && !lines.some(l => /mode set minimal/.test(l));
10714
+ dbg.remedyQuantified = /이월분 \d+ tok \(합계의 \d+%\) 은 \*\*등급을 낮춰도 남습니다\*\*/.test(minOut);
10715
+
10716
+ // ⑦ 이 라운드는 **지우지 않는다**. 이월 블록이 그대로 남아 있어야 한다(측정이 삭제로 번지지 않았음을 단언).
10717
+ dbg.noDeletion = fs.readFileSync(path.join(carried, 'AGENTS.md'), 'utf8').includes('LEGACY-CARRY-149');
10718
+
10719
+ // ⑧ 영어 모드에서 이 표면은 한글을 내지 않는다(T-0100 상환분 — 래칫 여유에 숨지 못하게 직접 단언).
10720
+ // ⚠ 종전엔 **예산 이내** 신규 프로젝트만 봐서 `if (over)` 안의 영어 문구 6종이 한 번도 렌더되지 않았다
10721
+ // (독립 검수 지적). 한국어가 되살아나기 가장 쉬운 절반을 가드가 못 보고 있었다 — 초과·이월 분기를 실제로 밟힌다.
10722
+ const en = mk('en_carry', 'en');
10723
+ const enEnv = Object.assign({}, ENV, { LEERNESS_LANG: 'en' });
10724
+ {
10725
+ const p = path.join(en, 'AGENTS.md'); const t = fs.readFileSync(p, 'utf8');
10726
+ const extra = Array.from({ length: 200 }, (_, i) => `- CARRY-EN-${i} legacy release note`).join('\n');
10727
+ fs.writeFileSync(p, PU._managedMerge('AGENTS.md', t, t + '\n' + extra + '\n', '.harness/archive', new Set(), { lang: 'en' }));
10728
+ fs.appendFileSync(path.join(en, 'CLAUDE.md'), '\n' + 'x'.repeat(40000) + '\n');
10729
+ }
10730
+ const enOut = String(R(en, ['context', 'budget'], enEnv).stdout || '');
10731
+ const enJ = J(en, ['context', 'budget'], enEnv);
10732
+ // 손상 경고까지 영어여야 한다 — 사유 문자열이 한국어면 그 줄은 여전히 누출이다(별도 프로젝트로 분리 측정).
10733
+ const enCorrupt = mk('en_corrupt', 'en');
10734
+ fs.writeFileSync(path.join(enCorrupt, '.harness', 'manifest.json'), '{ not json');
10735
+ const enCorruptOut = String(R(enCorrupt, ['context', 'budget'], enEnv).stdout || '');
10736
+ dbg.enClean = enOut.split('\n').filter(l => /[가-힣ㄱ-ㆎ]/.test(l)).length === 0
10737
+ && enCorruptOut.split('\n').filter(l => /[가-힣ㄱ-ㆎ]/.test(l)).length === 0
10738
+ && /manifest\.json corrupt \(invalid JSON\)/.test(enCorruptOut) // 손상 분기를 실제로 밟았는지 단언
10739
+ && !!enJ && enJ.lang === 'en'
10740
+ && enJ.over === true && enJ.carried.tokens > 0 // 초과·이월 분기를 실제로 밟았는지 단언
10741
+ && /carried-over/.test(enOut) && /survives a mode change/.test(enOut)
10742
+ && /at least/.test(enOut) && /session load exceeds the budget/.test(enOut)
10743
+ && enJ.parts.every(p => typeof p.key === 'string'); // 기계는 로케일 흔들리는 라벨 대신 안정 키를 본다
10744
+
10745
+ // ⑨ 두 파일이 **모두** 이월분을 가진 형태 — 이 라운드의 근거 수치(77.6%)가 나온 저장소가 바로 이 형태다.
10746
+ // 종전 픽스처는 AGENTS.md 에만 넣어 **합산이 한 번도 시험되지 않았고**, 독립 검수가
10747
+ // `carriedTok = Math.max(carriedTok, cT)` 변이의 생존을 지적했다(합계가 최댓값과 구별되지 않았다).
10748
+ const both = mk('both');
10749
+ for (const f of ['AGENTS.md', 'CLAUDE.md']) {
10750
+ const p = path.join(both, f); const t = fs.readFileSync(p, 'utf8');
10751
+ const extra = Array.from({ length: f === 'AGENTS.md' ? 140 : 55 }, (_, i) => `- CARRY-${f}-${i} 과거 항목`).join('\n');
10752
+ fs.writeFileSync(p, PU._managedMerge(f, t, t + '\n' + extra + '\n', '.harness/archive', new Set(), {}));
10753
+ }
10754
+ const twoJ = J(both, ['context', 'budget']);
10755
+ const pA = twoJ && twoJ.parts.find(p => p.key === 'AGENTS.md');
10756
+ const pC = twoJ && twoJ.parts.find(p => p.key === 'CLAUDE.md');
10757
+ dbg.twoFileSum = !!twoJ && !!pA && !!pC && pA.carriedTokens > 0 && pC.carriedTokens > 0
10758
+ && pA.carriedTokens !== pC.carriedTokens // 합계와 최댓값이 갈리는 입력인지 **먼저** 확인
10759
+ && twoJ.carried.tokens === pA.carriedTokens + pC.carriedTokens
10760
+ && twoJ.carried.bytes > twoJ.carried.tokens; // bytes 가 tokens 의 복사본이 아님(계약 필드 커버리지)
10761
+
10762
+ // ⑩ 백업 판정은 이월분을 가진 **모든** 파일을 본다. AGENTS 만 백업된 상태에서 "보관돼 있습니다" 는 거짓이다.
10763
+ const snap2 = path.join(both, '.harness', 'archive', 'leerness-1.0.0-x', 'files');
10764
+ fs.mkdirSync(snap2, { recursive: true }); fs.writeFileSync(path.join(snap2, 'AGENTS.md'), 'x');
10765
+ const partial = J(both, ['context', 'budget']);
10766
+ fs.writeFileSync(path.join(snap2, 'CLAUDE.md'), 'x');
10767
+ const full = J(both, ['context', 'budget']);
10768
+ dbg.archivePerFile = !!partial && !!full && !!partial.carried.archive && !!full.carried.archive
10769
+ && partial.carried.archive.exists === false && full.carried.archive.exists === true
10770
+ && full.carried.archive.files === 2;
10771
+
10772
+ // ⑪ 프로젝트 **밖**을 가리키는 안내는 백업으로 인정하지 않는다(안내 문구는 프로젝트 파일에서 온 입력이다)
10773
+ const esc = mk('esc');
10774
+ {
10775
+ const outside = path.join(sb, 'outside', 'files'); fs.mkdirSync(outside, { recursive: true });
10776
+ fs.writeFileSync(path.join(outside, 'AGENTS.md'), 'x');
10777
+ const p = path.join(esc, 'AGENTS.md'); const t = fs.readFileSync(p, 'utf8');
10778
+ fs.writeFileSync(p, PU._managedMerge('AGENTS.md', t, t + '\n- CARRY-ESC\n', '.harness/archive', new Set(), {})
10779
+ .replace('`.harness/archive`', '`../outside`'));
10780
+ }
10781
+ const escJ = J(esc, ['context', 'budget']);
10782
+ dbg.noEscape = !!escJ && !!escJ.carried.archive && escJ.carried.archive.exists === false;
10783
+
10784
+ // ⑫ 이월 블록 **안의** `.harness/*.md` 지목은 등급 절감으로 치지 않는다 — 등급을 낮춰도 그 언급은 남기 때문이다.
10785
+ // 독립 검수가 이 머신의 실제 설치본(_bench/v19-demo)에서 옛 문서 목록이 통째로 이월된 형태를 확인했다.
10786
+ // 구분하지 않으면 "등급을 낮추면 N tok 이 빠진다" 가 최악의 경우 **전부 허수**가 된다.
10787
+ const refc = mk('refcarry');
10788
+ {
10789
+ const p = path.join(refc, 'AGENTS.md');
10790
+ const stripped = fs.readFileSync(p, 'utf8').replace(/\.harness\//g, 'dot-harness/'); // 관리분에서 지목 제거
10791
+ fs.writeFileSync(p, PU._managedMerge('AGENTS.md', stripped,
10792
+ stripped + '\n- 읽어라: .harness/plan.md\n- 읽어라: .harness/decisions.md\n', '.harness/archive', new Set(), {}));
10793
+ fs.appendFileSync(path.join(refc, 'CLAUDE.md'), '\n' + 'x'.repeat(60000) + '\n'); // 예산 초과 유도
10794
+ }
10795
+ const refJ = J(refc, ['context', 'budget']);
10796
+ const refPart = refJ && refJ.parts.find(p => p.key === 'referencedDocs');
10797
+ const refLines = remLines(refc);
10798
+ // 판별 대조군: **같은 지목**을 관리분에 둔 쌍둥이 프로젝트. 두 값의 차이가 정확히 지목 토큰이어야 한다.
10799
+ // ⚠ 표시 문자열만 단언하면 공허하다 — 변이가 **정렬에 쓰는 값**만 바꾸면 화면은 그대로다(변이 M18 이 그렇게 생존했다).
10800
+ // ⚠ "절감 < 지목" 같은 크기 가정도 못 쓴다 — 신규 프로젝트에서는 그 관계가 성립하지 않는다(작성 중 실측).
10801
+ const refm = mk('refmanaged');
10802
+ {
10803
+ const p = path.join(refm, 'AGENTS.md');
10804
+ const stripped = fs.readFileSync(p, 'utf8').replace(/\.harness\//g, 'dot-harness/');
10805
+ const withRefs = stripped + '\n- 읽어라: .harness/plan.md\n- 읽어라: .harness/decisions.md\n';
10806
+ fs.writeFileSync(p, PU._managedMerge('AGENTS.md', withRefs, withRefs + '\n- CARRY-FILLER\n', '.harness/archive', new Set(), {}));
10807
+ fs.appendFileSync(path.join(refm, 'CLAUDE.md'), '\n' + 'x'.repeat(60000) + '\n');
10808
+ }
10809
+ const refmJ = J(refm, ['context', 'budget']);
10810
+ const refmPart = refmJ && refmJ.parts.find(p => p.key === 'referencedDocs');
10811
+ dbg.carriedRefsNotCounted = !!refJ && refJ.over === true
10812
+ && !!refPart && refPart.tokens > 0 // 총량에는 들어간다 — AI 는 이월 블록도 읽는다
10813
+ && typeof refJ.modeSavesAtLeast === 'number' && !!refmJ && typeof refmJ.modeSavesAtLeast === 'number'
10814
+ && !!refmPart && refmPart.tokens === refPart.tokens // 두 프로젝트가 같은 문서를 가리키는지 먼저 확인
10815
+ && refmJ.modeSavesAtLeast - refJ.modeSavesAtLeast === refPart.tokens
10816
+ && refLines.some(l => /지목 문서 0 /.test(l)); // 표시도 0 이어야 한다
10817
+
10818
+ // ⑬ 관리 영역에 **사용자가 덧붙인** 내용은 등급을 낮춰도 삭제되지 않고 이월 블록으로 옮겨간다(managedMerge 의 계약).
10819
+ // 따라서 절감으로 세면 안 된다. 처음엔 `관리분 − 최소템플릿` 으로 재서 이 몫이 절감에 섞여 있었다.
10820
+ const pad = mk('padded');
10821
+ const padBefore = J(pad, ['context', 'budget']);
10822
+ fs.appendFileSync(path.join(pad, 'AGENTS.md'), '\n' + '사용자가 덧붙인 지침 줄입니다.\n'.repeat(2000));
10823
+ const padAfter = J(pad, ['context', 'budget']);
10824
+ const padA = padBefore && padBefore.parts.find(p => p.key === 'AGENTS.md');
10825
+ const padB = padAfter && padAfter.parts.find(p => p.key === 'AGENTS.md');
10826
+ dbg.userContentNotSaving = !!padA && !!padB
10827
+ && padB.tokens - padA.tokens > 5000 // 덧붙임이 실제로 컸는지 먼저 확인
10828
+ && padAfter.modeSavesAtLeast === padBefore.modeSavesAtLeast; // 그런데 절감은 그대로여야 한다
10829
+
10830
+ ok = dbg.cleanZero && dbg.writerMadeBlock && dbg.roundTrip && dbg.splitNoop && dbg.counts
10831
+ && dbg.survivesMode && dbg.archiveBothWays && dbg.remedyOrder && dbg.remedyQuantified
10832
+ && dbg.remedyOrderModeFirst && dbg.remedyOrderCarriedFirst
10833
+ && dbg.twoFileSum && dbg.archivePerFile && dbg.noEscape && dbg.carriedRefsNotCounted
10834
+ && dbg.userContentNotSaving && dbg.noDeletion && dbg.enClean;
10835
+ } catch (e) { dbg.err = String(e && e.message).slice(0, 200); } finally { try { fs.rmSync(sb, { recursive: true, force: true }); } catch {} }
10836
+ console.log(ok ? '✓ P(1.36.112) 이월분 계량: 무이월 0 · 분해 무손실(왕복) · 경계없음 무동작 · 두 파일 합산(≠최댓값) · bytes 계약 · **등급을 낮춰도 잔존**(비중은 증가) · 백업판정 양방향+파일별+경로가둠 · 이월 안의 지목은 절감 아님 · 권고 절감액순(양방향 판별) + 수치동반 · 삭제 없음 · 영어표면 한글 0'
10837
+ : '✗ 1.36.112 이월분 계량 실패 ' + JSON.stringify(dbg));
10838
+ if (!ok) failed++;
10839
+ }
10840
+
10532
10841
  console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
10533
10842
  if (failed > 0) process.exit(1);
10534
10843