autosnippet 3.0.1 → 3.0.2

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

@@ -5,57 +5,82 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
-import { envelope } from '../envelope.js';
 import * as Paths from '../../../infrastructure/config/Paths.js';
+import { LanguageService } from '../../../shared/LanguageService.js';
+import { envelope } from '../envelope.js';
 
-// ─── SpmService 缓存 ─────────────────────────────────────
+// ─── Discoverer 缓存 ─────────────────────────────────────
 // 同一 projectRoot 在模块生命期内只初始化一次
-let _spmCache = null;   // { projectRoot, spm, targets }
+let _discovererCache = null; // { projectRoot, discoverer, targets }
 
-async function _getLoadedSpm() {
+async function _getLoadedDiscoverer() {
   const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
-  if (_spmCache && _spmCache.projectRoot === projectRoot) return _spmCache;
-  const { SpmService } = await import('../../../service/spm/SpmService.js');
-  const spm = new SpmService(projectRoot);
-  await spm.load();
-  const targets = await spm.listTargets() || [];
-  _spmCache = { projectRoot, spm, targets };
-  return _spmCache;
+  if (_discovererCache && _discovererCache.projectRoot === projectRoot) {
+    return _discovererCache;
+  }
+
+  // 优先使用 DiscovererRegistry（多语言统一接口）
+  const { getDiscovererRegistry } = await import('../../../core/discovery/index.js');
+  const registry = getDiscovererRegistry();
+  const discoverer = await registry.detect(projectRoot);
+  await discoverer.load(projectRoot);
+  const targets = (await discoverer.listTargets()) || [];
+  _discovererCache = { projectRoot, discoverer, targets };
+  return _discovererCache;
 }
 
 function _findTarget(targets, targetName) {
-  const t = targets.find(t => t.name === targetName);
-  if (!t) throw new Error(`Target not found: ${targetName}`);
+  const t = targets.find((t) => t.name === targetName);
+  if (!t) {
+    throw new Error(`Target not found: ${targetName}`);
+  }
   return t;
 }
 
-/** 推断语言 */
+/** 推断语言 — 委托给 LanguageService */
 function _inferLang(filename) {
-  const ext = path.extname(filename).toLowerCase();
-  const map = {
-    '.swift': 'swift', '.m': 'objectivec', '.h': 'objectivec', '.mm': 'objectivec',
-    '.c': 'c', '.cpp': 'cpp', '.js': 'javascript', '.ts': 'typescript',
-    '.py': 'python', '.rb': 'ruby', '.java': 'java', '.kt': 'kotlin',
-    '.go': 'go', '.rs': 'rust',
-  };
-  return map[ext] || 'unknown';
+  return LanguageService.inferLang(filename);
 }
 
 /** 推断 Target 职责 */
 function _inferTargetRole(targetName) {
   const n = targetName.toLowerCase();
-  if (/core|kit|shared|common|foundation|base/i.test(n)) return 'core';
-  if (/service|manager|provider|repository|store/i.test(n)) return 'service';
-  if (/ui|view|screen|component|widget/i.test(n)) return 'ui';
-  if (/network|api|http|grpc|socket/i.test(n)) return 'networking';
-  if (/storage|database|cache|persist|realm|coredata/i.test(n)) return 'storage';
-  if (/test|spec|mock|stub|fake/i.test(n)) return 'test';
-  if (/app|main|launch|entry/i.test(n)) return 'app';
-  if (/router|coordinator|navigation/i.test(n)) return 'routing';
-  if (/util|helper|extension|tool/i.test(n)) return 'utility';
-  if (/model|entity|dto|schema/i.test(n)) return 'model';
-  if (/auth|login|session|token/i.test(n)) return 'auth';
-  if (/config|setting|environment|constant/i.test(n)) return 'config';
+  if (/core|kit|shared|common|foundation|base/i.test(n)) {
+    return 'core';
+  }
+  if (/service|manager|provider|repository|store/i.test(n)) {
+    return 'service';
+  }
+  if (/ui|view|screen|component|widget/i.test(n)) {
+    return 'ui';
+  }
+  if (/network|api|http|grpc|socket/i.test(n)) {
+    return 'networking';
+  }
+  if (/storage|database|cache|persist|realm|coredata/i.test(n)) {
+    return 'storage';
+  }
+  if (/test|spec|mock|stub|fake/i.test(n)) {
+    return 'test';
+  }
+  if (/app|main|launch|entry/i.test(n)) {
+    return 'app';
+  }
+  if (/router|coordinator|navigation/i.test(n)) {
+    return 'routing';
+  }
+  if (/util|helper|extension|tool/i.test(n)) {
+    return 'utility';
+  }
+  if (/model|entity|dto|schema/i.test(n)) {
+    return 'model';
+  }
+  if (/auth|login|session|token/i.test(n)) {
+    return 'auth';
+  }
+  if (/config|setting|environment|constant/i.test(n)) {
+    return 'config';
+  }
   return 'feature';
 }
 
@@ -64,7 +89,7 @@ function _inferTargetRole(targetName) {
 // ═══════════════════════════════════════════════════════════
 
 export async function getTargets(ctx, args = {}) {
-  const { spm, targets } = await _getLoadedSpm();
+  const { discoverer, targets } = await _getLoadedDiscoverer();
   const includeSummary = args.includeSummary !== false; // 默认 true
 
   if (!includeSummary) {
@@ -80,14 +105,16 @@ export async function getTargets(ctx, args = {}) {
     let fileCount = 0;
     const langStats = {};
     try {
-      const fileList = await spm.getTargetFiles(t);
+      const fileList = await discoverer.getTargetFiles(t);
       fileCount = fileList.length;
       for (const f of fileList) {
         const lang = _inferLang(f.name);
         langStats[lang] = (langStats[lang] || 0) + 1;
         globalLangStats[lang] = (globalLangStats[lang] || 0) + 1;
       }
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
     totalFiles += fileCount;
     enriched.push({
       name: t.name,
@@ -114,12 +141,14 @@ export async function getTargets(ctx, args = {}) {
 // ═══════════════════════════════════════════════════════════
 
 export async function getTargetFiles(ctx, args) {
-  if (!args.targetName) throw new Error('targetName is required');
-  const { spm, targets } = await _getLoadedSpm();
+  if (!args.targetName) {
+    throw new Error('targetName is required');
+  }
+  const { discoverer, targets } = await _getLoadedDiscoverer();
   const target = _findTarget(targets, args.targetName);
 
-  // 使用 SpmService.getTargetFiles — 正确定位 Sources/<target>/ 目录
-  const rawFiles = await spm.getTargetFiles(target);
+  // 使用 Discoverer.getTargetFiles — 统一接口定位源文件
+  const rawFiles = await discoverer.getTargetFiles(target);
 
   const includeContent = args.includeContent || false;
   const contentMaxLines = args.contentMaxLines || 100;
@@ -127,7 +156,9 @@ export async function getTargetFiles(ctx, args) {
 
   const files = [];
   for (const f of rawFiles) {
-    if (files.length >= maxFiles) break;
+    if (files.length >= maxFiles) {
+      break;
+    }
     const entry = {
       name: f.name,
       path: f.path,
@@ -142,14 +173,20 @@ export async function getTargetFiles(ctx, args) {
         entry.content = lines.slice(0, contentMaxLines).join('\n');
         entry.totalLines = lines.length;
         entry.truncated = lines.length > contentMaxLines;
-      } catch { entry.content = null; entry.totalLines = 0; entry.truncated = false; }
+      } catch {
+        entry.content = null;
+        entry.totalLines = 0;
+        entry.truncated = false;
+      }
     }
     files.push(entry);
   }
 
   // 文件语言统计
   const langStats = {};
-  for (const f of files) { langStats[f.language] = (langStats[f.language] || 0) + 1; }
+  for (const f of files) {
+    langStats[f.language] = (langStats[f.language] || 0) + 1;
+  }
 
   return envelope({
     success: true,
@@ -169,21 +206,27 @@ export async function getTargetFiles(ctx, args) {
 // ═══════════════════════════════════════════════════════════
 
 export async function getTargetMetadata(ctx, args) {
-  if (!args.targetName) throw new Error('targetName is required');
-  const { spm, targets, projectRoot } = await _getLoadedSpm();
+  if (!args.targetName) {
+    throw new Error('targetName is required');
+  }
+  const { targets } = await _getLoadedDiscoverer();
   const target = _findTarget(targets, args.targetName);
+  const projectRoot = _discovererCache.projectRoot;
 
   // ── 基础元数据 ──
   const meta = {
     name: target.name,
+    path: target.path || null,
     packageName: target.packageName || null,
     packagePath: target.packagePath || null,
     type: target.type || 'target',
+    language: target.language || null,
+    framework: target.framework || null,
     inferredRole: _inferTargetRole(target.name),
     targetDir: target.targetDir || null,
     sourcesPath: target.info?.path || null,
     sources: target.info?.sources || null,
-    dependencies: target.info?.dependencies || [],
+    dependencies: target.info?.dependencies || target.metadata?.dependencies || [],
   };
 
   // ── SPM 图谱 (spmmap.json) ──
@@ -199,7 +242,9 @@ export async function getTargetMetadata(ctx, args) {
         meta.packageTargets = pkg.targets || [];
       }
     }
-  } catch { /* ignore */ }
+  } catch {
+    /* ignore */
+  }
 
   // ── 知识图谱关系 (knowledge_edges) ──
   try {
@@ -207,11 +252,21 @@ export async function getTargetMetadata(ctx, args) {
     if (graphService) {
       const edges = graphService.getEdges(target.name, 'module', 'both');
       meta.graphEdges = {
-        outgoing: (edges.outgoing || []).map(e => ({ toId: e.toId, toType: e.toType, relation: e.relation })),
-        incoming: (edges.incoming || []).map(e => ({ fromId: e.fromId, fromType: e.fromType, relation: e.relation })),
+        outgoing: (edges.outgoing || []).map((e) => ({
+          toId: e.toId,
+          toType: e.toType,
+          relation: e.relation,
+        })),
+        incoming: (edges.incoming || []).map((e) => ({
+          fromId: e.fromId,
+          fromType: e.fromType,
+          relation: e.relation,
+        })),
       };
     }
-  } catch { /* knowledge_edges may not exist */ }
+  } catch {
+    /* knowledge_edges may not exist */
+  }
 
   return envelope({ success: true, data: meta, meta: { tool: 'autosnippet_structure' } });
 }
@@ -219,7 +274,11 @@ export async function getTargetMetadata(ctx, args) {
 export async function graphQuery(ctx, args) {
   const graphService = ctx.container.get('knowledgeGraphService');
   if (!graphService) {
-    return envelope({ success: false, message: 'KnowledgeGraphService not available — knowledge_edges 表可能未初始化', meta: { tool: 'autosnippet_graph' } });
+    return envelope({
+      success: false,
+      message: 'KnowledgeGraphService not available — knowledge_edges 表可能未初始化',
+      meta: { tool: 'autosnippet_graph' },
+    });
   }
   const nodeType = args.nodeType || 'recipe';
   const direction = args.direction || 'both';
@@ -234,7 +293,11 @@ export async function graphQuery(ctx, args) {
     // knowledge_edges 表不存在时 graceful 降级到 relations 字段
     if (err.message?.includes('no such table')) {
       data = await _fallbackRelationsFromRecipe(ctx, args.nodeId, args.relation, direction);
-      return envelope({ success: true, data, meta: { tool: 'autosnippet_graph', source: 'relations-fallback' } });
+      return envelope({
+        success: true,
+        data,
+        meta: { tool: 'autosnippet_graph', source: 'relations-fallback' },
+      });
     }
     throw err;
   }
@@ -244,7 +307,11 @@ export async function graphQuery(ctx, args) {
 export async function graphImpact(ctx, args) {
   const graphService = ctx.container.get('knowledgeGraphService');
   if (!graphService) {
-    return envelope({ success: false, message: 'KnowledgeGraphService not available — knowledge_edges 表可能未初始化', meta: { tool: 'autosnippet_graph' } });
+    return envelope({
+      success: false,
+      message: 'KnowledgeGraphService not available — knowledge_edges 表可能未初始化',
+      meta: { tool: 'autosnippet_graph' },
+    });
   }
   const nodeType = args.nodeType || 'recipe';
   let impacted;
@@ -254,11 +321,25 @@ export async function graphImpact(ctx, args) {
     // knowledge_edges 表不存在时 graceful 降级
     if (err.message?.includes('no such table')) {
       impacted = await _fallbackImpactFromRecipe(ctx, args.nodeId);
-      return envelope({ success: true, data: { nodeId: args.nodeId, impactedCount: impacted.length, impacted, degraded: true, degradedReason: 'knowledge_edges 表不存在，仅从 relations 字段反查' }, meta: { tool: 'autosnippet_graph', source: 'relations-fallback' } });
+      return envelope({
+        success: true,
+        data: {
+          nodeId: args.nodeId,
+          impactedCount: impacted.length,
+          impacted,
+          degraded: true,
+          degradedReason: 'knowledge_edges 表不存在，仅从 relations 字段反查',
+        },
+        meta: { tool: 'autosnippet_graph', source: 'relations-fallback' },
+      });
     }
     throw err;
   }
-  return envelope({ success: true, data: { nodeId: args.nodeId, impactedCount: impacted.length, impacted }, meta: { tool: 'autosnippet_graph' } });
+  return envelope({
+    success: true,
+    data: { nodeId: args.nodeId, impactedCount: impacted.length, impacted },
+    meta: { tool: 'autosnippet_graph' },
+  });
 }
 
 /**
@@ -268,15 +349,28 @@ async function _fallbackRelationsFromRecipe(ctx, nodeId, relation, direction) {
   try {
     const knowledgeService = ctx.container.get('knowledgeService');
     const entry = await knowledgeService.get(nodeId);
-    if (!entry) return { outgoing: [], incoming: [] };
+    if (!entry) {
+      return { outgoing: [], incoming: [] };
+    }
 
-    const relJson = typeof entry.relations?.toJSON === 'function' ? entry.relations.toJSON() : (entry.relations || {});
+    const relJson =
+      typeof entry.relations?.toJSON === 'function'
+        ? entry.relations.toJSON()
+        : entry.relations || {};
     const outgoing = [];
     if (direction === 'both' || direction === 'out') {
       for (const [relType, targets] of Object.entries(relJson)) {
-        if (relation && relType !== relation) continue;
-        for (const t of (Array.isArray(targets) ? targets : [])) {
-          outgoing.push({ fromId: nodeId, fromType: 'knowledge', toId: t.target || t.id || t, toType: 'knowledge', relation: relType });
+        if (relation && relType !== relation) {
+          continue;
+        }
+        for (const t of Array.isArray(targets) ? targets : []) {
+          outgoing.push({
+            fromId: nodeId,
+            fromType: 'knowledge',
+            toId: t.target || t.id || t,
+            toType: 'knowledge',
+            relation: relType,
+          });
         }
       }
     }
@@ -285,27 +379,39 @@ 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 = knowledgeRepo.db
+        .prepare(`SELECT id, relations FROM knowledge_entries WHERE relations LIKE ? AND id != ?`)
+        .all(`%${nodeId}%`, nodeId);
       for (const row of reverseRows) {
         try {
           const rels = JSON.parse(row.relations || '{}');
           for (const [relType, targets] of Object.entries(rels)) {
-            if (relation && relType !== relation) continue;
-            for (const t of (Array.isArray(targets) ? targets : [])) {
+            if (relation && relType !== relation) {
+              continue;
+            }
+            for (const t of Array.isArray(targets) ? targets : []) {
               const targetId = t.target || t.id || t;
               if (targetId === nodeId) {
-                incoming.push({ fromId: row.id, fromType: 'knowledge', toId: nodeId, toType: 'knowledge', relation: relType });
+                incoming.push({
+                  fromId: row.id,
+                  fromType: 'knowledge',
+                  toId: nodeId,
+                  toType: 'knowledge',
+                  relation: relType,
+                });
               }
             }
           }
-        } catch { /* ignore parse error */ }
+        } catch {
+          /* ignore parse error */
+        }
       }
     }
 
     return { outgoing, incoming };
-  } catch { return { outgoing: [], incoming: [] }; }
+  } catch {
+    return { outgoing: [], incoming: [] };
+  }
 }
 
 /**
@@ -314,34 +420,52 @@ 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 = knowledgeRepo.db
+      .prepare(
+        `SELECT id, title, relations FROM knowledge_entries WHERE relations LIKE ? AND id != ?`
+      )
+      .all(`%${nodeId}%`, nodeId);
 
     const impacted = [];
     for (const row of rows) {
       try {
         const rels = JSON.parse(row.relations || '{}');
         for (const [relType, targets] of Object.entries(rels)) {
-          for (const t of (Array.isArray(targets) ? targets : [])) {
+          for (const t of Array.isArray(targets) ? targets : []) {
             if ((t.target || t.id || t) === nodeId) {
-              impacted.push({ id: row.id, title: row.title, type: 'knowledge', relation: relType, depth: 1 });
+              impacted.push({
+                id: row.id,
+                title: row.title,
+                type: 'knowledge',
+                relation: relType,
+                depth: 1,
+              });
             }
           }
         }
-      } catch { /* ignore */ }
+      } catch {
+        /* ignore */
+      }
     }
     return impacted;
-  } catch { return []; }
+  } catch {
+    return [];
+  }
 }
 
 // ─── graph_path — 路径查找 ─────────────────────────────────
 
 export async function graphPath(ctx, args) {
-  if (!args.fromId || !args.toId) throw new Error('fromId and toId are required');
+  if (!args.fromId || !args.toId) {
+    throw new Error('fromId and toId are required');
+  }
   const graphService = ctx.container.get('knowledgeGraphService');
   if (!graphService) {
-    return envelope({ success: false, message: 'KnowledgeGraphService not available', meta: { tool: 'autosnippet_graph' } });
+    return envelope({
+      success: false,
+      message: 'KnowledgeGraphService not available',
+      meta: { tool: 'autosnippet_graph' },
+    });
   }
   const fromType = args.fromType || 'recipe';
   const toType = args.toType || 'recipe';
@@ -353,7 +477,11 @@ export async function graphPath(ctx, args) {
     if (err.message?.includes('no such table')) {
       // 降级：用 relations 字段做单跳查找
       result = await _fallbackPathFromRecipe(ctx, args.fromId, args.toId);
-      return envelope({ success: true, data: result, meta: { tool: 'autosnippet_graph', source: 'relations-fallback' } });
+      return envelope({
+        success: true,
+        data: result,
+        meta: { tool: 'autosnippet_graph', source: 'relations-fallback' },
+      });
     }
     throw err;
   }
@@ -367,23 +495,36 @@ async function _fallbackPathFromRecipe(ctx, fromId, toId) {
   try {
     const knowledgeService = ctx.container.get('knowledgeService');
     const entry = await knowledgeService.get(fromId);
-    if (!entry) return { found: false, path: [], depth: -1 };
+    if (!entry) {
+      return { found: false, path: [], depth: -1 };
+    }
 
-    const relJson = typeof entry.relations?.toJSON === 'function' ? entry.relations.toJSON() : (entry.relations || {});
+    const relJson =
+      typeof entry.relations?.toJSON === 'function'
+        ? entry.relations.toJSON()
+        : entry.relations || {};
     for (const [relType, targets] of Object.entries(relJson)) {
-      for (const t of (Array.isArray(targets) ? targets : [])) {
+      for (const t of Array.isArray(targets) ? targets : []) {
         const targetId = t.target || t.id || t;
         if (targetId === toId) {
           return {
             found: true,
-            path: [{ from: { id: fromId, type: 'knowledge' }, to: { id: toId, type: 'knowledge' }, relation: relType }],
+            path: [
+              {
+                from: { id: fromId, type: 'knowledge' },
+                to: { id: toId, type: 'knowledge' },
+                relation: relType,
+              },
+            ],
             depth: 1,
           };
         }
       }
     }
     return { found: false, path: [], depth: -1 };
-  } catch { return { found: false, path: [], depth: -1 }; }
+  } catch {
+    return { found: false, path: [], depth: -1 };
+  }
 }
 
 // ─── graph_stats — 图谱统计 ────────────────────────────────
@@ -391,14 +532,27 @@ async function _fallbackPathFromRecipe(ctx, fromId, toId) {
 export async function graphStats(ctx) {
   const graphService = ctx.container.get('knowledgeGraphService');
   if (!graphService) {
-    return envelope({ success: false, message: 'KnowledgeGraphService not available', meta: { tool: 'autosnippet_graph' } });
+    return envelope({
+      success: false,
+      message: 'KnowledgeGraphService not available',
+      meta: { tool: 'autosnippet_graph' },
+    });
   }
   let stats;
   try {
     stats = graphService.getStats();
   } catch (err) {
     if (err.message?.includes('no such table')) {
-      return envelope({ success: true, data: { totalEdges: 0, byRelation: {}, nodeTypes: [], note: 'knowledge_edges 表不存在，请运行数据库迁移' }, meta: { tool: 'autosnippet_graph' } });
+      return envelope({
+        success: true,
+        data: {
+          totalEdges: 0,
+          byRelation: {},
+          nodeTypes: [],
+          note: 'knowledge_edges 表不存在，请运行数据库迁移',
+        },
+        meta: { tool: 'autosnippet_graph' },
+      });
     }
     throw err;
   }

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

@@ -6,7 +6,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { envelope } from '../envelope.js';
-import { TOOLS, TOOL_GATEWAY_MAP, TIER_ORDER } from '../tools.js';
+import { TIER_ORDER, TOOL_GATEWAY_MAP, TOOLS } from '../tools.js';
 
 export async function health(ctx) {
   const checks = { database: false, gateway: false, vectorStore: false };
@@ -31,24 +31,36 @@ export async function health(ctx) {
       // 知识库统计（轻量聚合查询）
       try {
         // V3: knowledge_entries 统一表（lifecycle 替代 status）
-        const rStats = db.prepare(`
+        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(`
+        `)
+          .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();
+        `)
+          .get();
         knowledgeBase = {
-          recipes: { total: rStats.total, active: rStats.active, rules: rStats.rules, patterns: rStats.patterns, facts: rStats.facts },
+          recipes: {
+            total: rStats.total,
+            active: rStats.active,
+            rules: rStats.rules,
+            patterns: rStats.patterns,
+            facts: rStats.facts,
+          },
           candidates: { total: cPending.total, pending: cPending.pending },
         };
-      } catch { /* 统计查询失败不影响 health */ }
+      } catch {
+        /* 统计查询失败不影响 health */
+      }
     }
   } catch (e) {
     issues.push(`database: ${e.message}`);
@@ -70,7 +82,9 @@ export async function health(ctx) {
       checks.vectorStore = true;
       if (vsStats) {
         knowledgeBase = knowledgeBase || {};
-        knowledgeBase.vectorIndex = { documentCount: vsStats.documentCount ?? vsStats.totalDocuments ?? 0 };
+        knowledgeBase.vectorIndex = {
+          documentCount: vsStats.documentCount ?? vsStats.totalDocuments ?? 0,
+        };
       }
     }
   } catch (e) {
@@ -135,9 +149,9 @@ export function capabilities() {
   // 根据当前 tier 决定可见工具
   const tierName = process.env.ASD_MCP_TIER || 'agent';
   const maxTier = TIER_ORDER[tierName] ?? TIER_ORDER.agent;
-  const visibleTools = TOOLS.filter(t => (TIER_ORDER[t.tier || 'agent'] ?? 0) <= maxTier);
+  const visibleTools = TOOLS.filter((t) => (TIER_ORDER[t.tier || 'agent'] ?? 0) <= maxTier);
 
-  const tools = visibleTools.map(t => {
+  const tools = visibleTools.map((t) => {
     const props = t.inputSchema.properties || {};
     const requiredSet = new Set(t.inputSchema.required || []);
     const params = Object.entries(props).map(([key, schema]) => ({
@@ -185,9 +199,25 @@ export function capabilities() {
       byCategory,
       tools,
       workflows: [
-        { name: '知识查询', steps: ['search（推荐首选，auto mode 融合）', 'knowledge op=get', 'knowledge op=confirm_usage'], tips: '精确匹配用 mode=keyword，需意图+会话上下文用 mode=context' },
+        {
+          name: '知识查询',
+          steps: [
+            'search（推荐首选，auto mode 融合）',
+            'knowledge op=get',
+            'knowledge op=confirm_usage',
+          ],
+          tips: '精确匹配用 mode=keyword，需意图+会话上下文用 mode=context',
+        },
         { name: '单条知识提交', steps: ['submit_knowledge（内置校验+去重）'] },
-        { name: '批量 Target 扫描', steps: ['structure op=targets', 'structure op=files', '(Agent 分析)', 'submit_knowledge_batch'] },
+        {
+          name: '批量 Target 扫描',
+          steps: [
+            'structure op=targets',
+            'structure op=files',
+            '(Agent 分析)',
+            'submit_knowledge_batch',
+          ],
+        },
         { name: '冷启动', steps: ['bootstrap op=knowledge', 'bootstrap op=refine'] },
         { name: '代码审计', steps: ['guard (code/files)', 'knowledge op=list kind=rule'] },
       ],