Skip to content

Releases

v0.11.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 19:36
Immutable release. Only release title and notes can be modified.
2d09f40

CONGA v0.11.0 makes completion follow each field's declaration more closely: an enum narrows the field's predictor, map values complete from their value type, and a type's Predict runs only when the shell completes that field. Programs that declare enum on path fields now fail at startup.

🚀 Highlights

  • enum narrows completion: A field with an enum tag offers only the enum values, drawn from its predictor so they keep their descriptions and order. system.Signal with enum:"TERM,INT,HUP" now offers three signals instead of every spelling of every signal. The new predict.Predictor.Include exposes the same filter to predictor authors (#218, closes #128).
  • Map values complete: Map flags and positionals complete the value after key= from the value type's predictor, so map[string]*time.Location with timezone.RegisterLocation offers time zones after eu=. A map without help names its value type in the hint, such as <key>=<Path to a file> (#223, closes #217).
  • Predict runs only when needed: With completion enabled, ordinary runs, --help and --why no longer call every type's Predict. A completion request calls it only for the field being completed (#222, closes #129).

⚠ Breaking Changes & Migration

  • enum on path fields fails at startup (#221): Schema build rejects enum with ErrSchema on conga.File, conga.Dir, conga.FileContent (including slices and pointers of them), on types implementing predict.FileFilterable, DirFilterable or PathFilterable, and on fields with a file, dir, exec or symlink predictor. Remove enum, use glob on conga.File, or use a string field with enum and no path predictor. conga-lint reports the same error.

✨ Features

  • completion: Add predict.Predictor.Include(values ...string), and narrow a field's predictor to its enum values (#218).
  • completion: Complete map values from their value type. Entries split at the first = as the run does, predictor:"file" (or dir, exec, symlink) on a map completes the value after key=, and slice and map element predictors keep a timeout raised with Timeout(d) (#223).

🐛 Bug Fixes

  • completion: Call a type's Predict only when completing that field. In programs with completion enabled, a panicking Predict now fails only that field's completion request (exit 2) instead of crashing every run (#222).
  • completion: Slice completion keeps envs/dev.yaml after dev.yaml was given. predict.Predictor.Exclude and Raw now compare each candidate's Value after Prefix and Suffix, never Display; on a MultiParts predictor, call Exclude on the predictor the segment function returns (#218).
  • completion: Finished segmented values such as --image api-gateway:v3.2.0 and later list elements get a trailing space, and Timeout alternatives keep their own modifiers (#218).
  • lint: Report the map tag rules (no enum, range or len on a map, string keys only) as the program does, stop reporting domain tags such as existing:"true" on OptionalFlag[*conga.File] as unknown, and report range on a map with the program's message (#221).

Full Changelog: v0.10.0...v0.11.0

Requirements: Go 1.27+ · Docs · pkg.go.dev

v0.10.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 18:20
Immutable release. Only release title and notes can be modified.
54d7ef4

CONGA v0.10.0 simplifies typed map binding—eliminating App.RegisterMap—and tightens startup validation across map types, config environment variables, boolean struct tags, and conga-lint diagnostics.

🚀 Highlights

  • Zero-registration typed maps: Typed maps now bind automatically without App.RegisterMap and parse keys and values through registered TypeParsers, including maps keyed or valued by named string types. Slice- and map-kind types with their own text unmarshaler, such as net.IP, bind as one value, and a missing parser fails at startup (#210, #215).
  • Safer config-variable reservation: Apps reserve <PREFIX>_CONFIG only when they register a config decoder or declare a ConfigFile field, and both runtime schema build and conga-lint catch flags or features bound to that variable at startup (#214, #216).
  • Strict boolean tags & unified schema diagnostics: hidden, negatable, and bootstrap reject misspelled tag values at startup (#212), and conga-lint shares exact schema error formatting with the runtime (#211).

⚠ Breaking Changes & Migration

API changes

  • App.RegisterMap removed; RegisterType rejects slices and maps (#210, closes #121, #113):
    • Delete app.RegisterMap(...) calls—typed maps now bind automatically.
    • Move any predictor previously passed to RegisterMap onto a predictor:"<name>" struct tag paired with app.Predictor("<name>", p), or implement a Predict method on a named map type.
    • App.RegisterType now panics for slice and map types; register a TypeParser for the element or value type instead.

Schema & startup guards

  • Config environment variable collisions (#214, closes #168):
    • In apps that read a config variable (via a registered decoder or a ConfigFile field), any flag or feature bound to that variable (such as a Config flag under EnvPrefix) now fails at startup with ErrSchema. Give it an explicit env:"..." tag or opt out with env:"-".
  • Unparseable field types fail at startup (#210):
    • Any flag or positional argument whose type, slice element, or map key/value has no parser now fails schema build with ErrSchema instead of failing later when a user supplies a value.
  • Strict boolean struct tags (#212, closes #165):
    • hidden, negatable, and bootstrap values other than empty, "true", or "false" (such as "yes", "1", or "True") now fail at startup with ErrSchema. Use the bare tag, "true", or "false".

Configuration

  • Config environment variable only for config-capable apps (#214, closes #168):
    • Apps without a decoder or ConfigFile field no longer read <PREFIX>_CONFIG, and env:"-" on ConfigFile now disables its environment variable.

Errors & diagnostics

  • Unified schema and conga-lint error wording (#211, closes #126):
    • Shadowing errors end in "on an ancestor command" without the command name.
    • Missing-Runner errors read: struct <Name>: schema error: runner not implemented: implement conga.Runner: Run(context.Context, *conga.Session) error.
    • Duplicate ConfigFile errors read: duplicate ConfigFile field (already declared by field <First>).
    • Update callers or tests that assert the previous message text.

🐛 Bug Fixes

  • maps: Bind maps keyed or valued by named string types without panicking in reflect.Value.Convert (#215).
  • lint: Report flags, features, and Features map variables bound to the reserved config-file environment variable, matching runtime schema build (#216).

📚 Documentation

  • struct-tags: Clarify that the len tag measures rune count on strings and applies per element on slices, while maps use items and reject len at schema build (#213, refs #166).

Full Changelog: v0.9.0...v0.10.0

Requirements: Go 1.27+ · Docs · pkg.go.dev

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 17:34
Immutable release. Only release title and notes can be modified.
4965321

CONGA v0.9.0 is a broad reliability release covering strict configuration key matching, source-aware error classification, stricter flag and input parsing, and cross-shell completion fixes.

🚀 Highlights

  • Exact config key matching & casing options: Configuration files match keys strictly by config tag or flag name, with conga.ConfigKeyCase (KebabCase, SnakeCase, CamelCase) for app-wide casing (#183).
  • Source-aware error classification: Environment-, config-, and default-sourced value and group failures now classify consistently under ErrConfig (exit 1, no usage block) instead of usage errors (exit 2) (#190, #192, #205).
  • Stricter parsing & safer executables: Counter rejects =N on the CLI, empty boolean values fail cleanly, repeated stdin reads are caught before coercion, and ./tool executables resolve in the working directory rather than $PATH (#186, #187, #193, #203).
  • Cross-shell completion & LS_COLORS: Multibyte cursor handling, quote/escape handling across Bash/Zsh/Fish/PowerShell/Nushell, keeporder support, and LS_COLORS SGR styling (#198, #199, #201).

⚠ Breaking Changes & Migration

Schema & startup guards

  • Built-in and Features flag collisions (#189, closes #148):
    • An ancestor --json flag with a mounted VersionCommand, or an ancestor flag colliding with a CLI-exposed Features flag, now fails schema build with ErrSchema. Rename the ancestor flag or rely on --version.
  • feature on implicit:"true" commands (#194, closes #160, #161):
    • Declaring a feature tag on an implicit:"true" command fails schema build with ErrSchema; gate the parent command or make the subcommand explicit.
  • bootstrap on FileContent (#187):
    • bootstrap:"true" on a FileContent field now fails schema build with ErrSchema; use conga.File and read it in Bootstrap.

Configuration

  • Exact config keys and nested sections (#183, closes #142, #143, #182):
    • Config keys must match the flag name or config tag exactly (api_endpoint no longer binds --api-endpoint by default and fails with ErrConfig, exit 1). Update your config file, set conga.ConfigKeyCase(conga.SnakeCase), or add config:"<key>".
    • Flag/subcommand aliases no longer work as config keys, dotted config tags map only to nested sections, and flags with an explicit config tag no longer fall back to their flag name.
  • <PREFIX>_CONFIG outranks conga.ConfigExplicit (#135, closes #117):
    • Config targets now resolve in order: --config-file > <PREFIX>_CONFIG > ConfigExplicit(path) > search paths. When <PREFIX>_CONFIG is set, a missing ConfigExplicit file is no longer read or errored on.
  • Stricter HCL, JSON, and YAML decoding (#184, closes #145, #146):
    • HCL labeled blocks and attribute/block name collisions fail to load instead of being dropped.
    • Integers outside the int64 and uint64 ranges fail to load in JSON, YAML, and HCL with ErrConfig (exit 1), and the cause matches the decoder's own ErrParse (for example json.ErrParse). JSON and HCL also reject numbers that overflow float64.
  • .env escaped dollars (#195, closes #159):
    • \$ inside a double-quoted .env value is now a literal $ instead of starting variable expansion.

Command-line behaviour

  • Strict Counter flags (#186, closes #149):
    • Counter rejects attached CLI values (--verbose=2, -v=2); repeat the flag (-vv), set via env/config, or use OptionalFlag[int].
    • Negative and signed counts from env/config are rejected, and counter errors now say "unsigned integer".
  • Empty booleans rejected (#193, closes #171):
    • --flag=, empty map[string]bool values, and empty boolean config strings no longer mean true. Pass --flag or --flag=true.
  • FileContent, stdin, and repeated scalar flags (#187, closes #147, #150, #151, #152):
    • A scalar FileContent flag can only be given once on the CLI, and a second value reading - (across FileContent or File with stdin:"true") is a usage error.
    • Repeated scalar flags coerce every occurrence instead of only the last, so an earlier invalid value now fails the run.
  • File with executable:"true" resolves relative paths cleanly (#203, closes #188):
    • ./tool resolves in the working directory instead of $PATH, all executable paths are normalized to absolute paths, and missing/non-executable ./name fails with ErrValidation instead of ErrCoerce.

Errors & diagnostics

  • Source-based error categories (#190, closes #133, #162):
    • Env-, config-, and default-sourced value failures match ErrConfig only (exit 1, IsUsageError false) instead of ErrCoerce/ErrValidation (exit 2).
    • This replaces the v0.8.0 change that made config-sourced feature errors usage errors.
    • Unexpected arguments and negated flags with values match ErrParse; wrong path kinds match ErrValidation; missing Runner matches ErrSchema.
  • Group conflict attribution & --why (#192, closes #170):
    • xor, oneof, and and conflicts whose members all come from env/config match ErrConfig only (exit 1, IsUsageError false). Messages identify non-CLI members by source and CLI members by typed spelling; --why no longer aborts on group conflicts.
  • Updated error & --why=json formats:
    • --why=json reports bypassed search paths and overridden named files with paths[].status set to "skipped" (#137, #185).
    • Feature errors drop the "config error:" prefix, name their source, and render compound/negated gates in words (#194).
    • Unknown-flag suggestions use 'unknown flag: --prot (did you mean "--port"?)' (#196).

✨ Features

  • config: Add conga.ConfigKeyCase (KebabCase, SnakeCase, CamelCase) for derived config keys (#183).
  • completion: Honour LS_COLORS SGR codes and file-kind indicators (di, ln, or, ex, *<suffix>) in path predictors (#201, closes #156).

🐛 Bug Fixes

  • api: conga.TypeParser is again an alias of func(string) (U, error), so RegisterType accepts named function types as before v0.8.0 (#141).
  • completion: Write the bash lazy-load completion file under ${XDG_DATA_HOME:-$HOME/.local/share} and add an fpath fallback to the Homebrew zsh install steps (#141).
  • lint: conga-lint prints related notes, and its -test flag wins over a same-named analyzer flag (#141).
  • validation: Compare float32 range bounds at float64 precision and report exact ByteSize overflow limits and accepted units (#187, closes #147, #152).
  • cli: Allow repeated identical - stdin claims on a single scalar File/FileContent flag (#205).
  • config: Report errors in dotted namespace sections the same way as command sections (#205).
  • errors: Let errors.Is reach the underlying cause of config-sourced ErrConfig errors (#205).
  • cli: Fix pluralization and natural list joining in and-group errors, remove [command] from RawArgs usage lines, and route help <unknown> through command suggestions (#140, #196...
Read more

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 18:12
Immutable release. Only release title and notes can be modified.
fd4713d

CONGA v0.8.0 overhauls the documentation site on docs.conga.sh, introduces conga.TypeParser, and ships diagnostics and completion installation fixes uncovered during the rewrite.

🚀 Highlights

  • Documentation site rewrite: Rebuilt the documentation around tutorials, how-to guides, reference pages, and explanations, with rendered keyboard shortcuts via starlight-kbd (#118, #120).
  • Named parser type & relative conga-lint paths: Exported conga.TypeParser for RegisterType callbacks and switched conga-lint diagnostics to working-directory-relative paths (#118).

⚠ Breaking Changes & Migration

  • Config-sourced feature errors & source attribution (#118):
    • Invalid feature values read from a config file now fail as usage errors (exit 2) rather than ErrConfig (exit 1), matching CLI and environment values. (Note: later superseded by source-based ErrConfig classification in v0.9.0.)
    • Flag and feature value errors now include the environment variable or config key the value came from; update tests or callers matching the previous message text.

✨ Features

  • api: Export the conga.TypeParser signature for App.RegisterType (#118).
  • lint: Print conga-lint diagnostic paths relative to the working directory (#118).

🐛 Bug Fixes

  • errors: List accepted boolean values (including 1 and 0) in boolean parse error messages (#118).
  • completion: Correct and complete per-shell completion installation instructions (#118).

📚 Documentation

  • website: Rewrite the documentation site (#118) and render keyboard keys with starlight-kbd (#120).

Full Changelog: v0.7.0...v0.8.0

Requirements: Go 1.27+ · Docs · pkg.go.dev

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 19:19
Immutable release. Only release title and notes can be modified.
f4b993f

CONGA v0.7.0 removes the blank-field form of envprefix and lets completion-enabled applications have names that start with a digit.

⚠ Breaking Changes & Migration

  • Blank-field envprefix removed (#106, closes #100):
    • _ struct{} `envprefix:"APP_"` fails schema build with ErrSchema. Set the root prefix with app.EnvPrefix("APP_"), and a subcommand's prefix with an envprefix tag on its Command[T] field.
    • A subcommand envprefix replaces the inherited prefix rather than extending it. This was already the behaviour; the docs now say so.

✨ Features

  • completion: A derived completion prefix that would start with a digit gains a leading underscore instead of failing at startup, so 7z reads _7Z_COMPLETION_DESCRIPTIONS. An explicit conga.CompletionEnvPrefix that starts with a digit is still rejected (#104, closes #102).

📚 Documentation

  • website: Clarify that App.EnvPrefix does not apply to Features containers (#107).

Full Changelog: v0.6.0...v0.7.0

Requirements: Go 1.27+ · Docs · pkg.go.dev

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 15:04
Immutable release. Only release title and notes can be modified.
0de3091

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, so tool ./script.ts runs as tool run ./script.ts (#98).
  • Trailing argument completion: DashArgs and RawArgs accept a predictor tag and complete after -- or once raw mode begins (#95).

⚠ Breaking Changes & Migration

  • -- ends subcommand routing (#95):
    • Operands after -- no longer name subcommands. They bind to DashArgs or positional arguments, or fail as unexpected arguments. Declare DashArgs on the command that should receive them.
  • Trailing argument grammar is checked at startup (#95):
    • Schema build fails with ErrSchema when a command declares both positional arguments and subcommands, combines RawArgs with command fields, puts optional or variadic positionals before RawArgs, or declares duplicate trailing collectors.
    • Move positionals to leaf commands, and use DashArgs to forward arguments after -- from a command with subcommands.
  • 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 --verbose now fails with flag requires an argument: --name (exit 2). Pass such values attached: --name=--verbose.

✨ Features

  • cli: Add implicit:"true" subcommands, marked (default) in help (#98).
  • completion: Complete DashArgs and RawArgs with predictor tags, and offer no candidates after -- when the command has nowhere to bind them (#95).

🐛 Bug Fixes

  • cli: A declared --help or --version flag also disables the synthesized -h or -V short 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

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 01 Nov 16:50
Immutable release. Only release title and notes can be modified.
dec1a9f

CONGA v0.5.0 renames the group help-heading tag to section and rejects flag groups and tags that previously had no effect.

⚠ Breaking Changes & Migration

  • group tag renamed to section (#91, closes #87):
    • Rename group:"..." to section:"..." on flags, commands, and built-in command fields. group is now an unknown tag and fails schema build with ErrSchema unless allowed with app.AllowTags("group").
  • Flag groups that had no effect are rejected (#91):
    • A one-member xor or and group, a one-member oneof group on a flag other than a Counter, and a flag in both an exclusive (xor or oneof) group and an and group fail schema build with ErrSchema.
    • Remove the group tag, add the missing members, or use RequiredFlag instead of a one-member oneof.
  • CONGA tags on plain fields are rejected (#91):
    • CONGA tags on fields that are not containers used to be ignored. They now fail schema build with ErrSchema. Remove the tags, or make the field a container.

📚 Documentation

  • website: Document flag grouping, built-in short flags, and help wrapping (2d443b4).

Full Changelog: v0.4.0...v0.5.0

Requirements: Go 1.27+ · Docs · pkg.go.dev

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 23:35
Immutable release. Only release title and notes can be modified.
db0d406

CONGA v0.4.0 wraps help to the terminal width, adds oneof flag groups and short flags for the built-in help and version flags, and names completion environment variables after the application.

🚀 Highlights

  • Help wrapping: Help output wraps to COLUMNS, the terminal width, or 100 columns, and aligns columns by terminal cell width (#88).
  • oneof flag groups: Exactly one member of a oneof group must be set. Usage shows the group as (--input-file=PATH | --input-url=URL), and completion hides the other members once one is given (#88).
  • Built-in short flags: App.HelpShortFlag and App.VersionShortFlag bind a short rune to --help and --version (#88).
  • App-named completion variables: Completion toggles are read from <APP>_COMPLETION_*, and conga.CompletionEnvPrefix overrides the prefix (#82).

⚠ Breaking Changes & Migration

API changes

  • WhyJSON and RegisterTypeOption renamed (#84):
    • Replace conga.WhyJSON() with conga.WhyOptionJSON() and the conga.RegisterTypeOption type with conga.RegistrationOption.

Schema & startup guards

  • RequiredFlag rejects default and xor (#88):
    • Either tag on a RequiredFlag fails schema build with ErrSchema. Use OptionalFlag fields in a oneof group instead.
  • conga directives removed (#88):
    • conga:"ignore" and conga:"-" no longer exclude a field. Plain fields that are not containers need no tag. Remove from the struct any container field CONGA should skip.
    • Any remaining conga tag is an unknown tag and fails schema build with ErrSchema unless allowed with app.AllowTags("conga").

Configuration

  • Completion environment variables named after the application (#82, closes #81):
    • CONGA_COMPLETION_ALIASES and CONGA_COMPLETION_DESCRIPTIONS are now <APP>_COMPLETION_ALIASES and <APP>_COMPLETION_DESCRIPTIONS, where <APP> is the application name in upper snake case. Rename them in shell configuration, or pass conga.CompletionEnvPrefix(...) to EnableCompletion to choose the prefix.

✨ Features

  • cli: Wrap help output to the terminal width and align tables by terminal cell width (#88).
  • cli: Add oneof groups for exactly-one flag sets (#88).
  • cli: Add App.HelpShortFlag and App.VersionShortFlag for built-in short flags; collisions with declared shorts fail schema build (#88).
  • cli: Help, usage, and version output use the configured application name instead of the invoked binary name (#88).
  • completion: Read completion toggles from application-prefixed variables and add conga.CompletionEnvPrefix (#82, closes #81).
  • completion: Offer flags only after - in every shell, not at a bare space; set <APP>_COMPLETION_BARE_SPACE_FLAGS or the bare-space-flags zstyle to restore them. Zsh also resolves ~name named directories (#86).

Full Changelog: v0.3.0...v0.4.0

Requirements: Go 1.27+ · Docs · pkg.go.dev

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 18:27
Immutable release. Only release title and notes can be modified.
8282f08

CONGA v0.3.0 replaces ConfigLoader with the Bootstrapper lifecycle hook and adds completion toggles for aliases and descriptions.

🚀 Highlights

  • Bootstrapper lifecycle hook: Bootstrap(ctx, *conga.Bootstrap) runs before config resolution. It can load .env files from flag-derived paths and supply a ConfigDocument that overlays file configuration key by key (#70).
  • Completion toggles: CONGA_COMPLETION_ALIASES and CONGA_COMPLETION_DESCRIPTIONS control whether aliases and descriptions appear, in every shell (#76).

⚠ Breaking Changes & Migration

  • ConfigLoader replaced by Bootstrapper (#70):

    • conga.ConfigLoader, ConfigLoaderFunc, and ConfigContext are removed. Implement Bootstrap(ctx context.Context, b *conga.Bootstrap) error on the root command, build the same ConfigDocument, and pass it to b.SetConfig. b.LookupEnv and b.Path replace ConfigContext.LookupEnv and CommandPath.
    • A ConfigLoader replaced configuration file resolution. SetConfig overlays file configuration key by key instead, so files found through decoders and search paths now load as well.
    // Before
    app.ConfigOptions(conga.ConfigLoader(func(ctx conga.ConfigContext, root *CLI) (*conga.ConfigDocument, error) {
    	return loadDocument(root)
    }))
    
    // After
    func (c *CLI) Bootstrap(ctx context.Context, b *conga.Bootstrap) error {
    	document, err := loadDocument(c)
    	if err != nil {
    		return err
    	}
    
    	b.SetConfig(document)
    
    	return nil
    }

✨ Features

  • completion: Add the CONGA_COMPLETION_ALIASES and CONGA_COMPLETION_DESCRIPTIONS toggles, mark aliases on the wire, and honour the zsh verbose and show-aliases styles (#76). (Renamed after the application in v0.4.0.)

🐛 Bug Fixes

  • completion: Honour the zsh list-separator style in list-colors patterns, so both columns keep their colours (#77).

📚 Documentation

  • website: Reframe the bootstrap docs as domain document loading (#78).

Full Changelog: v0.2.0...v0.3.0

Requirements: Go 1.27+ · Docs · pkg.go.dev

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 24 Oct 18:12
Immutable release. Only release title and notes can be modified.
f120511

CONGA v0.2.0 adds per-feature environment variables, makes struct tag validation always on, and lets applications replace the writer that .env loading uses.

🚀 Highlights

  • Per-feature environment variables: envprefix on a Features container derives one variable per feature, feature fields accept env tags, and root help lists each feature's variables (#53, #57).
  • Always-on tag validation: Unknown struct tag keys always fail schema build, and app.AllowTags is the only way to accept extra keys (#58).
  • Injectable .env writer: App.SetenvFunc replaces the os.Setenv call that App.Dotenv uses, so tests can pass t.Setenv (#55).

⚠ Breaking Changes & Migration

  • App.StrictTagValidation removed (#58):
    • Struct tag validation is always on. Delete StrictTagValidation(...) calls, and list any foreign tag keys with app.AllowTags("<key>", ...), which matches keys exactly.
    • The conga:"allow-unknown-tags" and conga:"recurse" directives fail schema build with ErrSchema. Replace them with app.AllowTags.
    • conga-lint drops its -strict flag.
  • envprefix on a Features container derives one variable per feature (#53, closes #49):
    • envprefix:"APP" used to derive one combined name=value map variable, APP_<FLAG>, from the container's flag name. It now derives APP_<FEATURE> for each feature.
    • To keep a single combined variable, name it with env:"<NAME>" on the container instead of envprefix.
  • {{env}} in Features help text (#57):
    • {{env}} now substitutes only the container's combined-map env variable. A container whose only environment surface is envprefix or field env tags fails schema build with ErrSchema.
    • Remove {{env}} from such help text. Root help now lists each feature's variables as [env: ...].

✨ Features

  • features: Feature fields accept env:"NAME1,NAME2" and env:"-", and an invalid per-feature value is a usage error naming the variable (#53, closes #49).
  • features: Root help lists each feature's environment variables as [env: VAR1, VAR2] (#57).
  • dotenv: Add App.SetenvFunc to replace the writer App.Dotenv uses for loaded variables (default os.Setenv) (#55, closes #51).
  • config: Config-file flag help lists the registered decoders, for example [decoders: .json, .yaml] (#59).
  • why: Help shows --why[=FORMAT], and completion offers --why=<format>, only when JSON output is enabled with WhyJSON() (#61).
  • cli: Built-in help, version, and completion command fields accept aliases and group tags (#66). (group was renamed section in v0.5.0.)

🐛 Bug Fixes

  • cli: Synthesized help, version, and completion commands follow the app-wide built-in visibility toggles, and disabled --why and --completion flags no longer appear on subcommands (#64).

📚 Documentation

  • website: Document --why flag help and completion rendering (#67).

Full Changelog: v0.1.1...v0.2.0

Requirements: Go 1.27+ · Docs · pkg.go.dev