From f4a0029a73c3dd94ca5979ec556397034212ca07 Mon Sep 17 00:00:00 2001
From: hongyi-chen <hongyigma@gmail.com>
Date: Mon, 27 Jul 2026 17:10:18 +0000
Subject: [PATCH] docs: missing_docs audit bookkeeping (surface map + snapshot)

Map the Warp Agent CLI (TUI)-only /theme slash command and appearance.theme
setting to internal, consistent with the other Warp Agent CLI-only surfaces
(/voice, /version, general.autoupdate_enabled, appearance.zero_state.*). The
GUI theme setting appearance.themes.theme remains documented.

Regenerate surface_snapshot.json so the next drift-watch run diffs against the
current baseline (records the new evaluations Oz web app routes, factory/scorers
API routes, WellKnownMcpIds dogfood flag, and the oz agent --remove-prompt CLI
flag documented in the companion CLI PR).

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 .../missing_docs/references/feature_surface_map.md  | 13 +++++++++++++
 .../missing_docs/references/surface_snapshot.json   |  9 +++++++++
 2 files changed, 22 insertions(+)

diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md
index cdb189a5..945b90d2 100644
--- a/.agents/skills/missing_docs/references/feature_surface_map.md
+++ b/.agents/skills/missing_docs/references/feature_surface_map.md
@@ -373,6 +373,11 @@ GET /memory_stores/{uid}/memories/{memoryUid}/versions -> gated:AIMemories
 # TUI-only voice input and version commands (Warp Agent CLI surface).
 /voice -> internal
 /version -> internal
+# TUI-only color-theme picker (Warp Agent CLI surface, SlashCommandSurfaces::TuiOnly
+# in static_commands/commands.rs). It sets the Warp Agent CLI theme
+# (appearance.theme, mapped internal below) and isn't present in the GUI, so it
+# stays internal like the other Warp Agent CLI-only commands.
+/theme -> internal
 
 ## Settings -> doc pages
 
@@ -390,6 +395,14 @@ warpify.ssh.ssh_tmux_deprecation_notice_pending -> internal
 # documented in the all-settings reference.
 general.autoupdate_enabled -> internal
 
+# Warp Agent CLI-only (crates/warp_tui) color theme (surface: Warp Agent CLI,
+# SettingSurfaces::TUI in tui_theme.rs; "auto|light|dark" matching the host
+# terminal background). It isn't present in the GUI settings UI, so it isn't
+# documented in the all-settings reference. The GUI theme setting is the separate
+# appearance.themes.theme, which is documented. Paired with the /theme Warp Agent
+# CLI slash command mapped internal above.
+appearance.theme -> internal
+
 # Warp Agent CLI-only (crates/warp_tui) zero-state animation knobs (surface: Warp
 # Agent CLI, SettingSurfaces::TUI). They tune the rotating object shown in the
 # empty Warp Agent CLI state and aren't present in the GUI settings UI, so they
diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json
index dfea2713..9e38f7e3 100644
--- a/.agents/skills/missing_docs/references/surface_snapshot.json
+++ b/.agents/skills/missing_docs/references/surface_snapshot.json
@@ -284,6 +284,7 @@
     "WebSearchUI": "ga",
     "WelcomeBlock": "other",
     "WelcomeTips": "other",
+    "WellKnownMcpIds": "dogfood",
     "WithSandboxTelemetry": "other",
     "WorkflowAliases": "ga"
   },
@@ -682,6 +683,7 @@
       "--remove-base-model",
       "--remove-description",
       "--remove-environment",
+      "--remove-prompt",
       "--remove-secret",
       "--remove-skill",
       "--repo",
@@ -845,6 +847,8 @@
     "GET /api/v1/factory/automations",
     "GET /api/v1/factory/automations/events/{provider}",
     "GET /api/v1/factory/automations/{id}",
+    "GET /api/v1/factory/scorers",
+    "GET /api/v1/factory/scorers/{scorer_id}/results",
     "GET /api/v1/factory/{uid}",
     "GET /api/v1/factory/{uid}/source",
     "GET /api/v1/factory/{uid}/syncs",
@@ -883,6 +887,7 @@
     "POST /api/v1/factory",
     "POST /api/v1/factory/automations",
     "POST /api/v1/factory/avatar",
+    "POST /api/v1/factory/scorers",
     "POST /api/v1/factory/{uid}/apply",
     "POST /api/v1/factory/{uid}/plan",
     "POST /api/v1/factory/{uid}/tasks",
@@ -959,6 +964,7 @@
     "/rewind",
     "/set-tab-color",
     "/skills",
+    "/theme",
     "/usage",
     "/version",
     "/view-logs",
@@ -1049,6 +1055,7 @@
     "appearance.text.match_notebook_to_monospace_font_size": "always_on",
     "appearance.text.notebook_font_size": "always_on",
     "appearance.text.use_thin_strokes": "always_on",
+    "appearance.theme": "always_on",
     "appearance.themes.selected_system_themes": "always_on",
     "appearance.themes.system_theme": "always_on",
     "appearance.themes.theme": "always_on",
@@ -1191,6 +1198,8 @@
     "agents",
     "design",
     "environments",
+    "evaluations",
+    "evaluations/:evaluationId",
     "integrations",
     "login",
     "login/callback",