autosnippet 3.2.16 → 3.2.17

package/dist/lib/http/routes/guard.js

@@ -172,9 +172,9 @@ router.post('/batch', validate(GuardBatchBody), async (req, res) => {
 // ═══ 内部工具 ═══════════════════════════════════════
 /**
  * 获取或创建 GuardCheckEngine，并注入 Enhancement Pack 规则
- * @param {object} container - ServiceContainer
- * @param {Function} GuardCheckEngine - GuardCheckEngine class
- * @returns {Promise<object>} engine
+ * @param container ServiceContainer
+ * @param GuardCheckEngine GuardCheckEngine class
+ * @returns engine
  */
 async function _getEngine(container, GuardCheckEngineCtor) {
     let engine;
@@ -209,9 +209,6 @@ async function _getEngine(container, GuardCheckEngineCtor) {
  * 双重受众设计：
  *   - 人类看到: 波浪线 + 违规描述
  *   - Agent 看到: ruleId + 明确的 MCP 搜索指令
- *
- * @param {object} violation
- * @returns {string}
  */
 function _buildDiagnosticMessage(violation) {
     const { ruleId, message, fixSuggestion } = violation;
@@ -224,4 +221,3 @@ function _buildDiagnosticMessage(violation) {
     return msg;
 }
 export default router;
-//# sourceMappingURL=guard.js.map

package/dist/lib/http/routes/guardRules.d.ts

@@ -4,4 +4,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=guardRules.d.ts.map

package/dist/lib/http/routes/guardRules.js

@@ -11,9 +11,7 @@ import { LanguageService } from '../../shared/LanguageService.js';
 import { validate } from '../middleware/validate.js';
 import { getContext, safeInt } from '../utils/routeHelpers.js';
 const router = express.Router();
-/**
- * 将 Recipe 实体 → Guard 规则扁平格式（Dashboard GuardView 期望）
- */
+/** 将 Recipe 实体 → Guard 规则扁平格式（Dashboard GuardView 期望） */
 function mapRecipeToGuardRule(r) {
     const constraints = r.constraints;
     const guards = constraints?.guards || [];
@@ -303,4 +301,3 @@ router.get('/compliance', async (req, res) => {
     res.json({ success: true, data: report });
 });
 export default router;
-//# sourceMappingURL=guardRules.js.map

package/dist/lib/http/routes/health.d.ts

@@ -1,6 +1,3 @@
-/**
- * 健康检查端点
- */
+/** 健康检查端点 */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=health.d.ts.map

package/dist/lib/http/routes/health.js

@@ -1,6 +1,4 @@
-/**
- * 健康检查端点
- */
+/** 健康检查端点 */
 import express from 'express';
 const router = express.Router();
 /**
@@ -28,4 +26,3 @@ router.get('/ready', (req, res) => {
     });
 });
 export default router;
-//# sourceMappingURL=health.js.map

package/dist/lib/http/routes/knowledge.d.ts

@@ -5,4 +5,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=knowledge.d.ts.map

package/dist/lib/http/routes/knowledge.js

@@ -254,4 +254,3 @@ router.patch('/:id/quality', async (req, res) => {
     res.json({ success: true, data: result });
 });
 export default router;
-//# sourceMappingURL=knowledge.js.map

package/dist/lib/http/routes/modules.d.ts

@@ -6,4 +6,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=modules.d.ts.map

package/dist/lib/http/routes/modules.js

@@ -457,4 +457,3 @@ router.get('/bootstrap/status', async (req, res) => {
     });
 });
 export default router;
-//# sourceMappingURL=modules.js.map

package/dist/lib/http/routes/monitoring.d.ts

@@ -4,4 +4,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=monitoring.d.ts.map

package/dist/lib/http/routes/monitoring.js

@@ -308,4 +308,3 @@ router.post('/reset', (req, res) => {
     }
 });
 export default router;
-//# sourceMappingURL=monitoring.js.map

package/dist/lib/http/routes/recipes.d.ts

@@ -7,4 +7,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=recipes.d.ts.map

package/dist/lib/http/routes/recipes.js

@@ -129,9 +129,7 @@ router.post('/discover-relations', async (req, res) => {
     });
 });
 /* ═══ GET /api/v1/recipes/discover-relations/status ═════ */
-/**
- * 查询关系发现任务状态
- */
+/** 查询关系发现任务状态 */
 router.get('/discover-relations/status', async (req, res) => {
     const data = { ...discoverTask };
     // 计算实时 elapsed
@@ -141,4 +139,3 @@ router.get('/discover-relations/status', async (req, res) => {
     res.json({ success: true, data });
 });
 export default router;
-//# sourceMappingURL=recipes.js.map

package/dist/lib/http/routes/remote.d.ts

@@ -18,8 +18,8 @@
 declare const router: import("express-serve-static-core").Router;
 /**
  * 截取 IDE 窗口 → 上传飞书 → 发送图片消息（完整流水线）
- * @param {string} [caption] 可选文字说明（会先发一条文本）
- * @returns {Promise<{success: boolean, message: string}>}
+ * @param [caption] 可选文字说明（会先发一条文本）
+ * @returns >}
  */
 export declare function sendLarkScreenshot(caption?: string): Promise<{
     success: boolean;
@@ -29,13 +29,10 @@ export declare function sendLarkScreenshot(caption?: string): Promise<{
  * 向飞书活跃会话发送主动通知（非回复）
  * 用于任务进度、Guard 结果等非指令触发的通知
  *
- * @param {string} text 纯文本通知内容
- * @returns {Promise<boolean>} 发送是否成功
+ * @param text 纯文本通知内容
+ * @returns 发送是否成功
  */
 export declare function sendLarkNotification(text: string): Promise<boolean>;
-/**
- * 查询飞书通知是否可用
- */
+/** 查询飞书通知是否可用 */
 export declare function isLarkNotificationReady(): boolean;
 export default router;
-//# sourceMappingURL=remote.d.ts.map

package/dist/lib/http/routes/remote.js

@@ -18,10 +18,10 @@
 import crypto from 'node:crypto';
 import { readFileSync, unlinkSync } from 'node:fs';
 import express from 'express';
+import { LarkTransport } from '../../external/lark/LarkTransport.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { getServiceContainer } from '../../injection/ServiceContainer.js';
 import { RemoteCommandRepository, } from '../../repository/remote/RemoteCommandRepository.js';
-import { LarkTransport } from '../../service/agent/LarkTransport.js';
 import { resolveProjectRoot } from '../../shared/resolveProjectRoot.js';
 import { RemoteHistoryQuery, RemoteNotifyBody, RemoteResultBody, RemoteSendBody, } from '../../shared/schemas/http-requests.js';
 import { validate, validateQuery } from '../middleware/validate.js';
@@ -284,7 +284,6 @@ setInterval(() => {
 // ═══════════════════════════════════════════════════════
 //  LarkTransport — 自然语言意图路由
 // ═══════════════════════════════════════════════════════
-/** @type {LarkTransport|null} */
 let _larkTransport = null;
 /**
  * 获取或创建 LarkTransport 实例
@@ -321,9 +320,7 @@ function getLarkTransport() {
         return null;
     }
 }
-/**
- * 生成系统状态文本 (给 LarkTransport 系统操作使用)
- */
+/** 生成系统状态文本 (给 LarkTransport 系统操作使用) */
 async function getStatusText() {
     const lines = ['📊 状态面板', ''];
     const now = Math.floor(Date.now() / 1000);
@@ -369,9 +366,9 @@ async function getStatusText() {
 /**
  * 写入 IDE 编程指令队列 (供 LarkTransport 的 ide_agent 路由使用)
  *
- * @param {string} command 自然语言编程指令
- * @param {Object} meta - { chatId, messageId, senderId, senderName }
- * @returns {Promise<{id: string}>}
+ * @param command 自然语言编程指令
+ * @param meta { chatId, messageId, senderId, senderName }
+ * @returns >}
  */
 async function enqueueIdeCommand(command, meta = {}) {
     const repo = getRepo();
@@ -717,9 +714,8 @@ async function replyLark(messageId, text) {
 // ═══════════════════════════════════════════════════════
 /**
  * 截取 IDE 窗口截图（通过 ScreenCaptureKit 原生 API，息屏时可用）
- * @param {object} [opts]
- * @param {string} [opts.windowTitle] 窗口标题关键词（默认 "Code"）
- * @returns {Promise<{path: string|null, error: string|null}>}
+ * @param [opts.windowTitle] 窗口标题关键词（默认 "Code"）
+ * @returns >}
  */
 async function captureIDEScreenshot(opts = {}) {
     try {
@@ -758,8 +754,8 @@ async function captureIDEScreenshot(opts = {}) {
 }
 /**
  * 上传图片到飞书 Image API
- * @param {string} filePath 本地图片路径
- * @returns {Promise<{imageKey: string|null, error: string|null}>}
+ * @param filePath 本地图片路径
+ * @returns >}
  */
 async function _uploadImageToLark(filePath) {
     const token = await getTenantToken();
@@ -790,11 +786,7 @@ async function _uploadImageToLark(filePath) {
         return { imageKey: null, error: `上传异常: ${err.message}` };
     }
 }
-/**
- * 向飞书发送图片消息
- * @param {string} imageKey
- * @returns {Promise<boolean>}
- */
+/** 向飞书发送图片消息 */
 async function _sendLarkImageMsg(imageKey) {
     if (!_activeChatId || !_wsConnected) {
         return false;
@@ -840,8 +832,8 @@ async function _sendLarkImageMsg(imageKey) {
 }
 /**
  * 截取 IDE 窗口 → 上传飞书 → 发送图片消息（完整流水线）
- * @param {string} [caption] 可选文字说明（会先发一条文本）
- * @returns {Promise<{success: boolean, message: string}>}
+ * @param [caption] 可选文字说明（会先发一条文本）
+ * @returns >}
  */
 export async function sendLarkScreenshot(caption = '') {
     if (!_activeChatId || !_wsConnected) {
@@ -922,8 +914,8 @@ function _restoreActiveChatId() {
  * 向飞书活跃会话发送主动通知（非回复）
  * 用于任务进度、Guard 结果等非指令触发的通知
  *
- * @param {string} text 纯文本通知内容
- * @returns {Promise<boolean>} 发送是否成功
+ * @param text 纯文本通知内容
+ * @returns 发送是否成功
  */
 export async function sendLarkNotification(text) {
     if (!_activeChatId || !_wsConnected) {
@@ -968,11 +960,8 @@ export async function sendLarkNotification(text) {
         return false;
     }
 }
-/**
- * 查询飞书通知是否可用
- */
+/** 查询飞书通知是否可用 */
 export function isLarkNotificationReady() {
     return !!(_activeChatId && _wsConnected);
 }
 export default router;
-//# sourceMappingURL=remote.js.map

package/dist/lib/http/routes/search.d.ts

@@ -4,4 +4,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=search.d.ts.map

package/dist/lib/http/routes/search.js

@@ -335,4 +335,3 @@ router.post('/similarity', validate(SimilarityBody), async (req, res) => {
     }
 });
 export default router;
-//# sourceMappingURL=search.js.map

package/dist/lib/http/routes/skills.d.ts

@@ -4,4 +4,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=skills.d.ts.map

package/dist/lib/http/routes/skills.js

@@ -266,4 +266,3 @@ router.get('/metrics', (req, res) => {
     }
 });
 export default router;
-//# sourceMappingURL=skills.js.map

package/dist/lib/http/routes/snippets.d.ts

@@ -4,4 +4,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=snippets.d.ts.map

package/dist/lib/http/routes/snippets.js

@@ -47,4 +47,3 @@ router.get('/:id', async (req, res) => {
     res.json({ success: true, data: snippet });
 });
 export default router;
-//# sourceMappingURL=snippets.js.map

package/dist/lib/http/routes/task.d.ts

@@ -10,4 +10,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=task.d.ts.map

package/dist/lib/http/routes/task.js

@@ -47,9 +47,7 @@ router.post('/', validate(TaskDispatchBody), async (req, res) => {
         });
     }
 });
-/**
- * 操作路由 — 与 MCP handler/task.js 保持一致
- */
+/** 操作路由 — 与 MCP handler/task.js 保持一致 */
 async function _dispatch(svc, operation, params) {
     switch (operation) {
         case 'create':
@@ -380,4 +378,3 @@ async function _unpinDecision(svc, args) {
     };
 }
 export default router;
-//# sourceMappingURL=task.js.map

package/dist/lib/http/routes/violations.d.ts

@@ -4,4 +4,3 @@
  */
 declare const router: import("express-serve-static-core").Router;
 export default router;
-//# sourceMappingURL=violations.d.ts.map

package/dist/lib/http/routes/violations.js

@@ -67,4 +67,3 @@ router.post('/clear', async (req, res) => {
     });
 });
 export default router;
-//# sourceMappingURL=violations.js.map

package/dist/lib/http/routes/wiki.d.ts

@@ -13,15 +13,8 @@
  *   GET    /api/v1/wiki/file/:path      — 读取某个 Wiki 文件内容
  */
 declare const router: import("express-serve-static-core").Router;
-/**
- * 外部读取 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用）
- * @returns {typeof wikiTask}
- */
+/** 外部读取 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用） */
 export declare function getWikiTask(): Record<string, any>;
-/**
- * 外部设置 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用）
- * @param {Partial<typeof wikiTask>} patch
- */
+/** 外部设置 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用） */
 export declare function patchWikiTask(patch: Record<string, unknown>): void;
 export default router;
-//# sourceMappingURL=wiki.d.ts.map

package/dist/lib/http/routes/wiki.js

@@ -32,7 +32,6 @@ let wikiTask = {
     result: null,
     error: null,
 };
-/** @type {WikiGenerator|null} */
 let currentGenerator = null;
 function resetWikiTask() {
     wikiTask = {
@@ -47,23 +46,15 @@ function resetWikiTask() {
     };
     currentGenerator = null;
 }
-/**
- * 外部读取 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用）
- * @returns {typeof wikiTask}
- */
+/** 外部读取 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用） */
 export function getWikiTask() {
     return wikiTask;
 }
-/**
- * 外部设置 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用）
- * @param {Partial<typeof wikiTask>} patch
- */
+/** 外部设置 wikiTask 状态（供 bootstrap orchestrator 等外部流程同步使用） */
 export function patchWikiTask(patch) {
     Object.assign(wikiTask, patch);
 }
-/**
- * 创建 WikiGenerator 实例
- */
+/** 创建 WikiGenerator 实例 */
 function createGenerator(container) {
     const projectRoot = container.singletons?._projectRoot ||
         process.env.ASD_PROJECT_DIR ||
@@ -310,4 +301,3 @@ router.get('/file/{*path}', async (req, res) => {
     });
 });
 export default router;
-//# sourceMappingURL=wiki.js.map

package/dist/lib/http/utils/routeHelpers.d.ts

@@ -6,8 +6,7 @@ import type { Request } from 'express';
 import { KnowledgeEntry } from '../../domain/knowledge/KnowledgeEntry.js';
 /**
  * 从请求中提取操作上下文（用户身份、IP、UA）
- * @param {import('express').Request} req
- * @returns {{ userId: string, ip: string, userAgent: string }}
+ * @returns }
  */
 export declare function getContext(req: Request): {
     userId: string;
@@ -16,25 +15,24 @@ export declare function getContext(req: Request): {
 };
 /**
  * 安全的整数解析（带范围约束）
- * @param {*} value     待解析值
- * @param {number} defaultValue  解析失败时的默认值
- * @param {number} [min=1]       最小值
- * @param {number} [max=1000]    最大值
- * @returns {number}
+ * @param value 待解析值
+ * @param defaultValue 解析失败时的默认值
+ * @param [min=1] 最小值
+ * @param [max=1000] 最大值
  */
 export declare function safeInt(value: unknown, defaultValue: number, min?: number, max?: number): number;
 /**
  * 将 KnowledgeEntry（或其 toJSON 输出）转换为对外 API 安全的格式
  * - 过滤系统内部标签（dimension:* / bootstrap:* 等）
  *
- * @param {KnowledgeEntry|Object} entryOrJson  实体或 toJSON 输出
- * @returns {Object} 过滤后的 JSON
+ * @param entryOrJson 实体或 toJSON 输出
+ * @returns 过滤后的 JSON
  */
 export declare function sanitizeForAPI(entryOrJson: KnowledgeEntry | Record<string, unknown>): any;
 /**
  * 将分页结果中的 data 数组批量过滤系统标签
  * @param {{ data: Array, pagination: Object }} result
- * @returns {{ data: Array, pagination: Object }}
+ * @returns }
  */
 export declare function sanitizePaginatedForAPI(result: {
     data?: Array<KnowledgeEntry | Record<string, unknown>>;
@@ -45,4 +43,3 @@ export declare function sanitizePaginatedForAPI(result: {
 } | {
     data: any[];
 };
-//# sourceMappingURL=routeHelpers.d.ts.map

package/dist/lib/http/utils/routeHelpers.js

@@ -5,8 +5,7 @@
 import { KnowledgeEntry } from '../../domain/knowledge/KnowledgeEntry.js';
 /**
  * 从请求中提取操作上下文（用户身份、IP、UA）
- * @param {import('express').Request} req
- * @returns {{ userId: string, ip: string, userAgent: string }}
+ * @returns }
  */
 export function getContext(req) {
     return {
@@ -17,11 +16,10 @@ export function getContext(req) {
 }
 /**
  * 安全的整数解析（带范围约束）
- * @param {*} value     待解析值
- * @param {number} defaultValue  解析失败时的默认值
- * @param {number} [min=1]       最小值
- * @param {number} [max=1000]    最大值
- * @returns {number}
+ * @param value 待解析值
+ * @param defaultValue 解析失败时的默认值
+ * @param [min=1] 最小值
+ * @param [max=1000] 最大值
  */
 export function safeInt(value, defaultValue, min = 1, max = 1000) {
     const parsed = parseInt(String(value), 10);
@@ -34,8 +32,8 @@ export function safeInt(value, defaultValue, min = 1, max = 1000) {
  * 将 KnowledgeEntry（或其 toJSON 输出）转换为对外 API 安全的格式
  * - 过滤系统内部标签（dimension:* / bootstrap:* 等）
  *
- * @param {KnowledgeEntry|Object} entryOrJson  实体或 toJSON 输出
- * @returns {Object} 过滤后的 JSON
+ * @param entryOrJson 实体或 toJSON 输出
+ * @returns 过滤后的 JSON
  */
 export function sanitizeForAPI(entryOrJson) {
     const json = typeof entryOrJson?.toJSON === 'function' ? entryOrJson.toJSON() : { ...entryOrJson };
@@ -47,7 +45,7 @@ export function sanitizeForAPI(entryOrJson) {
 /**
  * 将分页结果中的 data 数组批量过滤系统标签
  * @param {{ data: Array, pagination: Object }} result
- * @returns {{ data: Array, pagination: Object }}
+ * @returns }
  */
 export function sanitizePaginatedForAPI(result) {
     if (!result?.data) {
@@ -58,4 +56,3 @@ export function sanitizePaginatedForAPI(result) {
         data: result.data.map(sanitizeForAPI),
     };
 }
-//# sourceMappingURL=routeHelpers.js.map

package/dist/lib/http/utils/sse-sessions.d.ts

@@ -16,8 +16,7 @@ import { EventEmitter } from 'node:events';
 /**
  * 创建一个 stream session
  *
- * @param {'chat'|'refine'} scene 场景标识
- * @returns {StreamSession}
+ * @param scene 场景标识
  */
 export declare function createStreamSession(scene: string): {
     sessionId: string;
@@ -29,31 +28,18 @@ export declare function createStreamSession(scene: string): {
     createdAt: number;
     /**
      * 缓冲 + 广播一个事件
-     * @param {object} event 必须包含 type 字段
+     * @param event 必须包含 type 字段
      */
     send(event: Record<string, unknown>): void;
-    /**
-     * 标记会话完成，发送 stream:done
-     * @param {object} [donePayload={}]
-     */
+    /** 标记会话完成，发送 stream:done */
     end(donePayload?: Record<string, unknown>): void;
-    /**
-     * 标记会话错误，发送 stream:error
-     * @param {string} message
-     * @param {string} [code]
-     */
+    /** 标记会话错误，发送 stream:error */
     error(message: string, code: string): void;
     /**
      * 订阅实时事件
-     * @param {(event: object) => void} handler
-     * @returns {() => void} unsubscribe 函数
+     * @returns unsubscribe 函数
      */
     on(handler: (event: Record<string, unknown>) => void): () => EventEmitter<any>;
 };
-/**
- * 获取已有的 session
- * @param {string} sessionId
- * @returns {StreamSession|undefined}
- */
+/** 获取已有的 session */
 export declare function getStreamSession(sessionId: string): any;
-//# sourceMappingURL=sse-sessions.d.ts.map

package/dist/lib/http/utils/sse-sessions.js

@@ -13,7 +13,6 @@
  * @module lib/http/utils/sse-sessions
  */
 import { EventEmitter } from 'node:events';
-/** @type {Map<string, StreamSession>} */
 const _sessions = new Map();
 /** Session 自动清理 TTL (5 分钟) */
 const SESSION_TTL = 5 * 60 * 1000;
@@ -22,8 +21,7 @@ const COMPLETED_KEEP = 60 * 1000;
 /**
  * 创建一个 stream session
  *
- * @param {'chat'|'refine'} scene 场景标识
- * @returns {StreamSession}
+ * @param scene 场景标识
  */
 export function createStreamSession(scene) {
     const sessionId = `ss_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
@@ -39,17 +37,14 @@ export function createStreamSession(scene) {
         createdAt: Date.now(),
         /**
          * 缓冲 + 广播一个事件
-         * @param {object} event 必须包含 type 字段
+         * @param event 必须包含 type 字段
          */
         send(event) {
             const payload = { ...event, ts: event.ts || Date.now() };
             session.buffer.push(payload);
             emitter.emit('event', payload);
         },
-        /**
-         * 标记会话完成，发送 stream:done
-         * @param {object} [donePayload={}]
-         */
+        /** 标记会话完成，发送 stream:done */
         end(donePayload = {}) {
             if (session.completed) {
                 return;
@@ -64,11 +59,7 @@ export function createStreamSession(scene) {
                 keepTimer.unref();
             }
         },
-        /**
-         * 标记会话错误，发送 stream:error
-         * @param {string} message
-         * @param {string} [code]
-         */
+        /** 标记会话错误，发送 stream:error */
         error(message, code) {
             if (session.completed) {
                 return;
@@ -84,8 +75,7 @@ export function createStreamSession(scene) {
         },
         /**
          * 订阅实时事件
-         * @param {(event: object) => void} handler
-         * @returns {() => void} unsubscribe 函数
+         * @returns unsubscribe 函数
          */
         on(handler) {
             emitter.on('event', handler);
@@ -100,12 +90,7 @@ export function createStreamSession(scene) {
     }
     return session;
 }
-/**
- * 获取已有的 session
- * @param {string} sessionId
- * @returns {StreamSession|undefined}
- */
+/** 获取已有的 session */
 export function getStreamSession(sessionId) {
     return _sessions.get(sessionId);
 }
-//# sourceMappingURL=sse-sessions.js.map