feat(knowledge): 完成 L0+L1 混合检索集成

核心功能：
- 新增 FrontmatterParser 解析 YAML frontmatter
- 新增 KnowledgeIndexService L0 内存索引
- 新增 LookupKnowledgeTool 混合检索工具
- 增强 DocumentManagementService 文件保存和索引同步

技术实现：
- 数据库迁移 V004: api_document.metadata (TEXT)
- 依赖新增: snakeyaml 2.0
- 配置新增: knowledge.base-path
- 可观测性: requestId 追踪 + 性能日志

质量保证：
- 单元测试: 31/31 通过
- 测试覆盖: FrontmatterParser(11), KnowledgeIndexService(13), LookupKnowledgeTool(7)
- 启动验证: L0 索引正常加载

归档文档：
- OpenSpec: openspec/changes/lookup-knowledge-integration/
- devflow 档案: devflow/projects/2026-06-24-lookup-knowledge-integration/
- handoff: handoff/2026-06-24-lookup-knowledge-integration.md

src/main/java/com/superbiz/agent/dto/Frontmatter.java

@@ -0,0 +1,62 @@
+package com.superbiz.agent.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Frontmatter 数据模型
+ * 用于解析 Markdown 文件头的 YAML frontmatter
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Frontmatter {
+
+    /**
+     * 文档标题（必填）
+     */
+    private String title;
+
+    /**
+     * 关键词列表（必填，用于 L0 精确匹配）
+     */
+    private List<String> keywords;
+
+    /**
+     * 文档摘要（必填）
+     */
+    private String summary;
+
+    /**
+     * 文档类别（可选）
+     */
+    private String category;
+
+    /**
+     * 章节锚点（预留字段，MVP 不使用）
+     * Key: 章节标题，Value: 章节 Markdown 标题
+     */
+    private Map<String, String> sections;
+
+    /**
+     * 版本号（预留字段）
+     */
+    private String version;
+
+    /**
+     * 作者（预留字段）
+     */
+    private String author;
+
+    /**
+     * 最后更新日期（预留字段）
+     */
+    private LocalDate lastUpdated;
+}

src/main/java/com/superbiz/agent/dto/KnowledgeEntry.java

@@ -0,0 +1,46 @@
+package com.superbiz.agent.dto;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 知识库索引条目
+ * L0 内存索引使用的数据结构
+ */
+@Data
+@Builder
+public class KnowledgeEntry {
+
+    /**
+     * 文件路径（如：knowledge_base/api/payment-errors.md）
+     */
+    private String filePath;
+
+    /**
+     * 文档标题
+     */
+    private String title;
+
+    /**
+     * 关键词列表（用于精确匹配）
+     */
+    private List<String> keywords;
+
+    /**
+     * 文档摘要
+     */
+    private String summary;
+
+    /**
+     * 文档类别（如：api、domain、troubleshooting）
+     */
+    private String category;
+
+    /**
+     * 章节锚点（预留字段，MVP 不使用）
+     */
+    private Map<String, String> sections;
+}

src/main/java/com/superbiz/agent/dto/LookupResult.java

@@ -0,0 +1,29 @@
+package com.superbiz.agent.dto;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 知识库查询结果
+ */
+@Data
+@Builder
+public class LookupResult {
+
+    /**
+     * 是否找到结果
+     */
+    private boolean found;
+
+    /**
+     * 主要结果（L0 精确匹配）
+     */
+    private PrimaryResult primary;
+
+    /**
+     * 补充结果（L1 语义检索）
+     */
+    private SupplementResult supplement;
+}

src/main/java/com/superbiz/agent/dto/PrimaryResult.java

@@ -0,0 +1,39 @@
+package com.superbiz.agent.dto;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * L0 精确匹配结果
+ */
+@Data
+@Builder
+public class PrimaryResult {
+
+    /**
+     * 文档内容（前 2000 字符）
+     */
+    private String content;
+
+    /**
+     * 文档来源路径
+     */
+    private String source;
+
+    /**
+     * 匹配类型（exact_L0）
+     */
+    private String matchType;
+
+    /**
+     * 置信度（high / low）
+     */
+    private String confidence;
+
+    /**
+     * 可用的章节列表（预留字段，MVP 返回 null）
+     */
+    private List<String> availableSections;
+}

src/main/java/com/superbiz/agent/dto/SupplementResult.java

@@ -0,0 +1,27 @@
+package com.superbiz.agent.dto;
+
+import lombok.Builder;
+import lombok.Data;
+
+/**
+ * L1 语义检索补充结果
+ */
+@Data
+@Builder
+public class SupplementResult {
+
+    /**
+     * 文档内容片段
+     */
+    private String content;
+
+    /**
+     * 文档来源
+     */
+    private String source;
+
+    /**
+     * 匹配类型（semantic_L1）
+     */
+    private String matchType;
+}