/**
 * Comment Checker — detects and flags AI-generated "slop" in code comments.
 *
 * Scans code output from write/edit/patch tools for common low-quality
 * AI comment patterns: filler phrases, redundant narration, over-explanation
 * of obvious code, and marketing-style language that adds no value.
 *
 * Operates purely on heuristics — no LLM calls.
 */
import type { Logger } from '../types';
export interface CommentCheckerConfig {
    /** Enable the comment checker. Default: true. */
    enabled?: boolean;
    /** Minimum number of violations to trigger a warning. Default: 2. */
    minViolations?: number;
    /** Severity: 'warn' emits advisory, 'block' rejects the output. Default: 'warn'. */
    severity?: 'warn' | 'block';
}
export interface CommentViolation {
    /** The matched line (trimmed). */
    line: string;
    /** Which pattern category matched. */
    category: string;
    /** Human-readable explanation. */
    reason: string;
}
export interface CheckResult {
    violations: CommentViolation[];
    /** Pre-formatted warning text (empty when no violations). */
    warning: string;
}
export declare class CommentChecker {
    private config;
    private logger;
    constructor(logger: Logger, config?: CommentCheckerConfig);
    isEnabled(): boolean;
    /**
     * Check code content for AI slop comments.
     */
    check(content: string): CheckResult;
}
//# sourceMappingURL=comment-checker.d.ts.map