feat: Implement Class-Based Help System (CLIHelp) and Core Refactoring

[supitsdu]

This pull request introduces a significant overhaul of the help system in the Climonad CLI framework, transitioning from a flag-based help configuration to a class-based approach using the new CLIHelp class. It also includes updates to improve maintainability, extensibility, and test coverage. Below are the most important changes grouped by theme:

Help System Enhancements

• Introduced the CLIHelp class to encapsulate help functionality, allowing for more structured and customizable help behavior. The class supports both flag-based (--help) and command-based (help) triggers (src/ui/help.ts, README.md, docs/help-system.md, docs/core-concepts.md). [1] [2] [3]
• Added the createCLIHelp utility function to simplify the creation of CLIHelp instances with options for customizing names, descriptions, aliases, and trigger types (src/ui/help.ts, README.md, docs/core-concepts.md). [1] [2] [3]
• Updated the README.md and documentation to reflect the new class-based approach and provide examples for creating and integrating custom help reporters (README.md, docs/core-concepts.md, docs/help-system.md). [1] [2] [3]

Core Refactoring

• Refactored the CLI class to replace the old helpReporter and help flag system with the CLIHelp class, improving modularity and reducing boilerplate (src/createCLI.ts). [1] [2]
• Introduced helper functions parseInputToTokens and processTokens to streamline token processing and improve readability of the CLI parsing logic (src/helpers/cli-helpers.ts).

Testing Improvements

• Updated test cases to accommodate the new CLIHelp class, including mocking the createCLIHelp utility and testing the integration of CLIHelp instances (test/createCLI.test.ts). [1] [2] [3]

Version Update

• Bumped the package version from 1.0.0-alpha.2 to 1.0.0-alpha.3 to reflect the significant changes and enhancements (package.json).

These changes collectively improve the flexibility, maintainability, and user experience of the help system in the Climonad framework.