@rodyssey/cli 0.3.0 → 0.4.0

package/README.md

@@ -102,7 +102,28 @@ 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
+
+`ro app deploy` prints a post-deploy summary after the deploy succeeds:
+
+- public Rodyssey app URL, e.g. `https://development-app.rodyssey.ai/webapp/<id>`
+- published asset URL for SPA zip deployments
+- registered Dynamic Worker endpoint URLs
+- MCP server endpoint URLs for `api/mcp.ts`
+- cron job names, schedules, enabled state, and script files
+
+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
 

package/dist/cli.js

@@ -2071,7 +2071,7 @@ var {
 // package.json
 var package_default = {
   name: "@rodyssey/cli",
-  version: "0.3.0",
+  version: "0.4.0",
   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,92 @@ 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)
+    return resolve(process.cwd(), manifest);
+  const candidates = [
+    resolve(process.cwd(), "build/client/widgets.manifest.json"),
+    resolve(process.cwd(), "dist/widgets.manifest.json")
+  ];
+  const found = candidates.find((candidate) => existsSync4(candidate));
+  if (!found) {
+    throw new Error("No widget manifest found. Run `bun run build` first or pass --manifest <path>.");
+  }
+  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 webappId = resolveWebappId(options.webappId);
+  if (!options.dryRun)
+    ensureDeployToken(options.env);
+  const manifestPath = resolveManifestPath(options.manifest);
+  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",
@@ -3864,6 +3950,12 @@ var DEPLOY_URLS = {
   staging: "https://staging-cms.rodyssey.ai/api/webapps/deploy",
   production: "https://cms.rodyssey.ai/api/webapps/deploy"
 };
+var WEB_CLIENT_URLS = {
+  local: "http://localhost:5178",
+  development: "https://development-app.rodyssey.ai",
+  staging: "https://staging-app.rodyssey.ai",
+  production: "https://app.rodyssey.ai"
+};
 var BUILD_DIR = "dist";
 var ZIP_FILE = "webapp-build.zip";
 var FULLSTACK_DEPLOY_ENVS = new Set(["development", "staging", "production"]);
@@ -3872,11 +3964,209 @@ var MAX_SIZE_PER_BATCH = 30 * 1024 * 1024;
 function shellQuote(value) {
   return `'${value.replace(/'/g, "'\\''")}'`;
 }
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function pickString2(value) {
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+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];
+  if (!deployUrl) {
+    throw new Error(`Unknown environment "${env}". Available: ${Object.keys(DEPLOY_URLS).join(", ")}`);
+  }
+  if (overrides.host || overrides.port) {
+    const url = new URL(deployUrl);
+    if (overrides.host)
+      url.hostname = overrides.host;
+    if (overrides.port)
+      url.port = String(overrides.port);
+    deployUrl = url.toString().replace(/\/$/, "");
+  }
+  return deployUrl;
+}
+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];
+}
+function buildPublicWebappUrl(env, webappId) {
+  const baseUrl = resolveWebClientBaseUrl(env);
+  if (!baseUrl)
+    return;
+  const url = new URL(`/webapp/${encodeURIComponent(webappId)}`, baseUrl);
+  return url.toString();
+}
+function encodeEndpointPath(endpointPath) {
+  return endpointPath.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
+}
+function buildDynamicEndpointUrl(env, webappId, endpointPath) {
+  const baseUrl = resolveWebClientBaseUrl(env);
+  if (!baseUrl)
+    return;
+  const encodedEndpoint = encodeEndpointPath(endpointPath);
+  const url = new URL(`/api/webapps/${encodeURIComponent(webappId)}/endpoints/${encodedEndpoint}`, baseUrl);
+  return url.toString();
+}
+function normalizeBuildRelativePath(filePath) {
+  return filePath.substring(BUILD_DIR.length + 1).replace(/\\/g, "/");
+}
+function isScriptFile(filePath) {
+  const relativePath = normalizeBuildRelativePath(filePath);
+  if (relativePath === "cron-jobs/cron.config.json")
+    return true;
+  return (relativePath.startsWith("api/") || relativePath.startsWith("cron-jobs/")) && relativePath.endsWith(".js");
+}
+function isMcpEndpoint(endpointPath) {
+  const segments = endpointPath.split("/").filter(Boolean);
+  return segments[segments.length - 1]?.toLowerCase() === "mcp";
+}
+function resolveCronScriptCode(payload, scriptName) {
+  const scriptNameKey = scriptName.replace(/\.js$/, "");
+  return payload.cron[scriptNameKey] || payload.cron[scriptName];
+}
+function readCronConfig(filePath, content) {
+  const parsed = JSON.parse(content);
+  if (!isRecord(parsed)) {
+    throw new Error(`Cron config must be a JSON object: ${filePath}`);
+  }
+  const jobs = parsed.jobs;
+  if (jobs !== undefined && !Array.isArray(jobs)) {
+    throw new Error(`Cron config jobs must be an array: ${filePath}`);
+  }
+  return parsed;
+}
+function collectScripts(scriptFiles) {
+  const payload = { api: {}, cron: {}, cronConfig: null };
+  const summary = { apiEndpoints: [], cronJobs: [], mcpEndpoints: [] };
+  for (const filePath of scriptFiles) {
+    const content = readFileSync4(filePath, "utf-8");
+    const relativePath = normalizeBuildRelativePath(filePath);
+    if (relativePath === "cron-jobs/cron.config.json") {
+      payload.cronConfig = readCronConfig(filePath, content);
+      summary.cronJobs = payload.cronConfig.jobs ?? [];
+    } else if (relativePath.startsWith("api/")) {
+      const endpoint = relativePath.substring(4, relativePath.lastIndexOf(".js"));
+      payload.api[endpoint] = content;
+      summary.apiEndpoints.push(endpoint);
+      if (isMcpEndpoint(endpoint)) {
+        summary.mcpEndpoints.push(endpoint);
+      }
+    } else if (relativePath.startsWith("cron-jobs/")) {
+      const scriptName = relativePath.substring(10);
+      payload.cron[scriptName] = content;
+    }
+  }
+  summary.cronJobs = summary.cronJobs.filter((job) => {
+    const hasScriptCode = !!resolveCronScriptCode(payload, job.script);
+    if (!hasScriptCode) {
+      console.warn(`⚠️ Cron job "${job.name}" references missing script "${job.script}" and will not be registered.`);
+    }
+    return hasScriptCode;
+  });
+  return { payload, summary };
+}
+function extractDeploymentWebapp(result) {
+  if (!isRecord(result) || !isRecord(result.webapp))
+    return {};
+  return {
+    id: pickString2(result.webapp.id),
+    title: pickString2(result.webapp.title),
+    appUrl: pickString2(result.webapp.appUrl)
+  };
+}
+function printScriptsSetupCounts(result) {
+  if (!isRecord(result))
+    return;
+  const parts = [
+    ["API registered", pickNumber(result.apiCreated)],
+    ["API deleted", pickNumber(result.apiDeleted)],
+    ["Cron registered", pickNumber(result.cronCreated)],
+    ["Cron deleted", pickNumber(result.cronDeleted)],
+    ["Cache invalidated", pickNumber(result.cacheInvalidated)]
+  ].filter((entry) => entry[1] !== undefined).map(([label, count]) => `${label}: ${count}`);
+  if (parts.length > 0) {
+    console.log(`   ${parts.join(" · ")}`);
+  }
+}
+function printPostDeploySummary(options) {
+  const webapp = extractDeploymentWebapp(options.deploymentResult);
+  const webappId = webapp.id || process.env.WEBAPP_ID;
+  console.log(`
+\uD83D\uDD17 Deployment URLs`);
+  if (webappId) {
+    const appUrl = buildPublicWebappUrl(options.env, webappId);
+    if (appUrl) {
+      console.log(`App URL: ${appUrl}`);
+    }
+  } else {
+    console.log("App URL: unavailable (WEBAPP_ID was not found)");
+  }
+  if (webapp.appUrl) {
+    console.log(`Published asset URL: ${webapp.appUrl}`);
+  }
+  if (options.scriptsSummary.apiEndpoints.length > 0) {
+    console.log(`
+\uD83C\uDF10 Dynamic endpoints`);
+    for (const endpoint of options.scriptsSummary.apiEndpoints) {
+      const url = webappId ? buildDynamicEndpointUrl(options.env, webappId, endpoint) : undefined;
+      console.log(`- ${endpoint}${url ? `: ${url}` : ""}`);
+    }
+  }
+  if (options.scriptsSummary.mcpEndpoints.length > 0) {
+    console.log(`
+\uD83E\uDDE9 MCP server URLs`);
+    for (const endpoint of options.scriptsSummary.mcpEndpoints) {
+      const url = webappId ? buildDynamicEndpointUrl(options.env, webappId, endpoint) : undefined;
+      console.log(`- ${endpoint}${url ? `: ${url}` : ""}`);
+    }
+  }
+  if (options.scriptsSummary.cronJobs.length > 0) {
+    console.log(`
+⏱️  Cron jobs`);
+    for (const job of options.scriptsSummary.cronJobs) {
+      const status = job.enabled === false ? "disabled" : "enabled";
+      console.log(`- ${job.name}: ${job.schedule} (${status}, ${job.script})`);
+    }
+  }
+}
+async function syncScripts(deployUrl, scriptFiles, stepLabel) {
+  const { payload, summary } = collectScripts(scriptFiles);
+  if (scriptFiles.length === 0) {
+    console.log(`\uD83D\uDCDC ${stepLabel}: No scripts found to sync.`);
+    return { summary, result: undefined };
+  }
+  console.log(`\uD83D\uDCDC ${stepLabel}: Registering ${scriptFiles.length} scripts (APIs & Crons)...`);
+  const scriptsUrl = resolveScriptsSetupUrl(deployUrl);
+  const response = await fetch(scriptsUrl, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${process.env.DEPLOY_TOKEN}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(payload)
+  });
+  const result = await readResponsePayload(response);
+  if (!response.ok) {
+    throw new Error(`Scripts setup failed: ${response.status} ${response.statusText}
+${JSON.stringify(result, null, 2)}`);
+  }
+  console.log("✅ Scripts registered successfully");
+  printScriptsSetupCounts(result);
+  return { summary, result };
 }
 function getAllFiles(dirPath, arrayOfFiles = []) {
-  if (!existsSync4(dirPath))
+  if (!existsSync5(dirPath))
     return arrayOfFiles;
   const files = readdirSync(dirPath);
   files.forEach(function(f) {
@@ -3890,7 +4180,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) {
@@ -3911,6 +4201,7 @@ async function deployFullstack(env, overrides) {
     ...process.env,
     CLOUDFLARE_ENV: env
   };
+  const deployUrl = resolveDeployUrl(env, overrides);
   console.log(`\uD83D\uDE80 Starting fullstack deployment process for [${env}] environment...
 `);
   console.log("\uD83D\uDCE6 Step 1: Building the fullstack webapp...");
@@ -3923,30 +4214,22 @@ 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");
+  printPostDeploySummary({
+    env,
+    scriptsSummary: scriptsSync.summary
+  });
   console.log(`
 ✨ Fullstack deployment successful!`);
 }
 async function deploySpa(env, overrides) {
-  let DEPLOY_URL = DEPLOY_URLS[env];
-  if (!DEPLOY_URL) {
-    console.error(`❌ Unknown environment "${env}". Available: ${Object.keys(DEPLOY_URLS).join(", ")}`);
-    process.exit(1);
-  }
-  if (overrides.host || overrides.port) {
-    const url = new URL(DEPLOY_URL);
-    if (overrides.host)
-      url.hostname = overrides.host;
-    if (overrides.port)
-      url.port = String(overrides.port);
-    DEPLOY_URL = url.toString().replace(/\/$/, "");
-  }
+  const DEPLOY_URL = resolveDeployUrl(env, overrides);
   const ASSETS_URL = DEPLOY_URL.replace("/webapps/deploy", "/webapps/assets");
   console.log(`\uD83D\uDE80 Starting deployment process for [${env}] environment...
 `);
@@ -3964,7 +4247,7 @@ async function deploySpa(env, overrides) {
 `);
   const allFiles = getAllFiles(BUILD_DIR);
   const htmlFiles = allFiles.filter((f) => f.endsWith(".html"));
-  const scriptFiles = allFiles.filter((f) => f.includes("/api/") || f.includes("/cron-jobs/") || f.endsWith("cron.config.json"));
+  const scriptFiles = allFiles.filter(isScriptFile);
   const heavyFiles = allFiles.filter((f) => !f.endsWith(".html") && !scriptFiles.includes(f));
   console.log(`\uD83D\uDCE4 Step 2: Uploading ${heavyFiles.length} heavy assets...`);
   if (heavyFiles.length > 0) {
@@ -4012,42 +4295,7 @@ ${errorText}`);
     console.log("✅ No heavy assets to upload");
   }
   console.log();
-  if (scriptFiles.length > 0) {
-    console.log(`\uD83D\uDCDC Step 3: Setting up ${scriptFiles.length} scripts (APIs & Crons)...`);
-    const scriptsPayload = { api: {}, cron: {}, cronConfig: null };
-    for (const f of scriptFiles) {
-      const content = readFileSync3(f, "utf-8");
-      const relativePath = f.substring(BUILD_DIR.length + 1).replace(/\\/g, "/");
-      if (relativePath === "cron-jobs/cron.config.json") {
-        scriptsPayload.cronConfig = JSON.parse(content);
-      } else if (relativePath.startsWith("api/")) {
-        const endpoint = relativePath.substring(4, relativePath.lastIndexOf(".js"));
-        scriptsPayload.api[endpoint] = content;
-      } else if (relativePath.startsWith("cron-jobs/")) {
-        const scriptName = relativePath.substring(10);
-        scriptsPayload.cron[scriptName] = content;
-      }
-    }
-    const scriptsUrl = DEPLOY_URL.replace("/webapps/deploy", "/webapps/scripts-setup");
-    const response = await fetch(scriptsUrl, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${process.env.DEPLOY_TOKEN}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(scriptsPayload)
-    });
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`Scripts setup failed: ${response.status} ${response.statusText}
-${errorText}`);
-    }
-    console.log(`✅ Scripts synced successfully`);
-  } else {
-    console.log(`\uD83D\uDCDC Step 3: No scripts found to sync.`);
-  }
-  console.log();
-  console.log(`\uD83D\uDDDC️  Step 4: Zipping ${htmlFiles.length} HTML files...`);
+  console.log(`\uD83D\uDDDC️  Step 3: Zipping ${htmlFiles.length} HTML files...`);
   if (htmlFiles.length === 0) {
     console.warn("⚠️ No HTML files found to zip! Deployment might fail if CMS expects an HTML file.");
   }
@@ -4055,8 +4303,8 @@ ${errorText}`);
   execSync2(`cd ${BUILD_DIR} && zip ../${ZIP_FILE} ${relativeHtmlFiles.join(" ")}`, { stdio: "inherit" });
   console.log(`✅ Created ${ZIP_FILE}
 `);
-  console.log("☁️  Step 5: Deploying HTML zip to server...");
-  const zipBuffer = readFileSync3(ZIP_FILE);
+  console.log("☁️  Step 4: Deploying HTML zip to server...");
+  const zipBuffer = readFileSync4(ZIP_FILE);
   try {
     const response = await fetch(DEPLOY_URL, {
       method: "POST",
@@ -4071,15 +4319,22 @@ ${errorText}`);
       throw new Error(`Deploy failed: ${response.status} ${response.statusText}
 ${errorText}`);
     }
-    const result = await response.json();
+    const result = await readResponsePayload(response);
     console.log("✅ Deploy completed");
     console.log(`
 \uD83D\uDCCB Deployment result:`, result);
+    console.log();
+    const scriptsSync = await syncScripts(DEPLOY_URL, scriptFiles, "Step 5");
+    printPostDeploySummary({
+      env,
+      deploymentResult: result,
+      scriptsSummary: scriptsSync.summary
+    });
   } catch (error) {
     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}`);
@@ -4098,8 +4353,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;
@@ -4120,8 +4375,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) {
@@ -4316,7 +4571,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}`);
@@ -4412,21 +4667,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)) {
@@ -4446,12 +4701,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);
@@ -4480,7 +4735,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.");
@@ -4488,7 +4743,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.");
@@ -4500,12 +4755,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, {
@@ -4524,7 +4779,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;
@@ -4546,7 +4801,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.");
@@ -4555,7 +4810,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}`);
@@ -4599,7 +4854,7 @@ var PROD_ENV_FILE = ".env.production";
 function isObject3(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
-function pickString2(...values) {
+function pickString3(...values) {
   return values.find((value) => typeof value === "string" && value.length > 0);
 }
 function nestedObject2(value, key) {
@@ -4610,7 +4865,7 @@ function nestedObject2(value, key) {
 }
 function extractDeployToken2(payload) {
   const webapp = nestedObject2(payload, "webapp");
-  return pickString2(webapp?.deployToken, webapp?.deploymentToken);
+  return pickString3(webapp?.deployToken, webapp?.deploymentToken);
 }
 function unwrapSourceDetails(payload) {
   if (!isObject3(payload))
@@ -4621,8 +4876,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)) {
@@ -4711,9 +4966,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);
@@ -4797,10 +5052,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",
@@ -4836,6 +5092,7 @@ var TEMPLATES = {
     ]
   },
   "webapp-fullstack": {
+    key: "webapp-fullstack",
     name: "webapp (Fullstack)",
     repo: "https://github.com/airconcepts/webapp-template-fullstack.git",
     remoteName: "template",
@@ -4850,20 +5107,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"];
@@ -4872,26 +5140,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
@@ -4901,6 +5207,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";
@@ -4916,7 +5289,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 });
@@ -4949,7 +5322,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 });
@@ -4965,7 +5338,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);
@@ -5148,15 +5527,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");
       }
     });
   });
@@ -5237,6 +5616,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.0",
+  "version": "0.4.0",
   "description": "Scaffold new projects from airconcepts templates",
   "repository": {
     "type": "git",