[Daily Report] Daily Status Report — 2026-04-01 #23851
Description
📚 Documentation Quality — Daily Status Report
Date: 2026-04-01 | Scope: gh-aw documentation health
Previous report: #23659 (2026-03-31)
Summary
| Category | Count |
|---|---|
| Carry-over documentation gaps | 1 |
| Open issues with documentation problems | 6 🔴 |
| Issues now answerable by existing documentation | 2 ✅ |
| Documentation gaps without coverage | 3 ❌ |
⚠️ Carry-Over from Previous Report
toolsets: [all] shorthand undocumented — ongoing gap
Status: No doc addition yet for toolsets: [all] in reference/github-tools.md.
Note: The previous report referenced #22207 for this carry-over, but #22207 was actually a compiler bug (closed not_planned on 2026-03-25). The underlying documentation gap — that toolsets: [all] silently includes dependabot and requires vulnerability-alerts: read — remains unaddressed in reference/github-tools.md.
Recommended action: Add a callout to reference/github-tools.md:
⚠️ toolsets: [all]includes thedependabottoolset, which requiresvulnerability-alerts: read(GitHub App–only). Prefer listing specific toolsets if you don't need Dependabot tools.
🆕 New Issue Since Last Report
Issue #23832 — Add "Supported Languages" reference page
Title: Docs: Add "Supported Languages" reference page
Created: 2026-04-01 | Labels: documentation, enhancement
Problem: Users configuring their first workflow for Go, Java, or Rust must piece together which ecosystem identifier to use from two separate pages (reference/network and guides/network-configuration). No single discoverable page answers "which languages does this support?"
Docs cross-reference: docs/src/content/docs/reference/network.md and docs/src/content/docs/guides/network-configuration.md contain the information in a fragmented way. docs/src/content/docs/reference/supported-languages.md does not exist.
Classification: ❌ Documentation gap. A new reference/supported-languages.md page is needed covering language → ecosystem identifier → package manager mapping, with configuration examples.
🔴 Open Issues with Documentation Problems (Carry-Over)
Issue #19703 — .github/agents/ path does not resolve
Problem: docs/src/content/docs/reference/copilot-custom-agents.md states agent files should live in .github/agents/, but the compiler resolves imports relative to .github/workflows/, causing a "file not found" error.
Classification: ❌ Docs/implementation mismatch — still unresolved.
Issue #19611 — .github/agents imports on Claude/Codex take fragile path
Problem: docs/src/content/docs/reference/imports.md (lines 76–120) and copilot-custom-agents.md claim agent imports work cross-engine; in practice they use a fragile AGENT_CONTENT + PROMPT_TEXT assembly. The .github/snippets/ workaround is undocumented.
Classification: ❌ Docs/implementation mismatch — still unresolved.
Issue #22939 — AWF agent cannot reach Postgres started via services:
Problem: docs/src/content/docs/reference/frontmatter.md → ## Service Containers (services:) documents the field with a Postgres example but never clarifies that service containers are unreachable from inside the agent sandbox (ports bind to the host, not accessible across network isolation boundary).
Classification: ❌ Documentation gap — still unresolved.
Issue #23212 — gh aw add rewrites imports with incorrect path
Problem: docs/src/content/docs/guides/packaging-imports.md covers packaging patterns but does not document gh aw add's import-rewriting behavior, the wrong base path it uses, or how to opt out of rewriting for local imports.
Classification: ❌ Undocumented behavior — still unresolved.
Issue #1250 — "web-search" not available when using Copilot CLI (now closeable)
Original problem: Workflows trigger Engine 'copilot' does not support the web-search tool with no actionable guidance.
Current state: docs/src/content/docs/guides/web-search.md now exists — it covers Tavily MCP configuration and mentions alternatives (Exa, SerpAPI, Brave Search).
Assessment: ✅ This issue is closeable with a pointer to guides/web-search.md.
✅ Issues Answerable by Existing Documentation
Issue #20593 — Documentation missing for GH_AW_GITHUB_TOKEN
(Carry-over from previous report) docs/src/content/docs/reference/tokens.md provides a comprehensive reference including GH_AW_GITHUB_TOKEN and its fallback chain. Recommend closing with a pointer to tokens.md#gh_aw_github_token.
Issue #1250 — "web-search" not available
(See above) guides/web-search.md now addresses this directly.
📊 Day-over-Day Trend
| Metric | 2026-03-31 | 2026-04-01 | Change |
|---|---|---|---|
| Open doc-problem issues | 5 | 6 | ⬆️ +1 (new #23832) |
| Issues closeable with doc pointer | 1 | 2 | ✅ +1 (web-search.md created) |
| Carry-over gaps | 1 | 1 | ↔ Stable (toolsets: [all] undocumented) |
| New reference pages added | — | web-search.md ✅ |
🆕 1 guide added |
| Missing reference pages | — | supported-languages.md ❌ |
🆕 1 gap identified |
🎯 Recommended Actions
| Priority | Action | Target |
|---|---|---|
| High | Fix compiler or update docs for .github/agents/ path resolution |
#19703, #19611 |
| High | Add sandbox networking note to services: section in frontmatter.md |
#22939 |
| Medium | Create reference/supported-languages.md page |
#23832 |
| Medium | Document gh aw add import rewriting in packaging-imports.md |
#23212 |
| Medium | Add toolsets: [all] warning callout to github-tools.md |
carry-over |
| Low | Close #1250 with pointer to guides/web-search.md |
#1250 |
| Low | Close #20593 with pointer to reference/tokens.md#gh_aw_github_token |
#20593 |
Generated by Daily Status Report workflow — 2026-04-01 09:31 UTC
Note
🔒 Integrity filter blocked 19 items
The following items were blocked because they don't meet the GitHub integrity level.
- engine: claude — squid proxy rejects chroot localhost connections (transaction-end-before-headers) #23765
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - Ask: Runtime Parameterization of Compile-Time Frontmatter Fields #23724
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - create-code-scanning-alert safe-output doesn't seem to work as it should #23725
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - Request: Allow commenting, editing posts within a Discussion #23753
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - Feature request: allow for templating of steps #23766
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - assign_to_agent: allow multiple assignments to same issue when pull_request_repo differs #23726
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - Ability for checkout_pr_branch.cjs to preserve .github/skills/ and .github/instructions/ from base branch #23769
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - engine: claude — get-claude-key.sh missing in chroot (AWF v0.25.4), apiKeyHelper exit 127 #23614
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #20593
search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #20717
search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #20508
search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #23725
search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #19080
search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #21306
search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #21188
search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - #20593
issue_read: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - ... and 3 more items
To allow these resources, lower min-integrity in your GitHub frontmatter:
tools:
github:
min-integrity: approved # merged | approved | unapproved | none
- expires on Apr 8, 2026, 9:37 AM UTC