autosnippet 3.2.16 → 3.2.18

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

@@ -25,9 +25,7 @@ import Logger from '#infra/logging/Logger.js';
 // ═══════════════════════════════════════════════════════════
 // §1: 工具压缩策略 (从 WorkingMemory 迁入)
 // ═══════════════════════════════════════════════════════════
-/**
- * 工具特化压缩策略 — 不同工具返回不同结构，压缩时保留最有价值的部分
- */
+/** 工具特化压缩策略 — 不同工具返回不同结构，压缩时保留最有价值的部分 */
 const TOOL_COMPRESS_STRATEGIES = {
     search_project_code(result) {
         if (typeof result !== 'object' || result === null) {
@@ -120,9 +118,7 @@ const TOOL_COMPRESS_STRATEGIES = {
         return `目录结构: ${Array.isArray(entries) ? entries.length : 0} 个条目`;
     },
 };
-/**
- * 默认压缩 — 截断到 maxChars
- */
+/** 默认压缩 — 截断到 maxChars */
 function defaultCompress(result, maxChars = 600) {
     const str = typeof result === 'string' ? result : JSON.stringify(result);
     if (str.length <= maxChars) {
@@ -153,9 +149,8 @@ export class ActiveContext {
     #totalObservations = 0;
     #logger;
     /**
-     * @param {object} [options]
-     * @param {number} [options.maxRecentRounds=3] 保留最近 N 轮原始结果 (WM 滑动窗口)
-     * @param {boolean} [options.lightweight=false] 轻量模式: 跳过 WM 的压缩/Scratchpad 逻辑 (D5)
+     * @param [options.maxRecentRounds=3] 保留最近 N 轮原始结果 (WM 滑动窗口)
+     * @param [options.lightweight=false] 轻量模式: 跳过 WM 的压缩/Scratchpad 逻辑 (D5)
      */
     constructor(options = {}) {
         this.#maxRecentRounds = options.maxRecentRounds ?? 3;
@@ -167,7 +162,7 @@ export class ActiveContext {
     // ═══════════════════════════════════════════════════════
     /**
      * 开始新一轮推理
-     * @param {number} iteration 轮次编号
+     * @param iteration 轮次编号
      */
     startRound(iteration) {
         if (this.#currentRound) {
@@ -184,9 +179,7 @@ export class ActiveContext {
             endTime: null,
         };
     }
-    /**
-     * 结束当前轮次
-     */
+    /** 结束当前轮次 */
     endRound() {
         if (this.#currentRound) {
             this.#currentRound.endTime = Date.now();
@@ -197,10 +190,7 @@ export class ActiveContext {
     // ═══════════════════════════════════════════════════════
     // §2.2: 记录 (合并 WM.observe + RT.addAction/addObservation)
     // ═══════════════════════════════════════════════════════
-    /**
-     * 记录 AI 的推理文本（从 aiResult.text 提取）
-     * @param {string} text
-     */
+    /** 记录 AI 的推理文本（从 aiResult.text 提取） */
     setThought(text) {
         if (this.#currentRound && text) {
             this.#currentRound.thought = text;
@@ -209,10 +199,10 @@ export class ActiveContext {
     /**
      * 统一记录一次工具调用 — 合并原 WM.observe() + RT.addAction() + RT.addObservation()
      *
-     * @param {string} toolName 工具名称
-     * @param {object} args 工具参数
-     * @param {*} result 工具返回的原始结果
-     * @param {boolean} isNew 是否发现新信息 (由 ExplorationTracker.recordToolCall 提供)
+     * @param toolName 工具名称
+     * @param args 工具参数
+     * @param result 工具返回的原始结果
+     * @param isNew 是否发现新信息 (由 ExplorationTracker.recordToolCall 提供)
      */
     recordToolCall(toolName, args, result, isNew) {
         const round = this.#currentRound?.iteration || 0;
@@ -238,28 +228,15 @@ export class ActiveContext {
             }
         }
     }
-    /**
-     * 兼容旧 RT API: 记录一次工具调用 (Action only)
-     * @param {string} toolName
-     * @param {object} params
-     */
+    /** 兼容旧 RT API: 记录一次工具调用 (Action only) */
     addAction(toolName, params) {
         this.#currentRound?.actions.push({ tool: toolName, params });
     }
-    /**
-     * 兼容旧 RT API: 记录一次工具结果的结构化观察
-     * @param {string} toolName
-     * @param {object} meta
-     */
+    /** 兼容旧 RT API: 记录一次工具结果的结构化观察 */
     addObservation(toolName, meta) {
         this.#currentRound?.observations.push({ tool: toolName, ...meta });
     }
-    /**
-     * 兼容旧 WM API: 记录工具调用结果 (Observe, 仅 WM 滑动窗口)
-     * @param {string} toolName
-     * @param {*} result
-     * @param {number} round
-     */
+    /** 兼容旧 WM API: 记录工具调用结果 (Observe, 仅 WM 滑动窗口) */
     observe(toolName, result, round) {
         if (this.#lightweight) {
             return;
@@ -274,10 +251,7 @@ export class ActiveContext {
             }
         }
     }
-    /**
-     * 记录反思内容 (ExplorationTracker 使用, L5 修复)
-     * @param {string} text
-     */
+    /** 记录反思内容 (ExplorationTracker 使用, L5 修复) */
     setReflection(text) {
         if (this.#currentRound && text) {
             this.#currentRound.reflection = text;
@@ -285,7 +259,7 @@ export class ActiveContext {
     }
     /**
      * 记录轮次摘要
-     * @param {object} summary - { newInfoCount, totalCalls, submits, cumulativeFiles, cumulativePatterns }
+     * @param summary { newInfoCount, totalCalls, submits, cumulativeFiles, cumulativePatterns }
      */
     setRoundSummary(summary) {
         if (this.#currentRound) {
@@ -298,10 +272,10 @@ export class ActiveContext {
     /**
      * Agent 主动记录关键发现 (note_finding 工具入口)
      *
-     * @param {string} finding 关键发现描述
-     * @param {string} [evidence] 证据 (文件路径:行号)
-     * @param {number} [importance=5] 重要性 1-10
-     * @param {number} [round=0] 当前轮次
+     * @param finding 关键发现描述
+     * @param [evidence] 证据 (文件路径:行号)
+     * @param [importance=5] 重要性 1-10
+     * @param [round=0] 当前轮次
      */
     noteKeyFinding(finding, evidence = '', importance = 5, round = 0) {
         // P0 Fix: 防御性保证 evidence 是 string (AI 可能传入 array/object)
@@ -330,9 +304,9 @@ export class ActiveContext {
      * 这防止 reflection 回复中的编号列表（非计划的回应文本）污染已有计划。
      * ExplorationTracker 在发送 plan elicitation / replan 时调用 expectPlan() 授权更新。
      *
-     * @param {string} text - AI 完整响应文本
-     * @param {number} iteration 当前轮次
-     * @returns {boolean} 是否成功提取到计划
+     * @param text AI 完整响应文本
+     * @param iteration 当前轮次
+     * @returns 是否成功提取到计划
      */
     extractAndSetPlan(text, iteration) {
         const planText = this.#extractPlanFromText(text);
@@ -360,26 +334,15 @@ export class ActiveContext {
     expectPlan() {
         this.#expectingPlan = true;
     }
-    /**
-     * 直接设置计划 (公开接口，供 ExplorationTracker 和测试使用)
-     * @param {string} planText
-     * @param {number} iteration
-     */
+    /** 直接设置计划 (公开接口，供 ExplorationTracker 和测试使用) */
     setPlan(planText, iteration) {
         this.#setPlan(planText, iteration);
     }
-    /**
-     * 更新计划 (保留旧 plan 到 history)
-     * @param {string} replanText
-     * @param {number} iteration
-     */
+    /** 更新计划 (保留旧 plan 到 history) */
     updatePlan(replanText, iteration) {
         this.#updatePlan(replanText, iteration);
     }
-    /**
-     * 获取当前计划 (只读副本)
-     * @returns {Plan|null}
-     */
+    /** 获取当前计划 (只读副本) */
     getPlan() {
         if (!this.#plan) {
             return null;
@@ -389,31 +352,22 @@ export class ActiveContext {
             steps: this.#plan.steps.map((s) => ({ ...s })),
         };
     }
-    /**
-     * 获取计划步骤的可变引用 (ExplorationTracker.updatePlanProgress 使用)
-     * @returns {Array<PlanStep>}
-     */
+    /** 获取计划步骤的可变引用 (ExplorationTracker.updatePlanProgress 使用) */
     getPlanStepsMutable() {
         return this.#plan?.steps || [];
     }
-    /**
-     * 获取计划历史 (F7)
-     * @returns {Array<Plan>}
-     */
+    /** 获取计划历史 (F7) */
     getPlanHistory() {
         return this.#planHistory.map((p) => ({ ...p, steps: p.steps.map((s) => ({ ...s })) }));
     }
     /**
      * 获取当前轮次的 actions (ExplorationTracker.updatePlanProgress 使用, L5 修复)
-     * @returns {Array<{tool: string, params: object}>}
+     * @returns >}
      */
     getCurrentRoundActions() {
         return this.#currentRound?.actions || [];
     }
-    /**
-     * 获取当前轮次的 iteration 编号 (F8)
-     * @returns {number|null}
-     */
+    /** 获取当前轮次的 iteration 编号 (F8) */
     getCurrentIteration() {
         return this.#currentRound?.iteration || null;
     }
@@ -424,8 +378,8 @@ export class ActiveContext {
      * 构建当前工作记忆的上下文快照
      * 用于注入到 system prompt 或 user nudge 中
      *
-     * @param {number} [tokenBudget=Infinity] - token 预算 (新增: 预算控制)
-     * @returns {string} Markdown 格式的上下文块，空字符串表示无内容
+     * @param [tokenBudget=Infinity] token 预算 (新增: 预算控制)
+     * @returns Markdown 格式的上下文块，空字符串表示无内容
      */
     buildContext(tokenBudget = Infinity) {
         if (this.#lightweight) {
@@ -481,8 +435,6 @@ export class ActiveContext {
     /**
      * 蒸馏 ActiveContext 为结构化报告
      * 在 Agent execute 结束时调用，结果写入 SessionStore
-     *
-     * @returns {DistilledContext}
      */
     distill() {
         return {
@@ -503,7 +455,7 @@ export class ActiveContext {
     // ═══════════════════════════════════════════════════════
     /**
      * 获取所有有 Thought 的轮次
-     * @returns {Array<{iteration: number, thought: string}>}
+     * @returns >}
      */
     getThoughts() {
         return this.#rounds
@@ -512,8 +464,7 @@ export class ActiveContext {
     }
     /**
      * 获取最近 N 轮的紧凑摘要 (ExplorationTracker.#checkReflection 使用)
-     * @param {number} [n=3] 回看轮数
-     * @returns {object|null}
+     * @param [n=3] 回看轮数
      */
     getRecentSummary(n = 3) {
         const recent = this.#rounds.slice(-n);
@@ -534,10 +485,7 @@ export class ActiveContext {
             lastIteration: recent[recent.length - 1].iteration,
         };
     }
-    /**
-     * 统计指标 (ExplorationTracker.getQualityMetrics 使用)
-     * @returns {object}
-     */
+    /** 统计指标 (ExplorationTracker.getQualityMetrics 使用) */
     getStats() {
         return {
             totalRounds: this.#rounds.length,
@@ -551,24 +499,17 @@ export class ActiveContext {
     // ═══════════════════════════════════════════════════════
     // §2.8: Scratchpad 查询 (从 WorkingMemory 继承)
     // ═══════════════════════════════════════════════════════
-    /**
-     * 获取 scratchpad 中的关键发现数量
-     * @returns {number}
-     */
+    /** 获取 scratchpad 中的关键发现数量 */
     get scratchpadSize() {
         return this.#scratchpad.length;
     }
-    /**
-     * 获取总观察数
-     * @returns {number}
-     */
+    /** 获取总观察数 */
     get totalObservations() {
         return this.#totalObservations;
     }
     /**
      * 获取 scratchpad 中的高重要性发现
-     * @param {number} [minImportance=7]
-     * @returns {Array<{finding: string, evidence: string, importance: number}>}
+     * @returns >}
      */
     getHighPriorityFindings(minImportance = 7) {
         return this.#scratchpad
@@ -578,10 +519,7 @@ export class ActiveContext {
     // ═══════════════════════════════════════════════════════
     // §2.9: 序列化 (从 ReasoningTrace 继承)
     // ═══════════════════════════════════════════════════════
-    /**
-     * 可序列化输出
-     * @returns {object}
-     */
+    /** 可序列化输出 */
     toJSON() {
         return {
             rounds: this.#rounds.map((r) => ({ ...r })),
@@ -604,8 +542,7 @@ export class ActiveContext {
     }
     /**
      * 从 JSON 恢复 ActiveContext (断点续传)
-     * @param {object} json - toJSON() 的输出
-     * @returns {ActiveContext}
+     * @param json toJSON() 的输出
      */
     static fromJSON(json) {
         const ctx = new ActiveContext();
@@ -628,9 +565,7 @@ export class ActiveContext {
         }
         return ctx;
     }
-    /**
-     * 清空 ActiveContext — 释放内存
-     */
+    /** 清空 ActiveContext — 释放内存 */
     clear() {
         this.#scratchpad.length = 0;
         this.#rounds.length = 0;
@@ -648,11 +583,8 @@ export class ActiveContext {
      * 从工具执行结果构建结构化观察元数据
      * 不改变工具结果传给 AI 的内容，只影响推理链记录
      *
-     * @param {string} toolName
-     * @param {object} args
-     * @param {*} result
-     * @param {boolean} isNew 由 ExplorationTracker.recordToolCall 提供
-     * @returns {{ gotNewInfo: boolean, resultType: string, keyFacts: string[], resultSize: number }}
+     * @param isNew 由 ExplorationTracker.recordToolCall 提供
+     * @returns }
      */
     static buildObservationMeta(toolName, args, result, isNew) {
         const meta = {
@@ -738,7 +670,7 @@ export class ActiveContext {
     /**
      * 工具结果压缩 — 使用特化策略 (从 WorkingMemory 迁入)
      * @param {{toolName: string, result: unknown, round: number}} observation
-     * @returns {{toolName: string, round: number, summary: string}}
+     * @returns }
      */
     #compressObservation(observation) {
         const strategy = TOOL_COMPRESS_STRATEGIES[observation.toolName];
@@ -755,19 +687,11 @@ export class ActiveContext {
             summary,
         };
     }
-    /**
-     * 粗糙 token 估算 (1 token ≈ 4 chars)
-     * @param {string} text
-     * @returns {number}
-     */
+    /** 粗糙 token 估算 (1 token ≈ 4 chars) */
     #estimateTokens(text) {
         return Math.ceil((text || '').length / 4);
     }
     // ── Plan 内部方法 (从 ReasoningTrace 迁入) ──
-    /**
-     * @param {string} planText
-     * @param {number} iteration
-     */
     #setPlan(planText, iteration) {
         this.#plan = {
             text: planText,
@@ -776,10 +700,6 @@ export class ActiveContext {
             lastUpdatedAtIteration: iteration,
         };
     }
-    /**
-     * @param {string} replanText
-     * @param {number} iteration
-     */
     #updatePlan(replanText, iteration) {
         if (!this.#plan) {
             this.#setPlan(replanText, iteration);
@@ -790,11 +710,7 @@ export class ActiveContext {
         this.#plan.steps = this.#parsePlanSteps(replanText);
         this.#plan.lastUpdatedAtIteration = iteration;
     }
-    /**
-     * 从 AI 文本中解析计划步骤
-     * @param {string} text
-     * @returns {Array<PlanStep>}
-     */
+    /** 从 AI 文本中解析计划步骤 */
     #parsePlanSteps(text) {
         if (!text) {
             return [];
@@ -813,22 +729,14 @@ export class ActiveContext {
         }
         return steps;
     }
-    /**
-     * 从步骤描述中提取关键词
-     * @param {string} text
-     * @returns {string[]}
-     */
+    /** 从步骤描述中提取关键词 */
     #extractKeywords(text) {
         const quoted = [...text.matchAll(/[`"']([A-Za-z_]\w{2,})[`"']/g)].map((m) => m[1]);
         const camelCase = [...text.matchAll(/\b([A-Z][a-z]+(?:[A-Z][a-z]+)+)\b/g)].map((m) => m[0]);
         const acronyms = [...text.matchAll(/\b([A-Z]{2,}[a-z]\w+)\b/g)].map((m) => m[0]);
         return [...new Set([...quoted, ...camelCase, ...acronyms])];
     }
-    /**
-     * 从 AI 响应文本中提取"计划"部分
-     * @param {string} text
-     * @returns {string|null}
-     */
+    /** 从 AI 响应文本中提取"计划"部分 */
     #extractPlanFromText(text) {
         if (!text || text.length < 30) {
             return null;
@@ -887,4 +795,3 @@ export class ActiveContext {
     }
 }
 export default ActiveContext;
-//# sourceMappingURL=ActiveContext.js.map

package/dist/lib/{service/agent → agent}/memory/MemoryConsolidator.d.ts

@@ -37,28 +37,19 @@ interface MemoryLogger {
 }
 export declare class MemoryConsolidator {
     #private;
-    /**
-     * @param {MemoryStore} store
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
     constructor(store: MemoryStore, opts?: {
         logger?: MemoryLogger | null;
     });
     /**
      * 智能固化: 先执行冲突检测 (Mem0 风格)，再执行 ADD / UPDATE / MERGE / NOOP
      *
-     * @param {Array<object>} candidateMemories
-     * @param {object} [opts]
-     * @param {string} [opts.bootstrapSession]
-     * @returns {{ added: number, updated: number, merged: number, skipped: number, replaced?: number }}
+     * @returns }
      */
     consolidate(candidateMemories: CandidateMemory[], { bootstrapSession }?: ConsolidateOptions): ConsolidateStats;
     /**
      * 从旧版 Memory.js JSONL 文件迁移数据到 SQLite
      *
-     * @param {string} projectRoot
-     * @returns {Promise<{ migrated: number, skipped: number, error?: string }>}
+     * @returns >}
      */
     migrateFromLegacy(projectRoot: string): Promise<{
         migrated: number;
@@ -67,4 +58,3 @@ export declare class MemoryConsolidator {
     }>;
 }
 export {};
-//# sourceMappingURL=MemoryConsolidator.d.ts.map

package/dist/lib/{service/agent → agent}/memory/MemoryConsolidator.js

@@ -27,15 +27,8 @@ const MIN_TOPIC_OVERLAP_WORDS = 2;
 /** 共享词语比例阈值 */
 const MIN_TOPIC_OVERLAP_RATIO = 0.3;
 export class MemoryConsolidator {
-    /** @type {MemoryStore} */
     #store;
-    /** @type {MemoryLogger|null} */
     #logger;
-    /**
-     * @param {MemoryStore} store
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
     constructor(store, opts = {}) {
         this.#store = store;
         this.#logger = opts.logger || null;
@@ -46,10 +39,7 @@ export class MemoryConsolidator {
     /**
      * 智能固化: 先执行冲突检测 (Mem0 风格)，再执行 ADD / UPDATE / MERGE / NOOP
      *
-     * @param {Array<object>} candidateMemories
-     * @param {object} [opts]
-     * @param {string} [opts.bootstrapSession]
-     * @returns {{ added: number, updated: number, merged: number, skipped: number, replaced?: number }}
+     * @returns }
      */
     consolidate(candidateMemories, { bootstrapSession } = {}) {
         // Phase 1: 冲突预解决
@@ -111,8 +101,7 @@ export class MemoryConsolidator {
     /**
      * 从旧版 Memory.js JSONL 文件迁移数据到 SQLite
      *
-     * @param {string} projectRoot
-     * @returns {Promise<{ migrated: number, skipped: number, error?: string }>}
+     * @returns >}
      */
     async migrateFromLegacy(projectRoot) {
         const legacyPath = path.join(projectRoot, '.autosnippet', 'memory.jsonl');
@@ -169,8 +158,7 @@ export class MemoryConsolidator {
     // ═══════════════════════════════════════════════════════════
     /**
      * 在 consolidate 主流程前检测并解决矛盾
-     * @param {Array<object>} candidates
-     * @returns {{ processed: Array<object>, replaced: number }}
+     * @returns }
      */
     #preResolveConflicts(candidates) {
         if (!candidates || candidates.length === 0) {
@@ -213,12 +201,7 @@ export class MemoryConsolidator {
         }
         return { processed, replaced };
     }
-    /**
-     * 检测两段记忆内容是否矛盾
-     * @param {string} contentA
-     * @param {string} contentB
-     * @returns {boolean}
-     */
+    /** 检测两段记忆内容是否矛盾 */
     static #detectContradiction(contentA, contentB) {
         if (!contentA || !contentB) {
             return false;
@@ -242,11 +225,7 @@ export class MemoryConsolidator {
         }
         return overlap >= MIN_TOPIC_OVERLAP_WORDS || overlap / minSize >= MIN_TOPIC_OVERLAP_RATIO;
     }
-    /**
-     * 提取主题词 (去停用词 + 短词)
-     * @param {string} text
-     * @returns {Set<string>}
-     */
+    /** 提取主题词 (去停用词 + 短词) */
     static #extractTopicWords(text) {
         if (!text) {
             return new Set();
@@ -311,11 +290,7 @@ export class MemoryConsolidator {
         ]);
         return new Set(tokens.filter((t) => !stopWords.has(t)));
     }
-    /**
-     * Legacy type 映射
-     * @param {string} legacyType
-     * @returns {string}
-     */
+    /** Legacy type 映射 */
     static #mapLegacyType(legacyType) {
         switch (legacyType) {
             case 'preference':
@@ -332,4 +307,3 @@ export class MemoryConsolidator {
     }
 }
 _a = MemoryConsolidator;
-//# sourceMappingURL=MemoryConsolidator.js.map