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

[github-actions]

📚 Documentation Quality — Daily Status Report

Date: 2026-04-02 | Scope: gh-aw documentation health
Previous report: #23851 (2026-04-01)

---

Summary

Category	Count
Carry-over documentation gaps	5 ⚠️
New issues with documentation problems	4 🆕
Documentation gaps without coverage	4 ❌
Issues closed / docs improved since last report	3 ✅

---

✅ Progress Since Last Report

#23832 — "Supported Languages" reference page → CLOSED (2026-04-01)

The gap identified in the 2026-04-01 report was resolved. A supported-languages reference page was created.

docs: improve security architecture explanation in index.mdx (commit #24026)

Security architecture docs were improved in docs/src/content/docs/index.mdx.

docs: condense verbose sections in common-issues.md (commit #24010)

Verbose troubleshooting sections in docs/src/content/docs/reference/common-issues.md were condensed for clarity.

---

🆕 New Issues Since Last Report

Issue #23950 — Docs: clarify default AWF memory limit

Created: 2026-04-01 | Reporter: @Mossaka | Labels: documentation

Problem: docs/src/content/docs/reference/frontmatter.md → ## memory field states "AWF's default is used when unspecified" but does not state what that default value is. The actual default is 6g (set in gh-aw-firewall/src/docker-manager.ts).

Docs cross-reference: docs/src/content/docs/reference/frontmatter.md — memory: field documentation.

Classification: ❌ Documentation gap — fix is simple: add (default: 6g) to the memory field description.

---

Issue #23957 — docs: add audit command reference page

Created: 2026-04-01 | Reporter: @Mossaka | Labels: documentation, enhancement, audit, cli | Part of epic: #22735

Problem: The audit feature shipped ~13K LOC with 3 CLI commands (gh aw audit, gh aw audit diff, gh aw audit report) but there are zero dedicated documentation pages in the docs site.

Docs cross-reference: No file docs/src/content/docs/reference/audit.md exists. Closest related files: docs/src/content/docs/reference/ (command references) and pkg/cli/audit.go, pkg/cli/audit_report.go.

Classification: ❌ Missing documentation — a new reference/audit.md page is needed covering all three audit subcommands, flags, output formats, and JSON schemas.

---

Issue #23958 — docs: add guide for consuming audit reports with an agent

Created: 2026-04-01 | Labels: documentation, enhancement, audit, cli | Part of epic: #22735

Problem: The audit commands produce rich structured output (JSON, markdown) consumable programmatically by agents, but no guide shows users how to do this.

Docs cross-reference: No file docs/src/content/docs/guides/audit-with-agent.md exists.

Classification: ❌ Missing documentation — a new guides/audit-with-agent.md page is needed.

---

Issue #23959 — docs: enhance existing pages with audit cross-references and glossary entries

Created: 2026-04-01 | Labels: documentation, enhancement, audit | Part of epic: #22735

Problem: Several existing pages need updating to mention the audit feature for discoverability:

• reference/glossary.md — needs entries for Audit, Audit diff, Firewall analysis, Behavior fingerprint
• reference/frontmatter.md — needs an audit tip linking to reference/audit.md
• guides/debugging.md — needs an "Analyzing failures with audit" section

Classification: ❌ Documentation gap — spread across multiple existing pages.

---

⚠️ Carry-Over Documentation Gaps

toolsets: [all] shorthand undocumented — ongoing gap

Status: No doc addition yet. reference/github-tools.md still lacks a warning that toolsets: [all] silently includes the dependabot toolset requiring vulnerability-alerts: read (GitHub App–only).

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 unless you need Dependabot tools.

---

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 "file not found" errors.

Classification: ❌ Docs/implementation mismatch — unresolved.

---

Issue #19611 — .github/agents imports on Claude/Codex take fragile path

Problem: docs/src/content/docs/reference/imports.md and copilot-custom-agents.md claim agent imports work cross-engine; in practice the .github/snippets/ workaround is undocumented.

Classification: ❌ Docs/implementation mismatch — 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.

Classification: ❌ Documentation gap — unresolved.

---

Issue #23212 — gh aw add rewrites imports with incorrect path

Problem: docs/src/content/docs/guides/packaging-imports.md does not document gh aw add's import-rewriting behavior, the incorrect base path it uses, or how to opt out.

Classification: ❌ Undocumented behavior — unresolved.

---

📊 Day-over-Day Trend

Metric	2026-04-01	2026-04-02	Change
Open doc-problem issues	6	9	⬆️ +4 new, -1 closed (#23832)
Carry-over gaps	1	5	⬆️ +4 (3 audit gaps, 1 memory clarification)
Issues closeable with doc pointer	2	0 new	—
Reference pages added	1 (supported-languages.md)	2 doc commits	✅
Missing reference pages	1	2 (audit.md, audit-with-agent.md)	⬆️ +2

---

🎯 Recommended Actions

Priority	Action	Target
High	Create reference/audit.md command reference page	#23957
High	Create guides/audit-with-agent.md	#23958
High	Fix compiler or update docs for .github/agents/ path resolution	#19703, #19611
Medium	Add sandbox networking note to services: section in frontmatter.md	#22939
Medium	Add default memory value (6g) to frontmatter.md memory: field	#23950
Medium	Add audit cross-references to glossary, frontmatter, debugging guide	#23959
Medium	Document gh aw add import rewriting in packaging-imports.md	#23212
Low	Add toolsets: [all] warning callout to github-tools.md	carry-over

---

Generated by Daily Status Report workflow — 2026-04-02 09:26 UTC

Note

🔒 Integrity filter blocked 31 items

The following items were blocked because they don't meet the GitHub integrity level.

• #20593 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #20207 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #20514 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #22929 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #23769 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".
• #18407 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #22533 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19611 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #22897 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #23940 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".
• #21784 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".
• ... and 15 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 9, 2026, 9:47 AM UTC