repowiki-core 0.1.0

package/dist/analyzer/api-analyzer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * API 路由分析器
+ * 通过正则表达式从源码中提取 HTTP 路由定义，支持 FastAPI、Express、NestJS 等框架。
+ */
+import type { FileNode, ApiRoute } from '../models/index.js';
+/**
+ * 分析项目中的 API 路由定义
+ *
+ * 从扫描到的文件列表中筛选可能包含路由定义的文件，
+ * 读取其内容并应用多框架正则模式提取路由信息。
+ *
+ * 支持的框架：
+ * - FastAPI / Python（装饰器 @app.get / @router.post 等）
+ * - Express / Node.js（app.get / router.post 等）
+ * - NestJS / TypeScript（@Controller + @Get/@Post 装饰器等）
+ *
+ * @param rootPath - 项目根目录的绝对路径
+ * @param files - 扫描到的 FileNode 列表
+ * @returns 排序后的 ApiRoute 数组
+ */
+export declare function analyzeApiRoutes(rootPath: string, files: FileNode[]): Promise<ApiRoute[]>;
+//# sourceMappingURL=api-analyzer.d.ts.map

package/dist/analyzer/api-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/api-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AA8Q7D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,CA4BrB"}

package/dist/analyzer/api-analyzer.js

@@ -0,0 +1,272 @@
+/**
+ * API 路由分析器
+ * 通过正则表达式从源码中提取 HTTP 路由定义，支持 FastAPI、Express、NestJS 等框架。
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+// ============================================================================
+// 路由文件过滤
+// ============================================================================
+/** 路径中包含这些关键词的文件可能定义路由 */
+const ROUTE_PATH_KEYWORDS = [
+    'route',
+    'router',
+    'controller',
+    'api',
+    'endpoint',
+    'views',
+    'handlers',
+];
+/**
+ * 判断文件是否可能包含路由定义
+ * @param relativePath - 文件相对路径
+ * @returns 是否为候选路由文件
+ */
+function isRouteCandidateFile(relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/').toLowerCase();
+    return ROUTE_PATH_KEYWORDS.some((kw) => normalized.includes(kw));
+}
+// ============================================================================
+// 正则模式定义
+// ============================================================================
+/**
+ * FastAPI / Python 装饰器路由
+ * 匹配 @app.get("/path") 或 @router.post("/path") 等形式
+ */
+const FASTAPI_ROUTE_PATTERN = /@(app|router)\.(get|post|put|delete|patch)\(\s*['"]([^'"]+)['"]/gi;
+/**
+ * FastAPI 处理函数名
+ * 匹配 async def function_name 或 def function_name
+ */
+const PYTHON_FUNC_PATTERN = /(?:async\s+)?def\s+(\w+)/;
+/**
+ * Express / Node.js 路由
+ * 匹配 app.get("/path", ...) 或 router.post("/path", ...) 等形式
+ */
+const EXPRESS_ROUTE_PATTERN = /(?:app|router)\.(get|post|put|delete|patch|all)\(\s*['"]([^'"]+)['"]/gi;
+/**
+ * Express 处理函数引用
+ * 匹配 , handlerName 或 , async (req 等形式
+ */
+const EXPRESS_HANDLER_PATTERN = /,\s*(\w+)/;
+/**
+ * NestJS 方法装饰器
+ * 匹配 @Get(), @Post("/path"), @Put('path') 等形式
+ */
+const NESTJS_METHOD_PATTERN = /@(Get|Post|Put|Delete|Patch)\(\s*['"]?([^'")]*?)['"]?\s*\)/gi;
+/**
+ * NestJS Controller 装饰器
+ * 匹配 @Controller("prefix") 等形式
+ */
+const NESTJS_CONTROLLER_PATTERN = /@Controller\(\s*['"]([^'"]+)['"]\s*\)/i;
+/**
+ * NestJS 方法名
+ * 匹配装饰器下方的 async methodName( 或 methodName( 形式
+ */
+const NESTJS_METHOD_NAME_PATTERN = /(?:async\s+)?(\w+)\s*\(/;
+// ============================================================================
+// 路由提取逻辑
+// ============================================================================
+/**
+ * 提取 FastAPI 路由
+ * @param content - 文件内容
+ * @param filePath - 文件相对路径
+ * @returns 提取到的路由数组
+ */
+function extractFastAPIRoutes(content, filePath) {
+    const routes = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // 重置正则 lastIndex
+        FASTAPI_ROUTE_PATTERN.lastIndex = 0;
+        const match = FASTAPI_ROUTE_PATTERN.exec(line);
+        if (match) {
+            const method = match[2].toUpperCase();
+            const routePath = match[3];
+            // 在后续行中查找处理函数名
+            let handler = '';
+            for (let j = i + 1; j < Math.min(i + 5, lines.length); j++) {
+                const funcMatch = PYTHON_FUNC_PATTERN.exec(lines[j]);
+                if (funcMatch) {
+                    handler = funcMatch[1];
+                    break;
+                }
+            }
+            routes.push({
+                method,
+                path: routePath,
+                handler,
+                filePath,
+                lineNumber: i + 1,
+                framework: 'fastapi',
+            });
+        }
+    }
+    return routes;
+}
+/**
+ * 提取 Express 路由
+ * @param content - 文件内容
+ * @param filePath - 文件相对路径
+ * @returns 提取到的路由数组
+ */
+function extractExpressRoutes(content, filePath) {
+    const routes = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        EXPRESS_ROUTE_PATTERN.lastIndex = 0;
+        const match = EXPRESS_ROUTE_PATTERN.exec(line);
+        if (match) {
+            const method = match[1].toUpperCase();
+            const routePath = match[2];
+            // 尝试从同一行或下一行提取 handler 名
+            let handler = '';
+            const handlerMatch = EXPRESS_HANDLER_PATTERN.exec(line.slice(match.index + match[0].length));
+            if (handlerMatch && handlerMatch[1] !== 'async' && handlerMatch[1] !== 'function') {
+                handler = handlerMatch[1];
+            }
+            else if (i + 1 < lines.length) {
+                const nextLineMatch = EXPRESS_HANDLER_PATTERN.exec(lines[i + 1]);
+                if (nextLineMatch &&
+                    nextLineMatch[1] !== 'async' &&
+                    nextLineMatch[1] !== 'function') {
+                    handler = nextLineMatch[1];
+                }
+            }
+            routes.push({
+                method,
+                path: routePath,
+                handler,
+                filePath,
+                lineNumber: i + 1,
+                framework: 'express',
+            });
+        }
+    }
+    return routes;
+}
+/**
+ * 提取 NestJS 路由
+ * @param content - 文件内容
+ * @param filePath - 文件相对路径
+ * @returns 提取到的路由数组
+ */
+function extractNestJSRoutes(content, filePath) {
+    const routes = [];
+    const lines = content.split('\n');
+    // 首先提取 Controller 前缀
+    let controllerPrefix = '';
+    const controllerMatch = NESTJS_CONTROLLER_PATTERN.exec(content);
+    if (controllerMatch) {
+        controllerPrefix = controllerMatch[1];
+        // 确保前缀以 / 开头
+        if (!controllerPrefix.startsWith('/')) {
+            controllerPrefix = '/' + controllerPrefix;
+        }
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        NESTJS_METHOD_PATTERN.lastIndex = 0;
+        const match = NESTJS_METHOD_PATTERN.exec(line);
+        if (match) {
+            const method = match[1].toUpperCase();
+            let methodPath = match[2] || '';
+            // 组合 controller 前缀与方法路径
+            if (methodPath && !methodPath.startsWith('/')) {
+                methodPath = '/' + methodPath;
+            }
+            const fullPath = controllerPrefix + methodPath || controllerPrefix || '/';
+            // 查找方法名
+            let handler = '';
+            for (let j = i + 1; j < Math.min(i + 5, lines.length); j++) {
+                const methodNameMatch = NESTJS_METHOD_NAME_PATTERN.exec(lines[j]);
+                if (methodNameMatch) {
+                    handler = methodNameMatch[1];
+                    break;
+                }
+            }
+            routes.push({
+                method,
+                path: fullPath,
+                handler,
+                filePath,
+                lineNumber: i + 1,
+                framework: 'nestjs',
+            });
+        }
+    }
+    return routes;
+}
+/**
+ * 检测文件中使用的框架并提取路由
+ * @param content - 文件内容
+ * @param filePath - 文件相对路径
+ * @returns 提取到的路由数组
+ */
+function extractRoutesFromContent(content, filePath) {
+    const routes = [];
+    // 根据内容特征检测框架类型
+    const hasFastAPIDecorator = /@(app|router)\.(get|post|put|delete|patch)\(/i.test(content);
+    const hasExpressCall = /(?:app|router)\.(get|post|put|delete|patch)\(\s*['"]/i.test(content);
+    const hasNestJSDecorator = /@(Get|Post|Put|Delete|Patch)\(/i.test(content);
+    const hasControllerDecorator = /@Controller\(/i.test(content);
+    // NestJS 优先级最高（因为它同时可能含有类似 Express 的模式）
+    if (hasNestJSDecorator || hasControllerDecorator) {
+        routes.push(...extractNestJSRoutes(content, filePath));
+    }
+    // 检查 FastAPI（Python 装饰器风格）
+    if (hasFastAPIDecorator) {
+        // 确认是 Python 文件（通过 def 关键词辅助判断）
+        if (/\bdef\s+\w+/.test(content)) {
+            routes.push(...extractFastAPIRoutes(content, filePath));
+        }
+    }
+    // 检查 Express（排除已被 NestJS 检测的情况）
+    if (hasExpressCall && !hasNestJSDecorator && !hasControllerDecorator) {
+        routes.push(...extractExpressRoutes(content, filePath));
+    }
+    return routes;
+}
+/**
+ * 分析项目中的 API 路由定义
+ *
+ * 从扫描到的文件列表中筛选可能包含路由定义的文件，
+ * 读取其内容并应用多框架正则模式提取路由信息。
+ *
+ * 支持的框架：
+ * - FastAPI / Python（装饰器 @app.get / @router.post 等）
+ * - Express / Node.js（app.get / router.post 等）
+ * - NestJS / TypeScript（@Controller + @Get/@Post 装饰器等）
+ *
+ * @param rootPath - 项目根目录的绝对路径
+ * @param files - 扫描到的 FileNode 列表
+ * @returns 排序后的 ApiRoute 数组
+ */
+export async function analyzeApiRoutes(rootPath, files) {
+    const allRoutes = [];
+    // 筛选候选文件
+    const candidates = files.filter((f) => f.nodeType === 'file' && isRouteCandidateFile(f.relativePath));
+    for (const candidate of candidates) {
+        try {
+            const absolutePath = path.resolve(rootPath, candidate.relativePath);
+            const content = await fs.readFile(absolutePath, 'utf-8');
+            const routes = extractRoutesFromContent(content, candidate.relativePath);
+            allRoutes.push(...routes);
+        }
+        catch {
+            // 无法读取的文件直接跳过
+            continue;
+        }
+    }
+    // 按文件路径和行号排序
+    allRoutes.sort((a, b) => {
+        const fileCmp = a.filePath.localeCompare(b.filePath);
+        if (fileCmp !== 0)
+            return fileCmp;
+        return a.lineNumber - b.lineNumber;
+    });
+    return allRoutes;
+}
+//# sourceMappingURL=api-analyzer.js.map

package/dist/analyzer/api-analyzer.js.map

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

package/dist/analyzer/config-analyzer.d.ts

@@ -0,0 +1,18 @@
+import type { FileNode } from '../models/index.js';
+export interface ConfigInfo {
+    filePath: string;
+    type: 'env' | 'yaml' | 'json' | 'toml' | 'dockerfile' | 'ci' | 'js_ts';
+    keys: string[];
+    description: string;
+}
+/**
+ * 分析项目中的配置文件和环境配置
+ *
+ * 识别 docker-compose, tsconfig, env.example, *.config.js 等文件，
+ * 提取顶层配置键、工作流阶段或环境变量，以便 Wiki 文档生成时使用。
+ *
+ * @param rootPath - 项目根目录
+ * @param files - 扫描的文件节点
+ */
+export declare function analyzeConfigs(rootPath: string, files: FileNode[]): Promise<ConfigInfo[]>;
+//# sourceMappingURL=config-analyzer.d.ts.map

package/dist/analyzer/config-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/config-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC;IACvE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACvB;AAmKD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA2B/F"}

package/dist/analyzer/config-analyzer.js

@@ -0,0 +1,200 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * 判断是否为配置文件，并归类其类型
+ */
+function detectConfigType(relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/').toLowerCase();
+    const basename = path.basename(normalized);
+    if (normalized.startsWith('.github/workflows/')) {
+        return 'ci';
+    }
+    if (basename === 'dockerfile' || basename.startsWith('dockerfile.')) {
+        return 'dockerfile';
+    }
+    if (basename.startsWith('.env')) {
+        return 'env';
+    }
+    if (basename.endsWith('.json')) {
+        return 'json';
+    }
+    if (basename.endsWith('.toml')) {
+        return 'toml';
+    }
+    if (basename.endsWith('.yaml') || basename.endsWith('.yml')) {
+        return 'yaml';
+    }
+    if (basename.endsWith('config.js') ||
+        basename.endsWith('config.ts') ||
+        basename.endsWith('config.mjs') ||
+        basename.endsWith('config.cjs')) {
+        return 'js_ts';
+    }
+    return null;
+}
+/**
+ * 解析各种配置文件中的配置键/节
+ */
+async function parseConfigFiles(absolutePath, type, content) {
+    const keys = [];
+    let description = '';
+    try {
+        switch (type) {
+            case 'env': {
+                description = '环境变量模板/配置文件';
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed.startsWith('#'))
+                        continue;
+                    const match = /^export\s+(\w+)=|^(\w+)=/.exec(trimmed);
+                    if (match) {
+                        const key = match[1] || match[2];
+                        if (key)
+                            keys.push(key);
+                    }
+                }
+                break;
+            }
+            case 'json': {
+                description = 'JSON 格式配置文件';
+                try {
+                    // 去除 JSON 的注释（如果有的话，如 tsconfig.json）
+                    const cleanJson = content.replace(/\/\*[\s\S]*?\*\/|([^\\:]|^)\/\/.*$/gm, '$1');
+                    const parsed = JSON.parse(cleanJson);
+                    if (parsed && typeof parsed === 'object') {
+                        keys.push(...Object.keys(parsed));
+                    }
+                }
+                catch {
+                    // 解析失败时，回退到正则
+                    const keyPattern = /"([^"]+)"\s*:/g;
+                    let match;
+                    while ((match = keyPattern.exec(content)) !== null) {
+                        if (!keys.includes(match[1])) {
+                            keys.push(match[1]);
+                        }
+                    }
+                }
+                break;
+            }
+            case 'yaml':
+            case 'ci': {
+                description = type === 'ci' ? 'GitHub 工作流持续集成配置' : 'YAML 格式配置文件';
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    const match = /^([a-zA-Z0-9_\-]+)\s*:/gm.exec(line);
+                    if (match) {
+                        const key = match[1];
+                        if (!keys.includes(key)) {
+                            keys.push(key);
+                        }
+                    }
+                }
+                break;
+            }
+            case 'toml': {
+                description = 'TOML 格式配置文件';
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+                        const section = trimmed.slice(1, -1).trim();
+                        keys.push(section);
+                    }
+                    else {
+                        const match = /^([a-zA-Z0-9_\-]+)\s*=/.exec(trimmed);
+                        if (match) {
+                            keys.push(match[1]);
+                        }
+                    }
+                }
+                break;
+            }
+            case 'dockerfile': {
+                description = 'Docker 容器构建文件';
+                const lines = content.split('\n');
+                const envKeys = new Set();
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed.startsWith('FROM')) {
+                        const parts = trimmed.split(/\s+/);
+                        if (parts[1])
+                            keys.push(`BaseImage: ${parts[1]}`);
+                    }
+                    else if (trimmed.startsWith('ENV')) {
+                        // ENV KEY=VALUE 或 ENV KEY VALUE
+                        const match = /^ENV\s+(\w+)(?:=|\s+)/.exec(trimmed);
+                        if (match && match[1]) {
+                            envKeys.add(match[1]);
+                        }
+                    }
+                    else if (trimmed.startsWith('EXPOSE')) {
+                        const parts = trimmed.split(/\s+/);
+                        if (parts[1])
+                            keys.push(`ExposePort: ${parts[1]}`);
+                    }
+                }
+                if (envKeys.size > 0) {
+                    keys.push(...Array.from(envKeys).map(k => `ENV: ${k}`));
+                }
+                break;
+            }
+            case 'js_ts': {
+                description = 'JavaScript/TypeScript 构建/运行时配置文件';
+                // 查找默认导出的对象键或 module.exports
+                const exportMatch = /export\s+default\s*\{([\s\S]*?)\}/.exec(content) ||
+                    /module\.exports\s*=\s*\{([\s\S]*?)\}/.exec(content);
+                if (exportMatch) {
+                    const block = exportMatch[1];
+                    const keyPattern = /^\s*(\w+)\s*:/gm;
+                    let match;
+                    while ((match = keyPattern.exec(block)) !== null) {
+                        keys.push(match[1]);
+                    }
+                }
+                break;
+            }
+        }
+    }
+    catch {
+        // 解析出错则返回空 keys
+    }
+    return { keys: Array.from(new Set(keys)), description };
+}
+/**
+ * 分析项目中的配置文件和环境配置
+ *
+ * 识别 docker-compose, tsconfig, env.example, *.config.js 等文件，
+ * 提取顶层配置键、工作流阶段或环境变量，以便 Wiki 文档生成时使用。
+ *
+ * @param rootPath - 项目根目录
+ * @param files - 扫描的文件节点
+ */
+export async function analyzeConfigs(rootPath, files) {
+    const configInfos = [];
+    for (const file of files) {
+        if (file.nodeType !== 'file')
+            continue;
+        const type = detectConfigType(file.relativePath);
+        if (!type)
+            continue;
+        try {
+            const absolutePath = path.resolve(rootPath, file.relativePath);
+            const content = await fs.readFile(absolutePath, 'utf-8');
+            const { keys, description } = await parseConfigFiles(absolutePath, type, content);
+            configInfos.push({
+                filePath: file.relativePath,
+                type,
+                keys,
+                description,
+            });
+        }
+        catch {
+            // 忽略读取失败的文件
+        }
+    }
+    // 排序，保证生成文档的顺序一致
+    return configInfos.sort((a, b) => a.filePath.localeCompare(b.filePath));
+}
+//# sourceMappingURL=config-analyzer.js.map

package/dist/analyzer/config-analyzer.js.map

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

package/dist/analyzer/database-analyzer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 数据库模型分析器
+ * 通过正则表达式从 ORM 定义文件中提取数据模型、字段和关系信息。
+ * 支持 SQLAlchemy、Prisma、TypeORM、Mongoose 四种 ORM。
+ */
+import type { FileNode, DatabaseModel } from '../models/index.js';
+/**
+ * 分析项目中的数据库模型定义
+ *
+ * 从扫描到的文件列表中筛选可能包含 ORM 模型定义的文件，
+ * 读取其内容并通过正则提取模型名、字段和关系信息。
+ *
+ * 支持的 ORM：
+ * - SQLAlchemy（Python，Column + relationship 解析）
+ * - Prisma（schema.prisma 文件解析）
+ * - TypeORM（TypeScript @Entity 装饰器解析）
+ * - Mongoose（TypeScript/JavaScript Schema 解析）
+ *
+ * @param rootPath - 项目根目录的绝对路径
+ * @param files - 扫描到的 FileNode 列表
+ * @returns 排序后的 DatabaseModel 数组
+ */
+export declare function analyzeDatabaseModels(rootPath: string, files: FileNode[]): Promise<DatabaseModel[]>;
+//# sourceMappingURL=database-analyzer.d.ts.map

package/dist/analyzer/database-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/database-analyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAmC,MAAM,oBAAoB,CAAC;AA4ZnG;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CA4B1B"}