autosnippet 3.2.16 → 3.2.18

package/dist/lib/service/{cursor → delivery}/FileProtection.js

@@ -23,8 +23,8 @@ const SIGNATURE_PATTERN = /auto-generated by (?:\[)?autosnippet(?:\])?|autosnipp
 /**
  * 检查文件是否可以被 AutoSnippet 安全写入
  *
- * @param {string} filePath 目标文件绝对路径
- * @returns {{ canWrite: boolean, reason: string }}
+ * @param filePath 目标文件绝对路径
+ * @returns }
  *   - canWrite: true  → 可以安全写入
  *   - canWrite: false → 文件存在且非 AutoSnippet 生成，不应覆盖
  */
@@ -52,12 +52,11 @@ export function checkWriteSafety(filePath) {
 /**
  * 安全写入文件 — 带保护机制
  *
- * @param {string} filePath 目标文件绝对路径
- * @param {string} content 文件内容
- * @param {Object} [options]
- * @param {boolean} [options.force=false] 强制覆盖（忽略保护）
- * @param {Object} [options.logger] 日志器
- * @returns {{ written: boolean, reason: string, filePath: string }}
+ * @param filePath 目标文件绝对路径
+ * @param content 文件内容
+ * @param [options.force=false] 强制覆盖（忽略保护）
+ * @param [options.logger] 日志器
+ * @returns }
  */
 export function safeWriteFile(filePath, content, options = {}) {
     const { force = false, logger } = options;
@@ -77,12 +76,11 @@ export function safeWriteFile(filePath, content, options = {}) {
 /**
  * 安全复制文件 — 带保护机制
  *
- * @param {string} srcPath 源文件路径
- * @param {string} destPath 目标文件路径
- * @param {Object} [options]
- * @param {boolean} [options.force=false] 强制覆盖
- * @param {Object} [options.logger] 日志器
- * @returns {{ written: boolean, reason: string, filePath: string }}
+ * @param srcPath 源文件路径
+ * @param destPath 目标文件路径
+ * @param [options.force=false] 强制覆盖
+ * @param [options.logger] 日志器
+ * @returns }
  */
 export function safeCopyFile(srcPath, destPath, options = {}) {
     const { force = false, logger } = options;
@@ -98,4 +96,3 @@ export function safeCopyFile(srcPath, destPath, options = {}) {
     logger?.info?.(`[FileProtection] Skipped "${destPath}" — ${reason} (file exists and is not AutoSnippet-generated)`);
     return { written: false, reason, filePath: destPath };
 }
-//# sourceMappingURL=FileProtection.js.map

package/dist/lib/service/{cursor → delivery}/KnowledgeCompressor.d.ts

@@ -20,14 +20,13 @@ export declare class KnowledgeCompressor {
      * 多语言项目中增加 [language] 前缀，帮助 Agent 判断规则适用性。
      * scope='universal' 或无 language 的规则不加前缀。
      *
-     * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='rule')
-     * @returns {Array<string>}
+     * @param entries KnowledgeEntry 数组 (kind='rule')
      */
     compressToRuleLine(entries: KnowledgeEntryProps[]): string[];
     /**
      * Channel B — When/Do/Don't/Why + Template（骨架化）
-     * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='pattern')
-     * @returns {Array<{ trigger: string, when: string, do: string, dont: string, why: string, template: string }>}
+     * @param entries KnowledgeEntry 数组 (kind='pattern')
+     * @returns >}
      */
     compressToWhenDoDont(entries: KnowledgeEntryProps[]): {
         trigger: string;
@@ -39,9 +38,8 @@ export declare class KnowledgeCompressor {
     }[];
     /**
      * 将 When/Do/Don't/Why 结果格式化为 Markdown 字符串
-     * @param {Array<Object>} compressed - compressToWhenDoDont 输出
-     * @param {string} [language=''] 代码围栏语言标识
-     * @returns {string}
+     * @param compressed compressToWhenDoDont 输出
+     * @param [language=''] 代码围栏语言标识
      */
     formatWhenDoDont(compressed: Array<{
         trigger: string;
@@ -58,8 +56,8 @@ export declare class KnowledgeCompressor {
      * 采用 "Know: {title} — {description}" 的简洁格式，
      * 让 Agent 获取项目事实性知识（技术选型、架构决策等）。
      *
-     * @param {Array<Object>} facts - KnowledgeEntry 数组 (kind='fact')
-     * @returns {Array<{ title: string, summary: string }>}
+     * @param facts KnowledgeEntry 数组 (kind='fact')
+     * @returns >}
      */
     compressToFactLines(facts: KnowledgeEntryProps[]): {
         title: string;
@@ -68,7 +66,6 @@ export declare class KnowledgeCompressor {
     /**
      * 将 Fact 压缩结果格式化为 Markdown 字符串
      * @param {Array<{ title: string, summary: string }>} factLines
-     * @returns {string}
      */
     formatFactLines(factLines: Array<{
         title: string;
@@ -76,4 +73,3 @@ export declare class KnowledgeCompressor {
     }>): string;
 }
 export default KnowledgeCompressor;
-//# sourceMappingURL=KnowledgeCompressor.d.ts.map

package/dist/lib/service/{cursor → delivery}/KnowledgeCompressor.js

@@ -39,8 +39,7 @@ export class KnowledgeCompressor {
      * 多语言项目中增加 [language] 前缀，帮助 Agent 判断规则适用性。
      * scope='universal' 或无 language 的规则不加前缀。
      *
-     * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='rule')
-     * @returns {Array<string>}
+     * @param entries KnowledgeEntry 数组 (kind='rule')
      */
     compressToRuleLine(entries) {
         return entries
@@ -62,8 +61,8 @@ export class KnowledgeCompressor {
     }
     /**
      * Channel B — When/Do/Don't/Why + Template（骨架化）
-     * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='pattern')
-     * @returns {Array<{ trigger: string, when: string, do: string, dont: string, why: string, template: string }>}
+     * @param entries KnowledgeEntry 数组 (kind='pattern')
+     * @returns >}
      */
     compressToWhenDoDont(entries) {
         const seen = new Set();
@@ -96,9 +95,8 @@ export class KnowledgeCompressor {
     }
     /**
      * 将 When/Do/Don't/Why 结果格式化为 Markdown 字符串
-     * @param {Array<Object>} compressed - compressToWhenDoDont 输出
-     * @param {string} [language=''] 代码围栏语言标识
-     * @returns {string}
+     * @param compressed compressToWhenDoDont 输出
+     * @param [language=''] 代码围栏语言标识
      */
     formatWhenDoDont(compressed, language = '') {
         const lang = language || '';
@@ -131,8 +129,8 @@ export class KnowledgeCompressor {
      * 采用 "Know: {title} — {description}" 的简洁格式，
      * 让 Agent 获取项目事实性知识（技术选型、架构决策等）。
      *
-     * @param {Array<Object>} facts - KnowledgeEntry 数组 (kind='fact')
-     * @returns {Array<{ title: string, summary: string }>}
+     * @param facts KnowledgeEntry 数组 (kind='fact')
+     * @returns >}
      */
     compressToFactLines(facts) {
         return facts
@@ -147,7 +145,6 @@ export class KnowledgeCompressor {
     /**
      * 将 Fact 压缩结果格式化为 Markdown 字符串
      * @param {Array<{ title: string, summary: string }>} factLines
-     * @returns {string}
      */
     formatFactLines(factLines) {
         if (factLines.length === 0) {
@@ -166,4 +163,3 @@ export class KnowledgeCompressor {
     }
 }
 export default KnowledgeCompressor;
-//# sourceMappingURL=KnowledgeCompressor.js.map

package/dist/lib/service/{cursor → delivery}/RulesGenerator.d.ts

@@ -10,15 +10,15 @@ export declare class RulesGenerator {
     projectRoot: string;
     rulesDir: string;
     /**
-     * @param {string} projectRoot 用户项目根目录
-     * @param {string} projectName 项目名称（用于 description/标题）
+     * @param projectRoot 用户项目根目录
+     * @param projectName 项目名称（用于 description/标题）
      */
     constructor(projectRoot: string, projectName?: string);
     /**
      * Channel A — 写入 Always-On Rules 文件
      *
-     * @param {string[]} ruleLines 一行式规则列表 (来自 KnowledgeCompressor.compressToRuleLine)
-     * @returns {{ filePath: string, tokensUsed: number, rulesCount: number }}
+     * @param ruleLines 一行式规则列表 (来自 KnowledgeCompressor.compressToRuleLine)
+     * @returns }
      */
     writeAlwaysOnRules(ruleLines: string[]): {
         filePath: string;
@@ -28,10 +28,10 @@ export declare class RulesGenerator {
     /**
      * Channel B — 写入 Smart Rules 文件（按主题）
      *
-     * @param {string} topic 主题名 (networking, ui, data, architecture, conventions, general)
-     * @param {string} compressedContent 格式化后的 When/Do/Don't Markdown 内容
-     * @param {string} description - Agent 关联性判断用 description
-     * @returns {{ filePath: string, tokensUsed: number }}
+     * @param topic 主题名 (networking, ui, data, architecture, conventions, general)
+     * @param compressedContent 格式化后的 When/Do/Don't Markdown 内容
+     * @param description Agent 关联性判断用 description
+     * @returns }
      */
     writeSmartRules(topic: string, compressedContent: string, description: string): {
         filePath: string;
@@ -42,18 +42,11 @@ export declare class RulesGenerator {
      * 保留静态模板文件（autosnippet-conventions.mdc, autosnippet-skills.mdc）
      */
     cleanDynamicFiles(): void;
-    /**
-     * @private
-     */
+    /** @private */
     _renderChannelA(ruleLines: string[]): string;
-    /**
-     * @private
-     */
+    /** @private */
     _renderChannelB(topic: string, body: string, description: string): string;
-    /**
-     * @private
-     */
+    /** @private */
     _ensureDir(): void;
 }
 export default RulesGenerator;
-//# sourceMappingURL=RulesGenerator.d.ts.map

package/dist/lib/service/{cursor → delivery}/RulesGenerator.js

@@ -13,8 +13,8 @@ export class RulesGenerator {
     projectRoot;
     rulesDir;
     /**
-     * @param {string} projectRoot 用户项目根目录
-     * @param {string} projectName 项目名称（用于 description/标题）
+     * @param projectRoot 用户项目根目录
+     * @param projectName 项目名称（用于 description/标题）
      */
     constructor(projectRoot, projectName = 'Project') {
         this.projectRoot = projectRoot;
@@ -24,8 +24,8 @@ export class RulesGenerator {
     /**
      * Channel A — 写入 Always-On Rules 文件
      *
-     * @param {string[]} ruleLines 一行式规则列表 (来自 KnowledgeCompressor.compressToRuleLine)
-     * @returns {{ filePath: string, tokensUsed: number, rulesCount: number }}
+     * @param ruleLines 一行式规则列表 (来自 KnowledgeCompressor.compressToRuleLine)
+     * @returns }
      */
     writeAlwaysOnRules(ruleLines) {
         this._ensureDir();
@@ -53,10 +53,10 @@ export class RulesGenerator {
     /**
      * Channel B — 写入 Smart Rules 文件（按主题）
      *
-     * @param {string} topic 主题名 (networking, ui, data, architecture, conventions, general)
-     * @param {string} compressedContent 格式化后的 When/Do/Don't Markdown 内容
-     * @param {string} description - Agent 关联性判断用 description
-     * @returns {{ filePath: string, tokensUsed: number }}
+     * @param topic 主题名 (networking, ui, data, architecture, conventions, general)
+     * @param compressedContent 格式化后的 When/Do/Don't Markdown 内容
+     * @param description Agent 关联性判断用 description
+     * @returns }
      */
     writeSmartRules(topic, compressedContent, description) {
         this._ensureDir();
@@ -108,9 +108,7 @@ export class RulesGenerator {
         }
     }
     // ─── 渲染方法 ───────────────────────────────────────
-    /**
-     * @private
-     */
+    /** @private */
     _renderChannelA(ruleLines) {
         const desc = `${this.projectName} mandatory rules — coding constraints that must never be violated. Auto-generated by AutoSnippet.`;
         const lines = [
@@ -129,9 +127,7 @@ export class RulesGenerator {
         ];
         return `${lines.join('\n')}\n`;
     }
-    /**
-     * @private
-     */
+    /** @private */
     _renderChannelB(topic, body, description) {
         const topicLabel = topic.charAt(0).toUpperCase() + topic.slice(1);
         const lines = [
@@ -148,9 +144,7 @@ export class RulesGenerator {
         ];
         return `${lines.join('\n')}\n`;
     }
-    /**
-     * @private
-     */
+    /** @private */
     _ensureDir() {
         if (!fs.existsSync(this.rulesDir)) {
             fs.mkdirSync(this.rulesDir, { recursive: true });
@@ -158,4 +152,3 @@ export class RulesGenerator {
     }
 }
 export default RulesGenerator;
-//# sourceMappingURL=RulesGenerator.js.map

package/dist/lib/service/{cursor → delivery}/SkillsSyncer.d.ts

@@ -18,9 +18,9 @@ export declare class SkillsSyncer {
     sourceDir: string;
     targetDir: string;
     /**
-     * @param {string} projectRoot 用户项目根目录
-     * @param {string} projectName 项目名称
-     * @param {Object} [knowledgeService] 可选，用于生成 references/RECIPES.md
+     * @param projectRoot 用户项目根目录
+     * @param projectName 项目名称
+     * @param [knowledgeService] 可选，用于生成 references/RECIPES.md
      */
     constructor(projectRoot: string, projectName?: string, knowledgeService?: {
         list: (filter: Record<string, unknown>, pagination: {
@@ -30,7 +30,7 @@ export declare class SkillsSyncer {
     } | null);
     /**
      * 执行完整同步流程
-     * @returns {Promise<{ synced: string[], skipped: string[], errors: string[] }>}
+     * @returns >}
      */
     sync(): Promise<{
         synced: string[];
@@ -52,10 +52,7 @@ export declare class SkillsSyncer {
      * @private
      */
     _generateUseCases(sourceDirName: string): string[];
-    /**
-     * @private
-     */
+    /** @private */
     _capitalizeWords(str: string): string;
 }
 export default SkillsSyncer;
-//# sourceMappingURL=SkillsSyncer.d.ts.map

package/dist/lib/service/{cursor → delivery}/SkillsSyncer.js

@@ -30,9 +30,7 @@ const SKILL_NAME_MAP = {
     'project-python-structure': 'autosnippet-python-structure',
     'project-jvm-annotations': 'autosnippet-jvm-annotations',
 };
-/**
- * 用途描述模板（英文，Cursor 优先）
- */
+/** 用途描述模板（英文，Cursor 优先） */
 const SKILL_DESC_MAP = {
     'autosnippet-architecture': 'Architecture patterns, module boundaries, and dependency rules for {project}. Use when creating new modules, reviewing architecture, or understanding dependencies.',
     'autosnippet-code-standard': 'Coding standards and style conventions for {project}. Use when writing new code, reviewing formatting, or enforcing naming conventions.',
@@ -56,9 +54,9 @@ export class SkillsSyncer {
     sourceDir;
     targetDir;
     /**
-     * @param {string} projectRoot 用户项目根目录
-     * @param {string} projectName 项目名称
-     * @param {Object} [knowledgeService] 可选，用于生成 references/RECIPES.md
+     * @param projectRoot 用户项目根目录
+     * @param projectName 项目名称
+     * @param [knowledgeService] 可选，用于生成 references/RECIPES.md
      */
     constructor(projectRoot, projectName = 'Project', knowledgeService = null) {
         this.projectRoot = projectRoot;
@@ -69,7 +67,7 @@ export class SkillsSyncer {
     }
     /**
      * 执行完整同步流程
-     * @returns {Promise<{ synced: string[], skipped: string[], errors: string[] }>}
+     * @returns >}
      */
     async sync() {
         const result = { synced: [], skipped: [], errors: [] };
@@ -277,12 +275,9 @@ export class SkillsSyncer {
             '- Need guidance on project-specific patterns',
         ]);
     }
-    /**
-     * @private
-     */
+    /** @private */
     _capitalizeWords(str) {
         return str.replace(/\b\w/g, (c) => c.toUpperCase());
     }
 }
 export default SkillsSyncer;
-//# sourceMappingURL=SkillsSyncer.js.map

package/dist/lib/service/{cursor → delivery}/TokenBudget.d.ts

@@ -15,13 +15,12 @@ export declare const BUDGET: {
 };
 /**
  * 按 token 预算截断内容行
- * @param {string[]} lines 内容行
- * @param {number} budget - token 上限
- * @returns {{ kept: string[], dropped: number, tokensUsed: number }}
+ * @param lines 内容行
+ * @param budget token 上限
+ * @returns }
  */
 export declare function truncateToTokenBudget(lines: string[], budget: number): {
     kept: string[];
     dropped: number;
     tokensUsed: number;
 };
-//# sourceMappingURL=TokenBudget.d.ts.map

package/dist/lib/service/{cursor → delivery}/TokenBudget.js

@@ -15,9 +15,9 @@ export const BUDGET = {
 };
 /**
  * 按 token 预算截断内容行
- * @param {string[]} lines 内容行
- * @param {number} budget - token 上限
- * @returns {{ kept: string[], dropped: number, tokensUsed: number }}
+ * @param lines 内容行
+ * @param budget token 上限
+ * @returns }
  */
 export function truncateToTokenBudget(lines, budget) {
     const kept = [];
@@ -35,4 +35,3 @@ export function truncateToTokenBudget(lines, budget) {
     }
     return { kept, dropped, tokensUsed };
 }
-//# sourceMappingURL=TokenBudget.js.map

package/dist/lib/service/{cursor → delivery}/TopicClassifier.d.ts

@@ -7,14 +7,12 @@
 import type { KnowledgeEntryProps } from '../../domain/knowledge/KnowledgeEntry.js';
 export declare class TopicClassifier {
     projectName: string;
-    /**
-     * @param {string} projectName 项目名称
-     */
+    /** @param projectName 项目名称 */
     constructor(projectName?: string);
     /**
      * 将 patterns 按主题分组
-     * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='pattern')
-     * @returns {Object<string, Array<Object>>} { topic: [entries] }
+     * @param entries KnowledgeEntry 数组 (kind='pattern')
+     * @returns { topic: [entries] }
      */
     group(entries: KnowledgeEntryProps[]): Record<string, KnowledgeEntryProps[]>;
     /**
@@ -23,10 +21,6 @@ export declare class TopicClassifier {
      * v3: 动态丰富化 — 除硬编码 baseKeywords 外，还从 entries 的
      * tags, whenClause, trigger 中提取高价值关键词，让 Cursor 的
      * description 匹配更精准。
-     *
-     * @param {string} topic
-     * @param {Array<Object>} entries
-     * @returns {string}
      */
     buildDescription(topic: string, entries: KnowledgeEntryProps[]): string;
     /**
@@ -39,10 +33,7 @@ export declare class TopicClassifier {
      * @private
      */
     _extractKeywords(entry: KnowledgeEntryProps): string[];
-    /**
-     * @private
-     */
+    /** @private */
     _topicLabel(topic: string): string;
 }
 export default TopicClassifier;
-//# sourceMappingURL=TopicClassifier.d.ts.map

package/dist/lib/service/{cursor → delivery}/TopicClassifier.js

@@ -34,16 +34,14 @@ const TOPIC_MAP = {
 };
 export class TopicClassifier {
     projectName;
-    /**
-     * @param {string} projectName 项目名称
-     */
+    /** @param projectName 项目名称 */
     constructor(projectName = 'Project') {
         this.projectName = projectName;
     }
     /**
      * 将 patterns 按主题分组
-     * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='pattern')
-     * @returns {Object<string, Array<Object>>} { topic: [entries] }
+     * @param entries KnowledgeEntry 数组 (kind='pattern')
+     * @returns { topic: [entries] }
      */
     group(entries) {
         const grouped = {};
@@ -72,10 +70,6 @@ export class TopicClassifier {
      * v3: 动态丰富化 — 除硬编码 baseKeywords 外，还从 entries 的
      * tags, whenClause, trigger 中提取高价值关键词，让 Cursor 的
      * description 匹配更精准。
-     *
-     * @param {string} topic
-     * @param {Array<Object>} entries
-     * @returns {string}
      */
     buildDescription(topic, entries) {
         const topicDef = TOPIC_MAP[topic];
@@ -121,9 +115,7 @@ export class TopicClassifier {
         const filtered = words.map((w) => w.toLowerCase()).filter((w) => !STOP_WORDS.has(w));
         return [...new Set(filtered)].slice(0, 5);
     }
-    /**
-     * @private
-     */
+    /** @private */
     _topicLabel(topic) {
         const labels = {
             networking: 'Networking',
@@ -136,7 +128,6 @@ export class TopicClassifier {
         return (labels[topic] || topic.charAt(0).toUpperCase() + topic.slice(1));
     }
 }
-/** @type {Set<string>} */
 const STOP_WORDS = new Set([
     'the',
     'and',
@@ -173,4 +164,3 @@ const STOP_WORDS = new Set([
     'bootstrap',
 ]);
 export default TopicClassifier;
-//# sourceMappingURL=TopicClassifier.js.map

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

@@ -90,21 +90,13 @@ export declare class ComplianceReporter {
     qualityGateConfig: Required<QualityGateThresholds>;
     ruleLearner: RuleLearnerLike | null;
     violationsStore: ViolationsStoreLike | null;
-    /**
-     * @param {import('./GuardCheckEngine.js').GuardCheckEngine} guardCheckEngine
-     * @param {import('./ViolationsStore.js').ViolationsStore} violationsStore
-     * @param {import('./RuleLearner.js').RuleLearner} ruleLearner
-     * @param {import('./ExclusionManager.js').ExclusionManager} exclusionManager
-     * @param {object} qualityGateConfig - { maxErrors, maxWarnings, minScore }
-     */
+    /** @param qualityGateConfig { maxErrors, maxWarnings, minScore } */
     constructor(guardCheckEngine: GuardCheckEngineLike, violationsStore: ViolationsStoreLike | null, ruleLearner: RuleLearnerLike | null, exclusionManager: ExclusionManagerLike | null, qualityGateConfig?: QualityGateThresholds);
     /**
      * 生成全项目合规报告
-     * @param {string} projectRoot 项目根目录
-     * @param {object} options
-     * @param {object} [options.qualityGate] 覆盖默认的 Quality Gate 阈值
-     * @param {number} [options.maxFiles] 最大扫描文件数
-     * @returns {Promise<ComplianceReport>}
+     * @param projectRoot 项目根目录
+     * @param [options.qualityGate] 覆盖默认的 Quality Gate 阈值
+     * @param [options.maxFiles] 最大扫描文件数
      */
     generate(projectRoot: string, options?: {
         qualityGate?: QualityGateThresholds;
@@ -143,8 +135,8 @@ export declare class ComplianceReporter {
     }>;
     /**
      * 终端格式化输出报告
-     * @param {object} report - generate() 产出的报告
-     * @param {object} options - { format: 'text' | 'markdown' | 'json' }
+     * @param report generate() 产出的报告
+     * @param options { format: 'text' | 'markdown' | 'json' }
      */
     printReport(report: Record<string, unknown>, options?: {
         format?: string;
@@ -153,4 +145,3 @@ export declare class ComplianceReporter {
     _printMarkdown(report: Record<string, unknown>): void;
 }
 export default ComplianceReporter;
-//# sourceMappingURL=ComplianceReporter.d.ts.map

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

@@ -14,9 +14,7 @@
 import Logger from '../../infrastructure/logging/Logger.js';
 import { COMPLIANCE_SCORING, QUALITY_GATE } from '../../shared/constants.js';
 import { collectSourceFilesWithContent } from './SourceFileCollector.js';
-/**
- * Quality Gate 评分算法
- */
+/** Quality Gate 评分算法 */
 function computeScore(summary, ruleHealth = []) {
     let score = 100;
     // 扣分：每个 error/warning/info 按常量权重扣分
@@ -35,9 +33,7 @@ function computeScore(summary, ruleHealth = []) {
     score -= problematic.length * COMPLIANCE_SCORING.PROBLEMATIC_RULE_PENALTY;
     return Math.max(0, Math.min(100, Math.round(score)));
 }
-/**
- * 判定 Quality Gate 状态
- */
+/** 判定 Quality Gate 状态 */
 function evaluateGate(summary, score, thresholds) {
     const { maxErrors = QUALITY_GATE.MAX_ERRORS, maxWarnings = QUALITY_GATE.MAX_WARNINGS, minScore = QUALITY_GATE.MIN_SCORE, } = thresholds;
     if (summary.errors > maxErrors) {
@@ -58,13 +54,7 @@ export class ComplianceReporter {
     qualityGateConfig;
     ruleLearner;
     violationsStore;
-    /**
-     * @param {import('./GuardCheckEngine.js').GuardCheckEngine} guardCheckEngine
-     * @param {import('./ViolationsStore.js').ViolationsStore} violationsStore
-     * @param {import('./RuleLearner.js').RuleLearner} ruleLearner
-     * @param {import('./ExclusionManager.js').ExclusionManager} exclusionManager
-     * @param {object} qualityGateConfig - { maxErrors, maxWarnings, minScore }
-     */
+    /** @param qualityGateConfig { maxErrors, maxWarnings, minScore } */
     constructor(guardCheckEngine, violationsStore, ruleLearner, exclusionManager, qualityGateConfig = {}) {
         this.engine = guardCheckEngine;
         this.violationsStore = violationsStore;
@@ -80,11 +70,9 @@ export class ComplianceReporter {
     }
     /**
      * 生成全项目合规报告
-     * @param {string} projectRoot 项目根目录
-     * @param {object} options
-     * @param {object} [options.qualityGate] 覆盖默认的 Quality Gate 阈值
-     * @param {number} [options.maxFiles] 最大扫描文件数
-     * @returns {Promise<ComplianceReport>}
+     * @param projectRoot 项目根目录
+     * @param [options.qualityGate] 覆盖默认的 Quality Gate 阈值
+     * @param [options.maxFiles] 最大扫描文件数
      */
     async generate(projectRoot, options = {}) {
         const thresholds = { ...this.qualityGateConfig, ...(options.qualityGate || {}) };
@@ -230,8 +218,8 @@ export class ComplianceReporter {
     }
     /**
      * 终端格式化输出报告
-     * @param {object} report - generate() 产出的报告
-     * @param {object} options - { format: 'text' | 'markdown' | 'json' }
+     * @param report generate() 产出的报告
+     * @param options { format: 'text' | 'markdown' | 'json' }
      */
     printReport(report, options = {}) {
         const { format = 'text' } = options;
@@ -314,4 +302,3 @@ export class ComplianceReporter {
     }
 }
 export default ComplianceReporter;
-//# sourceMappingURL=ComplianceReporter.js.map