autosnippet 3.2.7 → 3.2.9

package/lib/service/agent/index.js

@@ -0,0 +1,91 @@
+/**
+ * AutoSnippet Agent 模块 — 统一出口
+ *
+ * @module service/agent
+ *
+ * 统一架构: ONE Runtime, 多种配置
+ *
+ *   ┌──────── Transport ────────┐
+ *   │  HTTP│Lark│CLI│MCP│...    │  ← 渠道适配 (AgentMessage)
+ *   └──────────┬────────────────┘
+ *              │
+ *   ┌──────────▼────────────────┐
+ *   │       AgentRouter         │  ← 意图 → Preset
+ *   └──────────┬────────────────┘
+ *              │
+ *   ┌──────────▼────────────────┐
+ *   │       AgentFactory        │  ← Preset + DI → Runtime
+ *   └──────────┬────────────────┘
+ *              │
+ *   ┌──────────▼────────────────────────────────────────┐
+ *   │              AgentRuntime                          │
+ *   │                                                    │
+ *   │  ┌──────────┐  ┌───────────┐  ┌────────────────┐ │
+ *   │  │Capability│  │ Strategy  │  │    Policy       │ │
+ *   │  │ 技能模块 │  │ 执行策略  │  │    约束引擎    │ │
+ *   │  ├──────────┤  ├───────────┤  ├────────────────┤ │
+ *   │  │• 对话    │  │• Single   │  │• Budget 预算   │ │
+ *   │  │• 代码分析│  │• Pipeline │  │• Safety 安全   │ │
+ *   │  │• 知识生产│  │• FanOut   │  │• Quality 质量  │ │
+ *   │  │• 系统交互│  │• Adaptive │  │                │ │
+ *   │  └──────────┘  └───────────┘  └────────────────┘ │
+ *   │                                                    │
+ *   │  ┌─────────────────────────────────────────┐      │
+ *   │  │  ReAct Loop  (Thought→Action→Observe)   │      │
+ *   │  └─────────────────────────────────────────┘      │
+ *   └───────────────────────────────────────────────────┘
+ *              │
+ *   ┌──────────▼────────────────┐
+ *   │   AgentState + EventBus   │  ← 状态机 + 事件通信
+ *   └──────────────────────────-┘
+ *
+ * Preset 配置表:
+ *   | Preset       | Capabilities         | Strategy    | Policies         |
+ *   |--------------|----------------------|-------------|------------------|
+ *   | chat         | Conv + Analysis      | Single      | Budget(8轮)      |
+ *   | bootstrap    | Analysis + Knowledge | FanOut+Pipe | Budget+Quality   |
+ *   | scan         | Analysis + Knowledge | Pipeline    | Budget+Quality   |
+ *   | remote-exec  | Conv+Analysis+System | Single      | Budget+Safety    |
+ */
+
+// ── Infrastructure ──
+export { AgentState, AgentPhase } from './AgentState.js';
+export { AgentEventBus, AgentEvents } from './AgentEventBus.js';
+export { AgentMessage, Channel } from './AgentMessage.js';
+
+// ── Core ──
+export { AgentRuntime } from './AgentRuntime.js';
+export { AgentRouter, PresetName } from './AgentRouter.js';
+export { AgentFactory } from './AgentFactory.js';
+
+// ── Capabilities ──
+export {
+  Capability,
+  Conversation,
+  CodeAnalysis,
+  KnowledgeProduction,
+  SystemInteraction,
+  CapabilityRegistry,
+} from './capabilities.js';
+
+// ── Strategies ──
+export {
+  Strategy,
+  SingleStrategy,
+  PipelineStrategy,
+  FanOutStrategy,
+  AdaptiveStrategy,
+  StrategyRegistry,
+} from './strategies.js';
+
+// ── Policies ──
+export {
+  Policy,
+  BudgetPolicy,
+  SafetyPolicy,
+  QualityGatePolicy,
+  PolicyEngine,
+} from './policies.js';
+
+// ── Presets ──
+export { PRESETS, getPreset, resolveStrategy } from './presets.js';

package/lib/service/{chat → agent}/memory/ActiveContext.js

@@ -322,9 +322,11 @@ export class ActiveContext {
    * @param {number} [round=0] - 当前轮次
    */
   noteKeyFinding(finding, evidence = '', importance = 5, round = 0) {
+    // P0 Fix: 防御性保证 evidence 是 string (AI 可能传入 array/object)
+    const safeEvidence = typeof evidence === 'string' ? evidence : Array.isArray(evidence) ? evidence.join(', ') : evidence ? String(evidence) : '';
     this.#scratchpad.push({
       finding,
-      evidence,
+      evidence: safeEvidence,
       importance: Math.min(10, Math.max(1, importance)),
       round,
     });

package/lib/service/{chat → agent}/memory/MemoryCoordinator.js

@@ -9,7 +9,7 @@
  *
  * 生命周期:
  *   - Bootstrap 模式: 会话级 (orchestrator 创建, 贯穿所有维度)
- *   - User Chat 模式: 实例级 (ChatAgent 构造函数创建)
+ *   - User Chat 模式: 实例级 (AgentRuntime 创建)
  *
  * @module MemoryCoordinator
  */
@@ -53,7 +53,7 @@ const NON_CACHEABLE_TOOLS = new Set([
   'get_previous_evidence',
 ]);
 
-// ── 写入路由: 规则匹配模式 (from ChatAgent.#extractMemory) ──
+// ── 写入路由: 规则匹配模式 ──
 
 const PREFERENCE_PATTERNS = [
   /我们(项目|团队)?(不用|不使用|禁止|避免|偏好|习惯|规范是)/,
@@ -81,7 +81,7 @@ export class MemoryCoordinator {
   #budgetAllocation;
 
   // ── Tier 3: Persistent (跨会话) ──
-  #persistentMemory; // PersistentMemory (extends ProjectSemanticMemory)
+  #persistentMemory; // PersistentMemory
   #conversationLog; // ConversationStore
 
   // ── Tier 2: Session (会话级) ──
@@ -96,7 +96,7 @@ export class MemoryCoordinator {
 
   /**
    * @param {object} config
-   * @param {object} [config.persistentMemory] — PersistentMemory / ProjectSemanticMemory 实例
+   * @param {object} [config.persistentMemory] — PersistentMemory 实例
    * @param {object} [config.sessionStore] — SessionStore 实例 (bootstrap 模式)
    * @param {object} [config.conversationLog] — ConversationStore 实例
    * @param {'user'|'bootstrap'} [config.mode='bootstrap']
@@ -125,7 +125,7 @@ export class MemoryCoordinator {
   // ═══════════════════════════════════════════════════════════
 
   /**
-   * 配置总预算 (由 ChatAgent.execute 入口调用)
+   * 配置总预算 (由 AgentRuntime.execute 入口调用)
    * @param {object} options
    * @param {number} options.totalContextBudget — 模型总上下文 token 数
    * @param {string} [options.model]
@@ -327,7 +327,7 @@ export class MemoryCoordinator {
   }
 
   /**
-   * 从对话中提取记忆 (迁移自 ChatAgent.#extractMemory)
+   * 从对话中提取记忆
    *
    * 写入路由 (WriteRouter):
    *   - 规则 1: 只在 user 源触发规则匹配 (B4 fix)
@@ -520,7 +520,7 @@ export class MemoryCoordinator {
   }
 
   /**
-   * 获取 PersistentMemory / ProjectSemanticMemory
+   * 获取 PersistentMemory
    * @returns {object|null}
    */
   getPersistentMemory() {