autosnippet 3.2.15 → 3.2.17

package/dist/bin/api-server.d.ts

@@ -4,4 +4,3 @@
  * 用于开发和测试 REST API
  */
 export {};
-//# sourceMappingURL=api-server.d.ts.map

package/dist/bin/api-server.js

@@ -84,4 +84,3 @@ async function main() {
     }
 }
 main();
-//# sourceMappingURL=api-server.js.map

package/dist/bin/cli.d.ts

@@ -18,4 +18,3 @@
  *   asd status          - 环境状态
  */
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.js

@@ -127,9 +127,7 @@ program
     cli.log(`     • git submodule add ${url} AutoSnippet/recipes`);
     cli.log('     • 或将 AutoSnippet/recipes/ 加入 .gitignore');
 });
-/**
- * 更新 .autosnippet/config.json 中的 core.subRepoUrl 字段
- */
+/** 更新 .autosnippet/config.json 中的 core.subRepoUrl 字段 */
 function _updateConfigUrl(projectRoot, url) {
     const configPath = join(projectRoot, '.autosnippet', 'config.json');
     if (!existsSync(configPath)) {
@@ -721,6 +719,16 @@ program
             });
             signalCollector.start();
             globalThis._signalCollector = signalCollector;
+            // 将 SignalCollector 绑定到 AIRecallStrategy (延迟注入)
+            try {
+                const aiStrategy = container.singletons._aiRecallStrategy;
+                if (aiStrategy && typeof aiStrategy.setSignalCollector === 'function') {
+                    aiStrategy.setSignalCollector(signalCollector);
+                }
+            }
+            catch {
+                /* recommendation pipeline not yet initialized */
+            }
         }
         catch (scErr) {
             cli.warn(`⚠️  SignalCollector failed to start: ${scErr.message}`);
@@ -1347,9 +1355,8 @@ async function initBootstrap() {
 /**
  * Bootstrap → ServiceContainer 统一初始化
  * 所有需要服务层的 CLI 命令共用此入口，保证依赖注入一致性
- * @param {object}  [opts]
- * @param {string}  [opts.projectRoot]  项目根目录（默认 cwd）
- * @returns {Promise<{ bootstrap, container }>}
+ * @param [opts.projectRoot] 项目根目录（默认 cwd）
+ * @returns >}
  */
 async function initContainer(opts = {}) {
     const projectRoot = opts.projectRoot || process.cwd();
@@ -1375,4 +1382,3 @@ async function initContainer(opts = {}) {
     return { bootstrap, container };
 }
 program.parse(process.argv);
-//# sourceMappingURL=cli.js.map

package/dist/bin/mcp-server.d.ts

@@ -25,4 +25,3 @@
  * }
  */
 export {};
-//# sourceMappingURL=mcp-server.d.ts.map

package/dist/bin/mcp-server.js

@@ -56,4 +56,3 @@ startMcpServer()
     process.exit(1);
 });
 export {};
-//# sourceMappingURL=mcp-server.js.map

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

@@ -10,9 +10,7 @@
  * @module AgentEventBus
  */
 import { EventEmitter } from 'node:events';
-/**
- * 标准事件类型
- */
+/** 标准事件类型 */
 export declare const AgentEvents: Readonly<{
     AGENT_CREATED: "agent:created";
     AGENT_STARTED: "agent:started";
@@ -34,35 +32,20 @@ export declare const AgentEvents: Readonly<{
     LARK_MESSAGE: "lark:message";
     SCAN_REQUEST: "scan:request";
 }>;
-/**
- * @typedef {Object} AgentEvent
- * @property {string} type 事件类型
- * @property {string} source 发送者 agentId
- * @property {string} [target] 目标 agentId（广播时为 null）
- * @property {Object} payload 事件数据
- * @property {number} timestamp 事件时间戳
- * @property {string} [correlationId] 关联 ID（用于 request/reply）
- */
 export declare class AgentEventBus extends EventEmitter {
     #private;
     constructor();
-    /**
-     * 获取全局单例
-     * @returns {AgentEventBus}
-     */
+    /** 获取全局单例 */
     static getInstance(): AgentEventBus;
-    /**
-     * 重置单例（测试用）
-     */
+    /** 重置单例（测试用） */
     static resetInstance(): void;
     /**
      * 发布事件（广播）
-     * @param {string} type 事件类型
-     * @param {Object} payload 事件数据
-     * @param {Object} [opts]
-     * @param {string} [opts.source] 发送者 agentId
-     * @param {string} [opts.target] 目标 agentId
-     * @param {string} [opts.correlationId] 关联 ID
+     * @param type 事件类型
+     * @param payload 事件数据
+     * @param [opts.source] 发送者 agentId
+     * @param [opts.target] 目标 agentId
+     * @param [opts.correlationId] 关联 ID
      */
     publish(type: string, payload?: Record<string, unknown>, opts?: {
         source?: string;
@@ -71,28 +54,24 @@ export declare class AgentEventBus extends EventEmitter {
     }): void;
     /**
      * 订阅事件
-     * @param {string} type 事件类型
-     * @param {Function} handler 处理函数 (event) => void
-     * @returns {Function} 取消订阅函数
+     * @param type 事件类型
+     * @param handler 处理函数 (event) => void
+     * @returns 取消订阅函数
      */
     subscribe(type: string, handler: (event: Record<string, unknown>) => void): () => void;
     /**
      * Request/Reply 模式 — 发送请求并等待响应
-     * @param {string} requestType 请求事件类型
-     * @param {Object} payload 请求数据
-     * @param {Object} [opts]
-     * @param {number} [opts.timeout=30000] 超时毫秒
-     * @param {string} [opts.source] 发送者
-     * @returns {Promise<AgentEvent>} 响应事件
+     * @param requestType 请求事件类型
+     * @param payload 请求数据
+     * @param [opts.timeout=30000] 超时毫秒
+     * @param [opts.source] 发送者
+     * @returns 响应事件
      */
     request(requestType: string, payload?: Record<string, unknown>, opts?: {
         timeout?: number;
         source?: string;
     }): Promise<unknown>;
-    /**
-     * 获取事件统计
-     * @returns {Object}
-     */
+    /** 获取事件统计 */
     getStats(): {
         totalEvents: number;
         subscriptionTopics: number;
@@ -100,4 +79,3 @@ export declare class AgentEventBus extends EventEmitter {
     };
 }
 export default AgentEventBus;
-//# sourceMappingURL=AgentEventBus.d.ts.map

package/dist/lib/{service/agent → agent}/AgentEventBus.js

@@ -10,10 +10,8 @@
  * @module AgentEventBus
  */
 import { EventEmitter } from 'node:events';
-import Logger from '../../infrastructure/logging/Logger.js';
-/**
- * 标准事件类型
- */
+import Logger from '#infra/logging/Logger.js';
+/** 标准事件类型 */
 export const AgentEvents = Object.freeze({
     // ── 生命周期 ──
     AGENT_CREATED: 'agent:created',
@@ -40,17 +38,7 @@ export const AgentEvents = Object.freeze({
     LARK_MESSAGE: 'lark:message',
     SCAN_REQUEST: 'scan:request',
 });
-/**
- * @typedef {Object} AgentEvent
- * @property {string} type 事件类型
- * @property {string} source 发送者 agentId
- * @property {string} [target] 目标 agentId（广播时为 null）
- * @property {Object} payload 事件数据
- * @property {number} timestamp 事件时间戳
- * @property {string} [correlationId] 关联 ID（用于 request/reply）
- */
 export class AgentEventBus extends EventEmitter {
-    /** @type {AgentEventBus|null} */
     static #instance = null;
     #logger;
     /** @type {Map<string, Function[]>} topic → handlers */
@@ -64,19 +52,14 @@ export class AgentEventBus extends EventEmitter {
         this.setMaxListeners(100);
         this.#logger = Logger.getInstance();
     }
-    /**
-     * 获取全局单例
-     * @returns {AgentEventBus}
-     */
+    /** 获取全局单例 */
     static getInstance() {
         if (!AgentEventBus.#instance) {
             AgentEventBus.#instance = new AgentEventBus();
         }
         return AgentEventBus.#instance;
     }
-    /**
-     * 重置单例（测试用）
-     */
+    /** 重置单例（测试用） */
     static resetInstance() {
         if (AgentEventBus.#instance) {
             AgentEventBus.#instance.removeAllListeners();
@@ -88,12 +71,11 @@ export class AgentEventBus extends EventEmitter {
     // ─── 发布 ────────────────────────────────
     /**
      * 发布事件（广播）
-     * @param {string} type 事件类型
-     * @param {Object} payload 事件数据
-     * @param {Object} [opts]
-     * @param {string} [opts.source] 发送者 agentId
-     * @param {string} [opts.target] 目标 agentId
-     * @param {string} [opts.correlationId] 关联 ID
+     * @param type 事件类型
+     * @param payload 事件数据
+     * @param [opts.source] 发送者 agentId
+     * @param [opts.target] 目标 agentId
+     * @param [opts.correlationId] 关联 ID
      */
     publish(type, payload = {}, opts = {}) {
         this.#eventCount++;
@@ -128,9 +110,9 @@ export class AgentEventBus extends EventEmitter {
     }
     /**
      * 订阅事件
-     * @param {string} type 事件类型
-     * @param {Function} handler 处理函数 (event) => void
-     * @returns {Function} 取消订阅函数
+     * @param type 事件类型
+     * @param handler 处理函数 (event) => void
+     * @returns 取消订阅函数
      */
     subscribe(type, handler) {
         if (!this.#subscriptions.has(type)) {
@@ -149,12 +131,11 @@ export class AgentEventBus extends EventEmitter {
     }
     /**
      * Request/Reply 模式 — 发送请求并等待响应
-     * @param {string} requestType 请求事件类型
-     * @param {Object} payload 请求数据
-     * @param {Object} [opts]
-     * @param {number} [opts.timeout=30000] 超时毫秒
-     * @param {string} [opts.source] 发送者
-     * @returns {Promise<AgentEvent>} 响应事件
+     * @param requestType 请求事件类型
+     * @param payload 请求数据
+     * @param [opts.timeout=30000] 超时毫秒
+     * @param [opts.source] 发送者
+     * @returns 响应事件
      */
     async request(requestType, payload = {}, opts = {}) {
         const correlationId = `req_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
@@ -171,10 +152,7 @@ export class AgentEventBus extends EventEmitter {
         });
         return promise;
     }
-    /**
-     * 获取事件统计
-     * @returns {Object}
-     */
+    /** 获取事件统计 */
     getStats() {
         return {
             totalEvents: this.#eventCount,
@@ -184,4 +162,3 @@ export class AgentEventBus extends EventEmitter {
     }
 }
 export default AgentEventBus;
-//# sourceMappingURL=AgentEventBus.js.map

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

@@ -13,7 +13,7 @@
  *
  * @module AgentFactory
  */
-import type { AiProvider } from '../../external/ai/AiProvider.js';
+import type { AiProvider } from '#external/ai/AiProvider.js';
 import { AgentRouter } from './AgentRouter.js';
 import { AgentRuntime } from './AgentRuntime.js';
 import { ContextWindow } from './context/ContextWindow.js';
@@ -75,34 +75,26 @@ interface BootstrapKnowledgeOptions {
 export declare class AgentFactory {
     #private;
     /**
-     * @param {Object} opts
-     * @param {Object} opts.container - ServiceContainer 实例
-     * @param {import('./tools/ToolRegistry.js').ToolRegistry} opts.toolRegistry
-     * @param {import('../../external/ai/AiProvider.js').AiProvider} opts.aiProvider
-     * @param {Object} [opts.memoryCoordinator] - MemoryCoordinator 实例 (注入 Conversation)
-     * @param {string} [opts.projectBriefing] 项目概况文本
-     * @param {string} [opts.projectRoot] 项目根目录
+     * @param opts.container ServiceContainer 实例
+     * @param [opts.memoryCoordinator] MemoryCoordinator 实例 (注入 Conversation)
+     * @param [opts.projectBriefing] 项目概况文本
+     * @param [opts.projectRoot] 项目根目录
      */
     constructor({ container, toolRegistry, aiProvider, memoryCoordinator, projectBriefing, projectRoot, }: AgentFactoryOptions);
-    /**
-     * 创建带路由器的自动调度系统
-     * @returns {AgentRouter}
-     */
+    /** 创建带路由器的自动调度系统 */
     createRouter(): AgentRouter;
     /**
      * 根据 Preset 名称创建 AgentRuntime
      *
      * 这是一切的根基 — 任何 "Agent 类型" 都通过这个方法创建。
      *
-     * @param {string} presetName - Preset 名称 (chat/insight/remote-exec)
-     * @param {Object} [overrides] 覆盖 preset 配置
-     * @returns {AgentRuntime}
+     * @param presetName Preset 名称 (chat/insight/remote-exec)
+     * @param [overrides] 覆盖 preset 配置
      */
     createRuntime(presetName: string, overrides?: RuntimeOverrides): AgentRuntime;
     /**
      * 创建 ContextWindow (根据当前 AI Provider 自动解析 token 预算)
      * @param {{ isSystem?: boolean }} [opts]
-     * @returns {ContextWindow}
      */
     createContextWindow(opts?: {
         isSystem?: boolean;
@@ -129,12 +121,11 @@ export declare class AgentFactory {
      * bootstrap orchestrator 不使用此方法（它还需要领域特定的 SessionStore / dimContext 等），
      * 但引擎层基础设施是一致的。
      *
-     * @param {Object} [opts]
-     * @param {Object} [opts.budget] 预算覆盖 (透传给 ExplorationTracker)
-     * @param {string} [opts.trackerStrategy='analyst'] - tracker 策略名: 'analyst' | 'producer' | 'bootstrap'
-     * @param {string} [opts.label='default'] 作用域标签 (用于 scopeId 命名 + dimId)
-     * @param {string} [opts.lang] 项目语言 (透传给 sharedState._projectLanguage)
-     * @returns {{ contextWindow: ContextWindow, tracker: ExplorationTracker, trace: import('./memory/ActiveContext.js').ActiveContext, activeContext: import('./memory/ActiveContext.js').ActiveContext, memoryCoordinator: MemoryCoordinator, outputType: string, dimId: string, sharedState: Object, source: string, scopeId: string }}
+     * @param [opts.budget] 预算覆盖 (透传给 ExplorationTracker)
+     * @param [opts.trackerStrategy='analyst'] tracker 策略名: 'analyst' | 'producer' | 'bootstrap'
+     * @param [opts.label='default'] 作用域标签 (用于 scopeId 命名 + dimId)
+     * @param [opts.lang] 项目语言 (透传给 sharedState._projectLanguage)
+     * @returns }
      */
     buildSystemContext({ budget, trackerStrategy, label, lang, }?: SystemContextOptions): {
         contextWindow: ContextWindow;
@@ -155,33 +146,23 @@ export declare class AgentFactory {
     };
     /**
      * 获取 AI Provider 信息 (供 orchestrator 等外部使用)
-     * @returns {{ model: string, name: string }}
+     * @returns }
      */
     getAiProviderInfo(): {
         model: string;
         name: string;
     };
-    /**
-     * 创建对话 Runtime (Dashboard / 飞书聊天)
-     * @param {Object} [opts]
-     */
+    /** 创建对话 Runtime (Dashboard / 飞书聊天) */
     createChat(opts?: RuntimeOverrides): AgentRuntime;
     /**
      * 创建洞察 Runtime (深度代码分析 + 知识提取)
-     * @param {Object} [opts]
-     * @param {Array} [opts.dimensions] 维度列表 (传给 FanOutStrategy 的 items)
-     * @param {Object} [opts.projectInfo] 项目信息
+     * @param [opts.dimensions] 维度列表 (传给 FanOutStrategy 的 items)
+     * @param [opts.projectInfo] 项目信息
      */
     createInsight(opts?: RuntimeOverrides): AgentRuntime;
-    /**
-     * 创建飞书对话 Runtime (知识管理，服务端处理)
-     * @param {Object} [opts]
-     */
+    /** 创建飞书对话 Runtime (知识管理，服务端处理) */
     createLark(opts?: RuntimeOverrides): AgentRuntime;
-    /**
-     * 创建远程执行 Runtime (飞书终端 / 远程操作)
-     * @param {Object} [opts]
-     */
+    /** 创建远程执行 Runtime (飞书终端 / 远程操作) */
     createRemoteExec(opts?: RuntimeOverrides): AgentRuntime;
     /**
      * 统一知识扫描 — 走 insight 管线 (Analyze → QualityGate → Produce → RejectionGate)
@@ -193,13 +174,12 @@ export declare class AgentFactory {
      *
      * 关系发现请使用单独的 discoverRelations() 方法。
      *
-     * @param {Object} opts
-     * @param {string} opts.label              上下文标签（target 名 / 文件名）
+     * @param opts.label 上下文标签（target 名 / 文件名）
      * @param {Array<{name, content, language?}>} opts.files 源文件
-     * @param {'extract'|'summarize'} [opts.task='extract'] 任务类型
-     * @param {string} [opts.lang]             语言提示
-     * @param {boolean} [opts.comprehensive]   深度扫描标志
-     * @returns {Promise<Object>}              - task-specific JSON
+     * @param [opts.task='extract'] 任务类型
+     * @param [opts.lang] 语言提示
+     * @param [opts.comprehensive] 深度扫描标志
+     * @returns task-specific JSON
      */
     scanKnowledge({ label, files, task, lang, comprehensive, }?: ScanKnowledgeOptions): Promise<any>;
     /**
@@ -208,9 +188,8 @@ export declare class AgentFactory {
      * 与 scanKnowledge 不同，relations 不需要源文件输入，
      * 而是通过查询知识库 + 读取源码发现知识条目间的语义关系。
      *
-     * @param {Object} [opts]
-     * @param {number} [opts.batchSize=20] 批次大小提示
-     * @returns {Promise<{ analyzed: number, relations: Array }>}
+     * @param [opts.batchSize=20] 批次大小提示
+     * @returns >}
      */
     discoverRelations({ batchSize }?: {
         batchSize?: number | undefined;
@@ -220,9 +199,9 @@ export declare class AgentFactory {
      *
      * Agent(LLM) 直接翻译文本，无需工具。
      *
-     * @param {string} summary 中文摘要
-     * @param {string} [usageGuide] 中文使用指南
-     * @returns {Promise<{ summaryEn?: string, usageGuideEn?: string, error?: string }>}
+     * @param summary 中文摘要
+     * @param [usageGuide] 中文使用指南
+     * @returns >}
      */
     translateToEnglish(summary: string, usageGuide?: string): Promise<any>;
     /**
@@ -232,7 +211,6 @@ export declare class AgentFactory {
      * Candidate 创建，全程无 AI 推理。直接调用 handler 即可，无需创建 Agent。
      *
      * @param {{ maxFiles?: number, skipGuard?: boolean, contentMaxLines?: number, loadSkills?: boolean, skipAsyncFill?: boolean }} [opts]
-     * @returns {Promise<Object>}
      */
     bootstrapKnowledge(opts?: BootstrapKnowledgeOptions): Promise<any>;
     /**
@@ -241,11 +219,10 @@ export declare class AgentFactory {
      * 纯数据工具直接执行，无需创建 Agent。
      * AI 推理由各语义方法的 Agent 自主完成，此方法仅用于纯数据工具。
      *
-     * @param {string} toolName 工具名称
-     * @param {Object} params 工具参数
-     * @returns {Promise<*>} 工具原始返回值
+     * @param toolName 工具名称
+     * @param params 工具参数
+     * @returns 工具原始返回值
      */
     invokeAgent(toolName: string, params: Record<string, unknown>): Promise<unknown>;
 }
 export default AgentFactory;
-//# sourceMappingURL=AgentFactory.d.ts.map