//! CLI module for RIES (Rust Implementation of Equation Solver)
//!
//! This module contains all command-line interface handling, including:
//! - Argument parsing with clap
//! - Output formatting and display
//! - Diagnostics flag handling
//! - Search orchestration
//! - Configuration building
//! - Legacy argument handling
//! - JSON output types
//! - Manifest building
//!
//! # Structure
//!
//! - [`args`] - Command-line argument definitions and parsing helpers
//! - [`output`] - Output formatting functions for matches and expressions
//! - [`diagnostics`] - `-D` flag handling for diagnostic output channels
//! - [`search_runner`] - Search execution and orchestration
//! - [`config_builder`] - Configuration building from CLI arguments
//! - [`legacy`] - Legacy argument normalization for backward compatibility
//! - [`json_types`] - JSON output types and building functions
//! - [`manifest`] - Run manifest creation for reproducibility
//! - [`runtime`] - Startup/runtime helpers for special CLI modes

pub mod args;
pub mod config_builder;
pub mod diagnostics;
pub mod json_types;
pub mod legacy;
pub mod manifest;
pub mod output;
pub mod post_process;
pub mod runtime;
pub mod search_runner;

// Re-export the main public API
pub use args::{
    canon_reduction_enabled, parse_memory_size_bytes, parse_symbol_names_from_cli,
    parse_symbol_sets, parse_symbol_weights_from_cli, parse_user_constant_from_cli,
    parse_user_function_from_cli, print_option_list, print_symbol_table, Args,
};

pub use diagnostics::parse_diagnostics;

pub use json_types::{build_json_output, format_bytes_binary, peak_memory_bytes};

pub use manifest::build_manifest;

pub use output::{
    compute_significant_digits_tolerance, format_value, parse_display_format, print_footer,
    print_header, print_match_absolute, print_match_relative, print_show_work_details,
    DisplayFormat,
};

pub use runtime::{cli_level_to_complexity, handle_special_modes, load_runtime_profile, CliExit};

pub use search_runner::run_search;

pub use config_builder::build_gen_config;

pub use legacy::{normalize_legacy_args, NormalizedArgs};

pub use post_process::{
    expression_constraints_from_args, filter_matches, run_stability_check,
    ExpressionConstraintArgs, PostProcessOptions, StabilityRunConfig,
};
