Function buildSetupOptions

src/commands/init.ts:454–493

Build InitOptions from raw Commander opts + globals.

(
  cmdOpts: SetupCmdOpts,
  command: Command,
  defaultAgent: AgentTarget,
)

/** Build {@link InitOptions} from raw Commander opts + globals. */
function buildSetupOptions(
  cmdOpts: SetupCmdOpts,
  command: Command,
  defaultAgent: AgentTarget,
): InitOptions {
  const common = resolveCommonOptions(command);

  // Commander sets `agent: false` (boolean) when `--no-agent` is passed,
  // because `--no-agent` is the negation of `--agent <target>`. Guard against
  // this: if agent is falsy (false or empty string) default to the CLI default
  // so runInstall never receives a non-string target.
  const resolvedAgent =
    cmdOpts.agent && typeof cmdOpts.agent === 'string' ? cmdOpts.agent : defaultAgent;
  const isNoAgent = cmdOpts.noAgent === true || cmdOpts.agent === false;

  // Detect conflict when both --no-agent and --agent <target> appear in the raw
  // args. Commander only populates `rawArgs` on the ROOT command passed to
  // parseAsync; subcommands have an empty array. Walk up to the root so we
  // always inspect the full argv.
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
  let root: any = command;
  while (root.parent) root = root.parent;
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
  const rawArgs: string[] = (root as any).rawArgs ?? process.argv;
  const rawArgConflict =
    rawArgs.some((a: string) => a === '--no-agent') &&
    rawArgs.some((a: string) => a === '--agent' || a.startsWith('--agent='));

  return {
    ...common,
    apiKey: cmdOpts.apiKey,
    fromEnv: Boolean(cmdOpts.fromEnv),
    agent: resolvedAgent,
    noAgent: isNoAgent,
    force: Boolean(cmdOpts.force),
    dir: cmdOpts.dir,
    yes: Boolean(cmdOpts.yes),
    rawArgConflict,
  };
}

/** Shared action for `setup` and the deprecated `init` alias. */
async function runSetupAction(