Struct Cli 

pub struct Cli {
    pub command: Commands,
    pub json: bool,
    pub output: Option<OutputMode>,
    pub no_color: bool,
    pub repo: Option<PathBuf>,
    pub verbose: u8,
    pub quiet: bool,
    pub op_id: Option<String>,
}

Heddle: An AI-native version control system.

Fields

command: Commands

json: bool

Output JSON (deprecated; use --output json).

Still functional — both forms route to JSON. Kept for compatibility with scripts and agent harnesses written against the old surface. Emits a one-shot stderr warning on first use within a process.

output: Option<OutputMode>

Output format. auto (default) renders text on a TTY and JSON when piped; json and text override regardless of stream.

no_color: bool

Disable colored output.

repo: Option<PathBuf>

Repository path (default: find .heddle in ancestors).

verbose: u8

Increase verbosity.

quiet: bool

Decrease verbosity.

op_id: Option<String>

Client-supplied operation id (UUID v4) for idempotent retries.

State-changing verbs that pass this id to the dedup store return the original outcome on replay. Unset by default; agents supply one explicitly. Honoured for any state-changing verb that has been wired through the dedup store. Also reads HEDDLE_OPERATION_ID from the environment.

Hidden from default --help to keep the human surface uncluttered; see heddle help operation-ids for the full agent-facing contract.

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 CliContext for Cli

fn repo_path(&self) -> Option<&Path>

--repo override; None means “use the process’s current directory.”

fn operation_id_wire(&self) -> String

--op-id override for idempotent gRPC calls. Empty string means the caller did not supply one and the server should not dedupe.

fn should_output_json(&self, repo_config: Option<&Config>) -> bool

Resolves whether output should be JSON, encapsulating the precedence between the --json / --output cli flags, the user’s global config, and (when supplied) the repo’s output.format config. Hosted commands typically pass Some(repo.config()) after opening the repo and None otherwise.

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 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.