Skip to content

Commit 8f77b85

Browse files
felickzCopilot
andcommitted
Add weekly agentic workflow to update GHAS-on-GHES feature matrix
Create a GitHub Agentic Workflow that runs weekly to detect new GHES versions and Advanced Security feature changes, then opens PRs to update GHAS-on-GHES-feature-matrix.md. - Add .github/workflows/update-ghas-matrix.md agentic workflow - Compile to .github/workflows/update-ghas-matrix.lock.yml - Create .gitattributes for lock file handling - Update copilot instructions with automated workflow guidance, minor version checking, and end-of-life handling Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 923a041 commit 8f77b85

File tree

5 files changed

+1213
-2
lines changed

5 files changed

+1213
-2
lines changed

.gitattributes

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.github/workflows/*.lock.yml linguist-generated=true merge=ours

.github/aw/actions-lock.json

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"entries": {
3+
"actions/github-script@v8": {
4+
"repo": "actions/github-script",
5+
"version": "v8",
6+
"sha": "ed597411d8f924073f98dfc5c65a23a2325f34cd"
7+
},
8+
"github/gh-aw-actions/setup@v0.60.0": {
9+
"repo": "github/gh-aw-actions/setup",
10+
"version": "v0.60.0",
11+
"sha": "998487a673ace02b3d9586e7511268089af88971"
12+
}
13+
}
14+
}

.github/instructions/GHASonGHESMatrix.instructions.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,12 @@ You are an expert technical writer and product specialist for GitHub Advanced Se
77
When asked to update this Advanced Security feature matrix for a new GHES version, follow this strict procedure:
88

99
## 1. Research Phase
10-
- **Identify the Version:** Determine the specific GHES version number requested (e.g., 3.16).
11-
- **Consult Release Inventory:** Read the official start/end/docs/releasenote information for all versions at `End of life dates at: https://docs.github.com/en/enterprise-server/admin/all-releases#releases-of-github-enterprise-server`.
10+
- **Identify the Version(s):** Determine the specific GHES version number(s) to check.
11+
- If a version is specified by a user, use that version.
12+
- If running as an automated workflow (no user-specified version), compare the versions currently documented in the matrix against the all-releases page to detect any new major versions or recent patch releases.
13+
- **Consult Release Inventory:** Read the official start/end/docs/releasenote information for all versions at `https://docs.github.com/en/enterprise-server/admin/all-releases#releases-of-github-enterprise-server`.
1214
- **Consult Release Notes:** Read the official release notes at `https://docs.github.com/en/enterprise-server@<VERSION>/admin/release-notes`.
15+
- **Check Minor/Patch Versions:** For each currently documented major version that is still supported, check the release notes page for recent patch releases (e.g., 3.19.3 → 3.19.4) that may include significant Advanced Security feature changes such as features moving from Preview to GA, new capabilities being backported, or important security fixes.
1316
- **Specifics**
1417
- CodeQL version included in the runner toolcache is located in this document: https://docs.github.com/en/enterprise-server@<VERSION>/admin/managing-code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance#provisioning-the-actions-for-code-scanning
1518
- Secret Scanning pattern counts are easily discovered for the GHES VERSION by running this script on the public docs for secret scanning pattern list: https://github.com/felickz/scripts/blob/main/pwsh/Count-SecretScanningPatterns.ps1
@@ -35,8 +38,11 @@ When asked to update this Advanced Security feature matrix for a new GHES versio
3538
- **New Column:** Always add a new column for the new version in *every* table, even if there are no specific changes for that table.
3639
- **Carry Forward:** Pull forward the feature status from the previous version. Update the status icon only if it has changed (e.g., ☑️ to ✅).
3740
- **New Rows:** Insert new rows for new features found during research. Give the feature a few word summary, always prefer to deep link it to the docs for the new feature.
41+
- **End-of-Life Versions:** When a version has passed its deprecation date, consider whether it should be archived. The document uses an archive pattern — see the "End of life Archive" section at the top of the matrix. Do not remove columns without moving them to the archive first.
3842

3943
## 4. Pull Request & Output Instructions
4044
When generating the Pull Request description or summary of changes:
4145
- **List Omissions:** Explicitly list any advanced security / security features you saw in the release notes but decided *not* to include in the matrix. This helps the reviewer confirm if they should be added.
4246
- **Rendered Link:** Include a link to the rendered view of the Markdown file so the reviewer can easily visualize the table columns.
47+
- **Version Context:** When updating for a new major version, include the release date, deprecation date, and CodeQL toolcache version in the PR description.
48+
- **Duplicate Check:** Before creating a PR, check if there is already an open PR updating the matrix for the same version(s). If so, skip creating a duplicate.

0 commit comments

Comments
 (0)