@rodyssey/cli 0.2.1 → 0.3.1

package/README.md

@@ -1,23 +1,123 @@
 # ro-cli
 
-To install dependencies:
+The Rodyssey CLI (`@rodyssey/cli`) — scaffolds, deploys, configures, and ships webapp projects to the rodyssey CMS.
+
+## Installation
+
+The package installs three binaries: `ro` (recommended), `rocli`, and `@rodyssey/cli` (the canonical long form). Pick any.
+
+### Global install (most users)
+
+```bash
+# via Bun
+bun install -g @rodyssey/cli
+
+# via npm
+npm install -g @rodyssey/cli
+
+# verify
+ro --version
+```
+
+### Per-project (no global install)
 
 ```bash
+# Run any time without installing
+bunx @rodyssey/cli@latest auth login -e development
+bunx @rodyssey/cli@latest app create my-app --auto
+```
+
+### Develop against this repo (live-edit the CLI itself)
+
+```bash
+git clone git@github.com:airconcepts/ro-cli.git
+cd ro-cli
 bun install
+bun run build           # produces dist/cli.js with the ro/rocli shebangs
+
+# Register your local checkout as the global `ro` / `rocli` / `@rodyssey/cli`:
+bun link
+
+# Now `ro` everywhere points at this checkout's dist/cli.js
+ro --version            # prints whatever package.json says locally
+
+# When done, unlink to restore the published version:
+bun unlink              # from inside ro-cli/
+bun install -g @rodyssey/cli    # reinstall the published one
 ```
 
-To run:
+If you want to keep **both** the published `ro` and a local-dev version side-by-side without re-linking constantly, add a shell alias for the dev tree:
 
 ```bash
-bun run index.ts
+# in ~/.zshrc or ~/.bashrc
+alias rocli-dev='bun /absolute/path/to/ro-cli/src/cli.ts'
 ```
 
+`rocli-dev` then runs your live TypeScript via Bun (no rebuild needed), while `ro` keeps pointing at the globally-installed published version. The SKILL.md recognizes both names.
+
+## Using with AI agents
+
+The CLI ships with a [SKILL.md](.claude/skills/rodyssey-cli/SKILL.md) that teaches an AI coding agent how to drive `ro` correctly — command map, auth/scope model, deploy-vs-session-token distinction, `app config set` PATCH delta semantics, `global-config` set-vs-patch, and the gotchas that aren't obvious from `--help`.
+
+**To use it in your own project** (assumes Claude Code; adapt the path for other agent frameworks):
+
+```bash
+mkdir -p .claude/skills/rodyssey-cli
+curl -L https://raw.githubusercontent.com/airconcepts/ro-cli/main/.claude/skills/rodyssey-cli/SKILL.md \
+  -o .claude/skills/rodyssey-cli/SKILL.md
+```
+
+Or just copy [`.claude/skills/rodyssey-cli/SKILL.md`](.claude/skills/rodyssey-cli/SKILL.md) verbatim into your project's skills directory. Once loaded, your agent will recognize `ro app *` / `ro auth *` / `ro global-config *` commands, suggest the right subcommand for natural-language requests, and avoid the common footguns (e.g., echoing a `config get` response back into `config set --details` and wiping data).
+
+## Authentication
+
+`ro auth login -e <env>` runs a PKCE browser flow against the CMS. The consent screen
+lets the user authorize the CLI to act as themselves or as a service account they host,
+and pick which scopes to grant. The token is persisted at `~/.rodyssey/config.json`
+under `auth.<env>` along with an `identity` block describing who the token represents.
+
+`ro auth me -e <env>` reads that local session and prints which environment + identity
+is active. Examples:
+
+```
+$ ro auth me -e development
+Environment: development
+CMS URL:     https://development-cms.rodyssey.ai
+Logged in as: alex@example.com
+Granted scopes: webapps:create, webapps:deploy-token:create, cms:global-config:read
+
+$ ro auth me -e development        # after authorizing as a service account
+Environment: development
+CMS URL:     https://development-cms.rodyssey.ai
+Logged in as service account: deploy-bot (id: sa-abc-123)
+Granted scopes: webapps:create, feed:post
+```
+
+Add `--remote` to also call `/api/auth/me` for a freshness check.
+
+Sessions that pre-date the identity-aware flow render as `Logged in (legacy session —
+no identity block stored)`. Re-running `ro auth login -e <env>` refreshes them.
+
 ## Template Upgrade
 
 `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.
 
+## 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.
+
 ## Release
 
 Release automation lives in `.github/workflows/release.yml` and uses Changesets.

package/dist/cli.js

@@ -2071,14 +2071,16 @@ var {
 // package.json
 var package_default = {
   name: "@rodyssey/cli",
-  version: "0.2.1",
+  version: "0.3.1",
   description: "Scaffold new projects from airconcepts templates",
   repository: {
     type: "git",
     url: "git+https://github.com/airconcepts/ro-cli.git"
   },
   bin: {
-    "@rodyssey/cli": "dist/cli.js"
+    "@rodyssey/cli": "dist/cli.js",
+    ro: "dist/cli.js",
+    rocli: "dist/cli.js"
   },
   files: [
     "dist"
@@ -2123,19 +2125,47 @@ var CMS_BASE_URLS = {
   staging: "https://staging-cms.rodyssey.ai",
   production: "https://cms.rodyssey.ai"
 };
-var CONFIG_FILE = join(homedir(), ".rodyssey", "config.json");
+function describeSession(session) {
+  const base = { env: session.env, cmsUrl: session.cmsUrl };
+  if (session.identity?.type === "service-account") {
+    return {
+      ...base,
+      identityLine: `Logged in as service account: ${session.identity.label} (id: ${session.identity.id})`,
+      scopesLine: `Granted scopes: ${session.identity.scopes.join(", ")}`
+    };
+  }
+  if (session.identity?.type === "user") {
+    return {
+      ...base,
+      identityLine: `Logged in as: ${session.identity.label}`,
+      scopesLine: `Granted scopes: ${session.identity.scopes.join(", ")}`
+    };
+  }
+  return {
+    ...base,
+    identityLine: "Logged in (legacy session — no identity block stored)"
+  };
+}
+function configPath() {
+  const override = process.env.RODYSSEY_CONFIG_DIR;
+  if (override)
+    return join(override, "config.json");
+  return join(homedir(), ".rodyssey", "config.json");
+}
 function readConfig() {
-  if (!existsSync(CONFIG_FILE))
+  const file = configPath();
+  if (!existsSync(file))
     return {};
   try {
-    return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+    return JSON.parse(readFileSync(file, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeConfig(config) {
-  mkdirSync(dirname(CONFIG_FILE), { recursive: true });
-  writeFileSync(CONFIG_FILE, `${JSON.stringify(config, null, 2)}
+  const file = configPath();
+  mkdirSync(dirname(file), { recursive: true });
+  writeFileSync(file, `${JSON.stringify(config, null, 2)}
 `, "utf-8");
 }
 function getAuthConfig(config) {
@@ -2167,6 +2197,38 @@ function extractUser(payload) {
     return;
   return payload.user ?? (isObject(payload.data) ? payload.data.user : undefined);
 }
+function parseIdentity(raw) {
+  if (!isObject(raw))
+    return;
+  if (raw.type !== "user" && raw.type !== "service-account")
+    return;
+  if (typeof raw.id !== "string" || typeof raw.label !== "string")
+    return;
+  if (!Array.isArray(raw.scopes) || !raw.scopes.every((s) => typeof s === "string")) {
+    return;
+  }
+  return {
+    type: raw.type,
+    id: raw.id,
+    label: raw.label,
+    scopes: raw.scopes
+  };
+}
+function extractSessionFromTokenResponse(payload, ctx) {
+  const token = extractToken(payload);
+  if (!token) {
+    throw new Error(`CMS token response did not include an auth token:
+${JSON.stringify(payload, null, 2)}`);
+  }
+  const identity = isObject(payload) ? parseIdentity(payload.identity) : undefined;
+  const user = extractUser(payload);
+  const session = { env: ctx.env, cmsUrl: ctx.cmsUrl, token };
+  if (user !== undefined)
+    session.user = user;
+  if (identity)
+    session.identity = identity;
+  return session;
+}
 async function readResponsePayload(response) {
   const text = await response.text();
   if (!text)
@@ -2365,17 +2427,7 @@ ${authorizationUrl.toString()}
     throw new Error(`CMS token exchange failed: ${response.status} ${response.statusText}
 ${JSON.stringify(payload, null, 2)}`);
   }
-  const token = extractToken(payload);
-  if (!token) {
-    throw new Error(`CMS token response did not include an auth token:
-${JSON.stringify(payload, null, 2)}`);
-  }
-  const session = {
-    env: options.env,
-    cmsUrl,
-    token,
-    user: extractUser(payload)
-  };
+  const session = extractSessionFromTokenResponse(payload, { env: options.env, cmsUrl });
   if (options.persist !== false) {
     storeSession(session);
   }
@@ -2383,18 +2435,25 @@ ${JSON.stringify(payload, null, 2)}`);
 }
 async function me(options) {
   const storedSession = getStoredSession(options.env);
+  if (!storedSession) {
+    throw new Error(`No local CMS session found for [${options.env}]. Run \`ro auth login --env ${options.env}\` first.`);
+  }
+  const description = describeSession(storedSession);
+  console.log(`Environment: ${description.env}`);
+  console.log(`CMS URL:     ${description.cmsUrl}`);
+  console.log(description.identityLine);
+  if (description.scopesLine)
+    console.log(description.scopesLine);
   if (!options.remote) {
-    if (!storedSession) {
-      throw new Error(`No local CMS session found for [${options.env}]. Run \`ro auth login --env ${options.env}\` first.`);
-    }
     return {
       env: storedSession.env,
       cmsUrl: storedSession.cmsUrl,
       loggedIn: true,
+      identity: storedSession.identity ?? null,
       user: storedSession.user ?? null
     };
   }
-  const cmsUrl = resolveCmsUrl(options.env, options.cmsUrl || storedSession?.cmsUrl);
+  const cmsUrl = resolveCmsUrl(options.env, options.cmsUrl || storedSession.cmsUrl);
   const response = await fetch(options.meUrl || `${cmsUrl}/api/auth/me`, {
     method: "GET",
     headers: {
@@ -2407,6 +2466,9 @@ async function me(options) {
     throw new Error(`CMS me failed: ${response.status} ${response.statusText}
 ${JSON.stringify(payload, null, 2)}`);
   }
+  console.log(`
+Server view:`);
+  console.log(JSON.stringify(payload, null, 2));
   return payload;
 }
 
@@ -3802,6 +3864,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"]);
@@ -3810,9 +3878,204 @@ 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");
 }
+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 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 = readFileSync3(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))
     return arrayOfFiles;
@@ -3849,6 +4112,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...");
@@ -3868,23 +4132,18 @@ async function deployFullstack(env, overrides) {
     ...overrides.port ? ["--port", shellQuote(String(overrides.port))] : []
   ];
   execSync2(`bun run sync-widget-manifest -- ${syncArgs.join(" ")}`, { stdio: "inherit", env: childEnv });
+  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...
 `);
@@ -3902,7 +4161,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) {
@@ -3950,42 +4209,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.");
   }
@@ -3993,7 +4217,7 @@ ${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...");
+  console.log("☁️  Step 4: Deploying HTML zip to server...");
   const zipBuffer = readFileSync3(ZIP_FILE);
   try {
     const response = await fetch(DEPLOY_URL, {
@@ -4009,10 +4233,17 @@ ${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;
@@ -4537,7 +4768,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) {
@@ -4548,7 +4779,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))
@@ -5047,6 +5278,19 @@ async function updateGameSdk() {
 }
 
 // src/cli.ts
+function renderError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  console.error(`
+Error: ${msg}`);
+  if (process.env.RO_DEBUG && err instanceof Error && err.stack) {
+    console.error(`
+${err.stack}`);
+  }
+  console.error();
+  process.exit(1);
+}
+process.on("unhandledRejection", renderError);
+process.on("uncaughtException", renderError);
 var TEMPLATES2 = {
   webapp: {
     name: "webapp",
@@ -5110,8 +5354,7 @@ function addAuthCommands(parent) {
     console.log(`\uD83D\uDCCD CMS URL: ${session.cmsUrl}`);
   });
   auth.command("me").description("Show the locally stored CMS login session").option("-e, --env <environment>", "CMS environment (local | development | staging | production)", "development").option("--remote", "Call the CMS /me endpoint instead of only reading the local session").option("--cms-url <url>", "CMS base URL for --remote. Defaults to the selected environment or stored session").option("--me-url <url>", "Full me endpoint URL for --remote. Defaults to <cms-url>/api/auth/me").action(async (options) => {
-    const currentUser = await me(options);
-    console.log(JSON.stringify(currentUser, null, 2));
+    await me(options);
   });
   return auth;
 }

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@rodyssey/cli",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Scaffold new projects from airconcepts templates",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/airconcepts/ro-cli.git"
   },
   "bin": {
-    "@rodyssey/cli": "dist/cli.js"
+    "@rodyssey/cli": "dist/cli.js",
+    "ro": "dist/cli.js",
+    "rocli": "dist/cli.js"
   },
   "files": [
     "dist"