docs(missing_docs): audit bookkeeping (surface map + snapshot)

.agents/skills/missing_docs/references/feature_surface_map.md

@@ -104,7 +104,9 @@ AgentViewBlockContext -> src/content/docs/agent-platform/local-agents/agent-cont
 CloudConversations -> src/content/docs/agent-platform/local-agents/cloud-conversations.mdx
 CloudModeFromLocalSession -> src/content/docs/platform/index.mdx
 TeamApiKeys -> src/content/docs/reference/cli/api-keys.md
-PRCommentsSlashCommand -> src/content/docs/agent-platform/capabilities/slash-commands.mdx
+# The PRCommentsSlashCommand flag was removed: the /pr-comments slash command was
+# replaced by the bundled PR Comments skill (invoked via /skills), so the slash
+# command was dropped from the docs.
 PRCommentsV2 -> src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx
 CLIAgentRichInput -> src/content/docs/agent-platform/cli-agents/rich-input.md
 HOANotifications -> src/content/docs/agent-platform/capabilities/agent-notifications.mdx
@@ -135,9 +137,10 @@ WorkflowAliases -> src/content/docs/terminal/entry/yaml-workflows.mdx
 KittyImages -> src/content/docs/terminal/more-features/full-screen-apps.mdx
 UndoClosedPanes -> src/content/docs/terminal/windows/tabs.mdx
 # Tab groups (organize tabs into named, collapsible groups) — GA (in the default
-# feature set). Pinning tab groups is still Preview (PinnedTabs), so it stays out
-# of the docs for now.
+# feature set).
 GroupedTabs -> src/content/docs/terminal/windows/tabs.mdx
+# Pin individual tabs and whole tab groups to the front of the tab bar — GA.
+PinnedTabs -> src/content/docs/terminal/windows/tabs.mdx
 # Drag a tab out to its own window or between windows. GA on macOS and Windows
 # (RELEASE_FLAGS, cfg-gated), documented with that platform caveat.
 DragTabsToWindows -> src/content/docs/terminal/windows/tabs.mdx
@@ -175,8 +178,9 @@ OzHandoff -> src/content/docs/platform/handoff/index.mdx
 HandoffLocalCloud -> src/content/docs/platform/handoff/local-to-cloud.mdx
 HandoffCloudCloud -> src/content/docs/platform/handoff/cloud-to-cloud.mdx
 
-# Orchestration / multi-agent runs
-RunAgentsTool -> src/content/docs/platform/orchestration/multi-agent-runs.mdx
+# Orchestration / multi-agent runs is documented at
+# platform/orchestration/multi-agent-runs.mdx. The RunAgentsTool flag was removed
+# after the feature stabilized (GA), so it no longer needs a map entry.
 
 # Prompt queueing
 QueueSlashCommand -> src/content/docs/agent-platform/local-agents/interacting-with-agents/prompt-queueing.mdx
@@ -253,6 +257,16 @@ oz provider -> gated:ProviderCommand
 oz provider setup -> gated:ProviderCommand
 oz provider list -> gated:ProviderCommand
 
+# `oz runner` (manage cloud agent runners) is gated by CloudAgentRunnerCLICommands,
+# which is non-GA (dogfood), so the command group is deferred via `gated:` — it
+# auto-surfaces for docs when the flag goes GA. See "Public vs. private surfaces"
+# in SKILL.md.
+oz runner -> gated:CloudAgentRunnerCLICommands
+oz runner list -> gated:CloudAgentRunnerCLICommands
+oz runner create -> gated:CloudAgentRunnerCLICommands
+oz runner update -> gated:CloudAgentRunnerCLICommands
+oz runner delete -> gated:CloudAgentRunnerCLICommands
+
 # Internal/hidden command — not a user-facing surface, so no public docs.
 oz harness-support -> internal
 
@@ -461,18 +475,14 @@ CloudModeSetupV2
 CloudModeInputV2
 # Internal GitHub credential refresh during task runs (changelog-only behavior fix).
 GitCredentialRefresh
-# Internal SSE streaming infrastructure for orchestration viewers/owners.
-OrchestrationViewerStreamer
-OwnerOrchestrationAncestorStreamer
+# State-mutating recovery for abnormal terminal lifecycle sequences — an internal
+# reliability mechanism with no user-facing configuration or UI, so it needs no docs.
+TerminalLifecycleRecovery
 
 # Sub-feature toggles and pre-launch flags. Section placement does NOT assert
 # rollout status (the audit computes that from code); entries here are ignored
 # because the toggle itself isn't a documentable surface, or because the
 # feature isn't user-facing yet — the snapshot diff flags promotions.
-# Pinned Tabs is a Preview feature (pin individual tabs and whole tab groups to
-# the front of the tab list); public docs are pending GA promotion, which the
-# snapshot diff will flag.
-PinnedTabs
 LSPAsATool
 EmbeddedCodeReviewComments
 InteractiveConversationManagementView

.agents/skills/missing_docs/references/surface_snapshot.json

@@ -39,7 +39,7 @@
     "AmbientAgentsRTC": "ga",
     "ArtifactCommand": "ga",
     "AskUserQuestion": "ga",
-    "AsyncFind": "preview",
+    "AsyncFind": "ga",
     "AtMenuOutsideOfAIMode": "ga",
     "AutoOpenCodeReviewPane": "ga",
     "Autoupdate": "ga",
@@ -49,13 +49,15 @@
     "BillingAndUsagePageV2": "ga",
     "BlocklistMarkdownImages": "ga",
     "BlocklistMarkdownTableRendering": "ga",
+    "BoxDrawingGlyphs": "dogfood",
     "BuildPlanAutoReloadBannerToggle": "other",
     "BuildPlanAutoReloadPostPurchaseModal": "other",
     "BundledSkills": "ga",
     "CLIAgentRichInput": "ga",
     "Changelog": "ga",
     "ClassicCompletions": "ga",
     "ClearAutosuggestionOnEscape": "ga",
+    "CloudAgentRunnerCLICommands": "dogfood",
     "CloudConversations": "ga",
     "CloudEnvironments": "ga",
     "CloudMode": "ga",
@@ -123,7 +125,7 @@
     "FullScreenZenMode": "ga",
     "FullSourceCodeEmbedding": "dogfood",
     "GPTConfigurableContextWindow": "dogfood",
-    "GeminiEnterprise": "other",
+    "GeminiEnterprise": "dogfood",
     "GeminiNotifications": "dogfood",
     "GetStartedTab": "ga",
     "GitCredentialRefresh": "ga",
@@ -183,24 +185,22 @@
     "NamedAgents": "ga",
     "NativeShellCompletions": "other",
     "NewTabStyling": "ga",
-    "NldPromptHistoryMatch": "dogfood",
+    "NldPromptHistoryMatch": "other",
     "OpenCodeNotifications": "ga",
     "OpenWarpLaunchModal": "ga",
     "OpenWarpNewSettingsModes": "ga",
     "OrchestrationLaunchModal": "ga",
-    "OrchestrationViewerStreamer": "ga",
-    "OwnerOrchestrationAncestorStreamer": "ga",
+    "OscHyperlinks": "dogfood",
     "OzChangelogUpdates": "ga",
     "OzHandoff": "ga",
     "OzIdentityFederation": "ga",
     "OzLaunchModal": "ga",
     "OzPlatformSkills": "ga",
     "PRCommentsSkill": "ga",
-    "PRCommentsSlashCommand": "ga",
     "PRCommentsV2": "ga",
     "PartialNextCommandSuggestions": "other",
     "PendingUserQueryIndicator": "ga",
-    "PinnedTabs": "preview",
+    "PinnedTabs": "ga",
     "PluggableNotifications": "ga",
     "PredictAMQueries": "other",
     "ProfilesDesignRevamp": "ga",
@@ -226,7 +226,6 @@
     "RevertToCheckpoints": "ga",
     "RewindSlashCommand": "ga",
     "RichTextMultiselect": "ga",
-    "RunAgentsTool": "ga",
     "RunGeneratorsWithCmdExe": "dogfood",
     "RuntimeFeatureFlags": "other",
     "ScheduledAmbientAgents": "ga",
@@ -258,7 +257,7 @@
     "TabConfigs": "ga",
     "TabbedEditorView": "ga",
     "TeamApiKeys": "ga",
-    "TerminalLifecycleRecovery": "dogfood",
+    "TerminalLifecycleRecovery": "ga",
     "ThinStrokes": "other",
     "ToggleBootstrapBlock": "dogfood",
     "TransferControlTool": "ga",
@@ -571,6 +570,26 @@
       "command": "oz run message watch",
       "hidden": false
     },
+    {
+      "command": "oz runner",
+      "hidden": false
+    },
+    {
+      "command": "oz runner create",
+      "hidden": false
+    },
+    {
+      "command": "oz runner delete",
+      "hidden": false
+    },
+    {
+      "command": "oz runner list",
+      "hidden": false
+    },
+    {
+      "command": "oz runner update",
+      "hidden": false
+    },
     {
       "command": "oz schedule",
       "hidden": false
@@ -717,6 +736,18 @@
     "model": [
       "--model"
     ],
+    "runner": [
+      "--arch",
+      "--description",
+      "--docker-image",
+      "--macos-version",
+      "--memory-gb",
+      "--name",
+      "--os",
+      "--setup-command",
+      "--sort-by",
+      "--vcpus"
+    ],
     "schedule": [
       "--cron",
       "--host",
@@ -772,12 +803,15 @@
   "api_routes": [
     "DELETE /api/v1/agent/identities/{uid}",
     "DELETE /api/v1/agent/schedules/{id}",
+    "DELETE /api/v1/factory/automations/{id}",
+    "DELETE /api/v1/factory/automations/{id}/subscriptions/{subscription_id}",
     "DELETE /api/v1/factory/{uid}",
     "DELETE /api/v1/memory_stores/{uid}",
     "DELETE /api/v1/memory_stores/{uid}/memories/{memoryUid}",
     "GET /.well-known/openid-configuration",
     "GET /api/v1/agent",
     "GET /api/v1/agent/artifacts/{uid}",
+    "GET /api/v1/agent/artifacts/{uid}/download",
     "GET /api/v1/agent/connected-self-hosted-workers",
     "GET /api/v1/agent/conversations/{conversation_id}/block-snapshot",
     "GET /api/v1/agent/conversations/{conversation_id}/redirect",
@@ -799,6 +833,9 @@
     "GET /api/v1/agent/tasks",
     "GET /api/v1/agent/tasks/{id}",
     "GET /api/v1/factory",
+    "GET /api/v1/factory/automations",
+    "GET /api/v1/factory/automations/events/{provider}",
+    "GET /api/v1/factory/automations/{id}",
     "GET /api/v1/factory/{uid}",
     "GET /api/v1/harness-support/transcript",
     "GET /api/v1/memory_stores",
@@ -829,6 +866,7 @@
     "POST /api/v1/agent/schedules/{id}/resume",
     "POST /api/v1/agent/tasks/{id}/cancel",
     "POST /api/v1/factory",
+    "POST /api/v1/factory/automations",
     "POST /api/v1/factory/avatar",
     "POST /api/v1/harness-support/block-snapshot",
     "POST /api/v1/harness-support/external-conversation",
@@ -846,6 +884,7 @@
     "POST /api/v1/oauth/token",
     "PUT /api/v1/agent/identities/{uid}",
     "PUT /api/v1/agent/schedules/{id}",
+    "PUT /api/v1/factory/automations/{id}/subscriptions",
     "PUT /api/v1/memory_stores/{uid}",
     "PUT /api/v1/memory_stores/{uid}/memories/{memoryUid}"
   ],
@@ -876,6 +915,7 @@
     "/host",
     "/index",
     "/init",
+    "/mcp",
     "/model",
     "/new",
     "/open-code-review",
@@ -886,7 +926,6 @@
     "/open-rules",
     "/open-settings-file",
     "/open-skill",
-    "/pr-comments",
     "/profile",
     "/prompts",
     "/queue",
@@ -1223,5 +1262,5 @@
     "verify-ui-change-in-cloud": "dogfood",
     "warpctrl": "bundled"
   },
-  "changelog_last_version": "2026.07.09"
+  "changelog_last_version": "2026.07.16"
 }