export interface VersionCheckResult {
    updateAvailable: boolean;
    currentVersion: string;
    latestVersion: string;
}
export declare function readCachedResult(currentVersion: string, cacheDir: string): Promise<VersionCheckResult | null>;
/**
 * Fetches the latest published version and persists the comparison to the
 * cache file. Skips the write and returns false when the latest version
 * can't be determined so the next invocation retries.
 */
export declare function refreshVersionCheck(currentVersion: string, cacheDir: string): Promise<boolean>;
/**
 * Entry point for the detached refresh helper. Validates the argv contract
 * (`<currentVersion> <cacheDir>`) and returns the process exit code:
 * 0 on success, 1 on bad args, 2 when the latest version couldn't be fetched.
 */
export declare function runRefresh(argv: string[]): Promise<number>;
/**
 * Refreshes the version-check cache in a detached child process so the
 * registry roundtrip never blocks the invoked command. The result is picked
 * up from the cache on the next invocation.
 */
export declare function spawnBackgroundRefresh(currentVersion: string, cacheDir: string): void;