GitHub
02/12/2026, 9:12 AMmeltano config <plugin> list output can be large (SDK plugins have many settings), and users have no way to tell which settings are required vs optional. Plugins already define settings_group_validation (array of arrays, each inner array is a valid combination of required setting names) but this metadata was never surfaced in the CLI.
This PR adds visual cues to meltano config list output:
• Group summary header printed before the settings list when validation groups exist. For multiple groups it shows each valid combination; for a single group it lists the required settings.
• Per-setting labels annotated inline:
• (required) — setting appears in all validation groups (always needed)
• (required by group N) — setting appears in only some groups
• No annotation for optional settings
Example output for `tap-gitlab`:
Setting groups (one of the following combinations is required):
Group 1: api_url, groups, start_date
Group 2: api_url, projects, start_date
api_url (required) [env: TAP_GITLAB_API_URL] current value: '<https://gitlab.com>' (default)
groups (required by group 1) [env: TAP_GITLAB_GROUPS] current value: '' (default)
projects (required by group 2) [env: TAP_GITLAB_PROJECTS] current value: '' (default)
start_date (required) [env: TAP_GITLAB_START_DATE] current value: None (default)
Plugins without settings_group_validation (including meltano itself) are unaffected.
Checklist
• I have read the contribution guide
Was generative AI tooling used to co-author this PR?
• Yes — Claude Code (Claude Opus 4.6)
Generated-by: Claude Code following the agentic coding guidelines
Related Issues
• Closes #9043
Summary by Sourcery
Surface plugin required-setting group metadata in the meltano config list CLI output.
New Features:
• Display a summary of settings validation groups before the config list output when plugins define settings group validation.
• Annotate individual settings in config list with required-status labels based on the validation groups.
Tests:
• Extend CLI config list tests to cover required-setting labels, group summaries, and behavior when no or a single validation group is defined.
• Add tests for the helper that formats required-setting labels from group membership metadata.
meltano/meltanoGitHub
02/13/2026, 4:17 AMGitHub
02/13/2026, 4:42 AMGitHub
02/24/2026, 7:44 PM