autosnippet 3.3.7 → 3.3.9

package/dist/lib/external/mcp/handlers/bootstrap/shared/bootstrap-phases.js

@@ -9,7 +9,7 @@
  *   Phase 1   → 文件收集（DiscovererRegistry → 多语言项目类型检测）
  *   Phase 1.5 → AST 代码结构分析（tree-sitter + SFC 预处理）
  *   Phase 1.6 → Code Entity Graph（代码实体关系图谱）
- *   Phase 1.8 → Panorama 全景汇总（RoleRefiner + CouplingAnalyzer + LayerInferrer）
+ *   Phase 2.2 → Panorama 全景汇总（RoleRefiner + CouplingAnalyzer + LayerInferrer）
  *   Phase 2   → 依赖关系 → knowledge_edges
  *   Phase 2.1 → Module 实体写入 Entity Graph
  *   Phase 3   → Guard 规则审计
@@ -218,12 +218,13 @@ export async function runPhase1_6_EntityGraph(astProjectSummary, projectRoot, co
     if (astProjectSummary) {
         try {
             const { CodeEntityGraph } = await import('#service/knowledge/CodeEntityGraph.js');
-            const db = container.get('database');
-            if (db) {
-                const ceg = new CodeEntityGraph(db, { projectRoot });
-                ceg.clearProject();
+            const entityRepo = container.get('codeEntityRepository');
+            const edgeRepo = container.get('knowledgeEdgeRepository');
+            if (entityRepo && edgeRepo) {
+                const ceg = new CodeEntityGraph(entityRepo, edgeRepo, { projectRoot });
+                await ceg.clearProject();
                 // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- ProjectAnalysisResult structurally compatible at runtime
-                codeEntityResult = ceg.populateFromAst(astProjectSummary);
+                codeEntityResult = await ceg.populateFromAst(astProjectSummary);
                 logger.info(`[Bootstrap] Entity Graph: ${codeEntityResult.entitiesUpserted} entities, ${codeEntityResult.edgesCreated} edges`);
             }
         }
@@ -279,14 +280,15 @@ export async function runPhase1_7_CallGraph(astProjectSummary, projectRoot, cont
                     minConfidence: 0.5,
                 });
         // 写入 CodeEntityGraph
-        const db = container.get('database');
-        if (db && result && result.callEdges.length > 0) {
-            const ceg = new CodeEntityGraph(db, { projectRoot });
+        const entityRepo = container.get('codeEntityRepository');
+        const edgeRepo = container.get('knowledgeEdgeRepository');
+        if (entityRepo && edgeRepo && result && result.callEdges.length > 0) {
+            const ceg = new CodeEntityGraph(entityRepo, edgeRepo, { projectRoot });
             // 增量模式: 先删除变更文件的旧边
             if (isIncremental) {
-                ceg.clearCallGraphForFiles(changedFiles ?? null);
+                await ceg.clearCallGraphForFiles(changedFiles ?? null);
             }
-            callGraphResult = ceg.populateCallGraph(result.callEdges, result.dataFlowEdges);
+            callGraphResult = await ceg.populateCallGraph(result.callEdges, result.dataFlowEdges);
             const partialTag = result.stats.partial ? ' [partial]' : '';
             const incrTag = isIncremental ? ' [incremental]' : '';
             logger.info(`[Bootstrap] Call Graph${incrTag}${partialTag}: ${result.callEdges.length} call edges, ` +
@@ -321,7 +323,7 @@ export async function runPhase2_DependencyGraph(discoverer, container, logger, s
         depGraphData = await discoverer.getDependencyGraph();
         if (knowledgeGraphService) {
             for (const edge of depGraphData.edges || []) {
-                const result = knowledgeGraphService.addEdge(edge.from, 'module', edge.to, 'module', 'depends_on', { weight: 1.0, source: `${discoverer.id}-${sourceTag}` });
+                const result = await knowledgeGraphService.addEdge(edge.from, 'module', edge.to, 'module', 'depends_on', { weight: 1.0, source: `${discoverer.id}-${sourceTag}` });
                 if (result?.success) {
                     depEdgesWritten++;
                 }
@@ -346,10 +348,11 @@ export async function runPhase2_1_ModuleEntities(depGraphData, projectRoot, cont
     }
     try {
         const { CodeEntityGraph } = await import('#service/knowledge/CodeEntityGraph.js');
-        const db = container.get('database');
-        if (db) {
-            const ceg = new CodeEntityGraph(db, { projectRoot });
-            const result = ceg.populateFromSpm(depGraphData);
+        const entityRepo = container.get('codeEntityRepository');
+        const edgeRepo = container.get('knowledgeEdgeRepository');
+        if (entityRepo && edgeRepo) {
+            const ceg = new CodeEntityGraph(entityRepo, edgeRepo, { projectRoot });
+            const result = await ceg.populateFromSpm(depGraphData);
             logger.info(`[Bootstrap] Entity Graph modules: ${result.entitiesUpserted} entities`);
         }
     }
@@ -637,42 +640,43 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
     if (report) {
         report.phases.callGraph = { result: phase1_7.callGraphResult, ms: Date.now() - p17Start };
     }
-    // ── Phase 1.8: Panorama 全景汇总 ──
+    // ── Phase 2: 依赖图 ──
+    const p2Start = Date.now();
+    const phase2 = await runPhase2_DependencyGraph(discoverer, ctx.container, ctx.logger, options.sourceTag || 'bootstrap');
+    warnings.push(...phase2.warnings);
+    if (report) {
+        report.phases.depGraph = {
+            edgesWritten: phase2.depEdgesWritten || 0,
+            ms: Date.now() - p2Start,
+        };
+    }
+    // ── Phase 2.1: Module 实体 ──
+    await runPhase2_1_ModuleEntities(phase2.depGraphData, projectRoot, ctx.container, ctx.logger);
+    // ── Phase 2.2: Panorama 全景汇总 ──
+    // 必须在 Phase 2.1 之后：此时 code_entities 中已有 module 记录
     let panoramaResult = null;
     try {
-        const panoramaService = ctx.container?.resolve?.('panoramaService');
+        const panoramaService = ctx.container.get('panoramaService');
         if (panoramaService &&
             typeof panoramaService.invalidate === 'function') {
-            const p18Start = Date.now();
+            const pPanoStart = Date.now();
             panoramaService.invalidate();
-            const result = panoramaService.getResult();
+            const result = await panoramaService.getResult();
             panoramaResult = result;
-            ctx.logger.info(`[Bootstrap] Phase 1.8: Panorama computed in ${Date.now() - p18Start}ms`);
+            ctx.logger.info(`[Bootstrap] Phase 2.2: Panorama computed in ${Date.now() - pPanoStart}ms`);
             if (report) {
-                const overview = panoramaService.getOverview();
+                const overview = await panoramaService.getOverview();
                 report.phases.panorama = {
                     moduleCount: overview.moduleCount ?? 0,
                     layerCount: overview.layerCount ?? 0,
-                    ms: Date.now() - p18Start,
+                    ms: Date.now() - pPanoStart,
                 };
             }
         }
     }
     catch (err) {
-        warnings.push(`Phase 1.8 panorama failed (non-blocking): ${err instanceof Error ? err.message : String(err)}`);
+        warnings.push(`Phase 2.2 panorama failed (non-blocking): ${err instanceof Error ? err.message : String(err)}`);
     }
-    // ── Phase 2: 依赖图 ──
-    const p2Start = Date.now();
-    const phase2 = await runPhase2_DependencyGraph(discoverer, ctx.container, ctx.logger, options.sourceTag || 'bootstrap');
-    warnings.push(...phase2.warnings);
-    if (report) {
-        report.phases.depGraph = {
-            edgesWritten: phase2.depEdgesWritten || 0,
-            ms: Date.now() - p2Start,
-        };
-    }
-    // ── Phase 2.1: Module 实体 ──
-    await runPhase2_1_ModuleEntities(phase2.depGraphData, projectRoot, ctx.container, ctx.logger);
     // ── Phase 3: Guard 审计 ──
     const p3Start = Date.now();
     const phase3 = await runPhase3_GuardAudit(allFiles, ctx.container, ctx.logger, {
@@ -766,7 +770,7 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
         warnings,
         report, // NEW: Phase 级报告 (null if generateReport=false)
         incrementalPlan, // NEW: 增量评估结果 (null if incremental=false)
-        panoramaResult, // Phase 1.8: 全景汇总 (null if panoramaService unavailable)
+        panoramaResult, // Phase 2.2: 全景汇总 (null if panoramaService unavailable)
         isEmpty: false,
     };
 }

package/dist/lib/external/mcp/handlers/bootstrap-external.js

@@ -115,7 +115,7 @@ export async function bootstrapExternal(ctx) {
         session,
         languageExtension: buildLanguageExtension(primaryLang), // §7.1
         languageStats: langStats,
-        panoramaResult: snapshot.panorama, // §M1: Phase 1.8 全景数据
+        panoramaResult: snapshot.panorama, // §M1: Phase 2.2 全景数据
         localPackageModules, // 本地子包模块信息
     });
     // 附加 warnings

package/dist/lib/external/mcp/handlers/dimension-complete-external.js

@@ -273,7 +273,7 @@ export async function dimensionComplete(ctx, args) {
         if (knowledgeGraphService && keyFindings.length > 0) {
             // 将每个 keyFinding 创建为知识图谱中的实体
             for (const finding of keyFindings) {
-                knowledgeGraphService.addEdge(dimensionId, 'dimension', finding.substring(0, 80), 'finding', 'discovered_in', { source: 'external-agent-bootstrap', sessionId: session.id });
+                await knowledgeGraphService.addEdge(dimensionId, 'dimension', finding.substring(0, 80), 'finding', 'discovered_in', { source: 'external-agent-bootstrap', sessionId: session.id });
             }
         }
     }
@@ -351,7 +351,7 @@ export async function dimensionComplete(ctx, args) {
             if (panoramaService &&
                 typeof panoramaService.rescan === 'function') {
                 await panoramaService.rescan();
-                const overview = panoramaService.getOverview();
+                const overview = await panoramaService.getOverview();
                 logger.info(`[DimensionComplete] Panorama refreshed — ${overview.moduleCount} modules, ${overview.gapCount} gaps`);
             }
         }
@@ -388,7 +388,11 @@ export async function dimensionComplete(ctx, args) {
                 const db = ctx.container.get?.('database') ?? ctx.container.get?.('db');
                 if (db && session.sessionStore) {
                     const { PersistentMemory } = await import('#agent/memory/PersistentMemory.js');
-                    const semanticMemory = new PersistentMemory(db, { logger });
+                    const { MemoryEmbeddingStore } = await import('#agent/memory/MemoryEmbeddingStore.js');
+                    const semanticMemory = new PersistentMemory(db, {
+                        logger,
+                        embeddingStore: new MemoryEmbeddingStore(projectRoot),
+                    });
                     const consolidator = new EpisodicConsolidator(semanticMemory, { logger });
                     const result = await consolidator.consolidate(session.sessionStore, {
                         bootstrapSession: session.id,

package/dist/lib/external/mcp/handlers/evolve-external.d.ts

@@ -15,6 +15,7 @@
 import type { ServiceContainer } from '#inject/ServiceContainer.js';
 import type { EvolveInput } from '#shared/schemas/mcp-tools.js';
 /** MCP handler context */
+/** MCP handler context */
 interface McpContext {
     container: ServiceContainer;
     logger: {

package/dist/lib/external/mcp/handlers/evolve-external.js

@@ -46,15 +46,12 @@ export async function evolveExternal(ctx, args) {
     const proposalRepo = ctx.container.get('proposalRepository');
     const knowledgeService = ctx.container.get('knowledgeService');
     const supervisor = ctx.container.get('lifecycleSupervisor');
-    const dbConn = ctx.container.get('database');
-    const rawDb = dbConn?.db ?? null;
+    const knowledgeRepo = ctx.container.get('knowledgeRepository');
     for (const decision of decisions) {
         try {
             // O4: Recipe 存在性前置检查
-            if (rawDb) {
-                const exists = rawDb
-                    .prepare('SELECT 1 FROM knowledge_entries WHERE id = ?')
-                    .get(decision.recipeId);
+            if (knowledgeRepo) {
+                const exists = await knowledgeRepo.findById(decision.recipeId);
                 if (!exists) {
                     result.errors.push({ recipeId: decision.recipeId, error: 'Recipe not found' });
                     result.processed++;
@@ -111,7 +108,7 @@ export async function evolveExternal(ctx, args) {
                     // O1: 优先通过 RecipeLifecycleSupervisor 执行，回退到 KnowledgeService
                     const reason = decision.reason || 'IDE Agent confirmed deprecation';
                     if (supervisor) {
-                        const transResult = supervisor.transition({
+                        const transResult = await supervisor.transition({
                             recipeId: decision.recipeId,
                             targetState: 'deprecated',
                             trigger: 'manual-deprecation',
@@ -167,17 +164,17 @@ export async function evolveExternal(ctx, args) {
                     break;
                 }
                 case 'skip': {
-                    if (decision.skipReason === 'still_valid' && rawDb) {
+                    if (decision.skipReason === 'still_valid' && knowledgeRepo) {
                         // P4: 更新 stats.lastVerifiedAt 而非 updated_at
                         try {
-                            const row = rawDb
-                                .prepare('SELECT stats FROM knowledge_entries WHERE id = ?')
-                                .get(decision.recipeId);
-                            const stats = JSON.parse(row?.stats || '{}');
-                            stats.lastVerifiedAt = Date.now();
-                            rawDb
-                                .prepare('UPDATE knowledge_entries SET stats = ? WHERE id = ?')
-                                .run(JSON.stringify(stats), decision.recipeId);
+                            const entry = await knowledgeRepo.findById(decision.recipeId);
+                            if (entry) {
+                                const stats = (typeof entry.stats === 'object'
+                                    ? entry.stats
+                                    : {});
+                                stats.lastVerifiedAt = Date.now();
+                                await knowledgeRepo.updateStats(decision.recipeId, stats);
+                            }
                             result.refreshed++;
                         }
                         catch {

package/dist/lib/external/mcp/handlers/guard.js

@@ -211,7 +211,7 @@ export async function guardReview(ctx, args) {
         });
     }
     // 2. 预加载 rule recipe 缓存
-    const recipeMap = _loadRuleRecipes(ctx);
+    const recipeMap = await _loadRuleRecipes(ctx);
     // 3. 创建引擎，注入 Enhancement Pack
     const engine = _getOrCreateEngine(ctx, GuardCheckEngine);
     await _injectEnhancementGuardRules(engine, ctx);
@@ -355,24 +355,17 @@ export async function guardReview(ctx, args) {
  * 预加载所有 rule 类型 recipe 的修复字段
  * 构建 guardId → recipe 映射
  */
-function _loadRuleRecipes(ctx) {
+async function _loadRuleRecipes(ctx) {
     const map = new Map();
     try {
-        const db = typeof ctx.container.get('database')?.getDb === 'function'
-            ? ctx.container.get('database').getDb()
-            : ctx.container.get('database');
-        const rows = db
-            .prepare(`
-      SELECT id, title, doClause, dontClause, coreCode, constraints
-      FROM knowledge_entries
-      WHERE (kind = 'rule' OR knowledgeType = 'boundary-constraint')
-        AND lifecycle = 'active'
-    `)
-            .all();
-        for (const row of rows) {
+        const knowledgeRepo = ctx.container.get('knowledgeRepository');
+        const entries = await knowledgeRepo.findActiveGuardRecipes();
+        for (const row of entries) {
             try {
-                const constraints = JSON.parse(row.constraints || '{}');
-                const guards = constraints.guards || [];
+                const constraints = typeof row.constraints === 'object' && row.constraints
+                    ? row.constraints
+                    : JSON.parse(row.constraints || '{}');
+                const guards = (constraints.guards || []);
                 for (const g of guards) {
                     if (g.id) {
                         map.set(g.id, {
@@ -675,8 +668,7 @@ export async function guardReverseAudit(ctx, args) {
         reverseGuard = ctx.container.get('reverseGuard');
     }
     catch {
-        const db = ctx.container.get('database');
-        reverseGuard = new ReverseGuard(db.getDb());
+        reverseGuard = new ReverseGuard(ctx.container.get('knowledgeRepository'), ctx.container.get('codeEntityRepository'), ctx.container.get('recipeSourceRefRepository'));
     }
     const maxFiles = args.maxFiles || 200;
     const projectFiles = await collectSourceFilesWithContent(projectRoot, { maxFiles });
@@ -717,8 +709,7 @@ export async function guardCoverageMatrix(ctx, _args) {
         analyzer = ctx.container.get('coverageAnalyzer');
     }
     catch {
-        const db = ctx.container.get('database');
-        analyzer = new CoverageAnalyzer(db.getDb());
+        analyzer = new CoverageAnalyzer(ctx.container.get('knowledgeRepository'), ctx.container.get('guardViolationRepository'));
     }
     // 构建 moduleFiles 映射 — 从 Panorama 或目录结构推断
     const moduleFiles = await _buildModuleFiles(ctx, projectRoot);
@@ -798,11 +789,11 @@ async function _buildModuleFiles(ctx, projectRoot) {
     const moduleFiles = new Map();
     try {
         const panorama = ctx.container.get('panoramaService');
-        const overview = await panorama.getOverview();
-        if (overview?.modules) {
-            for (const mod of overview.modules) {
+        const result = await panorama.getResult();
+        if (result?.modules) {
+            for (const [name, mod] of result.modules) {
                 if (mod.files?.length > 0) {
-                    moduleFiles.set(mod.name, mod.files);
+                    moduleFiles.set(name, mod.files);
                 }
             }
         }

package/dist/lib/external/mcp/handlers/panorama.js

@@ -31,7 +31,7 @@ export async function panoramaHandler(ctx, args) {
     await panoramaService.ensureData();
     switch (op) {
         case 'overview': {
-            const overview = panoramaService.getOverview();
+            const overview = await panoramaService.getOverview();
             return envelope({
                 success: true,
                 data: overview,
@@ -47,7 +47,7 @@ export async function panoramaHandler(ctx, args) {
                     meta: { tool: 'autosnippet_panorama' },
                 });
             }
-            const detail = panoramaService.getModule(moduleName);
+            const detail = await panoramaService.getModule(moduleName);
             if (!detail) {
                 return envelope({
                     success: false,
@@ -62,7 +62,7 @@ export async function panoramaHandler(ctx, args) {
             });
         }
         case 'gaps': {
-            const gaps = panoramaService.getGaps();
+            const gaps = await panoramaService.getGaps();
             return envelope({
                 success: true,
                 data: { gaps },
@@ -70,7 +70,7 @@ export async function panoramaHandler(ctx, args) {
             });
         }
         case 'health': {
-            const health = panoramaService.getHealth();
+            const health = await panoramaService.getHealth();
             return envelope({
                 success: true,
                 data: health,
@@ -94,7 +94,7 @@ async function handleGovernanceOps(ctx, op) {
                     meta: { tool: 'autosnippet_panorama' },
                 });
             }
-            const report = metabolism.runFullCycle();
+            const report = await metabolism.runFullCycle();
             return envelope({
                 success: true,
                 data: report,
@@ -110,7 +110,7 @@ async function handleGovernanceOps(ctx, op) {
                     meta: { tool: 'autosnippet_panorama' },
                 });
             }
-            const results = decayDetector.scanAll();
+            const results = await decayDetector.scanAll();
             return envelope({
                 success: true,
                 data: { results },
@@ -126,8 +126,8 @@ async function handleGovernanceOps(ctx, op) {
                     meta: { tool: 'autosnippet_panorama' },
                 });
             }
-            const checkResult = stagingManager.checkAndPromote();
-            const currentStaging = stagingManager.listStaging();
+            const checkResult = await stagingManager.checkAndPromote();
+            const currentStaging = await stagingManager.listStaging();
             return envelope({
                 success: true,
                 data: { checkResult, currentStaging },
@@ -143,7 +143,7 @@ async function handleGovernanceOps(ctx, op) {
                     meta: { tool: 'autosnippet_panorama' },
                 });
             }
-            const suggestions = suggester.analyzeAll();
+            const suggestions = await suggester.analyzeAll();
             return envelope({
                 success: true,
                 data: { suggestions },

package/dist/lib/external/mcp/handlers/rescan-external.js

@@ -65,10 +65,7 @@ export async function rescanExternal(ctx, args) {
             ? ctx.container.get('knowledgeSyncService')
             : null;
         if (syncService) {
-            const rawDb = typeof db?.getDb === 'function'
-                ? db.getDb()
-                : db;
-            const syncReport = syncService.sync(rawDb, {
+            const syncReport = syncService.sync(db, {
                 force: true,
             });
             ctx.logger.info('[Rescan] KnowledgeSyncService sync complete', {
@@ -117,7 +114,11 @@ export async function rescanExternal(ctx, args) {
     // Step 4: Recipe 证据验证 + 快速衰退
     // ═══════════════════════════════════════════════════════════
     const auditor = new RecipeRelevanceAuditor({
-        db,
+        knowledgeRepo: ctx.container.get('knowledgeRepository'),
+        proposalRepo: ctx.container.singletons
+            ?.proposalRepository
+            ? ctx.container.get('proposalRepository')
+            : undefined,
         logger: ctx.logger,
     });
     const codeEntities = extractCodeEntities(astProjectSummary);
@@ -132,7 +133,7 @@ export async function rescanExternal(ctx, args) {
     // ═══════════════════════════════════════════════════════════
     // 按需过滤维度
     const dimensions = args.dimensions?.length
-        ? allDimensions.filter((d) => args.dimensions.includes(d.id))
+        ? allDimensions.filter((d) => args.dimensions?.includes(d.id))
         : allDimensions;
     // 创建 Session
     const sessionManager = getOrCreateSessionManager(ctx.container);

package/dist/lib/external/mcp/handlers/rescan-internal.js

@@ -71,10 +71,7 @@ export async function rescanInternal(ctx, args) {
             /* not registered */
         }
         if (syncService) {
-            const rawDb = typeof db?.getDb === 'function'
-                ? db.getDb()
-                : db;
-            const syncReport = syncService.sync(rawDb, {
+            const syncReport = syncService.sync(db, {
                 force: true,
             });
             ctx.logger.info('[Rescan-Internal] KnowledgeSyncService sync complete', {
@@ -119,7 +116,14 @@ export async function rescanInternal(ctx, args) {
     // ═══════════════════════════════════════════════════════════
     // Step 4: Recipe 证据验证 + 快速衰退
     // ═══════════════════════════════════════════════════════════
-    const auditor = new RecipeRelevanceAuditor({ db, logger: ctx.logger });
+    const auditor = new RecipeRelevanceAuditor({
+        knowledgeRepo: ctx.container.get('knowledgeRepository'),
+        proposalRepo: ctx.container.singletons
+            ?.proposalRepository
+            ? ctx.container.get('proposalRepository')
+            : undefined,
+        logger: ctx.logger,
+    });
     const codeEntities = extractCodeEntities(astProjectSummary);
     const dependencyEdges = extractDependencyEdges(depGraphData);
     const auditSummary = await auditor.audit(recipeSnapshot.entries, {

package/dist/lib/external/mcp/handlers/search.js

@@ -30,7 +30,9 @@ function getSearchEngine(ctx) {
 async function getFallbackEngine(ctx) {
     const { SearchEngine } = await import('#service/search/SearchEngine.js');
     const db = ctx.container.get('database');
-    return new SearchEngine(db);
+    const knowledgeRepo = ctx.container.get('knowledgeRepository');
+    const sourceRefRepo = ctx.container.get('recipeSourceRefRepository');
+    return new SearchEngine(db, { knowledgeRepo, sourceRefRepo });
 }
 /** 根据 kind 参数过滤 items */
 function filterByKind(items, kind) {

package/dist/lib/external/mcp/handlers/skill.js

@@ -648,11 +648,11 @@ export async function suggestSkills(ctx) {
         }
         // ── Fallback: 直接使用 SkillAdvisor ──
         const { SkillAdvisor } = await import('#service/skills/SkillAdvisor.js');
-        const dbConn = ctx?.container?.get?.('database') || null;
-        const database = dbConn?.getDb?.() || dbConn || null;
         const projectRoot = resolveProjectRoot(ctx?.container);
-        const advisor = new SkillAdvisor(projectRoot, { database });
-        const result = advisor.suggest();
+        const knowledgeRepo = ctx?.container?.get?.('knowledgeRepository') || null;
+        const auditRepo = ctx?.container?.get?.('auditRepository') || null;
+        const advisor = new SkillAdvisor(projectRoot, { knowledgeRepo, auditRepo });
+        const result = await advisor.suggest();
         return JSON.stringify({
             success: true,
             data: result,

package/dist/lib/external/mcp/handlers/structure.js

@@ -236,7 +236,7 @@ export async function getTargetMetadata(ctx, args) {
     try {
         const graphService = ctx.container?.get('knowledgeGraphService');
         if (graphService) {
-            const edges = graphService.getEdges(target.name, 'module', 'both');
+            const edges = await graphService.getEdges(target.name, 'module', 'both');
             meta.graphEdges = {
                 outgoing: (edges.outgoing || []).map((e) => ({
                     toId: e.toId,
@@ -270,10 +270,10 @@ export async function graphQuery(ctx, args) {
     let data;
     try {
         if (args.relation) {
-            data = graphService.getRelated(args.nodeId, nodeType, args.relation);
+            data = await graphService.getRelated(args.nodeId, nodeType, args.relation);
         }
         else {
-            data = graphService.getEdges(args.nodeId, nodeType, direction);
+            data = await graphService.getEdges(args.nodeId, nodeType, direction);
         }
     }
     catch (err) {
@@ -302,7 +302,7 @@ export async function graphImpact(ctx, args) {
     const nodeType = args.nodeType || 'recipe';
     let impacted;
     try {
-        impacted = graphService.getImpactAnalysis(args.nodeId, nodeType, args.maxDepth ?? 3);
+        impacted = await graphService.getImpactAnalysis(args.nodeId, nodeType, args.maxDepth ?? 3);
     }
     catch (err) {
         // knowledge_edges 表不存在时 graceful 降级
@@ -360,9 +360,7 @@ async function _fallbackRelationsFromRecipe(ctx, nodeId, relation, direction) {
         const incoming = [];
         if (direction === 'both' || direction === 'in') {
             const knowledgeRepo = ctx.container.get('knowledgeRepository');
-            const reverseRows = knowledgeRepo.db
-                .prepare(`SELECT id, relations FROM knowledge_entries WHERE relations LIKE ? AND id != ?`)
-                .all(`%${nodeId}%`, nodeId);
+            const reverseRows = await knowledgeRepo.findByRelationLike(nodeId, nodeId);
             for (const row of reverseRows) {
                 try {
                     const rels = JSON.parse(row.relations || '{}');
@@ -399,9 +397,7 @@ async function _fallbackRelationsFromRecipe(ctx, nodeId, relation, direction) {
 async function _fallbackImpactFromRecipe(ctx, nodeId) {
     try {
         const knowledgeRepo = ctx.container.get('knowledgeRepository');
-        const rows = knowledgeRepo.db
-            .prepare(`SELECT id, title, relations FROM knowledge_entries WHERE relations LIKE ? AND id != ?`)
-            .all(`%${nodeId}%`, nodeId);
+        const rows = await knowledgeRepo.findByRelationLike(nodeId, nodeId);
         const impacted = [];
         for (const row of rows) {
             try {
@@ -448,7 +444,7 @@ export async function graphPath(ctx, args) {
     const maxDepth = Math.min(Math.max(args.maxDepth ?? 5, 1), 10);
     let result;
     try {
-        result = graphService.findPath(args.fromId, fromType, args.toId, toType, maxDepth);
+        result = await graphService.findPath(args.fromId, fromType, args.toId, toType, maxDepth);
     }
     catch (err) {
         if (err instanceof Error && err.message?.includes('no such table')) {
@@ -568,7 +564,7 @@ export async function graphStats(ctx) {
     }
     let stats;
     try {
-        stats = graphService.getStats();
+        stats = await graphService.getStats();
     }
     catch (err) {
         if (err instanceof Error && err.message?.includes('no such table')) {

package/dist/lib/external/mcp/handlers/system.js

@@ -22,46 +22,22 @@ export async function health(ctx) {
     }
     // 2) Database 连通性 + 知识库统计
     try {
-        const dbConn = ctx.container.get('database');
-        if (dbConn) {
-            // DatabaseConnection 包装器 → 解包获取原始 better-sqlite3 实例
-            const db = typeof dbConn.getDb === 'function' ? dbConn.getDb() : dbConn;
-            db.prepare('SELECT 1').get();
+        const knowledgeRepo = ctx.container.get('knowledgeRepository');
+        if (knowledgeRepo) {
+            const stats = (await knowledgeRepo.getStats());
             checks.database = true;
-            // 知识库统计（轻量聚合查询）
-            try {
-                // V3: knowledge_entries 统一表（lifecycle 替代 status）
-                const rStats = db
-                    .prepare(`
-          SELECT COUNT(*) as total,
-            SUM(CASE WHEN lifecycle='active' THEN 1 ELSE 0 END) as active,
-            SUM(CASE WHEN kind='rule' THEN 1 ELSE 0 END) as rules,
-            SUM(CASE WHEN kind='pattern' THEN 1 ELSE 0 END) as patterns,
-            SUM(CASE WHEN kind='fact' THEN 1 ELSE 0 END) as facts
-          FROM knowledge_entries
-        `)
-                    .get();
-                const cPending = db
-                    .prepare(`
-          SELECT COUNT(*) as total,
-            SUM(CASE WHEN lifecycle='pending' THEN 1 ELSE 0 END) as pending
-          FROM knowledge_entries
-        `)
-                    .get();
+            if (stats) {
                 knowledgeBase = {
                     recipes: {
-                        total: rStats.total,
-                        active: rStats.active,
-                        rules: rStats.rules,
-                        patterns: rStats.patterns,
-                        facts: rStats.facts,
+                        total: stats.total,
+                        active: stats.active,
+                        rules: stats.rules,
+                        patterns: stats.patterns,
+                        facts: stats.facts,
                     },
-                    candidates: { total: cPending.total, pending: cPending.pending },
+                    candidates: { total: stats.total, pending: stats.pending },
                 };
             }
-            catch {
-                /* 统计查询失败不影响 health */
-            }
         }
     }
     catch (e) {