@rodyssey/cli 0.1.5 → 0.1.7

package/README.md

@@ -12,4 +12,24 @@ To run:
 bun run index.ts
 ```
 
+## Release
+
+Release automation lives in `.github/workflows/release.yml` and uses Changesets.
+
+For a change that should publish a new CLI version:
+
+```bash
+bun run changeset
+```
+
+Choose `patch`, `minor`, or `major`, commit the generated `.changeset/*.md` file, and merge to `main`. The workflow opens or updates a release PR with the version bump and changelog. Merging that release PR publishes `@rodyssey/cli` to npm.
+
+Configure npm trusted publishing for the package with:
+
+- Organization/user: `airconcepts`
+- Repository: `ro-cli`
+- Workflow filename: `release.yml`
+
+This repository is private, so npm provenance is disabled. If the repository becomes public later, change `publishConfig.provenance` and `NPM_CONFIG_PROVENANCE` back to `true`.
+
 This project was created using `bun init` in bun v1.3.9. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/cli.js

@@ -2068,6 +2068,47 @@ var {
   Option,
   Help
 } = import__.default;
+// package.json
+var package_default = {
+  name: "@rodyssey/cli",
+  version: "0.1.7",
+  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"
+  },
+  files: [
+    "dist"
+  ],
+  type: "module",
+  module: "index.ts",
+  scripts: {
+    build: "bun build src/cli.ts --outdir dist --target node",
+    start: "bun dist/cli.js",
+    changeset: "changeset",
+    "version-packages": "changeset version",
+    release: "bun run build && changeset publish",
+    prepublishOnly: "bun run build"
+  },
+  publishConfig: {
+    access: "public",
+    provenance: false
+  },
+  dependencies: {
+    commander: "^13.1.0",
+    mime: "^4.1.0"
+  },
+  devDependencies: {
+    "@changesets/cli": "^2.30.0",
+    "@types/bun": "latest"
+  },
+  peerDependencies: {
+    typescript: "^5"
+  }
+};
 
 // src/auth.ts
 import { spawn } from "node:child_process";
@@ -2262,7 +2303,9 @@ ${JSON.stringify(payload, null, 2)}`);
     token,
     user: extractUser(payload)
   };
-  storeSession(session);
+  if (options.persist !== false) {
+    storeSession(session);
+  }
   return session;
 }
 async function me(options) {
@@ -2296,12 +2339,29 @@ ${JSON.stringify(payload, null, 2)}`);
 
 // src/create.ts
 import { execSync } from "node:child_process";
-import { existsSync as existsSync3, readFileSync as readFileSync3, rmSync, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync3, rmSync } from "node:fs";
 import path2 from "node:path";
 
 // src/utils.ts
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2 } from "node:fs";
 import path from "node:path";
+function upsertEnvValue(content, key, value) {
+  const line = `${key}=${value}`;
+  const pattern = new RegExp(`^${key}=.*$`, "m");
+  if (pattern.test(content))
+    return content.replace(pattern, line);
+  return `${content}${content.endsWith(`
+`) || content.length === 0 ? "" : `
+`}${line}
+`;
+}
+function upsertEnvFile(filePath, entries) {
+  let content = existsSync2(filePath) ? readFileSync2(filePath, "utf-8") : "";
+  for (const [key, value] of Object.entries(entries)) {
+    content = upsertEnvValue(content, key, value);
+  }
+  writeFileSync2(filePath, content, "utf-8");
+}
 function replaceInFile(filePath, search, replace) {
   const content = readFileSync2(filePath, "utf-8");
   const updated = content.replaceAll(search, replace);
@@ -2374,22 +2434,11 @@ function extractDeployToken(payload) {
   const webapp = nestedObject(payload, "webapp");
   return pickString(webapp?.deployToken, webapp?.deploymentToken);
 }
-function upsertEnvValue(content, key, value) {
-  const line = `${key}=${value}`;
-  const pattern = new RegExp(`^${key}=.*$`, "m");
-  if (pattern.test(content))
-    return content.replace(pattern, line);
-  return `${content}${content.endsWith(`
-`) || content.length === 0 ? "" : `
-`}${line}
-`;
-}
 function writeProjectEnv(projectDir, provisioned) {
-  const envFile = path2.join(projectDir, ".env");
-  let content = existsSync3(envFile) ? readFileSync3(envFile, "utf-8") : "";
-  content = upsertEnvValue(content, "WEBAPP_ID", provisioned.webappId);
-  content = upsertEnvValue(content, "DEPLOY_TOKEN", provisioned.deployToken);
-  writeFileSync3(envFile, content, "utf-8");
+  upsertEnvFile(path2.join(projectDir, ".env"), {
+    WEBAPP_ID: provisioned.webappId,
+    DEPLOY_TOKEN: provisioned.deployToken
+  });
 }
 async function provisionWebapp(projectName, options) {
   const cmsUrl = resolveCmsUrl(options.env, options.cmsUrl);
@@ -2481,7 +2530,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 readFileSync4, readdirSync, statSync, unlinkSync } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync3, readdirSync, statSync, unlinkSync } from "node:fs";
 import { join as join2 } from "node:path";
 
 // node_modules/mime/dist/types/other.js
@@ -3693,7 +3742,7 @@ function getAllFiles(dirPath, arrayOfFiles = []) {
   return arrayOfFiles;
 }
 function fileToBlob(filePath) {
-  const buffer = readFileSync4(filePath);
+  const buffer = readFileSync3(filePath);
   return new Blob([buffer], { type: src_default.getType(filePath) || "application/octet-stream" });
 }
 async function deploy(env = "development", overrides = {}) {
@@ -3780,7 +3829,7 @@ ${errorText}`);
     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 = readFileSync4(f, "utf-8");
+      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);
@@ -3820,7 +3869,7 @@ ${errorText}`);
   console.log(`✅ Created ${ZIP_FILE}
 `);
   console.log("☁️  Step 5: Deploying HTML zip to server...");
-  const zipBuffer = readFileSync4(ZIP_FILE);
+  const zipBuffer = readFileSync3(ZIP_FILE);
   try {
     const response = await fetch(DEPLOY_URL, {
       method: "POST",
@@ -3853,20 +3902,377 @@ ${errorText}`);
 ✨ Deployment successful!`);
 }
 
+// src/promote.ts
+import { existsSync as existsSync6, readFileSync as readFileSync5 } from "node:fs";
+import { resolve as resolve2 } from "node:path";
+
+// src/update-webapp-config.ts
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } 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 parseJsonOption(value, optionName) {
+  const maybePath = resolve(process.cwd(), value);
+  const raw = existsSync5(maybePath) ? readFileSync4(maybePath, "utf-8") : value;
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error("value must be a JSON object");
+    }
+    return parsed;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid ${optionName}: ${message}`);
+  }
+}
+function coerceMaybeNull(value) {
+  if (value === undefined)
+    return;
+  if (value === "null")
+    return null;
+  return value;
+}
+function resolveConfigUrl(options, required = true) {
+  const configUrl = options.url || process.env.WEBAPP_CONFIG_URL || CONFIG_URLS[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.`);
+    process.exit(1);
+  }
+  const url = new URL(configUrl);
+  if (!options.host && !options.port) {
+    return url.toString().replace(/\/$/, "");
+  }
+  if (options.host)
+    url.hostname = options.host;
+  if (options.port)
+    url.port = String(options.port);
+  return url.toString().replace(/\/$/, "");
+}
+function buildDetailsPayload(options) {
+  const payload = options.details ? parseJsonOption(options.details, "--details") : {};
+  const title = coerceMaybeNull(options.title);
+  const description = coerceMaybeNull(options.description);
+  const coverImg = coerceMaybeNull(options.coverImg);
+  if (title !== undefined)
+    payload.title = title;
+  if (description !== undefined)
+    payload.description = description;
+  if (coverImg !== undefined)
+    payload.coverImg = coverImg;
+  if (options.localization !== undefined) {
+    payload.localization = options.localization === "null" ? null : parseJsonOption(options.localization, "--localization");
+  }
+  return payload;
+}
+function resolveWebappId(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.");
+    process.exit(1);
+  }
+  return resolved;
+}
+function ensureDeployToken(env) {
+  if (process.env.DEPLOY_TOKEN)
+    return;
+  console.error("❌ Error: DEPLOY_TOKEN is not set in environment variables.");
+  console.info(`\uD83D\uDCA1 Please check your .env or .env.${env} file.`);
+  process.exit(1);
+}
+function getConfigUrl(options, required = true) {
+  return resolveConfigUrl(options, required);
+}
+async function fetchWebappConfig(options) {
+  loadEnv(options.env);
+  const webappId = resolveWebappId(options.webappId);
+  const CONFIG_URL = getConfigUrl(options);
+  if (!CONFIG_URL) {
+    throw new Error("No webapp config endpoint configured.");
+  }
+  ensureDeployToken(options.env);
+  const url = new URL(CONFIG_URL);
+  url.searchParams.set("webappId", webappId);
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      Authorization: `Bearer ${process.env.DEPLOY_TOKEN}`,
+      Accept: "application/json"
+    }
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Config fetch failed: ${response.status} ${response.statusText}
+${errorText}`);
+  }
+  return await response.json();
+}
+async function getWebappConfig(options) {
+  loadEnv(options.env);
+  const webappId = resolveWebappId(options.webappId);
+  const CONFIG_URL = getConfigUrl(options);
+  if (!CONFIG_URL)
+    return;
+  const url = new URL(CONFIG_URL);
+  url.searchParams.set("webappId", webappId);
+  console.log(`⚙️ Pulling webapp config for [${options.env}] environment...`);
+  console.log(`\uD83D\uDCCD Config URL: ${url.toString()}`);
+  console.log(`\uD83D\uDCCD Webapp ID: ${webappId}
+`);
+  const config = await fetchWebappConfig(options);
+  const output = JSON.stringify(config, null, 2);
+  if (options.out) {
+    writeFileSync3(options.out, `${output}
+`, "utf-8");
+    console.log(`✅ Webapp config written to ${options.out}`);
+    return;
+  }
+  console.log(output);
+}
+async function updateWebappConfig(options) {
+  loadEnv(options.env);
+  const webappId = resolveWebappId(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.");
+    process.exit(1);
+  }
+  const payload = { webappId, details };
+  const CONFIG_URL = getConfigUrl(options, !options.dryRun);
+  if (!options.dryRun)
+    ensureDeployToken(options.env);
+  console.log(`⚙️ Updating webapp config for [${options.env}] environment...`);
+  if (CONFIG_URL) {
+    console.log(`\uD83D\uDCCD Config URL: ${CONFIG_URL}`);
+  }
+  console.log(`\uD83D\uDCCD Webapp ID: ${webappId}
+`);
+  if (options.dryRun) {
+    console.log("\uD83E\uDDEA Dry run payload:");
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+  if (!CONFIG_URL)
+    return;
+  const response = await fetch(CONFIG_URL, {
+    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(`Config update failed: ${response.status} ${response.statusText}
+${errorText}`);
+  }
+  const result = await response.json().catch(() => {
+    return;
+  });
+  console.log("✅ Webapp config updated");
+  if (result !== undefined) {
+    console.log(`
+\uD83D\uDCCB Update result:`, result);
+  }
+}
+
+// src/promote.ts
+var DEFAULT_SOURCE_ENV = "development";
+var PROD_ENV = "production";
+var PROD_ENV_FILE = ".env.production";
+function isObject3(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function pickString2(...values) {
+  return values.find((value) => typeof value === "string" && value.length > 0);
+}
+function nestedObject2(value, key) {
+  if (!isObject3(value))
+    return;
+  const nested = value[key];
+  return isObject3(nested) ? nested : undefined;
+}
+function extractDeployToken2(payload) {
+  const webapp = nestedObject2(payload, "webapp");
+  return pickString2(webapp?.deployToken, webapp?.deploymentToken);
+}
+function unwrapSourceDetails(payload) {
+  if (!isObject3(payload))
+    return {};
+  const inner = payload.details;
+  if (isObject3(inner))
+    return inner;
+  return payload;
+}
+function parseDetailsOption(value) {
+  const maybePath = resolve2(process.cwd(), value);
+  const raw = existsSync6(maybePath) ? readFileSync5(maybePath, "utf-8") : value;
+  try {
+    const parsed = JSON.parse(raw);
+    if (!isObject3(parsed)) {
+      throw new Error("value must be a JSON object");
+    }
+    return parsed;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid --details: ${message}`);
+  }
+}
+async function prompt(question) {
+  const readline = await import("node:readline");
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolveAnswer) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolveAnswer(answer);
+    });
+  });
+}
+function isAffirmative(answer) {
+  const trimmed = answer.trim().toLowerCase();
+  return trimmed === "" || trimmed === "y" || trimmed === "yes";
+}
+async function promote(options) {
+  loadEnv();
+  const webappId = process.env.WEBAPP_ID;
+  if (!webappId) {
+    console.error("❌ Error: WEBAPP_ID is not set in .env.");
+    console.info("\uD83D\uDCA1 Run `ro app create --auto` first, or set WEBAPP_ID manually.");
+    process.exit(1);
+  }
+  const prodEnvPath = resolve2(process.cwd(), PROD_ENV_FILE);
+  if (existsSync6(prodEnvPath)) {
+    const content = readFileSync5(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);
+    }
+  }
+  const sourceEnv = options.from || DEFAULT_SOURCE_ENV;
+  let details;
+  if (options.details) {
+    details = parseDetailsOption(options.details);
+    console.log("\uD83D\uDCE6 Using details from --details flag.");
+  } else {
+    console.log(`\uD83D\uDCE5 Fetching latest details from [${sourceEnv}]...`);
+    const sourceResponse = await fetchWebappConfig({ env: sourceEnv, webappId });
+    const sourceDetails = unwrapSourceDetails(sourceResponse);
+    console.log(`
+\uD83D\uDCCB Source details:`);
+    console.log(JSON.stringify(sourceDetails, null, 2));
+    console.log();
+    if (options.yes) {
+      console.log("✓ --yes flag set, using server details.");
+      details = sourceDetails;
+    } else {
+      const answer = await prompt("Pull these details from server? (Y/n): ");
+      if (isAffirmative(answer)) {
+        details = sourceDetails;
+      } else {
+        console.error("❌ Aborted. Re-run with --details <json|file> to provide custom details.");
+        process.exit(1);
+      }
+    }
+  }
+  console.log(`
+\uD83D\uDD10 Logging in to ${PROD_ENV} CMS (ephemeral, not stored)...`);
+  const session = await login({
+    env: PROD_ENV,
+    cmsUrl: options.cmsUrl,
+    persist: false
+  });
+  console.log(`✅ Logged in to ${session.cmsUrl}`);
+  const cmsUrl = resolveCmsUrl(PROD_ENV, options.cmsUrl);
+  const promoteUrl = options.promoteUrl || `${cmsUrl}/api/cli/webapps/promote`;
+  const promoteBody = { webappId, details };
+  console.log(`
+\uD83D\uDE80 Promoting webapp to ${PROD_ENV}...`);
+  console.log(`\uD83D\uDCCD Promote URL: ${promoteUrl}`);
+  console.log(`\uD83D\uDCCD Webapp ID: ${webappId}`);
+  console.log("\uD83D\uDCE6 Promote body:");
+  console.log(JSON.stringify(promoteBody, null, 2));
+  console.log();
+  const response = await fetch(promoteUrl, {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${session.token}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(promoteBody)
+  });
+  const payload = await readResponsePayload(response);
+  if (response.status === 409) {
+    console.error(`❌ Webapp ${webappId} is already promoted to ${PROD_ENV}.`);
+    process.exit(1);
+  }
+  if (!response.ok) {
+    throw new Error(`Promote failed: ${response.status} ${response.statusText}
+${JSON.stringify(payload, null, 2)}`);
+  }
+  const deployToken = extractDeployToken2(payload);
+  if (!deployToken) {
+    throw new Error(`Promote response did not include webapp.deployToken:
+${JSON.stringify(payload, null, 2)}`);
+  }
+  upsertEnvFile(prodEnvPath, {
+    WEBAPP_ID: webappId,
+    DEPLOY_TOKEN: deployToken
+  });
+  console.log(`✅ Wrote WEBAPP_ID and DEPLOY_TOKEN to ${PROD_ENV_FILE}`);
+  console.log(`\uD83D\uDCCD Webapp ID: ${webappId}`);
+  console.log(`
+✨ Promotion complete! Deploy to production with:
+`);
+  console.log(`    ro app deploy -e production
+`);
+}
+
 // src/upgrade-template.ts
 import { execSync as execSync3 } from "node:child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync2, copyFileSync, rmSync as rmSync2 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync2, copyFileSync, rmSync as rmSync2 } from "node:fs";
 var TEMPLATES = {
   webapp: {
     name: "webapp (SPA)",
     repo: "https://github.com/airconcepts/webapp-template.git",
     remoteName: "template",
-    checkoutFiles: ["AGENTS.md", ".agent/", "src/types/webapp.d.ts", "src/types/game-sdk.d.ts"],
+    checkoutFiles: [
+      "AGENTS.md",
+      ".agent/",
+      "src/types/webapp.d.ts",
+      "src/types/game-sdk.d.ts",
+      "src/widgets/Widget.tsx",
+      "src/widgets/data-source.ts",
+      "src/widgets/index.ts",
+      "src/widgets/manifest.ts",
+      "src/widgets/registry.ts",
+      "src/widgets/types.ts",
+      "src/widgets/use-widget-data.ts",
+      "src/widgets/dev/WidgetGrid.tsx",
+      "src/widgets/templates/action.tsx",
+      "src/widgets/templates/list.tsx",
+      "src/widgets/templates/progress.tsx",
+      "src/widgets/templates/stat.tsx",
+      "vite-plugins/widgets-manifest.ts"
+    ],
     newFiles: [
       "src/exp-engine/cli.ts",
       "src/exp-engine/evaluate.ts",
       "src/exp-engine/README.md",
-      "src/types/exp-engine.d.ts"
+      "src/types/exp-engine.d.ts",
+      "src/widgets/examples.tsx",
+      "src/routes/widget.$id.tsx",
+      "src/routes/dev/widgets-preview.tsx"
     ]
   },
   "webapp-fullstack": {
@@ -3890,12 +4296,12 @@ var CLI_SCRIPTS = {
   "upgrade-template": "bunx @rodyssey/cli@latest app upgrade-template"
 };
 function detectTemplate() {
-  if (existsSync5("app")) {
+  if (existsSync7("app")) {
     console.log(`\uD83D\uDD0D Detected fullstack template (found app/ directory)
 `);
     return TEMPLATES["webapp-fullstack"];
   }
-  if (existsSync5("src")) {
+  if (existsSync7("src")) {
     console.log(`\uD83D\uDD0D Detected SPA template (found src/ directory)
 `);
     return TEMPLATES["webapp"];
@@ -3906,11 +4312,11 @@ function detectTemplate() {
 }
 function updatePackageJsonScripts() {
   const pkgPath = "package.json";
-  if (!existsSync5(pkgPath)) {
+  if (!existsSync7(pkgPath)) {
     console.log("⚠️  No package.json found, skipping scripts update");
     return;
   }
-  const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
   if (!pkg.scripts) {
     pkg.scripts = {};
   }
@@ -3948,7 +4354,7 @@ function updateCliSkill() {
     }
     execSync3(`git fetch ${cliRemote}`, { stdio: "inherit" });
     execSync3(`git checkout ${cliRemote}/main -- skills/ro-cli/SKILL.md`, { stdio: "inherit" });
-    if (existsSync5("skills/ro-cli/SKILL.md")) {
+    if (existsSync7("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 });
@@ -3981,7 +4387,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 (!existsSync5(file)) {
+      if (!existsSync7(file)) {
         console.log(`\uD83D\uDCC2 Checking out ${file}...`);
         try {
           execSync3(`git checkout ${template.remoteName}/main -- ${file}`, { stdio: "inherit" });
@@ -4139,162 +4545,6 @@ async function updateGameSdk() {
   }
 }
 
-// src/update-webapp-config.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } 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 parseJsonOption(value, optionName) {
-  const maybePath = resolve(process.cwd(), value);
-  const raw = existsSync6(maybePath) ? readFileSync6(maybePath, "utf-8") : value;
-  try {
-    const parsed = JSON.parse(raw);
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      throw new Error("value must be a JSON object");
-    }
-    return parsed;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Invalid ${optionName}: ${message}`);
-  }
-}
-function resolveConfigUrl(options, required = true) {
-  const configUrl = options.url || process.env.WEBAPP_CONFIG_URL || CONFIG_URLS[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.`);
-    process.exit(1);
-  }
-  const url = new URL(configUrl);
-  if (!options.host && !options.port) {
-    return url.toString().replace(/\/$/, "");
-  }
-  if (options.host)
-    url.hostname = options.host;
-  if (options.port)
-    url.port = String(options.port);
-  return url.toString().replace(/\/$/, "");
-}
-function buildConfigPayload(options) {
-  const payload = options.config ? parseJsonOption(options.config, "--config") : {};
-  if (options.title !== undefined)
-    payload.title = options.title;
-  if (options.description !== undefined)
-    payload.description = options.description;
-  if (options.coverImg !== undefined)
-    payload.coverImg = options.coverImg;
-  if (options.localization !== undefined) {
-    payload.localization = parseJsonOption(options.localization, "--localization");
-  }
-  return payload;
-}
-function resolveWebappId(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.");
-    process.exit(1);
-  }
-  return resolved;
-}
-function ensureDeployToken(env) {
-  if (process.env.DEPLOY_TOKEN)
-    return;
-  console.error("❌ Error: DEPLOY_TOKEN is not set in environment variables.");
-  console.info(`\uD83D\uDCA1 Please check your .env or .env.${env} file.`);
-  process.exit(1);
-}
-function getConfigUrl(options, required = true) {
-  return resolveConfigUrl(options, required);
-}
-async function getWebappConfig(options) {
-  loadEnv(options.env);
-  const webappId = resolveWebappId(options.webappId);
-  const CONFIG_URL = getConfigUrl(options);
-  if (!CONFIG_URL)
-    return;
-  ensureDeployToken(options.env);
-  const url = new URL(CONFIG_URL);
-  url.searchParams.set("webappId", webappId);
-  console.log(`⚙️ Pulling webapp config for [${options.env}] environment...`);
-  console.log(`\uD83D\uDCCD Config URL: ${url.toString()}`);
-  console.log(`\uD83D\uDCCD Webapp ID: ${webappId}
-`);
-  const response = await fetch(url, {
-    method: "GET",
-    headers: {
-      Authorization: `Bearer ${process.env.DEPLOY_TOKEN}`,
-      Accept: "application/json"
-    }
-  });
-  if (!response.ok) {
-    const errorText = await response.text();
-    throw new Error(`Config fetch failed: ${response.status} ${response.statusText}
-${errorText}`);
-  }
-  const config = await response.json();
-  const output = JSON.stringify(config, null, 2);
-  if (options.out) {
-    writeFileSync5(options.out, `${output}
-`, "utf-8");
-    console.log(`✅ Webapp config written to ${options.out}`);
-    return;
-  }
-  console.log(output);
-}
-async function updateWebappConfig(options) {
-  loadEnv(options.env);
-  const webappId = resolveWebappId(options.webappId);
-  const config = buildConfigPayload(options);
-  if (Object.keys(config).length === 0) {
-    console.error("❌ Error: no config fields provided. Use --title, --cover-img, --localization, or --config.");
-    process.exit(1);
-  }
-  const payload = { webappId, config };
-  const CONFIG_URL = getConfigUrl(options, !options.dryRun);
-  if (!options.dryRun)
-    ensureDeployToken(options.env);
-  console.log(`⚙️ Updating webapp config for [${options.env}] environment...`);
-  if (CONFIG_URL) {
-    console.log(`\uD83D\uDCCD Config URL: ${CONFIG_URL}`);
-  }
-  console.log(`\uD83D\uDCCD Webapp ID: ${webappId}
-`);
-  if (options.dryRun) {
-    console.log("\uD83E\uDDEA Dry run payload:");
-    console.log(JSON.stringify(payload, null, 2));
-    return;
-  }
-  if (!CONFIG_URL)
-    return;
-  const response = await fetch(CONFIG_URL, {
-    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(`Config update failed: ${response.status} ${response.statusText}
-${errorText}`);
-  }
-  const result = await response.json().catch(() => {
-    return;
-  });
-  console.log("✅ Webapp config updated");
-  if (result !== undefined) {
-    console.log(`
-\uD83D\uDCCB Update result:`, result);
-  }
-}
-
 // src/cli.ts
 var TEMPLATES2 = {
   webapp: {
@@ -4322,26 +4572,26 @@ Available templates:
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     rl.question(`Select a template (1-${entries.length}): `, (answer) => {
       rl.close();
       const index = parseInt(answer, 10) - 1;
       if (index >= 0 && index < entries.length) {
-        resolve2(entries[index].name);
+        resolve3(entries[index].name);
       } else {
         console.error("Invalid selection, defaulting to 'webapp'");
-        resolve2("webapp");
+        resolve3("webapp");
       }
     });
   });
 }
-program.name("@rodyssey/cli").description("Airconcepts CLI toolkit").version("0.1.0");
+program.name("@rodyssey/cli").description("Airconcepts CLI toolkit").version(package_default.version);
 var app = program.command("app").description("Manage webapp projects");
 function addConfigTargetOptions(command) {
   return command.option("-e, --env <environment>", "Target environment (local | development | staging | production)", "development").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");
 }
 function addConfigSetOptions(command) {
-  return addConfigTargetOptions(command).option("--title <title>", "Webapp title").option("--description <description>", "Webapp description").option("--cover-img <url>", "Cover image URL").option("--localization <json-or-file>", "Localization JSON object or path to a JSON file").option("--config <json-or-file>", "Full config JSON object or path to a JSON file").option("--dry-run", "Print the request payload without sending it");
+  return addConfigTargetOptions(command).option("--title <title>", "Webapp title (pass the literal 'null' to clear)").option("--description <description>", "Webapp description (pass the literal 'null' to clear)").option("--cover-img <url>", "Cover image URL (pass the literal 'null' to clear)").option("--localization <json-or-file>", "Localization JSON object, path to a JSON file, or 'null' to clear").option("--details <json-or-file>", "Partial WebappDetails JSON or path to a JSON file. Sent as a delta — only include keys you want to change. Do NOT echo a full GET response here, or empty defaults like 'tags: []' will clobber real data.").option("--dry-run", "Print the request payload without sending it");
 }
 app.command("create").argument("<project-name>", "Name of the project to create").option("-t, --template <template>", "Template to use (webapp | webapp-fullstack)").option("--auto", "Create a CMS webapp and write WEBAPP_ID/DEPLOY_TOKEN to .env").option("-e, --env <environment>", "CMS environment for --auto (local | development | staging | production)", "development").option("--cms-url <url>", "CMS base URL for --auto. Defaults to the selected environment").option("--create-url <url>", "Full CMS create endpoint for --auto. Defaults to <cms-url>/api/cli/webapps/create").description("Create a new project from a template").action(async (projectName, options) => {
   let templateName;
@@ -4362,6 +4612,15 @@ app.command("create").argument("<project-name>", "Name of the project to create"
     createUrl: options.createUrl
   });
 });
+app.command("promote").description("Promote the current webapp to production (creates a prod record with the same WEBAPP_ID)").option("--details <json-or-file>", "Full WebappDetails JSON object or path to a JSON file. Skips the source-pull and confirmation prompts when provided.").option("-y, --yes", "Auto-accept pulling the latest details from development").option("--cms-url <url>", "Production CMS base URL. Defaults to the production environment").option("--promote-url <url>", "Full CMS promote endpoint. Defaults to <cms-url>/api/cli/webapps/promote").option("--from <env>", "Source environment to pull details from (testing override). Defaults to development", "development").action(async (options) => {
+  await promote({
+    details: options.details,
+    yes: options.yes,
+    cmsUrl: options.cmsUrl,
+    promoteUrl: options.promoteUrl,
+    from: options.from
+  });
+});
 app.command("update-game-sdk").description("Download and update the GameSDK library, types, and documentation").action(async () => {
   await updateGameSdk();
 });

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@rodyssey/cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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"
   },
@@ -13,16 +17,24 @@
   "scripts": {
     "build": "bun build src/cli.ts --outdir dist --target node",
     "start": "bun dist/cli.js",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "bun run build && changeset publish",
     "prepublishOnly": "bun run build"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
   "dependencies": {
     "commander": "^13.1.0",
     "mime": "^4.1.0"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.30.0",
     "@types/bun": "latest"
   },
   "peerDependencies": {
     "typescript": "^5"
   }
-}
+}