Skip to content

fix(cli): correct --roster help text to state true default resolution order (#102) - #104

Open
ghzhost wants to merge 1 commit into
Jason-Vaughan:mainfrom
ghzhost:fix-roster-help-text
Open

fix(cli): correct --roster help text to state true default resolution order (#102)#104
ghzhost wants to merge 1 commit into
Jason-Vaughan:mainfrom
ghzhost:fix-roster-help-text

Conversation

@ghzhost

@ghzhost ghzhost commented Aug 16, 2026

Copy link
Copy Markdown

Problem

tanglebrain --help stated that the default --roster path is tanglebrain/config/roster.yaml. In practice, default_roster_path() resolves:

  1. $TANGLEBRAIN_ROSTER environment variable
  2. $XDG_CONFIG_HOME/tanglebrain/roster.yaml (or ~/.config/tanglebrain/roster.yaml) if it exists
  3. The packaged generic example (tanglebrain/config/roster.yaml)

Misstating this default in --help leads operators debugging routing to look at and edit the wrong file.

Changes

  • Updated --roster help text in tanglebrain/cli.py to describe the actual resolution order ($TANGLEBRAIN_ROSTER, ~/.config/tanglebrain/roster.yaml, or packaged example).
  • Added regression test test_roster_help_text_states_discovery_order in tests/test_cli.py.
  • Added changelog entry in CHANGELOG.md under [Unreleased] -> Fixed.

Closes #102

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[bug] --roster help text misstates the default roster path

1 participant