/**
 * Comment Noise Detector — 注释噪音检测（注释规范中机械可判部分）。
 *
 * 职责边界：
 * - 负责：注释内任务编号（REQ-/task-/#\d+/任务号等）与变更日志式注释（日期+动作词）检测
 * - 不负责：注释语言/格式规范（guidance 承载）、TODO 检测（lazy_pattern_detector 已覆盖）
 *
 * 被谁调用：gate/executors/executors_comment_noise.ts
 * 调用谁：无外部依赖（纯计算）
 *
 * 数据流：文件内容 + 路径 → 注释文本提取（字符串剥离后）→ 噪音模式 → CommentNoiseFinding[]
 * 持久化：无
 *
 * 判定机制：逐行提取注释文本（行注释 `//`、`#` 与块注释段——先剥离字符串字面量，
 * 避免 "http://" 内 // 被当注释），对注释文本匹配任务编号/变更日志模式。
 * 编号模式排除日期（2026-08-27）与国标编码（GB-3304）形态；测试文件不豁免
 * （追踪标记的合法位置是测试名称，不是注释）；生成代码豁免。
 */
export interface CommentNoiseFinding {
    /** 噪音类型 */
    kind: "task_reference" | "changelog_comment";
    /** 发现位置行号（1-based） */
    line_number: number;
    /** 中文描述 */
    message: string;
    /** 证据片段（原始行内容，截断 120 字符） */
    evidence: string;
}
/**
 * 对单个文件执行注释噪音检测。
 * @param content 文件原始内容
 * @param filePath 文件路径（语言分流：代码扩展名才扫）
 */
export declare function detectCommentNoise(content: string, filePath: string): CommentNoiseFinding[];