leerness 1.9.24 → 1.9.26

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 1.9.26 — 2026-05-15
+
+**낙관적 표시 방지 — `optimism-check <T-ID>` + `verify-claim --strict-claims`** (사용자 명시 요구사항).
+
+API 연동/DB 저장/이메일 발송 등 외부 작용을 evidence에 적었는데 실제 코드에 호출 흔적이 없는 "낙관적 표시"를 정적 분석으로 자동 감지.
+
+### Added
+
+- **`leerness optimism-check <T-ID> [--json]`**: progress-tracker의 evidence를 5종 패턴(API/DB/Email/Webhook/Payment)으로 스캔 → 주장이 있으면 코드 본문(`src/`, `bin/`, `lib/`, `scripts/`)에 호출 흔적 검사 → 불일치 발견 시 `exit 1`.
+- **`leerness verify-claim --strict-claims`**: 기존 verify-claim 출력에 낙관적 표시 검사 결과 통합. 의심 발견 시 종합 FAIL.
+- 5종 패턴 카탈로그:
+  - **API**: `API 호출 / HTTP \d{3} / POST \/ / fetch / endpoint` ↔ `fetch( / http.request / axios. / undici / got.`
+  - **DB**: `DB에 저장 / insert N건 / 데이터베이스 / migration` ↔ `db. / pg. / mongoose. / prisma. / sequelize`
+  - **Email**: `이메일 발송 / sendMail` ↔ `sendMail / nodemailer / smtp / @sendgrid`
+  - **Webhook**: `웹훅 호출` ↔ `fetch / http.request / axios.`
+  - **Payment**: `결제 완료 / stripe / toss` ↔ `stripe / toss / tosspayments`
+
+### Why
+1.9.18~1.9.25의 verify-claim은 파일·테스트 카운트만 검증. 외부 작용(API/DB) 주장은 못 잡음. 1.9.26은 정적 분석으로 1차 방어선 추가.
+
+### Limitations (1.9.27 후보)
+- 같은 프로젝트가 다른 목적으로 동일 키워드(예: `http.request`)를 쓰면 false negative. URL/메서드 단위 매핑 필요.
+- AST 분석 없는 substring 매칭. 호출 위치(call site) vs evidence 청크 매핑 필요.
+- 파일 I/O, 메시지 큐(rabbitmq/kafka), 결제 PG 추가 필요.
+
+### Migration
+```bash
+npx leerness@latest update . --yes
+
+# 사용 예
+leerness optimism-check T-0001
+leerness verify-claim T-0001 --run-tests --strict-claims
+```
+
+## 1.9.25 — 2026-05-15
+
+**모순 감지 0/5 → 5/5 — 소스 코드 인덱싱 + 멀티 세션 in-progress 즉시 등록**.
+
+이전 1.9.24 실측에서 발견한 "코드는 있는데 progress-tracker에 등록 안 된 상태" 사각지대를 두 가지 신규 명령으로 보완.
+
+### Added
+
+- **`leerness memory search "키" --include-code`** (후보 A): `.harness/*.md` 외에 `src/`, `tests/`, `bin/`, `lib/`, `scripts/` 폴더의 `.js/.ts/.gd/.cs/.py/.rb/.go/.rs/.md/.html/.css/.json` 본문도 검색. 모순 감지 핵심.
+- **`leerness brainstorm "주제" --include-code`** (후보 A 확장): 단일/워크스페이스 모드 모두에서 코드 hits 별도 섹션 (`💻 코드`)으로 표시.
+- **`leerness register-pending "<요청>"`** (후보 B): 다중 세션/모델이 작업 시작 즉시 progress-tracker에 in-progress T-row를 등록. `--agent <name> --note <text>` 옵션. 다른 세션이 즉시 발견 가능 → 중복/모순 작업 방지.
+
+### Why
+1.9.24까지: Gemini가 워크스페이스 직접 수정 (toJson 추가)했지만 progress-tracker에 등록 전엔 다른 세션이 발견 못함 (0/5 fail). 1.9.25:
+- 소스 코드 인덱싱으로 즉시 발견 가능 (실측: `memory search "toJson" --include-code` → **0 → 15 matches**)
+- `register-pending`으로 작업 시작 시점 즉시 신호 발신
+
+### Migration
+```bash
+npx leerness@latest update . --yes
+
+# 다중 세션 / 외부 모델 워크플로 (Gemini/Codex/Claude)
+leerness handoff --compact > /tmp/ctx.txt
+# 외부 모델에 컨텍스트 + 작업 부여
+gemini -p "$(cat /tmp/ctx.txt)\n작업: ..." --yolo
+
+# 모순 감지 (코드 검색 포함)
+leerness memory search "키워드" --include-code
+leerness brainstorm "주제" --all-apps --include-code
+```
+
 ## 1.9.24 — 2026-05-14
 
 **`leerness deps <capability>` — depends-on 그래프 역방향 추적 + 자동 회귀 sweep**.

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.24';
+const VERSION = '1.9.26';
 const MARK = '<!-- leerness:managed -->';
 const README_START = '<!-- leerness:project-readme:start -->';
 const README_END = '<!-- leerness:project-readme:end -->';
@@ -1167,8 +1167,34 @@ function memorySearch(root, query) {
       total += hits.length;
     }
   }
+  // 1.9.25: --include-code 옵션 — 실제 소스 코드 본문도 검색 (src/tests/bin)
+  // 이전 모순 감지 0/5 → 5/5의 핵심 보완
+  if (has('--include-code')) {
+    const codeDirs = ['src', 'tests', 'bin', 'lib', 'scripts'];
+    for (const dir of codeDirs) {
+      const dp = path.join(root, dir);
+      if (!exists(dp)) continue;
+      function walkCodeDir(d) {
+        let entries; try { entries = fs.readdirSync(d, { withFileTypes: true }); } catch { return; }
+        for (const e of entries) {
+          const p = path.join(d, e.name);
+          if (e.isDirectory()) { walkCodeDir(p); continue; }
+          if (!/\.(js|ts|jsx|tsx|gd|cs|py|rb|go|rs|md|html|css|json)$/i.test(e.name)) continue;
+          let txt; try { txt = read(p); } catch { continue; }
+          const lines = txt.split('\n');
+          const hits = lines.map((line, i) => ({ line, i })).filter(x => re.test(x.line));
+          if (hits.length) {
+            log(`\n# ${rel(root, p)}`);
+            for (const h of hits.slice(0, parseInt(arg('--limit','5'),10))) log(`  L${h.i+1}: ${h.line.trim().slice(0, 160)}`);
+            total += hits.length;
+          }
+        }
+      }
+      walkCodeDir(dp);
+    }
+  }
   if (total === 0) log('(no matches)');
-  else log(`\n${total} matches`);
+  else log(`\n${total} matches${has('--include-code') ? ' (소스 코드 포함)' : ''}`);
 }
 
 function handoff(root) {
@@ -1673,6 +1699,15 @@ function verifyClaimCmd(root, taskId) {
     }
   }
 
+  // 1.9.26: --strict-claims — 낙관적 표시 자동 감지 (evidence vs 코드 호출 흔적)
+  let optimismSuspects = [];
+  let strictOk = true;
+  if (has('--strict-claims')) {
+    const codeText = _scanCodeForPatterns(root);
+    optimismSuspects = _detectOptimism(evidence, codeText);
+    strictOk = optimismSuspects.length === 0;
+  }
+
   log('');
   const allFilesOk = fileChecks.every(c => c.exists);
   const testOk = declaredTestCount == null || actualTestCount == null || actualTestCount >= declaredTestCount;
@@ -1683,7 +1718,14 @@ function verifyClaimCmd(root, taskId) {
     log(`  - npm test 실행: ${runTestsOk ? '✓ all passed' : '✗ FAIL'}`);
     if (declaredPass) log(`  - 주장과 실행 결과 일치: ${declaredPassMatchesActual ? '✓ pass' : '⚠ 다름'}`);
   }
-  const overallFail = !allFilesOk || !testOk || (runResult && !runResult.skipped && !runTestsOk);
+  if (has('--strict-claims')) {
+    if (strictOk) log(`  - 낙관적 표시 (--strict-claims): ✓ pass (의심 없음)`);
+    else {
+      log(`  - 낙관적 표시 (--strict-claims): ⚠ FAIL (${optimismSuspects.length}건 의심)`);
+      for (const s of optimismSuspects) log(`    · [${s.kind}] ${s.label}: evidence에 주장 있는데 코드에 호출 흔적 없음`);
+    }
+  }
+  const overallFail = !allFilesOk || !testOk || (runResult && !runResult.skipped && !runTestsOk) || (has('--strict-claims') && !strictOk);
   if (overallFail) {
     log('');
     log(`  ⚠ evidence 주장과 실제가 일치하지 않음 — task 상태 재검토 권장`);
@@ -1986,6 +2028,137 @@ function depsImpactCmd(root, targetCapability) {
   }
 }
 
+// 1.9.26: optimism-check — evidence의 외부 동작 주장 vs 실제 코드 호출 흔적 불일치 감지
+// 사용자 요청 (1.9.26): "API 연동/작업 요청 시 실제로 일어나지 않았는데 일어난 것처럼 표시하는 낙관적 결과 방지"
+//
+// 패턴 (한국어 + 영어):
+//   evidence에 "API 호출" / "HTTP 200|201" / "POST /" / "응답 확인" → 코드에 fetch/http.request/axios 흔적 없으면 의심
+//   evidence에 "DB 저장" / "insert N건" / "DB에" → db.*/pg.*/mysql.*/mongoose.*/prisma.* 없으면 의심
+//   evidence에 "이메일 발송" / "메일 전송" → sendMail/nodemailer/smtp 없으면 의심
+const OPTIMISM_PATTERNS = [
+  { kind: 'API',     evidenceRe: /(API\s*호출|HTTP\s*\d{3}|POST\s*\/|GET\s*\/|PUT\s*\/|DELETE\s*\/|fetch|REST 응답|응답 확인|endpoint)/i,
+    codeRe: /\b(fetch\s*\(|http\.request|https\.request|axios\.|got\.|undici|node-fetch)/i,
+    label: 'API/HTTP 호출' },
+  { kind: 'DB',      evidenceRe: /(DB에?\s*저장|insert\s+\d+|데이터베이스|SQL\s*(INSERT|UPDATE|DELETE)|migration|마이그레이션 적용)/i,
+    codeRe: /\b(db\.|pg\.|pool\.|mysql\.|mongoose\.|prisma\.|sequelize|knex|sqlite3|MongoClient|createConnection)/i,
+    label: 'DB 호출' },
+  { kind: 'Email',   evidenceRe: /(이메일[^.\n]{0,30}(발송|전송|보냈|보냄|완료)|메일[^.\n]{0,30}(발송|전송|보냈|보냄)|sendMail|smtp\s*(전송|발송))/i,
+    codeRe: /\b(sendMail|nodemailer|smtp|@sendgrid|mailgun|aws-sdk\/ses|resend\.)/i,
+    label: '이메일 전송' },
+  { kind: 'Webhook', evidenceRe: /(웹훅\s*(호출|전송)|webhook\s+(sent|posted|triggered))/i,
+    codeRe: /\b(fetch\s*\(|http\.request|axios\.)/i,
+    label: '웹훅' },
+  { kind: 'Payment', evidenceRe: /(결제\s*(완료|성공)|payment\s+(processed|charged)|stripe|toss)/i,
+    codeRe: /\b(stripe|toss|@stripe|tosspayments|iamport)/i,
+    label: '결제' }
+];
+
+function _scanCodeForPatterns(root) {
+  // src/, bin/, lib/, scripts/ 의 .js/.ts/.gd/.py 파일 본문 통합
+  let combined = '';
+  const dirs = ['src', 'bin', 'lib', 'scripts'];
+  for (const d of dirs) {
+    const dp = path.join(root, d);
+    if (!exists(dp)) continue;
+    function walk(p) {
+      let entries; try { entries = fs.readdirSync(p, { withFileTypes: true }); } catch { return; }
+      for (const e of entries) {
+        const fp = path.join(p, e.name);
+        if (e.isDirectory()) { walk(fp); continue; }
+        if (!/\.(js|ts|jsx|tsx|gd|cs|py|rb|go|rs)$/i.test(e.name)) continue;
+        try { combined += read(fp) + '\n'; } catch {}
+      }
+    }
+    walk(dp);
+  }
+  return combined;
+}
+
+function _detectOptimism(evidence, codeText) {
+  // 각 패턴 검사: evidence에 주장 있고 코드에 흔적 없으면 의심
+  const suspects = [];
+  for (const p of OPTIMISM_PATTERNS) {
+    if (p.evidenceRe.test(evidence) && !p.codeRe.test(codeText)) {
+      suspects.push({ kind: p.kind, label: p.label });
+    }
+  }
+  return suspects;
+}
+
+function optimismCheckCmd(root, taskId) {
+  root = absRoot(root || process.cwd());
+  if (!taskId) return fail('optimism-check <T-ID> 필요. 예: leerness optimism-check T-0001');
+  const rows = readProgressRows(root);
+  const row = rows.find(r => r.id === taskId);
+  if (!row) return fail(`progress-tracker.md에 ${taskId} 없음.`);
+
+  const codeText = _scanCodeForPatterns(root);
+  const suspects = _detectOptimism(row.evidence || '', codeText);
+
+  if (has('--json')) {
+    log(JSON.stringify({
+      project: path.basename(root), taskId, row,
+      suspects, ok: suspects.length === 0,
+      codeFilesScanned: codeText.length > 0
+    }, null, 2));
+    if (suspects.length > 0) return process.exit(1);
+    return;
+  }
+
+  log(`# leerness optimism-check ${taskId} (${path.basename(root)})`);
+  log(`Evidence: ${(row.evidence || '').slice(0, 200)}${(row.evidence || '').length > 200 ? '…' : ''}`);
+  log('');
+  if (!suspects.length) {
+    log(`  ✓ 낙관적 표시 의심 없음 — evidence의 주장이 실제 코드 호출 흔적과 일관`);
+    return;
+  }
+  log(`  ⚠ 낙관적 표시 의심 ${suspects.length}건 — evidence에 주장 있는데 코드에 호출 흔적 없음`);
+  for (const s of suspects) log(`    · [${s.kind}] ${s.label} 주장 ↔ 코드 호출 미발견`);
+  log('');
+  log(`💡 가능한 해석:`);
+  log(`  1) evidence 작성자가 실제 동작 없이 낙관적으로 표시 (검증 필요)`);
+  log(`  2) 호출이 별도 모듈/test fixture/외부 스크립트에 있음 → evidence에 경로 명시 권장`);
+  log(`  3) 라이브러리/SDK 이름 변경 → \`_apps/<proj>\` 정적 분석 패턴에 미포함된 경우`);
+  log('');
+  log(`정책 (1.9.26): 의심 발견 시 exit 1 — task 상태 재검토 권장`);
+  return process.exit(1);
+}
+
+// 1.9.25: register-pending — sub-agent/외부 모델이 작업 시작 즉시 progress-tracker에 in-progress 등록
+// 사용 예: leerness register-pending "<요청 내용>" --agent gemini
+//   → 다음 T-ID 자동 할당, status=in-progress, evidence="(pending) by <agent>"
+//   → 다른 세션이 즉시 발견 가능 (모순 감지)
+function registerPendingCmd(root, requestParts) {
+  root = absRoot(root || process.cwd());
+  const request = (requestParts || []).join(' ').trim();
+  if (!request) { fail('register-pending "<요청>" 필요. 예: leerness register-pending "toJson 함수 추가" --agent gemini'); return process.exit(1); }
+  const agent = arg('--agent', 'unknown');
+  const note = arg('--note', '');
+
+  // 다음 T-ID 산출
+  const rows = readProgressRows(root);
+  let maxN = 0;
+  for (const r of rows) {
+    const m = r.id && r.id.match(/^T-(\d+)$/);
+    if (m) maxN = Math.max(maxN, parseInt(m[1], 10));
+  }
+  const id = `T-${String(maxN + 1).padStart(4, '0')}`;
+  const evidence = `(pending) by ${agent}${note ? ' — ' + note : ''}`;
+  const row = {
+    id,
+    status: 'in-progress',
+    request: request.slice(0, 200),
+    evidence,
+    nextAction: '작업 진행 중',
+    updated: today()
+  };
+  upsertProgress(root, row);
+  log(`✓ ${id} 등록됨 (in-progress) by ${agent}`);
+  log(`  request: ${row.request}`);
+  log(`  💡 작업 완료 후: leerness task update ${id} --status done --evidence "..."`);
+  if (has('--json')) log(JSON.stringify({ ok: true, id, ...row }, null, 2));
+}
+
 // 1.9.22 후보 4: llm-bench record + retro 통합
 function llmBenchRecordCmd(root) {
   root = absRoot(root || process.cwd());
@@ -2507,7 +2680,7 @@ function _brainstormFor(root, topic) {
   const tokens = String(topic).split(/\s+/).filter(t => t.length >= 2);
   const wordRes = tokens.map(t => new RegExp(`(?<![\\p{L}\\p{N}_])${_escUnicode(t)}(?![\\p{L}\\p{N}_])`, 'iu'));
   function matches(text) { return wordRes.every(re => re.test(text)); }
-  const hits = { decisions: [], skills: [], tasks: [], rules: [], evidence: [], lessons: [] };
+  const hits = { decisions: [], skills: [], tasks: [], rules: [], evidence: [], lessons: [], code: [] };
   const dec = exists(decisionsPath(root)) ? read(decisionsPath(root)) : '';
   const decLines = dec.split('\n');
   for (const b of _extractDecisionBlocks(dec)) {
@@ -2563,10 +2736,38 @@ function _brainstormFor(root, topic) {
       if (/✗|fail|롤백|incomplete|버그/i.test(block)) hits.lessons.push({ title: t.trim(), line: lineNo });
     }
   }
+  // 1.9.25: --include-code 옵션 — 소스 본문 검색 추가 (모순 감지 핵심)
+  if (has('--include-code')) {
+    const codeDirs = ['src', 'tests', 'bin', 'lib'];
+    for (const dir of codeDirs) {
+      const dp = path.join(root, dir);
+      if (!exists(dp)) continue;
+      function walkCode(d) {
+        let entries; try { entries = fs.readdirSync(d, { withFileTypes: true }); } catch { return; }
+        for (const e of entries) {
+          const p = path.join(d, e.name);
+          if (e.isDirectory()) { walkCode(p); continue; }
+          if (!/\.(js|ts|jsx|tsx|gd|cs|py|rb|go|rs)$/i.test(e.name)) continue;
+          let txt; try { txt = read(p); } catch { continue; }
+          if (matches(txt)) {
+            const lines = txt.split('\n');
+            const firstHit = lines.findIndex(l => matches(l));
+            hits.code.push({
+              file: rel(root, p),
+              line: firstHit >= 0 ? firstHit + 1 : 0,
+              preview: firstHit >= 0 ? lines[firstHit].trim().slice(0, 120) : ''
+            });
+            if (hits.code.length >= 20) return; // 너무 많으면 stop
+          }
+        }
+      }
+      walkCode(dp);
+    }
+  }
   return hits;
 }
 
-function _brainstormTotal(h) { return h.decisions.length + h.skills.length + h.tasks.length + h.rules.length + h.evidence.length; }
+function _brainstormTotal(h) { return h.decisions.length + h.skills.length + h.tasks.length + h.rules.length + h.evidence.length + (h.code?.length || 0); }
 
 // 1.9.16: 워크스페이스 통합 brainstorm
 function _brainstormWorkspace(rootBase, topic) {
@@ -2608,8 +2809,13 @@ function _brainstormWorkspace(rootBase, topic) {
     if (h.lessons.length) {
       log(`  ⚠ 과거 실패/롤백 (${h.lessons.length})`);
     }
+    // 1.9.25: 소스 코드 본문 hits
+    if (h.code && h.code.length) {
+      log(`  💻 코드 (${h.code.length})`);
+      h.code.slice(0, 5).forEach(c => log(`    - ${c.file}:${c.line} — ${c.preview}`));
+    }
   }
-  log(`\n## 📊 워크스페이스 총합: ${grandTotal}건 매치 (${paths.length} 프로젝트)`);
+  log(`\n## 📊 워크스페이스 총합: ${grandTotal}건 매치 (${paths.length} 프로젝트)${has('--include-code') ? ' (소스 코드 포함)' : ''}`);
   if (grandTotal === 0) log(`  ⓘ 어느 프로젝트에서도 "${topic}" 관련 자원 없음 — 새 영역. 첫 결정/스킬을 기록하면 다음 brainstorm이 풍부해짐.`);
 }
 
@@ -2634,7 +2840,7 @@ function brainstormCmd(root, topic) {
   const tokens = String(topic).split(/\s+/).filter(t => t.length >= 2);
   const wordRes = tokens.map(t => new RegExp(`(?<![\\p{L}\\p{N}_])${_escUnicode(t)}(?![\\p{L}\\p{N}_])`, 'iu'));
   function matches(text) { return wordRes.every(re => re.test(text)); }
-  const hits = { decisions: [], skills: [], tasks: [], rules: [], evidence: [], lessons: [] };
+  const hits = { decisions: [], skills: [], tasks: [], rules: [], evidence: [], lessons: [], code: [] };
 
   // decisions (1.9.14: 코드블록/Template 제외, 1.9.15: 라인 번호)
   const dec = exists(decisionsPath(root)) ? read(decisionsPath(root)) : '';
@@ -4002,7 +4208,7 @@ function viewworkInstall(root) {
 }
 
 function help() {
-  log(`Leerness v${VERSION}\n\nUsage:\n  leerness init [path] [--language auto|ko|en] [--skills recommended|all|a,b]\n  leerness migrate [path] [--dry-run] [--force]\n  leerness update [path] [--check|--yes|--force|--from <tarball>]\n  leerness auto-update install [path]\n  leerness status [path]\n  leerness verify [path]\n  leerness debug [path]\n  leerness audit [path]\n  leerness check [path]\n  leerness scan secrets [path]\n  leerness encoding check [path]\n  leerness lazy detect [path]\n  leerness memory search "query" [--limit 5]\n  leerness handoff [path] [--all-apps] [--include p1,p2] [--since 24h|3d] [--compact] [--json]   # 1.9.17-22 워크스페이스 (--compact: LLM 시스템 프롬프트용 1줄 요약)\n  leerness orchestrate "<목표>" [--agents N] [--model qwen2.5:7b-instruct] [--retry-on-fail K]   # 1.9.22 Ollama opt-in (LEERNESS_OLLAMA_BASE_URL 필요)\n  leerness llm-bench record --score N --model X [--label L] [--tokens T]   # 1.9.22 LLM 벤치 히스토리 누적\n  leerness deps <capability> [--run-tests] [--json]   # 1.9.24 depends-on 역방향 추적 + 자동 회귀 sweep\n  leerness reuse-map [path] [--all-apps] [--include p1,p2] [--strict-elements] [--json] # 1.9.18 중복/잠재중복/depends-on\n  leerness verify-claim <T-ID> [--path .] [--run-tests] [--json]   # 1.9.18-20 evidence 자동 검증 (1.9.20: scenes/scripts 등 도메인 폴더 + jest/mocha 파싱)\n  leerness verify-code [path] [--build] [--bench]  # 1.9.20 --bench: scripts.bench 추가 실행 + evidence 누적\n  leerness session close [path]\n  leerness viewwork install [path]\n  leerness viewwork emit [path] [--action a] [--note n] [--agent x] [--tool t]\n  leerness route <task-type>\n  leerness self check [path]\n  leerness readme sync [path]\n  leerness consistency check [path]\n  leerness consistency merge-design-guide [path]\n  leerness plan show|init|add|drop|progress|sync [args]\n  leerness task list|add|update|drop|fix-evidence|relink [args]\n  leerness skill list|info <name>\n  leerness skill learn <id> --doc <url> --command "..." --capability "..." [--note ...]\n  leerness skill use <id> [--note ...]\n  leerness skill optimize <id> --before "..." --after "..." [--note ...]\n  leerness skill remove <id>\n  leerness skill consolidate [--threshold 0.3]\n  leerness gate [path]                       # verify+audit+scan+encoding+lazy
+  log(`Leerness v${VERSION}\n\nUsage:\n  leerness init [path] [--language auto|ko|en] [--skills recommended|all|a,b]\n  leerness migrate [path] [--dry-run] [--force]\n  leerness update [path] [--check|--yes|--force|--from <tarball>]\n  leerness auto-update install [path]\n  leerness status [path]\n  leerness verify [path]\n  leerness debug [path]\n  leerness audit [path]\n  leerness check [path]\n  leerness scan secrets [path]\n  leerness encoding check [path]\n  leerness lazy detect [path]\n  leerness memory search "query" [--limit 5]\n  leerness handoff [path] [--all-apps] [--include p1,p2] [--since 24h|3d] [--compact] [--json]   # 1.9.17-22 워크스페이스 (--compact: LLM 시스템 프롬프트용 1줄 요약)\n  leerness orchestrate "<목표>" [--agents N] [--model qwen2.5:7b-instruct] [--retry-on-fail K]   # 1.9.22 Ollama opt-in (LEERNESS_OLLAMA_BASE_URL 필요)\n  leerness llm-bench record --score N --model X [--label L] [--tokens T]   # 1.9.22 LLM 벤치 히스토리 누적\n  leerness deps <capability> [--run-tests] [--json]   # 1.9.24 depends-on 역방향 추적 + 자동 회귀 sweep\n  leerness memory search "키" [--include-code]   # 1.9.25 소스 코드 본문도 검색 (모순 감지 핵심)\n  leerness brainstorm "주제" [--include-code]    # 1.9.25 코드 본문 hits 포함\n  leerness register-pending "<요청>" [--agent X] [--note Y]   # 1.9.25 다중 세션 in-progress 즉시 등록\n  leerness optimism-check <T-ID> [--json]   # 1.9.26 낙관적 표시 감지 (evidence vs 코드 호출 흔적)\n  leerness verify-claim <T-ID> ... [--strict-claims]   # 1.9.26 verify-claim에 낙관적 표시 자동 검사 통합\n  leerness reuse-map [path] [--all-apps] [--include p1,p2] [--strict-elements] [--json] # 1.9.18 중복/잠재중복/depends-on\n  leerness verify-claim <T-ID> [--path .] [--run-tests] [--json]   # 1.9.18-20 evidence 자동 검증 (1.9.20: scenes/scripts 등 도메인 폴더 + jest/mocha 파싱)\n  leerness verify-code [path] [--build] [--bench]  # 1.9.20 --bench: scripts.bench 추가 실행 + evidence 누적\n  leerness session close [path]\n  leerness viewwork install [path]\n  leerness viewwork emit [path] [--action a] [--note n] [--agent x] [--tool t]\n  leerness route <task-type>\n  leerness self check [path]\n  leerness readme sync [path]\n  leerness consistency check [path]\n  leerness consistency merge-design-guide [path]\n  leerness plan show|init|add|drop|progress|sync [args]\n  leerness task list|add|update|drop|fix-evidence|relink [args]\n  leerness skill list|info <name>\n  leerness skill learn <id> --doc <url> --command "..." --capability "..." [--note ...]\n  leerness skill use <id> [--note ...]\n  leerness skill optimize <id> --before "..." --after "..." [--note ...]\n  leerness skill remove <id>\n  leerness skill consolidate [--threshold 0.3]\n  leerness gate [path]                       # verify+audit+scan+encoding+lazy
   leerness retro [path] [--days 7] [--all-apps] [--include p1,p2] [--json]  # 회고 (1.9.13~1.9.16)
   leerness insights [path] [--all-apps] [--include p1,p2] [--json]         # 누적 통계 (1.9.13~1.9.16)
   leerness brainstorm "<주제>" [--all-apps] [--include p1,p2] [--json]    # 브레인스토밍 (1.9.13~1.9.16)
@@ -4041,6 +4247,8 @@ async function main() {
   if (cmd === 'orchestrate')  return await orchestrateCmd(arg('--path', process.cwd()), args.slice(1).filter(x => !x.startsWith('-')));
   if (cmd === 'llm-bench' && args[1] === 'record') return llmBenchRecordCmd(arg('--path', process.cwd()));
   if (cmd === 'deps')         return depsImpactCmd(arg('--path', process.cwd()), args[1]);
+  if (cmd === 'register-pending') return registerPendingCmd(arg('--path', process.cwd()), args.slice(1).filter(x => !x.startsWith('-')));
+  if (cmd === 'optimism-check') return optimismCheckCmd(arg('--path', process.cwd()), args[1]);
   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; }
   if (cmd === 'viewwork' && args[1] === 'install') return viewworkInstall(args[2] || process.cwd());
   if (cmd === 'viewwork' && args[1] === 'emit')    return viewworkEmit(args[2] || process.cwd(), { action: arg('--action','task'), note: arg('--note',''), agent: arg('--agent','leerness'), tool: arg('--tool','leerness-cli') });

package/package.json

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

package/scripts/e2e.js

@@ -585,6 +585,77 @@ total++;
   if (!ok) { failed++; console.log(r.stdout.slice(0, 500)); }
 }
 
+// 1.9.25 회귀: memory search --include-code + brainstorm --include-code + register-pending
+total++;
+{
+  const tmpC = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-incode-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpC, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  fs.mkdirSync(path.join(tmpC, 'src'), { recursive: true });
+  fs.writeFileSync(path.join(tmpC, 'src/feature.js'), "function specialMagicHandler() { return 42; }\n");
+  // 기본 memory search → 0 matches
+  const r1 = cp.spawnSync(process.execPath, [CLI, 'memory', 'search', 'specialMagicHandler', '--path', tmpC], { encoding: 'utf8', timeout: 10000 });
+  // --include-code → 1+ matches
+  const r2 = cp.spawnSync(process.execPath, [CLI, 'memory', 'search', 'specialMagicHandler', '--path', tmpC, '--include-code'], { encoding: 'utf8', timeout: 10000 });
+  const ok = /no matches/.test(r1.stdout) && /src\/feature\.js/.test(r2.stdout) && /소스 코드 포함/.test(r2.stdout);
+  console.log(ok ? '✓ B(1.9.25) memory search --include-code: 코드 본문 검색' : '✗ --include-code 실패');
+  if (!ok) { failed++; console.log(r2.stdout.slice(0, 400)); }
+}
+
+total++;
+{
+  // register-pending
+  const tmpR = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-regp-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpR, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  const r = cp.spawnSync(process.execPath, [CLI, 'register-pending', 'JSON export 기능', '--agent', 'gemini', '--path', tmpR], { encoding: 'utf8', timeout: 10000 });
+  const okReg = r.status === 0 && /등록됨 \(in-progress\) by gemini/.test(r.stdout);
+  // 즉시 progress-tracker에서 검색 가능
+  const r2 = cp.spawnSync(process.execPath, [CLI, 'memory', 'search', 'JSON export', '--path', tmpR], { encoding: 'utf8', timeout: 10000 });
+  const okSearch = /in-progress/.test(r2.stdout) && /pending.*gemini/.test(r2.stdout);
+  const ok = okReg && okSearch;
+  console.log(ok ? '✓ B(1.9.25) register-pending: 즉시 등록 + 검색 가능' : `✗ register-pending 실패 (reg=${okReg} search=${okSearch})`);
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 400)); }
+}
+
+// 1.9.26 회귀: optimism-check (낙관적 표시 자동 감지) + verify-claim --strict-claims
+total++;
+{
+  const tmpO = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-optm-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpO, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  fs.mkdirSync(path.join(tmpO, 'src'), { recursive: true });
+  // 정적 코드: API/DB 호출 없음
+  fs.writeFileSync(path.join(tmpO, 'src/app.js'), "function pureCompute(n) { return n * 2; }\nmodule.exports = { pureCompute };\n");
+  // 낙관적 evidence: API 호출 주장
+  fs.appendFileSync(path.join(tmpO, '.harness/progress-tracker.md'),
+    '| T-9001 | done | API 등록 | POST /users API 호출 완료, HTTP 201 응답 확인 | (완료) | 2026-05-15 |\n');
+  // 정상 evidence: 단순 계산
+  fs.appendFileSync(path.join(tmpO, '.harness/progress-tracker.md'),
+    '| T-9002 | done | pure compute | src/app.js pureCompute 함수 구현 | (완료) | 2026-05-15 |\n');
+  // T-9001 (거짓) → exit 1 + 의심 감지
+  const r1 = cp.spawnSync(process.execPath, [CLI, 'optimism-check', 'T-9001', '--path', tmpO], { encoding: 'utf8', timeout: 10000 });
+  const okFalse = r1.status !== 0 && /낙관적 표시 의심/.test(r1.stdout) && /API\/HTTP 호출/.test(r1.stdout);
+  // T-9002 (정상) → exit 0 + 의심 없음
+  const r2 = cp.spawnSync(process.execPath, [CLI, 'optimism-check', 'T-9002', '--path', tmpO], { encoding: 'utf8', timeout: 10000 });
+  const okOk = r2.status === 0 && /의심 없음/.test(r2.stdout);
+  const ok = okFalse && okOk;
+  console.log(ok ? '✓ B(1.9.26) optimism-check: 낙관적 API 거짓 감지 + 정상 무경고' : `✗ optimism-check 실패 (거짓=${okFalse} 정상=${okOk})`);
+  if (!ok) { failed++; console.log('--- 거짓 case ---\n' + r1.stdout.slice(0, 300) + '\n--- 정상 case ---\n' + r2.stdout.slice(0, 300)); }
+}
+
+total++;
+{
+  // verify-claim --strict-claims 통합
+  const tmpS = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-stct-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmpS, '--yes', '--language', 'ko', '--skills', 'recommended'], { stdio: 'ignore', timeout: 30000 });
+  fs.mkdirSync(path.join(tmpS, 'src'), { recursive: true });
+  fs.writeFileSync(path.join(tmpS, 'src/x.js'), 'module.exports={};\n');
+  fs.appendFileSync(path.join(tmpS, '.harness/progress-tracker.md'),
+    '| T-0050 | done | DB 마이그레이션 | 사용자 데이터 DB에 저장, 1000건 insert 성공 | (완료) | 2026-05-15 |\n');
+  const r = cp.spawnSync(process.execPath, [CLI, 'verify-claim', 'T-0050', '--path', tmpS, '--strict-claims'], { encoding: 'utf8', timeout: 10000 });
+  const ok = r.status !== 0 && /낙관적 표시 \(--strict-claims\): ⚠ FAIL/.test(r.stdout) && /DB 호출/.test(r.stdout);
+  console.log(ok ? '✓ B(1.9.26) verify-claim --strict-claims: DB 거짓 evidence 통합 감지' : '✗ --strict-claims 실패');
+  if (!ok) { failed++; console.log(r.stdout.slice(0, 400)); }
+}
+
 // 1.9.22 회귀: handoff --compact + orchestrate opt-in 정책 + llm-bench record
 total++;
 {