Struct ReportConfig 

#[non_exhaustive]
pub struct ReportConfig {
    pub banner_width: usize,
    pub agent_titles: BTreeMap<AgentName, (String, String)>,
}

Configuration for the report formatter.

Controls banner width and agent display names/titles.

ASCII Constraint

The fixed-width banner guarantee (banner_width bytes per line) assumes all displayed content is ASCII. Agent titles, verdict labels, and consensus strings are ASCII by default. If agent_titles contains multi-byte UTF-8 characters, banner lines will have correct byte length but may appear visually misaligned in terminals because multi-byte characters can occupy more than one display column.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

banner_width: usize

Total width of the ASCII banner in bytes, including border characters (default: 52). Equals character count for ASCII content.

agent_titles: BTreeMap<AgentName, (String, String)>

Maps agent name to (display_name, title) for report display. Values should be ASCII for correct banner alignment.

Implementations

impl ReportConfig

pub const MIN_BANNER_WIDTH: usize = 8

Minimum banner_width accepted by ReportConfig::new_checked.

Allows | + 6 content bytes + | = 8 bytes minimum for any meaningful banner.

pub fn new_checked( banner_width: usize, agent_titles: BTreeMap<AgentName, (String, String)>, ) -> Result<Self, ReportError>

Creates a ReportConfig with validated banner_width and ASCII agent_titles.

Returns Err(ReportError::BannerTooSmall) if banner_width < 8. Returns Err(ReportError::NonAsciiTitle) if any display name or title in agent_titles contains non-ASCII characters.

This allows fit_content to assume ASCII without run-time panic and ensures the banner is at least minimally renderable.

Example

let mut titles = BTreeMap::new();
titles.insert(AgentName::Melchior, ("Melchior".to_string(), "Scientist".to_string()));
let config = ReportConfig::new_checked(52, titles)?;

Trait Implementations

impl Clone for ReportConfig

fn clone(&self) -> ReportConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ReportConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ReportConfig

fn default() -> Self

Returns the “default value” for a type.