Publish

You MUST use the publish_site tool to publish. Do NOT run build or deploy commands manually. The publish tool handles the entire pipeline: production build, packaging, upload, and deployment. There is no other way to publish.

One Site Per Publish Request (pipeline constraint)

CRITICAL: You may only publish ONE site per publish request. Even if the user asks to "publish everything", "publish all my sites", or "deploy all sites", you MUST publish them one at a time, sequentially. Never call the publish_site tool for multiple sites in parallel or in a batch. The publish pipeline does not support concurrent publishes — running multiple publishes simultaneously will cause build corruption, race conditions, and failed deployments.

This is a constraint on the publish pipeline only. It does not limit how much you build in one turn or one session: creating several pages on a site before publishing once is normal.

If the user asks to publish multiple sites:

1. Identify all the sites to publish via list_sites.
2. Confirm with the user which sites they want published.
3. Publish the first site. Wait for it to fully succeed (build + deploy complete).
4. Only after the first publish succeeds, publish the next site.
5. Repeat until all requested sites are published.