/**
 * Human-oriented CLI formatting for IR findings (structural + architecture lint).
 */
import type { IrStructuralFinding } from './ir-structural.js';
/** Pretty multi-line output for terminal / CI logs */
export declare function formatFindingLines(f: IrStructuralFinding): string[];
/**
 * Pretty-print findings. By default groups **IR structural (IR-STRUCT-*)** and **architecture lint (IR-LINT-*)** so both are obvious in CI logs.
 */
export declare function printFindingsPretty(findings: IrStructuralFinding[], header?: string, options?: {
    groupByLayer?: boolean;
}): void;
export type ValidationExitPolicy = {
    /** When true, any warning fails the run (CI gate). */
    failOnWarning?: boolean;
    /** Fail when warning count is strictly greater than this (undefined = no limit) */
    maxWarnings?: number;
    /** When true, never exit with failure (e.g. GitHub Action `fail-on: never`). */
    neverFail?: boolean;
};
export type FailOnMode = 'error' | 'warning' | 'never';
/** Maps `fail-on` style inputs to exit policy (GitHub Actions / CI). */
export declare function validationExitPolicyFromFailOn(mode: FailOnMode): ValidationExitPolicy;
export declare function countBySeverity(findings: IrStructuralFinding[], sev: IrStructuralFinding['severity']): number;
/** true = exit with failure */
export declare function shouldFailFromFindings(findings: IrStructuralFinding[], policy: ValidationExitPolicy): boolean;
/** Counts for CI / GitHub Action outputs. */
export declare function findingMetrics(findings: IrStructuralFinding[]): {
    findingsCount: number;
    errorCount: number;
    warningCount: number;
    infoCount: number;
};
export declare function sortFindings(findings: IrStructuralFinding[]): IrStructuralFinding[];
//# sourceMappingURL=cli-findings.d.ts.map