@quonfig/cli 0.0.14 → 0.0.15

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.14 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.15 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -59,7 +59,7 @@ USAGE
 * [`qfg whoami`](#qfg-whoami)
 * [`qfg workspace`](#qfg-workspace)
 * [`qfg workspace bootstrap`](#qfg-workspace-bootstrap)
-* [`qfg workspace switch`](#qfg-workspace-switch)
+* [`qfg workspace switch [SLUG]`](#qfg-workspace-switch-slug)
 
 ## `qfg config-schema`
 
@@ -88,7 +88,7 @@ EXAMPLES
   $ qfg config-schema --json-schema    # full JSON Schema document (copy into your editor)
 ```
 
-_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -160,7 +160,7 @@ EXAMPLES
   $ qfg set-rollout my.new.flag --environment production --true-percent 20
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/create.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -360,7 +360,7 @@ EXAMPLES
   $ qfg generate --targets node-ts -o ./dist # combine with targets
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -383,7 +383,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -415,7 +415,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -463,7 +463,7 @@ EXAMPLES
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -501,7 +501,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -531,7 +531,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -571,7 +571,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/list.ts)_
 
 ## `qfg login`
 
@@ -596,7 +596,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -619,7 +619,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -652,7 +652,7 @@ EXAMPLES
   $ qfg mcp --url http://local-app.quonfig-staging.com:3003/api/v1/mcp
 ```
 
-_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/mcp.ts)_
+_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/mcp.ts)_
 
 ## `qfg migrate`
 
@@ -706,7 +706,7 @@ EXAMPLES
   $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-config --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -744,7 +744,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -776,7 +776,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -807,7 +807,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME]`
 
@@ -851,7 +851,7 @@ EXAMPLES
   $ qfg override my.double.config --value=3.14159
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -895,7 +895,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/pull.ts)_
 
 ## `qfg schema NAME`
 
@@ -933,7 +933,7 @@ EXAMPLES
   $ qfg schema my-schema --set-json-schema=@schemas/my-schema.json --protected
 ```
 
-_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -960,7 +960,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -992,7 +992,7 @@ EXAMPLES
   $ qfg sdk-key create --environment staging --type browser
 ```
 
-_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1021,7 +1021,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1048,7 +1048,7 @@ EXAMPLES
   $ qfg sdk-key revoke a1b2c3d4-e5f6-7890-abcd-ef1234567890
 ```
 
-_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1119,7 +1119,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1196,7 +1196,7 @@ EXAMPLES
   $ qfg set-rollout my.variant.flag --environment production --weights "a:33,b:33,c:34" --hash-by user.id
 ```
 
-_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1228,7 +1228,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1330,7 +1330,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1353,7 +1353,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1376,7 +1376,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1409,15 +1409,18 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/workspace/bootstrap.ts)_
 
-## `qfg workspace switch`
+## `qfg workspace switch [SLUG]`
 
 Switch to a different workspace
 
 ```
 USAGE
-  $ qfg workspace switch [--json] [--interactive] [--no-color] [--verbose]
+  $ qfg workspace switch [SLUG] [--json] [--interactive] [--no-color] [--verbose]
+
+ARGUMENTS
+  SLUG  Workspace slug (or UUID) to switch to. Omit for an interactive picker.
 
 GLOBAL FLAGS
   --[no-]interactive  Force interactive mode
@@ -1430,9 +1433,11 @@ DESCRIPTION
 
 EXAMPLES
   $ qfg workspace switch
+
+  $ qfg workspace switch my-workspace-slug
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.15/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/workspace/switch.d.ts

@@ -1,6 +1,9 @@
 import type { JsonObj } from '../../result.js';
 import { BaseCommand } from '../../index.js';
 export default class WorkspaceSwitch extends BaseCommand {
+    static args: {
+        slug: import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
+    };
     static description: string;
     static examples: string[];
     run(): Promise<JsonObj | void>;

package/dist/commands/workspace/switch.js

@@ -1,12 +1,24 @@
+import { Args } from '@oclif/core';
 import { select } from '@inquirer/prompts';
 import { BaseCommand } from '../../index.js';
 import { getApiUrl } from '../../util/domain-urls.js';
 import { getValidAccessToken } from '../../util/get-valid-token.js';
 import { loadAuthConfig, saveAuthConfig } from '../../util/token-storage.js';
+const UUID_PATTERN = /^[\da-f]{8}(?:-[\da-f]{4}){3}-[\da-f]{12}$/i;
 export default class WorkspaceSwitch extends BaseCommand {
+    static args = {
+        slug: Args.string({
+            description: 'Workspace slug (or UUID) to switch to. Omit for an interactive picker.',
+            required: false,
+        }),
+    };
     static description = 'Switch to a different workspace';
-    static examples = ['<%= config.bin %> <%= command.id %>'];
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> my-workspace-slug',
+    ];
     async run() {
+        const { args } = await this.parse(WorkspaceSwitch);
         // Get a valid token — refresh silently if needed, error if not logged in
         let accessToken;
         try {
@@ -44,9 +56,19 @@ export default class WorkspaceSwitch extends BaseCommand {
         if (candidates.length === 0) {
             return this.err('No workspaces found for your account.');
         }
-        // Pick workspace
+        // Pick workspace: positional arg → interactive picker → auto-select if only one
         let match;
-        if (candidates.length === 1) {
+        if (args.slug) {
+            const found = UUID_PATTERN.test(args.slug)
+                ? candidates.find((w) => w.workspaceId === args.slug)
+                : candidates.find((w) => w.workspaceSlug === args.slug);
+            if (!found) {
+                const available = candidates.map((w) => w.workspaceSlug).join(', ') || '(none)';
+                return this.err(`Workspace "${args.slug}" not found. Available: ${available}.`);
+            }
+            match = found;
+        }
+        else if (candidates.length === 1) {
             match = candidates[0];
             this.log(`Only one workspace available: ${match.organizationName} / ${match.workspaceSlug}`);
         }

package/dist/commands/workspace.d.ts

@@ -4,4 +4,5 @@ export default class Workspace extends BaseCommand {
     static description: string;
     static examples: string[];
     run(): Promise<JsonObj | void>;
+    private runApiKeyMode;
 }

package/dist/commands/workspace.js

@@ -1,9 +1,18 @@
 import { BaseCommand } from '../index.js';
+import { getApiUrl } from '../util/domain-urls.js';
+import { getValidAccessToken } from '../util/get-valid-token.js';
 import { getActiveProfile, loadAuthConfig } from '../util/token-storage.js';
+const UUID_PATTERN = /^[\da-f]{8}(?:-[\da-f]{4}){3}-[\da-f]{12}$/i;
 export default class Workspace extends BaseCommand {
     static description = 'Show the current workspace';
     static examples = ['<%= config.bin %> <%= command.id %>'];
     async run() {
+        // API-key mode: resolve the workspace from QUONFIG_WORKSPACE via the server
+        // so we show the workspace the key is actually scoped to, not whatever
+        // the local OAuth config happens to point at.
+        if (process.env.QUONFIG_API_KEY) {
+            return this.runApiKeyMode();
+        }
         const authConfig = await loadAuthConfig();
         if (!authConfig || Object.keys(authConfig.profiles).length === 0) {
             return this.err('Not logged in. Run `qfg login` first.');
@@ -26,4 +35,50 @@ export default class Workspace extends BaseCommand {
             workspaceSlug,
         };
     }
+    async runApiKeyMode() {
+        const override = process.env.QUONFIG_WORKSPACE;
+        if (!override) {
+            return this.err('QUONFIG_API_KEY is set but QUONFIG_WORKSPACE is not. Set QUONFIG_WORKSPACE=<workspace-slug> (UUIDs also work).');
+        }
+        // getValidAccessToken short-circuits when QUONFIG_API_KEY is set.
+        let jwt;
+        try {
+            jwt = await getValidAccessToken();
+        }
+        catch (error) {
+            return this.err(error instanceof Error ? error.message : String(error));
+        }
+        let entries = [];
+        try {
+            const res = await fetch(`${getApiUrl()}/api/v1/userWorkspaces/list`, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${jwt}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify({ json: {} }),
+            });
+            if (!res.ok) {
+                return this.err(`Failed to resolve workspace (HTTP ${res.status}). Check that QUONFIG_API_KEY is valid.`);
+            }
+            const body = (await res.json());
+            entries = body.json ?? body ?? [];
+        }
+        catch (error) {
+            return this.err(`Failed to resolve workspace "${override}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const match = UUID_PATTERN.test(override)
+            ? entries.find((w) => w.workspaceId === override)
+            : entries.find((w) => w.workspaceSlug === override);
+        if (!match) {
+            const available = entries.map((w) => w.workspaceSlug).join(', ') || '(none)';
+            return this.err(`Workspace "${override}" not accessible with this API key. Available: ${available}.`);
+        }
+        const orgLine = match.organizationName ? `${match.organizationName} / ` : '';
+        this.log(`Workspace:    ${orgLine}${match.workspaceSlug}  (API key mode)`);
+        this.log(`ID:           ${match.workspaceId}`);
+        this.log(`Source:       QUONFIG_API_KEY + QUONFIG_WORKSPACE=${override}`);
+        return {
+            organizationName: match.organizationName,
+            workspace: match.workspaceId,
+            workspaceSlug: match.workspaceSlug,
+        };
+    }
 }

package/dist/util/get-client.js

@@ -36,7 +36,7 @@ const getClient = async (command, sdkKey, profile) => {
         }
         const workspaceOverride = profile ?? process.env.QUONFIG_WORKSPACE;
         if (!workspaceOverride) {
-            command.error('QUONFIG_API_KEY is set but no workspace was specified. Set QUONFIG_WORKSPACE=<slug-or-uuid> or pass --workspace=<slug-or-uuid>.', { exit: 1 });
+            command.error('QUONFIG_API_KEY is set but QUONFIG_WORKSPACE is not. Set QUONFIG_WORKSPACE=<workspace-slug> (UUIDs also work).', { exit: 1 });
         }
         const uuidPattern = /^[\da-f]{8}(?:-[\da-f]{4}){3}-[\da-f]{12}$/i;
         if (uuidPattern.test(workspaceOverride)) {

package/oclif.manifest.json

@@ -2526,10 +2526,17 @@
     },
     "workspace:switch": {
       "aliases": [],
-      "args": {},
+      "args": {
+        "slug": {
+          "description": "Workspace slug (or UUID) to switch to. Omit for an interactive picker.",
+          "name": "slug",
+          "required": false
+        }
+      },
       "description": "Switch to a different workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> my-workspace-slug"
       ],
       "flags": {
         "json": {
@@ -2579,5 +2586,5 @@
       ]
     }
   },
-  "version": "0.0.14"
+  "version": "0.0.15"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },