/**
 * Documentation drift detection - ported from lib/validation/docs-sync.sh
 *
 * Detects drift between scripts/, COMMANDS-INDEX.json, wrapper templates,
 * and README documentation. Helps keep documentation in sync with code.
 *
 * @task T4527
 * @epic T4454
 */
export interface DriftIssue {
    type: 'missing_from_index' | 'orphaned_index' | 'missing_from_wrapper' | 'missing_from_readme';
    severity: 'error' | 'warning';
    item: string;
    message: string;
}
export interface DriftReport {
    mode: 'quick' | 'full';
    issues: DriftIssue[];
    exitCode: 0 | 1 | 2;
}
export interface CommandIndexEntry {
    name: string;
    script?: string;
    aliasFor?: string | null;
    note?: string | null;
}
export interface CommandIndex {
    commands: CommandIndexEntry[];
}
/**
 * Get command names from scripts directory.
 * Returns sorted list of script basenames without .sh extension.
 * @task T4527
 */
export declare function getScriptCommands(scriptsDir: string): string[];
/**
 * Get script names from COMMANDS-INDEX.json.
 * @task T4527
 */
export declare function getIndexScripts(indexPath: string): string[];
/**
 * Get command names from COMMANDS-INDEX.json.
 * @task T4527
 */
export declare function getIndexCommands(indexPath: string): string[];
/**
 * Check commands index vs scripts directory for sync.
 * @task T4527
 */
export declare function checkCommandsSync(scriptsDir: string, indexPath: string): DriftIssue[];
/**
 * Check wrapper template sync with COMMANDS-INDEX.
 * @task T4527
 */
export declare function checkWrapperSync(wrapperPath: string, indexPath: string): DriftIssue[];
/**
 * Run full drift detection across scripts, index, wrapper, and README.
 * @task T4527
 */
export declare function detectDrift(mode?: 'quick' | 'full', projectRoot?: string): DriftReport;
/**
 * Check if drift detection should run automatically based on config.
 * @task T4527
 */
export declare function shouldRunDriftDetection(enabled?: boolean, autoCheck?: boolean, command?: string, criticalCommands?: string[]): boolean;
//# sourceMappingURL=docs-sync.d.ts.map