sphere-cli 0.1.4 → 0.1.7

package/README.md

@@ -49,6 +49,9 @@ sh install.sh --uninstall
 ## Quick start
 
 ```sh
+# Activate your license (once)
+sphere license activate sphere_xxxxxxxxxxxxxxxxxxxx
+
 # Generate synthetic data
 sphere generate real.csv -o synth.csv
 
@@ -63,6 +66,22 @@ sphere certify real.csv synth.csv -o report.html
 
 ## Commands
 
+### `sphere license`
+
+Activate and manage your SPHERE license. A valid license is required to use `generate`, `evaluate`, and `certify`.
+
+```
+sphere license activate [KEY]   # Activate with a sphere_… key (prompts if omitted)
+sphere license status           # Check current license (validates online, falls back to cache)
+sphere license clear            # Remove stored key and cache
+```
+
+The key is stored at `~/.config/sphere/license_key` (mode 0600). After a successful activation the license is cached locally for **7 days**, so the CLI works offline within that window.
+
+> Don't have a license? Contact [zihuai@stanford.edu](mailto:zihuai@stanford.edu) or visit [sphere.stanford.edu](https://sphere.stanford.edu).
+
+---
+
 ### `sphere generate`
 
 ```
@@ -118,6 +137,8 @@ sphere evaluate real.csv synth.csv --json > metrics.json
 
 | Variable | Description |
 |---|---|
+| `SPHERE_LICENSE_REQUIRED` | Set to `false` to bypass license checks (research / unlocked builds) |
+| `SPHERE_WORKER_URL` | Override the license validation endpoint |
 | `SPHERE_PREFIX` | Override install prefix |
 | `SPHERE_VERSION` | Pin a release tag, e.g. `v0.1.0` |
 | `SPHERE_BUNDLE_URL` | Full URL to a `sphere-cli-*.tar.gz` (skip auto-detect) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sphere-cli",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "SPHERE CLI — synthetic data generation, evaluation, and certification",
   "keywords": ["synthetic-data", "privacy", "cli", "data-science"],
   "homepage": "https://github.com/statzihuai/sphere-cli",

package/scripts/postinstall.js

@@ -77,14 +77,25 @@ async function main() {
   const nativeDir = path.join(PKG_DIR, 'native');
   const tmpTar    = path.join(os.tmpdir(), `sphere-cli-install-${process.pid}.tar.gz`);
 
-  // Already installed (e.g. re-running postinstall manually)
-  const binaryPath = path.join(nativeDir, 'sphere-cli', 'sphere');
-  if (fs.existsSync(binaryPath)) {
-    console.log('✓ SPHERE CLI binary already present — skipping download.');
+  // Re-download whenever the installed version doesn't match the package version.
+  // This ensures `npm install -g sphere-cli` or `npm update -g sphere-cli` always
+  // delivers the correct binary even when one is already present from a prior release.
+  const binaryPath  = path.join(nativeDir, 'sphere-cli', 'sphere');
+  const markerPath  = path.join(nativeDir, '.sphere-cli-version');
+  const installedVer = fs.existsSync(markerPath)
+    ? fs.readFileSync(markerPath, 'utf8').trim()
+    : null;
+
+  if (fs.existsSync(binaryPath) && installedVer === VERSION) {
+    console.log(`✓ SPHERE CLI v${VERSION} already installed — skipping download.`);
     return;
   }
 
-  console.log(`\nDownloading SPHERE CLI v${VERSION} for ${platform} …`);
+  if (installedVer && installedVer !== VERSION) {
+    console.log(`\nUpgrading SPHERE CLI ${installedVer} → ${VERSION} for ${platform} …`);
+  } else {
+    console.log(`\nDownloading SPHERE CLI v${VERSION} for ${platform} …`);
+  }
   console.log(`  ${url}\n`);
 
   try {
@@ -109,6 +120,9 @@ async function main() {
   // Ensure the binary is executable
   fs.chmodSync(binaryPath, 0o755);
 
+  // Write version marker so future postinstall runs can detect upgrades
+  fs.writeFileSync(markerPath, VERSION, 'utf8');
+
   console.log('✓ SPHERE CLI installed.\n');
   console.log('  Quick start:');
   console.log('    sphere generate data.csv -o synth.csv');