@clubedge/create-clubedge-app 0.42.1 → 0.43.1

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to `create-clubedge-app` are documented here.
 
+## 0.43.1
+
+- **`try` shows Railway's reason when Railway refuses a VM** (#144):
+  - Before, it said Railway may have changed its free VM and told you to update the CLI, which no update fixes.
+  - It now prints Railway's own explanation, then Railway's limits, the usual cause: 3 free VMs per network per day, and no anonymous VMs while Railway is busy.
+- Still on Starter `v0.27.1`.
+
+## 0.43.0
+
+- **Upgrades keep each app's own version** (#134, by @ahmed-husssain):
+  - An app whose version the project changed in `apps/*/package.json` keeps it, without a conflict on that line.
+  - An app whose version the project never touched takes the new Starter's.
+  - This completes 0.41.0's version ownership, which covered the root `package.json`.
+- **`add`, `remove`, and `upgrade` that change nothing exit before downloading the Starter** (#133, by @ahmed-husssain; issue #132):
+  - The cases: `upgrade` on the pinned Starter's commit or with `--ref` set to the recorded commit, `add` with options the project already uses, and `remove` of modules recorded as `none`.
+  - These commands now work offline. They no longer refuse a project with uncommitted changes, since they change nothing.
+  - `upgrade --ref <branch>` still resolves the branch, which may have moved. `remove` with an unknown module still fails with `Unknown module`.
+- Still on Starter `v0.27.1`.
+
 ## 0.42.1
 
 - Default to Starter `v0.27.1` (#140): new projects carry the Clubedge Starter brand, and their mobile app shows it.

package/README.md

@@ -381,7 +381,7 @@ Projects created with `--infra neon` also have `.github/workflows/preview.yml`,
 Each CLI release is tested against one specific Starter release:
 
 ```text
-create-clubedge-app v0.42.1
+create-clubedge-app v0.43.1
         |
         v
 Clubedge Starter v0.27.1
@@ -392,7 +392,7 @@ The current relationship is:
 
 | CLI release | Default Starter release | Meaning |
 | --- | --- | --- |
-| `create-clubedge-app@0.42.1` | `clubedge-starter@v0.27.1` | The CLI's required, tested default |
+| `create-clubedge-app@0.43.1` | `clubedge-starter@v0.27.1` | The CLI's required, tested default |
 
 This means the same CLI version always scaffolds the same Starter revision by default. The CLI does not silently follow Starter `main`.
 
@@ -509,6 +509,7 @@ Each phase ends with a Starter release and a CLI release pinned to it. The full
 | 0.40.0 | v0.26.0 | Starter v0.26.0: every module on React + Vite with FastAPI (pg-boss excepted) |
 | 0.41.0 | v0.26.0 | A conflicted package.json no longer breaks later commands (`--detailed-exit-code`); doctor finds conflict markers; projects own their version and README |
 | 0.42.0 | v0.27.0 | Starter v0.27.0: mobile apps with Capacitor (`--shell capacitor`, template schema 5); client addresses per platform; Docker Compose behind Caddy, with images on GHCR |
+| 0.43.0 | v0.27.1 | Upgrades keep each app's own version; add, remove, and upgrade that change nothing skip the Starter download |
 
 ## Community
 

package/dist/core/customize.js

@@ -88,10 +88,13 @@ export function customizeLegacySource(source, { displayName }) {
         .replaceAll(">Clubedge<", `>${displayName}<`)
         .replaceAll("Starter workspace", "Application workspace");
 }
-/** Gives a selected stack's app the package name generated projects use. */
-export function customizeAppManifest(source, appPackage) {
+/** Gives a selected stack's app the package name generated projects use and preserves its version. */
+export function customizeAppManifest(source, appPackage, version) {
     const manifest = JSON.parse(source);
-    manifest.name = appPackage;
+    if (appPackage)
+        manifest.name = appPackage;
+    if (version !== undefined)
+        manifest.version = version;
     return json(manifest);
 }
 /**

package/dist/core/railway.js

@@ -31,11 +31,12 @@ export function hostKeyFingerprint(key) {
 }
 /**
  * Finds Railway's JSON status line in a command's stderr. Returns null when there is none, and
- * throws when there is one without the fields this CLI needs.
+ * throws when there is one without the fields this CLI needs, with Railway's reason when it
+ * refused the VM.
  */
 export function parseRailwayStatus(stderr) {
-    for (const line of stderr.split(/\r?\n/)) {
-        const trimmed = line.trim();
+    const lines = stderr.split(/\r?\n/).map((line) => line.trim());
+    for (const trimmed of lines) {
         if (!trimmed.startsWith("{"))
             continue;
         let value;
@@ -47,6 +48,8 @@ export function parseRailwayStatus(stderr) {
         }
         if (typeof value.status !== "string")
             continue;
+        if (value.status === "error")
+            throw new Error(railwayRefusal(value, lines));
         const previewUrl = value.preview_url;
         const claimUrl = value.human_claim_url;
         const expiresAt = new Date(String(value.build_expires_at));
@@ -57,6 +60,19 @@ export function parseRailwayStatus(stderr) {
     }
     return null;
 }
+/**
+ * Why Railway refused a VM, in its own words: a message in its status line, else the text it
+ * wrote around that line, else the line itself. Its limits come after, since they are the usual
+ * cause.
+ */
+function railwayRefusal(value, lines) {
+    const said = ["message", "error", "reason", "description", "detail"]
+        .map((key) => value[key])
+        .find((text) => typeof text === "string" && text.trim() !== "");
+    const around = lines.filter((line) => line && !line.startsWith("{")).join(" ");
+    const reason = (said?.trim() || around || `its answer was ${JSON.stringify(value)}`).slice(0, 500).replace(/\.$/, "");
+    return `Railway did not start a VM: ${reason}. Railway allows 3 free VMs per network per day and turns anonymous VMs off while it is busy, so try again later or from another network; see ${railwayFreeVmUrl}.`;
+}
 /** Where the CLI keeps its own SSH key for Railway, apart from the user's ~/.ssh. */
 export function railwayKeyPath(env = process.env, platform = process.platform) {
     const configHome = env.XDG_CONFIG_HOME || (platform === "win32" && env.APPDATA ? env.APPDATA : join(homedir(), ".config"));

package/dist/core/update.js

@@ -3,6 +3,7 @@
 // through a three-way merge, see merge.ts.
 import { mkdir, readdir, rm, rmdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
+import { customizeAppManifest } from "./customize.js";
 import { updateEnvFile } from "./env.js";
 import { INCOMING_DIR, planMerge, sameContent } from "./merge.js";
 import { readProjectFiles, renderProject } from "./project.js";
@@ -35,6 +36,26 @@ export async function planUpdate(project, base, target) {
         baseFiles.delete("README.md");
         targetFiles.delete("README.md");
     }
+    // Workspace apps take the new Starter's version unless the project customized their version.
+    for (const [path, targetContent] of targetFiles) {
+        if (!path.startsWith("apps/") || !path.endsWith("/package.json"))
+            continue;
+        const baseContent = baseFiles.get(path);
+        const currentContent = current.get(path);
+        if (!baseContent || !currentContent)
+            continue;
+        try {
+            const basePkg = JSON.parse(baseContent.toString("utf8"));
+            const currentPkg = JSON.parse(currentContent.toString("utf8"));
+            if (typeof currentPkg.version === "string" && currentPkg.version !== basePkg.version) {
+                baseFiles.set(path, Buffer.from(customizeAppManifest(baseContent.toString("utf8"), undefined, currentPkg.version)));
+                targetFiles.set(path, Buffer.from(customizeAppManifest(targetContent.toString("utf8"), undefined, currentPkg.version)));
+            }
+        }
+        catch {
+            // Leave unparseable manifests untouched.
+        }
+    }
     const actions = planMerge(baseFiles, targetFiles, current);
     if (customReadme && targetReadme && !sameContent(currentReadme, targetReadme)) {
         actions.push({

package/dist/modify.js

@@ -366,8 +366,27 @@ export async function changeProject(args) {
         throw new Error("Not a project change.");
     const interactive = Boolean(process.stdin.isTTY) && !args.yes;
     const project = await readProject(process.cwd());
-    await assertSafeToChange(project, args, interactive);
     const upgrading = command.name === "upgrade";
+    if (upgrading &&
+        !args.templateDir &&
+        project.starterCommit &&
+        (args.ref ? args.ref === project.starterCommit : project.starterCommit === starterPin.starterCommit)) {
+        outro(`The project is already on Starter ${project.starterRef}.`);
+        return "unchanged";
+    }
+    if (command.name === "add" &&
+        command.changes.length > 0 &&
+        command.changes.every((c) => c.option && project.modules[c.module] === c.option)) {
+        outro("The project already uses that selection; nothing to change.");
+        return "unchanged";
+    }
+    if (command.name === "remove" &&
+        command.modules.length > 0 &&
+        command.modules.every((m) => project.modules[m] === "none")) {
+        outro("The project already uses that selection; nothing to change.");
+        return "unchanged";
+    }
+    await assertSafeToChange(project, args, interactive);
     const progress = spinner();
     progress.start(upgrading ? "Preparing both Starter revisions" : `Preparing Starter ${project.starterRef}`);
     const sources = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/create-clubedge-app",
-  "version": "0.42.1",
+  "version": "0.43.1",
   "description": "Create React apps from Clubedge Starter with a CLI or local MCP server.",
   "type": "module",
   "packageManager": "pnpm@10.9.0",