autosnippet 3.2.10 → 3.2.12

package/lib/service/agent/tools/ToolRegistry.js

@@ -1,215 +0,0 @@
-/**
- * ToolRegistry — 统一工具注册表
- *
- * 管理 Agent 可调用的所有工具定义。
- * 每个工具包含: name, description, parameters(JSON Schema), handler
- *
- * 设计原则:
- * - 所有 AI 能力均封装为 Tool，不再散落在各处
- * - Tool handler 仅做参数整理 + 调用已有 Service，不含业务逻辑
- * - 支持 Agent ReAct 循环调用（通过 LLM 推理决定工具调用）
- */
-
-import Logger from '../../../infrastructure/logging/Logger.js';
-
-/**
- * AI 模型常见的参数命名变体 → schema 标准名映射
- * 覆盖 Gemini / GPT / DeepSeek / Claude 常见偏好
- */
-const PARAM_ALIASES = {
-  // read_project_file 变体
-  file: 'filePath',
-  filename: 'filePath',
-  file_name: 'filePath',
-  filepath: 'filePath',
-  file_path: 'filePath',
-  path: 'filePath',
-  // search_project_code 变体
-  query: 'pattern',
-  search: 'pattern',
-  keyword: 'pattern',
-  search_query: 'pattern',
-  search_text: 'pattern',
-  regex: 'pattern',
-  // 通用变体
-  is_regex: 'isRegex',
-  file_filter: 'fileFilter',
-  context_lines: 'contextLines',
-  max_results: 'maxResults',
-  start_line: 'startLine',
-  end_line: 'endLine',
-  max_lines: 'maxLines',
-  candidate_id: 'candidateId',
-  recipe_id: 'recipeId',
-  skill_name: 'skillName',
-};
-
-export class ToolRegistry {
-  #tools = new Map();
-  #logger;
-
-  constructor() {
-    this.#logger = Logger.getInstance();
-  }
-
-  /**
-   * 注册一个工具
-   * @param {object} toolDef
-   * @param {string} toolDef.name        — 工具唯一名称 (snake_case)
-   * @param {string} toolDef.description  — 给 LLM 看的工具描述
-   * @param {object} toolDef.parameters   — JSON Schema 格式的参数定义
-   * @param {Function} toolDef.handler    — async (params, context) => result
-   */
-  register(toolDef) {
-    const { name, description, handler, parameters = {} } = toolDef;
-    if (!name || !handler) {
-      throw new Error('Tool must have name and handler');
-    }
-    this.#tools.set(name, { name, description, parameters, handler });
-  }
-
-  /**
-   * 批量注册
-   * @param {Array<object>} defs
-   */
-  registerAll(defs) {
-    for (const def of defs) {
-      this.register(def);
-    }
-    this.#logger.info(`[ToolRegistry] ${defs.length} tools registered`);
-  }
-
-  /**
-   * 获取工具定义（不含 handler，给 LLM prompt 使用）
-   * @param {string[]} [allowedTools] — 限制返回的工具列表（不传则返回全部）
-   * @returns {Array<{name: string, description: string, parameters: object}>}
-   */
-  getToolSchemas(allowedTools) {
-    const schemas = [];
-    for (const [name, tool] of this.#tools) {
-      if (allowedTools && !allowedTools.includes(name)) {
-        continue;
-      }
-      schemas.push({
-        name: tool.name,
-        description: tool.description,
-        parameters: tool.parameters,
-      });
-    }
-    return schemas;
-  }
-
-  /**
-   * 直接执行某个工具
-   * @param {string} name
-   * @param {object} params
-   * @param {object} context — { container, aiProvider, projectRoot, ... }
-   * @returns {Promise<any>}
-   */
-  async execute(name, params, context = {}) {
-    const tool = this.#tools.get(name);
-    if (!tool) {
-      throw new Error(`Tool '${name}' not found`);
-    }
-
-    // 参数归一化: AI 可能用 snake_case / 不同命名传参，
-    // 将其映射到 tool schema 中定义的 camelCase 参数名
-    const normalized = this.#normalizeParams(params, tool.parameters);
-
-    this.#logger.debug(`Tool execute: ${name}`, { params: Object.keys(normalized) });
-    try {
-      const result = await tool.handler(normalized, context);
-      return result;
-    } catch (err) {
-      // API Key 缺失为配置问题，降为 info 级别
-      if (err.code === 'API_KEY_MISSING') {
-        this.#logger.info(`Tool '${name}' 跳过: ${err.message}`);
-      } else {
-        this.#logger.error(`Tool '${name}' failed`, { error: err.message });
-      }
-      return { error: err.message };
-    }
-  }
-
-  /**
-   * 参数归一化 — 将 AI 传来的 snake_case / 变体参数名映射到 schema 定义名
-   *
-   * 例: AI 传 { file_path: "x.m" } → schema 定义 filePath → 归一化为 { filePath: "x.m" }
-   *     AI 传 { file: "x.m" }      → schema 定义 filePath → 通过别名表匹配
-   *
-   * 策略:
-   *   1. schema 中已有的 key → 保留不动
-   *   2. snake_case → camelCase 自动转换
-   *   3. 常用别名表兜底
-   */
-  #normalizeParams(params, schema) {
-    if (!params || typeof params !== 'object') {
-      return params || {};
-    }
-    const properties = schema?.properties || {};
-    const schemaKeys = new Set(Object.keys(properties));
-    if (schemaKeys.size === 0) {
-      return params;
-    }
-
-    const result = {};
-    const unmatched = [];
-
-    for (const [key, value] of Object.entries(params)) {
-      // 1. 精确匹配 — 已在 schema 中
-      if (schemaKeys.has(key)) {
-        result[key] = value;
-        continue;
-      }
-
-      // 2. snake_case → camelCase 转换
-      const camelKey = key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
-      if (schemaKeys.has(camelKey)) {
-        result[camelKey] = value;
-        continue;
-      }
-
-      // 3. 常用别名映射
-      const aliased = PARAM_ALIASES[key];
-      if (aliased && schemaKeys.has(aliased)) {
-        result[aliased] = value;
-        continue;
-      }
-
-      // 4. 无匹配 — 保留原样（handler 可能有自定义处理）
-      result[key] = value;
-      unmatched.push(key);
-    }
-
-    if (unmatched.length > 0) {
-      this.#logger.debug(
-        `[ToolRegistry] param normalization: unmatched keys [${unmatched.join(', ')}]`
-      );
-    }
-
-    return result;
-  }
-
-  /**
-   * 检查工具是否存在
-   */
-  has(name) {
-    return this.#tools.has(name);
-  }
-
-  /**
-   * 获取所有工具名
-   */
-  getToolNames() {
-    return [...this.#tools.keys()];
-  }
-
-  /**
-   * 工具数量
-   */
-  get size() {
-    return this.#tools.size;
-  }
-}
-
-export default ToolRegistry;

package/lib/service/agent/tools/_shared.js

@@ -1,61 +0,0 @@
-/**
- * _shared.js — 多个工具模块共享的常量和辅助函数
- */
-
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-export const PROJECT_ROOT = path.resolve(__dirname, '../../../..');
-/** skills/ 目录绝对路径 */
-export const SKILLS_DIR = path.resolve(PROJECT_ROOT, 'skills');
-/** 项目级 skills 目录 */
-export const PROJECT_SKILLS_DIR = path.resolve(PROJECT_ROOT, '.autosnippet', 'skills');
-
-// Bootstrap 维度展示分组 — 将 9 个细粒度维度合并为 4 个展示组
-export const DIMENSION_DISPLAY_GROUP = {
-  architecture: 'architecture', // → 架构与设计
-  'code-pattern': 'architecture', // → 架构与设计
-  'project-profile': 'architecture', // → 架构与设计
-  'best-practice': 'best-practice', // → 规范与实践
-  'code-standard': 'best-practice', // → 规范与实践
-  'event-and-data-flow': 'event-and-data-flow', // → 事件与数据流
-  'objc-deep-scan': 'objc-deep-scan', // → 深度扫描
-  'category-scan': 'objc-deep-scan', // → 深度扫描
-  'agent-guidelines': 'agent-guidelines', // skill-only
-};
-
-/**
- * 基于维度元数据 (dimensionMeta) 检查提交是否合法
- * @param {{ id: string, outputType: 'candidate'|'skill'|'dual', allowedKnowledgeTypes: string[] }} dimensionMeta
- * @param {object} params - submit_knowledge 的参数
- * @param {object} [logger]
- * @returns {{ status: string, reason: string } | null} 不合法返回 rejected，合法返回 null
- */
-export function checkDimensionType(dimensionMeta, params, logger) {
-  // 1. Skill-only 维度不允许提交 Candidate
-  if (dimensionMeta.outputType === 'skill') {
-    logger?.info(
-      `[submit_knowledge] ✗ rejected — dimension "${dimensionMeta.id}" is skill-only, cannot submit candidates`
-    );
-    return {
-      status: 'rejected',
-      reason: `当前维度 "${dimensionMeta.id}" 的输出类型为 skill-only，不允许调用 submit_knowledge。请只在最终回复中提供 dimensionDigest JSON。`,
-    };
-  }
-
-  // 2. knowledgeType 校验 — 不在允许列表时自动修正为第一个允许类型
-  const allowed = dimensionMeta.allowedKnowledgeTypes || [];
-  if (allowed.length > 0 && params.knowledgeType) {
-    if (!allowed.includes(params.knowledgeType)) {
-      const corrected = allowed[0];
-      logger?.warn(
-        `[submit_knowledge] knowledgeType "${params.knowledgeType}" → "${corrected}" (auto-corrected for dimension "${dimensionMeta.id}")`
-      );
-      params.knowledgeType = corrected;
-    }
-  }
-
-  return null;
-}

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

@@ -1,75 +0,0 @@
-/**
- * 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;
-  },
-};