autosnippet 3.2.7 → 3.2.9

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

@@ -4,14 +4,12 @@
  * 从各子模块导入所有工具，按原始顺序组装 ALL_TOOLS 数组并导出。
  */
 
-// ── AI 分析类 (4) ──
+// ── AI 分析类 (2) ──
 import {
   enrichCandidate,
-  extractRecipes,
   refineBootstrapCandidates,
-  summarizeCode,
 } from './ai-analysis.js';
-// ── AST 结构化分析 + Agent Memory (10) ──
+// ── AST 结构化分析 + Agent Memory (11) ──
 import {
   getCategoryMap,
   getClassHierarchy,
@@ -22,6 +20,7 @@ import {
   getProjectOverview,
   getProtocolInfo,
   noteFinding,
+  queryCallGraph,
   queryCodeGraph,
 } from './ast-graph.js';
 // ── 组合工具 + 元工具 (6) ──
@@ -34,10 +33,8 @@ import {
   submitWithCheck,
 } from './composite.js';
 
-// ── Guard 安全类 (6) ──
+// ── Guard 安全类 (4) ──
 import {
-  aiTranslate,
-  generateGuardRule,
   getRecommendations,
   guardCheckCode,
   listGuardRules,
@@ -53,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,
@@ -103,20 +108,15 @@ export {
   searchKnowledge,
   getRelatedRecipes,
   // AI 分析类
-  summarizeCode,
-  extractRecipes,
   enrichCandidate,
   refineBootstrapCandidates,
   // Guard 安全类
   listGuardRules,
   getRecommendations,
-  aiTranslate,
   guardCheckCode,
   queryViolations,
-  generateGuardRule,
   // 知识图谱类
   checkDuplicate,
-  discoverRelations,
   addGraphEdge,
   // 生命周期操作类
   submitCandidate,
@@ -158,6 +158,14 @@ export {
   getPreviousEvidence,
   // 代码实体图谱
   queryCodeGraph,
+  // 调用图查询 (Phase 5)
+  queryCallGraph,
+  // 扫描 Recipe 收集
+  collectScanRecipe,
+  // 系统交互类
+  runSafeCommand,
+  writeProjectFile,
+  getEnvironmentInfo,
 };
 
 // ── ALL_TOOLS 数组（与原始 tools.js 顺序一致）──
@@ -177,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,
@@ -200,9 +204,8 @@ export const ALL_TOOLS = [
   qualityScore,
   validateCandidate,
   getFeedbackStats,
-  // 知识图谱类 (3)
+  // 知识图谱类 (2)
   checkDuplicate,
-  discoverRelations,
   addGraphEdge,
   // 基础设施类 (3)
   graphImpactAnalysis,
@@ -234,6 +237,14 @@ export const ALL_TOOLS = [
   getPreviousEvidence,
   // 代码实体图谱 (1) — Phase E
   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 {
@@ -206,6 +206,10 @@ export const bootstrapKnowledgeTool = {
         type: 'boolean',
         description: '是否加载 Skills 增强维度定义（推荐开启），默认 true',
       },
+      skipAsyncFill: {
+        type: 'boolean',
+        description: '跳过异步 AI 填充（CLI 非 --wait 模式下使用，避免 DB 断连）',
+      },
     },
   },
   handler: async (params, ctx) => {
@@ -218,6 +222,7 @@ export const bootstrapKnowledgeTool = {
         skipGuard: params.skipGuard || false,
         contentMaxLines: params.contentMaxLines || 120,
         loadSkills: params.loadSkills ?? true,
+        skipAsyncFill: params.skipAsyncFill || false,
       }
     );
     // bootstrapKnowledge 返回 envelope JSON string，解析提取 data

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' }
+    );
+  },
+};

package/lib/service/agent/tools/scan-recipe.js

@@ -0,0 +1,189 @@
+/**
+ * scan-recipe.js — 扫描专用 Recipe 收集工具
+ *
+ * 与冷启动 submit_knowledge 使用完全相同的字段 schema，
+ * 但不入库 — 仅做本地验证 + 内存收集。
+ *
+ * 扫描 Produce 阶段 LLM 调用此工具逐个提交 Recipe，
+ * 执行完成后由 AgentFactory.scanKnowledge() 从 toolCalls 中提取。
+ *
+ * 设计原因:
+ *   - 冷启动 Producer 通过 submit_knowledge 工具逐个提交候选（工具驱动）
+ *   - 扫描 Produce 之前是纯 JSON 文本输出，LLM 容易 hallucinate 错误工具调用
+ *   - 统一为工具驱动模式：相同 schema → 相同字段质量 → 相同下游消费
+ *
+ * @module scan-recipe
+ */
+
+// ── collect_scan_recipe ──────────────────────────────────────
+
+export const collectScanRecipe = {
+  name: 'collect_scan_recipe',
+  description:
+    '提交一条扫描发现的知识候选（Recipe）。每个独立的代码模式/设计模式/最佳实践应单独调用此工具提交。\n' +
+    '所有必填字段必须在单次调用中一次性提供。\n' +
+    '⚠️ content 必须是对象: { "pattern": "代码片段", "markdown": "项目特写正文≥200字", "rationale": "设计原理" }\n' +
+    '⚠️ reasoning 必须是对象: { "whyStandard": "原因", "sources": ["file.ts"], "confidence": 0.85 }',
+  parameters: {
+    type: 'object',
+    properties: {
+      // ── 基本信息 ──
+      title: { type: 'string', description: '中文标题（≤20字，使用项目真实类名）' },
+      language: { type: 'string', description: '编程语言（小写）' },
+      description: { type: 'string', description: '中文简述 ≤80 字，引用真实类名' },
+      tags: { type: 'array', items: { type: 'string' }, description: '标签列表' },
+
+      // ── 内容（V3 content 子对象） ──
+      content: {
+        type: 'object',
+        description:
+          '{ markdown: "项目特写 Markdown(≥200字)", pattern: "核心代码 3-8 行", rationale: "设计原理(必填)" }',
+        properties: {
+          pattern: { type: 'string', description: '核心代码片段' },
+          markdown: { type: 'string', description: 'Markdown 正文（≥200字符）' },
+          rationale: { type: 'string', description: '设计原理说明（必填）' },
+        },
+        required: ['rationale'],
+      },
+
+      // ── Cursor 交付（必填）──
+      kind: {
+        type: 'string',
+        enum: ['rule', 'pattern', 'fact'],
+        description: 'rule=规则 | pattern=模板 | fact=参考',
+      },
+      category: {
+        type: 'string',
+        description: '分类: View / Service / Tool / Model / Network / Storage / UI / Utility',
+      },
+      trigger: { type: 'string', description: '触发关键词（@前缀，kebab-case）' },
+      doClause: { type: 'string', description: '正向指令（英文祈使句 ≤60 tokens）' },
+      dontClause: { type: 'string', description: '反向约束（描述禁止的做法）' },
+      whenClause: { type: 'string', description: '触发场景（描述何时适用）' },
+      coreCode: { type: 'string', description: '精华代码骨架（3-8行，语法完整）' },
+
+      // ── 结构化字段 ──
+      headers: {
+        type: 'array',
+        items: { type: 'string' },
+        description: '完整 import/include 语句数组',
+      },
+      usageGuide: { type: 'string', description: '使用指南（何时/如何使用）' },
+      knowledgeType: {
+        type: 'string',
+        description: 'code-pattern / architecture / best-practice / code-standard / data-flow / solution 等',
+      },
+
+      // ── 推理 ──
+      reasoning: {
+        type: 'object',
+        description: '{ whyStandard: "原因", sources: ["file.ts"], confidence: 0.85 }',
+        properties: {
+          whyStandard: { type: 'string', description: '为什么这是标准做法（必填）' },
+          sources: { type: 'array', items: { type: 'string' }, description: '参考的文件路径数组（必填）' },
+          confidence: { type: 'number', description: '置信度 0.0-1.0' },
+        },
+        required: ['whyStandard', 'sources'],
+      },
+
+      // ── 可选 ──
+      complexity: { type: 'string', enum: ['beginner', 'intermediate', 'advanced'] },
+      scope: { type: 'string', enum: ['universal', 'project-specific', 'target-specific'] },
+    },
+    required: [
+      'title', 'language', 'content', 'kind',
+      'doClause', 'dontClause', 'whenClause', 'coreCode',
+      'category', 'trigger', 'description',
+      'headers', 'usageGuide', 'knowledgeType', 'reasoning',
+    ],
+  },
+
+  /**
+   * Handler — 本地验证 + 内存收集（不入库）
+   *
+   * 验证通过后返回 { status: 'collected', recipe: {...} }，
+   * AgentFactory.scanKnowledge() 从 toolCalls 结果中提取 recipes。
+   */
+  handler: async (params, _ctx) => {
+    // ── 基本验证 ──
+    const errors = [];
+
+    if (!params.title || params.title.trim().length === 0) {
+      errors.push('title 不能为空');
+    }
+    if (!params.content || typeof params.content !== 'object') {
+      errors.push('content 必须是对象');
+    } else if (!params.content.rationale) {
+      errors.push('content.rationale (设计原理) 是必填字段');
+    }
+    if (!params.reasoning || typeof params.reasoning !== 'object') {
+      errors.push('reasoning 必须是对象');
+    } else {
+      if (!params.reasoning.whyStandard) errors.push('reasoning.whyStandard 是必填字段');
+      if (!Array.isArray(params.reasoning.sources) || params.reasoning.sources.length === 0) {
+        errors.push('reasoning.sources 必须是非空数组');
+      }
+    }
+    if (!params.kind || !['rule', 'pattern', 'fact'].includes(params.kind)) {
+      errors.push('kind 必须是 rule / pattern / fact 之一');
+    }
+    if (!params.trigger || !params.trigger.startsWith('@')) {
+      errors.push('trigger 必须以 @ 开头');
+    }
+    if (!params.coreCode || params.coreCode.trim().length < 10) {
+      errors.push('coreCode 必须提供有意义的代码骨架（≥10字符）');
+    }
+    if (!params.doClause) {
+      errors.push('doClause (正向指令) 是必填字段');
+    }
+
+    if (errors.length > 0) {
+      return {
+        status: 'rejected',
+        error: errors.join('\n'),
+        hint: '请根据错误信息调整内容后重新提交。',
+      };
+    }
+
+    // ── 构建标准化 Recipe 对象 ──
+    const contentObj = params.content || {};
+    const reasoning = params.reasoning || {};
+
+    const recipe = {
+      title: params.title.trim(),
+      language: params.language || '',
+      description: params.description || '',
+      tags: params.tags || [],
+      content: {
+        pattern: contentObj.pattern || '',
+        markdown: contentObj.markdown || '',
+        rationale: contentObj.rationale || '',
+      },
+      kind: params.kind,
+      category: params.category || 'Utility',
+      trigger: params.trigger,
+      doClause: params.doClause || '',
+      dontClause: params.dontClause || '',
+      whenClause: params.whenClause || '',
+      coreCode: params.coreCode || '',
+      headers: params.headers || [],
+      usageGuide: params.usageGuide || '',
+      knowledgeType: params.knowledgeType || 'code-pattern',
+      reasoning: {
+        whyStandard: reasoning.whyStandard || '',
+        sources: reasoning.sources || [],
+        confidence: reasoning.confidence ?? 0.8,
+      },
+      complexity: params.complexity || 'intermediate',
+      scope: params.scope || 'project-specific',
+    };
+
+    return {
+      status: 'collected',
+      title: recipe.title,
+      recipe,
+    };
+  },
+};
+
+export default collectScanRecipe;