import { type CommandHandler } from './helpers.js';
/**
 * How the page, the docs and the hints spell the command: the bare package,
 * no version. vigilbase.com refuses CLIs older than it accepts, and that
 * error's hint (CLI_UPGRADE_REQUIRED) names `@latest` to get past a cached copy.
 */
export declare const NPX_COMMAND = "npx @vigilbase/cli";
export declare const LOCAL_HELP: string;
/** `vigilbase local cloudflare-checkup [<command>] …` */
export declare const handleLocal: CommandHandler;
/** `vigilbase cloudflare-checkup …`: the top-level alias. */
export declare const handleCloudflareCheckup: CommandHandler;
/**
 * A path as one shell word, for hints the user may copy. POSIX shells get
 * single quotes (nothing inside is expanded), with a leading `~/` left outside
 * them so the shell still expands it.
 */
export declare function shellArg(value: string, platform?: NodeJS.Platform): string;
/**
 * `~/…` for paths under the home directory. Not on Windows: cmd and Windows
 * PowerShell do not expand `~` for native commands, and the printed path is
 * what users pass to `submit`.
 */
export declare function displayPath(path: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string;
/**
 * `cloudflare-checkup-<first 8 of the account ID>-<UTC yyyymmddThhmmssZ>.json`;
 * `-2`, `-3`, … only when a run in the same second already used the name.
 */
export declare function defaultSnapshotName(accountId: string, at: Date, attempt?: number): string;
/**
 * `submit` for a saved file. A loopback origin is named with `--base-url`, so a
 * development run never suggests an upload to production; production is the
 * CLI's default and is not named.
 */
export declare function submitCommand(path: string, origin: string): string;