spectra-cli 4.1.1

package/dist/panoramic/community/surprising-edges.js

@@ -0,0 +1,154 @@
+/**
+ * 跨社区异常边发现 + betweenness 近似采样
+ * 参考 Graphify analyze.py 的 surprising_connections 策略
+ * 复合评分：跨社区加成 + 置信度权重 + betweenness centrality
+ */
+// ============================================================
+// 常量
+// ============================================================
+/** 置信度惊奇权重：低置信度 = 更意外 */
+const CONFIDENCE_SURPRISE_WEIGHT = {
+    AMBIGUOUS: 3,
+    INFERRED: 2,
+    EXTRACTED: 1,
+};
+// ============================================================
+// 公共函数
+// ============================================================
+/**
+ * 发现跨社区异常边
+ * 评分策略：
+ * 1. 跨社区加成（+3）
+ * 2. 置信度权重（AMBIGUOUS=3, INFERRED=2, EXTRACTED=1）
+ * 3. betweenness centrality 采样归一化加成
+ *
+ * @param graph - graphology 图实例
+ * @param nodeCommunityMap - 节点 → 社区 ID 映射
+ * @param options - 采样和返回数量配置
+ * @returns 异常边列表（按评分降序）
+ */
+export function findSurprisingEdges(graph, nodeCommunityMap, options) {
+    const topN = options?.topN ?? 10;
+    const sampleSize = options?.sampleSize ?? 1000;
+    if (graph.size === 0)
+        return [];
+    // 计算边 betweenness（采样近似）
+    const edgeBetweenness = approximateEdgeBetweenness(graph, sampleSize);
+    // 归一化 betweenness（避免 spread 大 Map 导致栈溢出）
+    let maxBetweenness = 1;
+    for (const v of edgeBetweenness.values()) {
+        if (v > maxBetweenness)
+            maxBetweenness = v;
+    }
+    const candidates = [];
+    graph.forEachEdge((_edge, attrs, source, target) => {
+        const sourceCommunity = nodeCommunityMap.get(source);
+        const targetCommunity = nodeCommunityMap.get(target);
+        const crossCommunity = sourceCommunity !== undefined
+            && targetCommunity !== undefined
+            && sourceCommunity !== targetCommunity;
+        // 仅保留跨社区边或低置信度边
+        const confidence = attrs['confidence'] ?? 'EXTRACTED';
+        if (!crossCommunity && confidence === 'EXTRACTED')
+            return;
+        // 排除纯结构边
+        const relation = attrs['relation'] ?? 'unknown';
+        if (relation === 'contains')
+            return;
+        // 复合评分
+        let score = 0;
+        if (crossCommunity)
+            score += 3;
+        score += CONFIDENCE_SURPRISE_WEIGHT[confidence] ?? 1;
+        // betweenness 归一化加成（0-2 分）
+        const edgeKey = [source, target].sort().join('|');
+        const betweenness = edgeBetweenness.get(edgeKey) ?? 0;
+        score += (betweenness / maxBetweenness) * 2;
+        candidates.push({
+            source,
+            target,
+            relation,
+            confidence,
+            crossCommunity,
+            score: Math.round(score * 100) / 100,
+        });
+    });
+    // 按评分降序，取 Top N
+    candidates.sort((a, b) => b.score - a.score);
+    return candidates.slice(0, topN);
+}
+// ============================================================
+// 内���函数
+// ============================================================
+/**
+ * 近似边 betweenness centrality（BFS 采样）
+ * 从随机采样的源节点出发做 BFS，统计每条边被最短路径经过的次数
+ *
+ * @param graph - graphology 图实例
+ * @param sampleSize - 采样的源节点数
+ * @returns Map<edgeKey, betweenness count>
+ */
+function approximateEdgeBetweenness(graph, sampleSize) {
+    const betweenness = new Map();
+    const allNodes = graph.nodes();
+    if (allNodes.length === 0)
+        return betweenness;
+    // 随机采样源节点
+    const sampledSources = sampleNodes(allNodes, Math.min(sampleSize, allNodes.length));
+    for (const source of sampledSources) {
+        // BFS 计算从 source 到所有节点的最短路径
+        const dist = new Map();
+        const pred = new Map();
+        const sigma = new Map();
+        const queue = [source];
+        dist.set(source, 0);
+        sigma.set(source, 1);
+        while (queue.length > 0) {
+            const v = queue.shift();
+            const dv = dist.get(v);
+            graph.forEachNeighbor(v, (w) => {
+                if (!dist.has(w)) {
+                    dist.set(w, dv + 1);
+                    queue.push(w);
+                }
+                if (dist.get(w) === dv + 1) {
+                    sigma.set(w, (sigma.get(w) ?? 0) + (sigma.get(v) ?? 1));
+                    const preds = pred.get(w) ?? [];
+                    preds.push(v);
+                    pred.set(w, preds);
+                }
+            });
+        }
+        // 反向累加 betweenness
+        const delta = new Map();
+        // 按距离降序处理节点
+        const sorted = [...dist.entries()].sort((a, b) => b[1] - a[1]);
+        for (const [w] of sorted) {
+            if (w === source)
+                continue;
+            const dw = delta.get(w) ?? 0;
+            const sigmaW = sigma.get(w) ?? 1;
+            for (const v of pred.get(w) ?? []) {
+                const sigmaV = sigma.get(v) ?? 1;
+                const contribution = (sigmaV / sigmaW) * (1 + dw);
+                delta.set(v, (delta.get(v) ?? 0) + contribution);
+                // 累加到边 betweenness
+                const edgeKey = [v, w].sort().join('|');
+                betweenness.set(edgeKey, (betweenness.get(edgeKey) ?? 0) + contribution);
+            }
+        }
+    }
+    return betweenness;
+}
+/**
+ * 从数组中随机采样 N 个元素（Fisher-Yates 部分洗牌）
+ */
+function sampleNodes(nodes, n) {
+    const copy = [...nodes];
+    for (let i = copy.length - 1; i > copy.length - 1 - n && i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [copy[i], copy[j]] = [copy[j], copy[i]];
+    }
+    return copy.slice(copy.length - n);
+}
+//# sourceMappingURL=surprising-edges.js.map

package/dist/panoramic/community/surprising-edges.js.map

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

package/dist/panoramic/cross-reference-index.d.ts

@@ -0,0 +1,4 @@
+import type { ModuleCrossReferenceIndex, ModuleSpec } from '../models/module-spec.js';
+import type { DocGraph } from './builders/doc-graph-builder.js';
+export declare function buildCrossReferenceIndex(moduleSpec: ModuleSpec, docGraph: DocGraph): ModuleCrossReferenceIndex;
+//# sourceMappingURL=cross-reference-index.d.ts.map

package/dist/panoramic/cross-reference-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-reference-index.d.ts","sourceRoot":"","sources":["../../src/panoramic/cross-reference-index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,yBAAyB,EACzB,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAA6C,MAAM,iCAAiC,CAAC;AAW3G,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,GACjB,yBAAyB,CAqH3B"}

package/dist/panoramic/cross-reference-index.js

@@ -0,0 +1,201 @@
+/**
+ * CrossReferenceIndex
+ * 将 DocGraph 投影为单个 ModuleSpec 可直接渲染的 related spec 索引。
+ */
+import * as path from 'node:path';
+import { MODULE_SPEC_ANCHOR_ID } from './builders/doc-graph-builder.js';
+export function buildCrossReferenceIndex(moduleSpec, docGraph) {
+    const currentSpecPath = normalizeProjectPath(moduleSpec.outputPath, docGraph.projectRoot);
+    const currentSourceTarget = normalizeProjectPath(moduleSpec.frontmatter.sourceTarget, docGraph.projectRoot);
+    const currentNode = docGraph.specs.find((spec) => spec.specPath === currentSpecPath || spec.sourceTarget === currentSourceTarget);
+    if (!currentNode) {
+        return {
+            generatedAt: docGraph.generatedAt,
+            sameModule: [],
+            crossModule: [],
+        };
+    }
+    const sameModuleEvidence = docGraph.references
+        .filter((reference) => reference.kind === 'same-module'
+        && reference.fromSpecPath === currentNode.specPath
+        && reference.toSpecPath === currentNode.specPath);
+    const sameModule = [];
+    if (sameModuleEvidence.length > 0) {
+        const evidenceCount = sameModuleEvidence.reduce((sum, item) => sum + item.evidenceCount, 0);
+        const samples = flattenSamples(sameModuleEvidence.flatMap((item) => item.evidenceSamples));
+        sameModule.push({
+            label: '当前模块内部关联',
+            href: `#${MODULE_SPEC_ANCHOR_ID}`,
+            targetSpecPath: currentNode.specPath,
+            targetSourceTarget: currentNode.sourceTarget,
+            kind: 'same-module',
+            direction: 'internal',
+            evidenceCount,
+            summary: summarizeEvidence(evidenceCount, samples),
+        });
+    }
+    const crossModuleMap = new Map();
+    for (const reference of docGraph.references) {
+        if (reference.kind !== 'cross-module') {
+            continue;
+        }
+        if (reference.fromSpecPath === currentNode.specPath) {
+            const entry = getOrCreateCrossModuleAccumulator(crossModuleMap, reference.toSpecPath, reference.toSourceTarget);
+            entry.outboundCount += reference.evidenceCount;
+            entry.samples.push(...reference.evidenceSamples);
+            continue;
+        }
+        if (reference.toSpecPath === currentNode.specPath) {
+            const entry = getOrCreateCrossModuleAccumulator(crossModuleMap, reference.fromSpecPath, reference.fromSourceTarget);
+            entry.inboundCount += reference.evidenceCount;
+            entry.samples.push(...reference.evidenceSamples);
+        }
+    }
+    // 补充：从 skeleton imports 推断跨模块引用（适用于无相对 import 的项目，如 Python）
+    supplementCrossModuleFromSkeletonImports(moduleSpec, docGraph, currentNode, crossModuleMap);
+    const crossModule = [...crossModuleMap.values()]
+        .map((entry) => {
+        const evidenceCount = entry.outboundCount + entry.inboundCount;
+        const samples = flattenSamples(entry.samples);
+        const direction = entry.outboundCount > 0 && entry.inboundCount > 0
+            ? 'bidirectional'
+            : entry.outboundCount > 0
+                ? 'outbound'
+                : 'inbound';
+        return {
+            label: entry.targetSourceTarget,
+            href: buildRelativeSpecHref(currentNode.specPath, entry.targetSpecPath),
+            targetSpecPath: entry.targetSpecPath,
+            targetSourceTarget: entry.targetSourceTarget,
+            kind: 'cross-module',
+            direction,
+            evidenceCount,
+            summary: summarizeDirectionalEvidence(entry.outboundCount, entry.inboundCount, samples),
+        };
+    })
+        .sort((left, right) => {
+        if (right.evidenceCount !== left.evidenceCount) {
+            return right.evidenceCount - left.evidenceCount;
+        }
+        return left.label.localeCompare(right.label);
+    });
+    return {
+        generatedAt: docGraph.generatedAt,
+        sameModule,
+        crossModule,
+    };
+}
+/**
+ * 从 skeleton imports 补充跨模块引用
+ *
+ * 当 docGraph.references 不含引用（如 Python 绝对 import 项目）时，
+ * 遍历 skeleton 的 isRelative=false imports，将包名式 specifier 解析为
+ * docGraph 中已知的 spec，并增加出站引用计数。
+ */
+function supplementCrossModuleFromSkeletonImports(moduleSpec, docGraph, currentNode, crossModuleMap) {
+    // 预构建已覆盖引用的 Set，将内层查询从 O(references) 降到 O(1)
+    const coveredKeys = new Set();
+    for (const ref of docGraph.references) {
+        if (ref.kind === 'cross-module') {
+            coveredKeys.add(`${ref.fromSpecPath}:${ref.toSpecPath}`);
+        }
+    }
+    for (const imp of moduleSpec.baselineSkeleton.imports) {
+        // 相对 import 已由 docGraph.references 覆盖
+        if (imp.isRelative)
+            continue;
+        const targetSpecPath = resolveSpecifierToSpecPath(imp.moduleSpecifier, docGraph.specs);
+        if (!targetSpecPath || targetSpecPath === currentNode.specPath)
+            continue;
+        // 若 docGraph.references 已包含该跨模块引用，跳过（避免重复计数）
+        if (coveredKeys.has(`${currentNode.specPath}:${targetSpecPath}`))
+            continue;
+        const targetSpec = docGraph.specs.find((spec) => spec.specPath === targetSpecPath);
+        if (!targetSpec)
+            continue;
+        const entry = getOrCreateCrossModuleAccumulator(crossModuleMap, targetSpecPath, targetSpec.sourceTarget);
+        entry.outboundCount += 1;
+        entry.samples.push({
+            fromSource: currentNode.sourceTarget,
+            toSource: targetSpec.sourceTarget,
+        });
+    }
+}
+/**
+ * 将模块标识符（点分包名）解析为 docGraph 中匹配的 spec 路径
+ *
+ * 优先精确匹配 sourceTarget，其次匹配 specifier 是 sourceTarget 的子路径前缀。
+ * 返回最长匹配（最具体的 spec）。
+ */
+function resolveSpecifierToSpecPath(specifier, specs) {
+    const asPath = specifier.replace(/\./g, '/');
+    let bestMatch;
+    for (const spec of specs) {
+        // 规范化 sourceTarget：统一分隔符并去掉文件扩展名
+        const st = spec.sourceTarget.replace(/\\/g, '/').replace(/\.(py|pyi|ts|tsx|js|jsx|go|java|rs)$/, '');
+        if (asPath === st || asPath.startsWith(`${st}/`)) {
+            if (!bestMatch || st.length > bestMatch.length) {
+                bestMatch = { specPath: spec.specPath, length: st.length };
+            }
+        }
+    }
+    return bestMatch?.specPath;
+}
+function getOrCreateCrossModuleAccumulator(index, targetSpecPath, targetSourceTarget) {
+    if (!index.has(targetSpecPath)) {
+        index.set(targetSpecPath, {
+            targetSpecPath,
+            targetSourceTarget,
+            outboundCount: 0,
+            inboundCount: 0,
+            samples: [],
+        });
+    }
+    return index.get(targetSpecPath);
+}
+function buildRelativeSpecHref(fromSpecPath, toSpecPath) {
+    const relative = path.relative(path.dirname(fromSpecPath), toSpecPath);
+    const normalized = relative.split(path.sep).join('/');
+    return `${normalized}#${MODULE_SPEC_ANCHOR_ID}`;
+}
+function flattenSamples(samples) {
+    const deduped = [];
+    const seen = new Set();
+    for (const sample of samples) {
+        const key = `${sample.fromSource}->${sample.toSource}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        deduped.push(sample);
+        if (deduped.length >= 3) {
+            break;
+        }
+    }
+    return deduped;
+}
+function summarizeEvidence(evidenceCount, samples) {
+    const sampleText = formatSamples(samples);
+    return sampleText.length > 0
+        ? `${evidenceCount} 条文件级引用；示例：${sampleText}`
+        : `${evidenceCount} 条文件级引用`;
+}
+function summarizeDirectionalEvidence(outboundCount, inboundCount, samples) {
+    const sampleText = formatSamples(samples);
+    const directionText = `出站 ${outboundCount}，入站 ${inboundCount}`;
+    return sampleText.length > 0
+        ? `${directionText}；示例：${sampleText}`
+        : directionText;
+}
+function formatSamples(samples) {
+    return samples
+        .map((sample) => `${sample.fromSource} -> ${sample.toSource}`)
+        .join('；');
+}
+function normalizeProjectPath(inputPath, projectRoot) {
+    const relative = path.isAbsolute(inputPath)
+        ? path.relative(projectRoot, inputPath)
+        : inputPath;
+    return relative.split(path.sep).join('/');
+}
+//# sourceMappingURL=cross-reference-index.js.map

package/dist/panoramic/cross-reference-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-reference-index.js","sourceRoot":"","sources":["../../src/panoramic/cross-reference-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAOlC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAUxE,MAAM,UAAU,wBAAwB,CACtC,UAAsB,EACtB,QAAkB;IAElB,MAAM,eAAe,GAAG,oBAAoB,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1F,MAAM,mBAAmB,GAAG,oBAAoB,CAC9C,UAAU,CAAC,WAAW,CAAC,YAAY,EACnC,QAAQ,CAAC,WAAW,CACrB,CAAC;IACF,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,eAAe,IAAI,IAAI,CAAC,YAAY,KAAK,mBAAmB,CACzF,CAAC;IAEF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU;SAC3C,MAAM,CACL,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,aAAa;WAC1C,SAAS,CAAC,YAAY,KAAK,WAAW,CAAC,QAAQ;WAC/C,SAAS,CAAC,UAAU,KAAK,WAAW,CAAC,QAAQ,CACnD,CAAC;IAEJ,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAC7C,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,aAAa,EACvC,CAAC,CACF,CAAC;QACF,MAAM,OAAO,GAAG,cAAc,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;QAC3F,UAAU,CAAC,IAAI,CAAC;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,IAAI,qBAAqB,EAAE;YACjC,cAAc,EAAE,WAAW,CAAC,QAAQ;YACpC,kBAAkB,EAAE,WAAW,CAAC,YAAY;YAC5C,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,UAAU;YACrB,aAAa;YACb,OAAO,EAAE,iBAAiB,CAAC,aAAa,EAAE,OAAO,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkC,CAAC;IACjE,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,IAAI,SAAS,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,IAAI,SAAS,CAAC,YAAY,KAAK,WAAW,CAAC,QAAQ,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,iCAAiC,CAC7C,cAAc,EACd,SAAS,CAAC,UAAU,EACpB,SAAS,CAAC,cAAc,CACzB,CAAC;YACF,KAAK,CAAC,aAAa,IAAI,SAAS,CAAC,aAAa,CAAC;YAC/C,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QAED,IAAI,SAAS,CAAC,UAAU,KAAK,WAAW,CAAC,QAAQ,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,iCAAiC,CAC7C,cAAc,EACd,SAAS,CAAC,YAAY,EACtB,SAAS,CAAC,gBAAgB,CAC3B,CAAC;YACF,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC,aAAa,CAAC;YAC9C,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,wCAAwC,CACtC,UAAU,EACV,QAAQ,EACR,WAAW,EACX,cAAc,CACf,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;SAC7C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC;QAC/D,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAoC,KAAK,CAAC,aAAa,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC;YAClG,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC;gBACvB,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,kBAAkB;YAC/B,IAAI,EAAE,qBAAqB,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC;YACvE,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;YAC5C,IAAI,EAAE,cAAuB;YAC7B,SAAS;YACT,aAAa;YACb,OAAO,EAAE,4BAA4B,CACnC,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,YAAY,EAClB,OAAO,CACR;SACF,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,UAAU;QACV,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wCAAwC,CAC/C,UAAsB,EACtB,QAAkB,EAClB,WAA6B,EAC7B,cAAmD;IAEnD,6CAA6C;IAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAChC,WAAW,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QACtD,sCAAsC;QACtC,IAAI,GAAG,CAAC,UAAU;YAAE,SAAS;QAE7B,MAAM,cAAc,GAAG,0BAA0B,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvF,IAAI,CAAC,cAAc,IAAI,cAAc,KAAK,WAAW,CAAC,QAAQ;YAAE,SAAS;QAEzE,6CAA6C;QAC7C,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC;YAAE,SAAS;QAE3E,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,cAAc,CAAC,CAAC;QACnF,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,MAAM,KAAK,GAAG,iCAAiC,CAC7C,cAAc,EACd,cAAc,EACd,UAAU,CAAC,YAAY,CACxB,CAAC;QACF,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,UAAU,EAAE,WAAW,CAAC,YAAY;YACpC,QAAQ,EAAE,UAAU,CAAC,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,0BAA0B,CACjC,SAAiB,EACjB,KAAyB;IAEzB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,SAA2D,CAAC;IAEhE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,iCAAiC;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC;QACrG,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;gBAC/C,SAAS,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,EAAE,QAAQ,CAAC;AAC7B,CAAC;AAED,SAAS,iCAAiC,CACxC,KAA0C,EAC1C,cAAsB,EACtB,kBAA0B;IAE1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE;YACxB,cAAc;YACd,kBAAkB;YAClB,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAE,CAAC;AACpC,CAAC;AAED,SAAS,qBAAqB,CAAC,YAAoB,EAAE,UAAkB;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,UAAU,IAAI,qBAAqB,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,OAAkC;IACxD,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CACxB,aAAqB,EACrB,OAAkC;IAElC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;QAC1B,CAAC,CAAC,GAAG,aAAa,cAAc,UAAU,EAAE;QAC5C,CAAC,CAAC,GAAG,aAAa,SAAS,CAAC;AAChC,CAAC;AAED,SAAS,4BAA4B,CACnC,aAAqB,EACrB,YAAoB,EACpB,OAAkC;IAElC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,MAAM,aAAa,OAAO,YAAY,EAAE,CAAC;IAC/D,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;QAC1B,CAAC,CAAC,GAAG,aAAa,OAAO,UAAU,EAAE;QACrC,CAAC,CAAC,aAAa,CAAC;AACpB,CAAC;AAED,SAAS,aAAa,CAAC,OAAkC;IACvD,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;SAC7D,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB,EAAE,WAAmB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;QACvC,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/dist/panoramic/exporters/architecture-ir-exporters.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Architecture IR exporters
+ */
+import { type ArchitectureIR } from '../models/architecture-ir-model.js';
+export declare function exportArchitectureIRJson(ir: ArchitectureIR): ArchitectureIR;
+export declare function exportArchitectureIRStructurizrDsl(ir: ArchitectureIR): string;
+//# sourceMappingURL=architecture-ir-exporters.d.ts.map

package/dist/panoramic/exporters/architecture-ir-exporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-ir-exporters.d.ts","sourceRoot":"","sources":["../../../src/panoramic/exporters/architecture-ir-exporters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAI5C,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,cAAc,GAAG,cAAc,CAE3E;AAED,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CA2D7E"}

package/dist/panoramic/exporters/architecture-ir-exporters.js

@@ -0,0 +1,183 @@
+/**
+ * Architecture IR exporters
+ */
+import { getArchitectureIRView, } from '../models/architecture-ir-model.js';
+const WORKSPACE_CONTAINER_ID = 'container:workspace';
+export function exportArchitectureIRJson(ir) {
+    return ir;
+}
+export function exportArchitectureIRStructurizrDsl(ir) {
+    const lines = [
+        `workspace "${escapeDsl(ir.projectName)} Architecture" "Generated from panoramic ArchitectureIR" {`,
+        '    !identifiers hierarchical',
+        '',
+        '    model {',
+    ];
+    const elementLines = buildModelElements(ir);
+    lines.push(...elementLines.map((line) => `        ${line}`));
+    const relationshipLines = buildStaticRelationships(ir);
+    if (relationshipLines.length > 0) {
+        lines.push('');
+        lines.push(...relationshipLines.map((line) => `        ${line}`));
+    }
+    const deploymentLines = buildDeploymentEnvironment(ir);
+    if (deploymentLines.length > 0) {
+        lines.push('');
+        lines.push(...deploymentLines.map((line) => `        ${line}`));
+    }
+    lines.push('    }');
+    lines.push('');
+    lines.push('    views {');
+    const projectIdentifier = identifierFor('project');
+    lines.push(`        systemContext ${projectIdentifier} "architecture-ir-system-context" "System context derived from ArchitectureIR" {`);
+    lines.push('            include *');
+    lines.push('            autolayout lr');
+    lines.push('        }');
+    lines.push('');
+    lines.push(`        container ${projectIdentifier} "architecture-ir-containers" "Container view derived from ArchitectureIR" {`);
+    lines.push('            include *');
+    lines.push('            autolayout lr');
+    lines.push('        }');
+    if (ir.elements.some((element) => element.kind === 'component')) {
+        lines.push('');
+        lines.push(`        component ${identifierFor(WORKSPACE_CONTAINER_ID)} "architecture-ir-components" "Component view derived from ArchitectureIR" {`);
+        lines.push('            include *');
+        lines.push('            autolayout lr');
+        lines.push('        }');
+    }
+    if ((getArchitectureIRView(ir, 'deployment')?.available ?? false) && ir.elements.some((element) => element.kind === 'deployment-node')) {
+        lines.push('');
+        lines.push('        deployment * "runtime" "architecture-ir-deployment" "Deployment view derived from ArchitectureIR" {');
+        lines.push('            include *');
+        lines.push('            autolayout lr');
+        lines.push('        }');
+    }
+    lines.push('    }');
+    lines.push('}');
+    return lines.join('\n');
+}
+function buildModelElements(ir) {
+    const lines = [];
+    const project = ir.elements.find((element) => element.id === 'project' || element.kind === 'software-system');
+    if (project) {
+        lines.push(`${identifierFor(project.id)} = softwareSystem "${escapeDsl(project.name)}" "${escapeDsl(project.description ?? 'Source system derived from panoramic architecture facts')}" {`);
+    }
+    else {
+        lines.push(`${identifierFor('project')} = softwareSystem "${escapeDsl(ir.projectName)}" "Source system derived from panoramic architecture facts" {`);
+    }
+    const runtimeContainers = ir.elements.filter((element) => element.kind === 'container' && !isWorkspaceProxy(element));
+    for (const element of runtimeContainers) {
+        lines.push(`    ${identifierFor(element.id)} = container "${escapeDsl(element.name)}" "${escapeDsl(element.description ?? '')}" "${escapeDsl(element.technology ?? 'Container')}"`);
+    }
+    const workspaceComponents = ir.elements.filter((element) => element.kind === 'component');
+    if (workspaceComponents.length > 0) {
+        lines.push(`    ${identifierFor(WORKSPACE_CONTAINER_ID)} = container "Workspace" "Unified static workspace/component model" "Codebase" {`);
+        const groupedComponents = groupComponentsByWorkspaceGroup(workspaceComponents);
+        for (const [groupName, components] of groupedComponents.entries()) {
+            if (groupName !== '.') {
+                lines.push(`        group "${escapeDsl(groupName)}" {`);
+            }
+            for (const component of components) {
+                const indent = groupName !== '.' ? '            ' : '        ';
+                lines.push(`${indent}${identifierFor(component.id)} = component "${escapeDsl(component.name)}" "${escapeDsl(component.description ?? '')}" "${escapeDsl(component.technology ?? 'Component')}"`);
+            }
+            if (groupName !== '.') {
+                lines.push('        }');
+            }
+        }
+        lines.push('    }');
+    }
+    const externalSystems = ir.elements.filter((element) => element.kind === 'external-system');
+    for (const element of externalSystems) {
+        lines.push(`    ${identifierFor(element.id)} = softwareSystem "${escapeDsl(element.name)}" "${escapeDsl(element.description ?? '')}" "External System"`);
+    }
+    lines.push('}');
+    return lines;
+}
+function buildStaticRelationships(ir) {
+    const lines = [];
+    const allowedKinds = new Set(['software-system', 'container', 'component', 'external-system']);
+    for (const relationship of ir.relationships) {
+        const source = ir.elements.find((element) => element.id === relationship.sourceId);
+        const destination = ir.elements.find((element) => element.id === relationship.destinationId);
+        if (!source || !destination) {
+            continue;
+        }
+        const sourceDslKind = mapElementKindForStaticDsl(source.kind);
+        const destinationDslKind = mapElementKindForStaticDsl(destination.kind);
+        if (!allowedKinds.has(sourceDslKind) || !allowedKinds.has(destinationDslKind)) {
+            continue;
+        }
+        lines.push(`${identifierFor(source.id)} -> ${identifierFor(destination.id)} "${escapeDsl(relationship.description)}" "${escapeDsl(relationship.technology ?? relationship.kind)}"`);
+    }
+    return dedupe(lines);
+}
+function buildDeploymentEnvironment(ir) {
+    const deploymentView = getArchitectureIRView(ir, 'deployment');
+    if (!deploymentView?.available) {
+        return [];
+    }
+    const lines = ['deploymentEnvironment "runtime" {'];
+    const deploymentNodes = deploymentView.elementIds
+        .map((id) => ir.elements.find((element) => element.id === id))
+        .filter((element) => element?.kind === 'deployment-node');
+    if (deploymentNodes.length === 0) {
+        lines.push('}');
+        return lines;
+    }
+    for (const node of deploymentNodes) {
+        const serviceName = getStringMetadata(node, 'service');
+        const serviceId = serviceName ? `service:${serviceName}` : undefined;
+        lines.push(`    ${identifierFor(node.id)} = deploymentNode "${escapeDsl(node.name)}" "${escapeDsl(node.description ?? 'Runtime deployment node')}" "Container Runtime" {`);
+        if (serviceId) {
+            lines.push(`        ${identifierFor(`instance:${serviceId}`)} = containerInstance ${identifierFor(serviceId)}`);
+        }
+        const imageId = getStringMetadata(node, 'image');
+        if (imageId) {
+            lines.push(`        ${identifierFor(`infra:${imageId}`)} = infrastructureNode "${escapeDsl(imageId)}" "Container image" "Image"`);
+        }
+        lines.push('    }');
+    }
+    lines.push('}');
+    return lines;
+}
+function groupComponentsByWorkspaceGroup(components) {
+    const grouped = new Map();
+    for (const component of components) {
+        const groupName = getStringMetadata(component, 'group') || '.';
+        if (!grouped.has(groupName)) {
+            grouped.set(groupName, []);
+        }
+        grouped.get(groupName).push(component);
+    }
+    for (const group of grouped.values()) {
+        group.sort((left, right) => left.name.localeCompare(right.name));
+    }
+    return new Map([...grouped.entries()].sort((left, right) => left[0].localeCompare(right[0])));
+}
+function isWorkspaceProxy(element) {
+    return element.id === WORKSPACE_CONTAINER_ID;
+}
+function mapElementKindForStaticDsl(kind) {
+    switch (kind) {
+        case 'image':
+        case 'deployment-node':
+            return 'container';
+        default:
+            return kind;
+    }
+}
+function getStringMetadata(element, field) {
+    const value = element.metadata[field];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function identifierFor(value) {
+    return value.replace(/[^A-Za-z0-9_]/g, '_');
+}
+function escapeDsl(value) {
+    return value.replace(/"/g, '\\"');
+}
+function dedupe(values) {
+    return [...new Set(values)];
+}
+//# sourceMappingURL=architecture-ir-exporters.js.map

package/dist/panoramic/exporters/architecture-ir-exporters.js.map

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

package/dist/panoramic/exporters/export-types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 多格式导出相关类型定义
+ * 供 obsidian-exporter.ts 和 html-exporter.ts 共同使用
+ * 无运行时依赖，纯类型文件
+ */
+/** 支持的导出格式 */
+export type ExportFormat = 'obsidian' | 'html';
+/** 导出配置 */
+export interface ExportConfig {
+    /** 导出格式 */
+    format: ExportFormat;
+    /** 输出目录（绝对路径或相对于 cwd 的路径） */
+    outputDir: string;
+}
+/** 导出结果 */
+export interface ExportResult {
+    /** 生成的文件路径列表（绝对路径） */
+    files: string[];
+    /** 生成文件总数 */
+    fileCount: number;
+    /** 执行耗时（毫秒） */
+    durationMs: number;
+}
+/** Obsidian 页面内容表示（内存中间状态，尚未写盘） */
+export interface ObsidianPage {
+    /** 相对于 outputDir 的文件路径（如 "communities/community-0.md"） */
+    relativePath: string;
+    /** 文件内容（Markdown 字符串） */
+    content: string;
+    /** 仅 god-nodes 页面填充，用于碰撞检测时生成 disambiguator */
+    nodeId?: string;
+}
+//# sourceMappingURL=export-types.d.ts.map

package/dist/panoramic/exporters/export-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-types.d.ts","sourceRoot":"","sources":["../../../src/panoramic/exporters/export-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc;AACd,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/C,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/panoramic/exporters/export-types.js

@@ -0,0 +1,7 @@
+/**
+ * 多格式导出相关类型定义
+ * 供 obsidian-exporter.ts 和 html-exporter.ts 共同使用
+ * 无运行时依赖，纯类型文件
+ */
+export {};
+//# sourceMappingURL=export-types.js.map

package/dist/panoramic/exporters/export-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-types.js","sourceRoot":"","sources":["../../../src/panoramic/exporters/export-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}