repowiki-core 0.1.0

package/dist/detector/tech-stack-detector.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module detector/tech-stack-detector
+ * 技术栈探测器
+ *
+ * 通过分析项目中的配置文件（package.json、requirements.txt、docker-compose.yml 等）
+ * 以及文件扩展名分布，自动识别项目使用的编程语言、框架、包管理器、数据库和服务。
+ */
+import type { FileNode } from '../models/index.js';
+/** 技术栈检测结果 */
+export interface TechStackResult {
+    /** 检测到的编程语言列表 */
+    languages: string[];
+    /** 检测到的框架列表 */
+    frameworks: string[];
+    /** 检测到的包管理器列表 */
+    packageManagers: string[];
+    /** 检测到的数据库列表 */
+    databases: string[];
+    /** 检测到的服务/中间件列表 */
+    services: string[];
+    /** 参与检测的配置文件列表 */
+    configFiles: string[];
+}
+/**
+ * 检测项目技术栈。
+ *
+ * 通过读取配置文件内容和分析文件扩展名分布，自动识别项目使用的
+ * 编程语言、框架、包管理器、数据库和服务。
+ *
+ * @param rootPath 项目根目录的绝对路径
+ * @param files    FileScanner 输出的文件节点列表
+ * @returns 技术栈检测结果
+ *
+ * @example
+ * ```ts
+ * const result = await detectTechStack('/path/to/project', files);
+ * console.log(result.frameworks); // ['Next.js', 'FastAPI']
+ * ```
+ */
+export declare function detectTechStack(rootPath: string, files: FileNode[]): Promise<TechStackResult>;
+//# sourceMappingURL=tech-stack-detector.d.ts.map

package/dist/detector/tech-stack-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-stack-detector.d.ts","sourceRoot":"","sources":["../../src/detector/tech-stack-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMnD,cAAc;AACd,MAAM,WAAW,eAAe;IAC5B,iBAAiB;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAqSD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,eAAe,CAAC,CAkC1B"}

package/dist/detector/tech-stack-detector.js

@@ -0,0 +1,300 @@
+/**
+ * @module detector/tech-stack-detector
+ * 技术栈探测器
+ *
+ * 通过分析项目中的配置文件（package.json、requirements.txt、docker-compose.yml 等）
+ * 以及文件扩展名分布，自动识别项目使用的编程语言、框架、包管理器、数据库和服务。
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+// ---------------------------------------------------------------------------
+// 匹配规则
+// ---------------------------------------------------------------------------
+/** Node.js 依赖名 → 框架显示名 */
+const NODE_FRAMEWORK_MAP = {
+    next: 'Next.js',
+    react: 'React',
+    vue: 'Vue.js',
+    '@angular/core': 'Angular',
+    vite: 'Vite',
+    express: 'Express',
+    '@nestjs/core': 'NestJS',
+    fastify: 'Fastify',
+};
+/** Python 包名关键字 → 框架显示名 */
+const PYTHON_FRAMEWORK_MAP = {
+    fastapi: 'FastAPI',
+    django: 'Django',
+    flask: 'Flask',
+    langchain: 'LangChain',
+    langgraph: 'LangGraph',
+};
+/** docker-compose 服务镜像/名称关键字 → 数据库/服务显示名 */
+const DOCKER_SERVICE_MAP = {
+    postgres: { name: 'PostgreSQL', kind: 'database' },
+    mysql: { name: 'MySQL', kind: 'database' },
+    redis: { name: 'Redis', kind: 'database' },
+    mongo: { name: 'MongoDB', kind: 'database' },
+    minio: { name: 'MinIO', kind: 'service' },
+    rabbitmq: { name: 'RabbitMQ', kind: 'service' },
+    elasticsearch: { name: 'Elasticsearch', kind: 'service' },
+};
+/** 锁文件 → 包管理器名称 */
+const LOCKFILE_MAP = {
+    'package-lock.json': 'npm',
+    'yarn.lock': 'yarn',
+    'pnpm-lock.yaml': 'pnpm',
+};
+/** 文件扩展名 → 语言名称（用于统计文件数量） */
+const EXTENSION_LANGUAGE_MAP = {
+    '.ts': 'TypeScript',
+    '.tsx': 'TypeScript',
+    '.js': 'JavaScript',
+    '.jsx': 'JavaScript',
+    '.py': 'Python',
+    '.rs': 'Rust',
+    '.go': 'Go',
+    '.java': 'Java',
+    '.kt': 'Kotlin',
+    '.swift': 'Swift',
+    '.rb': 'Ruby',
+    '.php': 'PHP',
+    '.cs': 'C#',
+    '.cpp': 'C++',
+    '.c': 'C',
+    '.dart': 'Dart',
+    '.scala': 'Scala',
+    '.lua': 'Lua',
+    '.zig': 'Zig',
+};
+/** 需要达到的最低文件数量阈值，才会报告该语言 */
+const LANGUAGE_FILE_THRESHOLD = 5;
+// ---------------------------------------------------------------------------
+// 辅助函数
+// ---------------------------------------------------------------------------
+/**
+ * 安全读取文件内容，文件不存在时返回 null。
+ * @param filePath 要读取的文件绝对路径
+ */
+async function safeReadFile(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 在文件节点列表中查找指定相对路径的文件是否存在。
+ * @param files 文件节点列表
+ * @param relativePath 待查找的相对路径
+ */
+function hasFile(files, relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/');
+    return files.some((f) => f.nodeType === 'file' && f.relativePath.replace(/\\/g, '/') === normalized);
+}
+/**
+ * 在文件节点列表中查找指定相对路径前缀的目录是否存在。
+ * @param files 文件节点列表
+ * @param dirPrefix 待查找的目录前缀（如 "agents/"）
+ */
+function hasDirectory(files, dirPrefix) {
+    const normalized = dirPrefix.replace(/\\/g, '/');
+    return files.some((f) => {
+        const rel = f.relativePath.replace(/\\/g, '/');
+        return rel === normalized.replace(/\/$/, '') || rel.startsWith(normalized);
+    });
+}
+/**
+ * 对结果数组进行去重。
+ */
+function unique(arr) {
+    return [...new Set(arr)];
+}
+// ---------------------------------------------------------------------------
+// 检测子流程
+// ---------------------------------------------------------------------------
+/**
+ * 从 package.json 中检测 Node.js 框架和包管理器。
+ */
+async function detectFromPackageJson(rootPath, files, result) {
+    const content = await safeReadFile(path.join(rootPath, 'package.json'));
+    if (!content)
+        return;
+    result.configFiles.push('package.json');
+    let pkg;
+    try {
+        pkg = JSON.parse(content);
+    }
+    catch {
+        return;
+    }
+    // 合并 dependencies 和 devDependencies
+    const deps = {
+        ...(pkg.dependencies ?? {}),
+        ...(pkg.devDependencies ?? {}),
+    };
+    for (const [depName, frameworkName] of Object.entries(NODE_FRAMEWORK_MAP)) {
+        if (depName in deps) {
+            result.frameworks.push(frameworkName);
+        }
+    }
+    // 检测包管理器（通过锁文件）
+    for (const [lockFile, managerName] of Object.entries(LOCKFILE_MAP)) {
+        if (hasFile(files, lockFile)) {
+            result.packageManagers.push(managerName);
+        }
+    }
+}
+/**
+ * 从 requirements.txt 中检测 Python 框架。
+ */
+async function detectFromRequirementsTxt(rootPath, result) {
+    const content = await safeReadFile(path.join(rootPath, 'requirements.txt'));
+    if (!content)
+        return;
+    result.configFiles.push('requirements.txt');
+    const lower = content.toLowerCase();
+    for (const [keyword, frameworkName] of Object.entries(PYTHON_FRAMEWORK_MAP)) {
+        if (lower.includes(keyword)) {
+            result.frameworks.push(frameworkName);
+        }
+    }
+}
+/**
+ * 从 pyproject.toml 中检测 Python 框架。
+ */
+async function detectFromPyprojectToml(rootPath, result) {
+    const content = await safeReadFile(path.join(rootPath, 'pyproject.toml'));
+    if (!content)
+        return;
+    result.configFiles.push('pyproject.toml');
+    const lower = content.toLowerCase();
+    for (const [keyword, frameworkName] of Object.entries(PYTHON_FRAMEWORK_MAP)) {
+        if (lower.includes(keyword)) {
+            result.frameworks.push(frameworkName);
+        }
+    }
+}
+/**
+ * 从 docker-compose 配置中检测数据库和服务。
+ * 同时检测 docker-compose.yml 和 docker-compose.yaml 两种命名。
+ */
+async function detectFromDockerCompose(rootPath, result) {
+    const candidates = ['docker-compose.yml', 'docker-compose.yaml'];
+    for (const fileName of candidates) {
+        const content = await safeReadFile(path.join(rootPath, fileName));
+        if (!content)
+            continue;
+        result.configFiles.push(fileName);
+        const lower = content.toLowerCase();
+        for (const [keyword, info] of Object.entries(DOCKER_SERVICE_MAP)) {
+            if (lower.includes(keyword)) {
+                if (info.kind === 'database') {
+                    result.databases.push(info.name);
+                }
+                else {
+                    result.services.push(info.name);
+                }
+            }
+        }
+    }
+}
+/**
+ * 通过 Cargo.toml / go.mod 检测 Rust / Go 语言。
+ */
+async function detectFromLanguageManifests(rootPath, result) {
+    const cargoContent = await safeReadFile(path.join(rootPath, 'Cargo.toml'));
+    if (cargoContent) {
+        result.languages.push('Rust');
+        result.configFiles.push('Cargo.toml');
+    }
+    const goModContent = await safeReadFile(path.join(rootPath, 'go.mod'));
+    if (goModContent) {
+        result.languages.push('Go');
+        result.configFiles.push('go.mod');
+    }
+}
+/**
+ * 根据文件扩展名分布统计语言，仅报告文件数超过阈值的语言。
+ */
+function detectLanguagesFromExtensions(files, result) {
+    const counts = new Map();
+    for (const file of files) {
+        if (file.nodeType !== 'file')
+            continue;
+        const ext = path.extname(file.relativePath).toLowerCase();
+        const lang = EXTENSION_LANGUAGE_MAP[ext];
+        if (lang) {
+            counts.set(lang, (counts.get(lang) ?? 0) + 1);
+        }
+    }
+    for (const [lang, count] of counts) {
+        if (count >= LANGUAGE_FILE_THRESHOLD) {
+            result.languages.push(lang);
+        }
+    }
+}
+/**
+ * 根据目录结构模式检测架构特征（Agent 架构、Workflow 编排等）。
+ */
+function detectDirectoryPatterns(files, result) {
+    // Agent 架构：app/agents 或 agents/
+    if (hasDirectory(files, 'app/agents/') || hasDirectory(files, 'agents/')) {
+        result.frameworks.push('Agent Architecture');
+    }
+    // Workflow 编排：workflows/
+    if (hasDirectory(files, 'workflows/')) {
+        result.frameworks.push('Workflow Orchestration');
+    }
+}
+// ---------------------------------------------------------------------------
+// 主入口
+// ---------------------------------------------------------------------------
+/**
+ * 检测项目技术栈。
+ *
+ * 通过读取配置文件内容和分析文件扩展名分布，自动识别项目使用的
+ * 编程语言、框架、包管理器、数据库和服务。
+ *
+ * @param rootPath 项目根目录的绝对路径
+ * @param files    FileScanner 输出的文件节点列表
+ * @returns 技术栈检测结果
+ *
+ * @example
+ * ```ts
+ * const result = await detectTechStack('/path/to/project', files);
+ * console.log(result.frameworks); // ['Next.js', 'FastAPI']
+ * ```
+ */
+export async function detectTechStack(rootPath, files) {
+    const result = {
+        languages: [],
+        frameworks: [],
+        packageManagers: [],
+        databases: [],
+        services: [],
+        configFiles: [],
+    };
+    // 并行执行所有检测子流程
+    await Promise.all([
+        detectFromPackageJson(rootPath, files, result),
+        detectFromRequirementsTxt(rootPath, result),
+        detectFromPyprojectToml(rootPath, result),
+        detectFromDockerCompose(rootPath, result),
+        detectFromLanguageManifests(rootPath, result),
+    ]);
+    // 基于文件扩展名统计语言（同步操作）
+    detectLanguagesFromExtensions(files, result);
+    // 目录模式检测（同步操作）
+    detectDirectoryPatterns(files, result);
+    // 去重
+    result.languages = unique(result.languages);
+    result.frameworks = unique(result.frameworks);
+    result.packageManagers = unique(result.packageManagers);
+    result.databases = unique(result.databases);
+    result.services = unique(result.services);
+    result.configFiles = unique(result.configFiles);
+    return result;
+}
+//# sourceMappingURL=tech-stack-detector.js.map

package/dist/detector/tech-stack-detector.js.map

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

package/dist/generator/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * generator 模块入口
+ * 负责将静态分析结果组装、排版为符合规范的 Markdown 格式 Wiki 文档，并生成 Mermaid 关系图表。
+ */
+export { generateTable, formatSourceRef, formatSectionSource, formatDiagramSource, formatCiteBlock, formatToc, formatFileTable, wrapMermaid, formatTroubleshootingTable, assembleWikiPage, } from './markdown-generator.js';
+export { generateArchitectureDiagram, generateERDiagram, generateDependencyDiagram, generateApiDiagram, generateTechStackDiagram, } from './mermaid-generator.js';
+export { generateSidebar, generateHome, } from './sidebar-generator.js';
+export { WikiGenerator, type WikiGeneratorConfig, type PlannedPage, } from './wiki-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,eAAe,EACf,WAAW,EACX,0BAA0B,EAC1B,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACH,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,eAAe,EACf,YAAY,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/generator/index.js

@@ -0,0 +1,9 @@
+/**
+ * generator 模块入口
+ * 负责将静态分析结果组装、排版为符合规范的 Markdown 格式 Wiki 文档，并生成 Mermaid 关系图表。
+ */
+export { generateTable, formatSourceRef, formatSectionSource, formatDiagramSource, formatCiteBlock, formatToc, formatFileTable, wrapMermaid, formatTroubleshootingTable, assembleWikiPage, } from './markdown-generator.js';
+export { generateArchitectureDiagram, generateERDiagram, generateDependencyDiagram, generateApiDiagram, generateTechStackDiagram, } from './mermaid-generator.js';
+export { generateSidebar, generateHome, } from './sidebar-generator.js';
+export { WikiGenerator, } from './wiki-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,eAAe,EACf,WAAW,EACX,0BAA0B,EAC1B,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACH,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,eAAe,EACf,YAAY,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,aAAa,GAGhB,MAAM,qBAAqB,CAAC"}

package/dist/generator/markdown-generator.d.ts

@@ -0,0 +1,71 @@
+import { type SourceReference } from '../models/index.js';
+/**
+ * Markdown 文档生成工具集
+ * 提供格式化表格、源码引用链接、页面结构等工具函数
+ */
+/**
+ * 生成 Markdown 表格
+ */
+export declare function generateTable(headers: string[], rows: string[][]): string;
+/**
+ * 生成源码引用链接
+ * 格式: [file.py:1-50](file://project/path/to/file.py#L1-L50)
+ */
+export declare function formatSourceRef(ref: SourceReference, projectRoot: string): string;
+/**
+ * 生成源码引用块（章节来源）
+ */
+export declare function formatSectionSource(refs: SourceReference[], projectRoot: string): string;
+/**
+ * 生成图表来源引用
+ */
+export declare function formatDiagramSource(refs: SourceReference[], projectRoot: string): string;
+/**
+ * 生成 <cite> 引用块，列出所有被引用的源码文件
+ */
+export declare function formatCiteBlock(refs: SourceReference[], projectRoot: string): string;
+/**
+ * 生成目录（Table of Contents）
+ */
+export declare function formatToc(headings: string[]): string;
+/**
+ * 生成文件列表表格
+ */
+export declare function formatFileTable(files: Array<{
+    path: string;
+    description: string;
+}>): string;
+/**
+ * 包裹 Mermaid 代码块
+ */
+export declare function wrapMermaid(code: string): string;
+/**
+ * 生成故障排查表格
+ */
+export declare function formatTroubleshootingTable(issues: Array<{
+    problem: string;
+    cause: string;
+    resolution: string;
+}>): string;
+/**
+ * 组装完整的 Wiki 页面
+ * 将各部分内容按照标准模板结构拼装
+ */
+export declare function assembleWikiPage(sections: {
+    title: string;
+    citeRefs: SourceReference[];
+    projectRoot: string;
+    introduction: string;
+    projectStructure?: string;
+    projectStructureDiagram?: string;
+    coreComponents?: string;
+    architectureOverview?: string;
+    architectureDiagram?: string;
+    detailedAnalysis?: string;
+    dependencyAnalysis?: string;
+    dependencyDiagram?: string;
+    troubleshooting?: string;
+    conclusion?: string;
+    appendix?: string;
+}): string;
+//# sourceMappingURL=markdown-generator.d.ts.map

package/dist/generator/markdown-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-generator.d.ts","sourceRoot":"","sources":["../../src/generator/markdown-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAQzE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,GACpB,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAUxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAUxF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAkBpF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAOpD;AAcD;;GAEG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACtE,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAmHT"}