@quonfig/cli 0.0.18 → 0.0.20

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.18 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.20 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -37,6 +37,7 @@ USAGE
 * [`qfg init [DIRECTORY]`](#qfg-init-directory)
 * [`qfg interactive`](#qfg-interactive)
 * [`qfg list`](#qfg-list)
+* [`qfg log-level NAME`](#qfg-log-level-name)
 * [`qfg login`](#qfg-login)
 * [`qfg logout`](#qfg-logout)
 * [`qfg mcp`](#qfg-mcp)
@@ -60,6 +61,7 @@ USAGE
 * [`qfg whoami`](#qfg-whoami)
 * [`qfg workspace`](#qfg-workspace)
 * [`qfg workspace bootstrap`](#qfg-workspace-bootstrap)
+* [`qfg workspace create SLUG`](#qfg-workspace-create-slug)
 * [`qfg workspace switch [SLUG]`](#qfg-workspace-switch-slug)
 
 ## `qfg config-schema`
@@ -89,7 +91,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.18/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -97,9 +99,9 @@ Create a new feature flag, config value, or other item.
 
 ```
 USAGE
-  $ qfg create NAME --type boolean-flag|boolean|string|double|int|string-list|json [--json] [--interactive]
-    [--no-color] [--verbose] [-w <value>] [--confidential] [--env-var <value>] [--value <value>] [--secret]
-    [--secret-key-name <value>]
+  $ qfg create NAME --type boolean-flag|boolean|string|double|int|string-list|json|log_level [--json]
+    [--interactive] [--no-color] [--verbose] [-w <value>] [--confidential] [--env-var <value>] [--value <value>]
+    [--secret] [--secret-key-name <value>]
 
 ARGUMENTS
   NAME  name for your new item (e.g. my.new.flag)
@@ -111,7 +113,7 @@ FLAGS
   --secret-key-name=<value>  [default: quonfig.secrets.encryption.key] name of the secret key to use for
                              encryption/decryption
   --type=<option>            (required)
-                             <options: boolean-flag|boolean|string|double|int|string-list|json>
+                             <options: boolean-flag|boolean|string|double|int|string-list|json|log_level>
   --value=<value>            default value for your new item
 
 GLOBAL FLAGS
@@ -132,6 +134,7 @@ DESCRIPTION
   string-list   A comma-separated list of strings
   json          An arbitrary JSON blob
   boolean       A plain boolean (not a feature flag)
+  log_level     A dynamic log level (value must be one of TRACE/DEBUG/INFO/WARN/ERROR/FATAL)
 
   This sets the global default value. Override per-environment with:
   qfg set-default my.flag --environment production --value true
@@ -143,6 +146,13 @@ DESCRIPTION
   qfg config-schema          # full operator reference + examples
   qfg pull --dir ./config    # clone workspace, then edit JSON and git push
 
+  Log levels:
+  qfg create log-level.my-app --type log_level --value WARN
+  # Log-level keys must start with "log-level.".
+  # For per-logger targeting, create ONE log-level config per service and add
+  # rules on the "quonfig-sdk-logging.key" context property (e.g.
+  # PROP_STARTS_WITH_ONE_OF MyPackage.) rather than one config per logger.
+
 EXAMPLES
   $ qfg create my.new.flag --type boolean-flag
 
@@ -156,12 +166,14 @@ EXAMPLES
 
   $ qfg create my.new.string --type json --value="{\"key\": \"value\"}"
 
+  $ qfg create log-level.my-app --type log_level --value WARN
+
   # After creating a flag, set a 20% rollout in production:
 
   $ 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.18/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/create.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -361,7 +373,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.18/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -384,7 +396,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -416,7 +428,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -464,7 +476,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.18/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -504,7 +516,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -534,7 +546,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -574,7 +586,72 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/list.ts)_
+
+## `qfg log-level NAME`
+
+Create or add targeting rules to a log-level config.
+
+```
+USAGE
+  $ qfg log-level NAME [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [--environment <value>]
+    [--target <value>...] [--value TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+
+ARGUMENTS
+  NAME  log-level key (must start with "log-level.", e.g. log-level.my-app)
+
+FLAGS
+  --environment=<value>  when used with --target, scope the rule to this environment instead of the default
+  --target=<value>...    logger path prefix (matched via PROP_STARTS_WITH_ONE_OF on "quonfig-sdk-logging.key");
+                         repeatable
+  --value=<option>       log level — either the new default (create mode) or the level for the targeted loggers
+                         <options: TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
+
+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 or add targeting rules to a log-level config.
+
+  Log-level keys must start with "log-level." (e.g. log-level.my-app). The
+  default value applies to every logger in that service unless a targeting
+  rule matches first.
+
+  Two modes:
+
+  1. Create a new log-level config with a default value:
+  qfg log-level log-level.my-app --value=WARN
+
+  2. Add a per-logger targeting rule to an existing config. SDKs populate
+  the "quonfig-sdk-logging.key" context automatically from the logger path,
+  so this rule fires for any logger whose name starts with --target:
+  qfg log-level log-level.my-app --target=MyPackage.Noisy --value=ERROR
+
+  Pass --target multiple times to match any of several prefixes (OR).
+  Pass --environment=<env> to scope the rule to a single environment.
+
+  To update the catch-all default for an existing log level, use set-default:
+  qfg set-default log-level.my-app --value=DEBUG --environment=production
+
+  For more complex rules (regex, multi-criterion, exact match) edit the JSON:
+  qfg pull && $EDITOR log-levels/log-level.my-app.json
+  qfg config-schema            # full operator reference
+
+EXAMPLES
+  $ qfg log-level log-level.my-app --value=WARN
+
+  $ qfg log-level log-level.my-app --target=MyPackage.Noisy --value=ERROR
+
+  $ qfg log-level log-level.my-app --target=A --target=B --value=DEBUG
+
+  $ qfg log-level log-level.my-app --target=Chatty --value=INFO --environment=production
+```
+
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -599,7 +676,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -622,7 +699,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -655,7 +732,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.18/src/commands/mcp.ts)_
+_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/mcp.ts)_
 
 ## `qfg migrate`
 
@@ -709,7 +786,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.18/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -747,7 +824,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -779,7 +856,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -810,7 +887,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME]`
 
@@ -854,7 +931,7 @@ EXAMPLES
   $ qfg override my.double.config --value=3.14159
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -898,7 +975,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -946,7 +1023,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/push.ts)_
 
 ## `qfg schema NAME`
 
@@ -984,7 +1061,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.18/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1011,7 +1088,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1043,7 +1120,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.18/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1072,7 +1149,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1099,7 +1176,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.18/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1170,7 +1247,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1247,7 +1324,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.18/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1279,7 +1356,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1381,7 +1458,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1404,7 +1481,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1427,7 +1504,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1460,7 +1537,41 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/workspace/bootstrap.ts)_
+
+## `qfg workspace create SLUG`
+
+Create a new workspace. Provisions the Gitea repo and default environments, identical to the app's New Workspace UI.
+
+```
+USAGE
+  $ qfg workspace create SLUG [--json] [--interactive] [--no-color] [--verbose] [--name <value>] [--org <value>]
+
+ARGUMENTS
+  SLUG  Workspace slug (lowercase letters, numbers, hyphens)
+
+FLAGS
+  --name=<value>  Human-readable display name (defaults to the slug)
+  --org=<value>   Organization UUID or slug. Required when you belong to more than one organization; inferred otherwise.
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Create a new workspace. Provisions the Gitea repo and default environments, identical to the app's New Workspace UI.
+
+EXAMPLES
+  $ qfg workspace create my-team
+
+  $ qfg workspace create lt-21-smoke --name "Load Test 21"
+
+  $ qfg workspace create my-team --org 11111111-1111-1111-1111-111111111111
+```
+
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -1488,7 +1599,7 @@ EXAMPLES
   $ qfg workspace switch my-workspace-slug
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.18/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.20/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/codegen/code-generators/node-typescript-generator.js

@@ -7,7 +7,7 @@ export class NodeTypeScriptGenerator extends BaseTypescriptGenerator {
     declarationGenerate() {
         return (stripIndent `
     /* eslint-disable */
-    // AUTOGENERATED by quonfig-cli's 'gen' command
+    // AUTOGENERATED by quonfig-cli's 'generate' command
     // prettier-ignore
     import "@quonfig/node";
 
@@ -27,7 +27,7 @@ export class NodeTypeScriptGenerator extends BaseTypescriptGenerator {
     generate() {
         return (stripIndent `
     /* eslint-disable */
-    // AUTOGENERATED by quonfig-cli's 'gen' command
+    // AUTOGENERATED by quonfig-cli's 'generate' command
     // prettier-ignore
     import { Quonfig, Contexts, TypedNodeServerConfigurationRaw, TypedNodeServerConfigurationAccessor } from '@quonfig/node'
     // prettier-ignore

package/dist/codegen/code-generators/react-typescript-generator.js

@@ -8,7 +8,7 @@ export class ReactTypeScriptGenerator extends BaseTypescriptGenerator {
     declarationGenerate() {
         return (stripIndent `
     /* eslint-disable */
-    // AUTOGENERATED by quonfig-cli's 'gen' command
+    // AUTOGENERATED by quonfig-cli's 'generate' command
     // prettier-ignore
     import "@quonfig/javascript";
     // prettier-ignore
@@ -42,7 +42,7 @@ export class ReactTypeScriptGenerator extends BaseTypescriptGenerator {
     generate() {
         return (stripIndent `
     /* eslint-disable */
-    // AUTOGENERATED by quonfig-cli's 'gen' command
+    // AUTOGENERATED by quonfig-cli's 'generate' command
     // prettier-ignore
     import { Quonfig, TypedFrontEndConfigurationRaw } from "@quonfig/javascript"
     // prettier-ignore

package/dist/commands/create.d.ts

@@ -16,4 +16,5 @@ export default class Create extends APICommand {
     };
     run(): Promise<JsonObj | void>;
     private createBooleanFlag;
+    private createLogLevel;
 }

package/dist/commands/create.js

@@ -6,6 +6,7 @@ import { TYPE_MAPPING, coerceBool, coerceIntoType } from '../util/coerce.js';
 import { checkmark } from '../util/color.js';
 import { mapConfigValueToDto, mapValueTypeToString } from '../util/config-value-dto.js';
 import { makeConfidentialValue } from '../util/encryption.js';
+import { LOG_LEVELS, LOG_LEVEL_KEY_PREFIX, isLogLevel } from '../util/log-levels.js';
 import secretFlags, { parsedSecretFlags } from '../util/secret-flags.js';
 export default class Create extends APICommand {
     static args = {
@@ -21,6 +22,7 @@ Use --type to specify the kind of item:
   string-list   A comma-separated list of strings
   json          An arbitrary JSON blob
   boolean       A plain boolean (not a feature flag)
+  log_level     A dynamic log level (value must be one of ${LOG_LEVELS.join('/')})
 
 This sets the global default value. Override per-environment with:
   qfg set-default my.flag --environment production --value true
@@ -30,7 +32,14 @@ For a percentage rollout (gradual rollout / A/B test / canary deploy), use:
 
 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`;
+  qfg pull --dir ./config    # clone workspace, then edit JSON and git push
+
+Log levels:
+  qfg create log-level.my-app --type log_level --value WARN
+  # Log-level keys must start with "${LOG_LEVEL_KEY_PREFIX}".
+  # For per-logger targeting, create ONE log-level config per service and add
+  # rules on the "quonfig-sdk-logging.key" context property (e.g.
+  # PROP_STARTS_WITH_ONE_OF MyPackage.) rather than one config per logger.`;
     static examples = [
         '<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag',
         '<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag --value=true',
@@ -38,6 +47,7 @@ Or edit the JSON config file directly for complex targeting rules:
         '<%= 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\\"}"',
+        '<%= config.bin %> <%= command.id %> log-level.my-app --type log_level --value WARN',
         '# After creating a flag, set a 20% rollout in production:',
         '<%= config.bin %> set-rollout my.new.flag --environment production --true-percent 20',
     ];
@@ -45,7 +55,7 @@ Or edit the JSON config file directly for complex targeting rules:
         confidential: Flags.boolean({ default: false, description: 'mark the value as confidential' }),
         'env-var': Flags.string({ description: 'environment variable to get value from' }),
         type: Flags.string({
-            options: ['boolean-flag', 'boolean', 'string', 'double', 'int', 'string-list', 'json'],
+            options: ['boolean-flag', 'boolean', 'string', 'double', 'int', 'string-list', 'json', 'log_level'],
             required: true,
         }),
         value: Flags.string({ description: 'default value for your new item', required: false }),
@@ -56,6 +66,9 @@ Or edit the JSON config file directly for complex targeting rules:
         if (flags.type === 'boolean-flag') {
             return this.createBooleanFlag(args, flags.value);
         }
+        if (flags.type === 'log_level') {
+            return this.createLogLevel(args, flags);
+        }
         const key = args.name;
         const secret = parsedSecretFlags(flags);
         if (flags['env-var'] && flags.value) {
@@ -122,14 +135,7 @@ Or edit the JSON config file directly for complex targeting rules:
                 key: args.name,
                 valueType: mapValueTypeToString(valueType),
                 sendToClientSdk: false,
-                default: {
-                    rules: [
-                        {
-                            criteria: [],
-                            value: mapConfigValueToDto(configValue, valueType),
-                        },
-                    ],
-                },
+                defaultValue: mapConfigValueToDto(configValue, valueType),
             },
         };
         this.verboseLog('RPC configs/create', createInput);
@@ -172,16 +178,9 @@ Or edit the JSON config file directly for complex targeting rules:
                         description: 'Disabled',
                     },
                 ],
-                default: {
-                    rules: [
-                        {
-                            criteria: [],
-                            value: {
-                                type: 'bool',
-                                value: defaultValue,
-                            },
-                        },
-                    ],
+                defaultValue: {
+                    type: 'bool',
+                    value: defaultValue,
                 },
             },
         };
@@ -196,4 +195,88 @@ Or edit the JSON config file directly for complex targeting rules:
         const response = request.json;
         return this.ok(`${checkmark} Created boolean flag: ${key}`, { key, ...response });
     }
+    async createLogLevel(args, flags) {
+        const key = args.name;
+        if (!key.startsWith(LOG_LEVEL_KEY_PREFIX)) {
+            return this.err(`Log level key "${key}" must start with "${LOG_LEVEL_KEY_PREFIX}". Try: ${LOG_LEVEL_KEY_PREFIX}${key}`, { key, phase: 'validation' });
+        }
+        const secret = parsedSecretFlags(flags);
+        if (secret.selected) {
+            return this.err('--secret is not supported for log_level (values are enum, not free-form strings)');
+        }
+        if (flags['env-var']) {
+            return this.err('--env-var is not supported for log_level (values must be one of the enum constants)');
+        }
+        if (flags.confidential) {
+            return this.err('--confidential is not supported for log_level');
+        }
+        const valueInput = await getValue({
+            desiredValue: flags.value,
+            flags,
+            message: `Default log level (${LOG_LEVELS.join('/')})`,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            quonfig: undefined,
+        });
+        if (!valueInput.ok) {
+            if (valueInput.error) {
+                return this.err(valueInput.message, valueInput.json);
+            }
+            return;
+        }
+        const rawValue = valueInput.value.toUpperCase();
+        if (!isLogLevel(rawValue)) {
+            return this.err(`Invalid log level "${valueInput.value}". Must be one of: ${LOG_LEVELS.join(', ')}`, {
+                key,
+                phase: 'validation',
+            });
+        }
+        // Step 1: create the log-level config. The server always writes INFO as the
+        // initial default, so we patch it to the requested value below if needed.
+        const createInput = {
+            workspaceId: this.workspaceId,
+            logLevel: { key },
+        };
+        this.verboseLog('RPC logLevels/create', createInput);
+        const createRequest = await this.apiClient.post('/api/v1/logLevels/create', createInput);
+        if (!createRequest.ok) {
+            const errMsg = createRequest.status === 409
+                ? `Failed to create log level: ${key} already exists`
+                : `Failed to create log level: ${createRequest.status} | ${JSON.stringify(createRequest.error)}`;
+            return this.err(errMsg, { key, phase: 'creation', serverError: createRequest.error });
+        }
+        const createResponse = createRequest.json;
+        // Step 2: if the requested value isn't the server's default (INFO), update.
+        if (rawValue !== 'INFO') {
+            if (!createResponse.commitSha) {
+                return this.err('Server did not return commitSha after create; cannot patch default value', {
+                    key,
+                    phase: 'update',
+                });
+            }
+            const updateInput = {
+                workspaceId: this.workspaceId,
+                logLevelKey: key,
+                logLevel: {
+                    default: {
+                        rules: [
+                            {
+                                criteria: [{ operator: 'ALWAYS_TRUE' }],
+                                value: { type: 'log_level', value: rawValue },
+                            },
+                        ],
+                    },
+                },
+                expectedCommitSha: createResponse.commitSha,
+            };
+            this.verboseLog('RPC logLevels/update', updateInput);
+            const updateRequest = await this.apiClient.post('/api/v1/logLevels/update', updateInput);
+            if (!updateRequest.ok) {
+                return this.err(`Log level created with default INFO, but failed to set value to ${rawValue}: ${updateRequest.status}. Run \`qfg set-default ${key} --value=${rawValue}\` to retry.`, { key, phase: 'update', serverError: updateRequest.error });
+            }
+        }
+        return this.ok(`${checkmark} Created log level: ${key} (default: ${rawValue})`, {
+            key,
+            value: rawValue,
+        });
+    }
 }