spectra-cli 4.1.1

package/dist/panoramic/exporters/html-template.js.map

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

package/dist/panoramic/exporters/obsidian-exporter.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Obsidian Vault 导出器
+ * 纯函数管道：GraphJSON + CommunityResult + GodNode[] → Markdown 文件集
+ *
+ * 遵循 Graphify 纯函数管道设计模式：无类封装，无实例状态
+ * FR 追踪: FR-001 ~ FR-005、FR-016、FR-019
+ */
+import type { GraphJSON } from '../graph/graph-types.js';
+import type { CommunityResult, CommunityInfo } from '../community/community-detector.js';
+import type { GodNode } from '../community/god-node-analyzer.js';
+import type { ExportResult, ObsidianPage } from './export-types.js';
+/**
+ * 对文件名执行 Obsidian 安全 sanitize
+ *
+ * 规则：
+ * 1. 替换 / \ : * ? " < > | 和空格为 -
+ * 2. 合并连续 - 为单个 -
+ * 3. 去除首尾 -
+ * 4. 长度 > 200 时截取前 195 字符 + FNV-1a 4 字符哈希
+ *
+ * @param name - 原始文件名（通常是节点 ID 或 label）
+ * @returns 安全的文件名字符串（不含扩展名）
+ */
+export declare function sanitizeFilename(name: string): string;
+/**
+ * 生成 index.md 总览页内容（纯函数）
+ * 包含图谱统计、社区列表、God Node 列表
+ *
+ * @param graphJson - 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @returns ObsidianPage（relativePath 固定为 index.md）
+ */
+export declare function buildIndexPage(graphJson: GraphJSON, communityResult: CommunityResult, godNodes: GodNode[], godNodeFinalNames?: Map<string, string>): ObsidianPage;
+/**
+ * 生成单个社区页内容（纯函数）
+ *
+ * @param communityId - 社区 ID
+ * @param communityInfo - 社区元数据
+ * @param nodeIdToLabel - 节点 ID → label 映射（用于生成双向链接）
+ * @param communityResult - 社区检测结果（用于跨社区链接）
+ * @param graphJson - 图谱数据（用于查找跨社区边）
+ * @returns ObsidianPage（relativePath 为 communities/community-{id}.md）
+ */
+export declare function buildCommunityPage(communityId: number, communityInfo: CommunityInfo, nodeIdToLabel: Map<string, string>, communityResult: CommunityResult, graphJson: GraphJSON): ObsidianPage;
+/**
+ * 生成单个 God Node 页内容（纯函数）
+ *
+ * @param godNode - God Node 描述
+ * @param communityResult - 社区检测结果（用于查社区归属）
+ * @param graphJson - 图谱数据（用于查邻居）
+ * @param nodeIdToLabel - 节点 ID → label 映射
+ * @returns ObsidianPage（relativePath 为 god-nodes/{sanitized-name}.md）
+ */
+export declare function buildGodNodePage(godNode: GodNode, communityResult: CommunityResult, graphJson: GraphJSON, nodeIdToLabel: Map<string, string>): ObsidianPage;
+/**
+ * 生成完整 Obsidian Vault（写盘入口）
+ * 纯函数管道：graphJson + communityResult + godNodes → 文件产物
+ *
+ * @param graphJson - 图谱数据
+ * @param communityResult - 社区检测结果（含 nodeCommunityMap）
+ * @param godNodes - God Node 列表
+ * @param outputDir - 输出目录（绝对路径或相对路径）
+ * @returns ExportResult（文件列表、数量、耗时）
+ */
+export declare function generateObsidianVault(graphJson: GraphJSON, communityResult: CommunityResult, godNodes: GodNode[], outputDir: string): ExportResult;
+//# sourceMappingURL=obsidian-exporter.d.ts.map

package/dist/panoramic/exporters/obsidian-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian-exporter.d.ts","sourceRoot":"","sources":["../../../src/panoramic/exporters/obsidian-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA6BpE;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBrD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,YAAY,CAuCd;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,GACnB,YAAY,CA2Dd;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,YAAY,CAiEd;AAMD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,GAChB,YAAY,CA8Ed"}

package/dist/panoramic/exporters/obsidian-exporter.js

@@ -0,0 +1,333 @@
+/**
+ * Obsidian Vault 导出器
+ * 纯函数管道：GraphJSON + CommunityResult + GodNode[] → Markdown 文件集
+ *
+ * 遵循 Graphify 纯函数管道设计模式：无类封装，无实例状态
+ * FR 追踪: FR-001 ~ FR-005、FR-016、FR-019
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ============================================================
+// sanitizeFilename — FR-005
+// ============================================================
+/**
+ * FNV-1a 32-bit 哈希（纯 JS 实现，无 crypto 依赖）
+ * 用于长文件名截断时生成唯一后缀，降低碰撞概率
+ */
+function fnv1a32(str) {
+    let hash = 2166136261;
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        // 模拟 32-bit 无符号整数乘法
+        hash = (hash * 16777619) >>> 0;
+    }
+    return hash;
+}
+/**
+ * 返回 FNV-1a 32-bit hash 的前 4 位十六进制（用于碰撞去重）
+ * @param str - 用于生成哈希的字符串
+ * @returns 4 位十六进制字符串
+ */
+function fnv1a4(str) {
+    return (fnv1a32(str) >>> 0).toString(16).padStart(8, '0').slice(0, 4);
+}
+/**
+ * 对文件名执行 Obsidian 安全 sanitize
+ *
+ * 规则：
+ * 1. 替换 / \ : * ? " < > | 和空格为 -
+ * 2. 合并连续 - 为单个 -
+ * 3. 去除首尾 -
+ * 4. 长度 > 200 时截取前 195 字符 + FNV-1a 4 字符哈希
+ *
+ * @param name - 原始文件名（通常是节点 ID 或 label）
+ * @returns 安全的文件名字符串（不含扩展名）
+ */
+export function sanitizeFilename(name) {
+    if (!name)
+        return '';
+    // 替换特殊字符和空格为 -
+    let result = name.replace(/[/\\:*?"<>|\s]/g, '-');
+    // 合并连续 - 为单个 -
+    result = result.replace(/-+/g, '-');
+    // 去除首尾 -
+    result = result.replace(/^-+|-+$/g, '');
+    // 超过 200 字符：截取前 195 + FNV-1a 4 字符哈希
+    if (result.length > 200) {
+        const hash = fnv1a32(name).toString(16).padStart(8, '0').slice(0, 4);
+        result = result.slice(0, 195) + hash;
+    }
+    return result;
+}
+// ============================================================
+// buildIndexPage — FR-001、FR-004
+// ============================================================
+/**
+ * 生成 index.md 总览页内容（纯函数）
+ * 包含图谱统计、社区列表、God Node 列表
+ *
+ * @param graphJson - 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @returns ObsidianPage（relativePath 固定为 index.md）
+ */
+export function buildIndexPage(graphJson, communityResult, godNodes, godNodeFinalNames) {
+    const { nodeCount, edgeCount } = graphJson.graph;
+    const communityCount = communityResult.communities.length;
+    const lines = [
+        '# 知识图谱总览',
+        '',
+        '## 统计',
+        '',
+        `- **节点总数**: ${nodeCount}`,
+        `- **边总数**: ${edgeCount}`,
+        `- **社区数量**: ${communityCount}`,
+        '',
+    ];
+    // 社区列表
+    if (communityResult.communities.length > 0) {
+        lines.push('## 社区列表', '');
+        for (const community of communityResult.communities) {
+            lines.push(`- [[community-${community.id}]] — ${community.nodes.length} 个节点，内聚度 ${community.cohesion}`);
+        }
+        lines.push('');
+    }
+    // God Node 列表（使用碰撞检测后的最终文件名，保证 wikilink 有效）
+    if (godNodes.length > 0) {
+        lines.push('## God Nodes（高影响力节点）', '');
+        for (const godNode of godNodes) {
+            // 优先使用碰撞检测后的最终文件名；无映射时回退到 sanitizeFilename
+            const wikilinkName = godNodeFinalNames?.get(godNode.id) ?? sanitizeFilename(godNode.label);
+            lines.push(`- [[${wikilinkName}]] — 度数 ${godNode.degree}，主要关系 ${godNode.primaryRelation}`);
+        }
+        lines.push('');
+    }
+    return {
+        relativePath: 'index.md',
+        content: lines.join('\n'),
+    };
+}
+// ============================================================
+// buildCommunityPage — FR-002、FR-004
+// ============================================================
+/**
+ * 生成单个社区页内容（纯函数）
+ *
+ * @param communityId - 社区 ID
+ * @param communityInfo - 社区元数据
+ * @param nodeIdToLabel - 节点 ID → label 映射（用于生成双向链接）
+ * @param communityResult - 社区检测结果（用于跨社区链接）
+ * @param graphJson - 图谱数据（用于查找跨社区边）
+ * @returns ObsidianPage（relativePath 为 communities/community-{id}.md）
+ */
+export function buildCommunityPage(communityId, communityInfo, nodeIdToLabel, communityResult, graphJson) {
+    // 节点 ID 查 label，不存在时回退到 ID 本身
+    const nodeLabel = (id) => nodeIdToLabel.get(id) ?? id;
+    const memberSet = new Set(communityInfo.nodes);
+    const lines = [
+        `# 社区 ${communityId}`,
+        '',
+        '## 基本信息',
+        '',
+        `- **社区 ID**: ${communityId}`,
+        `- **节点数量**: ${communityInfo.nodes.length}`,
+        `- **内聚度评分**: ${communityInfo.cohesion}`,
+        '',
+    ];
+    // 核心节点 Top 3（纯文本，community 页面没有对应的节点页文件）
+    if (communityInfo.coreNodes.length > 0) {
+        lines.push('## 核心节点（Top 3）', '');
+        for (const nodeId of communityInfo.coreNodes.slice(0, 3)) {
+            const label = nodeLabel(nodeId);
+            lines.push(`- ${label}`);
+        }
+        lines.push('');
+    }
+    // 社区内所有节点（纯文本）
+    lines.push('## 所有节点', '');
+    for (const nodeId of communityInfo.nodes) {
+        const label = nodeLabel(nodeId);
+        lines.push(`- ${label}`);
+    }
+    lines.push('');
+    // 跨社区链接（FR-002）
+    const crossCommunityIds = new Set();
+    for (const edge of graphJson.links) {
+        const srcInComm = memberSet.has(edge.source);
+        const tgtInComm = memberSet.has(edge.target);
+        if (srcInComm && !tgtInComm) {
+            const otherId = communityResult.nodeCommunityMap.get(edge.target);
+            if (otherId !== undefined && otherId !== communityId)
+                crossCommunityIds.add(otherId);
+        }
+        else if (!srcInComm && tgtInComm) {
+            const otherId = communityResult.nodeCommunityMap.get(edge.source);
+            if (otherId !== undefined && otherId !== communityId)
+                crossCommunityIds.add(otherId);
+        }
+    }
+    if (crossCommunityIds.size > 0) {
+        lines.push('## 跨社区链接', '');
+        for (const otherId of [...crossCommunityIds].sort((a, b) => a - b)) {
+            lines.push(`- [[community-${otherId}]]`);
+        }
+        lines.push('');
+    }
+    return {
+        relativePath: `communities/community-${communityId}.md`,
+        content: lines.join('\n'),
+    };
+}
+// ============================================================
+// buildGodNodePage — FR-003、FR-004、FR-019
+// ============================================================
+/**
+ * 生成单个 God Node 页内容（纯函数）
+ *
+ * @param godNode - God Node 描述
+ * @param communityResult - 社区检测结果（用于查社区归属）
+ * @param graphJson - 图谱数据（用于查邻居）
+ * @param nodeIdToLabel - 节点 ID → label 映射
+ * @returns ObsidianPage（relativePath 为 god-nodes/{sanitized-name}.md）
+ */
+export function buildGodNodePage(godNode, communityResult, graphJson, nodeIdToLabel) {
+    const sanitizedName = sanitizeFilename(godNode.label);
+    // 查找社区归属
+    const communityId = communityResult.nodeCommunityMap.get(godNode.id) ?? godNode.communityId;
+    const communityLink = communityId >= 0 ? `[[community-${communityId}]]` : '未分类';
+    // 查找直接邻居（在 graphJson 中遍历边）
+    const neighbors = [];
+    for (const edge of graphJson.links) {
+        if (edge.source === godNode.id && edge.target !== godNode.id) {
+            neighbors.push(edge.target);
+        }
+        else if (edge.target === godNode.id && edge.source !== godNode.id) {
+            neighbors.push(edge.source);
+        }
+    }
+    // 去重
+    const uniqueNeighbors = [...new Set(neighbors)];
+    const lines = [
+        `# ${godNode.label}`,
+        '',
+        '## 基本信息',
+        '',
+        `- **节点 ID**: ${godNode.id}`,
+        `- **度数**: ${godNode.degree}`,
+        `- **主要关系类型**: ${godNode.primaryRelation}`,
+        `- **所属社区**: ${communityLink}`,
+        '',
+    ];
+    // 直接邻居列表
+    lines.push('## 直接依赖关系', '');
+    if (uniqueNeighbors.length === 0) {
+        lines.push('无直接依赖关系');
+    }
+    else {
+        for (const neighborId of uniqueNeighbors) {
+            const label = nodeIdToLabel.get(neighborId) ?? neighborId;
+            lines.push(`- [[${sanitizeFilename(label)}]]`);
+        }
+    }
+    lines.push('');
+    // 条件：metadata.sourceTarget 存在时生成额外链接（FR-019）
+    const nodeInfo = graphJson.nodes.find((n) => n.id === godNode.id);
+    if (nodeInfo?.metadata.sourceTarget && typeof nodeInfo.metadata.sourceTarget === 'string') {
+        lines.push('## 源文件', '');
+        lines.push(`- \`${nodeInfo.metadata.sourceTarget}\``);
+        lines.push('');
+    }
+    // 条件：metadata.relatedFiles 存在时生成额外链接（FR-019）
+    if (nodeInfo?.metadata.relatedFiles && Array.isArray(nodeInfo.metadata.relatedFiles)) {
+        lines.push('## 相关文件', '');
+        for (const file of nodeInfo.metadata.relatedFiles) {
+            lines.push(`- \`${file}\``);
+        }
+        lines.push('');
+    }
+    return {
+        relativePath: `god-nodes/${sanitizedName}.md`,
+        content: lines.join('\n'),
+        nodeId: godNode.id,
+    };
+}
+// ============================================================
+// generateObsidianVault — FR-001 ~ FR-005、FR-016
+// ============================================================
+/**
+ * 生成完整 Obsidian Vault（写盘入口）
+ * 纯函数管道：graphJson + communityResult + godNodes → 文件产物
+ *
+ * @param graphJson - 图谱数据
+ * @param communityResult - 社区检测结果（含 nodeCommunityMap）
+ * @param godNodes - God Node 列表
+ * @param outputDir - 输出目录（绝对路径或相对路径）
+ * @returns ExportResult（文件列表、数量、耗时）
+ */
+export function generateObsidianVault(graphJson, communityResult, godNodes, outputDir) {
+    const startTime = Date.now();
+    // 空图短路返回
+    if (graphJson.nodes.length === 0) {
+        return { files: [], fileCount: 0, durationMs: Date.now() - startTime };
+    }
+    // 构建 nodeIdToLabel Map（O(n) 一次性构建）
+    const nodeIdToLabel = new Map();
+    for (const node of graphJson.nodes) {
+        nodeIdToLabel.set(node.id, node.label);
+    }
+    // 第一阶段：构建 god-node pages 并做碰撞检测
+    // 必须先于 index.md 生成，以获取最终文件名映射（FR-001/FR-004 wikilink 正确性）
+    const rawGodNodePages = godNodes.map((godNode) => buildGodNodePage(godNode, communityResult, graphJson, nodeIdToLabel));
+    // 碰撞检测：相同 relativePath 的后来者追加 FNV-1a hash 后缀
+    // 修复：碰撞后的新路径也注册到 seenPaths，防止二次碰撞盲区
+    const seenPaths = new Map();
+    const deduplicatedGodNodePages = rawGodNodePages.map((page) => {
+        if (!seenPaths.has(page.relativePath)) {
+            seenPaths.set(page.relativePath, page.nodeId ?? page.relativePath);
+            return page;
+        }
+        // 发生碰撞：追加 FNV-1a 前 4 位十六进制后缀（基于 nodeId + relativePath）
+        const suffix = fnv1a4((page.nodeId ?? '') + page.relativePath);
+        const ext = path.extname(page.relativePath); // '.md'
+        const base = page.relativePath.slice(0, -ext.length); // 去掉 .md
+        const newRelativePath = `${base}-${suffix}${ext}`;
+        // 注册新路径，防止二次碰撞覆盖
+        seenPaths.set(newRelativePath, page.nodeId ?? newRelativePath);
+        return { ...page, relativePath: newRelativePath };
+    });
+    // 从去重后的 god-node pages 提取 nodeId → wikilink 文件名映射
+    // wikilink 名称 = relativePath 去掉 'god-nodes/' 前缀和 '.md' 扩展
+    const godNodeFinalNames = new Map();
+    for (const page of deduplicatedGodNodePages) {
+        if (page.nodeId) {
+            const ext = path.extname(page.relativePath);
+            const base = page.relativePath.slice('god-nodes/'.length, -ext.length);
+            godNodeFinalNames.set(page.nodeId, base);
+        }
+    }
+    // 第二阶段：构建 index.md（使用最终 wikilink 名称映射）和 community pages
+    const pages = [];
+    // index.md（传入 godNodeFinalNames 确保 wikilink 与实际文件一致）
+    pages.push(buildIndexPage(graphJson, communityResult, godNodes, godNodeFinalNames));
+    // communities/*.md
+    for (const community of communityResult.communities) {
+        pages.push(buildCommunityPage(community.id, community, nodeIdToLabel, communityResult, graphJson));
+    }
+    // 合并所有已去重的页面
+    const deduplicatedPages = [...pages, ...deduplicatedGodNodePages];
+    // 写盘：创建目录并写文件
+    const writtenFiles = [];
+    for (const page of deduplicatedPages) {
+        const absolutePath = path.resolve(outputDir, page.relativePath);
+        const dir = path.dirname(absolutePath);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(absolutePath, page.content, 'utf-8');
+        writtenFiles.push(absolutePath);
+    }
+    return {
+        files: writtenFiles,
+        fileCount: writtenFiles.length,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=obsidian-exporter.js.map

package/dist/panoramic/exporters/obsidian-exporter.js.map

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

package/dist/panoramic/generator-registry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * GeneratorRegistry — 全景文档化 Generator 注册中心（单例）
+ *
+ * 职责：
+ * - 维护 Generator id 到 DocumentGenerator 实例的映射
+ * - 提供按 id 查询、全量列出、按 ProjectContext 异步过滤的能力
+ * - 检测 id 冲突（两阶段验证：格式校验 + 重复检测）
+ * - 管理 Generator 的启用/禁用状态
+ *
+ * 设计决策：
+ * - 继承 AbstractRegistry<DocumentGenerator, GeneratorEntry> 复用通用逻辑
+ * - 单例模式参考 LanguageAdapterRegistry，保证全局唯一性
+ * - 启用/禁用状态由 Registry 拥有（独立 Map），不修改外部 Generator 实例
+ * - filterByContext 使用 Promise.resolve() 统一包装同步/异步 isApplicable
+ * - Promise.allSettled() 实现并发执行和错误隔离
+ *
+ * 生命周期：进程级单例，CLI 和 MCP 入口各自在启动时通过 bootstrapGenerators() 完成注册。
+ */
+import type { z } from 'zod';
+import type { DocumentGenerator, ProjectContext } from './interfaces.js';
+import { AbstractRegistry } from './abstract-registry.js';
+/**
+ * list() 方法返回的只读数据视图
+ * 包含 Generator 实例引用和当前启用/禁用状态
+ */
+export interface GeneratorEntry {
+    /** Generator 实例引用（只读视图） */
+    readonly generator: DocumentGenerator<any, any>;
+    /** 当前启用/禁用状态 */
+    readonly enabled: boolean;
+}
+/**
+ * Generator 的中心化注册中心
+ * 维护 id 到 DocumentGenerator 实例的映射以及每个 Generator 的启用/禁用状态。
+ * 进程级单例，全局唯一。
+ */
+export declare class GeneratorRegistry extends AbstractRegistry<DocumentGenerator<any, any>, GeneratorEntry> {
+    /** 单例实例 */
+    private static instance;
+    private constructor();
+    /**
+     * 获取或创建 Registry 单例
+     */
+    static getInstance(): GeneratorRegistry;
+    /**
+     * 重置单例（仅限测试使用）
+     * 重置后下次 getInstance() 返回新的空白实例。
+     */
+    static resetInstance(): void;
+    protected getMetadataSchema(): z.ZodSchema;
+    protected extractMetadata(item: DocumentGenerator<any, any>): {
+        id: string;
+        name: string;
+        description: string;
+    };
+    protected buildEntry(item: DocumentGenerator<any, any>, enabled: boolean): GeneratorEntry;
+    /**
+     * 切换 Generator 的启用/禁用状态
+     * 重写基类方法以保持向后兼容的错误消息前缀
+     */
+    setEnabled(id: string, enabled: boolean): void;
+    /**
+     * 按项目上下文过滤适用的 Generator
+     *
+     * 处理逻辑：
+     * 1. 跳过已禁用的 Generator
+     * 2. 使用 Promise.resolve() 统一包装同步/异步 isApplicable 返回值
+     * 3. 使用 Promise.allSettled() 并发执行所有 isApplicable 调用
+     * 4. rejected 的 Promise 记录 console.warn 并跳过
+     * 5. 收集 fulfilled 且值为 true 的 Generator，按注册顺序返回
+     *
+     * @param context - 项目上下文
+     * @returns 适用且启用的 Generator 列表
+     */
+    filterByContext(context: ProjectContext): Promise<DocumentGenerator<any, any>[]>;
+}
+/**
+ * 启动 Generator 注册
+ * 在 CLI/MCP 入口最早时机调用，完成所有内置 Generator 的注册。
+ * 幂等：如果 Registry 已有 Generator 注册则跳过。
+ *
+ * @param outputDir - 文档输出目录（可选）。副作用型和聚合评估型 Adapter 需要此参数。
+ *                   若不传则使用当前工作目录作为默认值。
+ */
+export declare function bootstrapGenerators(outputDir?: string): void;
+//# sourceMappingURL=generator-registry.d.ts.map

package/dist/panoramic/generator-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-registry.d.ts","sourceRoot":"","sources":["../../src/panoramic/generator-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAyB1D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAMD;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,cAAc,CAAC;IAClG,WAAW;IACX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IAEzD,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B,SAAS,CAAC,iBAAiB,IAAI,CAAC,CAAC,SAAS;IAI1C,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAQ/G,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc;IAQzF;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAW9C;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CA6CvF;AAMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAiC5D"}