@quonfig/cli 0.0.8 → 0.0.10

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.8 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.10 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -27,6 +27,9 @@ USAGE
 <!-- commands -->
 * [`qfg config-schema`](#qfg-config-schema)
 * [`qfg create NAME`](#qfg-create-name)
+* [`qfg flag info [NAME]`](#qfg-flag-info-name)
+* [`qfg flag list`](#qfg-flag-list)
+* [`qfg flag show [NAME]`](#qfg-flag-show-name)
 * [`qfg generate`](#qfg-generate)
 * [`qfg generate-new-hex-key`](#qfg-generate-new-hex-key)
 * [`qfg get [NAME]`](#qfg-get-name)
@@ -47,6 +50,7 @@ USAGE
 * [`qfg set-default [NAME]`](#qfg-set-default-name)
 * [`qfg set-rollout [NAME]`](#qfg-set-rollout-name)
 * [`qfg sync`](#qfg-sync)
+* [`qfg toggle [NAME]`](#qfg-toggle-name)
 * [`qfg verify [PATH]`](#qfg-verify-path)
 * [`qfg whoami`](#qfg-whoami)
 * [`qfg workspace`](#qfg-workspace)
@@ -80,7 +84,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.8/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -152,7 +156,137 @@ 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.8/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/create.ts)_
+
+## `qfg flag info [NAME]`
+
+Show current values, rules, and evaluation stats for a flag or config.
+
+```
+USAGE
+  $ qfg flag info [NAME] [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [--exclude-evaluations]
+
+ARGUMENTS
+  NAME  config/feature-flag/etc. name
+
+FLAGS
+  --exclude-evaluations  Exclude evaluation data
+
+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
+  Show current values, rules, and evaluation stats for a flag or config.
+
+  Output shows the value for each environment:
+  - A simple value (true / false / "hello") means a single unconditional rule.
+  - "[see rules]" means the environment has targeting rules or a percentage rollout.
+  - "[inherit]" means the environment falls back to the Default value.
+
+  Percentage rollouts are displayed as "20.0% true, 80.0% false".
+  Evaluation counts for the past 24 hours are included by default.
+
+  Related commands:
+  qfg set-default my.flag --environment production --value true   # set a scalar fallback
+  qfg set-rollout my.flag --environment production --true-percent 20  # set a % rollout
+
+ALIASES
+  $ qfg flag show
+  $ qfg flag info
+
+EXAMPLES
+  $ qfg flag info my.config.name
+
+  $ qfg flag info my.config.name --exclude-evaluations   # skip 24h stats
+```
+
+## `qfg flag list`
+
+Show keys for your config/feature flags/etc.
+
+```
+USAGE
+  $ qfg flag list [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [--configs] [--feature-flags]
+    [--log-levels] [--schemas] [--segments]
+
+FLAGS
+  --configs        include configs
+  --feature-flags  include flags
+  --log-levels     include log levels
+  --schemas        include schemas
+  --segments       include segments
+
+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
+  Show keys for your config/feature flags/etc.
+
+  All types are returned by default. If you pass one or more type flags (e.g. --configs), only those types will be
+  returned
+
+ALIASES
+  $ qfg flag list
+
+EXAMPLES
+  $ qfg flag list
+
+  $ qfg flag list --feature-flags
+```
+
+## `qfg flag show [NAME]`
+
+Show current values, rules, and evaluation stats for a flag or config.
+
+```
+USAGE
+  $ qfg flag show [NAME] [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [--exclude-evaluations]
+
+ARGUMENTS
+  NAME  config/feature-flag/etc. name
+
+FLAGS
+  --exclude-evaluations  Exclude evaluation data
+
+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
+  Show current values, rules, and evaluation stats for a flag or config.
+
+  Output shows the value for each environment:
+  - A simple value (true / false / "hello") means a single unconditional rule.
+  - "[see rules]" means the environment has targeting rules or a percentage rollout.
+  - "[inherit]" means the environment falls back to the Default value.
+
+  Percentage rollouts are displayed as "20.0% true, 80.0% false".
+  Evaluation counts for the past 24 hours are included by default.
+
+  Related commands:
+  qfg set-default my.flag --environment production --value true   # set a scalar fallback
+  qfg set-rollout my.flag --environment production --true-percent 20  # set a % rollout
+
+ALIASES
+  $ qfg flag show
+  $ qfg flag info
+
+EXAMPLES
+  $ qfg flag show my.config.name
+
+  $ qfg flag show my.config.name --exclude-evaluations   # skip 24h stats
+```
 
 ## `qfg generate`
 
@@ -222,7 +356,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.8/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -245,7 +379,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -277,7 +411,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -315,13 +449,17 @@ DESCRIPTION
   qfg set-default my.flag --environment production --value true   # set a scalar fallback
   qfg set-rollout my.flag --environment production --true-percent 20  # set a % rollout
 
+ALIASES
+  $ qfg flag show
+  $ qfg flag info
+
 EXAMPLES
   $ qfg info my.config.name
 
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -359,7 +497,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -377,7 +515,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -408,13 +546,16 @@ DESCRIPTION
   All types are returned by default. If you pass one or more type flags (e.g. --configs), only those types will be
   returned
 
+ALIASES
+  $ qfg flag list
+
 EXAMPLES
   $ qfg list
 
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/list.ts)_
 
 ## `qfg login`
 
@@ -439,7 +580,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -462,7 +603,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -495,7 +636,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.8/src/commands/mcp.ts)_
+_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/mcp.ts)_
 
 ## `qfg override [NAME]`
 
@@ -534,7 +675,7 @@ EXAMPLES
   $ qfg override my.double.config --value=3.14159
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -578,7 +719,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/pull.ts)_
 
 ## `qfg schema NAME`
 
@@ -616,7 +757,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.8/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -643,7 +784,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -675,7 +816,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.8/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -704,7 +845,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -731,7 +872,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.8/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -779,6 +920,9 @@ DESCRIPTION
   To see all current values and rules for a flag:
   qfg info my.flag
 
+ALIASES
+  $ qfg toggle
+
 EXAMPLES
   $ qfg set-default my.flag.name                                          # prompts for value and env
 
@@ -795,7 +939,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.8/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -872,7 +1016,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.8/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -904,7 +1048,72 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/sync.ts)_
+
+## `qfg toggle [NAME]`
+
+Set the unconditional fallback value for a flag or config in a specific environment.
+
+```
+USAGE
+  $ qfg toggle [NAME] [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [--confidential]
+    [--env-var <value>] [--environment <value>] [--value <value>] [--confirm] [--secret] [--secret-key-name <value>]
+
+ARGUMENTS
+  NAME  config/feature-flag/etc. name
+
+FLAGS
+  --confidential             mark the value as confidential
+  --confirm                  confirm without prompt
+  --env-var=<value>          environment variable to use as default value
+  --environment=<value>      environment to change
+  --secret                   encrypt the value of this item
+  --secret-key-name=<value>  [default: quonfig.secrets.encryption.key] name of the secret key to use for
+                             encryption/decryption
+  --value=<value>            new default value
+
+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
+  Set the unconditional fallback value for a flag or config in a specific environment.
+
+  This updates the catch-all rule — the value users receive when NO targeting rule matches.
+  Any targeting rules or percentage rollouts you have configured are NOT affected; they
+  continue to fire before this fallback is evaluated.
+
+  "Other rules still apply" means: if you have rules targeting specific users, segments,
+  or properties, those rules still take priority. This command only changes what everyone
+  else sees.
+
+  To set a percentage rollout (gradual rollout / A/B test / canary deploy) instead:
+  qfg set-rollout my.flag --environment production --true-percent 20
+
+  To see all current values and rules for a flag:
+  qfg info my.flag
+
+ALIASES
+  $ qfg toggle
+
+EXAMPLES
+  $ qfg toggle my.flag.name                                          # prompts for value and env
+
+  $ qfg toggle my.flag.name --value=true --environment=staging
+
+  $ qfg toggle my.flag.name --value=false --environment=production   # kill-switch: turn off for everyone
+
+  $ qfg toggle my.flag.name --value=true --secret
+
+  $ qfg toggle my.config.name --env-var=MY_ENV_VAR_NAME --environment=production
+
+  # For a percentage rollout, use set-rollout instead:
+
+  $ qfg set-rollout my.flag.name --environment production --true-percent 20
+```
 
 ## `qfg verify [PATH]`
 
@@ -937,7 +1146,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -960,7 +1169,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -983,7 +1192,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1016,7 +1225,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.8/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace switch`
 
@@ -1039,7 +1248,7 @@ EXAMPLES
   $ qfg workspace switch
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.8/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.10/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/info.d.ts

@@ -1,6 +1,7 @@
 import { APICommand } from '../index.js';
 import { JsonObj } from '../result.js';
 export default class Info extends APICommand {
+    static aliases: string[];
     static args: {
         name: import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
     };

package/dist/commands/info.js

@@ -6,6 +6,7 @@ import { getAppUrl } from '../util/domain-urls.js';
 import isInteractive from '../util/is-interactive.js';
 import nameArg from '../util/name-arg.js';
 export default class Info extends APICommand {
+    static aliases = ['flag:show', 'flag:info'];
     static args = { ...nameArg };
     static description = `Show current values, rules, and evaluation stats for a flag or config.
 

package/dist/commands/list.d.ts

@@ -1,5 +1,6 @@
 import { APICommand } from '../index.js';
 export default class List extends APICommand {
+    static aliases: string[];
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/list.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import { APICommand } from '../index.js';
 export default class List extends APICommand {
+    static aliases = ['flag:list'];
     static description = `Show keys for your config/feature flags/etc.
 
   All types are returned by default. If you pass one or more type flags (e.g. --configs), only those types will be returned`;

package/dist/commands/set-default.d.ts

@@ -1,6 +1,7 @@
 import { APICommand } from '../index.js';
 import { JsonObj } from '../result.js';
 export default class SetDefault extends APICommand {
+    static aliases: string[];
     static args: {
         name: import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
     };

package/dist/commands/set-default.js

@@ -13,6 +13,7 @@ import isInteractive from '../util/is-interactive.js';
 import nameArg from '../util/name-arg.js';
 import secretFlags, { parsedSecretFlags } from '../util/secret-flags.js';
 export default class SetDefault extends APICommand {
+    static aliases = ['toggle'];
     static args = { ...nameArg };
     static description = `Set the unconditional fallback value for a flag or config in a specific environment.
 

package/dist/commands/set-rollout.d.ts

@@ -17,3 +17,21 @@ export default class SetRollout extends APICommand {
     private parseWeights;
     private coerceValue;
 }
+/**
+ * Pick a short, stable variant name from a rollout value. Uses the first
+ * 10 characters of the stringified value, then dedupes collisions by
+ * appending `-2`, `-3`, ... so each name is unique within the set.
+ */
+export declare function synthesizeVariants(weightedValues: Array<{
+    value: {
+        type: string;
+        value: unknown;
+    };
+    weight: number;
+}>): Array<{
+    name: string;
+    value: {
+        type: string;
+        value: unknown;
+    };
+}>;

package/dist/commands/set-rollout.js

@@ -165,7 +165,20 @@ To inspect the current rollout:
         const updatedEnvironments = hasEnv
             ? existingEnvs.map((e) => (e.id === envKey ? { ...e, rules: [newRule] } : e))
             : [...existingEnvs, { id: envKey, rules: [newRule] }];
-        const updateFields = { environments: updatedEnvironments };
+        // Auto-create variants when the config has none. The UI cannot render a
+        // rollout without named variants, and the server/gitea verify now rejects
+        // it. Bool configs are exempt — the UI supplies implicit true/false variants.
+        const existingVariants = currentConfig.variants ?? [];
+        const updateFields = {
+            environments: updatedEnvironments,
+        };
+        if (existingVariants.length === 0 && config.valueType !== 'bool') {
+            const synthesized = synthesizeVariants(weightedValues);
+            if (synthesized.length > 0) {
+                updateFields.variants = synthesized;
+                this.log(`${checkmark} Auto-created ${synthesized.length} variant${synthesized.length === 1 ? '' : 's'}: ${synthesized.map((v) => v.name).join(', ')}`);
+            }
+        }
         this.verboseLog('Update fields:', JSON.stringify(updateFields, null, 2));
         let request;
         if (config.type === 'feature_flag') {
@@ -229,32 +242,57 @@ To inspect the current rollout:
         return { ok: true, weights };
     }
     coerceValue(raw, valueType) {
-        const type = valueType.toLowerCase();
-        switch (type) {
-            case 'bool': {
-                if (raw !== 'true' && raw !== 'false') {
-                    return { error: `Invalid boolean value "${raw}". Must be "true" or "false".`, ok: false };
-                }
-                return { ok: true, typed: { type: 'bool', value: raw === 'true' } };
-            }
-            case 'int': {
-                const n = Number.parseInt(raw, 10);
-                if (Number.isNaN(n)) {
-                    return { error: `Invalid int value "${raw}".`, ok: false };
-                }
-                return { ok: true, typed: { type: 'int', value: n } };
+        return coerceValue(raw, valueType);
+    }
+}
+/**
+ * Pick a short, stable variant name from a rollout value. Uses the first
+ * 10 characters of the stringified value, then dedupes collisions by
+ * appending `-2`, `-3`, ... so each name is unique within the set.
+ */
+export function synthesizeVariants(weightedValues) {
+    const used = new Set();
+    const variants = [];
+    for (const wv of weightedValues) {
+        const raw = typeof wv.value.value === 'string' ? wv.value.value : JSON.stringify(wv.value.value);
+        const base = (raw || wv.value.type).slice(0, 10);
+        let name = base;
+        let suffix = 2;
+        while (used.has(name)) {
+            name = `${base}-${suffix}`;
+            suffix += 1;
+        }
+        used.add(name);
+        variants.push({ name, value: wv.value });
+    }
+    return variants;
+}
+function coerceValue(raw, valueType) {
+    const type = valueType.toLowerCase();
+    switch (type) {
+        case 'bool': {
+            if (raw !== 'true' && raw !== 'false') {
+                return { error: `Invalid boolean value "${raw}". Must be "true" or "false".`, ok: false };
             }
-            case 'double': {
-                const n = Number.parseFloat(raw);
-                if (Number.isNaN(n)) {
-                    return { error: `Invalid double value "${raw}".`, ok: false };
-                }
-                return { ok: true, typed: { type: 'double', value: n } };
+            return { ok: true, typed: { type: 'bool', value: raw === 'true' } };
+        }
+        case 'int': {
+            const n = Number.parseInt(raw, 10);
+            if (Number.isNaN(n)) {
+                return { error: `Invalid int value "${raw}".`, ok: false };
             }
-            default: {
-                // string, json, etc — pass as-is
-                return { ok: true, typed: { type, value: raw } };
+            return { ok: true, typed: { type: 'int', value: n } };
+        }
+        case 'double': {
+            const n = Number.parseFloat(raw);
+            if (Number.isNaN(n)) {
+                return { error: `Invalid double value "${raw}".`, ok: false };
             }
+            return { ok: true, typed: { type: 'double', value: n } };
+        }
+        default: {
+            // string, json, etc — pass as-is
+            return { ok: true, typed: { type, value: raw } };
         }
     }
 }

package/dist/hooks/init/friction-log.d.ts

@@ -0,0 +1,3 @@
+import { Hook } from '@oclif/core';
+declare const hook: Hook<'init'>;
+export default hook;

package/dist/hooks/init/friction-log.js

@@ -0,0 +1,28 @@
+import { appendFrictionEntry, buildFrictionEntry, extractLastErrorLine, getFrictionLogPath, installStderrCapture, } from '../../util/friction-log.js';
+let installed = false;
+const hook = async function ({ config: _config }) {
+    if (installed)
+        return;
+    installed = true;
+    const logPath = getFrictionLogPath(process.env.QFG_FRICTION_LOG);
+    if (!logPath)
+        return;
+    const readCapturedStderr = installStderrCapture();
+    const originalArgv = process.argv.slice(2);
+    process.on('exit', (code) => {
+        if (code === 0)
+            return;
+        try {
+            const entry = buildFrictionEntry({
+                argv: originalArgv,
+                error: extractLastErrorLine(readCapturedStderr()),
+                exitCode: code,
+            });
+            appendFrictionEntry(logPath, entry);
+        }
+        catch {
+            // never fail a CLI invocation because of friction logging
+        }
+    });
+};
+export default hook;

package/dist/init/samples.js

@@ -41,7 +41,6 @@ export const SAMPLE_FILES = [
             key: 'example.dark-mode',
             type: 'feature_flag',
             valueType: 'bool',
-            sendToClientSdk: true,
             description: 'Enable dark mode UI.',
             default: {
                 rules: [

package/dist/util/friction-log.d.ts

@@ -0,0 +1,17 @@
+export interface FrictionEntry {
+    attempted: string;
+    error: string;
+    exitCode: number;
+    ts: string;
+}
+export declare function getFrictionLogPath(envValue: string | undefined, cwd?: string): null | string;
+export declare function buildFrictionEntry(opts: {
+    argv?: string[];
+    binName?: string;
+    error?: string;
+    exitCode: number;
+    now?: Date;
+}): FrictionEntry;
+export declare function appendFrictionEntry(logPath: string, entry: FrictionEntry): void;
+export declare function extractLastErrorLine(stderr: string): string | undefined;
+export declare function installStderrCapture(): () => string;

package/dist/util/friction-log.js

@@ -0,0 +1,56 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export function getFrictionLogPath(envValue, cwd = process.cwd()) {
+    if (envValue === undefined)
+        return null;
+    const trimmed = envValue.trim();
+    if (trimmed === '' || trimmed === 'false' || trimmed === '0')
+        return null;
+    if (trimmed === 'true' || trimmed === '1') {
+        return path.join(cwd, '.qfg-friction.log');
+    }
+    return path.isAbsolute(trimmed) ? trimmed : path.resolve(cwd, trimmed);
+}
+export function buildFrictionEntry(opts) {
+    const argv = opts.argv ?? process.argv.slice(2);
+    const binName = opts.binName ?? 'qfg';
+    const error = opts.error?.trim() || `nonzero exit code ${opts.exitCode}`;
+    return {
+        attempted: [binName, ...argv].join(' '),
+        error,
+        exitCode: opts.exitCode,
+        ts: (opts.now ?? new Date()).toISOString(),
+    };
+}
+export function appendFrictionEntry(logPath, entry) {
+    fs.appendFileSync(logPath, JSON.stringify(entry) + '\n', 'utf8');
+}
+const MAX_STDERR_CAPTURE = 4000;
+export function extractLastErrorLine(stderr) {
+    if (!stderr)
+        return undefined;
+    const stripped = stderr.replaceAll(/\u001B\[[\d;]*[A-Za-z]/g, '');
+    const lines = stripped.split('\n').map((l) => l.trim()).filter(Boolean);
+    if (lines.length === 0)
+        return undefined;
+    const errorLine = [...lines].reverse().find((l) => /^(error|»|×|✖)/i.test(l));
+    return (errorLine ?? lines.at(-1))?.replace(/^»\s*/, '').replace(/^error:\s*/i, '');
+}
+export function installStderrCapture() {
+    let captured = '';
+    const origWrite = process.stderr.write.bind(process.stderr);
+    process.stderr.write = ((chunk, ...rest) => {
+        try {
+            const asString = typeof chunk === 'string' ? chunk : chunk.toString();
+            captured += asString;
+            if (captured.length > MAX_STDERR_CAPTURE) {
+                captured = captured.slice(-MAX_STDERR_CAPTURE);
+            }
+        }
+        catch {
+            // ignore — stderr capture is best-effort
+        }
+        return origWrite(chunk, ...rest);
+    });
+    return () => captured;
+}

package/dist/util/oauth-client.js

@@ -4,8 +4,8 @@ const WORKOS_BASE_URL = 'https://api.workos.com';
 const WORKOS_CLIENT_ID_PRODUCTION = 'client_01KKCCWMNB2K8HYQZQ96G1MXE0';
 const WORKOS_CLIENT_ID_STAGING = 'client_01KKCCWM4K87JS0MKS8PHZ0ZY1';
 const getClientId = () => {
-    if (process.env.WORKOS_CLIENT_ID) {
-        return process.env.WORKOS_CLIENT_ID;
+    if (process.env.CLI_WORKOS_CLIENT_ID) {
+        return process.env.CLI_WORKOS_CLIENT_ID;
     }
     const domain = getDomain();
     if (domain === 'quonfig-staging.com') {

package/dist/verify/validate.js

@@ -142,7 +142,7 @@ const StoredConfigSchema = z.object({
     valueType: ValueTypeSchema,
     name: z.string().optional(),
     description: z.string().optional(),
-    sendToClientSdk: z.boolean().default(false),
+    sendToClientSdk: z.boolean().optional(),
     schemaKey: z.string().optional(),
     accessLevel: z.string().optional(),
     protection: z.string().optional(),
@@ -183,6 +183,24 @@ const VALUE_REQUIRED_OPERATORS = new Set([
     "IN_INT_RANGE",
     "LOOKUP_KEY_IN", "LOOKUP_KEY_NOT_IN",
 ]);
+/**
+ * Reject `sendToClientSdk` on feature_flag rows — the field is config-only.
+ * Checks the raw parsed JSON so the key is forbidden regardless of value
+ * (true or false). Segments are handled separately on the parsed config.
+ */
+function checkFeatureFlagForbiddenFields(parsed, file, issues) {
+    if (typeof parsed === "object" &&
+        parsed !== null &&
+        parsed.type === "feature_flag" &&
+        Object.prototype.hasOwnProperty.call(parsed, "sendToClientSdk")) {
+        issues.push({
+            file,
+            message: `feature_flag must not set "sendToClientSdk" — this field is only valid on config rows`,
+            severity: "error",
+            suggestion: `Remove the "sendToClientSdk" field from this feature_flag JSON`,
+        });
+    }
+}
 // ── Validation from filesystem ──────────────────────────────────────────
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -334,6 +352,7 @@ export function validateWorkspace(workspaceDir) {
                 stats.schemas++;
                 continue;
             }
+            checkFeatureFlagForbiddenFields(parsed, relPath, issues);
             // Validate against StoredConfigSchema
             const result = StoredConfigSchema.safeParse(parsed);
             if (!result.success) {
@@ -631,6 +650,7 @@ export function validateFileMap(files) {
             allSchemaFiles.push({ key: schemaKey, file: relPath });
             continue;
         }
+        checkFeatureFlagForbiddenFields(parsed, relPath, issues);
         const result = StoredConfigSchema.safeParse(parsed);
         if (!result.success) {
             for (const issue of result.error.issues) {
@@ -835,6 +855,19 @@ function validateRules(rules, file, context, expectedValueType, issues, variants
             if (wv.weightedValues.length === 0) {
                 issues.push({ file, message: `${ruleCtx}: weighted values list is empty`, severity: "error" });
             }
+            // Percentage rollouts must reference named variants — the UI cannot edit
+            // a rollout when variants is empty. Bool configs are exempt because the
+            // UI supplies implicit true/false variants.
+            if (wv.weightedValues.length > 0 &&
+                variants.length === 0 &&
+                expectedValueType !== "bool") {
+                issues.push({
+                    file,
+                    message: `${ruleCtx}: weighted_values rollout requires at least one variant, but variants is empty`,
+                    severity: "error",
+                    suggestion: `Define variants for the possible rollout values, then reference them from weightedValues.`,
+                });
+            }
             for (let j = 0; j < wv.weightedValues.length; j++) {
                 if (wv.weightedValues[j].value.type !== expectedValueType) {
                     issues.push({

package/oclif.manifest.json

@@ -421,7 +421,10 @@
       ]
     },
     "info": {
-      "aliases": [],
+      "aliases": [
+        "flag:show",
+        "flag:info"
+      ],
       "args": {
         "name": {
           "description": "config/feature-flag/etc. name",
@@ -634,7 +637,9 @@
       ]
     },
     "list": {
-      "aliases": [],
+      "aliases": [
+        "flag:list"
+      ],
       "args": {},
       "description": "Show keys for your config/feature flags/etc.\n\n  All types are returned by default. If you pass one or more type flags (e.g. --configs), only those types will be returned",
       "examples": [
@@ -1315,7 +1320,9 @@
       ]
     },
     "set-default": {
-      "aliases": [],
+      "aliases": [
+        "toggle"
+      ],
       "args": {
         "name": {
           "description": "config/feature-flag/etc. name",
@@ -2210,5 +2217,5 @@
       ]
     }
   },
-  "version": "0.0.8"
+  "version": "0.0.10"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },
@@ -81,7 +81,10 @@
     "plugins": [],
     "topicSeparator": " ",
     "helpClass": "./dist/help",
-    "stacktrace": false
+    "stacktrace": false,
+    "hooks": {
+      "init": "./dist/hooks/init/friction-log"
+    }
   },
   "scripts": {
     "build": "shx rm -rf dist && tsc -b",