veylix-cli 1.3.0 → 1.4.0

package/README.md

@@ -96,6 +96,7 @@ veylix pull > .env              # or write a .env file
 | `veylix push [--file .env] [--replace] [--dry-run] [--yes]` | Upload a `.env` file (needs a read-write token). Shows the changes first and asks before deleting anything |
 | `veylix set KEY=value [KEY2=value…]` | Create or update variables |
 | `veylix unset KEY` | Delete a variable |
+| `veylix diff <env> <other-env> [--all] [--fail-on-missing]` | Compare two environments: keys missing on either side (names only) |
 | `veylix help` / `veylix --version` | Show help or the version |
 
 Every command accepts `--project <name|id>` and `--env <name>` to override the folder link.
@@ -119,6 +120,9 @@ veylix pull --output .env.local
 veylix push --file .env.production --env production --replace --dry-run   # preview only
 veylix push --file .env.production --env production --replace             # asks before deleting
 
+# Find keys missing from production (exit 1 in CI if any)
+veylix diff development production --fail-on-missing
+
 # Quick edits
 veylix set STRIPE_KEY=sk_live_… FEATURE_FLAG=true
 veylix unset LEGACY_API_URL

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veylix-cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Veylix CLI: pull, inject and sync environment variables from Veylix into your apps, shells and CI pipelines. Zero dependencies.",
   "keywords": [
     "veylix",

package/veylix.mjs

@@ -8,7 +8,7 @@ import { homedir } from "node:os";
 import { dirname, join, relative } from "node:path";
 import { createInterface } from "node:readline/promises";
 
-const VERSION = "1.3.0";
+const VERSION = "1.4.0";
 const DEFAULT_URL = "https://veylix-omega.vercel.app";
 const CONFIG_PATH = join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "veylix", "config.json");
 // Per-folder project/environment choice (no secrets, safe to commit).
@@ -33,6 +33,8 @@ Usage:
                                       the file and asks before deleting (--yes skips the question)
   veylix set KEY=value [KEY2=value…]
   veylix unset KEY
+  veylix diff <env> <other-env> [--all] [--fail-on-missing]
+                                      Compare two environments (key names only, never values)
 
   Every command accepts --project <name> and --env <name> to override the link.
 
@@ -388,6 +390,36 @@ const commands = {
     success(`${where(res)}: ${res.created} created, ${res.updated} updated${res.deleted ? `, ${res.deleted} deleted` : ""}`);
   },
 
+  async diff(args, flags) {
+    const linked = target(flags).env;
+    const [envA, envB] = args.length >= 2 ? args : [linked, args[0]];
+    if (!envA || !envB) fail("Usage: veylix diff <env> <other-env>   (or `veylix diff <other-env>` in a linked folder)");
+    const [a, b] = await Promise.all([fetchSecrets({ ...flags, env: envA }), fetchSecrets({ ...flags, env: envB })]);
+    const keys = [...new Set([...Object.keys(a.secrets), ...Object.keys(b.secrets)])].sort();
+    const missing = [];
+    let different = 0;
+    let same = 0;
+    const width = Math.max(0, ...keys.map((k) => k.length));
+    info(`${c(1, `${a.project} › ${a.environment}`)} ↔ ${c(1, b.environment)}`);
+    for (const key of keys) {
+      if (!(key in b.secrets)) {
+        missing.push(key);
+        info(`  ${c(31, "-")} ${key.padEnd(width)}  ${c(31, `missing in ${b.environment}`)}`);
+      } else if (!(key in a.secrets)) {
+        missing.push(key);
+        info(`  ${c(31, "-")} ${key.padEnd(width)}  ${c(31, `missing in ${a.environment}`)}`);
+      } else if (a.secrets[key] !== b.secrets[key]) {
+        different++;
+        if (flags.all) info(`  ${c(33, "~")} ${key.padEnd(width)}  ${c(2, "different")}`);
+      } else {
+        same++;
+        if (flags.all) info(`  ${c(2, "=")} ${key.padEnd(width)}  ${c(2, "same value")}`);
+      }
+    }
+    info(c(2, `  ${missing.length} missing · ${different} different · ${same} same${flags.all ? "" : "  (--all lists every key)"}`));
+    if (missing.length && flags["fail-on-missing"]) process.exit(1);
+  },
+
   async set(args, flags) {
     const pairs = args.map((a) => a.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/s));
     if (!pairs.length || pairs.some((p) => !p)) fail("Usage: veylix set KEY=value [KEY2=value…]");