repowiki-core 0.1.0

package/dist/models/analysis-types.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+// ============================================================================
+// ModuleInfo — 模块聚类分析结果
+// ============================================================================
+/**
+ * 核心组件 Schema
+ * 描述某模块中的关键类、函数或子系统。
+ */
+export const CoreComponentSchema = z.object({
+    /** 组件名称（类名、函数名或子系统名） */
+    name: z.string().describe('核心组件名称'),
+    /** 组件的作用描述 */
+    description: z.string().describe('用途和调用逻辑'),
+});
+/**
+ * 模块信息 Schema
+ * 描述由 ModuleAnalyzer 聚类生成的逻辑模块。
+ */
+export const ModuleInfoSchema = z.object({
+    /** 模块名称（如 api, web, components） */
+    moduleName: z.string().describe('模块名称'),
+    /** 模块所在的目录相对路径 */
+    directory: z.string().describe('目录相对路径'),
+    /** 模块内包含的文件相对路径列表 */
+    files: z.array(z.string()).default([]).describe('文件相对路径列表'),
+    /** 模块职责描述 */
+    summary: z.string().default('').describe('模块职责描述'),
+    /** 模块分类标签 */
+    category: z.string().default('').describe('分类标签'),
+    /** 核心组件列表 */
+    coreComponents: z.array(CoreComponentSchema).default([]).describe('核心组件'),
+});
+// ============================================================================
+// ApiRoute — API 路由分析结果
+// ============================================================================
+/**
+ * API 路由 Schema
+ * 描述从源码中提取的单个 HTTP 路由定义。
+ */
+export const ApiRouteSchema = z.object({
+    /** HTTP 方法（GET, POST, PUT, DELETE, PATCH） */
+    method: z.string().describe('HTTP 方法'),
+    /** 路由路径 */
+    path: z.string().describe('路由路径'),
+    /** 处理函数名称 */
+    handler: z.string().default('').describe('处理函数名称'),
+    /** 所在文件的相对路径 */
+    filePath: z.string().describe('文件相对路径'),
+    /** 路由定义所在的行号 */
+    lineNumber: z.number().default(0).describe('行号'),
+    /** 检测到的框架类型 */
+    framework: z.string().default('').describe('框架类型'),
+});
+// ============================================================================
+// DatabaseModel — 数据库模型分析结果
+// ============================================================================
+/**
+ * 数据库字段 Schema
+ */
+export const DatabaseFieldSchema = z.object({
+    /** 字段名称 */
+    name: z.string().describe('字段名称'),
+    /** 字段类型 */
+    type: z.string().describe('字段类型'),
+    /** 是否可空 */
+    nullable: z.boolean().default(false).describe('是否可空'),
+});
+/**
+ * 数据库关系 Schema
+ */
+export const DatabaseRelationSchema = z.object({
+    /** 关系字段名 */
+    fieldName: z.string().describe('关系字段名'),
+    /** 关联的模型名 */
+    relatedModel: z.string().describe('关联模型'),
+    /** 关系类型（OneToMany, ManyToOne 等） */
+    relationType: z.string().default('').describe('关系类型'),
+});
+/**
+ * 数据库模型 Schema
+ * 描述从 ORM 定义中提取的数据模型。
+ */
+export const DatabaseModelSchema = z.object({
+    /** 模型名称 */
+    name: z.string().describe('模型名称'),
+    /** 所在文件相对路径 */
+    filePath: z.string().describe('文件相对路径'),
+    /** 检测到的 ORM 类型 */
+    orm: z.string().default('').describe('ORM 类型'),
+    /** 字段列表 */
+    fields: z.array(DatabaseFieldSchema).default([]).describe('字段列表'),
+    /** 关系列表 */
+    relations: z.array(DatabaseRelationSchema).default([]).describe('关系列表'),
+});
+//# sourceMappingURL=analysis-types.js.map

package/dist/models/analysis-types.js.map

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

package/dist/models/file-reference.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+/**
+ * 文件节点 Schema
+ * 表示扫描到的单个文件或目录。
+ */
+export declare const FileNodeSchema: z.ZodObject<{
+    /** 文件的绝对路径 */
+    path: z.ZodString;
+    /** 相对于项目根目录的路径 */
+    relativePath: z.ZodString;
+    /** 节点类型 */
+    nodeType: z.ZodEnum<["file", "directory"]>;
+    /** 文件大小 (字节) */
+    sizeBytes: z.ZodNumber;
+    /** 检测到的编程语言 */
+    language: z.ZodOptional<z.ZodString>;
+    /** 非空代码行数 */
+    lineCount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    relativePath: string;
+    nodeType: "file" | "directory";
+    sizeBytes: number;
+    language?: string | undefined;
+    lineCount?: number | undefined;
+}, {
+    path: string;
+    relativePath: string;
+    nodeType: "file" | "directory";
+    sizeBytes: number;
+    language?: string | undefined;
+    lineCount?: number | undefined;
+}>;
+/** 文件节点类型 */
+export type FileNode = z.infer<typeof FileNodeSchema>;
+/**
+ * 源码引用 Schema
+ * 指向特定代码片段的行范围，用于 Wiki 页面追溯。
+ */
+export declare const SourceReferenceSchema: z.ZodObject<{
+    /** 相对文件路径 */
+    filePath: z.ZodString;
+    /** 开始行号 */
+    startLine: z.ZodNumber;
+    /** 结束行号 */
+    endLine: z.ZodNumber;
+    /** 引用说明 */
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    reason: string;
+}, {
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    reason: string;
+}>;
+/** 源码引用类型 */
+export type SourceReference = z.infer<typeof SourceReferenceSchema>;
+//# sourceMappingURL=file-reference.d.ts.map

package/dist/models/file-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reference.d.ts","sourceRoot":"","sources":["../../src/models/file-reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,cAAc;IACvB,cAAc;;IAEd,kBAAkB;;IAElB,WAAW;;IAEX,gBAAgB;;IAEhB,eAAe;;IAEf,aAAa;;;;;;;;;;;;;;;;EAEf,CAAC;AAEH,aAAa;AACb,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAC9B,aAAa;;IAEb,WAAW;;IAEX,WAAW;;IAEX,WAAW;;;;;;;;;;;;EAEb,CAAC;AAEH,aAAa;AACb,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/models/file-reference.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * 文件节点 Schema
+ * 表示扫描到的单个文件或目录。
+ */
+export const FileNodeSchema = z.object({
+    /** 文件的绝对路径 */
+    path: z.string().describe('文件的绝对路径'),
+    /** 相对于项目根目录的路径 */
+    relativePath: z.string().describe('相对于项目根目录的路径'),
+    /** 节点类型 */
+    nodeType: z.enum(['file', 'directory']).describe('节点类型'),
+    /** 文件大小 (字节) */
+    sizeBytes: z.number().describe('文件大小'),
+    /** 检测到的编程语言 */
+    language: z.string().optional().describe('语言类型'),
+    /** 非空代码行数 */
+    lineCount: z.number().optional().describe('非空代码行数'),
+});
+/**
+ * 源码引用 Schema
+ * 指向特定代码片段的行范围，用于 Wiki 页面追溯。
+ */
+export const SourceReferenceSchema = z.object({
+    /** 相对文件路径 */
+    filePath: z.string().describe('相对文件路径'),
+    /** 开始行号 */
+    startLine: z.number().describe('开始行'),
+    /** 结束行号 */
+    endLine: z.number().describe('结束行'),
+    /** 引用说明 */
+    reason: z.string().describe('引用说明'),
+});
+//# sourceMappingURL=file-reference.js.map

package/dist/models/file-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reference.js","sourceRoot":"","sources":["../../src/models/file-reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,cAAc;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;IACpC,kBAAkB;IAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IAChD,WAAW;IACX,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxD,gBAAgB;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;IACtC,eAAe;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;IAChD,aAAa;IACb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;CACtD,CAAC,CAAC;AAKH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,aAAa;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACvC,WAAW;IACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;IACrC,WAAW;IACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;IACnC,WAAW;IACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;CACtC,CAAC,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * models 模块入口
+ * 统一导出所有数据模型 Schema 及类型定义。
+ */
+export { FileNodeSchema, type FileNode, SourceReferenceSchema, type SourceReference, } from './file-reference.js';
+export { ProjectProfileSchema, type ProjectProfile, } from './project-profile.js';
+export { CoreComponentSchema, type CoreComponent, ModuleInfoSchema, type ModuleInfo, ApiRouteSchema, type ApiRoute, DatabaseFieldSchema, type DatabaseField, DatabaseRelationSchema, type DatabaseRelation, DatabaseModelSchema, type DatabaseModel, } from './analysis-types.js';
+export { WikiPageSchema, type WikiPage, } from './wiki-page.js';
+export { DependencyEdgeSchema, DependencyGraphSchema, AnalysisResultSchema, type AnalysisResult, } from './analysis-result.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,cAAc,EACd,KAAK,QAAQ,EACb,qBAAqB,EACrB,KAAK,eAAe,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,oBAAoB,EACpB,KAAK,cAAc,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,mBAAmB,EACnB,KAAK,aAAa,EAClB,gBAAgB,EAChB,KAAK,UAAU,EACf,cAAc,EACd,KAAK,QAAQ,EACb,mBAAmB,EACnB,KAAK,aAAa,EAClB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,KAAK,aAAa,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,cAAc,EACd,KAAK,QAAQ,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,cAAc,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,10 @@
+/**
+ * models 模块入口
+ * 统一导出所有数据模型 Schema 及类型定义。
+ */
+export { FileNodeSchema, SourceReferenceSchema, } from './file-reference.js';
+export { ProjectProfileSchema, } from './project-profile.js';
+export { CoreComponentSchema, ModuleInfoSchema, ApiRouteSchema, DatabaseFieldSchema, DatabaseRelationSchema, DatabaseModelSchema, } from './analysis-types.js';
+export { WikiPageSchema, } from './wiki-page.js';
+export { DependencyEdgeSchema, DependencyGraphSchema, AnalysisResultSchema, } from './analysis-result.js';
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,cAAc,EAEd,qBAAqB,GAExB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,oBAAoB,GAEvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,mBAAmB,EAEnB,gBAAgB,EAEhB,cAAc,EAEd,mBAAmB,EAEnB,sBAAsB,EAEtB,mBAAmB,GAEtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,cAAc,GAEjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GAEvB,MAAM,sBAAsB,CAAC"}

package/dist/models/project-profile.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+/**
+ * 项目概要 Schema
+ * 描述被分析项目的基本元信息，包括技术栈、入口点和配置文件等。
+ */
+export declare const ProjectProfileSchema: z.ZodObject<{
+    /** 项目名称 */
+    name: z.ZodString;
+    /** 项目根目录的绝对路径 */
+    rootPath: z.ZodString;
+    /** 使用的主力编程语言 */
+    languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** 推断出的框架信息 */
+    frameworks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** 检测到的包管理器 */
+    packageManagers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** 使用的数据库 */
+    databases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** 接入的外部服务 */
+    services: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** 入口文件列表 */
+    entrypoints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** 配置文件列表 */
+    configFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    rootPath: string;
+    languages: string[];
+    frameworks: string[];
+    packageManagers: string[];
+    databases: string[];
+    services: string[];
+    entrypoints: string[];
+    configFiles: string[];
+}, {
+    name: string;
+    rootPath: string;
+    languages?: string[] | undefined;
+    frameworks?: string[] | undefined;
+    packageManagers?: string[] | undefined;
+    databases?: string[] | undefined;
+    services?: string[] | undefined;
+    entrypoints?: string[] | undefined;
+    configFiles?: string[] | undefined;
+}>;
+/** 项目概要类型 */
+export type ProjectProfile = z.infer<typeof ProjectProfileSchema>;
+//# sourceMappingURL=project-profile.d.ts.map

package/dist/models/project-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-profile.d.ts","sourceRoot":"","sources":["../../src/models/project-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC7B,WAAW;;IAEX,iBAAiB;;IAEjB,gBAAgB;;IAEhB,eAAe;;IAEf,eAAe;;IAEf,aAAa;;IAEb,cAAc;;IAEd,aAAa;;IAEb,aAAa;;;;;;;;;;;;;;;;;;;;;;EAEf,CAAC;AAEH,aAAa;AACb,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/models/project-profile.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+/**
+ * 项目概要 Schema
+ * 描述被分析项目的基本元信息，包括技术栈、入口点和配置文件等。
+ */
+export const ProjectProfileSchema = z.object({
+    /** 项目名称 */
+    name: z.string().describe('项目名称'),
+    /** 项目根目录的绝对路径 */
+    rootPath: z.string().describe('绝对路径'),
+    /** 使用的主力编程语言 */
+    languages: z.array(z.string()).default([]).describe('使用的主力语言'),
+    /** 推断出的框架信息 */
+    frameworks: z.array(z.string()).default([]).describe('框架推断结果'),
+    /** 检测到的包管理器 */
+    packageManagers: z.array(z.string()).default([]).describe('包管理器'),
+    /** 使用的数据库 */
+    databases: z.array(z.string()).default([]).describe('数据库'),
+    /** 接入的外部服务 */
+    services: z.array(z.string()).default([]).describe('外部服务'),
+    /** 入口文件列表 */
+    entrypoints: z.array(z.string()).default([]).describe('入口点'),
+    /** 配置文件列表 */
+    configFiles: z.array(z.string()).default([]).describe('配置文件'),
+});
+//# sourceMappingURL=project-profile.js.map

package/dist/models/project-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-profile.js","sourceRoot":"","sources":["../../src/models/project-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,WAAW;IACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;IACjC,iBAAiB;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;IACrC,gBAAgB;IAChB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC9D,eAAe;IACf,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC9D,eAAe;IACf,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IACjE,aAAa;IACb,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC1D,cAAc;IACd,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1D,aAAa;IACb,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC5D,aAAa;IACb,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;CAChE,CAAC,CAAC"}

package/dist/models/wiki-page.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+/**
+ * Wiki 页面 Schema
+ * 表示一篇生成的 Wiki 文档。
+ */
+export declare const WikiPageSchema: z.ZodObject<{
+    /** 页面标题 */
+    title: z.ZodString;
+    /** docs/wiki/ 下的相对文件名 */
+    filename: z.ZodString;
+    /** 页面摘要 */
+    summary: z.ZodString;
+    /** 最终渲染的 Markdown 正文 */
+    content: z.ZodString;
+    /** 引用的源码片段 */
+    sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        filePath: z.ZodString;
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        filePath: string;
+        startLine: number;
+        endLine: number;
+        reason: string;
+    }, {
+        filePath: string;
+        startLine: number;
+        endLine: number;
+        reason: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    title: string;
+    filename: string;
+    content: string;
+    sourceRefs: {
+        filePath: string;
+        startLine: number;
+        endLine: number;
+        reason: string;
+    }[];
+}, {
+    summary: string;
+    title: string;
+    filename: string;
+    content: string;
+    sourceRefs?: {
+        filePath: string;
+        startLine: number;
+        endLine: number;
+        reason: string;
+    }[] | undefined;
+}>;
+/** Wiki 页面类型 */
+export type WikiPage = z.infer<typeof WikiPageSchema>;
+//# sourceMappingURL=wiki-page.d.ts.map

package/dist/models/wiki-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-page.d.ts","sourceRoot":"","sources":["../../src/models/wiki-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,eAAO,MAAM,cAAc;IACvB,WAAW;;IAEX,yBAAyB;;IAEzB,WAAW;;IAEX,wBAAwB;;IAExB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhB,CAAC;AAEH,gBAAgB;AAChB,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/models/wiki-page.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { SourceReferenceSchema } from './file-reference.js';
+/**
+ * Wiki 页面 Schema
+ * 表示一篇生成的 Wiki 文档。
+ */
+export const WikiPageSchema = z.object({
+    /** 页面标题 */
+    title: z.string().describe('标题'),
+    /** docs/wiki/ 下的相对文件名 */
+    filename: z.string().describe('docs/wiki/ 下的相对路径'),
+    /** 页面摘要 */
+    summary: z.string().describe('简述'),
+    /** 最终渲染的 Markdown 正文 */
+    content: z.string().describe('最终 Markdown 文本'),
+    /** 引用的源码片段 */
+    sourceRefs: z.array(SourceReferenceSchema).default([]),
+});
+//# sourceMappingURL=wiki-page.js.map

package/dist/models/wiki-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-page.js","sourceRoot":"","sources":["../../src/models/wiki-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,WAAW;IACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;IAChC,yBAAyB;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAClD,WAAW;IACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;IAClC,wBAAwB;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC9C,cAAc;IACd,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACzD,CAAC,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,30 @@
+import type { AnalysisResult } from './models/index.js';
+export interface PipelineOptions {
+    workspacePath: string;
+    outputDir?: string;
+    modelName?: string;
+    concurrency?: number;
+    skipLlm?: boolean;
+    onProgress?: (event: PipelineEvent) => void;
+}
+export type PipelineEvent = {
+    type: 'PROGRESS';
+    stage: string;
+    progress: number;
+    message: string;
+} | {
+    type: 'DONE';
+    payload: {
+        docsPath: string;
+        pagesCount: number;
+    };
+} | {
+    type: 'ERROR';
+    code: number;
+    message: string;
+};
+/**
+ * 运行核心 Wiki 生成 Pipeline
+ */
+export declare function runPipeline(options: PipelineOptions): Promise<AnalysisResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,mBAAmB,CAAC;AAElF,MAAM,WAAW,eAAe;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA+LnF"}

package/dist/pipeline.js

@@ -0,0 +1,159 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { loadLLMConfig, LLMClient, validateConfig } from './llm/index.js';
+import { scanDirectory } from './scanner/index.js';
+import { buildTreeString } from './scanner/tree-builder.js';
+import { detectTechStack, detectEntrypoints, buildDependencyGraph } from './detector/index.js';
+import { analyzeModules, analyzeApiRoutes, analyzeDatabaseModels, analyzeConfigs, analyzeWorkflows, } from './analyzer/index.js';
+import { WikiGenerator, generateHome, generateSidebar } from './generator/index.js';
+/**
+ * 运行核心 Wiki 生成 Pipeline
+ */
+export async function runPipeline(options) {
+    const { workspacePath, outputDir = path.join(workspacePath, 'docs', 'wiki'), modelName, concurrency = 3, skipLlm = false, onProgress, } = options;
+    const emitProgress = (stage, progress, message) => {
+        if (onProgress) {
+            onProgress({ type: 'PROGRESS', stage, progress, message });
+        }
+        else {
+            // CLI 后台或未提供回调时输出规范的 JSONL 格式进程通知
+            console.log(JSON.stringify({ type: 'PROGRESS', stage, progress, message }));
+        }
+    };
+    try {
+        // ====================================================================
+        // 1. Pre-flight 阶段
+        // ====================================================================
+        emitProgress('Pre-flight', 5, '初始化环境与认证配置...');
+        let llmClient = null;
+        if (!skipLlm) {
+            const llmConfig = await loadLLMConfig(workspacePath);
+            if (modelName) {
+                llmConfig.modelName = modelName;
+            }
+            const validationErrors = validateConfig(llmConfig);
+            if (validationErrors.length > 0) {
+                // 如果 API Key 缺失，回退到免大模型模式
+                emitProgress('Pre-flight', 8, `未提供 API 凭证，切换至免大模型快速生成模式...`);
+            }
+            else {
+                llmClient = new LLMClient({ config: llmConfig });
+                emitProgress('Pre-flight', 10, `成功加载 LLM 接口，使用模型: ${llmConfig.modelName}`);
+            }
+        }
+        else {
+            emitProgress('Pre-flight', 10, '已开启免大模型（skip-llm）生成模式...');
+        }
+        // 确保输出目录存在
+        await fs.mkdir(outputDir, { recursive: true });
+        // ====================================================================
+        // 2. Scan Phase 阶段
+        // ====================================================================
+        emitProgress('Scanning', 15, '扫描项目文件结构中...');
+        const files = await scanDirectory(workspacePath);
+        emitProgress('Scanning', 25, `扫描完成，发现 ${files.length} 个非忽略文件。构建目录树...`);
+        const treeStr = buildTreeString(files, workspacePath);
+        emitProgress('Scanning', 30, '识别项目技术栈与框架特征...');
+        const techStackResult = await detectTechStack(workspacePath, files);
+        const projectProfile = {
+            name: path.basename(workspacePath) || 'unnamed-project',
+            rootPath: workspacePath,
+            languages: techStackResult.languages,
+            frameworks: techStackResult.frameworks,
+            packageManagers: techStackResult.packageManagers,
+            databases: techStackResult.databases,
+            services: techStackResult.services,
+            entrypoints: [],
+            configFiles: techStackResult.configFiles,
+        };
+        // ====================================================================
+        // 3. Analysis Phase 阶段
+        // ====================================================================
+        emitProgress('Analysis', 40, '分析项目入口及内部模块依赖图...');
+        const entrypoints = await detectEntrypoints(workspacePath, files);
+        projectProfile.entrypoints = entrypoints;
+        const dependencyGraph = await buildDependencyGraph(workspacePath, files);
+        emitProgress('Analysis', 50, '对模块结构聚类分析...');
+        const modules = await analyzeModules(workspacePath, files, llmClient);
+        emitProgress('Analysis', 60, '提取 API 路由及数据库模型定义...');
+        const apiRoutes = await analyzeApiRoutes(workspacePath, files);
+        const databaseModels = await analyzeDatabaseModels(workspacePath, files);
+        emitProgress('Analysis', 65, '分析 CI 流程、配置文件和 Agent 工作流...');
+        const configInfos = await analyzeConfigs(workspacePath, files);
+        const workflowInfos = await analyzeWorkflows(workspacePath, files);
+        const analysisResult = {
+            project: projectProfile,
+            tree: treeStr,
+            modules,
+            dependencies: dependencyGraph,
+            apiRoutes,
+            databaseModels,
+            wikiPages: [],
+        };
+        // ====================================================================
+        // 4. Planning Phase 阶段
+        // ====================================================================
+        emitProgress('Planning', 70, '制定 Wiki 页面规划方案...');
+        const generator = new WikiGenerator(llmClient, { outputDir, concurrency });
+        const plannedPages = await generator.planPages(analysisResult);
+        emitProgress('Planning', 75, `规划完成，共需要生成 ${plannedPages.length} 个 Wiki 页面。`);
+        // ====================================================================
+        // 5. Render Phase 阶段
+        // ====================================================================
+        const generatedPages = [];
+        // 构建快速交叉引用索引
+        const getExistingPagesSummary = () => {
+            return generatedPages.map((p) => `- ${p.title} (${p.filename})`).join('\n');
+        };
+        let currentProgress = 75;
+        const progressStep = (95 - 75) / Math.max(plannedPages.length, 1);
+        for (let i = 0; i < plannedPages.length; i++) {
+            const page = plannedPages[i];
+            currentProgress += progressStep;
+            emitProgress('LLM Inference', Math.round(currentProgress), `正在生成 (${i + 1}/${plannedPages.length}): ${page.title}...`);
+            const wikiPage = await generator.generatePage(workspacePath, page, analysisResult, getExistingPagesSummary());
+            await generator.savePage(wikiPage);
+            generatedPages.push(wikiPage);
+        }
+        // ====================================================================
+        // 6. Post-flight 阶段
+        // ====================================================================
+        emitProgress('Post-flight', 96, '生成 Wiki 导航与侧边栏 _Sidebar.md...');
+        const sidebarContent = generateSidebar(generatedPages);
+        const homeContent = generateHome(generatedPages, projectProfile);
+        await fs.writeFile(path.join(outputDir, '_Sidebar.md'), sidebarContent, 'utf-8');
+        await fs.writeFile(path.join(outputDir, 'Home.md'), homeContent, 'utf-8');
+        // 将新页追加到分析结果中
+        analysisResult.wikiPages = generatedPages;
+        emitProgress('Post-flight', 100, '所有 Wiki 文档生成完成！');
+        const doneEvent = {
+            type: 'DONE',
+            payload: {
+                docsPath: path.resolve(outputDir),
+                pagesCount: generatedPages.length + 2, // 包含 Home.md, _Sidebar.md
+            },
+        };
+        if (onProgress) {
+            onProgress(doneEvent);
+        }
+        else {
+            console.log(JSON.stringify(doneEvent));
+        }
+        return analysisResult;
+    }
+    catch (err) {
+        const errorEvent = {
+            type: 'ERROR',
+            code: 500,
+            message: err?.message || String(err),
+        };
+        if (onProgress) {
+            onProgress(errorEvent);
+        }
+        else {
+            console.log(JSON.stringify(errorEvent));
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/scanner/file-scanner.d.ts

@@ -0,0 +1,27 @@
+import type { FileNode } from '../models/file-reference.js';
+/**
+ * 文件扫描器配置项。
+ */
+export interface ScannerConfig {
+    /** 最大递归深度 (默认 5) */
+    maxDepth: number;
+    /** 额外忽略模式 (glob) */
+    ignorePatterns: string[];
+    /** 仅包含指定扩展名 (不含前导点)。为空时包含所有文件 */
+    includeExtensions: string[];
+}
+/**
+ * 递归扫描项目目录，返回扁平的 {@link FileNode} 列表。
+ *
+ * @param rootPath  - 项目根目录的绝对路径
+ * @param config    - 可选配置，覆盖默认值
+ * @returns 排序后的 FileNode 列表 (按相对路径字母序)
+ *
+ * @example
+ * ```ts
+ * const files = await scanDirectory('/path/to/project');
+ * console.log(files.length);
+ * ```
+ */
+export declare function scanDirectory(rootPath: string, config?: Partial<ScannerConfig>): Promise<FileNode[]>;
+//# sourceMappingURL=file-scanner.d.ts.map