Function createProjectCommand

src/commands/project.ts:319–438

(deps: ProjectDeps = {})

}

export function createProjectCommand(deps: ProjectDeps = {}): Command {
  const project = new Command('project').description('Manage TestSprite projects');

  project
    .command('list')
    .description(
      'List projects visible to the API key\n' +
        '\nExit codes:\n' +
        '  0  success\n' +
        '  3  auth error\n' +
        '  5  validation error (e.g., bad --page-size)\n' +
        ' 10  transport/network failure (UNAVAILABLE) — retry the command',
    )
    .option('--page-size <n>', 'service page-size hint (1-100, default 25)')
    .option('--starting-token <token>', 'opaque cursor from a previous list response')
    .option('--max-items <n>', 'stop after this many items across auto-paged pages')
    .addHelpText('after', GLOBAL_OPTS_HINT)
    .action(async (cmdOpts: ListFlagOpts, command: Command) => {
      // Don't parse numeric flags via Commander — its parser throws a
      // plain `Error`, which `index.ts` maps to exit code 1. Local
      // validation lives in `runList → validatePaginationFlags`, which
      // raises a typed `ApiError(VALIDATION_ERROR)` and surfaces with
      // the contract-mandated exit code 5.
      await runList(
        {
          ...resolveCommonOptions(command),
          pageSize: parseFlag(cmdOpts.pageSize, 'page-size'),
          startingToken: cmdOpts.startingToken,
          maxItems: parseFlag(cmdOpts.maxItems, 'max-items'),
        },
        deps,
      );
    });

  project
    .command('get <project-id>')
    .description('Get a project by id')
    .addHelpText('after', GLOBAL_OPTS_HINT)
    .action(async (projectId: string, _cmdOpts, command: Command) => {
      await runGet({ ...resolveCommonOptions(command), projectId }, deps);
    });

  project
    .command('create')
    .description('Create a new project')
    .option('--type <frontend|backend>', 'project type (required)')
    .option('--name <name>', 'project name (required)')
    .option('--url <url>', 'target URL (required for frontend)')
    .option('--description <text>', 'optional human description')
    .option('--username <user>', 'optional auth username')
    .option('--password <pw>', 'optional auth password (use --password-file for non-interactive)')
    .option('--password-file <path>', 'read password from file instead of inline flag')
    .option('--instruction <text>', 'optional FE plan-gen instruction hint')
    .option(
      '--idempotency-key <token>',
      'opaque idempotency token. Defaults to a UUIDv4 minted per invocation.',
    )
    .addHelpText('after', GLOBAL_OPTS_HINT)