From 126ff297a3868cd023c776c00304e2b3c15daa61 Mon Sep 17 00:00:00 2001 From: Oz Date: Mon, 20 Jul 2026 17:10:37 +0000 Subject: [PATCH] docs(missing_docs): update surface map and snapshot Map the CloudRunners/CloudAgentRunners flags and oz runner CLI to the new runners page, re-map the stale gated:CloudAgentRunnerCLICommands entries (flag removed on GA), mark the TUI-only /exit and /view-logs slash commands internal, and regenerate surface_snapshot.json. Co-Authored-By: Oz --- .../references/feature_surface_map.md | 30 +++++++++++++------ .../references/surface_snapshot.json | 17 +++++++++-- 2 files changed, 35 insertions(+), 12 deletions(-) diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index d91fccc5..67b23c4a 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -201,6 +201,13 @@ CustomModelRouters -> src/content/docs/agent-platform/inference/model-choice.mdx # Billing & Usage settings page (redesigned) BillingAndUsagePageV2 -> src/content/docs/support-and-community/plans-and-billing/index.mdx +# Cloud agent runners (reusable compute configs). CloudRunners gates the +# `--runner` flag on `run-cloud`; CloudAgentRunners gates the `oz runner` CRUD +# commands and the runner dropdown in the orchestration card. Both are GA +# (default cargo features). +CloudRunners -> src/content/docs/platform/runners.mdx +CloudAgentRunners -> src/content/docs/platform/runners.mdx + ## CLI commands -> doc pages # Top-level Oz CLI commands @@ -257,15 +264,14 @@ 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 +# `oz runner` (manage cloud agent runners) is GA (gated by CloudAgentRunners, a +# default cargo feature) and documented on the runners page. The old gating flag +# CloudAgentRunnerCLICommands was removed after the feature stabilized. +oz runner -> src/content/docs/platform/runners.mdx +oz runner list -> src/content/docs/platform/runners.mdx +oz runner create -> src/content/docs/platform/runners.mdx +oz runner update -> src/content/docs/platform/runners.mdx +oz runner delete -> src/content/docs/platform/runners.mdx # Internal/hidden command — not a user-facing surface, so no public docs. oz harness-support -> internal @@ -345,6 +351,12 @@ GET /memory_stores/{uid}/memories/{memoryUid}/versions -> gated:AIMemories # slash-commands page content; add entries here only for exceptions. # Gated by the dogfood-only LocalDockerSandbox flag — not user-facing yet. /docker-sandbox -> internal +# TUI-only (warp-tui) slash commands — added only when the settings mode is TUI +# (see static_commands/commands.rs). They aren't present in the GUI desktop app, +# so they aren't documented on the public slash-commands page. Consistent with +# the general.autoupdate_enabled TUI-only setting mapped to `internal` above. +/exit -> internal +/view-logs -> internal ## Settings -> doc pages diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json index b53620ad..037ffcf2 100644 --- a/.agents/skills/missing_docs/references/surface_snapshot.json +++ b/.agents/skills/missing_docs/references/surface_snapshot.json @@ -57,7 +57,7 @@ "Changelog": "ga", "ClassicCompletions": "ga", "ClearAutosuggestionOnEscape": "ga", - "CloudAgentRunnerCLICommands": "dogfood", + "CloudAgentRunners": "ga", "CloudConversations": "ga", "CloudEnvironments": "ga", "CloudMode": "ga", @@ -67,7 +67,7 @@ "CloudModeInputV2": "ga", "CloudModeSetupV2": "ga", "CloudObjects": "other", - "CloudRunners": "dogfood", + "CloudRunners": "ga", "CocoaSentry": "other", "CodeFindReplace": "ga", "CodeLaunchModal": "ga", @@ -806,6 +806,7 @@ "DELETE /api/v1/factory/automations/{id}", "DELETE /api/v1/factory/automations/{id}/subscriptions/{subscription_id}", "DELETE /api/v1/factory/{uid}", + "DELETE /api/v1/factory/{uid}/source", "DELETE /api/v1/memory_stores/{uid}", "DELETE /api/v1/memory_stores/{uid}/memories/{memoryUid}", "GET /.well-known/openid-configuration", @@ -822,6 +823,7 @@ "GET /api/v1/agent/identities/{uid}", "GET /api/v1/agent/messages/{run_id}", "GET /api/v1/agent/models", + "GET /api/v1/agent/run-by-external-reference", "GET /api/v1/agent/runs", "GET /api/v1/agent/runs/{runId}", "GET /api/v1/agent/runs/{runId}/handoff/attachments", @@ -837,6 +839,8 @@ "GET /api/v1/factory/automations/events/{provider}", "GET /api/v1/factory/automations/{id}", "GET /api/v1/factory/{uid}", + "GET /api/v1/factory/{uid}/source", + "GET /api/v1/factory/{uid}/syncs", "GET /api/v1/harness-support/transcript", "GET /api/v1/memory_stores", "GET /api/v1/memory_stores/{uid}", @@ -868,6 +872,8 @@ "POST /api/v1/factory", "POST /api/v1/factory/automations", "POST /api/v1/factory/avatar", + "POST /api/v1/factory/{uid}/apply", + "POST /api/v1/factory/{uid}/plan", "POST /api/v1/harness-support/block-snapshot", "POST /api/v1/harness-support/external-conversation", "POST /api/v1/harness-support/finish-task", @@ -885,6 +891,7 @@ "PUT /api/v1/agent/identities/{uid}", "PUT /api/v1/agent/schedules/{id}", "PUT /api/v1/factory/automations/{id}/subscriptions", + "PUT /api/v1/factory/{uid}/source", "PUT /api/v1/memory_stores/{uid}", "PUT /api/v1/memory_stores/{uid}/memories/{memoryUid}" ], @@ -904,6 +911,7 @@ "/create-new-project", "/docker-sandbox", "/environment", + "/exit", "/export-to-clipboard", "/export-to-file", "/feedback", @@ -935,7 +943,8 @@ "/rewind", "/set-tab-color", "/skills", - "/usage" + "/usage", + "/view-logs" ], "settings": { "accessibility.accessibility_verbosity": "always_on", @@ -1051,6 +1060,7 @@ "cloud_platform.third_party_api_keys.can_use_warp_credits_with_byok": "always_on", "cloud_platform.third_party_api_keys.gemini_enterprise_credentials_enabled": "always_on", "code.editor.auto_open_code_review_pane_on_first_agent_change": "always_on", + "code.editor.auto_save": "always_on", "code.editor.format_on_save": "always_on", "code.editor.open_code_panels_file_editor": "always_on", "code.editor.open_file_editor": "always_on", @@ -1258,6 +1268,7 @@ "tab-configs": "bundled", "test-warp-ui": "dogfood", "triage-vulnerabilities": "dogfood", + "tui-migrate-setup": "bundled", "update-tab-config": "bundled", "verify-ui-change-in-cloud": "dogfood", "warpctrl": "bundled"