spectra-cli 4.1.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-generator.d.ts","sourceRoot":"","sources":["../../src/generator/index-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,iBAAiB,EAKlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAc,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAkGD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,mBAAmB,EAAE,EAC5B,KAAK,EAAE,eAAe,EACtB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC7C,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,iBAAiB,CA2CnB"}

package/dist/generator/index-generator.js

@@ -0,0 +1,129 @@
+import { getSpectraVersionString } from './frontmatter.js';
+/**
+ * 从依赖图识别横切关注点（被多个模块依赖的共享模块）
+ */
+function identifyCrossCuttingConcerns(graph) {
+    const concerns = [];
+    for (const node of graph.modules) {
+        // 入度 >= 3 的模块视为横切关注点
+        if (node.inDegree >= 3) {
+            concerns.push(`${node.source} — 被 ${node.inDegree} 个模块依赖`);
+        }
+    }
+    return concerns;
+}
+/**
+ * 从 ModuleSpec 列表构建模块映射表
+ */
+function buildModuleMap(specs, graph) {
+    return specs.map((spec) => {
+        // 从依赖图中查找该模块的层级和依赖
+        const node = graph.modules.find((n) => spec.frontmatter.sourceTarget.includes(n.source));
+        const edges = graph.edges.filter((e) => spec.frontmatter.sourceTarget.includes(e.from));
+        return {
+            name: spec.frontmatter.sourceTarget,
+            specPath: spec.outputPath,
+            description: resolveIntentSummary(spec).slice(0, 100),
+            level: node?.level ?? 0,
+            dependencies: edges.map((e) => e.to),
+        };
+    });
+}
+/**
+ * 构建语言分布信息
+ *
+ * @param languageStats - 完整扫描的语言统计
+ * @param specs - 所有已生成的 ModuleSpec
+ * @param processedLanguages - 本次实际处理的语言 ID 列表
+ * @returns LanguageDistribution 数组（按文件数降序），或 undefined（单语言）
+ */
+function buildLanguageDistribution(languageStats, specs, processedLanguages) {
+    // 单语言项目不展示语言分布（FR-008）
+    if (languageStats.size <= 1) {
+        return undefined;
+    }
+    const totalFiles = Array.from(languageStats.values())
+        .reduce((sum, s) => sum + s.fileCount, 0);
+    const distribution = Array.from(languageStats.entries()).map(([adapterId, stat]) => {
+        // 模块数：统计 specs 中 frontmatter.language === adapterId 的数量
+        const moduleCount = specs.filter((s) => s.frontmatter.language === adapterId).length;
+        // 占比：该语言文件数 / 总文件数 * 100，保留一位小数
+        const percentage = totalFiles > 0
+            ? Math.round(stat.fileCount / totalFiles * 1000) / 10
+            : 0;
+        // 是否本次处理
+        const processed = processedLanguages
+            ? processedLanguages.includes(adapterId)
+            : true;
+        return {
+            language: adapterId,
+            adapterId,
+            fileCount: stat.fileCount,
+            moduleCount,
+            percentage,
+            processed,
+        };
+    });
+    // 按文件数降序排列
+    distribution.sort((a, b) => b.fileCount - a.fileCount);
+    return distribution;
+}
+/**
+ * 生成项目级架构索引
+ *
+ * @param specs - 所有已生成的 ModuleSpec
+ * @param graph - 项目 DependencyGraph（或合并后的图）
+ * @param languageStats - 完整扫描的语言统计（可选）
+ * @param processedLanguages - 本次实际处理的语言列表（可选）
+ * @returns ArchitectureIndex
+ */
+export function generateIndex(specs, graph, languageStats, processedLanguages) {
+    const frontmatter = {
+        type: 'architecture-index',
+        version: 'v1',
+        generatedBy: getSpectraVersionString(),
+        projectRoot: graph.projectRoot,
+        totalModules: specs.length,
+        lastUpdated: new Date().toISOString(),
+    };
+    const moduleMap = buildModuleMap(specs, graph);
+    const crossCuttingConcerns = identifyCrossCuttingConcerns(graph);
+    // 从依赖图推断系统目的和架构模式
+    const systemPurpose = specs.length > 0
+        ? `本项目包含 ${specs.length} 个模块，涵盖 ${[...new Set(specs.map((s) => s.frontmatter.sourceTarget.split('/')[0]))].join('、')} 等功能域。`
+        : '待分析';
+    const architecturePattern = graph.sccs.filter((s) => s.modules.length > 1).length > 0
+        ? '存在循环依赖，建议关注 SCC 模块的解耦'
+        : '模块间依赖为有向无环图（DAG），层次清晰';
+    // 从 package.json 推断技术栈（此处用空数组，实际使用时由调用方填充）
+    const technologyStack = [];
+    // 构建语言分布信息（多语言项目时填充）
+    const languageDistribution = languageStats
+        ? buildLanguageDistribution(languageStats, specs, processedLanguages)
+        : undefined;
+    return {
+        frontmatter,
+        systemPurpose,
+        architecturePattern,
+        moduleMap,
+        crossCuttingConcerns,
+        technologyStack,
+        dependencyDiagram: graph.mermaidSource,
+        outputPath: 'specs/_index.spec.md',
+        languageDistribution,
+    };
+}
+function resolveIntentSummary(spec) {
+    const summary = spec.sections?.intent
+        ?.split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (summary) {
+        return summary;
+    }
+    if (spec.intentSummary?.trim()) {
+        return spec.intentSummary.trim();
+    }
+    return spec.frontmatter.sourceTarget;
+}
+//# sourceMappingURL=index-generator.js.map

package/dist/generator/index-generator.js.map

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

package/dist/generator/mermaid-class-diagram.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Mermaid 类图生成器
+ * 从 CodeSkeleton exports 生成 classDiagram 源码（FR-007）
+ * 参见 contracts/generator.md
+ */
+import type { CodeSkeleton } from '../models/code-skeleton.js';
+/**
+ * 从 CodeSkeleton 生成 Mermaid classDiagram 源码
+ *
+ * @param skeleton - AST 提取的 CodeSkeleton
+ * @returns Mermaid classDiagram 源码字符串
+ */
+export declare function generateClassDiagram(skeleton: CodeSkeleton): string;
+//# sourceMappingURL=mermaid-class-diagram.d.ts.map

package/dist/generator/mermaid-class-diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-class-diagram.d.ts","sourceRoot":"","sources":["../../src/generator/mermaid-class-diagram.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,4BAA4B,CAAC;AA6G7E;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAyBnE"}

package/dist/generator/mermaid-class-diagram.js

@@ -0,0 +1,115 @@
+/**
+ * 转义 Mermaid 中的特殊字符
+ */
+function escapeMermaid(str) {
+    return str.replace(/[<>{}()[\]|]/g, '');
+}
+/**
+ * 简化类型签名用于 Mermaid 显示
+ */
+function simplifyType(signature) {
+    // 移除 async、function 关键字等，保留核心签名
+    return signature
+        .replace(/^async\s+/, '')
+        .replace(/^function\s+/, '')
+        .replace(/^const\s+/, '')
+        .slice(0, 80);
+}
+/**
+ * 从 ExportSymbol 生成 Mermaid 类图条目
+ */
+function renderExport(exp) {
+    const lines = [];
+    if (exp.kind === 'class' || exp.kind === 'interface') {
+        lines.push(`  class ${escapeMermaid(exp.name)} {`);
+        // 添加 <<interface>> 构造型
+        if (exp.kind === 'interface') {
+            lines.push(`    <<interface>>`);
+        }
+        // 渲染成员
+        if (exp.members) {
+            for (const member of exp.members) {
+                // 跳过私有成员
+                if (member.visibility === 'private')
+                    continue;
+                const prefix = member.visibility === 'protected' ? '#' : '+';
+                const staticMark = member.isStatic ? '$' : '';
+                const abstractMark = member.isAbstract ? '*' : '';
+                if (member.kind === 'method' || member.kind === 'constructor') {
+                    lines.push(`    ${prefix}${escapeMermaid(member.signature)}${staticMark}${abstractMark}`);
+                }
+                else if (member.kind === 'property') {
+                    lines.push(`    ${prefix}${escapeMermaid(member.signature)}${staticMark}`);
+                }
+                else if (member.kind === 'getter' || member.kind === 'setter') {
+                    lines.push(`    ${prefix}${escapeMermaid(member.signature)}`);
+                }
+            }
+        }
+        lines.push('  }');
+    }
+    return lines;
+}
+/**
+ * 从签名中提取继承/实现关系
+ */
+function extractRelationships(exp) {
+    const relationships = [];
+    // 从签名中提取 extends
+    const extendsMatch = /extends\s+(\w+)/.exec(exp.signature);
+    if (extendsMatch?.[1]) {
+        relationships.push(`  ${extendsMatch[1]} <|-- ${exp.name}`);
+    }
+    // 从签名中提取 implements
+    const implMatch = /implements\s+(.+)$/.exec(exp.signature);
+    if (implMatch?.[1]) {
+        const interfaces = implMatch[1].split(',').map((s) => s.trim());
+        for (const iface of interfaces) {
+            const ifaceName = iface.split('<')[0].trim();
+            if (ifaceName) {
+                relationships.push(`  ${ifaceName} <|.. ${exp.name}`);
+            }
+        }
+    }
+    // 检查成员中的组合关系
+    if (exp.members) {
+        const seen = new Set();
+        for (const member of exp.members) {
+            if (member.kind === 'property') {
+                // 从类型中检测组合关系
+                const typeMatch = /:\s*(\w+)(?:\[\])?$/.exec(member.signature);
+                if (typeMatch?.[1] && /^[A-Z]/.test(typeMatch[1]) && !seen.has(typeMatch[1])) {
+                    seen.add(typeMatch[1]);
+                    relationships.push(`  ${exp.name} *-- ${typeMatch[1]}`);
+                }
+            }
+        }
+    }
+    return relationships;
+}
+/**
+ * 从 CodeSkeleton 生成 Mermaid classDiagram 源码
+ *
+ * @param skeleton - AST 提取的 CodeSkeleton
+ * @returns Mermaid classDiagram 源码字符串
+ */
+export function generateClassDiagram(skeleton) {
+    const classExports = skeleton.exports.filter((e) => e.kind === 'class' || e.kind === 'interface');
+    if (classExports.length === 0) {
+        return '';
+    }
+    const lines = ['classDiagram'];
+    const relationships = [];
+    for (const exp of classExports) {
+        lines.push(...renderExport(exp));
+        relationships.push(...extractRelationships(exp));
+    }
+    // 去重并添加关系
+    const uniqueRelationships = [...new Set(relationships)];
+    if (uniqueRelationships.length > 0) {
+        lines.push('');
+        lines.push(...uniqueRelationships);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=mermaid-class-diagram.js.map

package/dist/generator/mermaid-class-diagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-class-diagram.js","sourceRoot":"","sources":["../../src/generator/mermaid-class-diagram.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,SAAiB;IACrC,gCAAgC;IAChC,OAAO,SAAS;SACb,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAiB;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,WAAW,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnD,uBAAuB;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAClC,CAAC;QAED,OAAO;QACP,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjC,SAAS;gBACT,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;oBAAE,SAAS;gBAE9C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9C,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAElD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBAC9D,KAAK,CAAC,IAAI,CACR,OAAO,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,UAAU,GAAG,YAAY,EAAE,CAC9E,CAAC;gBACJ,CAAC;qBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACtC,KAAK,CAAC,IAAI,CACR,OAAO,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;qBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAChE,KAAK,CAAC,IAAI,CACR,OAAO,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAClD,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAiB;IAC7C,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,iBAAiB;IACjB,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,aAAa,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,SAAS,EAAE,CAAC;gBACd,aAAa,CAAC,IAAI,CAAC,KAAK,SAAS,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IAED,aAAa;IACb,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC/B,aAAa;gBACb,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC/D,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7E,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;oBACvB,aAAa,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,QAAQ,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CACpD,CAAC;IAEF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,cAAc,CAAC,CAAC;IACzC,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,aAAa,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,UAAU;IACV,MAAM,mBAAmB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IACxD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/generator/mermaid-dependency-graph.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Mermaid 依赖关系图生成器
+ * 从 CodeSkeleton 的 imports 数据生成模块间依赖关系图
+ */
+import type { CodeSkeleton } from '../models/code-skeleton.js';
+/**
+ * 从 CodeSkeleton 生成 Mermaid 依赖关系图
+ * 展示模块的内部/外部依赖关系
+ *
+ * @param skeleton - 合并后的 CodeSkeleton
+ * @param skeletons - 原始各文件的 CodeSkeleton（可选，用于展示文件间关系）
+ * @returns Mermaid graph 源码，或 null（无依赖时）
+ */
+export declare function generateDependencyDiagram(skeleton: CodeSkeleton, skeletons?: CodeSkeleton[]): string | null;
+//# sourceMappingURL=mermaid-dependency-graph.d.ts.map

package/dist/generator/mermaid-dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-dependency-graph.d.ts","sourceRoot":"","sources":["../../src/generator/mermaid-dependency-graph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,YAAY,EAAE,GACzB,MAAM,GAAG,IAAI,CAoEf"}

package/dist/generator/mermaid-dependency-graph.js

@@ -0,0 +1,84 @@
+/**
+ * 从 CodeSkeleton 生成 Mermaid 依赖关系图
+ * 展示模块的内部/外部依赖关系
+ *
+ * @param skeleton - 合并后的 CodeSkeleton
+ * @param skeletons - 原始各文件的 CodeSkeleton（可选，用于展示文件间关系）
+ * @returns Mermaid graph 源码，或 null（无依赖时）
+ */
+export function generateDependencyDiagram(skeleton, skeletons) {
+    const imports = skeleton.imports;
+    if (!imports || imports.length === 0)
+        return null;
+    // 分类依赖
+    const internalDeps = [];
+    const externalDeps = [];
+    const seenInternal = new Set();
+    const seenExternal = new Set();
+    for (const imp of imports) {
+        const modName = extractModuleName(imp.moduleSpecifier);
+        if (imp.isRelative) {
+            if (!seenInternal.has(modName)) {
+                seenInternal.add(modName);
+                internalDeps.push(modName);
+            }
+        }
+        else if (!imp.isTypeOnly) {
+            if (!seenExternal.has(modName)) {
+                seenExternal.add(modName);
+                externalDeps.push(modName);
+            }
+        }
+    }
+    // 至少需要一些依赖才值得生成图
+    if (internalDeps.length === 0 && externalDeps.length === 0)
+        return null;
+    // 限制显示数量避免图太大
+    const maxInternal = 15;
+    const maxExternal = 10;
+    const shownInternal = internalDeps.slice(0, maxInternal);
+    const shownExternal = externalDeps.slice(0, maxExternal);
+    const lines = ['graph LR'];
+    // 当前模块节点
+    const moduleName = extractModuleName(skeleton.filePath);
+    lines.push(`  M["${moduleName}"]`);
+    // 内部依赖
+    if (shownInternal.length > 0) {
+        for (const dep of shownInternal) {
+            const safeId = sanitizeId(dep);
+            lines.push(`  M --> ${safeId}["${dep}"]`);
+        }
+        if (internalDeps.length > maxInternal) {
+            lines.push(`  M --> MORE_INT["...其他 ${internalDeps.length - maxInternal} 个内部模块"]`);
+        }
+    }
+    // 外部依赖
+    if (shownExternal.length > 0) {
+        for (const dep of shownExternal) {
+            const safeId = sanitizeId(dep);
+            lines.push(`  M -.-> ${safeId}["📦 ${dep}"]`);
+        }
+        if (externalDeps.length > maxExternal) {
+            lines.push(`  M -.-> MORE_EXT["...其他 ${externalDeps.length - maxExternal} 个外部包"]`);
+        }
+    }
+    // 样式
+    lines.push('  style M fill:#f9f,stroke:#333,stroke-width:2px');
+    return lines.join('\n');
+}
+/**
+ * 从 import 路径提取模块名
+ * './auth/login' → 'auth/login'
+ * 'node:fs' → 'node:fs'
+ * '@anthropic-ai/sdk' → '@anthropic-ai/sdk'
+ */
+function extractModuleName(specifier) {
+    return specifier.replace(/^\.\//, '').replace(/\.[^.]+$/, '');
+}
+/**
+ * 将模块名转换为合法的 Mermaid 节点 ID
+ */
+function sanitizeId(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, '_');
+}
+//# sourceMappingURL=mermaid-dependency-graph.js.map

package/dist/generator/mermaid-dependency-graph.js.map

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

package/dist/generator/spec-renderer.d.ts

@@ -0,0 +1,24 @@
+import type { ModuleSpec } from '../models/module-spec.js';
+/**
+ * 一次性初始化：编译模板、注册 Helpers
+ * 必须在首次调用 renderSpec() 之前执行
+ */
+export declare function initRenderer(): void;
+/**
+ * 使用 Handlebars 模板将 ModuleSpec 渲染为 Markdown
+ *
+ * @param moduleSpec - 完整的 ModuleSpec 数据
+ * @returns 包含 YAML frontmatter + 9 章节 + Mermaid + 基线骨架的完整 Markdown
+ */
+export declare function renderSpec(moduleSpec: ModuleSpec): string;
+/**
+ * 渲染架构索引
+ */
+export declare function renderIndex(data: Record<string, unknown>): string;
+/**
+ * 渲染漂移报告
+ */
+export declare function renderDriftReport(data: Record<string, unknown>): string;
+/** 重置初始化状态（测试用） */
+export declare function resetRenderer(): void;
+//# sourceMappingURL=spec-renderer.d.ts.map

package/dist/generator/spec-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-renderer.d.ts","sourceRoot":"","sources":["../../src/generator/spec-renderer.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AA2C3D;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAyBnC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAYzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKvE;AAED,mBAAmB;AACnB,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/generator/spec-renderer.js

@@ -0,0 +1,110 @@
+/**
+ * Handlebars Spec 渲染器
+ * 将 ModuleSpec 渲染为最终 Markdown（FR-006/FR-007/FR-008/FR-009）
+ * 参见 contracts/generator.md
+ */
+import Handlebars from 'handlebars';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.resolve(__dirname, '../../templates');
+let moduleSpecTemplate = null;
+let indexSpecTemplate = null;
+let driftReportTemplate = null;
+let initialized = false;
+/**
+ * 注册自定义 Handlebars Helpers
+ */
+function registerHelpers() {
+    // 格式化 TypeScript 签名为 Markdown 代码
+    Handlebars.registerHelper('formatSignature', (signature) => {
+        if (!signature)
+            return '';
+        return new Handlebars.SafeString(`\`${signature}\``);
+    });
+    // 智能判空
+    Handlebars.registerHelper('hasContent', (value) => {
+        if (value == null)
+            return false;
+        if (typeof value === 'string')
+            return value.trim().length > 0;
+        if (Array.isArray(value))
+            return value.length > 0;
+        if (typeof value === 'object')
+            return Object.keys(value).length > 0;
+        return Boolean(value);
+    });
+    // 文件路径转 Spec 链接
+    Handlebars.registerHelper('specLink', (filePath) => {
+        if (!filePath)
+            return '';
+        const specName = path.basename(filePath, path.extname(filePath));
+        return new Handlebars.SafeString(`[${specName}](${specName}.spec.md)`);
+    });
+    // Mermaid 类图包装
+    Handlebars.registerHelper('mermaidClass', (source) => {
+        if (!source)
+            return '';
+        return new Handlebars.SafeString(`\`\`\`mermaid\n${source}\n\`\`\``);
+    });
+}
+/**
+ * 一次性初始化：编译模板、注册 Helpers
+ * 必须在首次调用 renderSpec() 之前执行
+ */
+export function initRenderer() {
+    if (initialized)
+        return;
+    registerHelpers();
+    // 编译模板
+    const moduleSpecSrc = fs.readFileSync(path.join(TEMPLATES_DIR, 'module-spec.hbs'), 'utf-8');
+    moduleSpecTemplate = Handlebars.compile(moduleSpecSrc, { noEscape: true });
+    const indexSpecSrc = fs.readFileSync(path.join(TEMPLATES_DIR, 'index-spec.hbs'), 'utf-8');
+    indexSpecTemplate = Handlebars.compile(indexSpecSrc, { noEscape: true });
+    const driftReportSrc = fs.readFileSync(path.join(TEMPLATES_DIR, 'drift-report.hbs'), 'utf-8');
+    driftReportTemplate = Handlebars.compile(driftReportSrc, { noEscape: true });
+    initialized = true;
+}
+/**
+ * 使用 Handlebars 模板将 ModuleSpec 渲染为 Markdown
+ *
+ * @param moduleSpec - 完整的 ModuleSpec 数据
+ * @returns 包含 YAML frontmatter + 9 章节 + Mermaid + 基线骨架的完整 Markdown
+ */
+export function renderSpec(moduleSpec) {
+    if (!initialized || !moduleSpecTemplate) {
+        initRenderer();
+    }
+    const markdown = moduleSpecTemplate(moduleSpec);
+    // 将基线骨架序列化为 HTML 注释块（漂移检测 + panoramic 管线消费）
+    const baselineJson = JSON.stringify(moduleSpec.baselineSkeleton);
+    const baselineComment = `\n\n<!-- baseline-skeleton: ${baselineJson} -->\n`;
+    return markdown + baselineComment;
+}
+/**
+ * 渲染架构索引
+ */
+export function renderIndex(data) {
+    if (!initialized || !indexSpecTemplate) {
+        initRenderer();
+    }
+    return indexSpecTemplate(data);
+}
+/**
+ * 渲染漂移报告
+ */
+export function renderDriftReport(data) {
+    if (!initialized || !driftReportTemplate) {
+        initRenderer();
+    }
+    return driftReportTemplate(data);
+}
+/** 重置初始化状态（测试用） */
+export function resetRenderer() {
+    initialized = false;
+    moduleSpecTemplate = null;
+    indexSpecTemplate = null;
+    driftReportTemplate = null;
+}
+//# sourceMappingURL=spec-renderer.js.map

package/dist/generator/spec-renderer.js.map

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

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

@@ -0,0 +1,24 @@
+import type { DependencyGraph } from '../models/dependency-graph.js';
+export interface GraphOptions {
+    /** 用于过滤分析文件的 Glob 模式（默认 '^src/'） */
+    includeOnly?: string;
+    /** 排除模式 */
+    excludePatterns?: string[];
+    /** tsconfig.json 路径 */
+    tsConfigPath?: string;
+}
+export declare class ProjectNotFoundError extends Error {
+    constructor(projectRoot: string);
+}
+export declare class NoDependencyCruiserError extends Error {
+    constructor();
+}
+/**
+ * 使用 dependency-cruiser 构建项目级依赖关系图
+ *
+ * @param projectRoot - 项目根目录
+ * @param options - 构建选项
+ * @returns DependencyGraph
+ */
+export declare function buildGraph(projectRoot: string, options?: GraphOptions): Promise<DependencyGraph>;
+//# sourceMappingURL=dependency-graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../src/graph/dependency-graph.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,+BAA+B,CAAC;AASvC,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,WAAW,EAAE,MAAM;CAIhC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AAMD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,eAAe,CAAC,CAkM1B"}