chore(missing_docs): refresh surface map and snapshot - #603
Draft
hongyi-chen wants to merge 1 commit into
Draft
Conversation
Bookkeeping for this drift-watch run: repoint two stale map targets, map the newly GA WellKnownMcpIds and FactoryMcp flags, ignore two internal orchestration flags, mark the new Factory REST routes internal, prune routes that no longer exist, and regenerate the surface snapshot. Co-Authored-By: Warp <agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Collaborator
Author
|
This PR was generated with Warp. Comment |
Contributor
|
Your GitHub account is not connected to Warp. Connect it here. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Companion bookkeeping PR for this
missing_docsdrift-watch run. It carries every shared-file edit (the surface map and the regenerated snapshot) so the four feature PRs stay conflict-free. It is independently mergeable in any order: map hygiene only requires the mapped target pages to exist onmain, and every page referenced here already does.Feature PRs from the same run: #599 (well-known MCP ids), #600 (terminal input settings), #601 (tab colors), #602 (run-cloud flags).
Surface map changes
Stale targets repointed
AgentModeandAgentOnboardingpointed atagents/local-agents/overview.mdxandagents/getting-started/agents-in-warp.mdx, both deleted.vercel.json308s both URLs to/agents/, so they now map toagents/index.mdx.Newly GA flags mapped
WellKnownMcpIds→reference/cli/mcp-servers.mdx(documented in docs(mcp): document well-known managed integration ids #599).FactoryMcp→factories/factory-mcp.mdx, whose "Connect and authenticate" section already describes the zero-config attachment the flag gates.Newly GA flags ignored (internal implementation)
WaitForEventsParentRegistrationandOrchestrationUnifiedStackare orchestration plumbing behind the already-documented multi-agent orchestration feature. Neither changes anything a user sees or configures.Factory REST API
internal(webhooks, factory-file schemas and validation, source browsing/merges, review, scorer self-improvement config, benchmark tasks, integration pickers, metrics breakdowns, task cancel/lookup). Warp Factories is documented publicly, but none of these routes are in warp-server's canonical public spec, so per the skill's public/private guardrail they are not hand-documented. Revisit throughsync-openapi-specif they are released into the spec.pause/resumepair and theautofix-configtrio, superseded by theself-improvement-configroutes, plus the twofactory/autofix/*worker routes.Allowlist
platform/integrations/jirafrom the unlisted-pages allowlist: the page left draft status and is now insrc/sidebar.ts.Snapshot
surface_snapshot.jsonregenerated with--update-snapshotso the next run diffs against this baseline.Verification
Re-running the audit after these changes leaves zero findings in every code-surface category:
npm run buildpasses on the combined tree.Deferred findings
warp ai,ai credits,agent-mode,warp terminal,ambient agent) across 30 pages. Owned by thestyle_lintskill, which themissing_docsskill explicitly delegates wording issues to.internalas above; needs async-openapi-specpass if/when released.linear_agent_sessionMCP id — recognized server-side but exists for Linear-triggered runs writing agent-session activities, not as a user-facing choice, so it stays undocumented.factory-files— new in the snapshot. Docs don't enumerate bundled skills anywhere, and the subject matter it assists with is already covered byfactories/factory-as-code.mdx, so no doc change was made./connect-grok, repository-qualified skill references).gated:CLI commands, and 12gated:API routes remain deferred by design; the snapshot diff re-surfaces them on promotion.Reviewer routing
scripts/suggest_reviewers.pyresolved the owning code path to the@warpdotdev/oss-maintainersteam in the warp repo, but that team can't be requested on this repository, so the request didn't stick. Please assign a maintainer manually.