autosnippet 3.2.8 → 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/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 };
-  },
-};

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

@@ -4,12 +4,10 @@
  * 从各子模块导入所有工具，按原始顺序组装 ALL_TOOLS 数组并导出。
  */
 
-// ── AI 分析类 (4) ──
+// ── AI 分析类 (2) ──
 import {
   enrichCandidate,
-  extractRecipes,
   refineBootstrapCandidates,
-  summarizeCode,
 } from './ai-analysis.js';
 // ── AST 结构化分析 + Agent Memory (11) ──
 import {
@@ -35,10 +33,8 @@ import {
   submitWithCheck,
 } from './composite.js';
 
-// ── Guard 安全类 (6) ──
+// ── Guard 安全类 (4) ──
 import {
-  aiTranslate,
-  generateGuardRule,
   getRecommendations,
   guardCheckCode,
   listGuardRules,
@@ -54,8 +50,16 @@ import {
   rebuildIndex,
   suggestSkills,
 } from './infrastructure.js';
-// ── 知识图谱类 (3) ──
-import { addGraphEdge, checkDuplicate, discoverRelations } from './knowledge-graph.js';
+// ── 知识图谱类 (2) ──
+import { addGraphEdge, checkDuplicate } from './knowledge-graph.js';
+// ── 扫描 Recipe 收集 (1) ──
+import { collectScanRecipe } from './scan-recipe.js';
+// ── 系统交互类 (3) ──
+import {
+  getEnvironmentInfo,
+  runSafeCommand,
+  writeProjectFile,
+} from './system-interaction.js';
 // ── 生命周期操作类 (11) ──
 import {
   approveCandidate,
@@ -104,20 +108,15 @@ export {
   searchKnowledge,
   getRelatedRecipes,
   // AI 分析类
-  summarizeCode,
-  extractRecipes,
   enrichCandidate,
   refineBootstrapCandidates,
   // Guard 安全类
   listGuardRules,
   getRecommendations,
-  aiTranslate,
   guardCheckCode,
   queryViolations,
-  generateGuardRule,
   // 知识图谱类
   checkDuplicate,
-  discoverRelations,
   addGraphEdge,
   // 生命周期操作类
   submitCandidate,
@@ -161,6 +160,12 @@ export {
   queryCodeGraph,
   // 调用图查询 (Phase 5)
   queryCallGraph,
+  // 扫描 Recipe 收集
+  collectScanRecipe,
+  // 系统交互类
+  runSafeCommand,
+  writeProjectFile,
+  getEnvironmentInfo,
 };
 
 // ── ALL_TOOLS 数组（与原始 tools.js 顺序一致）──
@@ -180,16 +185,12 @@ export const ALL_TOOLS = [
   getRelatedRecipes,
   listGuardRules,
   getRecommendations,
-  // AI 分析类 (5)
-  summarizeCode,
-  extractRecipes,
+  // AI 分析类 (2)
   enrichCandidate,
   refineBootstrapCandidates,
-  aiTranslate,
-  // Guard 安全类 (3)
+  // Guard 安全类 (2)
   guardCheckCode,
   queryViolations,
-  generateGuardRule,
   // 生命周期操作类 (7)
   submitCandidate,
   saveDocument,
@@ -203,9 +204,8 @@ export const ALL_TOOLS = [
   qualityScore,
   validateCandidate,
   getFeedbackStats,
-  // 知识图谱类 (3)
+  // 知识图谱类 (2)
   checkDuplicate,
-  discoverRelations,
   addGraphEdge,
   // 基础设施类 (3)
   graphImpactAnalysis,
@@ -239,6 +239,12 @@ export const ALL_TOOLS = [
   queryCodeGraph,
   // 调用图查询 (1) — Phase 5
   queryCallGraph,
+  // 系统交互 (3) — Agent 终端/文件写入/环境探测
+  runSafeCommand,
+  writeProjectFile,
+  getEnvironmentInfo,
+  // 扫描 Recipe 收集 (1) — scanKnowledge produce 阶段专用
+  collectScanRecipe,
 ];
 
 export default ALL_TOOLS;

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

@@ -157,7 +157,7 @@ export const createSkillTool = {
   },
   handler: async (params, ctx) => {
     const { createSkill } = await import('../../../external/mcp/handlers/skill.js');
-    // 根据 ChatAgent 的 source 推断 createdBy
+    // 根据 Agent 的 source 推断 createdBy
     const createdBy = ctx?.source === 'system' ? 'system-ai' : 'user-ai';
     const raw = createSkill(null, { ...params, createdBy });
     try {

package/lib/service/agent/tools/knowledge-graph.js

@@ -0,0 +1,112 @@
+/**
+ * knowledge-graph.js — 知识图谱类工具 (2)
+ *
+ * 10. check_duplicate     候选查重
+ * 12. add_graph_edge      手动添加图谱边
+ *
+ * 注意: discover_relations 已删除。
+ * 关系发现由 Agent LLM 直接推理完成，利用通用工具（search_knowledge, query_code_graph 等）。
+ */
+
+import { findSimilarRecipes } from '../../candidate/SimilarityService.js';
+
+// ────────────────────────────────────────────────────────────
+// 10. check_duplicate
+// ────────────────────────────────────────────────────────────
+export const checkDuplicate = {
+  name: 'check_duplicate',
+  description:
+    '候选查重 — 检测候选代码是否与已有 Recipe 重复（基于标题/摘要/代码的 Jaccard 相似度）。',
+  parameters: {
+    type: 'object',
+    properties: {
+      candidate: { type: 'object', description: '候选对象 { title, summary, code, usageGuide }' },
+      candidateId: { type: 'string', description: '或提供候选 ID，从数据库读取' },
+      projectRoot: { type: 'string', description: '项目根目录（可选，默认当前项目）' },
+      threshold: { type: 'number', description: '相似度阈值，默认 0.5' },
+    },
+  },
+  handler: async (params, ctx) => {
+    let cand = params.candidate;
+    const projectRoot = params.projectRoot || ctx.projectRoot;
+    const threshold = params.threshold ?? 0.5;
+
+    // 如果提供 candidateId，从数据库读取条目信息
+    if (!cand && params.candidateId) {
+      try {
+        const knowledgeService = ctx.container.get('knowledgeService');
+        const found = await knowledgeService.get(params.candidateId);
+        if (found) {
+          const json = typeof found.toJSON === 'function' ? found.toJSON() : found;
+          cand = {
+            title: json.title || '',
+            summary: json.description || '',
+            code: json.content?.pattern || '',
+            usageGuide: '',
+          };
+        }
+      } catch {
+        /* ignore */
+      }
+    }
+
+    if (!cand) {
+      return { similar: [], message: 'No candidate provided' };
+    }
+
+    const similar = findSimilarRecipes(projectRoot, cand, {
+      threshold,
+      topK: 10,
+    });
+
+    return {
+      similar,
+      hasDuplicate: similar.some((s) => s.similarity >= 0.7),
+      highestSimilarity: similar.length > 0 ? similar[0].similarity : 0,
+      _meta: {
+        confidence: similar.length === 0 ? 'none' : similar[0].similarity >= 0.7 ? 'high' : 'low',
+        hint:
+          similar.length === 0
+            ? '未发现相似 Recipe，可放心提交。'
+            : similar[0].similarity >= 0.7
+              ? '发现高度相似 Recipe，建议人工审核是否重复。'
+              : '有低相似度匹配，大概率不是重复。',
+      },
+    };
+  },
+};
+
+// ────────────────────────────────────────────────────────────
+// 12. add_graph_edge
+// ────────────────────────────────────────────────────────────
+export const addGraphEdge = {
+  name: 'add_graph_edge',
+  description: '手动添加知识图谱关系边（从 A 到 B 的关系）。',
+  parameters: {
+    type: 'object',
+    properties: {
+      fromId: { type: 'string', description: '源节点 ID' },
+      fromType: { type: 'string', description: '源节点类型 (recipe/candidate)' },
+      toId: { type: 'string', description: '目标节点 ID' },
+      toType: { type: 'string', description: '目标节点类型 (recipe/candidate)' },
+      relation: {
+        type: 'string',
+        description:
+          '关系类型 (requires/extends/enforces/depends_on/inherits/implements/calls/prerequisite)',
+      },
+      weight: { type: 'number', description: '权重 0-1，默认 1.0' },
+    },
+    required: ['fromId', 'fromType', 'toId', 'toType', 'relation'],
+  },
+  handler: async (params, ctx) => {
+    const kgService = ctx.container.get('knowledgeGraphService');
+    return kgService.addEdge(
+      params.fromId,
+      params.fromType,
+      params.toId,
+      params.toType,
+      params.relation,
+      { weight: params.weight || 1.0, source: 'manual' }
+    );
+  },
+};