autosnippet 3.2.16 → 3.2.18

package/dist/lib/infrastructure/monitoring/ErrorTracker.d.ts

@@ -37,13 +37,9 @@ export declare class ErrorTracker {
         enableConsoleLogging: boolean;
         alertThreshold: number;
     }>);
-    /**
-     * 确保日志目录存在
-     */
+    /** 确保日志目录存在 */
     _ensureLogDirectory(): void;
-    /**
-     * Express 错误处理中间件
-     */
+    /** Express 错误处理中间件 */
     errorHandler(): (err: {
         message: string;
         stack?: string;
@@ -62,32 +58,20 @@ export declare class ErrorTracker {
         };
         statusCode: number;
     }, _next: unknown) => void;
-    /**
-     * 记录错误
-     */
+    /** 记录错误 */
     trackError(errorData: ErrorData): void;
-    /**
-     * 写入文件
-     */
+    /** 写入文件 */
     _writeToFile(errorData: ErrorData): void;
-    /**
-     * 检查告警阈值
-     */
+    /** 检查告警阈值 */
     _checkAlertThreshold(): void;
-    /**
-     * 生成错误报告
-     */
+    /** 生成错误报告 */
     _generateReport(): void;
-    /**
-     * 获取最常见错误类型
-     */
+    /** 获取最常见错误类型 */
     _getTopErrorTypes(limit?: number): {
         type: string;
         count: number;
     }[];
-    /**
-     * 获取错误统计
-     */
+    /** 获取错误统计 */
     getStats(): {
         summary: {
             totalErrors: number;
@@ -119,20 +103,14 @@ export declare class ErrorTracker {
             count: any;
         }[];
     };
-    /**
-     * 按路由统计错误
-     */
+    /** 按路由统计错误 */
     _getErrorsByRoute(): {
         route: any;
         count: any;
     }[];
-    /**
-     * 清除错误记录
-     */
+    /** 清除错误记录 */
     clearErrors(): void;
-    /**
-     * 搜索错误
-     */
+    /** 搜索错误 */
     searchErrors(options?: {
         type?: string;
         route?: string;
@@ -141,18 +119,11 @@ export declare class ErrorTracker {
         endDate?: string;
         limit?: number;
     }): ErrorData[];
-    /**
-     * 停止错误追踪
-     */
+    /** 停止错误追踪 */
     shutdown(): void;
 }
-/**
- * 初始化错误追踪
- */
+/** 初始化错误追踪 */
 export declare function initErrorTracker(options?: Partial<ErrorTrackerConfig>): ErrorTracker;
-/**
- * 获取错误追踪实例
- */
+/** 获取错误追踪实例 */
 export declare function getErrorTracker(): ErrorTracker;
 export default ErrorTracker;
-//# sourceMappingURL=ErrorTracker.d.ts.map

package/dist/lib/infrastructure/monitoring/ErrorTracker.js

@@ -34,9 +34,7 @@ export class ErrorTracker {
             this.reportInterval.unref();
         }
     }
-    /**
-     * 确保日志目录存在
-     */
+    /** 确保日志目录存在 */
     _ensureLogDirectory() {
         try {
             if (!fs.existsSync(this.config.logDirectory)) {
@@ -47,9 +45,7 @@ export class ErrorTracker {
             Logger.error('创建错误日志目录失败', { error: error.message });
         }
     }
-    /**
-     * Express 错误处理中间件
-     */
+    /** Express 错误处理中间件 */
     errorHandler() {
         return (err, req, res, _next) => {
             const errorData = {
@@ -78,9 +74,7 @@ export class ErrorTracker {
             });
         };
     }
-    /**
-     * 记录错误
-     */
+    /** 记录错误 */
     trackError(errorData) {
         // 添加到内存
         this.errors.push(errorData);
@@ -123,9 +117,7 @@ export class ErrorTracker {
         // 检查是否需要告警
         this._checkAlertThreshold();
     }
-    /**
-     * 写入文件
-     */
+    /** 写入文件 */
     _writeToFile(errorData) {
         try {
             const date = new Date().toISOString().split('T')[0];
@@ -141,9 +133,7 @@ export class ErrorTracker {
             Logger.error('写入错误日志文件失败', { error: error.message });
         }
     }
-    /**
-     * 检查告警阈值
-     */
+    /** 检查告警阈值 */
     _checkAlertThreshold() {
         const oneMinuteAgo = Date.now() - 60000;
         const recentErrorCount = this.errors.filter((err) => new Date(err.timestamp).getTime() > oneMinuteAgo).length;
@@ -152,9 +142,7 @@ export class ErrorTracker {
             // 这里可以集成通知服务（邮件、Slack 等）
         }
     }
-    /**
-     * 生成错误报告
-     */
+    /** 生成错误报告 */
     _generateReport() {
         const now = Date.now();
         const oneHourAgo = now - 3600000;
@@ -167,18 +155,14 @@ export class ErrorTracker {
             });
         }
     }
-    /**
-     * 获取最常见错误类型
-     */
+    /** 获取最常见错误类型 */
     _getTopErrorTypes(limit = 10) {
         return Array.from(this.errorCounts.entries())
             .sort((a, b) => b[1] - a[1])
             .slice(0, limit)
             .map(([type, count]) => ({ type, count }));
     }
-    /**
-     * 获取错误统计
-     */
+    /** 获取错误统计 */
     getStats() {
         const now = Date.now();
         const oneHourAgo = now - 3600000;
@@ -211,9 +195,7 @@ export class ErrorTracker {
             errorsByRoute: this._getErrorsByRoute(),
         };
     }
-    /**
-     * 按路由统计错误
-     */
+    /** 按路由统计错误 */
     _getErrorsByRoute() {
         const routeErrors = new Map();
         this.errors.forEach((err) => {
@@ -225,9 +207,7 @@ export class ErrorTracker {
             .slice(0, 10)
             .map(([route, count]) => ({ route, count }));
     }
-    /**
-     * 清除错误记录
-     */
+    /** 清除错误记录 */
     clearErrors() {
         this.errors = [];
         this.recentErrors = [];
@@ -235,9 +215,7 @@ export class ErrorTracker {
         this.errorCounts.clear();
         Logger.info('错误追踪记录已清除');
     }
-    /**
-     * 搜索错误
-     */
+    /** 搜索错误 */
     searchErrors(options = {}) {
         let results = [...this.errors];
         if (options.type) {
@@ -259,9 +237,7 @@ export class ErrorTracker {
         }
         return results.slice(0, options.limit || 100);
     }
-    /**
-     * 停止错误追踪
-     */
+    /** 停止错误追踪 */
     shutdown() {
         if (this.reportInterval) {
             clearInterval(this.reportInterval);
@@ -271,9 +247,7 @@ export class ErrorTracker {
 }
 // 单例实例
 let errorTrackerInstance = null;
-/**
- * 初始化错误追踪
- */
+/** 初始化错误追踪 */
 export function initErrorTracker(options = {}) {
     if (errorTrackerInstance) {
         return errorTrackerInstance;
@@ -282,9 +256,7 @@ export function initErrorTracker(options = {}) {
     Logger.info('✅ 错误追踪已启用');
     return errorTrackerInstance;
 }
-/**
- * 获取错误追踪实例
- */
+/** 获取错误追踪实例 */
 export function getErrorTracker() {
     if (!errorTrackerInstance) {
         throw new Error('错误追踪未初始化，请先调用 initErrorTracker()');
@@ -292,4 +264,3 @@ export function getErrorTracker() {
     return errorTrackerInstance;
 }
 export default ErrorTracker;
-//# sourceMappingURL=ErrorTracker.js.map

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.d.ts

@@ -44,9 +44,7 @@ export declare class PerformanceMonitor {
     };
     statsInterval: ReturnType<typeof setInterval>;
     constructor();
-    /**
-     * Express 中间件
-     */
+    /** Express 中间件 */
     middleware(): (req: {
         method: string;
         path: string;
@@ -56,17 +54,11 @@ export declare class PerformanceMonitor {
         on: (event: string, cb: () => void) => void;
         statusCode: number;
     }, next: () => void) => void;
-    /**
-     * 记录请求
-     */
+    /** 记录请求 */
     recordRequest(requestData: RequestData): void;
-    /**
-     * 计算统计数据
-     */
+    /** 计算统计数据 */
     calculateStats(): void;
-    /**
-     * 获取统计信息
-     */
+    /** 获取统计信息 */
     getStats(): {
         summary: {
             totalRequests: number;
@@ -100,22 +92,13 @@ export declare class PerformanceMonitor {
             statusCode: number;
         }[];
     };
-    /**
-     * 重置统计
-     */
+    /** 重置统计 */
     reset(): void;
-    /**
-     * 停止监控
-     */
+    /** 停止监控 */
     shutdown(): void;
 }
-/**
- * 初始化性能监控
- */
+/** 初始化性能监控 */
 export declare function initPerformanceMonitor(): PerformanceMonitor;
-/**
- * 获取性能监控实例
- */
+/** 获取性能监控实例 */
 export declare function getPerformanceMonitor(): PerformanceMonitor;
 export default PerformanceMonitor;
-//# sourceMappingURL=PerformanceMonitor.d.ts.map

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.js

@@ -32,9 +32,7 @@ export class PerformanceMonitor {
             this.statsInterval.unref();
         }
     }
-    /**
-     * Express 中间件
-     */
+    /** Express 中间件 */
     middleware() {
         return (req, res, next) => {
             const startTime = Date.now();
@@ -57,9 +55,7 @@ export class PerformanceMonitor {
             next();
         };
     }
-    /**
-     * 记录请求
-     */
+    /** 记录请求 */
     recordRequest(requestData) {
         const { route, statusCode, duration } = requestData;
         // 总体统计
@@ -121,9 +117,7 @@ export class PerformanceMonitor {
             Logger.warn(`🐢 慢请求: ${route} - ${duration}ms`);
         }
     }
-    /**
-     * 计算统计数据
-     */
+    /** 计算统计数据 */
     calculateStats() {
         const { total, errors } = this.metrics.requests;
         // 错误率
@@ -152,9 +146,7 @@ export class PerformanceMonitor {
             rpm: this.metrics.rpm,
         });
     }
-    /**
-     * 获取统计信息
-     */
+    /** 获取统计信息 */
     getStats() {
         this.calculateStats(); // 实时计算
         const topEndpoints = Array.from(this.metrics.endpoints.entries())
@@ -195,9 +187,7 @@ export class PerformanceMonitor {
             })),
         };
     }
-    /**
-     * 重置统计
-     */
+    /** 重置统计 */
     reset() {
         this.metrics = {
             requests: {
@@ -214,9 +204,7 @@ export class PerformanceMonitor {
         };
         Logger.info('性能监控统计已重置');
     }
-    /**
-     * 停止监控
-     */
+    /** 停止监控 */
     shutdown() {
         if (this.statsInterval) {
             clearInterval(this.statsInterval);
@@ -226,9 +214,7 @@ export class PerformanceMonitor {
 }
 // 单例实例
 let performanceMonitorInstance = null;
-/**
- * 初始化性能监控
- */
+/** 初始化性能监控 */
 export function initPerformanceMonitor() {
     if (performanceMonitorInstance) {
         return performanceMonitorInstance;
@@ -237,9 +223,7 @@ export function initPerformanceMonitor() {
     Logger.info('✅ 性能监控已启用');
     return performanceMonitorInstance;
 }
-/**
- * 获取性能监控实例
- */
+/** 获取性能监控实例 */
 export function getPerformanceMonitor() {
     if (!performanceMonitorInstance) {
         throw new Error('性能监控未初始化，请先调用 initPerformanceMonitor()');
@@ -247,4 +231,3 @@ export function getPerformanceMonitor() {
     return performanceMonitorInstance;
 }
 export default PerformanceMonitor;
-//# sourceMappingURL=PerformanceMonitor.js.map

package/dist/lib/infrastructure/realtime/RealtimeService.d.ts

@@ -5,55 +5,29 @@
 import { Server as SocketIOServer } from 'socket.io';
 export declare class RealtimeService {
     io: SocketIOServer;
-    /**
-     * @param {import('http').Server} httpServer
-     */
     constructor(httpServer: import('http').Server);
-    /**
-     * 设置事件处理器
-     */
+    /** 设置事件处理器 */
     setupEventHandlers(): void;
-    /**
-     * 广播候选人创建事件
-     */
+    /** 广播候选人创建事件 */
     broadcastCandidateCreated(candidate: unknown): void;
-    /**
-     * 广播候选人状态变化事件
-     */
+    /** 广播候选人状态变化事件 */
     broadcastCandidateStatusChanged(candidateId: string, newStatus: string, oldStatus: string): void;
-    /**
-     * 广播 Token 用量变化事件（Sidebar 指标刷新用）
-     */
+    /** 广播 Token 用量变化事件（Sidebar 指标刷新用） */
     broadcastTokenUsageUpdated(): void;
-    /**
-     * 广播食谱创建事件
-     */
+    /** 广播食谱创建事件 */
     broadcastRecipeCreated(recipe: unknown): void;
-    /**
-     * 广播食谱发布事件
-     */
+    /** 广播食谱发布事件 */
     broadcastRecipePublished(recipeId: string, recipe: unknown): void;
-    /**
-     * 广播规则创建事件
-     */
+    /** 广播规则创建事件 */
     broadcastRuleCreated(rule: unknown): void;
-    /**
-     * 广播规则状态变化事件
-     */
+    /** 广播规则状态变化事件 */
     broadcastRuleStatusChanged(ruleId: string, enabled: boolean): void;
-    /**
-     * 广播通用事件
-     */
+    /** 广播通用事件 */
     broadcastEvent(eventName: string, data: unknown): void;
-    /**
-     * 获取 Socket.io 实例
-     */
+    /** 获取 Socket.io 实例 */
     getIO(): SocketIOServer<import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, any>;
-    /**
-     * 获取连接的客户端数量
-     */
+    /** 获取连接的客户端数量 */
     getConnectedClients(): number;
 }
 export declare function initRealtimeService(httpServer: import('http').Server): RealtimeService;
 export declare function getRealtimeService(): RealtimeService;
-//# sourceMappingURL=RealtimeService.d.ts.map

package/dist/lib/infrastructure/realtime/RealtimeService.js

@@ -6,9 +6,6 @@ import { Server as SocketIOServer } from 'socket.io';
 import Logger from '../logging/Logger.js';
 export class RealtimeService {
     io;
-    /**
-     * @param {import('http').Server} httpServer
-     */
     constructor(httpServer) {
         this.io = new SocketIOServer(httpServer, {
             cors: {
@@ -21,9 +18,7 @@ export class RealtimeService {
         });
         this.setupEventHandlers();
     }
-    /**
-     * 设置事件处理器
-     */
+    /** 设置事件处理器 */
     setupEventHandlers() {
         this.io.on('connection', (socket) => {
             Logger.debug(`[Socket.io] Client connected: ${socket.id}`);
@@ -49,9 +44,7 @@ export class RealtimeService {
             });
         });
     }
-    /**
-     * 广播候选人创建事件
-     */
+    /** 广播候选人创建事件 */
     broadcastCandidateCreated(candidate) {
         this.io.to('notifications').emit('candidate-created', {
             type: 'candidate_created',
@@ -59,9 +52,7 @@ export class RealtimeService {
             timestamp: Date.now(),
         });
     }
-    /**
-     * 广播候选人状态变化事件
-     */
+    /** 广播候选人状态变化事件 */
     broadcastCandidateStatusChanged(candidateId, newStatus, oldStatus) {
         this.io.to('notifications').emit('candidate-status-changed', {
             type: 'candidate_status_changed',
@@ -71,18 +62,14 @@ export class RealtimeService {
             timestamp: Date.now(),
         });
     }
-    /**
-     * 广播 Token 用量变化事件（Sidebar 指标刷新用）
-     */
+    /** 广播 Token 用量变化事件（Sidebar 指标刷新用） */
     broadcastTokenUsageUpdated() {
         this.io.to('notifications').emit('token-usage-updated', {
             type: 'token_usage_updated',
             timestamp: Date.now(),
         });
     }
-    /**
-     * 广播食谱创建事件
-     */
+    /** 广播食谱创建事件 */
     broadcastRecipeCreated(recipe) {
         this.io.to('notifications').emit('recipe-created', {
             type: 'recipe_created',
@@ -90,9 +77,7 @@ export class RealtimeService {
             timestamp: Date.now(),
         });
     }
-    /**
-     * 广播食谱发布事件
-     */
+    /** 广播食谱发布事件 */
     broadcastRecipePublished(recipeId, recipe) {
         this.io.to('notifications').emit('recipe-published', {
             type: 'recipe_published',
@@ -101,9 +86,7 @@ export class RealtimeService {
             timestamp: Date.now(),
         });
     }
-    /**
-     * 广播规则创建事件
-     */
+    /** 广播规则创建事件 */
     broadcastRuleCreated(rule) {
         this.io.to('notifications').emit('rule-created', {
             type: 'rule_created',
@@ -111,9 +94,7 @@ export class RealtimeService {
             timestamp: Date.now(),
         });
     }
-    /**
-     * 广播规则状态变化事件
-     */
+    /** 广播规则状态变化事件 */
     broadcastRuleStatusChanged(ruleId, enabled) {
         this.io.to('notifications').emit('rule-status-changed', {
             type: 'rule_status_changed',
@@ -122,22 +103,16 @@ export class RealtimeService {
             timestamp: Date.now(),
         });
     }
-    /**
-     * 广播通用事件
-     */
+    /** 广播通用事件 */
     broadcastEvent(eventName, data) {
         // 直接透传 data（不包装 type/timestamp），保持与前端 hook 期望的数据结构一致
         this.io.to('notifications').emit(eventName, data);
     }
-    /**
-     * 获取 Socket.io 实例
-     */
+    /** 获取 Socket.io 实例 */
     getIO() {
         return this.io;
     }
-    /**
-     * 获取连接的客户端数量
-     */
+    /** 获取连接的客户端数量 */
     getConnectedClients() {
         return this.io.engine.clientsCount;
     }
@@ -157,4 +132,3 @@ export function getRealtimeService() {
     }
     return realtimeService;
 }
-//# sourceMappingURL=RealtimeService.js.map

package/dist/lib/infrastructure/vector/ASTChunker.d.ts

@@ -37,13 +37,12 @@ declare const LANG_ID_MAP: {
 };
 /**
  * 初始化 AST 解析器 (幂等, 延迟加载)
- * @returns {Promise<boolean>} 是否成功初始化
+ * @returns 是否成功初始化
  */
 declare function ensureParser(): Promise<boolean>;
 /**
  * 检查 ASTChunker 是否支持指定语言
- * @param {string} language - LanguageService.inferLang() 返回的语言 ID
- * @returns {boolean}
+ * @param language LanguageService.inferLang() 返回的语言 ID
  */
 export declare function isASTChunkerAvailable(language: string): boolean;
 /**
@@ -56,12 +55,10 @@ export declare function isASTChunkerAvailable(language: string): boolean;
  * 4. 超大节点递归拆分 (按子节点边界)
  * 5. 非声明代码 (import, 注释等) 合并为一个 chunk
  *
- * @param {string} content 源代码
- * @param {string} language 语言标识 (来自 LanguageService.inferLang)
- * @param {object} metadata 基础 metadata
- * @param {object} [options]
- * @param {number} [options.maxChunkTokens=512]
- * @returns {Array<{ content: string, metadata: object }>}
+ * @param content 源代码
+ * @param language 语言标识 (来自 LanguageService.inferLang)
+ * @param metadata 基础 metadata
+ * @returns >}
  */
 export declare function chunkByAST(content: string, language: string, metadata?: Record<string, unknown>, options?: {
     maxChunkTokens?: number;
@@ -70,4 +67,3 @@ export declare function chunkByAST(content: string, language: string, metadata?:
     metadata: Record<string, unknown>;
 }[] | null;
 export { ensureParser, TOP_LEVEL_TYPES, LANG_ID_MAP };
-//# sourceMappingURL=ASTChunker.d.ts.map