Clarify interview guidance in approval command help

This commit is contained in:
Scott Werner 2026-09-17 14:54:00 -04:00
parent 2866cc6bc8
commit 1630d26354
4 changed files with 87 additions and 23 deletions

View file

@ -63,7 +63,7 @@ fabro [OPTIONS] [COMMAND]
| Command | Description |
| --- | --- |
| `fabro approve` | Approve pending workflow runs |
| `fabro approve` | Approve pending workflow runs.<br /><br />Controls permission to start a run. For human interview gates during execution, use the questions API. |
| `fabro archive` | Mark terminal runs as archived (reviewed, no further action needed). Archived runs are hidden from default listings |
| `fabro artifact` | Inspect and copy run artifacts (screenshots, reports, traces) |
| `fabro ask` | Ask Fabro a read-only question about a run |
@ -71,7 +71,7 @@ fabro [OPTIONS] [COMMAND]
| `fabro auth` | Manage CLI authentication state |
| `fabro completion` | Generate shell completions |
| `fabro create` | Register a workflow version and create a submitted run |
| `fabro deny` | Deny pending workflow runs |
| `fabro deny` | Deny pending workflow runs.<br /><br />Controls permission to start a run. For human interview gates during execution, use the questions API. |
| `fabro discord` | Open the Discord community in the browser |
| `fabro docs` | Open the docs website in the browser |
| `fabro doctor` | Check environment and integration health |
@ -111,7 +111,7 @@ fabro [OPTIONS] [COMMAND]
### `fabro approve`
Approve pending workflow runs
Approve pending workflow runs.<br /><br />Controls permission to start a run. For human interview gates during execution, use the questions API.
```bash
fabro approve [OPTIONS] <RUNS>...
@ -371,7 +371,7 @@ fabro create [OPTIONS] <WORKFLOW>
### `fabro deny`
Deny pending workflow runs
Deny pending workflow runs.<br /><br />Controls permission to start a run. For human interview gates during execution, use the questions API.
```bash
fabro deny [OPTIONS] <RUNS>...

View file

@ -1358,8 +1358,14 @@ pub(crate) enum RunsCommands {
/// Show detailed information about a workflow run
Inspect(InspectArgs),
/// Approve pending workflow runs.
///
/// Controls permission to start a run. For human interview gates during
/// execution, use the questions API.
Approve(RunsApproveArgs),
/// Deny pending workflow runs.
///
/// Controls permission to start a run. For human interview gates during
/// execution, use the questions API.
Deny(RunsDenyArgs),
/// Mark terminal runs as archived (reviewed, no further action needed).
/// Archived runs are hidden from default listings.

View file

@ -14,21 +14,49 @@ fn help() {
success: true
exit_code: 0
----- stdout -----
Approve pending workflow runs
Approve pending workflow runs.
Controls permission to start a run. For human interview gates during execution, use the questions API.
Usage: fabro approve [OPTIONS] <RUNS>...
Arguments:
<RUNS>... Run IDs or workflow names to approve
<RUNS>...
Run IDs or workflow names to approve
Options:
--json Output as JSON [env: FABRO_JSON=]
--server <SERVER> Fabro server target: http(s) URL or absolute Unix socket path [env: FABRO_SERVER=]
--debug Enable DEBUG-level logging (default is INFO) [env: FABRO_DEBUG=]
--no-upgrade-check Disable automatic upgrade check [env: FABRO_NO_UPGRADE_CHECK=true]
--quiet Suppress non-essential output [env: FABRO_QUIET=]
--verbose Enable verbose output [env: FABRO_VERBOSE=]
-h, --help Print help
--json
Output as JSON
[env: FABRO_JSON=]
--server <SERVER>
Fabro server target: http(s) URL or absolute Unix socket path
[env: FABRO_SERVER=]
--debug
Enable DEBUG-level logging (default is INFO)
[env: FABRO_DEBUG=]
--no-upgrade-check
Disable automatic upgrade check
[env: FABRO_NO_UPGRADE_CHECK=true]
--quiet
Suppress non-essential output
[env: FABRO_QUIET=]
--verbose
Enable verbose output
[env: FABRO_VERBOSE=]
-h, --help
Print help (see a summary with '-h')
----- stderr -----
");
}

View file

@ -14,22 +14,52 @@ fn help() {
success: true
exit_code: 0
----- stdout -----
Deny pending workflow runs
Deny pending workflow runs.
Controls permission to start a run. For human interview gates during execution, use the questions API.
Usage: fabro deny [OPTIONS] <RUNS>...
Arguments:
<RUNS>... Run IDs or workflow names to deny
<RUNS>...
Run IDs or workflow names to deny
Options:
--json Output as JSON [env: FABRO_JSON=]
--server <SERVER> Fabro server target: http(s) URL or absolute Unix socket path [env: FABRO_SERVER=]
--debug Enable DEBUG-level logging (default is INFO) [env: FABRO_DEBUG=]
--reason <REASON> Reason for denying execution
--no-upgrade-check Disable automatic upgrade check [env: FABRO_NO_UPGRADE_CHECK=true]
--quiet Suppress non-essential output [env: FABRO_QUIET=]
--verbose Enable verbose output [env: FABRO_VERBOSE=]
-h, --help Print help
--json
Output as JSON
[env: FABRO_JSON=]
--server <SERVER>
Fabro server target: http(s) URL or absolute Unix socket path
[env: FABRO_SERVER=]
--debug
Enable DEBUG-level logging (default is INFO)
[env: FABRO_DEBUG=]
--reason <REASON>
Reason for denying execution
--no-upgrade-check
Disable automatic upgrade check
[env: FABRO_NO_UPGRADE_CHECK=true]
--quiet
Suppress non-essential output
[env: FABRO_QUIET=]
--verbose
Enable verbose output
[env: FABRO_VERBOSE=]
-h, --help
Print help (see a summary with '-h')
----- stderr -----
");
}