Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
16 changes: 8 additions & 8 deletions docs/src/content/docs/reference/frontmatter-full.md
Original file line number Diff line number Diff line change
Expand Up @@ -1669,7 +1669,7 @@ experiments:
# Storage backend for experiment state. 'repo' (default) persists state to a git
# branch named 'experiments/{sanitizedWorkflowID}' (workflow ID lowercased with
# hyphens removed, e.g. 'my-workflow' -> 'experiments/myworkflow') for durability
# across cache evictions. 'cache' uses GitHub Actions cache (legacy behaviour).
# across cache evictions. 'cache' uses GitHub Actions cache (legacy behavior).
# Repo storage is recommended because experiment data is valuable and more durable
# than cache.
# (optional)
Expand Down Expand Up @@ -4569,7 +4569,7 @@ safe-outputs:

# Controls protected-file protection. String form: request_review (default),
# blocked, allowed, or fallback-to-issue — or a GitHub Actions expression for
# reusable workflows. Object form: { policy, exclude } to customise the
# reusable workflows. Object form: { policy, exclude } to customize the
# protected-file set.
# (optional)
# Accepted formats:
Expand All @@ -4585,7 +4585,7 @@ safe-outputs:

# Format 2: GitHub Actions expression that resolves to 'blocked', 'allowed',
# 'fallback-to-issue', or 'request_review' at runtime. Use in reusable
# workflow_call workflows to parameterise the policy per caller.
# workflow_call workflows to parameterize the policy per caller.
protected-files: "example-value"

# Format 3: Object form for granular control over the protected-file set. Use the
Expand Down Expand Up @@ -4665,7 +4665,7 @@ safe-outputs:
patch-format: "am"

# Format 2: GitHub Actions expression that resolves to 'am' or 'bundle' at
# runtime. Use in reusable workflow_call workflows to parameterise the transport
# runtime. Use in reusable workflow_call workflows to parameterize the transport
# format per caller.
patch-format: "example-value"

Expand Down Expand Up @@ -6201,7 +6201,7 @@ safe-outputs:

# Controls protected-file protection. String form: blocked (default), allowed, or
# fallback-to-issue — or a GitHub Actions expression for reusable workflows.
# Object form: { policy, exclude } to customise the protected-file set.
# Object form: { policy, exclude } to customize the protected-file set.
# (optional)
# Accepted formats:

Expand All @@ -6214,7 +6214,7 @@ safe-outputs:

# Format 2: GitHub Actions expression that resolves to 'blocked', 'allowed', or
# 'fallback-to-issue' at runtime. Use in reusable workflow_call workflows to
# parameterise the policy per caller.
# parameterize the policy per caller.
protected-files: "example-value"

# Format 3: Object form for granular control over the protected-file set. Use the
Expand Down Expand Up @@ -6276,7 +6276,7 @@ safe-outputs:
patch-format: "am"

# Format 2: GitHub Actions expression that resolves to 'am' or 'bundle' at
# runtime. Use in reusable workflow_call workflows to parameterise the transport
# runtime. Use in reusable workflow_call workflows to parameterize the transport
# format per caller.
patch-format: "example-value"

Expand Down Expand Up @@ -6846,7 +6846,7 @@ safe-outputs:
# Default values injected when the model omits a field
# (optional)
defaults:
# Behaviour when no files match: 'error' (default) or 'ignore'
# Behavior when no files match: 'error' (default) or 'ignore'
# (optional)
if-no-files: "error"

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ The agent's commits are packaged as a **git bundle** and uploaded as an Actions
2. Applies the bundle via `git fetch <bundle-file>`. If prerequisite commits are missing (because the base branch advanced while the agent was running), they are fetched from origin by SHA and the bundle fetch retried automatically.
3. Pushes the branch using the GitHub GraphQL API (signed commits) and creates the pull request.

If the base branch advances between agent start and `safe_outputs` apply, the PR is created slightly behind the current base — normal behaviour the author can address with a rebase. If a non-fast-forward race occurs during the push itself, the job creates a fallback PR from a temporary branch so no changes are lost.
If the base branch advances between agent start and `safe_outputs` apply, the PR is created slightly behind the current base — normal behavior the author can address with a rebase. If a non-fast-forward race occurs during the push itself, the job creates a fallback PR from a temporary branch so no changes are lost.

An older **patch transport** (`git format-patch` / `git am --3way`) is used when bundle data is unavailable. `--3way` resolves cleanly against an updated base when there are no conflicts; if it cannot, the patch is applied at the agent's original base commit and the PR UI shows the conflicts for manual resolution.

Expand Down
Loading