leerness 1.36.78 → 1.36.80

package/lib/preview-serve.js

@@ -0,0 +1,254 @@
+// lib/preview-serve.js — 라이브 미리보기 (1.36.80, 사용자 요청 UR-0067).
+//   문제: 시안(preview mockup)이 "파일로만" 존재해 사용자가 직접 열어야 했다. 요청: 임시 워크스페이스에 프로젝트에 맞춰
+//   생성하고 로컬 서버로 띄워 확인한 뒤, 확인이 끝나면 임시 워크스페이스를 정리.
+//   모드(사용자 지시): A=self(기본) 자립형 HTML 을 0-deps node http 로 제공 — 어떤 스택에서도 즉시 동작.
+//                     B=project(옵트인) 프로젝트의 정적 디렉토리에 시안을 배치해 **프로젝트 자신의 dev 서버**로 확인.
+//   미설정이면 강제하지 않고 A 로 진행하되 선택 질문을 출력한다(false-PASS 편향 — 흐름을 막지 않는다).
+//   leerness 는 사용자의 dev 서버를 임의로 실행하지 않는다(사용자 코드 실행은 명시 옵트인 영역).
+'use strict';
+const fs = require('fs');
+const http = require('http');
+const path = require('path');
+const { absRoot, exists, read, writeUtf8, mkdirp, log, ok, warn, failJson, now } = require('./io');
+
+function _cfgPath(root) { return path.join(absRoot(root), '.harness', 'preview-config.json'); }
+
+function loadPreviewConfig(root) {
+  const f = _cfgPath(root);
+  if (!exists(f)) return { mode: null, devUrl: '', staticDir: '' };
+  try {
+    const j = JSON.parse(read(f));
+    const mode = (j && (j.mode === 'self' || j.mode === 'project')) ? j.mode : null;
+    return { mode, devUrl: (j && typeof j.devUrl === 'string') ? j.devUrl : '', staticDir: (j && typeof j.staticDir === 'string') ? j.staticDir : '' };
+  } catch { return { mode: null, devUrl: '', staticDir: '', corrupt: true }; }
+}
+
+function savePreviewConfig(root, cfg, json) {
+  const f = _cfgPath(root);
+  if (exists(f)) { try { JSON.parse(read(f)); } catch { failJson(json, 'store_corrupt', `preview-config.json 손상 — 덮어쓰기 거부: ${f}`); return false; } }
+  mkdirp(path.dirname(f));
+  writeUtf8(f, JSON.stringify({ ...cfg, updatedAt: now() }, null, 2) + '\n');
+  return true;
+}
+
+// 모드 미설정 시 사용자에게 물을 질문 — 강제하지 않고 기본(A)로 진행하며 선택지를 제시한다.
+function modeQuestionLines(root) {
+  return [
+    '  ❓ 미리보기 모드가 아직 정해지지 않았습니다 — 기본값 A(자립형)로 진행합니다. 사용자에게 확인하세요:',
+    '     (A) self    — 자립형 HTML 을 leerness 로컬 서버로 확인 (0 의존성 · 어떤 스택이든 즉시 · 오프라인)',
+    '     (B) project — 프로젝트 정적 디렉토리에 배치해 프로젝트 자신의 dev 서버로 확인 (스택 정합 ↑ · dev 서버는 사용자가 실행)',
+    '     → 설정: leerness preview mode self   |   leerness preview mode project --static-dir public --dev-url http://localhost:5173',
+  ];
+}
+
+// 임시 워크스페이스 — 확인이 끝나면(승인/수정요구) 정리된다. 시안 원본(.harness/previews/<id>-mockup.html)은 건드리지 않는다.
+function serveDir(root, id) { return path.join(absRoot(root), '.harness', 'previews', `.serve-${id}`); }
+
+function cleanupServeDir(root, id) {
+  let cleaned = false;
+  const d = serveDir(root, id);
+  try { if (exists(d)) { fs.rmSync(d, { recursive: true, force: true }); cleaned = true; } } catch {}
+  // (검수 #8) project 모드로 프로젝트 정적 디렉토리에 배치한 사본도 함께 정리 — "확인 끝나면 정리한다"는 안내와 실제를 일치시킨다.
+  try {
+    const cfgF = _cfgPath(root);
+    if (exists(cfgF)) {
+      const j = JSON.parse(read(cfgF));
+      const placed = (j && j.placed && j.placed[id]) ? j.placed[id] : null;
+      if (placed) {
+        const abs = path.resolve(absRoot(root), placed);
+        const rel = path.relative(absRoot(root), abs);
+        if (!rel.startsWith('..') && !path.isAbsolute(rel) && exists(abs)) { fs.rmSync(abs, { force: true }); cleaned = true; }
+        delete j.placed[id];
+        writeUtf8(cfgF, JSON.stringify(j, null, 2) + '\n');
+      }
+    }
+  } catch {}
+  return cleaned;
+}
+
+// 프로젝트의 디자인 토큰(있으면)을 임시 워크스페이스로 복사 — 시안이 프로젝트 톤과 어긋나지 않게.
+//   빌드가 필요한 산출물은 복사하지 않는다(leerness 는 사용자 프로젝트를 빌드하지 않는다).
+const _TOKEN_CANDIDATES = ['.harness/design-system.md', 'src/styles/tokens.css', 'src/styles/variables.css', 'styles/tokens.css', 'src/index.css', 'src/app.css', 'app/globals.css'];
+function _collectTokens(root) {
+  const found = [];
+  for (const rel of _TOKEN_CANDIDATES) {
+    const p = path.join(root, rel);
+    try { if (exists(p) && fs.statSync(p).isFile() && fs.statSync(p).size <= 256 * 1024) found.push({ rel, text: read(p) }); } catch {}
+    if (found.length >= 2) break;
+  }
+  return found;
+}
+
+function buildServeWorkspace(root, p) {
+  const srcRel = p.mockupPath || path.join('.harness', 'previews', `${p.id}-mockup.html`);
+  const src = path.isAbsolute(srcRel) ? srcRel : path.join(root, srcRel);
+  // (검수 #12) 검증 실패 시 빈 .serve-* 디렉토리가 남던 것 — 검증을 먼저, 생성은 그 뒤에.
+  if (!exists(src)) return { ok: false, error: `시안 파일 없음: ${srcRel} — 먼저 leerness preview mockup ${p.id}` };
+  const dir = serveDir(root, p.id);
+  mkdirp(dir);
+  let html = read(src);
+  const tokens = _collectTokens(root);
+  if (tokens.length) {
+    // (검수 #9) 프로젝트 CSS 를 <style> 안에 그대로 넣으면 CSS 안의 `</style><script>` 가 탈출해 스크립트가 실행됐다.
+    //   → 별도 스타일시트 파일로 쓰고 <link> 로 연결(문자열 탈출 자체가 불가능). 외부 리소스 0 은 그대로 유지(같은 워크스페이스).
+    const css = tokens.filter(t => /\.css$/.test(t.rel)).map(t => `/* from ${t.rel} */\n${t.text}`).join('\n');
+    const noteRels = tokens.map(t => t.rel).join(', ');
+    let inject = '';
+    if (css) { writeUtf8(path.join(dir, 'project-tokens.css'), css); inject += `<link rel="stylesheet" href="project-tokens.css">\n`; }
+    inject += `<!-- leerness: project design context — ${_escComment(noteRels)} -->\n`;
+    html = html.replace('</head>', inject + '</head>');
+  }
+  writeUtf8(path.join(dir, 'index.html'), html);
+  return { ok: true, dir, tokens: tokens.map(t => t.rel) };
+}
+function _escComment(s) { return String(s).replace(/--+/g, '-').replace(/[<>]/g, ''); }
+
+const _MIME = { '.html': 'text/html; charset=utf-8', '.css': 'text/css; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.svg': 'image/svg+xml', '.png': 'image/png', '.jpg': 'image/jpeg', '.json': 'application/json; charset=utf-8' };
+
+// 1.36.80 (사용자 지시): leerness 시그니처 포트 — 전화 키패드의 "LEER"(5-3-3-7). ollama:11434 처럼 기억 가능한 고정값.
+//   이미 사용 중이면 뒤로 순차 탐색(최대 20) → 그래도 없으면 OS 임의 빈 포트(0). 어떤 경우에도 "포트 충돌로 실패"하지 않는다.
+const LEERNESS_PREVIEW_PORT = 5337;
+function _listenWithFallback(server, preferred, host, onReady, onFail) {
+  const tries = [];
+  for (let i = 0; i < 20; i++) tries.push(preferred + i);
+  tries.push(0);   // 마지막 수단: OS 가 비어 있는 포트를 준다
+  let idx = 0;
+  const attempt = () => {
+    const port = tries[idx];
+    const onErr = (e) => {
+      server.removeListener('error', onErr);
+      if ((e && (e.code === 'EADDRINUSE' || e.code === 'EACCES')) && idx < tries.length - 1) { idx++; setImmediate(attempt); return; }
+      onFail(e, port);
+    };
+    server.once('error', onErr);
+    // 성공 시 실제 바인딩된 포트로 판단한다 — `port !== preferred` 는 port 0(OS 할당) 경로에서도 어긋나고,
+    //   무엇보다 "선호 포트가 막혀 옮겨갔다"는 사실은 실제 주소로만 정확히 알 수 있다(실측: 5338 인데 false 보고).
+    server.listen(port, host, () => { server.removeListener('error', onErr); const a = server.address().port; onReady(a, preferred > 0 && a !== preferred); });
+  };
+  attempt();
+}
+
+// `leerness preview serve <P-ID> [--port N] [--timeout SEC] [--keep]`
+function previewServeCmd(root, id, deps = {}) {
+  const { has, arg, previews } = deps;
+  root = absRoot(root);
+  const json = !!(has && has('--json'));
+  const p = (previews || []).find(x => x.id === id);
+  if (!p) { failJson(json, 'not_found', `preview 없음: ${id}`); return; }
+  const cfg = loadPreviewConfig(root);
+  const mode = cfg.mode || 'self';
+
+  if (mode === 'project') {
+    // B(옵트인): 프로젝트 정적 디렉토리에 배치 — dev 서버 실행은 사용자 몫(사용자 코드를 leerness 가 임의 실행하지 않음)
+    const staticDir = (arg ? arg('--static-dir', '') : '') || cfg.staticDir || 'public';
+    const destDir = path.resolve(root, staticDir);
+    const rel = path.relative(root, destDir);
+    if (rel.startsWith('..') || path.isAbsolute(rel)) { failJson(json, 'static_dir_outside_root', `--static-dir 은 프로젝트 안이어야 합니다: ${destDir}`); return; }
+    // (검수 #5) 렉시컬 검사만으론 정션/심볼릭 링크로 프로젝트 밖에 쓰는 것을 못 막는다 — 실제 경로로 재확인.
+    try {
+      const _rootReal2 = fs.realpathSync(root);
+      let probe = destDir;
+      while (!exists(probe) && path.dirname(probe) !== probe) probe = path.dirname(probe);   // 존재하는 최근접 조상
+      const realProbe = fs.realpathSync(probe);
+      const relReal2 = path.relative(_rootReal2, realProbe);
+      if (relReal2.startsWith('..') || path.isAbsolute(relReal2)) { failJson(json, 'static_dir_outside_root', `--static-dir 이 링크를 통해 프로젝트 밖을 가리킵니다: ${destDir} → ${realProbe}`); return; }
+    } catch {}
+    const built = buildServeWorkspace(root, p);
+    if (!built.ok) { failJson(json, 'mockup_missing', built.error); return; }
+    mkdirp(destDir);
+    const destFile = path.join(destDir, `leerness-preview-${p.id}.html`);
+    writeUtf8(destFile, read(path.join(built.dir, 'index.html')));
+    // (검수 #8) 배치 위치를 기록해 승인/수정 시 정확히 회수한다(추측 삭제 금지 — 기록된 경로만 지운다).
+    try {
+      const cur = exists(_cfgPath(root)) ? JSON.parse(read(_cfgPath(root))) : {};
+      cur.placed = cur.placed && typeof cur.placed === 'object' ? cur.placed : {};
+      cur.placed[p.id] = path.relative(root, destFile).replace(/\\/g, '/');
+      writeUtf8(_cfgPath(root), JSON.stringify(cur, null, 2) + '\n');
+    } catch {}
+    const urlBase = (arg ? arg('--dev-url', '') : '') || cfg.devUrl || 'http://localhost:3000';
+    const url = `${String(urlBase).replace(/\/$/, '')}/leerness-preview-${p.id}.html`;
+    const relFile = path.relative(root, destFile).replace(/\\/g, '/');
+    if (json) { log(JSON.stringify({ ok: true, mode: 'project', id: p.id, file: relFile, url, note: 'dev 서버는 사용자가 실행합니다' }, null, 2)); return; }
+    ok(`시안 배치(project 모드): ${relFile}`);
+    log(`  → 프로젝트 dev 서버를 실행한 뒤 열기: ${url}`);
+    log(`  ⓘ leerness 는 사용자의 dev 서버를 자동 실행하지 않습니다. 확인이 끝나면: leerness preview approve ${p.id} (배치본도 함께 정리)`);
+    return;
+  }
+
+  // A(기본): 자립형 HTML 을 0-deps 로컬 서버로
+  const built = buildServeWorkspace(root, p);
+  if (!built.ok) { failJson(json, 'mockup_missing', built.error); return; }
+  const _portArg = (arg ? arg('--port', '') : '');
+  const port = (_portArg && _portArg !== true) ? Math.max(0, parseInt(_portArg, 10) || 0) : LEERNESS_PREVIEW_PORT;
+  const timeoutSec = Math.max(5, parseInt((arg ? arg('--timeout', '') : '') || '600', 10) || 600);
+  const _rootReal = (() => { try { return fs.realpathSync(built.dir); } catch { return path.resolve(built.dir); } })();
+  const server = http.createServer((req, res) => {
+    // (검수 #4) ① 잘못된 인코딩(%E0%A4%A)이 URIError 로 서버를 죽였다 → 400. ② startsWith 는 형제 디렉토리
+    //   (.serve-P-0001-secret)를 통과시켰다 → path.relative 로 정확 판정. ③ 정션/심볼릭 링크로 밖을 가리키면
+    //   렉시컬 검사만으론 못 막는다 → realpath 로 실제 위치까지 확인.
+    let rel;
+    try { rel = decodeURIComponent(String(req.url || '/').split('?')[0]); }
+    catch { res.writeHead(400, { 'content-type': 'text/plain; charset=utf-8' }); res.end('bad request'); return; }
+    if (rel === '/' || rel === '') rel = '/index.html';
+    const fp = path.resolve(built.dir, '.' + rel);
+    const relCheck = path.relative(_rootReal, fp);
+    if (relCheck.startsWith('..') || path.isAbsolute(relCheck)) { res.writeHead(403); res.end('forbidden'); return; }
+    let realFp = fp;
+    try { realFp = fs.realpathSync(fp); } catch { res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' }); res.end('not found'); return; }
+    const relReal = path.relative(_rootReal, realFp);
+    if (relReal.startsWith('..') || path.isAbsolute(relReal)) { res.writeHead(403); res.end('forbidden'); return; }
+    fs.readFile(realFp, (err, buf) => {   // 실검사를 통과한 실제 경로로 읽는다
+      if (err) { res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' }); res.end('not found'); return; }
+      res.writeHead(200, { 'content-type': _MIME[path.extname(realFp).toLowerCase()] || 'application/octet-stream', 'cache-control': 'no-store' });
+      res.end(buf);
+    });
+  });
+  _listenWithFallback(server, port, '127.0.0.1', (actual, moved) => {
+    const url = `http://127.0.0.1:${actual}/`;
+    if (json) { log(JSON.stringify({ ok: true, mode: 'self', id: p.id, url, port: actual, preferredPort: port, portFallback: !!moved, timeoutSec, workspace: path.relative(root, built.dir).replace(/\\/g, '/'), tokens: built.tokens }, null, 2)); }
+    else {
+      ok(`라이브 미리보기 실행 중 — ${url}`);
+      if (moved) warn(`  ⓘ 기본 포트 ${port} 사용 중 → 비어 있는 ${actual} 로 자동 전환`);
+      log(`  시안: ${p.id} 「${p.title}」`);
+      if (built.tokens.length) log(`  프로젝트 디자인 컨텍스트 반영: ${built.tokens.join(', ')}`);
+      if (!cfg.mode) modeQuestionLines(root).forEach(l => log(l));
+      log(`  → 사용자에게 이 주소를 열어 확인받고, 승인: leerness preview approve ${p.id} · 수정요구: leerness preview revise ${p.id} --note "..."`);
+      log(`  ⓘ ${timeoutSec}초 후 자동 종료(Ctrl+C 로 즉시 종료). 확인이 끝나면 임시 워크스페이스는 승인/수정 시 자동 정리됩니다.`);
+    }
+    const stop = (why) => {
+      try { server.close(); } catch {}
+      if (!(has && has('--keep'))) cleanupServeDir(root, p.id);
+      if (!json) log(`  ⏹ 미리보기 종료(${why})${(has && has('--keep')) ? ' — 임시 워크스페이스 보존(--keep)' : ' — 임시 워크스페이스 정리됨'}`);
+      process.exit(0);
+    };
+    const t = setTimeout(() => stop('timeout'), timeoutSec * 1000);
+    if (t.unref) t.unref();
+    process.on('SIGINT', () => stop('SIGINT'));
+    process.on('SIGTERM', () => stop('SIGTERM'));
+  }, (e, tried) => { failJson(json, 'serve_failed', `로컬 서버 시작 실패: ${e && e.message} (마지막 시도 포트 ${tried})`); });
+}
+
+// `leerness preview mode [self|project] [--static-dir public] [--dev-url http://localhost:5173]`
+function previewModeCmd(root, val, deps = {}) {
+  const { has, arg } = deps;
+  root = absRoot(root);
+  const json = !!(has && has('--json'));
+  const cfg = loadPreviewConfig(root);
+  if (!val) {
+    if (json) { log(JSON.stringify({ ok: true, mode: cfg.mode, effective: cfg.mode || 'self', devUrl: cfg.devUrl, staticDir: cfg.staticDir, corrupt: cfg.corrupt || undefined }, null, 2)); return; }
+    log(`# leerness preview mode — ${cfg.mode ? cfg.mode : '(미설정 → 기본 self)'}`);
+    if (cfg.staticDir) log(`  static-dir: ${cfg.staticDir}`);
+    if (cfg.devUrl) log(`  dev-url: ${cfg.devUrl}`);
+    if (!cfg.mode) modeQuestionLines(root).forEach(l => log(l));
+    return;
+  }
+  if (val !== 'self' && val !== 'project') { failJson(json, 'invalid_mode', `preview mode <self|project> — 받은 값: ${val}`); return; }
+  const next = { mode: val, devUrl: (arg ? (arg('--dev-url', '') || cfg.devUrl) : cfg.devUrl) || '', staticDir: (arg ? (arg('--static-dir', '') || cfg.staticDir) : cfg.staticDir) || '' };
+  if (next.devUrl === true) next.devUrl = ''; if (next.staticDir === true) next.staticDir = '';
+  if (!savePreviewConfig(root, next, json)) return;
+  if (json) { log(JSON.stringify({ ok: true, ...next }, null, 2)); return; }
+  ok(`preview mode = ${val}`);
+  if (val === 'project') log(`  static-dir: ${next.staticDir || 'public'} · dev-url: ${next.devUrl || 'http://localhost:3000'} (dev 서버는 사용자가 실행)`);
+}
+
+module.exports = { LEERNESS_PREVIEW_PORT, previewServeCmd, previewModeCmd, loadPreviewConfig, savePreviewConfig, cleanupServeDir, serveDir, modeQuestionLines, buildServeWorkspace };

package/lib/pure-utils.js

@@ -831,8 +831,17 @@ function _managedMerge(file, next, previous, archiveRel, overwriteSet, opts = {}
 function _parseSkillsValue(v, catalog) {
   if (!v || v === true) return [];
   if (v === 'all') return Object.keys(catalog || {});
-  if (v === 'recommended') return ['office', 'commerce-api', 'ai-verified-skill-publisher', 'feature-implementation', 'project-roadmap-generator'];
-  return String(v).split(',').map(s => s.trim()).filter(Boolean).filter(s => (catalog || {})[s]);
+  // 1.36.80 (사용자 지시): 내장 기본에서 작성자 개인 도메인 스킬(커머스/GA4/앱스토어/오피스/크롤링/파이어베이스/퍼블리셔) 제거 —
+  //   검증 근거 없이 verification:'passed' 를 주장했고 내용은 설명 4줄짜리 메타데이터뿐이라 전역 배포본의 기본값으로 부적절.
+  //   남는 2종은 leerness 자체 워크플로(기능 구현 계약·로드맵 산출)라 도구와 함께 유지된다.
+  if (v === 'recommended') return Object.keys(catalog || {});
+  // 1.36.80 (검수 #10): 명시 요청한 미지/제거된 id 를 조용히 걸러 exit 0 + 0개 설치로 끝나던 것 —
+  //   호출부가 unknown 을 보고 분명히 거절할 수 있도록 함께 반환한다(하위호환: 반환은 여전히 배열).
+  const req = String(v).split(',').map(s => s.trim()).filter(Boolean);
+  const known = req.filter(s => (catalog || {})[s]);
+  const unknown = req.filter(s => !(catalog || {})[s]);
+  if (unknown.length) { try { Object.defineProperty(known, 'unknown', { value: unknown, enumerable: false }); } catch {} }
+  return known;
 }
 
 // 1.9.370 (UR-0025): memory archive 블록 파서 순수 코어 — "## 제거 DATE (target: \"...\")" 블록 → {date,target,originalHeader}[].

package/lib/review-request.js

@@ -212,7 +212,35 @@ function reviewRequestCmd(root, request, deps = {}) {
   if (broadHits.length) efficiencyHints.push(`🤔 범위 과대 신호(${broadHits.slice(0, 3).join(', ')}) — 더 작게 쪼갤 수 있나? 요청에 명시된 것만 (Karpathy 단순성)`);
   if (specHits.length) efficiencyHints.push(`🧪 투기적 신호(${specHits.slice(0, 3).join(', ')}) — 지금 필요한 범위만, 추측성 일반화 보류 (Karpathy 단순성)`);
 
-  // 7) proceed 권장 (충돌 critical 시 false)
+  // 6.9) 1.36.80 (P-0003, ponytail 검토 채택 · codex 공동판단 ADOPT): **순서 있는 최소성 결정 영수증** — 옵트인(--ladder).
+  //   왜: 같은 질문들이 review-request(내부 재사용) · reuse-check(외부 OSS) · lens(완료 시점)로 흩어져 있고,
+  //       특히 reuse-check 는 5번째 단(OSS 도입)만 물어 구조적으로 "의존성 추가" 쪽으로 밀었다. 순서를 복원한다.
+  //   원칙(공동 합의): 자문 전용(차단·점수·임계 없음) · 근거 없으면 unknown(not-applicable 아님) ·
+  //       "한 줄"은 목표가 아니라 질문 · 보존 요구사항(검증/보안/접근성/관측)이 가장 싼 단을 이길 수 있음 ·
+  //       저장하지 않는다(결정으로 남길 가치가 있으면 사용자가 leerness decision add 로 명시 기록).
+  let ladder = null;
+  if (has && has('--ladder')) {
+    const _rung = (id, question, status, evidence) => ({ id, question, status, evidence: evidence || '' });
+    ladder = {
+      // (검수 #11) "아무것도 저장하지 않는다"는 과장이었다 — 사다리 **내용**은 저장하지 않지만 명령 실행 기록(run/usage)은
+      //   다른 명령과 동일하게 남는다. 주장 범위를 사실에 맞춘다.
+      note: 'advisory — 근거 없는 칸은 unknown 입니다. 순서는 비용 순서일 뿐 정답 순서가 아닙니다(보안/접근성은 더 비싼 단이 옳을 수 있음). 사다리 내용은 저장되지 않습니다(명령 실행 기록은 다른 명령과 동일하게 남습니다).',
+      rungs: [
+        _rung('needed', '이 기능이 정말 필요한가? (요청 자체를 줄이거나 없앨 수 있나)', 'unknown', '요청 텍스트만으로는 판정 불가 — 사용자에게 확인'),
+        _rung('in-codebase', '이미 이 코드베이스에 있나?', reuseCandidates.length ? 'candidate' : 'unknown',
+          reuseCandidates.length ? `reuse 후보 ${reuseCandidates.length}건(토큰 매칭 — 확정 아님): ${reuseCandidates.slice(0, 3).map(r => r.name || r.id || r).join(', ')}` : 'reuse-map 매칭 없음 — 부재 증명은 아님 (leerness reuse find "<capability>")'),
+        _rung('stdlib', '표준 라이브러리가 이미 하나?', 'unknown', '런타임/버전/배포 타깃 의존 — 사람이 확인'),
+        _rung('native', '플랫폼 네이티브 기능이 있나? (예: <input type="date">)', 'unknown', '타깃 플랫폼·브라우저 지원 범위 확인 필요'),
+        _rung('installed', '이미 설치된 의존성으로 되나?', 'unknown', '설치됨 ≠ 적합 — 보안/유지보수/스코프 확인 (leerness reuse-check)'),
+        _rung('compose', '기존 것 조합/짧은 코드로 되나?', 'unknown', '"한 줄"은 목표가 아니라 질문 — 검증·에러처리를 숨기지 말 것'),
+        _rung('minimum', '위가 모두 아니면: 동작하는 최소 구현은?', 'unknown', '여기까지 왔다면 범위를 명시적으로 적어두세요'),
+      ],
+      preserved: ['입력 검증(신뢰 경계)', '보안·비밀 취급', '접근성', '에러 처리·관측', '데이터 손실 방지'],
+      preservedNote: '위 항목은 "줄이기" 대상이 아니다 — 더 비싼 단을 택해야 할 근거가 된다.',
+    };
+  }
+
+  // 7) proceed 권장 (충돌 critical 시 false) — ladder 는 자문이라 이 판정에 영향을 주지 않는다(공동 합의 가드레일)
   const proceed = conflictHints.length < 3 && planConflicts.length === 0;
 
   const dt = Date.now() - t0;
@@ -231,6 +259,7 @@ function reviewRequestCmd(root, request, deps = {}) {
     constraintSuggestions: constraintsCheck.suggestions,
     proceed,
     proceedReason: proceed ? '안전 — 충돌 신호 < 3 + plan 충돌 0' : '⚠ 충돌 critical — 사용자 확인 후 진행',
+    ...(ladder ? { ladder } : {}),
     durationMs: dt
   };
 
@@ -289,6 +318,19 @@ function reviewRequestCmd(root, request, deps = {}) {
     recommendedSteps.forEach(s => log(`  ${s}`));
     log('');
   }
+  // 1.36.80 (P-0003): 최소성 사다리 — 옵트인 자문 영수증. proceed 판정에는 영향 없음.
+  if (ladder) {
+    log(`## 🪜 최소성 결정 사다리 (--ladder · 자문)`);
+    for (const r of ladder.rungs) {
+      const mark = r.status === 'confirmed' ? '✅' : (r.status === 'candidate' ? '🔎' : (r.status === 'not-applicable' ? '➖' : '❔'));
+      log(`  ${mark} [${r.status}] ${r.question}`);
+      if (r.evidence) log(`        ${r.evidence}`);
+    }
+    log(`  🔒 줄이면 안 되는 것: ${ladder.preserved.join(' · ')}`);
+    log(`     ${ladder.preservedNote}`);
+    log(`  ⓘ ${ladder.note}`);
+    log('');
+  }
   log(`## ▶ 진행 권장: ${proceed ? '✓ 진행 안전' : '⚠ 사용자 확인 필요'}`);
   log(`   사유: ${out.proceedReason}`);
   log(`   분석 소요: ${dt}ms`);

package/lib/tech-profile.js

@@ -58,18 +58,22 @@ function _envKeys(root) {
 
 function _shallowExts(root) {
   const counts = {};
+  let _extBudget = 20000;   // 1.36.79 (검수 #4): 전체 예산 — 거대 저장소에서도 공정 집계 + 상한 보장
   const scan = (dir, depth) => {
     let entries = [];
     try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
-    for (const e of entries.slice(0, 400)) {
+    // 1.36.79 (검수 #4): 디렉토리당 400개 컷이 큰 플랫 디렉토리에서 **집계를 편향**시켰다(1501 JS vs 500 PY 인데 Python 1위).
+    //   순위가 실제 파일 수에 기반하려면 세는 범위가 공정해야 한다 — 상한을 크게(디렉토리당 5000, 전체 예산 20000) 두고 공정 집계.
+    for (const e of entries.slice(0, 5000)) {
+      if (_extBudget <= 0) return;
       if (e.name.startsWith('.') || e.name === 'node_modules' || e.name === 'dist' || e.name === 'build') continue;
       const p = path.join(dir, e.name);
       if (e.isDirectory()) { if (depth > 0) scan(p, depth - 1); continue; }
       const ext = path.extname(e.name).toLowerCase();
-      if (EXT_LANG[ext]) counts[EXT_LANG[ext]] = (counts[EXT_LANG[ext]] || 0) + 1;
+      if (EXT_LANG[ext]) { counts[EXT_LANG[ext]] = (counts[EXT_LANG[ext]] || 0) + 1; _extBudget--; }
     }
   };
-  scan(absRoot(root), 2);
+  scan(absRoot(root), 3);   // 1.36.79 (도그푸딩 P1-D): depth 2→3 — src/pkg/mod 3단 레이아웃의 소스가 통째로 안 세어지던 것
   return counts;
 }
 
@@ -84,6 +88,11 @@ function detectTechProfile(root) {
   }
   const extCounts = _shallowExts(root);
   for (const [lang, n] of Object.entries(extCounts)) if (n >= 3) addL(lang, `${n} source files`);
+  // 1.36.79 (도그푸딩 P1-D, 실 프로젝트): 마커 파일 존재만으로 순서가 정해져 **devDependency 1개짜리 package.json 이
+  //   205개 .py 파일을 이겨** Python 모노레포가 "javascript" 로 라벨링됐다(실측). 실제 소스 파일 수를 1순위 근거로
+  //   재정렬 — 파일이 많은 언어가 앞, 동수면 기존(마커) 순서 유지. 마커-only(0 파일)는 뒤로.
+  languages.sort((a, b) => (extCounts[b.id] || 0) - (extCounts[a.id] || 0));
+  for (const l of languages) { const n = extCounts[l.id] || 0; if (n >= 3 && !/source files/.test(l.evidence)) l.evidence = `${l.evidence} · ${n} source files`; }
   // deps 수집 — 1.36.54 (#5): 모노레포 대응, 루트 + 얕은 하위(2단계) 매니페스트 병합 (vendor 류 제외)
   let deps = {};
   let reqTxt = '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.36.78",
+  "version": "1.36.80",
   "description": "The AI-coding operations layer that makes \"done\" require evidence — persistent memory, evidence-gated completion checks, and clean handoffs for any AI agent (Claude Code, Codex, Cursor). State lives as plain files in your repo. CLI + MCP, 0 runtime dependencies.",
   "keywords": [
     "leerness",