Function parseBuiltInArgs

packages/cli/src/internal/commandDescriptor.ts:535–568

(
        args: ReadonlyArray<string>
      )

  switch (self._tag) {
    case "Standard": {
      const parseBuiltInArgs = (
        args: ReadonlyArray<string>
      ): Effect.Effect<
        Directive.CommandDirective<never>,
        ValidationError.ValidationError,
        FileSystem.FileSystem | Path.Path | Terminal.Terminal
      > =>
        Arr.matchLeft(args, {
          onEmpty: () => {
            const error = InternalHelpDoc.p(`Missing command name: '${self.name}'`)
            return Effect.fail(InternalValidationError.commandMismatch(error))
          },
          onNonEmpty: (argv0) => {
            const normalizedArgv0 = InternalCliConfig.normalizeCase(config, argv0)
            const normalizedCommandName = InternalCliConfig.normalizeCase(config, self.name)
            if (normalizedArgv0 === normalizedCommandName) {
              const help = getHelpInternal(self, config)
              const usage = getUsageInternal(self)
              const options = InternalBuiltInOptions.builtInOptions(self, usage, help)
              const argsWithoutCommand = Arr.drop(args, 1)
              return InternalOptions.processCommandLine(options, argsWithoutCommand, config)
                .pipe(
                  Effect.flatMap((tuple) => tuple[2]),
                  Effect.catchTag("NoSuchElementException", () => {
                    const error = InternalHelpDoc.p("No built-in option was matched")
                    return Effect.fail(InternalValidationError.noBuiltInMatch(error))
                  }),
                  Effect.map(InternalCommandDirective.builtIn)
                )
            }
            const error = InternalHelpDoc.p(`Missing command name: '${self.name}'`)
            return Effect.fail(InternalValidationError.commandMismatch(error))
          }
        })
      const parseUserDefinedArgs = (
        args: ReadonlyArray<string>
      ): Effect.Effect<