@quonfig/cli 0.0.4 → 0.0.6

package/dist/commands/config-schema.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../index.js';
+import { JsonObj } from '../result.js';
+export default class ConfigSchema extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'json-schema': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<JsonObj | void>;
+}

package/dist/commands/config-schema.js

@@ -0,0 +1,165 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../index.js';
+import { storedConfigJsonSchema } from '../init/schema.js';
+const REFERENCE = `
+────────────────────────────────────────────────────────────
+FILE LAYOUT
+────────────────────────────────────────────────────────────
+Config files live in your workspace (clone with: qfg pull --dir ./my-config):
+
+  feature-flags/   Boolean feature flags (on/off, targeting, percentage rollouts)
+  configs/         Typed config values (string, int, double, json, string-list)
+  segments/        User segments for targeting rules
+  log-levels/      Dynamic log-level configs
+
+────────────────────────────────────────────────────────────
+RULE EVALUATION
+────────────────────────────────────────────────────────────
+Rules are evaluated in ORDER — the FIRST matching rule wins.
+Put specific rules (user lists, segments) BEFORE catch-all rules.
+  criteria: []   means "match everyone" (unconditional / catch-all)
+  criteria: [..] multiple entries in one rule are ANDed together
+
+────────────────────────────────────────────────────────────
+EXAMPLE: complex targeting + rollout in production
+────────────────────────────────────────────────────────────
+Four rules in order:
+  1. Always ON  for users in an allowlist
+  2. Always ON  for users in the "beta" segment
+  3. Always OFF for users in the "holdout" segment
+  4. 50/50 split for everyone else
+
+  {
+    "key": "my.feature.flag",
+    "type": "feature_flag",
+    "valueType": "bool",
+    "default": {
+      "rules": [{ "criteria": [], "value": { "type": "bool", "value": false } }]
+    },
+    "environments": [{
+      "id": "production",
+      "rules": [
+        {
+          "criteria": [{
+            "operator": "PROP_IS_ONE_OF",
+            "propertyName": "user.key",
+            "valueToMatch": { "type": "string_list", "value": ["user-123", "user-456"] }
+          }],
+          "value": { "type": "bool", "value": true }
+        },
+        {
+          "criteria": [{
+            "operator": "IN_SEG",
+            "valueToMatch": { "type": "string", "value": "beta" }
+          }],
+          "value": { "type": "bool", "value": true }
+        },
+        {
+          "criteria": [{
+            "operator": "IN_SEG",
+            "valueToMatch": { "type": "string", "value": "holdout" }
+          }],
+          "value": { "type": "bool", "value": false }
+        },
+        {
+          "criteria": [],
+          "value": {
+            "type": "weighted_values",
+            "value": {
+              "hashByPropertyName": "user.key",
+              "weightedValues": [
+                { "value": { "type": "bool", "value": true },  "weight": 50000 },
+                { "value": { "type": "bool", "value": false }, "weight": 50000 }
+              ]
+            }
+          }
+        }
+      ]
+    }]
+  }
+
+────────────────────────────────────────────────────────────
+CRITERION FIELDS
+────────────────────────────────────────────────────────────
+Each criterion object has:
+  operator        (required) — see operator table below
+  propertyName    (required for PROP_* operators) — user property, e.g. "user.key", "user.plan"
+  valueToMatch    (required for all except ALWAYS_TRUE) — typed value to compare against
+
+────────────────────────────────────────────────────────────
+OPERATOR REFERENCE
+────────────────────────────────────────────────────────────
+  Operator                         valueToMatch type    Notes
+  ────────────────────────────────────────────────────────
+  ALWAYS_TRUE                      (none)               Unconditional match; use for catch-all rules
+  PROP_IS_ONE_OF                   string_list          propertyName value is in the list
+  PROP_IS_NOT_ONE_OF               string_list          propertyName value is NOT in the list
+  PROP_STARTS_WITH_ONE_OF          string_list          string prefix match
+  PROP_DOES_NOT_START_WITH_ONE_OF  string_list
+  PROP_ENDS_WITH_ONE_OF            string_list          string suffix match
+  PROP_DOES_NOT_END_WITH_ONE_OF    string_list
+  PROP_CONTAINS_ONE_OF             string_list          substring match
+  PROP_DOES_NOT_CONTAIN_ONE_OF     string_list
+  PROP_LESS_THAN                   int or double        numeric comparison
+  PROP_LESS_THAN_OR_EQUAL          int or double
+  PROP_GREATER_THAN                int or double
+  PROP_GREATER_THAN_OR_EQUAL       int or double
+  PROP_BEFORE                      string (ISO 8601)    date/time comparison
+  PROP_AFTER                       string (ISO 8601)
+  PROP_MATCHES                     string               regex match
+  PROP_DOES_NOT_MATCH              string
+  IN_SEG                           string               value = segment key (no propertyName needed)
+  NOT_IN_SEG                       string               value = segment key (no propertyName needed)
+  IN_INT_RANGE                     int_range            value = {min, max}
+  LOOKUP_KEY_IN                    string_list          matches if SDK lookup key is in the list
+  LOOKUP_KEY_NOT_IN                string_list
+
+valueToMatch format: { "type": "<type>", "value": <value> }
+  string_list  →  { "type": "string_list", "value": ["a", "b"] }
+  string       →  { "type": "string",      "value": "beta" }
+  int          →  { "type": "int",         "value": 42 }
+  double       →  { "type": "double",      "value": 3.14 }
+
+────────────────────────────────────────────────────────────
+PERCENTAGE ROLLOUT (weighted_values)
+────────────────────────────────────────────────────────────
+Weights are integers out of 100,000 (not percentages):
+  5%=5000  10%=10000  20%=20000  50%=50000  100%=100000
+  All weights in one rule MUST sum to exactly 100,000.
+
+hashByPropertyName controls the bucket assignment property (default: "user.key").
+
+────────────────────────────────────────────────────────────
+RELATED COMMANDS
+────────────────────────────────────────────────────────────
+  qfg create my.flag --type boolean-flag          create a new flag
+  qfg set-default my.flag --environment prod ...  set a scalar fallback value
+  qfg set-rollout my.flag --environment prod ...  set a simple percentage rollout
+  qfg pull --dir ./config                         clone workspace to edit JSON directly
+  qfg verify ./config                             validate all JSON files before pushing
+  qfg info my.flag                                inspect current values and rules
+  qfg config-schema --json-schema                 print the machine-readable JSON Schema
+`.trim();
+export default class ConfigSchema extends BaseCommand {
+    static description = 'Print the config file format reference: rules engine, operators, targeting criteria, segments, and weighted rollouts. ' +
+        'Use --json-schema for the machine-readable JSON Schema document.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>                  # human-readable operator reference + examples',
+        '<%= config.bin %> <%= command.id %> --json-schema    # full JSON Schema document (copy into your editor)',
+    ];
+    static flags = {
+        'json-schema': Flags.boolean({
+            default: false,
+            description: 'Output the full JSON Schema document for config files instead of the human-readable reference',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ConfigSchema);
+        if (flags['json-schema']) {
+            const schema = storedConfigJsonSchema();
+            this.log(JSON.stringify(schema, null, 2));
+            return schema;
+        }
+        this.log(REFERENCE);
+    }
+}

package/dist/commands/create.js

@@ -11,7 +11,26 @@ export default class Create extends APICommand {
     static args = {
         name: Args.string({ description: 'name for your new item (e.g. my.new.flag)', required: true }),
     };
-    static description = 'Create a new item in Quonfig';
+    static description = `Create a new feature flag, config value, or other item.
+
+Use --type to specify the kind of item:
+  boolean-flag  On/off feature flag (sendToClientSdk defaults to true; best for gradual rollouts)
+  string        A string configuration value
+  int           An integer configuration value
+  double        A floating-point configuration value
+  string-list   A comma-separated list of strings
+  json          An arbitrary JSON blob
+  boolean       A plain boolean (not a feature flag)
+
+This sets the global default value. Override per-environment with:
+  qfg set-default my.flag --environment production --value true
+
+For a percentage rollout (gradual rollout / A/B test / canary deploy), use:
+  qfg set-rollout my.flag --environment production --true-percent 20
+
+Or edit the JSON config file directly for complex targeting rules:
+  qfg config-schema          # full operator reference + examples
+  qfg pull --dir ./config    # clone workspace, then edit JSON and git push`;
     static examples = [
         '<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag',
         '<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag --value=true',
@@ -19,6 +38,8 @@ export default class Create extends APICommand {
         '<%= config.bin %> <%= command.id %> my.new.string --type string --value="hello world" --secret',
         '<%= config.bin %> <%= command.id %> my.new.string --type string --env-var=MY_ENV_VAR_NAME',
         '<%= config.bin %> <%= command.id %> my.new.string --type json --value="{\\"key\\": \\"value\\"}"',
+        '# After creating a flag, set a 20% rollout in production:',
+        '<%= config.bin %> set-rollout my.new.flag --environment production --true-percent 20',
     ];
     static flags = {
         confidential: Flags.boolean({ default: false, description: 'mark the value as confidential' }),

package/dist/commands/info.js

@@ -7,8 +7,23 @@ import isInteractive from '../util/is-interactive.js';
 import nameArg from '../util/name-arg.js';
 export default class Info extends APICommand {
     static args = { ...nameArg };
-    static description = 'Show details about the provided config/feature-flag/etc.';
-    static examples = ['<%= config.bin %> <%= command.id %> my.config.name'];
+    static 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`;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my.config.name',
+        '<%= config.bin %> <%= command.id %> my.config.name --exclude-evaluations   # skip 24h stats',
+    ];
     static flags = {
         'exclude-evaluations': Flags.boolean({ default: false, description: 'Exclude evaluation data' }),
     };

package/dist/commands/login.js

@@ -10,7 +10,8 @@ export default class Login extends BaseCommand {
     static flags = {
         profile: Flags.string({
             char: 'p',
-            description: 'Profile name to create or update (defaults to "default")',
+            description: 'Profile name to save credentials under (advanced; defaults to "default")',
+            hidden: true,
         }),
     };
     async run() {
@@ -56,6 +57,8 @@ export default class Login extends BaseCommand {
         let workspaceName;
         let workspaceSlug;
         let organizationName;
+        let organizationId;
+        let multipleWorkspacesAvailable = false;
         try {
             const apiUrl = getApiUrl();
             this.verboseLog('Resolving workspace...', { apiUrl, orgId });
@@ -70,17 +73,15 @@ export default class Login extends BaseCommand {
             if (res.ok) {
                 const body = await res.json();
                 const allWorkspaces = (body.json ?? body);
-                const orgWorkspaces = Array.isArray(allWorkspaces)
-                    ? allWorkspaces.filter((w) => w.workosOrgId === orgId)
-                    : [];
-                const candidates = orgWorkspaces.length > 0 ? orgWorkspaces : (Array.isArray(allWorkspaces) ? allWorkspaces : []);
+                const candidates = Array.isArray(allWorkspaces) ? allWorkspaces : [];
+                multipleWorkspacesAvailable = candidates.length > 1;
                 let match;
                 if (candidates.length === 1) {
                     match = candidates[0];
                 }
                 else if (candidates.length > 1) {
                     const chosen = await select({
-                        choices: candidates.map((w) => ({ name: w.workspaceSlug, value: w.workspaceId })),
+                        choices: candidates.map((w) => ({ name: `${w.organizationName} / ${w.workspaceSlug}`, value: w.workspaceId })),
                         message: 'Select workspace:',
                     });
                     match = candidates.find((w) => w.workspaceId === chosen);
@@ -90,6 +91,7 @@ export default class Login extends BaseCommand {
                     workspaceName = match.workspaceSlug;
                     workspaceSlug = match.workspaceSlug;
                     organizationName = match.organizationName;
+                    organizationId = match.workosOrgId;
                     this.verboseLog('Resolved workspace', { workspaceId, workspaceName, workspaceSlug, organizationName });
                 }
             }
@@ -113,33 +115,35 @@ export default class Login extends BaseCommand {
                     workspace: workspaceId || orgId || 'unknown',
                     workspaceName: workspaceName || (orgId ? `org:${orgId}` : undefined),
                     workspaceSlug,
+                    organizationName,
                 },
             },
         });
-        this.log(`\nProfile '${profileName}' configured.`);
-        if (shouldSetDefault) {
-            this.log('Set as default profile.');
-        }
         this.log('\nSuccessfully logged in!');
         if (userEmail) {
             this.log(`Logged in as: ${userEmail}`);
         }
         if (workspaceName) {
-            this.log(`Workspace: ${workspaceName} (${workspaceId})`);
-            if (organizationName) {
-                this.log(`Organization: ${organizationName}`);
+            const orgPrefix = organizationName ? `${organizationName} / ` : '';
+            this.log(`Workspace:    ${orgPrefix}${workspaceName}`);
+            if (workspaceId) {
+                this.log(`              (${workspaceId})`);
             }
         }
         else if (orgId) {
             this.log(`Organization: ${orgId}`);
         }
+        if (multipleWorkspacesAvailable) {
+            this.log(`\nTo switch workspaces: qfg workspace switch`);
+        }
         return {
             email: userEmail,
-            organizationId: orgId,
-            profile: profileName,
+            organizationId: organizationId || orgId,
+            organizationName,
             success: true,
             userId: user.id,
             workspaceId,
+            workspaceSlug,
         };
     }
 }

package/dist/commands/profile.d.ts

@@ -2,6 +2,7 @@ import type { JsonObj } from '../result.js';
 import { BaseCommand } from '../index.js';
 export default class Profile extends BaseCommand {
     static description: string;
+    static hidden: boolean;
     static examples: string[];
     run(): Promise<JsonObj | void>;
 }

package/dist/commands/profile.js

@@ -1,47 +1,11 @@
-import { select } from '@inquirer/prompts';
 import { BaseCommand } from '../index.js';
-import { loadAuthConfig, saveAuthConfig } from '../util/token-storage.js';
+import WorkspaceSwitch from './workspace/switch.js';
 export default class Profile extends BaseCommand {
-    static description = 'Manage profiles and set default profile';
-    static examples = ['<%= config.bin %> <%= command.id %>'];
+    static description = 'Deprecated. Use `qfg workspace switch` instead.';
+    static hidden = true;
+    static examples = ['<%= config.bin %> workspace switch'];
     async run() {
-        const authConfig = await loadAuthConfig();
-        if (!authConfig || Object.keys(authConfig.profiles).length === 0) {
-            return this.err('Not logged in. Please run `qfg login` first.');
-        }
-        const currentDefault = authConfig.defaultProfile || 'default';
-        // If only one profile, just show it
-        if (Object.keys(authConfig.profiles).length === 1) {
-            const profileName = Object.keys(authConfig.profiles)[0];
-            const profile = authConfig.profiles[profileName];
-            this.log(`Current default profile: ${profileName}`);
-            this.log(`Workspace: ${profile.workspaceName || profile.workspace}`);
-            this.log('\nYou only have one profile.');
-            return {
-                defaultProfile: profileName,
-                profiles: Object.keys(authConfig.profiles),
-            };
-        }
-        // Show current default
-        this.log(`Current default profile: ${currentDefault}\n`);
-        // Let user select a new default profile
-        const newDefault = await select({
-            choices: Object.entries(authConfig.profiles).map(([name, profile]) => ({
-                name: `${name} (${profile.workspaceName || profile.workspace})`,
-                value: name,
-            })),
-            message: 'Select default profile:',
-        });
-        // Update the default profile
-        await saveAuthConfig({
-            ...authConfig,
-            defaultProfile: newDefault,
-        });
-        this.log(`\nDefault profile set to: ${newDefault}`);
-        return {
-            defaultProfile: newDefault,
-            previousDefault: currentDefault,
-            success: true,
-        };
+        this.log('Note: `qfg profile` is deprecated. Use `qfg workspace switch` instead.\n');
+        return WorkspaceSwitch.run([], this.config);
     }
 }

package/dist/commands/pull.js

@@ -7,7 +7,22 @@ import { loadGiteaToken, isGiteaTokenExpired, saveGiteaToken } from '../util/git
 import { mintAndStoreGiteaReadToken, mintGiteaToken } from '../util/gitea-api.js';
 import { isGitRepo, getRemoteUrl, isWorkingTreeClean, gitFetch, gitSetRemote, canFastForward, hasDivergedFromRemote, gitMergeFfOnly, gitClone, displayUrl, } from '../util/git-ops.js';
 export default class Pull extends BaseCommand {
-    static description = 'Clone or update a local directory from the workspace Gitea repo';
+    static description = `Clone or update a local copy of your workspace config files.
+
+Use this when you need to edit flag JSON directly — for complex targeting rules,
+multi-rule configs, or anything beyond a single scalar value.
+
+For the config file format, operator reference, and examples:
+  qfg config-schema              # human-readable reference
+  qfg config-schema --json-schema  # machine-readable JSON Schema
+
+After editing files:
+  qfg verify <dir>               # validate JSON before pushing
+  git -C <dir> add -A && git -C <dir> commit -m "feat: ..." && git -C <dir> push
+
+CLI shortcuts (no JSON editing needed for simple cases):
+  qfg set-rollout my.flag --environment production --true-percent 20
+  qfg set-default my.flag --environment production --value true`;
     static examples = [
         '<%= config.bin %> pull --dir ./our-config',
         '<%= config.bin %> pull  # uses QUONFIG_DIR env var',

package/dist/commands/set-default.js

@@ -14,12 +14,29 @@ import nameArg from '../util/name-arg.js';
 import secretFlags, { parsedSecretFlags } from '../util/secret-flags.js';
 export default class SetDefault extends APICommand {
     static args = { ...nameArg };
-    static description = 'Set/update the default value for an environment (other rules still apply)';
+    static 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`;
     static examples = [
-        '<%= config.bin %> <%= command.id %> my.flag.name # will prompt for value and env',
+        '<%= config.bin %> <%= command.id %> my.flag.name                                          # prompts for value and env',
         '<%= config.bin %> <%= command.id %> my.flag.name --value=true --environment=staging',
+        '<%= config.bin %> <%= command.id %> my.flag.name --value=false --environment=production   # kill-switch: turn off for everyone',
         '<%= config.bin %> <%= command.id %> my.flag.name --value=true --secret',
         '<%= config.bin %> <%= command.id %> my.config.name --env-var=MY_ENV_VAR_NAME --environment=production',
+        '# For a percentage rollout, use set-rollout instead:',
+        '<%= config.bin %> set-rollout my.flag.name --environment production --true-percent 20',
     ];
     static flags = {
         confidential: Flags.boolean({ default: false, description: 'mark the value as confidential' }),
@@ -123,7 +140,6 @@ export default class SetDefault extends APICommand {
                 config,
                 envVar: flags['env-var'],
                 environment,
-                environmentId: environment.id,
                 key,
                 secret,
             });
@@ -147,13 +163,12 @@ export default class SetDefault extends APICommand {
             confidential,
             config,
             environment,
-            environmentId: environment.id,
             key,
             secret,
             value,
         });
     }
-    async submitChange({ confidential, config, envVar, environment, environmentId, key, secret, value, }) {
+    async submitChange({ confidential, config, envVar, environment, key, secret, value, }) {
         /* eslint-disable camelcase */
         const typeMapping = {
             bool: 'bool',
@@ -174,7 +189,7 @@ export default class SetDefault extends APICommand {
             successMessage = `Successfully changed default to \`${value}\``;
             if (secret.selected) {
                 // Handle encrypted values using shared utility
-                const encryptedValueResult = await makeConfidentialValue(this, value, secret, environmentId);
+                const encryptedValueResult = await makeConfidentialValue(this, value, secret, environment.id);
                 if (!encryptedValueResult.ok) {
                     return this.err(encryptedValueResult.message || 'Failed to encrypt value');
                 }
@@ -244,19 +259,67 @@ export default class SetDefault extends APICommand {
             configValue.confidential = true;
             successMessage += ' (confidential)';
         }
-        const payload = {
-            configKey: key,
-            currentVersionId: config.version,
-            environmentId: environmentId ? Number.parseInt(environmentId, 10) : 0,
-            value: configValue,
-        };
-        this.verboseLog('Payload:', payload);
-        const request = await this.apiClient.post('/internal/ops/v1/set-default', payload);
+        // Fetch the current full config to get the existing environments array and commitSha.
+        const detailRequest = await this.apiClient.post('/api/v1/metadata/getByKey', {
+            workspaceId: this.workspaceId,
+            key,
+        });
+        if (!detailRequest.ok) {
+            return this.err(`Failed to fetch config details: ${detailRequest.status}`);
+        }
+        const currentConfig = detailRequest.json;
+        // Build a single catch-all rule (empty criteria = matches everything).
+        const newRule = { criteria: [], value: configValue };
+        // For [Default] (environment.id === ''), update default.rules.
+        // For a specific environment, update the environments array.
+        let updateFields;
+        if (environment.id === '') {
+            // [Default] — no environment-specific block, update the catch-all default rules.
+            updateFields = { default: { rules: [newRule] } };
+        }
+        else {
+            // environment.name is the slug stored in git files (e.g. "production").
+            // environment.id is the DB UUID — never written to git files.
+            const envKey = environment.name;
+            const existingEnvs = currentConfig.environments ?? [];
+            const hasEnv = existingEnvs.some((e) => e.id === envKey);
+            const updatedEnvironments = hasEnv
+                ? existingEnvs.map((e) => (e.id === envKey ? { ...e, rules: [newRule] } : e))
+                : [...existingEnvs, { id: envKey, rules: [newRule] }];
+            updateFields = { environments: updatedEnvironments };
+        }
+        this.verboseLog('Update fields:', JSON.stringify(updateFields, null, 2));
+        // Route to the correct update endpoint based on config type.
+        let request;
+        if (config.type === 'feature_flag') {
+            request = await this.apiClient.post('/api/v1/flags/update', {
+                workspaceId: this.workspaceId,
+                flagKey: key,
+                flag: updateFields,
+                expectedCommitSha: currentConfig.commitSha,
+            });
+        }
+        else if (config.type === 'log_level') {
+            request = await this.apiClient.post('/api/v1/logLevels/update', {
+                workspaceId: this.workspaceId,
+                logLevelKey: key,
+                logLevel: updateFields,
+                expectedCommitSha: currentConfig.commitSha,
+            });
+        }
+        else {
+            request = await this.apiClient.post('/api/v1/configs/update', {
+                workspaceId: this.workspaceId,
+                configKey: key,
+                config: updateFields,
+                expectedCommitSha: currentConfig.commitSha,
+            });
+        }
         if (request.ok) {
             this.log(`${checkmark} ${successMessage}`);
             return {
                 environment: {
-                    id: environmentId,
+                    id: environment.id,
                     name: environment.name,
                 },
                 key,

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

@@ -0,0 +1,19 @@
+import { APICommand } from '../index.js';
+import { JsonObj } from '../result.js';
+export default class SetRollout extends APICommand {
+    static args: {
+        name: import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
+    };
+    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>;
+        'hash-by': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'true-percent': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        weights: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        confirm: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<JsonObj | void>;
+    private parseWeights;
+    private coerceValue;
+}