Function walk_invoked

atomic-cli/src/agent_error.rs:98–166

Walk argv against the live command tree to the deepest node that actually exists. The fallback for the [`ErrorKind`]s that carry no `Usage` context. Unlike [`path_from_usage`] this has to distinguish an accepted global flag from the one clap rejected. Known flags are skipped (along with their value); unknown flags stop the walk so we never attribute a root error to a later command.

(root: &clap::Command, argv: &[OsString])

/// one clap rejected. Known flags are skipped (along with their value); unknown
/// flags stop the walk so we never attribute a root error to a later command.
fn walk_invoked(root: &clap::Command, argv: &[OsString]) -> (String, usize) {
    let mut node = root;
    let mut parts: Vec<String> = Vec::new();
    let mut index = 1;
    let mut scope_start = 1;

    while index < argv.len() {
        let Some(tok) = argv[index].to_str() else {
            break;
        };
        if tok == "--" {
            break;
        }
        if tok.starts_with("--") {
            let (name, inline_value) = tok
                .split_once('=')
                .map_or((tok, false), |(name, _)| (name, true));
            let long = name.trim_start_matches('-');
            let arg = node
                .get_arguments()
                .chain(root.get_arguments())
                .find(|arg| arg.get_long() == Some(long));
            let Some(arg) = arg else {
                break;
            };
            if !inline_value && arg.get_action().takes_values() {
                index += 1;
            }
            index += 1;
            continue;
        }
        if tok.starts_with('-') && tok.len() > 1 {
            let mut consumes_next = false;
            let mut known = true;
            for short in tok[1..].chars() {
                let arg = node
                    .get_arguments()
                    .chain(root.get_arguments())
                    .find(|arg| arg.get_short() == Some(short));
                let Some(arg) = arg else {
                    known = false;
                    break;
                };
                if arg.get_action().takes_values() {
                    consumes_next = tok.len() == 2;
                    break;
                }
            }
            if !known {
                break;
            }
            if consumes_next {
                index += 1;
            }
            index += 1;
            continue;
        }
        match node.find_subcommand(tok) {