spectra-cli 4.1.1

package/dist/panoramic/graph/graph-types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * 知识图谱核心类型定义
+ * 定义 GraphNode、GraphEdge、GraphJSON、ConfidenceLevel 等图谱数据模型
+ * 遵循 NetworkX node-link 格式，供下游 Feature 102/105/107 消费
+ */
+import type { ExtractionResult } from '../../extraction/extraction-types.js';
+/**
+ * 统一三级置信度标签
+ * - EXTRACTED：AST 直接提取的确定性关系（import、call、contains）
+ * - INFERRED：LLM 推理的语义关系
+ * - AMBIGUOUS：弱信号、间接引用
+ */
+export type ConfidenceLevel = 'EXTRACTED' | 'INFERRED' | 'AMBIGUOUS';
+/**
+ * F4 新增：语义边类型联合（供 direction-audit 白名单使用）
+ * - references：文档直接引用代码实体（如 spec 中明确提到函数名）
+ * - conceptually_related_to：概念层面相关（向量相似度驱动）
+ * - rationale_for：文档章节为代码决策提供设计依据
+ */
+export type SemanticEdgeRelation = 'references' | 'conceptually_related_to' | 'rationale_for';
+/**
+ * 语义边类型注册表（const 对象，供 direction-audit 白名单引用）
+ * 三个 key 均可从模块导入，用于运行时类型判断
+ */
+export declare const SEMANTIC_EDGE_RELATIONS: {
+    readonly REFERENCES: "references";
+    readonly CONCEPTUALLY_RELATED_TO: "conceptually_related_to";
+    readonly RATIONALE_FOR: "rationale_for";
+};
+/**
+ * 图谱节点
+ * 表示模块、包、组件、Spec 文档等知识实体
+ */
+export interface GraphNode {
+    /** 节点唯一标识符，通常为文件路径或元素 ID */
+    id: string;
+    /** 节点类型：模块 / 包 / 组件 / 服务 / Spec 文档 / 通用文档 / API / API Schema / 事件 / 图表（Feature 107 扩展） */
+    kind: 'module' | 'package' | 'component' | 'service' | 'spec' | 'document' | 'api' | 'api-schema' | 'event' | 'diagram';
+    /** 显示标签，人类可读名称 */
+    label: string;
+    /** 附加元数据（来源标记、technology 等扩展信息） */
+    metadata: Record<string, unknown>;
+}
+/**
+ * 图谱边（关系）
+ * 表示节点之间的有向或无向关系
+ *
+ * schema v2.0 新增字段：evidenceText、evidenceSource
+ * 新增允许的 relation 值：'references' | 'conceptually_related_to' | 'rationale_for'
+ */
+export interface GraphEdge {
+    /** 来源节点 ID */
+    source: string;
+    /** 目标节点 ID */
+    target: string;
+    /** 关系类型（来自 ArchitectureIRRelationshipKind 或 DocGraphReference.kind 等） */
+    relation: string;
+    /** 统一三级置信度标签 */
+    confidence: ConfidenceLevel;
+    /** 置信度数值分数，范围 [0.0, 1.0] */
+    confidenceScore: number;
+    /**
+     * schema v2.0 新增：证据文本（最大 200 字符）
+     * INFERRED/AMBIGUOUS 语义边非空；EXTRACTED 边可省略
+     */
+    evidenceText?: string;
+    /**
+     * schema v2.0 新增：证据来源（格式 "repo-relative-path:startLine-endLine"）
+     * 示例："specs/ingestion.md:15-18"
+     */
+    evidenceSource?: string;
+}
+/**
+ * F4 新增：超边（Hyperedge）
+ * 连接 3 个以上节点的命名关系，由 LLM 从 design-doc 描述中提取
+ * 用于表示命名流程、跨模块协作等多节点语义关系
+ */
+export interface Hyperedge {
+    /** 超边唯一标识符（UUID v4） */
+    id: string;
+    /** 超边标签（≤ 8 Unicode 字符，人类可读的流程名称） */
+    label: string;
+    /** 参与节点 ID 列表（≥ 3 个，至少 1 个非 doc-section 代码节点） */
+    nodes: string[];
+    /** LLM 提取的设计依据（非空字符串，最大 200 字符） */
+    rationale: string;
+    /** 置信度（LLM 提取一般为 INFERRED 或 AMBIGUOUS） */
+    confidence: ConfidenceLevel;
+}
+/**
+ * 图谱 JSON 输出格式
+ * 严格遵循 NetworkX node-link 格式，可通过 nx.json_graph.node_link_graph() 无错加载
+ *
+ * schema v2.0 变更：
+ * - schemaVersion 从字面量 '1.0' 扩展为联合类型 '1.0' | '2.0'
+ * - 新增顶层 hyperedges? 字段（optional，向后兼容）
+ */
+export interface GraphJSON {
+    /** 是否有向图（默认 false，无向图） */
+    directed: boolean;
+    /** 是否多重图（本 Feature 固定为 false） */
+    multigraph: false;
+    /** 图级元数据 */
+    graph: {
+        /** 图谱名称，固定为 'spectra-knowledge-graph' */
+        name: 'spectra-knowledge-graph';
+        /** ISO 8601 生成时间戳 */
+        generatedAt: string;
+        /** 节点总数 */
+        nodeCount: number;
+        /** 边总数 */
+        edgeCount: number;
+        /** 图构建使用的数据源列表（Feature 107 扩展：新增 'extraction' 数据源） */
+        sources: ('architecture-ir' | 'doc-graph' | 'cross-reference' | 'extraction')[];
+        /** 被跳过的数据源及原因（容错标注） */
+        skippedSources?: Array<{
+            source: string;
+            reason: string;
+        }>;
+        /** Feature 100 cache：输入内容 hash（SHA-256 前 16 位） */
+        inputHash?: string;
+        /**
+         * graph.json 格式版本号，用于下游 Feature 兼容性判断
+         * schema v2.0 扩展为联合类型，'1.0' 文件仍可赋值给此接口
+         */
+        schemaVersion: '1.0' | '2.0';
+    };
+    /** 节点数组 */
+    nodes: GraphNode[];
+    /** 边数组（NetworkX node-link 格式使用 "links" 键） */
+    links: GraphEdge[];
+    /**
+     * schema v2.0 新增：超边数组（optional，v1.0 文件无此字段时默认 undefined）
+     * 由 LLM hyperedge 提取链路写入，MCP graph_hyperedges 工具读取
+     */
+    hyperedges?: Hyperedge[];
+}
+/**
+ * buildKnowledgeGraph 的输入选项
+ * 所有数据源字段均可选，缺失时 graceful skip
+ * 使用宽松类型（unknown 基础结构）避免循环依赖，
+ * graph-builder.ts 内部使用 as 转换为具体类型
+ */
+export interface BuildGraphOptions {
+    /** Architecture IR 数据（可选，缺失时跳过 IR 节点和关系） */
+    architectureIR?: any;
+    /** Doc Graph 数据（可选，缺失时跳过文档节点） */
+    docGraph?: any;
+    /** Cross Reference Link 列表（可选，缺失时跳过跨引用边） */
+    crossReferenceLinks?: any[];
+    /** 是否生成有向图，默认 false */
+    directed?: boolean;
+    /** 多模态提取结果（可选，缺失或为空数组时跳过第四路合并）— Feature 107 */
+    extractionResults?: ExtractionResult[];
+}
+//# sourceMappingURL=graph-types.d.ts.map

package/dist/panoramic/graph/graph-types.d.ts.map

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

package/dist/panoramic/graph/graph-types.js

@@ -0,0 +1,10 @@
+/**
+ * 语义边类型注册表（const 对象，供 direction-audit 白名单引用）
+ * 三个 key 均可从模块导入，用于运行时类型判断
+ */
+export const SEMANTIC_EDGE_RELATIONS = {
+    REFERENCES: 'references',
+    CONCEPTUALLY_RELATED_TO: 'conceptually_related_to',
+    RATIONALE_FOR: 'rationale_for',
+};
+//# sourceMappingURL=graph-types.js.map

package/dist/panoramic/graph/graph-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.js","sourceRoot":"","sources":["../../../src/panoramic/graph/graph-types.ts"],"names":[],"mappings":"AAkCA;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE,YAAY;IACxB,uBAAuB,EAAE,yBAAyB;IAClD,aAAa,EAAE,eAAe;CACtB,CAAC"}

package/dist/panoramic/graph/index.d.ts

@@ -0,0 +1,6 @@
+export type { ConfidenceLevel, GraphNode, GraphEdge, GraphJSON, BuildGraphOptions } from './graph-types.js';
+export { buildKnowledgeGraph, writeKnowledgeGraph, enrichNodeDegrees } from './graph-builder.js';
+export { CONFIDENCE_SCORES, mapDocConfidence, mapEvidenceConfidence } from './confidence-mapper.js';
+export { GraphQueryEngine } from './graph-query.js';
+export type { QueryResult, NodeResult, PathResult, CommunityResult, GodNodesResult } from './graph-query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/panoramic/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panoramic/graph/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG5G,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGjG,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/panoramic/graph/index.js

@@ -0,0 +1,8 @@
+// graph 模块统一导出入口，供 batch-orchestrator 和 CLI 使用
+// 构建函数
+export { buildKnowledgeGraph, writeKnowledgeGraph, enrichNodeDegrees } from './graph-builder.js';
+// 映射函数与常量
+export { CONFIDENCE_SCORES, mapDocConfidence, mapEvidenceConfidence } from './confidence-mapper.js';
+// 图谱查询引擎与结果类型
+export { GraphQueryEngine } from './graph-query.js';
+//# sourceMappingURL=index.js.map

package/dist/panoramic/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/panoramic/graph/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAK/C,OAAO;AACP,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEjG,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpG,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/panoramic/hyperedges/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Hyperedges 模块共享常量
+ *
+ * 将多处复用的常量集中到本文件，避免定义漂移（quality-review W-4）。
+ */
+import type { GraphNode } from '../graph/graph-types.js';
+/**
+ * 视为"文档类节点"的 kind 集合
+ *
+ * 这类节点不算"代码节点"，不参与 hyperedge 的代码节点语义校验。
+ * 在生成 prompt 的 `availableCodeNodes` 列表时也会被过滤掉。
+ *
+ * 新增文档类节点 kind（如 `diagram`）时仅需修改本处。
+ */
+export declare const DOC_NODE_KINDS: ReadonlySet<GraphNode['kind']>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/panoramic/hyperedges/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/panoramic/hyperedges/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAGxD,CAAC"}

package/dist/panoramic/hyperedges/constants.js

@@ -0,0 +1,13 @@
+/**
+ * 视为"文档类节点"的 kind 集合
+ *
+ * 这类节点不算"代码节点"，不参与 hyperedge 的代码节点语义校验。
+ * 在生成 prompt 的 `availableCodeNodes` 列表时也会被过滤掉。
+ *
+ * 新增文档类节点 kind（如 `diagram`）时仅需修改本处。
+ */
+export const DOC_NODE_KINDS = new Set([
+    'spec',
+    'document',
+]);
+//# sourceMappingURL=constants.js.map

package/dist/panoramic/hyperedges/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/panoramic/hyperedges/constants.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmC,IAAI,GAAG,CAAoB;IACvF,MAAM;IACN,UAAU;CACX,CAAC,CAAC"}

package/dist/panoramic/hyperedges/extractor.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Hyperedge Extractor
+ *
+ * 通过 LLM（Anthropic SDK）从 design-doc 中提取超边（hyperedge）。
+ *
+ * 架构决策（analyze F06）：
+ * - feature flag 作为 boolean 参数传入，extractor 不读取 process.env 或 argv
+ * - CLI 层面（doc-graph-builder.ts）负责从 SPECTRA_HYPEREDGES_ENABLED env + --hyperedges CLI 合并后传入
+ *
+ * 失败处理策略：
+ * - Zod 校验失败：静默丢弃，写入 failedSamples + trace 日志
+ * - 整 batch 失败：返回空数组，不抛出异常
+ * - LLM 网络错误：抛出异常（由上层处理）
+ * - 所有 nodes 均为文档类节点：语义校验过滤，返回空数组
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import type { z } from 'zod';
+import type { GraphNode, Hyperedge } from '../graph/graph-types.js';
+import type { DocChunk } from '../anchoring/chunker.js';
+import type { EmbeddingTokenUsage } from '../anchoring/embedding-provider.js';
+/**
+ * extractHyperedges 的输入选项
+ */
+export interface ExtractHyperedgesOptions {
+    /**
+     * feature flag：是否启用 hyperedge 提取
+     * 由 caller（doc-graph-builder.ts）从 env + CLI 合并后传入
+     * extractor 本身不读取 process.env 或 argv
+     */
+    enabled: boolean;
+    /** 图谱代码节点列表（用于构造 prompt + 语义校验） */
+    codeNodes: GraphNode[];
+    /** 文档切片列表（来自 chunkMarkdownFiles） */
+    docChunks: DocChunk[];
+    /** 可选的项目摘要（帮助 LLM 理解上下文） */
+    projectSummary?: string;
+    /** Anthropic SDK 客户端实例（由 caller 传入，便于测试 mock） */
+    anthropicClient: Anthropic;
+    /** LLM 模型 ID，默认 claude-haiku-4-5-20251001 */
+    model?: string;
+}
+/**
+ * extractHyperedges 的返回值
+ */
+export interface ExtractResult {
+    /** 提取并通过校验的超边列表 */
+    hyperedges: Hyperedge[];
+    /**
+     * LLM 调用的 token 使用记录（与 EmbeddingTokenUsage 格式兼容）
+     * feature flag 关闭时为空数组
+     */
+    usage: EmbeddingTokenUsage[];
+    /**
+     * 校验失败的原始样本
+     * 用于 trace 日志记录。errors 可能是 Zod schema 校验失败（`z.ZodError`），
+     * 也可能是 JSON 解析阶段的 `Error`（LLM 输出非法 JSON）。
+     */
+    failedSamples: Array<{
+        raw: unknown;
+        errors: z.ZodError | Error;
+    }>;
+}
+/**
+ * 从 design-doc 中提取 hyperedge 超边
+ *
+ * 步骤：
+ * 1. 检查 feature flag，关闭时直接返回空结果
+ * 2. 检查 docChunks，无文档内容时直接返回空结果
+ * 3. 构造 LLM prompt
+ * 4. 调用 Anthropic SDK，记录 tokenUsage
+ * 5. 解析 JSON 响应
+ * 6. HyperedgesOutputSchema.safeParse 校验
+ * 7. 语义校验：每条 hyperedge 的 nodes 中至少 1 个为代码节点
+ * 8. 返回合法 hyperedge 列表
+ *
+ * @param options ExtractHyperedgesOptions
+ * @returns ExtractResult
+ */
+export declare function extractHyperedges(options: ExtractHyperedgesOptions): Promise<ExtractResult>;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/panoramic/hyperedges/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/panoramic/hyperedges/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAU9E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,oCAAoC;IACpC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,eAAe,EAAE,SAAS,CAAC;IAC3B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;;OAGG;IACH,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B;;;;OAIG;IACH,aAAa,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAA;KAAE,CAAC,CAAC;CACpE;AAmBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CA+HxB"}

package/dist/panoramic/hyperedges/extractor.js

@@ -0,0 +1,133 @@
+import { buildHyperedgePrompt } from './prompt.js';
+import { HyperedgesOutputSchema } from './schema.js';
+import { extractJsonArray } from '../utils/llm-facade.js';
+import { DOC_NODE_KINDS } from './constants.js';
+// ============================================================
+// 默认配置
+// ============================================================
+/** 默认 LLM 模型（Haiku，成本低，适合结构化提取） */
+const DEFAULT_MODEL = 'claude-haiku-4-5-20251001';
+/** LLM 最大输出 token 数 */
+const MAX_TOKENS = 2048;
+/** LLM 温度（低温，提高结构化输出稳定性） */
+const TEMPERATURE = 0.1;
+// ============================================================
+// 主函数
+// ============================================================
+/**
+ * 从 design-doc 中提取 hyperedge 超边
+ *
+ * 步骤：
+ * 1. 检查 feature flag，关闭时直接返回空结果
+ * 2. 检查 docChunks，无文档内容时直接返回空结果
+ * 3. 构造 LLM prompt
+ * 4. 调用 Anthropic SDK，记录 tokenUsage
+ * 5. 解析 JSON 响应
+ * 6. HyperedgesOutputSchema.safeParse 校验
+ * 7. 语义校验：每条 hyperedge 的 nodes 中至少 1 个为代码节点
+ * 8. 返回合法 hyperedge 列表
+ *
+ * @param options ExtractHyperedgesOptions
+ * @returns ExtractResult
+ */
+export async function extractHyperedges(options) {
+    const { enabled, codeNodes, docChunks, projectSummary, anthropicClient, model = DEFAULT_MODEL, } = options;
+    // Step 1：feature flag 关闭 → 提前返回空结果
+    if (!enabled) {
+        return { hyperedges: [], usage: [], failedSamples: [] };
+    }
+    // Step 2：无文档内容 → 提前返回空结果（FR-015 零 doc chunk 降级）
+    if (docChunks.length === 0) {
+        return { hyperedges: [], usage: [], failedSamples: [] };
+    }
+    // Step 3：构造 prompt
+    const prompt = buildHyperedgePrompt(codeNodes, docChunks, projectSummary);
+    // Step 4：调用 LLM，记录 tokenUsage 和耗时
+    const startMs = performance.now();
+    let rawContent;
+    let inputTokens;
+    let outputTokens;
+    const response = await anthropicClient.messages.create({
+        model,
+        max_tokens: MAX_TOKENS,
+        temperature: TEMPERATURE,
+        messages: [{ role: 'user', content: prompt }],
+    });
+    const durationMs = performance.now() - startMs;
+    rawContent = response.content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('\n');
+    inputTokens = response.usage.input_tokens;
+    outputTokens = response.usage.output_tokens;
+    const tokenUsage = {
+        llmModel: model,
+        inputTokens,
+        outputTokens,
+        durationMs,
+    };
+    // Step 5：解析 JSON
+    let parsedRaw;
+    try {
+        parsedRaw = extractJsonArray(rawContent);
+        // extractJsonArray 期望返回数组，但 LLM 输出是 { hyperedges: [] } 对象
+        // 需要特殊处理：尝试直接 JSON.parse
+    }
+    catch {
+        // extractJsonArray 可能失败（LLM 返回对象而不是数组），尝试直接 parse
+        try {
+            parsedRaw = JSON.parse(rawContent);
+        }
+        catch {
+            // JSON 解析失败 → trace 日志，返回空结果
+            console.error('[hyperedges/extractor] LLM 返回无效 JSON，原始内容:', rawContent.slice(0, 200));
+            return {
+                hyperedges: [],
+                usage: [tokenUsage],
+                failedSamples: [{ raw: rawContent, errors: new Error('JSON 解析失败') }],
+            };
+        }
+    }
+    // 如果 extractJsonArray 返回数组（兜底），包装为正确格式
+    if (Array.isArray(parsedRaw)) {
+        parsedRaw = { hyperedges: parsedRaw };
+    }
+    // Step 6：Zod schema 校验（schema 层：结构 + label ≤ 8 + nodes ≥ 3 + batch ≤ 10）
+    const parseResult = HyperedgesOutputSchema.safeParse(parsedRaw);
+    if (!parseResult.success) {
+        // 校验失败 → trace 日志，返回空结果
+        console.error('[hyperedges/extractor] Zod 校验失败:', parseResult.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; '));
+        console.error('[hyperedges/extractor] 原始输出:', JSON.stringify(parsedRaw).slice(0, 300));
+        return {
+            hyperedges: [],
+            usage: [tokenUsage],
+            failedSamples: [{ raw: parsedRaw, errors: parseResult.error }],
+        };
+    }
+    // Step 7：语义校验——每条 hyperedge 至少 1 个代码节点（FR-020）
+    // 构造当前代码节点 ID set（kind 不在 DOC_NODE_KINDS 中的节点）
+    const codeNodeIdSet = new Set(codeNodes.filter((n) => !DOC_NODE_KINDS.has(n.kind)).map((n) => n.id));
+    const semanticallyValid = [];
+    for (const he of parseResult.data.hyperedges) {
+        const hasCodeNode = he.nodes.some((nodeId) => codeNodeIdSet.has(nodeId));
+        if (!hasCodeNode) {
+            // 语义校验失败：全部节点为文档类节点，trace 日志
+            console.error(`[hyperedges/extractor] hyperedge "${he.id}" (label: "${he.label}") 语义校验失败：nodes 中无代码节点，已丢弃`);
+            continue;
+        }
+        // 转换为 Hyperedge 类型（结构兼容，直接使用）
+        semanticallyValid.push({
+            id: he.id,
+            label: he.label,
+            nodes: he.nodes,
+            rationale: he.rationale,
+            confidence: he.confidence,
+        });
+    }
+    return {
+        hyperedges: semanticallyValid,
+        usage: [tokenUsage],
+        failedSamples: [],
+    };
+}
+//# sourceMappingURL=extractor.js.map

package/dist/panoramic/hyperedges/extractor.js.map

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

package/dist/panoramic/hyperedges/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * hyperedges 模块对外接口
+ *
+ * 导出 extractHyperedges 函数、相关类型和 Zod schema
+ * 供 doc-graph-builder.ts 和其他调用方使用
+ */
+export { extractHyperedges } from './extractor.js';
+export type { ExtractHyperedgesOptions, ExtractResult } from './extractor.js';
+export { HyperedgesOutputSchema, HyperedgeSchema } from './schema.js';
+export type { HyperedgeOutput, HyperedgeInput } from './schema.js';
+export { buildHyperedgePrompt } from './prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/panoramic/hyperedges/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panoramic/hyperedges/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAM9E,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/panoramic/hyperedges/index.js

@@ -0,0 +1,19 @@
+/**
+ * hyperedges 模块对外接口
+ *
+ * 导出 extractHyperedges 函数、相关类型和 Zod schema
+ * 供 doc-graph-builder.ts 和其他调用方使用
+ */
+// ============================================================
+// 主函数 + 类型导出
+// ============================================================
+export { extractHyperedges } from './extractor.js';
+// ============================================================
+// Zod schema + 类型导出
+// ============================================================
+export { HyperedgesOutputSchema, HyperedgeSchema } from './schema.js';
+// ============================================================
+// Prompt 构造器导出（供测试/调试使用）
+// ============================================================
+export { buildHyperedgePrompt } from './prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/panoramic/hyperedges/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/panoramic/hyperedges/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGtE,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/panoramic/hyperedges/prompt.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Hyperedge LLM prompt 构造器
+ *
+ * 输入：代码节点列表 + 文档 chunk 列表 + 可选的项目摘要
+ * 输出：用于指导 LLM 提取 design-doc 显式命名流程/阶段的 prompt 字符串
+ *
+ * 约束：
+ * - 代码节点最多取 20 个（仅非文档类节点，FR-021）
+ * - 文档 chunk 最多取 10 个
+ * - prompt 体积控制在 4000 tokens 以内（字符数 / 4 粗估）
+ * - 明确指示 LLM 每次最多输出 10 个 hyperedge（FR-018）
+ * - 明确指示 rationale_for 边的生成条件
+ */
+import type { GraphNode } from '../graph/graph-types.js';
+import type { DocChunk } from '../anchoring/chunker.js';
+/**
+ * 构造 LLM hyperedge 提取 prompt
+ *
+ * 流程：
+ * 1. 过滤出代码节点（kind 不在 DOC_NODE_KINDS 中），最多 20 个
+ * 2. 取 docChunks 最多 10 个
+ * 3. 序列化为 prompt 字符串，体积控制在 ~4000 tokens
+ *
+ * @param nodes - 图谱节点列表（来自 GraphJSON.nodes）
+ * @param docChunks - 文档切片列表（来自 chunkMarkdownFiles）
+ * @param projectSummary - 可选的项目简介（用于帮助 LLM 理解上下文）
+ * @returns LLM 用户 prompt 字符串
+ */
+export declare function buildHyperedgePrompt(nodes: GraphNode[], docChunks: DocChunk[], projectSummary?: string): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/panoramic/hyperedges/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/panoramic/hyperedges/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAOxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,EAAE,QAAQ,EAAE,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CA0ER"}

package/dist/panoramic/hyperedges/prompt.js

@@ -0,0 +1,88 @@
+import { DOC_NODE_KINDS } from './constants.js';
+// ============================================================
+// 公开 API
+// ============================================================
+/**
+ * 构造 LLM hyperedge 提取 prompt
+ *
+ * 流程：
+ * 1. 过滤出代码节点（kind 不在 DOC_NODE_KINDS 中），最多 20 个
+ * 2. 取 docChunks 最多 10 个
+ * 3. 序列化为 prompt 字符串，体积控制在 ~4000 tokens
+ *
+ * @param nodes - 图谱节点列表（来自 GraphJSON.nodes）
+ * @param docChunks - 文档切片列表（来自 chunkMarkdownFiles）
+ * @param projectSummary - 可选的项目简介（用于帮助 LLM 理解上下文）
+ * @returns LLM 用户 prompt 字符串
+ */
+export function buildHyperedgePrompt(nodes, docChunks, projectSummary) {
+    // 只保留代码节点（过滤掉文档类节点），最多 20 个
+    const codeNodes = nodes
+        .filter((n) => !DOC_NODE_KINDS.has(n.kind))
+        .slice(0, 20);
+    // 最多取 10 个 doc chunk
+    const selectedChunks = docChunks.slice(0, 10);
+    // 序列化代码节点列表
+    const nodesSection = codeNodes.length > 0
+        ? codeNodes
+            .map((n) => `- id: ${n.id} | kind: ${n.kind} | label: ${n.label}`)
+            .join('\n')
+        : '（无代码节点）';
+    // 序列化文档 chunk 列表
+    const chunksSection = selectedChunks.length > 0
+        ? selectedChunks
+            .map((c, i) => {
+            // 每个 chunk 文本截断到 300 字符，避免 prompt 超限
+            const text = c.text.length > 300 ? `${c.text.slice(0, 300)}...` : c.text;
+            return `[Chunk ${i + 1}] ${c.filePath}#${c.headingPath}\n${text}`;
+        })
+            .join('\n\n')
+        : '（无文档内容）';
+    // 可选项目摘要
+    const summarySection = projectSummary
+        ? `项目简介：\n${projectSummary.slice(0, 500)}\n\n`
+        : '';
+    return `你是一位软件架构分析专家。请从以下设计文档内容中，识别**显式命名的流程、阶段、协作模式**，并为每个识别到的流程提取一个"超边（hyperedge）"。
+
+超边表示一个命名流程/阶段，连接参与该流程的 3 个或更多代码模块节点。
+
+## 代码节点列表（可参与超边）
+
+${nodesSection}
+
+## 设计文档内容
+
+${summarySection}${chunksSection}
+
+## 输出要求
+
+请输出 JSON 格式，结构如下：
+\`\`\`json
+{
+  "hyperedges": [
+    {
+      "id": "he-<唯一编号，如 he-001>",
+      "label": "<流程名称，最多 8 个中文/英文字符>",
+      "nodes": ["<代码节点ID1>", "<代码节点ID2>", "<代码节点ID3>", ...],
+      "rationale": "<说明为何这些节点共同参与该流程，最多 200 字符>",
+      "confidence": "INFERRED"
+    }
+  ]
+}
+\`\`\`
+
+## 规则
+
+1. **每次最多输出 10 个 hyperedge**（FR-018）
+2. **nodes 列表必须包含至少 3 个节点**，且**至少 1 个必须来自"代码节点列表"**
+3. **label 最多 8 个 Unicode 字符**（含中文、英文字符均算 1 个）
+4. **rationale 不能为空，最多 200 字符**，说明 LLM 识别该流程的依据
+5. **confidence 固定填写 "INFERRED"**（LLM 推理结果）
+6. **rationale_for 边说明**：如果某个文档章节明确为某代码决策提供了设计依据（如"为什么选择 X 方案"），在 rationale 中注明 "rationale_for:<设计决策描述>"
+7. **只提取设计文档中有明确名称的流程或阶段**，不要凭空臆造
+8. **nodes 中的 ID 必须来自"代码节点列表"中的真实 ID**，不要使用未列出的 ID
+9. 若无法识别任何合法的超边，输出 \`{ "hyperedges": [] }\`
+
+请直接输出 JSON，不要添加其他说明文字。`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/panoramic/hyperedges/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/panoramic/hyperedges/prompt.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAkB,EAClB,SAAqB,EACrB,cAAuB;IAEvB,4BAA4B;IAC5B,MAAM,SAAS,GAAG,KAAK;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC1C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,qBAAqB;IACrB,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE9C,YAAY;IACZ,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,SAAS;aACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC;aACjE,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,SAAS,CAAC;IAEd,iBAAiB;IACjB,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;QAC7C,CAAC,CAAC,cAAc;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACZ,qCAAqC;YACrC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACzE,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACpE,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC;QACjB,CAAC,CAAC,SAAS,CAAC;IAEd,SAAS;IACT,MAAM,cAAc,GAAG,cAAc;QACnC,CAAC,CAAC,UAAU,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM;QAC9C,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;EAMP,YAAY;;;;EAIZ,cAAc,GAAG,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA+BT,CAAC;AACxB,CAAC"}