Function runInit

src/commands/init.ts:159–348

(opts: InitOptions, deps: InitDeps = {})

// ---------------------------------------------------------------------------

export async function runInit(opts: InitOptions, deps: InitDeps = {}): Promise<void> {
  const stderrFn = deps.stderr ?? ((line: string) => process.stderr.write(`${line}\n`));
  const out = new Output(opts.output, { stdout: deps.stdout, stderr: deps.stderr });

  // -------------------------------------------------------------------------
  // Fix 5: emit conflict warning when both --agent and --no-agent were given
  // -------------------------------------------------------------------------
  if (opts.rawArgConflict) {
    const effectiveLabel = opts.noAgent ? '--no-agent' : `--agent ${opts.agent}`;
    stderrFn(
      `[warn] both --no-agent and --agent supplied; using ${effectiveLabel} (last flag wins)`,
    );
  }

  // -------------------------------------------------------------------------
  // Non-interactive guard: no TTY + no key source → exit 5 immediately
  // -------------------------------------------------------------------------
  const isTTY = deps.isTTY ?? Boolean(process.stdin.isTTY);
  const hasKeySource = Boolean(opts.apiKey) || opts.fromEnv;
  // Non-interactive guard: no TTY + no key source → exit 5. Skipped under
  // --dry-run, which is documented to work without credentials or network.
  if (!isTTY && !hasKeySource && !opts.dryRun) {
    throw new CLIError(
      'No API key available in non-interactive mode. ' +
        'Pass --api-key <key>, --from-env (reads TESTSPRITE_API_KEY), or run interactively.',
      5,
    );
  }
  // JSON-output guard: an interactive secret prompt writes to stdout and would
  // corrupt init's single-JSON-object output contract. In --output json mode
  // require a non-interactive key source. Skipped under --dry-run (never prompts).
  if (opts.output === 'json' && !hasKeySource && !opts.dryRun) {
    throw new CLIError(
      'Interactive API-key prompt is unavailable in --output json mode (it would corrupt JSON stdout). ' +
        'Pass --api-key <key> or --from-env.',
      5,
    );
  }

  // -------------------------------------------------------------------------
  // Dry-run: zero network + zero FS writes; print preview only
  // -------------------------------------------------------------------------
  if (opts.dryRun) {
    stderrFn('[dry-run] no writes or network calls — preview only');
    stderrFn(
      `[dry-run] would configure profile="${opts.profile}" (key source: ${
        opts.apiKey ? 'flag' : opts.fromEnv ? 'env' : 'prompt'
      })`,
    );

    const agentTarget = opts.noAgent ? null : opts.agent;

    if (!opts.noAgent) {
      // Delegate to runInstall's own dry-run for the file-listing preview.
      // runInstall prints the would-write lines itself under dryRun.
      await runInstall(
        {
          ...opts,