autosnippet 3.2.8 → 3.2.10

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

@@ -1,267 +0,0 @@
-/**
- * ai-analysis.js — AI 分析类工具 (4)
- *
- * 7. summarize_code              AI 代码摘要
- * 8. extract_recipes             从源码批量提取 Recipe
- * 9. enrich_candidate            结构补齐
- * 9b. refine_bootstrap_candidates 内容润色
- */
-
-// ────────────────────────────────────────────────────────────
-// 7. summarize_code
-// ────────────────────────────────────────────────────────────
-export const summarizeCode = {
-  name: 'summarize_code',
-  description: 'AI 代码摘要 — 分析代码片段并生成结构化摘要（包含功能描述、关键 API、使用建议）。',
-  parameters: {
-    type: 'object',
-    properties: {
-      code: { type: 'string', description: '代码内容' },
-      language: { type: 'string', description: '编程语言' },
-    },
-    required: ['code'],
-  },
-  handler: async (params, ctx) => {
-    if (!ctx.aiProvider) {
-      return { error: 'AI provider not available' };
-    }
-    return ctx.aiProvider.summarize(params.code, params.language);
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 8. extract_recipes
-// ────────────────────────────────────────────────────────────
-export const extractRecipes = {
-  name: 'extract_recipes',
-  description:
-    '从源码文件中批量提取可复用的 Recipe 结构（代码标准、设计模式、最佳实践）。支持自动 provider fallback。',
-  parameters: {
-    type: 'object',
-    properties: {
-      targetName: { type: 'string', description: 'SPM Target / 模块名称' },
-      files: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: { name: { type: 'string' }, content: { type: 'string' } },
-        },
-        description: '文件数组 [{name, content}]',
-      },
-    },
-    required: ['targetName', 'files'],
-  },
-  handler: async (params, ctx) => {
-    if (!ctx.aiProvider) {
-      return { error: 'AI provider not available' };
-    }
-    const { targetName, files, comprehensive } = params;
-
-    // AST 代码结构分析（如可用），注入到 AI 提取 prompt
-    let astContext = null;
-    try {
-      const { analyzeProject, generateContextForAgent, isAvailable } = await import(
-        '../../../core/AstAnalyzer.js'
-      );
-      if (isAvailable()) {
-        const sourceFiles = files
-          .filter((f) => /\.(m|mm|h|swift|js|ts|jsx|tsx)$/.test(f.name || ''))
-          .map((f) => ({ path: f.name, source: f.content }));
-        if (sourceFiles.length > 0) {
-          const langProfile2 = ctx.aiProvider._detectLanguageProfile?.(files);
-          const lang = langProfile2?.primaryLanguage === 'swift' ? 'swift' : 'objc';
-          const summary = analyzeProject(sourceFiles, lang);
-          astContext = generateContextForAgent(summary);
-        }
-      }
-    } catch {
-      /* AST not available, proceed without */
-    }
-
-    const extractOpts = {};
-    if (astContext) {
-      extractOpts.astContext = astContext;
-    }
-    if (comprehensive) {
-      extractOpts.comprehensive = true;
-    }
-    // 传递用户语言偏好，让 AI 输出匹配用户语言
-    if (ctx.lang && ctx.lang !== 'en') {
-      extractOpts.lang = ctx.lang;
-    }
-
-    // 首选：使用当前 aiProvider
-    let recipes;
-    let fallbackUsed;
-    try {
-      recipes = await ctx.aiProvider.extractRecipes(targetName, files, extractOpts);
-    } catch (primaryErr) {
-      // 尝试 fallback（如果 AiFactory 可用）
-      let recovered = false;
-      try {
-        const aiFactory = ctx.container?.singletons?._aiFactory;
-        if (aiFactory?.isGeoOrProviderError?.(primaryErr)) {
-          const currentProvider = (process.env.ASD_AI_PROVIDER || 'google').toLowerCase();
-          const fallbacks = aiFactory.getAvailableFallbacks(currentProvider);
-          for (const fbName of fallbacks) {
-            try {
-              const fbProvider = aiFactory.createProvider({ provider: fbName });
-              recipes = await fbProvider.extractRecipes(targetName, files, extractOpts);
-              fallbackUsed = fbName;
-              recovered = true;
-              break;
-            } catch {
-              /* next fallback */
-            }
-          }
-        }
-      } catch {
-        /* AiFactory not available */
-      }
-      if (!recovered) {
-        throw primaryErr;
-      }
-    }
-
-    if (!Array.isArray(recipes)) {
-      recipes = [];
-    }
-    if (recipes.length === 0) {
-      ctx.logger?.warn?.(
-        `[extract_recipes] AI returned 0 recipes for ${targetName} (${files.length} files)`
-      );
-    }
-
-    // ── V3 直透：AI 已输出完整 V3 结构，仅做来源标记 + 程序化评分/标签 ──
-    let qualityScorer = null;
-    let recipeExtractor = null;
-    try {
-      qualityScorer = ctx.container?.get?.('qualityScorer');
-    } catch {
-      /* not available */
-    }
-    try {
-      recipeExtractor = ctx.container?.get?.('recipeExtractor');
-    } catch {
-      /* not available */
-    }
-
-    for (const recipe of recipes) {
-      // 来源 & 生命周期（非 AI 职责）
-      recipe.source = recipe.source || 'ai-scan';
-      recipe.lifecycle = recipe.lifecycle || 'pending';
-
-      // RecipeExtractor 语义标签增强（程序化补充，不替代 AI tags）
-      const codeText = recipe.content?.pattern || '';
-      if (recipeExtractor && codeText) {
-        try {
-          const extracted = recipeExtractor.extractFromContent(
-            codeText,
-            `${recipe.title || 'unknown'}.${recipe.language || 'unknown'}`,
-            ''
-          );
-          if (extracted.semanticTags?.length > 0) {
-            recipe.tags = [...new Set([...(recipe.tags || []), ...extracted.semanticTags])];
-          }
-          if (
-            (!recipe.category || recipe.category === 'Utility') &&
-            extracted.category &&
-            extracted.category !== 'general'
-          ) {
-            recipe.category = extracted.category;
-          }
-        } catch {
-          /* best effort */
-        }
-      }
-
-      // QualityScorer 评分 → quality 结构化
-      if (qualityScorer) {
-        try {
-          const scoreResult = qualityScorer.score(recipe);
-          recipe.quality = {
-            completeness: 0,
-            adaptation: 0,
-            documentation: 0,
-            overall: scoreResult.score ?? 0,
-            grade: scoreResult.grade || '',
-          };
-        } catch {
-          /* best effort */
-        }
-      }
-    }
-
-    const result = { targetName, extracted: recipes.length, recipes };
-    if (fallbackUsed) {
-      result.fallbackUsed = fallbackUsed;
-    }
-    return result;
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 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/tools/knowledge-graph.js

@@ -1,234 +0,0 @@
-/**
- * knowledge-graph.js — 知识图谱类工具 (3)
- *
- * 10. check_duplicate     候选查重
- * 11. discover_relations  AI 关系发现
- * 12. add_graph_edge      手动添加图谱边
- */
-
-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，建议人工审核是否重复。'
-              : '有低相似度匹配，大概率不是重复。',
-      },
-    };
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 11. discover_relations
-// ────────────────────────────────────────────────────────────
-export const discoverRelations = {
-  name: 'discover_relations',
-  description:
-    'AI 知识图谱关系发现 — 分析 Recipe 对之间的潜在关系（requires/extends/enforces/calls 等），并自动写入知识图谱。',
-  parameters: {
-    type: 'object',
-    properties: {
-      recipePairs: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            a: {
-              type: 'object',
-              properties: {
-                id: { type: 'string' },
-                title: { type: 'string' },
-                category: { type: 'string' },
-                code: { type: 'string' },
-              },
-            },
-            b: {
-              type: 'object',
-              properties: {
-                id: { type: 'string' },
-                title: { type: 'string' },
-                category: { type: 'string' },
-                code: { type: 'string' },
-              },
-            },
-          },
-        },
-        description:
-          'Recipe 对数组 [{ a: {id, title, category, code}, b: {id, title, category, code} }]',
-      },
-      dryRun: { type: 'boolean', description: '仅分析不写入，默认 false' },
-    },
-    required: ['recipePairs'],
-  },
-  handler: async (params, ctx) => {
-    if (!ctx.aiProvider) {
-      return { error: 'AI provider not available' };
-    }
-
-    const { recipePairs, dryRun = false } = params;
-    if (!recipePairs || recipePairs.length === 0) {
-      return { relations: [] };
-    }
-
-    // 构建 LLM prompt
-    const pairsText = recipePairs
-      .map(
-        (p, i) => `
---- Pair #${i + 1} ---
-Recipe A [${p.a.id}]: ${p.a.title} (${p.a.category}/${p.a.language || ''})
-${p.a.code ? `Code: ${p.a.code.substring(0, 300)}` : ''}
-
-Recipe B [${p.b.id}]: ${p.b.title} (${p.b.category}/${p.b.language || ''})
-${p.b.code ? `Code: ${p.b.code.substring(0, 300)}` : ''}`
-      )
-      .join('\n');
-
-    const prompt = `# Role
-You are a Software Architect analyzing relationships between code recipes (knowledge units).
-
-# Goal
-For each Recipe pair below, determine if there is a meaningful relationship.
-
-# Relationship Types
-- requires: A needs B to function
-- extends: A builds upon / enriches B
-- enforces: A enforces rules defined in B
-- depends_on: A depends on B
-- inherits: A inherits from B (class/protocol)
-- implements: A implements interface/protocol defined in B
-- calls: A calls API defined in B
-- prerequisite: B must be learned/applied before A
-- none: No meaningful relationship
-
-# Output
-Return a JSON array. For each pair with a relationship (skip "none"):
-{ "index": 0, "from_id": "...", "to_id": "...", "relation": "requires", "confidence": 0.85, "reason": "A uses the network client defined in B" }
-
-Return ONLY a JSON array. No markdown, no extra text. Return [] if no relationships found.
-
-# Recipe Pairs
-${pairsText}`;
-
-    const parsed = await ctx.aiProvider.chatWithStructuredOutput(prompt, {
-      openChar: '[',
-      closeChar: ']',
-      temperature: 0.2,
-    });
-    const relations = Array.isArray(parsed) ? parsed : [];
-
-    // 写入知识图谱（除非 dryRun）
-    if (!dryRun && relations.length > 0) {
-      try {
-        const kgService = ctx.container.get('knowledgeGraphService');
-        for (const rel of relations) {
-          if (rel.from_id && rel.to_id && rel.relation && rel.relation !== 'none') {
-            kgService.addEdge(rel.from_id, 'recipe', rel.to_id, 'recipe', rel.relation, {
-              confidence: rel.confidence || 0.5,
-              reason: rel.reason || '',
-              source: 'ai-discovery',
-            });
-          }
-        }
-      } catch {
-        /* KG not available */
-      }
-    }
-
-    return {
-      analyzed: recipePairs.length,
-      relations: relations.filter((r) => r.relation !== 'none'),
-      written: dryRun ? 0 : relations.filter((r) => r.relation !== 'none').length,
-    };
-  },
-};
-
-// ────────────────────────────────────────────────────────────
-// 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/chat/tools.js

@@ -1,18 +0,0 @@
-/**
- * tools.js — ChatAgent 工具定义统一入口 (Barrel Re-export)
- *
- * 实际工具定义已拆分到 ./tools/ 子目录:
- *   - project-access.js  项目数据访问 (5)
- *   - query.js           查询类 (6)
- *   - ai-analysis.js     AI 分析类 (4)
- *   - knowledge-graph.js  知识图谱 (3)
- *   - guard.js           Guard 安全类 (6)
- *   - lifecycle.js       生命周期操作类 (11)
- *   - infrastructure.js  基础设施 + Skills (7)
- *   - composite.js       组合工具 + 元工具 (6)
- *   - ast-graph.js       AST 分析 + Agent Memory (10)
- *
- * 本文件仅做 re-export，保持向后兼容。
- */
-
-export { ALL_TOOLS, default } from './tools/index.js';

package/lib/service/snippet/PlaceholderConverter.js

@@ -1,5 +0,0 @@
-/**
- * @deprecated Moved to lib/platform/ios/snippet/PlaceholderConverter.js
- * This re-export shim maintains backward compatibility.
- */
-export { PlaceholderConverter } from '../../platform/ios/snippet/PlaceholderConverter.js';

package/lib/service/snippet/codecs/XcodeCodec.js

@@ -1,5 +0,0 @@
-/**
- * @deprecated Moved to lib/platform/ios/snippet/XcodeCodec.js
- * This re-export shim maintains backward compatibility.
- */
-export { XcodeCodec } from '../../../platform/ios/snippet/XcodeCodec.js';