autosnippet 3.2.3 → 3.2.6

package/lib/service/chat/HandoffProtocol.js

@@ -211,7 +211,7 @@ export function buildAnalysisReport(analystResult, dimensionId, projectGraph = n
  * - evidenceMap: 文件 → 代码片段 + 摘要 (Producer 可直接引用)
  * - explorationLog: 工具调用意图 + 结果摘要序列
  * - negativeSignals: 搜索但未找到的模式 (告知 Producer 不要猜测)
- * - findings: 来自 WorkingMemory 的结构化发现
+ * - findings: 来自 ActiveContext 的结构化发现
  * - qualityReport: 多维度质量评分
  *
  * 向后兼容: 返回对象包含 v1 的所有字段 (analysisText, referencedFiles, searchQueries, classesExplored, metadata)
@@ -219,10 +219,10 @@ export function buildAnalysisReport(analystResult, dimensionId, projectGraph = n
  * @param {object} analystResult — ChatAgent.execute() 返回值
  * @param {string} dimensionId — 维度 ID
  * @param {object} [projectGraph] — ProjectGraph 实例
- * @param {object} [workingMemory] — WorkingMemory 实例 (提供 distill 结果)
+ * @param {object} [activeContext] — ActiveContext 实例 (提供 distill 结果)
  * @returns {AnalysisArtifact}
  */
-export function buildAnalysisArtifact(analystResult, dimensionId, projectGraph = null, workingMemory = null) {
+export function buildAnalysisArtifact(analystResult, dimensionId, projectGraph = null, activeContext = null) {
   const toolCalls = analystResult.toolCalls || [];
 
   // §1: 构建 v1 报告 (复用已有逻辑获取 referencedFiles, searchQueries 等)
@@ -235,13 +235,12 @@ export function buildAnalysisArtifact(analystResult, dimensionId, projectGraph =
   }
   const evidence = collector.build();
 
-  // §3: 从 WorkingMemory 获取结构化发现
-  const distilled = workingMemory?.distill() || { keyFindings: [], toolCallSummary: [] };
+  // §3: 从 ActiveContext 获取结构化发现 (保持与 distill() 一致的规范形状)
+  const distilled = activeContext?.distill() || { keyFindings: [], toolCallSummary: [] };
   const findings = distilled.keyFindings.map((f) => ({
-    claim: f.finding,
-    evidence: f.evidence ? [f.evidence] : [],
+    finding: f.finding,
+    evidence: f.evidence || '',
     importance: f.importance,
-    source: 'note_finding',
   }));
 
   // §4: 合并引用文件 (v1 提取 + evidenceMap 中的文件)
@@ -327,7 +326,7 @@ function buildQualityScores(analysisText, findings, evidence) {
 
   // §3: evidenceScore — 发现数量 + 有证据的发现比例
   const findingCount = findings?.length || 0;
-  const evidencedFindings = (findings || []).filter((f) => f.evidence.length > 0).length;
+  const evidencedFindings = (findings || []).filter((f) => f.evidence && f.evidence.length > 0).length;
   scores.evidenceScore =
     findingCount > 0
       ? Math.min(100, (evidencedFindings / findingCount) * 60 + findingCount * 10)

package/lib/service/chat/Memory.js

@@ -1,4 +1,8 @@
 /**
+ * @deprecated Phase 5: 已由 PersistentMemory 取代。
+ *   数据可通过 `PersistentMemory.migrateFromLegacy(projectRoot)` 迁移到 SQLite。
+ *   新代码请使用 `import { PersistentMemory } from './memory/PersistentMemory.js'`
+ *
  * Memory — 跨对话轻量记忆（带 source 隔离 + 去重）
  *
  * 设计:

package/lib/service/chat/ProducerAgent.js

@@ -143,15 +143,15 @@ function buildProducerPromptV2(artifact, dimConfig, projectInfo) {
   // §2 分析内容
   parts.push(`---\n${artifact.analysisText}\n---`);
 
-  // §3 结构化发现 (NEW — 来自 WorkingMemory note_finding)
+  // §3 结构化发现 (来自 ActiveContext note_finding)
   if (artifact.findings?.length > 0) {
     const findingLines = ['## 关键发现 (Analyst 已确认)'];
     const sorted = [...artifact.findings].sort((a, b) => b.importance - a.importance);
     for (const f of sorted) {
       const badge = f.importance >= 8 ? '⚠️' : '📋';
-      findingLines.push(`${badge} **[${f.importance}/10]** ${f.claim}`);
-      if (f.evidence.length > 0) {
-        findingLines.push(`  证据: ${f.evidence.join(', ')}`);
+      findingLines.push(`${badge} **[${f.importance}/10]** ${f.finding}`);
+      if (f.evidence) {
+        findingLines.push(`  证据: ${f.evidence}`);
       }
     }
     findingLines.push('');
@@ -303,9 +303,11 @@ export class ProducerAgent {
         budget,
         systemPromptOverride: PRODUCER_SYSTEM_PROMPT,
         allowedTools: PRODUCER_TOOLS,
-        disablePhaseRouter: true,
+        strategy: 'producer',
         temperature: 0.3,
         projectLanguage: projectInfo.lang,
+        // v5.0: 统一 MemoryCoordinator (修复 B2: Producer 获得 WM distilled context)
+        memoryCoordinator: options.memoryCoordinator || undefined,
         dimensionMeta: {
           id: dimId,
           outputType: dimConfig.outputType || 'candidate',
@@ -350,9 +352,10 @@ export class ProducerAgent {
             budget: { ...budget, maxIterations: 5, maxSubmits: rejectedCount },
             systemPromptOverride: PRODUCER_SYSTEM_PROMPT,
             allowedTools: PRODUCER_TOOLS,
-            disablePhaseRouter: true,
+            strategy: 'producer',
             temperature: 0.3,
             projectLanguage: projectInfo.lang,
+            memoryCoordinator: options.memoryCoordinator || undefined,
             dimensionMeta: {
               id: dimId,
               outputType: dimConfig.outputType || 'candidate',

package/lib/service/chat/ProjectSemanticMemory.js

@@ -1,4 +1,8 @@
 /**
+ * @deprecated Phase 5: 已由 PersistentMemory 继承增强。
+ *   新代码请使用 `import { PersistentMemory } from './memory/PersistentMemory.js'`
+ *   本文件保留作为 PersistentMemory 的父类，暂不删除。
+ *
  * ProjectSemanticMemory — 项目级永久语义记忆 (Tier 3)
  *
  * 替代/增强 Memory.js 的 JSONL 存储，使用 SQLite 提供:

package/lib/service/chat/ReasoningTrace.js

@@ -1,6 +1,10 @@
 /**
  * ReasoningTrace — 单次 execute() 的完整推理链记录
  *
+ * @deprecated Phase 3: 已合并入 ActiveContext (lib/service/chat/memory/ActiveContext.js)
+ *   - rounds + plan + thoughts + extractAndSetPlan + buildObservationMeta 已迁入 ActiveContext
+ *   - 本文件保留做向后兼容，新代码请使用 ActiveContext
+ *
  * 记录每轮 ReAct 循环的四要素:
  *   Thought     → AI 在执行工具前的推理文本
  *   Action      → 调用了什么工具、什么参数
@@ -315,6 +319,184 @@ export class ReasoningTrace {
     return [...new Set([...quoted, ...camelCase, ...acronyms])];
   }
 
+  // ─── 从 ReasoningLayer 迁入的方法 ─────────────────────
+
+  /**
+   * 从 AI 响应文本中提取计划，自动调用 setPlan/updatePlan
+   * （合并了 ReasoningLayer.afterAICall 中 plan 提取逻辑）
+   *
+   * @param {string} text — AI 完整响应文本
+   * @param {number} iteration — 当前轮次
+   * @returns {boolean} — 是否成功提取到计划
+   */
+  extractAndSetPlan(text, iteration) {
+    const planText = this.#extractPlanFromText(text);
+    if (!planText) return false;
+
+    if (this.#plan) {
+      this.updatePlan(planText, iteration);
+    } else {
+      this.setPlan(planText, iteration);
+    }
+    return true;
+  }
+
+  /**
+   * 从 AI 响应文本中提取"计划"部分（从 ReasoningLayer 迁入）
+   *
+   * 策略:
+   *   1. 查找"计划/plan/步骤"标记后的编号列表
+   *   2. 如果没有明确标记，提取文本前部分的编号列表
+   *
+   * @param {string} text — AI 完整响应文本
+   * @returns {string|null}
+   * @private
+   */
+  #extractPlanFromText(text) {
+    if (!text || text.length < 30) return null;
+
+    const searchArea = text.substring(0, 2000);
+
+    // 策略 1: 查找"计划"标记
+    const planMarkers = [
+      /(?:探索|分析)?计划[:：\s]/i,
+      /(?:my\s+)?plan[:：\s]/i,
+      /步骤[:：\s]/i,
+      /以下是.*(?:计划|步骤)/i,
+    ];
+
+    let planStart = -1;
+    for (const marker of planMarkers) {
+      const match = searchArea.match(marker);
+      if (match) {
+        planStart = match.index + match[0].length;
+        break;
+      }
+    }
+
+    // 策略 2: 如果没有标记，查找第一个编号列表
+    if (planStart === -1) {
+      const listMatch = searchArea.match(/\n\s*1[.)]\s+/);
+      if (listMatch) {
+        planStart = listMatch.index;
+      }
+    }
+
+    if (planStart === -1) return null;
+
+    const remaining = searchArea.substring(planStart);
+    const lines = remaining.split('\n');
+    const planLines = [];
+    let inList = false;
+
+    for (const line of lines) {
+      if (/^\s*(?:\d+[.)]\s+|[-*]\s+)/.test(line)) {
+        inList = true;
+        planLines.push(line);
+      } else if (inList && line.trim() === '') {
+        break;
+      } else if (inList) {
+        break;
+      }
+    }
+
+    return planLines.length >= 2 ? planLines.join('\n').trim() : null;
+  }
+
+  /**
+   * 从工具执行结果构建结构化观察元数据（从 ReasoningLayer 迁入）
+   *
+   * 不改变工具结果传给 AI 的内容，只影响 ReasoningTrace 记录
+   *
+   * @param {string} toolName
+   * @param {object} args
+   * @param {*} result
+   * @param {boolean} isNew — 由 ExplorationTracker.recordToolCall 提供
+   * @returns {{ gotNewInfo: boolean, resultType: string, keyFacts: string[], resultSize: number }}
+   */
+  static buildObservationMeta(toolName, args, result, isNew) {
+    const meta = {
+      gotNewInfo: isNew,
+      resultType: 'unknown',
+      keyFacts: [],
+      resultSize: 0,
+    };
+
+    const resultStr = typeof result === 'string' ? result : JSON.stringify(result || '');
+    meta.resultSize = resultStr.length;
+
+    switch (toolName) {
+      case 'search_project_code': {
+        meta.resultType = 'search';
+        const matches = result?.matches || [];
+        const batchResults = result?.batchResults;
+        const totalMatches = batchResults
+          ? Object.values(batchResults).reduce((s, br) => s + (br.matches?.length || 0), 0)
+          : matches.length;
+        meta.keyFacts.push(`${totalMatches} matches found`);
+        if (isNew) meta.keyFacts.push('new files discovered');
+        break;
+      }
+
+      case 'read_project_file': {
+        meta.resultType = 'file_content';
+        const fp = args?.filePath || '';
+        const fps = args?.filePaths || [];
+        const allPaths = fp ? [fp, ...fps] : fps;
+        meta.keyFacts.push(`read ${allPaths.length} file(s)`);
+        break;
+      }
+
+      case 'submit_knowledge':
+      case 'submit_with_check': {
+        meta.resultType = 'submit';
+        meta.gotNewInfo = true; // submit 本身就是进展
+        const status = typeof result === 'object' ? result?.status || 'ok' : 'ok';
+        const title = args?.title || '(untitled)';
+        meta.keyFacts.push(`submit "${title}": ${status}`);
+        break;
+      }
+
+      case 'list_project_structure': {
+        meta.resultType = 'structure';
+        meta.keyFacts.push(`list ${args?.directory || '/'}`);
+        break;
+      }
+
+      case 'get_class_info':
+      case 'get_class_hierarchy':
+      case 'get_protocol_info':
+      case 'get_method_overrides':
+      case 'get_category_map': {
+        meta.resultType = 'ast_query';
+        const target = args?.className || args?.protocolName || args?.name || '';
+        meta.keyFacts.push(`${toolName}(${target})`);
+        break;
+      }
+
+      case 'get_project_overview': {
+        meta.resultType = 'overview';
+        meta.keyFacts.push('project overview');
+        break;
+      }
+
+      case 'semantic_search_code':
+      case 'get_file_summary':
+      case 'get_previous_analysis': {
+        meta.resultType = 'query';
+        meta.keyFacts.push(toolName);
+        break;
+      }
+
+      default: {
+        meta.resultType = 'other';
+        meta.keyFacts.push(toolName);
+      }
+    }
+
+    return meta;
+  }
+
   /**
    * 可序列化输出
    * @returns {object}

package/lib/service/chat/WorkingMemory.js

@@ -1,6 +1,10 @@
 /**
  * WorkingMemory — 会话级工作记忆 (Tier 1)
  *
+ * @deprecated Phase 3: 已合并入 ActiveContext (lib/service/chat/memory/ActiveContext.js)
+ *   - Scratchpad + 工具压缩策略 + buildContext + distill 已迁入 ActiveContext
+ *   - 本文件保留做向后兼容，新代码请使用 ActiveContext
+ *
  * 管理单次 ChatAgent.execute() 中的上下文压缩与关键发现暂存。
  *
  * 策略: