@jay-framework/jay-stack-cli 0.23.0 → 0.24.0

package/dist/index.js

@@ -7,8 +7,8 @@ import path from "path";
 import fs, { promises } from "fs";
 import YAML from "yaml";
 import { getLogger, setDevLogger, createDevLogger } from "@jay-framework/logger";
-import { JAY_IMPORT_RESOLVER, parseJayFile, generateElementDefinitionFile, parseContract, generateElementFile, generateServerElementFile, htmlElementTagNameMap, loadLinkedContract, getLinkedContractDir } from "@jay-framework/compiler-jay-html";
-import { scanPlugins, listContracts, materializeContracts, SetupNeedsAnswerError, discoverPluginsWithSetup, discoverPluginsWithInit, sortPluginsByDependencies, executePluginSetup, executePluginServerInits, runInitCallbacks } from "@jay-framework/stack-server-runtime";
+import { parseJayFile, JAY_IMPORT_RESOLVER, generateElementDefinitionFile, parseContract, generateElementFile, generateServerElementFile, htmlElementTagNameMap, loadLinkedContract, getLinkedContractDir } from "@jay-framework/compiler-jay-html";
+import { scanPlugins, listContracts, materializeContracts, SetupNeedsAnswerError, discoverPluginsWithSetup, sortPluginsByDependencies, discoverPluginsWithInit, executePluginSetup, executePluginServerInits, runInitCallbacks } from "@jay-framework/stack-server-runtime";
 import { listContracts as listContracts2, materializeContracts as materializeContracts2 } from "@jay-framework/stack-server-runtime";
 import { Command } from "commander";
 import chalk from "chalk";
@@ -19,7 +19,7 @@ import { createRequire } from "module";
 import { glob } from "glob";
 import fsSync from "node:fs";
 import { fileURLToPath } from "node:url";
-import { input, confirm, select } from "@inquirer/prompts";
+import { select, confirm, input } from "@inquirer/prompts";
 const DEFAULT_CONFIG = {
   devServer: {
     portRange: [3e3, 3100],
@@ -41,7 +41,8 @@ function loadConfig() {
       devServer: {
         ...DEFAULT_CONFIG.devServer,
         ...userConfig.devServer
-      }
+      },
+      site: userConfig.site
     };
   } catch (error) {
     getLogger().warn(`Failed to parse .jay YAML config file, using defaults: ${error}`);
@@ -56,7 +57,8 @@ function getConfigWithDefaults(config) {
       componentsBase: config.devServer?.componentsBase || DEFAULT_CONFIG.devServer.componentsBase,
       publicFolder: config.devServer?.publicFolder || DEFAULT_CONFIG.devServer.publicFolder,
       configBase: config.devServer?.configBase || DEFAULT_CONFIG.devServer.configBase
-    }
+    },
+    site: config.site
   };
 }
 function updateConfig(updates) {
@@ -69,6 +71,10 @@ function updateConfig(updates) {
       devServer: {
         ...existingConfig.devServer,
         ...updates.devServer
+      },
+      site: {
+        ...existingConfig.site,
+        ...updates.site
       }
     };
     const yamlContent = YAML.stringify(updatedConfig, { indent: 2 });
@@ -146,6 +152,13 @@ async function startDevServer(options = {}) {
   });
   app.use(server);
   const publicPath = path.resolve(resolvedConfig.devServer.publicFolder);
+  if (!fs.existsSync(path.join(publicPath, "sitemap.xml"))) {
+    app.get("/sitemap.xml", (_req, res) => {
+      res.type("application/xml").send(
+        '<?xml version="1.0" encoding="UTF-8"?>\n<!-- Sitemap is generated by the production server from the route manifest. -->\n<!-- Run jay-stack build && jay-stack serve to see the full sitemap. -->\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" />\n'
+      );
+    });
+  }
   if (fs.existsSync(publicPath)) {
     app.use(express.static(publicPath));
   } else {
@@ -264,9 +277,11 @@ async function resolveProductionContext(projectPath, versionOverride) {
   const resolvedPath = path$1.resolve(projectPath || process.cwd());
   const jayConfigPath = path$1.join(resolvedPath, ".jay");
   let pagesBase = "./src/pages";
+  let siteBaseUrl;
   try {
     const jayConfig = YAML.parse(await fs$1.readFile(jayConfigPath, "utf-8"));
     pagesBase = jayConfig?.devServer?.pagesBase || pagesBase;
+    siteBaseUrl = jayConfig?.site?.baseUrl;
   } catch {
   }
   const version = versionOverride || await resolveVersionFromPackageJson(resolvedPath);
@@ -275,7 +290,8 @@ async function resolveProductionContext(projectPath, versionOverride) {
     pagesRoot: path$1.resolve(resolvedPath, pagesBase),
     buildRoot: path$1.join(resolvedPath, "build"),
     version,
-    tsConfigFilePath: path$1.join(resolvedPath, "tsconfig.json")
+    tsConfigFilePath: path$1.join(resolvedPath, "tsconfig.json"),
+    siteBaseUrl
   };
 }
 async function resolveVersionFromPackageJson(projectRoot) {
@@ -305,7 +321,8 @@ async function runBuild(projectPath, options) {
     buildRoot: ctx.buildRoot,
     concurrency: 4,
     tsConfigFilePath: ctx.tsConfigFilePath,
-    minify: options.minify
+    minify: options.minify,
+    siteBaseUrl: ctx.siteBaseUrl
   });
 }
 async function runServe(projectPath, options) {
@@ -319,7 +336,8 @@ async function runServe(projectPath, options) {
       port: parseInt(options.port, 10),
       projectRoot: ctx.resolvedPath,
       pagesRoot: ctx.pagesRoot,
-      tsConfigFilePath: ctx.tsConfigFilePath
+      tsConfigFilePath: ctx.tsConfigFilePath,
+      siteBaseUrl: ctx.siteBaseUrl
     });
   } else {
     const { startMainServer } = await import("@jay-framework/production-server");
@@ -358,7 +376,8 @@ async function runRebuild(projectPath, options) {
     buildRoot: ctx.buildRoot,
     version: ctx.version,
     target,
-    tsConfigFilePath: ctx.tsConfigFilePath
+    tsConfigFilePath: ctx.tsConfigFilePath,
+    siteBaseUrl: ctx.siteBaseUrl
   });
   if (result.errors.length > 0) {
     for (const err of result.errors) {
@@ -464,17 +483,13 @@ function collectLocalInterfaces(sourceFile) {
 function collectContractImportedTypes(sourceFile) {
   const contractTypes = /* @__PURE__ */ new Set();
   for (const statement of sourceFile.statements) {
-    if (!u.isImportDeclaration(statement))
-      continue;
+    if (!u.isImportDeclaration(statement)) continue;
     const moduleSpecifier = statement.moduleSpecifier;
-    if (!u.isStringLiteral(moduleSpecifier))
-      continue;
+    if (!u.isStringLiteral(moduleSpecifier)) continue;
     const modulePath = moduleSpecifier.text;
-    if (!modulePath.includes(".jay-contract"))
-      continue;
+    if (!modulePath.includes(".jay-contract")) continue;
     const importClause = statement.importClause;
-    if (!importClause)
-      continue;
+    if (!importClause) continue;
     const namedBindings = importClause.namedBindings;
     if (namedBindings && u.isNamedImports(namedBindings)) {
       for (const element of namedBindings.elements) {
@@ -510,8 +525,7 @@ function visitNode(node, result) {
       }
       if (node.arguments.length > 0) {
         const arg = node.arguments[0];
-        if (u.isIdentifier(arg))
-          ;
+        if (u.isIdentifier(arg)) ;
       }
     }
   }
@@ -533,10 +547,8 @@ function extractTypeNames(typeNode) {
   return [];
 }
 function checkPropsConsistency(propsTypeName, localInterfaces, contractImportedTypes, contract, contractName, contractPath, sourcePath, errors, warnings) {
-  if (FRAMEWORK_PROP_TYPES.has(propsTypeName))
-    return;
-  if (contractImportedTypes.has(propsTypeName))
-    return;
+  if (FRAMEWORK_PROP_TYPES.has(propsTypeName)) return;
+  if (contractImportedTypes.has(propsTypeName)) return;
   const prefix = `[${contractName}]`;
   const iface = localInterfaces.get(propsTypeName);
   if (!iface) {
@@ -551,8 +563,7 @@ function checkPropsConsistency(propsTypeName, localInterfaces, contractImportedT
     return;
   }
   const ownProperties = iface.properties;
-  if (ownProperties.length === 0)
-    return;
+  if (ownProperties.length === 0) return;
   if (!contract.props || contract.props.length === 0) {
     errors.push({
       type: "contract-invalid",
@@ -596,10 +607,8 @@ function checkParamsConsistency(paramsTypeNames, localInterfaces, contractImport
       suggestion: `Add a params section to the contract (e.g., params: { slug: string })`
     });
     for (const typeName of paramsTypeNames) {
-      if (FRAMEWORK_PROP_TYPES.has(typeName))
-        continue;
-      if (contractImportedTypes.has(typeName))
-        continue;
+      if (FRAMEWORK_PROP_TYPES.has(typeName)) continue;
+      if (contractImportedTypes.has(typeName)) continue;
       const iface = localInterfaces.get(typeName);
       if (iface) {
         const ownProps = iface.properties;
@@ -612,13 +621,10 @@ function checkParamsConsistency(paramsTypeNames, localInterfaces, contractImport
     return;
   }
   for (const typeName of paramsTypeNames) {
-    if (FRAMEWORK_PROP_TYPES.has(typeName))
-      continue;
-    if (contractImportedTypes.has(typeName))
-      continue;
+    if (FRAMEWORK_PROP_TYPES.has(typeName)) continue;
+    if (contractImportedTypes.has(typeName)) continue;
     const iface = localInterfaces.get(typeName);
-    if (!iface)
-      continue;
+    if (!iface) continue;
     const ownProperties = iface.properties;
     const contractParamNames = new Set(contract.params.map((p) => p.name));
     for (const prop of ownProperties) {
@@ -710,16 +716,13 @@ function requiredString(obj, field, itemPath, errors, code) {
 }
 function optionalString(obj, field) {
   const value = obj[field];
-  if (value === void 0)
-    return void 0;
-  if (typeof value !== "string")
-    return void 0;
+  if (value === void 0) return void 0;
+  if (typeof value !== "string") return void 0;
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : void 0;
 }
 function validateInteraction(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!isRecord$1(raw)) {
     errors.push({
       path: itemPath,
@@ -743,8 +746,7 @@ function validateInteraction(raw, itemPath, errors) {
   };
 }
 function validatePresentation(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!isRecord$1(raw)) {
     errors.push({
       path: itemPath,
@@ -764,14 +766,12 @@ function validatePresentation(raw, itemPath, errors) {
   }
   if (type === "image") {
     const src = requiredString(raw, "src", itemPath, errors, "presentation-missing-src");
-    if (!src)
-      return void 0;
+    if (!src) return void 0;
     return { type: "image", src };
   }
   if (type === "gif") {
     const src = requiredString(raw, "src", itemPath, errors, "presentation-missing-src");
-    if (!src)
-      return void 0;
+    if (!src) return void 0;
     return {
       type: "gif",
       src,
@@ -816,8 +816,7 @@ function validatePresentation(raw, itemPath, errors) {
 }
 const BROWSE_SIZES = /* @__PURE__ */ new Set(["large", "medium", "small"]);
 function validateBrowse(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!isRecord$1(raw)) {
     errors.push({
       path: itemPath,
@@ -841,8 +840,7 @@ function validateBrowse(raw, itemPath, errors) {
   return { size: sizeRaw };
 }
 function validateFolderPath(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!Array.isArray(raw)) {
     errors.push({
       path: `${itemPath}.folderPath`,
@@ -980,8 +978,7 @@ function validateAddMenuCatalogFile(raw, sourcePath) {
   raw.items.forEach((entry, index) => {
     const result = validateAddMenuItem(entry, `${sourcePath}.items[${index}]`);
     errors.push(...result.errors);
-    if (result.item)
-      items.push(result.item);
+    if (result.item) items.push(result.item);
   });
   if (items.length === 0 && errors.length > 0) {
     return { file: null, errors };
@@ -989,11 +986,9 @@ function validateAddMenuCatalogFile(raw, sourcePath) {
   return { file: { items }, errors };
 }
 function normalizeAddMenuPresentation(item) {
-  if (item.presentation)
-    return item.presentation;
+  if (item.presentation) return item.presentation;
   const thumbnail = item.thumbnail?.trim();
-  if (!thumbnail)
-    return void 0;
+  if (!thumbnail) return void 0;
   if (/\.gif$/i.test(thumbnail)) {
     return { type: "gif", src: thumbnail };
   }
@@ -1004,15 +999,12 @@ function normalizeAddMenuBrowseSize(item) {
 }
 function hasSingleRootDiv(html) {
   const trimmed = html.trim();
-  if (!trimmed.startsWith("<div"))
-    return false;
+  if (!trimmed.startsWith("<div")) return false;
   const openMatch = trimmed.match(/^<div\b[^>]*>/i);
-  if (!openMatch)
-    return false;
+  if (!openMatch) return false;
   const afterOpen = trimmed.slice(openMatch[0].length);
   const closeIdx = afterOpen.lastIndexOf("</div>");
-  if (closeIdx < 0)
-    return false;
+  if (closeIdx < 0) return false;
   const tail = afterOpen.slice(closeIdx + "</div>".length).trim();
   return tail.length === 0;
 }
@@ -1088,8 +1080,7 @@ function lintHtmlFragment(item, sourcePath) {
 }
 function lintGifPoster(item, sourcePath) {
   const presentation = normalizeAddMenuPresentation(item);
-  if (presentation?.type !== "gif" || presentation.poster?.trim())
-    return [];
+  if (presentation?.type !== "gif" || presentation.poster?.trim()) return [];
   return [
     catalogWarning(
       "gif-missing-poster",
@@ -1100,10 +1091,8 @@ function lintGifPoster(item, sourcePath) {
   ];
 }
 function lintBrowseLargeWithoutPresentation(item, sourcePath) {
-  if (normalizeAddMenuBrowseSize(item) !== "large")
-    return [];
-  if (normalizeAddMenuPresentation(item))
-    return [];
+  if (normalizeAddMenuBrowseSize(item) !== "large") return [];
+  if (normalizeAddMenuPresentation(item)) return [];
   return [
     catalogWarning(
       "browse-large-without-presentation",
@@ -1176,8 +1165,7 @@ function resolveModulePath$1(basePath) {
   return void 0;
 }
 function collectTypeScriptFiles(dir, depth = 0) {
-  if (depth > 4)
-    return [];
+  if (depth > 4) return [];
   const entries = fs.readdirSync(dir, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
@@ -1196,8 +1184,7 @@ function resolveHandlerSourceFile(pluginPath, handlerRef, isNpmPackage) {
   }
   const searchRoots = isNpmPackage ? [path.join(pluginPath, "lib"), path.join(pluginPath, "dist")] : [pluginPath];
   for (const root of searchRoots) {
-    if (!fs.existsSync(root))
-      continue;
+    if (!fs.existsSync(root)) continue;
     for (const file of collectTypeScriptFiles(root)) {
       const content = fs.readFileSync(file, "utf-8");
       const definesHandler = new RegExp(
@@ -1217,8 +1204,7 @@ function resolveHandlerSourceFile(pluginPath, handlerRef, isNpmPackage) {
       if (reExportMatch) {
         const importSpec = reExportMatch[1].replace(/\.js$/, "");
         const resolved = resolveModulePath$1(path.resolve(path.dirname(file), importSpec));
-        if (resolved)
-          return resolved;
+        if (resolved) return resolved;
       }
     }
   }
@@ -1228,8 +1214,7 @@ function extractBalancedBlock(source, openBraceIndex) {
   let depth = 0;
   for (let index = openBraceIndex; index < source.length; index++) {
     const char = source[index];
-    if (char === "{")
-      depth++;
+    if (char === "{") depth++;
     else if (char === "}") {
       depth--;
       if (depth === 0) {
@@ -1249,8 +1234,7 @@ function findFunctionBodyOpenBrace(source, searchFrom) {
   if (parenMatch?.index !== void 0) {
     candidates.push(searchFrom + parenMatch.index + parenMatch[0].length - 1);
   }
-  if (candidates.length === 0)
-    return -1;
+  if (candidates.length === 0) return -1;
   return Math.min(...candidates);
 }
 function extractFunctionBody(source, functionName) {
@@ -1267,11 +1251,9 @@ function extractFunctionBody(source, functionName) {
   ];
   for (const pattern of patterns) {
     const match = pattern.exec(source);
-    if (!match)
-      continue;
+    if (!match) continue;
     const braceIndex = findFunctionBodyOpenBrace(source, match.index);
-    if (braceIndex === -1)
-      continue;
+    if (braceIndex === -1) continue;
     return extractBalancedBlock(source, braceIndex);
   }
   return null;
@@ -1284,11 +1266,9 @@ function extractDefaultExportFunctionBody(source) {
   ];
   for (const pattern of patterns) {
     const match = pattern.exec(source);
-    if (!match)
-      continue;
+    if (!match) continue;
     const braceIndex = findFunctionBodyOpenBrace(source, match.index);
-    if (braceIndex === -1)
-      continue;
+    if (braceIndex === -1) continue;
     return extractBalancedBlock(source, braceIndex);
   }
   return null;
@@ -1298,8 +1278,7 @@ function handlerBodyWritesAddMenuCatalog(body) {
 }
 function resolveSetupHandlerFunctionBody(pluginPath, handlerRef, isNpmPackage) {
   const sourceFile = resolveHandlerSourceFile(pluginPath, handlerRef, isNpmPackage);
-  if (!sourceFile)
-    return null;
+  if (!sourceFile) return null;
   const source = fs.readFileSync(sourceFile, "utf-8");
   if (isRelativeHandlerRef(handlerRef)) {
     return extractDefaultExportFunctionBody(source) ?? extractFunctionBody(source, "setup") ?? extractFunctionBody(source, handlerRef);
@@ -1307,8 +1286,7 @@ function resolveSetupHandlerFunctionBody(pluginPath, handlerRef, isNpmPackage) {
   return extractFunctionBody(source, handlerRef);
 }
 function suggestionForCode(code) {
-  if (!code)
-    return `See ${CONTRIBUTOR_GUIDE} for schema and validation rules`;
+  if (!code) return `See ${CONTRIBUTOR_GUIDE} for schema and validation rules`;
   return ADD_MENU_VALIDATION_SUGGESTIONS[code] ?? `See ${CONTRIBUTOR_GUIDE} for schema and validation rules`;
 }
 function mapSchemaError$1(error, catalogPath) {
@@ -1338,8 +1316,7 @@ function pluginShipsAddMenuCatalog(context) {
   );
 }
 function validateAddMenuAgentKitHandler(context, result) {
-  if (!pluginShipsAddMenuCatalog(context))
-    return;
+  if (!pluginShipsAddMenuCatalog(context)) return;
   const agentKitHandler = context.manifest.agentkit;
   if (!agentKitHandler) {
     result.warnings.push({
@@ -1351,15 +1328,13 @@ function validateAddMenuAgentKitHandler(context, result) {
     });
   }
   const setupHandler = typeof context.manifest.setup === "string" ? context.manifest.setup : void 0;
-  if (!setupHandler)
-    return;
+  if (!setupHandler) return;
   const setupBody = resolveSetupHandlerFunctionBody(
     context.pluginPath,
     setupHandler,
     context.isNpmPackage
   );
-  if (!setupBody || !handlerBodyWritesAddMenuCatalog(setupBody))
-    return;
+  if (!setupBody || !handlerBodyWritesAddMenuCatalog(setupBody)) return;
   result.warnings.push({
     type: "add-menu-catalog",
     code: "add-menu-legacy-setup-handler",
@@ -1401,8 +1376,7 @@ async function validateAddMenuCatalog(context, result) {
   validateAddMenuAgentKitHandler(context, result);
   for (const relPath of ADD_MENU_CATALOG_REL_PATHS) {
     const catalogPath = path.join(context.pluginPath, relPath);
-    if (!fs.existsSync(catalogPath))
-      continue;
+    if (!fs.existsSync(catalogPath)) continue;
     await validateAddMenuCatalogFileAtPath(catalogPath, relPath, result);
   }
 }
@@ -2026,16 +2000,14 @@ async function validateSchema(context, result) {
 }
 function checkExportExists(exportName, context) {
   const packageJsonPath = path.join(context.pluginPath, "package.json");
-  if (!fs.existsSync(packageJsonPath))
-    return true;
+  if (!fs.existsSync(packageJsonPath)) return true;
   let mainPath;
   try {
     const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
     if (packageJson.exports?.["."]) {
       const entry = packageJson.exports["."];
       const entryPath = typeof entry === "string" ? entry : entry.default || entry.import;
-      if (entryPath)
-        mainPath = path.join(context.pluginPath, entryPath);
+      if (entryPath) mainPath = path.join(context.pluginPath, entryPath);
     }
     if (!mainPath && packageJson.main) {
       mainPath = path.join(context.pluginPath, packageJson.main);
@@ -2043,8 +2015,7 @@ function checkExportExists(exportName, context) {
   } catch {
     return true;
   }
-  if (!mainPath || !fs.existsSync(mainPath))
-    return true;
+  if (!mainPath || !fs.existsSync(mainPath)) return true;
   try {
     const content = fs.readFileSync(mainPath, "utf-8");
     const patterns = [
@@ -2104,8 +2075,7 @@ function resolveContractFile(contractSpec, context) {
             const resolvedPath = typeof exportValue === "string" ? exportValue : exportValue.default || exportValue.import || exportValue.require;
             if (resolvedPath) {
               const fullPath = path.join(context.pluginPath, resolvedPath);
-              if (fs.existsSync(fullPath))
-                return fullPath;
+              if (fs.existsSync(fullPath)) return fullPath;
             }
           }
         }
@@ -2114,8 +2084,7 @@ function resolveContractFile(contractSpec, context) {
     }
     for (const dir of ["dist", "lib", ""]) {
       const candidate = path.join(context.pluginPath, dir, contractSpec);
-      if (fs.existsSync(candidate))
-        return candidate;
+      if (fs.existsSync(candidate)) return candidate;
     }
     return void 0;
   } else {
@@ -2203,8 +2172,7 @@ function hasExportModifier(node) {
 function resolveModulePath(basePath) {
   for (const ext of ["", ".ts", ".js", "/index.ts", "/index.js"]) {
     const candidate = basePath + ext;
-    if (fs.existsSync(candidate))
-      return candidate;
+    if (fs.existsSync(candidate)) return candidate;
   }
   return void 0;
 }
@@ -2214,10 +2182,8 @@ function resolveComponentSourcePath(componentName, context) {
   const entryFile = resolveModulePath(entryBase);
   const libEntryFile = !entryFile ? resolveModulePath(path.join(context.pluginPath, "lib", modulePath)) : void 0;
   const sourceEntry = entryFile || libEntryFile;
-  if (!sourceEntry)
-    return void 0;
-  if (!sourceEntry.endsWith(".ts"))
-    return void 0;
+  if (!sourceEntry) return void 0;
+  if (!sourceEntry.endsWith(".ts")) return void 0;
   let sourceCode;
   try {
     sourceCode = fs.readFileSync(sourceEntry, "utf-8");
@@ -2233,12 +2199,9 @@ function resolveComponentSourcePath(componentName, context) {
   );
   const starReexportModules = [];
   for (const statement of sourceFile.statements) {
-    if (!u.isExportDeclaration(statement))
-      continue;
-    if (!statement.moduleSpecifier)
-      continue;
-    if (!u.isStringLiteral(statement.moduleSpecifier))
-      continue;
+    if (!u.isExportDeclaration(statement)) continue;
+    if (!statement.moduleSpecifier) continue;
+    if (!u.isStringLiteral(statement.moduleSpecifier)) continue;
     const moduleSpec = statement.moduleSpecifier.text;
     const exportClause = statement.exportClause;
     if (!exportClause) {
@@ -2256,12 +2219,10 @@ function resolveComponentSourcePath(componentName, context) {
     }
   }
   for (const moduleSpec of starReexportModules) {
-    if (!moduleSpec.startsWith("."))
-      continue;
+    if (!moduleSpec.startsWith(".")) continue;
     const resolvedBase = path.resolve(path.dirname(sourceEntry), moduleSpec);
     const resolvedPath = resolveModulePath(resolvedBase);
-    if (!resolvedPath || !resolvedPath.endsWith(".ts"))
-      continue;
+    if (!resolvedPath || !resolvedPath.endsWith(".ts")) continue;
     try {
       const modSource = fs.readFileSync(resolvedPath, "utf-8");
       const modFile = u.createSourceFile(
@@ -2294,16 +2255,12 @@ function resolveContractPath(contract, context) {
 }
 async function checkComponentContractConsistency(contract, context, result) {
   const componentName = contract.component;
-  if (!componentName)
-    return;
+  if (!componentName) return;
   const sourcePath = resolveComponentSourcePath(componentName, context);
-  if (!sourcePath)
-    return;
-  if (!sourcePath.endsWith(".ts"))
-    return;
+  if (!sourcePath) return;
+  if (!sourcePath.endsWith(".ts")) return;
   const contractPath = resolveContractPath(contract, context);
-  if (!contractPath)
-    return;
+  if (!contractPath) return;
   let contractContent;
   try {
     contractContent = await fs.promises.readFile(contractPath, "utf-8");
@@ -2311,8 +2268,7 @@ async function checkComponentContractConsistency(contract, context, result) {
     return;
   }
   const parsed = parseContract(contractContent, path.basename(contractPath));
-  if (parsed.validations.length > 0)
-    return;
+  if (parsed.validations.length > 0) return;
   let sourceCode;
   try {
     sourceCode = await fs.promises.readFile(sourcePath, "utf-8");
@@ -2429,10 +2385,99 @@ async function validatePackageJson(context, result) {
     });
   }
 }
+function isBareFunctionExport(exportName, context) {
+  const sourcePath = resolveExportSourceFile(exportName, context);
+  if (!sourcePath) return false;
+  let sourceCode;
+  try {
+    sourceCode = fs.readFileSync(sourcePath, "utf-8");
+  } catch {
+    return false;
+  }
+  const sourceFile = u.createSourceFile(
+    sourcePath,
+    sourceCode,
+    u.ScriptTarget.Latest,
+    true,
+    u.ScriptKind.TS
+  );
+  for (const statement of sourceFile.statements) {
+    if (u.isFunctionDeclaration(statement) && hasExportModifier(statement) && statement.name?.text === exportName) {
+      return true;
+    }
+  }
+  return false;
+}
+function resolveModulePathWithJsToTs(basePath) {
+  const result = resolveModulePath(basePath);
+  if (result) return result;
+  if (basePath.endsWith(".js")) {
+    return resolveModulePath(basePath.slice(0, -3) + ".ts");
+  }
+  return void 0;
+}
+function resolveExportSourceFile(exportName, context) {
+  const modulePath = context.manifest.module || "index";
+  const entryBase = path.join(context.pluginPath, modulePath);
+  const libEntryBase = path.join(context.pluginPath, "lib", modulePath);
+  const sourceEntry = resolveModulePath(entryBase) || resolveModulePath(libEntryBase);
+  if (!sourceEntry || !sourceEntry.endsWith(".ts")) return void 0;
+  return followExportChain(exportName, sourceEntry);
+}
+function followExportChain(exportName, filePath) {
+  let sourceCode;
+  try {
+    sourceCode = fs.readFileSync(filePath, "utf-8");
+  } catch {
+    return void 0;
+  }
+  const sourceFile = u.createSourceFile(
+    filePath,
+    sourceCode,
+    u.ScriptTarget.Latest,
+    true,
+    u.ScriptKind.TS
+  );
+  const starReexportModules = [];
+  for (const statement of sourceFile.statements) {
+    if (u.isExportDeclaration(statement) && statement.moduleSpecifier) {
+      if (!u.isStringLiteral(statement.moduleSpecifier)) continue;
+      const moduleSpec = statement.moduleSpecifier.text;
+      if (!statement.exportClause) {
+        starReexportModules.push(moduleSpec);
+        continue;
+      }
+      if (u.isNamedExports(statement.exportClause)) {
+        for (const element of statement.exportClause.elements) {
+          if (element.name.text === exportName) {
+            const resolvedBase = path.resolve(path.dirname(filePath), moduleSpec);
+            return resolveModulePathWithJsToTs(resolvedBase);
+          }
+        }
+      }
+    }
+    if (u.isFunctionDeclaration(statement) && hasExportModifier(statement)) {
+      if (statement.name?.text === exportName) return filePath;
+    }
+    if (u.isVariableStatement(statement) && hasExportModifier(statement)) {
+      for (const decl of statement.declarationList.declarations) {
+        if (u.isIdentifier(decl.name) && decl.name.text === exportName) return filePath;
+      }
+    }
+  }
+  for (const moduleSpec of starReexportModules) {
+    if (!moduleSpec.startsWith(".")) continue;
+    const resolvedBase = path.resolve(path.dirname(filePath), moduleSpec);
+    const resolved = resolveModulePathWithJsToTs(resolvedBase);
+    if (!resolved) continue;
+    const found = followExportChain(exportName, resolved);
+    if (found) return found;
+  }
+  return void 0;
+}
 async function validateDynamicContracts(context, result) {
   const { dynamic_contracts } = context.manifest;
-  if (!dynamic_contracts)
-    return;
+  if (!dynamic_contracts) return;
   const dynamicConfigs = Array.isArray(dynamic_contracts) ? dynamic_contracts : [dynamic_contracts];
   for (const config of dynamicConfigs) {
     const prefix = config.prefix || "(unknown)";
@@ -2456,6 +2501,13 @@ async function validateDynamicContracts(context, result) {
             suggestion: `Create generator file at ${generatorPath}.ts`
           });
         }
+      } else if (isBareFunctionExport(config.generator, context)) {
+        result.errors.push({
+          type: "export-mismatch",
+          message: `Generator "${config.generator}" for ${prefix} is a bare function — it must be a DynamicContractGenerator object`,
+          location: "plugin.yaml dynamic_contracts",
+          suggestion: `Use makeContractGenerator().generateWith(...) from @jay-framework/fullstack-component instead of exporting a plain function`
+        });
       }
     }
     if (config.component) {
@@ -2511,8 +2563,7 @@ function extractExpressions(text) {
 function extractTagPath(expr) {
   let cleaned = expr.replace(/^!/, "").trim();
   cleaned = cleaned.split(/\s*[!=]==?\s*/)[0].trim();
-  if (cleaned === "." || cleaned === "")
-    return null;
+  if (cleaned === "." || cleaned === "") return null;
   if (/^[a-zA-Z_$][a-zA-Z0-9_$]*(\.[a-zA-Z_$][a-zA-Z0-9_$]*)*$/.test(cleaned)) {
     return cleaned;
   }
@@ -2611,8 +2662,7 @@ function collectUsedTags(jayHtml) {
     const ifVal = element.getAttribute?.("if");
     if (ifVal) {
       const ifPath = extractTagPath(ifVal);
-      if (ifPath)
-        resolvePath(ifPath, scopes);
+      if (ifPath) resolvePath(ifPath, scopes);
     }
     const refVal = element.getAttribute?.("ref");
     if (refVal) {
@@ -2620,12 +2670,10 @@ function collectUsedTags(jayHtml) {
     }
     const attrs = element.attributes ?? {};
     for (const [name, value] of Object.entries(attrs)) {
-      if (SKIP_ATTRS.has(name))
-        continue;
+      if (SKIP_ATTRS.has(name)) continue;
       for (const expr of extractExpressions(value)) {
         const p = extractTagPath(expr);
-        if (p)
-          resolvePath(p, scopes);
+        if (p) resolvePath(p, scopes);
       }
     }
     for (const child of element.childNodes ?? []) {
@@ -2633,8 +2681,7 @@ function collectUsedTags(jayHtml) {
         const text = child.rawText ?? child.text ?? "";
         for (const expr of extractExpressions(text)) {
           const p = extractTagPath(expr);
-          if (p)
-            resolvePath(p, childScopes);
+          if (p) resolvePath(p, childScopes);
         }
       } else if (child.nodeType === 1) {
         walkElement(child, childScopes);
@@ -2647,14 +2694,12 @@ function collectUsedTags(jayHtml) {
 function analyzeTagCoverage(jayHtml, file) {
   const imports = jayHtml.headlessImports;
   const withContracts = imports.filter((imp) => imp.contract);
-  if (withContracts.length === 0)
-    return null;
+  if (withContracts.length === 0) return null;
   const usedTagsMap = collectUsedTags(jayHtml);
   const contracts = [];
   for (let i = 0; i < imports.length; i++) {
     const imp = imports[i];
-    if (!imp.contract)
-      continue;
+    if (!imp.contract) continue;
     const allTags = flattenContractTags(imp.contract.tags);
     const usedSet = usedTagsMap.get(i) ?? /* @__PURE__ */ new Set();
     const expanded = new Set(usedSet);
@@ -2683,12 +2728,9 @@ function resolveContractTag(contract, tagPath) {
   let tags = contract.tags;
   for (let i = 0; i < segments.length; i++) {
     const tag = tags.find((t) => t.tag === segments[i]);
-    if (!tag)
-      return void 0;
-    if (i === segments.length - 1)
-      return tag;
-    if (!tag.tags)
-      return void 0;
+    if (!tag) return void 0;
+    if (i === segments.length - 1) return tag;
+    if (!tag.tags) return void 0;
     tags = tag.tags;
   }
   return void 0;
@@ -2720,17 +2762,13 @@ function checkRefElementTypes(jayHtml, file) {
       importIndex = scope.importIndex;
       tagPath = scope.prefix ? `${scope.prefix}.${refPath}` : refPath;
     }
-    if (importIndex === void 0)
-      return;
+    if (importIndex === void 0) return;
     const imp = imports[importIndex];
-    if (!imp.contract)
-      return;
+    if (!imp.contract) return;
     const contractTag = resolveContractTag(imp.contract, tagPath);
-    if (!contractTag || !contractTag.elementType)
-      return;
+    if (!contractTag || !contractTag.elementType) return;
     const contractTypes = contractTag.elementType;
-    if (contractTypes.includes("HTMLElement"))
-      return;
+    if (contractTypes.includes("HTMLElement")) return;
     if (!contractTypes.includes(ref.actualType)) {
       const label = imp.key ? `${imp.key}.${tagPath}` : tagPath;
       warnings.push(
@@ -2799,6 +2837,65 @@ function checkRefElementTypes(jayHtml, file) {
   walkElement(jayHtml.body, []);
   return warnings;
 }
+function checkPageComponentExport(jayHtmlPath) {
+  const dirname = path.dirname(jayHtmlPath);
+  const compPath = path.join(dirname, "page.ts");
+  if (!fs.existsSync(compPath)) return null;
+  let content;
+  try {
+    content = fs.readFileSync(compPath, "utf-8");
+  } catch {
+    return null;
+  }
+  const exportName = "page";
+  const patterns = [
+    new RegExp(`export\\s*\\{[^}]*\\b${exportName}\\b[^}]*\\}`, "m"),
+    new RegExp(`export\\s+(?:async\\s+)?function\\s+${exportName}\\b`),
+    new RegExp(`export\\s+(?:const|let|var)\\s+${exportName}\\b`)
+  ];
+  if (patterns.some((p) => p.test(content))) return null;
+  return `${path.relative(dirname, compPath)} exists but does not export "${exportName}". Remove the file or add the export.`;
+}
+const DOCUMENT_ACCESS_PATTERNS = [
+  /document\.getElementById\b/,
+  /document\.querySelector\b/,
+  /document\.querySelectorAll\b/,
+  /document\.getElementsBy\w+/,
+  /document\.createElement\b/,
+  /document\.body\.appendChild\b/,
+  /document\.addEventListener\b/
+];
+const DOM_SUPPRESS_COMMENT = "jay-dom: allow";
+function checkDirectDocumentAccess(jayHtmlPath) {
+  const dirname = path.dirname(jayHtmlPath);
+  const basename = path.basename(jayHtmlPath, JAY_EXTENSION);
+  const candidates = [path.join(dirname, `${basename}.ts`), path.join(dirname, "page.ts")];
+  const compPath = candidates.find((p) => fs.existsSync(p));
+  if (!compPath) return [];
+  const compName = path.basename(compPath);
+  let content;
+  try {
+    content = fs.readFileSync(compPath, "utf-8");
+  } catch {
+    return [];
+  }
+  const warnings = [];
+  const lines = content.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.includes(DOM_SUPPRESS_COMMENT)) continue;
+    for (const pattern of DOCUMENT_ACCESS_PATTERNS) {
+      const match = pattern.exec(line);
+      if (match) {
+        warnings.push(
+          `${compName}:${i + 1} — Direct DOM access "${match[0]}" — use Jay refs instead. Suppress with // ${DOM_SUPPRESS_COMMENT} on the same line. See agent-kit/developer/component-refs.md`
+        );
+        break;
+      }
+    }
+  }
+  return warnings;
+}
 const PARSE_PARAM = /^\[(\[)?(\.\.\.)?([^\]]+)\]?\]$/;
 function extractRouteParams(filePath, pagesBase) {
   const relative = path.relative(pagesBase, filePath);
@@ -2840,8 +2937,7 @@ function checkRouteParams(parsedFile, filePath, pagesBase) {
       collectParams(imp.contract.params);
     }
   }
-  if (requiredParams.size === 0)
-    return [];
+  if (requiredParams.size === 0) return [];
   const routeParams = extractRouteParams(filePath, pagesBase);
   const headlessProps = extractHeadlessPropsParamNames(parsedFile);
   const availableParams = /* @__PURE__ */ new Set([...routeParams, ...headlessProps]);
@@ -2857,11 +2953,9 @@ function checkRouteParams(parsedFile, filePath, pagesBase) {
 }
 function checkRouteToContractParams(parsedFile, filePath, pagesBase) {
   const routeParams = extractRouteParams(filePath, pagesBase);
-  if (routeParams.size === 0)
-    return [];
+  if (routeParams.size === 0) return [];
   const hasAnyContract = !!parsedFile.contract || parsedFile.headlessImports.some((imp) => !!imp.contract);
-  if (!hasAnyContract)
-    return [];
+  if (!hasAnyContract) return [];
   const declaredParams = /* @__PURE__ */ new Set();
   if (parsedFile.contract?.params) {
     for (const p of parsedFile.contract.params) {
@@ -2913,17 +3007,14 @@ function resolveBindingPhase(bindingPath, jayHtml) {
   const keyedImport = jayHtml.headlessImports.find((i) => i.key === root && i.contract);
   if (keyedImport?.contract) {
     const tagPath = segments.slice(1).join(".");
-    if (!tagPath)
-      return void 0;
+    if (!tagPath) return void 0;
     const tag = resolveContractTag(keyedImport.contract, tagPath);
-    if (!tag)
-      return void 0;
+    if (!tag) return void 0;
     return tag.phase || "slow";
   }
   if (jayHtml.contract) {
     const tag = resolveContractTag(jayHtml.contract, bindingPath);
-    if (!tag)
-      return void 0;
+    if (!tag) return void 0;
     return tag.phase || "slow";
   }
   return void 0;
@@ -2974,15 +3065,12 @@ function checkHeadlessInstanceProps(jayHtml, file) {
           }
           for (const contractProp of contract.props) {
             const attrValue = lowerAttrs[contractProp.name.toLowerCase()];
-            if (!attrValue)
-              continue;
+            if (!attrValue) continue;
             const bindingMatch = attrValue.match(/^\{(.+)\}$/);
-            if (!bindingMatch)
-              continue;
+            if (!bindingMatch) continue;
             const bindingPath = bindingMatch[1];
             const sourcePhase = resolveBindingPhase(bindingPath, jayHtml);
-            if (!sourcePhase)
-              continue;
+            if (!sourcePhase) continue;
             const propPhase = contractProp.phase ?? "slow";
             const sourceOrder = PHASE_ORDER[sourcePhase] ?? 0;
             const propOrder = PHASE_ORDER[propPhase] ?? 0;
@@ -3020,8 +3108,7 @@ function resolveLinkedTags(tags, contractDir) {
   });
 }
 function resolveContractLinks(contract, contractPath) {
-  if (!contractPath)
-    return contract;
+  if (!contractPath) return contract;
   const contractDir = path.dirname(contractPath);
   return { ...contract, tags: resolveLinkedTags(contract.tags, contractDir) };
 }
@@ -3029,8 +3116,7 @@ async function runPluginValidators(projectRoot, parsedFiles, errors, warnings) {
   const scannedPlugins = await scanPlugins({ projectRoot, includeDevDeps: true });
   const loadedValidators = [];
   for (const [, plugin] of scannedPlugins) {
-    if (!plugin.manifest.validators)
-      continue;
+    if (!plugin.manifest.validators) continue;
     for (const validatorDef of plugin.manifest.validators) {
       const source = `${plugin.name}/${validatorDef.name}`;
       let validatorFn;
@@ -3232,6 +3318,18 @@ async function validateJayFiles(options = {}) {
           message: '<script type="application/jay-params"> is deprecated. Move the values into the YAML body of the headless component that uses them. See agent-kit/developer/routing.md for details.'
         });
       }
+      const pageExportError = checkPageComponentExport(jayFile);
+      if (pageExportError) {
+        errors.push({
+          file: relativePath,
+          message: pageExportError,
+          stage: "generate"
+        });
+      }
+      const domWarnings = checkDirectDocumentAccess(jayFile);
+      for (const msg of domWarnings) {
+        warnings.push({ file: relativePath, message: msg });
+      }
       const routeParamWarnings = checkRouteParams(parsedFile.val, jayFile, scanDir);
       for (const msg of routeParamWarnings) {
         warnings.push({ file: relativePath, message: msg });
@@ -3296,6 +3394,21 @@ async function validateJayFiles(options = {}) {
       }
     }
   }
+  const robotsTxtPath = path.resolve(projectRoot, "public/robots.txt");
+  if (!fs.existsSync(robotsTxtPath)) {
+    warnings.push({
+      file: "public/robots.txt",
+      message: "public/robots.txt not found — search engines may crawl pages you don't intend to expose.",
+      suggestion: "Create public/robots.txt with: User-agent: *\nAllow: /\nSitemap: https://your-domain.com/sitemap.xml"
+    });
+  }
+  if (!config.site?.baseUrl) {
+    warnings.push({
+      file: ".jay",
+      message: "site.baseUrl not configured — sitemap.xml will not be generated in production.",
+      suggestion: "Add to .jay config: site:\n  baseUrl: https://your-domain.com"
+    });
+  }
   const pluginValidators = await runPluginValidators(projectRoot, parsedFiles, errors, warnings);
   return {
     valid: errors.length === 0,
@@ -3609,8 +3722,7 @@ async function ensureAgentKitDocs(projectRoot, _force, mode) {
   const sharedDirs = ["contracts"];
   for (const dir of sharedDirs) {
     const srcDir = path$1.join(templateDir, dir);
-    if (!fsSync.existsSync(srcDir))
-      continue;
+    if (!fsSync.existsSync(srcDir)) continue;
     await copyDirRecursive(srcDir, path$1.join(agentKitDir, dir));
     getLogger().info(chalk.gray(`   Created agent-kit/${dir}/`));
   }
@@ -3635,8 +3747,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
   const copiedPerRole = /* @__PURE__ */ new Map();
   for (const [, plugin] of plugins) {
     const pluginAgentKitDir = path$1.join(plugin.pluginPath, "agent-kit");
-    if (!fsSync.existsSync(pluginAgentKitDir))
-      continue;
+    if (!fsSync.existsSync(pluginAgentKitDir)) continue;
     for (const role of roles) {
       const roleSourceDir = path$1.join(pluginAgentKitDir, role);
       let files;
@@ -3647,8 +3758,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
       } catch {
         continue;
       }
-      if (files.length === 0)
-        continue;
+      if (files.length === 0) continue;
       const roleOutputDir = path$1.join(agentKitDir, role);
       await fs$1.mkdir(roleOutputDir, { recursive: true });
       for (const filename of files) {
@@ -3671,8 +3781,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
           }
         } catch {
         }
-        if (!copiedPerRole.has(role))
-          copiedPerRole.set(role, []);
+        if (!copiedPerRole.has(role)) copiedPerRole.set(role, []);
         copiedPerRole.get(role).push({ filename, pluginName: plugin.name, description });
         getLogger().info(
           chalk.gray(
@@ -3684,8 +3793,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
   }
   for (const [role, entries] of copiedPerRole) {
     const instructionsPath = path$1.join(agentKitDir, role, "INSTRUCTIONS.md");
-    if (!fsSync.existsSync(instructionsPath))
-      continue;
+    if (!fsSync.existsSync(instructionsPath)) continue;
     const lines = [
       "",
       "## Plugin-Contributed Guides",
@@ -3707,8 +3815,7 @@ async function generatePluginAgentKit(projectRoot, options, initErrors, viteServ
     verbose: options.verbose,
     pluginFilter: options.plugin
   });
-  if (plugins.length === 0)
-    return;
+  if (plugins.length === 0) return;
   const logger = getLogger();
   logger.important("");
   logger.important(chalk.bold("Generating plugin agent-kit data..."));
@@ -3937,20 +4044,17 @@ function createAnswersFilePrompt(answers, pluginName) {
   return {
     async input(options) {
       const value = answers[options.key];
-      if (value !== void 0)
-        return value;
+      if (value !== void 0) return value;
       throw new SetupNeedsAnswerError(pluginName, options.key, "input", options.message);
     },
     async confirm(options) {
       const value = answers[options.key];
-      if (value !== void 0)
-        return value === "true" || value === "yes";
+      if (value !== void 0) return value === "true" || value === "yes";
       throw new SetupNeedsAnswerError(pluginName, options.key, "confirm", options.message);
     },
     async select(options) {
       const value = answers[options.key];
-      if (value !== void 0)
-        return value;
+      if (value !== void 0) return value;
       throw new SetupNeedsAnswerError(
         pluginName,
         options.key,
@@ -4111,12 +4215,9 @@ async function runSetup(pluginFilter, options, projectRoot) {
     }
     await runProjectInit(projectRoot, viteServer);
     const parts = [];
-    if (configured > 0)
-      parts.push(`${configured} configured`);
-    if (needsConfig > 0)
-      parts.push(`${needsConfig} needs config`);
-    if (errors > 0)
-      parts.push(`${errors} error(s)`);
+    if (configured > 0) parts.push(`${configured} configured`);
+    if (needsConfig > 0) parts.push(`${needsConfig} needs config`);
+    if (errors > 0) parts.push(`${errors} error(s)`);
     logger.important(`Setup complete: ${parts.join(", ")}`);
     if (errors > 0) {
       process.exit(1);
@@ -4135,8 +4236,7 @@ async function runSetup(pluginFilter, options, projectRoot) {
 }
 async function initPlugin(pluginName, allPluginsWithInit, viteServer, logger) {
   const pluginInit = allPluginsWithInit.filter((p) => p.name === pluginName);
-  if (pluginInit.length === 0)
-    return;
+  if (pluginInit.length === 0) return;
   const initErrors = await executePluginServerInits(pluginInit, viteServer, false, true);
   if (initErrors.size > 0) {
     for (const [, err] of initErrors) {
@@ -4276,8 +4376,7 @@ function printCommandList(commands) {
   logger.important("\nAvailable plugin commands:\n");
   const byPlugin = /* @__PURE__ */ new Map();
   for (const cmd of commands) {
-    if (!byPlugin.has(cmd.pluginName))
-      byPlugin.set(cmd.pluginName, []);
+    if (!byPlugin.has(cmd.pluginName)) byPlugin.set(cmd.pluginName, []);
     byPlugin.get(cmd.pluginName).push(cmd);
   }
   for (const [pluginName, cmds] of byPlugin) {
@@ -4333,8 +4432,7 @@ program.command("build").description("Build production artifacts").option("-p, -
     await runBuild(options.path, options);
   } catch (error) {
     getLogger().error(chalk.red("Build failed:") + " " + error.message);
-    if (error.stack)
-      getLogger().error(error.stack);
+    if (error.stack) getLogger().error(error.stack);
     process.exit(1);
   }
 });
@@ -4343,8 +4441,7 @@ program.command("serve").description("Start production server").option("-p, --pa
     await runServe(options.path, options);
   } catch (error) {
     getLogger().error(chalk.red("Server failed:") + " " + error.message);
-    if (error.stack)
-      getLogger().error(error.stack);
+    if (error.stack) getLogger().error(error.stack);
     process.exit(1);
   }
 });
@@ -4353,8 +4450,7 @@ program.command("rebuild").description("Rebuild instances by contract, route, or
     await runRebuild(options.path, options);
   } catch (error) {
     getLogger().error(chalk.red("Rebuild failed:") + " " + error.message);
-    if (error.stack)
-      getLogger().error(error.stack);
+    if (error.stack) getLogger().error(error.stack);
     process.exit(1);
   }
 });