leerness 1.36.6 → 1.36.7

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.36.7 — 2026-07-09 — handoff 넛지: 세션-시작 리추얼 사각지대 메꿈 (메타-테스트 도그푸드)
+
+**자기 행동 실측(세션 트랜스크립트 파싱)에서 드러난 사각지대를 leerness 기능으로 메꿈.** "세션이 길수록 leerness를 덜 참조하는가?" 가설을 트랜스크립트로 측정 → **반박**(workspace 사용은 세션 길이가 아니라 작업 종류에 종속). 단 실재 gap 1건: **compaction/resume 직후 세션-시작 `leerness handoff`를 건너뜀**(요약이 "resume mid-task"를 지시). 그 신호는 handoff 출력에만 떴는데 정작 handoff 를 안 돌리는 게 문제.
+
+- 신규: `_handoffNudgeState`/`_emitHandoffNudge` — `task add`/`decision add`(에이전트가 작업 중 실제로 실행하는 명령) 시, 마지막 handoff 가 오래됨(gap > 120분)이면 **한 줄 넛지**: `⚠ 마지막 handoff N시간 전 — 'leerness handoff .' 권장`.
+- FP 가드: **기록 있음 + gap > 임계**일 때만(신규 프로젝트=last-handoff.json 부재 → 넛지 안 함). `--json`/`--quiet` 오염 없음. opt-out `LEERNESS_NO_HANDOFF_NUDGE=1`.
+- 정본 `_getLastHandoffGap` 재사용(스키마 일관). selftest 281(행위: 오래됨→넛지·최근/부재→없음·opt-out) + e2e 통과.
+
 ## 1.36.6 — 2026-07-09 — 정직성 백로그 소진: 강제력/종합-health 문구 정직화 (심층 감사 P2/P3 후속)
 
 **1.36.5 심층 정직성 감사가 확인했으나 미수정으로 남긴 P2/P3 강제력·과장 문구를 정직화.**

package/README.md

@@ -125,7 +125,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.36.6 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.36.7 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -179,7 +179,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.36.6는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
+Leerness v1.36.7는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -200,7 +200,7 @@ Leerness v1.36.6는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 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) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.36.6)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.36.7)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -238,6 +238,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.36.6: 2026-07-09
+Last synced by Leerness v1.36.7: 2026-07-09
 <!-- leerness:project-readme:end -->
 

package/bin/leerness.js

@@ -33,7 +33,7 @@ const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInG
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _TOOL_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, REQUIRED_WORKSPACE_FILES, KEYWORD_STOPWORDS, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344/368/369 (UR-0025): catalog 분리 · 1.11.4 (UR-0007): _TOOL_CATALOG
 const { findCorruptedStateJson: _findCorruptedStateJson } = require('../lib/state-integrity');  // 1.36.1 (클린룸 리뷰 FN): .harness/*.json 상태 무결성 (audit/health/check 공유)
 
-const VERSION = '1.36.6';
+const VERSION = '1.36.7';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3973,6 +3973,26 @@ function _selfTestCases() {
       const policyHonest = self.includes('실제 셸 실행을 가로채진 않음'); // policy enforce: 차단 판정이 실행 가로채기 아님을 명시
       return tokenHonest && idHonest && policyHonest;
     } },
+    { name: 'handoff 넛지 (1.36.7, 메타-테스트 도그푸드): 오래된 handoff→넛지 · 최근/부재→없음 · opt-out 존중 (행위)', run: () => {
+      const os = require('os');
+      const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'lz-hn-'));
+      const hd = path.join(dir, '.harness'); fs.mkdirSync(hd);
+      const lhf = path.join(hd, 'last-handoff.json');
+      const iso = (msAgo) => new Date(Date.now() - msAgo).toISOString();
+      try {
+        const noneOk = _handoffNudgeState(dir) === null;                                 // 부재 → 넛지 없음(신규 프로젝트 FP 방지)
+        fs.writeFileSync(lhf, JSON.stringify({ last: iso(3 * 3600 * 1000), history: [iso(3 * 3600 * 1000)] }));
+        const st = _handoffNudgeState(dir);
+        const staleOk = !!st && st.gapMin >= 120;                                        // 3h 오래됨 → 넛지
+        fs.writeFileSync(lhf, JSON.stringify({ last: iso(5 * 60 * 1000), history: [iso(5 * 60 * 1000)] }));
+        const freshOk = _handoffNudgeState(dir) === null;                                // 5min 최근 → 없음
+        process.env.LEERNESS_NO_HANDOFF_NUDGE = '1';
+        fs.writeFileSync(lhf, JSON.stringify({ last: iso(3 * 3600 * 1000), history: [] }));
+        const optOutOk = _handoffNudgeState(dir) === null;                               // opt-out 존중
+        delete process.env.LEERNESS_NO_HANDOFF_NUDGE;
+        return noneOk && staleOk && freshOk && optOutOk;
+      } finally { try { fs.rmSync(dir, { recursive: true, force: true }); } catch { /* ignore */ } }
+    } },
     { name: 'CLI 영어화 Phase 1 (1.20.2, UR-0010): _uiLang 해석(flag>env>manifest>ko) + 첫화면 _t 적용 (행위+소스)', run: () => {
       const save = process.argv; const saveEnv = process.env.LEERNESS_LANG;
       try {
@@ -7000,6 +7020,29 @@ function _getLastHandoffGap(root) {
     return { hasLast: true, lastAt: j.last, gapMin, expected, isMiss, isLong, history: j.history || [] };
   } catch { return { hasLast: false }; }
 }
+// 1.36.7 (메타-테스트 도그푸드): 세션에서 작업 중(task/decision add)인데 handoff 가 오래됨/미실행이면 넛지.
+//   실측(트랜스크립트)에서 확인된 사각지대: compaction/resume 후 세션-시작 handoff 리추얼을 건너뜀 → 컨텍스트 미적재.
+//   그 신호는 handoff 출력에만 떴는데 정작 handoff 를 안 돌리는 게 문제라, 에이전트가 실제로 실행하는 명령에 넛지를 노출.
+//   FP 가드: 기록 있음 + gap > 임계(기본 120분)일 때만(신규 프로젝트=기록 없음 → 넛지 안 함). opt-out: LEERNESS_NO_HANDOFF_NUDGE=1.
+const HANDOFF_NUDGE_MIN = 120;
+function _handoffNudgeState(root, thresholdMin = HANDOFF_NUDGE_MIN) {
+  if (process.env.LEERNESS_NO_HANDOFF_NUDGE === '1') return null;
+  try {
+    const g = _getLastHandoffGap(root);
+    if (g && g.hasLast && g.gapMin > thresholdMin) return { gapMin: g.gapMin };
+  } catch {}
+  return null;
+}
+function _emitHandoffNudge(root) {
+  if (has('--json') || has('--quiet')) return;   // 구조화/조용 모드 오염 방지
+  const s = _handoffNudgeState(root);
+  if (!s) return;
+  const L = _uiLang(root); const tt = (ko, en) => (L === 'en' ? en : ko);
+  const koAge = s.gapMin < 120 ? `${s.gapMin}분` : `${Math.floor(s.gapMin / 60)}시간`;
+  const enAge = s.gapMin < 120 ? `${s.gapMin}min` : `${Math.floor(s.gapMin / 60)}h`;
+  log(tt(`  ⚠ 마지막 handoff ${koAge} 전 — 이 세션 컨텍스트 최신화를 위해 'leerness handoff .' 권장 (끄기: LEERNESS_NO_HANDOFF_NUDGE=1)`,
+    `  ⚠ last handoff ${enAge} ago — run 'leerness handoff .' to refresh this session's context (off: LEERNESS_NO_HANDOFF_NUDGE=1)`));
+}
 
 // 1.9.198: B축 (멀티 Sub-Agent 오케스트라) 보강 — handoff 에서 task keyword 매칭 best agent 추천
 //   1.9.193 에서 agents multi --execute 결과를 lessons.md 에 기록 → 이를 keyword 매칭하여 추출
@@ -7701,6 +7744,7 @@ function taskAdd(root, text) {
   if (has('--json')) { log(JSON.stringify({ ok: true, id, status: _normTaskStatus(arg('--status', 'requested')), request: text })); return; }
   ok(`task added: ${id}`);
   _autoRoadmap(absRoot(root), 'data-change');
+  _emitHandoffNudge(root);   // 1.36.7: 세션 handoff 미실행/오래됨 넛지 (compaction/resume 사각지대)
   // 1.9.177: task add 자동 review-request trigger (사용자 명시 1.9.176 자동화).
   //   사용자가 task 추가 시 자동으로 사전 검토 — 충돌/재사용/효율/권장 단계 결과를 등록 직후 표시.
   //   opt-out: --no-review 또는 env LEERNESS_NO_AUTO_REVIEW=1, 또는 status=in-progress/done 같은 운영 메타.
@@ -8192,6 +8236,7 @@ function decisionAdd(root, title) {
   ok(`decision added: ${title}`);
   // 1.9.43+ handoff lessons 회수 흐름과 자동 통합 (decisions.md fuzzy 매칭됨)
   _autoRoadmap(absRoot(root), 'data-change');
+  _emitHandoffNudge(root);   // 1.36.7: 세션 handoff 미실행/오래됨 넛지 (compaction/resume 사각지대)
 }
 
 // 1.9.6: 옛 link 손실 row를 plan.md milestone과 자동 매칭 제안/복구.
@@ -21178,5 +21223,6 @@ module.exports = {
   _vcImplIsEmpty, _VC_EMPTY_SHELL_RE,
   // 1.18.3 (UR-0003): 분야별 자기질문 품질 렌즈 — 단위 테스트. 1.19.2: 파일→도메인 매핑(완료-검증 advisory)
   LENS_CATALOG, lensCmd, _lensDomainsForFiles, _mergeLensCatalog, _loadProjectLenses, _effectiveLensCatalog,
-  _isDbContentText, _anyDbContentInFiles, _withDbDomain
+  _isDbContentText, _anyDbContentInFiles, _withDbDomain,
+  _handoffNudgeState, _getLastHandoffGap, _recordLastHandoff
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.36.6",
+  "version": "1.36.7",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",