@quonfig/cli 0.0.12 → 0.0.14

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.12 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.14 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -42,6 +42,7 @@ USAGE
 * [`qfg mcp`](#qfg-mcp)
 * [`qfg migrate`](#qfg-migrate)
 * [`qfg migrate doctor`](#qfg-migrate-doctor)
+* [`qfg migrate my-code`](#qfg-migrate-my-code)
 * [`qfg migrate status`](#qfg-migrate-status)
 * [`qfg override [NAME]`](#qfg-override-name)
 * [`qfg pull`](#qfg-pull)
@@ -87,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.12/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -159,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.12/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/create.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -359,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.12/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -382,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.12/src/commands/generate-new-hex-key.ts)_
+_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)_
 
 ## `qfg get [NAME]`
 
@@ -414,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.12/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -462,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.12/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -500,10 +501,12 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/init.ts)_
 
 ## `qfg interactive`
 
+Launch an interactive menu to browse and manage your workspace.
+
 ```
 USAGE
   $ qfg interactive [--json] [--interactive] [--no-color] [--verbose]
@@ -514,11 +517,21 @@ GLOBAL FLAGS
   --no-color          Do not colorize output
   --verbose           Verbose output
 
+DESCRIPTION
+  Launch an interactive menu to browse and manage your workspace.
+
+  Common shortcuts:
+  qfg set-default my.flag --environment production --value false   # catch-all fallback
+  qfg set-rollout my.flag --environment production --true-percent 20   # % rollout
+
+  For arbitrary targeting rules (e.g. user.email, plan, segment, custom property),
+  run 'qfg config-schema' then 'qfg pull' and edit the JSON config directly.
+
 EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -558,7 +571,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/list.ts)_
 
 ## `qfg login`
 
@@ -583,7 +596,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -606,7 +619,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -639,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.12/src/commands/mcp.ts)_
+_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/mcp.ts)_
 
 ## `qfg migrate`
 
@@ -693,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.12/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -731,7 +744,39 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/migrate/doctor.ts)_
+
+## `qfg migrate my-code`
+
+Migrate Launch SDK call sites in your codebase to Quonfig SDK call sites (invokes the qfg-migrate-code Claude skill)
+
+```
+USAGE
+  $ qfg migrate my-code [--json] [--interactive] [--no-color] [--verbose] [--dry-run] [--from launch]
+
+FLAGS
+  --dry-run        Show what would be migrated without editing any files
+  --from=<option>  [default: launch] Legacy SDK to migrate from
+                   <options: launch>
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Migrate Launch SDK call sites in your codebase to Quonfig SDK call sites (invokes the qfg-migrate-code Claude skill)
+
+EXAMPLES
+  $ qfg migrate my-code
+
+  $ qfg migrate my-code --from launch
+
+  $ 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)_
 
 ## `qfg migrate status`
 
@@ -762,11 +807,11 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME]`
 
-Override the value of an item for your user/SDK key combo
+Override the value of an item for your user/SDK key combo.
 
 ```
 USAGE
@@ -789,7 +834,12 @@ GLOBAL FLAGS
       --verbose            Verbose output
 
 DESCRIPTION
-  Override the value of an item for your user/SDK key combo
+  Override the value of an item for your user/SDK key combo.
+
+  To target users other than yourself, or to express rules like "user.email == X → value Y",
+  you cannot use override — see:
+  qfg config-schema   # operator reference + worked multi-rule example
+  qfg pull            # clone the workspace so you can edit JSON directly
 
 EXAMPLES
   $ qfg override # will prompt for name and value
@@ -801,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.12/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -845,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.12/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/pull.ts)_
 
 ## `qfg schema NAME`
 
@@ -883,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.12/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -910,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.12/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -942,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.12/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -971,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.12/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -998,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.12/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1063,9 +1113,13 @@ EXAMPLES
   # For a percentage rollout, use set-rollout instead:
 
   $ qfg set-rollout my.flag.name --environment production --true-percent 20
+
+  # For per-user / per-property targeting (e.g. user.email == X), edit JSON directly:
+
+  $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1142,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.12/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1174,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.12/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1239,6 +1293,10 @@ EXAMPLES
   # For a percentage rollout, use set-rollout instead:
 
   $ qfg set-rollout my.flag.name --environment production --true-percent 20
+
+  # For per-user / per-property targeting (e.g. user.email == X), edit JSON directly:
+
+  $ qfg pull && qfg config-schema
 ```
 
 ## `qfg verify [PATH]`
@@ -1272,7 +1330,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1295,7 +1353,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1318,7 +1376,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1351,7 +1409,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.12/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace switch`
 
@@ -1374,7 +1432,7 @@ EXAMPLES
   $ qfg workspace switch
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.12/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.14/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/codegen/json-schema-to-zod.js

@@ -100,11 +100,11 @@ function schemaToZod(schema) {
                     const items = schema.prefixItems.map((item) => schemaToZod(item));
                     result = z.tuple(items);
                 }
-                else if (schema.items !== undefined) {
-                    result = z.array(schemaToZod(schema.items));
+                else if (schema.items === undefined) {
+                    result = z.array(z.any());
                 }
                 else {
-                    result = z.array(z.any());
+                    result = z.array(schemaToZod(schema.items));
                 }
                 break;
             }
@@ -121,12 +121,14 @@ function schemaToZod(schema) {
             default: {
                 if (Array.isArray(schema.oneOf)) {
                     const options = schema.oneOf.map((item) => schemaToZod(item));
-                    result = options.length === 1 ? options[0] : z.union(options);
+                    result =
+                        options.length === 1 ? options[0] : z.union(options);
                     break;
                 }
                 if (Array.isArray(schema.anyOf)) {
                     const options = schema.anyOf.map((item) => schemaToZod(item));
-                    result = options.length === 1 ? options[0] : z.union(options);
+                    result =
+                        options.length === 1 ? options[0] : z.union(options);
                     break;
                 }
                 if (Array.isArray(schema.allOf) && schema.allOf.length === 1) {

package/dist/codegen/language-mappers/zod-base-mapper.d.ts

@@ -20,12 +20,12 @@ export declare abstract class ZodBaseMapper {
     protected abstract function(args: string, returns: string): string;
     protected abstract functionArguments(value?: $ZodFunctionArgs): string;
     protected abstract functionReturns(value: $ZodFunctionOut): string;
-    protected abstract null(): string;
     protected abstract literal(value: string | number | boolean | null): string;
+    protected abstract never(): string;
+    protected abstract null(): string;
     protected abstract number(isInteger: boolean): string;
     protected abstract object(properties: [string, z.ZodTypeAny][]): string;
     protected abstract optional(wrappedType: string): string;
-    protected abstract never(): string;
     protected abstract record(keyType: string, valueType: string): string;
     protected abstract string(): string;
     protected abstract tuple(wrappedTypes: string[]): string;

package/dist/codegen/language-mappers/zod-to-string-mapper.d.ts

@@ -9,12 +9,12 @@ export declare class ZodToStringMapper extends ZodBaseMapper {
     function(input: string, output: string): string;
     functionArguments(value?: $ZodFunctionArgs): string;
     functionReturns(value: $ZodFunctionOut): string;
-    null(): string;
     literal(value: string | number | boolean | null): string;
+    never(): string;
+    null(): string;
     number(isInteger?: boolean): "z.number()" | "z.number().int()";
     object(properties: [string, z.ZodTypeAny][]): string;
     optional(wrappedType: string): string;
-    never(): string;
     record(keyType: string, valueType: string): string;
     renderField(type: z.ZodTypeAny, key?: string): string;
     string(): string;

package/dist/codegen/language-mappers/zod-to-string-mapper.js

@@ -31,12 +31,15 @@ export class ZodToStringMapper extends ZodBaseMapper {
         const mapper = new ZodToStringMapper();
         return mapper.resolveType(value);
     }
-    null() {
-        return 'z.null()';
-    }
     literal(value) {
         return `z.literal(${JSON.stringify(value)})`;
     }
+    never() {
+        return 'z.never()';
+    }
+    null() {
+        return 'z.null()';
+    }
     number(isInteger = false) {
         const base = 'z.number()';
         if (isInteger) {
@@ -56,9 +59,6 @@ export class ZodToStringMapper extends ZodBaseMapper {
     optional(wrappedType) {
         return `${wrappedType}.optional()`;
     }
-    never() {
-        return 'z.never()';
-    }
     record(keyType, valueType) {
         return `z.record(${keyType}, ${valueType})`;
     }

package/dist/codegen/language-mappers/zod-to-typescript-mapper.d.ts

@@ -18,12 +18,12 @@ export declare class ZodToTypescriptMapper extends ZodBaseMapper {
     function(args: string, returns: string): string;
     functionArguments(value?: z.ZodTuple): string;
     functionReturns(value: z.ZodTypeAny): string;
-    null(): string;
     literal(value: string | number | boolean | null): string;
+    never(): string;
+    null(): string;
     number(): string;
     object(properties: [string, z.ZodTypeAny][]): string;
     optional(wrappedType: string): string;
-    never(): string;
     record(keyType: string, valueType: string): string;
     renderField(type: ZodTypeSupported): string;
     string(): string;

package/dist/codegen/language-mappers/zod-to-typescript-mapper.js

@@ -41,12 +41,15 @@ export class ZodToTypescriptMapper extends ZodBaseMapper {
         const mapper = new ZodToTypescriptMapper();
         return mapper.resolveType(value);
     }
-    null() {
-        return 'null';
-    }
     literal(value) {
         return JSON.stringify(value);
     }
+    never() {
+        return 'never';
+    }
+    null() {
+        return 'null';
+    }
     number() {
         return 'number';
     }
@@ -68,9 +71,6 @@ export class ZodToTypescriptMapper extends ZodBaseMapper {
         // Fallback to a union type w/undefined for inline optional definitions
         return this.union([wrappedType, 'undefined']);
     }
-    never() {
-        return 'never';
-    }
     record(keyType, valueType) {
         return `Record<${keyType}, ${valueType}>`;
     }

package/dist/codegen/language-mappers/zod-to-typescript-return-value-mapper.d.ts

@@ -17,12 +17,12 @@ export declare class ZodToTypescriptReturnValueMapper extends ZodBaseMapper {
     function(args: string, returns: string): string;
     functionArguments(value?: z.ZodTuple): string;
     functionReturns(): string;
-    null(): string;
     literal(): string;
+    never(): string;
+    null(): string;
     number(): string;
     object(properties: [string, z.ZodTypeAny][]): string;
     optional(wrappedType: string): string;
-    never(): string;
     record(): string;
     renderField(type: ZodTypeSupported): string;
     string(): string;

package/dist/codegen/language-mappers/zod-to-typescript-return-value-mapper.js

@@ -36,10 +36,13 @@ export class ZodToTypescriptReturnValueMapper extends ZodBaseMapper {
     functionReturns() {
         return `Mustache.render(raw${this.printPropertyPath()} ?? "", ${this.FUNCTION_ARGUMENTS_NAME})`;
     }
-    null() {
+    literal() {
         return `raw${this.printPropertyPath()}`;
     }
-    literal() {
+    never() {
+        return `raw${this.printPropertyPath()}`;
+    }
+    null() {
         return `raw${this.printPropertyPath()}`;
     }
     number() {
@@ -65,9 +68,6 @@ export class ZodToTypescriptReturnValueMapper extends ZodBaseMapper {
         // Fallback to a union type w/undefined for inline optional definitions
         return this.union([wrappedType, 'undefined']);
     }
-    never() {
-        return `raw${this.printPropertyPath()}`;
-    }
     record() {
         // Explicitly not supporting navigation into record values, as the keys are not known at compile time
         return `raw${this.printPath(this.returnTypePropertyPath)}`;

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

@@ -18,7 +18,6 @@ function mapGitValue(gitValue) {
         case 'string_list': {
             return { value: { string: JSON.stringify(value) } };
         }
-        case 'string':
         default: {
             return { value: { string: value } };
         }

package/dist/codegen/schema-extractor.js

@@ -216,8 +216,11 @@ export class SchemaExtractor {
             return;
         }
         const schemaFile = configFile.schemas?.find((schema) => {
-            const schemaPath = schema.path.replace(/\\/g, '/');
-            const derivedKey = schemaPath.split('/').at(-1)?.replace(/\.json$/, '');
+            const schemaPath = schema.path.replaceAll('\\', '/');
+            const derivedKey = schemaPath
+                .split('/')
+                .at(-1)
+                ?.replace(/\.json$/, '');
             return derivedKey === schemaKey;
         });
         if (schemaFile) {

package/dist/commands/info.js

@@ -195,7 +195,6 @@ Related commands:
         // Fetch stats for all environments (similar to original implementation)
         const endTime = Date.now();
         const startTime = endTime - 24 * 60 * 60 * 1000; // 24 hours ago
-        const timeInterval = 'HOURLY';
         const statsPerEnv = {};
         // Fetch stats for each environment via oRPC
         for (const env of environments) {
@@ -275,6 +274,10 @@ Related commands:
                 if (value.type === 'stringList' && Array.isArray(value.value)) {
                     return value.value.join(',');
                 }
+                // JSON values must be stringified, else they render as [object Object]
+                if (value.type === 'json') {
+                    return JSON.stringify(value.value);
+                }
                 return String(value.value);
             }
             // New format: {string: 'abc'}

package/dist/commands/init.js

@@ -55,7 +55,12 @@ export default class Init extends BaseCommand {
                 this.log('  Nothing to do.');
             }
             if (this.jsonEnabled()) {
-                return { actions: plan.actions, dryRun: true, isFirstTime: plan.isFirstTime, samplesIncluded: plan.samplesIncluded };
+                return {
+                    actions: plan.actions,
+                    dryRun: true,
+                    isFirstTime: plan.isFirstTime,
+                    samplesIncluded: plan.samplesIncluded,
+                };
             }
             return plan;
         }
@@ -76,7 +81,12 @@ export default class Init extends BaseCommand {
         }
         this.log('\nRun `qfg verify` to validate the workspace.');
         if (this.jsonEnabled()) {
-            return { actions: plan.actions, dryRun: false, isFirstTime: plan.isFirstTime, samplesIncluded: plan.samplesIncluded };
+            return {
+                actions: plan.actions,
+                dryRun: false,
+                isFirstTime: plan.isFirstTime,
+                samplesIncluded: plan.samplesIncluded,
+            };
         }
         return plan;
     }

package/dist/commands/interactive.d.ts

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../index.js';
 export default class Interactive extends BaseCommand {
+    static description: string;
     static examples: string[];
     run(): Promise<void>;
 }

package/dist/commands/interactive.js

@@ -1,6 +1,14 @@
 import { BaseCommand } from '../index.js';
 import { interactivePrompt } from '../interactive-prompt.js';
 export default class Interactive extends BaseCommand {
+    static description = `Launch an interactive menu to browse and manage your workspace.
+
+Common shortcuts:
+  qfg set-default my.flag --environment production --value false   # catch-all fallback
+  qfg set-rollout my.flag --environment production --true-percent 20   # % rollout
+
+For arbitrary targeting rules (e.g. user.email, plan, segment, custom property),
+run 'qfg config-schema' then 'qfg pull' and edit the JSON config directly.`;
     static examples = ['<%= config.bin %>'];
     async run() {
         await interactivePrompt(this.config);