@rodyssey/cli 0.3.1 → 0.4.1

package/README.md

@@ -102,7 +102,10 @@ no identity block stored)`. Re-running `ro auth login -e <env>` refreshes them.
 
 `app upgrade-template` backfills additive template files that are missing from
 older projects. This includes the Dynamic Worker MCP sample endpoint and the
-shared `mcp/` helper folder; existing local MCP files are left untouched.
+shared `mcp/` helper folder; existing local MCP files are left untouched. It
+also force-overwrites a whitelist of CLI/template-owned `package.json` scripts
+such as `deploy`, `deploy:staging`, `deploy:production`, and
+`sync-widget-manifest`.
 
 ## Deployment Output
 
@@ -118,6 +121,10 @@ SPA deploys register built `dist/api/*` and `dist/cron-jobs/*` scripts after the
 HTML zip has deployed. Fullstack deploys register the same Dynamic Worker
 scripts after `wrangler deploy` and widget manifest sync.
 
+`ro app sync-widget-manifest` can also be run directly from a fullstack project
+after `bun run build`. It reads `build/client/widgets.manifest.json` by default,
+then PATCHes the CMS webapp config with `details.widgetManifest`.
+
 ## Release
 
 Release automation lives in `.github/workflows/release.yml` and uses Changesets.

package/dist/cli.js

@@ -2071,7 +2071,7 @@ var {
 // package.json
 var package_default = {
   name: "@rodyssey/cli",
-  version: "0.3.1",
+  version: "0.4.1",
   description: "Scaffold new projects from airconcepts templates",
   repository: {
     type: "git",
@@ -2671,7 +2671,7 @@ async function create(projectName, repoUrl, templateName, autoCreate) {
 
 // src/deploy.ts
 import { execSync as execSync2 } from "node:child_process";
-import { existsSync as existsSync4, readFileSync as readFileSync3, readdirSync, statSync, unlinkSync } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4, readdirSync, statSync, unlinkSync } from "node:fs";
 import { join as join2 } from "node:path";
 
 // node_modules/mime/dist/types/other.js
@@ -3857,6 +3857,98 @@ var Mime_default = Mime;
 // node_modules/mime/dist/src/index.js
 var src_default = new Mime_default(standard_default, other_default)._freeze();
 
+// src/sync-widget-manifest.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
+import { resolve } from "node:path";
+var CONFIG_URLS = {
+  local: "http://localhost:5176/api/webapps/config",
+  development: "https://development-cms.rodyssey.ai/api/webapps/config",
+  staging: "https://staging-cms.rodyssey.ai/api/webapps/config",
+  production: "https://cms.rodyssey.ai/api/webapps/config"
+};
+function resolveWidgetConfigUrl(options) {
+  const rawUrl = options.url || process.env.WEBAPP_CONFIG_URL || CONFIG_URLS[options.env];
+  if (!rawUrl) {
+    throw new Error(`Unknown environment "${options.env}". Use one of: ${Object.keys(CONFIG_URLS).join(", ")}, pass --url, or set WEBAPP_CONFIG_URL.`);
+  }
+  const url = new URL(rawUrl);
+  if (options.host)
+    url.hostname = options.host;
+  if (options.port)
+    url.port = String(options.port);
+  return url.toString().replace(/\/$/, "");
+}
+function resolveManifestPath(manifest) {
+  if (manifest) {
+    const manifestPath = resolve(process.cwd(), manifest);
+    if (!existsSync4(manifestPath)) {
+      throw new Error(`Widget manifest not found: ${manifestPath}`);
+    }
+    return manifestPath;
+  }
+  const candidates = [
+    resolve(process.cwd(), "build/client/widgets.manifest.json"),
+    resolve(process.cwd(), "dist/widgets.manifest.json")
+  ];
+  const found = candidates.find((candidate) => existsSync4(candidate));
+  return found;
+}
+function readManifest(path3) {
+  const parsed = JSON.parse(readFileSync3(path3, "utf-8"));
+  if (!Array.isArray(parsed)) {
+    throw new Error(`Widget manifest must be a JSON array: ${path3}`);
+  }
+  return parsed;
+}
+function resolveWebappId(webappId) {
+  const resolved = webappId || process.env.WEBAPP_ID;
+  if (!resolved) {
+    throw new Error("WEBAPP_ID is not set. Add it to .env or pass --webapp-id.");
+  }
+  return resolved;
+}
+function ensureDeployToken(env) {
+  if (process.env.DEPLOY_TOKEN)
+    return;
+  throw new Error(`DEPLOY_TOKEN is not set. Please check your .env or .env.${env} file.`);
+}
+async function syncWidgetManifest(options) {
+  loadEnv(options.env);
+  const manifestPath = resolveManifestPath(options.manifest);
+  if (!manifestPath) {
+    console.log("No widget manifest found; skipping widget manifest sync.");
+    return;
+  }
+  const webappId = resolveWebappId(options.webappId);
+  if (!options.dryRun)
+    ensureDeployToken(options.env);
+  const manifest = readManifest(manifestPath);
+  const payload = { webappId, details: { widgetManifest: manifest } };
+  const configUrl = resolveWidgetConfigUrl(options);
+  console.log(`Syncing ${manifest.length} widget manifest entr${manifest.length === 1 ? "y" : "ies"}`);
+  console.log(`Manifest: ${manifestPath}`);
+  console.log(`Config URL: ${configUrl}`);
+  console.log(`Webapp ID: ${webappId}`);
+  if (options.dryRun) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+  const response = await fetch(configUrl, {
+    method: "PATCH",
+    headers: {
+      Authorization: `Bearer ${process.env.DEPLOY_TOKEN}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(payload)
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Widget manifest sync failed: ${response.status} ${response.statusText}
+${errorText}`);
+  }
+  console.log("Widget manifest synced");
+}
+
 // src/deploy.ts
 var DEPLOY_URLS = {
   local: "http://localhost:5176/api/webapps/deploy",
@@ -3888,7 +3980,7 @@ function pickNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
 function isFullstackProject() {
-  return existsSync4("app") && existsSync4("workers/app.ts") && existsSync4("wrangler.jsonc");
+  return existsSync5("app") && existsSync5("workers/app.ts") && existsSync5("wrangler.jsonc");
 }
 function resolveDeployUrl(env, overrides) {
   let deployUrl = DEPLOY_URLS[env];
@@ -3908,6 +4000,9 @@ function resolveDeployUrl(env, overrides) {
 function resolveScriptsSetupUrl(deployUrl) {
   return deployUrl.replace("/webapps/deploy", "/webapps/scripts-setup");
 }
+function resolveConfigUrlFromDeployUrl(deployUrl) {
+  return deployUrl.replace("/webapps/deploy", "/webapps/config");
+}
 function resolveWebClientBaseUrl(env) {
   return WEB_CLIENT_URLS[env];
 }
@@ -3961,7 +4056,7 @@ function collectScripts(scriptFiles) {
   const payload = { api: {}, cron: {}, cronConfig: null };
   const summary = { apiEndpoints: [], cronJobs: [], mcpEndpoints: [] };
   for (const filePath of scriptFiles) {
-    const content = readFileSync3(filePath, "utf-8");
+    const content = readFileSync4(filePath, "utf-8");
     const relativePath = normalizeBuildRelativePath(filePath);
     if (relativePath === "cron-jobs/cron.config.json") {
       payload.cronConfig = readCronConfig(filePath, content);
@@ -4077,7 +4172,7 @@ ${JSON.stringify(result, null, 2)}`);
   return { summary, result };
 }
 function getAllFiles(dirPath, arrayOfFiles = []) {
-  if (!existsSync4(dirPath))
+  if (!existsSync5(dirPath))
     return arrayOfFiles;
   const files = readdirSync(dirPath);
   files.forEach(function(f) {
@@ -4091,7 +4186,7 @@ function getAllFiles(dirPath, arrayOfFiles = []) {
   return arrayOfFiles;
 }
 function fileToBlob(filePath) {
-  const buffer = readFileSync3(filePath);
+  const buffer = readFileSync4(filePath);
   return new Blob([buffer], { type: src_default.getType(filePath) || "application/octet-stream" });
 }
 async function deployFullstack(env, overrides) {
@@ -4125,13 +4220,10 @@ async function deployFullstack(env, overrides) {
   console.log(`✅ Worker deployed
 `);
   console.log("\uD83D\uDCCB Step 3: Syncing widget manifest to CMS config...");
-  const syncArgs = [
-    "--env",
-    shellQuote(env),
-    ...overrides.host ? ["--host", shellQuote(overrides.host)] : [],
-    ...overrides.port ? ["--port", shellQuote(String(overrides.port))] : []
-  ];
-  execSync2(`bun run sync-widget-manifest -- ${syncArgs.join(" ")}`, { stdio: "inherit", env: childEnv });
+  await syncWidgetManifest({
+    env,
+    url: resolveConfigUrlFromDeployUrl(deployUrl)
+  });
   console.log();
   const scriptFiles = getAllFiles(BUILD_DIR).filter(isScriptFile);
   const scriptsSync = await syncScripts(deployUrl, scriptFiles, "Step 4");
@@ -4218,7 +4310,7 @@ ${errorText}`);
   console.log(`✅ Created ${ZIP_FILE}
 `);
   console.log("☁️  Step 4: Deploying HTML zip to server...");
-  const zipBuffer = readFileSync3(ZIP_FILE);
+  const zipBuffer = readFileSync4(ZIP_FILE);
   try {
     const response = await fetch(DEPLOY_URL, {
       method: "POST",
@@ -4248,7 +4340,7 @@ ${errorText}`);
     console.error("❌ Deploy failed:", error);
     throw error;
   } finally {
-    if (existsSync4(ZIP_FILE)) {
+    if (existsSync5(ZIP_FILE)) {
       unlinkSync(ZIP_FILE);
       console.log(`
 \uD83E\uDDF9 Cleaned up ${ZIP_FILE}`);
@@ -4267,8 +4359,8 @@ async function deploy(env = "development", overrides = {}) {
 }
 
 // src/global-config.ts
-import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
-import { resolve } from "node:path";
+import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { resolve as resolve2 } from "node:path";
 var PROD_ENV = "production";
 function isPlainObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
@@ -4289,8 +4381,8 @@ function applyMergePatch(target, patch) {
 function parseFlag(name, value) {
   if (value === "null")
     return null;
-  const candidatePath = resolve(process.cwd(), value);
-  const raw = existsSync5(candidatePath) ? readFileSync4(candidatePath, "utf-8") : value;
+  const candidatePath = resolve2(process.cwd(), value);
+  const raw = existsSync6(candidatePath) ? readFileSync5(candidatePath, "utf-8") : value;
   try {
     return JSON.parse(raw);
   } catch (error) {
@@ -4485,7 +4577,7 @@ ${pretty(payload)}`);
   }
   const text = pretty(payload);
   if (options.out) {
-    const outPath = resolve(process.cwd(), options.out);
+    const outPath = resolve2(process.cwd(), options.out);
     writeFileSync3(outPath, `${text}
 `, "utf-8");
     console.log(`✅ Wrote global config to ${outPath}`);
@@ -4581,21 +4673,21 @@ async function patchGlobalConfig(options) {
 }
 
 // src/promote.ts
-import { existsSync as existsSync7, readFileSync as readFileSync6 } from "node:fs";
-import { resolve as resolve3 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync7 } from "node:fs";
+import { resolve as resolve4 } from "node:path";
 
 // src/update-webapp-config.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
-import { resolve as resolve2 } from "node:path";
-var CONFIG_URLS = {
+import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { resolve as resolve3 } from "node:path";
+var CONFIG_URLS2 = {
   local: "http://localhost:5176/api/webapps/config",
   development: "https://development-cms.rodyssey.ai/api/webapps/config",
   staging: "https://staging-cms.rodyssey.ai/api/webapps/config",
   production: "https://cms.rodyssey.ai/api/webapps/config"
 };
 function parseJsonOption(value, optionName) {
-  const maybePath = resolve2(process.cwd(), value);
-  const raw = existsSync6(maybePath) ? readFileSync5(maybePath, "utf-8") : value;
+  const maybePath = resolve3(process.cwd(), value);
+  const raw = existsSync7(maybePath) ? readFileSync6(maybePath, "utf-8") : value;
   try {
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -4615,12 +4707,12 @@ function coerceMaybeNull(value) {
   return value;
 }
 function resolveConfigUrl(options, required = true) {
-  const configUrl = options.url || process.env.WEBAPP_CONFIG_URL || CONFIG_URLS[options.env];
+  const configUrl = options.url || process.env.WEBAPP_CONFIG_URL || CONFIG_URLS2[options.env];
   if (!configUrl) {
     if (!required)
       return;
     console.error("❌ Error: no webapp config endpoint configured.");
-    console.error(`\uD83D\uDCA1 Use one of these environments: ${Object.keys(CONFIG_URLS).join(", ")}, pass --url, or set WEBAPP_CONFIG_URL in your .env file.`);
+    console.error(`\uD83D\uDCA1 Use one of these environments: ${Object.keys(CONFIG_URLS2).join(", ")}, pass --url, or set WEBAPP_CONFIG_URL in your .env file.`);
     process.exit(1);
   }
   const url = new URL(configUrl);
@@ -4649,7 +4741,7 @@ function buildDetailsPayload(options) {
   }
   return payload;
 }
-function resolveWebappId(webappId) {
+function resolveWebappId2(webappId) {
   const resolved = webappId || process.env.WEBAPP_ID;
   if (!resolved) {
     console.error("❌ Error: WEBAPP_ID is not set. Pass --webapp-id or set it in your .env file.");
@@ -4657,7 +4749,7 @@ function resolveWebappId(webappId) {
   }
   return resolved;
 }
-function ensureDeployToken(env) {
+function ensureDeployToken2(env) {
   if (process.env.DEPLOY_TOKEN)
     return;
   console.error("❌ Error: DEPLOY_TOKEN is not set in environment variables.");
@@ -4669,12 +4761,12 @@ function getConfigUrl(options, required = true) {
 }
 async function fetchWebappConfig(options) {
   loadEnv(options.env);
-  const webappId = resolveWebappId(options.webappId);
+  const webappId = resolveWebappId2(options.webappId);
   const CONFIG_URL = getConfigUrl(options);
   if (!CONFIG_URL) {
     throw new Error("No webapp config endpoint configured.");
   }
-  ensureDeployToken(options.env);
+  ensureDeployToken2(options.env);
   const url = new URL(CONFIG_URL);
   url.searchParams.set("webappId", webappId);
   const response = await fetch(url, {
@@ -4693,7 +4785,7 @@ ${errorText}`);
 }
 async function getWebappConfig(options) {
   loadEnv(options.env);
-  const webappId = resolveWebappId(options.webappId);
+  const webappId = resolveWebappId2(options.webappId);
   const CONFIG_URL = getConfigUrl(options);
   if (!CONFIG_URL)
     return;
@@ -4715,7 +4807,7 @@ async function getWebappConfig(options) {
 }
 async function updateWebappConfig(options) {
   loadEnv(options.env);
-  const webappId = resolveWebappId(options.webappId);
+  const webappId = resolveWebappId2(options.webappId);
   const details = buildDetailsPayload(options);
   if (Object.keys(details).length === 0) {
     console.error("❌ Error: no detail fields provided. Use --title, --description, --cover-img, --localization, or --details.");
@@ -4724,7 +4816,7 @@ async function updateWebappConfig(options) {
   const payload = { webappId, details };
   const CONFIG_URL = getConfigUrl(options, !options.dryRun);
   if (!options.dryRun)
-    ensureDeployToken(options.env);
+    ensureDeployToken2(options.env);
   console.log(`⚙️ Updating webapp config for [${options.env}] environment...`);
   if (CONFIG_URL) {
     console.log(`\uD83D\uDCCD Config URL: ${CONFIG_URL}`);
@@ -4790,8 +4882,8 @@ function unwrapSourceDetails(payload) {
   return payload;
 }
 function parseDetailsOption(value) {
-  const maybePath = resolve3(process.cwd(), value);
-  const raw = existsSync7(maybePath) ? readFileSync6(maybePath, "utf-8") : value;
+  const maybePath = resolve4(process.cwd(), value);
+  const raw = existsSync8(maybePath) ? readFileSync7(maybePath, "utf-8") : value;
   try {
     const parsed = JSON.parse(raw);
     if (!isObject3(parsed)) {
@@ -4880,9 +4972,9 @@ async function promote(options) {
     console.info("\uD83D\uDCA1 Run `ro app create --auto` first, or set WEBAPP_ID manually.");
     process.exit(1);
   }
-  const prodEnvPath = resolve3(process.cwd(), PROD_ENV_FILE);
-  if (existsSync7(prodEnvPath)) {
-    const content = readFileSync6(prodEnvPath, "utf-8");
+  const prodEnvPath = resolve4(process.cwd(), PROD_ENV_FILE);
+  if (existsSync8(prodEnvPath)) {
+    const content = readFileSync7(prodEnvPath, "utf-8");
     if (/^WEBAPP_ID=.+/m.test(content)) {
       console.error(`❌ Error: ${PROD_ENV_FILE} already has WEBAPP_ID. The app appears to be promoted already.`);
       process.exit(1);
@@ -4966,10 +5058,11 @@ ${JSON.stringify(payload, null, 2)}`);
 
 // src/upgrade-template.ts
 import { execSync as execSync3 } from "node:child_process";
-import { existsSync as existsSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync5, mkdirSync as mkdirSync2, copyFileSync, rmSync as rmSync2 } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync5, mkdirSync as mkdirSync2, copyFileSync, rmSync as rmSync2 } from "node:fs";
 import path3 from "node:path";
 var TEMPLATES = {
   webapp: {
+    key: "webapp",
     name: "webapp (SPA)",
     repo: "https://github.com/airconcepts/webapp-template.git",
     remoteName: "template",
@@ -5005,6 +5098,7 @@ var TEMPLATES = {
     ]
   },
   "webapp-fullstack": {
+    key: "webapp-fullstack",
     name: "webapp (Fullstack)",
     repo: "https://github.com/airconcepts/webapp-template-fullstack.git",
     remoteName: "template",
@@ -5019,20 +5113,31 @@ var TEMPLATES = {
     ]
   }
 };
-var CLI_SCRIPTS = {
+var CLI_SCRIPT_DEFAULTS = {
   "link-game-sdk": "bunx @rodyssey/cli@latest app update-game-sdk",
   deploy: "bunx @rodyssey/cli@latest app deploy",
+  "sync-widget-manifest": "bunx @rodyssey/cli@latest app sync-widget-manifest",
   "get-webapp-config": "bunx @rodyssey/cli@latest app config get",
   "update-webapp-config": "bunx @rodyssey/cli@latest app config set",
   "upgrade-template": "bunx @rodyssey/cli@latest app upgrade-template"
 };
+var FORCE_OVERWRITE_SCRIPT_NAMES = [
+  "link-game-sdk",
+  "deploy",
+  "sync-widget-manifest",
+  "deploy:staging",
+  "deploy:production",
+  "get-webapp-config",
+  "update-webapp-config",
+  "upgrade-template"
+];
 function detectTemplate() {
-  if (existsSync8("app")) {
+  if (existsSync9("app")) {
     console.log(`\uD83D\uDD0D Detected fullstack template (found app/ directory)
 `);
     return TEMPLATES["webapp-fullstack"];
   }
-  if (existsSync8("src")) {
+  if (existsSync9("src")) {
     console.log(`\uD83D\uDD0D Detected SPA template (found src/ directory)
 `);
     return TEMPLATES["webapp"];
@@ -5041,26 +5146,64 @@ function detectTemplate() {
 `);
   return TEMPLATES["webapp"];
 }
-function updatePackageJsonScripts() {
+function normalizeScripts(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[1] === "string"));
+}
+function readTemplatePackageScripts(template) {
+  try {
+    const rawPackageJson = execSync3(`git show ${template.remoteName}/main:package.json`, {
+      encoding: "utf-8"
+    });
+    const packageJson = JSON.parse(rawPackageJson);
+    return normalizeScripts(packageJson.scripts);
+  } catch (error) {
+    console.log(`  ⚠️  Failed to read package.json scripts from template remote: ${error instanceof Error ? error.message : error}`);
+    console.log("  ℹ️  Falling back to built-in CLI script defaults.");
+    return {};
+  }
+}
+function getForcedScriptUpdates(templateScripts) {
+  const normalizedTemplateScripts = normalizeScripts(templateScripts);
+  const updates = {};
+  for (const name of FORCE_OVERWRITE_SCRIPT_NAMES) {
+    const command = normalizedTemplateScripts[name] ?? CLI_SCRIPT_DEFAULTS[name];
+    if (command) {
+      updates[name] = command;
+    }
+  }
+  return updates;
+}
+function applyPackageJsonScriptUpdates(packageJson, scriptUpdates) {
+  if (!packageJson.scripts) {
+    packageJson.scripts = {};
+  }
+  const changes = [];
+  for (const [name, cmd] of Object.entries(scriptUpdates)) {
+    if (packageJson.scripts[name] !== cmd) {
+      const action = packageJson.scripts[name] ? "Updated" : "Added";
+      packageJson.scripts[name] = cmd;
+      changes.push({ name, action });
+    }
+  }
+  return { updated: changes.length > 0, changes };
+}
+function updatePackageJsonScripts(template) {
   const pkgPath = "package.json";
-  if (!existsSync8(pkgPath)) {
+  if (!existsSync9(pkgPath)) {
     console.log("⚠️  No package.json found, skipping scripts update");
     return;
   }
-  const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
-  if (!pkg.scripts) {
-    pkg.scripts = {};
-  }
-  let updated = false;
-  for (const [name, cmd] of Object.entries(CLI_SCRIPTS)) {
-    if (pkg.scripts[name] !== cmd) {
-      const action = pkg.scripts[name] ? "Updated" : "Added";
-      pkg.scripts[name] = cmd;
-      console.log(`  \uD83D\uDCDD ${action} script: "${name}"`);
-      updated = true;
-    }
+  const pkg = JSON.parse(readFileSync8(pkgPath, "utf-8"));
+  const templateScripts = readTemplatePackageScripts(template);
+  const scriptUpdates = getForcedScriptUpdates(templateScripts);
+  const result = applyPackageJsonScriptUpdates(pkg, scriptUpdates);
+  for (const change of result.changes) {
+    console.log(`  \uD83D\uDCDD ${change.action} script: "${change.name}"`);
   }
-  if (updated) {
+  if (result.updated) {
     writeFileSync5(pkgPath, JSON.stringify(pkg, null, 2) + `
 `, "utf-8");
     console.log(`✅ package.json scripts updated
@@ -5070,6 +5213,73 @@ function updatePackageJsonScripts() {
 `);
   }
 }
+var SERVER_SCRIPTS_STEP = "vite build --mode server-scripts";
+var CANONICAL_BUILD_SCRIPT = "tsc -b && vite build && vite build --mode server-scripts && vite build --mode report";
+var VITE_CONFIG_CANDIDATES = ["vite.config.ts", "vite.config.js", "vite.config.mjs"];
+var TEMPLATE_VITE_CONFIG_URL = "https://github.com/airconcepts/webapp-template/blob/main/vite.config.ts";
+function normalizeSegment(segment) {
+  return segment.trim().replace(/\s+/g, " ");
+}
+function ensureServerScriptsStep(buildScript) {
+  const segments = buildScript.split("&&").map(normalizeSegment).filter(Boolean);
+  if (segments.includes(SERVER_SCRIPTS_STEP)) {
+    return { status: "present" };
+  }
+  const bareBuildIndex = segments.indexOf("vite build");
+  if (bareBuildIndex === -1) {
+    return { status: "unsafe" };
+  }
+  const next = [...segments];
+  next.splice(bareBuildIndex + 1, 0, SERVER_SCRIPTS_STEP);
+  return { status: "inserted", script: next.join(" && ") };
+}
+function viteHandlesServerScripts(viteConfigSource) {
+  return viteConfigSource.includes("server-scripts");
+}
+function ensureBuildScript() {
+  const pkgPath = "package.json";
+  if (!existsSync9(pkgPath)) {
+    console.log("  ⚠️  No package.json found, skipping build-script check");
+    return;
+  }
+  const pkg = JSON.parse(readFileSync8(pkgPath, "utf-8"));
+  const buildScript = pkg.scripts?.build;
+  if (typeof buildScript !== "string" || buildScript.trim() === "") {
+    console.log(`  ⚠️  No "build" script found. Add one that runs the server-scripts pass, e.g.:
+` + `      "build": "${CANONICAL_BUILD_SCRIPT}"`);
+    return;
+  }
+  const result = ensureServerScriptsStep(buildScript);
+  if (result.status === "present") {
+    console.log("  ✅ build script already runs the server-scripts pass");
+    return;
+  }
+  if (result.status === "unsafe") {
+    console.log(`  ⚠️  Could not auto-update the build script. Ensure it runs ` + `"vite build --mode server-scripts" after "vite build".
+` + `      Current: ${buildScript}`);
+    return;
+  }
+  pkg.scripts.build = result.script;
+  writeFileSync5(pkgPath, JSON.stringify(pkg, null, 2) + `
+`, "utf-8");
+  console.log(`  \uD83D\uDCDD Added "vite build --mode server-scripts" to the build script`);
+}
+function verifyViteServerScriptsMode() {
+  const configPath2 = VITE_CONFIG_CANDIDATES.find((p) => existsSync9(p));
+  if (!configPath2) {
+    console.log("  ⚠️  No vite.config found. Server scripts in src/api and src/cron-jobs won't be compiled.");
+    return;
+  }
+  const source = readFileSync8(configPath2, "utf-8");
+  if (viteHandlesServerScripts(source)) {
+    console.log(`  ✅ ${configPath2} handles the server-scripts build mode`);
+    return;
+  }
+  console.log(`  ⚠️  ${configPath2} does not handle the "server-scripts" build mode.
+` + `      src/api and src/cron-jobs won't compile into dist/, so "app deploy" will
+` + `      report "No scripts found to sync." Add the server-scripts branch from the template:
+` + `      ${TEMPLATE_VITE_CONFIG_URL}`);
+}
 function updateCliSkill() {
   const cliRemote = "ro-cli";
   const cliRepo = "https://github.com/airconcepts/ro-cli.git";
@@ -5085,7 +5295,7 @@ function updateCliSkill() {
     }
     execSync3(`git fetch ${cliRemote}`, { stdio: "inherit" });
     execSync3(`git checkout ${cliRemote}/main -- skills/ro-cli/SKILL.md`, { stdio: "inherit" });
-    if (existsSync8("skills/ro-cli/SKILL.md")) {
+    if (existsSync9("skills/ro-cli/SKILL.md")) {
       mkdirSync2(".agent/skills/ro-cli", { recursive: true });
       copyFileSync("skills/ro-cli/SKILL.md", ".agent/skills/ro-cli/SKILL.md");
       rmSync2("skills", { recursive: true, force: true });
@@ -5118,7 +5328,7 @@ async function upgradeTemplate() {
     const checkoutList = template.checkoutFiles.join(" ");
     execSync3(`git checkout ${template.remoteName}/main -- ${checkoutList}`, { stdio: "inherit" });
     for (const file of template.newFiles) {
-      if (!existsSync8(file)) {
+      if (!existsSync9(file)) {
         console.log(`\uD83D\uDCC2 Checking out ${file}...`);
         try {
           mkdirSync2(path3.dirname(file), { recursive: true });
@@ -5134,7 +5344,13 @@ async function upgradeTemplate() {
 \uD83D\uDD27 Updating CLI skill documentation...`);
     updateCliSkill();
     console.log("\uD83D\uDCE6 Updating package.json scripts...");
-    updatePackageJsonScripts();
+    updatePackageJsonScripts(template);
+    if (template.key === "webapp") {
+      console.log("\uD83E\uDDE9 Verifying server-scripts build chain...");
+      ensureBuildScript();
+      verifyViteServerScriptsMode();
+      console.log();
+    }
     console.log("✅ Template upgrade complete! Please check git status for changes.");
   } catch (error) {
     console.error("❌ Upgrade failed:", error);
@@ -5317,15 +5533,15 @@ Available templates:
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     rl.question(`Select a template (1-${entries.length}): `, (answer) => {
       rl.close();
       const index = parseInt(answer, 10) - 1;
       if (index >= 0 && index < entries.length) {
-        resolve4(entries[index].name);
+        resolve5(entries[index].name);
       } else {
         console.error("Invalid selection, defaulting to 'webapp'");
-        resolve4("webapp");
+        resolve5("webapp");
       }
     });
   });
@@ -5406,6 +5622,9 @@ app.command("update-game-sdk").description("Download and update the GameSDK libr
 app.command("deploy").description("Build and deploy the webapp to the server").option("-e, --env <environment>", "Target environment (local | development | staging | production)", "development").option("--host <host>", "Override the deploy host").option("--port <port>", "Override the deploy port", parseInt).action(async (options) => {
   await deploy(options.env, { host: options.host, port: options.port });
 });
+app.command("sync-widget-manifest").description("Sync the built widget manifest to the CMS webapp config").option("-e, --env <environment>", "Target environment (local | development | staging | production)", "development").option("--manifest <path>", "Path to widgets.manifest.json. Defaults to build/client/widgets.manifest.json or dist/widgets.manifest.json").option("--url <url>", "Override the config endpoint URL").option("--host <host>", "Override the config endpoint host").option("--port <port>", "Override the config endpoint port", parseInt).option("--webapp-id <id>", "Webapp ID. Defaults to WEBAPP_ID from .env").option("--dry-run", "Print the request payload without sending it").action(async (options) => {
+  await syncWidgetManifest(options);
+});
 var config = app.command("config").description("Manage webapp metadata config");
 addConfigTargetOptions(config.command("get").description("Pull the current webapp metadata config from the CMS").option("--out <file>", "Write the config JSON to a file")).action(async (options) => {
   await getWebappConfig(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rodyssey/cli",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Scaffold new projects from airconcepts templates",
   "repository": {
     "type": "git",