@wooojin/forgen 0.3.2 → 0.4.1

package/dist/cli.js

@@ -169,13 +169,157 @@ const commands = [
     // 수동 재설치: node scripts/postinstall.js
     {
         name: 'uninstall',
-        description: 'Remove forgen from settings [--force]',
+        description: 'Remove forgen from settings [--force] [--purge (also deletes ~/.forgen/)]',
         handler: async (args) => {
             const { handleUninstall } = await import('./core/uninstall.js');
-            await handleUninstall(process.cwd(), { force: args.includes('--force') });
+            await handleUninstall(process.cwd(), {
+                force: args.includes('--force'),
+                purge: args.includes('--purge'),
+            });
+        },
+    },
+    {
+        name: 'rule',
+        description: 'Rule management (list|suppress|activate|scan|health-scan|classify)',
+        handler: async (args) => {
+            await handleRuleNamespace(args);
+        },
+    },
+    {
+        name: 'classify-enforce',
+        aliases: ['rule-classify'],
+        description: '[alias: rule classify] Propose enforce_via for rules (ADR-001 migration).',
+        handler: async (args) => {
+            const { handleClassifyEnforce } = await import('./engine/classify-enforce-cli.js');
+            await handleClassifyEnforce(args);
+        },
+    },
+    {
+        name: 'rule-meta-scan',
+        description: '[alias: rule health-scan] Scan drift for stuck-loop events and demote Mech-A rules.',
+        handler: async (args) => {
+            const { handleRuleMetaScan } = await import('./engine/lifecycle/meta-cli.js');
+            await handleRuleMetaScan(args);
+        },
+    },
+    {
+        name: 'lifecycle-scan',
+        description: '[alias: rule scan] Run all rule lifecycle triggers (T1~T5 + Meta).',
+        handler: async (args) => {
+            const { handleLifecycleScan } = await import('./engine/lifecycle/lifecycle-cli.js');
+            await handleLifecycleScan(args);
+        },
+    },
+    {
+        name: 'stats',
+        description: 'One-screen dashboard: active rules, corrections, blocks/bypass/drift (7d).',
+        handler: async (args) => {
+            const { handleStats } = await import('./core/stats-cli.js');
+            await handleStats(args);
+        },
+    },
+    {
+        name: 'last-block',
+        description: 'Show the most recent Mech-A/B block event with rule detail (R6-UX2).',
+        handler: async (_args) => {
+            const { handleInspect } = await import('./core/inspect-cli.js');
+            await handleInspect(['violations', '--last', '1']);
+        },
+    },
+    {
+        name: 'recall',
+        description: 'Show recent compound recalls (matched solutions) with optional body preview.',
+        handler: async (args) => {
+            const { handleRecall } = await import('./core/recall-cli.js');
+            await handleRecall(args);
+        },
+    },
+    {
+        name: 'migrate',
+        description: 'One-shot schema migrations (implicit-feedback category backfill).',
+        handler: async (args) => {
+            const { handleMigrate } = await import('./core/migrate-cli.js');
+            await handleMigrate(args);
+        },
+    },
+    {
+        name: 'suppress-rule',
+        description: '[alias: rule suppress] Disable a rule by id/prefix. Hard rules refused.',
+        handler: async (args) => {
+            const { handleSuppressRule } = await import('./engine/rule-toggle-cli.js');
+            await handleSuppressRule(args);
+        },
+    },
+    {
+        name: 'activate-rule',
+        description: '[alias: rule activate] Re-activate a suppressed rule by id/prefix.',
+        handler: async (args) => {
+            const { handleActivateRule } = await import('./engine/rule-toggle-cli.js');
+            await handleActivateRule(args);
         },
     },
 ];
+// ---------------------------------------------------------------------------
+// `forgen rule <subcommand>` — user-facing namespace (R9-IA1)
+// Thin dispatcher that routes to existing handlers. Top-level legacy commands
+// (suppress-rule, activate-rule, lifecycle-scan, rule-meta-scan, classify-enforce)
+// remain as backward-compatible aliases.
+// ---------------------------------------------------------------------------
+async function handleRuleNamespace(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+    if (!sub || sub === 'help' || sub === '--help' || sub === '-h') {
+        console.log(`
+  forgen rule — manage personalization rules
+
+  Usage:
+    forgen rule list                       List all rules (alias: inspect rules)
+    forgen rule suppress <id-or-prefix>    Disable a rule (hard rules refused)
+    forgen rule activate <id-or-prefix>    Re-activate a suppressed rule
+    forgen rule scan [--apply]             Run lifecycle triggers (promote/demote/retire)
+    forgen rule health-scan [--apply]      Scan drift → Mech downgrade candidates
+    forgen rule classify [--apply] [--force]
+                                           Propose enforce_via for legacy rules
+`);
+        return;
+    }
+    switch (sub) {
+        case 'list': {
+            const { handleInspect } = await import('./core/inspect-cli.js');
+            await handleInspect(['rules', ...rest]);
+            return;
+        }
+        case 'suppress': {
+            const { handleSuppressRule } = await import('./engine/rule-toggle-cli.js');
+            await handleSuppressRule(rest);
+            return;
+        }
+        case 'activate': {
+            const { handleActivateRule } = await import('./engine/rule-toggle-cli.js');
+            await handleActivateRule(rest);
+            return;
+        }
+        case 'scan': {
+            const { handleLifecycleScan } = await import('./engine/lifecycle/lifecycle-cli.js');
+            await handleLifecycleScan(rest);
+            return;
+        }
+        case 'health-scan': {
+            const { handleRuleMetaScan } = await import('./engine/lifecycle/meta-cli.js');
+            await handleRuleMetaScan(rest);
+            return;
+        }
+        case 'classify': {
+            const { handleClassifyEnforce } = await import('./engine/classify-enforce-cli.js');
+            await handleClassifyEnforce(rest);
+            return;
+        }
+        default: {
+            console.error(`[forgen] Unknown rule subcommand: ${sub}\n  Run "forgen rule help" for options.`);
+            process.exit(1);
+        }
+    }
+}
 /** 최소 편집 거리 (유사 명령 제안용) */
 function levenshtein(a, b) {
     const m = a.length, n = b.length;
@@ -298,17 +442,25 @@ function printHelp() {
   Commands:
     forgen forge                    Personalize your coding profile
     forgen onboarding               Run 2-question onboarding
-    forgen inspect [profile|rules|evidence|session]
-                                    Inspect v1 state
+    forgen inspect [profile|rules|corrections|session]
+                                    Inspect v1 state (alias: evidence → corrections)
+    forgen rule <list|suppress|activate|scan|health-scan|classify>
+                                    Rule management (see: forgen rule help)
+    forgen stats                    One-screen trust-layer dashboard (+ philosophy)
+    forgen last-block               Show the most recent block event
+    forgen recall [--limit N] [--show]
+                                    최근 compound 주입 이력 (solution body preview)
+    forgen migrate [implicit-feedback|all]
+                                    One-shot schema migration (category backfill)
     forgen compound                 Manage accumulated knowledge
     forgen dashboard                Compound system dashboard
     forgen me                       Personal dashboard
-    forgen init                     Initialize project
+    forgen init                     Initialize project (+ starter-pack solutions)
     forgen config hooks             Hook management
     forgen mcp                      MCP server management
     forgen skill promote|list       Skill management
     forgen notepad show|add|clear   Session notepad
-    forgen doctor                   System diagnostics
+    forgen doctor [--prune-state]   System diagnostics (+ daily T4 decay on prune)
     forgen uninstall                Remove forgen
 
   Harness mode (default):

package/dist/core/auto-compound-runner.js

@@ -11,11 +11,12 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import * as os from 'node:os';
 import { execFileSync } from 'node:child_process';
 import { containsPromptInjection, filterSolutionContent } from '../hooks/prompt-injection-filter.js';
+import { redactSecrets } from '../hooks/secret-filter.js';
 import { createEvidence, saveEvidence, promoteSessionCandidates } from '../store/evidence-store.js';
 import { loadProfile } from '../store/profile-store.js';
+import { FORGEN_HOME, ME_DIR } from './paths.js';
 /** Auto-compound에 사용할 모델 — background 추출이므로 haiku로 충분 */
 const COMPOUND_MODEL = 'haiku';
 /** execFileSync wrapper: transient 에러(ETIMEDOUT 등) 시 1회 재시도 */
@@ -48,9 +49,8 @@ const [, , cwd, transcriptPath, sessionId] = process.argv;
 if (!cwd || !transcriptPath || !sessionId) {
     process.exit(1);
 }
-const FORGEN_HOME = path.join(os.homedir(), '.forgen');
-const SOLUTIONS_DIR = path.join(FORGEN_HOME, 'me', 'solutions');
-const BEHAVIOR_DIR = path.join(FORGEN_HOME, 'me', 'behavior');
+const SOLUTIONS_DIR = path.join(ME_DIR, 'solutions');
+const BEHAVIOR_DIR = path.join(ME_DIR, 'behavior');
 /** Lightweight quality gate for auto-extracted solution files */
 /** Toxicity patterns — code-context only to avoid false positives on prose */
 const SOLUTION_TOXICITY_PATTERNS = [/@ts-ignore/i, /:\s*any\b/, /\/\/\s*TODO\b/];
@@ -212,9 +212,16 @@ function mergeOrCreateBehavior(dir, newContent, kind, today) {
     return false;
 }
 try {
-    const summary = extractSummary(transcriptPath);
-    if (summary.length < 200)
+    const rawSummary = extractSummary(transcriptPath);
+    if (rawSummary.length < 200)
         process.exit(0);
+    // R5-G2 (P0 security): transcript 를 Claude 로 송신하기 전 API key / 토큰 / 비밀번호 /
+    // private key blocks 를 [REDACTED:...] 로 치환. 사용자가 채팅에 pasted 한 자격증명이
+    // auto-compound 를 통해 외부 API 로 누출되는 채널 차단.
+    const { redacted: summary, hits: secretHits } = redactSecrets(rawSummary);
+    if (secretHits.length > 0) {
+        process.stderr.write(`[forgen-auto-compound] redacted ${secretHits.length} secret(s) before send: ${secretHits.map((s) => s.name).join(', ')}\n`);
+    }
     // 보안: 프롬프트 인젝션이 포함된 transcript는 분석하지 않음
     if (containsPromptInjection(summary)) {
         process.exit(0);
@@ -375,10 +382,8 @@ ${sanitizedSummary.slice(0, 4000)}
     }
     // 3단계: 세션 학습 요약 (SessionLearningSummary) 생성
     try {
-        const FORGEN_HOME = path.join(os.homedir(), '.forgen');
-        const V1_ME_DIR = path.join(FORGEN_HOME, 'me');
-        const V1_PROFILE = path.join(V1_ME_DIR, 'forge-profile.json');
-        const V1_EVIDENCE_DIR = path.join(V1_ME_DIR, 'behavior');
+        const V1_PROFILE = path.join(ME_DIR, 'forge-profile.json');
+        const V1_EVIDENCE_DIR = path.join(ME_DIR, 'behavior');
         if (fs.existsSync(V1_PROFILE)) {
             const currentProfile = loadProfile();
             let profileContext = '';
@@ -477,8 +482,9 @@ ${sanitizedSummary.slice(0, 4000)}
         process.stderr.write(`[forgen-auto-compound] session learning: ${e instanceof Error ? e.message : String(e)}\n`);
     }
     // Step 4: prefer-from-now / avoid-this 교정 → scope:'me' 영구 규칙 승격
+    let promotedCount = 0;
     try {
-        const promotedCount = promoteSessionCandidates(sessionId);
+        promotedCount = promoteSessionCandidates(sessionId);
         if (promotedCount > 0) {
             process.stderr.write(`[forgen-auto-compound] promoted ${promotedCount} correction(s) to permanent rules\n`);
         }
@@ -486,6 +492,21 @@ ${sanitizedSummary.slice(0, 4000)}
     catch (e) {
         process.stderr.write(`[forgen-auto-compound] rule promotion: ${e instanceof Error ? e.message : String(e)}\n`);
     }
+    // H2: count newly extracted solutions (post-quality-gate) for Stop hook 알림.
+    // solutionsBefore 스냅샷 vs 현재 디스크 상태 차분 → "N개 패턴 학습됨" 1줄.
+    let extractedSolutionsCount = 0;
+    try {
+        if (fs.existsSync(SOLUTIONS_DIR)) {
+            const current = fs.readdirSync(SOLUTIONS_DIR).filter((f) => f.endsWith('.md'));
+            for (const f of current) {
+                if (!solutionsBefore.has(f))
+                    extractedSolutionsCount++;
+            }
+        }
+    }
+    catch (e) {
+        process.stderr.write(`[forgen-auto-compound] solution count failed: ${e instanceof Error ? e.message : String(e)}\n`);
+    }
     // Step 5: meta-learning (HyperAgents-inspired self-tuning)
     try {
         const { runMetaLearning } = await import('../engine/meta-learning/runner.js');
@@ -500,10 +521,61 @@ ${sanitizedSummary.slice(0, 4000)}
     catch (e) {
         process.stderr.write(`[forgen-meta] ${e instanceof Error ? e.message : String(e)}\n`);
     }
-    // 완료 기록
+    // Step 5.5 (v0.4.1): state hygiene — 세션 스코프 ephemeral 파일 7일 retention
+    // 자동 정리. 이전에는 `forgen doctor --prune-state` 수동만 있어서 injection-cache
+    // 2343 / modified-files 431 처럼 수천 파일 누적. 몇 달 사용하면 10만+ 파일 → stat
+    // 호출 느려지고 디스크 낭비. auto-compound 마다 호출되면 자연스레 정돈.
+    try {
+        const { pruneState } = await import('./state-gc.js');
+        const report = pruneState({ dryRun: false });
+        if (report.pruned > 0) {
+            const mb = (report.bytesFreed / 1024 / 1024).toFixed(2);
+            process.stderr.write(`[forgen-gc] pruned ${report.pruned} stale state files (${mb} MB freed)\n`);
+        }
+    }
+    catch (e) {
+        process.stderr.write(`[forgen-gc] state prune failed: ${e instanceof Error ? e.message : String(e)}\n`);
+    }
+    // Step 6 (v0.4.1): rule lifecycle 자동 실행 — rule 의 violations/bypass/drift
+    // 신호에 따른 자동 강등/승격. 이전에는 CLI (`forgen rule scan --apply`) 수동
+    // 호출만 있어서 구매자가 몇 주 써도 rule 정비 안 됨 → 쓸모없는 rule 이 계속
+    // active. 판매 관점 심각한 "자동 학습 단절". auto-compound-runner 끝에 자동
+    // 실행해 세션마다 rule 품질 유지.
+    try {
+        const { handleLifecycleScan } = await import('../engine/lifecycle/lifecycle-cli.js');
+        // silent mode 로 돌리기 위해 stdout 을 임시 리다이렉트 (내부가 console.log 씀)
+        const origLog = console.log;
+        let applied = 0;
+        console.log = (...args) => {
+            const msg = args.join(' ');
+            const match = msg.match(/apply(?:ied)?\s+(\d+)/i);
+            if (match)
+                applied = Number(match[1]);
+        };
+        try {
+            await handleLifecycleScan(['--apply']);
+        }
+        finally {
+            console.log = origLog;
+        }
+        if (applied > 0) {
+            process.stderr.write(`[forgen-meta] rule lifecycle: ${applied} event(s) applied\n`);
+        }
+    }
+    catch (e) {
+        process.stderr.write(`[forgen-meta] lifecycle scan failed: ${e instanceof Error ? e.message : String(e)}\n`);
+    }
+    // 완료 기록 — H2: Stop hook 알림용으로 extractedSolutions / promotedRules 포함.
+    // noticeShown=false 로 시작해서 Stop hook 가 최초 1회만 surface.
     const statePath = path.join(FORGEN_HOME, 'state', 'last-auto-compound.json');
     fs.mkdirSync(path.dirname(statePath), { recursive: true });
-    fs.writeFileSync(statePath, JSON.stringify({ sessionId, completedAt: new Date().toISOString() }));
+    fs.writeFileSync(statePath, JSON.stringify({
+        sessionId,
+        completedAt: new Date().toISOString(),
+        extractedSolutions: extractedSolutionsCount,
+        promotedRules: promotedCount,
+        noticeShown: false,
+    }));
 }
 catch (e) {
     process.stderr.write(`[forgen-auto-compound] ${e instanceof Error ? e.message : String(e)}\n`);

package/dist/core/dashboard.js

@@ -372,9 +372,15 @@ export function collectLearningCurve() {
             const files = fs.readdirSync(ME_BEHAVIOR).filter(f => f.endsWith('.json'));
             for (const f of files) {
                 try {
+                    // v0.4.1 정확도 수정: "교정 추이" 라벨은 explicit_correction evidence 만 포함.
+                    // 이전에는 behavior_observation + session_summary 까지 전부 "교정" 으로
+                    // 카운트되어 실측 488건 중 ~1건만 실제 교정인데 신뢰도 훼손. axis_hint 는
+                    // raw_payload 에도 저장되므로 fallback 체크.
                     const data = JSON.parse(fs.readFileSync(path.join(ME_BEHAVIOR, f), 'utf-8'));
                     if (!data.timestamp)
                         continue;
+                    if (data.type && data.type !== 'explicit_correction')
+                        continue;
                     const ts = new Date(data.timestamp).getTime();
                     if (!Number.isFinite(ts))
                         continue;
@@ -383,8 +389,9 @@ export function collectLearningCurve() {
                         correctionsLast7d++;
                     else if (age < 2 * SEVEN_DAYS_MS)
                         correctionsPrev7d++;
-                    if (data.axis_hint) {
-                        axisCounts.set(data.axis_hint, (axisCounts.get(data.axis_hint) ?? 0) + 1);
+                    const axisHint = data.axis_hint ?? data.raw_payload?.axis_hint;
+                    if (axisHint) {
+                        axisCounts.set(axisHint, (axisCounts.get(axisHint) ?? 0) + 1);
                     }
                     uniqueDays.add(new Date(ts).toISOString().slice(0, 10));
                 }

package/dist/core/doctor.js

@@ -2,15 +2,24 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { execFileSync } from 'node:child_process';
-import { FORGEN_HOME, LAB_DIR, ME_BEHAVIOR, ME_DIR, ME_PHILOSOPHY, ME_SOLUTIONS, ME_RULES, ME_SKILLS, PACKS_DIR, SESSIONS_DIR, STATE_DIR } from './paths.js';
+import { FORGEN_HOME, LAB_DIR, ME_BEHAVIOR, ME_DIR, ME_SOLUTIONS, ME_RULES, ME_SKILLS, PACKS_DIR, SESSIONS_DIR, STATE_DIR } from './paths.js';
 import { getTimingStats } from '../hooks/shared/hook-timing.js';
 import { countSessionScopedFiles, pruneState } from './state-gc.js';
 /** ~/.claude/projects/ — Claude Code 세션 저장 경로 */
 const CLAUDE_PROJECTS_DIR = path.join(os.homedir(), '.claude', 'projects');
+let currentSection = '';
+let failedChecks = [];
+function section(name) {
+    currentSection = name;
+    console.log(`  [${name}]`);
+}
 function check(label, condition, hint) {
     const icon = condition ? '✓' : '✗';
     const hintStr = !condition && hint ? ` — ${hint}` : '';
     console.log(`  ${icon} ${label}${hintStr}`);
+    if (!condition) {
+        failedChecks.push({ section: currentSection, label, hint });
+    }
 }
 function exists(p) {
     return fs.existsSync(p);
@@ -26,14 +35,15 @@ function commandExists(cmd) {
     }
 }
 export async function runDoctor(opts = {}) {
+    failedChecks = [];
     console.log('\n  Forgen — Diagnostics\n');
-    console.log('  [Tools]');
+    section('Tools');
     check('claude CLI', commandExists('claude'));
     check('tmux', commandExists('tmux'));
     check('git', commandExists('git'));
     check('gh (GitHub CLI)', commandExists('gh'), 'Required for team PR features: brew install gh');
     console.log();
-    console.log('  [Plugins]');
+    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 플러그인 캐시 디렉토리 확인 — 훅 실행의 필수 전제
@@ -68,7 +78,7 @@ export async function runDoctor(opts = {}) {
     }
     check('forgen plugin registered & installPath exists', pluginRegistered, 'Plugin registered but installPath missing on disk. Fix: npm run build && node scripts/postinstall.js');
     console.log();
-    console.log('  [Directories]');
+    section('Directories');
     check('~/.forgen/', exists(FORGEN_HOME));
     check('~/.forgen/me/', exists(ME_DIR));
     check('~/.forgen/me/solutions/', exists(ME_SOLUTIONS));
@@ -76,26 +86,58 @@ export async function runDoctor(opts = {}) {
     check('~/.forgen/me/rules/', exists(ME_RULES));
     check('~/.forgen/packs/', exists(PACKS_DIR));
     check('~/.forgen/sessions/', exists(SESSIONS_DIR));
+    // R9-IA5: warn if a user dropped rule files at ~/.forgen/rules/ by mistake.
+    // That path is NOT loaded — personal rules live at ~/.forgen/me/rules/.
+    const legacyRulesPath = path.join(FORGEN_HOME, 'rules');
+    if (exists(legacyRulesPath) && legacyRulesPath !== ME_RULES) {
+        try {
+            const files = fs.readdirSync(legacyRulesPath).filter((f) => f.endsWith('.json'));
+            if (files.length > 0) {
+                check(`~/.forgen/rules/ (${files.length} orphan file(s))`, false, `This path is NOT loaded. Move files to ~/.forgen/me/rules/ or delete them.`);
+            }
+        }
+        catch {
+            // permission / symlink issue — diagnostics must not crash
+        }
+    }
     console.log();
-    console.log('  [Philosophy]');
-    check('philosophy.json', exists(ME_PHILOSOPHY));
-    console.log();
-    console.log('  [Environment]');
-    check('Inside tmux session', !!process.env.TMUX);
-    check('FORGEN_HARNESS env var', (process.env.FORGEN_HARNESS ?? process.env.COMPOUND_HARNESS) === '1');
+    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.');
     console.log();
-    // 솔루션/규칙 수
+    // v0.4.1 파일 확장자 버그 수정: rules 는 .json, behavior 도 대부분 .json 포맷.
+    // 이전에 .md 만 count 해서 실 rules 4개인데 0 으로 표시되는 incident 관찰.
+    // (compound-export countFiles 와 동일 결함 — 일관된 수정).
+    const isKnowledgeFile = (f) => f.endsWith('.md') || f.endsWith('.json');
     if (exists(ME_SOLUTIONS)) {
-        const solutions = fs.readdirSync(ME_SOLUTIONS).filter((f) => f.endsWith('.md')).length;
+        const solutions = fs.readdirSync(ME_SOLUTIONS).filter(isKnowledgeFile).length;
         console.log(`  Personal solutions: ${solutions}`);
     }
     if (exists(ME_BEHAVIOR)) {
-        const behavior = fs.readdirSync(ME_BEHAVIOR).filter((f) => f.endsWith('.md')).length;
+        const behavior = fs.readdirSync(ME_BEHAVIOR).filter(isKnowledgeFile).length;
         console.log(`  Behavioral patterns: ${behavior}`);
     }
     if (exists(ME_RULES)) {
-        const rules = fs.readdirSync(ME_RULES).filter((f) => f.endsWith('.md')).length;
-        console.log(`  Personal rules: ${rules}`);
+        // v0.4.1 정확도: removed 상태 rule 은 "학습된 규칙" 에서 제외하고 별도 표시.
+        // 이전에는 디렉터리 파일 수만 세어 이미 제거된 rule 도 count 되어 판매 관점
+        // "살아있는 규칙" 수치가 부풀려짐. 실제 구매자 가치는 active + suppressed.
+        const ruleFiles = fs.readdirSync(ME_RULES).filter(isKnowledgeFile);
+        let active = 0, suppressed = 0, removed = 0;
+        for (const f of ruleFiles) {
+            try {
+                const d = JSON.parse(fs.readFileSync(path.join(ME_RULES, f), 'utf-8'));
+                if (d.status === 'active')
+                    active++;
+                else if (d.status === 'suppressed')
+                    suppressed++;
+                else if (d.status === 'removed' || d.status === 'superseded')
+                    removed++;
+            }
+            catch { /* skip */ }
+        }
+        const live = active + suppressed;
+        const removedTag = removed > 0 ? ` (${removed} removed/superseded)` : '';
+        console.log(`  Personal rules: ${live}  [active:${active} suppressed:${suppressed}]${removedTag}`);
     }
     console.log();
     console.log('  [Log Locations]');
@@ -323,6 +365,15 @@ export async function runDoctor(opts = {}) {
         const report = pruneState({ dryRun: false });
         const mb = (report.bytesFreed / 1024 / 1024).toFixed(2);
         console.log(`  → Pruned ${report.pruned}/${report.scanned} files (${mb} MB freed, >${report.retentionDays}d old)`);
+        // ADR-002 T4 — 90d 미주입 rule retire. pruneState 와 함께 "하루 한번 정돈" 의미 공유.
+        try {
+            const { runDailyT4Decay } = await import('./state-gc.js');
+            const t4 = await runDailyT4Decay({ dryRun: false });
+            if (t4.retired > 0) {
+                console.log(`  → Retired ${t4.retired} rule(s) (T4 time-decay): ${t4.sample.join(', ')}`);
+            }
+        }
+        catch { /* fail-open */ }
     }
     console.log();
     // 현재 디렉토리 git 정보
@@ -336,4 +387,28 @@ export async function runDoctor(opts = {}) {
         console.log('  git remote: (none)');
     }
     console.log();
+    // [Summary] — 최종 상태 요약과 복구 액션을 한눈에 보이게
+    console.log('  [Summary]');
+    if (failedChecks.length === 0) {
+        console.log('  ✓ All diagnostics passed. Forgen is ready.');
+    }
+    else {
+        console.log(`  ✗ ${failedChecks.length} check(s) failed:\n`);
+        const bySection = new Map();
+        for (const f of failedChecks) {
+            if (!bySection.has(f.section))
+                bySection.set(f.section, []);
+            bySection.get(f.section).push(f);
+        }
+        for (const [sec, items] of bySection) {
+            console.log(`    [${sec}]`);
+            for (const item of items) {
+                console.log(`      • ${item.label}`);
+                if (item.hint)
+                    console.log(`        → ${item.hint}`);
+            }
+        }
+        console.log('\n  Run `forgen doctor` again after applying the fixes above.');
+    }
+    console.log();
 }

package/dist/core/extraction-notice.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Forgen v0.4.1 — Extraction Notice (H2)
+ *
+ * `~/.forgen/state/last-auto-compound.json` 에 기록된 이전 세션의 추출 결과를
+ * Stop hook 에서 1회 surface. noticeShown 플래그로 한번 보여주면 다시 안뜸.
+ *
+ * 목적: v0.4.0 에서 auto-compound 가 8,000+ 번 돌았는데 사용자는 0건 노출. 추출이
+ *   실제로 일어났는지 사용자가 확인할 수 없었다. H2 는 "세션 종료 시 N개 패턴
+ *   학습됨" 1줄을 Stop hook UI (systemMessage) 로 밀어넣는다.
+ */
+/**
+ * Stop hook approve 경로에서 호출. 보여줄 알림이 있으면 1줄 문자열 반환하고
+ * noticeShown=true 로 파일 업데이트 (한 번만 surface). 없으면 null.
+ *
+ * 신선도 컷오프: completedAt 이 30분 이상 지나면 stale 로 간주하고 surface 안함.
+ * 이미 다른 세션에서 본 알림이 튀어나오는 걸 방지.
+ */
+export declare function takeLastExtractionNotice(nowMs?: number): string | null;

package/dist/core/extraction-notice.js

@@ -0,0 +1,64 @@
+/**
+ * Forgen v0.4.1 — Extraction Notice (H2)
+ *
+ * `~/.forgen/state/last-auto-compound.json` 에 기록된 이전 세션의 추출 결과를
+ * Stop hook 에서 1회 surface. noticeShown 플래그로 한번 보여주면 다시 안뜸.
+ *
+ * 목적: v0.4.0 에서 auto-compound 가 8,000+ 번 돌았는데 사용자는 0건 노출. 추출이
+ *   실제로 일어났는지 사용자가 확인할 수 없었다. H2 는 "세션 종료 시 N개 패턴
+ *   학습됨" 1줄을 Stop hook UI (systemMessage) 로 밀어넣는다.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { STATE_DIR } from './paths.js';
+const LAST_AUTO_COMPOUND_PATH = path.join(STATE_DIR, 'last-auto-compound.json');
+/** 정상 실행이면 건너뛰기 좋게 fail-open. */
+function readRecord() {
+    try {
+        if (!fs.existsSync(LAST_AUTO_COMPOUND_PATH))
+            return null;
+        return JSON.parse(fs.readFileSync(LAST_AUTO_COMPOUND_PATH, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Stop hook approve 경로에서 호출. 보여줄 알림이 있으면 1줄 문자열 반환하고
+ * noticeShown=true 로 파일 업데이트 (한 번만 surface). 없으면 null.
+ *
+ * 신선도 컷오프: completedAt 이 30분 이상 지나면 stale 로 간주하고 surface 안함.
+ * 이미 다른 세션에서 본 알림이 튀어나오는 걸 방지.
+ */
+export function takeLastExtractionNotice(nowMs = Date.now()) {
+    const record = readRecord();
+    if (!record || record.noticeShown)
+        return null;
+    const completed = Date.parse(record.completedAt);
+    if (!Number.isFinite(completed))
+        return null;
+    const ageMs = nowMs - completed;
+    if (ageMs > 30 * 60 * 1000)
+        return null; // stale
+    const extracted = record.extractedSolutions ?? 0;
+    const promoted = record.promotedRules ?? 0;
+    if (extracted === 0 && promoted === 0) {
+        // 아무것도 학습되지 않았으면 노이즈. 알림을 소비한 상태로만 마킹.
+        try {
+            fs.writeFileSync(LAST_AUTO_COMPOUND_PATH, JSON.stringify({ ...record, noticeShown: true }));
+        }
+        catch { /* fail-open */ }
+        return null;
+    }
+    // 마킹 — race 는 있으나 double-notice 가 치명적이지 않음 (fail-open).
+    try {
+        fs.writeFileSync(LAST_AUTO_COMPOUND_PATH, JSON.stringify({ ...record, noticeShown: true }));
+    }
+    catch { /* fail-open */ }
+    const parts = [];
+    if (extracted > 0)
+        parts.push(`${extracted}개 패턴 추출`);
+    if (promoted > 0)
+        parts.push(`${promoted}개 규칙 승격`);
+    return `[Forgen] 🧠 세션 학습 완료 — ${parts.join(', ')}`;
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Forgen v0.4.1 — `forgen init` CLI
+ *
+ * 빈 FORGEN_HOME (또는 기존에 starter 미설치 홈) 에 starter-pack 솔루션을
+ * 프로비저닝. npm install-g 시의 postinstall 이 하던 starter 배포 로직을 런타임
+ * CLI 로 노출해 다음 시나리오 지원:
+ *   - `FORGEN_HOME=/tmp/fresh forgen init` — 격리 테스트 환경
+ *   - CI pipeline 신규 컨테이너 프로비저닝
+ *   - 사용자가 실수로 me/solutions 전부 삭제한 뒤 복구
+ *
+ * 보수적 정책: me/solutions 에 **≥5개 파일**이 이미 있으면 건너뜀 (사용자
+ * 실 축적물 보호). `--force` 플래그로 우회 가능. postinstall 의 installStarterPack
+ * 과 동일 규칙.
+ */
+export interface InitResult {
+    solutionsInstalled: number;
+    solutionsSkippedExisting: number;
+    solutionsDir: string;
+    starterDir: string | null;
+    skipped: boolean;
+    skipReason?: string;
+}
+export declare function initializeForgenHome(options?: {
+    force?: boolean;
+}): InitResult;
+export declare function handleInit(args: string[]): Promise<void>;