docs: terminology cleanup, surface-map hygiene, and --mcp well-known-id docs

.agents/references/terminology.md

@@ -66,6 +66,9 @@ For the summary of the most critical terms (core features, Automation Platform t
 - **Tab Configs** — Reusable TOML-based tab layout definitions that launch preconfigured terminal sessions.
   *Usage note:* Capitalize as a feature name.
 
+- **Launch Configuration** / **Launch Configurations** — The legacy, YAML-based way to save a configuration of windows, tabs, and panes. Replaced by Tab Configs; existing Launch Configurations still work but aren't being extended.
+  *Usage note:* Capitalize as a feature name, including in headings ("Creating a Launch Configuration"). Use "Tab Configs" for new content.
+
 - **Vertical Tabs** — The sidebar-based tab management panel that replaces the horizontal tab bar.
   *Usage note:* Capitalize as a feature name.
 
@@ -107,6 +110,12 @@ For the summary of the most critical terms (core features, Automation Platform t
 - **Active AI** — The feature that proactively surfaces fixes and next actions based on terminal errors, inputs, and outputs. Covers Prompt Suggestions, Next Command predictions, and Suggested Code Diffs.
   *Usage note:* Always capitalize "Active AI" — it is a proper feature name and the label of the Settings toggle. Write the full capability as **Active AI Recommendations**, matching the page title. Lowercase the following word only when it is a plain common noun rather than part of the name, as in "Active AI features" or "the Active AI toggle".
 
+- **Computer Use** — The capability that lets agents interact with a desktop environment (screenshots, clicks, typing) inside a sandboxed cloud environment.
+  *Usage note:* Capitalize as a feature name, including in headings ("Enabling Computer Use", "How Computer Use works").
+
+- **Full Terminal Use** — The capability that lets an agent attach to and drive interactive terminal programs (for example `psql`, `vim`, a dev server) by reading live PTY output.
+  *Usage note:* Capitalize as a feature name, including in headings.
+
 ## Coding terms (Warp features)
 
 - **Code** — Warp's coding experience for agent-assisted changes (editing, diffs, code review).
@@ -331,6 +340,8 @@ Docs match the screen; the fix belongs in the app.
 - **command-line** — hyphenated when used as an adjective
 - **Git repository** or **repo** — not "git repository" (capitalize "Git")
 - **macOS** — not "Mac OS" or "Mac"
+- **Zero Data Retention (ZDR)** — Warp's agreements with contracted LLM providers not to train on or retain customer data. Capitalize as a proper term, including in headings ("Zero Data Retention (ZDR)"); keep the "(ZDR)" acronym on first mention in a section.
+- **SSO (Single Sign-On)** — Authentication through an organization's identity provider (Okta, Microsoft Entra ID, Google Workspace, or any SAML 2.0/OIDC provider). Always capitalize the acronym "SSO"; capitalize "Single Sign-On" when spelled out as the feature name.
 
 ## Branded and informal terms
 

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

@@ -25,12 +25,20 @@ auto-surfaces for docs once the flag goes GA.
 
 ## Feature flags -> doc pages
 
-AgentMode -> src/content/docs/agents/local-agents/overview.mdx
+# AgentMode's old target (agents/local-agents/overview.mdx) was removed in the
+# agents-section reorg; the concept now lives on the Agents tab overview page
+# (which literally covers Agent Mode and embeds a video titled "Agent Mode
+# Overview").
+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
+# AgentOnboarding's old target (agents/getting-started/agents-in-warp.mdx) was
+# removed in the same reorg. The first-run agent-onboarding wizard (account
+# sign-up, choosing how to access AI) is covered by the "Log in to Warp
+# (optional)" section of the installation/setup quickstart.
+AgentOnboarding -> src/content/docs/getting-started/quickstart/installation-and-setup.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
@@ -39,6 +47,9 @@ CodeFindReplace -> src/content/docs/code/code-editor/find-and-replace.md
 VimCodeEditor -> src/content/docs/code/code-editor/code-editor-vim-keybindings.md
 McpServer -> src/content/docs/agents/capabilities/mcp.mdx
 McpOauth -> src/content/docs/agents/capabilities/mcp.mdx
+# Factory MCP (the hosted MCP endpoint agents use to work with a factory) is
+# GA and documented on the Factory MCP page and related factories/* pages.
+FactoryMcp -> src/content/docs/factories/factory-mcp.mdx
 ImageAsContext -> src/content/docs/agents/local-agents/agent-context/images-as-context.mdx
 SelectionAsContext -> src/content/docs/agents/local-agents/agent-context/selection-as-context.mdx
 DiffSetAsContext -> src/content/docs/agents/local-agents/agent-context/selection-as-context.mdx
@@ -232,6 +243,11 @@ 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
 
+# `--mcp <well-known-id>` CLI shorthand (bare, non-UUID identifiers like
+# "linear" resolved server-side). GA; documented alongside the rest of the
+# --mcp flag formats.
+WellKnownMcpIds -> src/content/docs/reference/cli/mcp-servers.mdx
+
 ## CLI commands -> doc pages
 
 # Top-level Oz CLI commands
@@ -460,6 +476,49 @@ GET /factory/{uid}/benchmarks/runs/{run_uid} -> internal
 GET /factory/{uid}/benchmarks/runs/{run_uid}/results -> internal
 POST /factory/{uid}/benchmarks/runs/{run_uid}/cancel -> internal
 
+# Additional Factory web-app-only backend routes surfaced by the audit
+# (router/handlers/public_api/factories.go, factory_files.go,
+# factory_file_schemas.go, factory_file_validation.go, factory_access.go,
+# factory_scorers.go, benchmarks.go). Same unreleased Factory product as the
+# /factory/* routes above — Factory-UI-only backend routes, not part of the
+# released public Oz Agent API / OpenAPI spec.
+GET /factory-alias/{alias} -> internal
+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
+GET /factory-setup/integrations/jira/projects -> internal
+GET /factory-setup/integrations/linear/teams -> internal
+GET /factory/access -> internal
+GET /factory/scorers/{scorer_id}/metrics/pass-rate -> internal
+DELETE /factory/scorers/{scorer_id}/self-improvement-config -> internal
+GET /factory/scorers/{scorer_id}/self-improvement-config -> internal
+PUT /factory/scorers/{scorer_id}/self-improvement-config -> internal
+POST /factory/{uid}/benchmarks/suites/{suite_uid}/tasks -> internal
+GET /factory/{uid}/gitlab-automation-capability -> internal
+POST /factory/{uid}/gitlab-automation-capability/refresh -> internal
+GET /factory/{uid}/integration-activations -> internal
+GET /factory/{uid}/integration-destinations -> internal
+GET /factory/{uid}/integrations/jira/labels -> internal
+GET /factory/{uid}/integrations/jira/projects -> internal
+GET /factory/{uid}/integrations/jira/statuses -> internal
+POST /factory/{uid}/merges -> internal
+POST /factory/{uid}/merges/check -> internal
+GET /factory/{uid}/merges/{merge_uid} -> 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}/review -> internal
+POST /factory/{uid}/review/refine -> internal
+GET /factory/{uid}/source/export -> internal
+GET /factory/{uid}/source/file -> internal
+GET /factory/{uid}/source/link-readiness -> internal
+GET /factory/{uid}/source/tree -> internal
+POST /factory/{uid}/source/clone-url -> internal
+PUT /factory/{uid}/source/files -> internal
+GET /factory/{uid}/task-by-run -> internal
+POST /factory/{uid}/tasks/{task_uid}/cancel -> internal
+
 # Orchestration messaging and lifecycle-event endpoints. These are marked
 # `x-internal: true` in warp-server's canonical spec (public_api/openapi.yaml),
 # so the publish filter deliberately strips them from the public docs copy.
@@ -740,6 +799,13 @@ EditableMarkdownMermaid
 # Directory-based tab colors: the user-facing knob is the setting
 # appearance.tabs.directory_tab_colors, documented in the all-settings reference.
 DirectoryTabColors
+# Internal client-side orchestration event-delivery plumbing (agent-to-agent
+# messaging/lifecycle-event transport). Both flags are explicitly documented
+# as "no user-visible behavior change" in their design specs (see
+# warp/specs/QUALITY-928/TECH.md and warp/specs/QUALITY-919/TECH.md), so they
+# need no doc page.
+OrchestrationUnifiedStack
+WaitForEventsParentRegistration
 CloudModeHostSelector
 CodebaseIndexSpeedbump
 CodebaseIndexPersistence

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

@@ -96,6 +96,7 @@
     "CreateProjectFlow": "ga",
     "CreatingSharedSessions": "dogfood",
     "CrossRepoContext": "dogfood",
+    "CtrlCCancelsThirdPartyHarness": "dogfood",
     "CustomModelRouters": "ga",
     "CycleNextCommandSuggestion": "other",
     "DebugMode": "other",
@@ -110,7 +111,7 @@
     "EditableMarkdownMermaid": "dogfood",
     "EmbeddedCodeReviewComments": "other",
     "ExpandEditToPane": "ga",
-    "FactoryMcp": "dogfood",
+    "FactoryMcp": "ga",
     "FallbackModelLoadOutputMessaging": "ga",
     "FastForwardAutoexecuteButton": "ga",
     "FetchChannelVersionsFromWarpServer": "other",
@@ -194,6 +195,7 @@
     "OpenWarpLaunchModal": "ga",
     "OpenWarpNewSettingsModes": "ga",
     "OrchestrationLaunchModal": "ga",
+    "OrchestrationUnifiedStack": "ga",
     "OscHyperlinks": "ga",
     "OzChangelogUpdates": "ga",
     "OzHandoff": "ga",
@@ -204,7 +206,7 @@
     "PRCommentsV2": "ga",
     "PartialNextCommandSuggestions": "other",
     "PendingUserQueryIndicator": "ga",
-    "PeriodicHandoffCheckpoints": "other",
+    "PeriodicHandoffCheckpoints": "dogfood",
     "PinnedTabs": "ga",
     "PluggableNotifications": "ga",
     "PredictAMQueries": "other",
@@ -279,7 +281,7 @@
     "VideoRecording": "ga",
     "ViewingSharedSessions": "ga",
     "VimCodeEditor": "ga",
-    "WaitForEventsParentRegistration": "dogfood",
+    "WaitForEventsParentRegistration": "ga",
     "WarpControlCli": "dogfood",
     "WarpManagedSecrets": "ga",
     "WarpPacks": "ga",
@@ -288,7 +290,7 @@
     "WebSearchUI": "ga",
     "WelcomeBlock": "other",
     "WelcomeTips": "other",
-    "WellKnownMcpIds": "dogfood",
+    "WellKnownMcpIds": "ga",
     "WithSandboxTelemetry": "other",
     "WorkflowAliases": "ga"
   },
@@ -680,6 +682,7 @@
       "--no-computer-use",
       "--no-snapshot",
       "--open",
+      "--parent-run-id",
       "--profile",
       "--prompt",
       "--remove-all-secrets",
@@ -699,7 +702,8 @@
       "--snapshot-upload-timeout",
       "--sort-by",
       "--sort-order",
-      "--strict-mcp-startup"
+      "--strict-mcp-startup",
+      "--title"
     ],
     "api_key": [
       "--agent",
@@ -818,7 +822,7 @@
     "DELETE /api/v1/factory/automations/{id}",
     "DELETE /api/v1/factory/automations/{id}/subscriptions/{subscription_id}",
     "DELETE /api/v1/factory/scorers/{scorer_id}",
-    "DELETE /api/v1/factory/scorers/{scorer_id}/autofix-config",
+    "DELETE /api/v1/factory/scorers/{scorer_id}/self-improvement-config",
     "DELETE /api/v1/factory/{uid}",
     "DELETE /api/v1/factory/{uid}/benchmarks/suites/{suite_uid}",
     "DELETE /api/v1/factory/{uid}/source",
@@ -856,25 +860,39 @@
     "GET /api/v1/agent/tasks",
     "GET /api/v1/agent/tasks/{id}",
     "GET /api/v1/factory",
+    "GET /api/v1/factory-alias/{alias}",
+    "GET /api/v1/factory-files/schemas",
+    "GET /api/v1/factory-files/schemas/{schema_version}",
+    "GET /api/v1/factory-files/schemas/{schema_version}/{document}",
+    "GET /api/v1/factory-setup/integrations/jira/projects",
+    "GET /api/v1/factory-setup/integrations/linear/teams",
+    "GET /api/v1/factory/access",
     "GET /api/v1/factory/automations",
     "GET /api/v1/factory/automations/events/{provider}",
     "GET /api/v1/factory/automations/{id}",
     "GET /api/v1/factory/runs/{run_id}/scores",
     "GET /api/v1/factory/scorers",
-    "GET /api/v1/factory/scorers/{scorer_id}/autofix-config",
+    "GET /api/v1/factory/scorers/{scorer_id}/metrics/pass-rate",
     "GET /api/v1/factory/scorers/{scorer_id}/results",
     "GET /api/v1/factory/scorers/{scorer_id}/results/reasons",
+    "GET /api/v1/factory/scorers/{scorer_id}/self-improvement-config",
     "GET /api/v1/factory/{uid}",
     "GET /api/v1/factory/{uid}/benchmarks/runs",
     "GET /api/v1/factory/{uid}/benchmarks/runs/{run_uid}",
     "GET /api/v1/factory/{uid}/benchmarks/runs/{run_uid}/results",
     "GET /api/v1/factory/{uid}/benchmarks/suites",
     "GET /api/v1/factory/{uid}/benchmarks/suites/{suite_uid}",
+    "GET /api/v1/factory/{uid}/gitlab-automation-capability",
+    "GET /api/v1/factory/{uid}/integration-activations",
+    "GET /api/v1/factory/{uid}/integration-destinations",
     "GET /api/v1/factory/{uid}/integrations/github/branches",
     "GET /api/v1/factory/{uid}/integrations/github/labels",
     "GET /api/v1/factory/{uid}/integrations/github/teams",
     "GET /api/v1/factory/{uid}/integrations/github/users",
     "GET /api/v1/factory/{uid}/integrations/github/workflows",
+    "GET /api/v1/factory/{uid}/integrations/jira/labels",
+    "GET /api/v1/factory/{uid}/integrations/jira/projects",
+    "GET /api/v1/factory/{uid}/integrations/jira/statuses",
     "GET /api/v1/factory/{uid}/integrations/linear/issues",
     "GET /api/v1/factory/{uid}/integrations/linear/projects",
     "GET /api/v1/factory/{uid}/integrations/linear/teams",
@@ -883,10 +901,20 @@
     "GET /api/v1/factory/{uid}/integrations/linear/workflow-states",
     "GET /api/v1/factory/{uid}/integrations/slack/conversations",
     "GET /api/v1/factory/{uid}/integrations/slack/users",
+    "GET /api/v1/factory/{uid}/merges/{merge_uid}",
     "GET /api/v1/factory/{uid}/metrics",
+    "GET /api/v1/factory/{uid}/metrics/cost-by-pr-size",
+    "GET /api/v1/factory/{uid}/metrics/run-breakdown",
+    "GET /api/v1/factory/{uid}/metrics/top-prs",
+    "GET /api/v1/factory/{uid}/review",
     "GET /api/v1/factory/{uid}/source",
+    "GET /api/v1/factory/{uid}/source/export",
+    "GET /api/v1/factory/{uid}/source/file",
+    "GET /api/v1/factory/{uid}/source/link-readiness",
+    "GET /api/v1/factory/{uid}/source/tree",
     "GET /api/v1/factory/{uid}/syncs",
     "GET /api/v1/factory/{uid}/task-by-conversation",
+    "GET /api/v1/factory/{uid}/task-by-run",
     "GET /api/v1/factory/{uid}/tasks",
     "GET /api/v1/factory/{uid}/tasks/{task_uid}",
     "GET /api/v1/harness-support/transcript",
@@ -924,20 +952,24 @@
     "POST /api/v1/agent/schedules/{id}/resume",
     "POST /api/v1/agent/tasks/{id}/cancel",
     "POST /api/v1/factory",
-    "POST /api/v1/factory/autofix/runs/{autofix_run_id}/file-tasks",
-    "POST /api/v1/factory/autofix/worker-results/{worker_result_id}/report",
+    "POST /api/v1/factory-files/validate",
     "POST /api/v1/factory/automations",
     "POST /api/v1/factory/avatar",
     "POST /api/v1/factory/run-scoring/dispatches",
     "POST /api/v1/factory/scorers",
-    "POST /api/v1/factory/scorers/{scorer_id}/pause",
-    "POST /api/v1/factory/scorers/{scorer_id}/resume",
     "POST /api/v1/factory/{uid}/apply",
     "POST /api/v1/factory/{uid}/benchmarks/runs/{run_uid}/cancel",
     "POST /api/v1/factory/{uid}/benchmarks/suites",
     "POST /api/v1/factory/{uid}/benchmarks/suites/{suite_uid}/runs",
+    "POST /api/v1/factory/{uid}/benchmarks/suites/{suite_uid}/tasks",
+    "POST /api/v1/factory/{uid}/gitlab-automation-capability/refresh",
+    "POST /api/v1/factory/{uid}/merges",
+    "POST /api/v1/factory/{uid}/merges/check",
     "POST /api/v1/factory/{uid}/plan",
+    "POST /api/v1/factory/{uid}/review/refine",
+    "POST /api/v1/factory/{uid}/source/clone-url",
     "POST /api/v1/factory/{uid}/tasks",
+    "POST /api/v1/factory/{uid}/tasks/{task_uid}/cancel",
     "POST /api/v1/harness-support/block-snapshot",
     "POST /api/v1/harness-support/commit-snapshot",
     "POST /api/v1/harness-support/external-conversation",
@@ -961,9 +993,10 @@
     "PUT /api/v1/factory/automations/{id}",
     "PUT /api/v1/factory/automations/{id}/subscriptions",
     "PUT /api/v1/factory/automations/{id}/subscriptions/{subscription_id}",
-    "PUT /api/v1/factory/scorers/{scorer_id}/autofix-config",
+    "PUT /api/v1/factory/scorers/{scorer_id}/self-improvement-config",
     "PUT /api/v1/factory/{uid}/integrations/linear/teams/{team_id}/labels",
     "PUT /api/v1/factory/{uid}/source",
+    "PUT /api/v1/factory/{uid}/source/files",
     "PUT /api/v1/memory_stores/{uid}",
     "PUT /api/v1/memory_stores/{uid}/memories/{memoryUid}"
   ],
@@ -1365,6 +1398,7 @@
     "claude-api": "bundled",
     "create-skill": "bundled",
     "create-tab-config": "bundled",
+    "factory-files": "bundled",
     "factory-mcp": "bundled",
     "modify-settings": "bundled",
     "oz-platform": "bundled",
@@ -1377,5 +1411,5 @@
     "verify-ui-change-in-cloud": "dogfood",
     "warpctrl": "bundled"
   },
-  "changelog_last_version": "2026.08.07"
+  "changelog_last_version": "2026.08.13"
 }