- add CommandExecutor to unify shared command execution lifecycle
across Falyx and standalone command execution
- add CommandRunner for running a single Command directly as a CLI
or programmatic entrypoint
- add Command.build() factory and rename parse_args() to resolve_args()
to clarify the parsing-to-execution boundary
- introduce ExecutionOption and wire execution-scoped flags into
CommandArgumentParser and Command construction
- refactor Falyx to use FalyxParser/ParseResult and CommandExecutor
instead of the older argparse-based flow and run_key path
- simplify __main__.py bootstrap by building a bootstrap Falyx instance
directly and running flx.run()
- improve completer support for preview commands and unique-prefix
command resolution
- default BottomBar toggle namespace to "default"
- expand module/class docstrings to reflect the new execution architecture
- Renamed CLI subcommand from `list` to `help` for clarity and discoverability.
- Added `--key` and `--tldr` support to the `help` command for detailed and example-based output.
- Introduced `FalyxMode.HELP` to clearly delineate help-related behavior.
- Enhanced `_render_help()` to support:
- Tag filtering (`--tag`)
- Per-command help (`--key`)
- TLDR example rendering (`--tldr`)
- Updated built-in Help command to:
- Use `FalyxMode.HELP` internally
- Provide fallback messages for missing help or TLDR data
- Remove `LIST` alias (replaced by `help`)
- Documented `FalyxCompleter`:
- Improved docstrings for public methods and completions
- Updated internal documentation to reflect all supported completion cases
- Updated `CommandArgumentParser.render_tldr()` with fallback message for missing TLDR entries.
- Updated all parser docstrings and variable names to reference `help` (not `list`) as the proper CLI entrypoint.
- Added test coverage:
- `tests/test_falyx/test_help.py` for CLI `help` command with `tag`, `key`, `tldr`, and fallback scenarios
- `tests/test_falyx/test_run.py` for basic CLI parser integration
- Bumped version to 0.1.81
