leerness 1.9.206 → 1.9.207

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 1.9.207 — 2026-05-22
+
+**📥 사용자 요청 누락 확인 절차 MVP (사용자 명시).**
+
+### 사용자 명시
+> *"leerness가 적용된 프로젝트에서, 최근에 명령받아 진행한 것중에 누락된게 없는지 확인하는 절차도 있는지 확인해줘 / 다음 라운드시 참조"*
+
+### 1. `.harness/user-requests.json` — 사용자 요청 누적 기록
+- `_userRequestsPath/_loadUserRequests/_writeUserRequests` 파일 I/O 헬퍼
+- `_recordUserRequest(root, text, opts)` — 자동 ID 부여(UR-XXXX) + 중복 방지(동일 텍스트 + open 상태)
+- `_updateUserRequest(root, id, patch)` — status 전환 (open → in-progress → completed/dropped)
+- 최근 200개 유지 (rotate)
+
+### 2. `_auditUserRequests(root)` — 누락 후보 탐지
+- open/in-progress 요청 텍스트의 첫 12 단어 추출 → task-log/plan/decisions 와 비교
+- hits ≥ min(3, words×0.5) → **tracked** (어딘가 작업이 시작됨)
+- 그 외 → **missing** (누락 후보, AI/사용자가 잊은 가능성)
+- 7일+ open → **stale** (재검토 필요)
+
+### 3. `leerness requests <sub>` CLI (사용자 명시 — "확인 절차")
+- `audit` — missing/tracked/stale 보고 (--json 가능)
+- `add "<text>"` — 사용자 요청 수동 기록
+- `list [--status open|completed|dropped]` — 전체 출력
+- `complete <UR-id>` / `drop <UR-id>` — 상태 전환
+
+### 4. handoff 헤드라인 통합 (13번째 요소)
+- missing ≥ 1 시: `📥 미답 요청 N건` (red)
+- open > 0 (모두 tracked) 시: `📥 요청 N (tracked)` (green)
+- 헤드라인 라벨: `1.9.81/93/113/152/162/192/197/204/207`
+
+### 5. 누적 회귀 (1.9.200~206) — 모두 유지
+
+### 6. stress-v152 — 17/17 PASS
+- 1.9.207 (8) + 성능 (2) + 누적 회귀 (7)
+- 사용자 요청 라이프사이클 격리 tmpdir 테스트 (add → list → audit → complete → drop)
+- 중복 방지 확인
+- 성능: --version cold start avg 2206ms · MCP 54 도구 1597ms
+
+### 7. 자동 release (69 라운드 main-push streak · 30 라운드 npm publish streak)
+- `release sync-main` 자동 → main merge + npm publish leerness@1.9.207
+- 1.9.140부터 main 자동 push (69 라운드 무중단)
+- 1.9.178부터 npm publish (30 라운드 무중단)
+
+---
+
 ## 1.9.206 — 2026-05-22
 
 **🌐 i18n MVP + UI/UX 헬퍼 (사용자 명시 2종).**

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.206-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v151-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-136-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-68_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![i18n](https://img.shields.io/badge/i18n-ko%2Fen_MVP-success)]() [![perf](https://img.shields.io/badge/cold_start-1049ms-success)]() [![install](https://img.shields.io/badge/npm_i_leerness-즉시_사용_가능-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-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.207-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v152-17%2F17-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-54-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-137-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-69_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-98%2F100_(5축)-brightgreen)]() [![requests](https://img.shields.io/badge/requests-audit_누락확인-success)]() [![perf](https://img.shields.io/badge/cold_start-2206ms-success)]() [![install](https://img.shields.io/badge/npm_i_leerness-즉시_사용_가능-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.206  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.207  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🌐 i18n ko/en MVP · _typewrite/_ui UI/UX 헬퍼 (사용자 명시)        ║
+  ║  📥 사용자 요청 누락 확인 (requests audit) (사용자 명시)             ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

package/bin/harness.js

@@ -7,7 +7,7 @@ const cp = require('child_process');
 const os = require('os');  // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
 const readline = require('readline');
 
-const VERSION = '1.9.206';
+const VERSION = '1.9.207';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -1918,6 +1918,94 @@ function _analyzeWakeupStatus(root) {
   return { hasWakeup: true, latest, deltaMin, kind, pending: pending.length };
 }
 
+// 1.9.207: 사용자 요청 누락 확인 절차 — 사용자 명시
+//   "최근에 명령받아 진행한 것중에 누락된게 없는지 확인하는 절차도 있는지"
+//   .harness/user-requests.json 에 사용자 명시 요청을 누적 기록 → audit 시 task-log/plan/decisions 와 매칭 → 누락 보고
+//   레코드 구조: { id, text, recordedAt, status: 'open'|'in-progress'|'completed'|'dropped',
+//                  linkedTaskIds?, linkedPlanIds?, linkedDecisionIds?, notes?, completedAt?, droppedAt? }
+function _userRequestsPath(root) { return path.join(root, '.harness', 'user-requests.json'); }
+function _loadUserRequests(root) {
+  try {
+    const fp = _userRequestsPath(root);
+    if (!exists(fp)) return { requests: [] };
+    const j = JSON.parse(read(fp));
+    return { requests: Array.isArray(j.requests) ? j.requests : [] };
+  } catch { return { requests: [] }; }
+}
+function _writeUserRequests(root, requests) {
+  try {
+    mkdirp(path.join(root, '.harness'));
+    writeUtf8(_userRequestsPath(root), JSON.stringify({ requests, updatedAt: new Date().toISOString() }, null, 2));
+    return true;
+  } catch { return false; }
+}
+function _recordUserRequest(root, text, opts = {}) {
+  if (!text || typeof text !== 'string') return null;
+  const state = _loadUserRequests(root);
+  // 중복 방지: 동일 텍스트 + open 상태 이미 존재 시 skip
+  const norm = text.trim().slice(0, 500);
+  const dup = state.requests.find(r => r.text === norm && (r.status === 'open' || r.status === 'in-progress'));
+  if (dup) return dup;
+  const id = 'UR-' + String(state.requests.length + 1).padStart(4, '0');
+  const entry = {
+    id, text: norm, recordedAt: new Date().toISOString(),
+    status: opts.status || 'open',
+    linkedTaskIds: opts.linkedTaskIds || [],
+    linkedPlanIds: opts.linkedPlanIds || [],
+    linkedDecisionIds: opts.linkedDecisionIds || [],
+    notes: opts.notes || ''
+  };
+  state.requests.push(entry);
+  // 최근 200개만 유지
+  if (state.requests.length > 200) state.requests = state.requests.slice(-200);
+  _writeUserRequests(root, state.requests);
+  return entry;
+}
+function _updateUserRequest(root, id, patch) {
+  const state = _loadUserRequests(root);
+  const idx = state.requests.findIndex(r => r.id === id);
+  if (idx < 0) return null;
+  state.requests[idx] = { ...state.requests[idx], ...patch, updatedAt: new Date().toISOString() };
+  if (patch.status === 'completed' && !state.requests[idx].completedAt) state.requests[idx].completedAt = new Date().toISOString();
+  if (patch.status === 'dropped' && !state.requests[idx].droppedAt) state.requests[idx].droppedAt = new Date().toISOString();
+  _writeUserRequests(root, state.requests);
+  return state.requests[idx];
+}
+// audit: open/in-progress 요청 중 task-log 에 매칭되는 작업이 없는 항목을 "누락 후보"로 보고
+function _auditUserRequests(root) {
+  const state = _loadUserRequests(root);
+  const open = state.requests.filter(r => r.status === 'open' || r.status === 'in-progress');
+  const taskLog = (() => { try { return read(path.join(root, '.harness', 'task-log.md')); } catch { return ''; } })();
+  const plan = (() => { try { return read(path.join(root, '.harness', 'plan.md')); } catch { return ''; } })();
+  const decisions = (() => { try { return read(path.join(root, '.harness', 'decisions.md')); } catch { return ''; } })();
+  const haystack = (taskLog + '\n' + plan + '\n' + decisions).toLowerCase();
+  const missing = [];
+  const tracked = [];
+  open.forEach(req => {
+    const linked = (req.linkedTaskIds && req.linkedTaskIds.length > 0)
+      || (req.linkedPlanIds && req.linkedPlanIds.length > 0)
+      || (req.linkedDecisionIds && req.linkedDecisionIds.length > 0);
+    // 키워드 매칭 — 요청 텍스트의 처음 8단어 중 3단어 이상 task-log/plan/decisions 에 존재 → tracked
+    const words = req.text.toLowerCase().split(/[\s,.()/\\-]+/).filter(w => w.length >= 2).slice(0, 12);
+    const hits = words.filter(w => haystack.includes(w)).length;
+    const matched = hits >= Math.min(3, Math.ceil(words.length * 0.5));
+    if (linked || matched) tracked.push({ ...req, hits, words: words.length });
+    else missing.push({ ...req, hits, words: words.length });
+  });
+  // 7일 이상 묵은 open 요청 (stale)
+  const now = Date.now();
+  const stale = open.filter(r => (now - new Date(r.recordedAt).getTime()) > 7 * 24 * 60 * 60 * 1000);
+  return {
+    total: state.requests.length,
+    open: open.length,
+    missing,
+    tracked,
+    stale,
+    completed: state.requests.filter(r => r.status === 'completed').length,
+    dropped: state.requests.filter(r => r.status === 'dropped').length
+  };
+}
+
 // 1.9.203: 자동 라운드 plan 정리 — 사용자 명시
 //   "백그라운드에 다음 작업이 시작가능한 예상 시간 + 일어났을때 해야하는 일을 정리"
 //   라운드 마무리 시 .harness/auto-resume-plan.json 자동 저장 → 다음 wakeup 시 즉시 실행 가능
@@ -2027,6 +2115,122 @@ function resumeCmd(root) {
   log(grn(`✓ resume 준비 완료 — 권장: leerness handoff . 또는 leerness next-action take`));
 }
 
+// 1.9.207: leerness requests <sub> — 사용자 요청 누락 확인 절차 CLI (사용자 명시)
+//   audit  → open 요청 중 task-log/plan/decisions 에 매칭 안 되는 항목 보고 (누락 후보)
+//   add    → 사용자 요청 수동 기록 (예: leerness requests add "API rate limit 5/s 적용")
+//   list   → 모든 요청 출력 (--json 옵션)
+//   complete <id> → 요청 완료 표시
+//   drop <id>     → 요청 드롭 표시 (사용자 명시 취소)
+function requestsCmd(root, sub, ...rest) {
+  root = absRoot(root);
+  const isTty = process.stdout && process.stdout.isTTY;
+  const cyan = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+  const grn = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+  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;
+
+  if (!sub || sub === 'help' || sub === '--help') {
+    log(`# leerness requests (1.9.207) — 사용자 요청 누락 확인 절차`);
+    log('');
+    log(`  audit          → 누락 후보 + tracked + stale 보고 (--json 가능)`);
+    log(`  add "<text>"   → 사용자 요청 수동 기록`);
+    log(`  list           → 전체 요청 출력 (--json 가능, --status open|completed|dropped)`);
+    log(`  complete <id>  → 요청 완료 표시 (예: UR-0003)`);
+    log(`  drop <id>      → 요청 드롭 표시`);
+    return;
+  }
+
+  if (sub === 'add') {
+    const text = rest.filter(x => !x.startsWith('-')).join(' ');
+    if (!text) { console.error('Usage: leerness requests add "<request text>"'); process.exit(1); }
+    const entry = _recordUserRequest(root, text);
+    if (!entry) { console.error('failed to record'); process.exit(1); }
+    if (has('--json')) { log(JSON.stringify(entry, null, 2)); return; }
+    log(grn(`✓ recorded ${entry.id}: ${entry.text}`));
+    return;
+  }
+
+  if (sub === 'list') {
+    const state = _loadUserRequests(root);
+    const filterStatus = arg('--status', null);
+    let list = state.requests;
+    if (filterStatus) list = list.filter(r => r.status === filterStatus);
+    if (has('--json')) { log(JSON.stringify({ total: state.requests.length, filtered: list.length, requests: list }, null, 2)); return; }
+    log(cyan(`# leerness requests list (1.9.207)`));
+    log(`  total ${state.requests.length}${filterStatus ? ` · filter status=${filterStatus} → ${list.length}` : ''}`);
+    log('');
+    if (list.length === 0) { log(dim('  (없음)')); return; }
+    for (const r of list) {
+      const statusIcon = r.status === 'completed' ? '✓' : (r.status === 'dropped' ? '✗' : (r.status === 'in-progress' ? '▶' : '◯'));
+      const recordedDay = (r.recordedAt || '').slice(0, 10);
+      log(`  ${statusIcon} [${r.id}] ${dim(recordedDay)} ${r.text.slice(0, 100)}${r.text.length > 100 ? '…' : ''}`);
+      if (r.linkedTaskIds && r.linkedTaskIds.length > 0) log(dim(`       linked tasks: ${r.linkedTaskIds.join(', ')}`));
+    }
+    return;
+  }
+
+  if (sub === 'complete') {
+    const id = rest[0];
+    if (!id) { console.error('Usage: leerness requests complete <id>'); process.exit(1); }
+    const updated = _updateUserRequest(root, id, { status: 'completed' });
+    if (!updated) { console.error(`request not found: ${id}`); process.exit(1); }
+    if (has('--json')) { log(JSON.stringify(updated, null, 2)); return; }
+    log(grn(`✓ completed ${updated.id}`));
+    return;
+  }
+
+  if (sub === 'drop') {
+    const id = rest[0];
+    if (!id) { console.error('Usage: leerness requests drop <id>'); process.exit(1); }
+    const updated = _updateUserRequest(root, id, { status: 'dropped' });
+    if (!updated) { console.error(`request not found: ${id}`); process.exit(1); }
+    if (has('--json')) { log(JSON.stringify(updated, null, 2)); return; }
+    log(yel(`✗ dropped ${updated.id}`));
+    return;
+  }
+
+  if (sub === 'audit') {
+    const audit = _auditUserRequests(root);
+    if (has('--json')) { log(JSON.stringify(audit, null, 2)); return; }
+    log(cyan(`# leerness requests audit (1.9.207) — 사용자 요청 누락 확인 절차`));
+    log('');
+    log(`  📊 통계: total ${audit.total} · open ${audit.open} · completed ${audit.completed} · dropped ${audit.dropped}`);
+    log('');
+    if (audit.missing.length === 0) {
+      log(grn(`  ✓ 누락 없음 — open 요청 모두 task-log/plan/decisions 에 흔적 있음`));
+    } else {
+      log(red(`  ⚠ 누락 후보 ${audit.missing.length}건 (open 상태이나 task/plan/decisions 매칭 없음):`));
+      for (const m of audit.missing) {
+        log(`    • [${m.id}] ${m.text.slice(0, 90)}${m.text.length > 90 ? '…' : ''}`);
+        log(dim(`         ${m.recordedAt.slice(0, 10)} · hits=${m.hits}/${m.words}`));
+      }
+      log('');
+      log(dim(`  → 권장: 누락 항목별 leerness task add "<요청>" 또는 leerness requests complete <id>`));
+    }
+    if (audit.tracked.length > 0) {
+      log('');
+      log(grn(`  ✓ tracked ${audit.tracked.length}건 (open + task/plan/decisions 매칭됨):`));
+      for (const t of audit.tracked.slice(0, 5)) {
+        log(`    • [${t.id}] ${t.text.slice(0, 80)}${t.text.length > 80 ? '…' : ''} ${dim(`(hits=${t.hits})`)}`);
+      }
+    }
+    if (audit.stale.length > 0) {
+      log('');
+      log(yel(`  ⏳ stale ${audit.stale.length}건 (7일+ open):`));
+      for (const s of audit.stale.slice(0, 5)) {
+        const days = Math.floor((Date.now() - new Date(s.recordedAt).getTime()) / 86400000);
+        log(`    • [${s.id}] ${days}일 ${s.text.slice(0, 70)}…`);
+      }
+    }
+    return;
+  }
+
+  console.error(`Unknown subcommand: ${sub}`);
+  console.error(`Run: leerness requests help`);
+  process.exit(1);
+}
+
 // 1.9.199: wakeup miss 자동 회복 강화 — last-handoff timestamp 기록 + 25min 기대 interval 정밀 측정
 //   사용자 명시 (1.9.198 후속): "22:01에 라운드에 자동진입되지않았어"
 //   1.9.196 task-log mtime 기반 detector 는 task-log 가 자주 안 업데이트되면 false positive.
@@ -4061,10 +4265,19 @@ function handoff(root) {
           parts.push(`🔌 backend ${pb.ready}/${pb.total} (${ageLabel}${pb.expired ? '⚠' : '✓'})`);
         }
       } catch {}
+      // 13) 1.9.207: 사용자 요청 누락 확인 절차 (사용자 명시) — 누락 후보 ≥ 1 시 헤드라인 노출
+      try {
+        const audit = _auditUserRequests(root);
+        if (audit.missing && audit.missing.length > 0) {
+          parts.push(`📥 미답 요청 ${audit.missing.length}건`);
+        } else if (audit.open > 0) {
+          parts.push(`📥 요청 ${audit.open} (tracked)`);
+        }
+      } catch {}
       if (parts.length) {
         const isTty = process.stdout && process.stdout.isTTY;
         const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
-        log(cy(`📊 헤드라인 (1.9.81/93/113/152/162/192/197/204): ${parts.join(' · ')}`));
+        log(cy(`📊 헤드라인 (1.9.81/93/113/152/162/192/197/204/207): ${parts.join(' · ')}`));
       }
     } catch {}
   }
@@ -15353,6 +15566,8 @@ async function main() {
   if (cmd === 'next-action')                        return nextActionCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   // 1.9.203: leerness resume — auto-resume-plan 읽고 다음 라운드 즉시 안내 (사용자 명시)
   if (cmd === 'resume')                             return resumeCmd(arg('--path', process.cwd()));
+  // 1.9.207: leerness requests <audit|add|list|complete|drop> — 사용자 요청 누락 확인 절차 (사용자 명시)
+  if (cmd === 'requests')                           return requestsCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   if (cmd === 'rule' && args[1] === 'add')          return ruleAdd(arg('--path', process.cwd()), args.slice(2).filter(x => !x.startsWith('-')).join(' '));
   if (cmd === 'rule' && args[1] === 'list')         return ruleList(arg('--path', process.cwd()));
   if (cmd === 'rule' && args[1] === 'remove')       return ruleRemove(arg('--path', process.cwd()), args[2]);

package/package.json

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