docs: close missing-docs audit gaps for GA surfaces

[hongyi-chen]

Summary

Ran the missing_docs audit against the current warp-internal and warp-server sources and closed every non-API gap it reported.

Before: 56 gaps — 1 feature, 4 slash commands, 2 settings, 2 map-hygiene, 15 API, 32 staleness
After: 47 gaps — only the 15 API findings and 32 pre-existing staleness findings remain

Features, CLI commands, slash commands, and settings now all report zero findings with full completeness accounting.

Update: reconciled with #407

Since this PR was opened, #407 merged and split the BYOLLM docs into a landing page (bring-your-own-llm.mdx) plus dedicated per-host pages (byollm-aws-bedrock.mdx and byollm-gemini-enterprise.mdx). That dedicated Gemini Enterprise page now fully covers the feature gap this PR originally addressed with prose in the single BYOLLM file.

This branch now merges main and drops the now-redundant Gemini Enterprise prose it had added to bring-your-own-llm.mdx (the only merge conflict; resolved by taking #407's restructured version). The remaining Gemini change here is a one-line audit-map retarget (see Surface map below). This addresses point (1) of @hongyi-chen's review. Point (2) — the API false-positive/regex fix in audit_docs.py — is disjoint and handled by #446, so it stays out of this PR.

Changes

Bring your own LLM: Gemini Enterprise (now owned by #407)

Originally added a Supported hosts section, the workload identity federation credential flow, per-host model availability, setup/troubleshooting, and FAQ coverage to bring-your-own-llm.mdx. #407 has since delivered all of this in the dedicated byollm-gemini-enterprise.mdx page, so those additions are dropped here to avoid duplication and conflicts.

All settings: document auto_approve_bypasses_command_denylist

An always-on, all-surfaces setting missing from the [agents.warp_agent.other] section. It defaults to true, so auto-approve and Run until completion run denylisted commands unless you turn it off — worth being discoverable in the TOML reference. Links to the existing Run until completion and Command denylist sections.

Slash commands: document /copy-debugging-id

The only undocumented slash command with a GUI surface (GuiAndTui). The other three flagged commands are TUI-only and are mapped as internal instead.

Drive-by fix

The Run until completion caution pointed at Settings > Agents > Oz > Input. The section is labeled Warp Agent (confirmed in settings_view/nav.rs), and per the style guide "Oz" is not one of the Agents subpages.

Surface map

• Retarget the GeminiEnterprise flag to the dedicated byollm-gemini-enterprise.mdx page added by docs: Add Gemini Enterprise (Vertex AI) BYOLLM documentation #407 (previously pointed at the single bring-your-own-llm.mdx).
• Map the three TUI-only slash commands (/api-keys, /reset-statusline, /vim-mode) to internal, following the convention already used for /status, /clear, /statusline, and /theme.
• Prune /add-api-key and /clear-provider-api-key, which the map-hygiene audit flagged as gone from code. /api-keys replaced them.
• Map agents.voice.voice_input_hold_key to internal (SettingSurfaces::TUI). The documented GUI equivalent is agents.voice.voice_input_toggle_key.

Deliberately out of scope

The 15 remaining API findings are public endpoints missing from developers/agent-api-openapi.yaml. Per the surface map's own policy, they require confirming release status and routing through the sync-openapi-spec skill, so they belong in a separate change. Note that #446 fixes an audit_docs.py regex bug that was inflating the API count (parse_openapi_paths() didn't match quoted YAML path keys); after that lands, spec_covered rises 9 → 22. The 32 staleness findings are pre-existing and unchanged by this PR.

Testing

• Merged origin/main (bringing in docs: Add Gemini Enterprise (Vertex AI) BYOLLM documentation #407 and other merged PRs). The only conflict was bring-your-own-llm.mdx, resolved by taking docs: Add Gemini Enterprise (Vertex AI) BYOLLM documentation #407's restructured version; the resolved file is byte-identical to main.
• Verified every doc-path target in the missing_docs surface map resolves to a real file, including the retargeted byollm-gemini-enterprise.mdx.
• CI (build, link-check, audit) runs on push; the content changes are unchanged from the previously green commit.

Note for reviewers

I initially drafted this against warpdotdev/gitbook, which turns out to be archived and read-only. That repo also predates several pages that already exist here (custom routers, runners, prompt queueing), so I re-ran the audit against this repo and scoped the work to gaps that are actually still open.

Conversation: https://app.warp.dev/conversation/bd56ad19-fd93-414d-9fbe-bae84d973c24
Run: https://oz.warp.dev/runs/019fb766-fd99-7722-95a0-cc17405215a7

This PR was generated with Oz.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Jul 31, 2026 1:58pm

[hongyi-chen]

A missing_docs drift-watch run independently reached most of the same conclusions as this PR. I closed my duplicates (#443, #444) and narrowed my bookkeeping PR (#446) so nothing here conflicts. Two things surfaced that may be worth folding in:

1. The GeminiEnterprise map target may be stale. This PR maps it to bring-your-own-llm.mdx. #407 has since merged a dedicated page, src/content/docs/enterprise/enterprise-features/byollm-gemini-enterprise.mdx, which looks like the better target.

2. Six API findings in the same audit were false positives. parse_openapi_paths() in audit_docs.py only matched unquoted YAML path keys, so every '/path/{param}': looked absent from the spec. #446 fixes the regex; spec_covered goes 9 → 22. Worth knowing if this PR's triage was working from the same inflated API list.

#446 is disjoint from this PR (audit-script fix, /agent/messages/* and /agent/events/* internal mappings, snapshot regen), so the two can merge in either order.

Co-Authored-By: Oz oz-agent@warp.dev

[hongyi-chen]

Thanks @hongyi-chen — folded in both:

1. GeminiEnterprise retarget. Merged main (bringing in docs: Add Gemini Enterprise (Vertex AI) BYOLLM documentation #407) and retargeted the audit map from bring-your-own-llm.mdx to the dedicated byollm-gemini-enterprise.mdx page. The only merge conflict was bring-your-own-llm.mdx; I resolved it by taking docs: Add Gemini Enterprise (Vertex AI) BYOLLM documentation #407's restructured version and dropping this PR's now-redundant Gemini prose, so there's no duplication.

2. API false positives / parse_openapi_paths() regex. Left to docs: missing_docs audit bookkeeping and OpenAPI path-parsing fix #446 since it's disjoint (audit-script fix + internal /agent/messages/* and /agent/events/* mappings + snapshot regen). I noted in the PR description that docs: missing_docs audit bookkeeping and OpenAPI path-parsing fix #446 raises spec_covered 9 → 22 so the remaining API triage here should be read against the corrected count. Happy to merge in either order.

This reply was generated with Oz.