noteconnection 1.8.0 → 1.9.0

package/dist/src/learning/conversationComposer.test.js

@@ -384,6 +384,51 @@ describe('conversationComposer', () => {
             decision: 'abstain',
         }));
     });
+    test('uses the explicit Chinese answer language for an English no-match query', () => {
+        let blockCounter = 0;
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'what is water glass?',
+            answerLanguage: 'zh',
+            knowledgePoints: [],
+            citations: [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: {
+                ...globalScope,
+                source: 'scoped',
+                workspaceId: 'waterglass',
+                corpusId: 'waterglass',
+                sourcePathPrefixes: ['Knowledge_Base/waterglass'],
+                readiness: {
+                    status: 'ready',
+                    message: 'The scoped learning workspace is ready.',
+                    workspaceId: 'waterglass',
+                    corpusId: 'waterglass',
+                    activeResourceCount: 1,
+                    activeProjectionCount: 1,
+                    indexedUnitCount: 1,
+                    indexedSegmentCount: 4,
+                    matchedDocumentCount: 1,
+                },
+                missDiagnostics: {
+                    reason: 'retrieval_candidates_below_threshold',
+                    message: 'No evidence-bearing candidates were returned.',
+                    query: 'what is water glass?',
+                    normalizedQuery: 'what is water glass?',
+                    titleLikeQueries: ['water glass'],
+                    titleHitDocumentIds: [],
+                    indexedScopeAtomCount: 4,
+                },
+            },
+            nextBlockId: () => `language_empty_scope_${++blockCounter}`,
+        });
+        const structuredAnswer = reply.assistantBlocks.find((block) => block.type === 'structured_answer');
+        expect(reply.answer).toContain('当前范围');
+        expect(reply.answer).toContain('我暂时不能');
+        expect(reply.answer).not.toContain('No scoped knowledge points matched');
+        expect(structuredAnswer && 'title' in structuredAnswer ? structuredAnswer.title : '').toBe('可信回答');
+        expect(reply.knowledgeRun.answerReleaseReview?.publicAnswer).toBe(reply.answer);
+    });
     test('aggregates graph context across multiple knowledge points and preserves temporal edge details', () => {
         const knowledgePoints = [
             {
@@ -996,6 +1041,502 @@ describe('conversationComposer', () => {
         const structuredBlock = reply.assistantBlocks.find((block) => block.type === 'structured_answer');
         expect(structuredBlock && 'directAnswer' in structuredBlock ? structuredBlock.directAnswer : '').toBe(reply.answer);
     });
+    test('full response mode releases a bounded technical report while slim remains concise', () => {
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_full_water_glass',
+                documentId: 'doc_full_water_glass',
+                sourcePath: 'Knowledge_Base/test/full-water-glass.md',
+                title: 'Water Glass',
+                content: 'A water glass is a transparent drinking vessel that contains water.',
+            },
+            evidence: {
+                id: 'evidence_full_water_glass',
+                snippet: 'A water glass is a transparent drinking vessel that contains water.',
+                startLine: 4,
+                endLine: 4,
+            },
+            score: 0.96,
+        });
+        const knowledgePoints = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const citations = knowledgePoints[0].citations || [];
+        const ragContextPack = {
+            query: 'what is water glass?',
+            generatedAt: '2026-09-03T00:00:00.000Z',
+            sourceBoundary: 'full_document',
+            budget: {
+                maxFragments: 8,
+                maxCharsPerFragment: 1600,
+                maxTotalChars: 6400,
+            },
+            fragments: [
+                {
+                    fragmentId: 'rag_full_definition',
+                    role: 'parent_context',
+                    text: [
+                        '# Water Glass',
+                        '',
+                        'A water glass is a transparent drinking vessel that contains water.',
+                        '',
+                        '## Thermal model',
+                        '',
+                        'The temperature field follows:',
+                        '',
+                        '$$\n\\frac{\\partial T}{\\partial t} = \\alpha \\nabla^2 T\n$$',
+                    ].join('\n'),
+                    atomId: item.atom.id,
+                    documentId: item.atom.documentId,
+                    sourcePath: item.atom.sourcePath,
+                    title: item.atom.title,
+                    headingPath: ['Water Glass'],
+                    startLine: 1,
+                    endLine: 10,
+                    charCount: 260,
+                    tokenEstimate: 65,
+                    truncated: false,
+                    citationIds: ['evidence_full_water_glass'],
+                    sourceBoundary: 'full_document',
+                },
+                {
+                    fragmentId: 'rag_full_optics',
+                    role: 'parent_context',
+                    text: [
+                        '## Optical model',
+                        '',
+                        'At an interface, refraction follows Snell law:',
+                        '',
+                        '$$\nn_1 \\sin(\\theta_1) = n_2 \\sin(\\theta_2)\n$$',
+                    ].join('\n'),
+                    atomId: item.atom.id,
+                    documentId: item.atom.documentId,
+                    sourcePath: item.atom.sourcePath,
+                    title: item.atom.title,
+                    headingPath: ['Water Glass', 'Optical model'],
+                    startLine: 12,
+                    endLine: 18,
+                    charCount: 150,
+                    tokenEstimate: 38,
+                    truncated: false,
+                    citationIds: ['evidence_full_water_glass'],
+                    sourceBoundary: 'full_document',
+                },
+                {
+                    fragmentId: 'rag_full_comparison',
+                    role: 'parent_context',
+                    text: [
+                        '## Material comparison',
+                        '',
+                        '```mermaid',
+                        'graph LR',
+                        '    A[Glass] --> B[Water]',
+                        '```',
+                        '',
+                        'The comparison model relates material conductivity to heat loss.',
+                        '',
+                        '| Material | Thermal conductivity |',
+                        '| --- | --- |',
+                        '| Soda-lime glass | 1.0 W/(m·K) |',
+                        '| PET plastic | 0.2 W/(m·K) |',
+                    ].join('\n'),
+                    atomId: item.atom.id,
+                    documentId: item.atom.documentId,
+                    sourcePath: item.atom.sourcePath,
+                    title: 'Material comparison (mermaid block)',
+                    headingPath: ['Water Glass', 'Material comparison'],
+                    startLine: 20,
+                    endLine: 26,
+                    charCount: 150,
+                    tokenEstimate: 38,
+                    truncated: false,
+                    citationIds: ['evidence_full_water_glass'],
+                    sourceBoundary: 'full_document',
+                },
+                {
+                    fragmentId: 'rag_full_orphan_heading',
+                    role: 'parent_context',
+                    text: '### References',
+                    atomId: item.atom.id,
+                    documentId: item.atom.documentId,
+                    sourcePath: item.atom.sourcePath,
+                    title: item.atom.title,
+                    headingPath: ['Water Glass', 'References'],
+                    startLine: 30,
+                    endLine: 30,
+                    charCount: 15,
+                    tokenEstimate: 4,
+                    truncated: false,
+                    citationIds: ['evidence_full_water_glass'],
+                    sourceBoundary: 'full_document',
+                },
+                {
+                    fragmentId: 'rag_full_flattened_section',
+                    role: 'direct_support',
+                    text: '### Flattened section The fallback must retain this body when a source window is flattened.',
+                    atomId: item.atom.id,
+                    documentId: item.atom.documentId,
+                    sourcePath: item.atom.sourcePath,
+                    title: 'Flattened section',
+                    headingPath: ['Water Glass', 'Flattened section'],
+                    startLine: 31,
+                    endLine: 31,
+                    charCount: 86,
+                    tokenEstimate: 22,
+                    truncated: false,
+                    citationIds: ['evidence_full_water_glass'],
+                    sourceBoundary: 'direct_span_only',
+                },
+            ],
+            sourceDecisions: [],
+            totalCharCount: 560,
+            tokenEstimate: 141,
+        };
+        const ragSufficiencyReview = {
+            reviewedAt: '2026-09-03T00:00:00.000Z',
+            status: 'sufficient',
+            score: 0.98,
+            reasons: [],
+            deterministic: true,
+            degradationState: 'none',
+        };
+        const makeReply = (responseMode) => (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'what is water glass?',
+            responseMode,
+            knowledgePoints,
+            citations,
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-03T00:00:00.000Z',
+            nextBlockId: (() => {
+                let blockCounter = 0;
+                return () => `assistant_block_${++blockCounter}`;
+            })(),
+            ragContextPack,
+            ragSufficiencyReview,
+        });
+        const slimReply = makeReply('slim');
+        const fullReply = makeReply('full');
+        expect(slimReply.answer).not.toContain('## Material comparison');
+        expect(fullReply.answer).toContain('## Thermal model');
+        expect(fullReply.answer).toContain('## Optical model');
+        expect(fullReply.answer).toContain('## Material comparison');
+        expect(fullReply.answer).toContain('comparison model relates material conductivity');
+        expect(fullReply.answer).toContain('Soda-lime glass');
+        expect(fullReply.answer).not.toMatch(/### References\s*$/u);
+        expect(fullReply.answer).toContain('fallback must retain this body');
+        expect(fullReply.answer).toContain('\\frac{\\partial T}{\\partial t}');
+        expect(fullReply.answer).toContain('n_1 \\sin(\\theta_1)');
+        expect(fullReply.answer.match(/\$\$/gu)?.length).toBe(4);
+        expect(fullReply.answer).not.toContain('Grounded by');
+        expect(fullReply.answerReleaseReview.decision).not.toBe('abstain');
+    });
+    test('uses same-document graph-neighbor fragments as full-report section fallbacks', () => {
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_graph_fallback_water_glass',
+                documentId: 'doc_graph_fallback_water_glass',
+                sourcePath: 'Knowledge_Base/test/graph-fallback-water-glass.md',
+                title: 'Water Glass',
+                content: 'A water glass is a transparent drinking vessel that contains water.',
+            },
+            evidence: {
+                id: 'evidence_graph_fallback_water_glass',
+                snippet: 'A water glass is a transparent drinking vessel that contains water.',
+                startLine: 3,
+                endLine: 3,
+            },
+            score: 0.95,
+        });
+        const knowledgePoints = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const citations = knowledgePoints[0].citations || [];
+        const makeFragment = (overrides) => ({
+            fragmentId: String(overrides.fragmentId || 'fragment'),
+            role: overrides.role || 'parent_context',
+            text: String(overrides.text || ''),
+            atomId: overrides.atomId || item.atom.id,
+            documentId: String(overrides.documentId || item.atom.documentId),
+            sourcePath: String(overrides.sourcePath || item.atom.sourcePath),
+            title: String(overrides.title || item.atom.title),
+            headingPath: Array.isArray(overrides.headingPath) ? overrides.headingPath : ['Water Glass'],
+            startLine: overrides.startLine || 1,
+            endLine: overrides.endLine || 4,
+            charCount: Number(overrides.charCount || String(overrides.text || '').length),
+            tokenEstimate: Number(overrides.tokenEstimate || 10),
+            truncated: overrides.truncated === true,
+            citationIds: Array.isArray(overrides.citationIds) ? overrides.citationIds : ['evidence_graph_fallback_water_glass'],
+            sourceBoundary: overrides.sourceBoundary || 'full_document',
+        });
+        const ragContextPack = {
+            query: 'what is water glass?',
+            generatedAt: '2026-09-03T00:00:00.000Z',
+            sourceBoundary: 'full_document',
+            budget: {
+                maxFragments: 6,
+                maxCharsPerFragment: 1200,
+                maxTotalChars: 3600,
+            },
+            fragments: [
+                makeFragment({
+                    fragmentId: 'rag_graph_fallback_definition',
+                    role: 'parent_context',
+                    text: '## Definition\n\nA water glass is a transparent drinking vessel that contains water.',
+                    headingPath: ['Water Glass', 'Definition'],
+                }),
+                makeFragment({
+                    fragmentId: 'rag_graph_fallback_optics',
+                    role: 'graph_neighbor_support',
+                    text: '## Optical model\n\nRefraction follows Snell law.\n\n$$\nn_1 \\sin(\\theta_1) = n_2 \\sin(\\theta_2)\n$$',
+                    headingPath: ['Water Glass', 'Optical model'],
+                }),
+                makeFragment({
+                    fragmentId: 'rag_graph_fallback_unrelated',
+                    role: 'graph_neighbor_support',
+                    documentId: 'doc_unrelated_graph_neighbor',
+                    sourcePath: 'Knowledge_Base/test/unrelated.md',
+                    text: '## Unrelated model\n\nThis cross-document marker must not leak into the water-glass report.',
+                    headingPath: ['Unrelated', 'Unrelated model'],
+                }),
+            ],
+            sourceDecisions: [],
+            totalCharCount: 300,
+            tokenEstimate: 75,
+        };
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'what is water glass?',
+            responseMode: 'full',
+            knowledgePoints,
+            citations,
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-03T00:00:00.000Z',
+            nextBlockId: (() => {
+                let blockCounter = 0;
+                return () => `assistant_block_${++blockCounter}`;
+            })(),
+            ragContextPack,
+            ragSufficiencyReview: {
+                reviewedAt: '2026-09-03T00:00:00.000Z',
+                status: 'sufficient',
+                score: 0.95,
+                reasons: [],
+                deterministic: true,
+                degradationState: 'none',
+            },
+        });
+        expect(reply.answer).toContain('## Optical model');
+        expect(reply.answer).toContain('n_1 \\sin(\\theta_1)');
+        expect(reply.answer).not.toContain('cross-document marker');
+        expect(reply.answerReleaseReview.decision).not.toBe('abstain');
+    });
+    test('full report uses the injected max-tier budget instead of the legacy 24k cap', () => {
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_adaptive_max_report',
+                documentId: 'doc_adaptive_max_report',
+                sourcePath: 'Knowledge_Base/test/adaptive-max-report.md',
+                title: 'Adaptive Max Report',
+                content: 'Adaptive max report content.',
+            },
+            evidence: {
+                id: 'evidence_adaptive_max_report',
+                snippet: 'Adaptive max report content.',
+                startLine: 2,
+                endLine: 2,
+            },
+            score: 0.99,
+        });
+        const knowledgePoints = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const largeSections = Array.from({ length: 18 }, (_, index) => ({
+            fragmentId: `adaptive_section_${index}`,
+            role: 'parent_context',
+            text: `## Section ${index}\n\n${`Section ${index} preserves complete technical evidence. `.repeat(160)}`,
+            atomId: item.atom.id,
+            documentId: item.atom.documentId,
+            sourcePath: item.atom.sourcePath,
+            title: `Section ${index}`,
+            headingPath: ['Adaptive Max Report', `Section ${index}`],
+            startLine: index * 10 + 1,
+            endLine: index * 10 + 8,
+            charCount: 0,
+            tokenEstimate: 0,
+            truncated: false,
+            citationIds: ['evidence_adaptive_max_report'],
+            sourceBoundary: 'full_document',
+        })).map((fragment) => ({
+            ...fragment,
+            charCount: fragment.text.length,
+            tokenEstimate: Math.ceil(fragment.text.length / 4),
+        }));
+        const budget = {
+            mode: 'adaptive',
+            tier: 'max',
+            productCapDisabled: false,
+            rag: {
+                maxFragments: 256,
+                maxCharsPerFragment: 16000,
+                maxTotalChars: 256000,
+            },
+            reportMaxChars: 160000,
+            runtimeGovernor: {
+                timeoutMs: 120000,
+                maxSerializedBytes: 32 * 1024 * 1024,
+                maxFragmentsProcessed: 2048,
+                maxReportChars: 160000,
+            },
+        };
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'what is adaptive max report?',
+            responseMode: 'full',
+            responseBudget: budget,
+            knowledgePoints,
+            citations: knowledgePoints[0].citations || [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-03T00:00:00.000Z',
+            nextBlockId: (() => {
+                let blockCounter = 0;
+                return () => `adaptive_max_block_${++blockCounter}`;
+            })(),
+            ragContextPack: {
+                query: 'what is adaptive max report?',
+                generatedAt: '2026-09-03T00:00:00.000Z',
+                sourceBoundary: 'full_document',
+                budget: budget.rag,
+                fragments: [
+                    {
+                        fragmentId: 'adaptive_definition',
+                        role: 'parent_context',
+                        text: '# Adaptive Max Report\n\nAdaptive max report content.',
+                        atomId: item.atom.id,
+                        documentId: item.atom.documentId,
+                        sourcePath: item.atom.sourcePath,
+                        title: item.atom.title,
+                        headingPath: ['Adaptive Max Report'],
+                        startLine: 1,
+                        endLine: 3,
+                        charCount: 55,
+                        tokenEstimate: 14,
+                        truncated: false,
+                        citationIds: ['evidence_adaptive_max_report'],
+                        sourceBoundary: 'full_document',
+                    },
+                    ...largeSections,
+                ],
+                sourceDecisions: [],
+                totalCharCount: largeSections.reduce((sum, fragment) => sum + fragment.charCount, 55),
+                tokenEstimate: 0,
+            },
+            ragSufficiencyReview: {
+                reviewedAt: '2026-09-03T00:00:00.000Z',
+                status: 'sufficient',
+                score: 1,
+                reasons: [],
+                deterministic: true,
+            },
+        });
+        expect(reply.answer.length).toBeGreaterThan(24000);
+        expect(reply.answer.length).toBeLessThanOrEqual(160000);
+        expect(reply.fullReportAssembly?.truncated).toBe(false);
+    });
+    test('unbounded report retains safe sections and reports runtime truncation explicitly', () => {
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_unbounded_report',
+                documentId: 'doc_unbounded_report',
+                sourcePath: 'Knowledge_Base/test/unbounded-report.md',
+                title: 'Unbounded Report',
+                content: 'Unbounded report content.',
+            },
+            evidence: {
+                id: 'evidence_unbounded_report',
+                snippet: 'Unbounded report content.',
+                startLine: 2,
+                endLine: 2,
+            },
+            score: 0.99,
+        });
+        const knowledgePoints = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const makeFragment = (index) => ({
+            fragmentId: `unbounded_report_${index}`,
+            role: 'parent_context',
+            text: `## Safe section ${index}\n\nThis section ${index} remains available under product-unbounded mode. ${'Additional bounded evidence. '.repeat(20)}`,
+            atomId: item.atom.id,
+            documentId: item.atom.documentId,
+            sourcePath: item.atom.sourcePath,
+            title: `Safe section ${index}`,
+            headingPath: ['Unbounded Report', `Safe section ${index}`],
+            startLine: index + 1,
+            endLine: index + 4,
+            charCount: 0,
+            tokenEstimate: 0,
+            truncated: false,
+            citationIds: ['evidence_unbounded_report'],
+            sourceBoundary: 'full_document',
+        });
+        const fragments = Array.from({ length: 5 }, (_, index) => {
+            const fragment = makeFragment(index);
+            return { ...fragment, charCount: fragment.text.length, tokenEstimate: Math.ceil(fragment.text.length / 4) };
+        });
+        const budget = {
+            mode: 'unbounded',
+            tier: 'unbounded',
+            productCapDisabled: true,
+            rag: {
+                maxFragments: 4096,
+                maxCharsPerFragment: 16000,
+                maxTotalChars: 320000,
+                productCapDisabled: true,
+                runtimeMaxFragments: 4096,
+                runtimeMaxCharsPerFragment: 16000,
+                runtimeMaxTotalChars: 64 * 1024 * 1024,
+            },
+            runtimeGovernor: {
+                timeoutMs: 180000,
+                maxSerializedBytes: 64 * 1024 * 1024,
+                maxFragmentsProcessed: 2,
+                maxReportChars: 320000,
+            },
+        };
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'what is unbounded report?',
+            responseMode: 'full',
+            responseBudget: budget,
+            knowledgePoints,
+            citations: knowledgePoints[0].citations || [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-03T00:00:00.000Z',
+            nextBlockId: (() => {
+                let blockCounter = 0;
+                return () => `unbounded_block_${++blockCounter}`;
+            })(),
+            ragContextPack: {
+                query: 'what is unbounded report?',
+                generatedAt: '2026-09-03T00:00:00.000Z',
+                sourceBoundary: 'full_document',
+                budget: budget.rag,
+                fragments,
+                sourceDecisions: [],
+                totalCharCount: fragments.reduce((sum, fragment) => sum + fragment.charCount, 0),
+                tokenEstimate: 0,
+            },
+            ragSufficiencyReview: {
+                reviewedAt: '2026-09-03T00:00:00.000Z',
+                status: 'sufficient',
+                score: 1,
+                reasons: [],
+                deterministic: true,
+            },
+        });
+        expect(reply.answer).toContain('Safe section 0');
+        expect(reply.answer).toContain('Safe section 1');
+        expect(reply.answer).not.toContain('Safe section 2');
+        expect(reply.fullReportAssembly?.truncated).toBe(true);
+        expect(reply.fullReportAssembly?.truncationReason).toBe('runtime_fragment_limit');
+    });
     test('keeps decimal numeric evidence intact in RAG public answers', () => {
         const item = makeQueryItem({
             atom: {
@@ -1228,6 +1769,8 @@ describe('conversationComposer', () => {
             ragSufficiencyReview,
         });
         expect(reply.answer).toContain('transparent drinking vessel');
+        expect(reply.graphAnswerPlan.claims.map((claim) => claim.statement)).toContain('A plastic cup is an opaque polymer vessel that can deform under pressure.');
+        expect(reply.graphAnswerPlan.claims.map((claim) => claim.statement)).toContain('The graph marks the two nodes with a contrast relation, so the comparison should preserve their material and rigidity differences.');
         expect(reply.answer).toContain('opaque polymer vessel');
         expect(reply.answer).toContain('contrast relation');
         expect(reply.assistantBlocks.filter((block) => block.type === 'structured_answer')).toHaveLength(1);
@@ -1334,10 +1877,185 @@ describe('conversationComposer', () => {
             ragContextPack,
             ragSufficiencyReview,
         });
+        expect(reply.graphAnswerPlan.claims.map((claim) => claim.statement)).toEqual(expect.arrayContaining([
+            'Water Glass Soda-Lime',
+            'Plastic Cup PET',
+        ]));
+        expect(reply.answerReleaseReview.originalAnswer).toContain('Water Glass Soda-Lime');
+        expect(reply.answerReleaseReview.gates.filter((gate) => !gate.passed)).toEqual([]);
         expect(reply.answer).toContain('Water Glass Soda-Lime');
         expect(reply.answer).toContain('Plastic Cup PET');
         expect(reply.answer).not.toContain('```');
     });
+    test('bounds a full-document comparison to both requested operands instead of preamble context', () => {
+        const point = {
+            atomId: 'atom_full_compare_water_glass',
+            atomIds: ['atom_full_compare_water_glass'],
+            documentId: 'doc_full_compare_water_glass',
+            sourcePath: 'Knowledge_Base/waterglass/water glass.md',
+            title: '\u6c34\u676f (water glass)',
+            summary: '\u6c34\u676f\u662f\u7531\u73bb\u7483\u5bb9\u5668\u4e0e\u6c34\u7ec4\u6210\u7684\u7269\u7406\u7cfb\u7edf\u3002',
+            evidenceSnippet: '\u6c34\u676f\u662f\u7531\u73bb\u7483\u5bb9\u5668\u4e0e\u6c34\u7ec4\u6210\u7684\u7269\u7406\u7cfb\u7edf\u3002',
+            score: 0.98,
+            citation: null,
+            citations: [],
+            matchedSpans: [],
+            matchCount: 1,
+            relationPath: [],
+            relationPathAtomIds: [],
+            relationKinds: [],
+            temporalValidity: {
+                isValid: true,
+                checkedAt: '2026-09-01T00:00:00.000Z',
+                reasons: [],
+                details: [],
+            },
+            capabilities: [],
+        };
+        const documentId = 'doc_full_compare_water_glass';
+        const sourcePath = 'Knowledge_Base/waterglass/water glass.md';
+        const graphContext = {
+            anchorAtomId: point.atomId,
+            anchorTitle: point.title,
+            anchorDocumentId: documentId,
+            supportingAtomIds: [],
+            supportingTitles: [],
+            relationKinds: [],
+            relationSummaries: [],
+            connectionPaths: [{
+                    sourceAtomId: 'atom_full_compare_water_glass',
+                    sourceTitle: 'Temporal Current Release Source',
+                    targetAtomId: 'atom_full_compare_water_glass',
+                    targetTitle: 'Temporal Planned Roadmap Source',
+                    pathAtomIds: ['atom_full_compare_water_glass'],
+                    pathTitles: ['Temporal Current Release Source', 'Temporal Planned Roadmap Source'],
+                    pathEdges: [{
+                            fromAtomId: 'atom_full_compare_water_glass',
+                            toAtomId: 'atom_full_compare_water_glass',
+                            relationKind: 'contrast',
+                        }],
+                    length: 1,
+                }],
+            predecessorWindow: [{
+                    atomId: 'atom_full_compare_water_glass',
+                    title: 'Temporal Current Release Source',
+                    relationKind: 'contrast',
+                    confidence: 0.9,
+                }],
+            successorWindow: [{
+                    atomId: 'atom_full_compare_water_glass',
+                    title: 'Temporal Planned Roadmap Source',
+                    relationKind: 'contrast',
+                    confidence: 0.9,
+                }],
+            temporalValidity: {
+                checkedAt: '2026-09-01T00:00:00.000Z',
+                allPointsValid: true,
+                warningReasons: [],
+                invalidKnowledgePointTitles: [],
+                edgeKinds: [],
+                details: [],
+            },
+        };
+        const ragContextPack = {
+            query: 'compare water glass and plastic cup',
+            generatedAt: '2026-09-01T00:00:00.000Z',
+            sourceBoundary: 'full_document',
+            budget: { maxFragments: 8, maxCharsPerFragment: 1200, maxTotalChars: 4800 },
+            fragments: [
+                {
+                    fragmentId: 'full_compare_definition',
+                    role: 'direct_support',
+                    text: '## Water Glass\n\nA water glass is a transparent vessel made from soda-lime glass.',
+                    atomId: point.atomId,
+                    documentId,
+                    sourcePath,
+                    title: 'Water Glass',
+                    headingPath: ['Water Glass'],
+                    charCount: 86,
+                    tokenEstimate: 22,
+                    truncated: false,
+                    citationIds: ['full_compare_definition'],
+                    relationEdgeIds: [],
+                    sourceBoundary: 'full_document',
+                    score: 0.98,
+                },
+                {
+                    fragmentId: 'full_compare_preamble',
+                    role: 'direct_support',
+                    text: 'This technical document was generated from the title water glass and provides broad background context.',
+                    atomId: point.atomId,
+                    documentId,
+                    sourcePath,
+                    title: 'water glass.md preamble',
+                    headingPath: ['preamble'],
+                    charCount: 104,
+                    tokenEstimate: 26,
+                    truncated: false,
+                    citationIds: ['full_compare_preamble'],
+                    relationEdgeIds: [],
+                    sourceBoundary: 'full_document',
+                    score: 0.8,
+                },
+                {
+                    fragmentId: 'full_compare_mermaid',
+                    role: 'direct_support',
+                    text: [
+                        '### Container comparison',
+                        '```mermaid',
+                        'graph LR',
+                        'A[Water Glass Soda-Lime]',
+                        'B[Plastic Cup PET]',
+                        '```',
+                    ].join('\n'),
+                    atomId: point.atomId,
+                    documentId,
+                    sourcePath,
+                    title: 'Container comparison',
+                    headingPath: ['Water Glass', 'Container comparison'],
+                    charCount: 112,
+                    tokenEstimate: 28,
+                    truncated: false,
+                    citationIds: ['full_compare_mermaid'],
+                    relationEdgeIds: [],
+                    sourceBoundary: 'full_document',
+                    score: 0.95,
+                },
+            ],
+            sourceDecisions: [],
+            totalCharCount: 302,
+            tokenEstimate: 76,
+        };
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'compare water glass and plastic cup',
+            knowledgePoints: [point],
+            citations: [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-01T00:00:00.000Z',
+            nextBlockId: (() => {
+                let index = 0;
+                return () => `full_compare_block_${++index}`;
+            })(),
+            graphContext,
+            ragContextPack,
+            ragSufficiencyReview: {
+                reviewedAt: '2026-09-01T00:00:00.000Z',
+                status: 'sufficient',
+                score: 0.94,
+                reasons: [],
+                deterministic: true,
+                recoveryAttempted: false,
+                llmJudgeUsed: false,
+                degradationState: 'none',
+            },
+        });
+        expect(reply.answer).toContain('Water Glass Soda-Lime');
+        expect(reply.answer).toContain('Plastic Cup PET');
+        expect(reply.answer).not.toContain('This technical document was generated from the title');
+        expect(reply.answerReleaseReview.gates.filter((gate) => !gate.passed)).toEqual([]);
+    });
     test('uses how-to RAG profile to preserve steps prerequisites downstream checks and failure handling', () => {
         const item = makeQueryItem({
             atom: {
@@ -1648,6 +2366,60 @@ describe('conversationComposer', () => {
                     citationIds: ['evidence_generic_optical_bench_drift'],
                     sourceBoundary: 'direct_span_only',
                 },
+                {
+                    fragmentId: 'rag_direct_generic_optical_bench_drift_environment',
+                    role: 'direct_support',
+                    text: 'Ambient temperature changes shift the optical bench reference position.',
+                    atomId: 'atom_generic_optical_bench_drift_environment',
+                    documentId: 'doc_generic_optical_bench_drift',
+                    sourcePath: 'Knowledge_Base/test/optical-bench-drift.md',
+                    title: 'Optical Bench Drift Environment',
+                    headingPath: ['Optical Bench Drift', 'Environmental cause'],
+                    startLine: 14,
+                    endLine: 14,
+                    charCount: 71,
+                    tokenEstimate: 14,
+                    truncated: false,
+                    citationIds: ['evidence_generic_optical_bench_drift'],
+                    sourceBoundary: 'full_document',
+                    score: 0.93,
+                },
+                {
+                    fragmentId: 'rag_direct_generic_optical_bench_drift_mount',
+                    role: 'direct_support',
+                    text: 'Mount relaxation changes the beam angle while the detector remains stable.',
+                    atomId: 'atom_generic_optical_bench_drift_mount',
+                    documentId: 'doc_generic_optical_bench_drift',
+                    sourcePath: 'Knowledge_Base/test/optical-bench-drift.md',
+                    title: 'Optical Bench Drift Mount',
+                    headingPath: ['Optical Bench Drift', 'Mechanical cause'],
+                    startLine: 15,
+                    endLine: 15,
+                    charCount: 72,
+                    tokenEstimate: 14,
+                    truncated: false,
+                    citationIds: ['evidence_generic_optical_bench_drift'],
+                    sourceBoundary: 'full_document',
+                    score: 0.92,
+                },
+                {
+                    fragmentId: 'rag_direct_generic_optical_bench_drift_history',
+                    role: 'direct_support',
+                    text: 'A time-series baseline separates persistent bench drift from transient detector noise.',
+                    atomId: 'atom_generic_optical_bench_drift_history',
+                    documentId: 'doc_generic_optical_bench_drift',
+                    sourcePath: 'Knowledge_Base/test/optical-bench-drift.md',
+                    title: 'Optical Bench Drift History',
+                    headingPath: ['Optical Bench Drift', 'Historical baseline'],
+                    startLine: 16,
+                    endLine: 16,
+                    charCount: 83,
+                    tokenEstimate: 16,
+                    truncated: false,
+                    citationIds: ['evidence_generic_optical_bench_drift'],
+                    sourceBoundary: 'full_document',
+                    score: 0.91,
+                },
                 {
                     fragmentId: 'rag_parent_generic_optical_bench_drift',
                     role: 'parent_context',
@@ -1711,13 +2483,644 @@ describe('conversationComposer', () => {
             ragContextPack,
             ragSufficiencyReview,
         });
+        expect(reply.answerReleaseReview.originalAnswer).toContain('downstream calibration quality');
+        expect(reply.answerReleaseReview.gates.filter((gate) => !gate.passed)).toEqual([]);
         expect(reply.answer).toContain('reference beam against the current beam centroid');
         expect(reply.answer).toContain('centroid delta before changing hardware');
         expect(reply.answer).toContain('stable baseline records');
         expect(reply.answer).toContain('downstream calibration quality');
+        expect(reply.answer).toContain('Ambient temperature changes');
+        expect(reply.answer).toContain('Mount relaxation changes');
+        expect(reply.answer).toContain('time-series baseline separates');
+        expect(reply.graphAnswerCoverage.passed).toBe(true);
         expect(reply.answer).not.toContain('broad overview of laboratory documentation');
         expect(reply.answer).not.toContain('Graph caveat:');
     });
+    test('renders every planned direct-support claim without an intent profile quota', () => {
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_profile_free_beam_drift',
+                documentId: 'doc_profile_free_beam_drift',
+                sourcePath: 'Knowledge_Base/test/profile-free-beam-drift.md',
+                title: 'Beam Drift',
+                content: 'Beam drift is a displacement of the measured spot.',
+            },
+            evidence: {
+                id: 'evidence_profile_free_beam_drift',
+                snippet: 'Beam drift is a displacement of the measured spot.',
+                startLine: 3,
+                endLine: 6,
+            },
+            score: 0.93,
+        });
+        const knowledgePoints = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const citations = knowledgePoints.flatMap((point) => point.citations || []);
+        let blockCounter = 0;
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'tell me about beam drift',
+            knowledgePoints,
+            citations,
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-07-22T00:00:00.000Z',
+            nextBlockId: () => `assistant_block_${++blockCounter}`,
+            ragSufficiencyReview: {
+                reviewedAt: '2026-07-22T00:00:00.000Z',
+                status: 'sufficient',
+                score: 0.9,
+                reasons: [],
+                deterministic: true,
+                recoveryAttempted: false,
+                llmJudgeUsed: false,
+                degradationState: 'none',
+            },
+            ragContextPack: {
+                query: 'tell me about beam drift',
+                generatedAt: '2026-07-22T00:00:00.000Z',
+                sourceBoundary: 'direct_span_only',
+                budget: { maxFragments: 1, maxCharsPerFragment: 1000, maxTotalChars: 1000 },
+                fragments: [{
+                        fragmentId: 'direct_profile_free_beam_drift',
+                        role: 'direct_support',
+                        text: [
+                            'Beam drift is a displacement of the measured spot.',
+                            'It can be measured against a fixed reference mark.',
+                            'Its correction requires recording the centroid shift before adjustment.',
+                        ].join(' '),
+                        atomId: 'atom_profile_free_beam_drift',
+                        documentId: 'doc_profile_free_beam_drift',
+                        sourcePath: 'Knowledge_Base/test/profile-free-beam-drift.md',
+                        title: 'Beam Drift',
+                        headingPath: ['Beam Drift'],
+                        startLine: 3,
+                        endLine: 6,
+                        charCount: 163,
+                        tokenEstimate: 39,
+                        truncated: false,
+                        citationIds: ['evidence_profile_free_beam_drift'],
+                        sourceBoundary: 'direct_span_only',
+                        score: 0.7,
+                    }],
+                sourceDecisions: [],
+                totalCharCount: 163,
+                tokenEstimate: 39,
+            },
+        });
+        expect(reply.answer).toContain('It can be measured against a fixed reference mark');
+        expect(reply.answer).toContain('Its correction requires recording the centroid shift before adjustment');
+    });
+    test('projects definition answers to bounded non-comparison claims while retaining formula integrity', () => {
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_projection_water_glass',
+                documentId: 'doc_projection_water_glass',
+                title: 'Water Glass',
+                content: 'A water glass is a transparent vessel used to hold water.',
+            },
+            evidence: {
+                id: 'evidence_projection_water_glass',
+                snippet: 'A water glass is a transparent vessel used to hold water.',
+            },
+            score: 0.95,
+        });
+        const projectionPoints = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const densePack = {
+            query: 'what is water glass?',
+            generatedAt: '2026-07-12T00:00:00.000Z',
+            sourceBoundary: 'direct_span_only',
+            budget: { maxFragments: 1, maxCharsPerFragment: 1000, maxTotalChars: 1000 },
+            fragments: [{
+                    fragmentId: 'definition_projection_dense',
+                    role: 'direct_support',
+                    atomId: 'atom_projection_water_glass',
+                    documentId: 'doc_projection_water_glass',
+                    sourcePath: 'Knowledge_Base/test/projection-water-glass.md',
+                    title: 'Water Glass',
+                    headingPath: ['Water Glass'],
+                    text: [
+                        'A water glass is a transparent vessel used to hold water.',
+                        'It separates the liquid from the surrounding environment.',
+                        'Its wall conducts heat between the drink and the air.',
+                        'It is compared with a PET Plastic Cup and a Stainless Steel Metal Cup.',
+                        'The water glass thermal field follows $$\\frac{\\partial T}{\\partial t}=\\alpha\\nabla^2 T$$.',
+                        'This extra sentence should remain outside the compact definition answer.',
+                    ].join(' '),
+                    charCount: 330,
+                    tokenEstimate: 80,
+                    truncated: false,
+                    citationIds: ['evidence_projection_water_glass'],
+                    sourceBoundary: 'direct_span_only',
+                    score: 0.95,
+                }],
+            sourceDecisions: [],
+            totalCharCount: 330,
+            tokenEstimate: 80,
+        };
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'what is water glass?',
+            knowledgePoints: projectionPoints,
+            citations: [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-07-12T00:00:00.000Z',
+            nextBlockId: (() => {
+                let index = 0;
+                return () => `projection_block_${++index}`;
+            })(),
+            ragContextPack: densePack,
+            ragSufficiencyReview: {
+                reviewedAt: '2026-07-12T00:00:00.000Z',
+                status: 'sufficient',
+                score: 0.9,
+                reasons: [],
+                deterministic: true,
+                recoveryAttempted: false,
+                llmJudgeUsed: false,
+                degradationState: 'none',
+            },
+        });
+        expect(reply.answer).toContain('A water glass is a transparent vessel used to hold water.');
+        expect(reply.answer).toContain('It separates the liquid from the surrounding environment.');
+        expect(reply.answer).toContain('Its wall conducts heat between the drink and the air.');
+        expect(reply.answer).toContain('$$\n\\frac{\\partial T}{\\partial t}=\\alpha\\nabla^2 T\n$$');
+        expect(reply.answer).not.toContain('PET Plastic Cup');
+        expect(reply.answer).not.toContain('Stainless Steel Metal Cup');
+        expect(reply.answer).not.toContain('This extra sentence should remain outside');
+        expect(reply.graphAnswerPlan).toEqual(reply.answerReleaseReview.publicGraphAnswerPlan);
+        expect(reply.graphAnswerCoverage).toEqual(reply.answerReleaseReview.graphAnswerCoverage);
+        expect(reply.knowledgeRun.graphAnswerPlan).toEqual(reply.graphAnswerPlan);
+        expect(reply.knowledgeRun.graphAnswerCoverage).toEqual(reply.graphAnswerCoverage);
+        expect((reply.answer.match(/\$\$/gu) || []).length % 2).toBe(0);
+        expect((reply.answer.match(/\\frac\{\\partial T\}\{\\partial t\}=\\alpha\\nabla\^2 T/gu) || [])).toHaveLength(1);
+        expect(reply.answer.trim()).not.toMatch(/(?:and|or|with|between|is|are|:|：)\s*$/iu);
+    });
+    test('compound Chinese definition queries keep the subject answer and complete formula while dropping document scaffolding', () => {
+        const items = [
+            makeQueryItem({
+                atom: {
+                    id: 'atom_amorphous_ice_definition',
+                    documentId: 'doc_amorphous_ice',
+                    title: '非晶冰',
+                    sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                    content: '## 非晶冰\n非晶冰（Amorphous ice）是水的一种固态形式，其分子排列缺乏长程有序结构。',
+                    keywords: ['非晶冰', 'amorphous', 'ice'],
+                },
+                evidence: {
+                    id: 'evidence_amorphous_ice_definition',
+                    sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                    snippet: '## 非晶冰\n非晶冰（Amorphous ice）是水的一种固态形式，其分子排列缺乏长程有序结构。',
+                    startLine: 3,
+                    endLine: 6,
+                },
+                score: 0.98,
+            }),
+            makeQueryItem({
+                atom: {
+                    id: 'atom_amorphous_ice_math',
+                    documentId: 'doc_amorphous_ice',
+                    title: '核心概念与数学基础',
+                    sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                    content: '### 核心概念与数学基础\n其结构可用径向分布函数 $g(r)$ 描述。\n$$ g(r) = \\frac{V}{N^2} \\left\\langle \\sum_{i=1}^{N} \\delta(r) \\right\\rangle $$',
+                    keywords: ['核心概念', '数学基础', '非晶冰', 'g', 'r'],
+                },
+                evidence: {
+                    id: 'evidence_amorphous_ice_math',
+                    sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                    snippet: '### 核心概念与数学基础\n其结构可用径向分布函数 $g(r)$ 描述。\n$$ g(r) = \\frac{V}{N^2} \\left\\langle \\sum_{i=1}^{N} \\delta(r) \\right\\rangle $$',
+                    startLine: 7,
+                    endLine: 18,
+                },
+                score: 0.86,
+            }),
+            makeQueryItem({
+                atom: {
+                    id: 'atom_amorphous_ice_application',
+                    documentId: 'doc_amorphous_ice',
+                    title: '常见用例与性能指标',
+                    sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                    content: '### 常见用例与性能指标\n本节介绍冷冻电子显微镜和天体物理学应用。',
+                    keywords: ['常见用例', '性能指标', '应用'],
+                },
+                evidence: {
+                    id: 'evidence_amorphous_ice_application',
+                    sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                    snippet: '### 常见用例与性能指标\n本节介绍冷冻电子显微镜和天体物理学应用。',
+                    startLine: 48,
+                    endLine: 52,
+                },
+                score: 0.62,
+            }),
+        ];
+        const points = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)(items, () => []);
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: '什么是非晶冰？我应该通过哪些知识点学习？',
+            answerLanguage: 'zh',
+            knowledgePoints: points,
+            citations: points[0]?.citations || [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-01T00:00:00.000Z',
+            nextBlockId: (() => {
+                let index = 0;
+                return () => `compound_definition_block_${++index}`;
+            })(),
+            ragContextPack: {
+                query: '什么是非晶冰？我应该通过哪些知识点学习？',
+                generatedAt: '2026-09-01T00:00:00.000Z',
+                sourceBoundary: 'direct_span_only',
+                budget: { maxFragments: 3, maxCharsPerFragment: 900, maxTotalChars: 2400 },
+                fragments: [
+                    {
+                        fragmentId: 'rag_amorphous_ice_definition',
+                        role: 'direct_support',
+                        atomId: 'atom_amorphous_ice_definition',
+                        documentId: 'doc_amorphous_ice',
+                        sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                        title: '非晶冰',
+                        headingPath: ['非晶冰'],
+                        text: '## 非晶冰\n非晶冰（Amorphous ice）是水的一种固态形式，其分子排列缺乏长程有序结构。',
+                        startLine: 3,
+                        endLine: 6,
+                        charCount: 80,
+                        tokenEstimate: 20,
+                        truncated: false,
+                        citationIds: ['evidence_amorphous_ice_definition'],
+                        relationEdgeIds: [],
+                        sourceBoundary: 'direct_span_only',
+                        score: 0.98,
+                    },
+                    {
+                        fragmentId: 'rag_amorphous_ice_math',
+                        role: 'direct_support',
+                        atomId: 'atom_amorphous_ice_math',
+                        documentId: 'doc_amorphous_ice',
+                        sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                        title: '核心概念与数学基础',
+                        headingPath: ['非晶冰', '核心概念与数学基础'],
+                        text: '### 核心概念与数学基础\n其结构可用径向分布函数 $g(r)$ 描述。\n$$ g(r) = \\frac{V}{N^2} \\left\\langle \\sum_{i=1}^{N} \\delta(r) \\right\\rangle $$',
+                        startLine: 7,
+                        endLine: 18,
+                        charCount: 160,
+                        tokenEstimate: 40,
+                        truncated: false,
+                        citationIds: ['evidence_amorphous_ice_math'],
+                        relationEdgeIds: [],
+                        sourceBoundary: 'direct_span_only',
+                        score: 0.86,
+                    },
+                    {
+                        fragmentId: 'rag_amorphous_ice_technical_noise',
+                        role: 'direct_support',
+                        atomId: 'atom_amorphous_ice_application',
+                        documentId: 'doc_amorphous_ice',
+                        sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                        title: '关键技术规格',
+                        headingPath: ['非晶冰', '关键技术规格'],
+                        text: '### 关键技术规格\n非晶冰存在多种形态，玻璃化转变温度为 $T_g$。',
+                        startLine: 32,
+                        endLine: 45,
+                        charCount: 70,
+                        tokenEstimate: 18,
+                        truncated: false,
+                        citationIds: ['evidence_amorphous_ice_application'],
+                        relationEdgeIds: [],
+                        sourceBoundary: 'direct_span_only',
+                        score: 0.72,
+                    },
+                    {
+                        fragmentId: 'rag_amorphous_ice_math_duplicate',
+                        role: 'parent_context',
+                        atomId: 'atom_amorphous_ice_math',
+                        documentId: 'doc_amorphous_ice',
+                        sourcePath: 'Knowledge_Base/waterglass/Amorphous ice.md',
+                        title: '核心概念与数学基础',
+                        headingPath: ['非晶冰', '核心概念与数学基础'],
+                        text: '核心概念重复说明：$$ g(r) = \\frac{V}{N^2} \\left\\langle \\sum_{i=1}^{N} \\delta(r) \\right\\rangle $$。',
+                        startLine: 19,
+                        endLine: 23,
+                        charCount: 110,
+                        tokenEstimate: 28,
+                        truncated: false,
+                        citationIds: ['evidence_amorphous_ice_math'],
+                        relationEdgeIds: [],
+                        sourceBoundary: 'full_document',
+                        score: 0.65,
+                    },
+                ],
+                sourceDecisions: [],
+                totalCharCount: 240,
+                tokenEstimate: 60,
+            },
+            ragSufficiencyReview: {
+                reviewedAt: '2026-09-01T00:00:00.000Z',
+                status: 'sufficient',
+                score: 0.95,
+                reasons: [],
+                deterministic: true,
+                recoveryAttempted: false,
+                llmJudgeUsed: false,
+                degradationState: 'none',
+            },
+        });
+        expect(reply.answer).toContain('非晶冰（Amorphous ice）是水的一种固态形式');
+        expect(reply.answer).toContain('$g(r)$');
+        expect(reply.answer).toContain('$$');
+        expect(reply.answer).not.toMatch(/###\s+(?!建议学习路径)/u);
+        expect(reply.answer).not.toContain('常见用例与性能指标');
+        expect(reply.answer).not.toContain('关键技术规格');
+        expect(reply.answer).not.toContain('$T_g$');
+        expect(reply.answer).not.toContain('本节介绍');
+        expect(reply.answer).not.toContain('水杯');
+        expect((reply.answer.match(/\\frac\{V\}\{N\^2\}/gu) || [])).toHaveLength(1);
+        expect(reply.answer).toContain('\n\n$$\n');
+        expect(reply.answer).toContain('\n### 建议学习路径\n');
+        expect(reply.answer).toContain('1. **核心结构与数学基础**');
+        expect(reply.answer).toContain('当前资料顺序，不代表显式前置关系');
+        expect(reply.answer).not.toContain('后续分支包括');
+        const structuredBlock = reply.assistantBlocks.find((block) => block.type === 'structured_answer');
+        expect(structuredBlock && 'answerTaskPlan' in structuredBlock ? structuredBlock.answerTaskPlan : undefined)
+            .toEqual(expect.objectContaining({
+            schemaVersion: '1',
+            subtasks: expect.arrayContaining([
+                expect.objectContaining({ kind: 'learning_route', required: true }),
+            ]),
+        }));
+        expect(reply.answerReleaseReview.answerTaskCoverage).toEqual(expect.objectContaining({
+            passed: true,
+            coveredSubtaskIds: expect.arrayContaining(['learning_route']),
+        }));
+    });
+    test('compound definition release stays bounded when the RAG pack contains a full document', () => {
+        const sourcePath = 'Knowledge_Base/waterglass/Amorphous ice.md';
+        const documentText = [
+            '## 非晶冰',
+            '非晶冰（Amorphous ice）是水的一种固态形式，其分子排列缺乏晶体冰的长程有序结构。',
+            '### 核心概念与数学基础',
+            '其结构可用径向分布函数 $g(r)$ 描述。',
+            '$$ g(r) = \\frac{V}{N^2} \\left\\langle \\sum_{i=1}^{N} \\delta(r) \\right\\rangle $$',
+            '#### 4. 热力学：热量传递',
+            '系统内部的温度场由热传导方程描述。',
+            '### 常见用例与性能指标',
+            '非晶冰可用于冷冻电子显微镜和天体物理学研究。',
+            '### 关键技术规格',
+            '不同密度和制备方法会形成不同形态。',
+            '### 相关技术与比较数学模型',
+            '```mermaid\ngraph LR\nA[非晶冰] --> B[晶体冰]\n```',
+        ].join('\n');
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_full_document_amorphous_ice',
+                documentId: 'doc_full_document_amorphous_ice',
+                title: '非晶冰',
+                sourcePath,
+                content: documentText,
+                keywords: ['非晶冰', 'amorphous', 'ice'],
+            },
+            evidence: {
+                id: 'evidence_full_document_amorphous_ice',
+                sourcePath,
+                snippet: documentText,
+                startLine: 1,
+                endLine: 12,
+            },
+            score: 0.98,
+        });
+        const points = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: '什么是非晶冰？我应该通过哪些知识点学习？',
+            answerLanguage: 'zh',
+            knowledgePoints: points,
+            citations: points[0]?.citations || [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-01T00:20:00.000Z',
+            nextBlockId: (() => {
+                let index = 0;
+                return () => `full_document_compound_block_${++index}`;
+            })(),
+            ragContextPack: {
+                query: '什么是非晶冰？我应该通过哪些知识点学习？',
+                generatedAt: '2026-09-01T00:20:00.000Z',
+                sourceBoundary: 'full_document',
+                budget: { maxFragments: 4, maxCharsPerFragment: 1600, maxTotalChars: 5000 },
+                fragments: [
+                    {
+                        fragmentId: 'rag_full_document_amorphous_ice',
+                        role: 'direct_support',
+                        atomId: 'atom_full_document_amorphous_ice',
+                        documentId: 'doc_full_document_amorphous_ice',
+                        sourcePath,
+                        title: '非晶冰',
+                        headingPath: ['非晶冰'],
+                        text: documentText,
+                        startLine: 1,
+                        endLine: 12,
+                        charCount: documentText.length,
+                        tokenEstimate: 180,
+                        truncated: false,
+                        citationIds: ['evidence_full_document_amorphous_ice'],
+                        relationEdgeIds: [],
+                        sourceBoundary: 'full_document',
+                        score: 0.98,
+                    },
+                    {
+                        fragmentId: 'rag_full_document_amorphous_ice_duplicate_formula',
+                        role: 'parent_context',
+                        atomId: 'atom_full_document_amorphous_ice',
+                        documentId: 'doc_full_document_amorphous_ice',
+                        sourcePath,
+                        title: '核心概念与数学基础',
+                        headingPath: ['非晶冰', '核心概念与数学基础'],
+                        text: '核心概念重复说明：$$ g(r) = \\frac{V}{N^2} \\left\\langle \\sum_{i=1}^{N} \\delta(r) \\right\\rangle $$。',
+                        startLine: 4,
+                        endLine: 5,
+                        charCount: 110,
+                        tokenEstimate: 28,
+                        truncated: false,
+                        citationIds: ['evidence_full_document_amorphous_ice'],
+                        relationEdgeIds: [],
+                        sourceBoundary: 'full_document',
+                        score: 0.7,
+                    },
+                ],
+                sourceDecisions: [],
+                totalCharCount: documentText.length + 110,
+                tokenEstimate: 208,
+            },
+            ragSufficiencyReview: {
+                reviewedAt: '2026-09-01T00:20:00.000Z',
+                status: 'sufficient',
+                score: 0.95,
+                reasons: [],
+                deterministic: true,
+                recoveryAttempted: false,
+                llmJudgeUsed: false,
+                degradationState: 'none',
+            },
+        });
+        expect(reply.answer).toContain('非晶冰（Amorphous ice）是水的一种固态形式');
+        expect(reply.answer).toContain('g(r)');
+        expect(reply.answer).toContain('$$');
+        expect(reply.answer).not.toContain('常见用例与性能指标');
+        expect(reply.answer).not.toContain('关键技术规格');
+        expect(reply.answer).not.toContain('相关技术与比较数学模型');
+        expect(reply.answer).not.toContain('```mermaid');
+        expect(reply.graphAnswerPlan.answerTaskPlan?.learningRoute.length).toBeGreaterThanOrEqual(3);
+        expect(reply.graphAnswerPlan.answerTaskPlan?.learningRoute.every((node) => node.evidenceRefs.length > 0)).toBe(true);
+        expect(reply.answerReleaseReview.answerTaskCoverage).toEqual(expect.objectContaining({
+            passed: true,
+            coveredSubtaskIds: expect.arrayContaining(['definition', 'learning_route']),
+        }));
+        expect(reply.answer).not.toMatch(/(?:^|\\s)\\d+\\.?(?:\\s|$)/u);
+        expect((reply.answer.match(/\\frac\{V\}\{N\^2\}/gu) || [])).toHaveLength(1);
+        expect(reply.answer.length).toBeLessThan(900);
+    });
+    test('simple definition release keeps complete core formulas without expanding into later sections', () => {
+        const sourcePath = 'Knowledge_Base/waterglass/water glass.md';
+        const documentText = [
+            '## 水杯 (water glass)',
+            '此处的“水杯”被定义为一个由水和透明玻璃容器组成的物理系统。',
+            '### 核心概念及其数学基础',
+            '系统内部温度由热传导方程描述： $$ \\frac{\\partial T}{\\partial t}=\\alpha\\nabla^2 T $$。',
+            '当光线穿过空气、玻璃和水时会发生折射，满足斯涅尔定律： $$ n_1\\sin(\\theta_1)=n_2\\sin(\\theta_2) $$。',
+            '### 常见用例与量化性能指标',
+            '静水压力可以用 P = rho g h 估算。',
+            '### 相关技术与比较数学模型',
+            '```mermaid\ngraph LR\nA[水杯] --> B[塑料杯]\n```',
+        ].join('\n');
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_full_document_water_glass',
+                documentId: 'doc_full_document_water_glass',
+                title: '水杯 (water glass)',
+                sourcePath,
+                content: documentText,
+                keywords: ['水杯', 'water', 'glass'],
+            },
+            evidence: {
+                id: 'evidence_full_document_water_glass',
+                sourcePath,
+                snippet: documentText,
+                startLine: 1,
+                endLine: 9,
+            },
+            score: 0.98,
+        });
+        const points = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const reply = (0, conversationComposer_1.buildScopedConversationReply)({
+            message: '什么是waterglass?',
+            answerLanguage: 'zh',
+            knowledgePoints: points,
+            citations: points[0]?.citations || [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-09-01T00:30:00.000Z',
+            nextBlockId: (() => {
+                let index = 0;
+                return () => `simple_full_document_block_${++index}`;
+            })(),
+            ragContextPack: {
+                query: '什么是waterglass?',
+                generatedAt: '2026-09-01T00:30:00.000Z',
+                sourceBoundary: 'full_document',
+                budget: { maxFragments: 2, maxCharsPerFragment: 1800, maxTotalChars: 3600 },
+                fragments: [{
+                        fragmentId: 'rag_full_document_water_glass',
+                        role: 'direct_support',
+                        atomId: 'atom_full_document_water_glass',
+                        documentId: 'doc_full_document_water_glass',
+                        sourcePath,
+                        title: '水杯 (water glass)',
+                        headingPath: ['水杯 (water glass)'],
+                        text: documentText,
+                        startLine: 1,
+                        endLine: 9,
+                        charCount: documentText.length,
+                        tokenEstimate: 160,
+                        truncated: false,
+                        citationIds: ['evidence_full_document_water_glass'],
+                        relationEdgeIds: [],
+                        sourceBoundary: 'full_document',
+                        score: 0.98,
+                    }],
+                sourceDecisions: [],
+                totalCharCount: documentText.length,
+                tokenEstimate: 160,
+            },
+            ragSufficiencyReview: {
+                reviewedAt: '2026-09-01T00:30:00.000Z',
+                status: 'sufficient',
+                score: 0.95,
+                reasons: [],
+                deterministic: true,
+                recoveryAttempted: false,
+                llmJudgeUsed: false,
+                degradationState: 'none',
+            },
+        });
+        expect(reply.answer).toContain('水杯');
+        expect(reply.answer).toContain('\\frac{\\partial T}{\\partial t}=\\alpha\\nabla^2 T');
+        expect(reply.answer).toContain('n_1\\sin(\\theta_1)=n_2\\sin(\\theta_2)');
+        expect(reply.answer).not.toContain('常见用例与量化性能指标');
+        expect(reply.answer).not.toContain('相关技术与比较数学模型');
+        expect(reply.answer).not.toContain('```mermaid');
+        expect((reply.answer.match(/\\frac\{\\partial T\}\{\\partial t\}=\\alpha\\nabla\^2 T/gu) || [])).toHaveLength(1);
+        expect((reply.answer.match(/n_1\\sin\(\\theta_1\)=n_2\\sin\(\\theta_2\)/gu) || [])).toHaveLength(1);
+        expect(reply.answer.length).toBeLessThan(900);
+    });
+    test('uses the explicit answer language for grounded and deferred action text', () => {
+        const item = makeQueryItem({
+            atom: {
+                id: 'atom_language_contract',
+                documentId: 'doc_language_contract',
+                title: 'Language Contract',
+                content: 'A language contract keeps the answer and follow-up actions consistent.',
+            },
+            evidence: {
+                id: 'evidence_language_contract',
+                snippet: 'A language contract keeps the answer and follow-up actions consistent.',
+            },
+            score: 0.95,
+        });
+        const points = (0, conversationComposer_1.mergeAgentConversationKnowledgePoints)([item], () => []);
+        const buildReply = (answerLanguage) => (0, conversationComposer_1.buildScopedConversationReply)({
+            message: 'what is language contract?',
+            answerLanguage,
+            knowledgePoints: points,
+            citations: points[0].citations || [],
+            recalledMemories: [],
+            memoryActions: [],
+            usedScope: globalScope,
+            generatedAt: '2026-07-12T00:10:00.000Z',
+            nextBlockId: (() => {
+                let index = 0;
+                return () => `language_block_${answerLanguage}_${++index}`;
+            })(),
+        });
+        const englishBlock = buildReply('en').assistantBlocks.find((block) => block.type === 'structured_answer');
+        const chineseBlock = buildReply('zh').assistantBlocks.find((block) => block.type === 'structured_answer');
+        expect(englishBlock && 'title' in englishBlock ? englishBlock.title : '').toBe('Grounded Answer');
+        expect(chineseBlock && 'title' in chineseBlock ? chineseBlock.title : '').toBe('可信回答');
+        expect(englishBlock && 'directAnswer' in englishBlock ? englishBlock.directAnswer : '').toMatch(/\.$/u);
+        expect(englishBlock && 'nextActionsMarkdown' in englishBlock ? englishBlock.nextActionsMarkdown : '').toContain('## Next Actions');
+        expect(chineseBlock && 'directAnswer' in chineseBlock ? chineseBlock.directAnswer : '').toMatch(/。$/u);
+        expect(chineseBlock && 'nextActionsMarkdown' in chineseBlock ? chineseBlock.nextActionsMarkdown : '').toContain('## 下一步行动');
+        expect(chineseBlock && 'nextActionsMarkdown' in chineseBlock ? chineseBlock.nextActionsMarkdown : '').not.toContain('## Next Actions');
+        expect(chineseBlock && 'overviewMarkdown' in chineseBlock ? chineseBlock.overviewMarkdown : '').toContain('## \u56de\u7b54\u4e0a\u4e0b\u6587');
+        expect(chineseBlock && 'explanationMarkdown' in chineseBlock ? chineseBlock.explanationMarkdown : '').toContain('## \u8bf4\u660e');
+        expect(chineseBlock && 'evidenceMarkdown' in chineseBlock ? chineseBlock.evidenceMarkdown : '').toContain('## \u8bc1\u636e\u6458\u8981');
+        expect(buildReply('zh').assistantBlocks).toEqual(expect.arrayContaining([
+            expect.objectContaining({ type: 'knowledge_run_summary', title: '\u77e5\u8bc6\u8fd0\u884c' }),
+            expect.objectContaining({ type: 'citations', title: '\u5f15\u7528' }),
+            expect.objectContaining({ type: 'knowledge_actions', title: '\u77e5\u8bc6\u64cd\u4f5c' }),
+            expect.objectContaining({ type: 'system_notice', text: expect.stringContaining('\u672a\u53ec\u56de') }),
+        ]));
+    });
     test('fails graph comparison gate when compare intent only has reference context and no real branch signal', () => {
         const knowledgePoints = [
             {