autosnippet 3.2.16 → 3.2.17

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

@@ -47,57 +47,34 @@ export declare class ExclusionManager {
     });
     /**
      * 添加路径排除 (glob 或精确路径)
-     * @param {string} pattern
      * @param {{ reason?: string }} meta
      */
     addPathExclusion(pattern: string, meta?: ExclusionMeta): void;
-    /**
-     * 检查文件路径是否被排除
-     */
+    /** 检查文件路径是否被排除 */
     isPathExcluded(filePath: string): boolean;
-    /**
-     * 移除路径排除
-     */
+    /** 移除路径排除 */
     removePathExclusion(pattern: string): void;
-    /**
-     * 为特定文件排除某条规则
-     * @param {string} ruleId
-     * @param {string} filePath
-     */
+    /** 为特定文件排除某条规则 */
     addRuleExclusion(ruleId: string, filePath: string, meta?: ExclusionMeta): void;
-    /**
-     * 检查规则在特定文件是否被排除
-     */
+    /** 检查规则在特定文件是否被排除 */
     isRuleExcluded(ruleId: string, filePath: string): boolean;
-    /**
-     * 移除文件级规则排除
-     */
+    /** 移除文件级规则排除 */
     removeRuleExclusion(ruleId: string, filePath: string): void;
-    /**
-     * 全局禁用某条规则
-     */
+    /** 全局禁用某条规则 */
     addGlobalRuleExclusion(ruleId: string, meta?: ExclusionMeta): void;
-    /**
-     * 检查规则是否被全局禁用
-     */
+    /** 检查规则是否被全局禁用 */
     isRuleGloballyDisabled(ruleId: string): boolean;
-    /**
-     * 移除全局规则排除
-     */
+    /** 移除全局规则排除 */
     removeGlobalRuleExclusion(ruleId: string): void;
     /**
      * 应用排除策略到审计结果
-     * @param {object[]} violations - [{ruleId, filePath, ...}]
-     * @returns {object[]} 过滤后的违反列表
+     * @param violations [{ruleId, filePath, ...}]
+     * @returns 过滤后的违反列表
      */
     applyExclusions(violations: ViolationInput[]): ViolationInput[];
-    /**
-     * 导入排除配置
-     */
+    /** 导入排除配置 */
     importExclusions(config: ExclusionConfig): void;
-    /**
-     * 导出当前排除配置
-     */
+    /** 导出当前排除配置 */
     exportExclusions(): {
         pathExclusions: PathExclusion[];
         ruleExclusions: Record<string, RuleExclusionEntry[]>;
@@ -105,4 +82,3 @@ export declare class ExclusionManager {
     };
 }
 export {};
-//# sourceMappingURL=ExclusionManager.d.ts.map

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

@@ -22,7 +22,6 @@ export class ExclusionManager {
     // ─── Path 排除 ───────────────────────────────────────
     /**
      * 添加路径排除 (glob 或精确路径)
-     * @param {string} pattern
      * @param {{ reason?: string }} meta
      */
     addPathExclusion(pattern, meta = {}) {
@@ -40,25 +39,17 @@ export class ExclusionManager {
         });
         this.#save();
     }
-    /**
-     * 检查文件路径是否被排除
-     */
+    /** 检查文件路径是否被排除 */
     isPathExcluded(filePath) {
         return this.#data.pathExclusions.some((e) => this.#matchGlob(filePath, e.pattern));
     }
-    /**
-     * 移除路径排除
-     */
+    /** 移除路径排除 */
     removePathExclusion(pattern) {
         this.#data.pathExclusions = this.#data.pathExclusions.filter((e) => e.pattern !== pattern);
         this.#save();
     }
     // ─── Rule 排除 (per-file) ───────────────────────────
-    /**
-     * 为特定文件排除某条规则
-     * @param {string} ruleId
-     * @param {string} filePath
-     */
+    /** 为特定文件排除某条规则 */
     addRuleExclusion(ruleId, filePath, meta = {}) {
         if (!this.#data.ruleExclusions[ruleId]) {
             this.#data.ruleExclusions[ruleId] = [];
@@ -70,9 +61,7 @@ export class ExclusionManager {
         list.push({ filePath, reason: meta.reason || '', addedAt: new Date().toISOString() });
         this.#save();
     }
-    /**
-     * 检查规则在特定文件是否被排除
-     */
+    /** 检查规则在特定文件是否被排除 */
     isRuleExcluded(ruleId, filePath) {
         if (this.isRuleGloballyDisabled(ruleId)) {
             return true;
@@ -83,9 +72,7 @@ export class ExclusionManager {
         }
         return list.some((e) => e.filePath === filePath || this.#matchGlob(filePath, e.filePath));
     }
-    /**
-     * 移除文件级规则排除
-     */
+    /** 移除文件级规则排除 */
     removeRuleExclusion(ruleId, filePath) {
         const list = this.#data.ruleExclusions[ruleId];
         if (!list) {
@@ -98,9 +85,7 @@ export class ExclusionManager {
         this.#save();
     }
     // ─── Global Rule 排除 ────────────────────────────────
-    /**
-     * 全局禁用某条规则
-     */
+    /** 全局禁用某条规则 */
     addGlobalRuleExclusion(ruleId, meta = {}) {
         if (this.#data.globalRuleExclusions.find((e) => e.ruleId === ruleId)) {
             return;
@@ -112,15 +97,11 @@ export class ExclusionManager {
         });
         this.#save();
     }
-    /**
-     * 检查规则是否被全局禁用
-     */
+    /** 检查规则是否被全局禁用 */
     isRuleGloballyDisabled(ruleId) {
         return this.#data.globalRuleExclusions.some((e) => e.ruleId === ruleId);
     }
-    /**
-     * 移除全局规则排除
-     */
+    /** 移除全局规则排除 */
     removeGlobalRuleExclusion(ruleId) {
         this.#data.globalRuleExclusions = this.#data.globalRuleExclusions.filter((e) => e.ruleId !== ruleId);
         this.#save();
@@ -128,8 +109,8 @@ export class ExclusionManager {
     // ─── 批量操作 ─────────────────────────────────────────
     /**
      * 应用排除策略到审计结果
-     * @param {object[]} violations - [{ruleId, filePath, ...}]
-     * @returns {object[]} 过滤后的违反列表
+     * @param violations [{ruleId, filePath, ...}]
+     * @returns 过滤后的违反列表
      */
     applyExclusions(violations) {
         return violations.filter((v) => {
@@ -145,9 +126,7 @@ export class ExclusionManager {
             return true;
         });
     }
-    /**
-     * 导入排除配置
-     */
+    /** 导入排除配置 */
     importExclusions(config) {
         if (config.pathExclusions) {
             for (const e of config.pathExclusions) {
@@ -167,9 +146,7 @@ export class ExclusionManager {
             }
         }
     }
-    /**
-     * 导出当前排除配置
-     */
+    /** 导出当前排除配置 */
     exportExclusions() {
         return { ...this.#data };
     }
@@ -232,9 +209,7 @@ export class ExclusionManager {
             });
         }
     }
-    /**
-     * 自动迁移旧路径 .autosnippet/guard-exclusions.json → AutoSnippet/guard-exclusions.json
-     */
+    /** 自动迁移旧路径 .autosnippet/guard-exclusions.json → AutoSnippet/guard-exclusions.json */
     #migrateOldPath(projectRoot, internalDir) {
         try {
             const oldPath = join(projectRoot, internalDir, 'guard-exclusions.json');
@@ -254,4 +229,3 @@ export class ExclusionManager {
         }
     }
 }
-//# sourceMappingURL=ExclusionManager.js.map

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

@@ -95,9 +95,7 @@ interface AuditFilesInput {
     content: string;
 }
 export { detectLanguage } from './GuardPatternUtils.js';
-/**
- * GuardCheckEngine - 核心检查引擎
- */
+/** GuardCheckEngine - 核心检查引擎 */
 export declare class GuardCheckEngine {
     _astRulesCache: GuardRule[] | null;
     _builtInRules: Record<string, BuiltInRule>;
@@ -118,21 +116,17 @@ export declare class GuardCheckEngine {
      * @param {Array<{ruleId: string, pattern: RegExp|string, severity: string, message: string, category?: string, dimension?: string, languages?: string[], fixSuggestion?: string}>} rules
      */
     injectExternalRules(rules: ExternalRuleInput[]): void;
-    /**
-     * EP 注入幂等标记 — 调用者可用此判断是否已完成注入，避免重复加载 EnhancementRegistry
-     */
+    /** EP 注入幂等标记 — 调用者可用此判断是否已完成注入，避免重复加载 EnhancementRegistry */
     isEpInjected(): boolean;
     markEpInjected(): void;
-    /**
-     * 获取所有启用的规则 (数据库 + 内置)
-     */
+    /** 获取所有启用的规则 (数据库 + 内置) */
     getRules(language?: string | null): GuardRule[];
     /**
      * 对代码运行静态检查
-     * @param {string} code 源代码
-     * @param {string} language - 'objc'|'swift'|'javascript' 等
-     * @param {object} options - {scope, filePath}
-     * @returns {Array<{ruleId, message, severity, line, snippet, dimension?, fixSuggestion?}>}
+     * @param code 源代码
+     * @param language 'objc'|'swift'|'javascript' 等
+     * @param options {scope, filePath}
+     * @returns >}
      */
     checkCode(code: string, language: string, options?: {
         scope?: string | null;
@@ -156,14 +150,12 @@ export declare class GuardCheckEngine {
      * AST 语义规则检查
      * 支持 3 种查询类型: mustCallThrough, mustNotUseInContext, mustConformToProtocol
      * 仅在 Tree-sitter 可用且语言为 ObjC/Swift 时执行
-     * @param {string} code 源代码
-     * @param {string} language 语言标识
-     * @returns {Array} violations
+     * @param code 源代码
+     * @param language 语言标识
+     * @returns violations
      */
     _runAstRuleChecks(code: string, language: string): GuardViolation[];
-    /**
-     * 获取 AstAnalyzer 模块（静态 import，带可用性检测）
-     */
+    /** 获取 AstAnalyzer 模块（静态 import，带可用性检测） */
     _getAstAnalyzer(): typeof AstAnalyzerModule;
     /**
      * 将 Guard 命中计数回写到对应 Recipe 的 guard_hit_count
@@ -172,9 +164,9 @@ export declare class GuardCheckEngine {
     trackGuardHits(violations: GuardViolation[]): void;
     /**
      * 文件审计 - 读取文件并检查
-     * @param {string} filePath 绝对路径
-     * @param {string} code 文件内容
-     * @param {object} options - {scope}
+     * @param filePath 绝对路径
+     * @param code 文件内容
+     * @param options {scope}
      */
     auditFile(filePath: string, code: string, options?: {
         scope?: string;
@@ -182,8 +174,8 @@ export declare class GuardCheckEngine {
     /**
      * 批量文件审计
      * @param {Array<{path: string, content: string}>} files
-     * @param {object} options - {scope: 'file'|'target'|'project'}
-     * @returns {{files, summary, crossFileViolations}}
+     * @param options {scope: 'file'|'target'|'project'}
+     * @returns }
      */
     auditFiles(files: AuditFilesInput[], options?: {
         scope?: string;
@@ -197,20 +189,13 @@ export declare class GuardCheckEngine {
             filesWithViolations: number;
         };
     };
-    /**
-     * 清除规则缓存
-     */
+    /** 清除规则缓存 */
     clearCache(): void;
-    /**
-     * 获取内置规则列表
-     */
+    /** 获取内置规则列表 */
     getBuiltInRules(): {
         [x: string]: BuiltInRule;
     };
-    /**
-     * 获取已注入的外部规则数量
-     */
+    /** 获取已注入的外部规则数量 */
     getExternalRuleCount(): number;
 }
 export default GuardCheckEngine;
-//# sourceMappingURL=GuardCheckEngine.d.ts.map

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

@@ -439,9 +439,7 @@ const BUILT_IN_RULES = {
 };
 // 向后兼容: 从 GuardPatternUtils 重新导出 detectLanguage
 export { detectLanguage } from './GuardPatternUtils.js';
-/**
- * GuardCheckEngine - 核心检查引擎
- */
+/** GuardCheckEngine - 核心检查引擎 */
 export class GuardCheckEngine {
     _astRulesCache;
     _builtInRules;
@@ -466,10 +464,7 @@ export class GuardCheckEngine {
         this._externalRules = new Map();
         /** @type {boolean} EP 规则是否已注入（幂等标记，避免每次请求重复注入） */
         this._epInjected = false;
-        /**
-         * Guard 配置 — 允许禁用特定规则或调整 Code-Level 检查阈值
-         * @type {{ disabledRules?: string[], codeLevelThresholds?: Record<string, number> }}
-         */
+        /** Guard 配置 — 允许禁用特定规则或调整 Code-Level 检查阈值 */
         this._guardConfig = options.guardConfig || {};
     }
     /**
@@ -514,18 +509,14 @@ export class GuardCheckEngine {
         }
         this.logger.debug(`[GuardCheckEngine] External rules injected: ${this._externalRules.size} active`);
     }
-    /**
-     * EP 注入幂等标记 — 调用者可用此判断是否已完成注入，避免重复加载 EnhancementRegistry
-     */
+    /** EP 注入幂等标记 — 调用者可用此判断是否已完成注入，避免重复加载 EnhancementRegistry */
     isEpInjected() {
         return this._epInjected;
     }
     markEpInjected() {
         this._epInjected = true;
     }
-    /**
-     * 获取所有启用的规则 (数据库 + 内置)
-     */
+    /** 获取所有启用的规则 (数据库 + 内置) */
     getRules(language = null) {
         let rules = [];
         // 从数据库加载自定义规则
@@ -645,10 +636,10 @@ export class GuardCheckEngine {
     }
     /**
      * 对代码运行静态检查
-     * @param {string} code 源代码
-     * @param {string} language - 'objc'|'swift'|'javascript' 等
-     * @param {object} options - {scope, filePath}
-     * @returns {Array<{ruleId, message, severity, line, snippet, dimension?, fixSuggestion?}>}
+     * @param code 源代码
+     * @param language 'objc'|'swift'|'javascript' 等
+     * @param options {scope, filePath}
+     * @returns >}
      */
     checkCode(code, language, options = {}) {
         const { scope = null, filePath = '' } = options;
@@ -743,9 +734,9 @@ export class GuardCheckEngine {
      * AST 语义规则检查
      * 支持 3 种查询类型: mustCallThrough, mustNotUseInContext, mustConformToProtocol
      * 仅在 Tree-sitter 可用且语言为 ObjC/Swift 时执行
-     * @param {string} code 源代码
-     * @param {string} language 语言标识
-     * @returns {Array} violations
+     * @param code 源代码
+     * @param language 语言标识
+     * @returns violations
      */
     _runAstRuleChecks(code, language) {
         // AST 语言标准化 — 通过 LanguageService 判断是否为已知编程语言
@@ -858,9 +849,7 @@ export class GuardCheckEngine {
         }
         return violations;
     }
-    /**
-     * 获取 AstAnalyzer 模块（静态 import，带可用性检测）
-     */
+    /** 获取 AstAnalyzer 模块（静态 import，带可用性检测） */
     _getAstAnalyzer() {
         return AstAnalyzerModule;
     }
@@ -906,9 +895,9 @@ export class GuardCheckEngine {
     }
     /**
      * 文件审计 - 读取文件并检查
-     * @param {string} filePath 绝对路径
-     * @param {string} code 文件内容
-     * @param {object} options - {scope}
+     * @param filePath 绝对路径
+     * @param code 文件内容
+     * @param options {scope}
      */
     auditFile(filePath, code, options = {}) {
         const language = detectLanguage(filePath);
@@ -927,8 +916,8 @@ export class GuardCheckEngine {
     /**
      * 批量文件审计
      * @param {Array<{path: string, content: string}>} files
-     * @param {object} options - {scope: 'file'|'target'|'project'}
-     * @returns {{files, summary, crossFileViolations}}
+     * @param options {scope: 'file'|'target'|'project'}
+     * @returns }
      */
     auditFiles(files, options = {}) {
         const results = [];
@@ -957,26 +946,19 @@ export class GuardCheckEngine {
             },
         };
     }
-    /**
-     * 清除规则缓存
-     */
+    /** 清除规则缓存 */
     clearCache() {
         this._customRulesCache = null;
         this._cacheTime = 0;
         clearPatternCache();
     }
-    /**
-     * 获取内置规则列表
-     */
+    /** 获取内置规则列表 */
     getBuiltInRules() {
         return { ...this._builtInRules };
     }
-    /**
-     * 获取已注入的外部规则数量
-     */
+    /** 获取已注入的外部规则数量 */
     getExternalRuleCount() {
         return this._externalRules.size;
     }
 }
 export default GuardCheckEngine;
-//# sourceMappingURL=GuardCheckEngine.js.map

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

@@ -9,13 +9,12 @@
  * 按语言分发到各自的检查逻辑
  * 支持 disabledRules 禁用特定检查、codeLevelThresholds 调整阈值
  *
- * @param {string} code 源代码
- * @param {string} language 语言标识
- * @param {string[]} lines 按行拆分的源代码
- * @param {object} options
- * @param {string[]} [options.disabledRules] 禁用的规则 ID 列表
- * @param {Record<string, number>} [options.codeLevelThresholds] 可配置阈值
- * @returns {Array<{ruleId, message, severity, line, snippet, dimension?, fixSuggestion?}>}
+ * @param code 源代码
+ * @param language 语言标识
+ * @param lines 按行拆分的源代码
+ * @param [options.disabledRules] 禁用的规则 ID 列表
+ * @param [options.codeLevelThresholds] 可配置阈值
+ * @returns >}
  */
 interface CodeLevelViolation {
     ruleId: string;
@@ -31,4 +30,3 @@ export declare function runCodeLevelChecks(code: string, language: string, lines
     codeLevelThresholds?: Record<string, number>;
 }): CodeLevelViolation[];
 export {};
-//# sourceMappingURL=GuardCodeChecks.d.ts.map

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

@@ -348,4 +348,3 @@ export function runCodeLevelChecks(code, language, lines, options = {}) {
     }
     return violations;
 }
-//# sourceMappingURL=GuardCodeChecks.js.map

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

@@ -6,23 +6,17 @@
  */
 /**
  * 解析相对 import 路径为归一化路径（去掉扩展名）
- * @param {string} fromDir 当前文件目录
- * @param {string} importPath 相对路径如 './foo' 或 '../bar/baz'
- * @returns {string|null}
+ * @param fromDir 当前文件目录
+ * @param importPath 相对路径如 './foo' 或 '../bar/baz'
  */
 export declare function resolveImportPath(fromDir: string, importPath: string): string | null;
-/**
- * 归一化文件路径（去扩展名，用于 import 比较）
- * @param {string} filePath
- * @returns {string}
- */
+/** 归一化文件路径（去扩展名，用于 import 比较） */
 export declare function normalizeFilePath(filePath: string): string;
 /**
  * 跨文件检查 — 需要多文件上下文才能发现的问题
  * @param {Array<{path: string, content: string}>} files
- * @param {object} options
- * @param {string[]} [options.disabledRules] 禁用的规则 ID 列表
- * @returns {Array<{ruleId, message, severity, locations}>}
+ * @param [options.disabledRules] 禁用的规则 ID 列表
+ * @returns >}
  */
 export interface CrossFileViolation {
     ruleId: string;
@@ -40,4 +34,3 @@ export declare function runCrossFileChecks(files: {
 }[], options?: {
     disabledRules?: string[];
 }): CrossFileViolation[];
-//# sourceMappingURL=GuardCrossFileChecks.d.ts.map

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

@@ -6,9 +6,8 @@
  */
 /**
  * 解析相对 import 路径为归一化路径（去掉扩展名）
- * @param {string} fromDir 当前文件目录
- * @param {string} importPath 相对路径如 './foo' 或 '../bar/baz'
- * @returns {string|null}
+ * @param fromDir 当前文件目录
+ * @param importPath 相对路径如 './foo' 或 '../bar/baz'
  */
 export function resolveImportPath(fromDir, importPath) {
     try {
@@ -35,11 +34,7 @@ export function resolveImportPath(fromDir, importPath) {
         return null;
     }
 }
-/**
- * 归一化文件路径（去扩展名，用于 import 比较）
- * @param {string} filePath
- * @returns {string}
- */
+/** 归一化文件路径（去扩展名，用于 import 比较） */
 export function normalizeFilePath(filePath) {
     return filePath.replace(/\.(js|ts|jsx|tsx|mjs|mts)$/, '').replace(/\/index$/, '');
 }
@@ -287,4 +282,3 @@ export function runCrossFileChecks(files, options = {}) {
     } // end isDisabled('swift-cross-file-extension-conflict')
     return violations;
 }
-//# sourceMappingURL=GuardCrossFileChecks.js.map

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

@@ -40,20 +40,15 @@ export declare class GuardFeedbackLoop {
     guardCheckEngine: GuardCheckEngineLike | null;
     logger: ReturnType<typeof Logger.getInstance>;
     violationsStore: ViolationsStoreLike | null;
-    /**
-     * @param {import('./ViolationsStore.js').ViolationsStore} violationsStore
-     * @param {import('../quality/FeedbackCollector.js').FeedbackCollector} feedbackCollector
-     * @param {object} [options]
-     * @param {import('./GuardCheckEngine.js').GuardCheckEngine} [options.guardCheckEngine] 用于查找规则
-     */
+    /** @param [options.guardCheckEngine] 用于查找规则 */
     constructor(violationsStore: ViolationsStoreLike | null, feedbackCollector: FeedbackCollectorLike | null, options?: {
         guardCheckEngine?: GuardCheckEngineLike;
     });
     /**
      * 对比当前和历史 violations，检测已修复的违规
      * @param {{ violations: Array<{ruleId: string}> }} currentResult 本次检查结果
-     * @param {string} filePath 文件路径
-     * @returns {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} 已修复且有 Recipe 关联的列表
+     * @param filePath 文件路径
+     * @returns >} 已修复且有 Recipe 关联的列表
      */
     detectFixedViolations(currentResult: CheckResult, filePath: string): FixedViolation[];
     /**
@@ -65,12 +60,11 @@ export declare class GuardFeedbackLoop {
      * 一站式处理：检测修复 + 自动确认
      * 供 MCP handler、GuardHandler、HTTP guard/file 端点集成调用
      * @param {{ violations: Array }} currentResult
-     * @param {string} filePath
      */
     processFixDetection(currentResult: CheckResult, filePath: string): FixedViolation[];
     /**
      * 获取闭环统计数据
-     * @returns {{ totalFixDetected: number, totalConfirmed: number }}
+     * @returns }
      */
     getStats(): {
         hasViolationsStore: boolean;
@@ -88,4 +82,3 @@ export declare class GuardFeedbackLoop {
     }[]): string | null;
 }
 export default GuardFeedbackLoop;
-//# sourceMappingURL=GuardFeedbackLoop.d.ts.map

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

@@ -12,12 +12,7 @@ export class GuardFeedbackLoop {
     guardCheckEngine;
     logger;
     violationsStore;
-    /**
-     * @param {import('./ViolationsStore.js').ViolationsStore} violationsStore
-     * @param {import('../quality/FeedbackCollector.js').FeedbackCollector} feedbackCollector
-     * @param {object} [options]
-     * @param {import('./GuardCheckEngine.js').GuardCheckEngine} [options.guardCheckEngine] 用于查找规则
-     */
+    /** @param [options.guardCheckEngine] 用于查找规则 */
     constructor(violationsStore, feedbackCollector, options = {}) {
         this.violationsStore = violationsStore;
         this.feedbackCollector = feedbackCollector;
@@ -27,8 +22,8 @@ export class GuardFeedbackLoop {
     /**
      * 对比当前和历史 violations，检测已修复的违规
      * @param {{ violations: Array<{ruleId: string}> }} currentResult 本次检查结果
-     * @param {string} filePath 文件路径
-     * @returns {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} 已修复且有 Recipe 关联的列表
+     * @param filePath 文件路径
+     * @returns >} 已修复且有 Recipe 关联的列表
      */
     detectFixedViolations(currentResult, filePath) {
         if (!this.violationsStore) {
@@ -87,7 +82,6 @@ export class GuardFeedbackLoop {
      * 一站式处理：检测修复 + 自动确认
      * 供 MCP handler、GuardHandler、HTTP guard/file 端点集成调用
      * @param {{ violations: Array }} currentResult
-     * @param {string} filePath
      */
     processFixDetection(currentResult, filePath) {
         const fixed = this.detectFixedViolations(currentResult, filePath);
@@ -99,7 +93,7 @@ export class GuardFeedbackLoop {
     }
     /**
      * 获取闭环统计数据
-     * @returns {{ totalFixDetected: number, totalConfirmed: number }}
+     * @returns }
      */
     getStats() {
         return {
@@ -138,4 +132,3 @@ export class GuardFeedbackLoop {
     }
 }
 export default GuardFeedbackLoop;
-//# sourceMappingURL=GuardFeedbackLoop.js.map

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

@@ -8,22 +8,14 @@
  * - buildCommentMask: 注释行掩码
  * - detectLanguage: 文件扩展名推断语言
  */
-/**
- * 编译正则模式（支持 RegExp 对象和 string，带缓存）
- * @param {RegExp|string} pattern
- * @returns {RegExp}
- */
+/** 编译正则模式（支持 RegExp 对象和 string，带缓存） */
 export declare function compilePattern(pattern: RegExp | string): any;
-/**
- * 清除正则缓存
- */
+/** 清除正则缓存 */
 export declare function clearPatternCache(): void;
 /**
  * 构建内联测试块掩码
  * 目前支持 Rust #[cfg(test)] mod xxx { ... } 块
- * @param {string[]} lines
- * @param {string} language
- * @returns {boolean[]} 每行是否在测试块内
+ * @returns 每行是否在测试块内
  */
 export declare function buildTestBlockMask(lines: string[], language: string): any[];
 /**
@@ -35,13 +27,8 @@ export declare function buildTestBlockMask(lines: string[], language: string): a
  *   /* ... * / 块注释  (C/Java/JS/TS/Go/Rust/Swift/Kotlin)
  *   \"\"\" ... \"\"\"  (Python doc-string — 简化: 整行以 \"\"\" 开头的行)
  *
- * @param {string[]} lines
- * @param {string} language
- * @returns {boolean[]} 每行是否为注释行
+ * @returns 每行是否为注释行
  */
 export declare function buildCommentMask(lines: string[], language: string): any[];
-/**
- * 从文件扩展名推断语言
- */
+/** 从文件扩展名推断语言 */
 export declare function detectLanguage(filePath: string): string;
-//# sourceMappingURL=GuardPatternUtils.d.ts.map