autosnippet 3.2.8 → 3.2.10

package/lib/service/{chat → agent/domain}/ChatAgentTasks.js

@@ -1,8 +1,8 @@
 /**
- * ChatAgentTasks — ChatAgent 预定义任务方法（从 ChatAgent.js 提取）
+ * ChatAgentTasks — Agent 预定义任务方法
  *
- * 每个任务接收 context 对象: { executeTool, aiProvider, container, logger }
- * - executeTool(toolName, params) — 执行指定工具
+ * 每个任务接收 context 对象: { invokeAgent, aiProvider, container, logger }
+ * - invokeAgent(toolName, params) — 直接执行工具 handler（纯数据工具）
  * - aiProvider — AI Provider 实例
  * - container — ServiceContainer
  * - logger — Logger 实例
@@ -14,10 +14,10 @@
  * 2. 顺便返回质量评估建议
  */
 export async function taskCheckAndSubmit(context, { candidate, projectRoot }) {
-  const { executeTool, aiProvider } = context;
+  const { invokeAgent, aiProvider } = context;
 
   // Step 1: 查重
-  const duplicates = await executeTool('check_duplicate', {
+  const duplicates = await invokeAgent('check_duplicate', {
     candidate,
     projectRoot,
     threshold: 0.5,
@@ -61,102 +61,19 @@ ${highSim.map((s) => `- ${s.title} (相似度: ${s.similarity})`).join('\n')}
 
 /**
  * 任务: 批量发现 Recipe 间的知识图谱关系
- * 遍历所有 Recipe，两两分析可能的关系
+ * 委托给 AgentFactory.discoverRelations (独立 Explore → Synthesize 管线)
  */
 export async function taskDiscoverAllRelations(context, { batchSize = 20 } = {}) {
-  const { executeTool, aiProvider, container, logger } = context;
-
-  const knowledgeService = container.get('knowledgeService');
-  if (!knowledgeService) {
-    throw new Error('KnowledgeService 不可用');
-  }
-
-  if (!aiProvider) {
-    throw new Error('AI Provider 未配置，请先设置 API Key');
-  }
-
-  // 获取所有活跃知识条目
-  const { items = [], data = [] } = await knowledgeService.list(
-    { lifecycle: 'active' },
-    { page: 1, pageSize: 500 }
-  );
-  const recipes = items.length > 0 ? items : data;
-  if (recipes.length < 2) {
-    return {
-      discovered: 0,
-      totalPairs: 0,
-      message: `只有 ${recipes.length} 条 Recipe，至少需要 2 条`,
-    };
-  }
-
-  // 按 batch 分组分析
-  const pairs = [];
-  for (let i = 0; i < recipes.length; i++) {
-    for (let j = i + 1; j < recipes.length; j++) {
-      pairs.push([recipes[i], recipes[j]]);
-    }
-  }
-
-  let discovered = 0;
-  const results = [];
-  let batchErrors = 0;
-
-  // 分批处理，单批失败不终止整体
-  for (let b = 0; b < pairs.length; b += batchSize) {
-    const batch = pairs.slice(b, b + batchSize);
-    try {
-      const result = await executeTool('discover_relations', {
-        recipePairs: batch.map(([a, b]) => ({
-          a: {
-            id: a.id,
-            title: a.title,
-            category: a.category,
-            language: a.language,
-            code: String(a.content || a.code || '').substring(0, 500),
-          },
-          b: {
-            id: b.id,
-            title: b.title,
-            category: b.category,
-            language: b.language,
-            code: String(b.content || b.code || '').substring(0, 500),
-          },
-        })),
-      });
-
-      if (result.error) {
-        batchErrors++;
-        logger.warn(
-          `[DiscoverRelations] Batch ${Math.floor(b / batchSize) + 1} error: ${result.error}`
-        );
-        continue;
-      }
-      if (result.relations) {
-        discovered += result.relations.length;
-        results.push(...result.relations);
-      }
-    } catch (err) {
-      batchErrors++;
-      logger.warn(
-        `[DiscoverRelations] Batch ${Math.floor(b / batchSize) + 1} threw: ${err.message}`
-      );
-    }
-  }
-
-  return {
-    discovered,
-    totalPairs: pairs.length,
-    totalBatches: Math.ceil(pairs.length / batchSize),
-    batchErrors,
-    relations: results,
-  };
+  const { container } = context;
+  const agentFactory = container.get('agentFactory');
+  return agentFactory.discoverRelations({ batchSize });
 }
 
 /**
  * 任务: 批量 AI 补全候选语义字段
  */
 export async function taskFullEnrich(context, { status = 'pending', maxCount = 50 } = {}) {
-  const { executeTool, container } = context;
+  const { invokeAgent, container } = context;
 
   const knowledgeService = container.get('knowledgeService');
 
@@ -179,7 +96,7 @@ export async function taskFullEnrich(context, { status = 'pending', maxCount = 5
     return { enriched: 0, message: 'All candidates already enriched' };
   }
 
-  const result = await executeTool('enrich_candidate', {
+  const result = await invokeAgent('enrich_candidate', {
     candidateIds: needEnrich.map((c) => c.id).slice(0, 20),
   });
 
@@ -191,7 +108,7 @@ export async function taskFullEnrich(context, { status = 'pending', maxCount = 5
  * 对活跃 Recipe 逐个评分，返回低于阈值的列表
  */
 export async function taskQualityAudit(context, { threshold = 0.6, maxCount = 100 } = {}) {
-  const { executeTool, container } = context;
+  const { invokeAgent, container } = context;
 
   const knowledgeService = container.get('knowledgeService');
 
@@ -208,7 +125,7 @@ export async function taskQualityAudit(context, { threshold = 0.6, maxCount = 10
   const gradeDistribution = { A: 0, B: 0, C: 0, D: 0, F: 0 };
 
   for (const recipe of recipes) {
-    const scoreResult = await executeTool('quality_score', { recipe });
+    const scoreResult = await invokeAgent('quality_score', { recipe });
     if (scoreResult.grade) {
       gradeDistribution[scoreResult.grade] = (gradeDistribution[scoreResult.grade] || 0) + 1;
     }
@@ -239,14 +156,14 @@ export async function taskQualityAudit(context, { threshold = 0.6, maxCount = 10
  * 对代码运行全部 Guard 规则 + 生成修复建议
  */
 export async function taskGuardFullScan(context, { code, language, filePath } = {}) {
-  const { executeTool, aiProvider } = context;
+  const { invokeAgent, aiProvider } = context;
 
   if (!code) {
     return { error: 'code is required' };
   }
 
   // Step 1: 静态检查
-  const checkResult = await executeTool('guard_check_code', {
+  const checkResult = await invokeAgent('guard_check_code', {
     code,
     language: language || 'unknown',
     scope: 'project',

package/lib/service/{chat → agent/domain}/EpisodicConsolidator.js

@@ -2,18 +2,18 @@
  * EpisodicConsolidator — Episodic → Semantic 固化引擎
  *
  * Bootstrap 完成后，将 SessionStore (Tier 2) 中的维度分析结果
- * 提炼为结构化记忆，固化到 ProjectSemanticMemory (Tier 3)。
+ * 提炼为结构化记忆，固化到 PersistentMemory (Tier 3)。
  *
  * 固化策略 (规则化，无需额外 AI 调用):
  *   1. 从每个维度的 findings 提取 fact 记忆
  *   2. 从 Tier Reflections 的 crossDimensionPatterns 提取 insight 记忆
  *   3. 从 analysisText 中提取项目级别事实 (正则匹配)
- *   4. 使用 ProjectSemanticMemory.consolidate() 进行去重和合并
+ *   4. 使用 PersistentMemory.consolidate() 进行去重和合并
  *
  * @module EpisodicConsolidator
  */
 
-import Logger from '../../infrastructure/logging/Logger.js';
+import Logger from '../../../infrastructure/logging/Logger.js';
 
 // ──────────────────────────────────────────────────────────────
 // 正则: 从分析文本中提取陈述性知识
@@ -57,14 +57,14 @@ const INSIGHT_PATTERNS = [
 // ──────────────────────────────────────────────────────────────
 
 export class EpisodicConsolidator {
-  /** @type {import('./ProjectSemanticMemory.js').ProjectSemanticMemory} */
+  /** @type {import('../memory/PersistentMemory.js').PersistentMemory} */
   #semanticMemory;
 
   /** @type {import('../../infrastructure/logging/Logger.js').default} */
   #logger;
 
   /**
-   * @param {import('./ProjectSemanticMemory.js').ProjectSemanticMemory} semanticMemory
+   * @param {import('../memory/PersistentMemory.js').PersistentMemory} semanticMemory
    * @param {object} [opts]
    * @param {object} [opts.logger]
    */
@@ -74,9 +74,9 @@ export class EpisodicConsolidator {
   }
 
   /**
-   * 执行固化: SessionStore → ProjectSemanticMemory
+   * 执行固化: SessionStore → PersistentMemory
    *
-   * @param {import('./memory/SessionStore.js').SessionStore} sessionStore
+   * @param {import('../memory/SessionStore.js').SessionStore} sessionStore
    * @param {object} [opts]
    * @param {string} [opts.bootstrapSession] — Bootstrap session ID
    * @param {boolean} [opts.clearPrevious=false] — 是否先清除旧的 bootstrap 记忆

package/lib/service/{chat → agent/domain}/EvidenceCollector.js

@@ -1,8 +1,10 @@
 /**
  * EvidenceCollector.js — 从 Analyst 工具调用中收集结构化证据
  *
- * HandoffProtocol v2 核心组件: 将 Analyst 的 toolCall 序列转化为
- * 类型化的证据地图、探索日志和负空间信号，供 Producer 直接引用。
+ * Bootstrap 质量门控核心组件: 将 Analyst 阶段的 toolCall 序列转化为
+ * 类型化的证据地图、探索日志和负空间信号，供 Producer 阶段直接引用。
+ *
+ * 被 bootstrap-gate.js (buildAnalysisArtifact) 调用。
  *
  * 设计原则:
  * - 不保留原始工具返回值 (体积过大)

package/lib/service/{chat/AnalystAgent.js → agent/domain/insight-analyst.js}

@@ -1,26 +1,25 @@
 /**
- * AnalystAgent.js — v3.0 分析者 Agent
+ * insight-analyst.js — Insight Analyst 领域函数
  *
- * 职责:
- * - 使用 AST 工具 + 文件搜索工具自由探索代码库
- * - 输出自然语言分析结果 (无格式约束)
- * - 不提交候选、不关心格式
+ * 从旧 AnalystAgent.js 提取的纯领域逻辑:
+ * - Analyst System Prompt
+ * - 工具白名单
+ * - 预算常量
+ * - 9 段式 Prompt 构建器
  *
- * 设计哲学:
- * "给 AI 一个任务描述和一套好工具，让它像资深工程师一样自由探索代码库。"
+ * 被 PipelineStrategy 的 bootstrap preset 直接引用。
+ * 不再包含任何 Agent 类 — Agent 由 AgentRuntime + PipelineStrategy 驱动。
  *
- * @module AnalystAgent
+ * @module insight-analyst
  */
 
-import Logger from '../../infrastructure/logging/Logger.js';
-import { analysisQualityGate, buildAnalysisReport, buildAnalysisArtifact, buildRetryPrompt } from './HandoffProtocol.js';
-import { getDimensionSOP } from '../../external/mcp/handlers/bootstrap/shared/dimension-sop.js';
+import { getDimensionSOP } from '../../../external/mcp/handlers/bootstrap/shared/dimension-sop.js';
 
 // ──────────────────────────────────────────────────────────────────
 // System Prompt — Analyst 专用 (~100 tokens)
 // ──────────────────────────────────────────────────────────────────
 
-const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在深度分析一个真实项目的某个维度。
+export const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在深度分析一个真实项目的某个维度。
 
 ## 执行计划
 你有 **N 轮**工具调用机会（系统会告知具体数字）。请严格按以下节奏分配：
@@ -50,7 +49,7 @@ const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在深度
 // Analyst 可用工具白名单 — 只做探索，不做提交
 // ──────────────────────────────────────────────────────────────────
 
-const ANALYST_TOOLS = [
+export const ANALYST_TOOLS = [
   // AST 结构化分析
   'get_project_overview',
   'get_class_hierarchy',
@@ -77,30 +76,42 @@ const ANALYST_TOOLS = [
 // Analyst 预算 — 使用 analyst 策略（自由探索，无阶段约束）
 // ──────────────────────────────────────────────────────────────────
 
-const ANALYST_BUDGET = {
-  maxIterations: 24, // was 18 — 大项目维度需要充足探索轮次
-  searchBudget: 18, // was 14 — 匹配更大探索空间
-  searchBudgetGrace: 10, // was 8
-  maxSubmits: 0, // Analyst 不提交候选
+export const ANALYST_BUDGET = {
+  maxIterations: 24,
+  searchBudget: 18,
+  searchBudgetGrace: 10,
+  maxSubmits: 0,
   softSubmitLimit: 0,
-  idleRoundsToExit: 2, // 减少空转
+  idleRoundsToExit: 2,
 };
 
 // ──────────────────────────────────────────────────────────────────
-// 维度 Prompt 模板
+// 维度 Prompt 模板 (9 段式)
 // ──────────────────────────────────────────────────────────────────
 
 /**
  * 构建 Analyst Prompt
- * @param {object} dimConfig — 维度配置 { id, label, guide, focusKeywords }
+ *
+ * 9 段结构:
+ *   §1 任务描述
+ *   §2 维度指引
+ *   §3 SOP (分析步骤 + 常见错误)
+ *   §4 输出要求
+ *   §5 工具提示
+ *   §6 前序维度上下文 (SessionStore / DimensionContext)
+ *   §7 Tier Reflection 洞察
+ *   §8 历史语义记忆 (Tier 3)
+ *   §9 代码实体图谱 (Phase E)
+ *
+ * @param {object} dimConfig — 维度配置 { id, label, guide, focusKeywords, outputType }
  * @param {object} projectInfo — { name, lang, fileCount }
  * @param {object} [dimensionContext] — DimensionContext 实例 (跨维度上下文)
- * @param {object} [episodicMemory] — EpisodicMemory 实例 (v4.0 增强上下文)
- * @param {object} [semanticMemory] — ProjectSemanticMemory 实例 (v4.1 历史记忆)
+ * @param {object} [episodicMemory] — SessionStore 实例 (v4.0 增强上下文)
+ * @param {object} [semanticMemory] — PersistentMemory 实例 (v4.1 历史记忆)
  * @param {object} [codeEntityGraph] — CodeEntityGraph 实例 (Phase E 代码实体图谱)
  * @returns {string}
  */
-function buildAnalystPrompt(
+export function buildAnalystPrompt(
   dimConfig,
   projectInfo,
   dimensionContext,
@@ -137,8 +148,6 @@ function buildAnalystPrompt(
       }
     }
   } else if (dimConfig.guide) {
-    // 回退: 无 SOP 的维度使用 guide 作为关注要点
-    // guide 格式如 "命名约定、注释风格、文件组织规范"，按分隔符拆分为列表
     const items = dimConfig.guide.split(/[、，,/]/).map(s => s.trim()).filter(Boolean);
     if (items.length > 1) {
       parts.push(`重点关注:\n${items.map((f) => `- ${f}`).join('\n')}`);
@@ -170,8 +179,6 @@ ${depthHint}
   parts.push('使用 get_previous_evidence 工具查询前序维度对特定文件/类的分析证据，避免重复搜索。');
 
   // §6 前序维度分析摘要 (Tier 2+ 才有)
-  // v4.0: 优先使用 EpisodicMemory (更丰富的发现 + 文件清单 + 交叉引用)，
-  //        回退到 DimensionContext (兼容)
   if (episodicMemory) {
     const emContext = episodicMemory.buildContextForDimension(
       dimConfig.id,
@@ -204,7 +211,7 @@ ${depthHint}
     }
   }
 
-  // §8: 历史语义记忆 (Tier 3) — 上次 Bootstrap 遗留的项目级知识
+  // §8: 历史语义记忆 (Tier 3)
   if (semanticMemory) {
     try {
       const query = `${dimConfig.label} ${dimConfig.guide || ''} ${projectInfo.lang}`;
@@ -221,7 +228,7 @@ ${depthHint}
     }
   }
 
-  // §9: 代码实体图谱 (Phase E) — 类/协议/Category 关系拓扑
+  // §9: 代码实体图谱 (Phase E)
   if (codeEntityGraph) {
     try {
       const graphCtx = codeEntityGraph.generateContextForAgent({ maxEntities: 20, maxEdges: 40 });
@@ -236,145 +243,3 @@ ${depthHint}
 
   return parts.join('\n\n');
 }
-
-// ──────────────────────────────────────────────────────────────────
-// AnalystAgent 类
-// ──────────────────────────────────────────────────────────────────
-
-export class AnalystAgent {
-  /** @type {import('./ChatAgent.js').ChatAgent} */
-  #chatAgent;
-
-  /** @type {import('../../core/ast/ProjectGraph.js').default} */
-  #projectGraph;
-
-  /** @type {import('../../infrastructure/logging/Logger.js').default} */
-  #logger;
-
-  /** @type {number} Gate 最大重试次数 */
-  #maxRetries;
-
-  /**
-   * @param {object} chatAgent — ChatAgent 实例
-   * @param {object} [projectGraph] — ProjectGraph 实例
-   * @param {object} [options]
-   * @param {number} [options.maxRetries=1] — Gate 失败最大重试次数
-   */
-  constructor(chatAgent, projectGraph = null, options = {}) {
-    this.#chatAgent = chatAgent;
-    this.#projectGraph = projectGraph;
-    this.#logger = Logger.getInstance();
-    this.#maxRetries = options.maxRetries ?? 1;
-  }
-
-  /**
-   * 分析指定维度
-   *
-   * @param {object} dimConfig — 维度配置 { id, label, guide, focusKeywords }
-   * @param {object} projectInfo — { name, lang, fileCount }
-   * @param {object} [options]
-   * @param {string} [options.sessionId] — Bootstrap session ID
-   * @param {object} [options.dimensionContext] — DimensionContext 实例
-   * @returns {Promise<import('./HandoffProtocol.js').AnalysisReport>}
-   */
-  async analyze(dimConfig, projectInfo, options = {}) {
-    const dimId = dimConfig.id;
-    const prompt = buildAnalystPrompt(
-      dimConfig,
-      projectInfo,
-      options.dimensionContext,
-      options.memoryCoordinator?.getSessionStore(), // v5.0: SessionStore 提供跨维度上下文
-      options.semanticMemory, // v4.1: ProjectSemanticMemory 历史记忆
-      options.codeEntityGraph // Phase E: CodeEntityGraph 代码实体图谱
-    );
-
-    this.#logger.info(
-      `[AnalystAgent] ▶ analyzing dimension "${dimId}" — prompt ${prompt.length} chars`
-    );
-
-    let retries = 0;
-    let lastReport = null;
-
-    while (retries <= this.#maxRetries) {
-      const execPrompt =
-        retries === 0
-          ? prompt
-          : `${prompt}\n\n${buildRetryPrompt(lastReport?._gateReason || 'Analysis too short')}`;
-
-      try {
-        const result = await this.#chatAgent.execute(execPrompt, {
-          source: 'system',
-          conversationId: options.sessionId ? `analyst-${options.sessionId}-${dimId}` : undefined,
-          budget: ANALYST_BUDGET,
-          systemPromptOverride: ANALYST_SYSTEM_PROMPT,
-          allowedTools: ANALYST_TOOLS,
-          strategy: 'analyst',
-          temperature: 0.4,
-          dimensionMeta: {
-            id: dimId,
-            outputType: 'analysis',
-            allowedKnowledgeTypes: dimConfig.allowedKnowledgeTypes || [],
-          },
-          // v5.0: 统一 MemoryCoordinator
-          memoryCoordinator: options.memoryCoordinator || undefined,
-        });
-
-        // v5.0: 当有 MemoryCoordinator 时使用 ActiveContext 的 distill 结果
-        // 构建 AnalysisArtifact (包含 evidenceMap/findings/negativeSignals)
-        // 使用显式 scopeId 确保并行执行安全
-        const analystScopeId = `${dimId}:analyst`;
-        const ac = options.memoryCoordinator?.getActiveContext(analystScopeId);
-        const report = ac
-          ? buildAnalysisArtifact(result, dimId, this.#projectGraph, ac)
-          : buildAnalysisReport(result, dimId, this.#projectGraph);
-
-        // 附加推理链数据（如果 ChatAgent 返回了 ReasoningTrace）
-        if (result.reasoningTrace) {
-          report.reasoningStats = result.reasoningTrace.getStats();
-          report.thoughts = result.reasoningTrace.getThoughts();
-        }
-        if (result.reasoningQuality) {
-          report.reasoningQuality = result.reasoningQuality;
-        }
-
-        // 质量门控 — 传入 outputType 以调整门槛
-        const gate = analysisQualityGate(report, {
-          outputType: dimConfig.outputType || 'analysis',
-        });
-        if (gate.pass) {
-          this.#logger.info(
-            `[AnalystAgent] ✅ dimension "${dimId}" — ${report.analysisText.length} chars, ${report.referencedFiles.length} files referenced, ${report.metadata.toolCallCount} tool calls`
-          );
-          return report;
-        }
-
-        this.#logger.warn(
-          `[AnalystAgent] ⚠ Gate failed for "${dimId}": ${gate.reason} (action=${gate.action})`
-        );
-
-        if (gate.action === 'degrade') {
-          // 直接降级 — 不重试
-          report._gateResult = gate;
-          return report;
-        }
-
-        // retry
-        lastReport = report;
-        lastReport._gateReason = gate.reason;
-        retries++;
-      } catch (err) {
-        this.#logger.error(`[AnalystAgent] ❌ dimension "${dimId}" error: ${err.message}`);
-        // 返回空 report
-        return buildAnalysisReport({ reply: '', toolCalls: [] }, dimId, this.#projectGraph);
-      }
-    }
-
-    // 重试耗尽 — 返回最后一次结果
-    this.#logger.warn(`[AnalystAgent] Retries exhausted for "${dimId}" — returning last report`);
-    return (
-      lastReport || buildAnalysisReport({ reply: '', toolCalls: [] }, dimId, this.#projectGraph)
-    );
-  }
-}
-
-export default AnalystAgent;