@clubedge/create-clubedge-app 0.42.1 → 0.43.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to `create-clubedge-app` are documented here.
 
+## 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.0
         |
         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.0` | `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/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.0",
   "description": "Create React apps from Clubedge Starter with a CLI or local MCP server.",
   "type": "module",
   "packageManager": "pnpm@10.9.0",