@wooojin/forgen 0.4.13 → 0.5.5

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>;