@lumerahq/cli 0.19.26 → 0.20.0-dev.1

package/README.md

@@ -32,6 +32,9 @@ lumera show <resource>     # Show resource details
 lumera destroy             # Delete remote resources
 
 lumera run <target>        # Run script, automation, or invoke agent
+
+lumera flags list          # List this sandbox's feature flags
+lumera flags get <key>     # Print one flag's value (--default <v> if unset)
 ```
 
 ## Scaffolding Projects

package/dist/flags-UZW4D2SO.js

@@ -0,0 +1,97 @@
+import "./chunk-PNKVD2UK.js";
+
+// src/commands/flags.ts
+import pc from "picocolors";
+
+// src/lib/flags.ts
+import { readFileSync, statSync } from "fs";
+var ENV_PATH = "LUMERA_FEATURE_FLAGS_PATH";
+var DEFAULT_PATH = "/opt/lumera/feature-flags/flags.json";
+function flagsPath() {
+  return process.env[ENV_PATH] || DEFAULT_PATH;
+}
+var cache = null;
+function featureFlags() {
+  const path = flagsPath();
+  let key;
+  try {
+    key = `${path}:${statSync(path).mtimeMs}`;
+  } catch {
+    return {};
+  }
+  if (cache && cache.key === key) return cache.flags;
+  let flags2 = {};
+  try {
+    const data = JSON.parse(readFileSync(path, "utf-8"));
+    if (data && typeof data === "object" && data.flags && typeof data.flags === "object") {
+      flags2 = data.flags;
+    }
+  } catch {
+    flags2 = {};
+  }
+  cache = { key, flags: flags2 };
+  return flags2;
+}
+
+// src/commands/flags.ts
+async function flags(subcommand, args) {
+  switch (subcommand) {
+    case "get": {
+      const key = args[0];
+      if (!key) {
+        console.error(pc.red("Usage: lumera flags get <key> [--default <value>]"));
+        process.exit(1);
+      }
+      const defIdx = args.indexOf("--default");
+      if (defIdx !== -1 && args[defIdx + 1] === void 0) {
+        console.error(pc.red("--default requires a value"));
+        process.exit(1);
+      }
+      const fallback = defIdx !== -1 ? args[defIdx + 1] : void 0;
+      const all = featureFlags();
+      if (!(key in all)) {
+        if (fallback !== void 0) {
+          emit(fallback);
+          return;
+        }
+        process.exit(1);
+      }
+      emit(all[key]);
+      break;
+    }
+    case void 0:
+    case "list": {
+      const all = featureFlags();
+      if (process.env.LUMERA_JSON === "1") {
+        console.log(JSON.stringify(all, null, 2));
+        break;
+      }
+      const keys = Object.keys(all).sort();
+      if (keys.length === 0) {
+        console.log(pc.dim("No feature flags available."));
+        break;
+      }
+      for (const k of keys) {
+        console.log(`${pc.cyan(k)} = ${formatValue(all[k])}`);
+      }
+      break;
+    }
+    default:
+      console.error(pc.red(`Unknown flags subcommand: ${subcommand}`));
+      console.error("Usage: lumera flags [list | get <key> [--default <value>]]");
+      process.exit(1);
+  }
+}
+function formatValue(v) {
+  return typeof v === "string" ? v : JSON.stringify(v);
+}
+function emit(v) {
+  if (process.env.LUMERA_JSON === "1") {
+    console.log(JSON.stringify(v));
+    return;
+  }
+  console.log(formatValue(v));
+}
+export {
+  flags
+};

package/dist/index.js

@@ -95,6 +95,7 @@ var COMMANDS = [
   "migrate",
   "skills",
   "deps",
+  "flags",
   "login",
   "logout",
   "whoami"
@@ -162,6 +163,10 @@ ${pc.dim("Skills:")}
   ${pc.cyan("skills install")}           Install skills
   ${pc.cyan("skills update")}            Update skills
 
+${pc.dim("Feature Flags:")}
+  ${pc.cyan("flags list")}               List feature flags in this sandbox
+  ${pc.cyan("flags get")} <key>          Print one flag's value (--default <v> if unset)
+
 ${pc.dim("Auth:")}
   ${pc.cyan("login")}                    Login to Lumera
   ${pc.cyan("logout")}                   Clear credentials
@@ -189,6 +194,8 @@ ${pc.dim("Examples:")}
   lumera run automations/sync         # Trigger automation
   lumera run agents/support "Hello"   # Invoke an agent
   lumera dev                          # Start dev server
+  lumera flags list                   # List this sandbox's feature flags
+  lumera flags get studio_browser --default false   # one flag (fallback if unset)
 
 ${pc.dim("Documentation:")}
   https://docs.lumerahq.com/cli
@@ -270,6 +277,10 @@ async function main() {
       case "deps":
         await import("./deps-HWO6X5WM.js").then((m) => m.deps(args.slice(1)));
         break;
+      // Feature flags (read the in-sandbox snapshot)
+      case "flags":
+        await import("./flags-UZW4D2SO.js").then((m) => m.flags(subcommand, args.slice(2)));
+        break;
       // Auth
       case "login":
         await import("./auth-NI7JTMJM.js").then((m) => m.login(args.slice(1)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.19.26",
+  "version": "0.20.0-dev.1",
   "description": "CLI for building and deploying Lumera apps",
   "type": "module",
   "engines": {
@@ -16,6 +16,7 @@
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean",
     "dev": "tsup src/index.ts --format esm --watch",
+    "test": "rm -rf dist-test && tsc -p tsconfig.test.json && node --test 'dist-test/**/*.test.js'",
     "prepublishOnly": "pnpm build"
   },
   "dependencies": {