autosnippet 3.2.16 → 3.2.18

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

@@ -10,27 +10,21 @@ import type { Request, Response } from 'express';
 /**
  * 创建 SSE 会话 — 统一设置 headers、心跳、安全写入
  *
- * @param {import('express').Request} req
- * @param {import('express').Response} res
- * @param {'chat'|'refine'} scene 场景标识
- * @returns {{ send, end, error, isDisconnected, sessionId }}
+ * @param scene 场景标识
+ * @returns }
  */
 export declare function createSSESession(req: Request, res: Response, scene: string): {
     /**
      * 发送一个 SSE 事件
-     * @param {object} event 必须包含 type 字段
+     * @param event 必须包含 type 字段
      */
     send(event: Record<string, unknown>): void;
     /**
      * 正常结束流 — 发送 stream:done 并关闭连接
-     * @param {object} [donePayload={}] - done 事件携带的额外数据
+     * @param [donePayload={}] done 事件携带的额外数据
      */
     end(donePayload?: Record<string, unknown>): void;
-    /**
-     * 发送错误并结束流
-     * @param {string} message
-     * @param {string} [code]
-     */
+    /** 发送错误并结束流 */
     error(message: string, code: string): void;
     /** 是否已断开 */
     readonly isDisconnected: boolean;
@@ -47,4 +41,3 @@ export declare function createSSESession(req: Request, res: Response, scene: str
         firstTextDeltaTime: number;
     };
 };
-//# sourceMappingURL=sse.d.ts.map

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

@@ -9,10 +9,8 @@
 /**
  * 创建 SSE 会话 — 统一设置 headers、心跳、安全写入
  *
- * @param {import('express').Request} req
- * @param {import('express').Response} res
- * @param {'chat'|'refine'} scene 场景标识
- * @returns {{ send, end, error, isDisconnected, sessionId }}
+ * @param scene 场景标识
+ * @returns }
  */
 export function createSSESession(req, res, scene) {
     // ─── SSE Headers ───
@@ -64,7 +62,7 @@ export function createSSESession(req, res, scene) {
     return {
         /**
          * 发送一个 SSE 事件
-         * @param {object} event 必须包含 type 字段
+         * @param event 必须包含 type 字段
          */
         send(event) {
             if (disconnected || res.writableEnded) {
@@ -80,7 +78,7 @@ export function createSSESession(req, res, scene) {
         },
         /**
          * 正常结束流 — 发送 stream:done 并关闭连接
-         * @param {object} [donePayload={}] - done 事件携带的额外数据
+         * @param [donePayload={}] done 事件携带的额外数据
          */
         end(donePayload = {}) {
             clearInterval(heartbeat);
@@ -91,11 +89,7 @@ export function createSSESession(req, res, scene) {
             _write(`data: ${payload}\n\n`);
             res.end();
         },
-        /**
-         * 发送错误并结束流
-         * @param {string} message
-         * @param {string} [code]
-         */
+        /** 发送错误并结束流 */
         error(message, code) {
             clearInterval(heartbeat);
             if (disconnected || res.writableEnded) {
@@ -122,4 +116,3 @@ export function createSSESession(req, res, scene) {
         },
     };
 }
-//# sourceMappingURL=sse.js.map

package/dist/lib/infrastructure/audit/AuditLogger.d.ts

@@ -1,7 +1,5 @@
 import type { AuditStore } from './AuditStore.js';
-/**
- * AuditLogger - 审计日志记录器
- */
+/** AuditLogger - 审计日志记录器 */
 export declare class AuditLogger {
     auditStore: AuditStore;
     logger: import('winston').Logger;
@@ -26,17 +24,11 @@ export declare class AuditLogger {
         error?: string;
         duration?: number;
     }): Promise<void>;
-    /**
-     * 生成 ID
-     */
+    /** 生成 ID */
     generateId(): string;
-    /**
-     * 格式化资源
-     */
+    /** 格式化资源 */
     formatResource(resource: unknown): string;
-    /**
-     * 查询审计日志
-     */
+    /** 查询审计日志 */
     query(filters: {
         actor?: string;
         action?: string;
@@ -45,9 +37,7 @@ export declare class AuditLogger {
         endDate?: number;
         limit?: number;
     }): Promise<unknown[]>;
-    /**
-     * 获取特定请求的日志
-     */
+    /** 获取特定请求的日志 */
     getByRequestId(requestId: string): Promise<{
         id: string;
         timestamp: number;
@@ -60,9 +50,7 @@ export declare class AuditLogger {
         errorMessage: string | null;
         duration: number | null;
     } | undefined>;
-    /**
-     * 获取特定角色的日志
-     */
+    /** 获取特定角色的日志 */
     getByActor(actor: string, limit?: number): Promise<{
         id: string;
         timestamp: number;
@@ -75,9 +63,7 @@ export declare class AuditLogger {
         errorMessage: string | null;
         duration: number | null;
     }[]>;
-    /**
-     * 获取特定操作的日志
-     */
+    /** 获取特定操作的日志 */
     getByAction(action: string, limit?: number): Promise<{
         id: string;
         timestamp: number;
@@ -90,9 +76,7 @@ export declare class AuditLogger {
         errorMessage: string | null;
         duration: number | null;
     }[]>;
-    /**
-     * 获取失败的操作日志
-     */
+    /** 获取失败的操作日志 */
     getFailures(limit?: number): Promise<{
         id: string;
         timestamp: number;
@@ -105,9 +89,7 @@ export declare class AuditLogger {
         errorMessage: string | null;
         duration: number | null;
     }[]>;
-    /**
-     * 统计审计数据
-     */
+    /** 统计审计数据 */
     getStats(timeRange: string): Promise<{
         timeRange: string;
         total: number;
@@ -120,4 +102,3 @@ export declare class AuditLogger {
     }>;
 }
 export default AuditLogger;
-//# sourceMappingURL=AuditLogger.d.ts.map

package/dist/lib/infrastructure/audit/AuditLogger.js

@@ -1,7 +1,5 @@
 import Logger from '../../infrastructure/logging/Logger.js';
-/**
- * AuditLogger - 审计日志记录器
- */
+/** AuditLogger - 审计日志记录器 */
 export class AuditLogger {
     auditStore;
     logger;
@@ -51,15 +49,11 @@ export class AuditLogger {
             });
         }
     }
-    /**
-     * 生成 ID
-     */
+    /** 生成 ID */
     generateId() {
         return `audit_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
     }
-    /**
-     * 格式化资源
-     */
+    /** 格式化资源 */
     formatResource(resource) {
         if (typeof resource === 'string') {
             return resource;
@@ -69,42 +63,29 @@ export class AuditLogger {
         }
         return String(resource);
     }
-    /**
-     * 查询审计日志
-     */
+    /** 查询审计日志 */
     async query(filters) {
         return await this.auditStore.query(filters);
     }
-    /**
-     * 获取特定请求的日志
-     */
+    /** 获取特定请求的日志 */
     async getByRequestId(requestId) {
         return await this.auditStore.findByRequestId(requestId);
     }
-    /**
-     * 获取特定角色的日志
-     */
+    /** 获取特定角色的日志 */
     async getByActor(actor, limit = 100) {
         return await this.auditStore.findByActor(actor, limit);
     }
-    /**
-     * 获取特定操作的日志
-     */
+    /** 获取特定操作的日志 */
     async getByAction(action, limit = 100) {
         return await this.auditStore.findByAction(action, limit);
     }
-    /**
-     * 获取失败的操作日志
-     */
+    /** 获取失败的操作日志 */
     async getFailures(limit = 100) {
         return await this.auditStore.findByResult('failure', limit);
     }
-    /**
-     * 统计审计数据
-     */
+    /** 统计审计数据 */
     async getStats(timeRange) {
         return await this.auditStore.getStats(timeRange);
     }
 }
 export default AuditLogger;
-//# sourceMappingURL=AuditLogger.js.map

package/dist/lib/infrastructure/audit/AuditStore.d.ts

@@ -21,9 +21,7 @@ export declare class AuditStore {
         error_message: string | null;
         duration: number | null;
     }): Promise<void>;
-    /**
-     * 查询审计日志
-     */
+    /** 查询审计日志 */
     query(filters?: {
         actor?: string;
         action?: string;
@@ -96,9 +94,7 @@ export declare class AuditStore {
         errorMessage: string | null;
         duration: number | null;
     }[];
-    /**
-     * 获取统计数据
-     */
+    /** 获取统计数据 */
     getStats(timeRange?: string): {
         timeRange: string;
         total: number;
@@ -112,9 +108,8 @@ export declare class AuditStore {
     /**
      * 清理过期审计日志
      * ★ Drizzle 类型安全 DELETE
-     * @param {object} [opts]
-     * @param {number} [opts.maxAgeDays=90] 保留天数，超过此天数的记录将被删除
-     * @returns {{ deleted: number }}
+     * @param [opts.maxAgeDays=90] 保留天数，超过此天数的记录将被删除
+     * @returns }
      */
     cleanup({ maxAgeDays }?: {
         maxAgeDays?: number | undefined;
@@ -123,4 +118,3 @@ export declare class AuditStore {
     };
 }
 export default AuditStore;
-//# sourceMappingURL=AuditStore.d.ts.map

package/dist/lib/infrastructure/audit/AuditStore.js

@@ -1,6 +1,4 @@
-/**
- * AuditStore - 审计日志存储
- */
+/** AuditStore - 审计日志存储 */
 import { desc, eq, sql } from 'drizzle-orm';
 import { getDrizzle } from '../database/drizzle/index.js';
 import { auditLogs } from '../database/drizzle/schema.js';
@@ -32,9 +30,7 @@ export class AuditStore {
         })
             .run();
     }
-    /**
-     * 查询审计日志
-     */
+    /** 查询审计日志 */
     query(filters = {}) {
         let sql = 'SELECT * FROM audit_logs WHERE 1=1';
         const params = [];
@@ -112,9 +108,7 @@ export class AuditStore {
             .limit(limit)
             .all();
     }
-    /**
-     * 获取统计数据
-     */
+    /** 获取统计数据 */
     getStats(timeRange = '24h') {
         // 计算时间范围
         const hours = timeRange === '24h' ? 24 : timeRange === '7d' ? 168 : 720; // 30d
@@ -172,9 +166,8 @@ export class AuditStore {
     /**
      * 清理过期审计日志
      * ★ Drizzle 类型安全 DELETE
-     * @param {object} [opts]
-     * @param {number} [opts.maxAgeDays=90] 保留天数，超过此天数的记录将被删除
-     * @returns {{ deleted: number }}
+     * @param [opts.maxAgeDays=90] 保留天数，超过此天数的记录将被删除
+     * @returns }
      */
     cleanup({ maxAgeDays = 90 } = {}) {
         try {
@@ -191,4 +184,3 @@ export class AuditStore {
     }
 }
 export default AuditStore;
-//# sourceMappingURL=AuditStore.js.map

package/dist/lib/infrastructure/cache/CacheService.d.ts

@@ -3,9 +3,7 @@
  * 提供分布式缓存支持，提升 API 响应速度
  * 生产环境建议通过 UnifiedCacheAdapter 接入 Redis
  */
-/**
- * 本地缓存实现（无 Redis 依赖）
- */
+/** 本地缓存实现（无 Redis 依赖） */
 export declare class CacheService {
     cache: Map<string, {
         value: unknown;
@@ -13,48 +11,28 @@ export declare class CacheService {
     }>;
     cleanupInterval: ReturnType<typeof setInterval> | null;
     constructor();
-    /**
-     * 获取缓存
-     * @param {string} key
-     * @returns {any|null}
-     */
+    /** 获取缓存 */
     get(key: string): unknown;
     /**
      * 设置缓存
-     * @param {string} key
-     * @param {any} value
-     * @param {number} ttlSeconds 默认 300 秒
+     * @param ttlSeconds 默认 300 秒
      */
     set(key: string, value: unknown, ttlSeconds?: number): void;
-    /**
-     * 删除缓存
-     * @param {string} key
-     * @returns {boolean}
-     */
+    /** 删除缓存 */
     delete(key: string): boolean;
-    /**
-     * 清空所有缓存
-     */
+    /** 清空所有缓存 */
     clear(): void;
-    /**
-     * 清理过期缓存
-     */
+    /** 清理过期缓存 */
     cleanupExpired(): void;
-    /**
-     * 获取缓存统计信息
-     */
+    /** 获取缓存统计信息 */
     getStats(): {
         size: number;
         entries: string[];
     };
-    /**
-     * 关闭缓存服务
-     */
+    /** 关闭缓存服务 */
     shutdown(): void;
 }
-/**
- * 缓存键生成器
- */
+/** 缓存键生成器 */
 export declare class CacheKeyBuilder {
     static candidate(id: string): string;
     static candidatesList(page: number, limit: number, status?: string): string;
@@ -66,4 +44,3 @@ export declare class CacheKeyBuilder {
     static stats(): string;
 }
 export declare const cacheService: CacheService;
-//# sourceMappingURL=CacheService.d.ts.map

package/dist/lib/infrastructure/cache/CacheService.js

@@ -4,9 +4,7 @@
  * 生产环境建议通过 UnifiedCacheAdapter 接入 Redis
  */
 import Logger from '../logging/Logger.js';
-/**
- * 本地缓存实现（无 Redis 依赖）
- */
+/** 本地缓存实现（无 Redis 依赖） */
 export class CacheService {
     cache;
     cleanupInterval;
@@ -22,11 +20,7 @@ export class CacheService {
             this.cleanupInterval.unref();
         }
     }
-    /**
-     * 获取缓存
-     * @param {string} key
-     * @returns {any|null}
-     */
+    /** 获取缓存 */
     get(key) {
         const entry = this.cache.get(key);
         if (!entry) {
@@ -41,31 +35,21 @@ export class CacheService {
     }
     /**
      * 设置缓存
-     * @param {string} key
-     * @param {any} value
-     * @param {number} ttlSeconds 默认 300 秒
+     * @param ttlSeconds 默认 300 秒
      */
     set(key, value, ttlSeconds = 300) {
         const expiresAt = Date.now() + ttlSeconds * 1000;
         this.cache.set(key, { value, expiresAt });
     }
-    /**
-     * 删除缓存
-     * @param {string} key
-     * @returns {boolean}
-     */
+    /** 删除缓存 */
     delete(key) {
         return this.cache.delete(key);
     }
-    /**
-     * 清空所有缓存
-     */
+    /** 清空所有缓存 */
     clear() {
         this.cache.clear();
     }
-    /**
-     * 清理过期缓存
-     */
+    /** 清理过期缓存 */
     cleanupExpired() {
         const now = Date.now();
         for (const [key, entry] of this.cache.entries()) {
@@ -75,18 +59,14 @@ export class CacheService {
         }
         Logger.debug(`[Cache] Cleanup completed. Remaining entries: ${this.cache.size}`);
     }
-    /**
-     * 获取缓存统计信息
-     */
+    /** 获取缓存统计信息 */
     getStats() {
         return {
             size: this.cache.size,
             entries: Array.from(this.cache.keys()),
         };
     }
-    /**
-     * 关闭缓存服务
-     */
+    /** 关闭缓存服务 */
     shutdown() {
         if (this.cleanupInterval) {
             clearInterval(this.cleanupInterval);
@@ -95,9 +75,7 @@ export class CacheService {
         Logger.info('[Cache] Service shutdown');
     }
 }
-/**
- * 缓存键生成器
- */
+/** 缓存键生成器 */
 export class CacheKeyBuilder {
     static candidate(id) {
         return `candidate:${id}`;
@@ -129,4 +107,3 @@ export class CacheKeyBuilder {
 }
 // 导出单例实例
 export const cacheService = new CacheService();
-//# sourceMappingURL=CacheService.js.map

package/dist/lib/infrastructure/cache/GraphCache.d.ts

@@ -10,57 +10,47 @@
  */
 export declare class GraphCache {
     #private;
-    /**
-     * @param {string} projectRoot 项目根目录
-     */
+    /** @param projectRoot 项目根目录 */
     constructor(projectRoot: string);
     /**
      * 保存缓存
-     * @param {string} key 缓存键名（生成 {key}.json）
-     * @param {object} data 要缓存的数据
-     * @param {object} meta 元信息（含 hash、timestamp 等）
+     * @param key 缓存键名（生成 {key}.json）
+     * @param data 要缓存的数据
+     * @param meta 元信息（含 hash、timestamp 等）
      */
     save(key: string, data: unknown, meta?: Record<string, unknown>): void;
     /**
      * 加载缓存
-     * @param {string} key 缓存键名
-     * @returns {{ data: object, [key: string]: unknown } | null}
+     * @param key 缓存键名
+     * @returns | null}
      */
     load(key: string): any;
     /**
      * 检查缓存是否有效（hash 匹配）
-     * @param {string} key 缓存键
-     * @param {string} currentHash 当前内容的 hash
-     * @returns {boolean}
+     * @param key 缓存键
+     * @param currentHash 当前内容的 hash
      */
     isValid(key: string, currentHash: string): boolean;
-    /**
-     * 删除缓存
-     * @param {string} key
-     */
+    /** 删除缓存 */
     invalidate(key: string): void;
     /**
      * 计算文件内容 hash
-     * @param {string} filePath 文件绝对路径
-     * @returns {string} sha256 hex (前 16 字符)
+     * @param filePath 文件绝对路径
+     * @returns sha256 hex (前 16 字符)
      */
     computeFileHash(filePath: string): string;
     /**
      * 计算字符串内容 hash
-     * @param {string} content
-     * @returns {string} sha256 hex (前 16 字符)
+     * @returns sha256 hex (前 16 字符)
      */
     computeContentHash(content: string): string;
     /**
      * 批量计算文件 hash 映射
-     * @param {string[]} filePaths 文件绝对路径数组
-     * @param {string} projectRoot 项目根目录
-     * @returns {Object<string, string>} { relativePath: hash }
+     * @param filePaths 文件绝对路径数组
+     * @param projectRoot 项目根目录
+     * @returns { relativePath: hash }
      */
     computeFileHashes(filePaths: string[], projectRoot: string): Record<string, string>;
-    /**
-     * 获取缓存目录路径
-     */
+    /** 获取缓存目录路径 */
     getCacheDir(): string;
 }
-//# sourceMappingURL=GraphCache.d.ts.map

package/dist/lib/infrastructure/cache/GraphCache.js

@@ -15,18 +15,16 @@ import Logger from '../logging/Logger.js';
 export class GraphCache {
     #cacheDir;
     #logger;
-    /**
-     * @param {string} projectRoot 项目根目录
-     */
+    /** @param projectRoot 项目根目录 */
     constructor(projectRoot) {
         this.#cacheDir = join(projectRoot, '.autosnippet', 'cache');
         this.#logger = Logger.getInstance();
     }
     /**
      * 保存缓存
-     * @param {string} key 缓存键名（生成 {key}.json）
-     * @param {object} data 要缓存的数据
-     * @param {object} meta 元信息（含 hash、timestamp 等）
+     * @param key 缓存键名（生成 {key}.json）
+     * @param data 要缓存的数据
+     * @param meta 元信息（含 hash、timestamp 等）
      */
     save(key, data, meta = {}) {
         try {
@@ -49,8 +47,8 @@ export class GraphCache {
     }
     /**
      * 加载缓存
-     * @param {string} key 缓存键名
-     * @returns {{ data: object, [key: string]: unknown } | null}
+     * @param key 缓存键名
+     * @returns | null}
      */
     load(key) {
         try {
@@ -68,9 +66,8 @@ export class GraphCache {
     }
     /**
      * 检查缓存是否有效（hash 匹配）
-     * @param {string} key 缓存键
-     * @param {string} currentHash 当前内容的 hash
-     * @returns {boolean}
+     * @param key 缓存键
+     * @param currentHash 当前内容的 hash
      */
     isValid(key, currentHash) {
         const cached = this.load(key);
@@ -79,10 +76,7 @@ export class GraphCache {
         }
         return cached.contentHash === currentHash;
     }
-    /**
-     * 删除缓存
-     * @param {string} key
-     */
+    /** 删除缓存 */
     invalidate(key) {
         try {
             const filePath = join(this.#cacheDir, `${key}.json`);
@@ -97,8 +91,8 @@ export class GraphCache {
     }
     /**
      * 计算文件内容 hash
-     * @param {string} filePath 文件绝对路径
-     * @returns {string} sha256 hex (前 16 字符)
+     * @param filePath 文件绝对路径
+     * @returns sha256 hex (前 16 字符)
      */
     computeFileHash(filePath) {
         try {
@@ -111,17 +105,16 @@ export class GraphCache {
     }
     /**
      * 计算字符串内容 hash
-     * @param {string} content
-     * @returns {string} sha256 hex (前 16 字符)
+     * @returns sha256 hex (前 16 字符)
      */
     computeContentHash(content) {
         return createHash('sha256').update(content).digest('hex').substring(0, 16);
     }
     /**
      * 批量计算文件 hash 映射
-     * @param {string[]} filePaths 文件绝对路径数组
-     * @param {string} projectRoot 项目根目录
-     * @returns {Object<string, string>} { relativePath: hash }
+     * @param filePaths 文件绝对路径数组
+     * @param projectRoot 项目根目录
+     * @returns { relativePath: hash }
      */
     computeFileHashes(filePaths, projectRoot) {
         const hashes = {};
@@ -131,11 +124,8 @@ export class GraphCache {
         }
         return hashes;
     }
-    /**
-     * 获取缓存目录路径
-     */
+    /** 获取缓存目录路径 */
     getCacheDir() {
         return this.#cacheDir;
     }
 }
-//# sourceMappingURL=GraphCache.js.map