@wooojin/forgen 0.4.12 → 0.5.0

package/dist/core/dashboard.js

@@ -386,8 +386,7 @@ function renderMultiHost(data) {
     return lines.join('\n');
 }
 /**
- * Learning Curve 수집.
- * evidence 파일(교정 기록)과 compound 활용률을 교차 분석하여 "쓸수록 나아진다"를 정량화.
+ * 교정·활동 요약 수집 (관찰). evidence 파일(교정 기록) 기반. 인과 효과/절약은 미주장.
  */
 export function collectLearningCurve() {
     const now = Date.now();
@@ -429,14 +428,15 @@ export function collectLearningCurve() {
         }
     }
     catch { /* fail-open */ }
-    // 추세 판정: 전주 대비 30% 이상 감소 = improving, 30% 이상 증가 = worsening
-    let correctionTrend = 'stable';
+    // 추세: 전주 대비 카운트 델타의 *관찰* (30%↓=down, 30%↑=up). forgen 인과 효과가
+    // 아니라 단순 교정 횟수 변화 — 라벨도 개선/악화(가치 판단)가 아닌 감소/증가로 둔다.
+    let correctionTrend = 'flat';
     if (correctionsPrev7d > 0) {
         const delta = (correctionsLast7d - correctionsPrev7d) / correctionsPrev7d;
         if (delta < -0.3)
-            correctionTrend = 'improving';
+            correctionTrend = 'down';
         else if (delta > 0.3)
-            correctionTrend = 'worsening';
+            correctionTrend = 'up';
     }
     // 상위 교정 축
     const topCorrectionAxes = Array.from(axisCounts.entries())
@@ -445,59 +445,40 @@ export function collectLearningCurve() {
         .map(([axis, count]) => ({ axis, count }));
     // 세션 수: evidence 날짜 기준 (고유 날짜 × 평균 2세션/일 가정)
     const sessionsAnalyzed = uniqueDays.size * 2;
-    // 추정 절약 시간: 지난 7일 compound 주입 이벤트당 평균 8분 절약 가정
-    // (경쟁자 분석에서 도출한 경험적 수치 — 카운터팩추얼의 하한 추정)
-    const injection = collectInjectionActivity();
-    let successfulInjections = 0;
-    try {
-        for (const rec of injection.recentInjections ?? []) {
-            const ts = new Date(rec.ts).getTime();
-            if (Number.isFinite(ts) && now - ts < SEVEN_DAYS_MS)
-                successfulInjections++;
-        }
-    }
-    catch { /* fail-open */ }
-    const estimatedMinutesSaved = Math.round(successfulInjections * 8);
+    // (은퇴) estimatedMinutesSaved: "주입당 8분 절약" 카운터팩추얼은 honest-null 로 제거.
     return {
         correctionsLast7d,
         correctionsPrev7d,
         correctionTrend,
         evidenceTotalDays: uniqueDays.size,
         sessionsAnalyzed,
-        estimatedMinutesSaved,
         topCorrectionAxes,
     };
 }
 function renderLearningCurve(data) {
-    const trendIcon = data.correctionTrend === 'improving'
-        ? green('↓ 감소')
-        : data.correctionTrend === 'worsening'
-            ? red('↑ 증가')
+    // 관찰: 교정 카운트 델타. 개선/악화 색(가치 판단) 대신 중립 감소/증가 표기.
+    const trendIcon = data.correctionTrend === 'down'
+        ? dim('↓ 감소')
+        : data.correctionTrend === 'up'
+            ? dim('↑ 증가')
             : dim('→ 유지');
     const axisLines = data.topCorrectionAxes.length > 0
         ? data.topCorrectionAxes.map(a => `    ${a.axis}: ${a.count}회`).join('\n')
         : `    ${dim('(아직 교정 데이터 없음)')}`;
-    const savedHours = Math.floor(data.estimatedMinutesSaved / 60);
-    const savedMins = data.estimatedMinutesSaved % 60;
-    const savedStr = savedHours > 0 ? `${savedHours}시간 ${savedMins}분` : `${savedMins}분`;
     return [
-        `  ${bold('📈 Learning Curve / 학습 곡선')}`,
+        `  ${bold('📊 교정·활동 요약')} ${dim('(관찰 — 인과 효과/절약 미주장)')}`,
         ``,
         `  교정 추이 (지난 7일):`,
         `    이번 주: ${data.correctionsLast7d}건`,
         `    지난 주: ${data.correctionsPrev7d}건`,
-        `    추세: ${trendIcon}`,
+        `    카운트 변화: ${trendIcon} ${dim('(관찰치, forgen 효과 아님)')}`,
         ``,
         `  주요 교정 축 (누적):`,
         axisLines,
         ``,
-        `  누적 사용:`,
+        `  누적 활동:`,
         `    활동한 일수: ${data.evidenceTotalDays}일`,
         `    분석된 세션: 약 ${data.sessionsAnalyzed}회`,
-        ``,
-        `  ${cyan('추정 절약 시간')} (compound 주입 성공 기반):`,
-        `    ${bold(savedStr)} ${dim('(지난 7일)')}`,
-        `    ${dim('※ compound가 힌트를 제공한 매 1회당 평균 8분 절약 가정')}`,
     ].join('\n');
 }
 function renderFitnessSummary() {

package/dist/core/dev-cli.d.ts

@@ -0,0 +1,13 @@
+/**
+ * forgen dev — 개발/유지보수 명령 네임스페이스 (Wave 1 W1-3, feature-audit 2026-07-21).
+ *
+ * probe-workflow / parity / migrate / regress-map 은 개발·CI·스키마 유지보수용으로,
+ * 일반 사용자 표면(top-level)을 어지럽혔다. `forgen dev <sub>` 하나로 모아 사용자
+ * 명령 표면을 정리한다. 각 핸들러는 기존 것을 재사용.
+ *
+ *   forgen dev probe-workflow arm|report|status   ADR-009 §1 훅 발화 측정
+ *   forgen dev parity codex [--dry-run]            host parity (source 체크아웃 전용)
+ *   forgen dev migrate [implicit-feedback|...]     one-shot 스키마 마이그레이션
+ *   forgen dev regress-map [--days N --top N]      최근 fix 집중 파일
+ */
+export declare function handleDev(args: string[]): Promise<void>;

package/dist/core/dev-cli.js

@@ -0,0 +1,70 @@
+/**
+ * forgen dev — 개발/유지보수 명령 네임스페이스 (Wave 1 W1-3, feature-audit 2026-07-21).
+ *
+ * probe-workflow / parity / migrate / regress-map 은 개발·CI·스키마 유지보수용으로,
+ * 일반 사용자 표면(top-level)을 어지럽혔다. `forgen dev <sub>` 하나로 모아 사용자
+ * 명령 표면을 정리한다. 각 핸들러는 기존 것을 재사용.
+ *
+ *   forgen dev probe-workflow arm|report|status   ADR-009 §1 훅 발화 측정
+ *   forgen dev parity codex [--dry-run]            host parity (source 체크아웃 전용)
+ *   forgen dev migrate [implicit-feedback|...]     one-shot 스키마 마이그레이션
+ *   forgen dev regress-map [--days N --top N]      최근 fix 집중 파일
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+function printDevHelp() {
+    console.log(`
+  forgen dev — developer / maintenance utilities
+
+    forgen dev probe-workflow arm|report|status   Measure hook firing in dynamic-workflow subagents (ADR-009 §1)
+    forgen dev parity codex [--dry-run]            Host parity checks (source checkout only)
+    forgen dev migrate [target]                    One-shot schema migration
+    forgen dev regress-map [--days N --top N]      Top fix-touched files
+`);
+}
+async function runParity(args) {
+    const sub = args[0];
+    if (sub !== 'codex') {
+        console.log('Usage:\n  forgen dev parity codex [--dry-run]\n\nNotes:\n  - source 체크아웃에서만 작동합니다 (tests/ 디렉토리 필요).\n  - npm install 로 설치된 패키지에서는 run-parity.sh 가 없습니다.');
+        return;
+    }
+    const here = path.dirname(fileURLToPath(import.meta.url)); // dist/core
+    const scriptPath = path.resolve(here, '..', '..', 'tests', 'e2e', 'codex', 'run-parity.sh');
+    if (!fs.existsSync(scriptPath)) {
+        console.error('[forgen] run-parity.sh 는 source 체크아웃에서만 작동. 직접 git clone 후 실행하세요.');
+        console.error(`  expected: ${scriptPath}`);
+        process.exit(1);
+    }
+    const { spawnSync } = await import('node:child_process');
+    const dryRun = args.includes('--dry-run');
+    const result = spawnSync('bash', [scriptPath, ...(dryRun ? ['--dry-run'] : [])], { stdio: 'inherit' });
+    if (result.status !== 0)
+        process.exit(result.status ?? 1);
+}
+export async function handleDev(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+    switch (sub) {
+        case 'probe-workflow': {
+            const { handleProbeWorkflow } = await import('./probe-workflow-cli.js');
+            await handleProbeWorkflow(rest);
+            return;
+        }
+        case 'parity':
+            await runParity(rest);
+            return;
+        case 'migrate': {
+            const { handleMigrate } = await import('./migrate-cli.js');
+            await handleMigrate(rest);
+            return;
+        }
+        case 'regress-map': {
+            const { handleRegressMap } = await import('./regress-map-cli.js');
+            await handleRegressMap(rest);
+            return;
+        }
+        default:
+            printDevHelp();
+    }
+}

package/dist/core/doctor.d.ts

@@ -4,16 +4,27 @@ export interface DoctorOptions {
     pruneState?: boolean;
     /**
      * When true, auto-fix recoverable failures (e.g. missing plugin cache /
-     * stale installPath) by running `npm run build` + `node scripts/postinstall.js`
-     * inside the forgen install directory. Triggered by `forgen doctor --repair`.
+     * stale installPath) by running `node scripts/postinstall.js` inside the
+     * forgen install directory (`npm run build` 는 dist 부재 시에만 — W1-4).
+     * Triggered by `forgen doctor --repair`.
      *
-     * v0.4.8 (E3) — 이전엔 안내문 ("Fix: npm run build && node scripts/postinstall.js")
-     * 만 출력했고 사용자가 직접 실행해야 했음. fail-open: repair 실패해도
-     * doctor 흐름은 정상 종료.
+     * v0.4.8 (E3) — 이전엔 안내문만 출력. fail-open: repair 실패해도 doctor
+     * 흐름은 정상 종료. W1-4 (ADR-010) — 실행 사실이 아니라 재검증 결과를 보고.
      */
     repair?: boolean;
     /** When true, run only essential checks (Tools + Plugins + Directories +
      *  Initialization Status) for fast onboarding verification. ~10 lines output. */
     quick?: boolean;
+    /** W1-1 (ADR-010): tenetx/legacy 규칙 스프롤 스캔 (dry-run — 삭제는
+     *  `forgen migrate tenetx` 가 수행). native /doctor 가 비용을 flag 하면
+     *  forgen 이 provenance 로 안전하게 회수하는 보완 관계. */
+    reclaim?: boolean;
+    /** W2-1 (ADR-010): hook timing 표 등 상세 진단 표시. slow-hook 감지는
+     *  native /doctor 영역이라 기본 출력에서 강등됨 (수집은 유지). */
+    verbose?: boolean;
 }
+/** plugin cache 디렉토리에 버전 엔트리가 하나 이상 있는가 (check + repair 재검증 공용) */
+export declare function pluginCacheOk(): boolean;
+/** installed_plugins.json 의 forgen entry 가 존재하며 installPath 가 살아있는가 */
+export declare function pluginRegisteredOk(): boolean;
 export declare function runDoctor(opts?: DoctorOptions): Promise<void>;

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';
@@ -57,7 +57,7 @@ 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 +90,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 +143,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 +199,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 +256,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 +268,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 +379,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 +445,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 +507,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');
                 }
             }
         }
@@ -589,20 +571,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) {