Implement CLI argument parsing with Version and Diagnostics support

[github-actions[bot]]

Overview: The CLI entrypoint currently logs only raw arguments. We need to implement robust argument parsing to support the core flags --help, --version, and --diagnostics. This will improve usability and ensure users can quickly access usage information, version data, and environment diagnostics.

Acceptance Criteria:

1. parseArgs(args: string[]): { help: boolean; version: boolean; diagnostics: boolean } must return correct boolean flags for no args, each supported flag alone, and exit with code 1 for any unrecognized flag.
2. printUsage() prints a clear usage string that lists supported flags and exits with code 0.
3. printVersion() reads the version field from package.json, prints it exactly, and exits with code 0.
4. printDiagnostics() collects and prints JSON with keys nodeVersion (string), platform (string), cwd (string), and env (object of filtered environment variables), then exits with code 0.
5. main(args) dispatches in order: --help → printUsage, --version → printVersion, --diagnostics → printDiagnostics, otherwise falls back to console.log('Options:', options) without exiting.
6. Unit tests cover: • parseArgs behavior (all flags false by default, each flag true when provided, exit on unknown flag). • printUsage, printVersion, and printDiagnostics output to console.log and appropriate process.exit codes (use spies/mocks). • main dispatch logic issuing the correct function calls and exit codes.
7. README.md under CLI Usage includes descriptions and inline examples for npm run start --help, npm run start --version, and npm run diagnostics.

Implementation Steps:

• Install minimist and import in src/lib/main.js.
• Create and export parseArgs.
• Implement and export printUsage, printVersion, printDiagnostics.
• Update main to call these in the required order.
• Add/update tests in tests/unit/main.test.js to validate new functions and dispatch logic.
• Update README.md accordingly.

Verification:

• npm test passes all existing and new tests.
• npm run start --help outputs usage text and exits 0.
• npm run start --version outputs correct package.json version and exits 0.
• npm run diagnostics outputs valid JSON diagnostics and exits 0.
• Unknown flags cause an error message and exit code 1.

[github-actions[bot]]

This issue has been reviewed and marked as 'ready'. The description has been updated with testable acceptance criteria, and relevant library documents ([], 0 in total) have been added as comments.

[github-actions[bot]]

Implement CLI argument parsing with version and diagnostics support and update tests and docs

[github-actions[bot]]

https://github.com/xn-intenton-z2a/repository0/tree/agentic-lib-issue-2302

[github-actions[bot]]

Workflow name: transformation-07.1-in-progress-issue-to-ready-issue Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15281617991 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/bda6a4fe08c3f5d139d9c512eedd67fa775058b1