Add version and help support

[shellicar]

Summary

• Switch build-version plugin from gitversion to git calculator
• Add --version/-v, --help/-h/-? CLI args via node:util parseArgs
• Add /version and /help in-session slash commands
• Extract shared printVersion, printUsage, printHelp functions

Co-Authored-By: Claude noreply@anthropic.com

[bananabot9000]

Review

Clean, well-structured. Proper CLI behaviour for a package that's about to be published.

What's good

• Shared Log type — (msg: string) => void callback means printVersion/printHelp work both pre-startup (console.log) and in-session (term.info). No duplication, same functions used in both contexts. Nice pattern.

• help.ts extraction — All help/version text in one file. Easy to maintain, easy to find, no string literals scattered across main.ts and ClaudeCli.ts.

• node:util parseArgs — Using the built-in instead of pulling in commander or yargs for two flags. Right call for something this simple.

• strict: false — Allows unknown args without throwing. Smart since the CLI might want to pass-through args to the SDK later.

• -? manual check — parseArgs doesn't support ? in short options, so process.argv.includes('-?') is the pragmatic workaround. Windows/DOS users will appreciate it.

• Version info is rich — branch, sha, shortSha, commitDate, buildDate. Useful for debugging which build someone is running.

• versionCalculator: 'git' — Dropped the gitversion dependency in favour of pure git-based version calculation. One less external tool requirement for contributors.

Minor

• /help in-session shows commands and controls, but --help from CLI shows usage/options. Different content for different contexts — that's correct, but worth noting they're intentionally distinct (one is for using the CLI binary, the other is for using the interactive session).

• The biome-ignore comments for console.log in main.ts are sensible — app hasn't started yet, no terminal abstraction available.

Nothing to change. 🍌