autosnippet 3.2.7 → 3.2.9

package/lib/service/{chat → agent/tools}/ToolRegistry.js

@@ -1,16 +1,16 @@
 /**
  * ToolRegistry — 统一工具注册表
  *
- * 管理 ChatAgent 可调用的所有工具定义。
+ * 管理 Agent 可调用的所有工具定义。
  * 每个工具包含: name, description, parameters(JSON Schema), handler
  *
  * 设计原则:
  * - 所有 AI 能力均封装为 Tool，不再散落在各处
  * - Tool handler 仅做参数整理 + 调用已有 Service，不含业务逻辑
- * - 支持 programmatic 直接调用 (executeTool) 和 Agent ReAct 循环调用
+ * - 支持 Agent ReAct 循环调用（通过 LLM 推理决定工具调用）
  */
 
-import Logger from '../../infrastructure/logging/Logger.js';
+import Logger from '../../../infrastructure/logging/Logger.js';
 
 /**
  * AI 模型常见的参数命名变体 → schema 标准名映射

package/lib/service/agent/tools/ai-analysis.js

@@ -0,0 +1,75 @@
+/**
+ * ai-analysis.js — AI 分析类工具 (2)
+ *
+ * 9. enrich_candidate            结构补齐
+ * 9b. refine_bootstrap_candidates 内容润色
+ *
+ * 注意: summarize_code / extract_recipes 已删除。
+ * 代码摘要和 Recipe 提取由 Agent LLM 直接推理完成，不再需要专用工具。
+ */
+
+// ────────────────────────────────────────────────────────────
+// 9. enrich_candidate
+// ────────────────────────────────────────────────────────────
+export const enrichCandidate = {
+  name: 'enrich_candidate',
+  description:
+    '① 结构补齐 — 自动填充缺失的结构性语义字段（rationale/knowledgeType/complexity/scope/steps/constraints）。批量处理，只填空不覆盖。建议在 refine_bootstrap_candidates 之前执行。',
+  parameters: {
+    type: 'object',
+    properties: {
+      candidateIds: {
+        type: 'array',
+        items: { type: 'string' },
+        description: '候选 ID 列表 (最多 20 个)',
+      },
+    },
+    required: ['candidateIds'],
+  },
+  handler: async (params, ctx) => {
+    if (!ctx.aiProvider) {
+      return { error: 'AI provider not available' };
+    }
+    // V3: 使用 MCP handler enrichCandidates 的逻辑
+    const { enrichCandidates: enrichFn } = await import('../../../external/mcp/handlers/candidate.js');
+    const result = await enrichFn(ctx, { candidateIds: params.candidateIds });
+    return result?.data || result;
+  },
+};
+
+// ────────────────────────────────────────────────────────────
+// 9b. refine_bootstrap_candidates (Phase 6)
+// ────────────────────────────────────────────────────────────
+export const refineBootstrapCandidates = {
+  name: 'refine_bootstrap_candidates',
+  description:
+    '② 内容润色 — 逐条精炼 Bootstrap 候选的内容质量：改善 summary、补充架构 insight、推断 relations 关联、调整 confidence、丰富 tags。建议在 enrich_candidate 之后执行。',
+  parameters: {
+    type: 'object',
+    properties: {
+      candidateIds: {
+        type: 'array',
+        items: { type: 'string' },
+        description: '指定候选 ID 列表（可选，默认全部 bootstrap 候选）',
+      },
+      userPrompt: {
+        type: 'string',
+        description: '用户自定义润色提示词，指导 AI 润色方向（如"侧重描述线程安全注意事项"）',
+      },
+      dryRun: { type: 'boolean', description: '仅预览 AI 润色结果，不写入数据库' },
+    },
+  },
+  handler: async (params, ctx) => {
+    if (!ctx.aiProvider) {
+      return { error: 'AI provider not available' };
+    }
+    // V3: 委托给 bootstrap handler 的 refine 逻辑
+    const { bootstrapRefine } = await import('../../../external/mcp/handlers/bootstrap-internal.js');
+    const result = await bootstrapRefine(ctx, {
+      candidateIds: params.candidateIds,
+      userPrompt: params.userPrompt,
+      dryRun: params.dryRun,
+    });
+    return result?.data || result;
+  },
+};

package/lib/service/{chat → agent}/tools/ast-graph.js

@@ -1,16 +1,17 @@
 /**
- * ast-graph.js — AST 结构化分析 + Agent Memory 工具 (10)
+ * ast-graph.js — AST 结构化分析 + Agent Memory 工具 (11)
  *
  * 44. get_project_overview  项目 AST 概览
  * 45. get_class_hierarchy   类继承层级
- * 46. get_class_info        类详细信息
- * 47. get_protocol_info     协议详细信息
+ * 46. get_class_info        类/结构体详细信息 (跨语言)
+ * 47. get_protocol_info     协议/接口/trait 详细信息 (跨语言)
  * 48. get_method_overrides  方法覆写查询
- * 49. get_category_map      Category 扩展映射
+ * 49. get_category_map      Category/Extension 扩展映射
  * 50. get_previous_analysis 前序维度分析结果
  * 51. note_finding          记录关键发现
  * 52. get_previous_evidence 检索前序维度证据
  * 53. query_code_graph      查询代码实体图谱
+ * 54. query_call_graph      查询方法调用链 (Phase 5)
  */
 
 // ════════════════════════════════════════════════════════════
@@ -36,7 +37,8 @@ function _getProjectGraph(ctx) {
 export const getProjectOverview = {
   name: 'get_project_overview',
   description:
-    '获取项目的整体结构概览：文件统计、模块列表、入口点、类/协议/Category 数量。' +
+    '获取项目的整体结构概览：文件统计、语言分布、模块列表、入口点、类/协议/Category 数量。' +
+    '支持所有语言 (Swift/ObjC/Java/Kotlin/Python/TS/JS/Dart/Rust/Go 等)。' +
     '适用场景：了解项目规模和架构布局，规划探索路径。',
   parameters: {
     type: 'object',
@@ -49,13 +51,30 @@ export const getProjectOverview = {
     }
 
     const o = graph.getOverview();
+
+    // §P2: 从文件扩展名统计语言分布
+    const langStats = {};
+    for (const filePath of graph.getAllFilePaths?.() || []) {
+      const ext = filePath.split('.').pop();
+      if (ext) langStats[ext] = (langStats[ext] || 0) + 1;
+    }
+
     const lines = [
       `📊 项目 AST 概览 (构建耗时 ${o.buildTimeMs}ms)`,
       ``,
-      `文件: ${o.totalFiles} | 类: ${o.totalClasses} | 协议: ${o.totalProtocols} | Category: ${o.totalCategories} | 方法: ${o.totalMethods}`,
-      ``,
-      `── 模块 ──`,
+      `文件: ${o.totalFiles} | 类: ${o.totalClasses} | 协议/接口: ${o.totalProtocols} | Category/Extension: ${o.totalCategories} | 方法: ${o.totalMethods}`,
     ];
+
+    // 语言分布
+    const langEntries = Object.entries(langStats).sort((a, b) => b[1] - a[1]);
+    if (langEntries.length > 0) {
+      lines.push(``, `── 语言分布 ──`);
+      for (const [ext, count] of langEntries) {
+        lines.push(`  .${ext}: ${count} 个文件`);
+      }
+    }
+
+    lines.push(``, `── 模块 ──`);
     for (const mod of o.topLevelModules) {
       const count = o.classesPerModule[mod] || 0;
       lines.push(`  ${mod}/ — ${count} 个类`);
@@ -76,7 +95,8 @@ export const getProjectOverview = {
 export const getClassHierarchy = {
   name: 'get_class_hierarchy',
   description:
-    '查看指定类的继承链（向上到根类）和直接子类列表。' +
+    '查看指定类/结构体的继承链（向上到根类）和直接子类列表。' +
+    '支持所有语言的类继承体系 (Swift class/struct, Java/Kotlin class, Python class, TS class, Dart class, Rust struct, Go struct 等)。' +
     '传入 className 查看指定类，不传则返回项目中所有根类及其子树。',
   parameters: {
     type: 'object',
@@ -138,7 +158,9 @@ export const getClassHierarchy = {
 // ────────────────────────────────────────────────────────────
 export const getClassInfo = {
   name: 'get_class_info',
-  description: '获取指定类的详细信息: 属性、方法签名、导入、继承关系、Category 扩展。',
+  description:
+    '获取指定类/结构体的详细信息: 属性、方法签名、导入、继承关系、扩展。' +
+    '跨语言通用：ObjC @interface, Swift class/struct, Java/Kotlin class, Python class, TS/JS class, Dart class, Rust struct impl, Go struct 等。',
   parameters: {
     type: 'object',
     properties: {
@@ -169,7 +191,7 @@ export const getClassInfo = {
     ];
 
     if (info.protocols.length > 0) {
-      lines.push(`遵循: <${info.protocols.join(', ')}>`);
+      lines.push(`实现: ${info.protocols.join(', ')}`);
     }
 
     if (info.properties.length > 0) {
@@ -195,7 +217,7 @@ export const getClassInfo = {
     }
 
     if (cats.length > 0) {
-      lines.push(``, `── Category 扩展 (${cats.length}) ──`);
+      lines.push(``, `── 扩展 (${cats.length}) ──`);
       for (const cat of cats) {
         const methodNames = cat.methods.map((m) => m.selector).join(', ');
         lines.push(`  ${info.name}(${cat.categoryName}) — ${cat.filePath} — [${methodNames}]`);
@@ -218,7 +240,9 @@ export const getClassInfo = {
 // ────────────────────────────────────────────────────────────
 export const getProtocolInfo = {
   name: 'get_protocol_info',
-  description: '获取指定协议的定义（必选/可选方法）及所有遵循该协议的类。',
+  description:
+    '获取指定协议/接口/trait 的定义（必选/可选方法）及所有实现者列表。' +
+    '跨语言通用：ObjC @protocol, Swift protocol, Java/Kotlin interface, Python ABC, TS interface, Dart abstract class, Rust trait, Go interface 等。',
   parameters: {
     type: 'object',
     properties: {
@@ -235,36 +259,36 @@ export const getProtocolInfo = {
     const protocolName = params.protocolName || params.protocol_name;
     const info = graph.getProtocolInfo(protocolName);
     if (!info) {
-      return `未找到协议 "${protocolName}"。可以使用 get_project_overview 查看项目中的所有协议。`;
+      return `未找到协议/接口 "${protocolName}"。可以使用 get_project_overview 查看项目中的所有协议/接口。`;
     }
 
-    const lines = [`📋 @protocol ${info.name}`, `文件: ${info.filePath}:${info.line}`];
+    const lines = [`📋 ${info.name}`, `文件: ${info.filePath}:${info.line}`];
 
     if (info.inherits.length > 0) {
-      lines.push(`继承: <${info.inherits.join(', ')}>`);
+      lines.push(`继承: ${info.inherits.join(', ')}`);
     }
 
     if (info.requiredMethods.length > 0) {
-      lines.push(``, `── @required (${info.requiredMethods.length}) ──`);
+      lines.push(``, `── 必须实现 (${info.requiredMethods.length}) ──`);
       for (const m of info.requiredMethods) {
         lines.push(`  ${m.isClassMethod ? '+' : '-'} ${m.selector} → ${m.returnType}`);
       }
     }
 
     if (info.optionalMethods.length > 0) {
-      lines.push(``, `── @optional (${info.optionalMethods.length}) ──`);
+      lines.push(``, `── 可选实现 (${info.optionalMethods.length}) ──`);
       for (const m of info.optionalMethods) {
         lines.push(`  ${m.isClassMethod ? '+' : '-'} ${m.selector} → ${m.returnType}`);
       }
     }
 
     if (info.conformers.length > 0) {
-      lines.push(``, `── 遵循者 (${info.conformers.length}) ──`);
+      lines.push(``, `── 实现者 (${info.conformers.length}) ──`);
       for (const c of info.conformers) {
         lines.push(`  ${c}`);
       }
     } else {
-      lines.push(``, `⚠️ 暂未发现遵循此协议的类`);
+      lines.push(``, `⚠️ 暂未发现实现此协议/接口的类`);
     }
 
     return lines.join('\n');
@@ -276,7 +300,9 @@ export const getProtocolInfo = {
 // ────────────────────────────────────────────────────────────
 export const getMethodOverrides = {
   name: 'get_method_overrides',
-  description: '查找覆写了指定方法的所有子类。适用于理解方法在继承树中的多态行为。',
+  description:
+    '查找覆写了指定方法的所有子类。适用于理解方法在继承树中的多态行为。' +
+    '跨语言通用：支持 ObjC/Swift/Java/Kotlin/Python/TS/Dart 等语言的方法覆写。',
   parameters: {
     type: 'object',
     properties: {
@@ -314,7 +340,9 @@ export const getMethodOverrides = {
 export const getCategoryMap = {
   name: 'get_category_map',
   description:
-    '获取指定类或整个项目的 ObjC Category 扩展映射。Category 是 ObjC 的核心模式，了解它有助于发现功能划分。',
+    '获取指定类的 Category/Extension 扩展映射。' +
+    'ObjC Category、Swift Extension 等语言的类扩展机制。了解它有助于发现功能划分。' +
+    '不传 className 则返回整个项目中有扩展的类列表。',
   parameters: {
     type: 'object',
     properties: {
@@ -455,7 +483,9 @@ export const noteFinding = {
     const coordinator = ctx._memoryCoordinator;
     if (coordinator) {
       const finding = params.finding || '';
-      const evidence = params.evidence || '';
+      // P0 Fix: AI 可能传入 array/object，强制转为 string
+      const rawEvidence = params.evidence;
+      const evidence = typeof rawEvidence === 'string' ? rawEvidence : Array.isArray(rawEvidence) ? rawEvidence.join(', ') : rawEvidence ? String(rawEvidence) : '';
       const importance = params.importance || 5;
       const round = ctx._currentRound || 0;
       const scopeId = ctx._dimensionScopeId || undefined;
@@ -547,8 +577,8 @@ export const queryCodeGraph = {
       },
       entity_type: {
         type: 'string',
-        enum: ['class', 'protocol', 'category', 'module', 'pattern'],
-        description: '实体类型过滤 (可选)',
+        enum: ['class', 'protocol', 'category', 'module', 'pattern', 'method'],
+        description: '实体类型过滤 (可选，含 Phase 5 method 类型)',
       },
       max_depth: {
         type: 'number',
@@ -559,14 +589,17 @@ export const queryCodeGraph = {
   },
   handler: async (params, ctx) => {
     try {
-      const { CodeEntityGraph } = await import('../../knowledge/CodeEntityGraph.js');
-      const db = ctx?.container?.get('database');
-      if (!db) {
-        return '代码实体图谱不可用: 数据库未初始化';
+      // 优先从 container 获取单例 CEG，避免每次创建新实例
+      let ceg = ctx?.container?.get?.('codeEntityGraph');
+      if (!ceg) {
+        const { CodeEntityGraph } = await import('../../knowledge/CodeEntityGraph.js');
+        const db = ctx?.container?.get?.('database');
+        if (!db) {
+          return '代码实体图谱不可用: 数据库未初始化';
+        }
+        const projectRoot = ctx?.projectRoot || process.env.ASD_PROJECT_DIR || '';
+        ceg = new CodeEntityGraph(db, { projectRoot });
       }
-
-      const projectRoot = ctx?.projectRoot || process.env.ASD_PROJECT_DIR || '';
-      const ceg = new CodeEntityGraph(db, { projectRoot });
       const maxDepth = params.max_depth || 3;
 
       switch (params.action) {
@@ -680,3 +713,167 @@ export const queryCodeGraph = {
     }
   },
 };
+
+// ────────────────────────────────────────────────────────────
+// 54. query_call_graph — 查询方法调用链 (Phase 5)
+// ────────────────────────────────────────────────────────────
+export const queryCallGraph = {
+  name: 'query_call_graph',
+  description:
+    '查询方法的调用链上下文 (Call Graph)。支持 10+ 种编程语言 (Swift/ObjC/Java/Kotlin/Python/TS/JS/Dart/Rust/Go)。\n' +
+    '• callers: 谁调用了这个方法？(向上追踪调用者链)\n' +
+    '• callees: 这个方法调用了谁？(向下追踪依赖链)\n' +
+    '• both: 同时获取调用者和被调用者\n' +
+    '• impact: 修改此方法的影响半径分析 (受影响文件数)\n' +
+    '• search: 按名称搜索方法实体\n' +
+    '⚠️ 需要先完成 bootstrap 才有数据。方法名格式: "ClassName.methodName" 或简写 "methodName"。',
+  parameters: {
+    type: 'object',
+    properties: {
+      methodName: {
+        type: 'string',
+        description:
+          '方法名 (e.g. "UserService.getUser", "viewDidLoad", "handleClick")。' +
+          'search 模式下为搜索关键词。',
+      },
+      direction: {
+        type: 'string',
+        enum: ['callers', 'callees', 'both', 'impact', 'search'],
+        description:
+          'callers=调用者 | callees=被调用者 | both=双向 | impact=影响分析 | search=搜索方法实体',
+      },
+      maxDepth: {
+        type: 'number',
+        description: '最大遍历深度 (1-5, 默认 2)',
+      },
+    },
+    required: ['methodName'],
+  },
+  handler: async (params, ctx) => {
+    try {
+      // 前置: 必填参数校验 (fail-fast)
+      const methodName = params.methodName || params.method_name;
+      if (!methodName) {
+        return '请提供 methodName 参数。';
+      }
+
+      // 优先从 container 获取单例 CEG，避免每次创建新实例
+      let ceg = ctx?.container?.get?.('codeEntityGraph');
+      if (!ceg) {
+        // fallback: 手动构建
+        const { CodeEntityGraph } = await import('../../knowledge/CodeEntityGraph.js');
+        const db = ctx?.container?.get?.('database');
+        if (!db) {
+          return '调用图查询不可用: 数据库未初始化。';
+        }
+        const projectRoot = ctx?.projectRoot || process.env.ASD_PROJECT_DIR || '';
+        ceg = new CodeEntityGraph(db, { projectRoot });
+      }
+
+      const direction = params.direction || 'both';
+      const maxDepth = Math.min(Math.max(Number(params.maxDepth || params.max_depth) || 2, 1), 5);
+
+      // search 模式: 按名称搜索方法实体
+      if (direction === 'search') {
+        const results = ceg.searchEntities(methodName, { type: 'method', limit: 15 });
+        if (results.length === 0) {
+          // 降级: 不限类型搜索
+          const allResults = ceg.searchEntities(methodName, { limit: 15 });
+          if (allResults.length === 0) {
+            return `未找到匹配 "${methodName}" 的实体。请确认 bootstrap 已完成。`;
+          }
+          const lines = [`🔍 搜索 "${methodName}" (${allResults.length} 条, 无 method 类型匹配):`];
+          for (const e of allResults) {
+            lines.push(`  • [${e.entityType}] ${e.name}${e.filePath ? ` (${e.filePath})` : ''}`);
+          }
+          lines.push(``, `💡 提示: 调用图查询需使用 method 实体的 entityId。`);
+          return lines.join('\n');
+        }
+        const lines = [`🔍 方法搜索 "${methodName}" (${results.length} 条):`];
+        for (const e of results) {
+          lines.push(`  • ${e.name}${e.filePath ? ` (${e.filePath})` : ''}`);
+        }
+        lines.push(``, `💡 复制上面的完整方法名，用 callers/callees/both/impact 查询其调用链。`);
+        return lines.join('\n');
+      }
+
+      // impact 模式
+      if (direction === 'impact') {
+        const impact = ceg.getCallImpactRadius(methodName);
+        const lines = [
+          `⚡ 修改 "${methodName}" 的影响半径:`,
+          `  直接调用者: ${impact.directCallers}`,
+          `  传递性调用者 (depth≤3): ${impact.transitiveCallers}`,
+        ];
+        if (impact.affectedFiles.length > 0) {
+          lines.push(`  受影响文件 (${impact.affectedFiles.length}):`);
+          for (const f of impact.affectedFiles.slice(0, 15)) {
+            lines.push(`    📄 ${f}`);
+          }
+          if (impact.affectedFiles.length > 15) {
+            lines.push(`    ... 还有 ${impact.affectedFiles.length - 15} 个文件`);
+          }
+        } else {
+          lines.push(`  未发现受影响文件 (可能是叶子方法或 bootstrap 无调用图数据)。`);
+        }
+        return lines.join('\n');
+      }
+
+      // callers / callees / both 模式
+      const result = {};
+      if (direction === 'callers' || direction === 'both') {
+        result.callers = ceg.getCallers(methodName, maxDepth);
+      }
+      if (direction === 'callees' || direction === 'both') {
+        result.callees = ceg.getCallees(methodName, maxDepth);
+      }
+
+      const totalCallers = result.callers?.length || 0;
+      const totalCallees = result.callees?.length || 0;
+
+      if (totalCallers === 0 && totalCallees === 0) {
+        return (
+          `"${methodName}" 在调用图中没有找到调用关系。\n\n` +
+          `可能原因:\n` +
+          `  1. 方法名拼写不匹配 — 尝试 search 模式: query_call_graph({methodName:"关键词", direction:"search"})\n` +
+          `  2. 该方法是入口点/叶子节点，无上下游\n` +
+          `  3. bootstrap 尚未执行或不包含此文件`
+        );
+      }
+
+      const lines = [`📞 "${methodName}" 的调用链 (depth≤${maxDepth}):`];
+
+      if (result.callers?.length > 0) {
+        lines.push(``, `── 调用者 (谁调用了它, ${result.callers.length} 条) ──`);
+        for (const c of result.callers.slice(0, 20)) {
+          const indent = '  '.repeat(c.depth);
+          const typeTag = c.callType !== 'unknown' ? ` [${c.callType}]` : '';
+          lines.push(`${indent}⬆ ${c.caller}${typeTag}`);
+        }
+        if (result.callers.length > 20) {
+          lines.push(`  ... 还有 ${result.callers.length - 20} 个调用者`);
+        }
+      }
+
+      if (result.callees?.length > 0) {
+        lines.push(``, `── 被调用者 (它调用了谁, ${result.callees.length} 条) ──`);
+        for (const c of result.callees.slice(0, 20)) {
+          const indent = '  '.repeat(c.depth);
+          const typeTag = c.callType !== 'unknown' ? ` [${c.callType}]` : '';
+          lines.push(`${indent}⬇ ${c.callee}${typeTag}`);
+        }
+        if (result.callees.length > 20) {
+          lines.push(`  ... 还有 ${result.callees.length - 20} 个被调用者`);
+        }
+      }
+
+      return lines.join('\n');
+    } catch (err) {
+      // 表不存在 → 未 bootstrap
+      if (err.message?.includes('no such table')) {
+        return '调用图数据不可用 — knowledge_edges 表不存在，请先运行 bootstrap。';
+      }
+      return `调用图查询失败: ${err.message}`;
+    }
+  },
+};

package/lib/service/{chat → agent}/tools/composite.js

@@ -160,7 +160,7 @@ export const submitWithCheck = {
       content: {
         type: 'object',
         description:
-          '{ markdown: "项目特写 Markdown", pattern: "核心代码 3-8 行，必须语法完整（括号配对、不能以 } 开头或 { 结尾）" }',
+          '{ markdown: "项目特写 Markdown (≥200字符,含代码块)", rationale: "设计原理说明 (必填)", pattern: "核心代码 3-8 行，语法完整" }',
       },
       title: { type: 'string', description: '候选标题' },
       description: { type: 'string', description: '中文简述 ≤80 字' },
@@ -234,6 +234,7 @@ export const submitWithCheck = {
         ctx.logger?.info(`[submit_with_check] ✗ validator rejected: ${validResult.errors.join('; ')}`);
         return {
           submitted: false,
+          status: 'rejected',
           reason: 'validation_failed',
           errors: validResult.errors,
           warnings: validResult.warnings,

package/lib/service/{chat → agent}/tools/guard.js

@@ -1,12 +1,10 @@
 /**
- * guard.js — Guard 安全类工具 (6)
+ * guard.js — Guard 安全类工具 (4)
  *
  * 7b. list_guard_rules    列出 Guard 规则
  * 8b. get_recommendations 获取推荐 Recipe
- * 12. ai_translate        AI 翻译
  * 13. guard_check_code    Guard 检查代码
  * 14. query_violations    查询违规历史
- * 15. generate_guard_rule AI 生成 Guard 规则
  */
 
 // ────────────────────────────────────────────────────────────
@@ -75,46 +73,6 @@ export const getRecommendations = {
   },
 };
 
-// ────────────────────────────────────────────────────────────
-// 12. ai_translate
-// ────────────────────────────────────────────────────────────
-export const aiTranslate = {
-  name: 'ai_translate',
-  description: 'AI 翻译 — 将中文 summary/usageGuide 翻译为英文。',
-  parameters: {
-    type: 'object',
-    properties: {
-      summary: { type: 'string', description: '中文摘要' },
-      usageGuide: { type: 'string', description: '中文使用指南' },
-    },
-  },
-  handler: async (params, ctx) => {
-    if (!ctx.aiProvider) {
-      return { error: 'AI provider not available' };
-    }
-    const { summary, usageGuide } = params;
-    if (!summary && !usageGuide) {
-      return { summaryEn: '', usageGuideEn: '' };
-    }
-
-    const systemPrompt =
-      'You are a technical translator. Translate from Chinese to English. Keep technical terms unchanged. Return ONLY valid JSON: { "summaryEn": "...", "usageGuideEn": "..." }.';
-    const parts = [];
-    if (summary) {
-      parts.push(`summary: ${summary}`);
-    }
-    if (usageGuide) {
-      parts.push(`usageGuide: ${usageGuide}`);
-    }
-
-    const parsed = await ctx.aiProvider.chatWithStructuredOutput(parts.join('\n'), {
-      systemPrompt,
-      temperature: 0.2,
-    });
-    return parsed || { summaryEn: summary || '', usageGuideEn: usageGuide || '' };
-  },
-};
-
 // ────────────────────────────────────────────────────────────
 // 13. guard_check_code
 // ────────────────────────────────────────────────────────────
@@ -184,82 +142,4 @@ export const queryViolations = {
   },
 };
 
-// ────────────────────────────────────────────────────────────
-// 15. generate_guard_rule
-// ────────────────────────────────────────────────────────────
-export const generateGuardRule = {
-  name: 'generate_guard_rule',
-  description: 'AI 生成 Guard 规则 — 描述你想阻止的代码模式，AI 自动生成正则表达式和规则定义。',
-  parameters: {
-    type: 'object',
-    properties: {
-      description: {
-        type: 'string',
-        description: '规则描述（例如 "禁止在主线程使用同步网络请求"）',
-      },
-      language: { type: 'string', description: '目标语言 (swift/objc 等)' },
-      severity: { type: 'string', description: '严重程度 (error/warning/info)，默认 warning' },
-      autoCreate: { type: 'boolean', description: '是否自动创建到数据库，默认 false' },
-    },
-    required: ['description'],
-  },
-  handler: async (params, ctx) => {
-    if (!ctx.aiProvider) {
-      return { error: 'AI provider not available' };
-    }
-    const { description, language = 'swift', severity = 'warning', autoCreate = false } = params;
-
-    const prompt = `Generate a Guard rule for this requirement:
-Description: ${description}
-Language: ${language}
-Severity: ${severity}
-
-Return ONLY valid JSON:
-{
-  "name": "rule-name-kebab-case",
-  "description": "One-line description in English",
-  "description_cn": "一行中文描述",
-  "pattern": "regex pattern for matching the problematic code",
-  "languages": ["${language}"],
-  "severity": "${severity}",
-  "testCases": {
-    "shouldMatch": ["code example that should trigger"],
-    "shouldNotMatch": ["code example that should NOT trigger"]
-  }
-}`;
-
-    const rule = await ctx.aiProvider.chatWithStructuredOutput(prompt, { temperature: 0.2 });
-    if (!rule) {
-      return { error: 'Failed to parse AI response' };
-    }
 
-    // 验证正则表达式
-    try {
-      new RegExp(rule.pattern);
-    } catch (e) {
-      return { error: `Invalid regex pattern: ${e.message}`, rule };
-    }
-
-    // 自动创建
-    if (autoCreate && rule.name && rule.pattern) {
-      try {
-        const guardService = ctx.container.get('guardService');
-        const created = await guardService.createRule(
-          {
-            name: rule.name,
-            description: rule.description || description,
-            pattern: rule.pattern,
-            languages: rule.languages || [language],
-            severity: rule.severity || severity,
-          },
-          { userId: 'agent' }
-        );
-        return { rule, created: true, recipeId: created.id };
-      } catch (err) {
-        return { rule, created: false, error: err.message };
-      }
-    }
-
-    return { rule, created: false };
-  },
-};