export interface CliEnvelope<T = unknown> {
    ok: boolean;
    code: string;
    data?: T;
    message?: string;
    warnings: string[];
    items?: unknown[];
}
export declare class CliCommandError extends Error {
    readonly code: string;
    readonly exitCode: number;
    readonly data?: unknown;
    constructor(code: string, message: string, exitCode?: number, data?: unknown);
}
export declare function ok<T>(data: T, code?: string, warnings?: string[]): CliEnvelope<T>;
export declare function fail(code: string, message: string, warnings?: string[], data?: unknown): CliEnvelope;
export declare function writeJson(result: CliEnvelope): void;
export declare function writeJsonItems(items: unknown[], code: string, warnings?: string[]): void;
export declare function writeJsonResult<T>(data: T, code?: string, warnings?: string[]): void;
export declare function isJsonMode(argv: {
    json?: boolean;
}): boolean;
export declare function handleCliError(error: unknown, json: boolean, fallbackCode?: string): never;