Function handleBuiltInOption

packages/cli/src/internal/cliApp.ts:149–301

(
  self: CliApp.CliApp<A>,
  executable: string,
  args: ReadonlyArray<string>,
  builtIn: BuiltInOptions.BuiltInOptions,
  execute: (a: A) => Effect.Effect<void, E, R>,
  config: CliConfig.CliConfig,
  originalArgs: ReadonlyArray<string>
)

const printDocs = (error: HelpDoc.HelpDoc): Effect.Effect<void> => Console.error(InternalHelpDoc.toAnsiText(error))

const handleBuiltInOption = <R, E, A>(
  self: CliApp.CliApp<A>,
  executable: string,
  args: ReadonlyArray<string>,
  builtIn: BuiltInOptions.BuiltInOptions,
  execute: (a: A) => Effect.Effect<void, E, R>,
  config: CliConfig.CliConfig,
  originalArgs: ReadonlyArray<string>
): Effect.Effect<
  void,
  E | ValidationError.ValidationError,
  R | CliApp.CliApp.Environment | Terminal.Terminal
> => {
  switch (builtIn._tag) {
    case "SetLogLevel": {
      // Use first 2 elements from originalArgs (runtime + script) to preserve paths with spaces
      // Filter out --log-level from args before re-executing
      const baseArgs = Arr.take(originalArgs, 2)
      const filteredArgs: Array<string> = []
      for (let i = 0; i < args.length; i++) {
        if (isLogLevelArg(args[i]) || args[i - 1] === "--log-level") {
          continue
        }
        filteredArgs.push(args[i])
      }
      const nextArgs = Arr.appendAll(baseArgs, filteredArgs)
      return run(self, nextArgs, execute).pipe(
        Logger.withMinimumLogLevel(builtIn.level)
      )
    }
    case "ShowHelp": {
      const banner = InternalHelpDoc.h1(InternalSpan.code(self.name))
      const header = InternalHelpDoc.p(InternalSpan.spans([
        InternalSpan.text(`${self.name} ${self.version}`),
        InternalSpan.isEmpty(self.summary)
          ? InternalSpan.empty
          : InternalSpan.spans([
            InternalSpan.space,
            InternalSpan.text("--"),
            InternalSpan.space,
            self.summary
          ])
      ]))
      const usage = InternalHelpDoc.sequence(
        InternalHelpDoc.h1("USAGE"),
        pipe(
          InternalUsage.enumerate(builtIn.usage, config),
          Arr.map((span) => InternalHelpDoc.p(InternalSpan.concat(InternalSpan.text("$ "), span))),
          Arr.reduceRight(
            InternalHelpDoc.empty,
            (left, right) => InternalHelpDoc.sequence(left, right)
          )
        )
      )
      const helpDoc = pipe(
        banner,
        InternalHelpDoc.sequence(header),
        InternalHelpDoc.sequence(usage),