Repository navigation
[docs] Update glossary - daily scan - #76828
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
🟡 Changes recommended
The glossary entry contains an active documentation error that could lead readers to configure an unsupported policy or misunderstand the merge gate’s behavior and scope.
1 open issue
What changed in this PR
Updates the reference glossary to document connectors, security advisory safe outputs, and protected-file enforcement for merge pull requests.
Changes:
- Adds glossary entries for connectors and security advisory outputs.
- Expands Protected Files coverage to include merge operations.
- Updates the Merge Pull Request definition with protected-file and caution-notice behavior.
| File | Description |
|---|---|
| docs/src/content/docs/reference/glossary.md | Adds and updates glossary definitions for connectors, security advisory outputs, protected files, and merge pull requests. |
Review effort: Lite (auto)
| ### Protected Files | ||
|
|
||
| A security mechanism on `create-pull-request` and `push-to-pull-request-branch` safe outputs that prevents AI agents from modifying sensitive repository files. By default, protects dependency manifests (e.g., `package.json`, `go.mod`), GitHub Actions workflow files, and lock files. Configured via `protected-files:` with three policies: `blocked` (default — fails with error), `allowed` (no restriction), or `fallback-to-issue` (creates a review issue for human inspection instead of applying changes). Also accepts an object form `{ policy: string, exclude: [...] }` to remove specific files or path prefixes from the default protected set while keeping protection active for the remaining files. Repository-wide exceptions can be set with `protected_files.exclude` in `.github/workflows/aw.json` using root-relative path globs (e.g., `.changeset/*.md`); catch-all patterns such as `**` are rejected, and these exceptions never bypass `allowed-files`. See [Safe Outputs (Pull Requests)](/gh-aw/reference/safe-outputs-pull-requests/#protected-files). | ||
| A security mechanism on `create-pull-request`, `push-to-pull-request-branch`, and `merge-pull-request` safe outputs that prevents AI agents from modifying sensitive repository files. By default, protects dependency manifests (e.g., `package.json`, `go.mod`), GitHub Actions workflow files, and lock files. Configured via `protected-files:` with three policies: `blocked` (default — fails with error), `allowed` (no restriction), or `fallback-to-issue` (creates a review issue for human inspection instead of applying changes). Also accepts an object form `{ policy: string, exclude: [...] }` to remove specific files or path prefixes from the default protected set while keeping protection active for the remaining files. Repository-wide exceptions can be set with `protected_files.exclude` in `.github/workflows/aw.json` using root-relative path globs (e.g., `.changeset/*.md`); catch-all patterns such as `**` are rejected, and these exceptions never bypass `allowed-files`. See [Safe Outputs (Pull Requests)](/gh-aw/reference/safe-outputs-pull-requests/#protected-files). |
There was a problem hiding this comment.
Clarified that protected-file checks block a merge when its PR changes protected files, and scoped fallback-to-issue to the creation and push outputs; merge supports only blocked and allowed. The update is in 6ac821ea.
|
🍳 A little prep to help this PR along! Copilot assignment requested for the following outstanding work:
Keeping the changes focused; human review and CI get the final taste test. No merging or CI triggering. Structured data{
"completed_task": 0,
"head": "6a6ea2874dd7591ec149e842b65e095b8e3172ad",
"kind": "requested",
"schema_version": "1",
"state": "71f39f7a71c7eb5043aee49856253f76c84a51da76fa7a60ec840f2c603e6392",
"work": [],
"workflow": "pr-sous-chef"
}
|
…794392296-aa0f71ffa880dc1d # Conflicts: # docs/src/content/docs/reference/glossary.md Co-authored-by: gh-aw-bot <259018956+gh-aw-bot@users.noreply.github.com>
|
🎉 This pull request is included in a new release. Release: |

Daily scan.
Added: Connector (
connectors:), Security Advisory Outputs.Updated: Protected Files (now covers
merge-pull-request), Merge Pull Request.Sources: #74077, #76771, #76711.
AI dictionary alignment: no AI-coding terms revised.