frontend-guardian-core 3.7.6 → 3.8.0

package/bin/fg-core.js

@@ -6,75 +6,75 @@
 
 import { writeFileSync } from "node:fs";
 import { join } from "node:path";
+import pc from "picocolors";
 import {
-    createEngine,
-    i18nRules,
-    performanceRules,
+    AIFixSuggester,
     a11yRules,
-    securityRules,
-    namingRules,
-    crossFileRules,
+    BaselineManager,
+    buildNotificationPayload,
+    CodeownersParser,
+    compareHistoryReports,
+    complianceReportToMarkdown,
     componentRules,
-    hooksRules,
-    platformRules,
-    svelteRules,
-    e2eRules,
-    detectE2EGaps,
-    formatE2EGapReport,
-    formatE2EGapJson,
-    installGitHooks,
-    uninstallGitHooks,
-    hasGitHook,
-    generateCIConfig,
+    createEngine,
+    createPublisher,
+    crossFileRules,
+    detectAIConfig,
     detectCIProvider,
-    generateSarif,
-    formatAllAnnotations,
-    isGitHubActions,
-    writeJobSummary,
-    BaselineManager,
-    initConfig,
+    detectDashboardConfig,
+    detectE2EGaps,
+    detectFixBotConfig,
+    detectMonorepo,
+    detectNotificationConfig,
     detectProjectMeta,
-    generatePRComment,
     detectPublisherConfig,
-    createPublisher,
-    uploadReport,
     detectUploadConfig,
-    SmartCache,
-    runFixBot,
-    detectFixBotConfig,
-    HistoryReport,
-    generateDashboard,
-    detectMonorepo,
-    scanWorkspace,
-    formatWorkspaceReport,
-    formatWorkspaceJson,
-    AIFixSuggester,
-    detectAIConfig,
-    compareHistoryReports,
+    e2eRules,
+    FileWatcher,
+    findRouteFiles,
+    formatAllAnnotations,
+    formatE2EGapJson,
+    formatE2EGapReport,
     formatHistoryCompare,
     formatHistoryCompareJson,
-    CodeownersParser,
-    sendNotifications,
-    detectNotificationConfig,
-    buildNotificationPayload,
+    formatPageHealthJson,
+    formatPageHealthReport,
+    formatWorkspaceJson,
+    formatWorkspaceReport,
+    generateCIConfig,
     generateComplianceReport,
-    complianceReportToMarkdown,
-    saveComplianceReport,
-    uploadToDashboardServer,
-    detectDashboardConfig,
-    playwrightIntegration,
+    generateDashboard,
+    generatePRComment,
+    generateSarif,
+    HistoryReport,
+    hasGitHook,
+    hooksRules,
+    i18nRules,
+    initConfig,
+    installGitHooks,
+    isGitHubActions,
+    isPlaywrightAvailable,
+    namingRules,
     ProjectIndexer,
-    FileWatcher,
     parseAllRoutes,
-    findRouteFiles,
+    performanceRules,
+    platformRules,
+    playwrightIntegration,
+    runFixBot,
     runPageHealthCheck,
-    isPlaywrightAvailable,
-    formatPageHealthReport,
-    formatPageHealthJson,
-    uploadPageHealthResult,
+    SmartCache,
+    saveComplianceReport,
+    scanWorkspace,
+    securityRules,
+    sendNotifications,
+    svelteRules,
     toScanResult,
+    uninstallGitHooks,
+    uploadPageHealthResult,
+    uploadReport,
+    uploadToDashboardServer,
+    writeJobSummary,
 } from "../dist/index.js";
-import pc from "picocolors";
 import { runWatchMode } from "./watch-mode.js";
 
 const MODULES = [
@@ -107,7 +107,7 @@ const MODULE_RULES = {
 
 function showHelp() {
     console.log(`
-Frontend Guardian Core v3.7.6
+Frontend Guardian Core v3.8.0
 
 Usage:
   fg-core <project-dir> [options]
@@ -179,6 +179,7 @@ Options:
   --build-index        建立项目索引（预索引文件结构、符号、路由）
   --watch-index        监听文件变更并自动同步索引
   --index-status       查看项目索引状态
+  --mcp                启动 MCP Server（stdio，供 AI Agent 调用）
   --help, -h           显示帮助
 
 Examples:
@@ -267,6 +268,7 @@ async function main() {
         buildIndex: false,
         watchIndex: false,
         indexStatus: false,
+        mcp: false,
     };
 
     for (let i = 0; i < args.length; i++) {
@@ -476,6 +478,9 @@ async function main() {
             case "--index-status":
                 options.indexStatus = true;
                 break;
+            case "--mcp":
+                options.mcp = true;
+                break;
             case "--help":
             case "-h":
                 showHelp();
@@ -483,6 +488,17 @@ async function main() {
         }
     }
 
+    // v3.8.0: 启动 MCP Server（AI Agent 集成）
+    if (options.mcp) {
+        const { runMCPServer } = await import("../dist/index.js");
+        runMCPServer({
+            projectDir: options.projectDir,
+            configFile: options.configFile,
+            minSeverity: options.minSeverity,
+        });
+        return;
+    }
+
     // v3.6.0: E2E 测试覆盖缺口检测
     if (options.e2eDetectGaps) {
         const gapResult = detectE2EGaps({ projectDir: options.projectDir });
@@ -512,12 +528,18 @@ async function main() {
         const duration = Date.now() - start;
 
         if (options.json) {
-            console.log(JSON.stringify({
-                tool: "Playwright",
-                total: issues.length,
-                duration,
-                issues,
-            }, null, 2));
+            console.log(
+                JSON.stringify(
+                    {
+                        tool: "Playwright",
+                        total: issues.length,
+                        duration,
+                        issues,
+                    },
+                    null,
+                    2
+                )
+            );
         } else {
             console.log(pc.cyan(`📊 Playwright 测试结果`));
             console.log(pc.gray(`   耗时: ${duration}ms`));
@@ -553,7 +575,7 @@ async function main() {
 
         if (!options.baseUrl && !options.serveCommand) {
             console.log(pc.yellow("⚠️  请指定 --base-url 或 --serve"));
-            console.log(pc.gray("   示例: fg-core . --page-health --serve \"npm run dev\" --port 5173"));
+            console.log(pc.gray('   示例: fg-core . --page-health --serve "npm run dev" --port 5173'));
             console.log(pc.gray("   示例: fg-core . --page-health --base-url http://localhost:3000"));
             process.exit(1);
         }
@@ -587,7 +609,8 @@ async function main() {
                 if (result.issues.length > 0) {
                     console.log(pc.cyan(`📋 发现 ${result.issues.length} 个问题:`));
                     for (const issue of result.issues) {
-                        const color = issue.severity === "critical" ? pc.red : issue.severity === "warning" ? pc.yellow : pc.blue;
+                        const color =
+                            issue.severity === "critical" ? pc.red : issue.severity === "warning" ? pc.yellow : pc.blue;
                         console.log(color(`   [${issue.severity.toUpperCase()}] ${issue.title}`));
                         console.log(pc.gray(`      ${issue.description.split("\n")[0]}`));
                     }
@@ -605,11 +628,7 @@ async function main() {
                 if (!options.json) {
                     console.log(pc.gray(`\n   正在上报到看板服务器: ${options.server}`));
                 }
-                const uploadResult = await uploadPageHealthResult(
-                    result,
-                    options.projectDir,
-                    dashboardConfig
-                );
+                const uploadResult = await uploadPageHealthResult(result, options.projectDir, dashboardConfig);
                 if (!options.json) {
                     if (uploadResult.success) {
                         console.log(pc.green(`   ✅ 已上报到看板服务器`));
@@ -660,13 +679,7 @@ async function main() {
 
         const { globbySync } = require("globby");
         const patterns = ["**/*.{js,ts,jsx,tsx,vue}"];
-        const exclude = [
-            "**/node_modules/**",
-            "**/dist/**",
-            "**/build/**",
-            "**/.git/**",
-            "**/coverage/**",
-        ];
+        const exclude = ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**", "**/coverage/**"];
         const files = globbySync(patterns, {
             cwd: options.projectDir,
             ignore: exclude,
@@ -692,14 +705,20 @@ async function main() {
             projectDir: options.projectDir,
             onChange: (changed, deleted) => {
                 if (changed.length > 0) {
-                    console.log(pc.cyan(`\n📝 变更: ${changed.map((f) => relative(options.projectDir, f)).join(", ")}`));
+                    console.log(
+                        pc.cyan(`\n📝 变更: ${changed.map((f) => relative(options.projectDir, f)).join(", ")}`)
+                    );
                 }
                 if (deleted.length > 0) {
-                    console.log(pc.yellow(`\n🗑️  删除: ${deleted.map((f) => relative(options.projectDir, f)).join(", ")}`));
+                    console.log(
+                        pc.yellow(`\n🗑️  删除: ${deleted.map((f) => relative(options.projectDir, f)).join(", ")}`)
+                    );
                 }
             },
             onIndexUpdate: (stats) => {
-                console.log(pc.gray(`   索引已更新 | 文件: ${stats.files} | 路由: ${stats.routes} | 符号: ${stats.symbols}`));
+                console.log(
+                    pc.gray(`   索引已更新 | 文件: ${stats.files} | 路由: ${stats.routes} | 符号: ${stats.symbols}`)
+                );
             },
             onError: (err) => {
                 console.error(pc.red(`   监听错误: ${err.message}`));
@@ -756,7 +775,9 @@ async function main() {
             console.log(pc.gray("   使用 --init-config --force 覆盖（或使用 --init-config 直接覆盖）"));
         } else if (result.created) {
             console.log(pc.green(`   ✅ 已创建: ${result.path}`));
-            console.log(pc.gray(`   框架: ${meta.framework ?? "auto-detect"} | 组件库: ${meta.componentLib ?? "auto-detect"}`));
+            console.log(
+                pc.gray(`   框架: ${meta.framework ?? "auto-detect"} | 组件库: ${meta.componentLib ?? "auto-detect"}`)
+            );
         }
         process.exit(0);
     }
@@ -796,16 +817,28 @@ async function main() {
         if (filtered.length === 0) {
             console.log(pc.gray("   暂无历史记录"));
         } else {
-            console.log(`   ${"时间".padEnd(20)} ${"模块".padEnd(15)} ${"C".padStart(4)} ${"W".padStart(4)} ${"S".padStart(4)}`);
+            console.log(
+                `   ${"时间".padEnd(20)} ${"模块".padEnd(15)} ${"C".padStart(4)} ${"W".padStart(4)} ${"S".padStart(4)}`
+            );
             console.log(pc.gray("   " + "-".repeat(50)));
             for (const r of filtered) {
-                const time = new Date(r.timestamp).toLocaleString("zh-CN", { month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
+                const time = new Date(r.timestamp).toLocaleString("zh-CN", {
+                    month: "2-digit",
+                    day: "2-digit",
+                    hour: "2-digit",
+                    minute: "2-digit",
+                });
                 const c = pc.red(String(r.counts.critical).padStart(4));
                 const w = pc.yellow(String(r.counts.warning).padStart(4));
                 const s = pc.blue(String(r.counts.suggestion).padStart(4));
                 console.log(`   ${time.padEnd(20)} ${r.module.padEnd(15)} ${c} ${w} ${s}`);
             }
-            console.log(pc.gray(`   共 ${reports.length} 条记录` + (options.historyModule ? `，已按模块 "${options.historyModule}" 过滤` : "")));
+            console.log(
+                pc.gray(
+                    `   共 ${reports.length} 条记录` +
+                        (options.historyModule ? `，已按模块 "${options.historyModule}" 过滤` : "")
+                )
+            );
         }
         process.exit(0);
     }
@@ -840,9 +873,7 @@ async function main() {
             console.log(pc.yellow("⚠️  暂无历史扫描记录，无法生成看板。请先运行 --save-report 生成历史数据。"));
             process.exit(1);
         }
-        const fullReports = reportList
-            .map((r) => hr.loadReport(r.filename))
-            .filter(Boolean);
+        const fullReports = reportList.map((r) => hr.loadReport(r.filename)).filter(Boolean);
         const outputPath = generateDashboard(fullReports, { projectDir: options.projectDir });
         console.log(pc.cyan("📊 趋势看板已生成"));
         console.log(pc.green(`   ✅ ${outputPath}`));
@@ -855,7 +886,11 @@ async function main() {
     if (options.monorepo) {
         const mono = detectMonorepo(options.projectDir);
         if (!mono.isMonorepo) {
-            console.log(pc.yellow(`⚠️  未检测到 monorepo workspace 配置（pnpm-workspace.yaml / lerna.json / nx.json / package.json workspaces）`));
+            console.log(
+                pc.yellow(
+                    `⚠️  未检测到 monorepo workspace 配置（pnpm-workspace.yaml / lerna.json / nx.json / package.json workspaces）`
+                )
+            );
             console.log(pc.gray(`   将在项目根目录执行常规扫描...`));
             if (options.module === "all") {
                 await runAllModules(options);
@@ -906,13 +941,24 @@ async function main() {
             if (!pr.success || pr.result.total === 0) continue;
 
             console.log(pc.cyan(`\n📦 ${pr.package.name} (${pr.package.path})`));
-            const allIssues = [...pr.result.issues.critical, ...pr.result.issues.warning, ...pr.result.issues.suggestion];
+            const allIssues = [
+                ...pr.result.issues.critical,
+                ...pr.result.issues.warning,
+                ...pr.result.issues.suggestion,
+            ];
             for (const issue of allIssues) {
-                printIssue(issue, issue.severity === "critical" ? pc.red : issue.severity === "warning" ? pc.yellow : pc.blue);
+                printIssue(
+                    issue,
+                    issue.severity === "critical" ? pc.red : issue.severity === "warning" ? pc.yellow : pc.blue
+                );
             }
         }
 
-        console.log(pc.gray(`\n⏱️  总耗时: ${workspaceResult.summary.totalDuration}ms | 扫描 ${workspaceResult.summary.totalFilesScanned} 个文件`));
+        console.log(
+            pc.gray(
+                `\n⏱️  总耗时: ${workspaceResult.summary.totalDuration}ms | 扫描 ${workspaceResult.summary.totalFilesScanned} 个文件`
+            )
+        );
 
         if (workspaceResult.summary.issuesBySeverity.critical > 0) {
             process.exit(1);
@@ -1118,9 +1164,7 @@ async function runAllModules(options, cacheInstance) {
         } else {
             if (!options.json) {
                 console.log(
-                    pc.yellow(
-                        "   ⚠️ 未检测到 Fix Bot 配置。请设置 FG_FIX_BOT_PROVIDER 和 FG_FIX_BOT_TOKEN 环境变量。"
-                    )
+                    pc.yellow("   ⚠️ 未检测到 Fix Bot 配置。请设置 FG_FIX_BOT_PROVIDER 和 FG_FIX_BOT_TOKEN 环境变量。")
                 );
                 console.log("");
             }
@@ -1208,14 +1252,9 @@ async function runAllModules(options, cacheInstance) {
         // 构建发布器配置
         let pubConfig = detectPublisherConfig();
         if (!pubConfig && options.commentProvider) {
-            const token =
-                options.commentProvider === "github"
-                    ? process.env.GITHUB_TOKEN
-                    : process.env.GITLAB_TOKEN;
+            const token = options.commentProvider === "github" ? process.env.GITHUB_TOKEN : process.env.GITLAB_TOKEN;
             const repo =
-                options.commentProvider === "github"
-                    ? process.env.GITHUB_REPOSITORY
-                    : process.env.CI_PROJECT_ID;
+                options.commentProvider === "github" ? process.env.GITHUB_REPOSITORY : process.env.CI_PROJECT_ID;
             if (token && repo && options.prNumber) {
                 pubConfig = {
                     provider: options.commentProvider,
@@ -1231,9 +1270,7 @@ async function runAllModules(options, cacheInstance) {
                 const publisher = createPublisher(pubConfig);
                 const result = await publisher.publish(commentBody);
                 if (result.success) {
-                    console.log(
-                        pc.cyan(`💬 PR/MR 评论已${result.action === "updated" ? "更新" : "发布"}`)
-                    );
+                    console.log(pc.cyan(`💬 PR/MR 评论已${result.action === "updated" ? "更新" : "发布"}`));
                     if (result.commentUrl) {
                         console.log(pc.gray(`   ${result.commentUrl}`));
                     }
@@ -1254,7 +1291,7 @@ async function runAllModules(options, cacheInstance) {
     }
 
     // 生成并写入报告文件（--output）
-    let reportPath = options.output;
+    const reportPath = options.output;
     if (reportPath) {
         const reportBody = generatePRComment(
             allResults,
@@ -1283,25 +1320,27 @@ async function runAllModules(options, cacheInstance) {
     if (options.upload) {
         const uploadConfig = detectUploadConfig();
         if (uploadConfig) {
-            const targetPath = reportPath || (() => {
-                const tmpPath = join(process.cwd(), `fg-report-${Date.now()}.md`);
-                const reportBody = generatePRComment(
-                    allResults,
-                    {
-                        timestamp: new Date().toISOString(),
-                        duration: totalDuration,
-                        filesScanned: totalFilesScanned,
-                    },
-                    {
-                        external: externalResults.length > 0 ? externalResults : undefined,
-                        fixResult: fixResult
-                            ? { fixedCount: fixResult.fixedCount, filesModified: fixResult.filesModified }
-                            : null,
-                    }
-                );
-                writeFileSync(tmpPath, reportBody, "utf-8");
-                return tmpPath;
-            })();
+            const targetPath =
+                reportPath ||
+                (() => {
+                    const tmpPath = join(process.cwd(), `fg-report-${Date.now()}.md`);
+                    const reportBody = generatePRComment(
+                        allResults,
+                        {
+                            timestamp: new Date().toISOString(),
+                            duration: totalDuration,
+                            filesScanned: totalFilesScanned,
+                        },
+                        {
+                            external: externalResults.length > 0 ? externalResults : undefined,
+                            fixResult: fixResult
+                                ? { fixedCount: fixResult.fixedCount, filesModified: fixResult.filesModified }
+                                : null,
+                        }
+                    );
+                    writeFileSync(tmpPath, reportBody, "utf-8");
+                    return tmpPath;
+                })();
             const uploadResult = await uploadReport(targetPath, uploadConfig);
             if (uploadResult.success) {
                 console.log(pc.cyan("📤 报告已上传"));
@@ -1412,7 +1451,12 @@ async function runAllModules(options, cacheInstance) {
                 if (suggestions.length > 0) {
                     console.log(pc.cyan(`   ✅ 生成 ${suggestions.length} 个 AI 修复建议`));
                     for (const s of suggestions) {
-                        const confidenceIcon = s.confidence === "high" ? pc.green("●") : s.confidence === "medium" ? pc.yellow("●") : pc.red("●");
+                        const confidenceIcon =
+                            s.confidence === "high"
+                                ? pc.green("●")
+                                : s.confidence === "medium"
+                                  ? pc.yellow("●")
+                                  : pc.red("●");
                         console.log(pc.cyan(`\n   📄 ${s.issue.file}:${s.issue.line}`));
                         console.log(pc.yellow(`      [${s.issue.ruleId}] ${s.issue.title}`));
                         console.log(pc.gray(`      AI 置信度: ${confidenceIcon} ${s.confidence}`));
@@ -1470,18 +1514,18 @@ async function runAllModules(options, cacheInstance) {
                 console.log(pc.gray(`   ${icon} ${nr.channel}: ${nr.success ? "已发送" : nr.error}`));
             }
         } else {
-            console.log(pc.yellow("⚠️ 未配置通知渠道。请设置 FG_NOTIFY_FEISHU / FG_NOTIFY_DINGTALK / FG_NOTIFY_WECOM / FG_NOTIFY_SLACK 环境变量"));
+            console.log(
+                pc.yellow(
+                    "⚠️ 未配置通知渠道。请设置 FG_NOTIFY_FEISHU / FG_NOTIFY_DINGTALK / FG_NOTIFY_WECOM / FG_NOTIFY_SLACK 环境变量"
+                )
+            );
         }
     }
 
     // v3.5.0: 生成合规报告
     if (options.compliance) {
         const moduleResults = MODULES.map((m) => allResults[m]).filter(Boolean);
-        const report = generateComplianceReport(
-            moduleResults,
-            options.projectDir,
-            options.strategy
-        );
+        const report = generateComplianceReport(moduleResults, options.projectDir, options.strategy);
         const markdown = complianceReportToMarkdown(report);
         saveComplianceReport(report, options.compliance);
         if (!options.json) {
@@ -1732,7 +1776,9 @@ async function runSingleModule(options, cacheInstance) {
             issues.warning = issues.warning.filter((i) => newKeySet.has(`${i.file}|${i.ruleId}|${i.line}`));
             issues.suggestion = issues.suggestion.filter((i) => newKeySet.has(`${i.file}|${i.ruleId}|${i.line}`));
             result.total = issues.critical.length + issues.warning.length + issues.suggestion.length;
-            result.filesWithIssues = new Set([...issues.critical, ...issues.warning, ...issues.suggestion].map((i) => i.file)).size;
+            result.filesWithIssues = new Set(
+                [...issues.critical, ...issues.warning, ...issues.suggestion].map((i) => i.file)
+            ).size;
             allIssues = baselineResult.newIssues;
         }
 
@@ -1780,13 +1826,9 @@ async function runSingleModule(options, cacheInstance) {
             let pubConfig = detectPublisherConfig();
             if (!pubConfig && options.commentProvider) {
                 const token =
-                    options.commentProvider === "github"
-                        ? process.env.GITHUB_TOKEN
-                        : process.env.GITLAB_TOKEN;
+                    options.commentProvider === "github" ? process.env.GITHUB_TOKEN : process.env.GITLAB_TOKEN;
                 const repo =
-                    options.commentProvider === "github"
-                        ? process.env.GITHUB_REPOSITORY
-                        : process.env.CI_PROJECT_ID;
+                    options.commentProvider === "github" ? process.env.GITHUB_REPOSITORY : process.env.CI_PROJECT_ID;
                 if (token && repo && options.prNumber) {
                     pubConfig = {
                         provider: options.commentProvider,
@@ -1802,9 +1844,7 @@ async function runSingleModule(options, cacheInstance) {
                     const publisher = createPublisher(pubConfig);
                     const pubResult = await publisher.publish(commentBody);
                     if (pubResult.success) {
-                        console.log(
-                            pc.cyan(`💬 PR/MR 评论已${pubResult.action === "updated" ? "更新" : "发布"}`)
-                        );
+                        console.log(pc.cyan(`💬 PR/MR 评论已${pubResult.action === "updated" ? "更新" : "发布"}`));
                         if (pubResult.commentUrl) {
                             console.log(pc.gray(`   ${pubResult.commentUrl}`));
                         }
@@ -1903,7 +1943,12 @@ async function runSingleModule(options, cacheInstance) {
                     if (suggestions.length > 0) {
                         console.log(pc.cyan(`   ✅ 生成 ${suggestions.length} 个 AI 修复建议`));
                         for (const s of suggestions) {
-                            const confidenceIcon = s.confidence === "high" ? pc.green("●") : s.confidence === "medium" ? pc.yellow("●") : pc.red("●");
+                            const confidenceIcon =
+                                s.confidence === "high"
+                                    ? pc.green("●")
+                                    : s.confidence === "medium"
+                                      ? pc.yellow("●")
+                                      : pc.red("●");
                             console.log(pc.cyan(`\n   📄 ${s.issue.file}:${s.issue.line}`));
                             console.log(pc.yellow(`      [${s.issue.ruleId}] ${s.issue.title}`));
                             console.log(pc.gray(`      AI 置信度: ${confidenceIcon} ${s.confidence}`));
@@ -1990,9 +2035,7 @@ async function applyBaselineToResults(allResults, externalResults, baselinePath,
         return baselineResult;
     }
 
-    const newKeySet = new Set(
-        baselineResult.newIssues.map((i) => `${i.file}|${i.ruleId}|${i.line}`)
-    );
+    const newKeySet = new Set(baselineResult.newIssues.map((i) => `${i.file}|${i.ruleId}|${i.line}`));
 
     function isNew(issue) {
         return newKeySet.has(`${issue.file}|${issue.ruleId}|${issue.line}`);
@@ -2006,12 +2049,9 @@ async function applyBaselineToResults(allResults, externalResults, baselinePath,
         r.issues.warning = r.issues.warning.filter(isNew);
         r.issues.suggestion = r.issues.suggestion.filter(isNew);
         r.total = r.issues.critical.length + r.issues.warning.length + r.issues.suggestion.length;
-        r.filesWithIssues =
-            new Set([
-                ...r.issues.critical,
-                ...r.issues.warning,
-                ...r.issues.suggestion,
-            ].map((i) => i.file)).size;
+        r.filesWithIssues = new Set(
+            [...r.issues.critical, ...r.issues.warning, ...r.issues.suggestion].map((i) => i.file)
+        ).size;
     }
 
     // 过滤外部工具 issues

package/bin/fg-lsp.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+
 /**
  * Frontend Guardian LSP Server
  * Usage: fg-lsp --stdio [--project-dir <dir>] [--config <file>]
@@ -6,9 +7,9 @@
  * v3.3.0: Language Server Protocol 实现，为 IDE 提供实时诊断和快速修复。
  */
 
-import { runLSPServer } from "../dist/ide/lsp-server.js";
-import { resolve } from "node:path";
 import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { runLSPServer } from "../dist/ide/lsp-server.js";
 
 const args = process.argv.slice(2);
 
@@ -26,7 +27,7 @@ for (let i = 0; i < args.length; i++) {
     } else if (arg === "--severity" || arg === "-s") {
         minSeverity = args[++i] ?? "suggestion";
     } else if (arg === "--help" || arg === "-h") {
-        console.log(`Frontend Guardian LSP Server v3.7.6
+        console.log(`Frontend Guardian LSP Server v3.8.0
 
 Usage: fg-lsp [options]
 

package/bin/fg-server.js

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
+
 /**
  * Frontend Guardian Dashboard Server CLI
  * Usage: fg-server [options]
  */
 
-import { DashboardServer } from "../dist/index.js";
 import pc from "picocolors";
+import { DashboardServer } from "../dist/index.js";
 
 function showHelp() {
     console.log(`
-Frontend Guardian Dashboard Server v3.7.6
+Frontend Guardian Dashboard Server v3.8.0
 
 Usage:
   fg-server [options]
@@ -61,7 +62,7 @@ async function main() {
     }
 
     console.log(pc.cyan("Frontend Guardian Dashboard Server"));
-    console.log(pc.gray(`   Version: 3.7.5`));
+    console.log(pc.gray(`   Version: 3.8.0`));
     console.log("");
 
     const server = new DashboardServer({

package/dist/engine/rule-engine.d.ts

@@ -8,8 +8,8 @@
  * 4. 并行扫描多文件
  * 5. 支持增量扫描（git diff）
  */
-import type { Rule, Issue, Severity, ScanResult, FixPreview } from "../types.js";
 import type { ExternalTool, ExternalToolResult } from "../integrations/index.js";
+import type { FixPreview, Issue, Rule, ScanResult, Severity } from "../types.js";
 import { SmartCache } from "./cache.js";
 export interface EngineOptions {
     /** 项目根目录 */
@@ -48,6 +48,8 @@ export interface EngineOptions {
     incrementalImportGraph?: boolean;
     /** v3.5.0: 扫描策略分级 strict | standard | loose */
     strategy?: "strict" | "standard" | "loose";
+    /** v3.8.0: 静默模式（禁止向 stdout 输出日志，供 MCP Server 等场景使用） */
+    silent?: boolean;
 }
 export declare class RuleEngine {
     private registry;
@@ -56,6 +58,9 @@ export declare class RuleEngine {
     private options;
     private cache?;
     private history;
+    /** v3.8.0: 静默模式下禁止 stdout 日志 */
+    private log;
+    private logError;
     constructor(options: EngineOptions);
     /** ── Phase 3: 配置驱动规则加载 ── */
     private loadConfigRules;