leerness 1.9.36 → 1.9.37

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 1.9.37 — 2026-05-18
+
+**메인 에이전트의 "leerness 점점 안 쓰는" drift 현상 자동 감지·경고**.
+
+### 배경
+실 워크스페이스 분석 결과: 라운드가 길어질수록 메인 에이전트가 `session close` / `task add` 등을 점점 잊는 패턴 발견.
+- session-handoff.md 4.6일 stale
+- task-log.md 4.6일 stale
+- progress-tracker T-row 3일간 0건 업데이트
+- 신규 sub-app 4개에 task 0건 등록
+
+→ **drift score 100/200 (🔴 critical) 등급**. 사용자 우려 사실 확인.
+
+### Added
+
+- **`leerness drift check [path]`** 신규 명령:
+  - 4개 신호 측정: session-handoff.md, current-state.md, progress-tracker.md, task-log.md의 staleness
+  - 추가 신호: `_apps/*` 중 task 0건인 sub-project 수
+  - 가중치 합계 → 4단계 레벨 (🟢 healthy / 🟠 attention / 🟡 warning / 🔴 critical)
+  - 임계 0/20/50/100. 점수 ≥100 시 exit 1 (CI 친화)
+  - `--json` 출력 지원
+  - 권장 조치 자동 안내 (`session close` / `audit --fix` / `task add`)
+- **`handoff` 자동 drift 경고** — handoff 호출 시 빠른 inline check (전체 `drift check` 안 호출). session-handoff/progress-tracker 중 하나라도 2일 이상 stale이면 노랑색 경고 + 권장 명령 안내.
+- **스킵 옵션**: `--no-drift-check` 플래그 + `LEERNESS_NO_DRIFT_CHECK=1` 환경변수
+
+### 실측 (이번 라운드)
+- 실 워크스페이스: drift 100/200 (critical) → `session close` 1회 후 30/200 (attention)
+- e2e: 170/170 PASS (1.9.36 166 + 신규 4)
+
+### 정책
+- ✅ drift 경고는 *알림만* — 자동 실행 금지 (사용자/메인이 명시적 선택)
+- ✅ 빠른 inline check (handoff) vs 상세 보고 (`drift check`) 분리
+- ✅ CI 친화: `--no-drift-check` 또는 env로 끄기 가능
+
 ## 1.9.36 — 2026-05-18
 
 **외부 AI CLI 오케스트레이션 강화: dispatch 안전 모드 + agents bench + 작업 유형 추천 + stress test에서 발견한 2 BUG 즉시 수정**.

package/README.md

@@ -2,7 +2,7 @@
 
 > **AI 에이전트 검수·다중 협업 CLI 하네스** — 거짓 완료 차단, 멀티 에이전트 오케스트레이션, 사양 ↔ 구현 일치 검증, 워크스페이스 통합 가시성. **한국어 우선**.
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.36-green)]() [![tests](https://img.shields.io/badge/e2e-166%2F166-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.37-green)]() [![tests](https://img.shields.io/badge/e2e-170%2F170-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 > Claude Code · Cursor · Copilot · Codex · Gemini CLI — 어떤 AI 에이전트로 코드를 짜든, leerness는 **"진짜로 했나? 중복 아닌가? 합의된 사양인가?"** 를 자동으로 검수합니다.
 
@@ -42,6 +42,7 @@ AI 에이전트(Claude Code, Cursor, Copilot, Codex, Gemini CLI 등)는 **빠르
 | 🚨 신규 모듈의 capability가 reuse-map에 등록 안 됨 | **`leerness reuse autodetect`** — `module.exports` 스캔 + 자동 등록 (1.9.35) |
 | 🚨 신규 디렉토리에서 sub-agent가 컨텍스트 없이 작업 시작 | `handoff` 호출 시 **.harness 부재 자동 경고** (1.9.35) |
 | 🚨 audit warning이 쌓이지만 수동 fix가 번거로움 | **`audit --fix`** — session-handoff/current-state 자동 갱신 (1.9.35) |
+| 🚨 **프로젝트가 길어질수록 메인 에이전트가 leerness를 점점 안 씀** (메타파일 stale, session close 누락) | **`leerness drift check`** — 4개 신호로 staleness 측정 + handoff 시 자동 경고 (1.9.37) |
 
 ---
 
@@ -471,6 +472,7 @@ npm test     # = node ./scripts/e2e.js
 
 ## 📜 변경 이력 (최근)
 
+- **1.9.37** — `leerness drift check` — 라운드가 길어질수록 메인 에이전트가 leerness를 점점 안 쓰는 현상 자동 감지. handoff 시 자동 경고 + 4단계 레벨 (healthy/attention/warning/critical) + 권장 조치 안내. 실 워크스페이스에서 4.6일 stale, drift 100/200 (critical) 발견 → session close 1회로 30/200 (attention) 회복 실증.
 - **1.9.36** — 외부 AI CLI 오케스트레이션 강화: `agents bench` (3 CLI 동시 비교) + `dispatch --write` 자동 권장 플래그 + 작업 유형 키워드 추천. stress test에서 발견한 `contract verify` require() side-effect (보안 위험 + 25× 속도 회복) 즉시 수정.
 - **1.9.35** — 파이프라인 메타-감사에서 도출된 5개 개선 통합: `contract verify` · `reuse autodetect` · `audit --fix` · `handoff` init 부재 경고 · `agents dispatch` 안전 규칙 안내.
 - **1.9.34** — 방향키/스페이스 인터랙티브 multi-select (`_selectOne`/`_selectMany`) + 256색 그라데이션 배너 + 3단계 sub-agent 오케스트레이션 검증 (2.2× 효율 실측).

package/bin/harness.js

@@ -6,7 +6,7 @@ const path = require('path');
 const cp = require('child_process');
 const readline = require('readline');
 
-const VERSION = '1.9.36';
+const VERSION = '1.9.37';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -1432,6 +1432,38 @@ function handoffCmd(root) {
   if (has('--all-apps') || arg('--include', null)) {
     return _handoffWorkspace(absRoot(root));
   }
+  // 1.9.37: drift 자동 경고 (메인 에이전트가 leerness를 점점 안 쓰는 현상 감지)
+  const absR0 = absRoot(root || process.cwd());
+  if (exists(path.join(absR0, '.harness')) && !has('--no-drift-check') && process.env.LEERNESS_NO_DRIFT_CHECK !== '1') {
+    try {
+      const isTty = process.stdout && process.stdout.isTTY;
+      const yel = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+      const red = s => isTty ? `\x1b[31m${s}\x1b[0m` : s;
+      const dim = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+      // 간이 drift 계산 (전체 driftCheckCmd 호출 안 함 — 빠른 inline check)
+      const now = Date.now();
+      const shPath = handoffPath(absR0);
+      let shAge = null;
+      if (exists(shPath)) {
+        const m = read(shPath).match(/Last generated:\s*([\d\-T:.Z]+)/);
+        if (m) shAge = (now - new Date(m[1]).getTime()) / 86400000;
+      }
+      const rows = readProgressRows(absR0);
+      let ptAge = null;
+      if (rows.length) {
+        const dates = rows.map(r => (r.updated || '').match(/\d{4}-\d{2}-\d{2}/)).filter(Boolean).map(m => m[0]).sort();
+        if (dates.length) ptAge = (now - new Date(dates[dates.length - 1]).getTime()) / 86400000;
+      }
+      if ((shAge !== null && shAge > 2) || (ptAge !== null && ptAge > 2)) {
+        log('');
+        log(yel('  ⚠ leerness drift 감지 — 메타파일이 stale합니다'));
+        if (shAge !== null && shAge > 2) log(dim(`     session-handoff.md: ${shAge.toFixed(1)}일 stale`));
+        if (ptAge !== null && ptAge > 2) log(dim(`     progress-tracker:   ${ptAge.toFixed(1)}일 stale`));
+        log(dim(`     → 권장: ${red('leerness session close .')} 또는 ${red('leerness drift check .')} 로 상세 보기`));
+        log('');
+      }
+    } catch {}
+  }
   // 1.9.35 개선 #1: .harness 부재 시 즉시 경고 (자동 init 권장)
   // 사용자가 신규 디렉토리에서 handoff 호출 시 sub-agent 작업이 길을 잃지 않도록.
   const absR = absRoot(root || process.cwd());
@@ -5218,6 +5250,122 @@ function viewworkInstall(root) {
   ok('claude .claude/settings.local.json updated (Stop hook adds a viewwork event)');
 }
 
+// 1.9.37: drift detection — 메타파일 staleness 측정으로 "leerness 점점 안 쓰는" 현상 감지
+function driftCheckCmd(root, opts = {}) {
+  root = absRoot(root || process.cwd());
+  const now = Date.now();
+  const _ageDays = (p) => {
+    if (!exists(p)) return null;
+    return (now - fs.statSync(p).mtimeMs) / 86400000;
+  };
+  // 각 메타파일의 마지막 갱신
+  const signals = [];
+  // 1. session-handoff.md - "Last generated" 라인 우선, 없으면 mtime
+  const shPath = handoffPath(root);
+  if (exists(shPath)) {
+    const txt = read(shPath);
+    const m = txt.match(/Last generated:\s*([\d\-T:.Z]+)/);
+    let ageDays;
+    if (m) {
+      ageDays = (now - new Date(m[1]).getTime()) / 86400000;
+    } else {
+      ageDays = _ageDays(shPath);
+    }
+    signals.push({ file: 'session-handoff.md', ageDays, threshold: 1, weight: 30, label: 'session close 누락' });
+  }
+  // 2. current-state.md - "Updated: YYYY-MM-DD" 라인
+  const csPath = currentStatePath(root);
+  if (exists(csPath)) {
+    const m = read(csPath).match(/Updated:\s*(\d{4}-\d{2}-\d{2})/);
+    const ageDays = m ? (now - new Date(m[1]).getTime()) / 86400000 : _ageDays(csPath);
+    signals.push({ file: 'current-state.md', ageDays, threshold: 2, weight: 20, label: 'current-state 갱신 없음' });
+  }
+  // 3. progress-tracker.md 마지막 row의 updated 컬럼
+  const rows = readProgressRows(root);
+  if (rows.length) {
+    const dates = rows.map(r => (r.updated || '').match(/\d{4}-\d{2}-\d{2}/)).filter(Boolean).map(m => m[0]);
+    if (dates.length) {
+      dates.sort();
+      const latest = dates[dates.length - 1];
+      const ageDays = (now - new Date(latest).getTime()) / 86400000;
+      signals.push({ file: 'progress-tracker.md', ageDays, threshold: 1, weight: 30, label: 'task update 없음' });
+    }
+  } else {
+    signals.push({ file: 'progress-tracker.md', ageDays: 999, threshold: 1, weight: 25, label: 'progress-tracker 비어있음' });
+  }
+  // 4. task-log.md 마지막 entry "## YYYY-MM-DD"
+  const tlPath = taskLogPath(root);
+  if (exists(tlPath)) {
+    const dates = Array.from(read(tlPath).matchAll(/^## (\d{4}-\d{2}-\d{2})/gm)).map(m => m[1]);
+    if (dates.length) {
+      dates.sort();
+      const latest = dates[dates.length - 1];
+      const ageDays = (now - new Date(latest).getTime()) / 86400000;
+      signals.push({ file: 'task-log.md', ageDays, threshold: 2, weight: 20, label: 'task-log 갱신 없음' });
+    }
+  }
+  // 점수 계산
+  let totalScore = 0;
+  const fired = [];
+  for (const s of signals) {
+    if (s.ageDays > s.threshold) {
+      totalScore += s.weight;
+      fired.push(s);
+    }
+  }
+  // 신규 _apps/* 에서 task 0건도 신호로
+  const appsDir = path.join(root, '_apps');
+  let appsZeroTask = [];
+  if (exists(appsDir)) {
+    for (const d of fs.readdirSync(appsDir)) {
+      const sub = path.join(appsDir, d);
+      if (!exists(path.join(sub, '.harness'))) continue;
+      const subRows = readProgressRows(sub);
+      if (!subRows.length) appsZeroTask.push(d);
+    }
+    if (appsZeroTask.length) {
+      const w = Math.min(50, appsZeroTask.length * 10);
+      totalScore += w;
+      fired.push({ file: `_apps/* (${appsZeroTask.length}개)`, ageDays: null, threshold: 0, weight: w, label: `task 0건 sub-app: ${appsZeroTask.slice(0, 3).join(', ')}${appsZeroTask.length > 3 ? '...' : ''}` });
+    }
+  }
+  // 레벨 판정
+  let level = '🟢 healthy';
+  if (totalScore >= 100) level = '🔴 critical';
+  else if (totalScore >= 50) level = '🟡 warning';
+  else if (totalScore >= 20) level = '🟠 attention';
+
+  if (has('--json')) {
+    log(JSON.stringify({ root, score: totalScore, level, signals, fired, appsZeroTask }, null, 2));
+    return;
+  }
+  log(`# leerness drift check (1.9.37)`);
+  log(`경로: ${root}`);
+  log('');
+  log(`상태: ${level}  ·  점수 ${totalScore}/200`);
+  log('');
+  log(`| 신호 | age | 임계 | 가중치 | 발화 |`);
+  log(`|---|---:|---:|---:|---|`);
+  for (const s of signals) {
+    const fire = s.ageDays > s.threshold ? '🔥' : '✓';
+    const age = s.ageDays === null ? '-' : `${s.ageDays.toFixed(1)}d`;
+    log(`| ${s.label} | ${age} | ${s.threshold}d | ${s.weight} | ${fire} |`);
+  }
+  if (appsZeroTask.length) {
+    log('');
+    log(`task 0건 sub-app (${appsZeroTask.length}개): ${appsZeroTask.join(', ')}`);
+  }
+  if (totalScore >= 50) {
+    log('');
+    log(`💡 권장 조치:`);
+    log(`  - 즉시: leerness session close .                (handoff/current-state 갱신)`);
+    log(`  - 또는: leerness audit . --fix                  (자동 갱신 가능 항목 적용)`);
+    log(`  - sub-app에 task 등록: cd _apps/X && leerness task add "..."`);
+    log(`  - 이 검사 끄기: --no-drift-check 또는 LEERNESS_NO_DRIFT_CHECK=1`);
+  }
+  if (level === '🔴 critical') process.exitCode = 1;
+}
+
 // 1.9.35 개선 #3: contract verify <spec.md> <impl.js>
 // 사양 문서(spec.md)에 명시된 함수 이름이 실제 module.exports에 모두 있는지 검사.
 // 사용 예: leerness contract verify TICK_SPEC.md src/format.js
@@ -5410,6 +5558,7 @@ async function main() {
   if (cmd === 'review') return reviewCmd(arg('--path', process.cwd()), args[1]);
   if (cmd === 'agents') return agentsCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   if (cmd === 'contract' && args[1] === 'verify') return contractVerifyCmd(args[2], args[3]);
+  if (cmd === 'drift' && (args[1] === 'check' || !args[1])) return driftCheckCmd(args[2] || arg('--path', process.cwd()));
   if (cmd === 'reuse' && args[1] === 'autodetect') return reuseAutodetectCmd(args[2] || arg('--path', process.cwd()));
   if (cmd === 'setup-agents' || cmd === 'setup' && args[1] === 'agents') return await setupAgentsCmd(args[1] && args[1] !== 'agents' ? args[1] : (args[2] || process.cwd()));
   if (cmd === 'session' && args[1] === 'close') { const r = sessionClose(args[2] || process.cwd()); viewworkEmit(args[2] || process.cwd(), { action: 'task', tool: 'session-close', note: 'session close' }); return r; }

package/package.json

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

package/scripts/e2e.js

@@ -950,6 +950,78 @@ total++;
   if (!ok) { failed++; console.log(r.stdout.slice(0, 800)); }
 }
 
+// 1.9.37 회귀: drift detection
+total++;
+{
+  // drift check: 신규 init 직후 (메타파일은 fresh) → healthy 또는 attention
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-drift-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  const r = cp.spawnSync(process.execPath, [CLI, 'drift', 'check', tmpC], { encoding: 'utf8', timeout: 15000 });
+  const ok = r.status === 0
+    && /leerness drift check \(1\.9\.37\)/.test(r.stdout)
+    && /(healthy|attention|warning)/.test(r.stdout);  // 막 init이라 critical은 안 됨
+  console.log(ok ? '✓ B(1.9.37) drift check: 신규 init → healthy/attention 등급' : `✗ drift check 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
+}
+
+total++;
+{
+  // drift check --json: 점수/신호 구조 검증
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-drift2-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  // 인공적으로 progress-tracker를 옛날 날짜로 만들기 어려우니 신호 갯수만 검증
+  const r = cp.spawnSync(process.execPath, [CLI, 'drift', 'check', tmpC, '--json'], { encoding: 'utf8', timeout: 15000 });
+  let parsed = null;
+  try { parsed = JSON.parse(r.stdout); } catch {}
+  const ok = parsed
+    && typeof parsed.score === 'number'
+    && typeof parsed.level === 'string'
+    && Array.isArray(parsed.signals)
+    && parsed.signals.length >= 3; // session-handoff/current-state/progress-tracker 최소
+  console.log(ok ? '✓ B(1.9.37) drift check --json: 점수/레벨/신호 구조' : `✗ drift --json 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
+}
+
+total++;
+{
+  // handoff 자동 drift 경고 — 인공 stale 시뮬 (session-handoff.md의 Last generated를 옛 날짜로)
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-drift3-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  // session-handoff.md에 옛 날짜 주입
+  const shPath = path.join(tmpC, '.harness', 'session-handoff.md');
+  if (fs.existsSync(shPath)) {
+    let body = fs.readFileSync(shPath, 'utf8');
+    const oldDate = new Date(Date.now() - 5 * 86400000).toISOString();
+    body = body.replace(/Last generated:.*/, `Last generated: ${oldDate}`);
+    if (!/Last generated:/.test(body)) body = `Last generated: ${oldDate}\n\n` + body;
+    fs.writeFileSync(shPath, body, 'utf8');
+  }
+  const r = cp.spawnSync(process.execPath, [CLI, 'handoff', tmpC, '--compact'], { encoding: 'utf8', timeout: 15000 });
+  const ok = /leerness drift 감지/.test(r.stdout) && /session close/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.37) handoff 자동 drift 경고: 5일 stale → 알림 표시' : `✗ handoff drift 경고 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
+}
+
+total++;
+{
+  // LEERNESS_NO_DRIFT_CHECK=1: 자동 경고 스킵
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-drift4-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--no-banner', '--no-stale-check', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  const shPath = path.join(tmpC, '.harness', 'session-handoff.md');
+  if (fs.existsSync(shPath)) {
+    const oldDate = new Date(Date.now() - 5 * 86400000).toISOString();
+    let body = fs.readFileSync(shPath, 'utf8');
+    body = body.replace(/Last generated:.*/, `Last generated: ${oldDate}`);
+    if (!/Last generated:/.test(body)) body = `Last generated: ${oldDate}\n\n` + body;
+    fs.writeFileSync(shPath, body, 'utf8');
+  }
+  const env = { ...process.env, LEERNESS_NO_DRIFT_CHECK: '1' };
+  const r = cp.spawnSync(process.execPath, [CLI, 'handoff', tmpC, '--compact'], { encoding: 'utf8', timeout: 15000, env });
+  const ok = !/leerness drift 감지/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.37) LEERNESS_NO_DRIFT_CHECK=1: 경고 스킵' : `✗ drift skip 실패`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 400)); }
+}
+
 // 1.9.36 회귀: dispatch 권장 플래그 + bench + 작업 유형 추천
 total++;
 {