autosnippet 2.9.0 → 2.11.0

package/lib/external/ai/AiProvider.js

@@ -174,6 +174,67 @@ export class AiProvider {
       ? `\n# Code Structure Analysis (AST)\nThe following is a Tree-sitter AST analysis of the project. Use this structural context to better understand class hierarchies, design patterns, and code quality when extracting recipes:\n\n${options.astContext.substring(0, 3000)}\n`
       : '';
 
+    // comprehensive 模式：全量分析整个文件，不跳过任何有意义的方法
+    if (options.comprehensive) {
+      return `# Role
+You are a ${langProfile.role} performing a **comprehensive full-file analysis**.
+
+# Goal
+Thoroughly analyze ALL code in "${targetName}" and create Recipe entries for **every significant method, function, or code block**.
+This is a full-file analysis — do NOT skip methods just because they seem "simple" or "standard".
+${skillSection}${astSection}
+
+# What to extract
+- **Every** complete method/function with 5+ lines of implementation
+- Initialization and configuration methods (init, viewDidLoad, setup, configure)
+- Event handlers and action methods
+- Data processing and business logic
+- Protocol/delegate implementations
+- ANY code block that a developer might reference, learn from, or reuse
+
+# Extraction Rules
+- Extract **BROADLY** — include all meaningful code units, not just "clever" or "novel" patterns
+- Each recipe must be a **complete, standalone** code unit with full signature and body
+- Put the complete code in \`content.pattern\`, and a meaningful project writeup in \`content.markdown\`
+- Preserve the file's actual code. Use \`<#placeholder#>\` ONLY for literal strings/values a developer would customize
+- Every recipe must be traceable to real code in the file. Do NOT invent code
+- Include relevant \`headers\` (import/require lines) that the code depends on
+- You **MUST** extract at least ONE recipe — every source file has something worth capturing
+- For each recipe, provide a concise \`doClause\` (imperative sentence) and a \`topicHint\` group label
+
+${langProfile.extractionExamples}
+
+# Output (JSON Array)
+Each item MUST use the following V3 KnowledgeEntry structure:
+- title (string): Descriptive English name
+- description (string): 2-3 sentences explaining what this code does, written as a project-specific guide
+- trigger (string): @shortcut (kebab-case, e.g. "@url-parser")
+- kind (string): "rule" | "pattern" | "fact" — rule = always-do/never-do, pattern = reusable recipe with code, fact = reference info
+- knowledgeType (string): "code-pattern" | "architecture" | "api-usage" | "naming-convention" | "error-handling" | "performance" | "best-practice"
+- complexity (string): "basic" | "intermediate" | "advanced"
+- scope (string): "universal" | "project-specific" | "team-convention"
+- category: ${langProfile.categories}
+- language: "${langProfile.primaryLanguage}"
+- content (object): { "pattern": "<complete function/method/class from the file>", "markdown": "<project-specific writeup: what this pattern does, when to use it, key design decisions>", "rationale": "<why this pattern is designed this way — design trade-offs, alternatives considered>" }
+- reasoning (object): { "whyStandard": "<why this is a standard/best-practice worth following>", "sources": ["<source file names>"], "confidence": <0.0-1.0> }
+- headers (string[]): Required import/require lines
+- tags (string[]): Search keywords
+- doClause (string): One-sentence imperative: what to do (e.g. "Use dependency injection via constructor")
+- dontClause (string): What NOT to do (e.g. "Don't instantiate services with new directly")
+- whenClause (string): When this pattern applies (e.g. "When creating a new ViewController subclass")
+- topicHint (string): Group label for related patterns (e.g. "Networking", "UI-Layout", "Error-Handling")
+- coreCode (string): Minimal 3-10 line code skeleton that captures the essence
+- constraints (object, optional): { "preconditions": ["<conditions that must be true before using this pattern>"], "sideEffects": ["<observable side effects of using this code>"], "boundaries": ["<usage limitations or scope restrictions>"] }
+- aiInsight (string, optional): One-sentence concise insight — the single most important takeaway about this code pattern
+
+IMPORTANT: content.pattern must contain the COMPLETE source code. content.markdown must be a meaningful project-specific writeup, NOT just a copy of description. content.rationale must explain WHY this pattern is designed this way. reasoning.whyStandard must explain WHY this pattern matters.
+
+Return ONLY a JSON array. Do NOT return an empty array.
+
+Files Content:
+${files}`;
+    }
+
     return `# Role
 You are a ${langProfile.role} extracting production-quality reusable code patterns.
 
@@ -197,24 +258,37 @@ For each function/method/class in the file, ask: "Would a developer benefit from
 ${langProfile.extractionExamples}
 
 # Rules
-1. Each \`code\` field must contain a **complete function/method or logical unit** — include the signature and full body
-2. Preserve the file's actual code. Use \`<#placeholder#>\` ONLY for literal strings/values a developer would customize
-3. Every recipe must be traceable to real code in the file. Do NOT invent code
-4. Include relevant \`headers\` (import/require lines) that the code depends on
+1. \`content.pattern\` must contain a **complete function/method or logical unit** — include the signature and full body
+2. \`content.markdown\` must be a meaningful project-specific writeup explaining what this code does and when to use it
+3. Preserve the file's actual code. Use \`<#placeholder#>\` ONLY for literal strings/values a developer would customize
+4. Every recipe must be traceable to real code in the file. Do NOT invent code
+5. Include relevant \`headers\` (import/require lines) that the code depends on
+6. Every recipe must have a concise \`doClause\` and a \`topicHint\` group label
 
 # Output (JSON Array)
-Each item:
+Each item MUST use the following V3 KnowledgeEntry structure:
 - title (string): Descriptive English name
-- summary_cn (string): Chinese description
-- summary_en (string): English description
-- trigger (string): @shortcut
+- description (string): 2-3 sentences explaining what this code does, written as a project-specific guide
+- trigger (string): @shortcut (kebab-case, e.g. "@url-parser")
+- kind (string): "rule" | "pattern" | "fact" — rule = always-do/never-do, pattern = reusable recipe with code, fact = reference info
+- knowledgeType (string): "code-pattern" | "architecture" | "api-usage" | "naming-convention" | "error-handling" | "performance" | "best-practice"
+- complexity (string): "basic" | "intermediate" | "advanced"
+- scope (string): "universal" | "project-specific" | "team-convention"
 - category: ${langProfile.categories}
 - language: "${langProfile.primaryLanguage}"
-- code (string): Complete function/method/class from the file
+- content (object): { "pattern": "<complete function/method/class from the file>", "markdown": "<project-specific writeup: what this pattern does, when to use it, key design decisions>", "rationale": "<why this pattern is designed this way — design trade-offs, alternatives considered>" }
+- reasoning (object): { "whyStandard": "<why this is a standard/best-practice worth following>", "sources": ["<source file names>"], "confidence": <0.0-1.0> }
 - headers (string[]): Required import/require lines
 - tags (string[]): Search keywords
-- usageGuide_cn (string): "何时使用" + "关键要点" (2-3 lines)
-- usageGuide_en (string): "When to use" + "Key points" (2-3 lines)
+- doClause (string): One-sentence imperative: what to do (e.g. "Use dependency injection via constructor")
+- dontClause (string): What NOT to do (e.g. "Don't instantiate services with new directly")
+- whenClause (string): When this pattern applies (e.g. "When creating a new ViewController subclass")
+- topicHint (string): Group label (e.g. "Networking", "UI-Layout")
+- coreCode (string): Minimal 3-10 line code skeleton that captures the essence
+- constraints (object, optional): { "preconditions": ["<conditions that must be true before using this pattern>"], "sideEffects": ["<observable side effects of using this code>"], "boundaries": ["<usage limitations or scope restrictions>"] }
+- aiInsight (string, optional): One-sentence concise insight — the single most important takeaway about this code pattern
+
+IMPORTANT: content.pattern must contain the COMPLETE source code. content.markdown must be a meaningful project-specific writeup, NOT just a copy of description. content.rationale must explain WHY this pattern is designed this way. reasoning.whyStandard must explain WHY this pattern matters.
 
 Return ONLY a JSON array. If no meaningful patterns found, return [].
 

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 || '',
@@ -652,6 +652,22 @@ export async function fillDimensionsV3(fillContext) {
   // 释放文件缓存
   allFiles = null;
   chatAgent.setFileCache(null);
+
+  // ── Cursor Delivery: 生成 4 通道交付物料 ──
+  try {
+    const { getServiceContainer } = await import('../../../../../injection/ServiceContainer.js');
+    const container = getServiceContainer();
+    if (container.services.cursorDeliveryPipeline) {
+      const pipeline = container.get('cursorDeliveryPipeline');
+      const deliveryResult = await pipeline.deliver();
+      logger.info(`[Bootstrap-v3] 🚀 Cursor Delivery complete — ` +
+        `A: ${deliveryResult.channelA.rulesCount} rules, ` +
+        `B: ${deliveryResult.channelB.topicCount} topics, ` +
+        `C: ${deliveryResult.channelC.synced} skills`);
+    }
+  } catch (deliveryErr) {
+    logger.warn(`[Bootstrap-v3] Cursor Delivery failed (non-blocking): ${deliveryErr.message}`);
+  }
 }
 
 export { clearCheckpoints };

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.knowledgeType}
+语言: ${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.description) {
+        updateData.description = 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,69 @@
 /**
- * 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,
+    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,
+  };
+}
+
 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 +72,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 +81,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,
+    knowledgeType: json.knowledgeType,
     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,
+      guardHits: json.stats?.guardHits ?? 0,
+      views: json.stats?.views ?? 0,
+      searchHits: json.stats?.searchHits ?? 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?.codeChanges?.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,
+    createdBy: json.createdBy,
+    createdAt: json.createdAt,
+    updatedAt: json.updatedAt,
   };
 
   return envelope({ success: true, data: insights, meta: { tool: 'autosnippet_recipe_insights' } });
@@ -121,11 +124,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 +149,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' },
   });
 }