@quonfig/cli 0.0.6 → 0.0.7

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.6 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.7 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -27,7 +27,6 @@ USAGE
 <!-- commands -->
 * [`qfg config-schema`](#qfg-config-schema)
 * [`qfg create NAME`](#qfg-create-name)
-* [`qfg download`](#qfg-download)
 * [`qfg generate`](#qfg-generate)
 * [`qfg generate-new-hex-key`](#qfg-generate-new-hex-key)
 * [`qfg get [NAME]`](#qfg-get-name)
@@ -41,7 +40,10 @@ USAGE
 * [`qfg override [NAME]`](#qfg-override-name)
 * [`qfg pull`](#qfg-pull)
 * [`qfg schema NAME`](#qfg-schema-name)
-* [`qfg serve DATA-FILE`](#qfg-serve-data-file)
+* [`qfg sdk-key`](#qfg-sdk-key)
+* [`qfg sdk-key create`](#qfg-sdk-key-create)
+* [`qfg sdk-key list`](#qfg-sdk-key-list)
+* [`qfg sdk-key revoke KEYID`](#qfg-sdk-key-revoke-keyid)
 * [`qfg set-default [NAME]`](#qfg-set-default-name)
 * [`qfg set-rollout [NAME]`](#qfg-set-rollout-name)
 * [`qfg sync`](#qfg-sync)
@@ -78,7 +80,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.6/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -150,40 +152,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.6/src/commands/create.ts)_
-
-## `qfg download`
-
-Download a Datafile for a given environment
-
-```
-USAGE
-  $ qfg download [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [--environment <value>]
-    [--sdk-key <value>]
-
-FLAGS
-  --environment=<value>  environment to download
-  --sdk-key=<value>      SDK key for authentication (uses legacy download endpoint)
-
-GLOBAL FLAGS
-  -w, --workspace=<value>  Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)
-      --[no-]interactive   Force interactive mode
-      --json               Format output as json.
-      --no-color           Do not colorize output
-      --verbose            Verbose output
-
-DESCRIPTION
-  Download a Datafile for a given environment
-
-  You can serve a datafile using the `serve` command.
-
-EXAMPLES
-  $ qfg download --environment=test
-
-  $ qfg download --environment=test --sdk-key=YOUR_SDK_KEY
-```
-
-_See code: [src/commands/download.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/download.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/create.ts)_
 
 ## `qfg generate`
 
@@ -191,20 +160,20 @@ Generate type definitions for your Quonfig configuration
 
 ```
 USAGE
-  $ qfg generate [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [-o <value>] [--targets
+  $ qfg generate [--json] [--interactive] [--no-color] [--verbose] [--dir <value>] [-o <value>] [--targets
     <value>]
 
 FLAGS
   -o, --output-directory=<value>  Override the output directory for generated files
+      --dir=<value>               Path to local QUONFIG_DIR (defaults to QUONFIG_DIR env var)
       --targets=<value>           [default: react-ts] Determines for language/framework to generate code for (node-ts,
                                   react-ts)
 
 GLOBAL FLAGS
-  -w, --workspace=<value>  Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)
-      --[no-]interactive   Force interactive mode
-      --json               Format output as json.
-      --no-color           Do not colorize output
-      --verbose            Verbose output
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
 
 DESCRIPTION
   Generate type definitions for your Quonfig configuration
@@ -253,7 +222,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.6/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -276,7 +245,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -308,7 +277,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -352,7 +321,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.6/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -390,7 +359,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -408,7 +377,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -445,7 +414,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/list.ts)_
 
 ## `qfg login`
 
@@ -470,7 +439,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -493,7 +462,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -526,7 +495,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.6/src/commands/mcp.ts)_
+_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/mcp.ts)_
 
 ## `qfg override [NAME]`
 
@@ -565,7 +534,7 @@ EXAMPLES
   $ qfg override my.double.config --value=3.14159
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -609,7 +578,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/pull.ts)_
 
 ## `qfg schema NAME`
 
@@ -647,21 +616,15 @@ 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.6/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/schema.ts)_
 
-## `qfg serve DATA-FILE`
+## `qfg sdk-key`
 
-Serve a datafile on a local port
+Manage SDK keys for your workspace
 
 ```
 USAGE
-  $ qfg serve DATA-FILE [--json] [--interactive] [--no-color] [--verbose] [--port <value>]
-
-ARGUMENTS
-  DATA-FILE  file to read
-
-FLAGS
-  --port=<value>  [default: 3099] port to serve on
+  $ qfg sdk-key [--json] [--interactive] [--no-color] [--verbose]
 
 GLOBAL FLAGS
   --[no-]interactive  Force interactive mode
@@ -670,20 +633,105 @@ GLOBAL FLAGS
   --verbose           Verbose output
 
 DESCRIPTION
-  Serve a datafile on a local port
+  Manage SDK keys for your workspace
+
+EXAMPLES
+  $ qfg sdk-key list
+
+  $ qfg sdk-key create --environment production --type server
+
+  $ qfg sdk-key revoke <key-id>
+```
+
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/sdk-key.ts)_
+
+## `qfg sdk-key create`
 
-  You can download a datafile using the `download` command.
+Create a new SDK key
 
-  You'll need to update your JavaScript (or React) client to point to this server.
+```
+USAGE
+  $ qfg sdk-key create [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [-e <value>] [-t
+    server|browser]
 
-  e.g. `endpoints: ["http://localhost:3099"],`
+FLAGS
+  -e, --environment=<value>  Environment name (e.g. production, staging)
+  -t, --type=<option>        Key type: server (backend) or browser (frontend)
+                             <options: server|browser>
 
+GLOBAL FLAGS
+  -w, --workspace=<value>  Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)
+      --[no-]interactive   Force interactive mode
+      --json               Format output as json.
+      --no-color           Do not colorize output
+      --verbose            Verbose output
+
+DESCRIPTION
+  Create a new SDK key
+
+EXAMPLES
+  $ qfg sdk-key create --environment production --type server
+
+  $ qfg sdk-key create --environment staging --type browser
+```
+
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/sdk-key/create.ts)_
+
+## `qfg sdk-key list`
+
+List SDK keys for your workspace
+
+```
+USAGE
+  $ qfg sdk-key list [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [-e <value>]
+
+FLAGS
+  -e, --environment=<value>  Filter by environment name
+
+GLOBAL FLAGS
+  -w, --workspace=<value>  Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)
+      --[no-]interactive   Force interactive mode
+      --json               Format output as json.
+      --no-color           Do not colorize output
+      --verbose            Verbose output
+
+DESCRIPTION
+  List SDK keys for your workspace
+
+EXAMPLES
+  $ qfg sdk-key list
+
+  $ qfg sdk-key list --environment production
+```
+
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/sdk-key/list.ts)_
+
+## `qfg sdk-key revoke KEYID`
+
+Revoke an SDK key by its ID
+
+```
+USAGE
+  $ qfg sdk-key revoke KEYID [--json] [--interactive] [--no-color] [--verbose] [-w <value>]
+
+ARGUMENTS
+  KEYID  ID of the SDK key to revoke
+
+GLOBAL FLAGS
+  -w, --workspace=<value>  Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)
+      --[no-]interactive   Force interactive mode
+      --json               Format output as json.
+      --no-color           Do not colorize output
+      --verbose            Verbose output
+
+DESCRIPTION
+  Revoke an SDK key by its ID
 
 EXAMPLES
-  $ qfg serve ./quonfig.test.588.config.json --port=3099
+  $ qfg sdk-key revoke a1b2c3d4-e5f6-7890-abcd-ef1234567890
 ```
 
-_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/serve.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -747,7 +795,7 @@ EXAMPLES
   $ qfg set-rollout my.flag.name --environment production --true-percent 20
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -824,7 +872,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.6/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -856,7 +904,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/sync.ts)_
 
 ## `qfg verify [PATH]`
 
@@ -889,7 +937,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -912,7 +960,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -935,7 +983,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -968,7 +1016,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace switch`
 
@@ -991,7 +1039,7 @@ EXAMPLES
   $ qfg workspace switch
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.6/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.7/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/codegen/local-config-reader.d.ts

@@ -0,0 +1,6 @@
+import type { ConfigFile } from './types.js';
+export declare class LocalConfigReader {
+    private dir;
+    constructor(dir: string);
+    read(): Promise<ConfigFile>;
+}

package/dist/codegen/local-config-reader.js

@@ -0,0 +1,113 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+function mapGitValue(gitValue) {
+    const { type, value } = gitValue;
+    switch (type) {
+        case 'bool': {
+            return { value: { bool: value } };
+        }
+        case 'int': {
+            return { value: { int: value } };
+        }
+        case 'json': {
+            return { value: { json: { json: value } } };
+        }
+        case 'log_level': {
+            return { value: { logLevel: value } };
+        }
+        case 'string_list': {
+            return { value: { string: JSON.stringify(value) } };
+        }
+        case 'string':
+        default: {
+            return { value: { string: value } };
+        }
+    }
+}
+function buildRows(gitConfig) {
+    const allRules = [
+        ...(gitConfig.default?.rules ?? []),
+        ...(gitConfig.environments ?? []).flatMap((env) => env.rules),
+    ];
+    return allRules.map((rule) => ({
+        values: [mapGitValue(rule.value)],
+    }));
+}
+function mapConfigType(gitType) {
+    return gitType === 'feature_flag' ? 'FEATURE_FLAG' : 'CONFIG';
+}
+function mapValueType(gitValueType) {
+    return gitValueType.toUpperCase();
+}
+async function readJsonFiles(dir) {
+    try {
+        const entries = await fs.promises.readdir(dir);
+        const jsonFiles = entries.filter((f) => f.endsWith('.json'));
+        return Promise.all(jsonFiles.map(async (file) => {
+            const filePath = path.join(dir, file);
+            const content = await fs.promises.readFile(filePath, 'utf8');
+            return { filePath, data: JSON.parse(content) };
+        }));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+export class LocalConfigReader {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    async read() {
+        // Validate dir exists
+        try {
+            await fs.promises.access(this.dir, fs.constants.F_OK);
+        }
+        catch {
+            throw new Error(`Directory not found: ${this.dir}. Run \`qfg pull --dir ${this.dir}\` to clone it.`);
+        }
+        // Validate it's a quonfig workspace
+        const quonfigJsonPath = path.join(this.dir, 'quonfig.json');
+        try {
+            await fs.promises.access(quonfigJsonPath, fs.constants.F_OK);
+        }
+        catch {
+            throw new Error(`${this.dir} does not look like a Quonfig workspace. Is this the right directory?`);
+        }
+        // Read configs and feature-flags
+        const [configFiles, flagFiles] = await Promise.all([
+            readJsonFiles(path.join(this.dir, 'configs')),
+            readJsonFiles(path.join(this.dir, 'feature-flags')),
+        ]);
+        const configs = [];
+        for (const { filePath, data } of [...configFiles, ...flagFiles]) {
+            const gitConfig = data;
+            if (!gitConfig.key || !gitConfig.type || !gitConfig.valueType) {
+                console.warn(`Skipping malformed config file: ${filePath}`);
+                continue;
+            }
+            const rows = buildRows(gitConfig);
+            configs.push({
+                configType: mapConfigType(gitConfig.type),
+                key: gitConfig.key,
+                rows,
+                schemaKey: gitConfig.schemaKey,
+                sendToClientSdk: gitConfig.sendToClientSdk,
+                valueType: mapValueType(gitConfig.valueType),
+            });
+        }
+        // Read schemas
+        const schemaFiles = await readJsonFiles(path.join(this.dir, 'schemas'));
+        const schemas = schemaFiles.map(({ filePath, data }) => ({
+            path: filePath,
+            schema: data,
+        }));
+        if (configs.length === 0) {
+            console.warn('No configs or feature-flags found in workspace. Generated types will be empty.');
+        }
+        return { configs, schemas };
+    }
+}

package/dist/commands/create.js

@@ -105,6 +105,9 @@ Or edit the JSON config file directly for complex targeting rules:
                     configValue = confidentialValueResult.value;
                 }
             }
+            else if (valueInput.error) {
+                return this.err(valueInput.message, valueInput.json);
+            }
             else {
                 return;
             }

package/dist/commands/generate.d.ts

@@ -1,9 +1,10 @@
 import type { JsonObj } from '../result.js';
-import { APICommand } from '../index.js';
-export default class Generate extends APICommand {
+import { BaseCommand } from '../index.js';
+export default class Generate extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         'output-directory': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         targets: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
     };

package/dist/commands/generate.js

@@ -4,9 +4,9 @@ import * as path from 'node:path';
 import { z } from 'zod';
 import { NodeTypeScriptGenerator } from '../codegen/code-generators/node-typescript-generator.js';
 import { ReactTypeScriptGenerator } from '../codegen/code-generators/react-typescript-generator.js';
-import { ConfigDownloader } from '../codegen/config-downloader.js';
+import { LocalConfigReader } from '../codegen/local-config-reader.js';
 import { SupportedLanguage } from '../codegen/types.js';
-import { APICommand } from '../index.js';
+import { BaseCommand } from '../index.js';
 import { createFileManager } from '../util/file-manager.js';
 // base types
 const nodeOrReactLanguageSpecificSchema = z.object({
@@ -66,7 +66,7 @@ const DEFAULT_CONFIG = {
         },
     },
 };
-export default class Generate extends APICommand {
+export default class Generate extends BaseCommand {
     /* eslint-disable no-irregular-whitespace */
     static description = `You can use the default type-generation configuration, or by provide your own via a quonfig.config.json file:
 
@@ -108,6 +108,10 @@ Example quonfig.config.json:
         '<%= config.bin %> <%= command.id %> --targets node-ts -o ./dist # combine with targets',
     ];
     static flags = {
+        dir: Flags.string({
+            description: 'Path to local QUONFIG_DIR (defaults to QUONFIG_DIR env var)',
+            env: 'QUONFIG_DIR',
+        }),
         'output-directory': Flags.string({
             char: 'o',
             description: 'Override the output directory for generated files',
@@ -121,18 +125,22 @@ Example quonfig.config.json:
     async run() {
         const { flags } = await this.parse(Generate);
         this.verboseLog('=== GENERATE COMMAND START ===');
-        this.verboseLog(`Base API URL: ${process.env.QUONFIG_API_URL || 'Default'}`);
         try {
+            // Resolve workspace directory
+            const dir = flags.dir;
+            if (!dir) {
+                this.error('No directory specified. Run `qfg pull` first or pass --dir <path>.');
+            }
             // Look for and read local quonfig.config.json file
             const localConfig = await this.readLocalConfig(flags['output-directory']);
-            // Use tarets flag override, otherwise fall back to local config
+            // Use targets flag override, otherwise fall back to local config
             const targets = flags.targets.split(',') || Object.keys(localConfig);
             this.verboseLog(`Language(s): ${targets.join(', ')}`);
-            // Download the configuration using the APICommand's client
-            const downloader = new ConfigDownloader(this);
-            this.verboseLog('Downloading config...');
-            const configFile = await downloader.downloadConfig();
-            this.verboseLog('Config download complete.');
+            // Read configuration from local directory
+            const reader = new LocalConfigReader(dir);
+            this.verboseLog(`Reading config from ${dir}...`);
+            const configFile = await reader.read();
+            this.verboseLog(`Config read complete. Found ${configFile.configs.length} configs.`);
             const fileCreationPromises = [];
             for (const target of targets) {
                 // Resolve the language input

package/dist/commands/login.js

@@ -133,8 +133,11 @@ export default class Login extends BaseCommand {
         else if (orgId) {
             this.log(`Organization: ${orgId}`);
         }
-        if (multipleWorkspacesAvailable) {
-            this.log(`\nTo switch workspaces: qfg workspace switch`);
+        if (multipleWorkspacesAvailable && workspaceSlug) {
+            this.log(`\nYou have multiple workspaces. To pin this project to ${workspaceSlug},`);
+            this.log(`add this to your project's .env file:`);
+            this.log(`  QUONFIG_WORKSPACE=${workspaceSlug}`);
+            this.log(`\nTo switch your default workspace: qfg workspace switch`);
         }
         return {
             email: userEmail,

package/dist/commands/sdk-key/create.d.ts

@@ -0,0 +1,11 @@
+import type { JsonObj } from '../../result.js';
+import { APICommand } from '../../index.js';
+export default class SdkKeyCreate extends APICommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        environment: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        type: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<JsonObj | void>;
+}