[docs] Update documentation for features from 2026-04-16

[github-actions]

Documentation Updates - April 16, 2026

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

• byok-copilot feature flag for Copilot offline BYOK mode (from Add byok-copilot feature flag for Copilot offline BYOK mode wiring and bump default firewall to v0.25.21 #26544)
• github-app.client-id migration away from deprecated app-id (from Migrate GitHub App token input to client-id, add schema-level compatibility, and provide codemod migration #26551)
• status-comment object form with issues/pull-requests/discussions toggles (from Scope activation-job permissions to actual trigger events and add status-comment discussions/issues/pull-requests toggles #26535)

📝 Detailed Changes & References

Changes Made

• docs/src/content/docs/reference/frontmatter.md: Added dedicated byok-copilot subsection under features: documenting the single-flag BYOK mode composition. Updated status-comment: field description to mention the new object form.
• docs/src/content/docs/reference/triggers.md: Added object-form section for status-comment with issues, pull-requests, and discussions toggle fields and a reference table. Updated all github-app examples to use client-id.
• docs/src/content/docs/reference/checkout.md: Updated github-app example and configuration table to use client-id as preferred field with deprecation note for app-id.
• docs/src/content/docs/reference/glossary.md: Updated GitHub App definition to mention client-id as preferred and app-id as deprecated alias, with codemod migration note.
• docs/src/content/docs/reference/auth.mdx: Updated both github-app examples (tools.github and safe-outputs) to use client-id.
• docs/src/content/docs/reference/faq.md, tokens.md, imports.md, safe-outputs.md, safe-outputs-pull-requests.md: Updated github-app examples to use client-id.

Merged PRs Referenced

• Add byok-copilot feature flag for Copilot offline BYOK mode wiring and bump default firewall to v0.25.21 #26544 — Add byok-copilot feature flag for Copilot offline BYOK mode wiring
• Migrate GitHub App token input to client-id, add schema-level compatibility, and provide codemod migration #26551 — Migrate GitHub App token input to client-id, add schema-level compatibility, and provide codemod migration
• Scope activation-job permissions to actual trigger events and add status-comment discussions/issues/pull-requests toggles #26535 — Scope activation-job permissions to actual trigger events and add status-comment discussions/issues/pull-requests toggles

Skipped Issues

• Provider-based authentication for Claude, Copilot, Codex. #16498 (Provider-based authentication for Claude, Copilot, Codex): Partially addressed — core auth docs are correct; BYOK model requirement for Copilot CLI 1.0.28 is tracked as bug bug: byok-copilot feature generates empty COPILOT_MODEL fallback, breaking BYOK mode #26565 and requires a code fix before documentation.
• Meet the workflows points to specific versions, need to keep these up to date #20391 (Stale version-pinned links in blog posts): 115 occurrences across 18+ blog files — requires bulk automation, out of scope for this run.
• Add WorkQueueOps and BatchOps doc pages under design patterns #22001 (WorkQueueOps and BatchOps doc pages): Both pages already exist at patterns/workqueue-ops.md and patterns/batch-ops.md — issue can be closed by maintainers.

Notes

The client-id migration leaves frontmatter-full.md and safe-outputs-specification.md unchanged — these are schema-derived specification files. The JSON schema was already updated by #26551. Run gh aw fix to automatically migrate existing workflow files from app-id to client-id.

Generated by Daily Documentation Updater · ● 857.8K · ◷

• expires on Apr 17, 2026, 11:02 AM UTC