autosnippet 2.9.0 → 2.10.0

package/lib/external/mcp/McpServer.js

@@ -3,7 +3,7 @@
  *
  * Model Context Protocol (stdio transport)
  * 提供给 IDE AI Agent (Cursor/VSCode Copilot) 的工具集
- * 34 工具，全部基于 V2 服务层，不依赖 V1
+ * 38 工具，全部基于 V2 服务层，不依赖 V1
  * Gateway 权限 gating: 写操作经过 Gateway 权限/宪法/审计检查
  *
  * 本文件仅包含服务编排层（初始化、路由、Gateway gating、生命周期）。
@@ -31,6 +31,7 @@ import * as candidateHandlers from './handlers/candidate.js';
 import * as guardHandlers from './handlers/guard.js';
 import * as bootstrapHandlers from './handlers/bootstrap.js';
 import * as skillHandlers from './handlers/skill.js';
+import * as knowledgeHandlers from './handlers/knowledge.js';
 
 // ─── McpServer 类 ─────────────────────────────────────────────
 
@@ -140,12 +141,9 @@ export class McpServer {
       case 'autosnippet_graph_impact':      return structureHandlers.graphImpact(ctx, args);
       case 'autosnippet_graph_path':        return structureHandlers.graphPath(ctx, args);
       case 'autosnippet_graph_stats':       return structureHandlers.graphStats(ctx);
-      // 候选校验 & 提交 & AI 补全
+      // 候选校验 & AI 补全（提交已移至 V3 knowledge handlers）
       case 'autosnippet_validate_candidate':  return candidateHandlers.validateCandidate(ctx, args);
       case 'autosnippet_check_duplicate':   return candidateHandlers.checkDuplicate(ctx, args);
-      case 'autosnippet_submit_candidate':  return candidateHandlers.submitSingle(ctx, args);
-      case 'autosnippet_submit_candidates': return candidateHandlers.submitBatch(ctx, args);
-      case 'autosnippet_submit_draft_recipes': return candidateHandlers.submitDrafts(ctx, args);
       case 'autosnippet_enrich_candidates': return candidateHandlers.enrichCandidates(ctx, args);
       // Guard & 扫描
       case 'autosnippet_guard_check':       return guardHandlers.guardCheck(ctx, args);
@@ -161,6 +159,10 @@ export class McpServer {
       case 'autosnippet_delete_skill':        return skillHandlers.deleteSkill(ctx, args);
       case 'autosnippet_update_skill':        return skillHandlers.updateSkill(ctx, args);
       case 'autosnippet_suggest_skills':      return skillHandlers.suggestSkills(ctx);
+      // V3 知识条目
+      case 'autosnippet_submit_knowledge':        return knowledgeHandlers.submitKnowledge(ctx, args);
+      case 'autosnippet_submit_knowledge_batch':  return knowledgeHandlers.submitKnowledgeBatch(ctx, args);
+      case 'autosnippet_knowledge_lifecycle':      return knowledgeHandlers.knowledgeLifecycle(ctx, args);
       default: throw new Error(`Unknown tool: ${name}`);
     }
   }

package/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.js

@@ -5,7 +5,7 @@
  *
  * 1. Analyst Agent 自由探索代码 (AST 工具 + 文件搜索)
  * 2. HandoffProtocol 质量门控
- * 3. Producer Agent 格式化输出 (submit_candidate)
+ * 3. Producer Agent 格式化输出 (submit_knowledge)
  * 4. TierScheduler 分层并行执行
  *
  * @module pipeline/orchestrator
@@ -412,7 +412,7 @@ export async function fillDimensionsV3(fillContext) {
       // 记录到 DimensionContext
       for (const tc of (producerResult.toolCalls || [])) {
         const tool = tc.tool || tc.name;
-        if (tool === 'submit_candidate' || tool === 'submit_with_check') {
+        if (tool === 'submit_knowledge' || tool === 'submit_with_check') {
           dimContext.addSubmittedCandidate(dimId, {
             title: tc.params?.title || '',
             subTopic: tc.params?.category || '',

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

@@ -392,7 +392,7 @@ export async function bootstrapKnowledge(ctx, args) {
       skillWorthyDimensions: dimensions.filter(d => d.skillWorthy).map(d => d.id),
       candidateOnlyDimensions: dimensions.filter(d => !d.skillWorthy).map(d => d.id),
       candidateRequiredFields: ['title', 'code', 'language', 'category', 'knowledgeType', 'reasoning'],
-      submissionTool: 'autosnippet_submit_candidates',
+      submissionTool: 'autosnippet_submit_knowledge_batch',
       expectedOutput: '候选知识（微观代码维度：code-pattern/best-practice/event-and-data-flow + 深度扫描：objc-deep-scan/category-scan）+ 6 个 Project Skills（宏观叙事维度：code-standard/architecture/project-profile/agent-guidelines + 深度扫描：objc-deep-scan/category-scan）',
     },
 
@@ -423,7 +423,7 @@ export async function bootstrapKnowledge(ctx, args) {
       '== 完成后可执行的后续操作 ==',
       '1. 调用 autosnippet_enrich_candidates(candidateIds) 补全候选缺失字段',
       '2. 调用 autosnippet_bootstrap_refine() 对候选进行 AI 精炼',
-      '3. 使用 autosnippet_submit_candidates 手动提交更多候选',
+      '3. 使用 autosnippet_submit_knowledge_batch 手动提交更多知识条目',
       '4. 使用 autosnippet_load_skill 加载自动生成的 Project Skills',
       '',
       '== 宏观维度 → Project Skills ==',
@@ -520,7 +520,7 @@ export async function bootstrapKnowledge(ctx, args) {
 /**
  * bootstrapRefine — Phase 6 AI 润色
  *
- * 对 Bootstrap Phase 5 产出的候选进行 AI 二次精炼：
+ * 对 Bootstrap Phase 5 产出的知识条目进行 AI 二次精炼：
  * - 改善模板化描述 → 更自然精准
  * - 补充高阶架构洞察
  * - 推断并填充 relations 关联
@@ -531,7 +531,7 @@ export async function bootstrapKnowledge(ctx, args) {
  */
 export async function bootstrapRefine(ctx, args) {
   const t0 = Date.now();
-  const candidateService = ctx.container.get('candidateService');
+  const knowledgeService = ctx.container.get('knowledgeService');
   const aiProvider = ctx.container.get('aiProvider');
 
   if (!aiProvider) {
@@ -545,17 +545,122 @@ export async function bootstrapRefine(ctx, args) {
     onProgress = (eventName, data) => taskManager.emitProgress(eventName, data);
   } catch { /* optional */ }
 
-  const result = await candidateService.refineBootstrapCandidates(
-    aiProvider,
-    { candidateIds: args.candidateIds, userPrompt: args.userPrompt, dryRun: args.dryRun, onProgress },
-    { userId: 'external_agent' },
-  );
+  // 1. 收集待润色条目
+  let entries;
+  if (args.candidateIds?.length) {
+    entries = [];
+    for (const id of args.candidateIds) {
+      const e = await knowledgeService.get(id);
+      if (e) entries.push(typeof e.toJSON === 'function' ? e.toJSON() : e);
+    }
+  } else {
+    const result = await knowledgeService.list({ lifecycle: 'pending', source: 'bootstrap' }, { page: 1, pageSize: 200 });
+    entries = (result.items || []).map(e => typeof e.toJSON === 'function' ? e.toJSON() : e);
+  }
+
+  if (entries.length === 0) {
+    return envelope({ success: true, data: { refined: 0, total: 0, errors: [], results: [] }, meta: { tool: 'autosnippet_bootstrap_refine', responseTimeMs: Date.now() - t0 } });
+  }
+
+  onProgress?.('refine:started', { total: entries.length, candidateIds: entries.map(e => e.id) });
+
+  // 2. 逐条 AI 润色
+  const allTitles = entries.map(e => e.title).filter(Boolean);
+  const results = [];
+  const errors = [];
+  let refined = 0;
+  let processed = 0;
+
+  for (const entry of entries) {
+    processed++;
+    onProgress?.('refine:item-started', { candidateId: entry.id, title: entry.title, current: processed, total: entries.length, progress: Math.round(((processed - 1) / entries.length) * 100) });
+
+    try {
+      const prompt = `你是一位高级代码知识管理专家。请改进以下知识条目：
+
+标题: ${entry.title}
+类型: ${entry.knowledge_type}
+语言: ${entry.language}
+描述: ${entry.description || ''}
+代码:
+\`\`\`
+${(entry.content?.pattern || '').substring(0, 2000)}
+\`\`\`
+
+同批次知识: ${allTitles.slice(0, 20).join(', ')}
+${args.userPrompt ? `用户补充: ${args.userPrompt}` : ''}
+
+请返回 JSON:
+{
+  "summary": "改进后的中文摘要",
+  "tags": ["建议标签"],
+  "relations": [{"target":"相关条目标题","relation":"depends_on|extends|related_to"}],
+  "confidence": 0.0-1.0,
+  "insight": "架构洞察（一句话）"
+}`;
+
+      const response = await aiProvider.chat(prompt, { temperature: 0.3 });
+      const parsed = aiProvider.extractJSON(response, '{', '}');
+
+      if (!parsed) {
+        errors.push({ id: entry.id, title: entry.title, error: 'AI returned no valid JSON' });
+        onProgress?.('refine:item-failed', { candidateId: entry.id, title: entry.title, error: 'No valid JSON', current: processed, total: entries.length, progress: Math.round((processed / entries.length) * 100) });
+        continue;
+      }
+
+      if (args.dryRun) {
+        results.push({ id: entry.id, title: entry.title, preview: parsed });
+        onProgress?.('refine:item-completed', { candidateId: entry.id, title: entry.title, refined: false, current: processed, total: entries.length, progress: Math.round((processed / entries.length) * 100) });
+        continue;
+      }
+
+      // 构建更新数据
+      const updateData = {};
+      let changed = false;
+
+      if (parsed.summary && parsed.summary !== entry.summary_cn) {
+        updateData.summary_cn = parsed.summary;
+        changed = true;
+      }
+      if (parsed.tags && Array.isArray(parsed.tags)) {
+        const merged = [...new Set([...(entry.tags || []), ...parsed.tags])];
+        if (merged.length > (entry.tags || []).length) {
+          updateData.tags = merged;
+          changed = true;
+        }
+      }
+      if (typeof parsed.confidence === 'number' && parsed.confidence !== 0.6) {
+        updateData.reasoning = { ...(entry.reasoning || {}), confidence: parsed.confidence };
+        changed = true;
+      }
+      if (parsed.insight) {
+        updateData.description = `${entry.description || ''}\n\n**AI Insight**: ${parsed.insight}`.trim();
+        changed = true;
+      }
+
+      if (changed) {
+        await knowledgeService.update(entry.id, updateData);
+        refined++;
+      }
+
+      results.push({ id: entry.id, title: entry.title, refined: changed, fields: Object.keys(parsed) });
+      onProgress?.('refine:item-completed', { candidateId: entry.id, title: entry.title, refined: changed, current: processed, total: entries.length, progress: Math.round((processed / entries.length) * 100), refinedSoFar: refined });
+    } catch (err) {
+      errors.push({ id: entry.id, title: entry.title, error: err.message });
+      onProgress?.('refine:item-failed', { candidateId: entry.id, title: entry.title, error: err.message, current: processed, total: entries.length, progress: Math.round((processed / entries.length) * 100) });
+    }
+  }
+
+  onProgress?.('refine:completed', { total: entries.length, refined, failed: errors.length });
 
   return envelope({
     success: true,
     data: {
-      ...result,
-      message: `Phase 6 AI 润色完成: ${result.refined}/${result.total} 条候选已更新${args.dryRun ? '（预览模式）' : ''}`,
+      refined,
+      total: entries.length,
+      errors,
+      results,
+      message: `Phase 6 AI 润色完成: ${refined}/${entries.length} 条知识条目已更新${args.dryRun ? '（预览模式）' : ''}`,
     },
     meta: { tool: 'autosnippet_bootstrap_refine', responseTimeMs: Date.now() - t0 },
   });

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

@@ -1,65 +1,70 @@
 /**
- * MCP Handlers — 知识浏览类
- * listByKind, listRecipes, getRecipe, recipeInsights, complianceReport, confirmUsage
+ * MCP Handlers — 知识浏览类 (V3: 使用 knowledgeService)
+ * listByKind, listRecipes, getRecipe, recipeInsights, confirmUsage
  */
 
 import { envelope } from '../envelope.js';
 
+/** 将 KnowledgeEntry 的 V3 字段投影为列表摘要 */
+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,
+    knowledge_type: json.knowledge_type, complexity: json.complexity,
+    scope: json.scope, tags: json.tags || [],
+    quality: json.quality || null, stats: json.stats || null,
+    // 兼容旧字段名
+    status: json.lifecycle, knowledgeType: json.knowledge_type,
+    statistics: json.stats,
+  };
+}
+
 export async function listByKind(ctx, kind, args) {
-  const recipeService = ctx.container.get('recipeService');
+  const ks = ctx.container.get('knowledgeService');
   const filters = { kind };
-  if (args.status) filters.status = args.status;
-  if (args.language) filters.language = args.language;
-  if (args.category) filters.category = args.category;
-  const result = await recipeService.listRecipes(filters, { page: 1, pageSize: args.limit || 20 });
-  const items = (result?.data || result?.items || []).map(r => ({
-    id: r.id, title: r.title || r.name, description: r.description,
-    trigger: r.trigger || '', status: r.status, language: r.language, category: r.category,
-    knowledgeType: r.knowledgeType, kind: r.kind,
-    complexity: r.complexity, scope: r.scope, tags: r.tags || [],
-    quality: r.quality || null, statistics: r.statistics || null,
-  }));
+  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` } });
 }
 
 export async function listRecipes(ctx, args) {
-  const recipeService = ctx.container.get('recipeService');
+  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.status) filters.status = args.status;
-  if (args.complexity) filters.complexity = args.complexity;
-  const result = await recipeService.listRecipes(filters, { page: 1, pageSize: args.limit || 20 });
-  const items = (result?.data || result?.items || []).map(r => ({
-    id: r.id, title: r.title, description: r.description,
-    trigger: r.trigger || '', status: r.status, language: r.language, category: r.category,
-    kind: r.kind, knowledgeType: r.knowledgeType, complexity: r.complexity,
-    scope: r.scope, tags: r.tags,
-    quality: r.quality, statistics: r.statistics,
-  }));
+  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' } });
 }
 
 export async function getRecipe(ctx, args) {
   if (!args.id) throw new Error('id is required');
-  const recipeService = ctx.container.get('recipeService');
-  const recipe = await recipeService.getRecipe(args.id);
-  if (!recipe) throw new Error(`Recipe not found: ${args.id}`);
-  return envelope({ success: true, data: recipe, meta: { tool: 'autosnippet_get_recipe' } });
+  const ks = ctx.container.get('knowledgeService');
+  const entry = await ks.get(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');
-  const recipeService = ctx.container.get('recipeService');
-  const recipe = await recipeService.getRecipe(args.id);
-  if (!recipe) throw new Error(`Recipe not found: ${args.id}`);
+  const ks = ctx.container.get('knowledgeService');
+  const entry = await ks.get(args.id);
+  if (!entry) throw new Error(`Knowledge entry not found: ${args.id}`);
+  const json = typeof entry.toJSON === 'function' ? entry.toJSON() : entry;
 
   // 聚合关系摘要
   const relationsSummary = {};
-  if (recipe.relations) {
-    for (const [type, targets] of Object.entries(recipe.relations)) {
+  if (json.relations) {
+    for (const [type, targets] of Object.entries(json.relations)) {
       if (Array.isArray(targets) && targets.length > 0) {
         relationsSummary[type] = targets.length;
       }
@@ -68,8 +73,8 @@ export async function recipeInsights(ctx, args) {
 
   // 约束条件概览
   const constraintsSummary = {};
-  if (recipe.constraints) {
-    for (const [type, items] of Object.entries(recipe.constraints)) {
+  if (json.constraints) {
+    for (const [type, items] of Object.entries(json.constraints)) {
       if (Array.isArray(items) && items.length > 0) {
         constraintsSummary[type] = items;
       }
@@ -77,43 +82,42 @@ export async function recipeInsights(ctx, args) {
   }
 
   const insights = {
-    id: recipe.id,
-    title: recipe.title,
-    trigger: recipe.trigger || '',
-    kind: recipe.kind,
-    status: recipe.status,
-    language: recipe.language,
-    category: recipe.category,
-    knowledgeType: recipe.knowledgeType,
+    id: json.id,
+    title: json.title,
+    trigger: json.trigger || '',
+    kind: json.kind,
+    lifecycle: json.lifecycle,
+    language: json.language,
+    category: json.category,
+    knowledge_type: json.knowledge_type,
     quality: {
-      overall: recipe.quality?.overall ?? null,
-      codeCompleteness: recipe.quality?.codeCompleteness ?? null,
-      projectAdaptation: recipe.quality?.projectAdaptation ?? null,
-      documentationClarity: recipe.quality?.documentationClarity ?? null,
+      overall: json.quality?.overall ?? null,
+      completeness: json.quality?.completeness ?? null,
+      adaptation: json.quality?.adaptation ?? null,
+      documentation: json.quality?.documentation ?? null,
     },
-    statistics: {
-      adoptionCount: recipe.statistics?.adoptionCount ?? 0,
-      applicationCount: recipe.statistics?.applicationCount ?? 0,
-      guardHitCount: recipe.statistics?.guardHitCount ?? 0,
-      viewCount: recipe.statistics?.viewCount ?? 0,
-      successCount: recipe.statistics?.successCount ?? 0,
-      feedbackScore: recipe.statistics?.feedbackScore ?? 0,
+    stats: {
+      adoptions: json.stats?.adoptions ?? 0,
+      applications: json.stats?.applications ?? 0,
+      guard_hits: json.stats?.guard_hits ?? 0,
+      views: json.stats?.views ?? 0,
+      search_hits: json.stats?.search_hits ?? 0,
     },
     content: {
-      hasPattern: !!recipe.content?.pattern,
-      hasRationale: !!recipe.content?.rationale,
-      hasMarkdown: !!recipe.content?.markdown,
-      stepsCount: recipe.content?.steps?.length ?? 0,
-      codeChangesCount: recipe.content?.codeChanges?.length ?? 0,
+      hasPattern: !!json.content?.pattern,
+      hasRationale: !!json.content?.rationale,
+      hasMarkdown: !!json.content?.markdown,
+      stepsCount: json.content?.steps?.length ?? 0,
+      codeChangesCount: json.content?.code_changes?.length ?? 0,
     },
     relations: relationsSummary,
     constraints: constraintsSummary,
-    tags: recipe.tags || [],
-    complexity: recipe.complexity,
-    scope: recipe.scope,
-    createdBy: recipe.createdBy,
-    createdAt: recipe.createdAt,
-    updatedAt: recipe.updatedAt,
+    tags: json.tags || [],
+    complexity: json.complexity,
+    scope: json.scope,
+    created_by: json.created_by,
+    created_at: json.created_at,
+    updated_at: json.updated_at,
   };
 
   return envelope({ success: true, data: insights, meta: { tool: 'autosnippet_recipe_insights' } });
@@ -121,11 +125,11 @@ export async function recipeInsights(ctx, args) {
 
 export async function confirmUsage(ctx, args) {
   if (!args.recipeId) throw new Error('recipeId is required');
-  const recipeService = ctx.container.get('recipeService');
+  const ks = ctx.container.get('knowledgeService');
   const usageType = args.usageType || 'adoption';
   const feedback = args.feedback || null;
 
-  await recipeService.incrementUsage(args.recipeId, usageType, {
+  await ks.incrementUsage(args.recipeId, usageType, {
     feedback,
     actor: 'mcp_user',
   });
@@ -146,7 +150,7 @@ export async function confirmUsage(ctx, args) {
   return envelope({
     success: true,
     data: { recipeId: args.recipeId, usageType, feedback },
-    message: `已记录 Recipe ${args.recipeId} 的${usageType === 'adoption' ? '采纳' : '应用'}`,
+    message: `已记录使用 ${args.recipeId} 的${usageType === 'adoption' ? '采纳' : '应用'}`,
     meta: { tool: 'autosnippet_confirm_usage' },
   });
 }