scriptoriumadmin/fabro
1
0
Fork 0
mirror of https://github.com/fabro-sh/fabro.git synced 2026-10-01 02:04:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Keep approval help concise and document attaching to interviews

Browse source
This commit is contained in:
Scott Werner 2026-09-17 15:15:42 -04:00
parent 1630d26354
commit e5ba7e3a0f
6 changed files with 31 additions and 95 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
docs/public/reference/cli.mdx
View file

@ -63,7 +63,7 @@ fabro [OPTIONS] [COMMAND]
| Command | Description |
| --- | --- |
| `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 approve` | Approve a pending run for execution |
| `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.<br /><br />Controls permission to start a run. For human interview gates during execution, use the questions API. |
| `fabro deny` | Deny execution of a pending run |
| `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.<br /><br />Controls permission to start a run. For human interview gates during execution, use the questions API.
Approve a pending run for execution
```bash
fabro approve [OPTIONS] <RUNS>...
@ -371,7 +371,7 @@ fabro create [OPTIONS] <WORKFLOW>
### `fabro deny`
Deny pending workflow runs.<br /><br />Controls permission to start a run. For human interview gates during execution, use the questions API.
Deny execution of a pending run
```bash
fabro deny [OPTIONS] <RUNS>...

8
docs/public/workflows/human-in-the-loop.mdx
View file

@ -21,10 +21,10 @@ When execution reaches the gate, the user sees the previous stage's output follo
<Note>
`fabro approve` and `fabro deny` grant or deny permission to **start a run** waiting
for execution approval. To answer a human gate during execution, use the
interactive CLI prompt or the run page's interview dock. API clients can list
pending questions with `GET /api/v1/runs/{id}/questions` and answer a specific
question with `POST /api/v1/runs/{id}/questions/{qid}/answer`.
for execution approval. To answer a human gate during execution, run
`fabro attach <run>` for an interactive prompt or use the run page's interview dock.
API clients can list pending questions with `GET /api/v1/runs/{id}/questions` and
answer a specific question with `POST /api/v1/runs/{id}/questions/{qid}/answer`.
</Note>
### Keyboard accelerators

10
lib/apps/fabro-cli/src/args.rs
View file

@ -1357,15 +1357,9 @@ pub(crate) enum RunsCommands {
Rm(RunsRemoveArgs),
/// 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 a pending run for execution.
Approve(RunsApproveArgs),
/// Deny pending workflow runs.
///
/// Controls permission to start a run. For human interview gates during
/// execution, use the questions API.
/// Deny execution of a pending run.
Deny(RunsDenyArgs),
/// Mark terminal runs as archived (reviewed, no further action needed).
/// Archived runs are hidden from default listings.

46
lib/apps/fabro-cli/tests/it/cmd/approve.rs
View file

@ -14,49 +14,21 @@ fn help() {
success: true
exit_code: 0
----- stdout -----
Approve pending workflow runs.
Controls permission to start a run. For human interview gates during execution, use the questions API.
Approve a pending run for execution
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 (see a summary with '-h')
--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
----- stderr -----
");
}

50
lib/apps/fabro-cli/tests/it/cmd/deny.rs
View file

@ -14,52 +14,22 @@ fn help() {
success: true
exit_code: 0
----- stdout -----
Deny pending workflow runs.
Controls permission to start a run. For human interview gates during execution, use the questions API.
Deny execution of a pending run
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 (see a summary with '-h')
--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
----- stderr -----
");
}

4
lib/apps/fabro-cli/tests/it/cmd/fabro.rs
View file

@ -31,8 +31,8 @@ fn help() {
dump Export a run's durable state to a directory
rm Remove one or more workflow runs
inspect Show detailed information about a workflow run
approve Approve pending workflow runs
deny Deny pending workflow runs
approve Approve a pending run for execution
deny Deny execution of a pending run
archive Mark terminal runs as archived (reviewed, no further action needed). Archived runs are hidden from default listings
unarchive Restore archived runs to their prior terminal status
model List and test LLM models