frontend-guardian-core 2.6.0

package/dist/utils/config-loader.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * 配置文件加载工具
+ * 支持 .frontend-guardian.yml 和 .frontend-guardian.json
+ * 支持 extends 继承组织级基线配置
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const yaml_1 = __importDefault(require("yaml"));
+function loadConfig(projectDir, configFile) {
+    // 1. 尝试指定配置文件
+    let config = {};
+    let configPath;
+    if (configFile) {
+        const customPath = (0, node_path_1.resolve)(projectDir, configFile);
+        if ((0, node_fs_1.existsSync)(customPath)) {
+            config = parseConfigFile(customPath);
+            configPath = customPath;
+        }
+    }
+    // 2. 尝试默认配置文件
+    if (!configPath) {
+        const ymlPath = (0, node_path_1.resolve)(projectDir, ".frontend-guardian.yml");
+        const jsonPath = (0, node_path_1.resolve)(projectDir, ".frontend-guardian.json");
+        if ((0, node_fs_1.existsSync)(ymlPath)) {
+            config = parseConfigFile(ymlPath);
+            configPath = ymlPath;
+        }
+        else if ((0, node_fs_1.existsSync)(jsonPath)) {
+            config = parseConfigFile(jsonPath);
+            configPath = jsonPath;
+        }
+    }
+    // 3. 处理 extends 继承
+    if (config.extends) {
+        const baseDir = configPath ? (0, node_path_1.dirname)(configPath) : projectDir;
+        config = resolveExtends(config, baseDir);
+    }
+    return config;
+}
+function parseConfigFile(filePath) {
+    const content = (0, node_fs_1.readFileSync)(filePath, "utf-8");
+    if (filePath.endsWith(".json")) {
+        return JSON.parse(content);
+    }
+    if (filePath.endsWith(".yml") || filePath.endsWith(".yaml")) {
+        return yaml_1.default.parse(content);
+    }
+    return {};
+}
+/**
+ * 解析 extends 继承链
+ * @param config 当前配置
+ * @param baseDir 配置文件所在目录（用于解析相对路径）
+ * @returns 合并后的配置
+ */
+function resolveExtends(config, baseDir) {
+    if (!config.extends)
+        return config;
+    const extendsPath = (0, node_path_1.resolve)(baseDir, config.extends);
+    if (!(0, node_fs_1.existsSync)(extendsPath)) {
+        console.warn(`[frontend-guardian] extends 配置未找到: ${extendsPath}`);
+        return config;
+    }
+    const baseConfig = parseConfigFile(extendsPath);
+    // 递归处理继承链
+    if (baseConfig.extends) {
+        const parentDir = (0, node_path_1.dirname)(extendsPath);
+        const resolvedBase = resolveExtends(baseConfig, parentDir);
+        return mergeConfig(resolvedBase, config);
+    }
+    return mergeConfig(baseConfig, config);
+}
+/**
+ * 合并配置：base 为基础，override 覆盖
+ * - 简单字段：override 优先
+ * - rules 数组：按 id 去重合并，override 覆盖同名规则
+ * - customRules 数组：合并去重
+ */
+function mergeConfig(base, override) {
+    const merged = { ...base, ...override };
+    // 合并 rules（按 id 去重，override 优先）
+    const baseRules = base.rules ?? [];
+    const overrideRules = override.rules ?? [];
+    if (baseRules.length > 0 || overrideRules.length > 0) {
+        const ruleMap = new Map();
+        for (const r of baseRules) {
+            ruleMap.set(r.id, r);
+        }
+        for (const r of overrideRules) {
+            const existing = ruleMap.get(r.id);
+            if (existing) {
+                ruleMap.set(r.id, { ...existing, ...r });
+            }
+            else {
+                ruleMap.set(r.id, r);
+            }
+        }
+        merged.rules = Array.from(ruleMap.values());
+    }
+    // 合并 customRules（按 path 去重）
+    const baseCustom = base.customRules ?? [];
+    const overrideCustom = override.customRules ?? [];
+    if (baseCustom.length > 0 || overrideCustom.length > 0) {
+        const pathSet = new Set(baseCustom.map((c) => c.path));
+        merged.customRules = [
+            ...baseCustom,
+            ...overrideCustom.filter((c) => !pathSet.has(c.path)),
+        ];
+    }
+    // 合并嵌套配置对象（浅合并）
+    mergeNested(merged, base, override, "i18n");
+    mergeNested(merged, base, override, "component");
+    mergeNested(merged, base, override, "hooks");
+    mergeNested(merged, base, override, "platform");
+    mergeNested(merged, base, override, "gate");
+    mergeNested(merged, base, override, "aiContext");
+    mergeNested(merged, base, override, "naming");
+    // 合并 scan 配置（对象浅合并）
+    if (base.scan || override.scan) {
+        merged.scan = {
+            ...base.scan,
+            ...override.scan,
+            includeExtensions: (override.scan?.includeExtensions ?? base.scan?.includeExtensions),
+            excludeDirs: (override.scan?.excludeDirs ?? base.scan?.excludeDirs),
+            excludePatterns: (override.scan?.excludePatterns ?? base.scan?.excludePatterns),
+        };
+    }
+    return merged;
+}
+/**
+ * 合并嵌套对象配置：base 为基础，override 覆盖
+ */
+function mergeNested(merged, base, override, key) {
+    const baseVal = base[key];
+    const overrideVal = override[key];
+    if (baseVal && typeof baseVal === "object" && !Array.isArray(baseVal)) {
+        if (overrideVal && typeof overrideVal === "object" && !Array.isArray(overrideVal)) {
+            merged[key] = { ...baseVal, ...overrideVal };
+        }
+        else if (overrideVal) {
+            merged[key] = overrideVal;
+        }
+    }
+    else if (overrideVal) {
+        merged[key] = overrideVal;
+    }
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/utils/config-loader.js.map

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

package/dist/utils/fix-bot.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Fix Bot — 自动修复并提交 PR/MR
+ * 类似 Dependabot，扫描后自动提交修复 PR
+ *
+ * Usage: fg-core . --fix --fix-bot
+ */
+export interface FixBotConfig {
+    /** 平台: github | gitlab */
+    provider: "github" | "gitlab";
+    /** API Token */
+    token: string;
+    /** 目标分支（默认自动检测 main/master） */
+    baseBranch?: string;
+    /** 修复分支前缀（默认 fg-auto-fix） */
+    branchPrefix?: string;
+    /** PR 标题 */
+    prTitle?: string;
+    /** PR 描述 */
+    prBody?: string;
+}
+export interface FixBotResult {
+    success: boolean;
+    branch?: string;
+    prUrl?: string;
+    prNumber?: number;
+    error?: string;
+}
+/**
+ * 检测 Fix Bot 配置（从环境变量）
+ */
+export declare function detectFixBotConfig(): FixBotConfig | null;
+/**
+ * 自动修复 Bot：创建分支、提交修复、创建 PR
+ */
+export declare function runFixBot(projectDir: string, filesModified: string[], config: FixBotConfig): Promise<FixBotResult>;
+//# sourceMappingURL=fix-bot.d.ts.map

package/dist/utils/fix-bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-bot.d.ts","sourceRoot":"","sources":["../../src/utils/fix-bot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,YAAY;IACzB,0BAA0B;IAC1B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC9B,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,GAAG,IAAI,CAexD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC3B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,YAAY,CAAC,CAmIvB"}

package/dist/utils/fix-bot.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * Fix Bot — 自动修复并提交 PR/MR
+ * 类似 Dependabot，扫描后自动提交修复 PR
+ *
+ * Usage: fg-core . --fix --fix-bot
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFixBotConfig = detectFixBotConfig;
+exports.runFixBot = runFixBot;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
+/**
+ * 检测 Fix Bot 配置（从环境变量）
+ */
+function detectFixBotConfig() {
+    const provider = process.env.FG_FIX_BOT_PROVIDER;
+    const token = process.env.FG_FIX_BOT_TOKEN;
+    if (!provider || !token)
+        return null;
+    if (provider !== "github" && provider !== "gitlab")
+        return null;
+    return {
+        provider,
+        token,
+        baseBranch: process.env.FG_FIX_BOT_BASE_BRANCH,
+        branchPrefix: process.env.FG_FIX_BOT_BRANCH_PREFIX || "fg-auto-fix",
+        prTitle: process.env.FG_FIX_BOT_PR_TITLE,
+        prBody: process.env.FG_FIX_BOT_PR_BODY,
+    };
+}
+/**
+ * 自动修复 Bot：创建分支、提交修复、创建 PR
+ */
+async function runFixBot(projectDir, filesModified, config) {
+    if (filesModified.length === 0) {
+        return { success: false, error: "没有文件需要修复" };
+    }
+    // 检测是否在 git 仓库中
+    let gitRoot;
+    try {
+        gitRoot = (0, node_child_process_1.execSync)("git rev-parse --show-toplevel", {
+            cwd: projectDir,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return { success: false, error: "未找到 Git 仓库" };
+    }
+    // 检测当前分支
+    let currentBranch;
+    try {
+        currentBranch = (0, node_child_process_1.execSync)("git rev-parse --abbrev-ref HEAD", {
+            cwd: gitRoot,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+    }
+    catch {
+        return { success: false, error: "无法检测当前分支" };
+    }
+    // 检测目标分支
+    const baseBranch = config.baseBranch || detectDefaultBranch(gitRoot);
+    // 检查是否有未提交的更改
+    try {
+        const status = (0, node_child_process_1.execSync)("git status --porcelain", {
+            cwd: gitRoot,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+        if (status) {
+            return { success: false, error: "工作区有未提交的更改，请先提交或暂存" };
+        }
+    }
+    catch {
+        // ignore
+    }
+    // 创建修复分支
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    const branchName = `${config.branchPrefix || "fg-auto-fix"}/${timestamp}`;
+    try {
+        (0, node_child_process_1.execSync)(`git checkout -b ${branchName}`, { cwd: gitRoot, stdio: "pipe" });
+    }
+    catch (err) {
+        return { success: false, error: `创建分支失败: ${err.message || err}` };
+    }
+    // 添加修改的文件
+    try {
+        for (const file of filesModified) {
+            const relPath = (0, node_path_1.resolve)(gitRoot, file).replace(gitRoot + "/", "");
+            (0, node_child_process_1.execSync)(`git add "${relPath}"`, { cwd: gitRoot, stdio: "pipe" });
+        }
+    }
+    catch (err) {
+        // 回滚分支
+        try {
+            (0, node_child_process_1.execSync)(`git checkout ${currentBranch}`, { cwd: gitRoot, stdio: "pipe" });
+            (0, node_child_process_1.execSync)(`git branch -D ${branchName}`, { cwd: gitRoot, stdio: "pipe" });
+        }
+        catch {
+            // ignore rollback error
+        }
+        return { success: false, error: `添加文件失败: ${err.message || err}` };
+    }
+    // 提交修复
+    try {
+        (0, node_child_process_1.execSync)('git commit -m "chore: auto-fix by frontend-guardian"', {
+            cwd: gitRoot,
+            stdio: "pipe",
+        });
+    }
+    catch (err) {
+        // 回滚分支
+        try {
+            (0, node_child_process_1.execSync)(`git reset --hard HEAD`, { cwd: gitRoot, stdio: "pipe" });
+            (0, node_child_process_1.execSync)(`git checkout ${currentBranch}`, { cwd: gitRoot, stdio: "pipe" });
+            (0, node_child_process_1.execSync)(`git branch -D ${branchName}`, { cwd: gitRoot, stdio: "pipe" });
+        }
+        catch {
+            // ignore rollback error
+        }
+        return { success: false, error: `提交失败: ${err.message || err}` };
+    }
+    // 推送分支
+    try {
+        (0, node_child_process_1.execSync)(`git push -u origin ${branchName}`, { cwd: gitRoot, stdio: "pipe" });
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `推送失败: ${err.message || err}`,
+            branch: branchName,
+        };
+    }
+    // 创建 PR
+    let prUrl;
+    let prNumber;
+    try {
+        const prResult = await createPR(gitRoot, branchName, baseBranch, config);
+        prUrl = prResult.url;
+        prNumber = prResult.number;
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `创建 PR 失败: ${err.message || err}`,
+            branch: branchName,
+        };
+    }
+    // 切回原分支
+    try {
+        (0, node_child_process_1.execSync)(`git checkout ${currentBranch}`, { cwd: gitRoot, stdio: "pipe" });
+    }
+    catch {
+        // ignore
+    }
+    return {
+        success: true,
+        branch: branchName,
+        prUrl,
+        prNumber,
+    };
+}
+/**
+ * 检测默认分支（main 或 master）
+ */
+function detectDefaultBranch(gitRoot) {
+    try {
+        const branches = (0, node_child_process_1.execSync)("git branch -rl '*/HEAD'", {
+            cwd: gitRoot,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+        if (branches.includes("main"))
+            return "main";
+    }
+    catch {
+        // ignore
+    }
+    try {
+        (0, node_child_process_1.execSync)("git show-ref --verify --quiet refs/heads/main", {
+            cwd: gitRoot,
+            stdio: "pipe",
+        });
+        return "main";
+    }
+    catch {
+        return "master";
+    }
+}
+/**
+ * 创建 PR / MR
+ */
+async function createPR(gitRoot, headBranch, baseBranch, config) {
+    const title = config.prTitle || `chore: auto-fix by frontend-guardian (${new Date().toLocaleDateString("zh-CN")})`;
+    const body = config.prBody ||
+        `🤖 此 PR 由 frontend-guardian 自动修复 Bot 生成。\n\n修复了代码质量问题，建议 review 后合并。`;
+    // 获取远程 URL
+    let remoteUrl;
+    try {
+        remoteUrl = (0, node_child_process_1.execSync)("git remote get-url origin", {
+            cwd: gitRoot,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+    }
+    catch {
+        throw new Error("无法获取远程仓库 URL");
+    }
+    if (config.provider === "github") {
+        return createGitHubPR(remoteUrl, headBranch, baseBranch, title, body, config.token);
+    }
+    else {
+        return createGitLabMR(remoteUrl, headBranch, baseBranch, title, body, config.token);
+    }
+}
+/**
+ * 通过 GitHub API 创建 PR
+ */
+async function createGitHubPR(remoteUrl, head, base, title, body, token) {
+    // 解析 owner/repo
+    const match = remoteUrl.match(/github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (!match) {
+        throw new Error(`无法解析 GitHub 仓库: ${remoteUrl}`);
+    }
+    const [, owner, repo] = match;
+    const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls`, {
+        method: "POST",
+        headers: {
+            Authorization: `token ${token}`,
+            Accept: "application/vnd.github.v3+json",
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ title, body, head, base }),
+    });
+    if (!response.ok) {
+        const err = await response.text();
+        throw new Error(`GitHub API ${response.status}: ${err}`);
+    }
+    const data = (await response.json());
+    return { url: data.html_url, number: data.number };
+}
+/**
+ * 通过 GitLab API 创建 MR
+ */
+async function createGitLabMR(remoteUrl, sourceBranch, targetBranch, title, description, token) {
+    // 解析 project path
+    const match = remoteUrl.match(/gitlab\.com[:/](.+?)(?:\.git)?$/);
+    if (!match) {
+        throw new Error(`无法解析 GitLab 仓库: ${remoteUrl}`);
+    }
+    const projectPath = encodeURIComponent(match[1]);
+    const response = await fetch(`https://gitlab.com/api/v4/projects/${projectPath}/merge_requests`, {
+        method: "POST",
+        headers: {
+            "PRIVATE-TOKEN": token,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            source_branch: sourceBranch,
+            target_branch: targetBranch,
+            title,
+            description,
+        }),
+    });
+    if (!response.ok) {
+        const err = await response.text();
+        throw new Error(`GitLab API ${response.status}: ${err}`);
+    }
+    const data = (await response.json());
+    return { url: data.web_url, number: data.iid };
+}
+//# sourceMappingURL=fix-bot.js.map

package/dist/utils/fix-bot.js.map

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

package/dist/utils/git-hooks.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Git Hook 自动安装工具
+ * 一键配置 pre-commit / pre-push hook，在提交前自动运行增量扫描
+ */
+export interface HookConfig {
+    /** 要安装的 hook 类型 */
+    type: "pre-commit" | "pre-push" | "commit-msg" | "both" | "all";
+    /** 扫描命令参数 */
+    scanArgs?: string;
+    /** 是否自动修复 */
+    autoFix?: boolean;
+    /** 是否启用缓存 */
+    cache?: boolean;
+    /** 最低 severity 级别 */
+    minSeverity?: string;
+    /** commit-msg 自定义正则（默认 Conventional Commits） */
+    commitMsgPattern?: string;
+    /** 是否允许空提交消息 */
+    allowEmpty?: boolean;
+}
+/**
+ * 检测项目是否使用 husky
+ * @param projectDir 项目根目录
+ * @returns husky 配置信息
+ */
+export declare function detectHusky(projectDir: string): {
+    useHusky: boolean;
+    huskyDir: string | null;
+    version: "v8+" | "legacy" | null;
+};
+/**
+ * 安装 Git Hook
+ * @param projectDir 项目根目录
+ * @param config Hook 配置
+ * @returns 安装结果
+ */
+export declare function installGitHooks(projectDir: string, config: HookConfig): {
+    installed: string[];
+    skipped: string[];
+};
+/**
+ * 卸载 Git Hook
+ * @param projectDir 项目根目录
+ * @param type 要卸载的 hook 类型
+ * @returns 卸载结果
+ */
+export declare function uninstallGitHooks(projectDir: string, type: "pre-commit" | "pre-push" | "commit-msg" | "both" | "all"): {
+    removed: string[];
+    notFound: string[];
+};
+/**
+ * 检查是否已安装 fg hook
+ */
+export declare function hasGitHook(projectDir: string, type: "pre-commit" | "pre-push" | "commit-msg"): boolean;
+//# sourceMappingURL=git-hooks.d.ts.map

package/dist/utils/git-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hooks.d.ts","sourceRoot":"","sources":["../../src/utils/git-hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,UAAU;IACvB,mBAAmB;IACnB,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;IAChE,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAsFD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAA;CAAE,CAahI;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgFlH;AAgDD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA8ChK;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAwBtG"}