Reorder global args to start of list.

[jglogan]

Co-author: Chris Naples cnaples79@gmail.com (@cnaples79)

• Fixes [Bug]: "Error: Unknown option '--debug'. Did you mean '--debug'?" #360.
• Adapts cli: accept global flags after subcommands #730 to new dispatch mechanism.
• Gets rid of wonky error message when --debug is placed after the subcommand and before --.

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update

Motivation and Context

That error message is really vexing.

Testing

• Tested locally
• Added/updated tests
• Added/updated docs

[dcantah]

My brain is fried with all of the implicit main funcs being called and when validate actually runs for subcommands logic, but does this mean we don't run validate's logic for every command anymore now? This is where we were shoving in some "nice to run every time" logic:

public func validate() throws {
        // Not really a "validation", but a cheat to run this before
        // any of the commands do their business.
        let debugEnvVar = ProcessInfo.processInfo.environment["CONTAINER_DEBUG"]
        if self.global.debug || debugEnvVar != nil {
            log.logLevel = .debug
        }
        // Ensure we're not running under Rosetta.
        if try isTranslated() {
            throw ValidationError(
                """
                `container` is currently running under Rosetta Translation, which could be
                caused by your terminal application. Please ensure this is turned off.
                """
            )
        }
    }