frontend-guardian-core 3.14.1 → 3.20.0

package/bin/fg-core.js

@@ -10,15 +10,21 @@ import pc from "picocolors";
 import {
     AIFixSuggester,
     a11yRules,
+    backendRules,
     BaselineManager,
     buildNotificationPayload,
+    checkRuleCompatibility,
     CodeownersParser,
     compareHistoryReports,
     complianceReportToMarkdown,
     componentRules,
+    computeRuleScores,
     createEngine,
     createPublisher,
     crossFileRules,
+    cssRules,
+    cypressIntegration,
+    dataRules,
     detectAIConfig,
     detectCIProvider,
     detectE2EGaps,
@@ -31,36 +37,53 @@ import {
     e2eRules,
     FileWatcher,
     formatAllAnnotations,
+    formatCompatibilityReport,
+    formatCompatibilityReportJson,
     formatE2EGapJson,
     formatE2EGapReport,
+    formatGeneratedDocs,
     formatHistoryCompare,
     formatHistoryCompareJson,
+    formatImpactGraph,
+    formatMarketIndex,
+    formatMarketIndexJson,
     formatMiniProgramJson,
+    formatScanProfile,
     formatMiniProgramReport,
     formatPageHealthJson,
+    formatRecommendedConfig,
     formatPageHealthReport,
+    formatRuleScores,
+    formatRuleScoresJson,
     formatWorkspaceJson,
     formatWorkspaceReport,
     generateCIConfig,
     generateComplianceReport,
     generateDashboard,
     generatePRComment,
+    generateRuleDocs,
+    generateRuleTemplate,
     generateSarif,
     HistoryReport,
     hooksRules,
     i18nRules,
     initConfig,
     installGitHooks,
+    isCompatibilityReportClean,
     isGitHubActions,
     isPlaywrightAvailable,
+    katalonIntegration,
+    loadMarketIndex,
     namingRules,
     ProjectIndexer,
     performanceRules,
     platformRules,
+    recommendConfig,
     playwrightIntegration,
     runFixBot,
     runMiniProgramTest,
     runPageHealthCheck,
+    seleniumIntegration,
     SmartCache,
     saveComplianceReport,
     scanWorkspace,
@@ -87,6 +110,9 @@ const MODULES = [
     "platform",
     "svelte",
     "e2e",
+    "css",
+    "data",
+    "backend",
 ];
 
 const MODULE_RULES = {
@@ -101,18 +127,21 @@ const MODULE_RULES = {
     platform: platformRules,
     svelte: svelteRules,
     e2e: e2eRules,
+    css: cssRules,
+    data: dataRules,
+    backend: backendRules,
 };
 
 function showHelp() {
     console.log(`
-Frontend Guardian Core v3.14.1
+Frontend Guardian Core v3.20.0
 
 Usage:
   fg-core <project-dir> [options]
 
 Options:
   --scan               全量扫描（等价于 --module all）
-  --module <name>      扫描模块: i18n | performance | a11y | security | naming | cross-file | component | hooks | platform | svelte | e2e | all
+  --module <name>      扫描模块: i18n | performance | a11y | security | naming | cross-file | component | hooks | platform | svelte | e2e | css | data | backend | all
   --severity <level>   最低严重级别: critical | warning | suggestion (默认: suggestion)
   --files <pattern>    仅扫描匹配的文件
   --exclude <pattern>  排除匹配的文件
@@ -129,6 +158,9 @@ Options:
   --output <file>      将扫描报告写入指定文件（Markdown 格式）
   --external           运行外部工具集成 (ESLint / TypeScript / Stylelint)
   --watch              Watch 模式：文件变更自动增量扫描
+  --no-progress        禁用扫描进度条（v3.15.0）
+  --profile            输出扫描耗时分析：规则/文件耗时排名（v3.15.0）
+  --recommend-config   根据项目规模与框架自动推荐最优配置（v3.15.0）
   --no-cache           禁用智能缓存
   --config <file>      指定配置文件
   --install-hooks      安装 Git hook（默认 pre-commit，可用 --install-hooks-type 指定）
@@ -164,7 +196,8 @@ Options:
   --server <url>       扫描后上报到治理看板服务器
   --serve              扫描前启动本地看板服务（扫描完成后停止）
   --e2e-detect-gaps    检测 E2E 测试覆盖缺口（页面 + 接口）
-  --e2e-run            运行 Playwright E2E 测试并输出治理报告
+  --e2e-run            运行 E2E 测试并输出治理报告
+  --e2e-tool <tool>    E2E 工具: auto | playwright | cypress | selenium | katalon (默认: auto)（v3.16.0）
   --page-health        页面健康检查：遍历路由验证渲染、控制台错误、白屏
   --serve <cmd>        自动启动 dev server（配合 --page-health，如 "npm run dev"）
   --port <n>           dev server 端口（默认 5173，配合 --serve）
@@ -211,6 +244,22 @@ Options:
   --watch-index        监听文件变更并自动同步索引
   --index-status       查看项目索引状态
   --recommend-tests    智能测试推荐：基于变更影响分析推荐需要运行的测试（可配合 --staged/--diff/--auto-scope/--files）
+  --impact-graph       配合 --recommend-tests 输出变更影响图（默认 mermaid 格式）（v3.16.0）
+  --impact-graph-format <format>  影响图格式: json | mermaid | dot (默认: mermaid)（v3.16.0）
+  --create-rule <id>   生成规则模板文件（默认输出到 ./rules）（v3.17.0）
+  --create-rule-dir <dir>  规则模板输出目录（默认 ./rules）（v3.17.0）
+  --create-rule-category <cat>  规则分类（默认 security）（v3.17.0）
+  --create-rule-severity <sev>  严重级别: critical | warning | suggestion (默认: warning)（v3.17.0）
+  --create-rule-fix    生成的规则模板包含 fix 示例（v3.17.0）
+  --create-rule-lang <js|ts>  规则模板语言（默认 js）（v3.17.0）
+  --market-index       打印规则市场索引（v3.17.0）
+  --market-index-json  以 JSON 格式输出规则市场索引（v3.17.0）
+  --market-index-url <url>  覆盖默认市场索引 URL（v3.17.0）
+  --rule-scores        打印规则评分（基于本地扫描历史）（v3.17.0）
+  --rule-scores-json   以 JSON 格式输出规则评分（v3.17.0）
+  --generate-rule-docs              为所有规则生成 Markdown 文档（默认输出 ./docs/rules）（v3.18.0）
+  --generate-rule-docs-dir <dir>    指定规则文档输出目录（v3.18.0）
+  --check-rule-compat               检查当前启用规则集的兼容性/冲突（v3.18.0）
   --flaky-threshold-failure-rate <n>  flaky 测试失败率阈值（默认 0.2）
   --flaky-threshold-flip-rate <n>    flaky 测试状态翻转率阈值（默认 0.15）
   --flaky-min-runs <n>               参与 flaky 计算的最少历史运行次数（默认 3）
@@ -219,6 +268,8 @@ Options:
 
 Examples:
   fg-core ./my-project --module all
+  fg-core ./my-project --module backend
+  fg-core ./my-project --module backend --files "server/**/*.go"
   fg-core ./my-project --module i18n
   fg-core ./my-project --module i18n --severity warning --json
   fg-core ./my-project --module performance --files "src/**/*.tsx"
@@ -349,6 +400,30 @@ async function main() {
         flakyThresholdFailureRate: undefined,
         flakyThresholdFlipRate: undefined,
         flakyMinRuns: undefined,
+        // v3.16.0
+        impactGraph: false,
+        impactGraphFormat: "mermaid",
+        e2eTool: "auto",
+        // v3.17.0
+        createRule: undefined,
+        createRuleDir: "./rules",
+        createRuleCategory: "security",
+        createRuleSeverity: "warning",
+        createRuleFix: false,
+        createRuleLang: "js",
+        marketIndex: false,
+        marketIndexJson: false,
+        marketIndexUrl: undefined,
+        ruleScores: false,
+        ruleScoresJson: false,
+        // v3.18.0
+        generateRuleDocs: false,
+        generateRuleDocsDir: "./docs/rules",
+        checkRuleCompat: false,
+        // v3.15.0
+        profile: false,
+        showProgress: true,
+        recommendConfig: false,
         mcp: false,
     };
 
@@ -674,6 +749,65 @@ async function main() {
             case "--recommend-tests":
                 options.recommendTests = true;
                 break;
+            case "--impact-graph":
+                options.impactGraph = true;
+                break;
+            case "--impact-graph-format":
+                options.impactGraphFormat = args[++i];
+                break;
+            case "--e2e-tool":
+                options.e2eTool = args[++i];
+                break;
+            // v3.17.0
+            case "--create-rule": {
+                const next = args[i + 1];
+                if (next && !next.startsWith("-")) {
+                    options.createRule = args[++i];
+                } else {
+                    options.createRule = true;
+                }
+                break;
+            }
+            case "--create-rule-dir":
+                options.createRuleDir = args[++i];
+                break;
+            case "--create-rule-category":
+                options.createRuleCategory = args[++i];
+                break;
+            case "--create-rule-severity":
+                options.createRuleSeverity = args[++i];
+                break;
+            case "--create-rule-fix":
+                options.createRuleFix = true;
+                break;
+            case "--create-rule-lang":
+                options.createRuleLang = args[++i];
+                break;
+            case "--market-index":
+                options.marketIndex = true;
+                break;
+            case "--market-index-json":
+                options.marketIndexJson = true;
+                break;
+            case "--market-index-url":
+                options.marketIndexUrl = args[++i];
+                break;
+            case "--rule-scores":
+                options.ruleScores = true;
+                break;
+            case "--rule-scores-json":
+                options.ruleScoresJson = true;
+                break;
+            // v3.18.0
+            case "--generate-rule-docs":
+                options.generateRuleDocs = true;
+                break;
+            case "--generate-rule-docs-dir":
+                options.generateRuleDocsDir = args[++i];
+                break;
+            case "--check-rule-compat":
+                options.checkRuleCompat = true;
+                break;
             case "--flaky-threshold-failure-rate":
                 options.flakyThresholdFailureRate = parseFloat(args[++i]);
                 break;
@@ -686,6 +820,16 @@ async function main() {
             case "--mcp":
                 options.mcp = true;
                 break;
+            // v3.15.0
+            case "--profile":
+                options.profile = true;
+                break;
+            case "--no-progress":
+                options.showProgress = false;
+                break;
+            case "--recommend-config":
+                options.recommendConfig = true;
+                break;
             case "--help":
             case "-h":
                 showHelp();
@@ -704,6 +848,102 @@ async function main() {
         return;
     }
 
+    // v3.15.0: 配置推荐
+    if (options.recommendConfig) {
+        const rec = recommendConfig(options.projectDir);
+        if (options.json) {
+            console.log(JSON.stringify(rec, null, 2));
+        } else {
+            console.log(formatRecommendedConfig(rec));
+        }
+        process.exit(0);
+    }
+
+    // v3.17.0: 生成规则模板
+    if (options.createRule) {
+        const ruleId = typeof options.createRule === "string" ? options.createRule : undefined;
+        if (!ruleId) {
+            console.log(pc.yellow("⚠️  请提供规则 ID，例如: --create-rule no-console-log"));
+            process.exit(1);
+        }
+        try {
+            const result = generateRuleTemplate({
+                targetDir: resolve(options.projectDir, options.createRuleDir),
+                ruleId,
+                category: options.createRuleCategory,
+                severity: options.createRuleSeverity,
+                includeFix: options.createRuleFix,
+                language: options.createRuleLang,
+            });
+            console.log(pc.cyan("📝 规则模板已生成"));
+            console.log(pc.green(`   ✅ 规则文件: ${result.rulePath}`));
+            console.log(pc.green(`   ✅ 测试文件: ${result.testPath}`));
+            process.exit(0);
+        } catch (err) {
+            console.error(pc.red("❌ 生成规则模板失败:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    }
+
+    // v3.17.0: 规则市场索引
+    if (options.marketIndex || options.marketIndexJson) {
+        const market = await loadMarketIndex({
+            url: options.marketIndexUrl,
+            projectDir: options.projectDir,
+        });
+        if (options.marketIndexJson) {
+            console.log(formatMarketIndexJson(market));
+        } else {
+            console.log(formatMarketIndex(market));
+        }
+        process.exit(0);
+    }
+
+    // v3.17.0: 规则评分
+    if (options.ruleScores || options.ruleScoresJson) {
+        const summary = computeRuleScores(options.projectDir);
+        if (options.ruleScoresJson) {
+            console.log(formatRuleScoresJson(summary));
+        } else {
+            console.log(formatRuleScores(summary));
+        }
+        process.exit(0);
+    }
+
+    // v3.18.0: 规则文档生成
+    if (options.generateRuleDocs) {
+        try {
+            const engine = createEngine({ projectDir: options.projectDir, configFile: options.configFile });
+            const rules = engine.getRules ? engine.getRules() : Object.values(MODULE_RULES).flat();
+            const result = generateRuleDocs({
+                outputDir: resolve(options.projectDir, options.generateRuleDocsDir),
+                rules,
+            });
+            console.log(pc.cyan(formatGeneratedDocs(result)));
+            process.exit(0);
+        } catch (err) {
+            console.error(pc.red("❌ 生成规则文档失败:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    }
+
+    // v3.18.0: 规则兼容性检查
+    if (options.checkRuleCompat) {
+        try {
+            const engine = createEngine({ projectDir: options.projectDir, configFile: options.configFile });
+            const report = engine.checkRuleCompatibility();
+            if (options.json) {
+                console.log(formatCompatibilityReportJson(report));
+            } else {
+                console.log(formatCompatibilityReport(report));
+            }
+            process.exit(isCompatibilityReportClean(report) ? 0 : 2);
+        } catch (err) {
+            console.error(pc.red("❌ 规则兼容性检查失败:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    }
+
     // v3.6.0: E2E 测试覆盖缺口检测
     if (options.e2eDetectGaps) {
         const gapResult = detectE2EGaps({ projectDir: options.projectDir });
@@ -715,28 +955,49 @@ async function main() {
         process.exit(gapResult.uncoveredPages.length + gapResult.uncoveredApis.length > 0 ? 1 : 0);
     }
 
-    // v3.6.1: 运行 Playwright E2E 测试
+    // v3.6.1 / v3.16.0: 运行 E2E 测试（支持 Playwright / Cypress / Selenium / Katalon）
     if (options.e2eRun) {
-        if (!playwrightIntegration.isAvailable(options.projectDir)) {
-            console.log(pc.yellow("⚠️  未检测到 Playwright 配置（playwright.config.ts/js）或 playwright 包未安装"));
-            console.log(pc.gray("   请先安装 Playwright: npm install -D @playwright/test"));
-            console.log(pc.gray("   或初始化配置: npx playwright init"));
+        const tools = [
+            { name: "Playwright", integration: playwrightIntegration },
+            { name: "Cypress", integration: cypressIntegration },
+            { name: "Selenium", integration: seleniumIntegration },
+            { name: "Katalon", integration: katalonIntegration },
+        ];
+
+        let selected;
+        if (options.e2eTool === "auto") {
+            selected = tools.find((t) => t.integration.isAvailable(options.projectDir));
+        } else {
+            selected = tools.find((t) => t.name.toLowerCase() === options.e2eTool.toLowerCase());
+            if (selected && !selected.integration.isAvailable(options.projectDir)) {
+                console.log(pc.yellow(`⚠️  未检测到 ${selected.name} 配置或依赖`));
+                process.exit(1);
+            }
+        }
+
+        if (!selected) {
+            if (options.e2eTool === "auto") {
+                console.log(pc.yellow("⚠️  未检测到任何支持的 E2E 工具（Playwright / Cypress / Selenium / Katalon）"));
+            } else {
+                console.log(pc.yellow(`⚠️  未知的 E2E 工具: ${options.e2eTool}`));
+            }
+            console.log(pc.gray("   支持的工具: auto | playwright | cypress | selenium | katalon"));
             process.exit(1);
         }
 
-        console.log(pc.cyan("🎭 正在运行 Playwright E2E 测试..."));
+        console.log(pc.cyan(`🎭 正在运行 ${selected.name} E2E 测试...`));
         console.log(pc.gray("   这可能需要几分钟（取决于测试数量和浏览器启动时间）"));
         console.log("");
 
         const start = Date.now();
-        const issues = playwrightIntegration.run(options.projectDir);
+        const issues = selected.integration.run(options.projectDir);
         const duration = Date.now() - start;
 
         if (options.json) {
             console.log(
                 JSON.stringify(
                     {
-                        tool: "Playwright",
+                        tool: selected.name,
                         total: issues.length,
                         duration,
                         issues,
@@ -746,12 +1007,12 @@ async function main() {
                 )
             );
         } else {
-            console.log(pc.cyan(`📊 Playwright 测试结果`));
+            console.log(pc.cyan(`📊 ${selected.name} 测试结果`));
             console.log(pc.gray(`   耗时: ${duration}ms`));
             if (issues.length === 0) {
                 console.log(pc.green(`   ✅ 所有测试通过`));
             } else {
-                console.log(pc.red(`   ❌ ${issues.length} 个测试失败`));
+                console.log(pc.red(`   ❌ ${issues.length} 个测试失败/异常`));
                 for (const issue of issues) {
                     const severityColor = issue.severity === "critical" ? pc.red : pc.yellow;
                     console.log(severityColor(`      [${issue.severity.toUpperCase()}] ${issue.title}`));
@@ -978,7 +1239,7 @@ async function main() {
         process.exit(0);
     }
 
-    // v3.9.0: 智能测试推荐
+    // v3.9.0 / v3.16.0: 智能测试推荐
     if (options.recommendTests) {
         const { recommendTests, formatRecommendations, formatRecommendationsJson } = await import("../dist/index.js");
         const changedFiles = options.files?.map((f) => resolve(options.projectDir, f));
@@ -995,12 +1256,18 @@ async function main() {
                 flipRate: options.flakyThresholdFlipRate,
                 minRuns: options.flakyMinRuns,
             },
+            includeImpactGraph: options.impactGraph,
         });
 
         if (options.json) {
             console.log(JSON.stringify(formatRecommendationsJson(result), null, 2));
         } else {
             console.log(formatRecommendations(result));
+            if (options.impactGraph && result.impactGraph) {
+                console.log("");
+                console.log(pc.cyan("🕸️  变更影响图"));
+                console.log(formatImpactGraph(result.impactGraph, options.impactGraphFormat));
+            }
         }
 
         process.exit(result.uncoveredChanges.length > 0 ? 1 : 0);
@@ -1304,7 +1571,30 @@ async function main() {
         const scanFn = options.module === "all" ? runAllModules : runSingleModule;
         // v2.6.0: Watch 模式复用 SmartCache，实现缓存预热
         const cacheInstance = options.cache !== false ? new SmartCache(options.projectDir) : undefined;
-        await runWatchMode(options, scanFn, cacheInstance);
+        // v3.17.0: 需要先创建 engine，以便 watch 模式热重载自定义规则
+        const engine = createEngine({
+            projectDir: options.projectDir,
+            minSeverity: options.minSeverity,
+            files: options.files,
+            exclude: options.exclude,
+            configFile: options.configFile,
+            staged: options.staged,
+            diffRange: options.diffRange,
+            autoScope: options.autoScope,
+            external: options.external,
+            cache: options.cache,
+            cacheInstance,
+            dryRun: options.dryRun,
+            interactive: options.interactive,
+            skipLargeFilesThreshold: options.skipLargeFilesThreshold,
+            strategy: options.strategy,
+            profile: options.profile,
+            showProgress: options.showProgress,
+        });
+        for (const rules of Object.values(MODULE_RULES)) {
+            engine.registerAll(rules);
+        }
+        await runWatchMode(options, scanFn, cacheInstance, runSingleModule, engine);
     } else if (options.module === "all") {
         await runAllModules(options);
     } else {
@@ -1315,7 +1605,7 @@ async function main() {
 async function runAllModules(options, cacheInstance) {
     console.log(pc.cyan("🛡️  Frontend Guardian Core"));
     console.log(pc.gray(`   Project: ${options.projectDir}`));
-    console.log(pc.gray(`   Module: all (9 modules)`));
+    console.log(pc.gray(`   Module: all (${MODULES.length} modules)`));
     if (options.staged) {
         console.log(pc.gray(`   Mode: staged (git cached only)`));
     } else if (options.diffRange) {
@@ -1341,6 +1631,9 @@ async function runAllModules(options, cacheInstance) {
         interactive: options.interactive,
         skipLargeFilesThreshold: options.skipLargeFilesThreshold,
         strategy: options.strategy,
+        // v3.15.0
+        profile: options.profile,
+        showProgress: options.showProgress,
     });
 
     // 注册所有模块的规则
@@ -1393,6 +1686,11 @@ async function runAllModules(options, cacheInstance) {
             }
 
             allResults[mod] = result;
+            // v3.15.0: 输出扫描耗时分析
+            if (options.profile && !options.json && result.profile) {
+                console.log(formatScanProfile(result.profile));
+                console.log("");
+            }
             totalCritical += result.issues.critical.length;
             totalWarning += result.issues.warning.length;
             totalSuggestion += result.issues.suggestion.length;
@@ -1947,6 +2245,9 @@ async function runSingleModule(options, cacheInstance) {
         interactive: options.interactive,
         skipLargeFilesThreshold: options.skipLargeFilesThreshold,
         strategy: options.strategy,
+        // v3.15.0
+        profile: options.profile,
+        showProgress: options.showProgress,
     });
 
     // 注册规则
@@ -1978,6 +2279,11 @@ async function runSingleModule(options, cacheInstance) {
         }
 
         const { issues } = result;
+        // v3.15.0: 输出扫描耗时分析
+        if (options.profile && !options.json && result.profile) {
+            console.log(formatScanProfile(result.profile));
+            console.log("");
+        }
         let totalCritical = issues.critical.length;
         let totalWarning = issues.warning.length;
         let totalSuggestion = issues.suggestion.length;

package/bin/fg-lsp.js

@@ -27,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.14.1
+        console.log(`Frontend Guardian LSP Server v3.20.0
 
 Usage: fg-lsp [options]
 

package/bin/fg-server.js

@@ -10,7 +10,7 @@ import { DashboardServer } from "../dist/index.js";
 
 function showHelp() {
     console.log(`
-Frontend Guardian Dashboard Server v3.14.1
+Frontend Guardian Dashboard Server v3.20.0
 
 Usage:
   fg-server [options]
@@ -62,7 +62,7 @@ async function main() {
     }
 
     console.log(pc.cyan("Frontend Guardian Dashboard Server"));
-    console.log(pc.gray(`   Version: 3.14.0`));
+    console.log(pc.gray(`   Version: 3.20.0`));
     console.log("");
 
     const server = new DashboardServer({