[Daily Report] Documentation Quality Report — April 14, 2026

[github-actions]

Daily status report on documentation quality for the gh-aw project, cross-referenced against open issues.

---

🆕 What Changed Since April 13

• [ca] CLI Version Updates: Claude Code 2.1.104, Copilot 1.0.24, Codex 0.120.0, MCP Gateway v0.2.18 #25978 closed (not_planned, Apr 14): CLI Version Updates issue (Claude Code 2.1.104, Copilot 1.0.24, Codex 0.120.0, MCP Gateway v0.2.18) — closed without documentation updates.
• docs: comprehensive guide for maintaining a repo with agentic workflows #26072 closed (completed, Apr 13): New guide added: comprehensive maintainer guide for repos with agentic workflows — likely added guides/maintaining-repos.md.
• Doc: firewall-audit-logs artifact name not documented for downstream consumers #25683 closed (completed, Apr 10): docs/src/content/docs/reference/artifacts.md created documenting firewall-audit-logs artifact structure.
• [doc-healer] DDUw improvement: scan pkg/constants for new artifact name constants and verify artifacts.md coverage #25813 closed (completed, Apr 11): DDUw improvement to scan pkg/constants/ for new artifact name constants.
• MCP Gateway v0.2.18 ships reaction-based integrity endorsement — no docs yet for this new feature.

---

🐛 Open Documentation Issues

1. #16498 — Provider-based authentication for Claude, Copilot, Codex (open since Feb 2026)

Labels: documentation, enhancement, security

CLAUDE_CODE_OAUTH_TOKEN is used in workflow code but undocumented. Copilot CLI 1.0.19 introduced BYOK (COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY) — none of these appear anywhere in the docs.

Verified gaps (zero matches in docs):

• reference/auth.mdx — no COPILOT_PROVIDER_* entries, no BYOK section
• reference/engines.md — no COPILOT_PROVIDER_* entries
• reference/environment-variables.md — no COPILOT_PROVIDER_* entries

Status: ❌ Active gap — BYOK and provider-based auth entirely undocumented. Open ~2 months.

---

2. #20391 — "Meet the Workflows" stale version links (open since March 2026)

Labels: documentation, automation, workflows

All "Meet the Workflows" blog posts still reference v0.45.5 in install links. Confirmed: 115 occurrences of v0.45.5 across the blog directory.

gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/...

Status: ❌ Ongoing — 115 stale version-pinned links across blog files, no automation covers them.

---

3. Copilot CLI 1.0.24 --mode / --plan flags (new since Apr 13 report)

Related: #25978 (closed not_planned without docs)

Copilot CLI 1.0.24 (shipped Apr 13) adds:

• --mode <interactive|plan|autopilot> — set initial agent mode
• --plan — shorthand for plan mode
• Clarified --autopilot description

reference/engines.md documents --autopilot but has no mention of --mode or --plan. The version checker issue was closed without triggering documentation updates.

Relevant docs: reference/engines.md
Status: ❌ New gap — docs not updated for 1.0.24 release.

---

4. MCP Gateway v0.2.18 reaction endorsement (new — undocumented feature)

MCP Gateway v0.2.18 (shipped Apr 12) adds reaction-based integrity endorsement:

• Thumbs-up/heart reactions from trusted members can promote content integrity
• Thumbs-down/confused can demote content
• endorsement-reactions and disapproval-reactions config keys

No documentation exists for this feature. The integrity reference page (reference/integrity.md) and frontmatter reference need updating.

Relevant docs: reference/integrity.md, reference/frontmatter.md
Status: ❌ New gap — new MCP Gateway feature with zero documentation.

---

5. #18821 — Settings for repositories with long build times (open since Feb 2026)

Labels: scout

Repos with 5–10 min build times (C++, large monorepos) can hit MCP/Bash tool timeouts. No documentation covers timeout configuration per agent or recommended settings.

Relevant docs: reference/sandbox.md, reference/engines.md
Gap: No dedicated timeout guidance section anywhere.
Status: ❌ Ongoing gap — open ~7 weeks, unassigned.

---

✅ Issues Where Documentation Already Contains the Answer

#22001 — WorkQueueOps and BatchOps pages

Labels: documentation

Both pages already exist and are substantial:

• patterns/workqueue-ops.md — 188 lines ✅
• patterns/batch-ops.md — 268 lines ✅

This issue can be closed with pointers to the two pattern pages.

---

📊 Summary

Issue	Title	Status	Relevant Doc
#16498	Copilot BYOK / provider-based auth undocumented	❌ Gap (2mo)	reference/auth.mdx, reference/engines.md
#20391	"Meet the Workflows" stale v0.45.5 links (115 occurrences)	❌ Gap	blog/ directory
#18821	Settings for long build times	❌ Gap (7wk)	reference/sandbox.md
(no issue)	Copilot CLI 1.0.24 --mode/--plan flags	❌ New gap	reference/engines.md
(no issue)	MCP Gateway v0.2.18 reaction endorsement	❌ New gap	reference/integrity.md
#22001	WorkQueueOps and BatchOps pages	✅ Can close — docs exist

---

🔍 Documentation Structure Health

148 documentation files across docs/src/content/docs/. Priority files needing attention:

• reference/engines.md — Add Copilot 1.0.24 --mode/--plan flags
• reference/auth.mdx — Add BYOK section (COPILOT_PROVIDER_* env vars), document CLAUDE_CODE_OAUTH_TOKEN
• reference/integrity.md — Add MCP Gateway v0.2.18 reaction endorsement (endorsement-reactions, disapproval-reactions)
• reference/sandbox.md — Add timeout configuration guidance for long-build repos
• blog/ — 115 stale v0.45.5 version-pinned links need updating

🎯 Recommended Actions

1. High priority: Document Copilot CLI 1.0.24 --mode/--plan in reference/engines.md — new release, quick update
2. High priority: Document MCP Gateway v0.2.18 reaction endorsement in reference/integrity.md — new security-relevant feature
3. Medium priority: Add BYOK documentation to reference/auth.mdx (Provider-based authentication for Claude, Copilot, Codex. #16498 — open 2 months)
4. Low priority: Close Add WorkQueueOps and BatchOps doc pages under design patterns #22001 — workqueue-ops and batch-ops pages already exist
5. Low priority: Add timeout guidance to reference/sandbox.md (Review settings for using in repositories with long build times #18821)

Note

🔒 Integrity filter blocked 22 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".
• #25993 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #26069 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #26101 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #25363 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".
• #24422 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21426 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #24949 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21615 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19380 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #24403 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".
• #26120 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #11190 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #18329 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• ... and 6 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 · ● 1.4M · ◷

• expires on Apr 21, 2026, 9:13 AM UTC

[github-actions]

This issue was automatically closed because it expired on 2026-04-21T09:13:25.342Z.

Closed by Workflow