Command: workflowRuns trigger

[andrewjensen]

This defines the dx workflowRuns trigger command.

Help text:

Usage: dx workflowRuns trigger [options] <workflow-identifier>

Trigger a Self-service workflow run and wait until it succeeds or fails. If the workflow requires approval, this command will submit a request and notify
approvers.

Arguments:
  workflow-identifier           Workflow identifier (from dx workflows list)

Options:
  --entity <identifier>         Catalog entity identifier (required for entity-scoped workflows)
  --param <key=value>           Workflow parameter value (repeatable). Value after the first '=' is kept verbatim (default: [])
  --notify-approvers <boolean>  For workflows that require approval, send a message to each approver requesting review
  -h, --help                    display help for command

Examples:
  Trigger a global workflow and wait for completion:
    dx workflowRuns trigger my-global-workflow
  Trigger with an entity and parameters:
    dx workflowRuns trigger provision-db --entity acme-api --param size=small --param "greeting=hello world"
  Trigger with machine-readable output:
    dx workflowRuns trigger my-workflow --json --entity svc-1 --param count=3
  Request approval to trigger a workflow but do not notify approvers:
    dx workflowRuns trigger workflow-requiring-approval --notify-approvers false

Depends on #69. Note that this PR originally had all the other commands but we split off the other PR to define info and the event commands.

[BigGig17]

This looks really good, I don't actually have a lot of concerns around event rendering and approval language for the events per se, however IU do have concerns around the UI Triggering language and how it implies that all triggers are "triggers" and not "requests to trigger" which they sometimes can be.

Additionally, I would like to see the trigger PR split from the rest as I think that's a relatively delicate CLI Item here that I think would value from it's own PR.

Lastly, should we add some in code comments at the top of some of these files to give more of a description of how we intend for them to work or link to the DX Docs for the relevant API Methods perhaps? WDYT?

Also the verify checks seem to be blocking as well 😅

[BigGig17]

one more minor tweak but otherwise I like it!