docs: missing_docs audit bookkeeping (surface map + snapshot)

[hongyi-chen]

Summary

Companion audit-bookkeeping change for the missing_docs drift-watch run. Collects all surface-map edits and the regenerated snapshot into one PR (per the skill's PR strategy), so the shared feature_surface_map.md and surface_snapshot.json don't conflict across the feature PRs.

Surface map edits

• Map VideoRecording and BackgroundComputerUse -> Computer Use page (docs added in docs: add dedicated Computer Use testing and video recordings page #374).
• Slash commands: replace the removed /enable-natural-language-detection and /disable-natural-language-detection entries with /natural-language-detection; map the new TUI-only /voice and /version -> internal (Warp Agent CLI surface, not in the GUI slash-commands page).
• Settings: map the new TUI-only appearance.zero_state.object, appearance.zero_state.rotation_period_seconds, and appearance.zero_state.extrusion_depth -> internal (SettingSurfaces::TUI, not in the GUI settings UI — consistent with general.autoupdate_enabled).
• Flags: add AccountFirstOnboarding to the internal ignore list (internal login/onboarding flow variant, no distinct user-facing surface).

Snapshot

• Regenerated with --update-snapshot (absorbs the new factory/agent API routes, the report_intent/report_outcome/start_agent server-tool diffs, the new slash/settings surfaces, and advances the last-seen changelog version).

Companion feature PRs: #373 (cloud runners) and #374 (Computer Use recording).

Related feature verified already documented (no change needed)

• Tab pinning, tab groups, and drag-a-tab-to-another-window (changelog 2026.07.23) are already fully documented in terminal/windows/tabs.mdx.

Deferred findings (nothing silently dropped)

These remain open by design and were not documented in this run:

• 41 public API endpoints (/factory/*, /agent/artifacts/*, /agent/events*, /agent/messages*, /agent/schedules/{id}*, /agent/run-by-external-reference). warp-server is a private repo and these are not in the released OpenAPI spec, so they must not be hand-documented. Route any that are publicly released through the sync-openapi-spec skill as a separate change; the rest stay deferred. Factory endpoints back the (preview) software-factory surface.
• 32 docs-staleness (terminology) findings — LOW; pure wording/style is owned by the style_lint skill and is intentionally out of scope here. Several are also false positives in context (e.g. "warp terminal" when distinguishing from Oz, "ai credits" on billing pages).
• Changelog items to verify — the bulk are incremental Warp TUI (Warp Agent CLI) UX improvements and the oh-my-pi (omp) CLI-agent integration. TUI-only surfaces are treated as internal here (matching existing map policy); omp is deferred pending confirmation of public/GA status. The snapshot regen advances the last-seen changelog version so these don't re-fire as noise.

Validation

• missing_docs audit re-run after all edits: feature_flags, cli_commands, slash_commands, and settings findings are all 0; completeness accounting reports no unaccounted items. Remaining findings are only the deferred API (41) and staleness (32) buckets above.
• Both audit modes exited 0 (no audits_skipped, no extraction-guard failures).

Conversation: https://staging.warp.dev/conversation/a962f7a4-4945-4f91-af46-26e65f71152d
Run: https://oz.staging.warp.dev/runs/019f9511-e5f7-78c7-8960-dc26fa67140d

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, Comment	Jul 24, 2026 7:40pm

[oz-for-oss]

@hongyi-chen

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[oz-for-oss]

Overview

This PR updates missing_docs audit bookkeeping by adding surface-map decisions for newly documented computer-use flags, TUI-only slash commands and settings, and an internal onboarding flag, then refreshes the generated surface snapshot to the latest extracted surfaces and changelog baseline.

Concerns

• No blocking correctness, security, or spec-alignment concerns found in the attached diff.
• spec_context.md states no approved or repository spec context was found for this PR.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz