frontend-guardian-core 2.8.0 → 3.0.0

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/monorepo.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Monorepo 工作区检测与解析
+ *
+ * v2.9.0 功能：
+ * 1. 自动检测 monorepo 工具（pnpm / lerna / nx / yarn / npm workspaces）
+ * 2. 解析 workspace 配置，获取所有子包路径
+ * 3. 读取子包 package.json 元数据
+ */
+/** 支持的 monorepo 工具 */
+export type MonorepoTool = "pnpm-workspace" | "lerna" | "nx" | "yarn-workspaces" | "npm-workspaces" | "rush" | "none";
+/** Workspace 子包信息 */
+export interface WorkspacePackage {
+    /** 子包名称 */
+    name: string;
+    /** 子包目录（相对项目根目录） */
+    path: string;
+    /** 子包绝对路径 */
+    absolutePath: string;
+    /** package.json 中的版本 */
+    version?: string;
+    /** 依赖列表 */
+    dependencies?: string[];
+    /** devDependencies 列表 */
+    devDependencies?: string[];
+    /** peerDependencies 列表 */
+    peerDependencies?: string[];
+    /** 是否是 private 包 */
+    private?: boolean;
+}
+/** Monorepo 检测结果 */
+export interface MonorepoInfo {
+    /** 是否是 monorepo */
+    isMonorepo: boolean;
+    /** 检测到的工具 */
+    tool: MonorepoTool;
+    /** 工具配置文件路径 */
+    configPath?: string;
+    /** 项目根目录 */
+    rootDir: string;
+    /** 所有子包 */
+    packages: WorkspacePackage[];
+    /** workspace 中包含的 glob 模式 */
+    patterns?: string[];
+}
+/** 检测项目是否为 monorepo */
+export declare function detectMonorepo(projectDir: string): MonorepoInfo;
+/** 检测跨包依赖问题 */
+export interface CrossPackageIssue {
+    type: "circular-dependency" | "missing-dependency" | "unused-dependency" | "version-mismatch";
+    package: string;
+    relatedPackage?: string;
+    message: string;
+    severity: "critical" | "warning" | "suggestion";
+}
+/** 分析跨包依赖 */
+export declare function analyzeCrossPackageDeps(packages: WorkspacePackage[]): CrossPackageIssue[];
+//# sourceMappingURL=monorepo.d.ts.map

package/dist/utils/monorepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo.d.ts","sourceRoot":"","sources":["../../src/utils/monorepo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,sBAAsB;AACtB,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,OAAO,GAAG,IAAI,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtH,qBAAqB;AACrB,MAAM,WAAW,gBAAgB;IAC7B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yBAAyB;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,oBAAoB;AACpB,MAAM,WAAW,YAAY;IACzB,mBAAmB;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAqC/D;AA0MD,eAAe;AACf,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;CACnD;AAED,aAAa;AACb,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,EAAE,CAsEzF"}

package/dist/utils/monorepo.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * Monorepo 工作区检测与解析
+ *
+ * v2.9.0 功能：
+ * 1. 自动检测 monorepo 工具（pnpm / lerna / nx / yarn / npm workspaces）
+ * 2. 解析 workspace 配置，获取所有子包路径
+ * 3. 读取子包 package.json 元数据
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectMonorepo = detectMonorepo;
+exports.analyzeCrossPackageDeps = analyzeCrossPackageDeps;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const globby_1 = require("globby");
+/** 检测项目是否为 monorepo */
+function detectMonorepo(projectDir) {
+    // 按优先级检测各种工具
+    const pnpmWorkspace = (0, node_path_1.resolve)(projectDir, "pnpm-workspace.yaml");
+    if ((0, node_fs_1.existsSync)(pnpmWorkspace)) {
+        return parsePnpmWorkspace(projectDir, pnpmWorkspace);
+    }
+    const lernaJson = (0, node_path_1.resolve)(projectDir, "lerna.json");
+    if ((0, node_fs_1.existsSync)(lernaJson)) {
+        return parseLernaWorkspace(projectDir, lernaJson);
+    }
+    const nxJson = (0, node_path_1.resolve)(projectDir, "nx.json");
+    if ((0, node_fs_1.existsSync)(nxJson)) {
+        return parseNxWorkspace(projectDir, nxJson);
+    }
+    const rushJson = (0, node_path_1.resolve)(projectDir, "rush.json");
+    if ((0, node_fs_1.existsSync)(rushJson)) {
+        return parseRushWorkspace(projectDir, rushJson);
+    }
+    const packageJsonPath = (0, node_path_1.resolve)(projectDir, "package.json");
+    if ((0, node_fs_1.existsSync)(packageJsonPath)) {
+        const pkg = readPackageJson(packageJsonPath);
+        // npm / yarn workspaces
+        if (pkg.workspaces) {
+            return parseNpmWorkspaces(projectDir, pkg);
+        }
+    }
+    return {
+        isMonorepo: false,
+        tool: "none",
+        rootDir: projectDir,
+        packages: [],
+    };
+}
+/** 解析 pnpm-workspace.yaml */
+function parsePnpmWorkspace(rootDir, configPath) {
+    const content = (0, node_fs_1.readFileSync)(configPath, "utf-8");
+    const patterns = [];
+    // 简单 YAML 解析：提取 packages 字段
+    const packagesMatch = content.match(/packages:\s*\n((?:\s*-\s*[^\n]+\n?)*)/);
+    if (packagesMatch) {
+        const lines = packagesMatch[1].split("\n");
+        for (const line of lines) {
+            const match = line.match(/^\s*-\s*(.+)$/);
+            if (match) {
+                patterns.push(match[1].trim());
+            }
+        }
+    }
+    // 也支持单行格式 packages: ['apps/*', 'packages/*']
+    const inlineMatch = content.match(/packages:\s*\[([^\]]+)\]/);
+    if (inlineMatch) {
+        const items = inlineMatch[1].split(",").map((s) => s.trim().replace(/['"]/g, ""));
+        patterns.push(...items);
+    }
+    const packages = resolveWorkspacePackages(rootDir, patterns);
+    return {
+        isMonorepo: true,
+        tool: "pnpm-workspace",
+        configPath,
+        rootDir,
+        packages,
+        patterns,
+    };
+}
+/** 解析 lerna.json */
+function parseLernaWorkspace(rootDir, configPath) {
+    try {
+        const config = JSON.parse((0, node_fs_1.readFileSync)(configPath, "utf-8"));
+        const patterns = config.packages || ["packages/*"];
+        const packages = resolveWorkspacePackages(rootDir, patterns);
+        return {
+            isMonorepo: true,
+            tool: "lerna",
+            configPath,
+            rootDir,
+            packages,
+            patterns,
+        };
+    }
+    catch {
+        return { isMonorepo: false, tool: "none", rootDir, packages: [] };
+    }
+}
+/** 解析 nx.json */
+function parseNxWorkspace(rootDir, configPath) {
+    try {
+        // nx 使用 workspace.json 或 angular.json 定义项目
+        const workspaceJsonPath = (0, node_path_1.resolve)(rootDir, "workspace.json");
+        const angularJsonPath = (0, node_path_1.resolve)(rootDir, "angular.json");
+        let projects = {};
+        if ((0, node_fs_1.existsSync)(workspaceJsonPath)) {
+            const ws = JSON.parse((0, node_fs_1.readFileSync)(workspaceJsonPath, "utf-8"));
+            projects = ws.projects || {};
+        }
+        else if ((0, node_fs_1.existsSync)(angularJsonPath)) {
+            const ng = JSON.parse((0, node_fs_1.readFileSync)(angularJsonPath, "utf-8"));
+            projects = ng.projects || {};
+        }
+        const packages = [];
+        for (const [name, projectPath] of Object.entries(projects)) {
+            const absPath = (0, node_path_1.resolve)(rootDir, projectPath);
+            const pkgJsonPath = (0, node_path_1.resolve)(absPath, "package.json");
+            if ((0, node_fs_1.existsSync)(pkgJsonPath)) {
+                const pkg = readPackageJson(pkgJsonPath);
+                packages.push(createWorkspacePackage(pkg, projectPath, absPath));
+            }
+            else {
+                packages.push({
+                    name,
+                    path: projectPath,
+                    absolutePath: absPath,
+                });
+            }
+        }
+        return {
+            isMonorepo: true,
+            tool: "nx",
+            configPath,
+            rootDir,
+            packages,
+        };
+    }
+    catch {
+        return { isMonorepo: false, tool: "none", rootDir, packages: [] };
+    }
+}
+/** 解析 rush.json */
+function parseRushWorkspace(rootDir, configPath) {
+    try {
+        const config = JSON.parse((0, node_fs_1.readFileSync)(configPath, "utf-8"));
+        const projects = config.projects || [];
+        const patterns = projects.map((p) => p.projectFolder);
+        const packages = resolveWorkspacePackages(rootDir, patterns);
+        return {
+            isMonorepo: true,
+            tool: "rush",
+            configPath,
+            rootDir,
+            packages,
+            patterns,
+        };
+    }
+    catch {
+        return { isMonorepo: false, tool: "none", rootDir, packages: [] };
+    }
+}
+/** 解析 npm / yarn workspaces */
+function parseNpmWorkspaces(rootDir, pkg) {
+    const workspaces = pkg.workspaces;
+    let patterns = [];
+    if (Array.isArray(workspaces)) {
+        patterns = workspaces;
+    }
+    else if (typeof workspaces === "object" && workspaces !== null) {
+        patterns = workspaces.packages || [];
+    }
+    const packages = resolveWorkspacePackages(rootDir, patterns);
+    const tool = pkg.packageManager?.toString().startsWith("pnpm") ? "pnpm-workspace" : "yarn-workspaces";
+    return {
+        isMonorepo: true,
+        tool: packages.length > 0 ? tool : "npm-workspaces",
+        rootDir,
+        packages,
+        patterns,
+    };
+}
+/** 根据 glob 模式解析 workspace 包 */
+function resolveWorkspacePackages(rootDir, patterns) {
+    const packages = [];
+    const seen = new Set();
+    for (const pattern of patterns) {
+        // 将 glob 模式转换为实际路径
+        const globPattern = pattern.endsWith("/") ? `${pattern}package.json` : `${pattern}/package.json`;
+        try {
+            const pkgPaths = (0, globby_1.globbySync)(globPattern, { cwd: rootDir, onlyFiles: true });
+            for (const pkgPath of pkgPaths) {
+                const absPath = (0, node_path_1.resolve)(rootDir, (0, node_path_1.dirname)(pkgPath));
+                const relPath = (0, node_path_1.dirname)(pkgPath);
+                if (seen.has(absPath))
+                    continue;
+                seen.add(absPath);
+                const pkg = readPackageJson((0, node_path_1.resolve)(rootDir, pkgPath));
+                packages.push(createWorkspacePackage(pkg, relPath, absPath));
+            }
+        }
+        catch {
+            // 忽略解析失败的包
+        }
+    }
+    return packages;
+}
+/** 读取 package.json */
+function readPackageJson(path) {
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(path, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/** 创建 WorkspacePackage */
+function createWorkspacePackage(pkg, relPath, absPath) {
+    const deps = pkg.dependencies ? Object.keys(pkg.dependencies) : [];
+    const devDeps = pkg.devDependencies ? Object.keys(pkg.devDependencies) : [];
+    const peerDeps = pkg.peerDependencies ? Object.keys(pkg.peerDependencies) : [];
+    return {
+        name: pkg.name || relPath,
+        path: relPath,
+        absolutePath: absPath,
+        version: pkg.version,
+        dependencies: deps,
+        devDependencies: devDeps,
+        peerDependencies: peerDeps,
+        private: pkg.private,
+    };
+}
+/** 分析跨包依赖 */
+function analyzeCrossPackageDeps(packages) {
+    const issues = [];
+    const pkgMap = new Map(packages.map((p) => [p.name, p]));
+    const pkgNames = new Set(packages.map((p) => p.name));
+    for (const pkg of packages) {
+        const allDeps = new Set([...(pkg.dependencies || []), ...(pkg.devDependencies || []), ...(pkg.peerDependencies || [])]);
+        for (const dep of allDeps) {
+            // 检测缺失的内部依赖
+            if (dep.startsWith("@") || dep.includes("/")) {
+                const scopeName = dep.split("/")[0];
+                // 如果依赖的是 workspace 内的包但名称不匹配
+                if (!pkgNames.has(dep) && pkgNames.has(scopeName)) {
+                    issues.push({
+                        type: "missing-dependency",
+                        package: pkg.name,
+                        relatedPackage: dep,
+                        message: `包 "${pkg.name}" 依赖 "${dep}"，但该包不在 workspace 中`,
+                        severity: "warning",
+                    });
+                }
+            }
+        }
+    }
+    // 检测循环依赖
+    const visited = new Set();
+    const pathStack = [];
+    function findCycle(pkgName) {
+        if (pathStack.includes(pkgName)) {
+            const cycleStart = pathStack.indexOf(pkgName);
+            return pathStack.slice(cycleStart);
+        }
+        if (visited.has(pkgName))
+            return null;
+        visited.add(pkgName);
+        pathStack.push(pkgName);
+        const pkg = pkgMap.get(pkgName);
+        if (pkg) {
+            const allDeps = new Set([...(pkg.dependencies || []), ...(pkg.devDependencies || [])]);
+            for (const dep of allDeps) {
+                if (pkgNames.has(dep)) {
+                    const cycle = findCycle(dep);
+                    if (cycle)
+                        return cycle;
+                }
+            }
+        }
+        pathStack.pop();
+        return null;
+    }
+    for (const pkg of packages) {
+        if (!visited.has(pkg.name)) {
+            const cycle = findCycle(pkg.name);
+            if (cycle && cycle.length > 1) {
+                issues.push({
+                    type: "circular-dependency",
+                    package: cycle[0],
+                    message: `循环依赖 detected: ${cycle.join(" → ")} → ${cycle[0]}`,
+                    severity: "critical",
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=monorepo.js.map