@wooojin/forgen 0.4.13 → 0.5.5

package/dist/core/doctor.js

@@ -3,7 +3,7 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { execFileSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-import { FORGEN_HOME, LAB_DIR, ME_BEHAVIOR, ME_DIR, ME_SOLUTIONS, ME_RULES, ME_SKILLS, PACKS_DIR, SESSIONS_DIR, STATE_DIR, V1_SESSIONS_DIR } from './paths.js';
+import { FORGEN_HOME, LAB_DIR, ME_BEHAVIOR, ME_DIR, ME_SOLUTIONS, ME_RULES, PACKS_DIR, SESSIONS_DIR, STATE_DIR, V1_SESSIONS_DIR } from './paths.js';
 import { getTimingStats } from '../hooks/shared/hook-timing.js';
 import { countSessionScopedFiles, pruneState } from './state-gc.js';
 import { summarizeAllByHost } from '../store/host-mismatch.js';
@@ -52,12 +52,39 @@ function relativeTime(isoString) {
     }
     return `${diffDays}d ago`;
 }
+/** ADR-014 D4 — [Codex Hooks] 섹션: hooks.json forgen 엔트리의 Codex trust 기록 대조 */
+async function renderCodexHookTrust() {
+    try {
+        const codexHome = process.env.CODEX_HOME ?? path.join(os.homedir(), '.codex');
+        const hooksPath = path.join(codexHome, 'hooks.json');
+        if (!fs.existsSync(hooksPath))
+            return; // Codex 미설치/미등록 — 섹션 생략
+        const { auditCodexHookTrust } = await import('../host/install-codex.js');
+        // pkgRoot: dist/core/doctor.js → 두 단계 위. 어차피 FORGEN_HOOK_SCRIPT_MARKER fallback 이 있어 정확도 비의존.
+        const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+        const t = auditCodexHookTrust({ hooksPath, configTomlPath: path.join(codexHome, 'config.toml'), pkgRoot });
+        console.log('  [Codex Hooks]');
+        if (t.total === 0) {
+            console.log('  △ hooks.json 에 forgen hook 없음 — forgen install codex');
+        }
+        else if (t.trusted === t.total) {
+            console.log(`  ✓ ${t.trusted}/${t.total} forgen hooks trusted by Codex`);
+        }
+        else if (t.noStateRecorded) {
+            console.log(`  △ ${t.total} forgen hooks registered, Codex trust 기록 없음 — codex 안에서 /hooks 로 승인 (미승인 훅은 skip 됨)`);
+        }
+        else {
+            console.log(`  ✗ ${t.untrusted.length}/${t.total} forgen hooks untrusted (${t.untrusted.slice(0, 4).join(', ')}${t.untrusted.length > 4 ? ', …' : ''}) — codex 안에서 /hooks 로 승인`);
+        }
+    }
+    catch { /* fail-open */ }
+}
 /** [Codex Parity] 섹션 렌더링 — ~/.forgen/state/parity-result.json 신선도 검사 */
 function renderCodexParity() {
     console.log('  [Codex Parity]');
     const parityPath = path.join(STATE_DIR, 'parity-result.json');
     if (!fs.existsSync(parityPath)) {
-        console.log('  △ Codex parity 미실행 — tests/e2e/codex/run-parity.sh 또는 forgen parity codex');
+        console.log('  △ Codex parity 미실행 — tests/e2e/codex/run-parity.sh 또는 forgen dev parity codex');
         return;
     }
     let data;
@@ -90,10 +117,51 @@ function renderCodexParity() {
         console.log(`  ✓ Codex parity green (last run: ${timeStr},${version})`);
     }
 }
+/** plugin cache 디렉토리에 버전 엔트리가 하나 이상 있는가 (check + repair 재검증 공용) */
+export function pluginCacheOk() {
+    const pluginCacheBase = path.join(os.homedir(), '.claude', 'plugins', 'cache', 'forgen-local', 'forgen');
+    if (!exists(pluginCacheBase))
+        return false;
+    try {
+        return fs.readdirSync(pluginCacheBase).some(f => {
+            try {
+                const lstat = fs.lstatSync(path.join(pluginCacheBase, f));
+                return lstat.isDirectory() || lstat.isSymbolicLink();
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        return false;
+    }
+}
+/** installed_plugins.json 의 forgen entry 가 존재하며 installPath 가 살아있는가 */
+export function pluginRegisteredOk() {
+    const installedPluginsPath = path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+    if (!exists(installedPluginsPath))
+        return false;
+    try {
+        const installed = JSON.parse(fs.readFileSync(installedPluginsPath, 'utf-8'));
+        const entry = installed?.plugins?.['forgen@forgen-local'];
+        if (Array.isArray(entry) && entry.length > 0) {
+            const installPath = entry[0]?.installPath;
+            return !!installPath && exists(installPath);
+        }
+    }
+    catch { /* ignore */ }
+    return false;
+}
 /**
  * v0.4.8 (E3): plugin cache / installPath 진단이 실패했을 때 자동 복구.
- * forgen 패키지 디렉토리에서 `npm run build` + postinstall 을 차례로 실행.
  * 실패해도 doctor 자체는 계속 진행 (fail-open).
+ *
+ * W1-4 수정 (ADR-010, 실측 2026-07-16): 이전 구현은 무조건 `npm run build` 를
+ * 먼저 실행했는데, 글로벌 설치엔 devDeps(tsc)가 없어 MODULE_NOT_FOUND 로 실패
+ * → postinstall 에 도달하지 못해 캐시가 영원히 복구되지 않았다. published
+ * 패키지는 dist 가 이미 있으므로 build 는 dist 부재(dev checkout)시에만 시도.
+ * 또한 "실행했다"가 아니라 "복구됐다"를 재검증 후 보고한다.
  */
 function attemptPluginRepair() {
     try {
@@ -102,20 +170,53 @@ function attemptPluginRepair() {
         const here = path.dirname(fileURLToPath(import.meta.url));
         const pkgRoot = path.resolve(here, '..', '..');
         console.log(`\n  [Repair] forgen 패키지 자가복구 시도 — ${pkgRoot}`);
-        execFileSync('npm', ['run', 'build'], { cwd: pkgRoot, stdio: 'inherit' });
+        if (!exists(path.join(pkgRoot, 'dist', 'cli.js'))) {
+            // dev checkout 등 dist 부재 시에만 build (devDeps 가 있는 환경)
+            execFileSync('npm', ['run', 'build'], { cwd: pkgRoot, stdio: 'inherit' });
+        }
         execFileSync('node', ['scripts/postinstall.js'], { cwd: pkgRoot, stdio: 'inherit' });
-        console.log('  [Repair] 완료. 진단 재실행 권장: forgen doctor');
-        return true;
+        // 결과 재검증 — 성공 주장은 검증된 상태에만 한다.
+        const ok = pluginCacheOk() && pluginRegisteredOk();
+        if (ok) {
+            console.log('  [Repair] ✓ 복구 확인 — plugin cache/registry 재검증 통과');
+        }
+        else {
+            console.warn('  [Repair] ✗ postinstall 은 실행됐지만 재검증 실패 — 수동 확인 필요');
+            console.warn('  [Repair] 수동 복구: cd <forgen pkgRoot> && node scripts/postinstall.js');
+        }
+        return ok;
     }
     catch (e) {
         console.warn(`  [Repair] 실패: ${e instanceof Error ? e.message : String(e)}`);
-        console.warn('  [Repair] 수동 복구: cd <forgen pkgRoot> && npm run build && node scripts/postinstall.js');
+        console.warn('  [Repair] 수동 복구: cd <forgen pkgRoot> && node scripts/postinstall.js (dist 부재 시 npm run build 선행)');
         return false;
     }
 }
+/** W1-1: --reclaim 스캔 (읽기 전용) — full/quick 양쪽에서 재사용 */
+async function runReclaimScan() {
+    try {
+        const { runReclaim, printReclaimResult } = await import('./migrate-tenetx.js');
+        printReclaimResult(runReclaim({ cwd: process.cwd(), dryRun: true }));
+        console.log('    실제 회수: forgen migrate tenetx [--yes] [--apply-settings]');
+    }
+    catch (e) {
+        console.warn(`  [reclaim] 스캔 실패: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    console.log();
+}
+/** W1-4: repair 성공 시 Summary 에서 걷어내는 대상 — check() 라벨과 단일 소스 */
+const REPAIRABLE_PLUGIN_LABELS = Object.freeze({
+    cache: 'forgen plugin cache',
+    registered: 'forgen plugin registered & installPath exists',
+});
 export async function runDoctor(opts = {}) {
     failedChecks = [];
-    console.log('\n  Forgen — Diagnostics\n');
+    console.log('\n  Forgen — Diagnostics');
+    // ADR-010 W2-1 경계 선언: 일반 환경 건강(컨텍스트 비용, unused skill/MCP,
+    // CLAUDE.md 정리, slow hook)은 native /doctor 의 영역. 이 명령은 forgen
+    // 자체 기계(플러그인 캐시·훅 오류·상태 위생)와 효과-측정 게이트만 본다.
+    console.log('  환경 전반 진단은 Claude Code native /doctor 를 사용하세요.');
+    console.log('  이 명령은 forgen 자체 기계와 효과-측정 게이트를 검사합니다.\n');
     section('Tools');
     check('claude CLI', commandExists('claude'));
     check('tmux', commandExists('tmux'));
@@ -125,46 +226,24 @@ export async function runDoctor(opts = {}) {
     section('Plugins');
     const ralphLoopInstalled = exists(path.join(os.homedir(), '.claude', 'plugins', 'cache', 'claude-plugins-official', 'ralph-loop'));
     check('ralph-loop plugin', ralphLoopInstalled, 'Required for ralph mode auto-iteration. Install: claude plugins install ralph-loop');
-    // forgen 플러그인 캐시 디렉토리 확인 — 훅 실행의 필수 전제
-    const pluginCacheBase = path.join(os.homedir(), '.claude', 'plugins', 'cache', 'forgen-local', 'forgen');
-    let forgenPluginCacheOk = false;
-    if (exists(pluginCacheBase)) {
-        const versions = fs.readdirSync(pluginCacheBase).filter(f => {
-            try {
-                const lstat = fs.lstatSync(path.join(pluginCacheBase, f));
-                return lstat.isDirectory() || lstat.isSymbolicLink();
-            }
-            catch {
-                return false;
-            }
-        });
-        forgenPluginCacheOk = versions.length > 0;
-    }
-    check('forgen plugin cache', forgenPluginCacheOk, opts.repair
+    // forgen 플러그인 캐시 / registry 정합성 — 훅 실행의 필수 전제
+    const forgenPluginCacheOk = pluginCacheOk();
+    check(REPAIRABLE_PLUGIN_LABELS.cache, forgenPluginCacheOk, opts.repair
         ? 'Hook execution requires plugin cache. Attempting auto-repair (--repair)…'
-        : 'Hook execution requires plugin cache. Fix: npm run build && node scripts/postinstall.js (or rerun with --repair)');
-    // installed_plugins.json 정합성 확인
-    const installedPluginsPath = path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
-    let pluginRegistered = false;
-    if (exists(installedPluginsPath)) {
-        try {
-            const installed = JSON.parse(fs.readFileSync(installedPluginsPath, 'utf-8'));
-            const entry = installed?.plugins?.['forgen@forgen-local'];
-            if (Array.isArray(entry) && entry.length > 0) {
-                const installPath = entry[0]?.installPath;
-                pluginRegistered = !!installPath && exists(installPath);
-            }
-        }
-        catch { /* ignore */ }
-    }
-    check('forgen plugin registered & installPath exists', pluginRegistered, opts.repair
+        : 'Hook execution requires plugin cache. Fix: node scripts/postinstall.js in the forgen package (or rerun with --repair)');
+    const pluginRegistered = pluginRegisteredOk();
+    check(REPAIRABLE_PLUGIN_LABELS.registered, pluginRegistered, opts.repair
         ? 'Plugin registered but installPath missing on disk. Attempting auto-repair (--repair)…'
-        : 'Plugin registered but installPath missing on disk. Fix: npm run build && node scripts/postinstall.js (or rerun with --repair)');
-    // v0.4.8 (E3): plugin cache 또는 installPath 가 깨졌고 --repair 가 켜져
-    // 있으면 build + postinstall 자동 실행. doctor 진단 자체는 계속 진행하여
-    // 사용자가 다른 health 항목도 한 번에 확인 가능.
+        : 'Plugin registered but installPath missing on disk. Fix: node scripts/postinstall.js in the forgen package (or rerun with --repair)');
+    // v0.4.8 (E3) + W1-4: plugin cache 또는 installPath 가 깨졌고 --repair 가
+    // 켜져 있으면 자가복구. 재검증까지 통과하면 failedChecks 에서 해당 항목을
+    // 걷어내 Summary 가 복구된 상태를 정직하게 반영하게 한다.
     if (opts.repair && (!forgenPluginCacheOk || !pluginRegistered)) {
-        attemptPluginRepair();
+        const repaired = attemptPluginRepair();
+        if (repaired) {
+            const pluginLabels = new Set(Object.values(REPAIRABLE_PLUGIN_LABELS));
+            failedChecks = failedChecks.filter(f => !pluginLabels.has(f.label));
+        }
     }
     console.log();
     section('Directories');
@@ -204,6 +283,9 @@ export async function runDoctor(opts = {}) {
     }
     console.log();
     if (opts.quick) {
+        // --reclaim 은 읽기 전용 스캔이라 --quick 과 조합 가능 (silent-ignore 방지)
+        if (opts.reclaim)
+            await runReclaimScan();
         console.log();
         if (failedChecks.length === 0) {
             console.log('  All essential checks passed.\n');
@@ -213,9 +295,32 @@ export async function runDoctor(opts = {}) {
         }
         return;
     }
+    // 리뷰 SEV-3 (c): critic-review 룰의 트리거가 stale(skip-review 시그널 미포함)이면 발견 nudge.
+    // "고쳤는데 기존 유저에겐 안 닿는" 상태 방지 — 재-bake 명령을 안내한다.
+    section('Rules');
+    try {
+        const [{ loadActiveRules }, { needsCriticTriggerMigration }] = await Promise.all([
+            import('../store/rule-store.js'),
+            import('../engine/enforce-classifier.js'),
+        ]);
+        const outdated = loadActiveRules().filter(needsCriticTriggerMigration);
+        check('critic-review 룰 트리거 최신', outdated.length === 0, `${outdated.length}개 critic 룰이 구 트리거(skip-review 미포함) — \`forgen rule classify --apply --force\` 로 갱신 권장`);
+    }
+    catch {
+        /* rule-store 로드 실패는 무해 — 스킵 */
+    }
+    console.log();
     section('Environment');
     check('Inside tmux session', !!process.env.TMUX, 'FORGEN auto-compound relies on tmux. Launch: tmux new -s forgen');
     check('FORGEN_HARNESS env var', (process.env.FORGEN_HARNESS ?? process.env.COMPOUND_HARNESS) === '1', 'Set by `forgen` / `fgx` launcher. Hooks assume harness mode is active.');
+    // ADR-012: auto-compound Haiku 추출 동의 상태 고지 (transcript 요약 API 전송 여부).
+    try {
+        const { getHaikuConsentState } = await import('./compound-consent.js');
+        const s = getHaikuConsentState();
+        console.log(`  auto-compound Haiku 추출: ${s.enabled ? 'ON' : 'OFF'} (${s.source}) — ` +
+            `${s.enabled ? '세션 요약이 Haiku 로 전송됨' : '결정론 룰 승급만(egress 0)'}. 변경: forgen compound consent on|off`);
+    }
+    catch { /* noop */ }
     console.log();
     // v0.4.1 파일 확장자 버그 수정: rules 는 .json, behavior 도 대부분 .json 포맷.
     // 이전에 .md 만 count 해서 실 rules 4개인데 0 으로 표시되는 incident 관찰.
@@ -301,26 +406,28 @@ export async function runDoctor(opts = {}) {
         console.log('  Unable to read hook error log.');
     }
     console.log();
-    // Hook Timing: performance stats
-    console.log('  [Hook Timing]');
-    const timingStats = getTimingStats();
-    if (timingStats.length === 0) {
-        console.log('  No timing data collected yet.');
-    }
-    else {
-        console.log('  Hook                  Count   p50ms   p95ms   max ms');
-        console.log(`  ${'-'.repeat(56)}`);
-        for (const s of timingStats) {
-            const hook = s.hook.padEnd(22);
-            const count = String(s.count).padStart(5);
-            const p50 = String(s.p50).padStart(7);
-            const p95 = String(s.p95).padStart(7);
-            const max = String(s.max).padStart(8);
-            console.log(`  ${hook}${count}${p50}${p95}${max}`);
+    // Hook Timing: W2-1 (ADR-010) — slow hook 감지는 native /doctor 가 하므로
+    // 표시는 --verbose 로 강등. 수집(hook-timing.jsonl)은 자체 회귀 테스트용으로 유지.
+    if (opts.verbose) {
+        console.log('  [Hook Timing]');
+        const timingStats = getTimingStats();
+        if (timingStats.length === 0) {
+            console.log('  No timing data collected yet.');
         }
+        else {
+            console.log('  Hook                  Count   p50ms   p95ms   max ms');
+            console.log(`  ${'-'.repeat(56)}`);
+            for (const s of timingStats) {
+                const hook = s.hook.padEnd(22);
+                const count = String(s.count).padStart(5);
+                const p50 = String(s.p50).padStart(7);
+                const p95 = String(s.p95).padStart(7);
+                const max = String(s.max).padStart(8);
+                console.log(`  ${hook}${count}${p50}${p95}${max}`);
+            }
+        }
+        console.log();
     }
-    console.log();
-    console.log();
     // v1: 팀 팩 시스템 제거. 개인 모드만 지원.
     console.log('  [Pack Connections]');
     console.log('  v1: Personal mode only (team packs removed)');
@@ -365,107 +472,9 @@ export async function runDoctor(opts = {}) {
             console.log();
         }
     }
-    // Harness Maturity section
-    console.log('  [Harness Maturity]');
-    const cwd = process.cwd();
-    // 1. Preparation
-    const hasClaude = fs.existsSync(path.join(cwd, 'CLAUDE.md'));
-    let rulesCount = 0;
-    try {
-        const rulesDir = path.join(cwd, '.claude', 'rules');
-        if (fs.existsSync(rulesDir)) {
-            rulesCount = fs.readdirSync(rulesDir).filter(f => f.endsWith('.md')).length;
-        }
-    }
-    catch { /* fail-open */ }
-    let hooksActive = 0;
-    try {
-        const hooksJsonPath = path.join(cwd, 'hooks', 'hooks.json');
-        if (fs.existsSync(hooksJsonPath)) {
-            const hooksData = JSON.parse(fs.readFileSync(hooksJsonPath, 'utf-8'));
-            if (hooksData.hooks && typeof hooksData.hooks === 'object') {
-                for (const eventHooks of Object.values(hooksData.hooks)) {
-                    if (Array.isArray(eventHooks)) {
-                        for (const group of eventHooks) {
-                            if (Array.isArray(group.hooks)) {
-                                hooksActive += (group.hooks).length;
-                            }
-                        }
-                    }
-                }
-            }
-        }
-    }
-    catch { /* fail-open */ }
-    const prepL = hasClaude && rulesCount >= 3 && hooksActive > 0 ? 'L3' : hasClaude && hooksActive > 0 ? 'L2' : hasClaude ? 'L1' : 'L0';
-    // 2. Context
-    let solutionsCount = 0;
-    try {
-        if (exists(ME_SOLUTIONS))
-            solutionsCount = fs.readdirSync(ME_SOLUTIONS).filter(f => f.endsWith('.md')).length;
-    }
-    catch { /* fail-open */ }
-    let behaviorCount = 0;
-    try {
-        if (exists(ME_BEHAVIOR))
-            behaviorCount = fs.readdirSync(ME_BEHAVIOR).filter(f => f.endsWith('.md')).length;
-    }
-    catch { /* fail-open */ }
-    const ctxL = solutionsCount >= 5 && behaviorCount >= 3 ? 'L3' : solutionsCount >= 3 || behaviorCount >= 1 ? 'L2' : solutionsCount > 0 || behaviorCount > 0 ? 'L1' : 'L0';
-    // 3. Execution
-    const hasSkills = exists(ME_SKILLS);
-    const execL = hasSkills ? 'L2' : 'L1';
-    // 4. Validation
-    const hasTests = fs.existsSync(path.join(cwd, 'tests'));
-    const hasCI = fs.existsSync(path.join(cwd, '.github', 'workflows'));
-    const validL = hasTests && hasCI ? 'L3' : hasTests ? 'L2' : 'L1';
-    // 5. Improvement: reflection rate from solutions
-    let reflectionRate = 0;
-    try {
-        if (exists(ME_SOLUTIONS)) {
-            const solFiles = fs.readdirSync(ME_SOLUTIONS).filter(f => f.endsWith('.md'));
-            if (solFiles.length > 0) {
-                let reflected = 0;
-                for (const f of solFiles) {
-                    try {
-                        const content = fs.readFileSync(path.join(ME_SOLUTIONS, f), 'utf-8');
-                        const match = content.match(/reflected:\s*(\d+)/);
-                        if (match && parseInt(match[1], 10) > 0)
-                            reflected++;
-                    }
-                    catch { /* skip */ }
-                }
-                reflectionRate = Math.round((reflected / solFiles.length) * 100);
-            }
-        }
-    }
-    catch { /* fail-open */ }
-    const improvL = reflectionRate > 0 ? 'L3' : solutionsCount > 0 ? 'L2' : 'L1';
-    const levelIcon = (l) => l === 'L3' ? '✓' : l === 'L2' ? '✓' : l === 'L1' ? '✗' : '✗';
-    console.log(`  Axis               Level  Detail`);
-    console.log(`  ${'─'.repeat(55)}`);
-    console.log(`  ${levelIcon(prepL)} Preparation        ${prepL}     CLAUDE.md:${hasClaude ? 'yes' : 'no'}, rules:${rulesCount}, hooks:${hooksActive}`);
-    console.log(`  ${levelIcon(ctxL)} Context            ${ctxL}     solutions:${solutionsCount}, behavior:${behaviorCount}`);
-    console.log(`  ${levelIcon(execL)} Execution          ${execL}     skills:${hasSkills ? 'yes' : 'no'}`);
-    console.log(`  ${levelIcon(validL)} Validation         ${validL}     tests:${hasTests ? 'yes' : 'no'}, CI:${hasCI ? 'yes' : 'no'}`);
-    console.log(`  ${levelIcon(improvL)} Improvement        ${improvL}     reflection:${reflectionRate}%`);
-    console.log();
-    // Quick wins: suggest for lowest scoring axes
-    const axes = [
-        { name: 'Preparation', level: prepL, hint: 'Add CLAUDE.md + .claude/rules/ files' },
-        { name: 'Context', level: ctxL, hint: 'Run /compound to accumulate solutions' },
-        { name: 'Execution', level: execL, hint: 'Promote solutions to skills' },
-        { name: 'Validation', level: validL, hint: 'Add tests/ dir and .github/workflows' },
-        { name: 'Improvement', level: improvL, hint: 'Reflect on existing solutions' },
-    ];
-    const quickWins = axes.filter(a => a.level === 'L0' || a.level === 'L1').slice(0, 3);
-    if (quickWins.length > 0) {
-        console.log('  Quick Wins (Top 3):');
-        for (const win of quickWins) {
-            console.log(`  → ${win.name}: ${win.hint}`);
-        }
-        console.log();
-    }
+    // W2-1 (ADR-010): Harness Maturity / Quick Wins 섹션 제거 —
+    // "CLAUDE.md 추가하세요" 류 일반 셋업 조언은 native /doctor 영역.
+    // forgen 고유 진단(아래 State Hygiene, ψ-long, parity 등)만 유지한다.
     // State bloat check — session-scoped files accumulate until pruned.
     console.log('  [State Hygiene]');
     const sessionFiles = countSessionScopedFiles();
@@ -525,7 +534,7 @@ export async function runDoctor(opts = {}) {
                 if (map.available && map.hotspots.length > 0) {
                     const top = map.hotspots.map((h) => `${h.path} (${h.fixHits})`).join(', ');
                     console.log(`  → 진앙 후보 top 3: ${top}`);
-                    console.log('  → 전체 보기: forgen regress-map');
+                    console.log('  → 전체 보기: forgen dev regress-map');
                 }
             }
         }
@@ -556,6 +565,8 @@ export async function runDoctor(opts = {}) {
         console.log('  Unable to read host evidence data.');
     }
     console.log();
+    // [Codex Hooks] — ADR-014 D4 trust 감사
+    await renderCodexHookTrust();
     // [Codex Parity] — parity-result.json 신선도 검사 (v0.4.2 패턴 확장)
     renderCodexParity();
     console.log();
@@ -589,20 +600,23 @@ export async function runDoctor(opts = {}) {
         console.log(`  Unable to read psi-long state: ${e instanceof Error ? e.message : 'unknown'}`);
     }
     console.log();
-    // [Effort (Opus 4.8)] — ADR-009 §5. nudge-only: forgen 은 effort 를 직접 설정할 수
-    // 없으므로 long-running 컨텍스트(forge-loop)에서 xhigh/ultracode 를 권고만 한다.
-    console.log('  [Effort (Opus 4.8)]');
+    // [Effort] — ADR-009 §5 nudge-only. W2-1 (ADR-010): Sonnet 5 는 adaptive
+    // thinking 으로 effort 를 자체 관리하므로, 권고가 실제로 의미 있는 상황
+    // (forge-loop 활성 = long-running → xhigh 넛지)에서만 표시한다.
     try {
         const loopActive = !!readForgeLoopState()?.active;
-        const adv = effortAdvisory({ longRunningActive: loopActive });
-        const icon = adv.recommend === 'xhigh' ? '→' : '✓';
-        console.log(`  ${icon} recommend: ${adv.recommend}`);
-        console.log(`    ${adv.reason}`);
-    }
-    catch {
-        console.log('  Unable to compute effort advisory.');
+        if (loopActive) {
+            const adv = effortAdvisory({ longRunningActive: true });
+            console.log('  [Effort]');
+            console.log(`  → recommend: ${adv.recommend}`);
+            console.log(`    ${adv.reason}`);
+            console.log();
+        }
     }
-    console.log();
+    catch { /* effort 권고 실패는 침묵 — 부가 정보일 뿐 */ }
+    // W1-1 (ADR-010): --reclaim → legacy 규칙 스프롤 스캔 (읽기 전용).
+    if (opts.reclaim)
+        await runReclaimScan();
     // [Summary] — 최종 상태 요약과 복구 액션을 한눈에 보이게
     console.log('  [Summary]');
     if (failedChecks.length === 0) {

package/dist/core/drift-score.d.ts

@@ -20,6 +20,8 @@ export interface DriftState {
     lastWarningAt: number;
     lastCriticalAt: number;
     hardCapReached: boolean;
+    /** 최근 hardcap 발화 timestamp (쿨다운용, ADR-013). */
+    lastHardcapAt?: number;
 }
 export interface DriftResult {
     level: 'normal' | 'warning' | 'critical' | 'hardcap';

package/dist/core/drift-score.js

@@ -54,9 +54,17 @@ export function evaluateDrift(state, isEdit, isRevert, thresholds = {}) {
     // Calculate drift score: edit rate 65% + revert rate 35%
     const rawScore = (state.ewmaEditRate * 65) + (state.ewmaRevertRate * 35);
     const score = Math.min(100, Math.max(0, Math.round(rawScore)));
-    // Hard cap
+    // Hard cap — ADR-013 버그수정: 이전엔 cooldown 이 없어 50편집 넘으면 **매 편집마다**
+    // hardcap(=drift_critical) 을 발화 → drift_critical 이 세션길이 카운터로 전락(2067/2100
+    // 이벤트가 score100). critical 처럼 cooldown 게이트를 둬 반복 발화를 억제. 상태
+    // (hardCapReached)는 항상 갱신하되, message 는 쿨다운 밖에서만 낸다(null=emitter skip).
     if (state.totalEdits >= t.hardCapEdits) {
         state.hardCapReached = true;
+        const withinCooldown = now - (state.lastHardcapAt ?? 0) <= t.criticalCooldownMs;
+        if (withinCooldown) {
+            return { level: 'hardcap', score: 100, message: null };
+        }
+        state.lastHardcapAt = now;
         return {
             level: 'hardcap',
             score: 100,