/**
 * Manpage-grade CLI reference — command groups, env vars, exit codes, JSON contracts.
 * Single source of truth for completions and help snapshots.
 */
export declare const CLI_REFERENCE_SCHEMA = "todos.cli_reference.v1";
export interface CliCommandRef {
    name: string;
    summary: string;
    usage?: string;
    flags?: string[];
    example?: string;
    json?: boolean;
}
export interface CliCommandGroup {
    name: string;
    description: string;
    commands: CliCommandRef[];
}
export interface ExitCodeRef {
    code: number;
    meaning: string;
}
export interface EnvVarRef {
    name: string;
    description: string;
    default?: string;
}
export declare const EXIT_CODES: ExitCodeRef[];
export declare const ENV_VARS: EnvVarRef[];
export declare const JSON_OUTPUT_CONTRACT: {
    schema_version: string;
    description: string;
    shape: {
        success: string;
        error: string;
    };
    stable_fields: string[];
};
export declare const CLI_COMMAND_GROUPS: CliCommandGroup[];
/** Flat list of top-level command names for completions */
export declare function listTopLevelCommands(): string[];
/** Subcommands for command groups that use nested subcommands */
export declare const NESTED_SUBCOMMANDS: Record<string, string[]>;
export declare function getCommandHelp(name: string): CliCommandRef | undefined;
export declare function getInstallInstructions(shell: "bash" | "zsh" | "fish"): string[];
//# sourceMappingURL=cli-reference.d.ts.map