autosnippet 3.3.6 → 3.3.8

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.d.ts

@@ -62,6 +62,15 @@ export declare function bootstrapExternal(ctx: McpContext): Promise<{
             clearedTables: number;
             dbCleared: boolean;
             errors: string[];
+            trash: {
+                folder: string;
+                movedItems: number;
+                dbSnapshotRows: number;
+            } | null;
+            purgedTrash: {
+                count: number;
+                freedBytes: number;
+            } | null;
         };
     } | null;
     meta: {

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
@@ -133,6 +133,8 @@ export async function bootstrapExternal(ctx) {
                 clearedTables: cleanupResult.clearedTables.length,
                 dbCleared: true,
                 errors: cleanupResult.errors,
+                trash: cleanupResult.trash ?? null,
+                purgedTrash: cleanupResult.purgedTrash ?? null,
             },
             ...briefing,
         },

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

@@ -223,6 +223,8 @@ export async function bootstrapKnowledge(ctx, args) {
             clearedTables: cleanupResult.clearedTables.length,
             dbCleared: true,
             errors: cleanupResult.errors,
+            trash: cleanupResult.trash ?? null,
+            purgedTrash: cleanupResult.purgedTrash ?? null,
         },
         report,
         targets: targetsSummary ||

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

@@ -9,6 +9,7 @@
  * autosnippet_bootstrap 已迁移到 bootstrap-external.js（外部 Agent 路径）。
  */
 import { getRequiredFieldsDescription } from '#domain/knowledge/FieldSpec.js';
+import { getDeveloperIdentity } from '#shared/developer-identity.js';
 import { envelope } from '../envelope.js';
 import * as browseHandlers from './browse.js';
 import * as guardHandlers from './guard.js';
@@ -285,7 +286,7 @@ export async function enhancedSubmitKnowledge(ctx, args) {
             skipConsolidation,
             supersedes,
             existingTitles,
-            userId: 'mcp',
+            userId: getDeveloperIdentity(),
         },
     });
     // ── Step 4: Bootstrap session 追踪 ──

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

@@ -16,6 +16,7 @@
  */
 import Logger from '#infra/logging/Logger.js';
 import { BootstrapEventEmitter } from '#service/bootstrap/BootstrapEventEmitter.js';
+import { getDeveloperIdentity } from '#shared/developer-identity.js';
 import { envelope } from '../envelope.js';
 import { saveDimensionCheckpoint } from './bootstrap/pipeline/checkpoint.js';
 import { BOOTSTRAP_COMPLETE_ACTIONS } from './bootstrap/shared/dimension-text.js';
@@ -160,7 +161,7 @@ export async function dimensionComplete(ctx, args) {
                             await knowledgeService.update(recipeId, {
                                 category: dimensionId,
                                 tags: newTags,
-                            }, { userId: 'mcp' });
+                            }, { userId: getDeveloperIdentity() });
                             recipesBound++;
                         }
                     }
@@ -272,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 });
             }
         }
     }
@@ -350,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`);
             }
         }
@@ -387,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

@@ -12,6 +12,7 @@
  *
  * @module handlers/evolve-external
  */
+import { getDeveloperIdentity } from '#shared/developer-identity.js';
 import { envelope } from '../envelope.js';
 // ── 主入口 ─────────────────────────────────────────────────
 export async function evolveExternal(ctx, args) {
@@ -45,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++;
@@ -110,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',
@@ -121,7 +119,7 @@ export async function evolveExternal(ctx, args) {
                             // Supervisor 拒绝（可能状态不允许直接转 deprecated），回退到 KnowledgeService
                             if (knowledgeService) {
                                 await knowledgeService.deprecate(decision.recipeId, reason, {
-                                    userId: 'ide-agent',
+                                    userId: getDeveloperIdentity(),
                                 });
                             }
                             else {
@@ -135,7 +133,9 @@ export async function evolveExternal(ctx, args) {
                     }
                     else if (knowledgeService) {
                         // P3: 添加 await
-                        await knowledgeService.deprecate(decision.recipeId, reason, { userId: 'ide-agent' });
+                        await knowledgeService.deprecate(decision.recipeId, reason, {
+                            userId: getDeveloperIdentity(),
+                        });
                     }
                     else {
                         result.errors.push({
@@ -164,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/knowledge.js

@@ -3,6 +3,7 @@
  * submitKnowledge, submitKnowledgeBatch, knowledgeLifecycle
  */
 import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
+import { getDeveloperIdentity } from '#shared/developer-identity.js';
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
 import { envelope } from '../envelope.js';
 // ─── 限流 ──────────────────────────────────────────────────
@@ -69,7 +70,7 @@ export async function submitKnowledge(ctx, args) {
     const service = ctx.container.get('knowledgeService');
     // V3 字段增强
     const enrichedData = _enrichToV3(args, ctx.container);
-    const entry = await service.create(enrichedData, { userId: 'mcp' });
+    const entry = await service.create(enrichedData, { userId: getDeveloperIdentity() });
     // ── QualityScorer 自动评分（R9: create 后置执行）──
     try {
         await service.updateQuality(entry.id, { userId: 'mcp' });
@@ -193,10 +194,10 @@ export async function submitKnowledgeBatch(ctx, args) {
         }
         try {
             const itemData = _enrichToV3({ ...items[i], source }, ctx.container);
-            const entry = await service.create(itemData, { userId: 'mcp' });
+            const entry = await service.create(itemData, { userId: getDeveloperIdentity() });
             // ── QualityScorer 自动评分（R9: create 后置执行）──
             try {
-                await service.updateQuality(entry.id, { userId: 'mcp' });
+                await service.updateQuality(entry.id, { userId: getDeveloperIdentity() });
             }
             catch {
                 /* best effort — 不阻塞批量提交 */
@@ -269,7 +270,7 @@ export async function knowledgeLifecycle(ctx, args) {
         throw new Error(`[PERMISSION_DENIED] 外部 Agent 不允许执行 "${action}" 操作，仅支持: reactivate。发布、废弃等操作请在 Dashboard 中完成。提交新知识请使用 autosnippet_submit_knowledge 工具。`);
     }
     const service = ctx.container.get('knowledgeService');
-    const context = { userId: 'mcp' };
+    const context = { userId: getDeveloperIdentity() };
     const entry = await service.reactivate(id, context);
     return envelope({
         success: true,

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,