autosnippet 2.19.8 → 3.0.0

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

@@ -332,7 +332,7 @@ export function createSkill(_ctx, args) {
       path: skillPath,
       overwritten: fs.existsSync(skillPath) && overwrite,
       editorIndex: indexResult,
-      hint: `Skill "${name}" created. Use autosnippet_load_skill to verify content.`,
+      hint: `Skill "${name}" created. Use autosnippet_skill({ operation: "load", name: "${name}" }) to verify content.`,
     },
   });
 }
@@ -381,7 +381,7 @@ function _regenerateEditorIndex() {
       '',
       '# AutoSnippet Project Skills',
       '',
-      `本项目已注册 ${projectSkills.length} 个自定义 Skill。使用 \`autosnippet_load_skill\` 工具加载完整内容。`,
+      `本项目已注册 ${projectSkills.length} 个自定义 Skill。使用 \`autosnippet_skill({ operation: "load", name })\` 加载完整内容。`,
       '',
       skillLines,
       '',
@@ -529,7 +529,7 @@ export function updateSkill(_ctx, args) {
       success: false,
       error: {
         code: 'SKILL_NOT_FOUND',
-        message: `Project skill "${name}" not found. Use autosnippet_create_skill to create it first.`,
+        message: `Project skill "${name}" not found. Use autosnippet_skill({ operation: "create" }) to create it first.`,
       },
     });
   }
@@ -592,7 +592,7 @@ export function updateSkill(_ctx, args) {
       updated: true,
       fieldsUpdated: [description ? 'description' : null, content ? 'content' : null].filter(Boolean),
       editorIndex: indexResult,
-      hint: `Skill "${name}" updated. Use autosnippet_load_skill to verify content.`,
+      hint: `Skill "${name}" updated. Use autosnippet_skill({ operation: "load", name: "${name}" }) to verify content.`,
     },
   });
 }

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

@@ -68,7 +68,7 @@ export async function getTargets(ctx, args = {}) {
   const includeSummary = args.includeSummary !== false; // 默认 true
 
   if (!includeSummary) {
-    return envelope({ success: true, data: { targets }, meta: { tool: 'autosnippet_get_targets' } });
+    return envelope({ success: true, data: { targets }, meta: { tool: 'autosnippet_structure' } });
   }
 
   // 带摘要：每个 target 附加文件数、语言统计、推断职责
@@ -105,7 +105,7 @@ export async function getTargets(ctx, args = {}) {
       targets: enriched,
       summary: { targetCount: targets.length, totalFiles, languageStats: globalLangStats },
     },
-    meta: { tool: 'autosnippet_get_targets' },
+    meta: { tool: 'autosnippet_structure' },
   });
 }
 
@@ -160,7 +160,7 @@ export async function getTargetFiles(ctx, args) {
       totalAvailable: rawFiles.length,
       languageStats: langStats,
     },
-    meta: { tool: 'autosnippet_get_target_files' },
+    meta: { tool: 'autosnippet_structure' },
   });
 }
 
@@ -213,13 +213,13 @@ export async function getTargetMetadata(ctx, args) {
     }
   } catch { /* knowledge_edges may not exist */ }
 
-  return envelope({ success: true, data: meta, meta: { tool: 'autosnippet_get_target_metadata' } });
+  return envelope({ success: true, data: meta, meta: { tool: 'autosnippet_structure' } });
 }
 
 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_query' } });
+    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,17 +234,17 @@ 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_query', source: 'relations-fallback' } });
+      return envelope({ success: true, data, meta: { tool: 'autosnippet_graph', source: 'relations-fallback' } });
     }
     throw err;
   }
-  return envelope({ success: true, data, meta: { tool: 'autosnippet_graph_query' } });
+  return envelope({ success: true, data, meta: { tool: 'autosnippet_graph' } });
 }
 
 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_impact' } });
+    return envelope({ success: false, message: 'KnowledgeGraphService not available — knowledge_edges 表可能未初始化', meta: { tool: 'autosnippet_graph' } });
   }
   const nodeType = args.nodeType || 'recipe';
   let impacted;
@@ -254,11 +254,11 @@ 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_impact', 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_impact' } });
+  return envelope({ success: true, data: { nodeId: args.nodeId, impactedCount: impacted.length, impacted }, meta: { tool: 'autosnippet_graph' } });
 }
 
 /**
@@ -341,7 +341,7 @@ export async function graphPath(ctx, args) {
   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_path' } });
+    return envelope({ success: false, message: 'KnowledgeGraphService not available', meta: { tool: 'autosnippet_graph' } });
   }
   const fromType = args.fromType || 'recipe';
   const toType = args.toType || 'recipe';
@@ -353,11 +353,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_path', source: 'relations-fallback' } });
+      return envelope({ success: true, data: result, meta: { tool: 'autosnippet_graph', source: 'relations-fallback' } });
     }
     throw err;
   }
-  return envelope({ success: true, data: result, meta: { tool: 'autosnippet_graph_path' } });
+  return envelope({ success: true, data: result, meta: { tool: 'autosnippet_graph' } });
 }
 
 /**
@@ -391,16 +391,16 @@ 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_stats' } });
+    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_stats' } });
+      return envelope({ success: true, data: { totalEdges: 0, byRelation: {}, nodeTypes: [], note: 'knowledge_edges 表不存在，请运行数据库迁移' }, meta: { tool: 'autosnippet_graph' } });
     }
     throw err;
   }
-  return envelope({ success: true, data: stats, meta: { tool: 'autosnippet_graph_stats' } });
+  return envelope({ success: true, data: stats, meta: { tool: 'autosnippet_graph' } });
 }

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 } from '../tools.js';
+import { TOOLS, TOOL_GATEWAY_MAP, TIER_ORDER } from '../tools.js';
 
 export async function health(ctx) {
   const checks = { database: false, gateway: false, vectorStore: false };
@@ -112,36 +112,32 @@ export async function health(ctx) {
 let _pkgVersion = null;
 
 export function capabilities() {
-  // 工具分类映射
+  // V3 工具分类映射
   const CATEGORY_MAP = {
     autosnippet_health: 'system',
     autosnippet_capabilities: 'system',
     autosnippet_search: 'search',
-    autosnippet_context_search: 'search',
-    autosnippet_keyword_search: 'search',
-    autosnippet_semantic_search: 'search',
-    autosnippet_list_rules: 'browse',
-    autosnippet_list_patterns: 'browse',
-    autosnippet_list_facts: 'browse',
-    autosnippet_list_recipes: 'browse',
-    autosnippet_get_recipe: 'browse',
-    autosnippet_recipe_insights: 'browse',
-    autosnippet_graph_query: 'graph',
-    autosnippet_graph_impact: 'graph',
-    autosnippet_get_targets: 'structure',
-    autosnippet_get_target_files: 'structure',
-    autosnippet_get_target_metadata: 'structure',
-    autosnippet_validate_candidate: 'validate',
-    autosnippet_check_duplicate: 'validate',
-    autosnippet_guard_check: 'guard',
-    autosnippet_guard_audit_files: 'guard',
-    autosnippet_scan_project: 'scan',
-    autosnippet_enrich_candidates: 'enrich',
-    autosnippet_confirm_usage: 'telemetry',
-    autosnippet_compliance_report: 'telemetry',
+    autosnippet_knowledge: 'browse',
+    autosnippet_structure: 'structure',
+    autosnippet_graph: 'graph',
+    autosnippet_guard: 'guard',
+    autosnippet_submit_knowledge: 'submit',
+    autosnippet_submit_knowledge_batch: 'submit',
+    autosnippet_save_document: 'submit',
+    autosnippet_skill: 'skill',
+    autosnippet_bootstrap: 'bootstrap',
+    autosnippet_enrich_candidates: 'admin',
+    autosnippet_knowledge_lifecycle: 'admin',
+    autosnippet_validate_candidate: 'admin',
+    autosnippet_check_duplicate: 'admin',
   };
 
-  const tools = TOOLS.map(t => {
+  // 根据当前 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 tools = visibleTools.map(t => {
     const props = t.inputSchema.properties || {};
     const requiredSet = new Set(t.inputSchema.required || []);
     const params = Object.entries(props).map(([key, schema]) => ({
@@ -155,6 +151,7 @@ export function capabilities() {
     const gatewayInfo = TOOL_GATEWAY_MAP[t.name];
     return {
       name: t.name,
+      tier: t.tier || 'agent',
       description: t.description,
       category: CATEGORY_MAP[t.name] || 'other',
       gatewayGated: !!gatewayInfo,
@@ -172,27 +169,27 @@ export function capabilities() {
     success: true,
     data: {
       count: tools.length,
+      tier: tierName,
       categoryGuide: {
         system: '系统状态与能力发现',
-        search: '知识库搜索 — search(auto 融合推荐) / keyword_search(SQL LIKE 精确) / semantic_search(向量语义) / context_search(Agent+漏斗+会话)',
-        browse: '知识浏览（list / get / insights）',
-        graph: '知识图谱关系查询与影响分析',
-        structure: 'SPM Target 结构发现',
-        validate: '候选预校验与去重检测',
-        submit: '候选提交（写操作，Gateway gated）',
-        guard: '代码 Guard 规则审计（写操作，Gateway gated）',
-        scan: '全项目扫描（文件收集 + Guard 检查）',
-        enrich: 'AI 语义字段补全（写操作，Gateway gated）',
-        telemetry: '使用遥测与合规',
+        search: '统合搜索 — auto(BM25+semantic 融合) / keyword / semantic / context(漏斗+会话)',
+        browse: '知识浏览 — list/get/insights/confirm_usage（operation 路由）',
+        graph: '知识图谱 — query/impact/path/stats（operation 路由）',
+        structure: '项目结构 — targets/files/metadata（operation 路由）',
+        submit: '知识提交（写操作，Gateway gated）',
+        guard: '代码 Guard 检查 — code(单文件)/files(批量)（自动路由）',
+        skill: 'Skill 管理 — list/load/create/update/delete/suggest',
+        bootstrap: '冷启动 & 扫描 — knowledge/refine/scan',
+        admin: '管理员工具（诊断/生命周期/校验/去重）',
       },
       byCategory,
       tools,
       workflows: [
-        { name: '知识查询', steps: ['search（推荐首选，auto mode 融合）', 'get_recipe', 'confirm_usage'], tips: '精确匹配用 keyword_search，需意图+会话上下文用 context_search' },
-        { name: '单条知识提交', steps: ['check_duplicate', 'validate_candidate', 'submit_knowledge'] },
-        { name: '批量 Target 扫描', steps: ['get_targets', 'get_target_files', '(Agent 分析)', 'submit_knowledge_batch'] },
-        { name: '全项目深度扫描', steps: ['scan_project', '(Agent 语义分析)', 'submit_knowledge_batch', 'enrich_candidates'] },
-        { name: '候选就绪检查', steps: ['enrich_candidates', 'validate_candidate', 'check_duplicate'] },
+        { 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: '冷启动', steps: ['bootstrap op=knowledge', 'bootstrap op=refine'] },
+        { name: '代码审计', steps: ['guard (code/files)', 'knowledge op=list kind=rule'] },
       ],
     },
     meta: { tool: 'autosnippet_capabilities' },