feat: add safe project upgrades and production performance fixes

.publish/cli/README.md

@@ -76,6 +76,12 @@ bun dist/server.js   # PORT env var optional
 
 Scaffolds a new app from an inline (dependency-free) template — `package.json`, `.gitignore`, config, and starter `app/` files. Use `npm run dev` during development, `npm run build && npm start` for production, or `npm run production` to build and start in one command. The generated production server currently requires Bun even when npm is used to manage packages and scripts.
 
+### `wrnexus update`
+
+`wrnexus update --latest` performs a complete project upgrade. It hands control to the exact target CLI, backs up important project files under `.wrnexus/update-backups/`, updates every `@wrnexus/*` dependency, refreshes framework-owned references, and applies every versioned syntax/config/file migration between the project version and target version. After installation it runs the project's `check` and `build` scripts; the new version is recorded only after verification succeeds.
+
+Use `--dry-run` to preview an upgrade or `--no-verify` when verification is intentionally handled elsewhere. Migrations never overwrite user-owned configuration wholesale: each release must provide a focused, idempotent transformation for any changed syntax or config contract.
+
 ```bash
 wrnexus create my-app
 ```

.publish/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/cli",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "type": "module",
   "description": "@wrnexus/cli — part of the WrNexus framework.",
   "license": "MIT",
@@ -28,16 +28,16 @@
     "wrnexus": "./dist/index.js"
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.13",
-    "@wrnexus/router": "^0.2.13",
-    "@wrnexus/csr": "^0.2.13",
-    "@wrnexus/compiler": "^0.2.13",
-    "@wrnexus/styles": "^0.2.13",
-    "@wrnexus/dev-server": "^0.2.13",
-    "@wrnexus/ui": "^0.2.13",
-    "@wrnexus/validation": "^0.2.13",
-    "@wrnexus/i18n": "^0.2.13",
-    "@wrnexus/db": "^0.2.13"
+    "@wrnexus/core": "^0.2.14",
+    "@wrnexus/router": "^0.2.14",
+    "@wrnexus/csr": "^0.2.14",
+    "@wrnexus/compiler": "^0.2.14",
+    "@wrnexus/styles": "^0.2.14",
+    "@wrnexus/dev-server": "^0.2.14",
+    "@wrnexus/ui": "^0.2.14",
+    "@wrnexus/validation": "^0.2.14",
+    "@wrnexus/i18n": "^0.2.14",
+    "@wrnexus/db": "^0.2.14"
   },
   "files": [
     "dist"