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

[github-actions]

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

---

🆕 What Changed Since April 15

• bug: byok-copilot feature generates empty COPILOT_MODEL fallback, breaking BYOK mode #26565 opened (Apr 16): byok-copilot feature generates empty COPILOT_MODEL fallback — breaks BYOK mode with Copilot CLI 1.0.28. New documentation gap identified.
• [ca] Update CLI versions: Claude Code 2.1.110, Copilot 1.0.28, Codex 0.121.0, Gemini 0.38.1, GitHub MCP v0.33.1, MCPG v0.2.20 #26556 opened (Apr 16): CLI version bump — Copilot CLI 1.0.21 → 1.0.28. Subcommand restructure: copilot config --help and copilot environment --help are gone; replaced by copilot help config / copilot help environment. Docs not yet updated.
• Documentation Unbloat workflow failing ([aw] Documentation Unbloat failed #26554): Automation that keeps docs lean is hitting engine errors, meaning documentation bloat may go unaddressed.

---

🐛 Open Documentation Issues

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

Labels: documentation, enhancement, security

The issue asks for documentation (and support) of provider-based authentication across engines.

Current doc state:

• CLAUDE_CODE_OAUTH_TOKEN is documented as unsupported in reference/auth.mdx (line 121–123) ✅
• byok-copilot feature flag is mentioned in reference/glossary.md ✅
• Gap: The glossary entry for byok-copilot does not document that Copilot CLI 1.0.28 requires an explicit model in BYOK mode — this is now a live bug (bug: byok-copilot feature generates empty COPILOT_MODEL fallback, breaking BYOK mode #26565).

Relevant docs: reference/auth.mdx, reference/frontmatter.md, reference/engines.md
Status: ❌ Partially addressed — BYOK model requirement undocumented, now also a live bug.

---

2. #20391 — Stale version-pinned links in blog posts (open since Mar 2026)

Labels: documentation, automation, workflows

Blog posts contain gh aw add-wizard links pinned to v0.45.5 — an old release. No automation keeps these current.

Current doc state:

• 115 occurrences of v0.45.5 across docs/src/content/docs/blog/ ✅ confirmed
• No link validation automation in place

Relevant docs: docs/src/content/docs/blog/ (18+ files)
Status: ❌ Ongoing — 115 stale version-pinned links, unresolved for 5+ weeks.

---

3. #26565 — byok-copilot empty COPILOT_MODEL fallback (NEW, Apr 16)

Labels: bug

Copilot CLI 1.0.28 in BYOK mode requires an explicit model (COPILOT_MODEL). The compiler currently generates an empty string fallback, causing immediate failure. The workaround (manually patching .lock.yml) is tedious and breaks on every recompile.

Current doc state:

• reference/glossary.md mentions byok-copilot but says nothing about model requirements
• reference/engines.md covers max-continuations and autopilot but not BYOK model configuration
• Gap: No documentation of the model frontmatter field for BYOK workflows or the GH_AW_MODEL_AGENT_COPILOT variable in a BYOK context

Relevant docs: reference/frontmatter.md, reference/engines.md, reference/glossary.md
Status: ❌ New gap — no documentation of BYOK model requirement. Also tracked as a bug.

---

4. Copilot CLI 1.0.28 subcommand restructure (new gap, no issue filed)

From #26556: copilot config --help and copilot environment --help no longer work as direct subcommands. Users must use copilot help config and copilot help environment.

Current doc state:

• reference/engines.md does not appear to reference copilot config or copilot environment directly
• No known breakage in the docs, but any external guides/blog posts referencing the old syntax are now stale

Status: ⚠️ Low-severity — verify reference/engines.md and blog content does not reference old subcommand paths.

---

✅ Issues Where Documentation Already Contains the Answer

#22001 — Add WorkQueueOps and BatchOps doc pages

Labels: documentation

Both pages exist and appear substantial:

• docs/src/content/docs/patterns/workqueue-ops.md ✅
• docs/src/content/docs/patterns/batch-ops.md ✅

Recommendation: Close #22001 with pointers to these two pages.

---

📊 Summary

Issue	Title	Status	Relevant Doc
#16498	Provider-based auth (BYOK)	❌ Gap (2mo)	reference/auth.mdx, reference/engines.md
#20391	115 stale v0.45.5 links in blog	❌ Gap (5wk)	blog/ directory
#26565 (NEW)	byok-copilot COPILOT_MODEL undocumented	❌ New gap + bug	reference/frontmatter.md, reference/engines.md
(no issue)	Copilot 1.0.28 subcommand restructure	⚠️ Low risk — verify docs	reference/engines.md
#22001	WorkQueueOps and BatchOps pages	✅ Docs exist — can close	patterns/workqueue-ops.md, patterns/batch-ops.md

---

🎯 Recommended Actions

1. High priority: Document byok-copilot model requirement in reference/frontmatter.md and reference/engines.md — directly tied to live bug bug: byok-copilot feature generates empty COPILOT_MODEL fallback, breaking BYOK mode #26565
2. Medium priority: Close Add WorkQueueOps and BatchOps doc pages under design patterns #22001 with pointers to patterns/workqueue-ops.md and patterns/batch-ops.md
3. Medium priority: Continue tracking Provider-based authentication for Claude, Copilot, Codex. #16498 — auth docs are largely correct but BYOK model interaction is now a real user pain point
4. Low priority: Automate version link updates in blog/ directory (Meet the workflows points to specific versions, need to keep these up to date #20391)
5. Low priority: Verify no docs reference deprecated copilot config --help / copilot environment --help subcommand paths (Copilot 1.0.28 change)

Note

🔒 Integrity filter blocked 16 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".
• #26156 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".
• #19080 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21130 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".
• #22533 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• create_issue.cjs: issue body bypasses @mention neutralization — asymmetric sanitization relative to title path #26588 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• cache-memory: default integrity: none restores unvalidated prior-run content to agent filesystem before any detection gate #26586 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Safeoutputs write-sink reachable from bash in github-readonly profile — shared MCP bearer token bypasses declared read-only perm [Content truncated due to length] #26584 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• agent: "Redact secrets in logs" step emits 3 warnings — EACCES permission denied on MCP log files #26569 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Dev · ● 1M · ◷

• expires on Apr 23, 2026, 9:18 AM UTC