export interface CommandEntry {
    id: number;
    command: string;
    timestamp: string;
}
export interface History {
    projectName: string;
    commands: CommandEntry[];
}
/**
 * Read command history from .proj-track.json.
 * Returns a default empty history if the file doesn't exist or is malformed.
 */
export declare function readHistory(dir?: string): History;
/**
 * Write command history to .proj-track.json.
 */
export declare function writeHistory(history: History, dir?: string): void;
/**
 * Append a command to history with deduplication and size limit.
 */
export declare function appendCommand(command: string, dir?: string): void;
/**
 * Clear all commands from history.
 */
export declare function clearHistory(dir?: string): void;
/**
 * Convert .proj-track.json to .proj-track.txt (plain text backup).
 * Removes the JSON file after conversion.
 */
export declare function convertToTxt(dir?: string): void;
/**
 * Find a command entry by its ID.
 */
export declare function findCommandById(id: number, dir?: string): CommandEntry | undefined;
//# sourceMappingURL=file-handler.d.ts.map