autosnippet 3.0.1 → 3.0.2

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

@@ -9,12 +9,20 @@ import { envelope } from '../envelope.js';
 function _projectItem(r) {
   const json = typeof r.toJSON === 'function' ? r.toJSON() : r;
   return {
-    id: json.id, title: json.title, description: json.description,
-    trigger: json.trigger || '', lifecycle: json.lifecycle, kind: json.kind,
-    language: json.language, category: json.category,
-    knowledgeType: json.knowledgeType, complexity: json.complexity,
-    scope: json.scope, tags: json.tags || [],
-    quality: json.quality || null, stats: json.stats || null,
+    id: json.id,
+    title: json.title,
+    description: json.description,
+    trigger: json.trigger || '',
+    lifecycle: json.lifecycle,
+    kind: json.kind,
+    language: json.language,
+    category: json.category,
+    knowledgeType: json.knowledgeType,
+    complexity: json.complexity,
+    scope: json.scope,
+    tags: json.tags || [],
+    quality: json.quality || null,
+    stats: json.stats || null,
     status: json.lifecycle,
     statistics: json.stats,
   };
@@ -23,41 +31,73 @@ function _projectItem(r) {
 export async function listByKind(ctx, kind, args) {
   const ks = ctx.container.get('knowledgeService');
   const filters = { kind };
-  if (args.language)  filters.language  = args.language;
-  if (args.category)  filters.category  = args.category;
+  if (args.language) {
+    filters.language = args.language;
+  }
+  if (args.category) {
+    filters.category = args.category;
+  }
   const result = await ks.list(filters, { page: 1, pageSize: args.limit || 20 });
   const items = (result?.data || []).map(_projectItem);
-  return envelope({ success: true, data: { kind, count: items.length, total: result?.pagination?.total || items.length, items }, meta: { tool: `autosnippet_list_${kind}s` } });
+  return envelope({
+    success: true,
+    data: { kind, count: items.length, total: result?.pagination?.total || items.length, items },
+    meta: { tool: `autosnippet_list_${kind}s` },
+  });
 }
 
 export async function listRecipes(ctx, args) {
   const ks = ctx.container.get('knowledgeService');
   const filters = {};
-  if (args.kind)           filters.kind          = args.kind;
-  if (args.language)       filters.language       = args.language;
-  if (args.category)       filters.category       = args.category;
-  if (args.knowledgeType)  filters.knowledgeType  = args.knowledgeType;
-  if (args.complexity)     filters.complexity     = args.complexity;
-  if (args.status)         filters.lifecycle      = args.status;
+  if (args.kind) {
+    filters.kind = args.kind;
+  }
+  if (args.language) {
+    filters.language = args.language;
+  }
+  if (args.category) {
+    filters.category = args.category;
+  }
+  if (args.knowledgeType) {
+    filters.knowledgeType = args.knowledgeType;
+  }
+  if (args.complexity) {
+    filters.complexity = args.complexity;
+  }
+  if (args.status) {
+    filters.lifecycle = args.status;
+  }
   const result = await ks.list(filters, { page: 1, pageSize: args.limit || 20 });
   const items = (result?.data || []).map(_projectItem);
-  return envelope({ success: true, data: { count: items.length, total: result?.pagination?.total || items.length, items }, meta: { tool: 'autosnippet_list_recipes' } });
+  return envelope({
+    success: true,
+    data: { count: items.length, total: result?.pagination?.total || items.length, items },
+    meta: { tool: 'autosnippet_list_recipes' },
+  });
 }
 
 export async function getRecipe(ctx, args) {
-  if (!args.id) throw new Error('id is required');
+  if (!args.id) {
+    throw new Error('id is required');
+  }
   const ks = ctx.container.get('knowledgeService');
   const entry = await ks.get(args.id);
-  if (!entry) throw new Error(`Knowledge entry not found: ${args.id}`);
+  if (!entry) {
+    throw new Error(`Knowledge entry not found: ${args.id}`);
+  }
   const json = typeof entry.toJSON === 'function' ? entry.toJSON() : entry;
   return envelope({ success: true, data: json, meta: { tool: 'autosnippet_get_recipe' } });
 }
 
 export async function recipeInsights(ctx, args) {
-  if (!args.id) throw new Error('id is required');
+  if (!args.id) {
+    throw new Error('id is required');
+  }
   const ks = ctx.container.get('knowledgeService');
   const entry = await ks.get(args.id);
-  if (!entry) throw new Error(`Knowledge entry not found: ${args.id}`);
+  if (!entry) {
+    throw new Error(`Knowledge entry not found: ${args.id}`);
+  }
   const json = typeof entry.toJSON === 'function' ? entry.toJSON() : entry;
 
   // 聚合关系摘要
@@ -123,7 +163,9 @@ export async function recipeInsights(ctx, args) {
 }
 
 export async function confirmUsage(ctx, args) {
-  if (!args.recipeId) throw new Error('recipeId is required');
+  if (!args.recipeId) {
+    throw new Error('recipeId is required');
+  }
   const ks = ctx.container.get('knowledgeService');
   const usageType = args.usageType || 'adoption';
   const feedback = args.feedback || null;
@@ -143,7 +185,9 @@ export async function confirmUsage(ctx, args) {
           comment: feedback,
         });
       }
-    } catch { /* feedbackCollector 降级不影响主流程 */ }
+    } catch {
+      /* feedbackCollector 降级不影响主流程 */
+    }
   }
 
   return envelope({

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

@@ -17,42 +17,85 @@ export async function validateCandidate(ctx, args) {
   const suggestions = [];
 
   // Layer 1: 核心必填
-  if (!c.title?.trim()) errors.push('缺少 title');
-  if (!c.code?.trim() && args.strict) errors.push('strict 模式下需要 code');
-  if (!c.language) warnings.push('缺少 language');
+  if (!c.title?.trim()) {
+    errors.push('缺少 title');
+  }
+  if (!c.code?.trim() && args.strict) {
+    errors.push('strict 模式下需要 code');
+  }
+  if (!c.language) {
+    warnings.push('缺少 language');
+  }
 
   // Layer 2: 分类
-  if (!c.category) warnings.push('缺少 category');
-  if (!c.knowledgeType) warnings.push('缺少 knowledgeType（code-pattern/architecture/best-practice/...）');
-  if (!c.complexity) suggestions.push({ field: 'complexity', value: 'intermediate' });
+  if (!c.category) {
+    warnings.push('缺少 category');
+  }
+  if (!c.knowledgeType) {
+    warnings.push('缺少 knowledgeType（code-pattern/architecture/best-practice/...）');
+  }
+  if (!c.complexity) {
+    suggestions.push({ field: 'complexity', value: 'intermediate' });
+  }
 
   // Layer 3: 描述文档
-  if (!c.trigger?.trim()) warnings.push('缺少 trigger（建议 @ 开头）');
+  if (!c.trigger?.trim()) {
+    warnings.push('缺少 trigger（建议 @ 开头）');
+  }
   if (c.trigger && !c.trigger.startsWith('@')) {
     suggestions.push({ field: 'trigger', value: `@${c.trigger.replace(/^@+/, '')}` });
   }
-  if (!c.summary?.trim() && !c.description?.trim()) warnings.push('缺少 summary 或 description');
-  if (!c.usageGuide?.trim()) warnings.push('缺少 usageGuide');
+  if (!c.summary?.trim() && !c.description?.trim()) {
+    warnings.push('缺少 summary 或 description');
+  }
+  if (!c.usageGuide?.trim()) {
+    warnings.push('缺少 usageGuide');
+  }
 
   // Layer 4: 结构化内容
-  if (!c.rationale) warnings.push('缺少 rationale（设计原理）');
-  if (!Array.isArray(c.headers) || c.headers.length === 0) warnings.push('缺少 headers（import 声明）');
-  if (!c.steps && !c.codeChanges) suggestions.push({ field: 'steps', value: '[{title, description, code}]' });
+  if (!c.rationale) {
+    warnings.push('缺少 rationale（设计原理）');
+  }
+  if (!Array.isArray(c.headers) || c.headers.length === 0) {
+    warnings.push('缺少 headers（import 声明）');
+  }
+  if (!c.steps && !c.codeChanges) {
+    suggestions.push({ field: 'steps', value: '[{title, description, code}]' });
+  }
 
   // Layer 5: 约束与关系
-  if (!c.constraints) suggestions.push({ field: 'constraints', value: '{boundaries[], preconditions[], sideEffects[], guards[]}' });
+  if (!c.constraints) {
+    suggestions.push({
+      field: 'constraints',
+      value: '{boundaries[], preconditions[], sideEffects[], guards[]}',
+    });
+  }
 
   // Reasoning 推理依据
   if (!c.reasoning) {
     errors.push('缺少 reasoning（推理依据 — whyStandard + sources + confidence）');
   } else {
-    if (!c.reasoning.whyStandard?.trim()) errors.push('reasoning.whyStandard 不能为空');
-    if (!Array.isArray(c.reasoning.sources) || c.reasoning.sources.length === 0) errors.push('reasoning.sources 至少包含一项来源');
-    if (typeof c.reasoning.confidence !== 'number' || c.reasoning.confidence < 0 || c.reasoning.confidence > 1) warnings.push('reasoning.confidence 应为 0-1 的数字');
+    if (!c.reasoning.whyStandard?.trim()) {
+      errors.push('reasoning.whyStandard 不能为空');
+    }
+    if (!Array.isArray(c.reasoning.sources) || c.reasoning.sources.length === 0) {
+      errors.push('reasoning.sources 至少包含一项来源');
+    }
+    if (
+      typeof c.reasoning.confidence !== 'number' ||
+      c.reasoning.confidence < 0 ||
+      c.reasoning.confidence > 1
+    ) {
+      warnings.push('reasoning.confidence 应为 0-1 的数字');
+    }
   }
 
   const ok = errors.length === 0;
-  return envelope({ success: ok, data: { ok, errors, warnings, suggestions }, meta: { tool: 'autosnippet_validate_candidate' } });
+  return envelope({
+    success: ok,
+    data: { ok, errors, warnings, suggestions },
+    meta: { tool: 'autosnippet_validate_candidate' },
+  });
 }
 
 export async function checkDuplicate(ctx, args) {
@@ -63,7 +106,11 @@ export async function checkDuplicate(ctx, args) {
     threshold: args.threshold ?? 0.7,
     topK: args.topK ?? 5,
   });
-  return envelope({ success: true, data: { similar }, meta: { tool: 'autosnippet_check_duplicate' } });
+  return envelope({
+    success: true,
+    data: { similar },
+    meta: { tool: 'autosnippet_check_duplicate' },
+  });
 }
 
 // ─── 语义字段缺失诊断（无 AI 依赖） ──────────────────────────
@@ -78,14 +125,33 @@ export async function enrichCandidates(ctx, args) {
   }
 
   const knowledgeService = ctx.container.get('knowledgeService');
-  if (!knowledgeService) throw new Error('KnowledgeService not available');
+  if (!knowledgeService) {
+    throw new Error('KnowledgeService not available');
+  }
 
-  const SEMANTIC_KEYS = ['content.rationale', 'knowledgeType', 'complexity', 'scope', 'content.steps', 'constraints'];
+  const SEMANTIC_KEYS = [
+    'content.rationale',
+    'knowledgeType',
+    'complexity',
+    'scope',
+    'content.steps',
+    'constraints',
+  ];
   const RECIPE_READY_KEYS = [
-    { key: 'category', check: v => v && ['View','Service','Tool','Model','Network','Storage','UI','Utility'].includes(v), hint: 'category 必须为 8 标准值之一' },
-    { key: 'trigger', check: v => v && v.startsWith('@'), hint: 'trigger 必须以 @ 开头' },
-    { key: 'description', check: v => !!v, hint: '知识条目描述' },
-    { key: 'headers', check: v => Array.isArray(v) && v.length > 0, hint: '完整 import 语句数组' },
+    {
+      key: 'category',
+      check: (v) =>
+        v &&
+        ['View', 'Service', 'Tool', 'Model', 'Network', 'Storage', 'UI', 'Utility'].includes(v),
+      hint: 'category 必须为 8 标准值之一',
+    },
+    { key: 'trigger', check: (v) => v?.startsWith('@'), hint: 'trigger 必须以 @ 开头' },
+    { key: 'description', check: (v) => !!v, hint: '知识条目描述' },
+    {
+      key: 'headers',
+      check: (v) => Array.isArray(v) && v.length > 0,
+      hint: '完整 import 语句数组',
+    },
   ];
 
   const results = [];
@@ -105,11 +171,17 @@ export async function enrichCandidates(ctx, args) {
       for (const keyPath of SEMANTIC_KEYS) {
         const parts = keyPath.split('.');
         let val = json;
-        for (const p of parts) { val = val?.[p]; }
-        if (val === undefined || val === null || val === '' ||
-            (typeof val === 'string' && val.trim() === '') ||
-            (Array.isArray(val) && val.length === 0) ||
-            (typeof val === 'object' && !Array.isArray(val) && Object.keys(val).length === 0)) {
+        for (const p of parts) {
+          val = val?.[p];
+        }
+        if (
+          val === undefined ||
+          val === null ||
+          val === '' ||
+          (typeof val === 'string' && val.trim() === '') ||
+          (Array.isArray(val) && val.length === 0) ||
+          (typeof val === 'object' && !Array.isArray(val) && Object.keys(val).length === 0)
+        ) {
           missing.push(keyPath);
         }
       }
@@ -134,10 +206,20 @@ export async function enrichCandidates(ctx, args) {
         recipeReadyMissing,
         complete: missing.length === 0 && recipeReadyMissing.length === 0,
       });
-      if (missing.length > 0) needsEnrichment++;
-      if (recipeReadyMissing.length > 0) needsRecipeFields++;
+      if (missing.length > 0) {
+        needsEnrichment++;
+      }
+      if (recipeReadyMissing.length > 0) {
+        needsRecipeFields++;
+      }
     } catch (err) {
-      results.push({ id, found: false, error: err.message, missingFields: [], recipeReadyMissing: [] });
+      results.push({
+        id,
+        found: false,
+        error: err.message,
+        missingFields: [],
+        recipeReadyMissing: [],
+      });
     }
   }
 
@@ -149,9 +231,10 @@ export async function enrichCandidates(ctx, args) {
       needsRecipeFields,
       fullyComplete: ids.length - Math.max(needsEnrichment, needsRecipeFields),
       entries: results,
-      hint: (needsEnrichment > 0 || needsRecipeFields > 0)
-        ? '请 Agent 根据 missingFields（语义）和 recipeReadyMissing（必填）自行补全后重新提交'
-        : '所有条目字段完整',
+      hint:
+        needsEnrichment > 0 || needsRecipeFields > 0
+          ? '请 Agent 根据 missingFields（语义）和 recipeReadyMissing（必填）自行补全后重新提交'
+          : '所有条目字段完整',
     },
     meta: { tool: 'autosnippet_enrich_candidates' },
   });

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

@@ -7,13 +7,13 @@
  * 不包含业务逻辑，仅做参数解构 → 路由 → 转发。
  */
 
-import * as searchHandlers from './search.js';
+import * as bootstrapHandlers from './bootstrap.js';
 import * as browseHandlers from './browse.js';
-import * as structureHandlers from './structure.js';
+import * as candidateHandlers from './candidate.js';
 import * as guardHandlers from './guard.js';
+import * as searchHandlers from './search.js';
 import * as skillHandlers from './skill.js';
-import * as bootstrapHandlers from './bootstrap.js';
-import * as candidateHandlers from './candidate.js';
+import * as structureHandlers from './structure.js';
 
 // ─── autosnippet_search (整合 4 → 1) ────────────────────────
 
@@ -33,8 +33,6 @@ export async function consolidatedSearch(ctx, args) {
       return searchHandlers.semanticSearch(ctx, args);
     case 'context':
       return searchHandlers.contextSearch(ctx, args);
-    case 'auto':
-    case 'bm25':
     default:
       return searchHandlers.search(ctx, { ...args, mode });
   }
@@ -71,7 +69,9 @@ export async function consolidatedKnowledge(ctx, args) {
       }
       return browseHandlers.confirmUsage(ctx, args);
     default:
-      throw new Error(`Unknown knowledge operation: ${op}. Expected: list, get, insights, confirm_usage`);
+      throw new Error(
+        `Unknown knowledge operation: ${op}. Expected: list, get, insights, confirm_usage`
+      );
   }
 }
 
@@ -108,7 +108,9 @@ export async function consolidatedStructure(ctx, args) {
  */
 export async function consolidatedGraph(ctx, args) {
   const op = args.operation;
-  if (!op) throw new Error('Missing required parameter: operation. Expected: query, impact, path, stats');
+  if (!op) {
+    throw new Error('Missing required parameter: operation. Expected: query, impact, path, stats');
+  }
   switch (op) {
     case 'query':
       return structureHandlers.graphQuery(ctx, args);
@@ -137,7 +139,9 @@ export async function consolidatedGuard(ctx, args) {
   if (args.code) {
     return guardHandlers.guardCheck(ctx, args);
   }
-  throw new Error('autosnippet_guard requires either "code" (single check) or "files" (batch audit) parameter');
+  throw new Error(
+    'autosnippet_guard requires either "code" (single check) or "files" (batch audit) parameter'
+  );
 }
 
 // ─── autosnippet_skill (整合 6 → 1) ─────────────────────────
@@ -153,7 +157,11 @@ export async function consolidatedGuard(ctx, args) {
  */
 export async function consolidatedSkill(ctx, args) {
   const op = args.operation;
-  if (!op) throw new Error('Missing required parameter: operation. Expected: list, load, create, update, delete, suggest');
+  if (!op) {
+    throw new Error(
+      'Missing required parameter: operation. Expected: list, load, create, update, delete, suggest'
+    );
+  }
 
   // loadSkill expects { skillName }, map from { name }
   if (args.name && !args.skillName) {
@@ -174,7 +182,9 @@ export async function consolidatedSkill(ctx, args) {
     case 'suggest':
       return skillHandlers.suggestSkills(ctx);
     default:
-      throw new Error(`Unknown skill operation: ${op}. Expected: list, load, create, update, delete, suggest`);
+      throw new Error(
+        `Unknown skill operation: ${op}. Expected: list, load, create, update, delete, suggest`
+      );
   }
 }
 
@@ -188,7 +198,9 @@ export async function consolidatedSkill(ctx, args) {
  */
 export async function consolidatedBootstrap(ctx, args) {
   const op = args.operation;
-  if (!op) throw new Error('Missing required parameter: operation. Expected: knowledge, refine, scan');
+  if (!op) {
+    throw new Error('Missing required parameter: operation. Expected: knowledge, refine, scan');
+  }
   switch (op) {
     case 'knowledge':
       return bootstrapHandlers.bootstrapKnowledge(ctx, args);
@@ -248,7 +260,21 @@ export async function enhancedSubmitKnowledge(ctx, args) {
       data: {
         missingFields: readiness.missing,
         suggestions: readiness.suggestions,
-        requiredFields: ['title', 'language', 'content', 'kind', 'doClause', 'category', 'trigger', 'description', 'headers', 'usageGuide', 'knowledgeType', 'rationale (in content.rationale)'],
+        requiredFields: [
+          'title',
+          'language',
+          'content (pattern/markdown)',
+          'content.rationale',
+          'kind (rule/pattern/fact)',
+          'doClause',
+          'category (View/Service/Tool/Model/Network/Storage/UI/Utility)',
+          'trigger (@前缀)',
+          'description',
+          'headers (import 语句数组)',
+          'usageGuide (### 章节格式)',
+          'knowledgeType',
+          'reasoning (whyStandard + sources + confidence)',
+        ],
       },
       meta: { tool: 'autosnippet_submit_knowledge' },
     });
@@ -258,7 +284,9 @@ export async function enhancedSubmitKnowledge(ctx, args) {
   const result = await submitKnowledge(ctx, args);
 
   // 如果提交本身失败，直接返回
-  if (result && !result.success) return result;
+  if (result && !result.success) {
+    return result;
+  }
 
   // ── 附加去重检测结果（非阻塞） ──
   let duplicateCheck = null;
@@ -269,10 +297,14 @@ export async function enhancedSubmitKnowledge(ctx, args) {
         summary: args.description || '',
         code: args.content?.pattern || '',
       };
-      const dedupResult = await candidateHandlers.checkDuplicate(ctx, { candidate: dedupCandidate, threshold: 0.7, topK: 3 });
+      const dedupResult = await candidateHandlers.checkDuplicate(ctx, {
+        candidate: dedupCandidate,
+        threshold: 0.7,
+        topK: 3,
+      });
       if (dedupResult?.data) {
         duplicateCheck = {
-          hasSimilar: dedupResult.data.hasDuplicate ?? (dedupResult.data.matches?.length > 0),
+          hasSimilar: dedupResult.data.hasDuplicate ?? dedupResult.data.matches?.length > 0,
           closest: dedupResult.data.matches?.[0] || null,
         };
       }
@@ -282,7 +314,7 @@ export async function enhancedSubmitKnowledge(ctx, args) {
   }
 
   // 将去重结果附到响应中
-  if (result && result.data) {
+  if (result?.data) {
     result.data.duplicateCheck = duplicateCheck;
   }