Struct Cli 

pub struct Cli {

    pub version: bool,
    pub check_update: bool,
    pub format: OutputFormat,
    pub robot_help: bool,
    pub robot_docs: Option<String>,
    pub robot_schema: bool,
    pub schema_command: Option<String>,
    pub stats: bool,
    pub robot_next: bool,
    pub robot_overview: bool,
    pub robot_triage: bool,
    pub robot_triage_by_track: bool,
    pub robot_triage_by_label: bool,
    pub robot_plan: bool,
    pub robot_insights: bool,
    pub robot_full_stats: bool,
    pub insight_limit: usize,
    pub robot_priority: bool,
    pub robot_alerts: bool,
    pub robot_economics: bool,
    pub economics_overlay: Option<PathBuf>,
    pub robot_delivery: bool,
    pub severity: Option<String>,
    pub alert_type: Option<String>,
    pub alert_label: Option<String>,
    pub robot_suggest: bool,
    pub suggest_type: Option<String>,
    pub suggest_confidence: f64,
    pub suggest_bead: Option<String>,
    pub robot_diff: bool,
    pub diff_since: Option<String>,
    pub robot_history: bool,
    pub bead_history: Option<String>,
    pub history_limit: usize,
    pub history_since: Option<String>,
    pub history_min_confidence: f64,
    pub robot_burndown: Option<String>,
    pub robot_forecast: Option<String>,
    pub robot_graph: bool,
    pub graph_format: GraphFormat,
    pub graph_root: Option<String>,
    pub graph_depth: usize,
    pub graph_preset: GraphPreset,
    pub graph_style: GraphStyle,
    pub graph_title: Option<String>,
    pub export_graph: Option<PathBuf>,
    pub forecast_label: Option<String>,
    pub forecast_sprint: Option<String>,
    pub forecast_agents: usize,
    pub robot_capacity: bool,
    pub capacity_agents: usize,
    pub capacity_label: Option<String>,
    pub robot_max_results: usize,
    pub robot_min_confidence: f64,
    pub robot_by_label: Option<String>,
    pub robot_by_assignee: Option<String>,
    pub label: Option<String>,
    pub workspace: Option<PathBuf>,
    pub repo: Option<String>,
    pub robot_sprint_list: bool,
    pub robot_sprint_show: Option<String>,
    pub robot_metrics: bool,
    pub robot_label_health: bool,
    pub robot_label_flow: bool,
    pub robot_label_attention: bool,
    pub attention_limit: usize,
    pub robot_explain_correlation: Option<String>,
    pub robot_confirm_correlation: Option<String>,
    pub robot_reject_correlation: Option<String>,
    pub correlation_by: Option<String>,
    pub correlation_reason: Option<String>,
    pub robot_correlation_stats: bool,
    pub robot_orphans: bool,
    pub orphans_min_score: u32,
    pub robot_file_beads: Option<String>,
    pub file_beads_limit: usize,
    pub robot_file_hotspots: bool,
    pub hotspots_limit: usize,
    pub robot_impact: Option<String>,
    pub robot_file_relations: Option<String>,
    pub relations_threshold: f64,
    pub relations_limit: usize,
    pub robot_related: Option<String>,
    pub related_min_relevance: u32,
    pub related_max_results: usize,
    pub robot_blocker_chain: Option<String>,
    pub robot_impact_network: Option<String>,
    pub network_depth: usize,
    pub robot_causality: Option<String>,
    pub save_baseline: Option<String>,
    pub robot_drift: bool,
    pub search: Option<String>,
    pub robot_search: bool,
    pub search_limit: usize,
    pub search_mode: Option<String>,
    pub search_preset: Option<String>,
    pub search_weights: Option<String>,
    pub robot_recipes: bool,
    pub recipe: Option<String>,
    pub weight_preset: Option<String>,
    pub emit_script: bool,
    pub script_limit: usize,
    pub script_format: String,
    pub feedback_accept: Option<String>,
    pub feedback_ignore: Option<String>,
    pub feedback_show: bool,
    pub feedback_reset: bool,
    pub priority_brief: Option<PathBuf>,
    pub agent_brief: Option<PathBuf>,
    pub export_pages: Option<PathBuf>,
    pub preview_pages: Option<PathBuf>,
    pub watch_export: bool,
    pub pages: bool,
    pub pages_include_closed: bool,
    pub pages_include_history: bool,
    pub pages_title: Option<String>,
    pub pages_subtitle: Option<String>,
    pub no_live_reload: bool,
    pub background_mode: bool,
    pub no_background_mode: bool,
    pub export_md: Option<PathBuf>,
    pub no_hooks: bool,
    pub view: Option<String>,
    pub list_filter: Option<String>,
    pub debug_render: Option<String>,
    pub debug_width: u16,
    pub debug_height: u16,
    pub agents_check: bool,
    pub agents_add: bool,
    pub agents_update: bool,
    pub agents_remove: bool,
    pub agents_dry_run: bool,
    pub agents_force: bool,
    pub as_of: Option<String>,
    pub force_full_analysis: bool,
    pub profile_startup: bool,
    pub profile_json: bool,
    pub no_cache: bool,
    pub db: Option<PathBuf>,
    pub baseline_info: bool,
    pub check_drift: bool,
    pub related_include_closed: bool,
    pub beads_file: Option<PathBuf>,
    pub repo_path: Option<PathBuf>,
}

Fields

version: bool

check_update: bool

Check whether a newer bvr version is available.

format: OutputFormat

robot_help: bool

robot_docs: Option<String>

robot_schema: bool

schema_command: Option<String>

stats: bool

robot_next: bool

robot_overview: bool

robot_triage: bool

robot_triage_by_track: bool

robot_triage_by_label: bool

robot_plan: bool

robot_insights: bool

robot_full_stats: bool

Include full per-node metric maps in robot-insights output.

insight_limit: usize

Maximum items per insight category (bottlenecks, influencers, etc.).

robot_priority: bool

robot_alerts: bool

robot_economics: bool

Emit economics projections (burn rate, cost-to-complete, cost-of-delay). Requires --economics-overlay <path> or BVR_ECONOMICS_OVERLAY env var pointing at a JSON file with hourly_rate and hours_per_day.

economics_overlay: Option<PathBuf>

Path to a JSON economics overlay file. Overrides BVR_ECONOMICS_OVERLAY when both are set. Required for --robot-economics unless the env var is set. Schema: {"hourly_rate": f64, "hours_per_day": f64, "budget_envelope": f64?, "throughput_window_days": u32?, "currency": String?}.

robot_delivery: bool

Emit delivery posture classification (flow mix, urgency profile, milestone pressure). No overlay required.

severity: Option<String>

alert_type: Option<String>

alert_label: Option<String>

robot_suggest: bool

suggest_type: Option<String>

suggest_confidence: f64

suggest_bead: Option<String>

robot_diff: bool

diff_since: Option<String>

robot_history: bool

bead_history: Option<String>

history_limit: usize

history_since: Option<String>

history_min_confidence: f64

robot_burndown: Option<String>

robot_forecast: Option<String>

robot_graph: bool

graph_format: GraphFormat

graph_root: Option<String>

graph_depth: usize

graph_preset: GraphPreset

graph_style: GraphStyle

graph_title: Option<String>

export_graph: Option<PathBuf>

forecast_label: Option<String>

forecast_sprint: Option<String>

forecast_agents: usize

robot_capacity: bool

capacity_agents: usize

capacity_label: Option<String>

robot_max_results: usize

robot_min_confidence: f64

robot_by_label: Option<String>

robot_by_assignee: Option<String>

label: Option<String>

workspace: Option<PathBuf>

repo: Option<String>

robot_sprint_list: bool

robot_sprint_show: Option<String>

robot_metrics: bool

robot_label_health: bool

robot_label_flow: bool

robot_label_attention: bool

attention_limit: usize

robot_explain_correlation: Option<String>

robot_confirm_correlation: Option<String>

robot_reject_correlation: Option<String>

correlation_by: Option<String>

correlation_reason: Option<String>

robot_correlation_stats: bool

robot_orphans: bool

orphans_min_score: u32

robot_file_beads: Option<String>

file_beads_limit: usize

robot_file_hotspots: bool

hotspots_limit: usize

robot_impact: Option<String>

robot_file_relations: Option<String>

relations_threshold: f64

relations_limit: usize

robot_related: Option<String>

related_min_relevance: u32

related_max_results: usize

robot_blocker_chain: Option<String>

robot_impact_network: Option<String>

network_depth: usize

robot_causality: Option<String>

save_baseline: Option<String>

robot_drift: bool

search: Option<String>

robot_search: bool

search_limit: usize

search_mode: Option<String>

search_preset: Option<String>

search_weights: Option<String>

robot_recipes: bool

List available triage recipes.

recipe: Option<String>

Apply a named recipe to filter/sort recommendations.

weight_preset: Option<String>

Scoring weight preset (default, graph-heavy, priority-first, quick-wins, risk-averse).

emit_script: bool

Emit a shell script for the top recommendations.

script_limit: usize

Number of recommendations to include in emitted script (default 5).

script_format: String

Shell format for emitted script: bash (default), fish, zsh.

feedback_accept: Option<String>

Record positive feedback for a recommendation.

feedback_ignore: Option<String>

Record negative feedback (ignore) for a recommendation.

feedback_show: bool

Show feedback statistics.

feedback_reset: bool

Reset all recorded feedback.

priority_brief: Option<PathBuf>

Generate a priority brief as markdown and write to the given path.

agent_brief: Option<PathBuf>

Generate an agent brief bundle in the given directory.

export_pages: Option<PathBuf>

Export static pages bundle to directory.

preview_pages: Option<PathBuf>

Preview an existing static pages bundle from directory.

watch_export: bool

Watch beads file changes and auto-regenerate pages export.

pages: bool

Launch pages deployment wizard.

pages_include_closed: bool

Include closed issues in exported pages bundle (default: true).

pages_include_history: bool

Include history payload in exported pages bundle (default: true).

pages_title: Option<String>

Custom title for exported pages bundle.

pages_subtitle: Option<String>

Custom subtitle for exported pages bundle.

no_live_reload: bool

Disable live reload when previewing pages.

background_mode: bool

Enable experimental background snapshot loading (TUI only).

no_background_mode: bool

Disable experimental background snapshot loading (TUI only).

export_md: Option<PathBuf>

no_hooks: bool

view: Option<String>

Start the TUI in the given view instead of Main. Supported: main, board, insights, graph, history, actionable, attention, tree, labels, flow, timediff, sprint.

list_filter: Option<String>

Start the TUI with a list-status filter applied. Supported: all, open, in-progress, blocked, closed, ready.

debug_render: Option<String>

Render a named TUI view non-interactively and output to stdout. Supported views: insights, board, history, main, graph.

debug_width: u16

Width in columns for debug render (default 180).

debug_height: u16

Height in rows for debug render (default 50).

agents_check: bool

Check agent file blurb status.

agents_add: bool

Add beads workflow blurb to agent file (creates AGENTS.md if needed).

agents_update: bool

Update blurb to current version in agent file.

agents_remove: bool

Remove blurb from agent file.

agents_dry_run: bool

Dry-run mode for agents commands (show what would change without writing).

agents_force: bool

Skip confirmation prompts for agents commands (legacy compatibility flag).

as_of: Option<String>

force_full_analysis: bool

profile_startup: bool

Output detailed startup timing profile for diagnostics.

profile_json: bool

Output profile in JSON format (use with –profile-startup).

no_cache: bool

Bypass disk cache for this invocation.

db: Option<PathBuf>

Legacy compatibility alias for --beads-file.

baseline_info: bool

Show baseline metadata (when it was saved, description, stats).

check_drift: bool

Compare current state against saved baseline with human-readable output.

related_include_closed: bool

Include closed issues in related work discovery.

beads_file: Option<PathBuf>

repo_path: Option<PathBuf>

Implementations

impl Cli

pub fn resolve_output_format(&self) -> Result<OutputFormat, String>

pub fn resolve_stats_flag(&self) -> bool

pub fn resolve_search_preset(&self) -> Option<String>

pub fn is_operational_command(&self) -> bool

pub fn is_robot_command(&self) -> bool

pub fn is_agents_command(&self) -> bool

Trait Implementations

impl Args for Cli

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl CommandFactory for Cli

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl Debug for Cli

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

Formats the value using the given formatter.

impl FromArgMatches for Cli

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Cli

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.