leerness 1.9.283 → 1.9.284

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.
Files changed (5) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +5 -5
  3. package/bin/harness.js +4 -2
  4. package/package.json +1 -1
  5. package/scripts/e2e.js +9 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,25 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.9.284 — 2026-06-03 — UR-0029: handoff 성능 회귀 수정 (10 provider 전부 spawn → 활성만) + e2e 단축
4
+
5
+ **⚡ GPT-5.5 "e2e 5분 초과" 추적 중 발견 — `handoff` 가 매번 10개 provider 의 `--version` 을 전부 spawn(≈5.5s 오버헤드). 활성(env=1) provider 만 체크하도록 수정 → handoff 7.3s → 2.6s.**
6
+
7
+ ### 배경 (프로파일 기반 디버그)
8
+ GPT-5.5 가 두 번 "npm test(e2e) 5분 내 미완료" 지적. 실측 336s. `node --prof` 프로파일 결과 **handoff 시간의 90%가 `spawnSync`** — handoff 헤드라인이 `EXTERNAL_AGENTS.map(_checkAgent)` 로 **10개 provider 의 `--version` 을 매번 전부 실행**(1.9.277 provider 6→10 으로 악화). 'ready'(=활성+설치) 는 **활성(env flag=1) 일 때만** 가능하므로 비활성 provider spawn 은 순수 낭비.
9
+
10
+ ### 구현
11
+ 1. **handoff 헤드라인 agent 체크 — 활성 필터 선행** (bin/harness.js:7723): `EXTERNAL_AGENTS.filter(a => process.env[a.envFlag]==='1').map(_checkAgent)`. 결과 동일(비활성은 ready 불가), spawn 만 제거. **활성 0(대부분/모든 e2e) → spawn 0**.
12
+ - 효과: handoff **7.3s → 2.6s** (회당 4.6s↓). 실사용에서도 매 handoff 5초 절감 + provider 확장 회귀 영구 해결.
13
+ 2. **e2e roadmap 기본 OFF** (roadmap 전용 블록만 ON) + **총 소요시간 출력**(투명성).
14
+ 3. e2e 총 **336s → 306s**. (구조적으로 133 init × ~1.1s 가 잔여 비용 — init 은 I/O 바운드.)
15
+
16
+ ### 재현성 (GPT 우려 해소)
17
+ - 빠른 게이트: **`npm run test:fast`** (selftest + smoke 13종, ~10s) — 로컬/PR 즉시 검증.
18
+ - 전체 e2e: 229 케이스(subprocess 바운드 ~5min) — CI 매트릭스(ubuntu+windows × node 18/20/22) 병렬 실행으로 재현.
19
+
20
+ ### 검증
21
+ - **selftest 31/31 PASS** · **E2E 229/229 PASS** (회귀 0) · handoff 활성 0 시 spawn 0 실측.
22
+
3
23
  ## 1.9.283 — 2026-06-03 — UR-0025 2단계: 순수 함수 추가 모듈 분리 (lib/pure-utils 7→14종)
4
24
 
5
25
  **🧩 GPT-5.5 "1.2MB 단일 파일" 지적의 점진적·비파괴 모듈화 계속 — 최근 추가한 순수 로직을 lib/ 로 추출.**
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
4
4
  > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
5
5
 
6
- [![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.283-green)]() [![tests](https://img.shields.io/badge/e2e-229%2F229-success)]() [![selftest](https://img.shields.io/badge/selftest-24%2F24-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-80-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
6
+ [![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.284-green)]() [![tests](https://img.shields.io/badge/e2e-229%2F229-success)]() [![selftest](https://img.shields.io/badge/selftest-24%2F24-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-80-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
7
7
 
8
8
  ```
9
9
  ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
471
471
  <!-- leerness:project-readme:start -->
472
472
  ## Leerness Project Harness
473
473
 
474
- 이 프로젝트는 Leerness v1.9.283 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
474
+ 이 프로젝트는 Leerness v1.9.284 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
475
475
 
476
476
  ### Core Commands
477
477
 
@@ -513,7 +513,7 @@ leerness memory restore decision <date|title>
513
513
 
514
514
  ### MCP server (외부 AI 통합)
515
515
 
516
- Leerness v1.9.283는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
516
+ Leerness v1.9.284는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **42개 도구**를 노출:
517
517
 
518
518
  ```jsonc
519
519
  // 카테고리별
@@ -534,7 +534,7 @@ Leerness v1.9.283는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
534
534
  `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
535
535
  1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
536
536
 
537
- 현재 누적: **70 라운드 (1.9.40 → 1.9.283)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
537
+ 현재 누적: **70 라운드 (1.9.40 → 1.9.284)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
538
538
 
539
539
  ### 성능 가이드 (1.9.140 측정)
540
540
 
@@ -572,6 +572,6 @@ leerness release pack --close --auto-main-push
572
572
  - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
573
573
  - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
574
574
 
575
- Last synced by Leerness v1.9.283: 2026-06-03
575
+ Last synced by Leerness v1.9.284: 2026-06-03
576
576
  <!-- leerness:project-readme:end -->
577
577
 
package/bin/harness.js CHANGED
@@ -10,7 +10,7 @@ const readline = require('readline');
10
10
  const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
11
11
  PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord } = require('../lib/pure-utils');
12
12
 
13
- const VERSION = '1.9.283';
13
+ const VERSION = '1.9.284';
14
14
 
15
15
  // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
16
16
  // leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -7720,7 +7720,9 @@ function handoff(root) {
7720
7720
  // 8) 1.9.152: 활성 외부 AI CLI 카운트 (1.9.151 복수 선택 결과 반영) — 메인 에이전트가 sub-agent 분배 가능성 즉시 인지
7721
7721
  try {
7722
7722
  _loadEnvFile(root); // .env 자동 로드 (handoff 컨텍스트)
7723
- const ready = EXTERNAL_AGENTS.map(a => _checkAgent(a)).filter(c => c.status === 'ready');
7723
+ // 1.9.284 (UR-0029) 성능: 'ready'(=활성+설치)는 활성(env=1)일 때만 가능 → 활성 agent 만 --version spawn.
7724
+ // 비활성(대부분/모든 e2e) 은 spawn 0 (이전: 10개 전부 spawn = handoff 5.5s 병목, provider 6→10 으로 악화).
7725
+ const ready = EXTERNAL_AGENTS.filter(a => process.env[a.envFlag] === '1').map(a => _checkAgent(a)).filter(c => c.status === 'ready');
7724
7726
  if (ready.length > 0) {
7725
7727
  parts.push(`🤖 agents ${ready.length} (${ready.map(c => c.id).join(',')})`);
7726
7728
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "leerness",
3
- "version": "1.9.283",
3
+ "version": "1.9.284",
4
4
  "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
5
5
  "keywords": [
6
6
  "leerness",
package/scripts/e2e.js CHANGED
@@ -8,9 +8,13 @@ const cp = require('child_process');
8
8
 
9
9
  // 1.9.12: e2e 안정성을 위해 자식 프로세스의 npm 호출 차단 (hang 방지)
10
10
  process.env.LEERNESS_OFFLINE = process.env.LEERNESS_OFFLINE || '1';
11
+ // 1.9.284 (UR-0029): e2e 속도 — 기본 roadmap.html(70KB HTML) 자동 생성 OFF (roadmap 전용 테스트 블록만 일시 ON).
12
+ // 대부분의 init/session 테스트는 roadmap 을 검증하지 않으므로 생성 비용 제거 → 5분 내 완료.
13
+ process.env.LEERNESS_NO_AUTO_ROADMAP = '1';
11
14
  const CLI = path.resolve(__dirname, '..', 'bin', 'harness.js');
12
15
  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-e2e-'));
13
16
  let failed = 0; let total = 0;
17
+ const _e2eStart = Date.now(); // 1.9.284 (UR-0029): 총 소요시간 투명성
14
18
 
15
19
  function run(label, args, opts = {}) {
16
20
  total++;
@@ -2217,6 +2221,8 @@ total++;
2217
2221
  if (!ok) failed++;
2218
2222
  }
2219
2223
 
2224
+ // 1.9.284: roadmap 전용 테스트 블록 — roadmap 생성 일시 ON (이후 다시 OFF)
2225
+ process.env.LEERNESS_NO_AUTO_ROADMAP = '0';
2220
2226
  // 1.9.12: auto roadmap — install 직후 자동 생성
2221
2227
  total++;
2222
2228
  {
@@ -2278,6 +2284,8 @@ total++;
2278
2284
  console.log(ok ? '✓ B(1.9.12) --on-every-change: task add만으로 즉시 갱신' : `✗ on-every-change 미작동`);
2279
2285
  if (!ok) failed++;
2280
2286
  }
2287
+ // 1.9.284: roadmap 전용 블록 종료 — 다시 OFF (나머지 테스트 속도)
2288
+ process.env.LEERNESS_NO_AUTO_ROADMAP = '1';
2281
2289
 
2282
2290
  // 1.9.12: status 출력
2283
2291
  total++;
@@ -2962,5 +2970,5 @@ total++;
2962
2970
  if (!ok) failed++;
2963
2971
  }
2964
2972
 
2965
- console.log(`\nE2E result: ${total - failed}/${total} passed`);
2973
+ console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
2966
2974
  if (failed > 0) process.exit(1);