Skip to content

[docs] Update documentation for features from 2026-08-06 #50832

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 1 commit into from
Aug 6, 2026
+16 −1
Merged

[docs] Update documentation for features from 2026-08-06 #50832

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/src/content/docs/experimental/trial-ops.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,8 @@ Results are saved in `trials/*.json` with workflow runs, issues, PRs, and commen
{
"workflow_name": "weekly-research",
"run_id": "12345678",
"success": true,
"safe_output_errors": [],
"safe_outputs": {
"issues_created": [{
"number": 5,
Expand All @@ -121,7 +123,9 @@ Results are saved in `trials/*.json` with workflow runs, issues, PRs, and commen
}
```

**Success indicators:** Green checkmark, expected outputs created, no errors in logs.
`success` provides an explicit pass/fail signal for each workflow result. When safe-output processing rejects one or more requested actions, `safe_output_errors` contains the rejected-message errors and `gh aw trial` exits non-zero instead of reporting unconditional success.

**Success indicators:** Green checkmark, expected outputs created, no safe-output errors in logs or JSON results.

**Common issues:**

Expand Down
11 changes: 11 additions & 0 deletions docs/src/content/docs/reference/frontmatter.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -278,6 +278,17 @@ Enables defining custom MCP tools inline using JavaScript or shell scripts. See

Enables automatic issue creation, comment posting, and other safe outputs. See [Safe Outputs Processing](/gh-aw/reference/safe-outputs/).

`safe-outputs:` also accepts workflow-level control fields that apply to safe-output processing as a whole, not just individual handlers. For example, `report-failed-jobs: false` disables the automatic failed-job reporting issue created by the framework:

```yaml wrap
safe-outputs:
create-issue:
max: 1
report-failed-jobs: false
```

When omitted, `report-failed-jobs` defaults to `true`.

### Run Configuration (`run-name:`, `runs-on:`, `runs-on-slim:`, `timeout-minutes:`)

Standard GitHub Actions properties:
Expand Down
Loading