autosnippet 3.3.2 → 3.3.4

package/dist/lib/external/mcp/tools.js

@@ -1,239 +1,241 @@
 /**
- * MCP 工具定义 — V3 整合版 (14 agent + 2 admin = 16 工具)
+ * MCP Tool Definitions — V3 Consolidated (14 agent + 2 admin = 16 tools)
  *
- * 每个工具声明包含 name、tier（agent/admin）、description 和 inputSchema。
- * description 是 Agent 选择工具的关键 — 使用 bullet list 列出所有 operation 及其用途。
- * inputSchema 由 Zod Schema 自动生成（zodToMcpSchema），参数的 .describe() 会转为 JSON Schema description。
+ * Each tool declaration contains name, tier (agent/admin), description, and inputSchema.
+ * description is the key for Agent tool selection — use bullet list to enumerate all operations and their purposes.
+ * inputSchema is auto-generated from Zod Schema (zodToMcpSchema); parameter .describe() translates to JSON Schema description.
  *
- * Agent 工具 (14):
- *   1-7:   查询工具 (health/search/knowledge/structure/graph/call_context/guard)
- *   8:     写入工具 (submit_knowledge — unified pipeline，单条/批量统一处理)
- *   9:     Skill 管理 (skill)
- *   10-12: 冷启动 (bootstrap/dimension_complete/wiki)
- *   13:    项目全景 (panorama)
- *   14:    任务管理 (task — 5 ops: prime/create/close/fail/record_decision)
+ * Agent tools (14):
+ *   1-7:   Query tools (health/search/knowledge/structure/graph/call_context/guard)
+ *   8:     Write tool (submit_knowledge — unified pipeline, single/batch)
+ *   9:     Skill management (skill)
+ *   10-12: Cold-start (bootstrap/dimension_complete/wiki)
+ *   13:    Project panorama (panorama)
+ *   14:    Task management (task — 5 ops: prime/create/close/fail/record_decision)
  *
- * Admin 工具 (2):
+ * Admin tools (2):
  *   15-16: enrich_candidates/knowledge_lifecycle
  */
 import { BootstrapInput, CallContextInput, DimensionCompleteInput, EnrichCandidatesInput, GraphInput, GuardInput, HealthInput, KnowledgeInput, KnowledgeLifecycleInput, PanoramaInput, SearchInput, SkillInput, StructureInput, SubmitKnowledgeInput, TaskInput, WikiInput, } from '#shared/schemas/mcp-tools.js';
 import { zodToMcpSchema } from './zodToMcpSchema.js';
-// ─── Tier 定义 ──────────────────────────────────────────────
+// ─── Tier Definitions ────────────────────────────────────────
 export const TIER_ORDER = { agent: 0, admin: 1 };
-// ─── Gateway 映射（仅写操作需要 gating） ────────────────────
+// ─── Gateway Mapping (only write operations require gating) ─
 export const TOOL_GATEWAY_MAP = {
-    // bootstrap — 无参数化 Mission Briefing（只读分析，无需 gating）
+    // bootstrap — parameterless Mission Briefing (read-only analysis, no gating needed)
     // autosnippet_bootstrap: null,
-    // dimension_complete — 写操作（recipe tagging + skill creation + checkpoint）
+    // dimension_complete — write operation (recipe tagging + skill creation + checkpoint)
     autosnippet_dimension_complete: { action: 'knowledge:bootstrap', resource: 'knowledge' },
-    // wiki — finalize 操作是写操作（meta.json）
+    // wiki — finalize is a write operation (meta.json)
     autosnippet_wiki: {
-        resolver: (args) => args?.operation === 'finalize' ? { action: 'knowledge:create', resource: 'knowledge' } : null, // plan 只读
+        resolver: (args) => args?.operation === 'finalize' ? { action: 'knowledge:create', resource: 'knowledge' } : null, // plan is read-only
     },
-    // guard 写操作（仅 files 模式）
+    // guard write operation (files mode only)
     autosnippet_guard: {
         resolver: (args) => args?.files && Array.isArray(args.files)
             ? { action: 'guard_rule:check_code', resource: 'guard_rules' }
-            : null, // code 模式只读，跳过 Gateway
+            : null, // code mode is read-only, skip Gateway
     },
-    // skill 写操作（create/update/delete）
+    // skill write operations (create/update/delete)
     autosnippet_skill: {
         resolver: (args) => ({
             create: { action: 'create:skills', resource: 'skills' },
             update: { action: 'update:skills', resource: 'skills' },
             delete: { action: 'delete:skills', resource: 'skills' },
-        })[args?.operation] || null, // list/load/suggest 只读
+        })[args?.operation] || null, // list/load/suggest are read-only
     },
-    // 知识提交（unified pipeline）
+    // knowledge submission (unified pipeline)
     autosnippet_submit_knowledge: { action: 'knowledge:create', resource: 'knowledge' },
-    // task 写操作（create/close/fail + record_decision）
+    // task write operations (create/close/fail + record_decision)
     autosnippet_task: {
         resolver: (args) => ({
             create: { action: 'task:create', resource: 'intent' },
             close: { action: 'task:update', resource: 'intent' },
             fail: { action: 'task:update', resource: 'intent' },
             record_decision: { action: 'task:create', resource: 'intent' },
-        })[args?.operation] || null, // prime 只读
+        })[args?.operation] || null, // prime is read-only
     },
-    // admin 工具
+    // admin tools
     autosnippet_enrich_candidates: { action: 'knowledge:update', resource: 'knowledge' },
     autosnippet_knowledge_lifecycle: { action: 'knowledge:update', resource: 'knowledge' },
 };
-// ─── 工具声明 ────────────────────────────────────────────────
+// ─── Tool Declarations ───────────────────────────────────────
 export const TOOLS = [
     // ══════════════════════════════════════════════════════
-    //  Tier: agent — Agent 核心工具集 (14 个)
+    //  Tier: agent — Core Agent Toolset (14)
     // ══════════════════════════════════════════════════════
-    // 1. 健康检查
+    // 1. Health Check
     {
         name: 'autosnippet_health',
         tier: 'agent',
-        description: '检查服务状态与知识库统计。返回 total（知识总数）和各 kind/lifecycle 分布。total=0 时需要冷启动（调用 autosnippet_bootstrap）。',
+        description: 'Check service status and knowledge base stats. Returns total (entry count) and kind/lifecycle distribution. When total=0, cold-start is needed (call autosnippet_bootstrap).',
         inputSchema: zodToMcpSchema(HealthInput),
     },
-    // 2. 统合搜索
+    // 2. Unified Search
     {
         name: 'autosnippet_search',
         tier: 'agent',
-        description: '搜索知识库。5 种模式：\n' +
-            '• auto（默认）— 自动选最优策略\n' +
-            '• keyword — 精确关键词匹配，适合 trigger/title 查找\n' +
-            '• bm25 — 全文检索，适合自然语言描述\n' +
-            '• semantic — 向量语义搜索，适合模糊概念匹配\n' +
-            '• context — 综合搜索 + 上下文关联，适合编码辅助\n' +
-            '返回按 kind（rule/pattern/fact）分组的结果。',
+        description: 'Search the knowledge base. 5 modes:\n' +
+            '• auto (default) — automatically selects optimal strategy\n' +
+            '• keyword — exact keyword matching, best for trigger/title lookup\n' +
+            '• bm25 — full-text search, best for natural language descriptions\n' +
+            '• semantic — vector semantic search, best for fuzzy concept matching\n' +
+            '• context — combined search + context association, best for coding assistance\n' +
+            'Returns results grouped by kind (rule/pattern/fact).',
         inputSchema: zodToMcpSchema(SearchInput),
     },
-    // 3. 知识浏览
+    // 3. Knowledge Browser
     {
         name: 'autosnippet_knowledge',
         tier: 'agent',
-        description: '知识条目管理。\n' +
-            '• list — 按 kind/category/status 过滤列表\n' +
-            '• get — 获取单条完整内容（需 id）\n' +
-            '• insights — 条目质量分析与改进建议（需 id）\n' +
-            '• confirm_usage — 记录知识被实际采纳（需 id）',
+        description: 'Knowledge entry management.\n' +
+            '• list — filter entries by kind/category/status\n' +
+            '• get — retrieve full content of a single entry (requires id)\n' +
+            '• insights — quality analysis and improvement suggestions (requires id)\n' +
+            '• confirm_usage — record that knowledge was actually adopted (requires id)',
         inputSchema: zodToMcpSchema(KnowledgeInput),
     },
-    // 4. 项目结构
+    // 4. Project Structure
     {
         name: 'autosnippet_structure',
         tier: 'agent',
-        description: '探查项目结构。\n' +
-            '• targets — 构建目标列表（模块/Target/Package）\n' +
-            '• files — 指定 Target 的文件列表\n' +
-            '• metadata — 项目元数据（语言、依赖、配置）',
+        description: 'Explore project structure.\n' +
+            '• targets — list build targets (modules/Targets/Packages)\n' +
+            '• files — list files for a specific Target\n' +
+            '• metadata — project metadata (language, dependencies, configuration)',
         inputSchema: zodToMcpSchema(StructureInput),
     },
-    // 5. 知识图谱
+    // 5. Knowledge Graph
     {
         name: 'autosnippet_graph',
         tier: 'agent',
-        description: '知识关系图谱查询。\n' +
-            '• query — 查询节点的关联关系\n' +
-            '• impact — 修改某知识的影响范围分析\n' +
-            '• path — 两个知识节点间的关联路径\n' +
-            '• stats — 图谱全局统计（节点/边/密度）',
+        description: 'Knowledge relationship graph queries.\n' +
+            '• query — query relationships of a node\n' +
+            '• impact — analyze impact scope of modifying a knowledge entry\n' +
+            '• path — find relationship path between two knowledge nodes\n' +
+            '• stats — global graph statistics (nodes/edges/density)',
         inputSchema: zodToMcpSchema(GraphInput),
     },
-    // 6. 调用链上下文
+    // 6. Call Context
     {
         name: 'autosnippet_call_context',
         tier: 'agent',
-        description: '查询函数/方法的调用链。\n' +
-            '• callers — 谁调用了它（上游调用链）\n' +
-            '• callees — 它调用了谁（下游依赖链）\n' +
-            '• impact — 修改它的影响半径（上+下游+受影响文件数）\n' +
-            '• both — 同时获取 callers + callees',
+        description: 'Query function/method call chains.\n' +
+            '• callers — who calls it (upstream call chain)\n' +
+            '• callees — what it calls (downstream dependency chain)\n' +
+            '• impact — modification impact radius (upstream + downstream + affected file count)\n' +
+            '• both — retrieve callers + callees simultaneously',
         inputSchema: zodToMcpSchema(CallContextInput),
     },
-    // 7. Guard 代码检查
+    // 7. Guard Code Check
     {
         name: 'autosnippet_guard',
         tier: 'agent',
-        description: '代码规范检查与 Guard 免疫系统。\n' +
-            '• 无参数 → 自动检查 git diff 增量文件（编码后首选用法）\n' +
-            '• files → 检查指定文件列表\n' +
-            '• code → 内联检查代码片段\n' +
-            '• operation: "reverse_audit" → Recipe→Code 反向验证（检查知识是否过时）\n' +
-            '• operation: "coverage_matrix" → 模块级 Guard 规则覆盖率矩阵\n' +
-            '每个 violation 附带修复指南（doClause + coreCode），按指示修复后可再次检查。',
+        description: 'Code compliance check and Guard immune system.\n' +
+            '• no params → auto-check git diff incremental files (preferred after coding)\n' +
+            '• files → check specified file list\n' +
+            '• code → inline check code snippet\n' +
+            '• operation: "reverse_audit" → Recipe→Code reverse validation (check if knowledge is outdated)\n' +
+            '• operation: "coverage_matrix" → module-level Guard rule coverage matrix\n' +
+            'Each violation includes a fix guide (doClause + coreCode). Fix accordingly and re-check.',
         inputSchema: zodToMcpSchema(GuardInput),
     },
-    // 8. 提交知识（统一管线）
+    // 8. Submit Knowledge (Unified Pipeline)
     {
         name: 'autosnippet_submit_knowledge',
         tier: 'agent',
-        description: '提交知识条目（单条/批量统一管线）。通过 items 数组传入 1~N 条。\n' +
-            '• 所有条目统一严格校验，所有 V3 字段须一次性提供\n' +
-            '• 统一融合分析：检测与已有 Recipe 和批次内候选的重叠\n' +
-            '• 返回 CONSOLIDATION_MERGE / CONSOLIDATION_REORGANIZE / CONSOLIDATION_INSUFFICIENT 时需处理\n' +
-            '• 设 skipConsolidation: true 跳过融合检查。content 和 reasoning 必须是对象。',
+        description: 'Submit knowledge entries (single/batch unified pipeline). Pass 1~N items via the items array.\n' +
+            '• All entries undergo strict validation; all V3 fields must be provided at once\n' +
+            '• Unified consolidation analysis: detects overlap with existing Recipes and batch candidates\n' +
+            '• Handle CONSOLIDATION_MERGE / CONSOLIDATION_REORGANIZE / CONSOLIDATION_INSUFFICIENT responses\n' +
+            '• Set skipConsolidation: true to skip consolidation check. content and reasoning must be objects.\n' +
+            '⚠️ Batch rule: items in the array must NOT be cross-redundant — no highly overlapping doClause/coreCode/trigger within the same batch. ' +
+            'If two entries share 80%+ content, merge into one or split into primary + extends supplementary entries.',
         inputSchema: zodToMcpSchema(SubmitKnowledgeInput),
     },
-    // 9. Skill 管理
+    // 9. Skill Management
     {
         name: 'autosnippet_skill',
         tier: 'agent',
-        description: 'Skill 管理。\n' +
-            '• list — 列出所有可用 Skill（内置 + 项目级）\n' +
-            '• load — 加载 Skill 完整内容，获取详细指引（需 name）\n' +
-            '• create — 创建项目级 Skill（需 name + description + content）\n' +
-            '• update — 更新项目级 Skill 内容\n' +
-            '• delete — 删除项目级 Skill（内置不可删）\n' +
-            '• suggest — 基于项目分析推荐应创建的 Skill',
+        description: 'Skill management.\n' +
+            '• list — list all available Skills (built-in + project-level)\n' +
+            '• load — load full Skill content for detailed guidance (requires name)\n' +
+            '• create — create project-level Skill (requires name + description + content)\n' +
+            '• update — update project-level Skill content\n' +
+            '• delete — delete project-level Skill (built-in cannot be deleted)\n' +
+            '• suggest — recommend Skills to create based on project analysis',
         inputSchema: zodToMcpSchema(SkillInput),
     },
-    // 10. 冷启动
+    // 10. Cold-Start Bootstrap
     {
         name: 'autosnippet_bootstrap',
         tier: 'agent',
-        description: '冷启动 — 无需参数，自动分析项目（AST、依赖图、Guard 审计），返回 Mission Briefing：\n' +
-            '• 项目元数据与语言统计\n' +
-            '• 维度任务清单（8 维度 × 3 Tier）\n' +
-            '• 执行计划与提交示例\n' +
-            '收到 Briefing 后按 executionPlan 完成所有维度分析。',
+        description: 'Cold-start — no parameters needed. Auto-analyzes the project (AST, dependency graph, Guard audit) and returns a Mission Briefing:\n' +
+            '• Project metadata and language statistics\n' +
+            '• Dimension task list (8 dimensions × 3 Tiers)\n' +
+            '• Execution plan and submission examples\n' +
+            'After receiving the Briefing, complete all dimension analyses per the executionPlan.',
         inputSchema: zodToMcpSchema(BootstrapInput),
     },
-    // 11. 维度完成通知
+    // 11. Dimension Complete Notification
     {
         name: 'autosnippet_dimension_complete',
         tier: 'agent',
-        description: '维度分析完成通知。负责：Recipe 关联、Skill 生成（从已提交候选自动合成）、Checkpoint 保存、跨维度 Hints 分发。\n' +
-            'analysisText 可简写，系统会自动从已提交的候选知识中合成详细内容用于 Skill 生成。',
+        description: 'Dimension analysis completion notification. Handles: Recipe linking, Skill generation (auto-synthesized from submitted candidates), Checkpoint saving, cross-dimension Hints distribution.\n' +
+            'analysisText can be brief — the system auto-synthesizes detailed content from submitted candidates for Skill generation.',
         inputSchema: zodToMcpSchema(DimensionCompleteInput),
     },
-    // 12. Wiki 文档生成
+    // 12. Wiki Documentation Generation
     {
         name: 'autosnippet_wiki',
         tier: 'agent',
-        description: 'Wiki 文档生成。\n' +
-            '• plan — 规划主题 + 数据包（整合项目结构与知识库，返回主题列表 + 每个主题的数据包，Agent 据此撰写）\n' +
-            '• finalize — 完成生成（写入 meta.json、去重检查、验证完整性，所有文章写入后调用）',
+        description: 'Wiki documentation generation.\n' +
+            '• plan — plan topics + data packages (integrates project structure and knowledge base; returns topic list + per-topic data package for Agent to write)\n' +
+            '• finalize — complete generation (write meta.json, dedup check, validate completeness; call after all articles are written)',
         inputSchema: zodToMcpSchema(WikiInput),
     },
-    // 13. 项目全景
+    // 13. Project Panorama
     {
         name: 'autosnippet_panorama',
         tier: 'agent',
-        description: '项目全景查询。无数据时自动触发结构扫描，无需手动冷启动。\n' +
-            '• overview（默认）— 项目骨架 + 架构层级 + 模块角色 + 知识覆盖率\n' +
-            '• module — 单模块详情 + 邻居关系（需 module 参数）\n' +
-            '• gaps — 知识空白区（有代码无 Recipe 的模块）\n' +
-            '• health — 全景健康度（覆盖率 + 耦合度 + 循环依赖 + 健康评分）\n' +
-            '• governance_cycle — 知识新陈代谢完整周期（矛盾检测 + 冗余分析 + 衰退评估）\n' +
-            '• decay_report — 衰退评估报告（5 策略检测 + decayScore 评分）\n' +
-            '• staging_check — staging 条目检查 + 到期自动发布\n' +
-            '• enhancement_suggestions — 基于使用数据的 Recipe 增强建议',
+        description: 'Project panorama queries. Auto-triggers structure scan when no data exists — no manual cold-start needed.\n' +
+            '• overview (default) — project skeleton + architecture layers + module roles + knowledge coverage\n' +
+            '• module — single module details + neighbor relationships (requires module param)\n' +
+            '• gaps — knowledge gaps (modules with code but no Recipes)\n' +
+            '• health — panorama health score (coverage + coupling + circular deps + health score)\n' +
+            '• governance_cycle — full knowledge metabolism cycle (contradiction detection + redundancy analysis + decay assessment)\n' +
+            '• decay_report — decay assessment report (5 strategy detection + decayScore)\n' +
+            '• staging_check — staging entry check + auto-publish on expiry\n' +
+            '• enhancement_suggestions — Recipe enhancement suggestions based on usage data',
         inputSchema: zodToMcpSchema(PanoramaInput),
     },
-    // 14. 任务与决策管理
+    // 14. Task & Decision Management
     {
         name: 'autosnippet_task',
         tier: 'agent',
-        description: '任务与决策管理（5 operations）。每次对话开始时先调用 prime 加载知识上下文。\n' +
-            '• prime — 加载知识上下文 + 初始化意图生命周期\n' +
-            '• create — 创建任务锚点（≥2 files 或 ≥10 lines 的非轻量工作）\n' +
-            '• close — 完成任务 + 触发 Guard 合规审查\n' +
-            '• fail — 放弃任务\n' +
-            '• record_decision — 记录用户偏好决策',
+        description: 'Task and decision management (5 operations). Call prime first at the start of each conversation to load knowledge context.\n' +
+            '• prime — load knowledge context + initialize intent lifecycle\n' +
+            '• create — create task anchor (for non-trivial work: ≥2 files or ≥10 lines)\n' +
+            '• close — complete task + trigger Guard compliance review\n' +
+            '• fail — abandon task\n' +
+            '• record_decision — record user preference decision',
         inputSchema: zodToMcpSchema(TaskInput),
     },
     // ══════════════════════════════════════════════════════
-    //  Tier: admin — 管理员/CI 工具 (+2)
+    //  Tier: admin — Admin/CI Tools (+2)
     // ══════════════════════════════════════════════════════
-    // 15. 候选字段诊断
+    // 15. Candidate Field Diagnosis
     {
         name: 'autosnippet_enrich_candidates',
         tier: 'admin',
-        description: '诊断候选条目的字段完整性（无 AI）。返回每条候选的 missingFields 列表，Agent 据此补全后重新提交。',
+        description: 'Diagnose field completeness of candidate entries (no AI). Returns missingFields list per candidate for Agent to fill in and resubmit.',
         inputSchema: zodToMcpSchema(EnrichCandidatesInput),
     },
-    // 16. 知识生命周期
+    // 16. Knowledge Lifecycle
     {
         name: 'autosnippet_knowledge_lifecycle',
         tier: 'admin',
-        description: '知识条目生命周期操作。approve/fast_track → 发布知识；reject → 拒绝；deprecate → 废弃；reactivate → 恢复。',
+        description: 'Knowledge entry lifecycle operations. approve/fast_track → publish; reject → reject; deprecate → deprecate; reactivate → restore.',
         inputSchema: zodToMcpSchema(KnowledgeLifecycleInput),
     },
 ];

package/dist/lib/http/middleware/validate.js

@@ -60,8 +60,8 @@ export function validateQuery(schema) {
             });
             return;
         }
-        // 替换为 parsed + defaulted + coerced 数据
-        req.query = result.data;
+        // Express 5: req.query is a read-only getter, use defineProperty to override
+        Object.defineProperty(req, 'query', { value: result.data, writable: true, configurable: true });
         next();
     };
 }
@@ -85,7 +85,11 @@ export function validateParams(schema) {
             });
             return;
         }
-        req.params = result.data;
+        Object.defineProperty(req, 'params', {
+            value: result.data,
+            writable: true,
+            configurable: true,
+        });
         next();
     };
 }

package/dist/lib/infrastructure/database/drizzle/schema.d.ts

@@ -3311,3 +3311,103 @@ export declare const evolutionProposals: import("drizzle-orm/sqlite-core").SQLit
     };
     dialect: "sqlite";
 }>;
+export declare const recipeSourceRefs: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "recipe_source_refs";
+    schema: undefined;
+    columns: {
+        recipeId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "recipe_id";
+            tableName: "recipe_source_refs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        sourcePath: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "source_path";
+            tableName: "recipe_source_refs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "recipe_source_refs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        newPath: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "new_path";
+            tableName: "recipe_source_refs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        verifiedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "verified_at";
+            tableName: "recipe_source_refs";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "sqlite";
+}>;

package/dist/lib/infrastructure/database/drizzle/schema.js

@@ -329,3 +329,13 @@ export const evolutionProposals = sqliteTable('evolution_proposals', {
     index('idx_ep_expires').on(table.expiresAt),
     index('idx_ep_source').on(table.source),
 ]);
+// ═══════════════════════════════════════════════════════════════
+// 17. recipe_source_refs — Recipe 来源引用桥接表 (可信度证据链)
+// ═══════════════════════════════════════════════════════════════
+export const recipeSourceRefs = sqliteTable('recipe_source_refs', {
+    recipeId: text('recipe_id').notNull(),
+    sourcePath: text('source_path').notNull(),
+    status: text('status').notNull().default('active'),
+    newPath: text('new_path'),
+    verifiedAt: integer('verified_at').notNull(),
+}, (table) => [index('idx_rsr_path').on(table.sourcePath), index('idx_rsr_status').on(table.status)]);

package/dist/lib/infrastructure/database/migrations/005_recipe_source_refs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration 005 — Recipe Source References 桥接表
+ *
+ * 存储 Recipe 的 reasoning.sources 路径引用及其健康状态：
+ *   - active:  文件存在，路径有效
+ *   - renamed: 文件已移动到 new_path，等待修复
+ *   - stale:   路径失效，无法自动修复
+ */
+export default function migrate(db: import('better-sqlite3').Database): void;

package/dist/lib/infrastructure/database/migrations/005_recipe_source_refs.js

@@ -0,0 +1,24 @@
+/**
+ * Migration 005 — Recipe Source References 桥接表
+ *
+ * 存储 Recipe 的 reasoning.sources 路径引用及其健康状态：
+ *   - active:  文件存在，路径有效
+ *   - renamed: 文件已移动到 new_path，等待修复
+ *   - stale:   路径失效，无法自动修复
+ */
+export default function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS recipe_source_refs (
+      recipe_id    TEXT    NOT NULL,
+      source_path  TEXT    NOT NULL,
+      status       TEXT    NOT NULL DEFAULT 'active',
+      new_path     TEXT,
+      verified_at  INTEGER NOT NULL,
+      PRIMARY KEY (recipe_id, source_path),
+      FOREIGN KEY (recipe_id) REFERENCES knowledge_entries(id) ON DELETE CASCADE
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_rsr_path   ON recipe_source_refs(source_path);
+    CREATE INDEX IF NOT EXISTS idx_rsr_status ON recipe_source_refs(status);
+  `);
+}

package/dist/lib/infrastructure/vector/HnswVectorAdapter.js

@@ -121,8 +121,13 @@ export class HnswVectorAdapter extends VectorStore {
             // 迁移完成, 数据已加载到内存
             await this.#persist();
         }
-        // 初始化 WAL (即使是空索引也创建, 以便后续操作写 WAL)
+        // 初始化 WAL + replay 未刷盘操作 (即使是空索引也创建, 以便后续操作写 WAL)
         this.#initWal();
+        const { replayed } = this.#wal?.recover() || { replayed: 0 };
+        if (replayed > 0) {
+            this.#dirty = true;
+            await this.#persist();
+        }
     }
     /**
      * 同步初始化 (兼容 JsonVectorAdapter)
@@ -171,8 +176,19 @@ export class HnswVectorAdapter extends VectorStore {
         }
         // 同步迁移: 读取 JSON 索引并加载到内存
         this.#syncMigrateFromJson();
-        // 初始化 WAL
+        // 初始化 WAL + replay 未刷盘操作
         this.#initWal();
+        const { replayed } = this.#wal?.recover() || { replayed: 0 };
+        if (replayed > 0) {
+            this.#dirty = true;
+            BinaryPersistence.save(this.#indexPath, {
+                index: this.#index,
+                quantizer: this.#quantizer,
+                metadata: this.#metadata,
+                contents: this.#contents,
+            });
+            this.#dirty = false;
+        }
     }
     /** 同步从 JSON 索引迁移 (用于 initSync 路径) */
     #syncMigrateFromJson() {

package/dist/lib/injection/ServiceContainer.js

@@ -130,6 +130,8 @@ export class ServiceContainer {
             }
             // v3.3: 初始化 VectorService（绑定 EventBus 事件监听）
             await VectorModule.initializeVectorService(this);
+            // v3.4: 初始化 Knowledge 服务（绑定 EventBus → SearchEngine.refreshIndex + sourceRefs）
+            KnowledgeModule.initializeKnowledgeServices(this);
             this.logger.info('Service container initialized successfully');
         }
         catch (error) {

package/dist/lib/injection/modules/KnowledgeModule.d.ts

@@ -9,3 +9,8 @@
  */
 import type { ServiceContainer } from '../ServiceContainer.js';
 export declare function register(c: ServiceContainer): void;
+/**
+ * 初始化知识服务（在容器初始化后调用）
+ * 绑定 EventBus → SearchEngine.refreshIndex() + recipe_source_refs 填充
+ */
+export declare function initializeKnowledgeServices(c: ServiceContainer): void;