repowiki-core 0.1.0

package/dist/analyzer/module-analyzer.js

@@ -0,0 +1,252 @@
+/**
+ * 模块聚类分析器
+ * 将扫描到的文件按目录结构聚类为逻辑模块，并可选通过 LLM 生成模块描述。
+ */
+import * as path from 'node:path';
+import { buildModuleAnalysisPrompt } from '../llm/index.js';
+// ============================================================================
+// 目录 → 分类标签映射
+// ============================================================================
+/** 目录名关键词到分类标签的映射规则 */
+const CATEGORY_RULES = [
+    { keywords: ['agent'], category: 'agents' },
+    { keywords: ['model', 'entity', 'schema'], category: 'models' },
+    { keywords: ['route', 'router', 'controller', 'endpoint'], category: 'api' },
+    { keywords: ['test', '__tests__', 'spec'], category: 'tests' },
+    { keywords: ['component', 'components'], category: 'components' },
+    { keywords: ['view', 'views', 'page', 'pages'], category: 'views' },
+    { keywords: ['hook', 'hooks'], category: 'hooks' },
+    { keywords: ['util', 'utils', 'helper', 'helpers', 'lib'], category: 'utilities' },
+    { keywords: ['service', 'services'], category: 'services' },
+    { keywords: ['middleware', 'middlewares'], category: 'middleware' },
+    { keywords: ['config', 'configuration'], category: 'config' },
+    { keywords: ['store', 'stores', 'state'], category: 'state' },
+    { keywords: ['workflow', 'workflows', 'pipeline'], category: 'workflows' },
+    { keywords: ['migration', 'migrations'], category: 'migrations' },
+    { keywords: ['static', 'public', 'assets'], category: 'assets' },
+    { keywords: ['type', 'types', 'interface', 'interfaces'], category: 'types' },
+    { keywords: ['llm', 'ai', 'prompt', 'prompts'], category: 'ai' },
+    { keywords: ['auth', 'authentication', 'authorization'], category: 'auth' },
+    { keywords: ['doc', 'docs', 'documentation'], category: 'docs' },
+    { keywords: ['script', 'scripts', 'tool', 'tools'], category: 'tooling' },
+];
+/**
+ * 根据目录路径推断分类标签
+ * @param dirPath - 目录的相对路径
+ * @returns 匹配的分类标签，无匹配时返回 'general'
+ */
+function inferCategory(dirPath) {
+    const normalizedPath = dirPath.replace(/\\/g, '/').toLowerCase();
+    const segments = normalizedPath.split('/');
+    for (const rule of CATEGORY_RULES) {
+        for (const segment of segments) {
+            if (rule.keywords.some((kw) => segment.includes(kw))) {
+                return rule.category;
+            }
+        }
+    }
+    return 'general';
+}
+/**
+ * 从目录路径推导模块名称
+ * 取路径中最后一级有意义的目录名，如 'apps/api' → 'api'，'src/components' → 'components'
+ *
+ * @param dirPath - 目录的相对路径
+ * @returns 模块名称
+ */
+function deriveModuleName(dirPath) {
+    const segments = dirPath
+        .replace(/\\/g, '/')
+        .split('/')
+        .filter((s) => s.length > 0);
+    // 跳过仅作命名空间的顶级目录（如 src）
+    const skipSegments = new Set(['src', 'source', 'lib', 'app']);
+    const meaningfulSegments = segments.filter((s) => !skipSegments.has(s.toLowerCase()));
+    if (meaningfulSegments.length > 0) {
+        return meaningfulSegments[meaningfulSegments.length - 1];
+    }
+    return segments[segments.length - 1] || 'root';
+}
+/**
+ * 提取文件的分组键：取前两级目录路径
+ * 例如 'apps/api/routers/user.py' → 'apps/api'
+ *      'src/components/Header.tsx' → 'src/components'
+ *      'main.py' → '.'
+ *
+ * @param relativePath - 文件相对路径
+ * @returns 分组键
+ */
+function getGroupKey(relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/');
+    const parts = normalized.split('/');
+    if (parts.length <= 1) {
+        // 根目录下的文件
+        return '.';
+    }
+    if (parts.length === 2) {
+        // 只有一级目录
+        return parts[0];
+    }
+    // 取前两级目录
+    return `${parts[0]}/${parts[1]}`;
+}
+/**
+ * 基于文件名和结构生成基本模块描述（无 LLM 时的回退逻辑）
+ *
+ * @param moduleName - 模块名称
+ * @param directory - 目录路径
+ * @param files - 文件列表
+ * @param category - 分类标签
+ * @returns 模块描述文本
+ */
+function generateBasicSummary(moduleName, directory, files, category) {
+    const extCounts = new Map();
+    for (const f of files) {
+        const ext = path.extname(f).toLowerCase();
+        if (ext) {
+            extCounts.set(ext, (extCounts.get(ext) || 0) + 1);
+        }
+    }
+    const extSummary = Array.from(extCounts.entries())
+        .sort((a, b) => b[1] - a[1])
+        .map(([ext, count]) => `${ext}(${count})`)
+        .join(', ');
+    const categoryDescriptions = {
+        agents: 'Agent 智能体相关逻辑',
+        models: '数据模型定义',
+        api: 'API 路由与控制器',
+        tests: '测试代码',
+        components: 'UI 组件',
+        views: '视图/页面',
+        hooks: 'React Hooks',
+        utilities: '工具函数与辅助库',
+        services: '业务服务层',
+        middleware: '中间件',
+        config: '配置管理',
+        state: '状态管理',
+        workflows: '工作流/流水线编排',
+        migrations: '数据库迁移脚本',
+        assets: '静态资源',
+        types: '类型定义',
+        ai: 'AI/LLM 集成',
+        auth: '认证与授权',
+        docs: '文档',
+        tooling: '脚本与工具',
+        general: '通用模块',
+    };
+    const categoryDesc = categoryDescriptions[category] || '通用模块';
+    return `${moduleName} 模块位于 ${directory}，包含 ${files.length} 个文件（${extSummary}），主要负责${categoryDesc}。`;
+}
+/**
+ * 基于文件列表推断核心组件（无 LLM 时的回退逻辑）
+ *
+ * @param files - 文件列表
+ * @returns 推断的核心组件列表
+ */
+function inferCoreComponents(files) {
+    const components = [];
+    const seen = new Set();
+    for (const filePath of files) {
+        const basename = path.basename(filePath, path.extname(filePath));
+        // 跳过 index 文件和常见工具文件
+        if (['index', 'types', 'constants', 'utils'].includes(basename.toLowerCase())) {
+            continue;
+        }
+        // 跳过测试文件
+        if (/\.(test|spec|e2e)$/i.test(basename)) {
+            continue;
+        }
+        if (seen.has(basename))
+            continue;
+        seen.add(basename);
+        components.push({
+            name: basename,
+            description: `定义于 ${filePath}`,
+        });
+        // 最多保留 10 个核心组件
+        if (components.length >= 10)
+            break;
+    }
+    return components;
+}
+/**
+ * 将文件聚类为逻辑模块并生成描述
+ *
+ * 将扫描到的全部文件按顶级和次级目录分组，每个分组视为一个逻辑模块。
+ * 若提供 LLM 客户端，则通过 LLM 为每个模块生成专业描述；
+ * 否则基于文件结构启发式推断。
+ *
+ * @param rootPath - 项目根目录的绝对路径
+ * @param files - 扫描到的 FileNode 列表
+ * @param llmClient - 可选的 LLM 客户端实例
+ * @returns 分析得到的 ModuleInfo 数组
+ */
+export async function analyzeModules(rootPath, files, llmClient) {
+    // ------------------------------------------------------------------
+    // 第一步：按目录分组
+    // ------------------------------------------------------------------
+    const groups = new Map();
+    for (const file of files) {
+        if (file.nodeType !== 'file')
+            continue;
+        const key = getGroupKey(file.relativePath);
+        if (!groups.has(key)) {
+            groups.set(key, []);
+        }
+        groups.get(key).push(file.relativePath);
+    }
+    // ------------------------------------------------------------------
+    // 第二步：为每个分组构建 ModuleInfo
+    // ------------------------------------------------------------------
+    const modules = [];
+    for (const [directory, moduleFiles] of groups) {
+        const moduleName = deriveModuleName(directory);
+        const category = inferCategory(directory);
+        const moduleInfo = {
+            moduleName,
+            directory,
+            files: moduleFiles.sort(),
+            summary: '',
+            category,
+            coreComponents: [],
+        };
+        modules.push(moduleInfo);
+    }
+    // ------------------------------------------------------------------
+    // 第三步：生成描述（LLM 或回退）
+    // ------------------------------------------------------------------
+    if (llmClient) {
+        // 使用 LLM 逐模块生成描述，串行调用以避免速率限制
+        for (const mod of modules) {
+            try {
+                const prompt = buildModuleAnalysisPrompt(mod.directory, mod.files.join('\n'), '');
+                const result = await llmClient.chatJSON(prompt);
+                if (result && typeof result.summary === 'string') {
+                    mod.summary = result.summary;
+                }
+                if (result && Array.isArray(result.core_components)) {
+                    mod.coreComponents = result.core_components.map((c) => ({
+                        name: String(c.name || ''),
+                        description: String(c.description || ''),
+                    }));
+                }
+            }
+            catch {
+                // LLM 调用失败时使用回退逻辑
+                mod.summary = generateBasicSummary(mod.moduleName, mod.directory, mod.files, mod.category);
+                mod.coreComponents = inferCoreComponents(mod.files);
+            }
+        }
+    }
+    else {
+        // 无 LLM，使用基于结构的启发式描述
+        for (const mod of modules) {
+            mod.summary = generateBasicSummary(mod.moduleName, mod.directory, mod.files, mod.category);
+            mod.coreComponents = inferCoreComponents(mod.files);
+        }
+    }
+    // 按目录路径排序输出
+    modules.sort((a, b) => a.directory.localeCompare(b.directory));
+    return modules;
+}
+//# sourceMappingURL=module-analyzer.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { FileNode } from '../models/index.js';
+export interface WorkflowInfo {
+    name: string;
+    type: 'langchain' | 'langgraph' | 'custom-agent' | 'celery' | 'temporal' | 'custom-workflow';
+    filePath: string;
+    description: string;
+    steps: string[];
+}
+/**
+ * 分析项目中的智能体（Agent）和工作流（Workflow）设计模式
+ *
+ * 识别 LangGraph, LangChain, Celery, Temporal 以及自定义 Agent 结构，
+ * 提取工作流节点与流转步骤。
+ *
+ * @param rootPath - 项目根目录
+ * @param files - 扫描的文件节点
+ */
+export declare function analyzeWorkflows(rootPath: string, files: FileNode[]): Promise<WorkflowInfo[]>;
+//# sourceMappingURL=workflow-analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/workflow-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,iBAAiB,CAAC;IAC7F,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAsID;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAoCnG"}

package/dist/analyzer/workflow-analyzer.js

@@ -0,0 +1,165 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * 根据导入和内容模式识别工作流/智能体类型
+ */
+function detectWorkflowType(content, relativePath) {
+    const lowerContent = content.toLowerCase();
+    const normalizedPath = relativePath.replace(/\\/g, '/').toLowerCase();
+    if (lowerContent.includes('langgraph') || lowerContent.includes('stategraph')) {
+        return 'langgraph';
+    }
+    if (lowerContent.includes('langchain') || lowerContent.includes('agentexecutor') || lowerContent.includes('create_react_agent')) {
+        return 'langchain';
+    }
+    if (lowerContent.includes('celery') || lowerContent.includes('@shared_task') || lowerContent.includes('@app.task')) {
+        return 'celery';
+    }
+    if (lowerContent.includes('temporalio') || lowerContent.includes('@workflow.defn') || lowerContent.includes('workflow.run')) {
+        return 'temporal';
+    }
+    // 启发式路径规则
+    if (normalizedPath.includes('/agent/') || normalizedPath.includes('/agents/') || normalizedPath.includes('agent.py') || normalizedPath.includes('agent.ts')) {
+        return 'custom-agent';
+    }
+    if (normalizedPath.includes('/workflow/') || normalizedPath.includes('/workflows/') || normalizedPath.includes('/pipeline/') || normalizedPath.includes('/pipelines/')) {
+        return 'custom-workflow';
+    }
+    return null;
+}
+/**
+ * 提取工作流步骤或节点
+ */
+function extractSteps(content, type) {
+    const steps = [];
+    switch (type) {
+        case 'langgraph': {
+            // 匹配 .add_node("name", ...) 或 .add_node('name', ...)
+            const nodePattern = /\.add_node\(\s*['"]([^'"]+)['"]/g;
+            let match;
+            while ((match = nodePattern.exec(content)) !== null) {
+                steps.push(match[1]);
+            }
+            // 也可能匹配 .add_edge("nodeA", "nodeB")
+            const edgePattern = /\.add_edge\(\s*['"]([^'"]+)['"]\s*,\s*['"]([^'"]+)['"]/g;
+            while ((match = edgePattern.exec(content)) !== null) {
+                const edgeStr = `${match[1]} -> ${match[2]}`;
+                if (!steps.includes(edgeStr)) {
+                    steps.push(edgeStr);
+                }
+            }
+            break;
+        }
+        case 'langchain': {
+            // 匹配 Tool 定义或 Agent 步骤
+            const toolPattern = /@tool\b|Tool\.from_function|class\s+(\w+Tool)\b/g;
+            let match;
+            while ((match = toolPattern.exec(content)) !== null) {
+                steps.push(match[1] || 'Registered Tool');
+            }
+            break;
+        }
+        case 'celery': {
+            // 匹配任务函数
+            const taskPattern = /@(?:app|shared)_task\s*(?:\([^)]*\))?\s*\n\s*(?:async\s+)?def\s+(\w+)/g;
+            let match;
+            while ((match = taskPattern.exec(content)) !== null) {
+                steps.push(match[1]);
+            }
+            break;
+        }
+        case 'temporal': {
+            // 匹配活动或工作流定义
+            const temporalPattern = /@workflow\.run\b\s*\n\s*(?:async\s+)?def\s+(\w+)|@activity\.defn\b\s*\n\s*(?:async\s+)?def\s+(\w+)/g;
+            let match;
+            while ((match = temporalPattern.exec(content)) !== null) {
+                steps.push(match[1] || match[2]);
+            }
+            break;
+        }
+        case 'custom-agent':
+        case 'custom-workflow': {
+            // 匹配类中的主要方法名，如 run, execute, process, invoke, step
+            const methodPattern = /(?:async\s+)?def\s+(run|execute|process|invoke|step|start|next_step)\s*\(/g;
+            let match;
+            while ((match = methodPattern.exec(content)) !== null) {
+                steps.push(match[1]);
+            }
+            break;
+        }
+    }
+    return Array.from(new Set(steps));
+}
+/**
+ * 猜测工作流名称
+ */
+function deriveWorkflowName(content, filePath) {
+    const basename = path.basename(filePath, path.extname(filePath));
+    // 尝试寻找类名定义，如 class Agent, class WritingWorkflow
+    const classMatch = /class\s+(\w+(?:Agent|Workflow|Graph|Pipeline|Chain))\b/.exec(content);
+    if (classMatch) {
+        return classMatch[1];
+    }
+    return basename.replace(/^./, (c) => c.toUpperCase());
+}
+/**
+ * 生成工作流简要描述
+ */
+function generateDescription(name, type, steps) {
+    const typeNames = {
+        langgraph: 'LangGraph 状态图智能体工作流',
+        langchain: 'LangChain 链式/智能体代理执行器',
+        celery: 'Celery 分布式异步任务队列',
+        temporal: 'Temporal 强一致性持久工作流',
+        'custom-agent': '自定义 Agent 智能体逻辑',
+        'custom-workflow': '自定义业务流程/工作流',
+    };
+    const typeDesc = typeNames[type] || '业务工作流';
+    if (steps.length > 0) {
+        return `${name} 是一个基于 ${typeDesc}，定义了包含 [${steps.join(', ')}] 等关键节点或步骤。`;
+    }
+    return `${name} 定义了项目中的 ${typeDesc} 流程。`;
+}
+/**
+ * 分析项目中的智能体（Agent）和工作流（Workflow）设计模式
+ *
+ * 识别 LangGraph, LangChain, Celery, Temporal 以及自定义 Agent 结构，
+ * 提取工作流节点与流转步骤。
+ *
+ * @param rootPath - 项目根目录
+ * @param files - 扫描的文件节点
+ */
+export async function analyzeWorkflows(rootPath, files) {
+    const workflows = [];
+    for (const file of files) {
+        if (file.nodeType !== 'file')
+            continue;
+        // 仅对文本源文件分析
+        const ext = path.extname(file.relativePath).toLowerCase();
+        if (!['.py', '.ts', '.js', '.tsx', '.jsx'].includes(ext)) {
+            continue;
+        }
+        try {
+            const absolutePath = path.resolve(rootPath, file.relativePath);
+            const content = await fs.readFile(absolutePath, 'utf-8');
+            const type = detectWorkflowType(content, file.relativePath);
+            if (!type)
+                continue;
+            const name = deriveWorkflowName(content, file.relativePath);
+            const steps = extractSteps(content, type);
+            const description = generateDescription(name, type, steps);
+            workflows.push({
+                name,
+                type,
+                filePath: file.relativePath,
+                description,
+                steps,
+            });
+        }
+        catch {
+            // 忽略读取错误
+        }
+    }
+    return workflows.sort((a, b) => a.filePath.localeCompare(b.filePath));
+}
+//# sourceMappingURL=workflow-analyzer.js.map

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

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

package/dist/detector/dependency-detector.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @module detector/dependency-detector
+ * 依赖关系探测器
+ *
+ * 通过正则表达式解析源文件中的 import / require 语句，
+ * 构建项目内部模块间的依赖图以及外部包引用列表。
+ *
+ * 为避免性能问题，仅处理前 500 个源文件。
+ */
+import type { FileNode } from '../models/index.js';
+/** 依赖边，表示一个文件对另一个模块的引用 */
+export interface DependencyEdge {
+    /** 源文件的相对路径 */
+    source: string;
+    /** 引用目标的相对路径（内部模块）或包名（外部依赖） */
+    target: string;
+    /** 是否为外部依赖 */
+    isExternal: boolean;
+}
+/** 完整的依赖关系图 */
+export interface DependencyGraph {
+    /** 所有依赖边 */
+    edges: DependencyEdge[];
+    /** 参与图中的内部模块路径列表 */
+    internalModules: string[];
+    /** 引用到的外部包名列表 */
+    externalPackages: string[];
+}
+/**
+ * 构建项目依赖关系图。
+ *
+ * 扫描源文件（.ts, .tsx, .js, .jsx, .py）中的 import/require 语句，
+ * 将导入分类为内部模块引用和外部包引用，尝试解析内部导入的实际文件路径，
+ * 并汇总为完整的依赖图。
+ *
+ * 为避免性能问题，最多处理前 {@link MAX_SOURCE_FILES} 个源文件。
+ *
+ * @param rootPath 项目根目录的绝对路径
+ * @param files    FileScanner 输出的文件节点列表
+ * @returns 完整的依赖关系图
+ *
+ * @example
+ * ```ts
+ * const graph = await buildDependencyGraph('/path/to/project', files);
+ * console.log(graph.externalPackages); // ['react', 'express', ...]
+ * console.log(graph.edges.length);      // 依赖边数量
+ * ```
+ */
+export declare function buildDependencyGraph(rootPath: string, files: FileNode[]): Promise<DependencyGraph>;
+//# sourceMappingURL=dependency-detector.d.ts.map

package/dist/detector/dependency-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-detector.d.ts","sourceRoot":"","sources":["../../src/detector/dependency-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMnD,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC3B,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,eAAe;AACf,MAAM,WAAW,eAAe;IAC5B,YAAY;IACZ,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,oBAAoB;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC9B;AA6OD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,eAAe,CAAC,CA6F1B"}