leerness 1.9.38 → 1.9.39
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 +39 -0
- package/README.md +2 -1
- package/bin/harness.js +141 -3
- package/package.json +1 -1
- package/scripts/e2e.js +54 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,44 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.9.39 — 2026-05-19
|
|
4
|
+
|
|
5
|
+
**AI 하네스 엔지니어링 6단계 워크플로 자동 유도 + drift 자동 회복**.
|
|
6
|
+
|
|
7
|
+
사용자 우려: "프로젝트가 복잡해지고 길어질 때 leerness를 점점 참조하지 않는다" — 1.9.37/38 drift 감지에 이어, 이번엔 **매 세션 시작 시 워크플로 자체를 자동 안내**하는 능동형 메커니즘 추가.
|
|
8
|
+
|
|
9
|
+
### Added — A. 세션 워크플로 정책
|
|
10
|
+
|
|
11
|
+
- **`.harness/session-workflow.md`** 신규 — AI 하네스 엔지니어링 6단계 가이드:
|
|
12
|
+
1. **요청 분석** (handoff + drift check)
|
|
13
|
+
2. **계획 수립** (plan add / TodoWrite + reuse-map)
|
|
14
|
+
3. **업무 분배** (agents list/recommend, 작업유형별 sub-agent 매핑)
|
|
15
|
+
4. **sub-agent 작업** (파일 경로 격리, mtime 검증 의무, 자체 테스트)
|
|
16
|
+
5. **종합 검증** (contract verify + verify-claim --run-tests + review --persona)
|
|
17
|
+
6. **세션 마감** (session close + audit --fix + usage stats)
|
|
18
|
+
- **`handoff` 출력 끝에 6단계 가이드 자동 표시** — 매 세션 시작 시 메인 에이전트가 잊지 않도록.
|
|
19
|
+
- **AGENTS.md / CLAUDE.md 템플릿 업그레이드** — "⭐ 매 세션 첫 행동: session-workflow.md 먼저 읽기" 항목 최상단 추가, Mandatory read order 1번 위치.
|
|
20
|
+
- 스킵: `--no-workflow-guide` 또는 `LEERNESS_NO_WORKFLOW_GUIDE=1`.
|
|
21
|
+
|
|
22
|
+
### Added — B. drift 자동 회복
|
|
23
|
+
|
|
24
|
+
- **`leerness drift check --auto-fix`** — critical (≥100) 시 자동으로 `session close` 실행 + 재검증.
|
|
25
|
+
- 회복 성공 시 usage-stats의 `drift.autoResolved` 카운터 누적
|
|
26
|
+
- 실패 시 수동 실행 안내
|
|
27
|
+
- **`leerness handoff --auto-recover`** — handoff 진입 시 severe drift 감지하면 inline 자동 회복.
|
|
28
|
+
- sevStale (≥3일) 시에만 발동 (안전)
|
|
29
|
+
|
|
30
|
+
### 정책
|
|
31
|
+
- ✅ `--auto-fix`/`--auto-recover`는 **명시적 플래그** 필요 (기본 동작은 알림만 유지)
|
|
32
|
+
- ✅ 워크플로 가이드는 매 handoff 출력에 표시 → 메인 에이전트가 매 세션 6단계 인지
|
|
33
|
+
- ✅ AGENTS/CLAUDE 템플릿 통합 → AI 에이전트가 세션 시작 시 자동 읽음
|
|
34
|
+
|
|
35
|
+
### 실측
|
|
36
|
+
- 워크플로 가이드 정상 표시 (handoff 끝에 6 단계 + .harness/session-workflow.md 링크)
|
|
37
|
+
- session-workflow.md init 시 자동 생성 (6단계 + 사용 명령 + anti-pattern 명시)
|
|
38
|
+
- AGENTS/CLAUDE에 session-workflow.md 참조 자동 inject
|
|
39
|
+
|
|
40
|
+
### e2e: 178/178 PASS (1.9.38 174 + 신규 4)
|
|
41
|
+
|
|
3
42
|
## 1.9.38 — 2026-05-18
|
|
4
43
|
|
|
5
44
|
**drift 자동 reminder + 사용 통계 + TodoWrite 임포트 + drift 임계 학습**.
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
|
|
4
4
|
|
|
5
|
-
[](https://www.npmjs.com/package/leerness) [](https://www.npmjs.com/package/leerness) []() []() []()
|
|
6
6
|
|
|
7
7
|
```
|
|
8
8
|
╔══════════════════════════════════════════════════════════════╗
|
|
@@ -380,6 +380,7 @@ npm test # = node ./scripts/e2e.js
|
|
|
380
380
|
|
|
381
381
|
## 변경 이력 (최근)
|
|
382
382
|
|
|
383
|
+
- **1.9.39** — AI 하네스 엔지니어링 6단계 워크플로 자동 유도 (`session-workflow.md` + handoff 끝 가이드 + AGENTS/CLAUDE 인스트럭션 통합) · `drift check --auto-fix` · `handoff --auto-recover` (critical 시 session close 자동 실행).
|
|
383
384
|
- **1.9.38** — drift 자동 reminder (`agent-reminders.md`) · `usage stats` 명령 · `task sync --from <todo.json>` · drift 임계 학습 (skip ≥5 → 임계 완화).
|
|
384
385
|
- **1.9.37** — `leerness drift check` (4 신호 + 4단계 레벨) — 라운드 길어지며 메인이 leerness 잊는 현상 자동 감지.
|
|
385
386
|
- **1.9.36** — `agents bench` (3 CLI 동시 비교) · `dispatch --write` (CLI별 권장 플래그) · 작업 유형 추천 · `contract verify` require() side-effect 25× 속도 회복.
|
package/bin/harness.js
CHANGED
|
@@ -6,7 +6,7 @@ const path = require('path');
|
|
|
6
6
|
const cp = require('child_process');
|
|
7
7
|
const readline = require('readline');
|
|
8
8
|
|
|
9
|
-
const VERSION = '1.9.
|
|
9
|
+
const VERSION = '1.9.39';
|
|
10
10
|
const MARK = '<!-- leerness:managed -->';
|
|
11
11
|
const README_START = '<!-- leerness:project-readme:start -->';
|
|
12
12
|
const README_END = '<!-- leerness:project-readme:end -->';
|
|
@@ -198,8 +198,8 @@ function coreFiles(root, lang = 'ko', selectedSkills = []) {
|
|
|
198
198
|
const project = detectProjectName(root);
|
|
199
199
|
const skillRows = Object.entries(skillCatalog).map(([k, v]) => `| ${k} | ${v.displayNameKo} | ${v.capabilities.join(', ')} | ${v.lastUpdated} | ${v.verification} |`).join('\n');
|
|
200
200
|
return {
|
|
201
|
-
'AGENTS.md': `${MARK}\n# Leerness Agent Instructions\n\n## Mandatory read order (session start)\n1. .harness/context-routing.md\
|
|
202
|
-
'CLAUDE.md': `${MARK}\n# Claude Code Instructions\n\nFollow AGENTS.md. Always run \`leerness handoff .\` at the start and \`leerness session close .\` before ending a session.\n\nProtected files must not be deleted. Read .harness/anti-lazy-work-policy.md before claiming completion.\n\n## 자연어 영구 룰 (1.9.8)\n사용자가 "매 X마다 Y를 해줘" 같은 자연어 룰을 말하면 즉시 \`leerness rule add "Y" --trigger every-X\`로 등록하세요. 등록된 룰은 매 세션 \`handoff\`가 자동 출력하고, \`session close\`가 자동 검증해 보고합니다. 사용자가 "중지" / "그만" / "끄기"를 명시할 때만 \`rule pause/remove\`를 호출합니다.\n\n자세한 매핑은 AGENTS.md의 "자연어 룰 처리" 표를 참고하세요.\n`,
|
|
201
|
+
'AGENTS.md': `${MARK}\n# Leerness Agent Instructions\n\n## ⭐ 매 세션 첫 행동 (1.9.39+)\n**반드시 \`.harness/session-workflow.md\`를 먼저 읽고 6단계 워크플로를 따른다**: 요청분석→계획→분배→sub-agent작업→종합검증→마감. 라운드 길이/복잡도 무관, drift 방지를 위해 모든 작업에 동일 흐름 유지.\n\n## Mandatory read order (session start)\n1. **.harness/session-workflow.md** (1.9.39+ 6단계 워크플로 — 최우선)\n2. .harness/context-routing.md\n3. .harness/session-handoff.md\n4. .harness/current-state.md\n5. .harness/plan.md\n6. .harness/progress-tracker.md\n7. .harness/guideline.md\n8. .harness/protected-files.md\n9. .harness/writeback-policy.md\n10. .harness/anti-lazy-work-policy.md\n11. **.harness/rules.md** (사용자 정의 영구 룰 — 매 세션 반드시 따름)\n\n## Required behavior\n- 작업 시작 시 \`leerness handoff .\`를 실행해 컨텍스트를 적재합니다 (handoff가 active rules를 자동 출력).\n- 작업 분류는 \`leerness route <task-type>\`로 확인합니다 (planning, feature, bugfix, refactor, research, consistency, release, migration, session-start, session-close, harness-maintenance).\n- 보호 파일/관리 섹션을 삭제하지 않습니다. 머지·아카이브·deprecated 표시를 사용합니다.\n- 의미 있는 변경 후 progress-tracker, current-state, task-log, session-handoff를 갱신합니다.\n- 완료 선언 전 \`leerness check .\` 또는 \`leerness lazy detect .\`로 자기검증합니다.\n- 변경 전 secret/encoding 가드: \`leerness scan secrets .\`, \`leerness encoding check .\`.\n- 같은 기능 중복 생성 전 design-system.md, consistency-policy.md, reuse-map.md를 확인합니다.\n- 매 세션 종료 시 \`leerness session close .\`로 9개 카테고리(완료/진행중/미완료/예정/대기/보류/차단/드랍/검증) + **활성 룰 검증 결과**를 보고합니다.\n- 업데이트는 \`leerness update --check\` (감지) → \`leerness update --yes\` (자동 마이그레이션).\n\n## 자연어 회고/통찰/브레인스토밍 (1.9.13)\n사용자가 자연어로 회고/통찰/브레인스토밍을 요청하면 즉시 leerness 명령으로 호출합니다.\n\n| 사용자 발화 (자연어) | 즉시 실행할 명령 |\n|---|---|\n| "회고해줘 / 돌아보자 / 정리해줘" | \`leerness retro\` |\n| "최근 N일 회고" | \`leerness retro --days N\` |\n| "통계 / 누적 지표 / insights" | \`leerness insights\` |\n| "X에 대해 브레인스토밍 / X 관련 자료 / X 시작 전 검토" | \`leerness brainstorm "X"\` |\n\nsession close가 매번 자동으로 한 줄 요약을 출력하고, 5세션마다 자동 깊은 회고를 실행합니다. 사용자가 명시 요청 시 즉시 호출.\n\n## 자연어 룰 처리 (1.9.8)\n사용자가 자연어로 영구 룰을 요청하면 즉시 leerness rule 명령으로 등록합니다.\n\n| 사용자 발화 (자연어) | 즉시 실행할 명령 |\n|---|---|\n| "매 업데이트마다 버전 bump해줘" | \`leerness rule add "버전을 patch로 bump" --trigger every-update\` |\n| "매 커밋마다 패치노트 추가해줘" | \`leerness rule add "패치노트 추가" --trigger every-commit\` |\n| "세션 종료마다 배포해줘" | \`leerness rule add "배포 (release publish)" --trigger session-close\` |\n| "X 룰 중지/그만/끄기" | \`leerness rule pause <ID>\` (해당 룰 ID는 list로 확인) |\n| "X 룰 제거/삭제" | \`leerness rule remove <ID>\` |\n| "모든 룰 중지" | \`leerness rule stop\` |\n| "룰 다시 켜줘" | \`leerness rule resume-all\` 또는 \`leerness rule resume <ID>\` |\n\n룰을 등록한 후 사용자에게 등록 결과(ID + trigger + 설명)를 보고하고, 그 이후 매 세션마다 자동 적용합니다. 사용자가 "중지" 또는 "제거"를 명시적으로 말하기 전까지는 룰을 비활성화하지 않습니다.\n\n## 룰 자동 적용 (1.9.8)\nleerness가 자동 검증 가능한 trigger:\n- **every-update / version bump 키워드 룰**: package.json의 version이 갱신됐는지 검사 (handoff/session close가 baseline 캐시와 비교).\n- **CHANGELOG / 패치노트 키워드 룰**: CHANGELOG.md의 mtime이 갱신됐는지 검사.\n- **test / 테스트 / verify 키워드 룰**: review-evidence.md에 오늘 verify-code 흔적이 있는지 검사.\n- **배포 / publish / push 키워드 룰**: 자동 검증 불가 → 사용자에게 release publish 명령을 안내.\n\n자동 검증 가능한 룰의 실행은 \`leerness release bump\`, \`leerness release note "..."\`, \`leerness release publish\`를 사용해 자동화합니다.\n`,
|
|
202
|
+
'CLAUDE.md': `${MARK}\n# Claude Code Instructions\n\nFollow AGENTS.md. Always run \`leerness handoff .\` at the start and \`leerness session close .\` before ending a session.\n\n**⭐ 매 세션 첫 행동 (1.9.39+)**: \`.harness/session-workflow.md\`의 6단계 워크플로(요청분석→계획→분배→sub-agent→종합검증→마감)를 따라야 함. drift critical 시 \`leerness drift check --auto-fix\`로 자동 회복.\n\nProtected files must not be deleted. Read .harness/anti-lazy-work-policy.md before claiming completion.\n\n## 자연어 영구 룰 (1.9.8)\n사용자가 "매 X마다 Y를 해줘" 같은 자연어 룰을 말하면 즉시 \`leerness rule add "Y" --trigger every-X\`로 등록하세요. 등록된 룰은 매 세션 \`handoff\`가 자동 출력하고, \`session close\`가 자동 검증해 보고합니다. 사용자가 "중지" / "그만" / "끄기"를 명시할 때만 \`rule pause/remove\`를 호출합니다.\n\n자세한 매핑은 AGENTS.md의 "자연어 룰 처리" 표를 참고하세요.\n`,
|
|
203
203
|
'.cursor/rules/leerness.mdc': `${MARK}\n---\nalwaysApply: true\n---\nFollow AGENTS.md and .harness/context-routing.md.\nRun: \`leerness handoff .\` at session start.\nRun: \`leerness session close .\` at session end.\nPreserve Leerness protected files.\n`,
|
|
204
204
|
'.github/copilot-instructions.md': `${MARK}\n# Copilot Instructions\n\nUse AGENTS.md and .harness/ as project memory.\nDo not remove protected Leerness files.\nBefore completion, ensure plan.md, progress-tracker.md, current-state.md, session-handoff.md are updated.\n`,
|
|
205
205
|
'.harness/HARNESS_VERSION': VERSION + '\n',
|
|
@@ -229,6 +229,81 @@ function coreFiles(root, lang = 'ko', selectedSkills = []) {
|
|
|
229
229
|
'.harness/review-checklist.md': fm('review-checklist', ['PR/리뷰 전'], ['리뷰 기준 변경'], `# Review Checklist\n\n- [ ] 계획과 정렬되어 있는가\n- [ ] progress-tracker가 갱신되었는가\n- [ ] 보호 파일을 삭제하지 않았는가\n- [ ] 디자인/기능 재사용을 확인했는가\n- [ ] 시크릿이 코드에 들어가지 않았는가 (\`leerness scan secrets\`)\n- [ ] 한글 인코딩 OK (\`leerness encoding check\`)\n- [ ] 게으름 평가 통과 (\`leerness lazy detect\`)\n`),
|
|
230
230
|
'.harness/release-checklist.md': fm('release-checklist', ['배포 전'], ['배포 조건/환경변수/롤백 변경'], `# Release Checklist\n\n- [ ] \`leerness verify .\`\n- [ ] \`leerness audit .\`\n- [ ] \`leerness scan secrets .\`\n- [ ] \`leerness encoding check .\`\n- [ ] 프로젝트 typecheck/lint/test\n- [ ] 환경변수 (.env.example) 동기화\n- [ ] 롤백 방법 확인\n- [ ] CHANGELOG 갱신\n`),
|
|
231
231
|
'.harness/session-close-policy.md': fm('session-close-policy', ['세션 종료 전'], ['세션 종료 형식 변경'], `# Session Close Policy\n\nEvery session must list:\n- Completed\n- In progress\n- Incomplete\n- Planned\n- Waiting\n- On hold\n- Blocked\n- Dropped\n- Verification (commands run, results)\n- Recommended next direction\n- Next exact step\n\n\`leerness session close\`가 위 9개 카테고리를 자동 추출하고, session-handoff.md에 다음 세션을 위한 인수인계 블록을 자동 작성합니다.\n`),
|
|
232
|
+
'.harness/session-workflow.md': fm('session-workflow', ['세션 시작','새 사용자 요청 도착','복잡한 작업 분배 전'], ['워크플로 단계 변경'], `# Session Workflow — AI 하네스 엔지니어링 6단계
|
|
233
|
+
|
|
234
|
+
> **매 세션 시작 시 메인 에이전트는 이 문서를 먼저 읽고 6단계를 그대로 따른다.**
|
|
235
|
+
> 라운드 길이/복잡도 무관, 단순 작업도 동일 흐름 유지 — 그래야 drift 안 됨.
|
|
236
|
+
|
|
237
|
+
## Step 1. 요청 분석 + 환경 확인
|
|
238
|
+
\`\`\`bash
|
|
239
|
+
leerness handoff . # 컨텍스트 적재 + drift 자동 경고
|
|
240
|
+
leerness drift check . # 4 신호 + 4단계 레벨
|
|
241
|
+
\`\`\`
|
|
242
|
+
- 사용자 요청을 5W1H로 분해. 모호하면 명확화 질문 (autonomous 모드 제외).
|
|
243
|
+
- drift critical 시 \`leerness session close .\` 또는 \`drift check --auto-fix\` 우선 실행.
|
|
244
|
+
|
|
245
|
+
## Step 2. 계획 수립
|
|
246
|
+
- 작업이 3 step 이상 → TodoWrite 또는 \`leerness plan add\` 사용.
|
|
247
|
+
- 신규 capability → \`leerness reuse-map\` / \`reuse find <query>\`로 기존 자원 우선 검색.
|
|
248
|
+
- 다중 모듈 → 통합 사양 사전 정의 (예: TICK_SPEC.md).
|
|
249
|
+
|
|
250
|
+
## Step 3. 업무 분배 — sub-agent 매핑
|
|
251
|
+
\`\`\`bash
|
|
252
|
+
leerness agents list # ready CLI 확인
|
|
253
|
+
leerness agents quota # 한도 확인
|
|
254
|
+
leerness agents dispatch "<task>" --to <id> # 작업 유형 추천 자동
|
|
255
|
+
\`\`\`
|
|
256
|
+
- 작업 유형별 최적 sub-agent:
|
|
257
|
+
- 텍스트/번역/분석 → claude (1.7× 빠름)
|
|
258
|
+
- 깊은 코드 추론 → codex (가장 상세)
|
|
259
|
+
- 파일 직접 수정 → gemini --yolo (정확)
|
|
260
|
+
- 보안 리뷰 → \`leerness review --persona security\`
|
|
261
|
+
- **충돌 방지 규칙 (필수)**:
|
|
262
|
+
- 각 sub-agent에 *자신만 수정할 파일 경로* 명시
|
|
263
|
+
- mtime 검증 결과 보고 의무화 (동시 쓰기는 last-writer-wins 위험)
|
|
264
|
+
- 사양 사전 정의 → \`leerness contract verify\`로 사후 검증
|
|
265
|
+
|
|
266
|
+
## Step 4. sub-agent 작업 + 개별 자체 검증
|
|
267
|
+
- 각 sub-agent가 자기 모듈 자체 테스트 통과 후 보고.
|
|
268
|
+
- 보고 형식: 라인 수, 테스트 N/N PASS, 발견 이슈, mtime 검증 결과.
|
|
269
|
+
|
|
270
|
+
## Step 5. 종합 검증
|
|
271
|
+
\`\`\`bash
|
|
272
|
+
leerness contract verify SPEC.md src/<mod>.js # 명세 ↔ 구현 일치
|
|
273
|
+
leerness verify-claim T-XXX --run-tests --strict-claims
|
|
274
|
+
leerness review <file> --persona security,performance,ux
|
|
275
|
+
\`\`\`
|
|
276
|
+
- 메인이 직접 통합 시나리오 작성 + 실행 (independent 검증).
|
|
277
|
+
- Sub-agent 검수 vs 메인 검수 결과 *교차 일치* 확인.
|
|
278
|
+
|
|
279
|
+
## Step 6. 세션 마감 + 인계
|
|
280
|
+
\`\`\`bash
|
|
281
|
+
leerness session close . # handoff/current-state/task-log 자동 갱신
|
|
282
|
+
leerness audit . --fix # 누락 메타 자동 보강
|
|
283
|
+
leerness usage stats . # 이번 세션 명령 카운트 확인
|
|
284
|
+
\`\`\`
|
|
285
|
+
- session close가 누락되면 다음 세션 시작 시 drift critical 발생.
|
|
286
|
+
- 자동 회복 옵션: \`drift check --auto-fix\` (critical 시 session close 자동 실행).
|
|
287
|
+
|
|
288
|
+
---
|
|
289
|
+
|
|
290
|
+
## 빠른 체크리스트
|
|
291
|
+
|
|
292
|
+
세션 끝나기 전 다음이 모두 ✓이어야 한다:
|
|
293
|
+
- [ ] plan/progress-tracker에 이번 라운드 task 등록됨 (또는 task sync)
|
|
294
|
+
- [ ] 모든 done 항목에 evidence 첨부됨 (verify-claim PASS)
|
|
295
|
+
- [ ] sub-agent 사용 시 contract verify PASS
|
|
296
|
+
- [ ] drift 점수 ≤ 30 (attention 이하)
|
|
297
|
+
- [ ] session close 호출됨
|
|
298
|
+
|
|
299
|
+
## Anti-pattern (drift 신호)
|
|
300
|
+
|
|
301
|
+
- ⚠ "작업 끝났으니 보고만 하고 끝" → session close 누락 → 다음 세션 drift critical
|
|
302
|
+
- ⚠ "TodoWrite만 갱신하고 leerness 안 씀" → \`task sync --from\` 또는 \`task add\` 필수
|
|
303
|
+
- ⚠ sub-agent 분배 시 파일 경로 미명시 → 동시 쓰기 충돌
|
|
304
|
+
- ⚠ "테스트 돌렸으니 PASS" 자기 보고만 → verify-claim --run-tests 미실행
|
|
305
|
+
- ⚠ contract verify 생략 → 사양 불일치 BUG가 사용자에게 노출
|
|
306
|
+
`),
|
|
232
307
|
'.harness/anti-lazy-work-policy.md': fm('anti-lazy-work-policy', ['완료 선언 전'], ['게으른 작업 방지 기준 변경'], `# Anti Lazy Work Policy\n\n## Rules\n1. **증거 없는 완료 금지**: \"완료\"를 선언하려면 progress-tracker의 evidence 컬럼에 명령 출력/테스트 결과/스크린샷 경로 등이 있어야 합니다.\n2. **빈 핸드오프 금지**: 세션 종료 시 session-handoff.md의 Completed/In Progress/Next Exact Step이 모두 비어 있으면 close가 \"insufficient\" 상태로 표시됩니다.\n3. **부분 구현 자기보고**: 완전 구현이 아니면 status를 \`incomplete\`로, Next Exact Step에 \"무엇을 추가해야 끝나는지\" 한 줄을 적습니다.\n4. **검증 기록**: typecheck/lint/test 결과를 review-evidence.md에 누적 기록합니다.\n5. **TODO 표지**: 코드에 \`TODO\`/\`FIXME\`/\`XXX\`를 새로 도입하면 progress-tracker에 동일 ID로 추적합니다.\n6. **거짓 완료 자동 감지**: \`leerness lazy detect\`는 다음을 자동 점검합니다.\n - progress-tracker에 done인데 evidence가 비어있는 row\n - session-handoff의 Completed가 비어있고 Next Exact Step도 비어있음\n - 코드에 새 TODO/FIXME 추가 + progress-tracker에 추적 항목 없음\n - test 명령 실행 흔적 없음 (review-evidence.md 또는 task-log.md에 명령 기록)\n`),
|
|
233
308
|
'.harness/rules.md': _rulesHeader() + '\n',
|
|
234
309
|
'.harness/session-handoff.md': fm('session-handoff', ['세션 시작','다음 작업 이어받기'], ['세션 종료'], `# Session Handoff\n\nLast generated: (자동)\n\n## Completed\n-\n\n## In Progress\n-\n\n## Incomplete / Waiting / On Hold / Blocked\n-\n\n## Dropped\n-\n\n## Verification\n-\n\n## Recommended Direction\n-\n\n## Next Exact Step\n-\n`),
|
|
@@ -1302,6 +1377,24 @@ function handoff(root) {
|
|
|
1302
1377
|
const cs = read(currentStatePath(root)).replace(/Updated: \d{4}-\d{2}-\d{2}/, `Updated: ${today()}`);
|
|
1303
1378
|
writeUtf8(currentStatePath(root), cs);
|
|
1304
1379
|
}
|
|
1380
|
+
// 1.9.39: handoff 출력 끝에 6단계 워크플로 가이드 자동 표시 (메인 에이전트가 매 세션 인지)
|
|
1381
|
+
if (!has('--no-workflow-guide') && !has('--compact') && process.env.LEERNESS_NO_WORKFLOW_GUIDE !== '1') {
|
|
1382
|
+
const isTty = process.stdout && process.stdout.isTTY;
|
|
1383
|
+
const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
|
|
1384
|
+
const b = s => isTty ? `\x1b[1m${s}\x1b[0m` : s;
|
|
1385
|
+
const d = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
|
|
1386
|
+
log('');
|
|
1387
|
+
log(cy('## 🛠 세션 워크플로 6단계 (1.9.39+, AI 하네스 엔지니어링)'));
|
|
1388
|
+
log(d(' 상세: ') + cy('.harness/session-workflow.md'));
|
|
1389
|
+
log(` 1. ${b('요청 분석')} handoff(이미 완료) · drift check · 모호하면 명확화`);
|
|
1390
|
+
log(` 2. ${b('계획 수립')} plan add / TodoWrite · reuse-map으로 기존 자원 우선`);
|
|
1391
|
+
log(` 3. ${b('업무 분배')} agents list/recommend · 작업유형별 sub-agent 매핑`);
|
|
1392
|
+
log(` 4. ${b('sub-agent 작업')} 파일 경로 격리 · mtime 검증 의무 · 자체 테스트`);
|
|
1393
|
+
log(` 5. ${b('종합 검증')} contract verify · verify-claim --run-tests · review --persona`);
|
|
1394
|
+
log(` 6. ${b('세션 마감')} session close · audit --fix · usage stats`);
|
|
1395
|
+
log(d(' 끄려면: --no-workflow-guide 또는 LEERNESS_NO_WORKFLOW_GUIDE=1'));
|
|
1396
|
+
log('');
|
|
1397
|
+
}
|
|
1305
1398
|
ok('handoff loaded; current-state updated');
|
|
1306
1399
|
}
|
|
1307
1400
|
|
|
@@ -1479,6 +1572,24 @@ function handoffCmd(root) {
|
|
|
1479
1572
|
if (ptAge !== null && ptAge > threshold) log(dim(` progress-tracker: ${ptAge.toFixed(1)}일 stale`));
|
|
1480
1573
|
log(dim(` → 권장: ${red('leerness session close .')} 또는 ${red('leerness drift check .')} 로 상세 보기`));
|
|
1481
1574
|
if (skipCount >= 5) log(dim(` (학습: skip ${skipCount}회 누적 → 임계 ${threshold}일로 완화)`));
|
|
1575
|
+
// 1.9.39: --auto-recover — drift 감지 시 inline 자동 회복
|
|
1576
|
+
if (has('--auto-recover') && sevStale) {
|
|
1577
|
+
log(dim(` 🔧 --auto-recover 활성 — session close 자동 실행 중...`));
|
|
1578
|
+
try {
|
|
1579
|
+
const r = cp.spawnSync(process.execPath, [__filename, 'session', 'close', absR0], { encoding: 'utf8', timeout: 60000 });
|
|
1580
|
+
if (r.status === 0) {
|
|
1581
|
+
log(dim(` ✓ session close 자동 완료 (다음 라운드부터 healthy)`));
|
|
1582
|
+
const s2 = _readUsageStats(absR0);
|
|
1583
|
+
s2.drift = s2.drift || {};
|
|
1584
|
+
s2.drift.autoResolved = (s2.drift.autoResolved || 0) + 1;
|
|
1585
|
+
writeUtf8(_usageStatsPath(absR0), JSON.stringify(s2, null, 2) + '\n');
|
|
1586
|
+
} else {
|
|
1587
|
+
log(dim(` ⚠ auto-recover 실패 (exit ${r.status})`));
|
|
1588
|
+
}
|
|
1589
|
+
} catch (e) {
|
|
1590
|
+
log(dim(` ⚠ auto-recover 오류: ${e.message}`));
|
|
1591
|
+
}
|
|
1592
|
+
}
|
|
1482
1593
|
log('');
|
|
1483
1594
|
// 1.9.38 (A): critical 시 .harness/agent-reminders.md 자동 생성 — 다음 세션 시작 시 메인 에이전트가 읽도록.
|
|
1484
1595
|
if (sevStale) {
|
|
@@ -5386,6 +5497,33 @@ function driftCheckCmd(root, opts = {}) {
|
|
|
5386
5497
|
writeUtf8(p, JSON.stringify(stats, null, 2) + '\n');
|
|
5387
5498
|
}
|
|
5388
5499
|
} catch {}
|
|
5500
|
+
// 1.9.39: --auto-fix — critical 시 session close 자동 실행
|
|
5501
|
+
const autoFix = has('--auto-fix');
|
|
5502
|
+
if (autoFix && level === '🔴 critical') {
|
|
5503
|
+
log('');
|
|
5504
|
+
log(`🔧 --auto-fix 활성 — session close 자동 실행 중...`);
|
|
5505
|
+
try {
|
|
5506
|
+
const r = cp.spawnSync(process.execPath, [__filename, 'session', 'close', root], { encoding: 'utf8', timeout: 60000 });
|
|
5507
|
+
if (r.status === 0) {
|
|
5508
|
+
log(`✓ session close 자동 완료`);
|
|
5509
|
+
// autoResolved 카운트
|
|
5510
|
+
const stats = _readUsageStats(root);
|
|
5511
|
+
stats.drift = stats.drift || {};
|
|
5512
|
+
stats.drift.autoResolved = (stats.drift.autoResolved || 0) + 1;
|
|
5513
|
+
const p = _usageStatsPath(root);
|
|
5514
|
+
mkdirp(path.dirname(p));
|
|
5515
|
+
writeUtf8(p, JSON.stringify(stats, null, 2) + '\n');
|
|
5516
|
+
// 재검사
|
|
5517
|
+
log('');
|
|
5518
|
+
log(`재검사 중...`);
|
|
5519
|
+
return driftCheckCmd(root); // 재귀 1회 (auto-fix 없이)
|
|
5520
|
+
} else {
|
|
5521
|
+
log(`⚠ session close 실패 (exit ${r.status}) — 수동 실행 필요`);
|
|
5522
|
+
}
|
|
5523
|
+
} catch (e) {
|
|
5524
|
+
log(`⚠ auto-fix 오류: ${e.message}`);
|
|
5525
|
+
}
|
|
5526
|
+
}
|
|
5389
5527
|
if (has('--json')) {
|
|
5390
5528
|
log(JSON.stringify({ root, score: totalScore, level, signals, fired, appsZeroTask }, null, 2));
|
|
5391
5529
|
return;
|
package/package.json
CHANGED
package/scripts/e2e.js
CHANGED
|
@@ -950,6 +950,60 @@ total++;
|
|
|
950
950
|
if (!ok) { failed++; console.log(r.stdout.slice(0, 800)); }
|
|
951
951
|
}
|
|
952
952
|
|
|
953
|
+
// 1.9.39 회귀: session workflow 가이드 + auto-fix + auto-recover
|
|
954
|
+
total++;
|
|
955
|
+
{
|
|
956
|
+
// handoff 끝에 워크플로 6단계 가이드 자동 표시
|
|
957
|
+
const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-wf-'));
|
|
958
|
+
cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
|
|
959
|
+
const r = cp.spawnSync(process.execPath, [CLI, 'handoff', tmpC, '--no-drift-check'], { encoding: 'utf8', timeout: 15000 });
|
|
960
|
+
const ok = r.status === 0
|
|
961
|
+
&& /세션 워크플로 6단계/.test(r.stdout)
|
|
962
|
+
&& /1\. 요청 분석/.test(r.stdout)
|
|
963
|
+
&& /6\. 세션 마감/.test(r.stdout);
|
|
964
|
+
console.log(ok ? '✓ B(1.9.39) handoff: 6단계 워크플로 가이드 자동 표시' : `✗ workflow guide 실패`);
|
|
965
|
+
if (!ok) { failed++; console.log(r.stdout.slice(-500)); }
|
|
966
|
+
}
|
|
967
|
+
|
|
968
|
+
total++;
|
|
969
|
+
{
|
|
970
|
+
// session-workflow.md 파일이 init 시 생성
|
|
971
|
+
const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-wf2-'));
|
|
972
|
+
cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
|
|
973
|
+
const wfFile = path.join(tmpC, '.harness', 'session-workflow.md');
|
|
974
|
+
const ok = fs.existsSync(wfFile)
|
|
975
|
+
&& /6단계/.test(fs.readFileSync(wfFile, 'utf8'))
|
|
976
|
+
&& /sub-agent/.test(fs.readFileSync(wfFile, 'utf8'));
|
|
977
|
+
console.log(ok ? '✓ B(1.9.39) .harness/session-workflow.md init 시 자동 생성' : `✗ workflow 파일 실패`);
|
|
978
|
+
if (!ok) { failed++; if (fs.existsSync(wfFile)) console.log(fs.readFileSync(wfFile, 'utf8').slice(0, 300)); else console.log('파일 없음'); }
|
|
979
|
+
}
|
|
980
|
+
|
|
981
|
+
total++;
|
|
982
|
+
{
|
|
983
|
+
// AGENTS.md / CLAUDE.md에 session-workflow.md 참조 포함
|
|
984
|
+
const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-wf3-'));
|
|
985
|
+
cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
|
|
986
|
+
const agentsBody = fs.readFileSync(path.join(tmpC, 'AGENTS.md'), 'utf8');
|
|
987
|
+
const claudeBody = fs.readFileSync(path.join(tmpC, 'CLAUDE.md'), 'utf8');
|
|
988
|
+
const ok = /session-workflow\.md/.test(agentsBody) && /session-workflow\.md/.test(claudeBody);
|
|
989
|
+
console.log(ok ? '✓ B(1.9.39) AGENTS/CLAUDE 템플릿에 session-workflow.md 참조' : `✗ 인스트럭션 통합 실패`);
|
|
990
|
+
if (!ok) { failed++; }
|
|
991
|
+
}
|
|
992
|
+
|
|
993
|
+
total++;
|
|
994
|
+
{
|
|
995
|
+
// drift check --auto-fix: critical 시 session close 자동 실행 (시뮬은 어려우니 옵션 인식만)
|
|
996
|
+
const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-af-'));
|
|
997
|
+
cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
|
|
998
|
+
// --auto-fix 플래그 인식 (healthy 상태에서도 명령 자체는 정상 종료)
|
|
999
|
+
const r = cp.spawnSync(process.execPath, [CLI, 'drift', 'check', tmpC, '--auto-fix'], { encoding: 'utf8', timeout: 30000 });
|
|
1000
|
+
const ok = r.status === 0
|
|
1001
|
+
&& /leerness drift check/.test(r.stdout)
|
|
1002
|
+
&& /(healthy|attention|warning|critical)/.test(r.stdout);
|
|
1003
|
+
console.log(ok ? '✓ B(1.9.39) drift check --auto-fix 옵션 인식 + healthy fallthrough' : `✗ --auto-fix 실패`);
|
|
1004
|
+
if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
|
|
1005
|
+
}
|
|
1006
|
+
|
|
953
1007
|
// 1.9.38 회귀: usage stats, task sync, drift reminder, drift skip learning
|
|
954
1008
|
total++;
|
|
955
1009
|
{
|