#!/usr/bin/env node
import { Command } from 'commander';
/**
 * Creates the VersionGuard CLI program definition.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * This function wires all commands, options, and handlers onto a fresh Commander
 * program instance without parsing arguments yet.
 *
 * @returns A configured Commander program for the VersionGuard CLI.
 *
 * @example
 * ```typescript
 * const program = createProgram();
 * console.log(program.name());
 * ```
 */
export declare function createProgram(): Command;
/**
 * Parses CLI arguments and executes the matching command.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * This helper delegates argument parsing to the Commander program created by
 * {@link createProgram}. It resolves when the selected command finishes.
 *
 * @param argv - Full argument vector to parse.
 * @see {@link createProgram}
 *
 * @example
 * ```typescript
 * const argv = ['node', 'versionguard', 'check'];
 * await runCli(argv);
 * ```
 */
export declare function runCli(argv?: string[]): Promise<void>;
/**
 * Determines whether the current module is the invoked CLI entry point.
 *
 * @public
 * @since 0.1.0
 * @remarks
 * This helper compares the resolved script path from `argv` with the current
 * module URL so the CLI runs only during direct execution.
 *
 * @param argv - Full process argument vector.
 * @param metaUrl - Module URL to compare against the invoked entry path.
 * @returns `true` when the current module should launch the CLI.
 *
 * @example
 * ```typescript
 * const shouldRun = shouldRunCli(process.argv, import.meta.url);
 * console.log(shouldRun);
 * ```
 */
export declare function shouldRunCli(argv?: string[], metaUrl?: string): boolean;
//# sourceMappingURL=cli.d.ts.map