autosnippet 3.2.16 → 3.2.18

package/dist/lib/external/ai/providers/GoogleGeminiProvider.js

@@ -22,9 +22,7 @@ export class GoogleGeminiProvider extends AiProvider {
         this.apiKey = config.apiKey || process.env.ASD_GOOGLE_API_KEY || '';
         this.logger = Logger.getInstance();
     }
-    /**
-     * 是否支持原生结构化函数调用
-     */
+    /** 是否支持原生结构化函数调用 */
     get supportsNativeToolCalling() {
         return true;
     }
@@ -60,15 +58,11 @@ export class GoogleGeminiProvider extends AiProvider {
      *
      * 接受统一消息格式，内部转换为 Gemini 原生 contents 格式。
      *
-     * @param {string} prompt 未使用 messages 时的 fallback prompt
-     * @param {object} opts
-     * @param {Array}  opts.messages 统一格式消息
-     * @param {Array}  opts.toolSchemas - [{name, description, parameters}]
-     * @param {string} opts.toolChoice - 'auto' | 'required' | 'none'
-     * @param {string} [opts.systemPrompt]
-     * @param {number} [opts.temperature=0.7]
-     * @param {number} [opts.maxTokens=8192]
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id, name, args}>|null}>}
+     * @param prompt 未使用 messages 时的 fallback prompt
+     * @param opts.messages 统一格式消息
+     * @param opts.toolSchemas [{name, description, parameters}]
+     * @param opts.toolChoice 'auto' | 'required' | 'none'
+     * @returns >|null}>}
      */
     async chatWithTools(prompt, opts = {}) {
         return this._withRetry(async () => {
@@ -122,9 +116,7 @@ export class GoogleGeminiProvider extends AiProvider {
     #convertMessages(messages) {
         const contents = [];
         let pendingToolResults = [];
-        /**
-         * 推入 contents，如果上一个 entry 同角色则合并 parts
-         */
+        /** 推入 contents，如果上一个 entry 同角色则合并 parts */
         const pushOrMerge = (entry) => {
             const last = contents[contents.length - 1];
             if (last && last.role === entry.role) {
@@ -181,9 +173,7 @@ export class GoogleGeminiProvider extends AiProvider {
         }
         return contents;
     }
-    /**
-     * toolChoice → Gemini mode
-     */
+    /** toolChoice → Gemini mode */
     #toGeminiMode(toolChoice) {
         switch (toolChoice) {
             case 'required':
@@ -194,9 +184,7 @@ export class GoogleGeminiProvider extends AiProvider {
                 return 'AUTO';
         }
     }
-    /**
-     * 标准 tool schema → Gemini functionDeclaration
-     */
+    /** 标准 tool schema → Gemini functionDeclaration */
     #toFunctionDeclaration(schema) {
         return {
             name: schema.name,
@@ -399,4 +387,3 @@ export class GoogleGeminiProvider extends AiProvider {
     }
 }
 export default GoogleGeminiProvider;
-//# sourceMappingURL=GoogleGeminiProvider.js.map

package/dist/lib/external/ai/providers/MockProvider.d.ts

@@ -21,14 +21,9 @@ export declare class MockProvider extends AiProvider {
     chat(prompt: string, context?: ChatContext): Promise<string>;
     summarize(code: string): Promise<Record<string, unknown>>;
     embed(text: string | string[]): Promise<number[] | number[][]>;
-    /**
-     * 获取调用日志（测试断言用）
-     */
+    /** 获取调用日志（测试断言用） */
     getCalls(): CallLogEntry[];
-    /**
-     * 重置调用记录
-     */
+    /** 重置调用记录 */
     reset(): void;
 }
 export default MockProvider;
-//# sourceMappingURL=MockProvider.d.ts.map

package/dist/lib/external/ai/providers/MockProvider.js

@@ -42,18 +42,13 @@ export class MockProvider extends AiProvider {
         }
         return makeVector();
     }
-    /**
-     * 获取调用日志（测试断言用）
-     */
+    /** 获取调用日志（测试断言用） */
     getCalls() {
         return this.callLog;
     }
-    /**
-     * 重置调用记录
-     */
+    /** 重置调用记录 */
     reset() {
         this.callLog = [];
     }
 }
 export default MockProvider;
-//# sourceMappingURL=MockProvider.js.map

package/dist/lib/external/ai/providers/OpenAiProvider.d.ts

@@ -23,9 +23,9 @@ export declare class OpenAiProvider extends AiProvider {
      * 接受统一消息格式，内部转换为 OpenAI Chat Completions 消息格式。
      * 兼容 DeepSeek / Ollama 等 OpenAI-Compatible API。
      *
-     * @param {string} prompt - fallback prompt
-     * @param {object} opts 统一参数
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id, name, args}>|null}>}
+     * @param prompt fallback prompt
+     * @param opts 统一参数
+     * @returns >|null}>}
      */
     chatWithTools(prompt: string, opts?: ChatWithToolsOptions): Promise<ChatWithToolsResult>;
     summarize(code: string): Promise<any>;
@@ -40,4 +40,3 @@ export declare class OpenAiProvider extends AiProvider {
     _post(url: string, body: Record<string, unknown>): Promise<ApiResponse>;
 }
 export default OpenAiProvider;
-//# sourceMappingURL=OpenAiProvider.d.ts.map

package/dist/lib/external/ai/providers/OpenAiProvider.js

@@ -51,9 +51,9 @@ export class OpenAiProvider extends AiProvider {
      * 接受统一消息格式，内部转换为 OpenAI Chat Completions 消息格式。
      * 兼容 DeepSeek / Ollama 等 OpenAI-Compatible API。
      *
-     * @param {string} prompt - fallback prompt
-     * @param {object} opts 统一参数
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id, name, args}>|null}>}
+     * @param prompt fallback prompt
+     * @param opts 统一参数
+     * @returns >|null}>}
      */
     async chatWithTools(prompt, opts = {}) {
         return this._withRetry(async () => {
@@ -268,4 +268,3 @@ export class OpenAiProvider extends AiProvider {
     }
 }
 export default OpenAiProvider;
-//# sourceMappingURL=OpenAiProvider.js.map

package/dist/lib/{service/agent → external/lark}/LarkTransport.d.ts

@@ -17,7 +17,7 @@
  *
  * @module LarkTransport
  */
-import type { AgentRuntime } from './AgentRuntime.js';
+import type { AgentRuntime } from '#agent/AgentRuntime.js';
 interface AgentFactory {
     createLark(opts: RuntimeOverrides): AgentRuntime;
     createRemoteExec(opts: RuntimeOverrides): AgentRuntime;
@@ -44,7 +44,7 @@ interface LarkTransportConfig {
         id: string;
     }>;
     isUserAllowed?: (userId: string) => boolean;
-    aiProvider?: import('../../external/ai/AiProvider.js').AiProvider;
+    aiProvider?: import('#external/ai/AiProvider.js').AiProvider;
     projectRoot?: string;
 }
 /** Raw Lark im.message.receive_v1 event data */
@@ -68,37 +68,20 @@ interface LarkRawSender {
         open_id?: string;
     };
 }
-/**
- * @typedef {Object} LarkTransportConfig
- * @property {import('./AgentFactory.js').AgentFactory} agentFactory - Agent 工厂
- * @property {Function} replyFn - (messageId, text) => Promise<void>
- * @property {Function} sendFn - (text) => Promise<void> (主动发送到活跃会话)
- * @property {Function} [sendImageFn] - (caption?) => Promise<{success, message}>
- * @property {Function} [getStatusFn] - () => Promise<string> 获取系统状态
- * @property {Function} [enqueueIdeFn] - (command, meta) => Promise<{id}> 写入 IDE 队列
- * @property {Function} [isUserAllowed] - (userId) => boolean 鉴权
- * @property {import('../../external/ai/AiProvider.js').AiProvider} [aiProvider]
- * @property {string} [projectRoot] 项目根目录 (用于 ConversationStore 持久化)
- */
 export declare class LarkTransport {
     #private;
     /** 对话历史最大轮数 */
     static MAX_HISTORY: number;
     /** 去重 TTL (5 分钟) */
     static DEDUP_TTL: number;
-    /**
-     * @param {LarkTransportConfig} config
-     */
     constructor(config: LarkTransportConfig);
     /**
      * 接收原始飞书消息事件
      *
      * 这是唯一入口 — 替代了 remote.js 中的 handleLarkMessage()
      *
-     * @param {Object} data 飞书 im.message.receive_v1 事件数据
-     * @returns {Promise<void>}
+     * @param data 飞书 im.message.receive_v1 事件数据
      */
     receive(data: LarkRawEvent): Promise<void>;
 }
 export default LarkTransport;
-//# sourceMappingURL=LarkTransport.d.ts.map

package/dist/lib/{service/agent → external/lark}/LarkTransport.js

@@ -18,22 +18,10 @@
  * @module LarkTransport
  */
 var _a;
-import Logger from '../../infrastructure/logging/Logger.js';
-import { AgentMessage } from './AgentMessage.js';
-import { ConversationStore } from './ConversationStore.js';
-import { Intent, IntentClassifier } from './IntentClassifier.js';
-/**
- * @typedef {Object} LarkTransportConfig
- * @property {import('./AgentFactory.js').AgentFactory} agentFactory - Agent 工厂
- * @property {Function} replyFn - (messageId, text) => Promise<void>
- * @property {Function} sendFn - (text) => Promise<void> (主动发送到活跃会话)
- * @property {Function} [sendImageFn] - (caption?) => Promise<{success, message}>
- * @property {Function} [getStatusFn] - () => Promise<string> 获取系统状态
- * @property {Function} [enqueueIdeFn] - (command, meta) => Promise<{id}> 写入 IDE 队列
- * @property {Function} [isUserAllowed] - (userId) => boolean 鉴权
- * @property {import('../../external/ai/AiProvider.js').AiProvider} [aiProvider]
- * @property {string} [projectRoot] 项目根目录 (用于 ConversationStore 持久化)
- */
+import { AgentMessage } from '#agent/AgentMessage.js';
+import { ConversationStore } from '#agent/ConversationStore.js';
+import { Intent, IntentClassifier } from '#agent/IntentClassifier.js';
+import Logger from '#infra/logging/Logger.js';
 export class LarkTransport {
     #agentFactory;
     #classifier;
@@ -56,9 +44,6 @@ export class LarkTransport {
     #recentMsgIds = new Map();
     /** 去重 TTL (5 分钟) */
     static DEDUP_TTL = 5 * 60 * 1000;
-    /**
-     * @param {LarkTransportConfig} config
-     */
     constructor(config) {
         this.#agentFactory = config.agentFactory;
         this.#replyFn = config.replyFn ?? null;
@@ -85,8 +70,7 @@ export class LarkTransport {
      *
      * 这是唯一入口 — 替代了 remote.js 中的 handleLarkMessage()
      *
-     * @param {Object} data 飞书 im.message.receive_v1 事件数据
-     * @returns {Promise<void>}
+     * @param data 飞书 im.message.receive_v1 事件数据
      */
     async receive(data) {
         const message = data?.message || data?.event?.message || {};
@@ -187,9 +171,7 @@ export class LarkTransport {
     // ═══════════════════════════════════════════════════
     //  意图处理器
     // ═══════════════════════════════════════════════════
-    /**
-     * 系统操作 — 直接处理，不走 Agent
-     */
+    /** 系统操作 — 直接处理，不走 Agent */
     async #handleSystem(action, messageId, _text) {
         switch (action) {
             case 'status':
@@ -292,9 +274,7 @@ export class LarkTransport {
             await this.#reply(messageId, `❌ 转发失败: ${err.message}`);
         }
     }
-    /**
-     * 远程命令执行 — 使用 remote-exec preset（含 SafetyPolicy 命令白名单）
-     */
+    /** 远程命令执行 — 使用 remote-exec preset（含 SafetyPolicy 命令白名单） */
     async #handleRemoteExec(command, messageId, chatId, senderId, senderName) {
         await this.#reply(messageId, `⚡ 正在执行: \`${command.slice(0, 60)}\`...`);
         try {
@@ -334,9 +314,7 @@ export class LarkTransport {
             await this.#reply(messageId, `❌ 执行失败: ${err.message}`);
         }
     }
-    /**
-     * Bot Agent 知识任务 — 服务端 AgentRuntime 直接处理
-     */
+    /** Bot Agent 知识任务 — 服务端 AgentRuntime 直接处理 */
     async #handleBotAgent(text, messageId, chatId, senderId, senderName) {
         // 进度提示
         await this.#reply(messageId, '🤔 正在思考...');
@@ -394,8 +372,7 @@ export class LarkTransport {
     // ═══════════════════════════════════════════════════
     /**
      * 获取或创建 chatId 对应的 conversationId
-     * @param {string} chatId
-     * @returns {string|null} conversationId (ConversationStore 不可用时返回 null)
+     * @returns conversationId (ConversationStore 不可用时返回 null)
      */
     #resolveConversationId(chatId) {
         if (!this.#conversationStore || !chatId) {
@@ -428,9 +405,7 @@ export class LarkTransport {
             return null;
         }
     }
-    /**
-     * 获取指定会话的历史
-     */
+    /** 获取指定会话的历史 */
     #getHistory(chatId) {
         // 优先使用 ConversationStore 持久化历史
         const convId = this.#resolveConversationId(chatId);
@@ -445,9 +420,7 @@ export class LarkTransport {
         // 降级到内存
         return this.#conversationHistory.get(chatId) || [];
     }
-    /**
-     * 获取最近对话的可读文本 (给 IntentClassifier 提供上下文)
-     */
+    /** 获取最近对话的可读文本 (给 IntentClassifier 提供上下文) */
     #getRecentHistoryText(chatId) {
         const history = this.#getHistory(chatId);
         if (history.length === 0) {
@@ -458,9 +431,7 @@ export class LarkTransport {
             .map((h) => `${h.role}: ${h.content.slice(0, 100)}`)
             .join('\n');
     }
-    /**
-     * 追加对话记录 (双写: ConversationStore + 内存降级)
-     */
+    /** 追加对话记录 (双写: ConversationStore + 内存降级) */
     #appendHistory(chatId, role, content) {
         if (!chatId) {
             return;
@@ -502,4 +473,3 @@ export class LarkTransport {
 }
 _a = LarkTransport;
 export default LarkTransport;
-//# sourceMappingURL=LarkTransport.js.map

package/dist/lib/external/mcp/McpServer.d.ts

@@ -90,14 +90,13 @@ export declare class McpServer {
      *   - 其他工具: 注入 _activeDecisions 摘要
      *   - 首次未调 prime 的工具: 注入更强提醒
      *
-     * @param {string} toolName
-     * @param {object} result - handler 返回的 envelope 对象
+     * @param result handler 返回的 envelope 对象
      */
     _injectDecisions(toolName: string, result: unknown): Promise<unknown>;
     /**
      * 获取 decisions 摘要（带缓存 + 防并发）
      * @private
-     * @returns {Promise<Array<{id: string, title: string}>>}
+     * @returns >>}
      */
     _getDecisionsSummary(): Promise<DecisionEntry[]>;
     /**
@@ -137,4 +136,3 @@ export declare class McpServer {
 }
 export declare function startMcpServer(): Promise<McpServer>;
 export default McpServer;
-//# sourceMappingURL=McpServer.d.ts.map

package/dist/lib/external/mcp/McpServer.js

@@ -200,8 +200,7 @@ export class McpServer {
      *   - 其他工具: 注入 _activeDecisions 摘要
      *   - 首次未调 prime 的工具: 注入更强提醒
      *
-     * @param {string} toolName
-     * @param {object} result - handler 返回的 envelope 对象
+     * @param result handler 返回的 envelope 对象
      */
     async _injectDecisions(toolName, result) {
         // ── P3: Session 统计 ──
@@ -242,7 +241,7 @@ export class McpServer {
     /**
      * 获取 decisions 摘要（带缓存 + 防并发）
      * @private
-     * @returns {Promise<Array<{id: string, title: string}>>}
+     * @returns >>}
      */
     async _getDecisionsSummary() {
         const cache = this._decisionCache;
@@ -467,4 +466,3 @@ export async function startMcpServer() {
     return server;
 }
 export default McpServer;
-//# sourceMappingURL=McpServer.js.map

package/dist/lib/external/mcp/autoApproveInjector.d.ts

@@ -32,17 +32,15 @@ declare const AUTO_APPROVE_TOOLS: string[];
  * 在 bootstrap handler 中调用。只写一个轻量标记文件到 .autosnippet/，
  * 不触碰 .cursor/mcp.json，避免 Cursor 检测配置变更重启 MCP Server。
  *
- * @param {string} projectRoot 项目根目录
- * @param {object} [logger]
- * @returns {boolean}
+ * @param projectRoot 项目根目录
  */
 export declare function markAutoApproveNeeded(projectRoot: string, logger?: AutoApproveLogger): boolean;
 /**
  * 向 .cursor/mcp.json 中 autosnippet 服务器注入 autoApprove 工具列表
  *
- * @param {string} projectRoot 项目根目录
- * @param {object} [logger]    日志实例（可选）
- * @returns {boolean} 是否成功写入（false = 文件不存在或无 autosnippet 配置）
+ * @param projectRoot 项目根目录
+ * @param [logger] 日志实例（可选）
+ * @returns 是否成功写入（false = 文件不存在或无 autosnippet 配置）
  */
 export declare function injectAutoApprove(projectRoot: string, logger?: AutoApproveLogger): boolean;
 /**
@@ -50,10 +48,6 @@ export declare function injectAutoApprove(projectRoot: string, logger?: AutoAppr
  *
  * 注入发生在 MCP 连接建立之前，写入 mcp.json 不影响当前启动。
  * Cursor 下次读取 mcp.json 时（重启或新窗口）即生效。
- *
- * @param {string} projectRoot
- * @param {object} [logger]
  */
 export declare function applyPendingAutoApprove(projectRoot: string, logger?: AutoApproveLogger): void;
 export { AUTO_APPROVE_TOOLS };
-//# sourceMappingURL=autoApproveInjector.d.ts.map

package/dist/lib/external/mcp/autoApproveInjector.js

@@ -50,9 +50,7 @@ function _markerPath(projectRoot) {
  * 在 bootstrap handler 中调用。只写一个轻量标记文件到 .autosnippet/，
  * 不触碰 .cursor/mcp.json，避免 Cursor 检测配置变更重启 MCP Server。
  *
- * @param {string} projectRoot 项目根目录
- * @param {object} [logger]
- * @returns {boolean}
+ * @param projectRoot 项目根目录
  */
 export function markAutoApproveNeeded(projectRoot, logger) {
     const marker = _markerPath(projectRoot);
@@ -74,9 +72,9 @@ export function markAutoApproveNeeded(projectRoot, logger) {
 /**
  * 向 .cursor/mcp.json 中 autosnippet 服务器注入 autoApprove 工具列表
  *
- * @param {string} projectRoot 项目根目录
- * @param {object} [logger]    日志实例（可选）
- * @returns {boolean} 是否成功写入（false = 文件不存在或无 autosnippet 配置）
+ * @param projectRoot 项目根目录
+ * @param [logger] 日志实例（可选）
+ * @returns 是否成功写入（false = 文件不存在或无 autosnippet 配置）
  */
 export function injectAutoApprove(projectRoot, logger) {
     const configPath = path.join(projectRoot, '.cursor', 'mcp.json');
@@ -124,9 +122,6 @@ export function injectAutoApprove(projectRoot, logger) {
  *
  * 注入发生在 MCP 连接建立之前，写入 mcp.json 不影响当前启动。
  * Cursor 下次读取 mcp.json 时（重启或新窗口）即生效。
- *
- * @param {string} projectRoot
- * @param {object} [logger]
  */
 export function applyPendingAutoApprove(projectRoot, logger) {
     const marker = _markerPath(projectRoot);
@@ -145,4 +140,3 @@ export function applyPendingAutoApprove(projectRoot, logger) {
     }
 }
 export { AUTO_APPROVE_TOOLS };
-//# sourceMappingURL=autoApproveInjector.js.map

package/dist/lib/external/mcp/envelope.d.ts

@@ -3,13 +3,8 @@
  * 所有 MCP 工具返回的 content 均使用此格式
  */
 /**
- * @param {object} opts
- * @param {boolean} opts.success
- * @param {*}       [opts.data]
- * @param {string}  [opts.message]
- * @param {object}  [opts.meta]        - { tool, version, responseTimeMs, source }
- * @param {string}  [opts.errorCode]
- * @returns {object} 标准化响应对象
+ * @param [opts.meta] { tool, version, responseTimeMs, source }
+ * @returns 标准化响应对象
  */
 export interface EnvelopeMeta {
     responseTimeMs?: number;
@@ -38,4 +33,3 @@ export declare function envelope<T = unknown>({ success, data, message, meta, er
     };
 };
 export default envelope;
-//# sourceMappingURL=envelope.d.ts.map

package/dist/lib/external/mcp/envelope.js

@@ -21,4 +21,3 @@ export function envelope({ success, data = null, message = '', meta = {}, errorC
     };
 }
 export default envelope;
-//# sourceMappingURL=envelope.js.map

package/dist/lib/external/mcp/errorHandler.d.ts

@@ -20,14 +20,13 @@ type McpHandlerFn = (ctx: Record<string, unknown>, args: Record<string, unknown>
  * 则在 handler 执行前自动校验并 parse（应用 defaults + coercion），
  * 校验失败返回结构化 VALIDATION_ERROR，不会到达 handler。
  *
- * @param {string} toolName 工具名（用于 meta.tool + schema 查找）
- * @param {Function} handlerFn 原始 handler: (ctx, args) => Promise<unknown>
- * @param {ZodType} [schema] 可选的显式 schema 覆盖（优先于 TOOL_SCHEMAS 自动查找）
- * @returns {Function} 包装后的 handler，保证 *不会* throw
+ * @param toolName 工具名（用于 meta.tool + schema 查找）
+ * @param handlerFn 原始 handler: (ctx, args) => Promise<unknown>
+ * @param [schema] 可选的显式 schema 覆盖（优先于 TOOL_SCHEMAS 自动查找）
+ * @returns 包装后的 handler，保证 *不会* throw
  */
 export declare function wrapHandler(toolName: string, handlerFn: McpHandlerFn, schema?: z.ZodType): (ctx: Record<string, unknown>, rawArgs: Record<string, unknown>) => Promise<unknown>;
 declare const _default: {
     wrapHandler: typeof wrapHandler;
 };
 export default _default;
-//# sourceMappingURL=errorHandler.d.ts.map

package/dist/lib/external/mcp/errorHandler.js

@@ -15,11 +15,7 @@ import Logger from '#infra/logging/Logger.js';
 import { ConflictError, ConstitutionViolation, NotFoundError, PermissionDenied, ValidationError, } from '#shared/errors/index.js';
 import { TOOL_SCHEMAS } from '#shared/schemas/mcp-tools.js';
 const logger = Logger.getInstance();
-/**
- * 从已知错误类型推断 errorCode
- * @param {Error} err
- * @returns {string}
- */
+/** 从已知错误类型推断 errorCode */
 function inferErrorCode(err) {
     if (err instanceof ValidationError) {
         return 'VALIDATION_ERROR';
@@ -49,10 +45,10 @@ function inferErrorCode(err) {
  * 则在 handler 执行前自动校验并 parse（应用 defaults + coercion），
  * 校验失败返回结构化 VALIDATION_ERROR，不会到达 handler。
  *
- * @param {string} toolName 工具名（用于 meta.tool + schema 查找）
- * @param {Function} handlerFn 原始 handler: (ctx, args) => Promise<unknown>
- * @param {ZodType} [schema] 可选的显式 schema 覆盖（优先于 TOOL_SCHEMAS 自动查找）
- * @returns {Function} 包装后的 handler，保证 *不会* throw
+ * @param toolName 工具名（用于 meta.tool + schema 查找）
+ * @param handlerFn 原始 handler: (ctx, args) => Promise<unknown>
+ * @param [schema] 可选的显式 schema 覆盖（优先于 TOOL_SCHEMAS 自动查找）
+ * @returns 包装后的 handler，保证 *不会* throw
  */
 export function wrapHandler(toolName, handlerFn, schema) {
     // 确定使用的 schema：显式传入 > TOOL_SCHEMAS 自动查找
@@ -120,4 +116,3 @@ export function wrapHandler(toolName, handlerFn, schema) {
     };
 }
 export default { wrapHandler };
-//# sourceMappingURL=errorHandler.js.map

package/dist/lib/external/mcp/handlers/LanguageExtensions.d.ts

@@ -18,8 +18,8 @@ export declare function detectPrimaryLanguage(langStats: Record<string, number>)
  * 根据主语言构建语言扩展字段
  * 包含：语言特有的分析关注点、典型模式、反模式、Guard 规则、Agent 注意事项
  *
- * @param {string} lang 规范化语言 ID (如 'swift', 'typescript')
- * @returns {{ language: string, customFields: object, extraDimensions: object[], typicalPatterns: string[], commonAntiPatterns: object[], suggestedGuardRules: object[], agentCautions: string[] }}
+ * @param lang 规范化语言 ID (如 'swift', 'typescript')
+ * @returns }
  */
 export declare function buildLanguageExtension(lang: string | null): {
     language: string;
@@ -30,4 +30,3 @@ export declare function buildLanguageExtension(lang: string | null): {
     suggestedGuardRules: never[];
     agentCautions: never[];
 };
-//# sourceMappingURL=LanguageExtensions.d.ts.map

package/dist/lib/external/mcp/handlers/LanguageExtensions.js

@@ -22,10 +22,7 @@ export function detectPrimaryLanguage(langStats) {
 // ═══════════════════════════════════════════════════════════
 // 语言扩展注册表 — 按 lang ID 索引
 // ═══════════════════════════════════════════════════════════
-/**
- * JS/TS 共享扩展生成器（根据具体 lang 微调差异点）
- * @param {'javascript'|'typescript'} lang
- */
+/** JS/TS 共享扩展生成器（根据具体 lang 微调差异点） */
 function _buildJsTsEntry(lang) {
     const isTs = lang === 'typescript';
     return {
@@ -97,7 +94,6 @@ function _buildJsTsEntry(lang) {
         ],
     };
 }
-/** @type {Readonly<Record<string, object>>} */
 const LANG_REGISTRY = Object.freeze({
     // ── Swift ──────────────────────────────────────────────────
     swift: {
@@ -911,8 +907,8 @@ const LANG_REGISTRY = Object.freeze({
  * 根据主语言构建语言扩展字段
  * 包含：语言特有的分析关注点、典型模式、反模式、Guard 规则、Agent 注意事项
  *
- * @param {string} lang 规范化语言 ID (如 'swift', 'typescript')
- * @returns {{ language: string, customFields: object, extraDimensions: object[], typicalPatterns: string[], commonAntiPatterns: object[], suggestedGuardRules: object[], agentCautions: string[] }}
+ * @param lang 规范化语言 ID (如 'swift', 'typescript')
+ * @returns }
  */
 export function buildLanguageExtension(lang) {
     const base = {
@@ -938,4 +934,3 @@ export function buildLanguageExtension(lang) {
     }
     return base;
 }
-//# sourceMappingURL=LanguageExtensions.js.map

package/dist/lib/external/mcp/handlers/TargetClassifier.d.ts

@@ -6,7 +6,6 @@
  *   - 文件名 → 分析优先级推断
  */
 /** 根据 Target 名称推断模块职责 */
-export declare function inferTargetRole(targetName: string): "model" | "config" | "test" | "app" | "service" | "ui" | "auth" | "networking" | "core" | "storage" | "routing" | "utility" | "feature";
+export declare function inferTargetRole(targetName: string): "model" | "config" | "networking" | "ui" | "service" | "auth" | "core" | "storage" | "test" | "app" | "routing" | "utility" | "feature";
 /** 根据文件名推断分析优先级 */
 export declare function inferFilePriority(filename: string): "high" | "medium" | "low";
-//# sourceMappingURL=TargetClassifier.d.ts.map

package/dist/lib/external/mcp/handlers/TargetClassifier.js

@@ -66,4 +66,3 @@ export function inferFilePriority(filename) {
     // Medium: everything else
     return 'medium';
 }
-//# sourceMappingURL=TargetClassifier.js.map