[Daily Report] Daily Status Report — 2026-04-01

[github-actions]

📚 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 the dependabot toolset, which requires vulnerability-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

Generated by Dev · ◷

• expires on Apr 8, 2026, 9:37 AM UTC