/**
 * X-Ray Finding Guidance
 *
 * Human-readable explanations for each finding category.
 * Tells users what a finding means, what to do about it,
 * and whether it's likely a false positive.
 */
import type { XRayCategory } from './types.js';
export interface FindingGuidance {
    /** Plain-language explanation of what this means */
    whatItMeans: string;
    /** What the user should do */
    whatToDo: string;
    /** When this is typically a false positive */
    falsePositiveNote: string;
    /** How serious this usually is: 'usually-safe' | 'investigate' | 'act-now' */
    urgency: 'usually-safe' | 'investigate' | 'act-now';
}
/**
 * Get human-readable guidance for a finding.
 */
export declare function getGuidance(category: XRayCategory, severity: string): FindingGuidance;
/**
 * Check if a file path looks like a system/cache file that commonly triggers false positives.
 */
export declare function isLikelySystemFile(filePath: string): boolean;
