Feature/shell completions

[dvoraj75]

This pull request updates the documentation and example config files to reflect several new features and improvements for the upcoming 1.5.0 release. The main focus is on introducing shell completion support, new configuration options for notifications and the indicator, improved config validation and error handling, and updating CLI documentation to include the new completions subcommand. No code changes are present in this diff; all updates are to documentation and example files.

Key documentation and config improvements:

Shell completion support and CLI changes

• Added documentation for the new forgewatch completions <shell> subcommand, which generates Bash, Zsh, or tcsh shell completions using shtab. The CLI is now described as supporting setup, service, uninstall, and completions subcommands, and the --config flag supports file-path completion. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]

New configuration options and documentation

• Documented new [notifications] and [indicator] sections in the config, including notification grouping, per-repo overrides, and indicator-specific settings (reconnect_interval, window_width, max_window_height). Example configs and validation rules for these sections are provided. [1] [2] [3] [4] [5] [6] [7]

Improved config validation and error handling

• Updated documentation to describe the new config validation behavior: all errors are collected and reported at once, error messages include actionable hints, and unrecognised top-level keys now produce a warning instead of being silently ignored. Also, config errors are now caught and displayed as user-friendly log messages, with remediation hints and clean exit codes. [1] [2] [3]

Changelog updates

• Added a new section for version 1.5.0 (unreleased) in CHANGELOG.md, summarizing all the above new features, changes, and improvements.

[github-actions]

☂️ Python Coverage

current status: ✅

Overall Coverage

Lines	Covered	Coverage	Threshold	Status
1928	1836	95%	90%	🟢

New Files

No new covered files...

Modified Files

File	Coverage	Status
forgewatch/_main_.py	98%	🟢
forgewatch/cli/_init_.py	100%	🟢
forgewatch/config.py	82%	🟢
forgewatch/daemon.py	100%	🟢
forgewatch/indicator/_main_.py	95%	🟢
forgewatch/indicator/app.py	100%	🟢
forgewatch/indicator/client.py	98%	🟢
forgewatch/indicator/window.py	85%	🟢
forgewatch/notifier.py	99%	🟢
forgewatch/poller.py	96%	🟢
TOTAL	95%	🟢

updated for commit: 39873cd by action🐍