autosnippet 3.3.7 → 3.3.8

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) {

package/dist/lib/http/routes/ai.js

@@ -135,33 +135,31 @@ router.post('/config', validate(AiConfigBody), async (req, res) => {
 router.post('/mock/cleanup', async (_req, res) => {
     const container = getContainer();
     const knowledgeService = container.get('knowledgeService');
-    const dbConn = container.get('database');
-    const rawDb = dbConn.getDb();
+    const knowledgeRepo = container.get('knowledgeRepository');
     // 查找所有 mock 来源的候选
     const mockSources = ['mock-bootstrap', 'mock-pipeline'];
     let totalDeleted = 0;
     for (const source of mockSources) {
-        const rows = rawDb
-            .prepare('SELECT id FROM knowledge_entries WHERE source = ?')
-            .all(source);
-        for (const row of rows) {
+        const ids = await knowledgeRepo.findIdsBySource(source);
+        for (const id of ids) {
             try {
-                await knowledgeService.delete(row.id, { userId: 'system:mock-cleanup' });
+                await knowledgeService.delete(id, { userId: 'system:mock-cleanup' });
                 totalDeleted++;
             }
             catch {
-                logger.debug(`Mock cleanup: failed to delete ${row.id}`);
+                logger.debug(`Mock cleanup: failed to delete ${id}`);
             }
         }
     }
-    // 清理 mock 相关的 semantic_memories
+    // 清理 bootstrap 来源的 semantic_memories
     try {
-        rawDb
-            .prepare("DELETE FROM semantic_memories WHERE source = 'bootstrap' AND metadata LIKE '%mock%'")
-            .run();
+        const memoryRepo = container.get('memoryRepository');
+        if (memoryRepo) {
+            await memoryRepo.clearBootstrapMemories();
+        }
     }
     catch {
-        // 表可能不存在
+        // memoryRepository 可能未注册
     }
     logger.info(`Mock cleanup completed: ${totalDeleted} entries deleted`);
     const rt = getRealtimeService();

package/dist/lib/http/routes/guardReport.js

@@ -67,8 +67,7 @@ router.get('/reverse', async (req, res) => {
             reverseGuard = container.get('reverseGuard');
         }
         catch {
-            const db = container.get('database');
-            reverseGuard = new ReverseGuard(db.getDb());
+            reverseGuard = new ReverseGuard(container.get('knowledgeRepository'), container.get('codeEntityRepository'), container.get('recipeSourceRefRepository'));
         }
         const maxFiles = req.query.maxFiles ? Number(req.query.maxFiles) : 200;
         const projectFiles = await collectSourceFilesWithContent(projectRoot, { maxFiles });
@@ -111,14 +110,13 @@ router.get('/coverage', async (_req, res) => {
             analyzer = container.get('coverageAnalyzer');
         }
         catch {
-            const db = container.get('database');
-            analyzer = new CoverageAnalyzer(db.getDb());
+            analyzer = new CoverageAnalyzer(container.get('knowledgeRepository'), container.get('guardViolationRepository'));
         }
         // 从 Panorama 或目录结构获取模块文件
         const moduleFiles = new Map();
         try {
             const panorama = container.get('panoramaService');
-            const overview = panorama.getOverview();
+            const overview = await panorama.getOverview();
             if (overview?.modules) {
                 for (const mod of overview.modules) {
                     if (mod.files?.length > 0) {

package/dist/lib/http/routes/panorama.js

@@ -31,7 +31,7 @@ router.get('/', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const overview = panoramaService.getOverview();
+        const overview = await panoramaService.getOverview();
         res.json({ success: true, data: overview });
     }
     catch (err) {
@@ -62,7 +62,7 @@ router.get('/health', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const health = panoramaService.getHealth();
+        const health = await panoramaService.getHealth();
         res.json({ success: true, data: health });
     }
     catch (err) {
@@ -93,7 +93,7 @@ router.get('/gaps', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const gaps = panoramaService.getGaps();
+        const gaps = await panoramaService.getGaps();
         res.json({ success: true, data: gaps });
     }
     catch (err) {
@@ -124,8 +124,8 @@ router.get('/coverage', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const overview = panoramaService.getOverview();
-        const gaps = panoramaService.getGaps?.() ?? [];
+        const overview = await panoramaService.getOverview();
+        const gaps = (await panoramaService.getGaps?.()) ?? [];
         // 构建模块级覆盖率数据：从 overview.layers 中提取每个模块的文件数和 recipe 数
         const modules = [];
         for (const layer of overview.layers || []) {
@@ -187,7 +187,7 @@ router.get('/module/:name', async (req, res) => {
         if (typeof panoramaService.ensureData === 'function') {
             await panoramaService.ensureData();
         }
-        const detail = panoramaService.getModule(req.params.name);
+        const detail = await panoramaService.getModule(req.params.name);
         if (!detail) {
             res.status(404).json({
                 success: false,
@@ -220,7 +220,7 @@ router.post('/governance/cycle', async (_req, res) => {
             });
             return;
         }
-        const report = metabolism.runFullCycle();
+        const report = await metabolism.runFullCycle();
         res.json({ success: true, data: report });
     }
     catch (err) {
@@ -245,7 +245,7 @@ router.get('/governance/decay', async (_req, res) => {
             });
             return;
         }
-        const results = decayDetector.scanAll();
+        const results = await decayDetector.scanAll();
         res.json({ success: true, data: { results } });
     }
     catch (err) {
@@ -270,8 +270,8 @@ router.post('/governance/staging-check', async (_req, res) => {
             });
             return;
         }
-        const checkResult = stagingManager.checkAndPromote();
-        const currentStaging = stagingManager.listStaging();
+        const checkResult = await stagingManager.checkAndPromote();
+        const currentStaging = await stagingManager.listStaging();
         res.json({ success: true, data: { checkResult, currentStaging } });
     }
     catch (err) {
@@ -296,7 +296,7 @@ router.get('/governance/staging', async (_req, res) => {
             });
             return;
         }
-        const entries = stagingManager.listStaging();
+        const entries = await stagingManager.listStaging();
         res.json({ success: true, data: { entries } });
     }
     catch (err) {
@@ -321,7 +321,7 @@ router.get('/governance/enhancements', async (_req, res) => {
             });
             return;
         }
-        const suggestions = suggester.analyzeAll();
+        const suggestions = await suggester.analyzeAll();
         res.json({ success: true, data: { suggestions } });
     }
     catch (err) {