autosnippet 3.2.16 → 3.2.17

package/dist/lib/external/mcp/handlers/wiki-external.js

@@ -40,8 +40,8 @@ function tryGet(container, name) {
  * 复用 WikiGenerator 的数据收集和主题发现逻辑（Phase 1-5），
  * 但不撰写文章，只返回规划清单和每个主题的数据包。
  *
- * @param {object} ctx  - { container, logger, startedAt }
- * @param {object} args - { language?: 'zh'|'en', sessionId?: string }
+ * @param ctx { container, logger, startedAt }
+ * @param args { language?: 'zh'|'en', sessionId?: string }
  */
 export async function wikiPlan(ctx, args) {
     const t0 = Date.now();
@@ -220,8 +220,8 @@ export async function wikiPlan(ctx, args) {
  *   3. 写入 meta.json
  *   4. 同步 Cursor 端文档（可选）
  *
- * @param {object} ctx  - { container, logger, startedAt }
- * @param {object} args - { articlesWritten: string[] }
+ * @param ctx { container, logger, startedAt }
+ * @param args { articlesWritten: string[] }
  */
 export async function wikiFinalize(ctx, args) {
     const t0 = Date.now();
@@ -370,9 +370,7 @@ function _ensureDir(dir) {
         fs.mkdirSync(dir, { recursive: true });
     }
 }
-/**
- * 为主题生成写作指南
- */
+/** 为主题生成写作指南 */
 function _buildWritingGuide(topic, isZh) {
     const guides = {
         overview: isZh
@@ -408,9 +406,7 @@ function _buildWritingGuide(topic, isZh) {
             ? '撰写详细的技术文档，结构清晰，内容准确。'
             : 'Write detailed technical documentation with clear structure and accurate content.'));
 }
-/**
- * 为主题构建数据包
- */
+/** 为主题构建数据包 */
 function _buildTopicDataBundle(topic, structuredData) {
     const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = structuredData;
     const bundle = {};
@@ -542,9 +538,7 @@ function _buildTopicDataBundle(topic, structuredData) {
     }
     return bundle;
 }
-/**
- * 构建写作指导手册
- */
+/** 构建写作指导手册 */
 function _buildWritingGuidelines(isZh) {
     return {
         language: isZh ? 'zh' : 'en',
@@ -570,4 +564,3 @@ function _buildWritingGuidelines(isZh) {
             : 'Add a "## Related Documents" section at the end, linking to other wiki pages',
     };
 }
-//# sourceMappingURL=wiki-external.js.map

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

@@ -72,4 +72,3 @@ export declare const TOOLS: {
     description: string;
     inputSchema: import("./zodToMcpSchema.js").McpInputSchema;
 }[];
-//# sourceMappingURL=tools.d.ts.map

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

@@ -238,4 +238,3 @@ export const TOOLS = [
         inputSchema: zodToMcpSchema(CheckDuplicateInput),
     },
 ];
-//# sourceMappingURL=tools.js.map

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

@@ -29,4 +29,3 @@ export interface McpInputSchema {
  *   // → { type: 'object', properties: { query: { type: 'string', minLength: 1 }, ... }, required: ['query'] }
  */
 export declare function zodToMcpSchema(schema: z.ZodType): McpInputSchema;
-//# sourceMappingURL=zodToMcpSchema.d.ts.map

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

@@ -10,9 +10,7 @@
  * @module external/mcp/zodToMcpSchema
  */
 import { z } from 'zod';
-/**
- * 递归清理 JSON Schema 对象
- */
+/** 递归清理 JSON Schema 对象 */
 function cleanJsonSchema(obj) {
     const cleaned = { ...obj };
     // 移除顶层 $schema
@@ -81,4 +79,3 @@ export function zodToMcpSchema(schema) {
         ...cleaned,
     };
 }
-//# sourceMappingURL=zodToMcpSchema.js.map

package/dist/lib/http/HttpServer.d.ts

@@ -32,52 +32,31 @@ export declare class HttpServer {
     realtimeService: Record<string, unknown> | null;
     server: Server | null;
     constructor(config?: Partial<HttpServerConfig>);
-    /**
-     * 初始化服务器
-     */
+    /** 初始化服务器 */
     initialize(): Promise<void>;
-    /**
-     * 初始化服务（监控、缓存等）
-     */
+    /** 初始化服务（监控、缓存等） */
     initializeServices(): Promise<void>;
-    /**
-     * 设置中间件
-     */
+    /** 设置中间件 */
     setupMiddleware(): void;
-    /**
-     * 注册 Gateway Actions
-     */
+    /** 注册 Gateway Actions */
     registerGatewayActions(): void;
-    /**
-     * 设置路由
-     */
+    /** 设置路由 */
     setupRoutes(): void;
-    /**
-     * 设置错误处理
-     */
+    /** 设置错误处理 */
     setupErrorHandling(): void;
-    /**
-     * 启动服务器
-     */
+    /** 启动服务器 */
     start(): Promise<unknown>;
-    /**
-     * 停止服务器
-     */
+    /** 停止服务器 */
     stop(): Promise<void>;
-    /**
-     * 获取 Express 应用实例
-     */
+    /** 获取 Express 应用实例 */
     getApp(): express.Application;
     /**
      * 挂载 Dashboard 静态资源（生产模式：直接托管预构建产物）
      * 必须在 initialize() + start() 之后调用
-     * @param {string} distDir - dashboard/dist 目录的绝对路径
+     * @param distDir dashboard/dist 目录的绝对路径
      */
     mountDashboard(distDir: string): void;
-    /**
-     * 获取服务器实例
-     */
+    /** 获取服务器实例 */
     getServer(): Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse> | null;
 }
 export default HttpServer;
-//# sourceMappingURL=HttpServer.d.ts.map

package/dist/lib/http/HttpServer.js

@@ -67,9 +67,7 @@ export class HttpServer {
         this.realtimeService = null;
         this.capabilityProbe = null;
     }
-    /**
-     * 初始化服务器
-     */
+    /** 初始化服务器 */
     async initialize() {
         // 初始化监控和缓存服务
         await this.initializeServices();
@@ -89,9 +87,7 @@ export class HttpServer {
             timestamp: new Date().toISOString(),
         });
     }
-    /**
-     * 初始化服务（监控、缓存等）
-     */
+    /** 初始化服务（监控、缓存等） */
     async initializeServices() {
         try {
             // 初始化缓存适配器（纯内存模式）
@@ -116,9 +112,7 @@ export class HttpServer {
             throw error;
         }
     }
-    /**
-     * 设置中间件
-     */
+    /** 设置中间件 */
     setupMiddleware() {
         // 性能监控中间件（优先级最高）
         if (this.performanceMonitor) {
@@ -186,9 +180,7 @@ export class HttpServer {
             next();
         });
     }
-    /**
-     * 注册 Gateway Actions
-     */
+    /** 注册 Gateway Actions */
     registerGatewayActions() {
         try {
             const container = getServiceContainer();
@@ -202,9 +194,7 @@ export class HttpServer {
             });
         }
     }
-    /**
-     * 设置路由
-     */
+    /** 设置路由 */
     setupRoutes() {
         // API 版本前缀
         const apiPrefix = '/api/v1';
@@ -287,9 +277,7 @@ export class HttpServer {
             });
         });
     }
-    /**
-     * 设置错误处理
-     */
+    /** 设置错误处理 */
     setupErrorHandling() {
         // 使用错误追踪器的错误处理中间件（如果启用）
         if (this.errorTracker) {
@@ -300,9 +288,7 @@ export class HttpServer {
             this.app.use(errorHandler(this.logger));
         }
     }
-    /**
-     * 启动服务器
-     */
+    /** 启动服务器 */
     async start() {
         const { promise, resolve, reject } = Promise.withResolvers();
         try {
@@ -343,9 +329,7 @@ export class HttpServer {
         }
         return promise;
     }
-    /**
-     * 停止服务器
-     */
+    /** 停止服务器 */
     async stop() {
         const { promise, resolve, reject } = Promise.withResolvers();
         if (!this.server) {
@@ -385,16 +369,14 @@ export class HttpServer {
         });
         return promise;
     }
-    /**
-     * 获取 Express 应用实例
-     */
+    /** 获取 Express 应用实例 */
     getApp() {
         return this.app;
     }
     /**
      * 挂载 Dashboard 静态资源（生产模式：直接托管预构建产物）
      * 必须在 initialize() + start() 之后调用
-     * @param {string} distDir - dashboard/dist 目录的绝对路径
+     * @param distDir dashboard/dist 目录的绝对路径
      */
     mountDashboard(distDir) {
         // 从路由栈中移除最后的 404 catch-all 和根路径 handler
@@ -426,12 +408,9 @@ export class HttpServer {
         }
         this.logger.info('Dashboard mounted (production mode)', { distDir });
     }
-    /**
-     * 获取服务器实例
-     */
+    /** 获取服务器实例 */
     getServer() {
         return this.server;
     }
 }
 export default HttpServer;
-//# sourceMappingURL=HttpServer.js.map

package/dist/lib/http/api-spec.d.ts

@@ -1,6 +1,4 @@
-/**
- * API 文档 - OpenAPI 3.0 规范
- */
+/** API 文档 - OpenAPI 3.0 规范 */
 export declare const apiSpec: {
     openapi: string;
     info: {
@@ -229,4 +227,3 @@ export declare const apiSpec: {
     };
 };
 export default apiSpec;
-//# sourceMappingURL=api-spec.d.ts.map

package/dist/lib/http/api-spec.js

@@ -1,6 +1,4 @@
-/**
- * API 文档 - OpenAPI 3.0 规范
- */
+/** API 文档 - OpenAPI 3.0 规范 */
 export const apiSpec = {
     openapi: '3.0.0',
     info: {
@@ -188,4 +186,3 @@ export const apiSpec = {
     },
 };
 export default apiSpec;
-//# sourceMappingURL=api-spec.js.map

package/dist/lib/http/middleware/RateLimiter.d.ts

@@ -4,10 +4,10 @@
  */
 /**
  * 检查是否允许提交
- * @param {string} projectRoot 项目根路径作为命名空间
- * @param {string} clientId 客户端标识
- * @param {object} [opts] - { windowMs: 60000, maxRequests: 10 }
- * @returns {{ allowed: boolean, retryAfter?: number }}
+ * @param projectRoot 项目根路径作为命名空间
+ * @param clientId 客户端标识
+ * @param [opts] { windowMs: 60000, maxRequests: 10 }
+ * @returns }
  */
 export declare function checkRecipeSave(projectRoot: string, clientId: string, opts?: {
     windowMs?: number;
@@ -19,13 +19,10 @@ export declare function checkRecipeSave(projectRoot: string, clientId: string, o
     allowed: boolean;
     retryAfter?: undefined;
 };
-/**
- * 重置限流器（测试用）
- */
+/** 重置限流器（测试用） */
 export declare function resetRateLimiter(): void;
 declare const _default: {
     checkRecipeSave: typeof checkRecipeSave;
     resetRateLimiter: typeof resetRateLimiter;
 };
 export default _default;
-//# sourceMappingURL=RateLimiter.d.ts.map

package/dist/lib/http/middleware/RateLimiter.js

@@ -5,9 +5,7 @@
 const _buckets = new Map();
 let _lastPrune = Date.now();
 const PRUNE_INTERVAL = 300_000; // 5 分钟清理一次过期 bucket
-/**
- * 清理过期的 bucket 条目，防止内存泄漏
- */
+/** 清理过期的 bucket 条目，防止内存泄漏 */
 function _pruneIfNeeded(windowMs) {
     const now = Date.now();
     if (now - _lastPrune < PRUNE_INTERVAL) {
@@ -23,10 +21,10 @@ function _pruneIfNeeded(windowMs) {
 }
 /**
  * 检查是否允许提交
- * @param {string} projectRoot 项目根路径作为命名空间
- * @param {string} clientId 客户端标识
- * @param {object} [opts] - { windowMs: 60000, maxRequests: 10 }
- * @returns {{ allowed: boolean, retryAfter?: number }}
+ * @param projectRoot 项目根路径作为命名空间
+ * @param clientId 客户端标识
+ * @param [opts] { windowMs: 60000, maxRequests: 10 }
+ * @returns }
  */
 export function checkRecipeSave(projectRoot, clientId, opts = {}) {
     const windowMs = opts.windowMs ?? 60_000;
@@ -50,11 +48,8 @@ export function checkRecipeSave(projectRoot, clientId, opts = {}) {
     bucket.timestamps.push(now);
     return { allowed: true };
 }
-/**
- * 重置限流器（测试用）
- */
+/** 重置限流器（测试用） */
 export function resetRateLimiter() {
     _buckets.clear();
 }
 export default { checkRecipeSave, resetRateLimiter };
-//# sourceMappingURL=RateLimiter.js.map

package/dist/lib/http/middleware/errorHandler.d.ts

@@ -1,15 +1,11 @@
-/**
- * 错误处理中间件
- */
+/** 错误处理中间件 */
 import type { ErrorRequestHandler } from 'express';
 /** Minimal logger interface (compatible with winston.Logger) */
 interface AppLogger {
     error(message: string, meta?: Record<string, unknown>): void;
 }
 export declare function errorHandler(logger: AppLogger): ErrorRequestHandler;
-/**
- * 将领域错误转换为 HTTP 错误
- */
+/** 将领域错误转换为 HTTP 错误 */
 export declare function mapDomainError(error: Error): {
     status: number;
     code: string;
@@ -22,4 +18,3 @@ export declare function mapDomainError(error: Error): {
     details?: undefined;
 };
 export {};
-//# sourceMappingURL=errorHandler.d.ts.map

package/dist/lib/http/middleware/errorHandler.js

@@ -1,6 +1,4 @@
-/**
- * 错误处理中间件
- */
+/** 错误处理中间件 */
 import { ConflictError, NotFoundError, PermissionDenied, ValidationError, } from '../../shared/errors/index.js';
 export function errorHandler(logger) {
     return (error, req, res, _next) => {
@@ -28,9 +26,7 @@ export function errorHandler(logger) {
         });
     };
 }
-/**
- * 将领域错误转换为 HTTP 错误
- */
+/** 将领域错误转换为 HTTP 错误 */
 export function mapDomainError(error) {
     if (error instanceof ValidationError) {
         return {
@@ -69,4 +65,3 @@ export function mapDomainError(error) {
         message: error.message || 'Internal server error',
     };
 }
-//# sourceMappingURL=errorHandler.js.map

package/dist/lib/http/middleware/gatewayMiddleware.d.ts

@@ -9,9 +9,6 @@
  *   3. 'anonymous' — 兜底
  */
 import type { NextFunction, Request, Response } from 'express';
-/**
- * Express 中间件：将 Gateway 注入到 req 对象
- */
+/** Express 中间件：将 Gateway 注入到 req 对象 */
 export declare function gatewayMiddleware(): (req: Request, _res: Response, next: NextFunction) => void;
 export default gatewayMiddleware;
-//# sourceMappingURL=gatewayMiddleware.d.ts.map

package/dist/lib/http/middleware/gatewayMiddleware.js

@@ -22,17 +22,15 @@ class GatewayError extends Error {
         this.requestId = requestId;
     }
 }
-/**
- * Express 中间件：将 Gateway 注入到 req 对象
- */
+/** Express 中间件：将 Gateway 注入到 req 对象 */
 export function gatewayMiddleware() {
     return (req, _res, next) => {
         /**
          * Gateway 快捷执行方法
-         * @param {string} action 操作标识 (如 'candidate:create')
-         * @param {string} resource 资源类型 (如 'candidates')
-         * @param {object} data 请求数据
-         * @returns {Promise<{success: boolean, data?: unknown, error?: object, requestId: string}>}
+         * @param action 操作标识 (如 'candidate:create')
+         * @param resource 资源类型 (如 'candidates')
+         * @param data 请求数据
+         * @returns >}
          */
         req.gw = async (action, resource, data = {}) => {
             const container = getServiceContainer();
@@ -60,4 +58,3 @@ export function gatewayMiddleware() {
     };
 }
 export default gatewayMiddleware;
-//# sourceMappingURL=gatewayMiddleware.js.map

package/dist/lib/http/middleware/requestLogger.d.ts

@@ -22,4 +22,3 @@ interface AppLogger {
 }
 export declare function requestLogger(logger: AppLogger): (req: Request, res: Response, next: NextFunction) => void;
 export {};
-//# sourceMappingURL=requestLogger.d.ts.map

package/dist/lib/http/middleware/requestLogger.js

@@ -22,9 +22,7 @@ const SILENT_PATHS = [
     '/api/v1/remote/wait',
     '/socket.io',
 ];
-/**
- * 从 originalUrl 中提取 pathname（去除 query string）
- */
+/** 从 originalUrl 中提取 pathname（去除 query string） */
 function extractPath(originalUrl) {
     const idx = originalUrl.indexOf('?');
     return idx === -1 ? originalUrl : originalUrl.slice(0, idx);
@@ -64,4 +62,3 @@ export function requestLogger(logger) {
         next();
     };
 }
-//# sourceMappingURL=requestLogger.js.map

package/dist/lib/http/middleware/roleResolver.d.ts

@@ -10,14 +10,8 @@
  */
 import type { NextFunction, Request, Response } from 'express';
 import type { CapabilityProbe } from '../../core/capability/CapabilityProbe.js';
-/**
- * 创建双路径角色解析中间件
- *
- * @param {object} options
- * @param {import('../../core/capability/CapabilityProbe.js').CapabilityProbe} [options.capabilityProbe]
- */
+/** 创建双路径角色解析中间件 */
 export declare function roleResolverMiddleware(options?: {
     capabilityProbe?: CapabilityProbe;
 }): (req: Request, _res: Response, next: NextFunction) => void;
 export default roleResolverMiddleware;
-//# sourceMappingURL=roleResolver.d.ts.map

package/dist/lib/http/middleware/roleResolver.js

@@ -25,12 +25,7 @@ async function getVerifyToken() {
     }
     return _verifyToken;
 }
-/**
- * 创建双路径角色解析中间件
- *
- * @param {object} options
- * @param {import('../../core/capability/CapabilityProbe.js').CapabilityProbe} [options.capabilityProbe]
- */
+/** 创建双路径角色解析中间件 */
 export function roleResolverMiddleware(options = {}) {
     const { capabilityProbe } = options;
     // 预加载 verifyToken（异步但不阻塞中间件注册）
@@ -104,4 +99,3 @@ export function roleResolverMiddleware(options = {}) {
     };
 }
 export default roleResolverMiddleware;
-//# sourceMappingURL=roleResolver.js.map

package/dist/lib/http/middleware/validate.d.ts

@@ -38,4 +38,3 @@ export declare function validateQuery<T extends z.ZodType>(schema: T): (req: Req
  * @returns Express 中间件
  */
 export declare function validateParams<T extends z.ZodType>(schema: T): (req: Request, res: Response, next: NextFunction) => void;
-//# sourceMappingURL=validate.d.ts.map

package/dist/lib/http/middleware/validate.js

@@ -89,4 +89,3 @@ export function validateParams(schema) {
         next();
     };
 }
-//# sourceMappingURL=validate.js.map

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

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

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

@@ -5,15 +5,15 @@
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import express from 'express';
+import { AgentMessage, Channel } from '../../agent/AgentMessage.js';
+import { ConversationStore } from '../../agent/ConversationStore.js';
+import { buildProjectBriefing } from '../../agent/core/ChatAgentPrompts.js';
+import { taskCheckAndSubmit, taskDiscoverAllRelations, taskFullEnrich, taskGuardFullScan, taskQualityAudit, } from '../../agent/domain/ChatAgentTasks.js';
+import { PRESETS } from '../../agent/presets.js';
 import { createProvider } from '../../external/ai/AiFactory.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { getRealtimeService } from '../../infrastructure/realtime/RealtimeService.js';
 import { getServiceContainer } from '../../injection/ServiceContainer.js';
-import { AgentMessage, Channel } from '../../service/agent/AgentMessage.js';
-import { ConversationStore } from '../../service/agent/ConversationStore.js';
-import { buildProjectBriefing } from '../../service/agent/core/ChatAgentPrompts.js';
-import { taskCheckAndSubmit, taskDiscoverAllRelations, taskFullEnrich, taskGuardFullScan, taskQualityAudit, } from '../../service/agent/domain/ChatAgentTasks.js';
-import { PRESETS } from '../../service/agent/presets.js';
 import { ValidationError } from '../../shared/errors/index.js';
 import { resolveProjectRoot } from '../../shared/resolveProjectRoot.js';
 import { AiChatBody, AiConfigBody, AiEnvConfigBody, AiFormatUsageGuideBody, AiLangBody, AiStreamBody, AiSummarizeBody, AiTaskBody, AiToolBody, AiTranslateBody, } from '../../shared/schemas/http-requests.js';
@@ -752,4 +752,3 @@ router.get('/token-usage', async (req, res) => {
     res.json({ success: true, data: report });
 });
 export default router;
-//# sourceMappingURL=ai.js.map

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

@@ -12,4 +12,3 @@ declare const router: import("express-serve-static-core").Router;
 declare function verifyToken(token: string | undefined): any;
 export { verifyToken };
 export default router;
-//# sourceMappingURL=auth.d.ts.map

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

@@ -122,4 +122,3 @@ router.get('/me', async (req, res) => {
 });
 export { verifyToken };
 export default router;
-//# sourceMappingURL=auth.js.map

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

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

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

@@ -185,9 +185,8 @@ function extractBeforeFields(json) {
 }
 /**
  * 构造直接润色提示词 —— 以用户 prompt 为主指令
- * @param {object} before - extractBeforeFields 的输出
- * @param {string} userPrompt 用户输入的润色指令
- * @returns {string}
+ * @param before extractBeforeFields 的输出
+ * @param userPrompt 用户输入的润色指令
  */
 function buildRefinePrompt(before, userPrompt) {
     return `你是一位知识库条目润色助手。你必须**严格按照用户指令**修改知识条目。
@@ -269,9 +268,7 @@ ${userPrompt}
 
 每个 key 都必须存在，key 名称必须与上述完全一致。`;
 }
-/**
- * 将 AI 返回的润色结果合并到 before 上生成 after，并构造 knowledgeService.update() 所需的 updateData
- */
+/** 将 AI 返回的润色结果合并到 before 上生成 after，并构造 knowledgeService.update() 所需的 updateData */
 function buildUpdateFromRefineResult(before, parsed) {
     // ─── key 别名归一化：AI 可能返回不精确的 key，统一映射到标准 key ───
     const KEY_ALIASES = {
@@ -719,4 +716,3 @@ router.post('/refine-apply', validate(RefineApplyBody), async (req, res) => {
     });
 });
 export default router;
-//# sourceMappingURL=candidates.js.map

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

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

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

@@ -305,4 +305,3 @@ router.post('/files/save', validate(FileSaveBody), async (req, res) => {
     }
 });
 export default router;
-//# sourceMappingURL=commands.js.map

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

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

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

@@ -159,4 +159,3 @@ router.post('/text', validate(ExtractTextBody), async (req, res) => {
     });
 });
 export default router;
-//# sourceMappingURL=extract.js.map

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

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