autosnippet 3.2.9 → 3.2.11

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

@@ -1,145 +0,0 @@
-/**
- * guard.js — Guard 安全类工具 (4)
- *
- * 7b. list_guard_rules    列出 Guard 规则
- * 8b. get_recommendations 获取推荐 Recipe
- * 13. guard_check_code    Guard 检查代码
- * 14. query_violations    查询违规历史
- */
-
-// ────────────────────────────────────────────────────────────
-// 7b. list_guard_rules
-// ────────────────────────────────────────────────────────────
-export const listGuardRules = {
-  name: 'list_guard_rules',
-  description: '列出所有 Guard 规则（boundary-constraint 类型的 Recipe）。支持按语言/状态过滤。',
-  parameters: {
-    type: 'object',
-    properties: {
-      language: { type: 'string', description: '按语言过滤 (swift/objc 等)' },
-      includeBuiltIn: { type: 'boolean', description: '是否包含内置规则，默认 true' },
-      limit: { type: 'number', description: '返回数量上限，默认 50' },
-    },
-  },
-  handler: async (params, ctx) => {
-    const { language, includeBuiltIn = true, limit = 50 } = params;
-    const results = [];
-
-    // 数据库自定义规则
-    try {
-      const guardService = ctx.container.get('guardService');
-      const dbRules = await guardService.listRules({}, { page: 1, pageSize: limit });
-      results.push(...(dbRules.data || dbRules.items || []));
-    } catch {
-      /* not available */
-    }
-
-    // 内置规则
-    if (includeBuiltIn) {
-      try {
-        const guardCheckEngine = ctx.container.get('guardCheckEngine');
-        const builtIn = guardCheckEngine
-          .getRules(language || null)
-          .filter((r) => r.source === 'built-in');
-        results.push(...builtIn);
-      } catch {
-        /* not available */
-      }
-    }
-
-    return { total: results.length, rules: results.slice(0, limit) };
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 8b. get_recommendations
-// ────────────────────────────────────────────────────────────
-export const getRecommendations = {
-  name: 'get_recommendations',
-  description: '获取推荐的 Recipe 列表（基于使用频率和质量排序）。',
-  parameters: {
-    type: 'object',
-    properties: {
-      limit: { type: 'number', description: '返回数量，默认 10' },
-    },
-  },
-  handler: async (params, ctx) => {
-    const knowledgeService = ctx.container.get('knowledgeService');
-    // V3: 推荐 = 活跃条目按使用量排序
-    return knowledgeService.list(
-      { lifecycle: 'active' },
-      { page: 1, pageSize: params.limit || 10 }
-    );
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 13. guard_check_code
-// ────────────────────────────────────────────────────────────
-export const guardCheckCode = {
-  name: 'guard_check_code',
-  description: '对代码运行 Guard 规则检查，返回违规列表（支持内置规则 + 数据库自定义规则）。',
-  parameters: {
-    type: 'object',
-    properties: {
-      code: { type: 'string', description: '待检查的源代码' },
-      language: { type: 'string', description: '编程语言 (swift/objc/javascript 等)' },
-      scope: { type: 'string', description: '检查范围 (file/target/project)，默认 file' },
-    },
-    required: ['code'],
-  },
-  handler: async (params, ctx) => {
-    const { code, language, scope = 'file' } = params;
-
-    // 优先用 GuardCheckEngine（内置 + DB 规则）
-    try {
-      const engine = ctx.container.get('guardCheckEngine');
-      const violations = engine.checkCode(code, language || 'unknown', { scope });
-      // reasoning 已由 GuardCheckEngine.checkCode() 内置附加
-      return { violationCount: violations.length, violations };
-    } catch {
-      /* not available */
-    }
-
-    // 降级到 GuardService.checkCode（仅 DB 规则）
-    try {
-      const guardService = ctx.container.get('guardService');
-      const matches = await guardService.checkCode(code, { language });
-      return { violationCount: matches.length, violations: matches };
-    } catch (err) {
-      return { error: err.message };
-    }
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 14. query_violations
-// ────────────────────────────────────────────────────────────
-export const queryViolations = {
-  name: 'query_violations',
-  description: '查询 Guard 违规历史记录和统计。',
-  parameters: {
-    type: 'object',
-    properties: {
-      file: { type: 'string', description: '按文件路径过滤' },
-      limit: { type: 'number', description: '返回数量，默认 20' },
-      statsOnly: { type: 'boolean', description: '仅返回统计数据，默认 false' },
-    },
-  },
-  handler: async (params, ctx) => {
-    const { file, limit = 20, statsOnly = false } = params;
-    const store = ctx.container.get('violationsStore');
-
-    if (statsOnly) {
-      return store.getStats();
-    }
-
-    if (file) {
-      return { runs: store.getRunsByFile(file) };
-    }
-
-    return store.list({}, { page: 1, limit });
-  },
-};
-
-

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

@@ -1,250 +0,0 @@
-/**
- * tools/index.js — Barrel 导出文件
- *
- * 从各子模块导入所有工具，按原始顺序组装 ALL_TOOLS 数组并导出。
- */
-
-// ── AI 分析类 (2) ──
-import {
-  enrichCandidate,
-  refineBootstrapCandidates,
-} from './ai-analysis.js';
-// ── AST 结构化分析 + Agent Memory (11) ──
-import {
-  getCategoryMap,
-  getClassHierarchy,
-  getClassInfo,
-  getMethodOverrides,
-  getPreviousAnalysis,
-  getPreviousEvidence,
-  getProjectOverview,
-  getProtocolInfo,
-  noteFinding,
-  queryCallGraph,
-  queryCodeGraph,
-} from './ast-graph.js';
-// ── 组合工具 + 元工具 (6) ──
-import {
-  analyzeCode,
-  getToolDetails,
-  knowledgeOverview,
-  planTask,
-  reviewMyOutput,
-  submitWithCheck,
-} from './composite.js';
-
-// ── Guard 安全类 (4) ──
-import {
-  getRecommendations,
-  guardCheckCode,
-  listGuardRules,
-  queryViolations,
-} from './guard.js';
-// ── 基础设施类 (7) ──
-import {
-  bootstrapKnowledgeTool,
-  createSkillTool,
-  graphImpactAnalysis,
-  loadSkill,
-  queryAuditLog,
-  rebuildIndex,
-  suggestSkills,
-} from './infrastructure.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,
-  deprecateRecipe,
-  getFeedbackStats,
-  publishRecipe,
-  qualityScore,
-  recordUsage,
-  rejectCandidate,
-  saveDocument,
-  submitCandidate,
-  updateRecipe,
-  validateCandidate,
-} from './lifecycle.js';
-// ── 项目数据访问 (5) ──
-import {
-  getFileSummary,
-  listProjectStructure,
-  readProjectFile,
-  searchProjectCode,
-  semanticSearchCode,
-} from './project-access.js';
-// ── 查询类 (6) ──
-import {
-  getProjectStats,
-  getRecipeDetail,
-  getRelatedRecipes,
-  searchCandidates,
-  searchKnowledge,
-  searchRecipes,
-} from './query.js';
-
-// ── Re-export 所有工具 ──
-export {
-  // 项目数据访问
-  searchProjectCode,
-  readProjectFile,
-  listProjectStructure,
-  getFileSummary,
-  semanticSearchCode,
-  // 查询类
-  searchRecipes,
-  searchCandidates,
-  getRecipeDetail,
-  getProjectStats,
-  searchKnowledge,
-  getRelatedRecipes,
-  // AI 分析类
-  enrichCandidate,
-  refineBootstrapCandidates,
-  // Guard 安全类
-  listGuardRules,
-  getRecommendations,
-  guardCheckCode,
-  queryViolations,
-  // 知识图谱类
-  checkDuplicate,
-  addGraphEdge,
-  // 生命周期操作类
-  submitCandidate,
-  saveDocument,
-  approveCandidate,
-  rejectCandidate,
-  publishRecipe,
-  deprecateRecipe,
-  updateRecipe,
-  recordUsage,
-  qualityScore,
-  validateCandidate,
-  getFeedbackStats,
-  // 基础设施类
-  graphImpactAnalysis,
-  rebuildIndex,
-  queryAuditLog,
-  loadSkill,
-  createSkillTool,
-  suggestSkills,
-  bootstrapKnowledgeTool,
-  // 组合工具 + 元工具
-  analyzeCode,
-  knowledgeOverview,
-  submitWithCheck,
-  getToolDetails,
-  planTask,
-  reviewMyOutput,
-  // AST 结构化分析
-  getProjectOverview,
-  getClassHierarchy,
-  getClassInfo,
-  getProtocolInfo,
-  getMethodOverrides,
-  getCategoryMap,
-  getPreviousAnalysis,
-  // Agent Memory
-  noteFinding,
-  getPreviousEvidence,
-  // 代码实体图谱
-  queryCodeGraph,
-  // 调用图查询 (Phase 5)
-  queryCallGraph,
-  // 扫描 Recipe 收集
-  collectScanRecipe,
-  // 系统交互类
-  runSafeCommand,
-  writeProjectFile,
-  getEnvironmentInfo,
-};
-
-// ── ALL_TOOLS 数组（与原始 tools.js 顺序一致）──
-export const ALL_TOOLS = [
-  // 项目数据访问 (5) — 含 v10 Agent-Pull 工具
-  searchProjectCode,
-  readProjectFile,
-  listProjectStructure,
-  getFileSummary,
-  semanticSearchCode,
-  // 查询类 (8)
-  searchRecipes,
-  searchCandidates,
-  getRecipeDetail,
-  getProjectStats,
-  searchKnowledge,
-  getRelatedRecipes,
-  listGuardRules,
-  getRecommendations,
-  // AI 分析类 (2)
-  enrichCandidate,
-  refineBootstrapCandidates,
-  // Guard 安全类 (2)
-  guardCheckCode,
-  queryViolations,
-  // 生命周期操作类 (7)
-  submitCandidate,
-  saveDocument,
-  approveCandidate,
-  rejectCandidate,
-  publishRecipe,
-  deprecateRecipe,
-  updateRecipe,
-  recordUsage,
-  // 质量与反馈类 (3)
-  qualityScore,
-  validateCandidate,
-  getFeedbackStats,
-  // 知识图谱类 (2)
-  checkDuplicate,
-  addGraphEdge,
-  // 基础设施类 (3)
-  graphImpactAnalysis,
-  rebuildIndex,
-  queryAuditLog,
-  // Skills & Bootstrap (4)
-  loadSkill,
-  createSkillTool,
-  suggestSkills,
-  bootstrapKnowledgeTool,
-  // 组合工具 (3) — 减少 ReAct 轮次
-  analyzeCode,
-  knowledgeOverview,
-  submitWithCheck,
-  // 元工具 (3) — Agent 自主能力增强
-  getToolDetails,
-  planTask,
-  reviewMyOutput,
-  // AST 结构化分析 (7) — v3.0 AI-First Bootstrap
-  getProjectOverview,
-  getClassHierarchy,
-  getClassInfo,
-  getProtocolInfo,
-  getMethodOverrides,
-  getCategoryMap,
-  getPreviousAnalysis,
-  // Agent Memory 增强 (2) — 工作记忆 + 情景记忆
-  noteFinding,
-  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/agent/tools/infrastructure.js

@@ -1,232 +0,0 @@
-/**
- * infrastructure.js — 基础设施类工具 (7)
- *
- * 29. graph_impact_analysis  知识图谱影响分析
- * 30. rebuild_index          向量索引重建
- * 31. query_audit_log        审计日志查询
- * 32. load_skill             加载 Skill 文档
- * 33. create_skill           创建项目级 Skill
- * 34. suggest_skills         推荐创建 Skill
- * 34. bootstrap_knowledge    冷启动知识库
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import Logger from '../../../infrastructure/logging/Logger.js';
-import { PROJECT_SKILLS_DIR, SKILLS_DIR } from './_shared.js';
-
-// ────────────────────────────────────────────────────────────
-// 29. graph_impact_analysis
-// ────────────────────────────────────────────────────────────
-export const graphImpactAnalysis = {
-  name: 'graph_impact_analysis',
-  description: '知识图谱影响范围分析 — 查找修改某个 Recipe 后可能受影响的所有下游依赖。',
-  parameters: {
-    type: 'object',
-    properties: {
-      recipeId: { type: 'string', description: 'Recipe ID' },
-      maxDepth: { type: 'number', description: '最大深度，默认 3' },
-    },
-    required: ['recipeId'],
-  },
-  handler: async (params, ctx) => {
-    const kgService = ctx.container.get('knowledgeGraphService');
-    const impacted = kgService.getImpactAnalysis(params.recipeId, 'recipe', params.maxDepth || 3);
-    return { recipeId: params.recipeId, impactedCount: impacted.length, impacted };
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 30. rebuild_index
-// ────────────────────────────────────────────────────────────
-export const rebuildIndex = {
-  name: 'rebuild_index',
-  description:
-    '向量索引重建 — 重新扫描 Recipe 文件并更新向量索引（用于索引过期或新增大量 Recipe 后）。',
-  parameters: {
-    type: 'object',
-    properties: {
-      force: { type: 'boolean', description: '强制重建（跳过增量检测），默认 false' },
-      dryRun: { type: 'boolean', description: '仅预览不实际写入，默认 false' },
-    },
-  },
-  handler: async (params, ctx) => {
-    const pipeline = ctx.container.get('indexingPipeline');
-    return pipeline.run({ force: params.force || false, dryRun: params.dryRun || false });
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 31. query_audit_log
-// ────────────────────────────────────────────────────────────
-export const queryAuditLog = {
-  name: 'query_audit_log',
-  description: '审计日志查询 — 查看系统操作历史（谁在什么时间做了什么操作）。',
-  parameters: {
-    type: 'object',
-    properties: {
-      action: {
-        type: 'string',
-        description: '按操作类型过滤 (create_candidate/approve_candidate/create_guard_rule 等)',
-      },
-      actor: { type: 'string', description: '按操作者过滤' },
-      limit: { type: 'number', description: '返回数量，默认 20' },
-    },
-  },
-  handler: async (params, ctx) => {
-    const auditLogger = ctx.container.get('auditLogger');
-    const { action, actor, limit = 20 } = params;
-
-    if (actor) {
-      return auditLogger.getByActor(actor, limit);
-    }
-    if (action) {
-      return auditLogger.getByAction(action, limit);
-    }
-    return auditLogger.getStats();
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 32. load_skill — 按需加载 Agent Skill 文档
-// ────────────────────────────────────────────────────────────
-export const loadSkill = {
-  name: 'load_skill',
-  description:
-    '加载指定的 Agent Skill 文档，获取领域操作指南和最佳实践参考。可用于冷启动指南 (autosnippet-coldstart)、候选管理 (autosnippet-candidates)、规范审计 (autosnippet-guard) 等。',
-  parameters: {
-    type: 'object',
-    properties: {
-      skillName: {
-        type: 'string',
-        description:
-          'Skill 目录名（如 autosnippet-coldstart, autosnippet-candidates, autosnippet-guard 等）',
-      },
-    },
-    required: ['skillName'],
-  },
-  handler: async (params) => {
-    // 项目级 Skills 优先（覆盖同名内置 Skill）
-    const projectSkillPath = path.join(PROJECT_SKILLS_DIR, params.skillName, 'SKILL.md');
-    const builtinSkillPath = path.join(SKILLS_DIR, params.skillName, 'SKILL.md');
-    const skillPath = fs.existsSync(projectSkillPath) ? projectSkillPath : builtinSkillPath;
-    try {
-      const content = fs.readFileSync(skillPath, 'utf8');
-      const source = skillPath === projectSkillPath ? 'project' : 'builtin';
-      return { skillName: params.skillName, source, content };
-    } catch {
-      const available = new Set();
-      try {
-        fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
-          .filter((d) => d.isDirectory())
-          .forEach((d) => available.add(d.name));
-      } catch {
-        /* skip: SKILLS_DIR may not exist */
-      }
-      try {
-        fs.readdirSync(PROJECT_SKILLS_DIR, { withFileTypes: true })
-          .filter((d) => d.isDirectory())
-          .forEach((d) => available.add(d.name));
-      } catch {
-        /* skip: project skills dir may not exist */
-      }
-      return { error: `Skill "${params.skillName}" not found`, availableSkills: [...available] };
-    }
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 33. create_skill — 创建项目级 Skill
-// ────────────────────────────────────────────────────────────
-export const createSkillTool = {
-  name: 'create_skill',
-  description:
-    '创建项目级 Skill 文档，写入 AutoSnippet/skills/<name>/SKILL.md。Skill 是 Agent 的领域知识增强文档。创建后自动更新编辑器索引。',
-  parameters: {
-    type: 'object',
-    properties: {
-      name: {
-        type: 'string',
-        description: 'Skill 名称（kebab-case，如 my-auth-guide），3-64 字符',
-      },
-      description: { type: 'string', description: 'Skill 一句话描述（写入 frontmatter）' },
-      content: { type: 'string', description: 'Skill 正文内容（Markdown 格式，不含 frontmatter）' },
-      overwrite: { type: 'boolean', description: '如果同名 Skill 已存在，是否覆盖（默认 false）' },
-    },
-    required: ['name', 'description', 'content'],
-  },
-  handler: async (params, ctx) => {
-    const { createSkill } = await import('../../../external/mcp/handlers/skill.js');
-    // 根据 Agent 的 source 推断 createdBy
-    const createdBy = ctx?.source === 'system' ? 'system-ai' : 'user-ai';
-    const raw = createSkill(null, { ...params, createdBy });
-    try {
-      return JSON.parse(raw);
-    } catch {
-      return { success: false, error: raw };
-    }
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 34. suggest_skills — 基于使用模式推荐 Skill 创建
-// ────────────────────────────────────────────────────────────
-export const suggestSkills = {
-  name: 'suggest_skills',
-  description:
-    '基于项目使用模式分析，推荐创建 Skill。分析 Guard 违规频率、Memory 偏好积累、Recipe 分布缺口、候选积压率。返回推荐列表（含 name/description/rationale/priority），可据此直接调用 create_skill 创建。',
-  parameters: {
-    type: 'object',
-    properties: {},
-    required: [],
-  },
-  handler: async (_params, ctx) => {
-    const { SkillAdvisor } = await import('../../skills/SkillAdvisor.js');
-    const database = ctx?.container?.get?.('database') || null;
-    const projectRoot = ctx?.projectRoot || process.cwd();
-    const advisor = new SkillAdvisor(projectRoot, { database });
-    return advisor.suggest();
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 34. bootstrap_knowledge — 冷启动知识库初始化
-// ────────────────────────────────────────────────────────────
-export const bootstrapKnowledgeTool = {
-  name: 'bootstrap_knowledge',
-  description:
-    '冷启动知识库初始化（纯启发式，不使用 AI）: SPM Target 扫描 → 依赖图谱 → Guard 审计 → 9 维度 Candidate 自动创建。支持 Skill 增强维度定义。产出为初稿候选，后续由 DAG pipeline 自动编排 AI 增强（enrich → refine）。',
-  parameters: {
-    type: 'object',
-    properties: {
-      maxFiles: { type: 'number', description: '最大扫描文件数，默认 500' },
-      skipGuard: { type: 'boolean', description: '是否跳过 Guard 审计，默认 false' },
-      contentMaxLines: { type: 'number', description: '每文件读取最大行数，默认 120' },
-      loadSkills: {
-        type: 'boolean',
-        description: '是否加载 Skills 增强维度定义（推荐开启），默认 true',
-      },
-      skipAsyncFill: {
-        type: 'boolean',
-        description: '跳过异步 AI 填充（CLI 非 --wait 模式下使用，避免 DB 断连）',
-      },
-    },
-  },
-  handler: async (params, ctx) => {
-    const { bootstrapKnowledge } = await import('../../../external/mcp/handlers/bootstrap-internal.js');
-    const logger = Logger.getInstance();
-    const result = await bootstrapKnowledge(
-      { container: ctx.container, logger },
-      {
-        maxFiles: params.maxFiles || 500,
-        skipGuard: params.skipGuard || false,
-        contentMaxLines: params.contentMaxLines || 120,
-        loadSkills: params.loadSkills ?? true,
-        skipAsyncFill: params.skipAsyncFill || false,
-      }
-    );
-    // bootstrapKnowledge 返回 envelope JSON string，解析提取 data
-    const parsed = typeof result === 'string' ? JSON.parse(result) : result;
-    return parsed?.data || parsed;
-  },
-};