AdoCli v0.4.4

What's New in v0.4.4

This release fixes the multi-word --content parsing issue and overhauls
documentation across the CLI and skills for LLM agent consumption.

Fixed

• ado prs comments add --content accepts unquoted multi-word text.
  Elixir 1.18+ OptionParser in strict mode consumes only one token after
  a flag, so --content Code review approved parsed as content="Code"
  and ["review", "approved"] as extra positional args, which CliMate
  rejected with unexpected extra argument review. Added a pre-parse
  pass in AdoCli.CLI.run/1 that detects flags in @multivalue_opts
  (--content, --message, --body, --description, --reason,
  --summary, --text) and joins all subsequent non-flag tokens into
  a single value using the --flag=value syntax. 12 new unit tests
  cover single-word, multi-word, --status-after, =, -, @file
  and combination cases.

Documentation

• Enriched --help text across all 27 command modules. Every option
  doc: string now includes valid values for enums, default behavior
  hints, output format descriptions, and argument format hints (GUID
  vs numeric ID vs name). Example: state: "wellFormed, creating, deleting, new, all" instead of Filter by project state.
• Rewrote all 3 skills for LLM agent consumption. Each skill now
  has a decision tree, structured command reference, common pitfalls
  table with specific error messages and version-specific fixes, and
  cross-references. Bumped to v0.4.3 to match the CLI version. New
  sections include binary download matrix (5 platforms in ado-ci), PAT
  scope table, troubleshooting matrix (ado-auth), and JSON output
  examples (ado-cli).
• Updated help text to document the new multi-word flag behavior.
  prs comments add --help and prs comments update --help now show:
  "Multi-word values do NOT need quoting — all subsequent args are
  joined until the next flag. Use @ to read from a file or -
  to read from stdin."

Tests

• 12 new tests in test/ado_cli/cli_test.exs for the multi-word flag
  join behavior. 337 tests pass, credo clean, dialyzer clean.

Binaries

Platform	Architecture	Binary
Linux	x86_64	ado-0.4.4-linux-x86_64
Linux	aarch64	ado-0.4.4-linux-aarch64
macOS	Apple Silicon	ado-0.4.4-macos-aarch64
macOS	Intel	ado-0.4.4-macos-x86_64
Windows	x86_64	ado-0.4.4-windows-x86_64.exe

Installation

# macOS arm64 (Apple Silicon)
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.4-macos-aarch64
chmod +x ado && sudo mv ado /usr/local/bin/

# Linux x86_64
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.4-linux-x86_64
chmod +x ado && sudo mv ado /usr/local/bin/

# Or via npm
npm install -g @gilbertwong1996/ado

See README.md and the
project homepage for
full installation instructions and usage examples.

What's Changed

• 6a63f35 docs: enrich --help and skills for LLM consumption
• 3e47310 fix(cli): support unquoted multi-word --content values

Full Changelog: https://github.com/gilbertwong96/ado_cli/blob/main/CHANGELOG.md