@winspan/claude-forge 4.1.0 → 6.0.0

package/dist/daemon/index.js

@@ -1,582 +1,128 @@
-import path from 'path';
-import os from 'os';
-import fs from 'fs';
-import { expandPath } from '../utils/path.js';
+/**
+ * Daemon entry point — starts the Forge daemon process
+ *
+ * Responsibilities:
+ * 1. Load config and initialize logging
+ * 2. Manage lifecycle (PID, socket, auth token)
+ * 3. Initialize storage, AI provider, and engines
+ * 4. Create event handlers and start socket server
+ * 5. Handle graceful shutdown
+ */
 import { SocketServer } from './server.js';
-import { writePidFile, removePidFile, cleanSocket, getSocketPath, isForgeManaged, writeAuthToken, removeAuthToken, } from './lifecycle.js';
-import { logger, setLogLevel, setEventsFile, setCurrentProject, logEvent, LogLevel, relPath } from '../utils/logger.js';
-import { memoryManager } from '../utils/memory-manager.js';
-import { SQLiteStorage } from '../storage/sqlite.js';
-import { summarizeToolAction } from './tool-summary.js';
-import { ConfigManager } from '../config/index.js';
-import { detectBestModels } from '../utils/claude-api.js';
-import { createProvider } from '../ai/factory.js';
-import { AIGateway } from '../ai/index.js';
-import { buildEngineContext } from './engine-registry.js';
-import { OrchestrationConfigManager } from '../skill-registry/orchestration-config.js';
-import { UserPromptHandler } from './handlers/user-prompt-handler.js';
-import { PreToolUseHandler } from './handlers/pre-tool-use-handler.js';
-import { PostToolUseHandler } from './handlers/post-tool-use-handler.js';
-import { StopHandler } from './handlers/stop-handler.js';
-import { diagnoseForgeHookEnvironment, repairForgeHookEnvironment } from '../cli/commands/init/doctor.js';
-import { pruneOldBackups } from '../web/routes/config.js';
-import { createHash } from 'crypto';
-import { copyHookScripts } from '../cli/commands/init/hook-manager.js';
-import { WebServer } from '../web/server.js';
-import { SseBroadcaster } from '../web/sse-broadcaster.js';
-import { FORGE_PATHS, TIME } from '../constants.js';
-import { restoreNodeTypesFromDatabase } from '../pipeline/node-type-sync.js';
-import { syncBuiltinTemplatesToDatabase } from '../pipeline/template-sync.js';
-import { ConventionManager } from '../convention/convention-manager.js';
-const FORGE_HOME = FORGE_PATHS.home();
+import { writePidFile, removePidFile, cleanSocket, getSocketPath, writeAuthToken, removeAuthToken, } from './lifecycle.js';
+import { routeEvent } from './router.js';
+import { logger, setLogLevel, LogLevel } from '../core/utils/logger.js';
+import { ConfigManager } from '../core/config.js';
+import { SQLiteStorage } from '../core/storage/sqlite.js';
+import { expandPath } from '../core/utils/path.js';
+import { ClaudeProvider } from '../core/ai/provider.js';
+import { RuleEngine } from '../engine/rule-engine.js';
+import { ContextBuilder } from '../engine/context-builder.js';
+import { EvidenceStore } from '../engine/evidence-store.js';
+import { IntentClassifier } from '../intelligence/classifier.js';
+import { QualityGate } from '../intelligence/quality-gate.js';
+import { Distiller } from '../intelligence/distiller.js';
+import { SkillRegistry } from '../skills/registry.js';
+import { HistoryExporter } from './handlers/history-exporter.js';
+import { ResumeManager } from '../claudemd/resume-manager.js';
+import { UserPromptHandler } from './handlers/user-prompt.js';
+import { PreToolUseHandler } from './handlers/pre-tool-use.js';
+import { PostToolUseHandler } from './handlers/post-tool-use.js';
+import { StopHandler } from './handlers/stop.js';
 export async function startDaemon(foreground = false) {
-    // ── Bootstrap ──────────────────────────────────────────────────────────────
+    // ── 1. Config & Logging ────────────────────────────────────────────────────
     const config = new ConfigManager().get();
-    setEventsFile(path.join(FORGE_HOME, 'events.jsonl'));
     const envLevel = (process.env.LOG_LEVEL ?? '').toLowerCase();
     const levelMap = {
         debug: LogLevel.DEBUG, info: LogLevel.INFO, warn: LogLevel.WARN, error: LogLevel.ERROR,
     };
     setLogLevel(levelMap[envLevel] ?? LogLevel.INFO);
-    logger.info('Claude Forge 守护进程启动中...');
-    // ── Hook 自检：确保所有事件类型都注册了 Forge hook ──────────────────────────
-    // 同时自动同步 hook 脚本（npm 更新后无需手动 cf init）
-    try {
-        copyHookScripts();
-        logger.info('[Forge:Hooks] 脚本已同步到最新版本');
-        const { hooksHealthy } = diagnoseForgeHookEnvironment();
-        if (!hooksHealthy) {
-            logger.warn('检测到 Hooks 注册不完整，自动修复中...');
-            repairForgeHookEnvironment();
-            const after = diagnoseForgeHookEnvironment();
-            if (after.hooksHealthy) {
-                logger.info('Hooks 自动修复成功（需重启 Claude Code 会话生效）');
-            }
-            else {
-                logger.warn('Hooks 自动修复后仍有问题，请手动执行 cf doctor --fix');
-            }
-        }
-    }
-    catch (err) {
-        logger.warn(`Hooks 自检失败：${err}`);
-    }
+    logger.info('Claude Forge daemon starting...');
+    // ── 2. Lifecycle (PID, socket, auth token) ─────────────────────────────────
     cleanSocket();
     writePidFile();
     const authToken = writeAuthToken();
-    logger.info('[安全] Auth token 已生成');
-    // ── Storage ────────────────────────────────────────────────────────────────
+    logger.info('[Security] Auth token generated');
+    // ── 3. Storage ─────────────────────────────────────────────────────────────
     const dbPath = expandPath(config.storage.path);
     const storage = new SQLiteStorage(dbPath);
-    logger.info(`存储已初始化：${dbPath}`);
-    // 从数据库恢复节点类型到内存注册表（解决重启丢失问题）
-    restoreNodeTypesFromDatabase(storage);
-    // 同步内置 Pipeline 模板到数据库（首次启动时写入，已存在则跳过）
-    syncBuiltinTemplatesToDatabase(storage);
-    // 注入 storage 到 ConventionManager，用于节点类型持久化
-    ConventionManager.setStorage(storage);
-    // 启动时执行一次维护（清理过期数据）
-    storage.runMaintenance(config.storage.max_size_mb);
-    // 每日凌晨 3 点定期维护
-    const now = new Date();
-    const next3am = new Date(now);
-    next3am.setHours(3, 0, 0, 0);
-    if (next3am <= now)
-        next3am.setDate(next3am.getDate() + 1);
-    const msUntil3am = next3am.getTime() - now.getTime();
-    const maintenanceInitTimer = setTimeout(() => {
-        storage.runMaintenance(config.storage.max_size_mb);
-        const maintenanceDailyTimer = setInterval(() => storage.runMaintenance(config.storage.max_size_mb), TIME.DAY);
-        maintenanceDailyTimer.unref();
-    }, msUntil3am);
-    maintenanceInitTimer.unref();
-    logger.info(`[存储] 下次定期维护计划于 ${next3am.toLocaleTimeString()}`);
-    // 每周日凌晨 4 点执行 VACUUM（降低数据库膨胀）
-    const nextSunday4am = new Date(now);
-    nextSunday4am.setHours(4, 0, 0, 0);
-    const daysUntilSunday = (7 - nextSunday4am.getDay()) % 7;
-    if (daysUntilSunday === 0 && nextSunday4am <= now) {
-        nextSunday4am.setDate(nextSunday4am.getDate() + 7);
-    }
-    else {
-        nextSunday4am.setDate(nextSunday4am.getDate() + daysUntilSunday);
-    }
-    const msUntilSunday4am = nextSunday4am.getTime() - now.getTime();
-    const vacuumInitTimer = setTimeout(() => {
-        logger.info('[存储] 执行每周 VACUUM...');
-        storage.vacuum();
-        const vacuumWeeklyTimer = setInterval(() => {
-            logger.info('[存储] 执行每周 VACUUM...');
-            storage.vacuum();
-        }, TIME.WEEK);
-        vacuumWeeklyTimer.unref();
-    }, msUntilSunday4am);
-    vacuumInitTimer.unref();
-    logger.info(`[存储] 下次 VACUUM 计划于 ${nextSunday4am.toLocaleString()}`);
-    // 自动备份调度（按配置 daily/weekly，默认关闭）
-    const backupConfig = config.backup?.auto;
-    if (backupConfig?.enabled) {
-        const backupInterval = backupConfig.schedule === 'weekly' ? TIME.WEEK : TIME.DAY;
-        const maxKeep = config.backup?.max_keep ?? 10;
-        const backupDir = `${FORGE_HOME}/backups`;
-        const runAutoBackup = () => {
-            try {
-                const dbPath = storage.getDbPath();
-                if (!fs.existsSync(backupDir))
-                    fs.mkdirSync(backupDir, { recursive: true });
-                const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-                const backupPath = path.join(backupDir, `data-${timestamp}.db`);
-                fs.copyFileSync(dbPath, backupPath);
-                const hash = createHash('sha256').update(fs.readFileSync(backupPath)).digest('hex');
-                fs.writeFileSync(`${backupPath}.sha256`, `${hash}  data-${timestamp}.db\n`, 'utf-8');
-                pruneOldBackups(backupDir, maxKeep);
-                logger.info(`[备份] 自动备份完成：data-${timestamp}.db`);
-            }
-            catch (err) {
-                logger.error(`[备份] 自动备份失败：${err}`);
-            }
-        };
-        const autoBackupTimer = setInterval(() => { void runAutoBackup(); }, backupInterval);
-        autoBackupTimer.unref();
-        logger.info(`[备份] 自动备份已启用（${backupConfig.schedule}，保留最近 ${maxKeep} 个）`);
-    }
-    // ── Claude API ─────────────────────────────────────────────────────────────
-    // API Key 优先级：配置文件 → ANTHROPIC_API_KEY → ANTHROPIC_AUTH_TOKEN → CLAUDE_FORGE_DISTILL_API_KEY
-    let apiKey = config.distill.api_key || undefined;
-    // 配置文件无 Key 时，从环境变量读取并自动持久化
+    logger.info(`Storage initialized: ${dbPath}`);
+    // ── 4. AI Provider ─────────────────────────────────────────────────────────
+    const apiKey = config.distill.api_key || process.env.ANTHROPIC_API_KEY || '';
     if (!apiKey) {
-        const envKey = process.env.ANTHROPIC_API_KEY ||
-            process.env.ANTHROPIC_AUTH_TOKEN ||
-            process.env.CLAUDE_FORGE_DISTILL_API_KEY;
-        if (envKey) {
-            apiKey = envKey;
-            config.distill.api_key = envKey;
-            new ConfigManager().save(config);
-            logger.info(`[API] 已从环境变量读取 API Key 并持久化到配置文件`);
-        }
-    }
-    if (!apiKey) {
-        logger.error('❌ Claude API Key 未配置，daemon 无法启动');
-        logger.info('');
-        logger.info('请通过以下任一方式配置 API Key：');
-        logger.info('  1. cf config api --key sk-ant-...');
-        logger.info('  2. export ANTHROPIC_API_KEY=sk-ant-...');
-        logger.info('  3. export ANTHROPIC_AUTH_TOKEN=sk-ant-...');
-        logger.info('');
-        logger.info('获取 API Key：https://console.anthropic.com/settings/keys');
-        process.exit(1);
+        logger.warn('No API key configured — AI features (classifier, quality gate, distiller) disabled');
     }
-    let sharedApi = null;
-    try {
-        const baseUrl = config.distill.base_url || undefined;
-        const providerType = config.distill.provider ?? 'claude';
-        // Claude provider 支持自动检测最佳模型（三个分层）
-        let detectedModels = null;
-        if (providerType === 'claude') {
-            detectedModels = await detectBestModels(apiKey, baseUrl);
-        }
-        // 合并检测结果和配置：检测结果优先
-        const finalModels = {
-            haiku: detectedModels?.haiku ?? config.ai?.models?.haiku ?? 'claude-haiku-4-5-20251001',
-            sonnet: detectedModels?.sonnet ?? config.ai?.models?.sonnet ?? 'claude-sonnet-4-6',
-            opus: detectedModels?.opus ?? config.ai?.models?.opus ?? 'claude-opus-4-6',
-        };
-        const model = detectedModels?.opus ?? config.distill.model;
-        sharedApi = createProvider({
-            type: providerType,
-            apiKey: apiKey,
-            model: model,
-            baseUrl: baseUrl,
-            storage: storage,
-        });
-        sharedApi = new AIGateway(sharedApi, { models: finalModels });
-        if (detectedModels) {
-            logger.info(`[API] Provider: ${providerType} | 模型自动检测：Haiku=${finalModels.haiku} Sonnet=${finalModels.sonnet} Opus=${finalModels.opus} | AI Gateway 已启用`);
-        }
-        else {
-            logger.info(`[API] Provider: ${providerType} | 模型：${model}（配置指定） | AI Gateway 已启用`);
-        }
-    }
-    catch (err) {
-        logger.error(`❌ AI Provider 初始化失败：${err}`);
-        logger.error('请检查 API Key 是否有效，或网络连接是否正常');
-        process.exit(1);
-    }
-    // ── Engines ────────────────────────────────────────────────────────────────
-    const { ctx, trigger, evolveInitTimer, evolveDailyTimer } = await buildEngineContext(config, storage, sharedApi);
-    // ── Handlers ───────────────────────────────────────────────────────────────
+    const ai = apiKey
+        ? new ClaudeProvider(apiKey, config.distill.model, config.distill.base_url)
+        : null;
+    // ── 5. Initialize engines ──────────────────────────────────────────────────
+    const ruleEngine = new RuleEngine();
+    ruleEngine.loadAll();
+    const evidenceStore = new EvidenceStore();
+    const contextBuilder = new ContextBuilder(evidenceStore);
+    const classifier = ai ? new IntentClassifier(ai) : null;
+    const qualityGate = ai ? new QualityGate(ai) : null;
+    const distiller = ai ? new Distiller(ai, storage) : null;
+    const skills = new SkillRegistry();
+    const exporter = new HistoryExporter(storage);
+    const resume = new ResumeManager(storage);
+    logger.info('[Engines] Initialized: RuleEngine, ContextBuilder, EvidenceStore, ResumeManager');
+    if (classifier)
+        logger.info('[Engines] AI-powered: IntentClassifier, QualityGate, Distiller');
+    // ── 6. Create handlers ─────────────────────────────────────────────────────
     const handlers = {
-        UserPromptSubmit: new UserPromptHandler(ctx),
-        PreToolUse: new PreToolUseHandler(ctx),
-        PostToolUse: new PostToolUseHandler(ctx),
-        Stop: new StopHandler(ctx),
-    };
-    // ── TUI 状态查询处理器 ─────────────────────────────────────────────────────
-    const handleTuiQuery = () => {
-        const trackerStatus = ctx.orchestration?.getStatus();
-        const pipelineActive = ctx.pipelineEngine?.hasActivePipeline('') ?? false;
-        const data = {
-            pid: process.pid,
-            uptime: (() => {
-                const s = Math.floor(process.uptime());
-                if (s < 60)
-                    return `${s}秒`;
-                if (s < 3600)
-                    return `${Math.floor(s / 60)}分钟`;
-                return `${Math.floor(s / 3600)}小时${Math.floor((s % 3600) / 60)}分钟`;
-            })(),
-            engines: {
-                distill: !!trigger,
-                resume: !!ctx.resumeEngine,
-                pipeline: !!ctx.pipelineEngine,
-                intent: !!ctx.goalClassifier,
-                quality: !!ctx.qualityGate,
-                skills: true,
-            },
-            distillStats: {
-                total: storage.countEvents({}),
-                distilled: storage.countEvents({ distilled: true }),
-                lastAt: '—',
-            },
-            skills: (() => {
-                try {
-                    const all = ctx.skillRegistry.getRegistry().getAll();
-                    return {
-                        total: all.length,
-                        official: all.filter(s => s.source === 'official').length,
-                        custom: all.filter(s => s.source !== 'official').length,
-                    };
-                }
-                catch {
-                    return { total: 0, official: 0, custom: 0 };
-                }
-            })(),
-            recentEvents: storage.queryEvents({ limit: 10 }).map(e => ({
-                time: new Date(e.timestamp).toLocaleTimeString(),
-                type: e.hook_type,
-                tool: e.tool_name ?? '—',
-                project: e.project_path,
-            })),
-            logs: (() => {
-                try {
-                    // 读取当天的事件日志文件
-                    const todayStr = () => {
-                        const now = new Date();
-                        return now.getFullYear()
-                            + '-' + String(now.getMonth() + 1).padStart(2, '0')
-                            + '-' + String(now.getDate()).padStart(2, '0');
-                    };
-                    const eventsPath = `${FORGE_HOME}/events-${todayStr()}.jsonl`;
-                    if (fs.existsSync(eventsPath)) {
-                        return fs.readFileSync(eventsPath, 'utf-8')
-                            .split('\n')
-                            .filter(Boolean)
-                            .slice(-30)
-                            .reverse()
-                            .map(line => {
-                            try {
-                                const e = JSON.parse(line);
-                                return `[${e.level}] ${e.event}: ${e.msg}`;
-                            }
-                            catch {
-                                return line;
-                            }
-                        });
-                    }
-                }
-                catch { /* ignore */ }
-                return [];
-            })(),
-        };
-        return { allow: true, additionalContext: JSON.stringify(data) };
+        UserPromptSubmit: new UserPromptHandler(classifier ?? null, skills, resume),
+        PreToolUse: new PreToolUseHandler(ruleEngine, contextBuilder),
+        PostToolUse: new PostToolUseHandler(qualityGate ?? null),
+        Stop: new StopHandler(distiller ?? null, exporter, resume),
     };
-    // ── Event router（轻量调度，无业务逻辑）────────────────────────────────────
+    // ── 7. Event handler ───────────────────────────────────────────────────────
     const handleEvent = async (event) => {
         try {
-            // TUI 状态查询（不写入存储）
-            if (event.type === 'tui_query') {
-                return handleTuiQuery();
-            }
-            // 设置当前项目上下文，后续 logger 调用自动关联
-            setCurrentProject(event.project_path);
-            // 关联活跃 pipeline_id，确保事件与 pipeline 精准绑定
-            if (ctx.pipelineEngine && !event.pipeline_id) {
-                const activePipeline = ctx.pipelineEngine.getActivePipeline(event.project_path);
-                if (activePipeline) {
-                    event.pipeline_id = activePipeline.id;
-                }
-            }
             storage.writeEvent(event);
-            // SSE 实时推送：会话事件
-            SseBroadcaster.getInstance().broadcast({
-                type: 'session:event',
-                data: {
-                    sessionId: event.session_id,
-                    projectPath: event.project_path,
-                    hookType: event.hook_type,
-                    toolName: event.tool_name,
-                    pipelineId: event.pipeline_id,
-                    ts: event.timestamp,
-                },
-            });
-            // 生成工具操作摘要，让日志更有可读性
-            const actionSummary = summarizeToolAction(event.tool_name, event.tool_input, event.tool_output, relPath);
-            const summaryPart = actionSummary ? ` → ${actionSummary}` : '';
-            logEvent(event.project_path, 'info', event.hook_type, `tool=${event.tool_name || 'N/A'}${summaryPart} session=${event.session_id}`);
-            // 关键事件 + 管理项目下的工具流：默认 INFO 可见
-            if (event.hook_type === 'UserPromptSubmit' || event.hook_type === 'Stop') {
-                logger.info(`收到事件：${event.hook_type} | 项目=${relPath(event.project_path)}`);
-            }
-            else if (isForgeManaged(event.project_path) &&
-                (event.hook_type === 'PreToolUse' || event.hook_type === 'PostToolUse')) {
-                logger.info(`收到事件：${event.hook_type} | ${event.tool_name || '—'}${summaryPart} | 项目=${relPath(event.project_path)}`);
-            }
-            else {
-                logger.debug(`[事件] ${event.hook_type} | ${event.tool_name || 'N/A'}${summaryPart} | project=${relPath(event.project_path)}`);
-            }
-            if (trigger) {
-                trigger.trackProject(event.session_id, event.project_path);
-            }
-            // 非 Forge 管理的项目：只执行全局安全策略（PolicyEngine），跳过所有写文件和编排操作。
-            // 防止 Forge 在 Cursor / VSCode 等其他编辑器打开的项目里写入 .claude/ 和 .claude-forge/。
-            // "Forge 管理"的判断标准：项目根目录存在 .claude-forge/ 目录（即用户曾运行 claude-forge init）。
-            if (!isForgeManaged(event.project_path)) {
-                if (event.hook_type === 'PreToolUse' && ctx.orchestration) {
-                    // 安全策略全局生效（如 rm -rf 拦截），不受项目范围限制
-                    const safetyDecision = ctx.orchestration.evaluatePreToolUse(event);
-                    if (safetyDecision && !safetyDecision.allow) {
-                        logger.warn(`[Forge:安全] 非管理项目安全拦截：${event.tool_name} | ${safetyDecision.reason}`);
-                        return safetyDecision;
-                    }
-                }
-                logger.debug(`[Forge:范围] 非管理项目，跳过编排/写文件：${event.project_path}`);
-                return;
-            }
-            const handler = handlers[event.hook_type];
-            if (handler) {
-                const result = await handler.handle(event);
-                // SSE 实时推送：pipeline 状态变化
-                if (result && event.hook_type === 'PostToolUse' && event.pipeline_id) {
-                    const pipelineResult = result;
-                    if (pipelineResult.advanceReason || pipelineResult.qualityBlocked) {
-                        SseBroadcaster.getInstance().broadcast({
-                            type: 'pipeline:status',
-                            data: {
-                                pipelineId: event.pipeline_id,
-                                projectPath: event.project_path,
-                                advanceReason: pipelineResult.advanceReason,
-                                qualityBlocked: pipelineResult.qualityBlocked,
-                                qualityIssues: pipelineResult.qualityIssues,
-                            },
-                        });
-                    }
-                }
-                // SSE 实时推送：pipeline 进度快照（每次 PostToolUse 都广播）
-                if (event.hook_type === 'PostToolUse' && ctx.pipelineEngine?.hasActivePipeline(event.project_path)) {
-                    const progressSnap = ctx.pipelineEngine.getProgressLogLine(event.project_path);
-                    if (progressSnap) {
-                        SseBroadcaster.getInstance().broadcast({
-                            type: 'pipeline:progress',
-                            data: {
-                                projectPath: event.project_path,
-                                progress: progressSnap,
-                                toolName: event.tool_name,
-                                timestamp: new Date().toISOString(),
-                            },
-                        });
-                    }
-                }
-                if (result) {
-                    // 统一记录注入给 Claude 的内容摘要
-                    if (result.additionalContext || result.systemMessage) {
-                        const ctxLen = result.additionalContext?.length ?? 0;
-                        const smLen = result.systemMessage?.length ?? 0;
-                        // 提取注入的模块标签（如 [Forge 历史经验]、[Forge 技能推荐] 等）
-                        const fullContent = (result.additionalContext ?? '') + (result.systemMessage ?? '');
-                        const moduleMatches = [...fullContent.matchAll(/\[Forge[^\]]+\]/g)].map(m => m[0]);
-                        const uniqueModules = [...new Set(moduleMatches)];
-                        const moduleSummary = uniqueModules.length > 0 ? uniqueModules.join(', ') : '通用上下文';
-                        logger.info(`[Forge:注入] ${event.hook_type} | 模块：${moduleSummary} | ctx=${ctxLen}字符 sm=${smLen}字符`);
-                        // 将完整注入内容按模块分段记录，每段一条日志
-                        const segments = fullContent.split(/(?=\[Forge[^\]]+\])/).filter(s => s.trim());
-                        for (const seg of segments) {
-                            const preview = seg.length > 500 ? seg.slice(0, 500) + '...' : seg;
-                            logger.info(`[Forge:注入内容] ${preview.replace(/\n/g, ' ').trim()}`);
-                        }
-                        // 同时输出到 stdout，让用户可见（灰色显示，避免干扰）
-                        console.log(`\x1b[90m💡 ${moduleSummary}\x1b[0m`);
-                        for (const seg of segments) {
-                            const lines = seg.trim().split('\n').slice(0, 3); // 只显示前 3 行
-                            for (const line of lines) {
-                                if (line.trim()) {
-                                    console.log(`\x1b[90m   ${line.trim()}\x1b[0m`);
-                                }
-                            }
-                            if (seg.split('\n').length > 3) {
-                                console.log(`\x1b[90m   ...\x1b[0m`);
-                            }
-                        }
-                    }
-                    return result;
-                }
-            }
-            else if (event.hook_type !== 'Notification') {
-                logger.warn(`[Forge:路由] 未注册的事件类型：${event.hook_type}`);
-            }
+            logger.debug(`[Event] ${event.hook_type} | tool=${event.tool_name ?? 'N/A'}`);
+            return routeEvent(event, handlers);
         }
         catch (err) {
-            logger.error(`事件处理失败：${err}`);
-            throw err; // 关键路径必须抛出，避免静默失败
+            logger.error(`Event handling failed: ${err}`);
+            throw err;
         }
     };
-    // ── Socket server ──────────────────────────────────────────────────────────
+    // ── 8. Start socket server ─────────────────────────────────────────────────
     const socketPath = getSocketPath();
     const server = new SocketServer(socketPath, handleEvent, authToken);
-    // ── Web 管理后台 ────────────────────────────────────────────────────────────
+    // ── 8.5. Start web server (optional) ───────────────────────────────────────
     let webServer = null;
     if (config.web.enabled) {
-        try {
-            // 如果配置中未指定 auth_token，使用启动时生成的随机 token
-            const webAuthToken = config.web.auth_token || authToken;
-            webServer = new WebServer({
-                port: config.web.port,
-                authToken: webAuthToken,
-                storage,
-                aiProvider: sharedApi,
-                pipelineEngine: ctx.pipelineEngine ?? undefined,
-            });
-            await webServer.start();
-            if (webAuthToken === authToken) {
-                logger.info(`[Web] 认证已启用（随机 Token）`);
-            }
-            else {
-                logger.info(`[Web] 认证已启用（配置文件 Token）`);
-            }
-        }
-        catch (err) {
-            logger.warn(`[Web] 管理后台启动失败：${err}`);
-        }
-    }
-    // 启动时清理过期 Pipeline（防止残留任务跨会话污染）
-    if (ctx.pipelineEngine) {
-        try {
-            ctx.pipelineEngine.cleanupExpired();
-            logger.info('[Forge:Pipeline] 启动时已执行过期 Pipeline 清理');
-        }
-        catch (err) {
-            logger.warn(`[Forge:Pipeline] 清理过期 Pipeline 失败：${err}`);
-        }
-    }
-    // ── 技能目录文件监听（跨平台：逐目录注册，避免 Linux 下 recursive 无效）──────
-    const skillsDir = path.join(os.homedir(), '.claude', 'skills');
-    const skillsWatchers = new Map();
-    let skillsDebounceTimer = null;
-    const onSkillChange = (eventType, filename) => {
-        // 过滤非技能文件：只关注 .md 文件变更和目录增删（rename），忽略 .DS_Store 等噪音文件
-        if (!filename)
-            return;
-        const ignored = ['.DS_Store', 'Thumbs.db', '.gitkeep', 'desktop.ini'];
-        if (ignored.includes(filename))
-            return;
-        if (!filename.endsWith('.md') && eventType !== 'rename')
-            return;
-        if (skillsDebounceTimer)
-            clearTimeout(skillsDebounceTimer);
-        skillsDebounceTimer = setTimeout(async () => {
-            skillsDebounceTimer = null;
-            logger.info(`[Forge:技能监听] 检测到变更：${filename}，触发注册表刷新`);
-            try {
-                const result = await ctx.skillRegistry.refreshAndGenerateKeywords();
-                if (result.added.length > 0) {
-                    logger.info(`[Forge:技能监听] 新技能已注册并生成关键词：${result.added.join(', ')}`);
-                }
-            }
-            catch (err) {
-                logger.warn(`[Forge:技能监听] 刷新失败：${err}`);
-            }
-            // 仅在 rename 事件（目录新增/删除）时重新扫描子目录
-            if (eventType === 'rename') {
-                watchSkillsDir();
-            }
-        }, 500);
-    };
-    const watchDir = (dir) => {
-        if (skillsWatchers.has(dir))
-            return;
-        try {
-            const w = fs.watch(dir, (eventType, filename) => onSkillChange(eventType, filename));
-            skillsWatchers.set(dir, w);
-        }
-        catch {
-            // 目录可能已被删除，忽略
-        }
-    };
-    const watchSkillsDir = () => {
-        if (!fs.existsSync(skillsDir))
-            return;
-        watchDir(skillsDir);
-        // 注册所有一级子目录
-        for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
-            if (entry.isDirectory()) {
-                watchDir(path.join(skillsDir, entry.name));
-            }
-        }
-    };
-    if (fs.existsSync(skillsDir)) {
-        watchSkillsDir();
-        logger.info(`[Forge:技能监听] 已启动监听：${skillsDir}（跨平台模式，共 ${skillsWatchers.size} 个目录）`);
-    }
-    else {
-        logger.info(`[Forge:技能监听] 技能目录不存在，跳过监听：${skillsDir}`);
+        const { WebServer } = await import('../web/server.js');
+        webServer = new WebServer({
+            port: config.web.port,
+            storage,
+            ruleEngine,
+        });
+        await webServer.start();
     }
-    // ── Graceful shutdown ──────────────────────────────────────────────────────
+    // ── 9. Graceful shutdown ───────────────────────────────────────────────────
     let shuttingDown = false;
     const shutdown = async () => {
         if (shuttingDown)
             return;
         shuttingDown = true;
-        logger.info('守护进程关闭中...');
-        const forceExit = setTimeout(() => {
-            logger.warn('优雅关闭超时，强制退出');
-            process.exit(1);
-        }, TIME.FIVE_SECONDS);
-        forceExit.unref();
-        if (trigger)
-            trigger.stopTimer();
-        if (evolveInitTimer)
-            clearTimeout(evolveInitTimer);
-        if (evolveDailyTimer)
-            clearInterval(evolveDailyTimer);
-        clearTimeout(maintenanceInitTimer);
-        if (skillsDebounceTimer)
-            clearTimeout(skillsDebounceTimer);
-        for (const w of skillsWatchers.values())
-            w.close();
-        // 关闭 Web 服务器
-        if (webServer) {
+        logger.info('Shutting down...');
+        if (ai)
+            logger.info(`[AI Stats] ${ai.formatStats()}`);
+        if (webServer)
             await webServer.stop();
-        }
-        // API 调用统计摘要
-        if (sharedApi) {
-            logger.info(`[API 统计]\n${sharedApi.formatStats()}`);
-        }
-        // 确保 OrchestrationConfig 缓存写入磁盘
-        new OrchestrationConfigManager().flush();
-        // 确保 SkillRegistry 使用统计写入磁盘
-        ctx.skillRegistry.getRegistry().flush();
         await server.close();
         storage.close();
         removePidFile();
         cleanSocket();
         removeAuthToken();
-        clearTimeout(forceExit);
         process.exit(0);
     };
     process.on('SIGTERM', shutdown);
     process.on('SIGINT', shutdown);
-    logger.info(`守护进程已启动 (PID: ${process.pid})`);
-    // 输出缓存容量报告
-    const capacityReport = memoryManager.getCapacityReport();
-    logger.info(`[缓存] 总容量=${capacityReport.totalCapacity} 已用=${capacityReport.totalSize} 利用率=${capacityReport.utilization}`);
+    logger.info(`Daemon started (PID: ${process.pid})`);
     if (foreground) {
         process.stdout.write(`Claude Forge daemon running (PID: ${process.pid})\n`);
         process.stdout.write('Press Ctrl+C to stop\n');