Repository navigation
v0.6.0
Immutable
release. Only release title and notes can be modified.
CONGA v0.6.0 adds implicit subcommands, completes trailing arguments with predictors, and makes -- end subcommand routing.
🚀 Highlights
- Implicit subcommands: An
implicit:"true"subcommand is selected by an operand that names no sibling, or by a flag only it declares, sotool ./script.tsruns astool run ./script.ts(#98). - Trailing argument completion:
DashArgsandRawArgsaccept apredictortag and complete after--or once raw mode begins (#95).
⚠ Breaking Changes & Migration
--ends subcommand routing (#95):- Operands after
--no longer name subcommands. They bind toDashArgsor positional arguments, or fail as unexpected arguments. DeclareDashArgson the command that should receive them.
- Operands after
- Trailing argument grammar is checked at startup (#95):
- Schema build fails with
ErrSchemawhen a command declares both positional arguments and subcommands, combinesRawArgswith command fields, puts optional or variadic positionals beforeRawArgs, or declares duplicate trailing collectors. - Move positionals to leaf commands, and use
DashArgsto forward arguments after--from a command with subcommands.
- Schema build fails with
- Flag-shaped tokens are no longer flag values (#95):
- A flag that takes a value no longer consumes a following token that looks like a flag, or
--.--name --verbosenow fails withflag requires an argument: --name(exit 2). Pass such values attached:--name=--verbose.
- A flag that takes a value no longer consumes a following token that looks like a flag, or
✨ Features
- cli: Add
implicit:"true"subcommands, marked(default)in help (#98). - completion: Complete
DashArgsandRawArgswithpredictortags, and offer no candidates after--when the command has nowhere to bind them (#95).
🐛 Bug Fixes
- cli: A declared
--helpor--versionflag also disables the synthesized-hor-Vshort for that command chain (#97).
📚 Documentation
- website: Document implicit subcommand routing (#103).
Full Changelog: v0.5.0...v0.6.0
Requirements: Go 1.27+ · Docs · pkg.go.dev