sphere-cli 0.2.5 → 0.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sphere-cli",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "SPHERE CLI — synthetic data generation, evaluation, and certification (sealed native binary)",
   "keywords": [
     "synthetic-data",

package/scripts/postinstall.js

@@ -24,7 +24,7 @@ const VERSION = PKG.version;
 const REPO = 'statzihuai/sphere-cli';
 // Binary release tag — decoupled from the npm package version so JS-only patch
 // releases reuse the same prebuilt/notarized binaries without re-uploading them.
-const BINARY_RELEASE = 'v0.2.5';
+const BINARY_RELEASE = 'v0.2.6';
 
 const PLATFORM = process.platform; // 'darwin' | 'linux'
 const ARCH = process.arch;         // 'arm64' | 'x64'
@@ -126,8 +126,60 @@ try {
     } catch (_) { /* best-effort; user just pays the scan on first run */ }
   }
 
+  setupGlobalPath();
+
   log(`installed sealed binary for ${KEY} ✓`);
 } catch (e) {
   fail(`failed to install binary: ${e.message}\n` +
     `You can retry with: npm rebuild sphere-cli`);
 }
+
+// ── Make `sphere` callable without manual PATH editing ──────────────────────
+// For a GLOBAL install whose prefix/bin is not already on PATH (common on HPC,
+// where users point `npm config set prefix` at a roomy shared dir like $OAK so
+// the install survives across login/compute nodes), append the bin dir to the
+// user's shell rc. Because the rc lives in the shared home dir, the `sphere`
+// command then works in every future session on every node — no reinstall.
+// Idempotent; skipped when already on PATH; opt out with SPHERE_NO_PATH_SETUP=1.
+function setupGlobalPath() {
+  try {
+    if (process.env.SPHERE_NO_PATH_SETUP === '1') return;
+    if (PLATFORM === 'win32') return;
+    const isGlobal = process.env.npm_config_global === 'true'
+      || /[\\/]lib[\\/]node_modules[\\/]sphere-cli$/.test(PKG_ROOT);
+    if (!isGlobal) return; // local installs run via `npx sphere` — no PATH needed
+
+    const prefix = process.env.npm_config_prefix
+      || path.resolve(PKG_ROOT, '..', '..', '..'); // <prefix>/lib/node_modules/sphere-cli
+    const binDir = path.join(prefix, 'bin');
+    const parts = (process.env.PATH || '').split(path.delimiter);
+    if (parts.includes(binDir)) return; // already callable — nothing to do
+
+    const os = require('os');
+    const home = os.homedir();
+    const block = `\n# added by sphere-cli — makes the \`sphere\` command available\n`
+      + `export PATH="${binDir}:$PATH"\n`;
+
+    const targets = [];
+    for (const f of ['.bashrc', '.zshrc']) {
+      const p = path.join(home, f);
+      if (fs.existsSync(p)) targets.push(p);
+    }
+    if (targets.length === 0) targets.push(path.join(home, '.bashrc')); // create one
+
+    const wrote = [];
+    for (const rc of targets) {
+      let cur = '';
+      try { cur = fs.readFileSync(rc, 'utf8'); } catch (_) {}
+      if (cur.includes(binDir)) continue; // idempotent
+      try { fs.appendFileSync(rc, block); wrote.push(path.basename(rc)); } catch (_) {}
+    }
+
+    if (wrote.length) {
+      log(`PATH: added ${binDir} to ${wrote.join(', ')} — \`sphere\` will work in new shells (and on every node, since home is shared).`);
+      log(`for THIS shell now:  export PATH="${binDir}:$PATH"`);
+    } else {
+      log(`to run \`sphere\`, add to your shell rc:  export PATH="${binDir}:$PATH"`);
+    }
+  } catch (_) { /* best-effort; never fail the install over PATH setup */ }
+}