@calo-design/cli 0.4.0 → 0.4.2

package/bin/cli.js

@@ -148,9 +148,14 @@ async function ensureRuntime({ force } = {}) {
     ok(`shared runtime ready (${tilde(rt)})`);
     return;
   }
-  log(c.b("\n[runtime] Building the shared Calo runtime (one-time, ~a couple of minutes)"));
+  const scaffolded = fs.existsSync(path.join(rt, "package.json"));
+  const repin = force && scaffolded && !has("--clean");
+  log(c.b(`\n[runtime] ${repin ? "Re-pinning" : "Building"} the shared Calo runtime${repin ? "" : " (one-time, ~a couple of minutes)"}`));
   fs.mkdirSync(rt, { recursive: true });
-  if (force) {
+  // Re-pin is NON-destructive: `npm install` updates node_modules in place and aborts
+  // cleanly on failure (e.g. a peer conflict), so a working shared runtime is never left
+  // wiped. `--clean` opts into a from-scratch rebuild for a genuinely corrupted tree.
+  if (force && has("--clean")) {
     fs.rmSync(path.join(rt, "node_modules"), { recursive: true, force: true });
     try { fs.rmSync(runtimeManifestPath()); } catch {}
   }
@@ -163,7 +168,7 @@ async function ensureRuntime({ force } = {}) {
     runtimeManifestPath(),
     JSON.stringify({ builtAt: new Date().toISOString(), pkgSpecs: PKG_SPECS, peers: PEERS }, null, 2) + "\n"
   );
-  ok(`shared runtime built -> ${tilde(rt)}`);
+  ok(`shared runtime ${repin ? "re-pinned" : "built"} -> ${tilde(rt)}`);
 }
 
 // ---------------------------------------------------------------- shared helpers
@@ -214,12 +219,14 @@ function scaffoldExpoApp(destDir = process.cwd()) {
 async function installCaloDeps(cwd) {
   // Private @calo/* installs authenticate with a short-lived broker-minted token,
   // injected into git for the npm subprocess only (no gh / PAT / SSH key).
+  // --legacy-peer-deps: the Expo/RN dep graph routinely has benign peerOptional conflicts
+  // (e.g. overlapping typescript ranges); without it a single conflict ERESOLVEs the whole install.
   const env = gitTokenEnv(await githubToken());
-  runWithRetry("npm", ["install", ...PKG_SPECS], 3, { cwd, env });
+  runWithRetry("npm", ["install", ...PKG_SPECS, "--legacy-peer-deps"], 3, { cwd, env });
   if (isExpoProject(cwd)) run("npx", ["expo", "install", ...PEERS, "expo-font"], { cwd });
   else {
     warn("non-Expo project — installing latest peers; pin them to match your React Native version if needed.");
-    run("npm", ["install", ...PEERS], { cwd });
+    run("npm", ["install", ...PEERS, "--legacy-peer-deps"], { cwd });
   }
 }
 
@@ -470,7 +477,10 @@ async function cmdUpdate() {
   await ensureLoggedIn();
   await installSkill();
   ok("skill updated to latest");
-  if (runtimeExists() || has("--build")) {
+  // Re-pin when the runtime is fully present OR merely scaffolded (package.json on disk),
+  // so a half-installed runtime self-heals via plain `update` instead of being stranded.
+  const scaffolded = fs.existsSync(path.join(runtimeDir(), "package.json"));
+  if (runtimeExists() || scaffolded || has("--build")) {
     await ensureRuntime({ force: true });
     ok("shared runtime re-pinned — every linked prototype now uses the latest Calo stack");
   } else {
@@ -487,6 +497,7 @@ function help() {
   ${c.dim("init --isolated")}                          install the Calo stack into THIS folder (no shared runtime)
   ${c.dim("init --skip-packages")}                      skill only (no runtime)
   ${c.dim("update")}                                    refresh the skill + re-pin the shared runtime (all linked prototypes float to latest)
+  ${c.dim("    update --clean")}                          re-pin with a from-scratch runtime rebuild (only if the tree is corrupted)
   ${c.dim("logout")}                                    forget the saved Calo session
   ${c.dim("push")}                                      publish THIS prototype to the Calo Mirror (login only — no EAS/Tigris creds needed)
   ${c.dim("    push --slug x --title \"…\" --owner \"…\" --screenshot path  --dry-run  --direct")}

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@calo-design/cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "One-line setup for Calo design tooling: logs in with your Calo email and installs the calo-design skill + design-system packages. No GitHub account needed.",
-  "bin": { "calo-design": "bin/cli.js" },
-  "files": ["bin"],
-  "publishConfig": { "access": "public" },
+  "bin": {
+    "calo-design": "bin/cli.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "UNLICENSED",
-  "engines": { "node": ">=18" }
+  "engines": {
+    "node": ">=18"
+  }
 }