autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/cursor/TopicClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopicClassifier.d.ts","sourceRoot":"","sources":["../../../../lib/service/cursor/TopicClassifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAoCpF,qBAAa,eAAe;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;gBACS,WAAW,SAAY;IAInC;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE;IAwBpC;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE;IAgC9D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB;IAIzC;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,mBAAmB;IAQ3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM;CAa1B;AAuCD,eAAe,eAAe,CAAC"}

package/dist/lib/service/cursor/TopicClassifier.js

@@ -0,0 +1,176 @@
+/**
+ * TopicClassifier — 按主题分组 KnowledgeEntry
+ *
+ * 将 kind='pattern' 的知识条目按主题分组，用于 Channel B（Smart Rules）。
+ * 每个主题对应一个 .mdc 文件，设 alwaysApply: false + 丰富的 description。
+ */
+/**
+ * 主题定义
+ * - dimensions: 关联的 bootstrap 维度
+ * - keywords: 用于匹配 entry 分类的关键词
+ * - descriptionKeywords: 用于 .mdc description 字段的关键词（Agent 关联性判断依据）
+ */
+const TOPIC_MAP = {
+    networking: {
+        dimensions: ['event-and-data-flow'],
+        descriptionKeywords: 'network, HTTP, API, request, response, URL, fetch, socket, REST, download, upload, error handling, retry, timeout',
+    },
+    ui: {
+        dimensions: ['code-pattern'],
+        descriptionKeywords: 'view, controller, UI, layout, animation, cell, table, collection, button, scroll, navigation, auto layout, gesture, storyboard',
+    },
+    data: {
+        dimensions: ['code-pattern', 'architecture'],
+        descriptionKeywords: 'model, storage, database, cache, CoreData, Realm, SQLite, keychain, UserDefaults, JSON, parsing, serialization, persistence',
+    },
+    architecture: {
+        dimensions: ['architecture', 'best-practice'],
+        descriptionKeywords: 'singleton, delegate, factory, observer, protocol, manager, service, dependency injection, module, MVVM, MVC, coordinator, router, design pattern',
+    },
+    conventions: {
+        dimensions: ['code-standard'],
+        descriptionKeywords: 'naming, format, style, import, header, prefix, convention, documentation, file organization, constants, enum, typedef, pragma mark',
+    },
+};
+export class TopicClassifier {
+    projectName;
+    /**
+     * @param {string} projectName 项目名称
+     */
+    constructor(projectName = 'Project') {
+        this.projectName = projectName;
+    }
+    /**
+     * 将 patterns 按主题分组
+     * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='pattern')
+     * @returns {Object<string, Array<Object>>} { topic: [entries] }
+     */
+    group(entries) {
+        const grouped = {};
+        const unmatched = [];
+        for (const entry of entries) {
+            const topic = this._classifyEntry(entry);
+            if (topic) {
+                if (!grouped[topic]) {
+                    grouped[topic] = [];
+                }
+                grouped[topic].push(entry);
+            }
+            else {
+                unmatched.push(entry);
+            }
+        }
+        // 未匹配的归入 'general' — 但只在有内容时
+        if (unmatched.length > 0) {
+            grouped.general = unmatched;
+        }
+        return grouped;
+    }
+    /**
+     * 为主题构建 description — Agent 判断关联性的唯一依据
+     *
+     * 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];
+        const baseKeywords = topicDef
+            ? topicDef.descriptionKeywords
+            : entries
+                .map((e) => e.title || '')
+                .filter(Boolean)
+                .join(', ');
+        // 从 entries 提取动态关键词（tags + whenClause + title/description）
+        const entryKeywords = entries
+            .flatMap((e) => this._extractKeywords(e))
+            .filter(Boolean);
+        // 从 tags 直接提取（tags 本身就是高质量关键词）
+        const tagKeywords = entries
+            .flatMap((e) => e.tags || [])
+            .map((t) => t.toLowerCase())
+            .filter((t) => t.length >= 2 && !STOP_WORDS.has(t));
+        // 从 whenClause 提取（包含触发场景信息）
+        const whenKeywords = entries
+            .flatMap((e) => (e.whenClause || '').match(/[a-zA-Z]{3,}/g) || [])
+            .map((w) => w.toLowerCase())
+            .filter((w) => !STOP_WORDS.has(w));
+        const allExtra = [...new Set([...tagKeywords, ...whenKeywords, ...entryKeywords])].slice(0, 15);
+        const extra = allExtra.length > 0 ? `, ${allExtra.join(', ')}` : '';
+        return `${this._topicLabel(topic)} patterns for ${this.projectName} — ${baseKeywords}${extra}. Use when writing or reviewing ${this._topicLabel(topic).toLowerCase()}-related code.`;
+    }
+    /**
+     * 分类单个 entry 到主题 — 直读 AI 预计算的 topicHint
+     * @private
+     */
+    _classifyEntry(entry) {
+        return entry.topicHint || null; // AI 没给 → null → 归入 general
+    }
+    /**
+     * 从 entry 提取关键词
+     * @private
+     */
+    _extractKeywords(entry) {
+        const text = `${entry.title || ''} ${entry.description || ''}`;
+        // 提取英文关键词（3+ 字母）
+        const words = text.match(/[a-zA-Z]{3,}/g) || [];
+        const filtered = words.map((w) => w.toLowerCase()).filter((w) => !STOP_WORDS.has(w));
+        return [...new Set(filtered)].slice(0, 5);
+    }
+    /**
+     * @private
+     */
+    _topicLabel(topic) {
+        const labels = {
+            networking: 'Networking',
+            ui: 'UI',
+            data: 'Data',
+            architecture: 'Architecture',
+            conventions: 'Conventions',
+            general: 'General',
+        };
+        return (labels[topic] || topic.charAt(0).toUpperCase() + topic.slice(1));
+    }
+}
+/** @type {Set<string>} */
+const STOP_WORDS = new Set([
+    'the',
+    'and',
+    'for',
+    'this',
+    'that',
+    'with',
+    'from',
+    'use',
+    'using',
+    'when',
+    'not',
+    'all',
+    'are',
+    'has',
+    'have',
+    'been',
+    'will',
+    'can',
+    'should',
+    'must',
+    'may',
+    'each',
+    'which',
+    'their',
+    'your',
+    'its',
+    'project',
+    'code',
+    'file',
+    'class',
+    'method',
+    'function',
+    'bootstrap',
+]);
+export default TopicClassifier;
+//# sourceMappingURL=TopicClassifier.js.map

package/dist/lib/service/cursor/TopicClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopicClassifier.js","sourceRoot":"","sources":["../../../../lib/service/cursor/TopicClassifier.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,156 @@
+/**
+ * ComplianceReporter — 全项目 Guard 合规报告生成
+ *
+ * 依赖:
+ *   - GuardCheckEngine.auditFiles() — 原始 violations 数据
+ *   - ViolationsStore — 历史统计 & 趋势
+ *   - RuleLearner — 规则 P/R/F1
+ *   - ExclusionManager — 排除项（不计入合规分）
+ *   - config.qualityGate — 阈值配置
+ *
+ * 输出:
+ *   ComplianceReport { qualityGate, summary, topViolations, fileHotspots, ruleHealth, trend }
+ */
+import Logger from '../../infrastructure/logging/Logger.js';
+interface ViolationSummary {
+    errors: number;
+    warnings: number;
+    infos?: number;
+    total?: number;
+    filesScanned?: number;
+    totalViolations?: number;
+}
+interface RuleHealthEntry {
+    ruleId: string;
+    precision: number;
+    recall: number;
+    f1: number;
+    triggers: number;
+    warning: string | null;
+}
+interface QualityGateThresholds {
+    maxErrors?: number;
+    maxWarnings?: number;
+    minScore?: number;
+}
+interface GuardCheckEngineLike {
+    auditFiles(files: {
+        path: string;
+        content: string;
+    }[], options: {
+        scope: string;
+    }): {
+        files: {
+            filePath: string;
+            violations: ViolationItem[];
+            summary: ViolationSummary;
+        }[];
+        crossFileViolations: ViolationItem[];
+    };
+}
+interface ViolationItem {
+    ruleId: string;
+    severity: string;
+    message: string;
+    line?: number;
+    snippet?: string;
+    fixSuggestion?: string;
+    filePath?: string;
+}
+interface ViolationsStoreLike {
+    appendRun(run: {
+        filePath: string;
+        violations: ViolationItem[];
+        summary: string;
+    }): string;
+    getTrend(): {
+        errorsChange: number;
+        warningsChange: number;
+        hasHistory: boolean;
+    };
+}
+interface RuleLearnerLike {
+    getAllStats(): Record<string, {
+        triggers: number;
+        metrics?: {
+            precision?: number;
+            recall?: number;
+            f1?: number;
+        };
+    }>;
+}
+interface ExclusionManagerLike {
+    isPathExcluded?(filePath: string): boolean;
+    isRuleExcluded?(ruleId: string, filePath: string): boolean;
+}
+export declare class ComplianceReporter {
+    engine: GuardCheckEngineLike;
+    exclusionManager: ExclusionManagerLike | null;
+    logger: ReturnType<typeof Logger.getInstance>;
+    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 }
+     */
+    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>}
+     */
+    generate(projectRoot: string, options?: {
+        qualityGate?: QualityGateThresholds;
+        maxFiles?: number;
+    }): Promise<{
+        timestamp: string;
+        projectRoot: string;
+        qualityGate: {
+            status: string;
+            score: number;
+            thresholds: {
+                maxErrors: number;
+                maxWarnings: number;
+                minScore: number;
+            };
+        };
+        summary: {
+            filesScanned: number;
+            totalViolations: number;
+            errors: number;
+            warnings: number;
+            infos: number;
+        };
+        topViolations: any[];
+        fileHotspots: {
+            filePath: string;
+            violationCount: number;
+            errorCount: number;
+        }[];
+        ruleHealth: RuleHealthEntry[];
+        trend: {
+            errorsChange: number;
+            warningsChange: number;
+            hasHistory: boolean;
+        };
+    }>;
+    /**
+     * 终端格式化输出报告
+     * @param {object} report - generate() 产出的报告
+     * @param {object} options - { format: 'text' | 'markdown' | 'json' }
+     */
+    printReport(report: Record<string, unknown>, options?: {
+        format?: string;
+    }): void;
+    _printText(report: Record<string, unknown>): void;
+    _printMarkdown(report: Record<string, unknown>): void;
+}
+export default ComplianceReporter;
+//# sourceMappingURL=ComplianceReporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComplianceReporter.d.ts","sourceRoot":"","sources":["../../../../lib/service/guard/ComplianceReporter.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,317 @@
+/**
+ * ComplianceReporter — 全项目 Guard 合规报告生成
+ *
+ * 依赖:
+ *   - GuardCheckEngine.auditFiles() — 原始 violations 数据
+ *   - ViolationsStore — 历史统计 & 趋势
+ *   - RuleLearner — 规则 P/R/F1
+ *   - ExclusionManager — 排除项（不计入合规分）
+ *   - config.qualityGate — 阈值配置
+ *
+ * 输出:
+ *   ComplianceReport { qualityGate, summary, topViolations, fileHotspots, ruleHealth, trend }
+ */
+import Logger from '../../infrastructure/logging/Logger.js';
+import { COMPLIANCE_SCORING, QUALITY_GATE } from '../../shared/constants.js';
+import { collectSourceFilesWithContent } from './SourceFileCollector.js';
+/**
+ * Quality Gate 评分算法
+ */
+function computeScore(summary, ruleHealth = []) {
+    let score = 100;
+    // 扣分：每个 error/warning/info 按常量权重扣分
+    score -= summary.errors * COMPLIANCE_SCORING.ERROR_PENALTY;
+    score -= summary.warnings * COMPLIANCE_SCORING.WARNING_PENALTY;
+    score -= (summary.infos || 0) * COMPLIANCE_SCORING.INFO_PENALTY;
+    // 加分：规则平均 F1 > 阈值加分
+    if (ruleHealth.length > 0) {
+        const avgF1 = ruleHealth.reduce((s, r) => s + (r.f1 || 0), 0) / ruleHealth.length;
+        if (avgF1 > COMPLIANCE_SCORING.HIGH_F1_THRESHOLD) {
+            score += COMPLIANCE_SCORING.HIGH_F1_BONUS;
+        }
+    }
+    // 扣分：高误报规则每条扣分
+    const problematic = ruleHealth.filter((r) => (r.precision || 1) < COMPLIANCE_SCORING.LOW_PRECISION_THRESHOLD);
+    score -= problematic.length * COMPLIANCE_SCORING.PROBLEMATIC_RULE_PENALTY;
+    return Math.max(0, Math.min(100, Math.round(score)));
+}
+/**
+ * 判定 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) {
+        return 'FAIL';
+    }
+    if (score < minScore) {
+        return 'FAIL';
+    }
+    if (summary.warnings > maxWarnings) {
+        return 'WARN';
+    }
+    return 'PASS';
+}
+export class ComplianceReporter {
+    engine;
+    exclusionManager;
+    logger;
+    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 }
+     */
+    constructor(guardCheckEngine, violationsStore, ruleLearner, exclusionManager, qualityGateConfig = {}) {
+        this.engine = guardCheckEngine;
+        this.violationsStore = violationsStore;
+        this.ruleLearner = ruleLearner;
+        this.exclusionManager = exclusionManager;
+        this.qualityGateConfig = {
+            maxErrors: QUALITY_GATE.MAX_ERRORS,
+            maxWarnings: QUALITY_GATE.MAX_WARNINGS,
+            minScore: QUALITY_GATE.MIN_SCORE,
+            ...qualityGateConfig,
+        };
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * 生成全项目合规报告
+     * @param {string} projectRoot 项目根目录
+     * @param {object} options
+     * @param {object} [options.qualityGate] 覆盖默认的 Quality Gate 阈值
+     * @param {number} [options.maxFiles] 最大扫描文件数
+     * @returns {Promise<ComplianceReport>}
+     */
+    async generate(projectRoot, options = {}) {
+        const thresholds = { ...this.qualityGateConfig, ...(options.qualityGate || {}) };
+        const maxFiles = options.maxFiles || 500;
+        // 1. 收集源文件
+        const files = await collectSourceFilesWithContent(projectRoot, { maxFiles });
+        this.logger.info(`[ComplianceReporter] Collected ${files.length} source files`);
+        // 2. 批量审计
+        const auditResult = this.engine.auditFiles(files, { scope: 'project' });
+        // 3. 通过 ExclusionManager 过滤被排除的项
+        const filteredFiles = [];
+        for (const fileResult of auditResult.files || []) {
+            if (this.exclusionManager?.isPathExcluded?.(fileResult.filePath)) {
+                continue;
+            }
+            const filteredViolations = fileResult.violations.filter((v) => {
+                // isRuleExcluded 内部已检查全局排除
+                if (this.exclusionManager?.isRuleExcluded?.(v.ruleId, fileResult.filePath)) {
+                    return false;
+                }
+                return true;
+            });
+            filteredFiles.push({
+                ...fileResult,
+                violations: filteredViolations,
+                summary: {
+                    total: filteredViolations.length,
+                    errors: filteredViolations.filter((v) => v.severity === 'error').length,
+                    warnings: filteredViolations.filter((v) => v.severity === 'warning').length,
+                    infos: filteredViolations.filter((v) => v.severity === 'info').length,
+                },
+            });
+        }
+        // 4. 汇总
+        const summary = {
+            filesScanned: files.length,
+            totalViolations: filteredFiles.reduce((s, f) => s + f.summary.total, 0),
+            errors: filteredFiles.reduce((s, f) => s + f.summary.errors, 0),
+            warnings: filteredFiles.reduce((s, f) => s + f.summary.warnings, 0),
+            infos: filteredFiles.reduce((s, f) => s + f.summary.infos, 0),
+        };
+        // 5. 按规则 ID 聚合 top violations
+        const ruleAgg = new Map();
+        for (const f of filteredFiles) {
+            for (const v of f.violations) {
+                const key = v.ruleId;
+                if (!ruleAgg.has(key)) {
+                    ruleAgg.set(key, {
+                        ruleId: key,
+                        message: v.message,
+                        severity: v.severity,
+                        fileCount: new Set(),
+                        occurrences: 0,
+                        fixRecipeId: null,
+                        fixRecipeTitle: null,
+                    });
+                }
+                const agg = ruleAgg.get(key);
+                agg.fileCount.add(f.filePath);
+                agg.occurrences++;
+                if (v.fixSuggestion && !agg.fixRecipeId) {
+                    agg.fixRecipeId = v.fixSuggestion.replace(/^recipe:/, '');
+                }
+            }
+        }
+        const topViolations = [...ruleAgg.values()]
+            .map((v) => ({ ...v, fileCount: v.fileCount.size }))
+            .sort((a, b) => b.occurrences - a.occurrences)
+            .slice(0, 20);
+        // 6. 文件热点
+        const fileHotspots = filteredFiles
+            .filter((f) => f.summary.total > 0)
+            .map((f) => ({
+            filePath: f.filePath,
+            violationCount: f.summary.total,
+            errorCount: f.summary.errors,
+        }))
+            .sort((a, b) => b.violationCount - a.violationCount)
+            .slice(0, 20);
+        // 7. 规则健康度（来自 RuleLearner）
+        let ruleHealth = [];
+        try {
+            if (this.ruleLearner?.getAllStats) {
+                const allStats = this.ruleLearner.getAllStats();
+                ruleHealth = Object.entries(allStats).map(([ruleId, stat]) => ({
+                    ruleId,
+                    precision: stat.metrics?.precision ?? 1,
+                    recall: stat.metrics?.recall ?? 1,
+                    f1: stat.metrics?.f1 ?? 1,
+                    triggers: stat.triggers || 0,
+                    warning: (stat.metrics?.precision ?? 1) < 0.5 ? '高误报' : null,
+                }));
+            }
+        }
+        catch {
+            // RuleLearner not available
+        }
+        // 8. 趋势
+        let trend = {
+            errorsChange: 0,
+            warningsChange: 0,
+            hasHistory: false,
+        };
+        try {
+            if (this.violationsStore?.getTrend) {
+                trend = this.violationsStore.getTrend();
+            }
+        }
+        catch {
+            // ViolationsStore not available
+        }
+        // 9. 评分 + Gate
+        const score = computeScore(summary, ruleHealth);
+        const gateStatus = evaluateGate(summary, score, thresholds);
+        // 10. 写入 ViolationsStore（记录本次运行）
+        try {
+            if (this.violationsStore?.appendRun) {
+                const allViolations = filteredFiles.flatMap((f) => f.violations.map((v) => ({ ...v, filePath: f.filePath })));
+                this.violationsStore.appendRun({
+                    filePath: projectRoot,
+                    violations: allViolations,
+                    summary: `Compliance scan: score=${score} ${gateStatus} | ${summary.errors}E ${summary.warnings}W`,
+                });
+            }
+        }
+        catch {
+            // Persist failure — non-critical
+        }
+        return {
+            timestamp: new Date().toISOString(),
+            projectRoot,
+            qualityGate: {
+                status: gateStatus,
+                score,
+                thresholds,
+            },
+            summary,
+            topViolations,
+            fileHotspots,
+            ruleHealth,
+            trend,
+        };
+    }
+    /**
+     * 终端格式化输出报告
+     * @param {object} report - generate() 产出的报告
+     * @param {object} options - { format: 'text' | 'markdown' | 'json' }
+     */
+    printReport(report, options = {}) {
+        const { format = 'text' } = options;
+        if (format === 'json') {
+            return;
+        }
+        if (format === 'markdown') {
+            this._printMarkdown(report);
+            return;
+        }
+        // text format
+        this._printText(report);
+    }
+    _printText(report) {
+        const { qualityGate, summary, topViolations, fileHotspots, trend } = report;
+        const gateIcon = qualityGate.status === 'PASS' ? '✅' : qualityGate.status === 'WARN' ? '⚠️' : '❌';
+        const lines = [];
+        lines.push(`${gateIcon} Quality Gate: ${qualityGate.status}  Score: ${qualityGate.score}/100`);
+        lines.push(`   Files: ${summary.filesScanned}  Errors: ${summary.errors}  Warnings: ${summary.warnings}  Infos: ${summary.infos || 0}`);
+        if (trend.hasHistory) {
+            const errTrend = trend.errorsChange > 0 ? `+${trend.errorsChange}` : `${trend.errorsChange}`;
+            const warnTrend = trend.warningsChange > 0 ? `+${trend.warningsChange}` : `${trend.warningsChange}`;
+            lines.push(`   Trend: Errors ${errTrend}  Warnings ${warnTrend}`);
+        }
+        if (topViolations.length > 0) {
+            lines.push('');
+            lines.push('Top Violations:');
+            for (const v of topViolations.slice(0, 10)) {
+                const fix = v.fixRecipeId ? ` → 🔧 recipe:${v.fixRecipeId}` : '';
+                const sev = v.severity === 'error' ? '🔴' : v.severity === 'warning' ? '🟡' : '🔵';
+                lines.push(`  ${sev} ${v.ruleId} (${v.occurrences} hits, ${v.fileCount} files)${fix}`);
+            }
+        }
+        if (fileHotspots.length > 0) {
+            lines.push('');
+            lines.push('File Hotspots:');
+            for (const f of fileHotspots.slice(0, 10)) {
+                lines.push(`  ${f.filePath} — ${f.violationCount} violations (${f.errorCount} errors)`);
+            }
+        }
+        this.logger.info(lines.join('\n'));
+    }
+    _printMarkdown(report) {
+        const { qualityGate, summary, topViolations, fileHotspots, trend } = report;
+        const lines = [];
+        lines.push('# Guard Compliance Report');
+        lines.push('');
+        lines.push(`| Metric | Value |`);
+        lines.push(`|--------|-------|`);
+        lines.push(`| Quality Gate | ${qualityGate.status} (Score: ${qualityGate.score}/100) |`);
+        lines.push(`| Files Scanned | ${summary.filesScanned} |`);
+        lines.push(`| Errors | ${summary.errors} |`);
+        lines.push(`| Warnings | ${summary.warnings} |`);
+        lines.push(`| Infos | ${summary.infos || 0} |`);
+        if (trend.hasHistory) {
+            lines.push(`| Errors Trend | ${trend.errorsChange > 0 ? '+' : ''}${trend.errorsChange} |`);
+            lines.push(`| Warnings Trend | ${trend.warningsChange > 0 ? '+' : ''}${trend.warningsChange} |`);
+        }
+        if (topViolations.length > 0) {
+            lines.push('');
+            lines.push('## Top Violations');
+            lines.push('');
+            lines.push('| Rule | Severity | Files | Hits | Fix |');
+            lines.push('|------|----------|-------|------|-----|');
+            for (const v of topViolations.slice(0, 20)) {
+                const fix = v.fixRecipeId ? `recipe:${v.fixRecipeId}` : '-';
+                lines.push(`| ${v.ruleId} | ${v.severity} | ${v.fileCount} | ${v.occurrences} | ${fix} |`);
+            }
+        }
+        if (fileHotspots.length > 0) {
+            lines.push('');
+            lines.push('## File Hotspots');
+            lines.push('');
+            lines.push('| File | Violations | Errors |');
+            lines.push('|------|-----------|--------|');
+            for (const f of fileHotspots.slice(0, 20)) {
+                lines.push(`| ${f.filePath} | ${f.violationCount} | ${f.errorCount} |`);
+            }
+        }
+    }
+}
+export default ComplianceReporter;
+//# sourceMappingURL=ComplianceReporter.js.map