docs-audit: surface map + snapshot bookkeeping (2026-08-05 drift-watch)

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

@@ -323,6 +323,15 @@ POST /oauth/token -> internal
 GET /oauth/jwks.json -> internal
 GET /.well-known/openid-configuration -> internal
 
+# RFC 8414 / RFC 9728 OAuth discovery documents that MCP clients fetch
+# automatically before authenticating against the hosted Factory MCP endpoint
+# (router/handlers/public_api/oauth2.go, registered only when the dogfood-only
+# factory_mcp flag is on). They are machine-facing protocol metadata for an
+# unreleased product, absent from warp-server's canonical public spec, so they
+# are not a documentable public API surface.
+GET /.well-known/oauth-authorization-server -> internal
+GET /.well-known/oauth-protected-resource/api/v1/mcp/factory -> internal
+
 # Anonymous-viewer redirect probes (documented exceptions to auth, not API surfaces).
 GET /agent/sessions/{session_uuid}/redirect -> internal
 GET /agent/conversations/{conversation_id}/redirect -> internal
@@ -378,6 +387,9 @@ POST /factory/{uid}/tasks -> internal
 GET /factory/{uid}/tasks/{task_uid} -> internal
 PATCH /factory/{uid}/tasks/{task_uid} -> internal
 DELETE /factory/{uid}/tasks/{task_uid} -> internal
+# Also marked `x-internal: true` in warp-server's canonical spec, so the publish
+# filter strips it from the public docs copy.
+GET /factory/{uid}/metrics -> internal
 GET /factory/{uid}/integrations/linear/teams -> internal
 GET /factory/{uid}/integrations/linear/teams/{team_id}/labels -> internal
 PUT /factory/{uid}/integrations/linear/teams/{team_id}/labels -> internal
@@ -523,6 +535,12 @@ appearance.zero_state.show_project_info -> internal
 appearance.zero_state.show_mcp -> internal
 appearance.zero_state.show_animation -> internal
 
+# Warp Agent CLI-only toggle that stops the zero-state animation from repainting
+# while the terminal is unfocused (app/src/settings/tui_zero_state.rs). Like the
+# other zero-state knobs it isn't in the GUI settings UI, so it's documented on
+# the Warp Agent CLI configuration page instead of the all-settings reference.
+appearance.zero_state.freeze_animation_when_unfocused -> src/content/docs/cli/configuration.mdx
+
 # Warp Agent CLI-only (crates/warp_tui) push-to-talk key for voice input (surface:
 # SettingSurfaces::TUI in app/src/settings/tui_voice.rs). The GUI equivalent is the
 # separate agents.voice.voice_input_toggle_key, which is documented.

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

@@ -820,6 +820,8 @@
     "DELETE /api/v1/factory/{uid}/tasks/{task_uid}",
     "DELETE /api/v1/memory_stores/{uid}",
     "DELETE /api/v1/memory_stores/{uid}/memories/{memoryUid}",
+    "GET /.well-known/oauth-authorization-server",
+    "GET /.well-known/oauth-protected-resource/api/v1/mcp/factory",
     "GET /.well-known/openid-configuration",
     "GET /api/v1/agent",
     "GET /api/v1/agent/artifacts/{uid}",
@@ -855,6 +857,7 @@
     "GET /api/v1/factory/{uid}",
     "GET /api/v1/factory/{uid}/integrations/linear/teams",
     "GET /api/v1/factory/{uid}/integrations/linear/teams/{team_id}/labels",
+    "GET /api/v1/factory/{uid}/metrics",
     "GET /api/v1/factory/{uid}/source",
     "GET /api/v1/factory/{uid}/syncs",
     "GET /api/v1/factory/{uid}/task-by-conversation",
@@ -885,6 +888,7 @@
     "POST /api/v1/agent/runs/{runId}/cancel",
     "POST /api/v1/agent/runs/{runId}/client-events",
     "POST /api/v1/agent/runs/{runId}/followups",
+    "POST /api/v1/agent/runs/{runId}/scores",
     "POST /api/v1/agent/schedules",
     "POST /api/v1/agent/schedules/{id}/pause",
     "POST /api/v1/agent/schedules/{id}/resume",
@@ -1096,6 +1100,7 @@
     "appearance.window.override_opacity": "always_on",
     "appearance.window.zoom_level": "always_on",
     "appearance.zero_state.extrusion_depth": "always_on",
+    "appearance.zero_state.freeze_animation_when_unfocused": "always_on",
     "appearance.zero_state.object": "always_on",
     "appearance.zero_state.rotation_period_seconds": "always_on",
     "appearance.zero_state.show_animation": "always_on",
@@ -1217,6 +1222,7 @@
     ":scheduleId",
     ":secretId",
     "agents",
+    "artifacts/:artifactUid",
     "design",
     "environments",
     "evaluations",
@@ -1262,6 +1268,7 @@
     "finish_task",
     "finish_warp_documentation_search",
     "get_artifacts_for_pull_request_description",
+    "get_media_artifact_links",
     "grep",
     "init_project",
     "insert_code_review_comments",