Module args 

CLI argument parsing + help text. Mirrors the TS packages/coding-agent/src/cli/args.ts (parseArgs + printHelp), scoped to the flags the v1 Rust CLI honors.

The TS parser is a hand-rolled positional/flag loop (no yargs/commander dep) that collects messages, @file attachments, known flags, and a map of unknown --flags (for extensions to claim later). This port keeps the same shape so the help text and flag semantics line up 1:1 with the reference. Unknown long flags are retained in Args::unknown_flags so a native extension can claim and consume its own CLI options after loading.

Divergences from the TS parser (all deliberate v1 scope cuts, documented in docs/m6-cli-open-questions.md):

• --mode rpc, --fork, --approve/-na, --extension/-e, --skill, and --prompt-template are recognized but not all wired into the full TS package manager. The supported resource flags are handled by the Rust loader; remaining compatibility flags are accepted with a warning.
• --thinking is typed via ThinkingLevel from rpi_ai (the TS parser validates against the same string set).
• --print/-p may consume a following positional as its prompt (the TS parser’s next !== undefined && !startsWith('@') heuristic) — preserved.

Structs

Args

The parsed argument set. Mirrors TS Args. Unknown long flags are retained for extension consumption; unknown short flags remain hard errors.

Enums

Mode

Output mode. Mirrors TS Mode = "text" | "json" | "rpc". rpc is parsed (so --mode rpc doesn’t error) but v1 does not implement it; main reports an error if selected.

RunMode

The concrete run mode resolve_mode picks. Mirrors TS AppMode (interactive/print/json/rpc). Distinguished from Mode (the raw --mode flag value) because the effective mode also folds in -p + TTY detection.

TuiMode

Interactive TUI presentation mode. fullscreen uses the alternate screen buffer; regular renders into the terminal’s normal scrollback.

Constants

VALID_THINKING_LEVELS

The canonical valid --thinking level strings, in level order. Mirrors TS VALID_THINKING_LEVELS.

Functions

parse_args

Parse argv (excluding the program name). Mirrors TS parseArgs.

parse_thinking_level

Parse a thinking-level string. Mirrors TS isValidThinkingLevel.

print_help

Print the help text to stdout. Mirrors TS printHelp, scoped to v1 flags.

print_version

Print the version line. Mirrors TS --version output (pi <version>).

resolve_mode

Resolve the effective output Mode. Mirrors TS resolveAppMode: rpc→rpc, json→json, print or piped-stdin/redirected-stdout→print, else interactive. Here stdin_is_tty/stdout_is_tty come from std::io::IsTerminal.