spectra-cli 4.1.1 → 4.2.0

package/dist/panoramic/qa/__tests__/index.test.js

@@ -0,0 +1,246 @@
+/**
+ * index.test.ts
+ * T-020 单元测试：answerQuestion() 7 步串联 + 边界条件
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { answerQuestion, clearEngineCache } from '../index.js';
+// ============================================================
+// Mock 所有依赖模块
+// ============================================================
+// Mock GraphQueryEngine（避免读取真实 graph.json）
+vi.mock('../../graph/graph-query.js', () => ({
+    GraphQueryEngine: {
+        loadFromFile: vi.fn(),
+    },
+}));
+vi.mock('../../graph/graph-paths.js', () => ({
+    resolveGraphJsonPath: vi.fn().mockReturnValue('/project/specs/_meta/graph.json'),
+}));
+vi.mock('../graph-retriever.js', () => ({
+    retrieveGraphContext: vi.fn(),
+}));
+vi.mock('../rag-reranker.js', () => ({
+    rerankWithEmbedding: vi.fn(),
+}));
+vi.mock('../debt-context.js', () => ({
+    injectDebtContext: vi.fn(),
+}));
+vi.mock('../citation.js', () => ({
+    buildCitations: vi.fn(),
+}));
+vi.mock('../prompt-builder.js', () => ({
+    buildQnAPrompt: vi.fn(),
+}));
+vi.mock('../llm-caller.js', () => ({
+    callQnALlm: vi.fn(),
+}));
+import { GraphQueryEngine } from '../../graph/graph-query.js';
+import { retrieveGraphContext } from '../graph-retriever.js';
+import { rerankWithEmbedding } from '../rag-reranker.js';
+import { injectDebtContext } from '../debt-context.js';
+import { buildCitations } from '../citation.js';
+import { buildQnAPrompt } from '../prompt-builder.js';
+import { callQnALlm } from '../llm-caller.js';
+// ============================================================
+// Mock 数据设置工具
+// ============================================================
+/** 设置正常流程的 mock 数据 */
+function setupNormalMocks() {
+    const mockEngine = {
+        query: vi.fn(),
+        getHyperedges: vi.fn(),
+        getNode: vi.fn(),
+        findPath: vi.fn(),
+        getCommunity: vi.fn(),
+        getSemanticEdges: vi.fn(),
+        graph: { nodes: [{ id: 'n1' }] },
+    };
+    vi.mocked(GraphQueryEngine.loadFromFile).mockReturnValue(mockEngine);
+    vi.mocked(retrieveGraphContext).mockReturnValue({
+        bfsNodes: [
+            { id: 'node-auth', label: '认证模块', kind: 'module' },
+            { id: 'node-db', label: '数据库', kind: 'module' },
+            { id: 'node-session', label: '会话', kind: 'module' },
+        ],
+        topChunks: [],
+        hyperedges: [],
+        fallbackMode: undefined,
+    });
+    vi.mocked(rerankWithEmbedding).mockResolvedValue({
+        rankedChunks: [
+            {
+                chunk: {
+                    filePath: 'specs/auth.md',
+                    startLine: 5,
+                    endLine: 10,
+                    headingPath: '## Auth',
+                    text: '认证模块说明',
+                    tokenCount: 20,
+                },
+                similarity: 0.85,
+                nodeId: 'node-auth',
+            },
+        ],
+    });
+    vi.mocked(injectDebtContext).mockResolvedValue({
+        triggered: false,
+        citations: [],
+    });
+    vi.mocked(buildCitations).mockReturnValue([
+        {
+            specPath: 'specs/auth.md',
+            lineRange: { startLine: 5, endLine: 10 },
+            excerpt: '认证模块说明',
+            nodeId: 'node-auth',
+        },
+    ]);
+    vi.mocked(buildQnAPrompt).mockReturnValue({
+        systemPrompt: '你是助手',
+        userPrompt: '什么调用了认证模块',
+    });
+    vi.mocked(callQnALlm).mockResolvedValue({
+        answer: '认证模块被 LoginService 调用',
+        parsedCitations: [
+            {
+                specPath: 'specs/auth.md',
+                lineRange: { startLine: 5, endLine: 10 },
+                excerpt: '认证模块说明',
+            },
+        ],
+        tokenUsage: { input: 100, output: 50, overBudget: false },
+    });
+    return mockEngine;
+}
+// ============================================================
+// 默认选项
+// ============================================================
+const defaultOptions = {
+    projectRoot: '/project',
+};
+// ============================================================
+// 测试套件
+// ============================================================
+describe('answerQuestion', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        clearEngineCache();
+    });
+    afterEach(() => {
+        clearEngineCache();
+    });
+    describe('正常 7 步串联', () => {
+        it('应返回包含 text、citations、tokenUsage 的 QnAAnswer', async () => {
+            setupNormalMocks();
+            const query = { text: '什么调用了认证模块' };
+            const result = await answerQuestion(query, defaultOptions);
+            expect(result.text).toBeTruthy();
+            expect(Array.isArray(result.citations)).toBe(true);
+            expect(result.tokenUsage).toBeDefined();
+            expect(typeof result.durationMs).toBe('number');
+        });
+        it('应依次调用 retrieveGraphContext、rerankWithEmbedding、injectDebtContext、buildCitations、buildQnAPrompt、callQnALlm', async () => {
+            setupNormalMocks();
+            await answerQuestion({ text: '测试问题' }, defaultOptions);
+            expect(retrieveGraphContext).toHaveBeenCalledOnce();
+            expect(rerankWithEmbedding).toHaveBeenCalledOnce();
+            expect(injectDebtContext).toHaveBeenCalledOnce();
+            expect(buildCitations).toHaveBeenCalledOnce();
+            expect(buildQnAPrompt).toHaveBeenCalledOnce();
+            expect(callQnALlm).toHaveBeenCalledOnce();
+        });
+        it('应包含 durationMs 字段（> 0）', async () => {
+            setupNormalMocks();
+            const result = await answerQuestion({ text: '测试' }, defaultOptions);
+            expect(result.durationMs).toBeGreaterThanOrEqual(0);
+        });
+    });
+    describe('边界条件 — 空字符串查询', () => {
+        it('空字符串应抛出 Error（不调用 LLM）', async () => {
+            await expect(answerQuestion({ text: '' }, defaultOptions)).rejects.toThrow(/不能为空/);
+            expect(callQnALlm).not.toHaveBeenCalled();
+        });
+        it('全空格字符串应抛出 Error', async () => {
+            await expect(answerQuestion({ text: '   ' }, defaultOptions)).rejects.toThrow(/不能为空/);
+        });
+    });
+    describe('边界条件 — 超长查询截断', () => {
+        it('> 2000 字符的查询应截断到 2000 字符', async () => {
+            setupNormalMocks();
+            const longQuery = 'A'.repeat(2500);
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            await answerQuestion({ text: longQuery }, defaultOptions);
+            // retrieveGraphContext 应被调用，且问题被截断
+            expect(retrieveGraphContext).toHaveBeenCalledWith('A'.repeat(2000), expect.anything(), expect.anything());
+            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('截断'));
+            warnSpy.mockRestore();
+        });
+    });
+    describe('边界条件 — 空图谱', () => {
+        it('BFS 命中 0 节点时应返回"图谱为空"提示', async () => {
+            vi.mocked(GraphQueryEngine.loadFromFile).mockReturnValue({});
+            vi.mocked(retrieveGraphContext).mockReturnValue({
+                bfsNodes: [], // 0 个节点
+                topChunks: [],
+                hyperedges: [],
+                fallbackMode: 'rag-only',
+            });
+            const result = await answerQuestion({ text: '测试' }, defaultOptions);
+            expect(result.text).toContain('图谱为空');
+            expect(result.citations).toEqual([]);
+            expect(callQnALlm).not.toHaveBeenCalled();
+        });
+        it('图谱文件不存在时应返回友好提示', async () => {
+            vi.mocked(GraphQueryEngine.loadFromFile).mockImplementation(() => {
+                throw new Error('无法读取图谱文件');
+            });
+            const result = await answerQuestion({ text: '测试' }, defaultOptions);
+            expect(result.text).toContain('图谱为空');
+            expect(callQnALlm).not.toHaveBeenCalled();
+        });
+    });
+    describe('边界条件 — LLM 调用失败', () => {
+        it('LLM 调用失败时应抛出 Error', async () => {
+            setupNormalMocks();
+            vi.mocked(callQnALlm).mockRejectedValue(new Error('API 调用超时'));
+            await expect(answerQuestion({ text: '测试' }, defaultOptions)).rejects.toThrow(/LLM 调用失败/);
+        });
+    });
+    describe('citations 合并', () => {
+        it('LLM 解析的 citations 非空时应优先使用', async () => {
+            setupNormalMocks();
+            const llmCitations = [
+                {
+                    specPath: 'specs/login.md',
+                    lineRange: { startLine: 1, endLine: 5 },
+                    excerpt: 'LLM 提供的 citation',
+                },
+            ];
+            vi.mocked(callQnALlm).mockResolvedValue({
+                answer: '回答',
+                parsedCitations: llmCitations,
+                tokenUsage: { input: 100, output: 50, overBudget: false },
+            });
+            const result = await answerQuestion({ text: '测试' }, defaultOptions);
+            expect(result.citations).toEqual(llmCitations);
+        });
+        it('LLM 返回空 citations 时应 fallback 到 buildCitations 的结果', async () => {
+            setupNormalMocks();
+            const builtCitations = [
+                {
+                    specPath: 'specs/auth.md',
+                    lineRange: { startLine: 5, endLine: 10 },
+                    excerpt: 'built citation',
+                },
+            ];
+            vi.mocked(buildCitations).mockReturnValue(builtCitations);
+            vi.mocked(callQnALlm).mockResolvedValue({
+                answer: '回答',
+                parsedCitations: [], // LLM 没有解析到 citations
+                tokenUsage: { input: 100, output: 50, overBudget: false },
+            });
+            const result = await answerQuestion({ text: '测试' }, defaultOptions);
+            expect(result.citations).toEqual(builtCitations);
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/panoramic/qa/__tests__/index.test.js.map

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

package/dist/panoramic/qa/__tests__/llm-caller.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=llm-caller.test.d.ts.map

package/dist/panoramic/qa/__tests__/llm-caller.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-caller.test.d.ts","sourceRoot":"","sources":["../../../../src/panoramic/qa/__tests__/llm-caller.test.ts"],"names":[],"mappings":""}

package/dist/panoramic/qa/__tests__/llm-caller.test.js

@@ -0,0 +1,168 @@
+/**
+ * llm-caller.test.ts
+ * T-019 单元测试：budget-gate record-only + overBudget 标记 + 响应解析
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// ============================================================
+// Mock 依赖
+// ============================================================
+// Mock Anthropic SDK
+vi.mock('@anthropic-ai/sdk', () => {
+    const mockCreate = vi.fn();
+    const Anthropic = vi.fn(() => ({
+        messages: {
+            create: mockCreate,
+        },
+    }));
+    Anthropic._mockCreate = mockCreate;
+    return { default: Anthropic };
+});
+// Mock estimateFast（控制 token 估算量）
+vi.mock('../../../core/token-counter.js', () => ({
+    estimateFast: vi.fn().mockReturnValue(100),
+}));
+// Mock runBudgetGate（不真实执行）
+vi.mock('../../../batch/budget-gate.js', () => ({
+    runBudgetGate: vi.fn().mockResolvedValue({
+        finalPolicy: 'continue',
+        finalEstimate: 100,
+        skipEnrichmentApplied: false,
+        cheaperModelApplied: false,
+        attempts: [],
+    }),
+}));
+// Mock resolveReverseSpecModel（返回确定性模型）
+vi.mock('../../../core/model-selection.js', () => ({
+    resolveReverseSpecModel: vi.fn().mockReturnValue({ model: 'claude-test-model' }),
+}));
+import Anthropic from '@anthropic-ai/sdk';
+import { callQnALlm } from '../llm-caller.js';
+import { runBudgetGate } from '../../../batch/budget-gate.js';
+import { estimateFast } from '../../../core/token-counter.js';
+// 获取 mock create 函数
+const MockedAnthropicClass = vi.mocked(Anthropic);
+// ============================================================
+// 测试数据
+// ============================================================
+const testPrompt = {
+    systemPrompt: '你是代码库问答助手',
+    userPrompt: '什么调用了认证模块',
+};
+/** 正常的 JSON 格式 LLM 响应 */
+const normalJsonResponse = {
+    id: 'msg-001',
+    type: 'message',
+    role: 'assistant',
+    model: 'claude-test-model',
+    content: [
+        {
+            type: 'text',
+            text: JSON.stringify({
+                answer: '认证模块被 LoginService 调用 [来源：specs/auth.md:10-15]',
+                citations: [
+                    {
+                        specPath: 'specs/auth.md',
+                        startLine: 10,
+                        endLine: 15,
+                        excerpt: '登录服务调用认证模块',
+                    },
+                ],
+            }),
+        },
+    ],
+    stop_reason: 'end_turn',
+    usage: { input_tokens: 150, output_tokens: 80 },
+};
+// ============================================================
+// 测试套件
+// ============================================================
+describe('callQnALlm', () => {
+    let mockCreate;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // 重新获取 mock create 实例
+        const instance = new (vi.mocked(Anthropic))();
+        mockCreate = instance.messages.create;
+        mockCreate.mockResolvedValue(normalJsonResponse);
+    });
+    describe('正常调用路径', () => {
+        it('应调用 runBudgetGate（record-only 模式）', async () => {
+            await callQnALlm(testPrompt);
+            expect(runBudgetGate).toHaveBeenCalledWith(expect.objectContaining({
+                budget: Infinity,
+                preset: 'continue',
+                isTTY: false,
+            }));
+        });
+        it('应从项目配置读取模型 ID（不硬编码）', async () => {
+            await callQnALlm(testPrompt);
+            // 验证 Anthropic.messages.create 被调用（模型来自 resolveReverseSpecModel）
+            // 由于 Anthropic 是 mock，这里验证 runBudgetGate 被调用即可
+            expect(runBudgetGate).toHaveBeenCalled();
+        });
+        it('应返回包含 answer 的结果', async () => {
+            const result = await callQnALlm(testPrompt);
+            expect(result.answer).toBeTruthy();
+            expect(typeof result.answer).toBe('string');
+        });
+        it('应返回 tokenUsage 字段', async () => {
+            const result = await callQnALlm(testPrompt);
+            expect(result.tokenUsage).toBeDefined();
+            expect(typeof result.tokenUsage.input).toBe('number');
+            expect(typeof result.tokenUsage.output).toBe('number');
+            expect(typeof result.tokenUsage.overBudget).toBe('boolean');
+        });
+        it('正常调用时 overBudget 应为 false（估算 130 tokens < 6000 上限）', async () => {
+            // estimateFast mock 返回 100，total = 100 + 30 = 130 < 6000
+            vi.mocked(estimateFast).mockReturnValue(100);
+            const result = await callQnALlm(testPrompt);
+            expect(result.tokenUsage.overBudget).toBe(false);
+        });
+    });
+    describe('overBudget 标记', () => {
+        it('token 估算超过 hardcode 上限时 overBudget 应为 true', async () => {
+            // 让 estimateFast 返回一个超过限制的值（6000 / 1.3 ≈ 4616 → total ≈ 6000+）
+            vi.mocked(estimateFast).mockReturnValue(5000); // total = 5000 + 1500 = 6500 > 6000
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            const result = await callQnALlm(testPrompt);
+            expect(result.tokenUsage.overBudget).toBe(true);
+            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('qna token cost over hardcode limit'));
+            warnSpy.mockRestore();
+        });
+        it('超额时 LLM 调用不应被阻断（应继续返回结果）', async () => {
+            vi.mocked(estimateFast).mockReturnValue(5000);
+            const result = await callQnALlm(testPrompt);
+            // 超额但调用继续，应有 answer
+            expect(result.answer).toBeTruthy();
+            expect(result.tokenUsage.overBudget).toBe(true);
+        });
+    });
+    describe('响应解析', () => {
+        it('应从 JSON 响应中解析 parsedCitations', async () => {
+            const result = await callQnALlm(testPrompt);
+            // 验证 parsedCitations 结构（来自 normalJsonResponse 中的 citations 数组）
+            expect(Array.isArray(result.parsedCitations)).toBe(true);
+        });
+        it('LLM 返回非 JSON 文本时应 fallback 到原始文本作为 answer', async () => {
+            // 创建一个返回纯文本（非 JSON）的 mock
+            const plainTextResponse = {
+                ...normalJsonResponse,
+                content: [{ type: 'text', text: '这是纯文本回答，没有 JSON 格式' }],
+                usage: { input_tokens: 100, output_tokens: 50 },
+            };
+            // 需要直接 mock Anthropic client 实例
+            const AnthropicConstructor = vi.mocked(Anthropic);
+            const mockInstance = { messages: { create: vi.fn().mockResolvedValue(plainTextResponse) } };
+            Anthropic.mockImplementation
+                ? vi.mocked(Anthropic).mockImplementation(() => mockInstance)
+                : null;
+            // 使用新实例重新调用
+            vi.mocked(Anthropic).mockImplementationOnce(() => mockInstance);
+            const result = await callQnALlm(testPrompt);
+            // 非 JSON 时 answer 应包含原始文本
+            expect(typeof result.answer).toBe('string');
+            expect(result.answer.length).toBeGreaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=llm-caller.test.js.map

package/dist/panoramic/qa/__tests__/llm-caller.test.js.map

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

package/dist/panoramic/qa/__tests__/prompt-builder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt-builder.test.d.ts.map

package/dist/panoramic/qa/__tests__/prompt-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.test.d.ts","sourceRoot":"","sources":["../../../../src/panoramic/qa/__tests__/prompt-builder.test.ts"],"names":[],"mappings":""}

package/dist/panoramic/qa/__tests__/prompt-builder.test.js

@@ -0,0 +1,150 @@
+/**
+ * prompt-builder.test.ts
+ * T-018 单元测试：prompt 组装 + citation 内联格式 + hyperedge 候选列表
+ */
+import { describe, it, expect } from 'vitest';
+import { buildQnAPrompt } from '../prompt-builder.js';
+// ============================================================
+// 测试数据工厂
+// ============================================================
+function makeGraphCtx(overrides) {
+    return {
+        bfsNodes: [
+            { id: 'node-auth', label: '认证模块', kind: 'module' },
+            { id: 'node-db', label: '数据库层', kind: 'module' },
+        ],
+        topChunks: [],
+        hyperedges: [
+            {
+                id: 'he-1',
+                label: '登录流程',
+                nodes: ['node-auth', 'node-db', 'node-session'],
+                rationale: '用户登录时依次调用认证、数据库和会话管理',
+                confidence: 'INFERRED',
+            },
+        ],
+        ...overrides,
+    };
+}
+function makeCitations() {
+    return [
+        {
+            specPath: 'specs/auth/login.md',
+            lineRange: { startLine: 10, endLine: 20 },
+            excerpt: '登录验证流程说明',
+            nodeId: 'node-auth',
+            similarity: 0.85,
+        },
+        {
+            specPath: '[graph hyperedge]',
+            lineRange: { startLine: 0, endLine: 0 },
+            excerpt: '登录流程跨模块协作',
+        },
+    ];
+}
+// ============================================================
+// 测试套件
+// ============================================================
+describe('buildQnAPrompt', () => {
+    describe('基础结构检查', () => {
+        it('应返回 systemPrompt 和 userPrompt 字段', () => {
+            const ctx = makeGraphCtx();
+            const citations = makeCitations();
+            const result = buildQnAPrompt(ctx, citations, '什么调用了认证模块');
+            expect(result.systemPrompt).toBeTruthy();
+            expect(result.userPrompt).toBeTruthy();
+            expect(typeof result.systemPrompt).toBe('string');
+            expect(typeof result.userPrompt).toBe('string');
+        });
+        it('systemPrompt 应包含 citation 格式要求', () => {
+            const ctx = makeGraphCtx();
+            const result = buildQnAPrompt(ctx, [], '测试问题');
+            expect(result.systemPrompt).toContain('[来源：');
+            expect(result.systemPrompt).toContain('100%');
+        });
+        it('systemPrompt 应要求返回 JSON 格式', () => {
+            const ctx = makeGraphCtx();
+            const result = buildQnAPrompt(ctx, [], '测试问题');
+            expect(result.systemPrompt).toContain('JSON');
+            expect(result.systemPrompt).toContain('"answer"');
+            expect(result.systemPrompt).toContain('"citations"');
+        });
+    });
+    describe('用户问题注入', () => {
+        it('userPrompt 应包含原始问题文本', () => {
+            const ctx = makeGraphCtx();
+            const question = '什么调用了认证模块的 login 函数';
+            const result = buildQnAPrompt(ctx, [], question);
+            expect(result.userPrompt).toContain(question);
+        });
+    });
+    describe('Citation 内联格式', () => {
+        it('userPrompt 应包含所有 citation 的内联格式', () => {
+            const ctx = makeGraphCtx();
+            const citations = makeCitations();
+            const result = buildQnAPrompt(ctx, citations, '测试');
+            // 应包含 specs/auth/login.md 的引用
+            expect(result.userPrompt).toContain('specs/auth/login.md:10-20');
+            // 应包含 graph-hyperedge 引用
+            expect(result.userPrompt).toContain('graph-hyperedge');
+        });
+        it('citation excerpt 应出现在 prompt 中', () => {
+            const ctx = makeGraphCtx();
+            const citations = makeCitations();
+            const result = buildQnAPrompt(ctx, citations, '测试');
+            expect(result.userPrompt).toContain('登录验证流程说明');
+        });
+    });
+    describe('Hyperedge 候选列表', () => {
+        it('userPrompt 应包含超边候选列表区块', () => {
+            const ctx = makeGraphCtx();
+            const result = buildQnAPrompt(ctx, [], '测试');
+            // 应有超边候选列表相关标题
+            expect(result.userPrompt).toContain('超边候选列表');
+        });
+        it('userPrompt 应包含 hyperedge 的 label', () => {
+            const ctx = makeGraphCtx();
+            const result = buildQnAPrompt(ctx, [], '测试');
+            // hyperedge label "登录流程" 应出现在 prompt 中
+            expect(result.userPrompt).toContain('登录流程');
+        });
+        it('hyperedge rationale 应出现在候选列表中', () => {
+            const ctx = makeGraphCtx();
+            const result = buildQnAPrompt(ctx, [], '测试');
+            expect(result.userPrompt).toContain('用户登录时依次调用认证');
+        });
+        it('空超边时应有占位说明', () => {
+            const ctx = makeGraphCtx({ hyperedges: [] });
+            const result = buildQnAPrompt(ctx, [], '测试');
+            expect(result.userPrompt).toContain('无超边数据');
+        });
+    });
+    describe('fallback 模式提示', () => {
+        it('fallbackMode=rag-only 时 userPrompt 应包含降级提示', () => {
+            const ctx = makeGraphCtx({ fallbackMode: 'rag-only' });
+            const result = buildQnAPrompt(ctx, [], '测试');
+            expect(result.userPrompt).toContain('rag-only');
+            expect(result.userPrompt).toContain('降级模式');
+        });
+        it('无 fallbackMode 时不应包含降级提示', () => {
+            const ctx = makeGraphCtx({ fallbackMode: undefined });
+            const result = buildQnAPrompt(ctx, [], '测试');
+            expect(result.userPrompt).not.toContain('降级模式');
+        });
+    });
+    describe('BFS 节点摘要', () => {
+        it('userPrompt 应包含 BFS 节点信息', () => {
+            const ctx = makeGraphCtx();
+            const result = buildQnAPrompt(ctx, [], '测试');
+            // 节点 label 应出现在 userPrompt 中
+            expect(result.userPrompt).toContain('认证模块');
+            expect(result.userPrompt).toContain('数据库层');
+        });
+        it('空 BFS 节点时应有占位说明', () => {
+            const ctx = makeGraphCtx({ bfsNodes: [] });
+            const result = buildQnAPrompt(ctx, [], '测试');
+            expect(result.userPrompt).toContain('无相关节点');
+        });
+    });
+});
+//# sourceMappingURL=prompt-builder.test.js.map

package/dist/panoramic/qa/__tests__/prompt-builder.test.js.map

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

package/dist/panoramic/qa/__tests__/qa-integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=qa-integration.test.d.ts.map

package/dist/panoramic/qa/__tests__/qa-integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-integration.test.d.ts","sourceRoot":"","sources":["../../../../src/panoramic/qa/__tests__/qa-integration.test.ts"],"names":[],"mappings":""}