/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 *
 * Dependency-light lifecycle and error primitives for user-facing CLI commands. This is intentionally separate from
 * `scripting/utils`, whose service disposal and structured logging are appropriate for long-running scripts.
 */
/**
 * An expected command failure whose message is safe to show directly. The original failure belongs in `cause`.
 */
export declare class CommandError extends Error {
    readonly exitCode = 1;
    constructor(message: string, options?: ErrorOptions);
}
/**
 * Format an expected command failure as guidance and preserve stacks for unexpected failures.
 */
export declare function formatCommandError(error: unknown): string;
/**
 * Log a command failure and the cause attached to expected guidance errors.
 */
export declare function reportError(error: unknown): void;
/**
 * Run a CLI command with one consistent stderr and exit-code boundary.
 */
export declare function runCLICommand(command: () => number | undefined | Promise<number | undefined>): Promise<number | undefined>;
//# sourceMappingURL=command.d.ts.map