autosnippet 3.2.8 → 3.2.9

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;