adding-a-command

To add a CLI command, create a file in src/commands, register it in src/cli.ts using the .command() and .action() methods wrapped with tracked() for telemetry, and export a default async function with the CLIContext signature.

The required structure places the command file at src/commands/{commandName}.ts and its test at src/commands/__tests__/{commandName}.test.ts. The command must be registered in src/cli.ts to enable telemetry tracking via the tracked() wrapper.

Yes, you must add a test file at src/commands/__tests__/{commandName}.test.ts. This test file needs to include at least one happy-path test to validate the command's behavior and ensure reliable telemetry before the command is fully integrated.

No, the command handler must export a default async function with the signature async (options: any, ctx: CLIContext) => Promise<void>. This specific signature is required for proper registration and telemetry tracking within the CLI.

Telemetry tracking is missing if the command is not registered in src/cli.ts using the tracked(commandName, ...) wrapper. Always applying this wrapper around the handler ensures telemetry data is properly collected during command execution.