feat(cli): implement CLI entry point and enhance error handling for missing options

[jiashengguo]

Summary by CodeRabbit

• New Features
  • Added a dedicated command-line entry point for running the application.
  • Added an additional CLI command alias.
• Bug Fixes
  • Improved detection of direct CLI execution across supported invocation paths.
• Tests
  • Added coverage confirming the CLI displays usage information and exits appropriately when required options are missing.

[coderabbitai]

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Free

Run ID: 1943e463-791a-4ada-ab88-0e8d3a6841cf

📥 Commits

Reviewing files that changed from the base of the PR and between 2b42ff2 and 4493228.

📒 Files selected for processing (4)

• package.json
• src/cli.ts
• src/index.ts
• tests/cli.test.ts

---

📝 Walkthrough

Walkthrough

The package now uses dist/cli.js as its binary entrypoint. A dedicated wrapper invokes the exported main function. Direct execution uses resolved paths, and an integration test validates missing-option handling.

Changes

CLI entrypoint

Layer / File(s)	Summary
CLI wrapper and package wiring package.json, src/cli.ts, src/index.ts	The package binaries target dist/cli.js. The build marks both CLI files executable. src/cli.ts invokes the exported main function.
Resolved direct execution and CLI validation src/index.ts, tests/cli.test.ts	Direct execution compares realpath-resolved paths and handles resolution errors. The integration test checks status 1 and usage output when required options are missing.

Estimated code review effort: 2 (Simple) | ~10 minutes

Mergeability Score: ⚪ Minimal · up to 44932

This localized CLI and error-handling change has no actionable merge-blocking risk identified at the current head and is merge-ready after normal checks and review.

Sequence Diagram(s)

sequenceDiagram
  participant PackageBinary
  participant CLIWrapper
  participant Main
  participant CLIIntegrationTest
  PackageBinary->>CLIWrapper: invoke dist/cli.js
  CLIWrapper->>Main: call main()
  Main-->>PackageBinary: print usage and exit with status 1
  CLIIntegrationTest->>PackageBinary: execute without required options
  PackageBinary-->>CLIIntegrationTest: return status and stderr

Loading

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands.}