/**
 * Settings auditor — entry point for vat audit settings command.
 */
import type { SettingsLevel } from '../types.js';
import type { EffectiveSettings, SettingsLayer } from './settings-merger.js';
import type { ReadSettingsOptions } from './settings-reader.js';
export interface SettingsAuditResult {
    effective: EffectiveSettings;
    /** All loaded layers in precedence order */
    layers: SettingsLayer[];
}
export interface SettingsPathEntry {
    label: string;
    path: string;
    exists: boolean;
    readable: boolean;
    level: SettingsLevel;
    status?: 'error' | undefined;
    message?: string | undefined;
}
export interface SettingsPathsResult {
    paths: SettingsPathEntry[];
}
export type SettingsDetectedType = 'managed' | 'user' | 'project' | 'unknown';
export interface SettingsValidateResult {
    valid: boolean;
    errors: Array<{
        path: string;
        message: string;
    }>;
    detectedType: SettingsDetectedType;
}
/**
 * Perform a settings audit — load all layers and merge.
 */
export declare function auditSettings(options?: ReadSettingsOptions): Promise<SettingsAuditResult>;
/**
 * Get all known settings paths with existence and readability status.
 */
export declare function getSettingsPaths(projectDir?: string): SettingsPathsResult;
/**
 * Resolve actual path access status (async version of getSettingsPaths).
 */
export declare function resolveSettingsPaths(projectDir?: string): Promise<SettingsPathsResult>;
/**
 * Validate a specific settings file against the appropriate schema.
 */
export declare function validateSettingsFile(filePath: string, typeHint?: Exclude<SettingsDetectedType, 'unknown'>): Promise<SettingsValidateResult>;
/**
 * Get summary of fields present in a settings file (for --file output).
 */
export declare function getSettingsFileFields(filePath: string): Promise<Array<{
    key: string;
    value?: string;
    count?: number;
}>>;
export { type EffectiveSettings, type SettingsLayer } from './settings-merger.js';
export { type ReadSettingsOptions } from './settings-reader.js';
//# sourceMappingURL=settings-auditor.d.ts.map