autosnippet 3.2.16 → 3.2.18

package/dist/lib/service/guard/GuardPatternUtils.js

@@ -11,11 +11,7 @@
 import { LanguageService } from '../../shared/LanguageService.js';
 /** @type {Map<string, RegExp>} 已编译的正则缓存 (pattern string → RegExp) */
 const _regexCache = new Map();
-/**
- * 编译正则模式（支持 RegExp 对象和 string，带缓存）
- * @param {RegExp|string} pattern
- * @returns {RegExp}
- */
+/** 编译正则模式（支持 RegExp 对象和 string，带缓存） */
 export function compilePattern(pattern) {
     if (pattern instanceof RegExp) {
         return pattern;
@@ -28,18 +24,14 @@ export function compilePattern(pattern) {
     }
     return cached;
 }
-/**
- * 清除正则缓存
- */
+/** 清除正则缓存 */
 export function clearPatternCache() {
     _regexCache.clear();
 }
 /**
  * 构建内联测试块掩码
  * 目前支持 Rust #[cfg(test)] mod xxx { ... } 块
- * @param {string[]} lines
- * @param {string} language
- * @returns {boolean[]} 每行是否在测试块内
+ * @returns 每行是否在测试块内
  */
 export function buildTestBlockMask(lines, language) {
     const mask = new Array(lines.length).fill(false);
@@ -113,9 +105,7 @@ export function buildTestBlockMask(lines, language) {
  *   /* ... * / 块注释  (C/Java/JS/TS/Go/Rust/Swift/Kotlin)
  *   \"\"\" ... \"\"\"  (Python doc-string — 简化: 整行以 \"\"\" 开头的行)
  *
- * @param {string[]} lines
- * @param {string} language
- * @returns {boolean[]} 每行是否为注释行
+ * @returns 每行是否为注释行
  */
 export function buildCommentMask(lines, language) {
     const mask = new Array(lines.length).fill(false);
@@ -157,9 +147,7 @@ export function buildCommentMask(lines, language) {
     }
     return mask;
 }
-/**
- * 从文件扩展名推断语言
- */
+/** 从文件扩展名推断语言 */
 export function detectLanguage(filePath) {
     if (!filePath) {
         return 'unknown';
@@ -168,4 +156,3 @@ export function detectLanguage(filePath) {
     // 向后兼容: Guard 内置规则使用 'objc' 而非 'objectivec'
     return LanguageService.toGuardLangId(lang);
 }
-//# sourceMappingURL=GuardPatternUtils.js.map

package/dist/lib/service/guard/GuardService.d.ts

@@ -90,25 +90,18 @@ export declare class GuardService {
     knowledgeRepository: KnowledgeRepositoryLike;
     logger: ReturnType<typeof Logger.getInstance>;
     /**
-     * @param {import('../../domain/knowledge/KnowledgeRepository.js').KnowledgeRepository} knowledgeRepository
-     * @param {object} auditLogger
-     * @param {object} gateway
-     * @param {object} [deps] 可选依赖注入
-     * @param {import('./GuardCheckEngine.js').GuardCheckEngine} [deps.guardCheckEngine] 核心引擎实例
+     * @param [deps] 可选依赖注入
+     * @param [deps.guardCheckEngine] 核心引擎实例
      */
     constructor(knowledgeRepository: KnowledgeRepositoryLike, auditLogger: AuditLoggerLike, gateway: unknown, deps?: {
         guardCheckEngine?: GuardCheckEngineLike;
     });
-    /**
-     * 创建新规则 → 创建一个 kind=rule, knowledgeType=boundary-constraint 的 KnowledgeEntry
-     */
+    /** 创建新规则 → 创建一个 kind=rule, knowledgeType=boundary-constraint 的 KnowledgeEntry */
     createRule(data: CreateRuleData, context: ActionContext): Promise<{
         id: string;
         title?: string;
     }>;
-    /**
-     * 启用规则（将 lifecycle 设为 active）
-     */
+    /** 启用规则（将 lifecycle 设为 active） */
     enableRule(ruleId: string, context: ActionContext): Promise<{
         id: string;
         title?: string;
@@ -121,9 +114,7 @@ export declare class GuardService {
             }[];
         };
     } | null>;
-    /**
-     * 禁用规则（将 lifecycle 设为 deprecated）
-     */
+    /** 禁用规则（将 lifecycle 设为 deprecated） */
     disableRule(ruleId: string, reason: string, context: ActionContext): Promise<{
         id: string;
         title?: string;
@@ -183,16 +174,12 @@ export declare class GuardService {
         }[];
         matchCount: number;
     }[]>;
-    /**
-     * 查询规则列表 (kind='rule' + knowledgeType='boundary-constraint')
-     */
+    /** 查询规则列表 (kind='rule' + knowledgeType='boundary-constraint') */
     listRules(filters?: Record<string, unknown>, pagination?: {
         page?: number;
         pageSize?: number;
     }): Promise<unknown>;
-    /**
-     * 搜索规则
-     */
+    /** 搜索规则 */
     searchRules(keyword: string, pagination?: {
         page?: number;
         pageSize?: number;
@@ -203,9 +190,7 @@ export declare class GuardService {
         }[];
         total: number;
     }>;
-    /**
-     * 获取规则统计
-     */
+    /** 获取规则统计 */
     getRuleStats(): Promise<unknown>;
     /**
      * 验证创建输入
@@ -214,4 +199,3 @@ export declare class GuardService {
     _validateCreateInput(data: CreateRuleData): void;
 }
 export default GuardService;
-//# sourceMappingURL=GuardService.d.ts.map

package/dist/lib/service/guard/GuardService.js

@@ -15,23 +15,17 @@ export class GuardService {
     knowledgeRepository;
     logger;
     /**
-     * @param {import('../../domain/knowledge/KnowledgeRepository.js').KnowledgeRepository} knowledgeRepository
-     * @param {object} auditLogger
-     * @param {object} gateway
-     * @param {object} [deps] 可选依赖注入
-     * @param {import('./GuardCheckEngine.js').GuardCheckEngine} [deps.guardCheckEngine] 核心引擎实例
+     * @param [deps] 可选依赖注入
+     * @param [deps.guardCheckEngine] 核心引擎实例
      */
     constructor(knowledgeRepository, auditLogger, gateway, deps = {}) {
         this.knowledgeRepository = knowledgeRepository;
         this.auditLogger = auditLogger;
         this.gateway = gateway;
         this.logger = Logger.getInstance();
-        /** @type {import('./GuardCheckEngine.js').GuardCheckEngine|null} */
         this._engine = deps.guardCheckEngine || null;
     }
-    /**
-     * 创建新规则 → 创建一个 kind=rule, knowledgeType=boundary-constraint 的 KnowledgeEntry
-     */
+    /** 创建新规则 → 创建一个 kind=rule, knowledgeType=boundary-constraint 的 KnowledgeEntry */
     async createRule(data, context) {
         try {
             this._validateCreateInput(data);
@@ -83,9 +77,7 @@ export class GuardService {
             throw error;
         }
     }
-    /**
-     * 启用规则（将 lifecycle 设为 active）
-     */
+    /** 启用规则（将 lifecycle 设为 active） */
     async enableRule(ruleId, context) {
         try {
             const entry = await this.knowledgeRepository.findById(ruleId);
@@ -113,9 +105,7 @@ export class GuardService {
             throw error;
         }
     }
-    /**
-     * 禁用规则（将 lifecycle 设为 deprecated）
-     */
+    /** 禁用规则（将 lifecycle 设为 deprecated） */
     async disableRule(ruleId, reason, context) {
         try {
             const entry = await this.knowledgeRepository.findById(ruleId);
@@ -236,9 +226,7 @@ export class GuardService {
         }
         return matches;
     }
-    /**
-     * 查询规则列表 (kind='rule' + knowledgeType='boundary-constraint')
-     */
+    /** 查询规则列表 (kind='rule' + knowledgeType='boundary-constraint') */
     async listRules(filters = {}, pagination = {}) {
         try {
             const { page = 1, pageSize = 20 } = pagination;
@@ -249,9 +237,7 @@ export class GuardService {
             throw error;
         }
     }
-    /**
-     * 搜索规则
-     */
+    /** 搜索规则 */
     async searchRules(keyword, pagination = {}) {
         try {
             const { page = 1, pageSize = 20 } = pagination;
@@ -265,9 +251,7 @@ export class GuardService {
             throw error;
         }
     }
-    /**
-     * 获取规则统计
-     */
+    /** 获取规则统计 */
     async getRuleStats() {
         try {
             return this.knowledgeRepository.getStats();
@@ -302,4 +286,3 @@ export class GuardService {
     }
 }
 export default GuardService;
-//# sourceMappingURL=GuardService.js.map

package/dist/lib/service/guard/RuleLearner.d.ts

@@ -20,20 +20,14 @@ export declare class RuleLearner {
     });
     /**
      * 记录规则触发
-     * @param {string} ruleId
      * @param {{ filePath?: string, message?: string }} context
      */
     recordTrigger(ruleId: string, _context?: Record<string, unknown>): void;
-    /**
-     * 记录用户反馈
-     * @param {string} ruleId
-     * @param {'correct'|'falsePositive'|'falseNegative'} feedbackType
-     */
+    /** 记录用户反馈 */
     recordFeedback(ruleId: string, feedbackType: 'correct' | 'falsePositive' | 'falseNegative'): void;
     /**
      * 获取规则精准度指标
-     * @param {string} ruleId
-     * @returns {{ precision: number, recall: number, f1: number, triggers: number, falsePositiveRate: number }}
+     * @returns }
      */
     getMetrics(ruleId: string): {
         precision: number;
@@ -44,28 +38,24 @@ export declare class RuleLearner {
     };
     /**
      * 识别问题规则（高误报）
-     * @returns {Array<{ ruleId: string, metrics: object, recommendation: string }>}
+     * @returns >}
      */
     getProblematicRules(): {
         ruleId: string;
         metrics: ReturnType<RuleLearner["getMetrics"]>;
         recommendation: string;
     }[];
-    /**
-     * 获取所有规则统计
-     */
+    /** 获取所有规则统计 */
     getAllStats(): Record<string, RuleStat & {
         metrics: ReturnType<RuleLearner["getMetrics"]>;
     }>;
-    /**
-     * 重置指定规则或全部统计
-     */
+    /** 重置指定规则或全部统计 */
     resetStats(ruleId?: string | null): void;
     /**
      * 基于历史数据提出规则优化建议
      * 策略 1: 高误报规则 → 建议调整
      * 策略 2: 高触发且高精度 → 建议创建项目特化版本
-     * @returns {Array<{ type: string, ruleId: string, message: string, confidence: number, evidence: object }>}
+     * @returns >}
      */
     suggestRules(): {
         type: string;
@@ -77,8 +67,7 @@ export declare class RuleLearner {
     /**
      * 追踪规则创建后的效果
      * 对比首次触发后的表现，判断规则是否有效
-     * @param {string} ruleId
-     * @returns {{ status: string, triggers: number, precision: number, recommendation: string, daysSinceFirstTrigger?: number }}
+     * @returns }
      */
     trackRuleEffectiveness(ruleId: string): {
         status: string;
@@ -95,4 +84,3 @@ export declare class RuleLearner {
     };
 }
 export {};
-//# sourceMappingURL=RuleLearner.d.ts.map

package/dist/lib/service/guard/RuleLearner.js

@@ -25,7 +25,6 @@ export class RuleLearner {
     }
     /**
      * 记录规则触发
-     * @param {string} ruleId
      * @param {{ filePath?: string, message?: string }} context
      */
     recordTrigger(ruleId, _context = {}) {
@@ -38,11 +37,7 @@ export class RuleLearner {
         }
         this.#save();
     }
-    /**
-     * 记录用户反馈
-     * @param {string} ruleId
-     * @param {'correct'|'falsePositive'|'falseNegative'} feedbackType
-     */
+    /** 记录用户反馈 */
     recordFeedback(ruleId, feedbackType) {
         const stat = this.#ensureStat(ruleId);
         if (feedbackType === 'correct') {
@@ -59,8 +54,7 @@ export class RuleLearner {
     }
     /**
      * 获取规则精准度指标
-     * @param {string} ruleId
-     * @returns {{ precision: number, recall: number, f1: number, triggers: number, falsePositiveRate: number }}
+     * @returns }
      */
     getMetrics(ruleId) {
         const stat = this.#data.ruleStats[ruleId];
@@ -78,7 +72,7 @@ export class RuleLearner {
     }
     /**
      * 识别问题规则（高误报）
-     * @returns {Array<{ ruleId: string, metrics: object, recommendation: string }>}
+     * @returns >}
      */
     getProblematicRules() {
         const results = [];
@@ -103,9 +97,7 @@ export class RuleLearner {
         }
         return results.sort((a, b) => b.metrics.falsePositiveRate - a.metrics.falsePositiveRate);
     }
-    /**
-     * 获取所有规则统计
-     */
+    /** 获取所有规则统计 */
     getAllStats() {
         const result = {};
         for (const [ruleId] of Object.entries(this.#data.ruleStats)) {
@@ -116,9 +108,7 @@ export class RuleLearner {
         }
         return result;
     }
-    /**
-     * 重置指定规则或全部统计
-     */
+    /** 重置指定规则或全部统计 */
     resetStats(ruleId = null) {
         if (ruleId) {
             delete this.#data.ruleStats[ruleId];
@@ -132,7 +122,7 @@ export class RuleLearner {
      * 基于历史数据提出规则优化建议
      * 策略 1: 高误报规则 → 建议调整
      * 策略 2: 高触发且高精度 → 建议创建项目特化版本
-     * @returns {Array<{ type: string, ruleId: string, message: string, confidence: number, evidence: object }>}
+     * @returns >}
      */
     suggestRules() {
         const suggestions = [];
@@ -195,8 +185,7 @@ export class RuleLearner {
     /**
      * 追踪规则创建后的效果
      * 对比首次触发后的表现，判断规则是否有效
-     * @param {string} ruleId
-     * @returns {{ status: string, triggers: number, precision: number, recommendation: string, daysSinceFirstTrigger?: number }}
+     * @returns }
      */
     trackRuleEffectiveness(ruleId) {
         const stat = this.#data.ruleStats[ruleId];
@@ -296,4 +285,3 @@ export class RuleLearner {
         }
     }
 }
-//# sourceMappingURL=RuleLearner.js.map

package/dist/lib/service/guard/SourceFileCollector.d.ts

@@ -7,12 +7,11 @@
 export declare const SOURCE_EXTS: Readonly<Set<string>>;
 /**
  * 递归收集目录下所有源文件路径
- * @param {string} dir 根目录
- * @param {object} options
- * @param {Set<string>} [options.extensions] 允许的扩展名（默认 SOURCE_EXTS）
- * @param {Set<string>} [options.skipDirs] 跳过的目录名（默认 SKIP_DIRS）
- * @param {number} [options.maxFiles] 最大文件数量（默认无限制）
- * @returns {Promise<string[]>} 文件路径列表
+ * @param dir 根目录
+ * @param [options.extensions] 允许的扩展名（默认 SOURCE_EXTS）
+ * @param [options.skipDirs] 跳过的目录名（默认 SKIP_DIRS）
+ * @param [options.maxFiles] 最大文件数量（默认无限制）
+ * @returns 文件路径列表
  */
 export declare function collectSourceFiles(dir: string, options?: {
     extensions?: Set<string>;
@@ -21,9 +20,9 @@ export declare function collectSourceFiles(dir: string, options?: {
 }): Promise<string[]>;
 /**
  * 收集源文件并读取内容
- * @param {string} dir 根目录
- * @param {object} options - collectSourceFiles 选项
- * @returns {Promise<Array<{path: string, content: string}>>}
+ * @param dir 根目录
+ * @param options collectSourceFiles 选项
+ * @returns >>}
  */
 export declare function collectSourceFilesWithContent(dir: string, options?: {
     extensions?: Set<string>;
@@ -39,4 +38,3 @@ declare const _default: {
     SOURCE_EXTS: Readonly<Set<string>>;
 };
 export default _default;
-//# sourceMappingURL=SourceFileCollector.d.ts.map

package/dist/lib/service/guard/SourceFileCollector.js

@@ -40,12 +40,11 @@ const SKIP_DIRS = new Set([
 ]);
 /**
  * 递归收集目录下所有源文件路径
- * @param {string} dir 根目录
- * @param {object} options
- * @param {Set<string>} [options.extensions] 允许的扩展名（默认 SOURCE_EXTS）
- * @param {Set<string>} [options.skipDirs] 跳过的目录名（默认 SKIP_DIRS）
- * @param {number} [options.maxFiles] 最大文件数量（默认无限制）
- * @returns {Promise<string[]>} 文件路径列表
+ * @param dir 根目录
+ * @param [options.extensions] 允许的扩展名（默认 SOURCE_EXTS）
+ * @param [options.skipDirs] 跳过的目录名（默认 SKIP_DIRS）
+ * @param [options.maxFiles] 最大文件数量（默认无限制）
+ * @returns 文件路径列表
  */
 export async function collectSourceFiles(dir, options = {}) {
     const { extensions = SOURCE_EXTS, skipDirs = SKIP_DIRS, maxFiles = Infinity } = options;
@@ -84,9 +83,9 @@ export async function collectSourceFiles(dir, options = {}) {
 }
 /**
  * 收集源文件并读取内容
- * @param {string} dir 根目录
- * @param {object} options - collectSourceFiles 选项
- * @returns {Promise<Array<{path: string, content: string}>>}
+ * @param dir 根目录
+ * @param options collectSourceFiles 选项
+ * @returns >>}
  */
 export async function collectSourceFilesWithContent(dir, options = {}) {
     const paths = await collectSourceFiles(dir, options);
@@ -103,4 +102,3 @@ export async function collectSourceFilesWithContent(dir, options = {}) {
     return results;
 }
 export default { collectSourceFiles, collectSourceFilesWithContent, SOURCE_EXTS };
-//# sourceMappingURL=SourceFileCollector.js.map

package/dist/lib/service/guard/ViolationsStore.d.ts

@@ -32,9 +32,7 @@ interface RunOutput {
 }
 export declare class ViolationsStore {
     #private;
-    /**
-     * @param {import('better-sqlite3').Database} db - SQLite 数据库实例
-     */
+    /** @param db SQLite 数据库实例 */
     constructor(db: DatabaseLike, drizzle?: DrizzleDB);
     /**
      * 追加一次 Guard 运行记录
@@ -56,9 +54,7 @@ export declare class ViolationsStore {
      * ★ Drizzle 类型安全 SELECT + ORDER + LIMIT
      */
     getRecentRuns(n?: number): RunOutput[];
-    /**
-     * 获取统计汇总
-     */
+    /** 获取统计汇总 */
     getStats(): {
         totalRuns: number;
         totalViolations: number;
@@ -68,12 +64,12 @@ export declare class ViolationsStore {
     /**
      * 按规则 ID 聚合统计
      * 利用 SQLite json_each 展开 violations_json 数组
-     * @returns {Array<{ruleId: string, severity: string, count: number}>}
+     * @returns >}
      */
     getStatsByRule(): Record<string, unknown>[];
     /**
      * 获取趋势数据 — 对比最近两次运行
-     * @returns {{ errorsChange: number, warningsChange: number, latestErrors: number, latestWarnings: number, previousErrors: number, previousWarnings: number }}
+     * @returns }
      */
     getTrend(): {
         errorsChange: number;
@@ -89,17 +85,13 @@ export declare class ViolationsStore {
      * ★ Drizzle 类型安全 DELETE
      */
     clearRuns(): void;
-    /**
-     * 清除指定规则或文件的记录
-     */
+    /** 清除指定规则或文件的记录 */
     clearAll(): Promise<void>;
     clear({ ruleId, file }?: {
         ruleId?: string;
         file?: string;
     }): Promise<void>;
-    /**
-     * 兼容 v2 violations.js 路由的 list()
-     */
+    /** 兼容 v2 violations.js 路由的 list() */
     list(filters?: {
         file?: string;
     }, { page, limit }?: {
@@ -116,4 +108,3 @@ export declare class ViolationsStore {
     }>;
 }
 export {};
-//# sourceMappingURL=ViolationsStore.d.ts.map

package/dist/lib/service/guard/ViolationsStore.js

@@ -10,9 +10,7 @@ const MAX_RUNS = 200;
 export class ViolationsStore {
     #db;
     #drizzle;
-    /**
-     * @param {import('better-sqlite3').Database} db - SQLite 数据库实例
-     */
+    /** @param db SQLite 数据库实例 */
     constructor(db, drizzle) {
         this.#db = db;
         this.#drizzle = drizzle ?? getDrizzle();
@@ -86,9 +84,7 @@ export class ViolationsStore {
             .all();
         return rows.reverse().map((r) => this.#rowToRun(r));
     }
-    /**
-     * 获取统计汇总
-     */
+    /** 获取统计汇总 */
     getStats() {
         const row = this.#db
             .prepare(`
@@ -109,7 +105,7 @@ export class ViolationsStore {
     /**
      * 按规则 ID 聚合统计
      * 利用 SQLite json_each 展开 violations_json 数组
-     * @returns {Array<{ruleId: string, severity: string, count: number}>}
+     * @returns >}
      */
     getStatsByRule() {
         try {
@@ -132,7 +128,7 @@ export class ViolationsStore {
     }
     /**
      * 获取趋势数据 — 对比最近两次运行
-     * @returns {{ errorsChange: number, warningsChange: number, latestErrors: number, latestWarnings: number, previousErrors: number, previousWarnings: number }}
+     * @returns }
      */
     getTrend() {
         const recent = this.getRecentRuns(2);
@@ -171,9 +167,7 @@ export class ViolationsStore {
     clearRuns() {
         this.#drizzle.delete(guardViolations).run();
     }
-    /**
-     * 清除指定规则或文件的记录
-     */
+    /** 清除指定规则或文件的记录 */
     async clearAll() {
         this.clearRuns();
     }
@@ -185,9 +179,7 @@ export class ViolationsStore {
             this.clearRuns();
         }
     }
-    /**
-     * 兼容 v2 violations.js 路由的 list()
-     */
+    /** 兼容 v2 violations.js 路由的 list() */
     async list(filters = {}, { page = 1, limit = 20 } = {}) {
         const offset = (page - 1) * limit;
         let sql = 'SELECT * FROM guard_violations';
@@ -210,9 +202,7 @@ export class ViolationsStore {
         };
     }
     // ─── 内部 ─────────────────────────────────────────────
-    /**
-     * 行转运行记录（兼容 raw SQL snake_case 和 Drizzle camelCase）
-     */
+    /** 行转运行记录（兼容 raw SQL snake_case 和 Drizzle camelCase） */
     #rowToRun(row) {
         const violationsRaw = (row.violationsJson ?? row.violations_json);
         return {
@@ -225,4 +215,3 @@ export class ViolationsStore {
         };
     }
 }
-//# sourceMappingURL=ViolationsStore.js.map