`runCommand`

Generated reference page for the runCommand function export.

Signatures

function runCommand(cmd: RunnableCommand, argv: readonly string[], options?: RunCommandOptions): Promise<RunResult>;

Parameter	Type	Description
`cmd`	`RunnableCommand`	The command builder (must have an action handler)
`argv`	`readonly string[]`	Raw argv strings (NOT including the command name itself). CLI-level `--json` and `--quiet`/`-q` before the `--` separator are honored and stripped here, just like the real CLI root — so `['--json']` enables JSON mode and `['--quiet']` sets quiet verbosity rather than failing as unknown flags. Equivalent to `{ jsonMode: true }` / `{ verbosity: 'quiet' }`. Both accept an explicit value (`--json=false`), and an invalid one fails with the same `INVALID_VALUE` error the CLI root produces. Pass `options.builtins` to mirror a CLI that released one of these tokens to its commands.
`options`	`RunCommandOptions \| undefined`	Injectable runtime state

Run a command builder against the given argv with injected options.

This is the testkit wrapper around the shared executor:

Apply the CLI root-flag layer (detect/strip --json and --quiet/-q) so copied real argv works
Create or reuse capture output
Build standalone schema/meta defaults when CLI dispatch did not
Delegate parse -> resolve -> execute to the shared executor
Return the structured result with captured buffers

Errors are normalized by the shared executor into structured RunResults with appropriate exit codes. The function never throws.

(cmd: RunnableCommand, argv: readonly string[], options?: RunCommandOptions): Promise<RunResult>;