frontend-guardian-core 2.9.0 → 3.1.0

package/bin/fg-core.js

@@ -44,6 +44,11 @@ import {
     scanWorkspace,
     formatWorkspaceReport,
     formatWorkspaceJson,
+    AIFixSuggester,
+    detectAIConfig,
+    compareHistoryReports,
+    formatHistoryCompare,
+    formatHistoryCompareJson,
 } from "../dist/index.js";
 import pc from "picocolors";
 import { runWatchMode } from "./watch-mode.js";
@@ -76,7 +81,7 @@ const MODULE_RULES = {
 
 function showHelp() {
     console.log(`
-Frontend Guardian Core v2.9.0
+Frontend Guardian Core v3.1.0
 
 Usage:
   fg-core <project-dir> [options]
@@ -118,11 +123,14 @@ Options:
   --history            查看历史扫描记录
   --history-module <m> 历史记录按模块过滤（配合 --history）
   --history-limit <n>  历史记录显示条数限制（默认 20）
+  --history-compare [c] [p] 对比历史报告：不指定则对比最近两次；指定一个则与该报告对比最近一次；指定两个则对比指定报告
   --generate-dashboard 生成团队趋势看板 HTML 页面
   --monorepo           启用 Monorepo 模式：自动检测 workspace 并扫描所有子包
   --workspace <name>   仅扫描指定 workspace 包（可多次使用，配合 --monorepo）
   --skip-package <name> 跳过指定 workspace 包（可多次使用，配合 --monorepo）
   --no-cross-deps      禁用跨包依赖分析（配合 --monorepo）
+  --ai-fix             启用 AI 修复建议（需配置 FG_AI_API_KEY 环境变量）
+  --ai-model <model>   指定 AI 模型（如 gpt-4o-mini / claude-3-5-sonnet，配合 --ai-fix）
   --help, -h           显示帮助
 
 Examples:
@@ -181,11 +189,15 @@ async function main() {
         history: false,
         historyModule: undefined,
         historyLimit: 20,
+        historyCompare: false,
+        historyCompareArgs: [],
         generateDashboard: false,
         monorepo: false,
         workspace: [],
         skipPackage: [],
         crossDeps: true,
+        aiFix: false,
+        aiModel: undefined,
     };
 
     for (let i = 0; i < args.length; i++) {
@@ -301,6 +313,13 @@ async function main() {
             case "--history-limit":
                 options.historyLimit = parseInt(args[++i], 10) || 20;
                 break;
+            case "--history-compare":
+                options.historyCompare = true;
+                // 收集后续非 -- 开头的参数作为对比报告引用
+                while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+                    options.historyCompareArgs.push(args[++i]);
+                }
+                break;
             case "--generate-dashboard":
                 options.generateDashboard = true;
                 break;
@@ -316,6 +335,12 @@ async function main() {
             case "--no-cross-deps":
                 options.crossDeps = false;
                 break;
+            case "--ai-fix":
+                options.aiFix = true;
+                break;
+            case "--ai-model":
+                options.aiModel = args[++i];
+                break;
             case "--help":
             case "-h":
                 showHelp();
@@ -409,6 +434,28 @@ async function main() {
         process.exit(0);
     }
 
+    // v3.1.0: 历史报告对比
+    if (options.historyCompare) {
+        const [currentRef, previousRef] = options.historyCompareArgs;
+        const result = compareHistoryReports({
+            projectDir: options.projectDir,
+            current: currentRef,
+            previous: previousRef,
+        });
+
+        if (!result) {
+            console.log(pc.yellow("⚠️  暂无历史报告可供对比。请先运行 --save-report 生成历史数据。"));
+            process.exit(1);
+        }
+
+        if (options.json) {
+            console.log(JSON.stringify(formatHistoryCompareJson(result), null, 2));
+        } else {
+            console.log(formatHistoryCompare(result));
+        }
+        process.exit(0);
+    }
+
     // v2.8.0: 生成趋势看板
     if (options.generateDashboard) {
         const hr = new HistoryReport(options.projectDir);
@@ -965,6 +1012,45 @@ async function runAllModules(options, cacheInstance) {
         }
     }
 
+    // v3.0.0: AI 修复建议
+    if (options.aiFix) {
+        const aiConfig = detectAIConfig();
+        if (aiConfig) {
+            if (options.aiModel) {
+                aiConfig.model = options.aiModel;
+            }
+            console.log(pc.cyan("🤖 正在生成 AI 修复建议..."));
+            const suggester = new AIFixSuggester(aiConfig);
+            const allIssues = collectAllIssues(allResults, externalResults);
+            // 只给没有自动修复的 issue 生成 AI 建议
+            const issuesWithoutFix = allIssues.filter((i) => !i.fix);
+            if (issuesWithoutFix.length > 0) {
+                const suggestions = await suggester.suggestFixes(issuesWithoutFix.slice(0, 5), options.projectDir);
+                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("●");
+                        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}`));
+                        if (s.explanation) {
+                            console.log(pc.gray(`      说明: ${s.explanation}`));
+                        }
+                        console.log(pc.gray(`      模型: ${s.model}`));
+                    }
+                } else {
+                    console.log(pc.gray("   未生成 AI 修复建议"));
+                }
+            } else {
+                console.log(pc.gray("   所有问题都有自动修复，无需 AI 建议"));
+            }
+            console.log("");
+        } else {
+            console.log(pc.yellow("   ⚠️ 未检测到 AI 配置。请设置 FG_AI_API_KEY 或 OPENAI_API_KEY 环境变量。"));
+            console.log("");
+        }
+    }
+
     // v2.8.0: 保存完整扫描报告
     if (options.saveReport) {
         const hr = new HistoryReport(options.projectDir);
@@ -1306,6 +1392,44 @@ async function runSingleModule(options, cacheInstance) {
             }
         }
 
+        // v3.0.0: AI 修复建议
+        if (options.aiFix) {
+            const aiConfig = detectAIConfig();
+            if (aiConfig) {
+                if (options.aiModel) {
+                    aiConfig.model = options.aiModel;
+                }
+                console.log(pc.cyan("\n🤖 正在生成 AI 修复建议..."));
+                const suggester = new AIFixSuggester(aiConfig);
+                const allIssues = [...issues.critical, ...issues.warning, ...issues.suggestion];
+                const issuesWithoutFix = allIssues.filter((i) => !i.fix);
+                if (issuesWithoutFix.length > 0) {
+                    const suggestions = await suggester.suggestFixes(issuesWithoutFix.slice(0, 5), options.projectDir);
+                    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("●");
+                            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}`));
+                            if (s.explanation) {
+                                console.log(pc.gray(`      说明: ${s.explanation}`));
+                            }
+                            console.log(pc.gray(`      模型: ${s.model}`));
+                        }
+                    } else {
+                        console.log(pc.gray("   未生成 AI 修复建议"));
+                    }
+                } else {
+                    console.log(pc.gray("   所有问题都有自动修复，无需 AI 建议"));
+                }
+                console.log("");
+            } else {
+                console.log(pc.yellow("   ⚠️ 未检测到 AI 配置。请设置 FG_AI_API_KEY 或 OPENAI_API_KEY 环境变量。"));
+                console.log("");
+            }
+        }
+
         console.log(
             pc.gray(
                 `⏱️  耗时: ${result.duration}ms | 扫描 ${result.filesScanned} 个文件 | ${result.filesWithIssues} 个文件有问题`

package/dist/index.d.ts

@@ -23,6 +23,10 @@ export { detectMonorepo, analyzeCrossPackageDeps } from "./utils/monorepo.js";
 export type { MonorepoInfo, WorkspacePackage, CrossPackageIssue, MonorepoTool } from "./utils/monorepo.js";
 export { scanWorkspace, formatWorkspaceReport, formatWorkspaceJson } from "./utils/workspace-scanner.js";
 export type { WorkspaceScanResult, PackageScanResult, WorkspaceSummary, WorkspaceScanOptions } from "./utils/workspace-scanner.js";
+export { AIFixSuggester, detectAIConfig, generateAIFixSuggestions } from "./utils/ai-fix-suggester.js";
+export type { AIConfig, AIProvider, AIFixSuggestion } from "./utils/ai-fix-suggester.js";
+export { compareHistoryReports, formatHistoryCompare, formatHistoryCompareJson } from "./utils/history-compare.js";
+export type { HistoryCompareResult, HistoryCompareOptions, ComparedIssue, IssueStatus, ReportRef } from "./utils/history-compare.js";
 export { uploadReport, detectUploadConfig } from "./utils/report-uploader.js";
 export type { UploadConfig, UploadResult } from "./utils/report-uploader.js";
 export { runFixBot, detectFixBotConfig } from "./utils/fix-bot.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,8 +4,8 @@
  * 导出所有公共 API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectPublisherConfig = exports.GitLabMRPublisher = exports.GitHubPRPublisher = exports.isGuardianComment = exports.COMMENT_MARKER = exports.generatePRCommentSummary = exports.generatePRComment = exports.writeJobSummary = exports.isGitHubActions = exports.formatAllAnnotations = exports.formatIssuesAnnotations = exports.formatIssueAnnotation = exports.formatSarif = exports.generateSarif = exports.toBaselineIssue = exports.saveBaseline = exports.loadBaseline = exports.generateBaseline = exports.compareWithBaseline = exports.BaselineManager = exports.detectFixBotConfig = exports.runFixBot = exports.detectUploadConfig = exports.uploadReport = exports.formatWorkspaceJson = exports.formatWorkspaceReport = exports.scanWorkspace = exports.analyzeCrossPackageDeps = exports.detectMonorepo = exports.generateDashboard = exports.HistoryReport = exports.detectCIProvider = exports.generateCIConfig = exports.detectHusky = exports.hasGitHook = exports.uninstallGitHooks = exports.installGitHooks = exports.generateDefaultConfig = exports.initConfig = exports.loadConfig = exports.detectProjectMeta = exports.walkAST = exports.hasImport = exports.getImports = exports.parseAST = exports.createRegistry = exports.RuleRegistry = exports.SmartCache = exports.createEngine = exports.RuleEngine = void 0;
-exports.getJSXTagName = exports.getFileExt = exports.svelteRules = exports.platformRules = exports.hooksRules = exports.componentRules = exports.crossFileRules = exports.namingRules = exports.securityRules = exports.a11yRules = exports.performanceRules = exports.i18nRules = exports.runAllExternalTools = exports.stylelintIntegration = exports.typescriptIntegration = exports.eslintIntegration = exports.allExternalTools = exports.autoPublishComment = exports.createPublisher = void 0;
+exports.generatePRComment = exports.writeJobSummary = exports.isGitHubActions = exports.formatAllAnnotations = exports.formatIssuesAnnotations = exports.formatIssueAnnotation = exports.formatSarif = exports.generateSarif = exports.toBaselineIssue = exports.saveBaseline = exports.loadBaseline = exports.generateBaseline = exports.compareWithBaseline = exports.BaselineManager = exports.detectFixBotConfig = exports.runFixBot = exports.detectUploadConfig = exports.uploadReport = exports.formatHistoryCompareJson = exports.formatHistoryCompare = exports.compareHistoryReports = exports.generateAIFixSuggestions = exports.detectAIConfig = exports.AIFixSuggester = exports.formatWorkspaceJson = exports.formatWorkspaceReport = exports.scanWorkspace = exports.analyzeCrossPackageDeps = exports.detectMonorepo = exports.generateDashboard = exports.HistoryReport = exports.detectCIProvider = exports.generateCIConfig = exports.detectHusky = exports.hasGitHook = exports.uninstallGitHooks = exports.installGitHooks = exports.generateDefaultConfig = exports.initConfig = exports.loadConfig = exports.detectProjectMeta = exports.walkAST = exports.hasImport = exports.getImports = exports.parseAST = exports.createRegistry = exports.RuleRegistry = exports.SmartCache = exports.createEngine = exports.RuleEngine = void 0;
+exports.getJSXTagName = exports.getFileExt = exports.svelteRules = exports.platformRules = exports.hooksRules = exports.componentRules = exports.crossFileRules = exports.namingRules = exports.securityRules = exports.a11yRules = exports.performanceRules = exports.i18nRules = exports.runAllExternalTools = exports.stylelintIntegration = exports.typescriptIntegration = exports.eslintIntegration = exports.allExternalTools = exports.autoPublishComment = exports.createPublisher = exports.detectPublisherConfig = exports.GitLabMRPublisher = exports.GitHubPRPublisher = exports.isGuardianComment = exports.COMMENT_MARKER = exports.generatePRCommentSummary = void 0;
 var rule_engine_js_1 = require("./engine/rule-engine.js");
 Object.defineProperty(exports, "RuleEngine", { enumerable: true, get: function () { return rule_engine_js_1.RuleEngine; } });
 Object.defineProperty(exports, "createEngine", { enumerable: true, get: function () { return rule_engine_js_1.createEngine; } });
@@ -47,6 +47,16 @@ var workspace_scanner_js_1 = require("./utils/workspace-scanner.js");
 Object.defineProperty(exports, "scanWorkspace", { enumerable: true, get: function () { return workspace_scanner_js_1.scanWorkspace; } });
 Object.defineProperty(exports, "formatWorkspaceReport", { enumerable: true, get: function () { return workspace_scanner_js_1.formatWorkspaceReport; } });
 Object.defineProperty(exports, "formatWorkspaceJson", { enumerable: true, get: function () { return workspace_scanner_js_1.formatWorkspaceJson; } });
+// v3.0.0: AI 修复建议
+var ai_fix_suggester_js_1 = require("./utils/ai-fix-suggester.js");
+Object.defineProperty(exports, "AIFixSuggester", { enumerable: true, get: function () { return ai_fix_suggester_js_1.AIFixSuggester; } });
+Object.defineProperty(exports, "detectAIConfig", { enumerable: true, get: function () { return ai_fix_suggester_js_1.detectAIConfig; } });
+Object.defineProperty(exports, "generateAIFixSuggestions", { enumerable: true, get: function () { return ai_fix_suggester_js_1.generateAIFixSuggestions; } });
+// v3.1.0: 历史报告对比
+var history_compare_js_1 = require("./utils/history-compare.js");
+Object.defineProperty(exports, "compareHistoryReports", { enumerable: true, get: function () { return history_compare_js_1.compareHistoryReports; } });
+Object.defineProperty(exports, "formatHistoryCompare", { enumerable: true, get: function () { return history_compare_js_1.formatHistoryCompare; } });
+Object.defineProperty(exports, "formatHistoryCompareJson", { enumerable: true, get: function () { return history_compare_js_1.formatHistoryCompareJson; } });
 // v2.5.0: 报告上传
 var report_uploader_js_1 = require("./utils/report-uploader.js");
 Object.defineProperty(exports, "uploadReport", { enumerable: true, get: function () { return report_uploader_js_1.uploadReport; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/ai-fix-suggester.d.ts

@@ -0,0 +1,85 @@
+/**
+ * AI Fix Suggester — LLM 驱动的 Issue 修复建议
+ *
+ * v3.0.0 功能：
+ * 1. 为无自动修复的 Issue 生成 AI 修复建议
+ * 2. 为低置信度修复提供替代方案
+ * 3. 支持 OpenAI / Claude API
+ * 4. 建议缓存避免重复调用
+ */
+import type { Issue, Fix, FixConfidence } from "../types.js";
+/** AI 提供商 */
+export type AIProvider = "openai" | "claude" | "auto";
+/** AI 修复建议结果 */
+export interface AIFixSuggestion {
+    /** 原始 Issue */
+    issue: Issue;
+    /** AI 生成的修复 */
+    fix: Fix;
+    /** AI 修复的置信度 */
+    confidence: FixConfidence;
+    /** AI 对修复的解释 */
+    explanation?: string;
+    /** 使用的模型 */
+    model?: string;
+}
+/** AI 配置 */
+export interface AIConfig {
+    /** 提供商 */
+    provider: AIProvider;
+    /** API Key */
+    apiKey: string;
+    /** 模型名称 */
+    model: string;
+    /** API 基础 URL（可选，用于自定义端点） */
+    baseUrl?: string;
+    /** 最大 token 数 */
+    maxTokens?: number;
+    /** 温度 */
+    temperature?: number;
+    /** 是否启用缓存 */
+    cacheEnabled?: boolean;
+    /** 缓存目录 */
+    cacheDir?: string;
+}
+/** 从环境变量检测 AI 配置 */
+export declare function detectAIConfig(): AIConfig | null;
+/**
+ * AI 修复建议器
+ */
+export declare class AIFixSuggester {
+    private config;
+    private cacheDir?;
+    constructor(config: AIConfig);
+    /**
+     * 为单个 Issue 生成 AI 修复建议
+     */
+    suggestFix(issue: Issue, projectDir: string): Promise<AIFixSuggestion | null>;
+    /**
+     * 批量生成 AI 修复建议
+     */
+    suggestFixes(issues: Issue[], projectDir: string): Promise<AIFixSuggestion[]>;
+    /** 构建给 LLM 的 prompt */
+    private buildPrompt;
+    /** 调用 LLM API */
+    private callLLM;
+    /** 调用 Claude API */
+    private callClaude;
+    /** 调用 OpenAI API */
+    private callOpenAI;
+    /** 解析 LLM 响应 */
+    private parseResponse;
+    /** 读取源代码文件 */
+    private readSource;
+    /** 生成缓存 key */
+    private getCacheKey;
+    /** 读取缓存 */
+    private readCache;
+    /** 写入缓存 */
+    private writeCache;
+}
+/**
+ * 为 Issue 列表生成 AI 修复建议的便捷函数
+ */
+export declare function generateAIFixSuggestions(issues: Issue[], projectDir: string, config?: Partial<AIConfig>): Promise<AIFixSuggestion[]>;
+//# sourceMappingURL=ai-fix-suggester.d.ts.map

package/dist/utils/ai-fix-suggester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-fix-suggester.d.ts","sourceRoot":"","sources":["../../src/utils/ai-fix-suggester.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,aAAa;AACb,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC5B,eAAe;IACf,KAAK,EAAE,KAAK,CAAC;IACb,eAAe;IACf,GAAG,EAAE,GAAG,CAAC;IACT,gBAAgB;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,YAAY;AACZ,MAAM,WAAW,QAAQ;IACrB,UAAU;IACV,QAAQ,EAAE,UAAU,CAAC;IACrB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oBAAoB;AACpB,wBAAgB,cAAc,IAAI,QAAQ,GAAG,IAAI,CAiChD;AAED;;GAEG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,MAAM,EAAE,QAAQ;IAO5B;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAmCnF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAanF,uBAAuB;IACvB,OAAO,CAAC,WAAW;IAgCnB,iBAAiB;YACH,OAAO;IAOrB,oBAAoB;YACN,UAAU;IAyBxB,oBAAoB;YACN,UAAU;IAwBxB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAiCrB,cAAc;IACd,OAAO,CAAC,UAAU;IAqBlB,eAAe;IACf,OAAO,CAAC,WAAW;IAQnB,WAAW;IACX,OAAO,CAAC,SAAS;IAYjB,WAAW;IACX,OAAO,CAAC,UAAU;CAYrB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,KAAK,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CAa5B"}

package/dist/utils/ai-fix-suggester.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * AI Fix Suggester — LLM 驱动的 Issue 修复建议
+ *
+ * v3.0.0 功能：
+ * 1. 为无自动修复的 Issue 生成 AI 修复建议
+ * 2. 为低置信度修复提供替代方案
+ * 3. 支持 OpenAI / Claude API
+ * 4. 建议缓存避免重复调用
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIFixSuggester = void 0;
+exports.detectAIConfig = detectAIConfig;
+exports.generateAIFixSuggestions = generateAIFixSuggestions;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+/** 从环境变量检测 AI 配置 */
+function detectAIConfig() {
+    const provider = process.env.FG_AI_PROVIDER || "auto";
+    const apiKey = process.env.FG_AI_API_KEY || process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY || "";
+    if (!apiKey) {
+        return null;
+    }
+    // 自动推断提供商
+    let detectedProvider = provider;
+    if (provider === "auto") {
+        if (process.env.ANTHROPIC_API_KEY) {
+            detectedProvider = "claude";
+        }
+        else if (process.env.OPENAI_API_KEY || process.env.FG_AI_API_KEY) {
+            detectedProvider = "openai";
+        }
+    }
+    // 默认模型
+    const defaultModel = detectedProvider === "claude"
+        ? "claude-3-5-sonnet-20241022"
+        : "gpt-4o-mini";
+    return {
+        provider: detectedProvider,
+        apiKey,
+        model: process.env.FG_AI_MODEL || defaultModel,
+        baseUrl: process.env.FG_AI_BASE_URL,
+        maxTokens: parseInt(process.env.FG_AI_MAX_TOKENS || "2048", 10),
+        temperature: parseFloat(process.env.FG_AI_TEMPERATURE || "0.2"),
+        cacheEnabled: process.env.FG_AI_CACHE !== "false",
+        cacheDir: process.env.FG_AI_CACHE_DIR,
+    };
+}
+/**
+ * AI 修复建议器
+ */
+class AIFixSuggester {
+    config;
+    cacheDir;
+    constructor(config) {
+        this.config = config;
+        if (config.cacheEnabled !== false) {
+            this.cacheDir = config.cacheDir || (0, node_path_1.join)(process.cwd(), ".frontend-guardian", "ai-cache");
+        }
+    }
+    /**
+     * 为单个 Issue 生成 AI 修复建议
+     */
+    async suggestFix(issue, projectDir) {
+        const cacheKey = this.getCacheKey(issue);
+        // 尝试从缓存读取
+        if (this.cacheDir) {
+            const cached = this.readCache(cacheKey);
+            if (cached) {
+                return { ...cached, issue };
+            }
+        }
+        // 读取源代码
+        const source = this.readSource(issue.file, projectDir, issue.line);
+        if (!source) {
+            return null;
+        }
+        // 构建 prompt
+        const prompt = this.buildPrompt(issue, source);
+        try {
+            const response = await this.callLLM(prompt);
+            const suggestion = this.parseResponse(response, issue);
+            if (suggestion && this.cacheDir) {
+                this.writeCache(cacheKey, suggestion);
+            }
+            return suggestion;
+        }
+        catch (err) {
+            // 静默失败，返回 null
+            return null;
+        }
+    }
+    /**
+     * 批量生成 AI 修复建议
+     */
+    async suggestFixes(issues, projectDir) {
+        const results = [];
+        for (const issue of issues) {
+            const suggestion = await this.suggestFix(issue, projectDir);
+            if (suggestion) {
+                results.push(suggestion);
+            }
+        }
+        return results;
+    }
+    /** 构建给 LLM 的 prompt */
+    buildPrompt(issue, source) {
+        return `You are an expert frontend code reviewer. Given the following code issue, provide a precise fix.
+
+Issue Details:
+- Rule: ${issue.ruleId}
+- Title: ${issue.title}
+- Description: ${issue.description}
+- File: ${issue.file}
+- Line: ${issue.line}, Column: ${issue.column}
+- Severity: ${issue.severity}
+
+Source Code (around the issue):
+\`\`\`
+${source}
+\`\`\`
+
+Please provide:
+1. The fixed code snippet (only the corrected version, no explanations)
+2. A brief explanation of the fix
+3. Your confidence in this fix: high / medium / low
+
+Format your response as:
+FIX:
+<corrected code snippet>
+
+EXPLANATION:
+<brief explanation>
+
+CONFIDENCE:
+<high|medium|low>`;
+    }
+    /** 调用 LLM API */
+    async callLLM(prompt) {
+        if (this.config.provider === "claude") {
+            return this.callClaude(prompt);
+        }
+        return this.callOpenAI(prompt);
+    }
+    /** 调用 Claude API */
+    async callClaude(prompt) {
+        const url = this.config.baseUrl || "https://api.anthropic.com/v1/messages";
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": this.config.apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                max_tokens: this.config.maxTokens || 2048,
+                temperature: this.config.temperature || 0.2,
+                messages: [{ role: "user", content: prompt }],
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Claude API error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data.content[0]?.text || "";
+    }
+    /** 调用 OpenAI API */
+    async callOpenAI(prompt) {
+        const url = this.config.baseUrl || "https://api.openai.com/v1/chat/completions";
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.config.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                max_tokens: this.config.maxTokens || 2048,
+                temperature: this.config.temperature || 0.2,
+                messages: [{ role: "user", content: prompt }],
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`OpenAI API error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data.choices[0]?.message?.content || "";
+    }
+    /** 解析 LLM 响应 */
+    parseResponse(response, issue) {
+        const fixMatch = response.match(/FIX:\s*\n?([\s\S]*?)(?=\n?EXPLANATION:|\n?CONFIDENCE:|$)/);
+        const explanationMatch = response.match(/EXPLANATION:\s*\n?([\s\S]*?)(?=\n?CONFIDENCE:|$)/);
+        const confidenceMatch = response.match(/CONFIDENCE:\s*(high|medium|low)/i);
+        if (!fixMatch) {
+            return null;
+        }
+        const fixedCode = fixMatch[1].trim();
+        const explanation = explanationMatch ? explanationMatch[1].trim() : undefined;
+        const confidenceStr = confidenceMatch ? confidenceMatch[1].toLowerCase() : "medium";
+        const confidence = ["high", "medium", "low"].includes(confidenceStr) ? confidenceStr : "medium";
+        // 构建 Fix 对象
+        // 简单实现：替换整行代码
+        const fix = {
+            text: fixedCode,
+            start: { line: issue.line, column: issue.column },
+            end: { line: issue.endLine || issue.line, column: issue.endColumn || issue.column + 1 },
+            confidence,
+            description: explanation,
+        };
+        return {
+            issue,
+            fix,
+            confidence,
+            explanation,
+            model: this.config.model,
+        };
+    }
+    /** 读取源代码文件 */
+    readSource(filePath, projectDir, issueLine) {
+        const fullPath = (0, node_path_1.resolve)(projectDir, filePath);
+        if (!(0, node_fs_1.existsSync)(fullPath)) {
+            return null;
+        }
+        try {
+            const content = (0, node_fs_1.readFileSync)(fullPath, "utf-8");
+            const lines = content.split("\n");
+            // 提取 issue 周围的代码（前后 5 行）
+            const startLine = Math.max(0, issueLine - 6);
+            const endLine = Math.min(lines.length, issueLine + 5);
+            const contextLines = lines.slice(startLine, endLine);
+            // 添加行号
+            return contextLines.map((line, idx) => `${startLine + idx + 1}: ${line}`).join("\n");
+        }
+        catch {
+            return null;
+        }
+    }
+    /** 生成缓存 key */
+    getCacheKey(issue) {
+        const hash = (0, node_crypto_1.createHash)("sha256")
+            .update(`${issue.file}|${issue.ruleId}|${issue.line}|${issue.column}|${issue.title}`)
+            .digest("hex")
+            .slice(0, 16);
+        return hash;
+    }
+    /** 读取缓存 */
+    readCache(key) {
+        if (!this.cacheDir)
+            return null;
+        try {
+            const cachePath = (0, node_path_1.join)(this.cacheDir, `${key}.json`);
+            if (!(0, node_fs_1.existsSync)(cachePath))
+                return null;
+            const raw = (0, node_fs_1.readFileSync)(cachePath, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** 写入缓存 */
+    writeCache(key, suggestion) {
+        if (!this.cacheDir)
+            return;
+        try {
+            if (!(0, node_fs_1.existsSync)(this.cacheDir)) {
+                (0, node_fs_1.mkdirSync)(this.cacheDir, { recursive: true });
+            }
+            const cachePath = (0, node_path_1.join)(this.cacheDir, `${key}.json`);
+            (0, node_fs_1.writeFileSync)(cachePath, JSON.stringify(suggestion, null, 2), "utf-8");
+        }
+        catch {
+            // 忽略缓存写入失败
+        }
+    }
+}
+exports.AIFixSuggester = AIFixSuggester;
+/**
+ * 为 Issue 列表生成 AI 修复建议的便捷函数
+ */
+async function generateAIFixSuggestions(issues, projectDir, config) {
+    const detected = detectAIConfig();
+    if (!detected) {
+        return [];
+    }
+    const mergedConfig = {
+        ...detected,
+        ...config,
+    };
+    const suggester = new AIFixSuggester(mergedConfig);
+    return suggester.suggestFixes(issues, projectDir);
+}
+//# sourceMappingURL=ai-fix-suggester.js.map

package/dist/utils/ai-fix-suggester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-fix-suggester.js","sourceRoot":"","sources":["../../src/utils/ai-fix-suggester.ts"],"names":[],"mappings":"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"}

package/dist/utils/history-compare.d.ts

@@ -0,0 +1,60 @@
+/**
+ * History Report Compare — 历史报告对比
+ *
+ * 功能：
+ * 1. 对比两次扫描报告，输出新增/已修复/持续存在的问题明细
+ * 2. 支持按文件+规则+行号精确匹配 issue
+ * 3. 检测 severity 变化的问题
+ * 4. 终端友好输出 + JSON 结构化输出
+ */
+import type { Issue, Severity } from "../types.js";
+export type IssueStatus = "new" | "fixed" | "persistent" | "changed";
+export interface ComparedIssue {
+    issue: Issue;
+    status: IssueStatus;
+    previousSeverity?: Severity;
+    previousIssue?: Issue;
+}
+export interface ReportRef {
+    filename: string;
+    timestamp: number;
+    module: string;
+    git?: {
+        commit?: string;
+        branch?: string;
+    };
+}
+export interface HistoryCompareResult {
+    currentReport: ReportRef;
+    previousReport: ReportRef;
+    summary: {
+        new: number;
+        fixed: number;
+        persistent: number;
+        changed: number;
+        totalCurrent: number;
+        totalPrevious: number;
+    };
+    newIssues: ComparedIssue[];
+    fixedIssues: ComparedIssue[];
+    persistentIssues: ComparedIssue[];
+    changedIssues: ComparedIssue[];
+}
+export interface HistoryCompareOptions {
+    projectDir: string;
+    current?: string;
+    previous?: string;
+}
+/**
+ * 对比两次历史报告
+ */
+export declare function compareHistoryReports(options: HistoryCompareOptions): HistoryCompareResult | null;
+/**
+ * 终端友好的对比报告输出
+ */
+export declare function formatHistoryCompare(result: HistoryCompareResult): string;
+/**
+ * JSON 格式的对比结果
+ */
+export declare function formatHistoryCompareJson(result: HistoryCompareResult): object;
+//# sourceMappingURL=history-compare.d.ts.map

package/dist/utils/history-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-compare.d.ts","sourceRoot":"","sources":["../../src/utils/history-compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB,CAAC,EAAE,QAAQ,CAAC;IAC5B,aAAa,CAAC,EAAE,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,SAAS,CAAC;IACzB,cAAc,EAAE,SAAS,CAAC;IAC1B,OAAO,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,aAAa,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAuDD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,IAAI,CA+FjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAgEzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAuB7E"}

package/dist/utils/history-compare.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * History Report Compare — 历史报告对比
+ *
+ * 功能：
+ * 1. 对比两次扫描报告，输出新增/已修复/持续存在的问题明细
+ * 2. 支持按文件+规则+行号精确匹配 issue
+ * 3. 检测 severity 变化的问题
+ * 4. 终端友好输出 + JSON 结构化输出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareHistoryReports = compareHistoryReports;
+exports.formatHistoryCompare = formatHistoryCompare;
+exports.formatHistoryCompareJson = formatHistoryCompareJson;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** Issue 签名：用于跨报告精确匹配 */
+function issueSignature(issue) {
+    return `${issue.file}|${issue.ruleId}|${issue.line}`;
+}
+/** 从 history 目录加载报告 */
+function loadReport(projectDir, filename) {
+    const reportsDir = (0, node_path_1.resolve)(projectDir, ".frontend-guardian", "history");
+    try {
+        const raw = (0, node_fs_1.readFileSync)((0, node_path_1.resolve)(reportsDir, filename), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** 列出所有报告文件（按时间倒序） */
+function listReportFiles(projectDir) {
+    const reportsDir = (0, node_path_1.resolve)(projectDir, ".frontend-guardian", "history");
+    try {
+        if (!(0, node_fs_1.existsSync)(reportsDir))
+            return [];
+        return (0, node_fs_1.readdirSync)(reportsDir)
+            .filter((f) => f.endsWith(".json"))
+            .sort()
+            .reverse();
+    }
+    catch {
+        return [];
+    }
+}
+/** 查找报告文件（支持 "latest" 和模糊匹配） */
+function resolveReportFile(projectDir, ref, exclude) {
+    const files = listReportFiles(projectDir);
+    if (files.length === 0)
+        return null;
+    if (!ref || ref === "latest") {
+        if (exclude) {
+            return files.find((f) => f !== exclude) ?? null;
+        }
+        return files[0];
+    }
+    // 精确匹配
+    if (files.includes(ref))
+        return ref;
+    // 前缀匹配（如 "20250601" 匹配 "20250601-120000.json"）
+    const matches = files.filter((f) => f.startsWith(ref));
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1)
+        return matches[0]; // 取最新的
+    return null;
+}
+/**
+ * 对比两次历史报告
+ */
+function compareHistoryReports(options) {
+    const files = listReportFiles(options.projectDir);
+    if (files.length === 0)
+        return null;
+    const currentFile = resolveReportFile(options.projectDir, options.current);
+    if (!currentFile)
+        return null;
+    const previousFile = resolveReportFile(options.projectDir, options.previous, currentFile);
+    if (!previousFile)
+        return null;
+    const current = loadReport(options.projectDir, currentFile);
+    const previous = loadReport(options.projectDir, previousFile);
+    if (!current || !previous)
+        return null;
+    const currentIssues = current.issues;
+    const previousIssues = previous.issues;
+    const currMap = new Map();
+    const prevMap = new Map();
+    for (const issue of currentIssues) {
+        currMap.set(issueSignature(issue), issue);
+    }
+    for (const issue of previousIssues) {
+        prevMap.set(issueSignature(issue), issue);
+    }
+    const newIssues = [];
+    const fixedIssues = [];
+    const persistentIssues = [];
+    const changedIssues = [];
+    // 当前报告中存在、previous 中不存在 → 新增
+    for (const [sig, issue] of currMap) {
+        if (!prevMap.has(sig)) {
+            newIssues.push({ issue, status: "new" });
+        }
+        else {
+            const prevIssue = prevMap.get(sig);
+            if (prevIssue.severity !== issue.severity) {
+                changedIssues.push({
+                    issue,
+                    status: "changed",
+                    previousSeverity: prevIssue.severity,
+                    previousIssue: prevIssue,
+                });
+            }
+            else {
+                persistentIssues.push({ issue, status: "persistent" });
+            }
+        }
+    }
+    // previous 中存在、当前不存在 → 已修复
+    for (const [sig, issue] of prevMap) {
+        if (!currMap.has(sig)) {
+            fixedIssues.push({ issue, status: "fixed" });
+        }
+    }
+    // 按 severity 排序
+    const severityOrder = { critical: 0, warning: 1, suggestion: 2 };
+    const sortBySeverity = (a, b) => severityOrder[a.issue.severity] - severityOrder[b.issue.severity];
+    newIssues.sort(sortBySeverity);
+    fixedIssues.sort(sortBySeverity);
+    persistentIssues.sort(sortBySeverity);
+    changedIssues.sort(sortBySeverity);
+    return {
+        currentReport: {
+            filename: currentFile,
+            timestamp: current.timestamp,
+            module: current.module,
+            git: current.git,
+        },
+        previousReport: {
+            filename: previousFile,
+            timestamp: previous.timestamp,
+            module: previous.module,
+            git: previous.git,
+        },
+        summary: {
+            new: newIssues.length,
+            fixed: fixedIssues.length,
+            persistent: persistentIssues.length,
+            changed: changedIssues.length,
+            totalCurrent: currentIssues.length,
+            totalPrevious: previousIssues.length,
+        },
+        newIssues,
+        fixedIssues,
+        persistentIssues,
+        changedIssues,
+    };
+}
+/**
+ * 终端友好的对比报告输出
+ */
+function formatHistoryCompare(result) {
+    const lines = [];
+    const formatDate = (ts) => new Date(ts).toLocaleString("zh-CN", { month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
+    lines.push(`📊 历史报告对比`);
+    lines.push(`   当前: ${result.currentReport.filename} (${formatDate(result.currentReport.timestamp)}) [${result.currentReport.module}]`);
+    lines.push(`   对比: ${result.previousReport.filename} (${formatDate(result.previousReport.timestamp)}) [${result.previousReport.module}]`);
+    lines.push("");
+    // 摘要
+    const { summary } = result;
+    lines.push(`📈 变化摘要`);
+    lines.push(`   当前报告: ${summary.totalCurrent} 个问题`);
+    lines.push(`   对比报告: ${summary.totalPrevious} 个问题`);
+    lines.push(`   新增: ${summary.new} | 已修复: ${summary.fixed} | 持续存在: ${summary.persistent} | 级别变化: ${summary.changed}`);
+    lines.push("");
+    // 新增问题
+    if (result.newIssues.length > 0) {
+        lines.push(`🆕 新增问题 (${result.newIssues.length})`);
+        for (const ci of result.newIssues) {
+            const sev = ci.issue.severity === "critical" ? "🔴" : ci.issue.severity === "warning" ? "🟡" : "💡";
+            lines.push(`   ${sev} [${ci.issue.ruleId}] ${ci.issue.title}`);
+            lines.push(`      📄 ${ci.issue.file}:${ci.issue.line}`);
+        }
+        lines.push("");
+    }
+    // 已修复问题
+    if (result.fixedIssues.length > 0) {
+        lines.push(`✅ 已修复问题 (${result.fixedIssues.length})`);
+        for (const ci of result.fixedIssues) {
+            const sev = ci.issue.severity === "critical" ? "🔴" : ci.issue.severity === "warning" ? "🟡" : "💡";
+            lines.push(`   ${sev} [${ci.issue.ruleId}] ${ci.issue.title}`);
+            lines.push(`      📄 ${ci.issue.file}:${ci.issue.line}`);
+        }
+        lines.push("");
+    }
+    // 级别变化
+    if (result.changedIssues.length > 0) {
+        lines.push(`🔄 严重级别变化 (${result.changedIssues.length})`);
+        for (const ci of result.changedIssues) {
+            lines.push(`   [${ci.issue.ruleId}] ${ci.issue.title}`);
+            lines.push(`      📄 ${ci.issue.file}:${ci.issue.line}`);
+            lines.push(`      ${ci.previousSeverity} → ${ci.issue.severity}`);
+        }
+        lines.push("");
+    }
+    // 持续存在
+    if (result.persistentIssues.length > 0) {
+        lines.push(`⏳ 持续存在的问题 (${result.persistentIssues.length})`);
+        const bySeverity = { critical: 0, warning: 0, suggestion: 0 };
+        for (const ci of result.persistentIssues) {
+            bySeverity[ci.issue.severity]++;
+        }
+        lines.push(`   🔴 Critical: ${bySeverity.critical} | 🟡 Warning: ${bySeverity.warning} | 💡 Suggestion: ${bySeverity.suggestion}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * JSON 格式的对比结果
+ */
+function formatHistoryCompareJson(result) {
+    return {
+        currentReport: result.currentReport,
+        previousReport: result.previousReport,
+        summary: result.summary,
+        newIssues: result.newIssues.map((ci) => ({
+            ...ci.issue,
+            status: ci.status,
+        })),
+        fixedIssues: result.fixedIssues.map((ci) => ({
+            ...ci.issue,
+            status: ci.status,
+        })),
+        changedIssues: result.changedIssues.map((ci) => ({
+            ...ci.issue,
+            status: ci.status,
+            previousSeverity: ci.previousSeverity,
+        })),
+        persistentIssues: result.persistentIssues.map((ci) => ({
+            ...ci.issue,
+            status: ci.status,
+        })),
+    };
+}
+//# sourceMappingURL=history-compare.js.map

package/dist/utils/history-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-compare.js","sourceRoot":"","sources":["../../src/utils/history-compare.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "frontend-guardian-core",
-    "version": "2.9.0",
+    "version": "3.1.0",
     "description": "Core analysis engine for frontend-guardian — AST-based scanning and auto-fixing",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",