Skip to content

Commit f353ad0

Browse files
docs(references): daily intelligence update 2026-04-18
- Update gh-aw-architecture.md: MCP Gateway v0.1.9 → v0.2.24 - Add AWF version v0.25.24 to gh-aw-architecture.md - Add SideRepoOps context (workflowRepo/eventRepo) to architecture - Add resolved 'Redact secrets in logs' gotcha to production-gotchas.md - Add set_issue_fields, resolve_review_thread tools to tools-reference.md - Add copilot, pull_request_granular, issues_granular toolsets to tools-reference.md - Add list_commits path/since/until parameters to tools-reference.md - Update knowledge-base.md with 2026-04-18 findings - Add intelligence report outputs/gh-aw-reports/2026-04-18.md Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 6c88e97 commit f353ad0

5 files changed

Lines changed: 178 additions & 1 deletion

File tree

.claude/skills/gh-aw-report/knowledge-base.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,28 @@
66
77
---
88

9+
## [2026-04-18] Intelligence Update
10+
11+
### GitHub MCP Server
12+
- **v1.0.0 released**: 2026-04-16 — first stable major release
13+
- **`set_issue_fields` tool** (v1.0.0): Sets/updates/deletes org-level custom field values on issues; in `issues_granular` toolset; feature-flagged under `issues_granular`
14+
- **MCP Apps** (v1.0.0): Graduated from insiders-only to feature flag `remote_mcp_ui_apps`; insiders mode remains for other experiments
15+
- **`resolve_review_thread` tool** (v0.33.0): Resolves PR review threads; in `pull_request_granular` toolset
16+
- **Granular toolsets** (v0.33.0): `pull_request_granular` and `issues_granular` OSS toolsets
17+
- **`list_commits` parameters** (v0.33.0): Added `path`, `since`, `until` filter params
18+
- **v0.33.1**: Patch over v0.33.0 (2026-04-14)
19+
20+
### gh-aw Core (as of 2026-04-18)
21+
- **MCP Gateway**: Current default version **v0.2.24** [SUPERSEDES v0.1.9 noted 2026-04-14]
22+
- **AWF (Actions Workflow Framework)**: Current default version **v0.25.24**
23+
- **"Redact secrets in logs" fix**: MCP gateway now runs as runner user with proper uid/gid mapping; eliminates persistent log warnings (PR #26658)
24+
- **`create_pull_request.base_branch`**: Now honored correctly in safe-output patch generation (PR #26952)
25+
- **Compile hardening**: `gh aw compile` now hardens MCP stdout handling (PR #26968)
26+
- **Copilot CLI pinned**: Default Copilot CLI version is v1.0.21 (PR #26963)
27+
- **`SideRepoOps` context**: Native context providing explicit `workflowRepo` vs `eventRepo` distinction for comment scripts (PR #26953)
28+
29+
---
30+
931
## [2026-04-14] Bootstrap Entry — Initial Research
1032

1133
### gh-aw CLI

.claude/skills/gh-aw-report/references/gh-aw-architecture.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Stable architectural facts about the GitHub Agentic Workflows ecosystem. Used by
99
- **Install**: `gh extension install github/gh-aw`
1010
- **Purpose**: Compile markdown workflow definitions into GitHub Actions `.lock.yml` files
1111
- **Key commands**: `gh aw compile`, `gh aw validate`, `gh aw upgrade`, `gh aw mcp inspect`, `gh aw mcp list`
12+
- **AWF (Actions Workflow Framework)**: Default version **v0.25.24** (as of 2026-04-18)
1213

1314
### Workflow File Structure
1415
- **Source**: `.github/workflows/<name>.md` — markdown with YAML frontmatter
@@ -80,7 +81,7 @@ Stable architectural facts about the GitHub Agentic Workflows ecosystem. Used by
8081
- **`base_ref` parameter:** On Copilot PR tools for stacked PR / feature branch workflows
8182
- **Insiders mode:** Opt-in experimental features via `/insiders` URL or config header
8283
- **HTTP mode:** Enterprise deployment with per-request OAuth token forwarding
83-
- **MCP Gateway:** Centralized access management for MCP servers (v0.1.9 as of 2026-04-14)
84+
- **MCP Gateway:** Centralized access management for MCP servers (**v0.2.24** as of 2026-04-18; runs as runner user with uid/gid Docker mapping since v0.2.x)
8485

8586
### Claude Code
8687
- Anthropic's CLI agentic coding tool
@@ -100,3 +101,12 @@ Stable architectural facts about the GitHub Agentic Workflows ecosystem. Used by
100101
- `strict: false` — required for custom domains and untrusted input
101102
- `lockdown` settings for public repositories
102103
- Network firewall with ecosystem identifiers: `defaults`, `github`, `containers`, `node`, `python`
104+
105+
## Cross-Repository Context
106+
107+
### SideRepoOps Context (workflowRepo vs eventRepo)
108+
gh-aw provides a native `SideRepoOps` context that distinguishes between:
109+
- **`workflowRepo`**: The repository where the gh-aw workflow is defined
110+
- **`eventRepo`**: The repository that triggered the event (may differ in cross-repo scenarios)
111+
112+
This context is used internally for comment scripts and for cross-repository safe-output operations. The distinction matters when using `target-repo` or `allowed-repos` in safe-outputs, or when writing workflows that operate across repositories. Refactored for native context in gh-aw PR #26953 (2026-04-18).
Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
# gh-aw Intelligence Report — 2026-04-18
2+
3+
**Generated**: 2026-04-18
4+
**Coverage**: 2026-04-14 → 2026-04-18
5+
**Sources**: GitHub API (github-mcp-server, gh-aw commits), repository data
6+
7+
---
8+
9+
## 1. Summary
10+
11+
Significant activity this week: **GitHub MCP Server reached v1.0.0** (its first stable major release) on 2026-04-16. The gh-aw core also had active development, with the default MCP Gateway bumped to **v0.2.24** and AWF to **v0.25.24**, plus a fix for the persistent "Redact secrets in logs" warning in MCP gateway logs.
12+
13+
---
14+
15+
## 2. GitHub MCP Server
16+
17+
### v1.0.0 (2026-04-16) — First Stable Release 🎉
18+
- **`set_issue_fields` tool**: New tool in the `issues_granular` toolset. Sets, updates, or deletes organization-level custom field values on issues. Feature-flagged under `issues_granular`.
19+
- **MCP Apps Feature Flag**: MCP Apps UI support migrated from insiders-only mode to a proper feature flag (`remote_mcp_ui_apps`). Will be rolled out to more users with supported clients over time. Insiders mode remains active for other experiments.
20+
- **Dependencies**: `modelcontextprotocol/go-sdk` upgraded to v1.5.0; `docker/login-action` to 4.0.0; `docker/setup-buildx-action` to 4.0.0.
21+
- **Source**: https://github.com/github/github-mcp-server/releases/tag/v1.0.0
22+
23+
### v0.33.1 (2026-04-14) — Patch
24+
- Patch release over v0.33.0. Full changelog: https://github.com/github/github-mcp-server/releases/tag/v0.33.1
25+
26+
### v0.33.0 (2026-04-14) — OSS Granular Toolsets
27+
- **`resolve_review_thread` tool**: Resolves PR review threads (in `pull_request_granular` toolset).
28+
- **Granular toolsets (OSS)**: `pull_request_granular` and `issues_granular` — fine-grained write operations separated from default toolsets.
29+
- **`list_commits` parameters**: Added `path`, `since`, and `until` filter parameters.
30+
- **Configurable server name/title** via translation strings.
31+
- **Source**: https://github.com/github/github-mcp-server/releases/tag/v0.33.0
32+
33+
---
34+
35+
## 3. gh-aw Core
36+
37+
### Version Bumps (2026-04-18)
38+
- **AWF (Actions Workflow Framework)** bumped to **v0.25.24**
39+
- **MCP Gateway** bumped to **v0.2.24**
40+
- **Commit**: `Bump default AWF to v0.25.24 and MCP Gateway to v0.2.24 (#26966)`
41+
42+
### "Redact secrets in logs" Fix (2026-04-18)
43+
- **Issue**: MCP gateway was previously running as a different user than the runner, causing persistent "Redact secrets in logs" warnings in workflow logs.
44+
- **Fix**: MCP gateway now runs as runner user with proper uid/gid mapping for Docker socket group.
45+
- **Impact**: Eliminates noisy log warnings; does not affect functionality.
46+
- **Commit**: `Eliminate persistent "Redact secrets in logs" warnings by running MCP gateway as runner user (#26658)`
47+
48+
### `create_pull_request.base_branch` Honored (2026-04-18)
49+
- The configured `create_pull_request.base_branch` safe-output parameter is now honored in safe-output patch generation.
50+
- **Commit**: `Honor configured create_pull_request.base_branch in safe-output patch generation (#26952)`
51+
52+
### Compile: MCP Stdout Hardening (2026-04-18)
53+
- `gh aw compile` now hardens MCP stdout handling and has compile stdio pollution coverage tests.
54+
- **Commit**: `Harden compile MCP stdout handling and add compile stdio pollution coverage (#26968)`
55+
56+
### SideRepoOps Context (2026-04-18)
57+
- Comment scripts refactored for native `SideRepoOps` context, providing explicit `workflowRepo` vs `eventRepo` distinction.
58+
- **Commit**: `Refactor comment scripts for native SideRepoOps context (workflowRepo vs eventRepo) (#26953)`
59+
60+
### Copilot CLI Pinned to v1.0.21 (2026-04-17)
61+
- Default Copilot CLI version reverted/pinned to v1.0.21 and lockfiles recompiled.
62+
- **Commit**: `Revert default Copilot CLI to v1.0.21 and recompile lockfiles (#26963)`
63+
64+
---
65+
66+
## 4. GitHub Actions / Platform
67+
68+
No significant GitHub Actions platform updates identified in this period beyond what's captured above.
69+
70+
---
71+
72+
## 5. GitHub Copilot
73+
74+
No new Copilot-specific updates beyond what's captured in the gh-aw section above.
75+
76+
---
77+
78+
## 6. Ecosystem / Community
79+
80+
No significant community posts or blog posts identified (web search unavailable; GitHub API only).
81+
82+
---
83+
84+
## 7. Gap Analysis Summary
85+
86+
Gaps identified against reference files (see Phase 4 for detail):
87+
88+
| Gap ID | Priority | File | Description |
89+
|--------|----------|------|-------------|
90+
| GAP-1 | outdated (2) | `gh-aw-architecture.md` | MCP Gateway version v0.1.9 → v0.2.24 |
91+
| GAP-2 | missing (3) | `gh-aw-architecture.md` | AWF version v0.25.24 not documented |
92+
| GAP-3 | missing (3) | `production-gotchas.md` | "Redact secrets in logs" resolved gotcha not documented |
93+
| GAP-4 | missing (3) | `tools-reference.md` | `set_issue_fields` tool (v1.0.0) not documented |
94+
| GAP-5 | missing (3) | `gh-aw-architecture.md` | `SideRepoOps` context (workflowRepo/eventRepo) not documented |
95+
96+
*Note: Gaps from yesterday's run (#32 GAP-1, #33 GAP-2, #34 GAP-3) are still open and excluded from today's new issues.*
97+
98+
---
99+
100+
## 8. Recommended Actions
101+
102+
1. Update `gh-aw-architecture.md` MCP Gateway version to v0.2.24
103+
2. Add AWF version v0.25.24 to architecture documentation
104+
3. Document the "Redact secrets in logs" fix in `production-gotchas.md`
105+
4. Add `set_issue_fields` to `tools-reference.md` GitHub tools section
106+
5. Document `SideRepoOps` context in `gh-aw-architecture.md`

skills/aw-author/references/production-gotchas.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -373,3 +373,25 @@ Repositories with branch protection rulesets that require **signed commits** now
373373
**Current behavior (early 2026+):** gh-aw correctly signs commits on newly created branches. No configuration change needed.
374374

375375
**Edge case:** Custom tokens (`github-token:` in safe-outputs) using a different App identity may still require signing configuration on the target App.
376+
377+
---
378+
379+
## "Redact secrets in logs" Warnings from MCP Gateway
380+
381+
### Symptom
382+
383+
Persistent `"Redact secrets in logs"` warnings appearing in agent workflow logs at MCP gateway startup.
384+
385+
### Root Cause
386+
387+
MCP gateway Docker container was running as a different user than the GitHub Actions runner, causing file permission/ownership mismatches that triggered GitHub Actions' secret redaction heuristics.
388+
389+
### Resolution
390+
391+
**Fixed in gh-aw MCP Gateway v0.2.x** — gateway now runs as runner user with proper uid/gid Docker socket group mapping (gh-aw PR #26658, merged 2026-04-18).
392+
393+
If still seeing this warning:
394+
1. Update gh-aw extension: `gh aw upgrade`
395+
2. Verify MCP gateway is v0.2.24+ by checking workflow logs for the MCP gateway version line.
396+
397+
This was a cosmetic/log-noise issue only — workflow functionality was not impacted.

skills/aw-author/references/tools-reference.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,9 @@ tools:
127127
| `secret_protection` | Secret scanning |
128128
| `security_advisories` | Security advisory management |
129129
| `stargazers` | Star information |
130+
| `copilot` | Copilot job management (`get_copilot_job_status`, `assign_copilot_to_issue`, `create_pull_request_with_copilot`) — default toolset since v0.32.0 |
131+
| `pull_request_granular` | Fine-grained PR operations (`resolve_review_thread`) — feature flag `pull_request_granular`, added v0.33.0 |
132+
| `issues_granular` | Granular issue field operations (`set_issue_fields`) — feature flag `issues_granular`, added v0.33.0 |
130133

131134
### Default Toolsets
132135

@@ -170,6 +173,20 @@ tools:
170173

171174
**Token precedence:** GitHub App → `github-token` → `GH_AW_GITHUB_MCP_SERVER_TOKEN` → `GH_AW_GITHUB_TOKEN` → `GITHUB_TOKEN`
172175

176+
### Notable GitHub MCP Tools (v0.32.0–v1.0.0)
177+
178+
New and notable tools added in recent GitHub MCP Server releases:
179+
180+
| Tool | Toolset | Version | Description |
181+
|------|---------|---------|-------------|
182+
| `get_copilot_job_status` | `copilot` | v0.32.0 | Get status of a Copilot coding agent job |
183+
| `assign_copilot_to_issue` | `copilot` | v0.32.0 | Assign Copilot to work on an issue |
184+
| `create_pull_request_with_copilot` | `copilot` | v0.32.0 | Create a PR with Copilot; supports `base_ref` for stacked PRs |
185+
| `resolve_review_thread` | `pull_request_granular` | v0.33.0 | Resolve a PR review thread by thread ID |
186+
| `set_issue_fields` | `issues_granular` | v1.0.0 | Set/update/delete org-level custom field values on issues |
187+
188+
**`list_commits` parameter additions** (v0.33.0): Added `path` (filter by file), `since` (ISO 8601 start date), and `until` (ISO 8601 end date) parameters to filter commit history.
189+
173190
### App Token Permission Inheritance (CRITICAL)
174191

175192
When using `tools.github.app`, the GitHub MCP server requests **ALL** workflow-level permissions for the App token — not just the ones MCP tools need. If the workflow has `packages: read` (e.g., for GHCR docker login in `steps:`) but the GitHub App doesn't have Packages permission, the App token creation fails with HTTP 422.

0 commit comments

Comments
 (0)