autosnippet 3.2.4 → 3.2.6

package/lib/service/chat/ChatAgentPrompts.js

@@ -7,17 +7,10 @@ import fs from 'node:fs';
 /**
  * 构建原生函数调用模式的系统提示词
  *
- * 设计原则:
- *   - 精简: bootstrap 模式不注入 SOUL.md 人格（节省 ~500 token）
- *   - 分层: 静态指令放 systemPrompt，动态上下文放 user prompt
- *   - 控制通过 PhaseRouter 状态机实现，不通过追加 user 消息
- *   - 工具描述已通过 functionDeclarations 传递，不重复
- *
  * @param {object} options
  * @param {string} options.currentSource — 'user' | 'system'
  * @param {string} options.projectBriefingCache — 项目概况缓存文本
- * @param {import('./Memory.js').Memory|null} options.memory — 跨对话记忆
- * @param {import('./ProjectSemanticMemory.js').ProjectSemanticMemory|null} options.semanticMemory — Tier 3 语义记忆
+ * @param {object} [options.memoryCoordinator] — MemoryCoordinator 实例
  * @param {object} options.budget — 预算配置
  * @param {string} options.soulPath — SOUL.md 文件路径
  * @returns {string}
@@ -25,8 +18,7 @@ import fs from 'node:fs';
 export function buildNativeToolSystemPrompt({
   currentSource,
   projectBriefingCache,
-  memory,
-  semanticMemory,
+  memoryCoordinator,
   budget = {},
   soulPath,
 }) {
@@ -41,9 +33,15 @@ export function buildNativeToolSystemPrompt({
       /* SOUL.md not available */
     }
 
+    // v5.0: 通过 coordinator 构建静态记忆 section
+    let memorySection = '';
+    if (memoryCoordinator) {
+      memorySection = memoryCoordinator.buildStaticMemoryPrompt({ mode: 'user' });
+    }
+
     return `${soulSection}
 你是 AutoSnippet 项目的统一 AI 中心。项目内所有 AI 推理和分析都通过你执行。
-${projectBriefingCache}${memory?.toPromptSection({ source: 'user' }) || ''}${semanticMemory?.toPromptSection({ source: 'user' }) || ''}
+${projectBriefingCache}${memorySection}
 
 ## 使用规则
 1. 当需要查询数据时，直接调用相应工具。

package/lib/service/chat/ContextWindow.js

@@ -11,7 +11,7 @@
  *   1. messages[0] 始终是原始 user prompt（不可删除）
  *   2. assistant(toolCalls) 与其 tool results 是原子单元（不可拆分）
  *   3. 每次 AI 调用前自动压缩到 TOKEN_BUDGET 以内
- *   4. 不通过追加 user 消息来控制 AI 行为（由 PhaseRouter 管理）
+ *   4. 不通过追加 user 消息来控制 AI 行为（由 ExplorationTracker 管理）
  *
  * 三级递进压缩:
  *   L1 (60-80%): 截断旧的 tool results 内容
@@ -149,7 +149,7 @@ export class ContextWindow {
   }
 
   /**
-   * 追加阶段过渡引导消息 — 轻量级 user 消息，用于在 PhaseRouter 阶段转换时
+   * 追加阶段过渡引导消息 — 轻量级 user 消息，用于在 ExplorationTracker 阶段转换时
    * 向 AI 明确传达新阶段的行为期望。与 appendUserMessage 功能相同，
    * 独立命名以便审计和搜索。
    * @param {string} content
@@ -647,297 +647,3 @@ function limitFileContent(result, maxChars) {
 
   return JSON.stringify(limited);
 }
-
-// ─── PhaseRouter ────────────────────────────────────────
-
-/**
- * 阶段路由器 — 管理 Agent ReAct 循环的阶段自动推进
- *
- * 取代散落在 while 循环中的多个状态变量:
- *   - wrapUpInjected → PRODUCE 阶段自动处理
- *   - searchOnlyRounds → EXPLORE 阶段自动计数
- *   - searchBudgetPromptInjected → EXPLORE→PRODUCE 自动转换
- *   - idleRoundsWithoutSubmit → PRODUCE 阶段自动计数
- *
- * 阶段流:
- *   candidate/dual: EXPLORE → PRODUCE → SUMMARIZE
- *   skill-only:     EXPLORE → SUMMARIZE
- */
-export class PhaseRouter {
-  /** @type {'EXPLORE'|'PRODUCE'|'SUMMARIZE'} */
-  #phase;
-  /** @type {number} 当前阶段内的轮次计数 */
-  #phaseRounds = 0;
-  /** @type {number} 连续无 submit 的轮次 */
-  #idleRounds = 0;
-  /** @type {number} 总迭代轮次 */
-  #totalIterations = 0;
-  /** @type {number} 总 submit 数 */
-  #totalSubmits = 0;
-  /** @type {Object} 预算配置 */
-  #budget;
-  /** @type {boolean} 是否为 skill-only 维度 */
-  #isSkillOnly;
-  /** @type {Object} 日志器 */
-  #logger;
-
-  /** @type {boolean} 是否因 maxIterations 强制进入 SUMMARIZE */
-  #forcedSummarize = false;
-
-  /**
-   * @param {Object} budget — 预算配置
-   * @param {boolean} isSkillOnly — 是否为 skill-only 维度
-   */
-  constructor(budget, isSkillOnly = false) {
-    this.#budget = budget;
-    this.#isSkillOnly = isSkillOnly;
-    this.#phase = 'EXPLORE';
-    this.#logger = Logger.getInstance();
-  }
-
-  /**
-   * 获取当前阶段
-   * @returns {'EXPLORE'|'PRODUCE'|'SUMMARIZE'}
-   */
-  get phase() {
-    return this.#phase;
-  }
-
-  /**
-   * 获取总迭代次数
-   * @returns {number}
-   */
-  get totalIterations() {
-    return this.#totalIterations;
-  }
-
-  /**
-   * 获取总提交数
-   * @returns {number}
-   */
-  get totalSubmits() {
-    return this.#totalSubmits;
-  }
-
-  /**
-   * 是否因 maxIterations 触顶而强制进入 SUMMARIZE（一次性标记）
-   * 调用后自动复位
-   * @returns {boolean}
-   */
-  consumeForcedSummarize() {
-    if (this.#forcedSummarize) {
-      this.#forcedSummarize = false;
-      return true;
-    }
-    return false;
-  }
-
-  /**
-   * 获取当前阶段的 toolChoice
-   * @returns {'required'|'auto'|'none'}
-   */
-  getToolChoice() {
-    switch (this.#phase) {
-      case 'EXPLORE':
-        // 最后一轮 EXPLORE 用 auto 保底
-        if (this.#phaseRounds >= this.#budget.searchBudget - 1) {
-          return 'auto';
-        }
-        return 'required';
-      case 'PRODUCE':
-        return 'auto';
-      case 'SUMMARIZE':
-        return 'none';
-      default:
-        return 'auto';
-    }
-  }
-
-  /**
-   * 是否应该退出主循环
-   * @returns {boolean}
-   */
-  shouldExit() {
-    // 已在 SUMMARIZE 阶段 → 给 2 轮输出总结后退出
-    if (this.#phase === 'SUMMARIZE' && this.#phaseRounds >= 2) {
-      return true;
-    }
-
-    // 达到 maxIterations → 不硬退出，而是强制转入 SUMMARIZE 让 AI 在完整上下文中收尾
-    if (this.#totalIterations >= this.#budget.maxIterations && this.#phase !== 'SUMMARIZE') {
-      this.#logger.info(
-        `[PhaseRouter] maxIterations reached (${this.#totalIterations}/${this.#budget.maxIterations}), forcing → SUMMARIZE for graceful exit`
-      );
-      this.#forcedSummarize = true;
-      this.#transitionTo('SUMMARIZE');
-      // 返回 false 让主循环继续运行 SUMMARIZE 阶段的 2 轮收尾
-      return false;
-    }
-
-    // SUMMARIZE 阶段超限兜底（maxIterations + 2 轮 grace）
-    if (this.#totalIterations >= this.#budget.maxIterations + 2) {
-      return true;
-    }
-
-    return false;
-  }
-
-  /**
-   * 每轮迭代开始时调用 — 递增计数 + 检查阶段转换
-   */
-  tick() {
-    this.#totalIterations++;
-    this.#phaseRounds++;
-  }
-
-  /**
-   * 根据本轮工具调用结果更新阶段
-   *
-   * @param {Object} roundResult — 本轮结果
-   * @param {Array} roundResult.functionCalls — AI 返回的工具调用（null 表示纯文本）
-   * @param {number} roundResult.submitCount — 本轮提交的候选数
-   * @param {boolean} roundResult.isTextOnly — AI 返回纯文本（无工具调用）
-   * @returns {{ transitioned: boolean, newPhase: string, exitReason?: string }}
-   */
-  update(roundResult) {
-    const { submitCount = 0, isTextOnly = false } = roundResult;
-    this.#totalSubmits += submitCount;
-
-    // ── EXPLORE → PRODUCE/SUMMARIZE ──
-    if (this.#phase === 'EXPLORE') {
-      // 有提交 → 直接进入 PRODUCE
-      if (submitCount > 0) {
-        return this.#transitionTo(this.#isSkillOnly ? 'SUMMARIZE' : 'PRODUCE');
-      }
-
-      // 搜索轮次耗尽 → 转换
-      if (this.#phaseRounds >= this.#budget.searchBudget) {
-        const next = this.#isSkillOnly ? 'SUMMARIZE' : 'PRODUCE';
-        this.#logger.info(
-          `[PhaseRouter] search budget exhausted (${this.#phaseRounds}/${this.#budget.searchBudget}) → ${next}`
-        );
-        return this.#transitionTo(next);
-      }
-
-      // 文本回复（非工具调用）→ AI 可能在总结 → 转换
-      if (isTextOnly) {
-        const next = this.#isSkillOnly ? 'SUMMARIZE' : 'PRODUCE';
-        return this.#transitionTo(next);
-      }
-
-      return { transitioned: false, newPhase: this.#phase };
-    }
-
-    // ── PRODUCE → SUMMARIZE ──
-    if (this.#phase === 'PRODUCE') {
-      if (submitCount > 0) {
-        this.#idleRounds = 0;
-      } else {
-        this.#idleRounds++;
-      }
-
-      // 硬上限
-      if (this.#budget.maxSubmits > 0 && this.#totalSubmits >= this.#budget.maxSubmits) {
-        this.#logger.info(
-          `[PhaseRouter] hard submit cap reached (${this.#totalSubmits}/${this.#budget.maxSubmits}) → SUMMARIZE`
-        );
-        return this.#transitionTo('SUMMARIZE');
-      }
-
-      // 连续空转
-      if (this.#totalSubmits > 0 && this.#idleRounds >= this.#budget.idleRoundsToExit) {
-        this.#logger.info(`[PhaseRouter] idle rounds (${this.#idleRounds}) → SUMMARIZE`);
-        return this.#transitionTo('SUMMARIZE');
-      }
-
-      // 文本回复 — AI 可能在提交间分析或被引导提交
-      // 只在以下情况下认为 AI 主动结束:
-      //   1. 已有至少 1 次提交 (softSubmitLimit < totalSubmits 说明 AI 认为足够)
-      //   2. 或已在 PRODUCE 阶段停留多轮但 0 提交 (通过 searchBudgetGrace 兜底)
-      // 否则视为 AI 的中间分析，不立即退出
-      if (isTextOnly) {
-        if (this.#totalSubmits >= this.#budget.softSubmitLimit) {
-          this.#logger.info(
-            `[PhaseRouter] text reply after ${this.#totalSubmits} submits (≥ softLimit=${this.#budget.softSubmitLimit}) → SUMMARIZE`
-          );
-          return this.#transitionTo('SUMMARIZE');
-        }
-        // 未达 softLimit — 空转已在上方通用分支计数，不再额外递增
-        this.#logger.info(
-          `[PhaseRouter] text reply in PRODUCE — idleRounds=${this.#idleRounds}, totalSubmits=${this.#totalSubmits}, continuing`
-        );
-        return { transitioned: false, newPhase: this.#phase };
-      }
-
-      // PRODUCE 阶段容忍期耗尽且 0 提交 → 强制进入 SUMMARIZE
-      // 使用 PRODUCE 阶段内的轮次计数，而非 totalIterations
-      if (this.#phaseRounds >= this.#budget.searchBudgetGrace && this.#totalSubmits === 0) {
-        this.#logger.info(
-          `[PhaseRouter] PRODUCE grace exhausted (${this.#phaseRounds}/${this.#budget.searchBudgetGrace} rounds, 0 submits) → SUMMARIZE`
-        );
-        return this.#transitionTo('SUMMARIZE');
-      }
-
-      return { transitioned: false, newPhase: this.#phase };
-    }
-
-    // SUMMARIZE 阶段不转换
-    return { transitioned: false, newPhase: this.#phase };
-  }
-
-  /**
-   * 获取当前阶段的系统提示（注入到 systemPrompt 中，而非追加 user 消息）
-   * @returns {string|null}
-   */
-  getPhaseHint() {
-    // 接近 maxIterations 上限时，无论处于哪个阶段都警告 AI
-    const remaining = this.#budget.maxIterations - this.#totalIterations;
-    if (remaining <= 2 && remaining > 0 && this.#phase !== 'SUMMARIZE') {
-      return `⚠️ 仅剩 ${remaining} 轮次即达上限，请尽快完成当前工作并准备输出总结。`;
-    }
-
-    switch (this.#phase) {
-      case 'EXPLORE':
-        if (this.#phaseRounds >= this.#budget.searchBudget - 2) {
-          return `搜索预算即将耗尽 (${this.#phaseRounds}/${this.#budget.searchBudget})，请准备提交候选或产出摘要。`;
-        }
-        return null;
-
-      case 'PRODUCE':
-        if (this.#totalSubmits === 0 && this.#phaseRounds >= 1) {
-          return this.#isSkillOnly
-            ? '你已收集足够信息，请在回复中直接输出 dimensionDigest JSON。'
-            : '⚠️ 探索阶段已结束。你已收集了足够的项目信息，请 **立即** 调用 submit_knowledge 提交候选。不要继续搜索，直接提交。';
-        }
-        if (
-          this.#totalSubmits >= this.#budget.softSubmitLimit &&
-          this.#budget.softSubmitLimit > 0
-        ) {
-          const remaining = this.#budget.maxSubmits - this.#totalSubmits;
-          return `已提交 ${this.#totalSubmits} 个候选（上限 ${this.#budget.maxSubmits}）。${remaining > 0 ? `还可提交 ${remaining} 个。` : ''}如果还有值得记录的发现可以继续提交，否则请产出 dimensionDigest 总结。\n⚠️ 如果还有未处理的信号，请在 dimensionDigest 的 remainingTasks 字段中标记，下次运行时会续传。`;
-        }
-        return null;
-
-      case 'SUMMARIZE':
-        return null; // SUMMARIZE 阶段不注入额外 hint
-
-      default:
-        return null;
-    }
-  }
-
-  /**
-   * 执行阶段转换
-   * @private
-   */
-  #transitionTo(newPhase) {
-    const oldPhase = this.#phase;
-    this.#phase = newPhase;
-    this.#phaseRounds = 0;
-    this.#idleRounds = 0;
-    this.#logger.info(
-      `[PhaseRouter] ${oldPhase} → ${newPhase} (iter=${this.#totalIterations}, submits=${this.#totalSubmits})`
-    );
-    return { transitioned: true, newPhase };
-  }
-}

package/lib/service/chat/EpisodicConsolidator.js

@@ -1,7 +1,7 @@
 /**
  * EpisodicConsolidator — Episodic → Semantic 固化引擎
  *
- * Bootstrap 完成后，将 EpisodicMemory (Tier 2) 中的维度分析结果
+ * Bootstrap 完成后，将 SessionStore (Tier 2) 中的维度分析结果
  * 提炼为结构化记忆，固化到 ProjectSemanticMemory (Tier 3)。
  *
  * 固化策略 (规则化，无需额外 AI 调用):
@@ -74,15 +74,15 @@ export class EpisodicConsolidator {
   }
 
   /**
-   * 执行固化: EpisodicMemory → ProjectSemanticMemory
+   * 执行固化: SessionStore → ProjectSemanticMemory
    *
-   * @param {import('../../external/mcp/handlers/bootstrap/pipeline/EpisodicMemory.js').EpisodicMemory} episodicMemory
+   * @param {import('./memory/SessionStore.js').SessionStore} sessionStore
    * @param {object} [opts]
    * @param {string} [opts.bootstrapSession] — Bootstrap session ID
    * @param {boolean} [opts.clearPrevious=false] — 是否先清除旧的 bootstrap 记忆
    * @returns {{ findings: object, insights: object, textFacts: object, total: object }}
    */
-  consolidate(episodicMemory, { bootstrapSession, clearPrevious = false } = {}) {
+  consolidate(sessionStore, { bootstrapSession, clearPrevious = false } = {}) {
     const t0 = Date.now();
 
     // 可选: 清除旧的 bootstrap 记忆 (全量重跑场景)
@@ -95,13 +95,13 @@ export class EpisodicConsolidator {
     this.#semanticMemory.compact();
 
     // 2. 从 findings 提取 fact 记忆
-    const findingMemories = this.#extractFromFindings(episodicMemory);
+    const findingMemories = this.#extractFromFindings(sessionStore);
 
     // 3. 从 Tier Reflections 提取 insight 记忆
-    const insightMemories = this.#extractFromReflections(episodicMemory);
+    const insightMemories = this.#extractFromReflections(sessionStore);
 
     // 4. 从 analysisText 提取文本中的事实
-    const textFactMemories = this.#extractFromAnalysisText(episodicMemory);
+    const textFactMemories = this.#extractFromAnalysisText(sessionStore);
 
     // 5. 合并所有候选, 使用 consolidate 去重
     const allCandidates = [...findingMemories, ...insightMemories, ...textFactMemories];
@@ -137,12 +137,12 @@ export class EpisodicConsolidator {
    *
    * 每个 finding 映射为一条 fact，importance 直接继承。
    */
-  #extractFromFindings(episodicMemory) {
+  #extractFromFindings(sessionStore) {
     const memories = [];
-    const completedDims = episodicMemory.getCompletedDimensions();
+    const completedDims = sessionStore.getCompletedDimensions();
 
     for (const dimId of completedDims) {
-      const report = episodicMemory.getDimensionReport(dimId);
+      const report = sessionStore.getDimensionReport(dimId);
       if (!report?.findings) {
         continue;
       }
@@ -185,9 +185,9 @@ export class EpisodicConsolidator {
    * suggestionsForNextTier → insight (分析建议)
    * topFindings 中重要性 ≥ 7 的 → fact (高优先级重复确认)
    */
-  #extractFromReflections(episodicMemory) {
+  #extractFromReflections(sessionStore) {
     const memories = [];
-    const json = episodicMemory.toJSON();
+    const json = sessionStore.toJSON();
     const reflections = json.tierReflections || [];
 
     for (const ref of reflections) {
@@ -253,13 +253,13 @@ export class EpisodicConsolidator {
    *
    * 仅提取高置信度的简短陈述 (≤100 字), 避免噪音。
    */
-  #extractFromAnalysisText(episodicMemory) {
+  #extractFromAnalysisText(sessionStore) {
     const memories = [];
     const seen = new Set(); // 去重
-    const completedDims = episodicMemory.getCompletedDimensions();
+    const completedDims = sessionStore.getCompletedDimensions();
 
     for (const dimId of completedDims) {
-      const report = episodicMemory.getDimensionReport(dimId);
+      const report = sessionStore.getDimensionReport(dimId);
       if (!report?.analysisText) {
         continue;
       }