frontend-guardian-core 3.6.0 → 3.7.0

package/bin/fg-core.js

@@ -62,6 +62,11 @@ import {
     saveComplianceReport,
     uploadToDashboardServer,
     detectDashboardConfig,
+    playwrightIntegration,
+    ProjectIndexer,
+    FileWatcher,
+    parseAllRoutes,
+    findRouteFiles,
 } from "../dist/index.js";
 import pc from "picocolors";
 import { runWatchMode } from "./watch-mode.js";
@@ -96,7 +101,7 @@ const MODULE_RULES = {
 
 function showHelp() {
     console.log(`
-Frontend Guardian Core v3.6.0
+Frontend Guardian Core v3.7.0
 
 Usage:
   fg-core <project-dir> [options]
@@ -155,6 +160,10 @@ Options:
   --server <url>       扫描后上报到治理看板服务器
   --serve              扫描前启动本地看板服务（扫描完成后停止）
   --e2e-detect-gaps    检测 E2E 测试覆盖缺口（页面 + 接口）
+  --e2e-run            运行 Playwright E2E 测试并输出治理报告
+  --build-index        建立项目索引（预索引文件结构、符号、路由）
+  --watch-index        监听文件变更并自动同步索引
+  --index-status       查看项目索引状态
   --help, -h           显示帮助
 
 Examples:
@@ -230,6 +239,10 @@ async function main() {
         server: undefined,
         serve: false,
         e2eDetectGaps: false,
+        e2eRun: false,
+        buildIndex: false,
+        watchIndex: false,
+        indexStatus: false,
     };
 
     for (let i = 0; i < args.length; i++) {
@@ -400,6 +413,18 @@ async function main() {
             case "--e2e-detect-gaps":
                 options.e2eDetectGaps = true;
                 break;
+            case "--e2e-run":
+                options.e2eRun = true;
+                break;
+            case "--build-index":
+                options.buildIndex = true;
+                break;
+            case "--watch-index":
+                options.watchIndex = true;
+                break;
+            case "--index-status":
+                options.indexStatus = true;
+                break;
             case "--help":
             case "-h":
                 showHelp();
@@ -418,6 +443,151 @@ async function main() {
         process.exit(gapResult.uncoveredPages.length + gapResult.uncoveredApis.length > 0 ? 1 : 0);
     }
 
+    // v3.6.1: 运行 Playwright E2E 测试
+    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"));
+            process.exit(1);
+        }
+
+        console.log(pc.cyan("🎭 正在运行 Playwright E2E 测试..."));
+        console.log(pc.gray("   这可能需要几分钟（取决于测试数量和浏览器启动时间）"));
+        console.log("");
+
+        const start = Date.now();
+        const issues = playwrightIntegration.run(options.projectDir);
+        const duration = Date.now() - start;
+
+        if (options.json) {
+            console.log(JSON.stringify({
+                tool: "Playwright",
+                total: issues.length,
+                duration,
+                issues,
+            }, null, 2));
+        } else {
+            console.log(pc.cyan(`📊 Playwright 测试结果`));
+            console.log(pc.gray(`   耗时: ${duration}ms`));
+            if (issues.length === 0) {
+                console.log(pc.green(`   ✅ 所有测试通过`));
+            } else {
+                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}`));
+                    console.log(pc.gray(`         ${issue.file}:${issue.line}`));
+                    if (issue.description) {
+                        const descLines = issue.description.split("\n").slice(0, 3);
+                        for (const dl of descLines) {
+                            console.log(pc.gray(`         ${dl}`));
+                        }
+                    }
+                }
+            }
+        }
+
+        process.exit(issues.length > 0 ? 1 : 0);
+    }
+
+    // v3.7.0: 索引状态查看
+    if (options.indexStatus) {
+        const indexer = new ProjectIndexer(options.projectDir);
+        const stats = indexer.getStats();
+        const valid = indexer.isValid();
+
+        console.log(pc.cyan("📦 项目索引状态"));
+        console.log(pc.gray(`   索引有效: ${valid ? pc.green("是") : pc.yellow("否（请运行 --build-index）")}`));
+        console.log(pc.gray(`   索引文件数: ${stats.files}`));
+        console.log(pc.gray(`   路由数: ${stats.routes}`));
+        console.log(pc.gray(`   符号数: ${stats.symbols}`));
+
+        if (valid && stats.routes > 0) {
+            const routes = indexer.getRoutes();
+            console.log(pc.cyan("\n🗺️  检测到的路由:"));
+            for (const route of routes.slice(0, 20)) {
+                console.log(pc.gray(`   ${route.path} → ${route.file} (${route.framework})`));
+            }
+            if (routes.length > 20) {
+                console.log(pc.gray(`   ... 还有 ${routes.length - 20} 条路由`));
+            }
+        }
+
+        process.exit(0);
+    }
+
+    // v3.7.0: 建立项目索引
+    if (options.buildIndex) {
+        console.log(pc.cyan("📦 正在建立项目索引..."));
+        const indexer = new ProjectIndexer(options.projectDir);
+
+        const { globbySync } = require("globby");
+        const patterns = ["**/*.{js,ts,jsx,tsx,vue}"];
+        const exclude = [
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/build/**",
+            "**/.git/**",
+            "**/coverage/**",
+        ];
+        const files = globbySync(patterns, {
+            cwd: options.projectDir,
+            ignore: exclude,
+            absolute: true,
+        });
+
+        console.log(pc.gray(`   发现 ${files.length} 个源文件`));
+        await indexer.buildIndex(files);
+
+        const stats = indexer.getStats();
+        console.log(pc.green(`   ✅ 索引建立完成`));
+        console.log(pc.gray(`   文件: ${stats.files} | 路由: ${stats.routes} | 符号: ${stats.symbols}`));
+
+        process.exit(0);
+    }
+
+    // v3.7.0: 监听文件变更并自动同步索引
+    if (options.watchIndex) {
+        console.log(pc.cyan("👁️  启动文件监听（索引自动同步）..."));
+        console.log(pc.gray("   按 Ctrl+C 停止"));
+
+        const watcher = new FileWatcher({
+            projectDir: options.projectDir,
+            onChange: (changed, deleted) => {
+                if (changed.length > 0) {
+                    console.log(pc.cyan(`\n📝 变更: ${changed.map((f) => relative(options.projectDir, f)).join(", ")}`));
+                }
+                if (deleted.length > 0) {
+                    console.log(pc.yellow(`\n🗑️  删除: ${deleted.map((f) => relative(options.projectDir, f)).join(", ")}`));
+                }
+            },
+            onIndexUpdate: (stats) => {
+                console.log(pc.gray(`   索引已更新 | 文件: ${stats.files} | 路由: ${stats.routes} | 符号: ${stats.symbols}`));
+            },
+            onError: (err) => {
+                console.error(pc.red(`   监听错误: ${err.message}`));
+            },
+        });
+
+        await watcher.start();
+
+        // 保持进程运行
+        process.on("SIGINT", () => {
+            console.log(pc.gray("\n\n👋 停止监听..."));
+            watcher.stop();
+            process.exit(0);
+        });
+
+        process.on("SIGTERM", () => {
+            watcher.stop();
+            process.exit(0);
+        });
+
+        // 阻塞主线程
+        await new Promise(() => {});
+    }
+
     // Phase 6: 特殊命令处理
     if (options.installHooks) {
         const hookType = ["pre-commit", "pre-push", "commit-msg", "both", "all"].includes(options.installHooksType)

package/bin/fg-lsp.js

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

package/bin/fg-server.js

@@ -9,7 +9,7 @@ import pc from "picocolors";
 
 function showHelp() {
     console.log(`
-Frontend Guardian Dashboard Server v3.6.0
+Frontend Guardian Dashboard Server v3.7.0
 
 Usage:
   fg-server [options]

package/dist/engine/indexer.d.ts

@@ -0,0 +1,158 @@
+/**
+ * ProjectIndexer — 项目级增量索引系统（v3.7.0）
+ *
+ * 设计目标：
+ * 1. 预索引项目文件结构（符号、import、路由），加速后续扫描
+ * 2. 基于文件哈希快速检测变更，只重新索引变更文件
+ * 3. 反向依赖图：快速定位"修改文件会影响谁"
+ * 4. 框架路由自动解析：React Router / Vue Router / Next.js / Nuxt / UniApp
+ * 5. 持久化到 `.frontend-guardian/index/index.json`，跨会话复用
+ *
+ * 与 SmartCache 的区别：
+ * - SmartCache 缓存扫描结果（Issue[]），按规则版本失效
+ * - ProjectIndexer 缓存文件结构（符号、import、路由），按文件内容哈希失效
+ */
+/** 符号信息 */
+export interface SymbolInfo {
+    name: string;
+    kind: "function" | "class" | "variable" | "hook" | "component";
+    line: number;
+    column: number;
+}
+/** 路由信息 */
+export interface RouteInfo {
+    path: string;
+    component?: string;
+    file: string;
+    framework: string;
+}
+/** 单个文件的索引 */
+export interface FileIndex {
+    /** 文件相对路径 */
+    path: string;
+    /** 文件内容 SHA-256 哈希（前 16 位） */
+    hash: string;
+    /** 最后索引时间 */
+    indexedAt: number;
+    /** 导入的文件列表（相对路径） */
+    imports: string[];
+    /** 导出的符号名列表 */
+    exports: string[];
+    /** 符号表 */
+    symbols: SymbolInfo[];
+    /** 路由信息（如果该文件定义了路由） */
+    route?: RouteInfo;
+}
+/** 项目级索引 */
+export interface ProjectIndex {
+    /** 索引版本 */
+    version: string;
+    /** 项目目录 */
+    projectDir: string;
+    /** 创建时间 */
+    createdAt: number;
+    /** 更新时间 */
+    updatedAt: number;
+    /** 文件索引映射（相对路径 → FileIndex） */
+    files: Record<string, FileIndex>;
+    /** 反向依赖图：文件 → 导入它的文件列表（相对路径） */
+    reverseImports: Record<string, string[]>;
+    /** 路由表 */
+    routes: RouteInfo[];
+}
+export declare class ProjectIndexer {
+    private index;
+    private indexDir;
+    private indexFilePath;
+    private projectDir;
+    constructor(projectDir: string);
+    /** 索引是否有效（版本匹配且有数据） */
+    isValid(): boolean;
+    /** 获取索引统计 */
+    getStats(): {
+        files: number;
+        routes: number;
+        symbols: number;
+    };
+    /**
+     * 对比当前文件系统与索引，返回变更文件列表
+     * @param files 当前项目中的文件列表（绝对路径）
+     * @returns 变更/新增/删除的文件列表（绝对路径）
+     */
+    getChangedFiles(files: string[]): {
+        changed: string[];
+        deleted: string[];
+    };
+    /**
+     * 全量建立索引
+     * @param files 项目源文件列表（绝对路径）
+     */
+    buildIndex(files: string[]): Promise<void>;
+    /**
+     * 增量更新索引
+     * @param changedFiles 变更文件列表（绝对路径）
+     * @param deletedFiles 已删除文件列表（绝对路径）
+     */
+    updateIndex(changedFiles: string[], deletedFiles?: string[]): Promise<void>;
+    /**
+     * 获取导入某个文件的所有文件（上游依赖方）
+     * @param filePath 文件绝对路径
+     * @returns 导入该文件的文件列表（绝对路径）
+     */
+    getImporters(filePath: string): string[];
+    /**
+     * 获取文件的直接依赖（下游）
+     * @param filePath 文件绝对路径
+     * @returns 该文件导入的文件列表（绝对路径）
+     */
+    getDependencies(filePath: string): string[];
+    /**
+     * 获取文件的完整依赖链（递归上游）
+     * @param filePath 文件绝对路径
+     * @returns 所有导入该文件的文件（包括间接导入）
+     */
+    getTransitiveImporters(filePath: string): string[];
+    /** 获取项目路由表 */
+    getRoutes(): RouteInfo[];
+    /** 按路径查找路由 */
+    findRouteByPath(path: string): RouteInfo | undefined;
+    /** 按组件名查找路由 */
+    findRouteByComponent(component: string): RouteInfo | undefined;
+    /** 获取文件中的符号列表 */
+    getSymbols(filePath: string): SymbolInfo[];
+    /** 搜索项目中定义的符号 */
+    findSymbol(name: string): {
+        file: string;
+        symbol: SymbolInfo;
+    }[];
+    /** 获取文件的导出列表 */
+    getExports(filePath: string): string[];
+    /** 保存索引到磁盘 */
+    save(): void;
+    /** 清理索引（删除所有索引数据） */
+    clean(): void;
+    /** 索引单个文件 */
+    private _indexSingleFile;
+    /** 解析 import 路径为相对路径 */
+    private resolveImports;
+    /** 解析 import 源路径为绝对路径 */
+    private resolveImportPath;
+    /** 从 AST 提取符号信息 */
+    private extractSymbols;
+    /** 推断符号类型 */
+    private inferSymbolKind;
+    /** 检测文件是否包含路由定义 */
+    private detectRoute;
+    private parseNextJsRoute;
+    private parseNuxtRoute;
+    private parseUniAppRoutes;
+    private parseReactRouterConfig;
+    private parseVueRouterConfig;
+    /** 构建反向依赖图（文件 → 导入它的文件） */
+    private buildReverseImports;
+    /** 计算文件内容 SHA-256 哈希（取前 16 位） */
+    private computeHash;
+    /** 加载索引 */
+    private loadIndex;
+}
+//# sourceMappingURL=indexer.d.ts.map

package/dist/engine/indexer.d.ts.map

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