feat(rag): close eval pipeline with live snapshots

src/test/java/com/superbiz/agent/service/VectorIndexServiceTest.java

@@ -1,8 +1,11 @@
 package com.superbiz.agent.service;
 
 import com.superbiz.agent.dto.DocumentChunk;
+import com.superbiz.agent.dto.Frontmatter;
 import org.junit.jupiter.api.Test;
 
+import java.util.Map;
+
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
 class VectorIndexServiceTest {
@@ -34,4 +37,35 @@ class VectorIndexServiceTest {
 
         assertEquals("Plain chunk content.", VectorIndexService.buildEmbeddingText(chunk));
     }
+
+    @Test
+    void buildDocumentMetadataUsesFrontmatterRetrievalFields() {
+        DocumentChunk chunk = DocumentChunk.builder()
+                .chunkIndex(0)
+                .title("Chunk Title")
+                .breadcrumb("Chunk > Path")
+                .content("content")
+                .build();
+        Frontmatter frontmatter = Frontmatter.builder()
+                .title("Document Title")
+                .source("mysql-connection-pool")
+                .breadcrumb("Database > MySQL > Connection Pool")
+                .kbScope("rag-eval")
+                .build();
+
+        Map<String, Object> metadata = VectorIndexService.buildDocumentMetadata(
+                "mysql-connection-pool",
+                chunk,
+                2,
+                "database",
+                frontmatter
+        );
+
+        assertEquals("mysql-connection-pool", metadata.get("docId"));
+        assertEquals("mysql-connection-pool", metadata.get("_source"));
+        assertEquals("mysql-connection-pool", metadata.get("source"));
+        assertEquals("database", metadata.get("category"));
+        assertEquals("rag-eval", metadata.get("kb_scope"));
+        assertEquals("Database > MySQL > Connection Pool", metadata.get("breadcrumb"));
+    }
 }