webstudio 0.301.0 → 0.303.0

package/lib/cli.js

@@ -20,7 +20,7 @@ import fs, { rm, mkdtemp, writeFile, readFile, access, constants as constants$1,
 import { gzip } from "node:zlib";
 import { execFile, spawn } from "node:child_process";
 import { promisify, isDeepStrictEqual } from "node:util";
-import { readdirSync, constants as constants$2, createWriteStream, existsSync, realpathSync, readFileSync } from "node:fs";
+import { readdirSync, constants as constants$2, createWriteStream, existsSync, createReadStream, realpathSync, readFileSync } from "node:fs";
 import envPaths from "env-paths";
 import { randomUUID, createHash } from "node:crypto";
 import { text as text$d, isCancel, cancel, log, spinner, confirm, select as select$3 } from "@clack/prompts";
@@ -38,6 +38,7 @@ import { createServer } from "node:net";
 import "detect-port";
 import { Launcher } from "chrome-launcher";
 import { Buffer as Buffer$1 } from "node:buffer";
+import semver from "semver";
 import { createRequire } from "node:module";
 import { x as x$6 } from "tinyexec";
 import makeCLI from "yargs";
@@ -52970,7 +52971,7 @@ const editCustomResponseHeaders = (headers, key2, next) => {
     (header2) => customResponseHeaderKey(header2) !== key2
   );
   if (next !== void 0) {
-    updated.unshift(next);
+    updated.push(next);
   }
   return customResponseHeaders.parse(updated);
 };
@@ -193558,7 +193559,7 @@ const propsCollapsible = {
 const propsCollapsibleTrigger = {};
 const propsCollapsibleContent = {
   forceMount: {
-    description: "Used to force mounting when more control is needed. Useful when controlling animation with React animation libraries or keeping content available in the DOM.",
+    description: "When true, closed content stays mounted. Keep an explicit closed-state CSS rule such as height: 0; Radix's animation-only example assumes unmounted content. Radix suppresses CSS transitions and animations while measuring height, so the first open may not animate.",
     required: false,
     control: "boolean",
     type: "boolean"
@@ -194167,10 +194168,10 @@ const propsAccordionHeader = {};
 const propsAccordionTrigger = {};
 const propsAccordionContent = {
   forceMount: {
-    description: "Used to force mounting when more control is needed. Useful when controlling animation with React animation libraries or keeping content available in the DOM.",
     required: false,
     control: "boolean",
-    type: "boolean"
+    type: "boolean",
+    description: "When true, closed content stays mounted. Keep an explicit closed-state CSS rule such as height: 0; Radix's animation-only example assumes unmounted content. Radix suppresses CSS transitions and animations while measuring height, so the first open may not animate."
   }
 };
 const metaAccordion = {
@@ -278902,7 +278903,7 @@ const AccordionItem = reactExports.forwardRef(({ value: value2, ...props2 }, ref
 });
 const AccordionHeader = Header;
 const AccordionTrigger = Trigger2;
-const AccordionContent = Content2$1;
+const AccordionContent = reactExports.forwardRef(({ forceMount, ...props2 }, ref2) => /* @__PURE__ */ jsxRuntimeExports.jsx(Content2$1, { ref: ref2, forceMount: forceMount ? true : void 0, ...props2 }));
 const namespace$2 = "@webstudio-is/sdk-components-react-radix";
 const hooksAccordion = {
   onNavigatorSelect: (context, event) => {
@@ -323331,8 +323332,9 @@ const capabilityAreas = [
   },
   {
     area: "publish",
-    goal: "Publish, unpublish, inspect publish jobs, and manage domains.",
+    goal: "Validate and publish projects, inspect publish jobs, and manage domains.",
     tools: [
+      "validate-publish",
       "publish",
       "list-publishes",
       "get-publish-job",
@@ -327221,7 +327223,8 @@ const createProjectSessionMcpServer = async ({
   toolNameFormat = "canonical",
   toolHeartbeatIntervalMs = 1e4,
   onToolFailure,
-  onToolSuccess
+  onToolSuccess,
+  additionalInstructions
 }) => {
   const server = new Server(
     { name: "webstudio", version: "0.0.0" },
@@ -327231,7 +327234,7 @@ const createProjectSessionMcpServer = async ({
         resources: {},
         logging: {}
       },
-      instructions: startupGuidance
+      instructions: [startupGuidance, additionalInstructions?.trim()].filter(Boolean).join("\n\n")
     }
   );
   const sendLog = (level, data2) => {
@@ -329285,10 +329288,10 @@ const serverOnlyRouterOperationMetadata = {
   },
   "publish.validate": {
     id: "publish.validate",
-    command: "check-publish-readiness",
+    command: "validate-publish",
     method: "query",
     path: "api.publish.validate",
-    client: "checkPublishReadiness",
+    client: "validatePublish",
     permit: "edit",
     inputSchema: {
       type: "object",
@@ -330279,12 +330282,12 @@ const curatedPublicApiOperationDocumentation = [
     examples: ["webstudio delete-resource --resource resource-id --json"]
   },
   {
-    command: "check-publish-readiness",
-    description: "Check publish access, selected domains, and content diagnostics without starting a publish. Use audit for project-wide quality checks.",
+    command: "validate-publish",
+    description: "Validate publish access, selected domains, and content diagnostics without starting a publish. Use audit for project-wide quality checks.",
     requiredOptions: ["target", "json"],
     examples: [
-      "webstudio check-publish-readiness --target production --json",
-      'MCP tool: check-publish-readiness {"target":"production"}'
+      "webstudio validate-publish --target production --json",
+      'MCP tool: validate-publish {"target":"production"}'
     ]
   },
   {
@@ -332331,7 +332334,7 @@ const createResource = projectMutationInput("create-resource");
 const updateResource = projectMutationInput("update-resource");
 const deleteResource = projectMutationInput("delete-resource");
 const listPublishes = projectQueryInput("list-publishes");
-const checkPublishReadiness = projectQueryInput("check-publish-readiness");
+const validatePublish = projectQueryInput("validate-publish");
 const publish = projectMutationInput("publish");
 const getPublishJob = projectQueryInput("get-publish-job");
 const unpublish = projectConfirmedMutationInput("unpublish");
@@ -332496,7 +332499,6 @@ const httpClient = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePr
   bindProps,
   bundleVersion,
   checkProjectBuildPermission,
-  checkPublishReadiness,
   clearStyleSourceStyles,
   cloneInstance,
   connectContentBlockSource,
@@ -332680,6 +332682,7 @@ const httpClient = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePr
   upsertResource,
   upsertResourceProp,
   validateAssetQuery,
+  validatePublish,
   verifyBindings,
   verifyDomain,
   wrapInstance
@@ -332692,7 +332695,7 @@ class HandledCliError extends Error {
 }
 const isHandledCliError = (error) => error instanceof HandledCliError;
 const name = "webstudio";
-const version$1 = "0.301.0";
+const version$1 = "0.303.0";
 const description = "Webstudio CLI";
 const author = "Webstudio <github@webstudio.is>";
 const homepage = "https://webstudio.is";
@@ -333059,6 +333062,7 @@ const materializeManagedAgents = async ({
   return { path: path2, status: current4 === void 0 ? "created" : "updated" };
 };
 const publishedMdxTotalBytes = 32 * 1024 * 1024;
+const getPublishedMdxAssetIds = (assets) => new Set(assets.filter(isMdxFileAsset).map(({ id: id2 }) => id2));
 const getPublishedMdxContentDatabaseMaxBytes = ({
   baseBytes,
   assets
@@ -333164,6 +333168,8 @@ const resolvePublishedMdxDependencyClosureWithParser = async ({
   build: build2,
   artifact,
   onTemplateOmission,
+  onMdxBlockInstanceId,
+  allMdxAssetIds,
   parseDocument: parseDocument2
 }) => {
   const instances = new Map(
@@ -333210,11 +333216,13 @@ const resolvePublishedMdxDependencyClosureWithParser = async ({
     if (source === void 0) {
       continue;
     }
+    onMdxBlockInstanceId?.(blockId);
     const staticValue = getStaticContentBlockSourceAssetId(source);
     const assetIds = typeof staticValue === "string" ? [staticValue] : resolvePublishedMdxAssetCandidates({
       build: build2,
       artifact,
-      blockInstanceIds: /* @__PURE__ */ new Set([blockId])
+      blockInstanceIds: /* @__PURE__ */ new Set([blockId]),
+      allMdxAssetIds
     }).get(blockId) ?? [];
     for (const assetId2 of assetIds) {
       const documentEntry = documentsById.get(assetId2);
@@ -333263,7 +333271,8 @@ const resolvePublishedMdxDependencyClosureWithParser = async ({
     build: build2,
     artifact,
     blockInstanceIds: reachableIds,
-    allowUnresolved: true
+    allowUnresolved: true,
+    allMdxAssetIds
   });
   return createPublishedBuildContentCompilationPlan(
     build2,
@@ -333314,7 +333323,8 @@ const resolvePublishedMdxAssetCandidates = ({
   build: build2,
   artifact,
   allowUnresolved = false,
-  blockInstanceIds = getPublishedInstanceIds(build2)
+  blockInstanceIds = getPublishedInstanceIds(build2),
+  allMdxAssetIds
 }) => {
   const instances = new Map(
     getBuildValues(build2.instances).map((instance2) => [
@@ -333341,7 +333351,7 @@ const resolvePublishedMdxAssetCandidates = ({
   );
   const documentGraph = artifact?.documentGraph === void 0 ? void 0 : createDocumentGraph(artifact.documentGraph);
   const documents = artifact?.documents ?? [];
-  const evaluateDataSource = (dataSourceId2, path2, visiting = /* @__PURE__ */ new Set()) => {
+  const evaluateDataSource = (dataSourceId2, path2, visiting = /* @__PURE__ */ new Set(), mutableVariables = /* @__PURE__ */ new Set()) => {
     if (visiting.has(dataSourceId2)) {
       throw new Error("Dynamic MDX source data dependency is cyclic");
     }
@@ -333350,6 +333360,7 @@ const resolvePublishedMdxAssetCandidates = ({
       return [];
     }
     if (dataSource2.type === "variable") {
+      mutableVariables.add(dataSourceId2);
       return [];
     }
     if (dataSource2.type === "resource") {
@@ -333428,7 +333439,8 @@ const resolvePublishedMdxAssetCandidates = ({
         iterables = evaluateDataSource(
           dependencyId,
           dataPath.slice(1),
-          visiting
+          visiting,
+          mutableVariables
         );
         visiting.delete(dataSourceId2);
       }
@@ -333459,8 +333471,14 @@ const resolvePublishedMdxAssetCandidates = ({
     const path2 = parseStaticMemberPath(source.value);
     const dataSourceId2 = path2 === void 0 ? void 0 : decodeDataVariableId(path2[0]);
     let assetIds = [];
+    const mutableVariables = /* @__PURE__ */ new Set();
     try {
-      assetIds = dataSourceId2 === void 0 || path2 === void 0 ? [] : evaluateDataSource(dataSourceId2, path2.slice(1)).filter(
+      assetIds = dataSourceId2 === void 0 || path2 === void 0 ? [] : evaluateDataSource(
+        dataSourceId2,
+        path2.slice(1),
+        /* @__PURE__ */ new Set(),
+        mutableVariables
+      ).filter(
         (value2) => typeof value2 === "string" && value2.length > 0
       );
     } catch (error) {
@@ -333468,6 +333486,9 @@ const resolvePublishedMdxAssetCandidates = ({
         throw error;
       }
     }
+    if (mutableVariables.size > 0 && allMdxAssetIds !== void 0) {
+      assetIds.push(...allMdxAssetIds);
+    }
     if (assetIds.length === 0) {
       if (allowUnresolved) {
         continue;
@@ -333839,7 +333860,26 @@ const sync = async (options, dependencies2 = defaultSyncDependencies) => {
     )
   });
   const isStaticBuild = project.build.deployment?.destination === "static";
-  const assetsToDownload = options.buildId !== void 0 && isStaticBuild === false ? project.assets.filter(
+  const publicationBuild = {
+    ...project.build,
+    pages: migratePages(project.build.pages)
+  };
+  const allMdxAssetIds = getPublishedMdxAssetIds(project.assets);
+  const projectCandidates = resolvePublishedMdxAssetCandidates({
+    build: publicationBuild,
+    artifact: project.assetIndex,
+    allowUnresolved: true,
+    allMdxAssetIds
+  });
+  const dynamicBlockIds = getDynamicPublishedMdxSourceBlockIds(publicationBuild);
+  const publicationPlan = createPublishedBuildContentCompilationPlan(
+    publicationBuild,
+    projectCandidates
+  );
+  const needsMdxCompilation = dynamicBlockIds.length > 0 || publicationPlan?.queries.some(
+    ({ id: id2 }) => id2.startsWith("__content-block-mdx__:")
+  ) === true;
+  const assetsToDownload = options.buildId !== void 0 && !isStaticBuild && !needsMdxCompilation ? project.assets.filter(
     (asset2) => asset2.format !== "md" && asset2.format !== "mdx"
   ) : project.assets;
   if (assetsToDownload.length > 0) {
@@ -333863,23 +333903,12 @@ const sync = async (options, dependencies2 = defaultSyncDependencies) => {
       throw new HandledCliError();
     }
   }
-  if (options.buildId !== void 0 && isStaticBuild && project.assetIndex === void 0) {
-    const publicationBuild = {
-      ...project.build,
-      pages: migratePages(project.build.pages)
-    };
-    const projectCandidates = resolvePublishedMdxAssetCandidates({
-      build: publicationBuild,
-      allowUnresolved: true
-    });
-    const needsCandidateDiscovery = getDynamicPublishedMdxSourceBlockIds(
-      publicationBuild
-    ).some((blockId) => projectCandidates.has(blockId) === false);
-    const candidateDiscoveryPlan = needsCandidateDiscovery ? createBuildContentCompilationPlan(publicationBuild) : void 0;
-    let plan = candidateDiscoveryPlan ?? createPublishedBuildContentCompilationPlan(
-      publicationBuild,
-      projectCandidates
+  if (options.buildId !== void 0 && (isStaticBuild && project.assetIndex === void 0 || needsMdxCompilation)) {
+    const needsCandidateDiscovery = dynamicBlockIds.some(
+      (blockId) => projectCandidates.has(blockId) === false
     );
+    const candidateDiscoveryPlan = needsCandidateDiscovery ? createBuildContentCompilationPlan(publicationBuild) : void 0;
+    const plan = candidateDiscoveryPlan ?? publicationPlan;
     if (plan !== void 0) {
       syncing.message("Preparing local content index");
       const source = createContentSource();
@@ -333900,7 +333929,11 @@ const sync = async (options, dependencies2 = defaultSyncDependencies) => {
         project.assetIndex = await compileContentUntilPlanIsStable({
           plan,
           compile,
-          resolvePlan: async (artifact) => await resolvePlan({ build: publicationBuild, artifact })
+          resolvePlan: async (artifact) => await resolvePlan({
+            build: publicationBuild,
+            artifact,
+            allMdxAssetIds
+          })
         });
       } else {
         project.assetIndex = await compile(plan);
@@ -340690,7 +340723,8 @@ const materializePublishedMdx = async ({
   cache = createPublishedMdxMaterializationCache(),
   dynamicAssetIdsByBlock = /* @__PURE__ */ new Map(),
   blockInstanceIds,
-  runtimeAssets: providedRuntimeAssets
+  runtimeAssets: providedRuntimeAssets,
+  loadDocumentSource
 }) => {
   const documentsById = new Map(
     artifact.documents.map((document2) => [document2._id, document2])
@@ -340718,7 +340752,7 @@ const materializePublishedMdx = async ({
           assetValueReferences: artifact.assetValueReferences,
           runtimeAssets,
           load: async (node2) => {
-            const source = artifact.contents?.[node2.contentRef];
+            const source = artifact.contents?.[node2.contentRef] ?? await loadDocumentSource?.(node2);
             if (source === void 0 || node2.format === void 0) {
               throw new Error(`Published document ${node2.id} is unavailable`);
             }
@@ -340873,6 +340907,26 @@ const materializePublishedMdx = async ({
           resolution2.references.map((reference) => reference.templateName)
         )
       );
+      let resolvedFrontmatter = document2.frontmatter.properties;
+      try {
+        resolvedFrontmatter = await resolveFrontmatter(candidate._id, document2);
+      } catch (error) {
+        if (error instanceof DocumentGraphResolutionError && error.code === "REQUEST_CANCELLED") {
+          throw error;
+        }
+        if (error instanceof DocumentGraphResolutionError) {
+          const linkedDocument = error.documentId === void 0 ? "Linked document" : `Linked document "${error.documentId}"`;
+          const reference = error.referenceId === void 0 ? "" : ` (reference "${error.referenceId}")`;
+          const failure = error.code === "DOCUMENT_LOAD_FAILED" ? "could not be loaded" : `could not be resolved: ${error.message}`;
+          warnUnavailableSource({
+            blockInstanceId: block.id,
+            assetId: candidate._id,
+            message: `${linkedDocument} ${failure}${reference} while resolving frontmatter for published MDX Asset "${candidate._id}".`
+          });
+        } else {
+          throw error;
+        }
+      }
       const materialized = materializeMdxAuthoredContent({
         identity,
         document: document2,
@@ -340905,7 +340959,7 @@ const materializePublishedMdx = async ({
         dynamic: isDynamicSource,
         identity,
         document: document2,
-        resolvedFrontmatter: await resolveFrontmatter(candidate._id, document2),
+        resolvedFrontmatter,
         fragment: materialized.fragment,
         templateDependencies: templates2.dependencies.templates,
         templateNames: referencedTemplateNames,
@@ -346947,6 +347001,37 @@ Please check webstudio --help for more details`
       exit$4(1);
     }
   }
+  const loadedSiteData = await loadJSONFile(LOCAL_DATA_FILE);
+  if (loadedSiteData === null) {
+    throw new Error(
+      `Project bundle is missing, please make sure the project is synced.`
+    );
+  }
+  const parsedSiteData = publishedProjectBundle.safeParse(loadedSiteData);
+  if (parsedSiteData.success === false) {
+    throw Object.assign(
+      new Error(
+        `Project bundle is invalid, please make sure the project is synced. Invalid fields: ${formatZodIssues(
+          parsedSiteData.error.issues,
+          loadedSiteData
+        )}`
+      ),
+      {
+        code: "PROJECT_BUNDLE_INVALID",
+        bundleVersion,
+        issues: getZodValidationIssues(parsedSiteData.error)
+      }
+    );
+  }
+  const siteData = parsedSiteData.data;
+  const pages2 = migratePages(siteData.build.pages);
+  const publicationBuild = { ...siteData.build, pages: pages2 };
+  const allMdxAssetIds = getPublishedMdxAssetIds(siteData.assets);
+  if (siteData.assetIndex === void 0 && (createPublishedBuildContentCompilationPlan(publicationBuild) !== void 0 || hasDynamicPublishedMdxSources(publicationBuild))) {
+    throw new Error(
+      "Assets queries require a content database. Sync the project again before building."
+    );
+  }
   feedback.step("Scaffolding the project files");
   if (options.incremental !== true) {
     await rm(generatedDir, { recursive: true, force: true });
@@ -346985,31 +347070,6 @@ Please check webstudio --help for more details`
     framework = await createFramework$2(frameworkOptions);
   }
   const assetBaseUrl = await readAssetBaseUrl(join$2(cwd$1(), "app/constants.mjs"));
-  const loadedSiteData = await loadJSONFile(LOCAL_DATA_FILE);
-  if (loadedSiteData === null) {
-    throw new Error(
-      `Project bundle is missing, please make sure the project is synced.`
-    );
-  }
-  const parsedSiteData = publishedProjectBundle.safeParse(loadedSiteData);
-  if (parsedSiteData.success === false) {
-    throw Object.assign(
-      new Error(
-        `Project bundle is invalid, please make sure the project is synced. Invalid fields: ${formatZodIssues(
-          parsedSiteData.error.issues,
-          loadedSiteData
-        )}`
-      ),
-      {
-        code: "PROJECT_BUNDLE_INVALID",
-        bundleVersion,
-        issues: getZodValidationIssues(parsedSiteData.error)
-      }
-    );
-  }
-  const siteData = parsedSiteData.data;
-  const pages2 = migratePages(siteData.build.pages);
-  const publicationBuild = { ...siteData.build, pages: pages2 };
   let verifiedAssetIndex = siteData.assetIndex === void 0 ? void 0 : await verifyContentArtifact(siteData.assetIndex);
   if (verifiedAssetIndex !== void 0 && (options.previewIdentity === true || options.assets === true)) {
     verifiedAssetIndex = await hydrateLocalMarkdownContents({
@@ -347023,10 +347083,11 @@ Please check webstudio --help for more details`
   }
   let dynamicMdxCandidates;
   if (hasDynamicPublishedMdxSources(publicationBuild)) {
-    dynamicMdxCandidates = verifiedAssetIndex === void 0 ? /* @__PURE__ */ new Map() : resolvePublishedMdxAssetCandidates({
+    dynamicMdxCandidates = resolvePublishedMdxAssetCandidates({
       build: publicationBuild,
       artifact: verifiedAssetIndex,
-      allowUnresolved: true
+      allowUnresolved: true,
+      allMdxAssetIds
     });
     for (const blockInstanceId of getDynamicPublishedMdxSourceBlockIds(
       publicationBuild
@@ -347260,7 +347321,8 @@ Please check webstudio --help for more details`
         ) ? resolvePublishedMdxAssetCandidates({
           build: pageBuild,
           artifact: verifiedAssetIndex,
-          blockInstanceIds: pendingBlockIds
+          blockInstanceIds: pendingBlockIds,
+          allMdxAssetIds
         }) : void 0;
         const materialized = await materializePublishedMdx({
           route,
@@ -347281,7 +347343,21 @@ Please check webstudio --help for more details`
           cache,
           dynamicAssetIdsByBlock: pageDynamicCandidates,
           blockInstanceIds: pendingBlockIds,
-          runtimeAssets: runtimeAssetsById
+          runtimeAssets: runtimeAssetsById,
+          loadDocumentSource: async ({ contentRef }) => {
+            const source = createReadStream(
+              getLocalAssetPath(
+                contentRef,
+                options.sourceAssetsDirectory ?? join$2(buildRoot, LOCAL_ASSETS_DIR)
+              )
+            );
+            return decodeUtf8$1(
+              await readBoundedBytes(
+                source,
+                contentEngineLimits.hydratedFileBytes
+              )
+            );
+          }
         });
         for (const root2 of materialized.roots) {
           const diagnostic = getUnsafeDynamicPublishedMdxDiagnostic({
@@ -347386,6 +347462,9 @@ Please check webstudio --help for more details`
               ...warning2.diagnostic
             })
           );
+          if (warning2.diagnostic.severity === "error") {
+            throw new Error(warning2.diagnostic.message);
+          }
         }
       }
       pageData.build.instances = Array.from(pageInstances);
@@ -347659,7 +347738,8 @@ Please check webstudio --help for more details`
       import type { PageMeta } from "@webstudio-is/sdk";
       ${generateResources({
       scope: scope2,
-      page: page2,
+      // XML generation removes the body wrapper from the instance map.
+      page: { ...page2, rootInstanceId },
       dataSources,
       props: props2,
       resources,
@@ -350346,7 +350426,7 @@ const publishCommandOptions = (yargs) => publishDomainsOption(publishTargetOptio
   type: "string",
   describe: "Optional idempotency key for retrying the same publish"
 });
-const checkPublishReadinessCommandOptions = (yargs) => publishDomainsOption(publishTargetOption(apiCommandOptions(yargs)));
+const validatePublishCommandOptions = (yargs) => publishDomainsOption(publishTargetOption(apiCommandOptions(yargs)));
 const publishJobCommandOptions = (yargs) => apiCommandOptions(yargs).option("job", {
   type: "string",
   describe: "Required publish job id returned by publish or unpublish",
@@ -351786,13 +351866,13 @@ const apiCommandHandlers = {
     };
     return runProjectSessionCommand("publish", input2, connection, dependencies2);
   },
-  "check-publish-readiness": async (options, connection, dependencies2) => {
+  "validate-publish": async (options, connection, dependencies2) => {
     const input2 = {
       target: publishTargetValue(options.target),
       domains: listStringOption(options.domain)
     };
     return runProjectSessionCommand(
-      "check-publish-readiness",
+      "validate-publish",
       input2,
       connection,
       dependencies2
@@ -352249,7 +352329,7 @@ const apiCommandOptionsByCommand = {
   "delete-resource": deleteResourceCommandOptions,
   "list-domains": paginatedListCommandOptions,
   publish: publishCommandOptions,
-  "check-publish-readiness": checkPublishReadinessCommandOptions,
+  "validate-publish": validatePublishCommandOptions,
   "get-publish-job": publishJobCommandOptions,
   unpublish: unpublishCommandOptions,
   "create-domain": createDomainCommandOptions,
@@ -352282,8 +352362,8 @@ const apiCommandMetadata = publicApiOperations.map((operation) => ({
 const highLevelCliCommands = [
   { command: "audit", operation: "audit" },
   {
-    command: "check-publish-readiness",
-    operation: "check-publish-readiness"
+    command: "validate-publish",
+    operation: "validate-publish"
   },
   { command: "permissions", operation: "permissions" },
   { command: "get-assets-resource", operation: "get-assets-resource" },
@@ -352837,7 +352917,7 @@ const apiCommandsByArea = {
   projectQuality: cliCommandMetadata.filter(({ cliCommand }) => cliCommand === "audit").map(({ cliCommand }) => cliCommand),
   assetsAndIndexes: cliCommandMetadata.filter(({ cliCommand }) => cliCommand.includes("asset")).map(({ cliCommand }) => cliCommand),
   publishAndDomains: cliCommandMetadata.filter(
-    ({ cliCommand }) => cliCommand === "check-publish-readiness" || cliCommand.startsWith("publish ") || cliCommand.startsWith("domains ")
+    ({ cliCommand }) => cliCommand === "validate-publish" || cliCommand.startsWith("publish ") || cliCommand.startsWith("domains ")
   ).map(({ cliCommand }) => cliCommand),
   pagesAndSettings: cliCommandMetadata.filter(
     ({ cliCommand }) => [
@@ -354807,6 +354887,35 @@ const withTimeout = async (operation, timeout, createTimeoutError2) => {
     }
   }
 };
+const latestPackageUrl = "https://registry.npmjs.org/webstudio/latest";
+const requestTimeoutMs = 1500;
+const checkForCliUpdate = async ({
+  currentVersion,
+  request = fetch
+}) => {
+  if (semver.valid(currentVersion) === null) {
+    return;
+  }
+  try {
+    const response = await request(latestPackageUrl, {
+      signal: AbortSignal.timeout(requestTimeoutMs)
+    });
+    if (response.ok === false) {
+      return;
+    }
+    const latestPackage = await response.json();
+    if (isPlainRecord(latestPackage) === false) {
+      return;
+    }
+    const latestVersion = typeof latestPackage.version === "string" ? semver.valid(latestPackage.version) : null;
+    if (latestVersion === null || semver.gt(latestVersion, currentVersion) === false) {
+      return;
+    }
+    return { currentVersion, latestVersion };
+  } catch {
+    return;
+  }
+};
 const createProgressProjects = () => /* @__PURE__ */ Object.create(null);
 const maximumConcurrency = 16;
 const parsePositiveInteger = (value2, fallback) => {
@@ -355958,14 +356067,32 @@ const createMcpPreviewHandlers = ({
     quality: input2.quality,
     scale: input2.scale
   });
+  const captureWhileRouteSettles = async (capture, isGeneratedSite, progress2) => {
+    let result2 = await capture();
+    for (let retry = 0; retry < 2 && !isGeneratedSite(result2); retry += 1) {
+      progress2?.report("tool screenshot waiting for refreshed generated route");
+      await sleep(1e3);
+      result2 = await capture();
+    }
+    return result2;
+  };
   const assertGeneratedSiteCapture = (input2, result2) => {
     if (input2.path !== void 0 && input2.baseUrl === void 0 && result2.navigation?.generatedSiteRootPresent === false) {
-      throw Object.assign(
-        new Error(
-          'Screenshot did not render the generated Webstudio site. Capture the route with screenshot { path: "/" }; do not capture the Builder UI.'
-        ),
-        { code: "SCREENSHOT_NOT_GENERATED_SITE" }
-      );
+      const status = result2.navigation.status;
+      const routeFailed = status !== void 0 && status >= 400;
+      const code2 = routeFailed ? "SCREENSHOT_ROUTE_HTTP_ERROR" : "SCREENSHOT_NOT_GENERATED_SITE";
+      const message = routeFailed ? `The generated route returned HTTP ${status} before a Webstudio page could render. Check the preview server output for the route error.` : "The requested route did not render a generated Webstudio page. Check the route and preview server output; a screenshot of the home route does not verify this page.";
+      throw Object.assign(new Error(message), {
+        code: code2,
+        issues: [
+          {
+            code: routeFailed ? "screenshot_route_http_error" : "generated_site_marker_missing",
+            path: [],
+            message,
+            constraint: routeFailed ? `http_status:${status}` : "generated_site_identity_present"
+          }
+        ]
+      });
     }
     return result2;
   };
@@ -356037,17 +356164,11 @@ const createMcpPreviewHandlers = ({
               return await captureWithSessionReconnect(
                 input2,
                 progress2,
-                async (captureSession2) => {
-                  let captureResult = await captureSession2.capture(captureOptions);
-                  for (let retry = 0; retry < 2 && captureResult.navigation?.generatedSiteRootPresent === false; retry += 1) {
-                    progress2?.report(
-                      "tool screenshot waiting for refreshed generated route"
-                    );
-                    await sleep(1e3);
-                    captureResult = await captureSession2.capture(captureOptions);
-                  }
-                  return captureResult;
-                }
+                async (captureSession2) => await captureWhileRouteSettles(
+                  () => captureSession2.capture(captureOptions),
+                  (result22) => result22.navigation?.generatedSiteRootPresent !== false,
+                  progress2
+                )
               );
             }
             return await captureScreenshot2({
@@ -356106,8 +356227,8 @@ const createMcpPreviewHandlers = ({
             return await captureWithSessionReconnect(
               firstInput,
               progress2,
-              async (captureSession2) => await captureSession2.capturePage(
-                inputs.map((input2, index2) => {
+              async (captureSession2) => {
+                const captureOptions = inputs.map((input2, index2) => {
                   const url2 = urls[index2];
                   if (url2 === void 0) {
                     throw new Error(
@@ -356115,8 +356236,18 @@ const createMcpPreviewHandlers = ({
                     );
                   }
                   return getCaptureOptions(input2, url2);
-                })
-              )
+                });
+                if (isManagedSessionPreviewCapture(firstInput) === false) {
+                  return await captureSession2.capturePage(captureOptions);
+                }
+                return await captureWhileRouteSettles(
+                  () => captureSession2.capturePage(captureOptions),
+                  (results2) => results2.every(
+                    (result2) => result2.navigation?.generatedSiteRootPresent !== false
+                  ),
+                  progress2
+                );
+              }
             );
           },
           timeout,
@@ -356178,6 +356309,12 @@ const prepareMcpProjectSession = async (session) => {
 };
 const mcpStatusPrefix = "[webstudio mcp]";
 const renderedAuditArtifactDirectory = ".webstudio/audits";
+const getCliUpdateInstructions = (update) => {
+  if (update === void 0) {
+    return;
+  }
+  return `This MCP server runs Webstudio CLI ${update.currentVersion}, but ${update.latestVersion} is available. Tell the user before editing and recommend restarting this MCP server with the latest CLI, for example \`npx -y webstudio@latest mcp\`. Do not try to update or restart the CLI yourself. The existing API compatibility check remains the authority for whether writes are supported.`;
+};
 const formatMcpStatusLine = (message) => `${mcpStatusPrefix} ${message}`;
 const createMcpStatusReporter = (write = (line) => {
   stderr.write(`${line}
@@ -357483,7 +357620,7 @@ const createCliMcpHost = async ({
       const renderedProjectVersion = previewStatus.renderedProjectVersion;
       const namespacesByStatus = snapshot === void 0 ? void 0 : (status) => getBuilderStateNamespacesByStatus(snapshot.freshness, status);
       return createIssueReportRuntime(failureTracker.get(), {
-        projectId,
+        projectId: connection.projectId,
         ...namespacesByStatus === void 0 ? {} : {
           session: {
             staleNamespaces: namespacesByStatus("stale"),
@@ -358307,6 +358444,9 @@ const mcp = async (options = {}) => {
   stdin.once("end", reportClose);
   stdin.once("close", reportClose);
   status.starting();
+  const cliUpdatePromise = checkForCliUpdate({
+    currentVersion: packageJson.version
+  });
   const {
     host,
     toolCount,
@@ -358318,6 +358458,7 @@ const mcp = async (options = {}) => {
   } = await createCliMcpHost({
     projectId: options.project
   });
+  const cliUpdate = await cliUpdatePromise;
   disposeHost = dispose;
   if (didReportClose) {
     await disposeHost().catch(() => void 0);
@@ -358328,6 +358469,7 @@ const mcp = async (options = {}) => {
   status.ready(toolCount);
   const server = await connectProjectSessionMcpServer({
     ...host,
+    additionalInstructions: getCliUpdateInstructions(cliUpdate),
     toolNameFormat: options.toolNameFormat,
     getErrorCode: getStableErrorCode,
     onToolFailure: recordToolFailure,
@@ -358344,6 +358486,7 @@ const mcp = async (options = {}) => {
 };
 const __testing__ = {
   getMcpDownloadAsset,
+  getCliUpdateInstructions,
   createMcpStatusReporter,
   formatMcpStatusLine,
   assertSingleOpCallToolSupported,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webstudio",
-  "version": "0.301.0",
+  "version": "0.303.0",
   "description": "Webstudio CLI",
   "author": "Webstudio <github@webstudio.is>",
   "homepage": "https://webstudio.is",
@@ -53,10 +53,10 @@
     "which": "^5.0.0",
     "yargs": "^17.7.2",
     "zod": "^4.4.3",
-    "@webstudio-is/http-client": "0.301.0",
-    "@webstudio-is/project-migrations": "0.301.0",
-    "@webstudio-is/protocol": "0.301.0",
-    "@webstudio-is/sync-client": "0.0.0"
+    "@webstudio-is/protocol": "0.303.0",
+    "@webstudio-is/sync-client": "0.0.0",
+    "@webstudio-is/http-client": "0.303.0",
+    "@webstudio-is/project-migrations": "0.303.0"
   },
   "devDependencies": {
     "@cloudflare/vite-plugin": "^1.1.0",
@@ -99,24 +99,24 @@
     "vite": "^6.3.4",
     "vitest": "^3.1.2",
     "wrangler": "4.130.0",
-    "@webstudio-is/content-engine": "0.301.0",
-    "@webstudio-is/css-engine": "0.301.0",
-    "@webstudio-is/expression": "0.301.0",
-    "@webstudio-is/image": "0.301.0",
-    "@webstudio-is/query-builder": "0.301.0",
-    "@webstudio-is/react-sdk": "0.301.0",
-    "@webstudio-is/sdk-components-animation": "0.301.0",
-    "@webstudio-is/sdk": "0.301.0",
-    "@webstudio-is/sdk-components-react": "0.301.0",
-    "@webstudio-is/sdk-components-react-radix": "0.301.0",
-    "@webstudio-is/sdk-components-react-remix": "0.301.0",
-    "@webstudio-is/fonts": "0.301.0",
-    "@webstudio-is/sdk-components-react-router": "0.301.0",
+    "@webstudio-is/css-engine": "0.303.0",
+    "@webstudio-is/expression": "0.303.0",
+    "@webstudio-is/content-engine": "0.303.0",
+    "@webstudio-is/fonts": "0.303.0",
+    "@webstudio-is/image": "0.303.0",
+    "@webstudio-is/project-build": "0.0.0",
+    "@webstudio-is/react-sdk": "0.303.0",
+    "@webstudio-is/query-builder": "0.303.0",
+    "@webstudio-is/sdk": "0.303.0",
+    "@webstudio-is/sdk-components-animation": "0.303.0",
+    "@webstudio-is/sdk-components-react": "0.303.0",
+    "@webstudio-is/sdk-components-react-radix": "0.303.0",
+    "@webstudio-is/sdk-components-react-remix": "0.303.0",
+    "@webstudio-is/sdk-components-react-router": "0.303.0",
+    "@webstudio-is/sdk-components-registry": "0.303.0",
     "@webstudio-is/tsconfig": "1.0.7",
     "@webstudio-is/vision": "0.0.0",
-    "@webstudio-is/wsauth": "0.301.0",
-    "@webstudio-is/project-build": "0.0.0",
-    "@webstudio-is/sdk-components-registry": "0.301.0"
+    "@webstudio-is/wsauth": "0.303.0"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/templates/cloudflare/package.json

@@ -12,7 +12,7 @@
     "build-cf-types": "wrangler types"
   },
   "dependencies": {
-    "@webstudio-is/wsauth": "0.301.0",
+    "@webstudio-is/wsauth": "0.303.0",
     "@remix-run/cloudflare": "2.16.5",
     "@remix-run/cloudflare-pages": "2.16.5"
   },

package/templates/defaults/package.json

@@ -13,14 +13,14 @@
     "@remix-run/node": "2.16.5",
     "@remix-run/react": "2.16.5",
     "@remix-run/server-runtime": "2.16.5",
-    "@webstudio-is/image": "0.301.0",
-    "@webstudio-is/react-sdk": "0.301.0",
-    "@webstudio-is/sdk": "0.301.0",
-    "@webstudio-is/sdk-components-react": "0.301.0",
-    "@webstudio-is/sdk-components-animation": "0.301.0",
-    "@webstudio-is/sdk-components-react-radix": "0.301.0",
-    "@webstudio-is/sdk-components-react-remix": "0.301.0",
-    "@webstudio-is/wsauth": "0.301.0",
+    "@webstudio-is/image": "0.303.0",
+    "@webstudio-is/react-sdk": "0.303.0",
+    "@webstudio-is/sdk": "0.303.0",
+    "@webstudio-is/sdk-components-react": "0.303.0",
+    "@webstudio-is/sdk-components-animation": "0.303.0",
+    "@webstudio-is/sdk-components-react-radix": "0.303.0",
+    "@webstudio-is/sdk-components-react-remix": "0.303.0",
+    "@webstudio-is/wsauth": "0.303.0",
     "isbot": "^5.1.25",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",

package/templates/react-router/package.json

@@ -15,14 +15,14 @@
     "@react-router/fs-routes": "^7.5.3",
     "@react-router/node": "^7.5.3",
     "@react-router/serve": "^7.5.3",
-    "@webstudio-is/image": "0.301.0",
-    "@webstudio-is/react-sdk": "0.301.0",
-    "@webstudio-is/sdk": "0.301.0",
-    "@webstudio-is/sdk-components-animation": "0.301.0",
-    "@webstudio-is/sdk-components-react-radix": "0.301.0",
-    "@webstudio-is/sdk-components-react-router": "0.301.0",
-    "@webstudio-is/sdk-components-react": "0.301.0",
-    "@webstudio-is/wsauth": "0.301.0",
+    "@webstudio-is/image": "0.303.0",
+    "@webstudio-is/react-sdk": "0.303.0",
+    "@webstudio-is/sdk": "0.303.0",
+    "@webstudio-is/sdk-components-animation": "0.303.0",
+    "@webstudio-is/sdk-components-react-radix": "0.303.0",
+    "@webstudio-is/sdk-components-react-router": "0.303.0",
+    "@webstudio-is/sdk-components-react": "0.303.0",
+    "@webstudio-is/wsauth": "0.303.0",
     "isbot": "^5.1.25",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",

package/templates/react-router-cloudflare/package.json

@@ -7,7 +7,7 @@
   },
   "dependencies": {
     "@cloudflare/vite-plugin": "^1.1.0",
-    "@webstudio-is/wsauth": "0.301.0",
+    "@webstudio-is/wsauth": "0.303.0",
     "wrangler": "^4.14.1"
   }
 }

package/templates/ssg/package.json

@@ -11,12 +11,12 @@
   "dependencies": {
     "@shikijs/langs": "4.4.1",
     "@shikijs/themes": "4.4.1",
-    "@webstudio-is/image": "0.301.0",
-    "@webstudio-is/react-sdk": "0.301.0",
-    "@webstudio-is/sdk": "0.301.0",
-    "@webstudio-is/sdk-components-react": "0.301.0",
-    "@webstudio-is/sdk-components-animation": "0.301.0",
-    "@webstudio-is/sdk-components-react-radix": "0.301.0",
+    "@webstudio-is/image": "0.303.0",
+    "@webstudio-is/react-sdk": "0.303.0",
+    "@webstudio-is/sdk": "0.303.0",
+    "@webstudio-is/sdk-components-react": "0.303.0",
+    "@webstudio-is/sdk-components-animation": "0.303.0",
+    "@webstudio-is/sdk-components-react-radix": "0.303.0",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",
     "shiki": "4.4.1",