leerness 1.9.372 → 1.9.374
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/CHANGELOG.md +33 -0
- package/README.md +5 -5
- package/bin/harness.js +33 -4
- package/lib/pure-utils.js +19 -1
- package/package.json +1 -1
- package/scripts/e2e.js +37 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,38 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.9.374 — 2026-06-06 — UR-0074: release cadence 진단 (외부리뷰 케이던스 가시화)
|
|
4
|
+
|
|
5
|
+
**🧩 외부 리뷰가 반복 지적한 "릴리스 케이던스 과다"를 측정·가시화 — `leerness release cadence`.**
|
|
6
|
+
|
|
7
|
+
### 배경
|
|
8
|
+
3개 모델 + GPT-5.5 외부 리뷰 모두 300+ 버전의 높은 릴리스 빈도를 신뢰 저하 요인으로 지적(UR-0074). 케이던스를 **측정 가능하게** 만들어 자기 인지 + batched-minor 전환 근거를 제공.
|
|
9
|
+
|
|
10
|
+
### 구현
|
|
11
|
+
1. **`_cadenceAssessment(perDay, total, daysActive)`**(순수): releases/day → 수준(very-high ≥5 / high ≥2 / moderate ≥0.5 / healthy) + 권장(batched minor·stable 채널 등).
|
|
12
|
+
2. **`leerness release cadence [path] [--json]`**: git tag(`_computeRoundHistory` 재사용)로 누적/활동일/빈도 산출 → 평가 출력. 읽기 전용.
|
|
13
|
+
3. commands(release) + help 등재.
|
|
14
|
+
|
|
15
|
+
### 검증 (회귀 0)
|
|
16
|
+
- **selftest 119→120 PASS** (행위: 임계값 4구간 + 권장 비어있지 않음).
|
|
17
|
+
- **E2E 319→320 PASS** (행위: `release cadence --json` level∈집합 + releasesPerDay number + recommendation string).
|
|
18
|
+
- 실측: 본 저장소 330 릴리스 / 28일 = **11.79/day → very-high**(외부리뷰 우려를 그대로 정량 확인) → batched minor 권장.
|
|
19
|
+
|
|
20
|
+
## 1.9.373 — 2026-06-06 — UR-0073 Phase C: handoff 팀 스케줄 알림 (opt-out · 실행 트리거 아님)
|
|
21
|
+
|
|
22
|
+
**🧩 정의된 비-manual 팀을 세션 시작(handoff)에서 미리보기 안내 — 스케줄 인지.** (UR-0073 Phase C)
|
|
23
|
+
|
|
24
|
+
### 구현
|
|
25
|
+
1. **`_teamHandoffReminders(teams)`**(순수): `schedule !== 'manual'` 이고 `status==='active'` 인 팀만 → `🤝 <id> (<schedule>) · N명 — 미리보기: leerness team preview <id>` 라인.
|
|
26
|
+
2. **handoff 통합**: 정의된 팀이 있으면 `## 🤝 에이전트 팀 스케줄` 섹션 노출. **opt-out**(`--no-team-reminders` / `LEERNESS_NO_TEAM_REMINDERS=1` / `--compact`/`--quiet`).
|
|
27
|
+
3. **안전**: 알림은 **미리보기 안내만** — 실행/dispatch/배포 트리거 아님. manual·paused 팀 제외.
|
|
28
|
+
|
|
29
|
+
### 검증 (회귀 0)
|
|
30
|
+
- **selftest 118→119 PASS** (행위: every-session/active 만 알림, manual·paused 제외, `team preview` 링크 포함, 모듈 reference equality).
|
|
31
|
+
- **E2E 318→319 PASS** (행위: handoff 가 every-session 팀 노출 + manual 제외 + `LEERNESS_NO_TEAM_REMINDERS=1` opt-out).
|
|
32
|
+
- 실측: handoff 에 rev(every-session) 노출, man(manual) 미표시, opt-out 동작.
|
|
33
|
+
|
|
34
|
+
### UR-0073 로드맵: A(정의)·B(preview)·**C(스케줄 알림)** 완료. D(배포 통합)는 향후 권한 게이트.
|
|
35
|
+
|
|
3
36
|
## 1.9.372 — 2026-06-06 — UR-0073 Phase B: team preview — dry-run 실행 계획 미리보기
|
|
4
37
|
|
|
5
38
|
**🧩 정의된 팀의 작업을 실제 실행 없이 미리보기 — `leerness team preview`.** (UR-0073 Phase B, 안전 게이트: dry-run 전용)
|
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
|
-
[](https://www.npmjs.com/package/leerness) [](https://www.npmjs.com/package/leerness) []() []() []() []() []() []()
|
|
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.
|
|
474
|
+
이 프로젝트는 Leerness v1.9.374 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
|
|
475
475
|
|
|
476
476
|
### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
|
|
477
477
|
|
|
@@ -525,7 +525,7 @@ leerness memory restore decision <date|title>
|
|
|
525
525
|
|
|
526
526
|
### MCP server (외부 AI 통합)
|
|
527
527
|
|
|
528
|
-
Leerness v1.9.
|
|
528
|
+
Leerness v1.9.374는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
|
|
529
529
|
|
|
530
530
|
```jsonc
|
|
531
531
|
// 카테고리별
|
|
@@ -546,7 +546,7 @@ Leerness v1.9.372는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
|
|
|
546
546
|
`<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
|
|
547
547
|
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) 다음 라운드 예약.
|
|
548
548
|
|
|
549
|
-
현재 누적: **70 라운드 (1.9.40 → 1.9.
|
|
549
|
+
현재 누적: **70 라운드 (1.9.40 → 1.9.374)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
|
|
550
550
|
|
|
551
551
|
### 성능 가이드 (1.9.140 측정)
|
|
552
552
|
|
|
@@ -584,6 +584,6 @@ leerness release pack --close --auto-main-push
|
|
|
584
584
|
- `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
|
|
585
585
|
- `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
|
|
586
586
|
|
|
587
|
-
Last synced by Leerness v1.9.
|
|
587
|
+
Last synced by Leerness v1.9.374: 2026-06-06
|
|
588
588
|
<!-- leerness:project-readme:end -->
|
|
589
589
|
|
package/bin/harness.js
CHANGED
|
@@ -7,7 +7,7 @@ const cp = require('child_process');
|
|
|
7
7
|
const os = require('os'); // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
|
|
8
8
|
const readline = require('readline');
|
|
9
9
|
// 1.9.274 (UR-0025 1단계): 순수 유틸 함수 모듈 분리 (require-based, 비파괴). selftest 7종이 동작 검증.
|
|
10
|
-
const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _parseSkillsValue, _parseArchiveBlocks, _parseSkillCatalog, _renderTeamsMd, _composeTeamPlan, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
|
|
10
|
+
const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _parseSkillsValue, _parseArchiveBlocks, _parseSkillCatalog, _renderTeamsMd, _composeTeamPlan, _teamHandoffReminders, _cadenceAssessment, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
|
|
11
11
|
PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord,
|
|
12
12
|
_htmlToText, _extractTitle, _extractLinks,
|
|
13
13
|
_countDatedBlocks, _extractDecisionBlocks, _classifyIntent,
|
|
@@ -28,7 +28,7 @@ const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInG
|
|
|
28
28
|
// 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
|
|
29
29
|
const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS, BUILTIN_CATALOG, ROADMAP_STATUS_LABEL, ROADMAP_STATUS_COLOR, SECRET_PATTERNS, MERGE_OVERWRITE_FILES, MINIMAL_SKIP_KEYS, SKILL_CATALOG_PRESETS } = require('../lib/catalogs'); // 1.9.344/368/369 (UR-0025): catalog 분리 (MERGE_OVERWRITE_FILES/MINIMAL_SKIP_KEYS 포함)
|
|
30
30
|
|
|
31
|
-
const VERSION = '1.9.
|
|
31
|
+
const VERSION = '1.9.374';
|
|
32
32
|
|
|
33
33
|
// 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
|
|
34
34
|
// 이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
|
|
@@ -3009,6 +3009,8 @@ function _selfTestCases() {
|
|
|
3009
3009
|
{ name: 'UR-0025: _parseArchiveBlocks/_parseSkillCatalog 순수 파서 모듈 분리 + 행위 (1.9.370)', run: () => { const m = require('../lib/pure-utils'); if (typeof _parseArchiveBlocks !== 'function' || typeof _parseSkillCatalog !== 'function') return false; const moved = m._parseArchiveBlocks === _parseArchiveBlocks && m._parseSkillCatalog === _parseSkillCatalog; const ab = _parseArchiveBlocks('## 제거 2026-01-01 (target: ' + '"T-1")\n### 헤더\n'); const abOk = ab.length === 1 && ab[0].date === '2026-01-01' && ab[0].target === 'T-1' && ab[0].originalHeader === '헤더'; const md = _parseSkillCatalog('- [nm](https://x/SKILL.md) — d', ''); const mdOk = md.length === 1 && md[0].name === 'nm' && md[0].format === 'markdown'; const js = _parseSkillCatalog('{' + '"skills":[{"id":"a","url":"u"}]}', ''); const jsOk = js.length === 1 && js[0].name === 'a' && js[0].format === 'json'; return moved && abOk && mdOk && jsOk; } },
|
|
3010
3010
|
{ name: 'UR-0073 Phase A: team 정의 레지스트리 (_renderTeamsMd + canonical load/save) 행위 (1.9.371)', run: () => { const m = require('../lib/pure-utils'); if (typeof teamCmd !== 'function' || typeof _renderTeamsMd !== 'function' || m._renderTeamsMd !== _renderTeamsMd) return false; const md = _renderTeamsMd([{ id: 't1', name: 'N', personas: ['security'], members: ['claude'], schedule: 'daily', status: 'active' }]); const mdOk = md.includes('## t1') && md.includes('security') && md.includes('daily') && md.includes('정의 전용'); const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_team_')); let rtOk = false; try { _saveTeams(tmp, [{ id: 'x', name: 'X', personas: [], members: [], schedule: 'manual', status: 'active' }]); const loaded = _loadTeams(tmp); rtOk = loaded.length === 1 && loaded[0].id === 'x' && fs.existsSync(path.join(tmp, '.harness', 'teams.json')) && fs.existsSync(path.join(tmp, '.harness', 'teams.md')); } finally { try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} } return mdOk && rtOk; } },
|
|
3011
3011
|
{ name: 'UR-0073 Phase B: _composeTeamPlan dry-run 실행 계획 (멤버별 dispatch, 실행 없음) 행위 (1.9.372)', run: () => { const m = require('../lib/pure-utils'); if (typeof _composeTeamPlan !== 'function' || m._composeTeamPlan !== _composeTeamPlan) return false; const team = { id: 'rev', name: 'R', purpose: 'PR 리뷰', personas: ['security', 'perf'], members: ['claude', 'codex'], schedule: 'manual' }; const p1 = _composeTeamPlan(team, '점검'); const ok1 = p1.steps.length === 2 && p1.task === '점검' && p1.steps[0].member === 'claude' && p1.steps[0].suggestedCommand.includes('agents dispatch') && p1.steps[0].suggestedCommand.includes('--to claude') && p1.steps[0].dispatchPrompt.includes('security'); const p2 = _composeTeamPlan(team, null); const ok2 = p2.task === 'PR 리뷰'; const p3 = _composeTeamPlan({ id: 'e', personas: [], members: [] }, 'x'); const ok3 = p3.steps.length === 0 && p3.memberCount === 0; return ok1 && ok2 && ok3; } },
|
|
3012
|
+
{ name: 'UR-0073 Phase C: _teamHandoffReminders 스케줄 알림 (비-manual·active 만, 실행 트리거 아님) 행위 (1.9.373)', run: () => { const m = require('../lib/pure-utils'); if (typeof _teamHandoffReminders !== 'function' || m._teamHandoffReminders !== _teamHandoffReminders) return false; const r = _teamHandoffReminders([{ id: 'rev', schedule: 'every-session', status: 'active', members: ['a', 'b'] }, { id: 'man', schedule: 'manual', status: 'active' }, { id: 'paused', schedule: 'daily', status: 'paused' }]); return r.length === 1 && r[0].includes('rev') && r[0].includes('every-session') && r[0].includes('team preview rev') && !r.join('|').includes('man') && !r.join('|').includes('paused'); } },
|
|
3013
|
+
{ name: 'UR-0074: _cadenceAssessment 릴리스 빈도 평가 (임계값) 행위 (1.9.374)', run: () => { const m = require('../lib/pure-utils'); if (typeof _cadenceAssessment !== 'function' || m._cadenceAssessment !== _cadenceAssessment || typeof releaseCadenceCmd !== 'function') return false; return _cadenceAssessment(7, 1, 1).level === 'very-high' && _cadenceAssessment(3, 1, 1).level === 'high' && _cadenceAssessment(1, 1, 1).level === 'moderate' && _cadenceAssessment(0.2, 1, 1).level === 'healthy' && _cadenceAssessment(7, 1, 1).recommendation.length > 0; } },
|
|
3012
3014
|
{ name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
|
|
3013
3015
|
];
|
|
3014
3016
|
}
|
|
@@ -3606,7 +3608,9 @@ function commandsCmd(root) {
|
|
|
3606
3608
|
release: [
|
|
3607
3609
|
{ cmd: 'release sync-main [path]', desc: 'main merge + push + 자동 npm publish (1.9.140/178)' },
|
|
3608
3610
|
{ cmd: 'release pack', desc: 'tarball 생성' },
|
|
3609
|
-
{ cmd: 'release publish', desc: 'GitHub release 발행' }
|
|
3611
|
+
{ cmd: 'release publish', desc: 'GitHub release 발행' },
|
|
3612
|
+
{ cmd: 'release channel [path] [--json]', desc: '릴리스 채널 정책 (stable/next/고정) — 1.9.275' },
|
|
3613
|
+
{ cmd: 'release cadence [path] [--json]', desc: '릴리스 빈도 진단 + 권장 (외부리뷰 케이던스 가시화) — UR-0074, 1.9.374' }
|
|
3610
3614
|
],
|
|
3611
3615
|
skill: [
|
|
3612
3616
|
{ cmd: 'skill list|info|learn|use|optimize|match|suggest', desc: 'skill 카탈로그 CRUD' },
|
|
@@ -3668,6 +3672,18 @@ function commandsCmd(root) {
|
|
|
3668
3672
|
log(dm(` → 빠른 시작: leerness pulse | handoff | health`));
|
|
3669
3673
|
}
|
|
3670
3674
|
|
|
3675
|
+
// 1.9.374 (UR-0074): release cadence — 릴리스 빈도 진단 + 권장 (외부리뷰 반복 지적 "릴리스 케이던스 과다" 가시화). git tag 재사용, 읽기 전용.
|
|
3676
|
+
function releaseCadenceCmd(root) {
|
|
3677
|
+
root = absRoot(root);
|
|
3678
|
+
const rh = _computeRoundHistory(root);
|
|
3679
|
+
const a = _cadenceAssessment(rh.avgRoundsPerDay, rh.roundCount, rh.daysActive);
|
|
3680
|
+
if (has('--json')) { log(JSON.stringify({ version: VERSION, currentVersion: rh.currentVersion, baselineVersion: rh.baselineVersion, ...a }, null, 2)); return; }
|
|
3681
|
+
log(`# leerness release cadence (1.9.374, UR-0074) — 릴리스 빈도 진단 (읽기 전용)`);
|
|
3682
|
+
log(` 누적 릴리스: ${a.total} · 활동일: ${a.daysActive}일 · 빈도: ${a.releasesPerDay}/day`);
|
|
3683
|
+
log(` 수준: ${a.level}`);
|
|
3684
|
+
log(` 권장: ${a.recommendation}`);
|
|
3685
|
+
log(`\n 관련: leerness release channel (stable/next 정책) · leerness install-safety (공급망 신뢰)`);
|
|
3686
|
+
}
|
|
3671
3687
|
function roundHistoryCmd(root) {
|
|
3672
3688
|
root = absRoot(root);
|
|
3673
3689
|
const isTty = process.stdout && process.stdout.isTTY;
|
|
@@ -8994,6 +9010,18 @@ function handoff(root) {
|
|
|
8994
9010
|
log(d(' 끄려면: --no-workflow-guide 또는 LEERNESS_NO_WORKFLOW_GUIDE=1'));
|
|
8995
9011
|
log('');
|
|
8996
9012
|
}
|
|
9013
|
+
// 1.9.373 (UR-0073 Phase C): 에이전트 팀 스케줄 알림 — 비-manual 팀이 정의돼 있으면 미리보기(dry-run) 안내. 실행 없음. opt-out.
|
|
9014
|
+
if (!has('--no-team-reminders') && !has('--compact') && !has('--quiet') && process.env.LEERNESS_NO_TEAM_REMINDERS !== '1') {
|
|
9015
|
+
try {
|
|
9016
|
+
const _teamRem = _teamHandoffReminders(_loadTeams(root));
|
|
9017
|
+
if (_teamRem.length) {
|
|
9018
|
+
log('');
|
|
9019
|
+
log('## 🤝 에이전트 팀 스케줄 (UR-0073 Phase C) — 정의 전용 · 자동 실행 X');
|
|
9020
|
+
_teamRem.forEach(r => log(' ' + r));
|
|
9021
|
+
log(' ⓘ 미리보기는 dry-run. 실행은 제안 명령 검토 후 직접 · 끄려면 --no-team-reminders 또는 LEERNESS_NO_TEAM_REMINDERS=1');
|
|
9022
|
+
}
|
|
9023
|
+
} catch {}
|
|
9024
|
+
}
|
|
8997
9025
|
ok('handoff loaded; current-state updated');
|
|
8998
9026
|
}
|
|
8999
9027
|
|
|
@@ -21195,7 +21223,7 @@ function help() {
|
|
|
21195
21223
|
leerness skill install <SKILL.md|dir|url> · leerness skill discover --preset vercel|anthropic # 스킬 설치/탐색
|
|
21196
21224
|
leerness release bump [--patch|--minor|--major] # package.json 자동 bump (1.9.8)
|
|
21197
21225
|
leerness release note "<내용>" # CHANGELOG.md 자동 추가 (1.9.8)
|
|
21198
|
-
leerness release publish [--dry-run] [--pack] [--git-push] [--gh-release] [--gh-pages] [--gh-pages-src file] [--npm-publish] [--auto] # 통합 배포 (1.9.8 + 1.9.10)\n leerness impact <target> [--all] # 변경 전 영향 분석 (기본 strong, --all로 weak 포함)\n leerness reuse find <query> # 기존 자원 검색 (재귀 안내)\n leerness reuse register <name> --where <p> --kind component|hook|util|api [--note ...]\n leerness ui consistency [path] [--strict] [--fail-on-violation]\n leerness graph [path] [--out <file>] # mermaid 의존성 그래프\n leerness guide [target] # impact + reuse + ui consistency 통합 가이드\n leerness migrate audit|apply|plan [path] [--json] [--yes] # 크로스버전 마이그레이션 진단/적용(canonical 백필)/플랜(임시폴더 비교) (UR-0075, 1.9.356~358)\n leerness migrate --guide # AI 에이전트용 크로스버전 마이그레이션 가이드 (1.9.355)\n leerness install-safety [--json] # 설치 안전 프로필 — 0 런타임 deps / 0 install-script (1.9.359)\n leerness capabilities [--json] # 권한·보안 표면 공개 (1.9.272)\n leerness feature add|link|impact|list|show # 기능 그래프(feature-graph) 추적\n leerness permissions list|set # agent 권한 모드 (1.9.174)\n leerness creds list|register|check|refresh # 크리덴셜 메타 추적 (값 미저장)\n leerness incident list|show|handle · webhook serve · deploy auto · runs list|show # 운영(ops)\n leerness whats-new [path] # 최근 버전 변경 요약\n leerness team list|add|show|remove|preview <id> [--name --purpose --personas a,b --members claude,codex --schedule every-session --task "..."] # 에이전트 팀 정의 + preview(dry-run 실행계획) — UR-0073 Phase A/B, opt-in · 정의/미리보기 전용(자동실행 X)\n leerness commands [--json] # 전체 명령 전수 목록 (누락 없이 이 명령으로 확인)\n`);
|
|
21226
|
+
leerness release publish [--dry-run] [--pack] [--git-push] [--gh-release] [--gh-pages] [--gh-pages-src file] [--npm-publish] [--auto] # 통합 배포 (1.9.8 + 1.9.10)\n leerness impact <target> [--all] # 변경 전 영향 분석 (기본 strong, --all로 weak 포함)\n leerness reuse find <query> # 기존 자원 검색 (재귀 안내)\n leerness reuse register <name> --where <p> --kind component|hook|util|api [--note ...]\n leerness ui consistency [path] [--strict] [--fail-on-violation]\n leerness graph [path] [--out <file>] # mermaid 의존성 그래프\n leerness guide [target] # impact + reuse + ui consistency 통합 가이드\n leerness migrate audit|apply|plan [path] [--json] [--yes] # 크로스버전 마이그레이션 진단/적용(canonical 백필)/플랜(임시폴더 비교) (UR-0075, 1.9.356~358)\n leerness migrate --guide # AI 에이전트용 크로스버전 마이그레이션 가이드 (1.9.355)\n leerness install-safety [--json] # 설치 안전 프로필 — 0 런타임 deps / 0 install-script (1.9.359)\n leerness capabilities [--json] # 권한·보안 표면 공개 (1.9.272)\n leerness feature add|link|impact|list|show # 기능 그래프(feature-graph) 추적\n leerness permissions list|set # agent 권한 모드 (1.9.174)\n leerness creds list|register|check|refresh # 크리덴셜 메타 추적 (값 미저장)\n leerness incident list|show|handle · webhook serve · deploy auto · runs list|show # 운영(ops)\n leerness whats-new [path] # 최근 버전 변경 요약\n leerness team list|add|show|remove|preview <id> [--name --purpose --personas a,b --members claude,codex --schedule every-session --task "..."] # 에이전트 팀 정의 + preview(dry-run 실행계획) — UR-0073 Phase A/B, opt-in · 정의/미리보기 전용(자동실행 X)\n leerness release channel|cadence [path] [--json] # 릴리스 채널 정책 + 빈도 진단 (UR-0074 케이던스 가시화, 1.9.275/374)\n leerness commands [--json] # 전체 명령 전수 목록 (누락 없이 이 명령으로 확인)\n`);
|
|
21199
21227
|
}
|
|
21200
21228
|
|
|
21201
21229
|
async function main() {
|
|
@@ -21468,6 +21496,7 @@ async function main() {
|
|
|
21468
21496
|
if (cmd === 'release' && args[1] === 'cleanup') return releaseCleanupCmd((args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd()));
|
|
21469
21497
|
// 1.9.275 (UR-0026): leerness release channel — 안정/실험 채널 정책 (npm dist-tag)
|
|
21470
21498
|
if (cmd === 'release' && args[1] === 'channel') return releaseChannelCmd((args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd()));
|
|
21499
|
+
if (cmd === 'release' && args[1] === 'cadence') return releaseCadenceCmd((args[2] && !args[2].startsWith('-')) ? args[2] : arg('--path', process.cwd())); // 1.9.374 (UR-0074): 릴리스 빈도 진단
|
|
21471
21500
|
// 1.9.141: feature causality graph
|
|
21472
21501
|
if (cmd === 'feature' && args[1] === 'add') return featureAddCmd(arg('--path', process.cwd()), args.slice(2).filter(x => !x.startsWith('--')).join(' '));
|
|
21473
21502
|
if (cmd === 'feature' && args[1] === 'link') return featureLinkCmd(arg('--path', process.cwd()), args[2]);
|
package/lib/pure-utils.js
CHANGED
|
@@ -762,11 +762,29 @@ function _composeTeamPlan(team, task) {
|
|
|
762
762
|
return { teamId: t.id || null, name: t.name || '', task: effTask, schedule: t.schedule || 'manual', memberCount: members.length, steps };
|
|
763
763
|
}
|
|
764
764
|
|
|
765
|
+
// 1.9.373 (UR-0073 Phase C): 비-manual·active 팀의 handoff 스케줄 알림 라인 (순수). 실행 트리거 아님 — 미리보기 안내만.
|
|
766
|
+
function _teamHandoffReminders(teams) {
|
|
767
|
+
return (teams || [])
|
|
768
|
+
.filter(t => t && t.schedule && t.schedule !== 'manual' && (t.status || 'active') === 'active' && t.id)
|
|
769
|
+
.map(t => `🤝 ${t.id} (${t.schedule})${Array.isArray(t.members) && t.members.length ? ' · ' + t.members.length + '명' : ''} — 미리보기: leerness team preview ${t.id}`);
|
|
770
|
+
}
|
|
771
|
+
|
|
772
|
+
// 1.9.374 (UR-0074): 릴리스 케이던스 평가 (순수) — releases/day → 수준 + 권장. 외부리뷰 "릴리스 빈도 과다" 가시화.
|
|
773
|
+
function _cadenceAssessment(perDay, total, daysActive) {
|
|
774
|
+
const r = Number(perDay) || 0;
|
|
775
|
+
let level, recommendation;
|
|
776
|
+
if (r >= 5) { level = 'very-high'; recommendation = 'batched minor 릴리스 강력 권장 — 관련 패치를 묶어 주 1~2회 minor 로. stable/next 채널 분리 + 사용자에겐 stable 만 권고.'; }
|
|
777
|
+
else if (r >= 2) { level = 'high'; recommendation = 'cadence 높음 — 연관 변경을 묶어 배포 빈도 축소 권장. 릴리스 노트에 실행 환경/검증 명시.'; }
|
|
778
|
+
else if (r >= 0.5) { level = 'moderate'; recommendation = '적정 범위 — 안정성 우선 시 minor 묶음 고려.'; }
|
|
779
|
+
else { level = 'healthy'; recommendation = '건강한 케이던스.'; }
|
|
780
|
+
return { releasesPerDay: r, total: Number(total) || 0, daysActive: Number(daysActive) || 0, level, recommendation };
|
|
781
|
+
}
|
|
782
|
+
|
|
765
783
|
module.exports = {
|
|
766
784
|
_isSecretKey, compareVer, parseHarnessVersion,
|
|
767
785
|
_isPlaceholderSecret, _looksSecretLike,
|
|
768
786
|
_mergeLines, _mergeEnvLines, _mergeReadmeSection, _managedMerge, _parseSkillsValue,
|
|
769
|
-
_parseArchiveBlocks, _parseSkillCatalog, _renderTeamsMd, _composeTeamPlan,
|
|
787
|
+
_parseArchiveBlocks, _parseSkillCatalog, _renderTeamsMd, _composeTeamPlan, _teamHandoffReminders, _cadenceAssessment,
|
|
770
788
|
_classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
|
|
771
789
|
// 1.9.283 (UR-0025 2단계)
|
|
772
790
|
PERMISSION_TIERS, _tierRank, _requiredTier, _policyAllows, _resolveNpmTag, _mcpJsonContent, _newRunRecord,
|
package/package.json
CHANGED
package/scripts/e2e.js
CHANGED
|
@@ -5133,5 +5133,42 @@ total++;
|
|
|
5133
5133
|
if (!ok) failed++;
|
|
5134
5134
|
}
|
|
5135
5135
|
|
|
5136
|
+
// 1.9.373 회귀 (UR-0073 Phase C): handoff 가 비-manual 팀 스케줄 알림 노출(미리보기 안내) · manual 미표시 · opt-out
|
|
5137
|
+
total++;
|
|
5138
|
+
{
|
|
5139
|
+
let ok = false;
|
|
5140
|
+
try {
|
|
5141
|
+
const d = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-tsch-'));
|
|
5142
|
+
cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', 'ko'], { encoding: 'utf8', timeout: 30000 });
|
|
5143
|
+
cp.spawnSync(process.execPath, [CLI, 'team', 'add', 'rev', '--members', 'claude', '--schedule', 'every-session', '--path', d], { encoding: 'utf8', timeout: 15000 });
|
|
5144
|
+
cp.spawnSync(process.execPath, [CLI, 'team', 'add', 'man', '--members', 'claude', '--schedule', 'manual', '--path', d], { encoding: 'utf8', timeout: 15000 });
|
|
5145
|
+
const h = cp.spawnSync(process.execPath, [CLI, 'handoff', d], { encoding: 'utf8', timeout: 30000 });
|
|
5146
|
+
const out = h.stdout || '';
|
|
5147
|
+
const shows = out.includes('에이전트 팀 스케줄') && out.includes('team preview rev') && !out.includes('🤝 man');
|
|
5148
|
+
const ho = cp.spawnSync(process.execPath, [CLI, 'handoff', d], { encoding: 'utf8', timeout: 30000, env: { ...process.env, LEERNESS_NO_TEAM_REMINDERS: '1' } });
|
|
5149
|
+
const optOut = !(ho.stdout || '').includes('에이전트 팀 스케줄');
|
|
5150
|
+
fs.rmSync(d, { recursive: true, force: true });
|
|
5151
|
+
ok = shows && optOut;
|
|
5152
|
+
} catch {}
|
|
5153
|
+
console.log(ok ? '✓ B(1.9.373) UR-0073 Phase C: handoff 팀 스케줄 알림 (비-manual 노출/manual 제외/opt-out)' : '✗ team 스케줄 알림 실패');
|
|
5154
|
+
if (!ok) failed++;
|
|
5155
|
+
}
|
|
5156
|
+
|
|
5157
|
+
// 1.9.374 회귀 (UR-0074): release cadence 진단 — --json level/recommendation/releasesPerDay 구조 (릴리스 빈도 가시화)
|
|
5158
|
+
total++;
|
|
5159
|
+
{
|
|
5160
|
+
let ok = false;
|
|
5161
|
+
try {
|
|
5162
|
+
const d = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-cad-'));
|
|
5163
|
+
cp.spawnSync(process.execPath, [CLI, 'init', d, '--yes', '--language', 'ko'], { encoding: 'utf8', timeout: 30000 });
|
|
5164
|
+
const r = cp.spawnSync(process.execPath, [CLI, 'release', 'cadence', d, '--json'], { encoding: 'utf8', timeout: 20000 });
|
|
5165
|
+
const j = JSON.parse(r.stdout);
|
|
5166
|
+
fs.rmSync(d, { recursive: true, force: true });
|
|
5167
|
+
ok = ['very-high', 'high', 'moderate', 'healthy'].includes(j.level) && typeof j.releasesPerDay === 'number' && typeof j.recommendation === 'string' && j.recommendation.length > 0;
|
|
5168
|
+
} catch {}
|
|
5169
|
+
console.log(ok ? '✓ B(1.9.374) UR-0074: release cadence 진단 (--json level/recommendation/releasesPerDay)' : '✗ release cadence 실패');
|
|
5170
|
+
if (!ok) failed++;
|
|
5171
|
+
}
|
|
5172
|
+
|
|
5136
5173
|
console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
|
|
5137
5174
|
if (failed > 0) process.exit(1);
|