chore(missing_docs): refresh surface map and snapshot

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

@@ -25,12 +25,16 @@ auto-surfaces for docs once the flag goes GA.
 
 ## Feature flags -> doc pages
 
-AgentMode -> src/content/docs/agents/local-agents/overview.mdx
+# The local-agents overview page was folded into the agents landing page
+# (/agents/local-agents/overview now 308s to /agents/ in vercel.json).
+AgentMode -> src/content/docs/agents/index.mdx
 AgentManagementView -> src/content/docs/platform/managing-cloud-agents.md
 AgentManagementDetailsView -> src/content/docs/platform/managing-cloud-agents.md
 AgentModeComputerUse -> src/content/docs/agents/capabilities/computer-use/index.mdx
 AgentModeWorkflows -> src/content/docs/knowledge-and-collaboration/warp-drive/workflows.md
-AgentOnboarding -> src/content/docs/agents/getting-started/agents-in-warp.mdx
+# agents-in-warp was folded into the agents landing page as well
+# (/agents/getting-started/agents-in-warp now 308s to /agents/).
+AgentOnboarding -> src/content/docs/agents/index.mdx
 AIRules -> src/content/docs/agents/capabilities/rules.mdx
 AIResumeButton -> src/content/docs/agents/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx
 InlineCodeReview -> src/content/docs/agents/local-agents/interactive-code-review.mdx
@@ -232,6 +236,17 @@ GeminiEnterprise -> src/content/docs/enterprise/enterprise-features/byollm-gemin
 # preview -> GA; documented with the rest of Warp's link handling.
 OscHyperlinks -> src/content/docs/terminal/more-features/files-and-links.mdx
 
+# Well-known managed MCP ids: accepts short integration ids (linear, slack,
+# jira) wherever a Warp MCP server UUID is accepted — bare `--mcp` arguments and
+# `warp_id` values in MCP configs. Promoted dogfood -> GA; documented in the CLI
+# MCP reference (and the cloud agent MCP schema page).
+WellKnownMcpIds -> src/content/docs/reference/cli/mcp-servers.mdx
+
+# Auto-attaches the Warp-hosted Factory MCP server to agent sessions with no
+# manual setup. Promoted dogfood -> GA; that zero-config behavior is documented
+# in the "Connect and authenticate" section of the Factory MCP page.
+FactoryMcp -> src/content/docs/factories/factory-mcp.mdx
+
 ## CLI commands -> doc pages
 
 # Top-level Oz CLI commands
@@ -380,14 +395,16 @@ POST /harness-support/report-shutdown -> internal
 POST /harness-support/upload-snapshot -> internal
 POST /harness-support/commit-snapshot -> internal
 
-# Oz Factory REST API (router/handlers/public_api/factory*.go). Factory is a
-# private, not-yet-released product (the FactoryMcp flag is dogfood and the
-# @warp/factory front-end is internal/computer-use gated), so none of these
-# endpoints are part of the released public Oz Agent API. They are marked
-# internal until Factory ships publicly; revisit and route through the
-# sync-openapi-spec skill if/when Factory goes GA. See SKILL.md "Public vs.
-# private surfaces".
+# Oz Factory REST API (router/handlers/public_api/factory*.go). Warp Factories
+# is now documented publicly (src/content/docs/factories/) as an Early Access
+# product, but its REST API is a different question: none of these routes appear
+# in warp-server's canonical public spec, so they are not part of the released
+# public Oz Agent API and must not be hand-documented. They stay internal;
+# revisit and route through the sync-openapi-spec skill if/when the Factory REST
+# API is released into the spec. See SKILL.md "Public vs. private surfaces".
 GET /factory -> internal
+GET /factory/access -> internal
+GET /factory-alias/{alias} -> internal
 POST /factory -> internal
 POST /factory/avatar -> internal
 GET /factory/{uid} -> internal
@@ -398,19 +415,62 @@ POST /factory/{uid}/plan -> internal
 GET /factory/{uid}/source -> internal
 PUT /factory/{uid}/source -> internal
 DELETE /factory/{uid}/source -> internal
+# Factory-as-code source browsing, editing, export, and merge plumbing backing
+# the factory definition editor in the Oz web app.
+GET /factory/{uid}/source/tree -> internal
+GET /factory/{uid}/source/file -> internal
+PUT /factory/{uid}/source/files -> internal
+GET /factory/{uid}/source/export -> internal
+POST /factory/{uid}/source/clone-url -> internal
+GET /factory/{uid}/source/link-readiness -> internal
+POST /factory/{uid}/merges -> internal
+POST /factory/{uid}/merges/check -> internal
+GET /factory/{uid}/merges/{merge_uid} -> internal
+# Factory file JSON schemas and validation, consumed by the factory definition
+# editor and the factory-files authoring tooling.
+GET /factory-files/schemas -> internal
+GET /factory-files/schemas/{schema_version} -> internal
+GET /factory-files/schemas/{schema_version}/{document} -> internal
+POST /factory-files/validate -> internal
+# Factory review (AI review of a factory definition) and its refine loop.
+GET /factory/{uid}/review -> internal
+POST /factory/{uid}/review/refine -> internal
+# Factory outbound webhooks: CRUD, delivery history, and secret rotation.
+GET /factory/webhooks -> internal
+POST /factory/webhooks -> internal
+GET /factory/webhooks/{uid} -> internal
+PUT /factory/webhooks/{uid} -> internal
+DELETE /factory/webhooks/{uid} -> internal
+GET /factory/webhooks/{uid}/deliveries -> internal
+POST /factory/webhooks/{uid}/rotate -> internal
 GET /factory/{uid}/syncs -> internal
 GET /factory/{uid}/task-by-conversation -> internal
 GET /factory/{uid}/tasks -> internal
 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
+POST /factory/{uid}/tasks/{task_uid}/cancel -> internal
+GET /factory/{uid}/task-by-run -> 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}/metrics/cost-by-pr-size -> internal
+GET /factory/{uid}/metrics/run-breakdown -> internal
+GET /factory/{uid}/metrics/top-prs -> 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
+GET /factory/{uid}/integrations/jira/projects -> internal
+GET /factory/{uid}/integrations/jira/labels -> internal
+GET /factory/{uid}/integrations/jira/statuses -> internal
+GET /factory/{uid}/integration-activations -> internal
+GET /factory/{uid}/integration-destinations -> internal
+GET /factory/{uid}/gitlab-automation-capability -> internal
+POST /factory/{uid}/gitlab-automation-capability/refresh -> internal
+# Integration pickers used during factory setup, before a factory exists.
+GET /factory-setup/integrations/jira/projects -> internal
+GET /factory-setup/integrations/linear/teams -> internal
 GET /factory/automations -> internal
 POST /factory/automations -> internal
 GET /factory/automations/events/{provider} -> internal
@@ -423,17 +483,16 @@ GET /factory/scorers -> internal
 POST /factory/scorers -> internal
 PATCH /factory/scorers/{scorer_id} -> internal
 DELETE /factory/scorers/{scorer_id} -> internal
-POST /factory/scorers/{scorer_id}/pause -> internal
-POST /factory/scorers/{scorer_id}/resume -> internal
 GET /factory/scorers/{scorer_id}/results -> internal
 GET /factory/scorers/{scorer_id}/results/reasons -> internal
-GET /factory/scorers/{scorer_id}/autofix-config -> internal
-PUT /factory/scorers/{scorer_id}/autofix-config -> internal
-DELETE /factory/scorers/{scorer_id}/autofix-config -> internal
+GET /factory/scorers/{scorer_id}/metrics/pass-rate -> internal
+# The scorer pause/resume routes and the autofix-config trio were replaced by
+# the self-improvement-config routes below; their dead map entries were pruned.
+GET /factory/scorers/{scorer_id}/self-improvement-config -> internal
+PUT /factory/scorers/{scorer_id}/self-improvement-config -> internal
+DELETE /factory/scorers/{scorer_id}/self-improvement-config -> internal
 GET /factory/runs/{run_id}/scores -> internal
 POST /factory/run-scoring/dispatches -> internal
-POST /factory/autofix/runs/{autofix_run_id}/file-tasks -> internal
-POST /factory/autofix/worker-results/{worker_result_id}/report -> internal
 PUT /factory/automations/{id}/subscriptions/{subscription_id} -> internal
 GET /factory/{uid}/integrations/github/branches -> internal
 GET /factory/{uid}/integrations/github/labels -> internal
@@ -455,6 +514,8 @@ GET /factory/{uid}/benchmarks/suites/{suite_uid} -> internal
 PATCH /factory/{uid}/benchmarks/suites/{suite_uid} -> internal
 DELETE /factory/{uid}/benchmarks/suites/{suite_uid} -> internal
 POST /factory/{uid}/benchmarks/suites/{suite_uid}/runs -> internal
+POST /factory/{uid}/benchmarks/suites/{suite_uid}/tasks -> internal
+POST /factory/{uid}/benchmarks/suites/{suite_uid}/tasks/compose-from-run -> internal
 GET /factory/{uid}/benchmarks/runs -> internal
 GET /factory/{uid}/benchmarks/runs/{run_uid} -> internal
 GET /factory/{uid}/benchmarks/runs/{run_uid}/results -> internal
@@ -608,10 +669,8 @@ guides/agent-workflows/warp-vs-claude-code
 # Custom Starlight 404 page (template: splash). Starlight renders it through its
 # own prerendered /404 route, so it is intentionally not in the sidebar.
 404
-# Jira integration page is draft: true (private beta — the Oz Jira app is not yet
-# published to the Atlassian marketplace). Kept out of the sidebar until the
-# integration goes GA; the snapshot diff will flag it for docs on promotion.
-platform/integrations/jira
+# The Jira integration page left draft status and is now listed in src/sidebar.ts,
+# so its allowlist entry was pruned.
 
 ## Flags to ignore (internal-only, not user-facing)
 
@@ -721,6 +780,16 @@ GitCredentialRefresh
 # 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
+# Orchestration plumbing promoted dogfood -> GA. Neither changes what a user sees
+# or configures, so both are internal implementation details of the documented
+# multi-agent orchestration feature (platform/orchestration/multi-agent-runs.mdx):
+# - WaitForEventsParentRegistration: on `wait_for_events`, confirms parent status
+#   with the server and registers an orchestrator for the ancestor event stream so
+#   children created out-of-band (CLI/API) still deliver events.
+# - OrchestrationUnifiedStack: consolidates child-state tracking behind a single
+#   tracker, one ancestor SSE per parent family, and one remote-child placeholder.
+WaitForEventsParentRegistration
+OrchestrationUnifiedStack
 # Internal persistence-backend detail: gates storing execution profiles in a
 # file-backed settings collection (agents.execution_profiles) versus the legacy
 # per-profile Warp Drive cloud objects. It changes where profiles are stored, not